@zudojs/cqrs 0.0.1

package/dist/handlerRegistry/handlerRegistry.core.js

@@ -0,0 +1,209 @@
+/**
+ * Central registry for CQRS command and query handlers.
+ *
+ * The registry is intentionally independent from the buses so handlers
+ * can be registered during application bootstrap and later consumed by
+ * one or more buses.
+ */
+export class HandlerRegistry {
+    commandHandlers = new Map();
+    queryHandlers = new Map();
+    /**
+     * Registers a command handler.
+     */
+    registerCommand(type, handler) {
+        this.validateType(type, "command");
+        this.validateHandler(handler, "command", type);
+        if (this.commandHandlers.has(type)) {
+            throw new Error(`A command handler is already registered for "${type}".`);
+        }
+        this.commandHandlers.set(type, handler);
+        return this;
+    }
+    /**
+     * Registers a query handler.
+     */
+    registerQuery(type, handler) {
+        this.validateType(type, "query");
+        this.validateHandler(handler, "query", type);
+        if (this.queryHandlers.has(type)) {
+            throw new Error(`A query handler is already registered for "${type}".`);
+        }
+        this.queryHandlers.set(type, handler);
+        return this;
+    }
+    /**
+     * Registers a generic handler entry.
+     */
+    register(entry) {
+        if (entry.kind === "command") {
+            return this.registerCommand(entry.type, entry.handler);
+        }
+        return this.registerQuery(entry.type, entry.handler);
+    }
+    /**
+     * Registers multiple handlers.
+     */
+    registerMany(entries) {
+        for (const entry of entries) {
+            this.register(entry);
+        }
+        return this;
+    }
+    /**
+     * Replaces a command handler.
+     */
+    replaceCommand(type, handler) {
+        this.validateType(type, "command");
+        this.validateHandler(handler, "command", type);
+        this.commandHandlers.set(type, handler);
+        return this;
+    }
+    /**
+     * Replaces a query handler.
+     */
+    replaceQuery(type, handler) {
+        this.validateType(type, "query");
+        this.validateHandler(handler, "query", type);
+        this.queryHandlers.set(type, handler);
+        return this;
+    }
+    /**
+     * Removes a command handler.
+     */
+    unregisterCommand(type) {
+        return this.commandHandlers.delete(type);
+    }
+    /**
+     * Removes a query handler.
+     */
+    unregisterQuery(type) {
+        return this.queryHandlers.delete(type);
+    }
+    /**
+     * Removes either a command or query handler.
+     */
+    unregister(kind, type) {
+        return kind === "command"
+            ? this.unregisterCommand(type)
+            : this.unregisterQuery(type);
+    }
+    /**
+     * Returns a command handler.
+     */
+    getCommandHandler(type) {
+        return this.commandHandlers.get(type);
+    }
+    /**
+     * Returns a query handler.
+     */
+    getQueryHandler(type) {
+        return this.queryHandlers.get(type);
+    }
+    /**
+     * Returns whether a command handler exists.
+     */
+    hasCommand(type) {
+        return this.commandHandlers.has(type);
+    }
+    /**
+     * Returns whether a query handler exists.
+     */
+    hasQuery(type) {
+        return this.queryHandlers.has(type);
+    }
+    /**
+     * Returns whether either kind of handler exists.
+     */
+    has(kind, type) {
+        return kind === "command" ? this.hasCommand(type) : this.hasQuery(type);
+    }
+    /**
+     * Returns all registered command types.
+     */
+    getCommandTypes() {
+        return [...this.commandHandlers.keys()];
+    }
+    /**
+     * Returns all registered query types.
+     */
+    getQueryTypes() {
+        return [...this.queryHandlers.keys()];
+    }
+    /**
+     * Returns all registered handlers.
+     */
+    getEntries() {
+        const entries = [];
+        for (const [type, handler] of this.commandHandlers) {
+            entries.push({
+                kind: "command",
+                type,
+                handler,
+            });
+        }
+        for (const [type, handler] of this.queryHandlers) {
+            entries.push({
+                kind: "query",
+                type,
+                handler,
+            });
+        }
+        return entries;
+    }
+    /**
+     * Returns the number of registered command handlers.
+     */
+    commandCount() {
+        return this.commandHandlers.size;
+    }
+    /**
+     * Returns the number of registered query handlers.
+     */
+    queryCount() {
+        return this.queryHandlers.size;
+    }
+    /**
+     * Returns the total number of handlers.
+     */
+    size() {
+        return this.commandHandlers.size + this.queryHandlers.size;
+    }
+    /**
+     * Clears all handlers.
+     */
+    clear() {
+        this.commandHandlers.clear();
+        this.queryHandlers.clear();
+    }
+    /**
+     * Clears only command handlers.
+     */
+    clearCommands() {
+        this.commandHandlers.clear();
+    }
+    /**
+     * Clears only query handlers.
+     */
+    clearQueries() {
+        this.queryHandlers.clear();
+    }
+    validateType(type, kind) {
+        if (typeof type !== "string" || type.trim().length === 0) {
+            throw new TypeError(`${kind} type cannot be empty.`);
+        }
+    }
+    validateHandler(handler, kind, type) {
+        if (typeof handler !== "function" &&
+            (typeof handler !== "object" || handler === null)) {
+            throw new TypeError(`A valid ${kind} handler is required for "${type}".`);
+        }
+    }
+}
+/**
+ * Creates a new handler registry.
+ */
+export function createHandlerRegistry() {
+    return new HandlerRegistry();
+}
+//# sourceMappingURL=handlerRegistry.core.js.map

