@zudojs/cqrs 0.0.1

package/dist/cqrsDecorators/cqrsDecorators.core.js

@@ -0,0 +1,181 @@
+/**
+ * Metadata key used to identify CQRS handler configuration.
+ */
+const CQRS_HANDLER_METADATA = Symbol.for("zudojs.cqrs.handler");
+/**
+ * Metadata key used to identify command handler configuration.
+ */
+const COMMAND_HANDLER_METADATA = Symbol.for("zudojs.cqrs.command-handler");
+/**
+ * Metadata key used to identify query handler configuration.
+ */
+const QUERY_HANDLER_METADATA = Symbol.for("zudojs.cqrs.query-handler");
+/**
+ * Metadata key used to identify command/query type information.
+ */
+const CQRS_TYPE_METADATA = Symbol.for("zudojs.cqrs.type");
+/**
+ * Marks a class as a CQRS handler.
+ *
+ * This decorator is useful when a framework or dependency injection
+ * container needs to discover handlers automatically.
+ */
+export function CqrsHandler(kind, type) {
+    validateHandlerMetadata(kind, type);
+    return (target) => {
+        const constructor = target;
+        const metadata = Object.freeze({
+            kind,
+            type,
+        });
+        Object.defineProperty(constructor, CQRS_HANDLER_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: metadata,
+        });
+        Object.defineProperty(constructor, CQRS_TYPE_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: type,
+        });
+    };
+}
+/**
+ * Marks a class as a command handler.
+ */
+export function CommandHandler(type) {
+    validateHandlerMetadata("command", type);
+    return (target) => {
+        const constructor = target;
+        const metadata = Object.freeze({
+            kind: "command",
+            type,
+        });
+        Object.defineProperty(constructor, COMMAND_HANDLER_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: metadata,
+        });
+        Object.defineProperty(constructor, CQRS_HANDLER_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: metadata,
+        });
+        Object.defineProperty(constructor, CQRS_TYPE_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: type,
+        });
+    };
+}
+/**
+ * Marks a class as a query handler.
+ */
+export function QueryHandler(type) {
+    validateHandlerMetadata("query", type);
+    return (target) => {
+        const constructor = target;
+        const metadata = Object.freeze({
+            kind: "query",
+            type,
+        });
+        Object.defineProperty(constructor, QUERY_HANDLER_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: metadata,
+        });
+        Object.defineProperty(constructor, CQRS_HANDLER_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: metadata,
+        });
+        Object.defineProperty(constructor, CQRS_TYPE_METADATA, {
+            configurable: false,
+            enumerable: false,
+            writable: false,
+            value: type,
+        });
+    };
+}
+/**
+ * Reads generic CQRS handler metadata from a class.
+ */
+export function getCqrsHandlerMetadata(target) {
+    if (typeof target !== "function") {
+        return undefined;
+    }
+    return target[CQRS_HANDLER_METADATA] ?? undefined;
+}
+/**
+ * Reads command handler metadata from a class.
+ */
+export function getCommandHandlerMetadata(target) {
+    if (typeof target !== "function") {
+        return undefined;
+    }
+    return target[COMMAND_HANDLER_METADATA] ?? undefined;
+}
+/**
+ * Reads query handler metadata from a class.
+ */
+export function getQueryHandlerMetadata(target) {
+    if (typeof target !== "function") {
+        return undefined;
+    }
+    return target[QUERY_HANDLER_METADATA] ?? undefined;
+}
+/**
+ * Reads the CQRS type discriminator from a class.
+ */
+export function getCqrsType(target) {
+    if (typeof target !== "function") {
+        return undefined;
+    }
+    return target[CQRS_TYPE_METADATA] ?? undefined;
+}
+/**
+ * Determines whether a class is decorated as a CQRS handler.
+ */
+export function isCqrsHandler(target) {
+    return getCqrsHandlerMetadata(target) !== undefined;
+}
+/**
+ * Determines whether a class is decorated as a command handler.
+ */
+export function isCommandHandler(target) {
+    return getCommandHandlerMetadata(target) !== undefined;
+}
+/**
+ * Determines whether a class is decorated as a query handler.
+ */
+export function isQueryHandler(target) {
+    return getQueryHandlerMetadata(target) !== undefined;
+}
+/**
+ * Creates a reusable command handler decorator.
+ */
+export function createCommandHandlerDecorator(type) {
+    return CommandHandler(type);
+}
+/**
+ * Creates a reusable query handler decorator.
+ */
+export function createQueryHandlerDecorator(type) {
+    return QueryHandler(type);
+}
+/**
+ * Validates decorator arguments.
+ */
+function validateHandlerMetadata(kind, type) {
+    if (typeof type !== "string" || type.trim().length === 0) {
+        throw new TypeError(`${kind} handler type cannot be empty.`);
+    }
+}
+//# sourceMappingURL=cqrsDecorators.core.js.map

