@zudojs/cqrs 0.0.1

package/README.md

@@ -0,0 +1,41 @@
+# @zudojs/cqrs
+
+Command Query Responsibility Segregation (CQRS) primitives for separating read and write operations.
+
+## Installation
+
+```bash
+npm install @zudojs/cqrs
+```
+
+## Quick Start
+
+```typescript
+import { createCommandBus, createQueryBus } from "@zudojs/cqrs";
+
+const commandBus = createCommandBus();
+const queryBus = createQueryBus();
+
+commandBus.register("CreateUser", async (command) => {
+  return userRepository.create(command.data);
+});
+
+queryBus.register("GetUser", async (query) => {
+  return userRepository.findById(query.id);
+});
+```
+
+## Features
+
+- Command bus for write operations
+- Query bus for read operations
+- Middleware pipeline for both
+- Command and query handlers
+- Result types for explicit returns
+
+## Use Cases
+
+- Complex domain logic
+- Event-sourced systems
+- Read/write model separation
+- Audit trails and logging

package/dist/command/command.core.d.ts

@@ -0,0 +1,47 @@
+import type { Command as CommandContract } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Base abstract command.
+ *
+ * Commands represent requests to change application state.
+ * Each concrete command should define a unique static type and
+ * immutable command data.
+ */
+export declare abstract class Command<TType extends string = string> implements CommandContract<TType> {
+    readonly type: TType;
+    protected constructor(type: TType);
+}
+/**
+ * Options used when constructing a concrete command.
+ */
+export interface CommandOptions {
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Command containing immutable metadata.
+ */
+export declare abstract class MetadataCommand<TType extends string = string> extends Command<TType> {
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    protected constructor(type: TType, options?: CommandOptions);
+}
+/**
+ * Creates a simple immutable command object.
+ */
+export declare function createCommand<TType extends string, TPayload extends Record<string, unknown> = Record<string, never>>(type: TType, payload?: TPayload): Readonly<{
+    readonly type: TType;
+} & TPayload>;
+/**
+ * Returns the command type discriminator.
+ */
+export declare function getCommandType(command: CommandContract): string;
+/**
+ * Determines whether a value is a command.
+ */
+export declare function isCommand(value: unknown): value is CommandContract;
+/**
+ * Creates a command type factory.
+ *
+ * This is useful when defining a family of related commands while
+ * keeping their discriminator values consistent.
+ */
+export declare function commandType<TType extends string>(type: TType): () => TType;
+//# sourceMappingURL=command.core.d.ts.map

package/dist/command/command.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.core.d.ts","sourceRoot":"","sources":["../../src/command/command.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjF;;;;;;GAMG;AACH,8BAAsB,OAAO,CAC3B,KAAK,SAAS,MAAM,GAAG,MAAM,CAC7B,YAAW,eAAe,CAAC,KAAK,CAAC;IACjC,SAAgB,IAAI,EAAE,KAAK,CAAC;IAE5B,SAAS,aAAa,IAAI,EAAE,KAAK,EAEhC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,8BAAsB,eAAe,CACnC,KAAK,SAAS,MAAM,GAAG,MAAM,CAC7B,SAAQ,OAAO,CAAC,KAAK,CAAC;IACtB,SAAgB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7D,SAAS,aAAa,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,cAAmB,EAI9D;CACF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEhE,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,QAAQ,GACjB,QAAQ,CACT;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,GAAG,QAAQ,CACb,CASA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAgBlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,KAAK,CAE1E"}

package/dist/command/command.core.js

@@ -0,0 +1,58 @@
+/**
+ * Base abstract command.
+ *
+ * Commands represent requests to change application state.
+ * Each concrete command should define a unique static type and
+ * immutable command data.
+ */
+export class Command {
+    type;
+    constructor(type) {
+        this.type = type;
+    }
+}
+/**
+ * Command containing immutable metadata.
+ */
+export class MetadataCommand extends Command {
+    metadata;
+    constructor(type, options = {}) {
+        super(type);
+        this.metadata = options.metadata;
+    }
+}
+/**
+ * Creates a simple immutable command object.
+ */
+export function createCommand(type, payload) {
+    return Object.freeze({
+        type,
+        ...(payload ?? {}),
+    });
+}
+/**
+ * Returns the command type discriminator.
+ */
+export function getCommandType(command) {
+    return command.type;
+}
+/**
+ * Determines whether a value is a command.
+ */
+export function isCommand(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        typeof value.type === "string" &&
+        value.type.length > 0);
+}
+/**
+ * Creates a command type factory.
+ *
+ * This is useful when defining a family of related commands while
+ * keeping their discriminator values consistent.
+ */
+export function commandType(type) {
+    return () => type;
+}
+//# sourceMappingURL=command.core.js.map