package/dist/handlerRegistry/handlerRegistry.core.js.map

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

package/dist/handlerRegistry/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/handlerRegistry
+ *
+ * Central registry for command and query handlers.
+ */
+export * from "./handlerRegistry.core.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/handlerRegistry/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/cqrs/handlerRegistry
+ *
+ * Central registry for command and query handlers.
+ */
+export * from "./handlerRegistry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/handlerRegistry/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @zudojs/cqrs
+ *
+ * Command Query Responsibility Segregation primitives for the Zudojs framework.
+ * Provides buses, handlers, middleware, and execution infrastructure.
+ */
+export { type CqrsContext, type CommandHandlerFunction, type QueryHandlerFunction, type CommandHandlerLike, type QueryHandlerLike, type CommandMiddleware, type QueryMiddleware, type CqrsMiddleware, type CqrsRequest, type CommandHandlerRegistration, type QueryHandlerRegistration, type CqrsBusOptions, type CommandOf, type QueryOf, type CqrsRequestType, type CqrsPayload, isCqrsRequest, } from "./cqrsTypes/index.js";
+export { Command, type CommandOptions, MetadataCommand, createCommand, getCommandType, isCommand, commandType, CommandHandler, FunctionCommandHandler, createCommandHandler, isCommandHandler, isCommandHandlerLike, executeCommandHandler, CommandBus, type CommandBusOptions, type CommandRegistration, createCommandBus, type CommandResultStatus, type CommandResult, type CreateCommandResultOptions, createCommandResult, createFailedCommandResult, isSuccessfulCommandResult, isFailedCommandResult, unwrapCommandResult, withCommandResultMetadata, } from "./command/index.js";
+export { Query, type QueryOptions, MetadataQuery, createQuery, getQueryType, isQuery, queryType, QueryHandler, FunctionQueryHandler, createQueryHandler, isQueryHandler, isQueryHandlerLike, executeQueryHandler, QueryBus, type QueryBusOptions, type QueryRegistration, createQueryBus, type QueryResultStatus, type QueryResult, type CreateQueryResultOptions, createQueryResult, createFailedQueryResult, isSuccessfulQueryResult, isFailedQueryResult, unwrapQueryResult, withQueryResultMetadata, } from "./query/index.js";
+export { type Event, type EventInput, type EventDefinition, type EventType, type EventPayload, isEvent, createEvent as createBaseEvent, createEventId as createBaseEventId, } from "@zudojs/events";
+export * from "./cqrsEvents/index.js";
+export * from "./cqrsMiddleware/index.js";
+export * from "./handlerRegistry/index.js";
+export * from "./cqrsDecorators/index.js";
+export * from "./cqrsContext/index.js";
+export * from "./cqrsErrors/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,EACL,KAAK,YAAY,EACjB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,OAAO,EACP,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,OAAO,EACP,WAAW,IAAI,eAAe,EAC9B,aAAa,IAAI,iBAAiB,GACnC,MAAM,gBAAgB,CAAC;AAExB,cAAc,uBAAuB,CAAC;AAGtC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,4BAA4B,CAAC;AAG3C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @zudojs/cqrs
+ *
+ * Command Query Responsibility Segregation primitives for the Zudojs framework.
+ * Provides buses, handlers, middleware, and execution infrastructure.
+ */
+// Core types (interfaces, type aliases, type guards)
+export { isCqrsRequest, } from "./cqrsTypes/index.js";
+// Command (classes, factories, type guards)
+export { Command, MetadataCommand, createCommand, getCommandType, isCommand, commandType, CommandHandler, FunctionCommandHandler, createCommandHandler, isCommandHandler, isCommandHandlerLike, executeCommandHandler, CommandBus, createCommandBus, createCommandResult, createFailedCommandResult, isSuccessfulCommandResult, isFailedCommandResult, unwrapCommandResult, withCommandResultMetadata, } from "./command/index.js";
+// Query (classes, factories, type guards)
+export { Query, MetadataQuery, createQuery, getQueryType, isQuery, queryType, QueryHandler, FunctionQueryHandler, createQueryHandler, isQueryHandler, isQueryHandlerLike, executeQueryHandler, QueryBus, createQueryBus, createQueryResult, createFailedQueryResult, isSuccessfulQueryResult, isFailedQueryResult, unwrapQueryResult, withQueryResultMetadata, } from "./query/index.js";
+// Events — re-exports base Zudojs Event types + CQRS extensions
+export { isEvent, createEvent as createBaseEvent, createEventId as createBaseEventId, } from "@zudojs/events";
+export * from "./cqrsEvents/index.js";
+// Middleware
+export * from "./cqrsMiddleware/index.js";
+// Handler Registry
+export * from "./handlerRegistry/index.js";
+// Decorators
+export * from "./cqrsDecorators/index.js";
+// Execution Context
+export * from "./cqrsContext/index.js";
+// Errors
+export * from "./cqrsErrors/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qDAAqD;AACrD,OAAO,EAiBL,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,4CAA4C;AAC5C,OAAO,EACL,OAAO,EAEP,eAAe,EACf,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EAGV,gBAAgB,EAIhB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,0CAA0C;AAC1C,OAAO,EACL,KAAK,EAEL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,OAAO,EACP,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EAGR,cAAc,EAId,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,gEAAgE;AAChE,OAAO,EAML,OAAO,EACP,WAAW,IAAI,eAAe,EAC9B,aAAa,IAAI,iBAAiB,GACnC,MAAM,gBAAgB,CAAC;AAExB,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,2BAA2B,CAAC;AAE1C,mBAAmB;AACnB,cAAc,4BAA4B,CAAC;AAE3C,aAAa;AACb,cAAc,2BAA2B,CAAC;AAE1C,oBAAoB;AACpB,cAAc,wBAAwB,CAAC;AAEvC,SAAS;AACT,cAAc,uBAAuB,CAAC"}