package/dist/cqrsDecorators/cqrsDecorators.core.js.map

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

package/dist/cqrsDecorators/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsDecorators
+ *
+ * TypeScript decorators for CQRS handler metadata.
+ */
+export * from "./cqrsDecorators.core.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cqrsDecorators/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsDecorators
+ *
+ * TypeScript decorators for CQRS handler metadata.
+ */
+export * from "./cqrsDecorators.core.js";
+//# sourceMappingURL=index.js.map

package/dist/cqrsDecorators/index.js.map

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

package/dist/cqrsErrors/cqrsError.base.d.ts

@@ -0,0 +1,85 @@
+import { BaseError, type ErrorMetadata } from "@zudojs/errors";
+/**
+ * Base error for failures originating from the CQRS package.
+ */
+export declare class CqrsError extends BaseError {
+    constructor(message: string, options?: ConstructorParameters<typeof BaseError>[1]);
+}
+/**
+ * Thrown when a CQRS request is invalid.
+ */
+export declare class CqrsValidationError extends CqrsError {
+    constructor(message?: string, metadata?: ErrorMetadata);
+}
+/**
+ * Thrown when a command handler cannot be resolved.
+ */
+export declare class CommandHandlerNotFoundError extends CqrsError {
+    readonly commandType: string;
+    constructor(commandType: string);
+}
+/**
+ * Thrown when a query handler cannot be resolved.
+ */
+export declare class QueryHandlerNotFoundError extends CqrsError {
+    readonly queryType: string;
+    constructor(queryType: string);
+}
+/**
+ * Thrown when an event handler fails during publication.
+ */
+export declare class EventHandlerExecutionError extends CqrsError {
+    readonly eventType: string;
+    readonly eventId?: string;
+    constructor(eventType: string, eventId?: string, cause?: unknown);
+}
+/**
+ * Thrown when attempting to register a duplicate handler.
+ */
+export declare class DuplicateHandlerError extends CqrsError {
+    readonly handlerKind: "command" | "query";
+    readonly handlerType: string;
+    constructor(handlerKind: "command" | "query", handlerType: string);
+}
+/**
+ * Thrown when an event cannot be published.
+ */
+export declare class EventPublishError extends CqrsError {
+    readonly eventType: string;
+    readonly eventId?: string;
+    constructor(eventType: string, eventId?: string, cause?: unknown);
+}
+/**
+ * Thrown when a handler is registered with an invalid type.
+ */
+export declare class InvalidHandlerTypeError extends CqrsValidationError {
+    readonly handlerKind: "command" | "query" | "event";
+    constructor(handlerKind: "command" | "query" | "event", handlerType: unknown);
+}
+/**
+ * Thrown when CQRS middleware is invalid.
+ */
+export declare class InvalidMiddlewareError extends CqrsValidationError {
+    constructor(message?: string, metadata?: ErrorMetadata);
+}
+/**
+ * Thrown when middleware invokes next() more than once.
+ */
+export declare class MiddlewareExecutionError extends CqrsError {
+    constructor(message?: string, cause?: unknown);
+}
+/**
+ * Thrown when a CQRS handler has not been configured correctly.
+ */
+export declare class HandlerConfigurationError extends CqrsError {
+    constructor(message?: string, metadata?: ErrorMetadata);
+}
+/**
+ * Determines whether an unknown value is a CQRS error.
+ */
+export declare function isCqrsError(error: unknown): error is CqrsError;
+/**
+ * Converts an unknown error into a CQRS error.
+ */
+export declare function toCqrsError(error: unknown, message?: string): CqrsError;
+//# sourceMappingURL=cqrsError.base.d.ts.map