package/dist/command/command.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.core.js","sourceRoot":"","sources":["../../src/command/command.core.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAgB,OAAO;IAGX,IAAI,CAAQ;IAE5B,YAAsB,IAAW;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AASD;;GAEG;AACH,MAAM,OAAgB,eAEpB,SAAQ,OAAc;IACN,QAAQ,CAAqC;IAE7D,YAAsB,IAAW,EAAE,OAAO,GAAmB,EAAE;QAC7D,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAI3B,IAAW,EACX,OAAkB;IAMlB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,GAAG,CAAC,OAAO,IAAK,EAAe,CAAC;KACjC,CAIA,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OACE,KAGD,CAAC,IAAI,KAAK,QAAQ;QAEjB,KAGD,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAClB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAuB,IAAW;IAC3D,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/command/commandBus.core.d.ts

@@ -0,0 +1,91 @@
+import type { Command, CommandBus as CommandBusContract, CommandHandlerLike, CqrsContext, CqrsMiddleware } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Options for constructing a command bus.
+ */
+export interface CommandBusOptions {
+    readonly middleware?: readonly CqrsMiddleware[];
+    /**
+     * Creates a default execution context when one is not supplied.
+     */
+    readonly contextFactory?: () => CqrsContext | Promise<CqrsContext>;
+}
+/**
+ * Registered command handler.
+ */
+export interface CommandRegistration<TCommand extends Command = Command, TResult = void> {
+    readonly commandType: TCommand["type"];
+    readonly handler: CommandHandlerLike<TCommand, TResult>;
+}
+/**
+ * Command bus implementation.
+ *
+ * The command bus resolves a handler by command type and executes it
+ * through the registered middleware pipeline.
+ */
+export declare class CommandBus implements CommandBusContract {
+    private readonly handlers;
+    private readonly middleware;
+    private readonly contextFactory?;
+    constructor(options?: CommandBusOptions);
+    /**
+     * Registers a command handler.
+     */
+    register<TCommand extends Command, TResult = void>(commandType: TCommand["type"], handler: CommandHandlerLike<TCommand, TResult>): this;
+    /**
+     * Registers multiple command handlers.
+     */
+    registerMany(registrations: readonly CommandRegistration[]): this;
+    /**
+     * Replaces an existing command handler.
+     */
+    replace<TCommand extends Command, TResult = void>(commandType: TCommand["type"], handler: CommandHandlerLike<TCommand, TResult>): this;
+    /**
+     * Removes a command handler.
+     */
+    unregister(commandType: string): boolean;
+    /**
+     * Determines whether a command handler is registered.
+     */
+    has(commandType: string): boolean;
+    /**
+     * Returns the registered handler for a command type.
+     */
+    getHandler<TCommand extends Command, TResult = void>(commandType: TCommand["type"]): CommandHandlerLike<TCommand, TResult> | undefined;
+    /**
+     * Executes a command.
+     */
+    execute<TCommand extends Command, TResult = void>(command: TCommand, context?: CqrsContext): Promise<TResult>;
+    /**
+     * Adds middleware to the end of the pipeline.
+     */
+    use(middleware: CqrsMiddleware): this;
+    /**
+     * Returns the number of registered handlers.
+     */
+    size(): number;
+    /**
+     * Removes all registered handlers.
+     */
+    clear(): void;
+    /**
+     * Returns all registered command types.
+     */
+    getCommandTypes(): readonly string[];
+    /**
+     * Builds the command execution pipeline.
+     */
+    private buildPipeline;
+    /**
+     * Resolves the execution context.
+     */
+    private resolveContext;
+    /**
+     * Validates a command before execution.
+     */
+    private validateCommand;
+}
+/**
+ * Creates a command bus.
+ */
+export declare function createCommandBus(options?: CommandBusOptions): CommandBus;
+//# sourceMappingURL=commandBus.core.d.ts.map