package/dist/query/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/cqrs/query
+ *
+ * Query implementation: abstract query, handler, bus, and result types.
+ */
+export * from "./query.core.js";
+export * from "./queryHandler.core.js";
+export * from "./queryBus.core.js";
+export * from "./queryResult.type.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/query/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/cqrs/query
+ *
+ * Query implementation: abstract query, handler, bus, and result types.
+ */
+export * from "./query.core.js";
+export * from "./queryHandler.core.js";
+export * from "./queryBus.core.js";
+export * from "./queryResult.type.js";
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

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

package/dist/query/query.core.d.ts

@@ -0,0 +1,50 @@
+import type { Query as QueryContract } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Base abstract query.
+ *
+ * Queries represent requests to retrieve data without changing
+ * application state.
+ */
+export declare abstract class Query<TType extends string = string> implements QueryContract<TType> {
+    readonly type: TType;
+    protected constructor(type: TType);
+}
+/**
+ * Options used when constructing a concrete query.
+ */
+export interface QueryOptions {
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Query containing immutable metadata.
+ */
+export declare abstract class MetadataQuery<TType extends string = string> extends Query<TType> {
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    protected constructor(type: TType, options?: QueryOptions);
+}
+/**
+ * Creates a simple immutable query object.
+ */
+export declare function createQuery<TType extends string, TPayload extends Record<string, unknown> = Record<string, never>>(type: TType, payload?: TPayload): Readonly<{
+    readonly type: TType;
+} & TPayload>;
+/**
+ * Returns the query type discriminator.
+ */
+export declare function getQueryType(query: QueryContract): string;
+/**
+ * Determines whether a value has the basic query shape.
+ *
+ * Commands and queries share the same runtime discriminator shape.
+ * Therefore, this helper should be used when the value is already
+ * known to belong to the query pipeline.
+ */
+export declare function isQuery(value: unknown): value is QueryContract;
+/**
+ * Creates a query type factory.
+ *
+ * This is useful when defining related queries while keeping their
+ * discriminator values consistent.
+ */
+export declare function queryType<TType extends string>(type: TType): () => TType;
+//# sourceMappingURL=query.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.core.d.ts","sourceRoot":"","sources":["../../src/query/query.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;GAKG;AACH,8BAAsB,KAAK,CACzB,KAAK,SAAS,MAAM,GAAG,MAAM,CAC7B,YAAW,aAAa,CAAC,KAAK,CAAC;IAC/B,SAAgB,IAAI,EAAE,KAAK,CAAC;IAE5B,SAAS,aAAa,IAAI,EAAE,KAAK,EAEhC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,8BAAsB,aAAa,CACjC,KAAK,SAAS,MAAM,GAAG,MAAM,CAC7B,SAAQ,KAAK,CAAC,KAAK,CAAC;IACpB,SAAgB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7D,SAAS,aAAa,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,YAAiB,EAI5D;CACF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,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,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAgB9D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,KAAK,CAExE"}

package/dist/query/query.core.js

@@ -0,0 +1,61 @@
+/**
+ * Base abstract query.
+ *
+ * Queries represent requests to retrieve data without changing
+ * application state.
+ */
+export class Query {
+    type;
+    constructor(type) {
+        this.type = type;
+    }
+}
+/**
+ * Query containing immutable metadata.
+ */
+export class MetadataQuery extends Query {
+    metadata;
+    constructor(type, options = {}) {
+        super(type);
+        this.metadata = options.metadata;
+    }
+}
+/**
+ * Creates a simple immutable query object.
+ */
+export function createQuery(type, payload) {
+    return Object.freeze({
+        type,
+        ...(payload ?? {}),
+    });
+}
+/**
+ * Returns the query type discriminator.
+ */
+export function getQueryType(query) {
+    return query.type;
+}
+/**
+ * Determines whether a value has the basic query shape.
+ *
+ * Commands and queries share the same runtime discriminator shape.
+ * Therefore, this helper should be used when the value is already
+ * known to belong to the query pipeline.
+ */
+export function isQuery(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        typeof value.type === "string" &&
+        value.type.length > 0);
+}
+/**
+ * Creates a query type factory.
+ *
+ * This is useful when defining related queries while keeping their
+ * discriminator values consistent.
+ */
+export function queryType(type) {
+    return () => type;
+}
+//# sourceMappingURL=query.core.js.map