package/dist/cqrsErrors/cqrsError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrsError.base.d.ts","sourceRoot":"","sources":["../../src/cqrsErrors/cqrsError.base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAIT,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAAqB,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAM,EAWzD;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,YACE,OAAO,SAAiC,EACxC,QAAQ,CAAC,EAAE,aAAa,EAWzB;CACF;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,SAAS;IACxD,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,YAAY,WAAW,EAAE,MAAM,EAc9B;CACF;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;IACtD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,SAAS,EAAE,MAAM,EAc5B;CACF;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC,YAAY,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAkB/D;CACF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,SAAgB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IAEjD,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,YAAY,WAAW,EAAE,SAAS,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,EAoBhE;CACF;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC,YAAY,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAkB/D;CACF;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,SAAgB,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAE3D,YACE,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,EAC1C,WAAW,EAAE,OAAO,EAQrB;CACF;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,YAAY,OAAO,SAA6B,EAAE,QAAQ,CAAC,EAAE,aAAa,EAEzE;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,YACE,OAAO,SAAkD,EACzD,KAAK,CAAC,EAAE,OAAO,EAWhB;CACF;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;IACtD,YACE,OAAO,SAAgD,EACvD,QAAQ,CAAC,EAAE,aAAa,EAWzB;CACF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,SAA2B,GACjC,SAAS,CAcX"}

package/dist/cqrsErrors/cqrsError.base.js

@@ -0,0 +1,221 @@
+import { BaseError, ErrorCategory, ErrorCode, ErrorSeverity, } from "@zudojs/errors";
+/**
+ * Base error for failures originating from the CQRS package.
+ */
+export class CqrsError extends BaseError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.code ?? ErrorCode.INTERNAL_ERROR,
+            category: options.category ?? ErrorCategory.SYSTEM,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+            ...options,
+        });
+    }
+}
+/**
+ * Thrown when a CQRS request is invalid.
+ */
+export class CqrsValidationError extends CqrsError {
+    constructor(message = "The CQRS request is invalid.", metadata) {
+        super(message, {
+            code: ErrorCode.INVALID_INPUT,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.WARNING,
+            statusCode: 400,
+            expose: true,
+            isOperational: true,
+            metadata: metadata,
+        });
+    }
+}
+/**
+ * Thrown when a command handler cannot be resolved.
+ */
+export class CommandHandlerNotFoundError extends CqrsError {
+    commandType;
+    constructor(commandType) {
+        super(`No command handler is registered for "${commandType}".`, {
+            code: ErrorCode.COMMAND_HANDLER_NOT_FOUND,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            metadata: {
+                commandType,
+            },
+        });
+        this.commandType = commandType;
+    }
+}
+/**
+ * Thrown when a query handler cannot be resolved.
+ */
+export class QueryHandlerNotFoundError extends CqrsError {
+    queryType;
+    constructor(queryType) {
+        super(`No query handler is registered for "${queryType}".`, {
+            code: ErrorCode.QUERY_HANDLER_NOT_FOUND,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            metadata: {
+                queryType,
+            },
+        });
+        this.queryType = queryType;
+    }
+}
+/**
+ * Thrown when an event handler fails during publication.
+ */
+export class EventHandlerExecutionError extends CqrsError {
+    eventType;
+    eventId;
+    constructor(eventType, eventId, cause) {
+        super(`An event handler failed while processing "${eventType}".`, {
+            code: ErrorCode.EVENT_HANDLER_FAILED,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            cause,
+            metadata: {
+                eventType,
+                eventId,
+            },
+        });
+        this.eventType = eventType;
+        this.eventId = eventId;
+    }
+}
+/**
+ * Thrown when attempting to register a duplicate handler.
+ */
+export class DuplicateHandlerError extends CqrsError {
+    handlerKind;
+    handlerType;
+    constructor(handlerKind, handlerType) {
+        super(`A ${handlerKind} handler is already registered for "${handlerType}".`, {
+            code: ErrorCode.CONFLICT,
+            category: ErrorCategory.CONFLICT,
+            severity: ErrorSeverity.WARNING,
+            statusCode: 409,
+            expose: true,
+            isOperational: true,
+            metadata: {
+                handlerKind,
+                handlerType,
+            },
+        });
+        this.handlerKind = handlerKind;
+        this.handlerType = handlerType;
+    }
+}
+/**
+ * Thrown when an event cannot be published.
+ */
+export class EventPublishError extends CqrsError {
+    eventType;
+    eventId;
+    constructor(eventType, eventId, cause) {
+        super(`Failed to publish event "${eventType}".`, {
+            code: ErrorCode.EVENT_HANDLER_FAILED,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            cause,
+            metadata: {
+                eventType,
+                eventId,
+            },
+        });
+        this.eventType = eventType;
+        this.eventId = eventId;
+    }
+}
+/**
+ * Thrown when a handler is registered with an invalid type.
+ */
+export class InvalidHandlerTypeError extends CqrsValidationError {
+    handlerKind;
+    constructor(handlerKind, handlerType) {
+        super(`Invalid ${handlerKind} handler type: "${String(handlerType)}".`, {
+            handlerKind,
+            handlerType: String(handlerType),
+        });
+        this.handlerKind = handlerKind;
+    }
+}
+/**
+ * Thrown when CQRS middleware is invalid.
+ */
+export class InvalidMiddlewareError extends CqrsValidationError {
+    constructor(message = "Invalid CQRS middleware.", metadata) {
+        super(message, metadata);
+    }
+}
+/**
+ * Thrown when middleware invokes next() more than once.
+ */
+export class MiddlewareExecutionError extends CqrsError {
+    constructor(message = "CQRS middleware called next() more than once.", cause) {
+        super(message, {
+            code: ErrorCode.INTERNAL_ERROR,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            cause,
+        });
+    }
+}
+/**
+ * Thrown when a CQRS handler has not been configured correctly.
+ */
+export class HandlerConfigurationError extends CqrsError {
+    constructor(message = "The CQRS handler is incorrectly configured.", metadata) {
+        super(message, {
+            code: ErrorCode.CONFIGURATION_ERROR,
+            category: ErrorCategory.CONFIGURATION,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: true,
+            metadata: metadata,
+        });
+    }
+}
+/**
+ * Determines whether an unknown value is a CQRS error.
+ */
+export function isCqrsError(error) {
+    return error instanceof CqrsError;
+}
+/**
+ * Converts an unknown error into a CQRS error.
+ */
+export function toCqrsError(error, message = "CQRS execution failed.") {
+    if (error instanceof CqrsError) {
+        return error;
+    }
+    return new CqrsError(error instanceof Error ? error.message : message, {
+        code: ErrorCode.INTERNAL_ERROR,
+        category: ErrorCategory.SYSTEM,
+        severity: ErrorSeverity.ERROR,
+        statusCode: 500,
+        expose: false,
+        isOperational: false,
+        cause: error,
+    });
+}
+//# sourceMappingURL=cqrsError.base.js.map