package/dist/command/commandBus.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBus.core.d.ts","sourceRoot":"","sources":["../../src/command/commandBus.core.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,IAAI,kBAAkB,EAChC,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,gCAAgC,CAAC;AAOxC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,IAAI;IAEd,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEvC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,kBAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAElE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA2C;IAE3E,YAAY,OAAO,GAAE,iBAAsB,EAI1C;IAED;;OAEG;IACI,QAAQ,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,GAAG,IAAI,EACtD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAC7C,IAAI,CAoBN;IAED;;OAEG;IACI,YAAY,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAMvE;IAED;;OAEG;IACI,OAAO,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,GAAG,IAAI,EACrD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAC7C,IAAI,CAQN;IAED;;OAEG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9C;IAED;;OAEG;IACI,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvC;IAED;;OAEG;IACI,UAAU,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,GAAG,IAAI,EACxD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC5B,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS,CAGnD;IAED;;OAEG;IACU,OAAO,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,GAAG,IAAI,EAC3D,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CA2BlB;IAED;;OAEG;IACI,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAQ3C;IAED;;OAEG;IACI,IAAI,IAAI,MAAM,CAEpB;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAEnB;IAED;;OAEG;IACI,eAAe,IAAI,SAAS,MAAM,EAAE,CAE1C;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,OAAO,CAAC,eAAe;CAuBxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAE5E"}

package/dist/command/commandBus.core.js

