@zudojs/cqrs 0.0.1

package/dist/command/commandResult.type.js

@@ -0,0 +1,86 @@
+/**
+ * Creates a successful command result.
+ */
+export function createCommandResult(result, options) {
+    const command = options.command;
+    validateCommand(command);
+    const commandResult = {
+        status: "success",
+        result,
+        commandType: command.type,
+        executedAt: options.executedAt ?? new Date(),
+        durationMs: options.durationMs,
+        metadata: options.metadata
+            ? Object.freeze({
+                ...options.metadata,
+            })
+            : undefined,
+    };
+    return Object.freeze(commandResult);
+}
+/**
+ * Creates a failed command result.
+ *
+ * This helper is intended for infrastructure that represents failures
+ * as values. Command buses normally throw errors instead.
+ */
+export function createFailedCommandResult(result, options) {
+    const command = options.command;
+    validateCommand(command);
+    const commandResult = {
+        status: "failure",
+        result,
+        commandType: command.type,
+        executedAt: options.executedAt ?? new Date(),
+        durationMs: options.durationMs,
+        metadata: options.metadata
+            ? Object.freeze({
+                ...options.metadata,
+            })
+            : undefined,
+    };
+    return Object.freeze(commandResult);
+}
+/**
+ * Determines whether a command result represents success.
+ */
+export function isSuccessfulCommandResult(result) {
+    return result.status === "success";
+}
+/**
+ * Determines whether a command result represents failure.
+ */
+export function isFailedCommandResult(result) {
+    return result.status === "failure";
+}
+/**
+ * Maps a command result to its underlying value.
+ */
+export function unwrapCommandResult(result) {
+    return result.result;
+}
+/**
+ * Adds execution metadata to an existing command result.
+ */
+export function withCommandResultMetadata(result, metadata) {
+    const merged = {
+        ...result,
+        metadata: Object.freeze({
+            ...(result.metadata ?? {}),
+            ...metadata,
+        }),
+    };
+    return Object.freeze(merged);
+}
+/**
+ * Validates the command portion of a command result.
+ */
+function validateCommand(command) {
+    if (!command || typeof command !== "object") {
+        throw new TypeError("A valid command is required to create a command result.");
+    }
+    if (typeof command.type !== "string" || command.type.trim().length === 0) {
+        throw new TypeError("Command type is required to create a command result.");
+    }
+}
+//# sourceMappingURL=commandResult.type.js.map

package/dist/command/commandResult.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandResult.type.js","sourceRoot":"","sources":["../../src/command/commandResult.type.ts"],"names":[],"mappings":"AAsCA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAe,EACf,OAA6C;IAE7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,eAAe,CAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,aAAa,GAAqC;QACtD,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE;QAC5C,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YACxB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,OAAO,CAAC,QAAQ;aACpB,CAAC;YACJ,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAIvC,MAAe,EACf,OAA6C;IAE7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,eAAe,CAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,aAAa,GAAqC;QACtD,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE;QAC5C,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YACxB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,OAAO,CAAC,QAAQ;aACpB,CAAC;YACJ,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAGvC,MAAwC;IACxC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAGnC,MAAwC;IACxC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAGjC,MAAwC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAIvC,MAAwC,EACxC,QAA2C;IAE3C,MAAM,MAAM,GAAqC;QAC/C,GAAG,MAAM;QACT,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC1B,GAAG,QAAQ;SACZ,CAAC;KACH,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,SAAS,CACjB,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/command/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/cqrs/command
+ *
+ * Command implementation: abstract command, handler, bus, and result types.
+ */
+export * from "./command.core.js";
+export * from "./commandHandler.core.js";
+export * from "./commandBus.core.js";
+export * from "./commandResult.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/command/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/cqrs/command
+ *
+ * Command implementation: abstract command, handler, bus, and result types.
+ */
+export * from "./command.core.js";
+export * from "./commandHandler.core.js";
+export * from "./commandBus.core.js";
+export * from "./commandResult.type.js";
+//# sourceMappingURL=index.js.map

package/dist/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/cqrsContext/cqrsContext.core.d.ts