package/dist/cqrsErrors/cqrsError.base.js.map

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

package/dist/cqrsErrors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsErrors
+ *
+ * CQRS-specific error types extending BaseError.
+ */
+export * from "./cqrsError.base.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cqrsErrors/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/cqrsErrors
+ *
+ * CQRS-specific error types extending BaseError.
+ */
+export * from "./cqrsError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/cqrsErrors/index.js.map

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

package/dist/cqrsEvents/cqrsEventBus.core.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CQRS event bus.
+ *
+ * Re-exports the Zudojs EventBus and factory functions.
+ * The base EventBus supports all CQRS publishing needs with
+ * middleware, registry, and emitter infrastructure.
+ */
+export { EventBus, type EventBusOptions, type EventPublishResult, createEventBus, createStartedEventBus, type PublishOptions, EventBusState, type EventBusEvent, type EventBusListener, } from "@zudojs/events";
+//# sourceMappingURL=cqrsEventBus.core.d.ts.map

package/dist/cqrsEvents/cqrsEventBus.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrsEventBus.core.d.ts","sourceRoot":"","sources":["../../src/cqrsEvents/cqrsEventBus.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,cAAc,EACd,qBAAqB,EACrB,KAAK,cAAc,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/cqrsEvents/cqrsEventBus.core.js

@@ -0,0 +1,9 @@
+/**
+ * CQRS event bus.
+ *
+ * Re-exports the Zudojs EventBus and factory functions.
+ * The base EventBus supports all CQRS publishing needs with
+ * middleware, registry, and emitter infrastructure.
+ */
+export { EventBus, createEventBus, createStartedEventBus, EventBusState, } from "@zudojs/events";
+//# sourceMappingURL=cqrsEventBus.core.js.map