@@ -0,0 +1,177 @@
+import { BaseError, ErrorCategory, ErrorCode, ErrorSeverity, } from "@zudojs/errors";
+import { CommandHandler, executeCommandHandler, } from "../command/commandHandler.core.js";
+/**
+ * Command bus implementation.
+ *
+ * The command bus resolves a handler by command type and executes it
+ * through the registered middleware pipeline.
+ */
+export class CommandBus {
+    handlers = new Map();
+    middleware;
+    contextFactory;
+    constructor(options = {}) {
+        this.middleware = [...(options.middleware ?? [])];
+        this.contextFactory = options.contextFactory;
+    }
+    /**
+     * Registers a command handler.
+     */
+    register(commandType, handler) {
+        if (!commandType.trim()) {
+            throw new TypeError("Command type cannot be empty.");
+        }
+        if (!handler) {
+            throw new TypeError(`A handler is required for command "${commandType}".`);
+        }
+        if (this.handlers.has(commandType)) {
+            throw new Error(`A handler is already registered for command "${commandType}".`);
+        }
+        this.handlers.set(commandType, handler);
+        return this;
+    }
+    /**
+     * Registers multiple command handlers.
+     */
+    registerMany(registrations) {
+        for (const registration of registrations) {
+            this.register(registration.commandType, registration.handler);
+        }
+        return this;
+    }
+    /**
+     * Replaces an existing command handler.
+     */
+    replace(commandType, handler) {
+        if (!commandType.trim()) {
+            throw new TypeError("Command type cannot be empty.");
+        }
+        this.handlers.set(commandType, handler);
+        return this;
+    }
+    /**
+     * Removes a command handler.
+     */
+    unregister(commandType) {
+        return this.handlers.delete(commandType);
+    }
+    /**
+     * Determines whether a command handler is registered.
+     */
+    has(commandType) {
+        return this.handlers.has(commandType);
+    }
+    /**
+     * Returns the registered handler for a command type.
+     */
+    getHandler(commandType) {
+        return this.handlers.get(commandType);
+    }
+    /**
+     * Executes a command.
+     */
+    async execute(command, context) {
+        this.validateCommand(command);
+        const handler = this.getHandler(command.type);
+        if (!handler) {
+            throw new BaseError(`No handler is registered for command "${command.type}".`, {
+                code: ErrorCode.COMMAND_HANDLER_NOT_FOUND,
+                category: ErrorCategory.SYSTEM,
+                severity: ErrorSeverity.ERROR,
+                statusCode: 500,
+                expose: false,
+                isOperational: true,
+                metadata: {
+                    commandType: command.type,
+                },
+            });
+        }
+        const executionContext = await this.resolveContext(context);
+        const pipeline = this.buildPipeline(handler);
+        return pipeline(command, executionContext);
+    }
+    /**
+     * Adds middleware to the end of the pipeline.
+     */
+    use(middleware) {
+        if (typeof middleware !== "function") {
+            throw new TypeError("Command middleware must be a function.");
+        }
+        this.middleware.push(middleware);
+        return this;
+    }
+    /**
+     * Returns the number of registered handlers.
+     */
+    size() {
+        return this.handlers.size;
+    }
+    /**
+     * Removes all registered handlers.
+     */
+    clear() {
+        this.handlers.clear();
+    }
+    /**
+     * Returns all registered command types.
+     */
+    getCommandTypes() {
+        return [...this.handlers.keys()];
+    }
+    /**
+     * Builds the command execution pipeline.
+     */
+    buildPipeline(handler) {
+        let next = async (command, context) => executeCommandHandler(handler, command, context);
+        for (let index = this.middleware.length - 1; index >= 0; index--) {
+            const middleware = this.middleware[index];
+            const current = next;
+            next = async (command, context) => middleware(command, context, current);
+        }
+        return next;
+    }
+    /**
+     * Resolves the execution context.
+     */
+    async resolveContext(context) {
+        if (context) {
+            return context;
+        }
+        if (this.contextFactory) {
+            return await this.contextFactory();
+        }
+        return {};
+    }
+    /**
+     * Validates a command before execution.
+     */
+    validateCommand(command) {
+        if (!command || typeof command !== "object") {
+            throw new BaseError("A valid command is required.", {
+                code: ErrorCode.INVALID_COMMAND,
+                category: ErrorCategory.VALIDATION,
+                severity: ErrorSeverity.WARNING,
+                statusCode: 400,
+                expose: true,
+                isOperational: true,
+            });
+        }
+        if (typeof command.type !== "string" || command.type.trim().length === 0) {
+            throw new BaseError("Command type is required.", {
+                code: ErrorCode.INVALID_COMMAND,
+                category: ErrorCategory.VALIDATION,
+                severity: ErrorSeverity.WARNING,
+                statusCode: 400,
+                expose: true,
+                isOperational: true,
+            });
+        }
+    }
+}
+/**
+ * Creates a command bus.
+ */
+export function createCommandBus(options = {}) {
+    return new CommandBus(options);
+}
+//# sourceMappingURL=commandBus.core.js.map

package/dist/command/commandBus.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBus.core.js","sourceRoot":"","sources":["../../src/command/commandBus.core.ts"],"names":[],"mappings":"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"}

package/dist/command/commandHandler.core.d.ts

