feat(core): add application interfaces (repositories + services)

packages/core/src/application/repositories/articles.repository.interface.ts

@@ -0,0 +1,16 @@
+import type { Article } from "@/entities/models/article.js";
+
+export interface IArticlesRepository {
+  getArticle(id: string): Promise<Article | undefined>;
+  getArticles(options?: {
+    status?: string;
+    authorId?: string;
+    limit?: number;
+    offset?: number;
+  }): Promise<Article[]>;
+  createArticle(input: Article): Promise<Article>;
+  updateArticle(
+    id: string,
+    input: Partial<Article>
+  ): Promise<Article | undefined>;
+}

packages/core/src/application/repositories/index.ts

@@ -0,0 +1,2 @@
+export type { IUsersRepository } from "./users.repository.interface.js";
+export type { IArticlesRepository } from "./articles.repository.interface.js";

packages/core/src/application/repositories/users.repository.interface.ts

@@ -0,0 +1,7 @@
+import type { User } from "@/entities/models/user.js";
+
+export interface IUsersRepository {
+  getUser(id: string): Promise<User | undefined>;
+  getUserByUsername(username: string): Promise<User | undefined>;
+  createUser(input: User): Promise<User>;
+}

packages/core/src/application/services/auth.service.interface.ts

@@ -0,0 +1,14 @@
+import type { Cookie } from "@/entities/models/cookie.js";
+import type { Session } from "@/entities/models/session.js";
+import type { User } from "@/entities/models/user.js";
+
+export interface IAuthenticationService {
+  generateUserId(): string;
+  hashPassword(password: string): Promise<string>;
+  verifyPassword(hash: string, password: string): Promise<boolean>;
+  validateSession(
+    sessionId: string
+  ): Promise<{ user: User; session: Session }>;
+  createSession(user: User): Promise<{ session: Session; cookie: Cookie }>;
+  invalidateSession(sessionId: string): Promise<{ blankCookie: Cookie }>;
+}

packages/core/src/application/services/index.ts

@@ -0,0 +1,2 @@
+export type { IAuthenticationService } from "./auth.service.interface.js";
+export type { ITelemetryService } from "./telemetry.service.interface.js";

packages/core/src/application/services/telemetry.service.interface.ts

@@ -0,0 +1,3 @@
+export interface ITelemetryService {
+  startSpan<T>(name: string, fn: () => T | Promise<T>): Promise<T>;
+}