@zudojs/cqrs 0.0.1

package/dist/query/queryBus.core.js

@@ -0,0 +1,177 @@
+import { BaseError, ErrorCategory, ErrorCode, ErrorSeverity, } from "@zudojs/errors";
+import { QueryHandler, executeQueryHandler, } from "../query/queryHandler.core.js";
+/**
+ * Query bus implementation.
+ *
+ * The query bus resolves a handler by query type and executes it
+ * through the registered middleware pipeline.
+ */
+export class QueryBus {
+    handlers = new Map();
+    middleware;
+    contextFactory;
+    constructor(options = {}) {
+        this.middleware = [...(options.middleware ?? [])];
+        this.contextFactory = options.contextFactory;
+    }
+    /**
+     * Registers a query handler.
+     */
+    register(queryType, handler) {
+        if (!queryType.trim()) {
+            throw new TypeError("Query type cannot be empty.");
+        }
+        if (!handler) {
+            throw new TypeError(`A handler is required for query "${queryType}".`);
+        }
+        if (this.handlers.has(queryType)) {
+            throw new Error(`A handler is already registered for query "${queryType}".`);
+        }
+        this.handlers.set(queryType, handler);
+        return this;
+    }
+    /**
+     * Registers multiple query handlers.
+     */
+    registerMany(registrations) {
+        for (const registration of registrations) {
+            this.register(registration.queryType, registration.handler);
+        }
+        return this;
+    }
+    /**
+     * Replaces an existing query handler.
+     */
+    replace(queryType, handler) {
+        if (!queryType.trim()) {
+            throw new TypeError("Query type cannot be empty.");
+        }
+        this.handlers.set(queryType, handler);
+        return this;
+    }
+    /**
+     * Removes a query handler.
+     */
+    unregister(queryType) {
+        return this.handlers.delete(queryType);
+    }
+    /**
+     * Determines whether a query handler is registered.
+     */
+    has(queryType) {
+        return this.handlers.has(queryType);
+    }
+    /**
+     * Returns the registered handler for a query type.
+     */
+    getHandler(queryType) {
+        return this.handlers.get(queryType);
+    }
+    /**
+     * Executes a query.
+     */
+    async execute(query, context) {
+        this.validateQuery(query);
+        const handler = this.getHandler(query.type);
+        if (!handler) {
+            throw new BaseError(`No handler is registered for query "${query.type}".`, {
+                code: ErrorCode.QUERY_HANDLER_NOT_FOUND,
+                category: ErrorCategory.SYSTEM,
+                severity: ErrorSeverity.ERROR,
+                statusCode: 500,
+                expose: false,
+                isOperational: true,
+                metadata: {
+                    queryType: query.type,
+                },
+            });
+        }
+        const executionContext = await this.resolveContext(context);
+        const pipeline = this.buildPipeline(handler);
+        return pipeline(query, executionContext);
+    }
+    /**
+     * Adds middleware to the end of the pipeline.
+     */
+    use(middleware) {
+        if (typeof middleware !== "function") {
+            throw new TypeError("Query 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 query types.
+     */
+    getQueryTypes() {
+        return [...this.handlers.keys()];
+    }
+    /**
+     * Builds the query execution pipeline.
+     */
+    buildPipeline(handler) {
+        let next = async (query, context) => executeQueryHandler(handler, query, context);
+        for (let index = this.middleware.length - 1; index >= 0; index--) {
+            const middleware = this.middleware[index];
+            const current = next;
+            next = async (query, context) => middleware(query, 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 query before execution.
+     */
+    validateQuery(query) {
+        if (!query || typeof query !== "object") {
+            throw new BaseError("A valid query is required.", {
+                code: ErrorCode.INVALID_QUERY,
+                category: ErrorCategory.VALIDATION,
+                severity: ErrorSeverity.WARNING,
+                statusCode: 400,
+                expose: true,
+                isOperational: true,
+            });
+        }
+        if (typeof query.type !== "string" || query.type.trim().length === 0) {
+            throw new BaseError("Query type is required.", {
+                code: ErrorCode.INVALID_QUERY,
+                category: ErrorCategory.VALIDATION,
+                severity: ErrorSeverity.WARNING,
+                statusCode: 400,
+                expose: true,
+                isOperational: true,
+            });
+        }
+    }
+}
+/**
+ * Creates a query bus.
+ */
+export function createQueryBus(options = {}) {
+    return new QueryBus(options);
+}
+//# sourceMappingURL=queryBus.core.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { QueryHandler as QueryHandlerContract, Query, CqrsContext } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Abstract base class for query handlers.
+ *
+ * A query handler contains the application logic required to execute
+ * one specific query.
+ */
+export declare abstract class QueryHandler<TQuery extends Query = Query, TResult = unknown> implements QueryHandlerContract<TQuery, TResult> {
+    /**
+     * Query type handled by this handler.
+     */
+    abstract readonly queryType: TQuery["type"];
+    /**
+     * Executes the query.
+     */
+    abstract execute(query: TQuery, context?: CqrsContext): Promise<TResult> | TResult;
+}
+/**
+ * Function-based query handler implementation.
+ */
+export declare class FunctionQueryHandler<TQuery extends Query = Query, TResult = unknown> extends QueryHandler<TQuery, TResult> {
+    readonly queryType: TQuery["type"];
+    private readonly handler;
+    constructor(queryType: TQuery["type"], handler: (query: TQuery, context?: CqrsContext) => TResult | Promise<TResult>);
+    execute(query: TQuery, context?: CqrsContext): TResult | Promise<TResult>;
+}
+/**
+ * Creates a function-based query handler.
+ */
+export declare function createQueryHandler<TQuery extends Query, TResult = unknown>(queryType: TQuery["type"], handler: (query: TQuery, context?: CqrsContext) => TResult | Promise<TResult>): FunctionQueryHandler<TQuery, TResult>;
+/**
+ * Determines whether a value is a query handler instance.
+ */
+export declare function isQueryHandler(value: unknown): value is QueryHandler;
+/**
+ * Determines whether a value can be used as a query handler.
+ */
+export declare function isQueryHandlerLike(value: unknown): value is QueryHandler | ((query: Query, context?: CqrsContext) => unknown);
+/**
+ * Executes either an object-based or function-based query handler.
+ */
+export declare function executeQueryHandler<TQuery extends Query, TResult = unknown>(handler: QueryHandler<TQuery, TResult> | ((query: TQuery, context?: CqrsContext) => TResult | Promise<TResult>), query: TQuery, context?: CqrsContext): Promise<TResult>;
+//# sourceMappingURL=queryHandler.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryHandler.core.d.ts","sourceRoot":"","sources":["../../src/query/queryHandler.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,IAAI,oBAAoB,EACpC,KAAK,EACL,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,8BAAsB,YAAY,CAChC,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,OAAO,GAAG,OAAO,CACjB,YAAW,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC;IAChD;;OAEG;IACH,kBAAyB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAEnD;;OAEG;IACH,SAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,oBAAoB,CAC/B,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,OAAO,GAAG,OAAO,CACjB,SAAQ,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGQ;IAEhC,YACE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAWhC;IAEM,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5B;CACF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,EACxE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC5E,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,YAAY,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,SAAS,KAAK,EACpB,OAAO,GAAG,OAAO,EAEjB,OAAO,EACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/query/queryHandler.core.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryHandler.core.js","sourceRoot":"","sources":["../../src/query/queryHandler.core.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAgB,YAAY;CAgBjC;AAED;;GAEG;AACH,MAAM,OAAO,oBAGX,SAAQ,YAA6B;IACrB,SAAS,CAAiB;IAEzB,OAAO,CAGQ;IAEhC,YACE,SAAyB,EACzB,OAG+B;QAE/B,KAAK,EAAE,CAAC;QAER,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,OAAO,CACZ,KAAa,EACb,OAAqB;QAErB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAyB,EACzB,OAA6E;IAE7E,OAAO,IAAI,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc;IAEd,OAAO,KAAK,YAAY,YAAY,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAIvC,OAE0E,EAC1E,KAAa,EACb,OAAqB;IAErB,IAAI,OAAO,YAAY,YAAY,EAAE,CAAC;QACpC,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,8BAA8B,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/query/queryResult.type.d.ts

@@ -0,0 +1,56 @@
+import type { Query } from "../cqrsTypes/cqrsTypes.type.js";
+/**
+ * Status of a query execution.
+ */
+export type QueryResultStatus = "success" | "failure";
+/**
+ * Result returned after query execution.
+ *
+ * The wrapper provides consistent execution metadata while preserving
+ * the actual value returned by the query handler.
+ */
+export interface QueryResult<TResult = unknown, TQuery extends Query = Query> {
+    readonly status: QueryResultStatus;
+    readonly result: TResult;
+    readonly queryType: TQuery["type"];
+    readonly executedAt: Date;
+    readonly durationMs?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Options for creating a query result.
+ */
+export interface CreateQueryResultOptions<TQuery extends Query = Query> {
+    readonly query: TQuery;
+    readonly executedAt?: Date;
+    readonly durationMs?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Creates a successful query result.
+ */
+export declare function createQueryResult<TResult, TQuery extends Query>(result: TResult, options: CreateQueryResultOptions<TQuery>): QueryResult<TResult, TQuery>;
+/**
+ * Creates a failed query result.
+ *
+ * Query buses normally throw failures. This helper is useful for
+ * infrastructure that needs to represent a failure as a value.
+ */
+export declare function createFailedQueryResult<TResult = unknown, TQuery extends Query = Query>(result: TResult, options: CreateQueryResultOptions<TQuery>): QueryResult<TResult, TQuery>;
+/**
+ * Determines whether a query result represents success.
+ */
+export declare function isSuccessfulQueryResult<TResult, TQuery extends Query = Query>(result: QueryResult<TResult, TQuery>): boolean;
+/**
+ * Determines whether a query result represents failure.
+ */
+export declare function isFailedQueryResult<TResult, TQuery extends Query = Query>(result: QueryResult<TResult, TQuery>): boolean;
+/**
+ * Returns the underlying query result value.
+ */
+export declare function unwrapQueryResult<TResult, TQuery extends Query = Query>(result: QueryResult<TResult, TQuery>): TResult;
+/**
+ * Adds metadata to an existing query result.
+ */
+export declare function withQueryResultMetadata<TResult, TQuery extends Query = Query>(result: QueryResult<TResult, TQuery>, metadata: Readonly<Record<string, unknown>>): QueryResult<TResult, TQuery>;
+//# sourceMappingURL=queryResult.type.d.ts.map

package/dist/query/queryResult.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryResult.type.d.ts","sourceRoot":"","sources":["../../src/query/queryResult.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK;IAC1E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,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,wBAAwB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,iBAAiB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,EAC7D,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACxC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAmB9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,KAAK,GAAG,KAAK,EAE5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACxC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAmB9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,EAC3E,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACnC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,EACvE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACnC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,EACrE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACnC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,EAC3E,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAU9B"}

package/dist/query/queryResult.type.js

@@ -0,0 +1,86 @@
+/**
+ * Creates a successful query result.
+ */
+export function createQueryResult(result, options) {
+    const query = options.query;
+    validateQuery(query);
+    const queryResult = {
+        status: "success",
+        result,
+        queryType: query.type,
+        executedAt: options.executedAt ?? new Date(),
+        durationMs: options.durationMs,
+        metadata: options.metadata
+            ? Object.freeze({
+                ...options.metadata,
+            })
+            : undefined,
+    };
+    return Object.freeze(queryResult);
+}
+/**
+ * Creates a failed query result.
+ *
+ * Query buses normally throw failures. This helper is useful for
+ * infrastructure that needs to represent a failure as a value.
+ */
+export function createFailedQueryResult(result, options) {
+    const query = options.query;
+    validateQuery(query);
+    const queryResult = {
+        status: "failure",
+        result,
+        queryType: query.type,
+        executedAt: options.executedAt ?? new Date(),
+        durationMs: options.durationMs,
+        metadata: options.metadata
+            ? Object.freeze({
+                ...options.metadata,
+            })
+            : undefined,
+    };
+    return Object.freeze(queryResult);
+}
+/**
+ * Determines whether a query result represents success.
+ */
+export function isSuccessfulQueryResult(result) {
+    return result.status === "success";
+}
+/**
+ * Determines whether a query result represents failure.
+ */
+export function isFailedQueryResult(result) {
+    return result.status === "failure";
+}
+/**
+ * Returns the underlying query result value.
+ */
+export function unwrapQueryResult(result) {
+    return result.result;
+}
+/**
+ * Adds metadata to an existing query result.
+ */
+export function withQueryResultMetadata(result, metadata) {
+    const merged = {
+        ...result,
+        metadata: Object.freeze({
+            ...(result.metadata ?? {}),
+            ...metadata,
+        }),
+    };
+    return Object.freeze(merged);
+}
+/**
+ * Validates the query portion of a query result.
+ */
+function validateQuery(query) {
+    if (!query || typeof query !== "object") {
+        throw new TypeError("A valid query is required to create a query result.");
+    }
+    if (typeof query.type !== "string" || query.type.trim().length === 0) {
+        throw new TypeError("Query type is required to create a query result.");
+    }
+}
+//# sourceMappingURL=queryResult.type.js.map

package/dist/query/queryResult.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryResult.type.js","sourceRoot":"","sources":["../../src/query/queryResult.type.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAe,EACf,OAAyC;IAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAE5B,aAAa,CAAC,KAAK,CAAC,CAAC;IAErB,MAAM,WAAW,GAAiC;QAChD,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,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,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAIrC,MAAe,EACf,OAAyC;IAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAE5B,aAAa,CAAC,KAAK,CAAC,CAAC;IAErB,MAAM,WAAW,GAAiC;QAChD,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,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,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAoC;IAEpC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAoC;IAEpC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAoC;IAEpC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAoC,EACpC,QAA2C;IAE3C,MAAM,MAAM,GAAiC;QAC3C,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,aAAa,CAAC,KAAY;IACjC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@zudojs/cqrs",
+  "version": "0.0.1",
+  "description": "Command Query Responsibility Segregation (CQRS) primitives for separating read and write operations.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/events": "workspace:*",
+    "@zudojs/messaging": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "keywords": [
+    "zudojs",
+    "cqrs",
+    "commands",
+    "queries"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}