@@ -0,0 +1,43 @@
+import type { CommandHandler as CommandHandlerContract, Command, CqrsContext } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Abstract base class for command handlers.
+ *
+ * A command handler contains the application logic required to execute
+ * one specific command.
+ */
+export declare abstract class CommandHandler<TCommand extends Command = Command, TResult = void> implements CommandHandlerContract<TCommand, TResult> {
+    /**
+     * Command type handled by this handler.
+     */
+    abstract readonly commandType: TCommand["type"];
+    /**
+     * Executes the command.
+     */
+    abstract execute(command: TCommand, context?: CqrsContext): Promise<TResult> | TResult;
+}
+/**
+ * Function-based command handler implementation.
+ */
+export declare class FunctionCommandHandler<TCommand extends Command = Command, TResult = void> extends CommandHandler<TCommand, TResult> {
+    readonly commandType: TCommand["type"];
+    private readonly handler;
+    constructor(commandType: TCommand["type"], handler: (command: TCommand, context?: CqrsContext) => TResult | Promise<TResult>);
+    execute(command: TCommand, context?: CqrsContext): TResult | Promise<TResult>;
+}
+/**
+ * Creates a function-based command handler.
+ */
+export declare function createCommandHandler<TCommand extends Command, TResult = void>(commandType: TCommand["type"], handler: (command: TCommand, context?: CqrsContext) => TResult | Promise<TResult>): FunctionCommandHandler<TCommand, TResult>;
+/**
+ * Determines whether a value is a command handler instance.
+ */
+export declare function isCommandHandler(value: unknown): value is CommandHandler;
+/**
+ * Determines whether a value can be used as a command handler.
+ */
+export declare function isCommandHandlerLike(value: unknown): value is CommandHandler | ((command: Command, context?: CqrsContext) => unknown);
+/**
+ * Executes either an object-based or function-based command handler.
+ */
+export declare function executeCommandHandler<TCommand extends Command, TResult = void>(handler: CommandHandler<TCommand, TResult> | ((command: TCommand, context?: CqrsContext) => TResult | Promise<TResult>), command: TCommand, context?: CqrsContext): Promise<TResult>;
+//# sourceMappingURL=commandHandler.core.d.ts.map

package/dist/command/commandHandler.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandHandler.core.d.ts","sourceRoot":"","sources":["../../src/command/commandHandler.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,sBAAsB,EACxC,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,8BAAsB,cAAc,CAClC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,IAAI,CACd,YAAW,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC;IACpD;;OAEG;IACH,kBAAyB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAgB,OAAO,CACrB,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,sBAAsB,CACjC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,IAAI,CACd,SAAQ,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;IACzC,SAAgB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGQ;IAEhC,YACE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,CACP,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAWhC;IAEM,OAAO,CACZ,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5B;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,GAAG,IAAI,EAC3E,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,CACP,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC9B,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IACN,cAAc,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,SAAS,OAAO,EACxB,OAAO,GAAG,IAAI,EAEd,OAAO,EACH,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,GACjC,CAAC,CACC,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EACpC,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/command/commandHandler.core.js

@@ -0,0 +1,57 @@
+/**
+ * Abstract base class for command handlers.
+ *
+ * A command handler contains the application logic required to execute
+ * one specific command.
+ */
+export class CommandHandler {
+}
+/**
+ * Function-based command handler implementation.
+ */
+export class FunctionCommandHandler extends CommandHandler {
+    commandType;
+    handler;
+    constructor(commandType, handler) {
+        super();
+        if (typeof handler !== "function") {
+            throw new TypeError("Command handler must be a function.");
+        }
+        this.commandType = commandType;
+        this.handler = handler;
+    }
+    execute(command, context) {
+        return this.handler(command, context);
+    }
+}
+/**
+ * Creates a function-based command handler.
+ */
+export function createCommandHandler(commandType, handler) {
+    return new FunctionCommandHandler(commandType, handler);
+}
+/**
+ * Determines whether a value is a command handler instance.
+ */
+export function isCommandHandler(value) {
+    return value instanceof CommandHandler;
+}
+/**
+ * Determines whether a value can be used as a command handler.
+ */
+export function isCommandHandlerLike(value) {
+    return value instanceof CommandHandler || typeof value === "function";
+}
+/**
+ * Executes either an object-based or function-based command handler.
+ */
+export async function executeCommandHandler(handler, command, context) {
+    if (handler instanceof CommandHandler) {
+        return await handler.execute(command, context);
+    }
+    if (typeof handler === "function") {
+        return await handler(command, context);
+    }
+    throw new TypeError(`Invalid command handler for "${command.type}".`);
+}
+//# sourceMappingURL=commandHandler.core.js.map