package/dist/query/query.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.core.js","sourceRoot":"","sources":["../../src/query/query.core.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAgB,KAAK;IAGT,IAAI,CAAQ;IAE5B,YAAsB,IAAW;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AASD;;GAEG;AACH,MAAM,OAAgB,aAEpB,SAAQ,KAAY;IACJ,QAAQ,CAAqC;IAE7D,YAAsB,IAAW,EAAE,OAAO,GAAiB,EAAE;QAC3D,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAIzB,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,YAAY,CAAC,KAAoB;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,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,SAAS,CAAuB,IAAW;IACzD,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/query/queryBus.core.d.ts

@@ -0,0 +1,91 @@
+import type { Query, QueryBus as QueryBusContract, QueryHandlerLike, CqrsContext, CqrsMiddleware } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Options for constructing a query bus.
+ */
+export interface QueryBusOptions {
+    readonly middleware?: readonly CqrsMiddleware[];
+    /**
+     * Creates a default execution context when one is not supplied.
+     */
+    readonly contextFactory?: () => CqrsContext | Promise<CqrsContext>;
+}
+/**
+ * Registered query handler.
+ */
+export interface QueryRegistration<TQuery extends Query = Query, TResult = unknown> {
+    readonly queryType: TQuery["type"];
+    readonly handler: QueryHandlerLike<TQuery, TResult>;
+}
+/**
+ * Query bus implementation.
+ *
+ * The query bus resolves a handler by query type and executes it
+ * through the registered middleware pipeline.
+ */
+export declare class QueryBus implements QueryBusContract {
+    private readonly handlers;
+    private readonly middleware;
+    private readonly contextFactory?;
+    constructor(options?: QueryBusOptions);
+    /**
+     * Registers a query handler.
+     */
+    register<TQuery extends Query, TResult = unknown>(queryType: TQuery["type"], handler: QueryHandlerLike<TQuery, TResult>): this;
+    /**
+     * Registers multiple query handlers.
+     */
+    registerMany(registrations: readonly QueryRegistration[]): this;
+    /**
+     * Replaces an existing query handler.
+     */
+    replace<TQuery extends Query, TResult = unknown>(queryType: TQuery["type"], handler: QueryHandlerLike<TQuery, TResult>): this;
+    /**
+     * Removes a query handler.
+     */
+    unregister(queryType: string): boolean;
+    /**
+     * Determines whether a query handler is registered.
+     */
+    has(queryType: string): boolean;
+    /**
+     * Returns the registered handler for a query type.
+     */
+    getHandler<TQuery extends Query, TResult = unknown>(queryType: TQuery["type"]): QueryHandlerLike<TQuery, TResult> | undefined;
+    /**
+     * Executes a query.
+     */
+    execute<TQuery extends Query, TResult = unknown>(query: TQuery, 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 query types.
+     */
+    getQueryTypes(): readonly string[];
+    /**
+     * Builds the query execution pipeline.
+     */
+    private buildPipeline;
+    /**
+     * Resolves the execution context.
+     */
+    private resolveContext;
+    /**
+     * Validates a query before execution.
+     */
+    private validateQuery;
+}
+/**
+ * Creates a query bus.
+ */
+export declare function createQueryBus(options?: QueryBusOptions): QueryBus;
+//# sourceMappingURL=queryBus.core.d.ts.map

package/dist/query/queryBus.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBus.core.d.ts","sourceRoot":"","sources":["../../src/query/queryBus.core.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,KAAK,EACL,QAAQ,IAAI,gBAAgB,EAC5B,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,gCAAgC,CAAC;AAOxC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,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,iBAAiB,CAChC,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAEnC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrD;AAED;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,gBAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA2C;IAE3E,YAAY,OAAO,GAAE,eAAoB,EAIxC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAM,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,EACrD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,IAAI,CAkBN;IAED;;OAEG;IACI,YAAY,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,CAMrE;IAED;;OAEG;IACI,OAAO,CAAC,MAAM,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,EACpD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,IAAI,CAQN;IAED;;OAEG;IACI,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5C;IAED;;OAEG;IACI,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErC;IAED;;OAEG;IACI,UAAU,CAAC,MAAM,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,EACvD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GACxB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAG/C;IAED;;OAEG;IACU,OAAO,CAAC,MAAM,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,EAC1D,KAAK,EAAE,MAAM,EACb,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,aAAa,IAAI,SAAS,MAAM,EAAE,CAExC;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,OAAO,CAAC,aAAa;CAuBtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAEtE"}