package/dist/cqrsEvents/cqrsEventBus.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrsEventBus.core.js","sourceRoot":"","sources":["../../src/cqrsEvents/cqrsEventBus.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,QAAQ,EAGR,cAAc,EACd,qBAAqB,EAErB,aAAa,GAGd,MAAM,gBAAgB,CAAC"}

package/dist/cqrsEvents/cqrsEventResult.type.d.ts

@@ -0,0 +1,81 @@
+import type { Event } from "@zudojs/events";
+/**
+ * Status of an event publication.
+ */
+export type EventResultStatus = "published" | "partial" | "failed";
+/**
+ * Result returned after publishing an event.
+ *
+ * This represents the outcome of event dispatching, not the business
+ * result of the event itself.
+ */
+export interface EventResult<TEvent extends Event = Event> {
+    readonly status: EventResultStatus;
+    readonly eventType: TEvent["type"];
+    readonly eventId: string;
+    readonly handlerCount: number;
+    readonly successfulHandlers: number;
+    readonly failedHandlers: number;
+    readonly publishedAt: Date;
+    readonly durationMs?: number;
+    readonly errors?: readonly unknown[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Options used to create an event result.
+ */
+export interface CreateEventResultOptions<TEvent extends Event = Event> {
+    readonly event: TEvent;
+    readonly handlerCount: number;
+    readonly successfulHandlers?: number;
+    readonly failedHandlers?: number;
+    readonly publishedAt?: Date;
+    readonly durationMs?: number;
+    readonly errors?: readonly unknown[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Creates an event publication result.
+ */
+export declare function createEventResult<TEvent extends Event>(options: CreateEventResultOptions<TEvent>): EventResult<TEvent>;
+/**
+ * Creates a result for a completely successful publication.
+ */
+export declare function createSuccessfulEventResult<TEvent extends Event>(event: TEvent, handlerCount: number, options?: Omit<CreateEventResultOptions<TEvent>, "event" | "handlerCount" | "successfulHandlers" | "failedHandlers">): EventResult<TEvent>;
+/**
+ * Creates a result for a partially successful publication.
+ */
+export declare function createPartialEventResult<TEvent extends Event>(event: TEvent, handlerCount: number, successfulHandlers: number, failedHandlers: number, options?: Omit<CreateEventResultOptions<TEvent>, "event" | "handlerCount" | "successfulHandlers" | "failedHandlers">): EventResult<TEvent>;
+/**
+ * Creates a result for a completely failed publication.
+ */
+export declare function createFailedEventResult<TEvent extends Event>(event: TEvent, handlerCount: number, errors?: readonly unknown[], options?: Omit<CreateEventResultOptions<TEvent>, "event" | "handlerCount" | "successfulHandlers" | "failedHandlers" | "errors">): EventResult<TEvent>;
+/**
+ * Determines whether an event was published successfully.
+ */
+export declare function isEventPublished<TEvent extends Event>(result: EventResult<TEvent>): boolean;
+/**
+ * Determines whether event publication partially succeeded.
+ */
+export declare function isEventPartiallyPublished<TEvent extends Event>(result: EventResult<TEvent>): boolean;
+/**
+ * Determines whether event publication failed.
+ */
+export declare function isEventFailed<TEvent extends Event>(result: EventResult<TEvent>): boolean;
+/**
+ * Determines whether any event handlers failed.
+ */
+export declare function hasEventHandlerFailures<TEvent extends Event>(result: EventResult<TEvent>): boolean;
+/**
+ * Determines whether every registered handler succeeded.
+ */
+export declare function allEventHandlersSucceeded<TEvent extends Event>(result: EventResult<TEvent>): boolean;
+/**
+ * Returns the errors captured during publication.
+ */
+export declare function getEventErrors<TEvent extends Event>(result: EventResult<TEvent>): readonly unknown[];
+/**
+ * Adds metadata to an event result.
+ */
+export declare function withEventResultMetadata<TEvent extends Event>(result: EventResult<TEvent>, metadata: Readonly<Record<string, unknown>>): EventResult<TEvent>;
+//# sourceMappingURL=cqrsEventResult.type.d.ts.map