@codemation/host 0.0.1

package/prisma/migrations/20260320140000_user_invites_account_status/migration.sql

@@ -0,0 +1,20 @@
+-- AlterTable
+ALTER TABLE "codemation_auth_user" ADD COLUMN "account_status" TEXT NOT NULL DEFAULT 'active';
+
+-- CreateTable
+CREATE TABLE "codemation_auth_user_invite" (
+    "id" TEXT NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "token_hash" TEXT NOT NULL,
+    "expires_at" TIMESTAMP(3) NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL,
+    "revoked_at" TIMESTAMP(3),
+
+    CONSTRAINT "codemation_auth_user_invite_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "codemation_auth_user_invite_token_hash_key" ON "codemation_auth_user_invite"("token_hash");
+
+CREATE INDEX "codemation_auth_user_invite_user_id_idx" ON "codemation_auth_user_invite"("user_id");
+
+ALTER TABLE "codemation_auth_user_invite" ADD CONSTRAINT "codemation_auth_user_invite_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "codemation_auth_user"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/migrations/20260325120000_workflow_activation/migration.sql

@@ -0,0 +1,8 @@
+-- CreateTable
+CREATE TABLE "WorkflowActivation" (
+    "workflow_id" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT false,
+    "updated_at" TEXT NOT NULL,
+
+    CONSTRAINT "WorkflowActivation_pkey" PRIMARY KEY ("workflow_id")
+);

package/prisma/migrations/migration_lock.toml

@@ -0,0 +1,3 @@
+# Please do not edit this file manually
+# It should be added in your version-control system (e.g., Git)
+provider = "postgresql"

package/prisma/schema.prisma

@@ -0,0 +1,179 @@
+generator client {
+  provider = "prisma-client-js"
+  output   = "../src/infrastructure/persistence/generated/prisma-client"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+model Run {
+  runId                 String  @id @map("run_id")
+  workflowId            String  @map("workflow_id")
+  startedAt             String  @map("started_at")
+  status                String
+  parentJson            String? @map("parent_json")
+  executionOptionsJson  String? @map("execution_options_json")
+  updatedAt             String  @map("updated_at")
+  stateJson             String  @map("state_json")
+}
+
+model WorkflowDebuggerOverlay {
+  workflowId       String  @id @map("workflow_id")
+  updatedAt        String  @map("updated_at")
+  copiedFromRunId  String? @map("copied_from_run_id")
+  stateJson        String  @map("state_json")
+}
+
+model WorkflowActivation {
+  workflowId String  @id @map("workflow_id")
+  isActive   Boolean @default(false) @map("is_active")
+  updatedAt  String  @map("updated_at")
+}
+
+model TriggerSetupState {
+  workflowId       String  @map("workflow_id")
+  nodeId           String  @map("node_id")
+  updatedAt        String  @map("updated_at")
+  stateJson        String  @map("state_json")
+
+  @@id([workflowId, nodeId])
+}
+
+model CredentialInstance {
+  instanceId       String  @id @map("instance_id")
+  typeId           String  @map("type_id")
+  displayName      String  @map("display_name")
+  sourceKind       String  @map("source_kind")
+  publicConfigJson String  @map("public_config_json")
+  secretRefJson    String  @map("secret_ref_json")
+  tagsJson         String  @map("tags_json")
+  setupStatus      String  @map("setup_status")
+  createdAt        String  @map("created_at")
+  updatedAt        String  @map("updated_at")
+}
+
+model CredentialSecretMaterial {
+  instanceId       String  @id @map("instance_id")
+  encryptedJson    String  @map("encrypted_json")
+  encryptionKeyId  String  @map("encryption_key_id")
+  schemaVersion    Int     @map("schema_version")
+  updatedAt        String  @map("updated_at")
+}
+
+model CredentialOAuth2Material {
+  instanceId       String  @id @map("instance_id")
+  encryptedJson    String  @map("encrypted_json")
+  encryptionKeyId  String  @map("encryption_key_id")
+  schemaVersion    Int     @map("schema_version")
+  providerId       String  @map("provider_id")
+  connectedEmail   String? @map("connected_email")
+  connectedAt      String? @map("connected_at")
+  scopesJson       String  @map("scopes_json")
+  updatedAt        String  @map("updated_at")
+}
+
+model CredentialOAuth2State {
+  state               String  @id
+  instanceId          String  @map("instance_id")
+  codeVerifier        String? @map("code_verifier")
+  providerId          String? @map("provider_id")
+  requestedScopesJson String  @map("requested_scopes_json")
+  createdAt           String  @map("created_at")
+  expiresAt           String  @map("expires_at")
+
+  @@index([instanceId])
+  @@index([expiresAt])
+}
+
+model CredentialBinding {
+  workflowId       String  @map("workflow_id")
+  nodeId           String  @map("node_id")
+  slotKey          String  @map("slot_key")
+  instanceId       String  @map("instance_id")
+  updatedAt        String  @map("updated_at")
+
+  @@id([workflowId, nodeId, slotKey])
+  @@index([instanceId])
+}
+
+model CredentialTestResult {
+  testId           String  @id @map("test_id")
+  instanceId       String  @map("instance_id")
+  status           String
+  message          String?
+  detailsJson      String  @map("details_json")
+  testedAt         String  @map("tested_at")
+  expiresAt        String? @map("expires_at")
+
+  @@index([instanceId, testedAt])
+}
+
+/// Auth.js / NextAuth user directory (JWT sessions; optional OAuth linking)
+model User {
+  id            String       @id @default(cuid())
+  name          String?
+  email         String?      @unique
+  emailVerified DateTime?    @map("email_verified")
+  image         String?
+  passwordHash  String?      @map("password_hash")
+  /// invited | active | inactive (local directory / invite flow)
+  accountStatus String       @default("active") @map("account_status")
+  accounts      Account[]
+  sessions      Session[]
+  invites       UserInvite[]
+
+  @@map("codemation_auth_user")
+}
+
+model UserInvite {
+  id        String    @id @default(cuid())
+  userId    String    @map("user_id")
+  tokenHash String    @unique @map("token_hash")
+  expiresAt DateTime  @map("expires_at")
+  createdAt DateTime  @map("created_at")
+  revokedAt DateTime? @map("revoked_at")
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("codemation_auth_user_invite")
+}
+
+model Account {
+  id                 String  @id @default(cuid())
+  userId             String  @map("user_id")
+  type               String
+  provider           String
+  providerAccountId  String  @map("provider_account_id")
+  refresh_token      String? @db.Text
+  access_token       String? @db.Text
+  expires_at         Int?
+  token_type         String?
+  scope              String? @db.Text
+  id_token           String? @db.Text
+  session_state      String?
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([provider, providerAccountId])
+  @@map("codemation_auth_account")
+}
+
+model Session {
+  id           String   @id @default(cuid())
+  sessionToken String   @unique @map("session_token")
+  userId       String   @map("user_id")
+  expires      DateTime
+  user         User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@map("codemation_auth_session")
+}
+
+model VerificationToken {
+  identifier String
+  token      String
+  expires    DateTime
+
+  @@unique([identifier, token])
+  @@map("codemation_auth_verification_token")
+}

package/prisma.config.ts

@@ -0,0 +1,12 @@
+import "dotenv/config";
+import { defineConfig, env } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  datasource: {
+    url: env("DATABASE_URL"),
+  },
+});