package/dist/command/commandHandler.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandHandler.core.js","sourceRoot":"","sources":["../../src/command/commandHandler.core.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAgB,cAAc;CAgBnC;AAED;;GAEG;AACH,MAAM,OAAO,sBAGX,SAAQ,cAAiC;IACzB,WAAW,CAAmB;IAE7B,OAAO,CAGQ;IAEhC,YACE,WAA6B,EAC7B,OAG+B;QAE/B,KAAK,EAAE,CAAC;QAER,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,OAAO,CACZ,OAAiB,EACjB,OAAqB;QAErB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA6B,EAC7B,OAG+B;IAE/B,OAAO,IAAI,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAGd,OAAO,KAAK,YAAY,cAAc,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAIzC,OAKoC,EACpC,OAAiB,EACjB,OAAqB;IAErB,IAAI,OAAO,YAAY,cAAc,EAAE,CAAC;QACtC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,gCAAgC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/command/commandResult.type.d.ts

@@ -0,0 +1,57 @@
+import type { Command } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Status of a command execution.
+ */
+export type CommandResultStatus = "success" | "failure";
+/**
+ * Result returned after command execution.
+ *
+ * Command handlers may return any domain-specific value, while this
+ * wrapper provides consistent execution metadata for infrastructure
+ * consumers.
+ */
+export interface CommandResult<TResult = void, TCommand extends Command = Command> {
+    readonly status: CommandResultStatus;
+    readonly result: TResult;
+    readonly commandType: TCommand["type"];
+    readonly executedAt: Date;
+    readonly durationMs?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Options for creating a command result.
+ */
+export interface CreateCommandResultOptions<TCommand extends Command = Command> {
+    readonly command: TCommand;
+    readonly executedAt?: Date;
+    readonly durationMs?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Creates a successful command result.
+ */
+export declare function createCommandResult<TResult, TCommand extends Command>(result: TResult, options: CreateCommandResultOptions<TCommand>): CommandResult<TResult, TCommand>;
+/**
+ * Creates a failed command result.
+ *
+ * This helper is intended for infrastructure that represents failures
+ * as values. Command buses normally throw errors instead.
+ */
+export declare function createFailedCommandResult<TResult = void, TCommand extends Command = Command>(result: TResult, options: CreateCommandResultOptions<TCommand>): CommandResult<TResult, TCommand>;
+/**
+ * Determines whether a command result represents success.
+ */
+export declare function isSuccessfulCommandResult<TResult, TCommand extends Command = Command>(result: CommandResult<TResult, TCommand>): boolean;
+/**
+ * Determines whether a command result represents failure.
+ */
+export declare function isFailedCommandResult<TResult, TCommand extends Command = Command>(result: CommandResult<TResult, TCommand>): boolean;
+/**
+ * Maps a command result to its underlying value.
+ */
+export declare function unwrapCommandResult<TResult, TCommand extends Command = Command>(result: CommandResult<TResult, TCommand>): TResult;
+/**
+ * Adds execution metadata to an existing command result.
+ */
+export declare function withCommandResultMetadata<TResult, TCommand extends Command = Command>(result: CommandResult<TResult, TCommand>, metadata: Readonly<Record<string, unknown>>): CommandResult<TResult, TCommand>;
+//# sourceMappingURL=commandResult.type.d.ts.map

package/dist/command/commandResult.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandResult.type.d.ts","sourceRoot":"","sources":["../../src/command/commandResult.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAC5B,OAAO,GAAG,IAAI,EACd,QAAQ,SAAS,OAAO,GAAG,OAAO;IAElC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CACzC,QAAQ,SAAS,OAAO,GAAG,OAAO;IAElC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,SAAS,OAAO,EACnE,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,GAC5C,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAmBlC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAG,IAAI,EACd,QAAQ,SAAS,OAAO,GAAG,OAAO,EAElC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,GAC5C,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAmBlC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EACP,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EACP,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EACP,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EACP,QAAQ,SAAS,OAAO,GAAG,OAAO,EAElC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,EACxC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAUlC"}