@@ -0,0 +1,97 @@
+import type { CqrsContext } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Standard execution context for CQRS operations.
+ *
+ * The context carries request-scoped information without coupling
+ * commands, queries, or events to a specific transport.
+ */
+export interface CqrsExecutionContext extends CqrsContext {
+    readonly requestId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly userId?: string;
+    readonly tenantId?: string;
+    readonly source?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Input used to create an execution context.
+ */
+export interface CreateExecutionContextInput {
+    readonly requestId?: string;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+    readonly userId?: string;
+    readonly tenantId?: string;
+    readonly source?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Creates a unique request identifier.
+ */
+export declare function createRequestId(): string;
+/**
+ * Creates an immutable CQRS execution context.
+ */
+export declare function createExecutionContext(input?: CreateExecutionContextInput): CqrsExecutionContext;
+/**
+ * Creates a child execution context while preserving correlation data.
+ */
+export declare function createChildExecutionContext(parent: CqrsExecutionContext, overrides?: CreateExecutionContextInput): CqrsExecutionContext;
+/**
+ * Adds metadata to an execution context.
+ */
+export declare function withContextMetadata(context: CqrsExecutionContext, metadata: Readonly<Record<string, unknown>>): CqrsExecutionContext;
+/**
+ * Adds or replaces the current user identity.
+ */
+export declare function withUser(context: CqrsExecutionContext, userId: string): CqrsExecutionContext;
+/**
+ * Adds or replaces the current tenant identity.
+ */
+export declare function withTenant(context: CqrsExecutionContext, tenantId: string): CqrsExecutionContext;
+/**
+ * Adds or replaces the source of the CQRS operation.
+ */
+export declare function withSource(context: CqrsExecutionContext, source: string): CqrsExecutionContext;
+/**
+ * Returns the request ID from the context.
+ */
+export declare function getRequestId(context?: CqrsExecutionContext): string | undefined;
+/**
+ * Returns the correlation ID from the context.
+ */
+export declare function getCorrelationId(context?: CqrsExecutionContext): string | undefined;
+/**
+ * Returns the causation ID from the context.
+ */
+export declare function getCausationId(context?: CqrsExecutionContext): string | undefined;
+/**
+ * Returns the current user ID.
+ */
+export declare function getUserId(context?: CqrsExecutionContext): string | undefined;
+/**
+ * Returns the current tenant ID.
+ */
+export declare function getTenantId(context?: CqrsExecutionContext): string | undefined;
+/**
+ * Returns a context metadata value.
+ */
+export declare function getContextMetadata<T = unknown>(context: CqrsExecutionContext | undefined, key: string): T | undefined;
+/**
+ * Determines whether the context has a user identity.
+ */
+export declare function hasUser(context?: CqrsExecutionContext): boolean;
+/**
+ * Determines whether the context has a tenant identity.
+ */
+export declare function hasTenant(context?: CqrsExecutionContext): boolean;
+/**
+ * Determines whether two contexts belong to the same correlation chain.
+ */
+export declare function sharesCorrelation(first?: CqrsExecutionContext, second?: CqrsExecutionContext): boolean;
+/**
+ * Converts an execution context into a plain serializable object.
+ */
+export declare function serializeExecutionContext(context: CqrsExecutionContext): Record<string, unknown>;
+//# sourceMappingURL=cqrsContext.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cqrsContext.core.d.ts","sourceRoot":"","sources":["../../src/cqrsContext/cqrsContext.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,2BAAgC,GACtC,oBAAoB,CAgBtB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,SAAS,GAAE,2BAAgC,GAC1C,oBAAoB,CActB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,oBAAoB,CAQtB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,MAAM,GACb,oBAAoB,CAStB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAStB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,MAAM,GACb,oBAAoB,CAStB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAC5C,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,SAAS,CAEf;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/cqrsContext/cqrsContext.core.js

@@ -0,0 +1,171 @@
+/**
+ * Creates a unique request identifier.
+ */
+export function createRequestId() {
+    if (typeof globalThis.crypto?.randomUUID === "function") {
+        return globalThis.crypto.randomUUID();
+    }
+    return `${Date.now().toString(36)}-${Math.random()
+        .toString(36)
+        .slice(2, 15)}`;
+}
+/**
+ * Creates an immutable CQRS execution context.
+ */
+export function createExecutionContext(input = {}) {
+    const context = {
+        requestId: input.requestId ?? createRequestId(),
+        correlationId: input.correlationId,
+        causationId: input.causationId,
+        userId: input.userId,
+        tenantId: input.tenantId,
+        source: input.source,
+        metadata: input.metadata
+            ? Object.freeze({
+                ...input.metadata,
+            })
+            : undefined,
+    };
+    return Object.freeze(context);
+}
+/**
+ * Creates a child execution context while preserving correlation data.
+ */
+export function createChildExecutionContext(parent, overrides = {}) {
+    return createExecutionContext({
+        requestId: overrides.requestId,
+        correlationId: overrides.correlationId ?? parent.correlationId,
+        causationId: overrides.causationId ?? parent.requestId ?? parent.causationId,
+        userId: overrides.userId ?? parent.userId,
+        tenantId: overrides.tenantId ?? parent.tenantId,
+        source: overrides.source ?? parent.source,
+        metadata: {
+            ...(parent.metadata ?? {}),
+            ...(overrides.metadata ?? {}),
+        },
+    });
+}
+/**
+ * Adds metadata to an execution context.
+ */
+export function withContextMetadata(context, metadata) {
+    return Object.freeze({
+        ...context,
+        metadata: Object.freeze({
+            ...(context.metadata ?? {}),
+            ...metadata,
+        }),
+    });
+}
+/**
+ * Adds or replaces the current user identity.
+ */
+export function withUser(context, userId) {
+    if (!userId.trim()) {
+        throw new TypeError("User ID cannot be empty.");
+    }
+    return Object.freeze({
+        ...context,
+        userId,
+    });
+}
+/**
+ * Adds or replaces the current tenant identity.
+ */
+export function withTenant(context, tenantId) {
+    if (!tenantId.trim()) {
+        throw new TypeError("Tenant ID cannot be empty.");
+    }
+    return Object.freeze({
+        ...context,
+        tenantId,
+    });
+}
+/**
+ * Adds or replaces the source of the CQRS operation.
+ */
+export function withSource(context, source) {
+    if (!source.trim()) {
+        throw new TypeError("Context source cannot be empty.");
+    }
+    return Object.freeze({
+        ...context,
+        source,
+    });
+}
+/**
+ * Returns the request ID from the context.
+ */
+export function getRequestId(context) {
+    return context?.requestId;
+}
+/**
+ * Returns the correlation ID from the context.
+ */
+export function getCorrelationId(context) {
+    return context?.correlationId;
+}
+/**
+ * Returns the causation ID from the context.
+ */
+export function getCausationId(context) {
+    return context?.causationId;
+}
+/**
+ * Returns the current user ID.
+ */
+export function getUserId(context) {
+    return context?.userId;
+}
+/**
+ * Returns the current tenant ID.
+ */
+export function getTenantId(context) {
+    return context?.tenantId;
+}
+/**
+ * Returns a context metadata value.
+ */
+export function getContextMetadata(context, key) {
+    return context?.metadata?.[key];
+}
+/**
+ * Determines whether the context has a user identity.
+ */
+export function hasUser(context) {
+    return Boolean(context?.userId);
+}
+/**
+ * Determines whether the context has a tenant identity.
+ */
+export function hasTenant(context) {
+    return Boolean(context?.tenantId);
+}
+/**
+ * Determines whether two contexts belong to the same correlation chain.
+ */
+export function sharesCorrelation(first, second) {
+    if (!first?.correlationId || !second?.correlationId) {
+        return false;
+    }
+    return first.correlationId === second.correlationId;
+}
+/**
+ * Converts an execution context into a plain serializable object.
+ */
+export function serializeExecutionContext(context) {
+    return {
+        requestId: context.requestId,
+        correlationId: context.correlationId,
+        causationId: context.causationId,
+        userId: context.userId,
+        tenantId: context.tenantId,
+        source: context.source,
+        metadata: context.metadata
+            ? {
+                ...context.metadata,
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=cqrsContext.core.js.map

package/dist/cqrsContext/cqrsContext.core.js.map

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

package/dist/cqrsContext/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsContext
+ *
+ * CQRS execution context creation and manipulation utilities.
+ */
+export * from "./cqrsContext.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cqrsContext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cqrsContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/cqrsContext/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsContext
+ *
+ * CQRS execution context creation and manipulation utilities.
+ */
+export * from "./cqrsContext.core.js";
+//# sourceMappingURL=index.js.map

package/dist/cqrsContext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cqrsContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/cqrsDecorators/cqrsDecorators.core.d.ts

@@ -0,0 +1,108 @@
+import type { Command, Query } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Metadata key used to identify CQRS handler configuration.
+ */
+declare const CQRS_HANDLER_METADATA: unique symbol;
+/**
+ * Metadata key used to identify command handler configuration.
+ */
+declare const COMMAND_HANDLER_METADATA: unique symbol;
+/**
+ * Metadata key used to identify query handler configuration.
+ */
+declare const QUERY_HANDLER_METADATA: unique symbol;
+/**
+ * Metadata key used to identify command/query type information.
+ */
+declare const CQRS_TYPE_METADATA: unique symbol;
+/**
+ * Supported CQRS handler kinds.
+ */
+export type CqrsHandlerKind = "command" | "query";
+/**
+ * Metadata attached to a CQRS handler class.
+ */
+export interface CqrsHandlerMetadata {
+    readonly kind: CqrsHandlerKind;
+    readonly type: string;
+}
+/**
+ * Metadata attached to a command handler.
+ */
+export interface CommandHandlerMetadata<TCommand extends Command = Command> extends CqrsHandlerMetadata {
+    readonly kind: "command";
+    readonly type: TCommand["type"];
+}
+/**
+ * Metadata attached to a query handler.
+ */
+export interface QueryHandlerMetadata<TQuery extends Query = Query> extends CqrsHandlerMetadata {
+    readonly kind: "query";
+    readonly type: TQuery["type"];
+}
+/**
+ * Generic constructor type used by decorators.
+ */
+export type CqrsClass<TInstance = object> = new (...args: unknown[]) => TInstance;
+/**
+ * Constructor decorated with CQRS metadata.
+ */
+export type DecoratedCqrsClass<TInstance = object> = CqrsClass<TInstance> & {
+    readonly [CQRS_HANDLER_METADATA]?: CqrsHandlerMetadata;
+    readonly [COMMAND_HANDLER_METADATA]?: CommandHandlerMetadata;
+    readonly [QUERY_HANDLER_METADATA]?: QueryHandlerMetadata;
+    readonly [CQRS_TYPE_METADATA]?: string;
+};
+/**
+ * Marks a class as a CQRS handler.
+ *
+ * This decorator is useful when a framework or dependency injection
+ * container needs to discover handlers automatically.
+ */
+export declare function CqrsHandler<TType extends string>(kind: CqrsHandlerKind, type: TType): ClassDecorator;
+/**
+ * Marks a class as a command handler.
+ */
+export declare function CommandHandler(type: string): ClassDecorator;
+/**
+ * Marks a class as a query handler.
+ */
+export declare function QueryHandler(type: string): ClassDecorator;
+/**
+ * Reads generic CQRS handler metadata from a class.
+ */
+export declare function getCqrsHandlerMetadata(target: unknown): CqrsHandlerMetadata | undefined;
+/**
+ * Reads command handler metadata from a class.
+ */
+export declare function getCommandHandlerMetadata(target: unknown): CommandHandlerMetadata | undefined;
+/**
+ * Reads query handler metadata from a class.
+ */
+export declare function getQueryHandlerMetadata(target: unknown): QueryHandlerMetadata | undefined;
+/**
+ * Reads the CQRS type discriminator from a class.
+ */
+export declare function getCqrsType(target: unknown): string | undefined;
+/**
+ * Determines whether a class is decorated as a CQRS handler.
+ */
+export declare function isCqrsHandler(target: unknown): boolean;
+/**
+ * Determines whether a class is decorated as a command handler.
+ */
+export declare function isCommandHandler(target: unknown): boolean;
+/**
+ * Determines whether a class is decorated as a query handler.
+ */
+export declare function isQueryHandler(target: unknown): boolean;
+/**
+ * Creates a reusable command handler decorator.
+ */
+export declare function createCommandHandlerDecorator(type: string): ClassDecorator;
+/**
+ * Creates a reusable query handler decorator.
+ */
+export declare function createQueryHandlerDecorator(type: string): ClassDecorator;
+export {};
+//# sourceMappingURL=cqrsDecorators.core.d.ts.map

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

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