package/scripts/ensure-prisma-runtime-sourcemaps.mjs

@@ -0,0 +1,42 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Prisma's generated `runtime/*.js` files end with `//# sourceMappingURL=*.map`, but Prisma does not
+ * ship those `.map` files (see prisma/prisma#28373). Vite then logs ENOENT on every transform.
+ * We write minimal valid sourcemaps so the URL resolves and stack tooling stays stable.
+ */
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const runtimeDir = path.resolve(packageRoot, "src/infrastructure/persistence/generated/prisma-client/runtime");
+
+function writeStub(mapFileName, jsFileName) {
+  const mapPath = path.join(runtimeDir, mapFileName);
+  const jsPath = path.join(runtimeDir, jsFileName);
+  if (!fs.existsSync(jsPath)) {
+    return;
+  }
+  const payload = JSON.stringify({
+    version: 3,
+    file: jsFileName,
+    sources: [],
+    names: [],
+    mappings: "",
+  });
+  fs.writeFileSync(mapPath, `${payload}\n`, "utf8");
+}
+
+export default function ensurePrismaRuntimeSourcemaps() {
+  if (!fs.existsSync(runtimeDir)) {
+    return;
+  }
+  writeStub("client.js.map", "client.js");
+  writeStub("index-browser.js.map", "index-browser.js");
+  writeStub("wasm-compiler-edge.js.map", "wasm-compiler-edge.js");
+}
+
+const selfPath = path.resolve(fileURLToPath(import.meta.url));
+const invokedDirectly = path.resolve(process.argv[1] ?? "") === selfPath;
+if (invokedDirectly) {
+  ensurePrismaRuntimeSourcemaps();
+}

package/scripts/integration-database-global-setup.mjs

@@ -0,0 +1,30 @@
+import { existsSync, readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const hostPackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const repoRoot = path.resolve(hostPackageRoot, "..", "..");
+const runner = path.join(hostPackageRoot, "test/http/testkit/IntegrationDatabaseGlobalSetupRunner.ts");
+const cachePath = path.join(hostPackageRoot, ".cache", "integration-database.json");
+
+export default function integrationDatabaseGlobalSetup() {
+  if (!process.env.DATABASE_URL?.trim()) {
+    return;
+  }
+  const result = spawnSync("pnpm", ["exec", "tsx", runner], {
+    cwd: repoRoot,
+    stdio: "inherit",
+    env: process.env,
+    shell: true,
+  });
+  if (result.status !== 0) {
+    throw new Error("Integration database global setup failed.");
+  }
+  if (existsSync(cachePath)) {
+    const payload = JSON.parse(readFileSync(cachePath, "utf8"));
+    if (payload?.databaseUrl && typeof payload.databaseUrl === "string") {
+      process.env.CODEMATION_INTEGRATION_SHARED_DATABASE_URL = payload.databaseUrl;
+    }
+  }
+}

package/src/application/ApplicationRequestError.ts

@@ -0,0 +1,12 @@
+export class ApplicationRequestError extends Error {
+  readonly status: number;
+
+  readonly payload: Readonly<{ error: string; errors?: ReadonlyArray<string> }>;
+
+  constructor(status: number, message: string, errors?: ReadonlyArray<string>) {
+    super(message);
+    this.name = "ApplicationRequestError";
+    this.status = status;
+    this.payload = errors && errors.length > 0 ? { error: message, errors } : { error: message };
+  }
+}

package/src/application/auth/AuthenticatedPrincipal.ts

@@ -0,0 +1,5 @@
+export type AuthenticatedPrincipal = Readonly<{
+  id: string;
+  email: string | null;
+  name: string | null;
+}>;

package/src/application/auth/SessionVerifier.ts

@@ -0,0 +1,5 @@
+import type { AuthenticatedPrincipal } from "./AuthenticatedPrincipal";
+
+export interface SessionVerifier {
+  verify(request: Request): Promise<AuthenticatedPrincipal | null>;
+}

package/src/application/binary/OverlayPinnedBinaryUploadService.ts

@@ -0,0 +1,119 @@
+import type { BinaryAttachment, BinaryBody, BinaryPreviewKind, BinaryStorage } from "@codemation/core";
+import { CoreTokens, inject, injectable } from "@codemation/core";
+import sanitizeFilename from "sanitize-filename";
+
+/** Sentinel run id for debugger-overlay pinned-output uploads (not a real execution). */
+export const OVERLAY_PIN_BINARY_RUN_ID = "overlay-pin";
+
+@injectable()
+export class OverlayPinnedBinaryUploadService {
+  constructor(@inject(CoreTokens.BinaryStorage) private readonly binaryStorage: BinaryStorage) {}
+
+  async attach(
+    args: Readonly<{
+      workflowId: string;
+      nodeId: string;
+      itemIndex: number;
+      name: string;
+      body: BinaryBody;
+      mimeType: string;
+      filename?: string;
+      previewKind?: BinaryAttachment["previewKind"];
+    }>,
+  ): Promise<BinaryAttachment> {
+    const attachmentId = this.createAttachmentId();
+    const createdAt = new Date().toISOString();
+    const activationId = this.overlayActivationId(args.itemIndex);
+    const storageKey = this.createStorageKey({
+      workflowId: args.workflowId,
+      runId: OVERLAY_PIN_BINARY_RUN_ID,
+      nodeId: args.nodeId,
+      activationId,
+      attachmentId,
+      name: args.name,
+      filename: args.filename,
+    });
+    const stored = await this.binaryStorage.write({
+      storageKey,
+      body: args.body,
+    });
+    return {
+      id: attachmentId,
+      storageKey: stored.storageKey,
+      mimeType: args.mimeType,
+      size: stored.size,
+      storageDriver: this.binaryStorage.driverName,
+      previewKind: args.previewKind ?? this.resolvePreviewKind(args.mimeType),
+      createdAt,
+      runId: OVERLAY_PIN_BINARY_RUN_ID,
+      workflowId: args.workflowId,
+      nodeId: args.nodeId,
+      activationId,
+      filename: args.filename,
+      sha256: stored.sha256,
+    };
+  }
+
+  private overlayActivationId(itemIndex: number): string {
+    return `overlay-pin-i${itemIndex}`;
+  }
+
+  private createAttachmentId(): string {
+    const cryptoObject = globalThis.crypto;
+    if (cryptoObject && typeof cryptoObject.randomUUID === "function") {
+      return cryptoObject.randomUUID();
+    }
+    return `bin-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  }
+
+  private createStorageKey(
+    args: Readonly<{
+      workflowId: string;
+      runId: string;
+      nodeId: string;
+      activationId: string;
+      attachmentId: string;
+      name: string;
+      filename?: string;
+    }>,
+  ): string {
+    const safeName = this.sanitizeSegment(args.name);
+    const safeFilename = this.sanitizeFilenameForKey(args.filename);
+    const filenameSuffix = safeFilename ? `-${safeFilename}` : "";
+    return `${this.sanitizeSegment(args.workflowId)}/${this.sanitizeSegment(args.runId)}/${this.sanitizeSegment(args.nodeId)}/${this.sanitizeSegment(args.activationId)}/${args.attachmentId}-${safeName}${filenameSuffix}`;
+  }
+
+  private sanitizeSegment(value: string): string {
+    const normalized = value.trim();
+    if (!normalized) {
+      return "item";
+    }
+    const safe = sanitizeFilename(normalized);
+    return safe || "item";
+  }
+
+  private sanitizeFilenameForKey(value: string | undefined): string | undefined {
+    if (!value) {
+      return undefined;
+    }
+    const basename = value.trim().split("/").at(-1)?.split("\\").at(-1) ?? value.trim();
+    if (!basename) {
+      return undefined;
+    }
+    const safe = sanitizeFilename(basename);
+    return safe || undefined;
+  }
+
+  private resolvePreviewKind(mimeType: string): BinaryPreviewKind {
+    if (mimeType.startsWith("image/")) {
+      return "image";
+    }
+    if (mimeType.startsWith("audio/")) {
+      return "audio";
+    }
+    if (mimeType.startsWith("video/")) {
+      return "video";
+    }
+    return "download";
+  }
+}

package/src/application/binary/RunBinaryAttachmentLookupService.ts

@@ -0,0 +1,139 @@
+import type { BinaryAttachment, Items, PersistedRunState, RunCurrentState } from "@codemation/core";
+import { inject, injectable } from "@codemation/core";
+import { ApplicationTokens } from "../../applicationTokens";
+import type { WorkflowRunRepository } from "../../domain/runs/WorkflowRunRepository";
+import type { WorkflowDebuggerOverlayRepository } from "../../domain/workflows/WorkflowDebuggerOverlayRepository";
+
+@injectable()
+export class RunBinaryAttachmentLookupService {
+  constructor(
+    @inject(ApplicationTokens.WorkflowRunRepository)
+    private readonly workflowRunRepository: WorkflowRunRepository,
+    @inject(ApplicationTokens.WorkflowDebuggerOverlayRepository)
+    private readonly workflowDebuggerOverlayRepository: WorkflowDebuggerOverlayRepository,
+  ) {}
+
+  async findForRun(runId: string, binaryId: string): Promise<BinaryAttachment | undefined> {
+    const state = await this.workflowRunRepository.load(runId);
+    if (!state) {
+      return undefined;
+    }
+    return this.findInRunState(state, binaryId);
+  }
+
+  async findForWorkflowOverlay(workflowId: string, binaryId: string): Promise<BinaryAttachment | undefined> {
+    const state = await this.workflowDebuggerOverlayRepository.load(workflowId);
+    if (!state) {
+      return undefined;
+    }
+    return this.findInCurrentState(state.currentState, binaryId);
+  }
+
+  private findInRunState(state: PersistedRunState, binaryId: string): BinaryAttachment | undefined {
+    const inOutputs = this.findInOutputsByNode(state.outputsByNode, binaryId);
+    if (inOutputs) {
+      return inOutputs;
+    }
+    const inSnapshots = this.findInNodeSnapshots(state, binaryId);
+    if (inSnapshots) {
+      return inSnapshots;
+    }
+    return this.findInMutableState(state.mutableState, binaryId);
+  }
+
+  private findInCurrentState(state: RunCurrentState, binaryId: string): BinaryAttachment | undefined {
+    const inOutputs = this.findInOutputsByNode(state.outputsByNode, binaryId);
+    if (inOutputs) {
+      return inOutputs;
+    }
+    const inSnapshots = this.findInCurrentStateSnapshots(state, binaryId);
+    if (inSnapshots) {
+      return inSnapshots;
+    }
+    return this.findInMutableState(state.mutableState, binaryId);
+  }
+
+  private findInOutputsByNode(
+    outputsByNode: Readonly<Record<string, Readonly<Partial<Record<string, Items>>>>>,
+    binaryId: string,
+  ): BinaryAttachment | undefined {
+    for (const outputs of Object.values(outputsByNode)) {
+      for (const items of Object.values(outputs)) {
+        const attachment = this.findInItems(items, binaryId);
+        if (attachment) {
+          return attachment;
+        }
+      }
+    }
+    return undefined;
+  }
+
+  private findInNodeSnapshots(state: PersistedRunState, binaryId: string): BinaryAttachment | undefined {
+    for (const snapshot of Object.values(state.nodeSnapshotsByNodeId)) {
+      const inInputs = this.findInPortItemMap(snapshot.inputsByPort, binaryId);
+      if (inInputs) {
+        return inInputs;
+      }
+      const inOutputs = this.findInPortItemMap(snapshot.outputs, binaryId);
+      if (inOutputs) {
+        return inOutputs;
+      }
+    }
+    return undefined;
+  }
+
+  private findInCurrentStateSnapshots(state: RunCurrentState, binaryId: string): BinaryAttachment | undefined {
+    for (const snapshot of Object.values(state.nodeSnapshotsByNodeId)) {
+      const inInputs = this.findInPortItemMap(snapshot.inputsByPort, binaryId);
+      if (inInputs) {
+        return inInputs;
+      }
+      const inOutputs = this.findInPortItemMap(snapshot.outputs, binaryId);
+      if (inOutputs) {
+        return inOutputs;
+      }
+    }
+    return undefined;
+  }
+
+  private findInMutableState(
+    mutableState: PersistedRunState["mutableState"] | RunCurrentState["mutableState"] | undefined,
+    binaryId: string,
+  ): BinaryAttachment | undefined {
+    for (const nodeState of Object.values(mutableState?.nodesById ?? {})) {
+      const inPinned = this.findInPortItemMap(nodeState.pinnedOutputsByPort, binaryId);
+      if (inPinned) {
+        return inPinned;
+      }
+      const inDebugInput = this.findInItems(nodeState.lastDebugInput, binaryId);
+      if (inDebugInput) {
+        return inDebugInput;
+      }
+    }
+    return undefined;
+  }
+
+  private findInPortItemMap(
+    itemMap: Readonly<Partial<Record<string, Items>>> | undefined,
+    binaryId: string,
+  ): BinaryAttachment | undefined {
+    for (const items of Object.values(itemMap ?? {})) {
+      const attachment = this.findInItems(items, binaryId);
+      if (attachment) {
+        return attachment;
+      }
+    }
+    return undefined;
+  }
+
+  private findInItems(items: Items | undefined, binaryId: string): BinaryAttachment | undefined {
+    for (const item of items ?? []) {
+      for (const attachment of Object.values(item.binary ?? {})) {
+        if (attachment.id === binaryId) {
+          return attachment;
+        }
+      }
+    }
+    return undefined;
+  }
+}

package/src/application/binary/RunStateBinaryStorageKeysCollector.ts

@@ -0,0 +1,57 @@
+import type { BinaryAttachment, Items, PersistedRunState } from "@codemation/core";
+
+/**
+ * Collects every `storageKey` referenced by binary attachments embedded in persisted run state
+ * (outputs, node snapshots, mutable debugger state).
+ */
+export class RunStateBinaryStorageKeysCollector {
+  collectFromRunState(state: PersistedRunState): ReadonlySet<string> {
+    const keys = new Set<string>();
+    this.addFromOutputsByNode(state.outputsByNode, keys);
+    this.addFromNodeSnapshots(state, keys);
+    this.addFromMutableState(state.mutableState, keys);
+    return keys;
+  }
+
+  private addFromOutputsByNode(outputsByNode: PersistedRunState["outputsByNode"], keys: Set<string>): void {
+    for (const outputs of Object.values(outputsByNode)) {
+      for (const items of Object.values(outputs)) {
+        this.addFromItems(items, keys);
+      }
+    }
+  }
+
+  private addFromNodeSnapshots(state: PersistedRunState, keys: Set<string>): void {
+    for (const snapshot of Object.values(state.nodeSnapshotsByNodeId)) {
+      this.addFromPortMap(snapshot.inputsByPort, keys);
+      this.addFromPortMap(snapshot.outputs, keys);
+    }
+  }
+
+  private addFromMutableState(mutableState: PersistedRunState["mutableState"], keys: Set<string>): void {
+    for (const nodeState of Object.values(mutableState?.nodesById ?? {})) {
+      this.addFromPortMap(nodeState.pinnedOutputsByPort, keys);
+      this.addFromItems(nodeState.lastDebugInput, keys);
+    }
+  }
+
+  private addFromPortMap(itemMap: Readonly<Partial<Record<string, Items>>> | undefined, keys: Set<string>): void {
+    for (const items of Object.values(itemMap ?? {})) {
+      this.addFromItems(items, keys);
+    }
+  }
+
+  private addFromItems(items: Items | undefined, keys: Set<string>): void {
+    for (const item of items ?? []) {
+      for (const attachment of Object.values(item.binary ?? {})) {
+        this.addAttachment(attachment, keys);
+      }
+    }
+  }
+
+  private addAttachment(attachment: BinaryAttachment, keys: Set<string>): void {
+    if (attachment.storageKey.length > 0) {
+      keys.add(attachment.storageKey);
+    }
+  }
+}

package/src/application/bus/Command.ts

@@ -0,0 +1,3 @@
+export abstract class Command<TResult> {
+  protected readonly __resultType?: TResult;
+}

package/src/application/bus/CommandBus.ts

@@ -0,0 +1,5 @@
+import type { Command } from "./Command";
+
+export interface CommandBus {
+  execute<TResult>(command: Command<TResult>): Promise<TResult>;
+}

package/src/application/bus/CommandHandler.ts

@@ -0,0 +1,5 @@
+import type { Command } from "./Command";
+
+export abstract class CommandHandler<TCommand extends Command<TResult>, TResult> {
+  abstract execute(command: TCommand): Promise<TResult>;
+}

package/src/application/bus/DomainEvent.ts

@@ -0,0 +1 @@
+export abstract class DomainEvent {}

package/src/application/bus/DomainEventBus.ts

@@ -0,0 +1,5 @@
+import type { DomainEvent } from "./DomainEvent";
+
+export interface DomainEventBus {
+  publish(event: DomainEvent): Promise<void>;
+}

package/src/application/bus/DomainEventHandler.ts

@@ -0,0 +1,5 @@
+import type { DomainEvent } from "./DomainEvent";
+
+export abstract class DomainEventHandler<TEvent extends DomainEvent> {
+  abstract handle(event: TEvent): Promise<void>;
+}