@ahoo-wang/wow-client 9.2.0-rc.0

package/dist/client/query/event/eventStreamQueryApi.d.cts

@@ -0,0 +1,29 @@
+import { DomainEventStream } from './domainEventStream.cjs';
+import { QueryApi } from '../queryApi.cjs';
+/**
+ * Interface for event stream query API operations.
+ * Extends the base QueryApi interface but omits the 'single' method,
+ * as event stream queries typically work with collections of events rather than single events,
+ * and adds `load`/`loadStream`, which replay one aggregate's versions.
+ * @template DomainEventBody - The type of the domain event bodies
+ */
+export interface EventStreamQueryApi<DomainEventBody = unknown, FIELDS extends string = string> extends Omit<QueryApi<DomainEventStream<DomainEventBody>, FIELDS>, 'single'> {
+    /**
+     * Loads one aggregate's event streams from `headVersion` to `tailVersion`,
+     * both inclusive, in version order.
+     * `GET {id}/event/{headVersion}/{tailVersion}`.
+     *
+     * @param id - The aggregate id
+     * @param headVersion - The first version, from 1
+     * @param tailVersion - The last version
+     * @param attributes - Optional shared attributes for the interceptors
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns The event streams of versions `headVersion` to `tailVersion`
+     */
+    load<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * `load` as a stream, one event stream per server-sent event. The
+     * stream errors with a `WowError` if the server fails midway.
+     */
+    loadStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+}

package/dist/client/query/event/eventStreamQueryApi.d.ts

@@ -0,0 +1,29 @@
+import { DomainEventStream } from './domainEventStream.js';
+import { QueryApi } from '../queryApi.js';
+/**
+ * Interface for event stream query API operations.
+ * Extends the base QueryApi interface but omits the 'single' method,
+ * as event stream queries typically work with collections of events rather than single events,
+ * and adds `load`/`loadStream`, which replay one aggregate's versions.
+ * @template DomainEventBody - The type of the domain event bodies
+ */
+export interface EventStreamQueryApi<DomainEventBody = unknown, FIELDS extends string = string> extends Omit<QueryApi<DomainEventStream<DomainEventBody>, FIELDS>, 'single'> {
+    /**
+     * Loads one aggregate's event streams from `headVersion` to `tailVersion`,
+     * both inclusive, in version order.
+     * `GET {id}/event/{headVersion}/{tailVersion}`.
+     *
+     * @param id - The aggregate id
+     * @param headVersion - The first version, from 1
+     * @param tailVersion - The last version
+     * @param attributes - Optional shared attributes for the interceptors
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns The event streams of versions `headVersion` to `tailVersion`
+     */
+    load<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * `load` as a stream, one event stream per server-sent event. The
+     * stream errors with a `WowError` if the server fails midway.
+     */
+    loadStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+}

package/dist/client/query/event/eventStreamQueryClient.cjs

@@ -0,0 +1,2 @@
+const e=require("../../../transport/endpoints.cjs"),t=require("../../bindMethods.cjs"),n=require("../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.cjs"),r=require("../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateParam.cjs"),i=require("../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.cjs"),a=require("./endpointPaths.cjs");let o=require("@ahoo-wang/fetcher-decorator");var s=class{constructor(e){this.apiMetadata=e,t.bindMethods(this)}aggregate(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}aggregateStream(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}cursor(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}count(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}list(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}listStream(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}paged(e,t,n){throw(0,o.autoGeneratedError)(e,t,n)}load(e,t,n,r,i){throw(0,o.autoGeneratedError)(e,t,n,r,i)}loadStream(e,t,n,r,i){throw(0,o.autoGeneratedError)(e,t,n,r,i)}};i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.AGGREGATION),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`aggregate`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.AGGREGATION,e.QUERY_STREAM_ENDPOINT),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`aggregateStream`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.CURSOR),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`cursor`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.COUNT),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`count`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.LIST),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`list`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.LIST,e.QUERY_STREAM_ENDPOINT),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`listStream`,null),i.default([(0,o.post)(a.EventStreamQueryEndpointPaths.PAGED),r.default(0,(0,o.body)()),r.default(1,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`paged`,null),i.default([(0,o.get)(a.EventStreamQueryEndpointPaths.LOAD),r.default(0,(0,o.path)(`id`)),r.default(1,(0,o.path)(`headVersion`)),r.default(2,(0,o.path)(`tailVersion`)),r.default(3,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[String,Number,Number,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`load`,null),i.default([(0,o.get)(a.EventStreamQueryEndpointPaths.LOAD,e.QUERY_STREAM_ENDPOINT),r.default(0,(0,o.path)(`id`)),r.default(1,(0,o.path)(`headVersion`)),r.default(2,(0,o.path)(`tailVersion`)),r.default(3,(0,o.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[String,Number,Number,typeof Record>`u`?Object:Record,Object]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],s.prototype,`loadStream`,null),s=i.default([(0,o.api)(),n.default(`design:paramtypes`,[Object])],s),Object.defineProperty(exports,"EventStreamQueryClient",{enumerable:!0,get:function(){return s}});
+//# sourceMappingURL=eventStreamQueryClient.cjs.map

package/dist/client/query/event/eventStreamQueryClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventStreamQueryClient.cjs","names":["autoGeneratedError","_decorate","post","EventStreamQueryEndpointPaths","_decorateParam","body","attribute","_decorateMetadata","QUERY_STREAM_ENDPOINT","get","path","api","require_endpoints","require_bindMethods","require_decorateMetadata","require_decorateParam","require_decorate","require_endpointPaths","_ahoo_wang_fetcher_decorator","EventStreamQueryClient","apiMetadata","query","attributes","abort","filter","listQuery","pagedQuery","id","headVersion","tailVersion"],"sources":["../../../../src/client/query/event/eventStreamQueryClient.ts"],"sourcesContent":["/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { EventStreamQueryApi } from './eventStreamQueryApi.js';\nimport { EventStreamQueryEndpointPaths } from './endpointPaths.js';\nimport type { AggregationQuery } from '../../../dsl/aggregation/index.js';\nimport type { FilterExpression } from '../../../dsl/filter/index.js';\nimport type {\n  Condition,\n  ListQueryRequest,\n  PagedQueryRequest,\n} from '../requests.js';\nimport type { PagedList } from '../../../dsl/queryable.js';\nimport type { DomainEventStream } from './domainEventStream.js';\nimport type { DynamicDocument } from '../../../dsl/documents.js';\nimport { QUERY_STREAM_ENDPOINT } from '../../../transport/endpoints.js';\nimport type { CursorPage, CursorQuery } from '../../../dsl/cursorQuery.js';\n\nimport type {\n  ApiMetadata,\n  ApiMetadataCapable,\n} from '@ahoo-wang/fetcher-decorator';\nimport {\n  api,\n  attribute,\n  autoGeneratedError,\n  body,\n  get,\n  path,\n  post,\n} from '@ahoo-wang/fetcher-decorator';\nimport { bindMethods } from '../../bindMethods.js';\n\n/**\n * Client for querying event streams through HTTP endpoints.\n * Implements EventStreamQueryApi to provide methods\n * for querying domain event streams with different query patterns.\n * This client supports counting, listing, streaming, and paging operations on event streams.\n *\n * @example\n * ```typescript\n * // Create client options configuration\n * const clientOptions: ApiMetadata = {\n *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),\n *   basePath: 'owner/{ownerId}/cart'\n * };\n *\n * // Create an event stream query client instance\n * const eventStreamQueryClient = new EventStreamQueryClient(clientOptions);\n *\n * // Count event streams\n * const count = await eventStreamQueryClient.count(filter.matchAll());\n *\n * // List event streams\n * const listQuery: FilterListQuery = {\n *   filter: filter.matchAll()\n * };\n * const list = await eventStreamQueryClient.list(listQuery);\n *\n * // List event streams as stream\n * const listStream = await eventStreamQueryClient.listStream(listQuery);\n * for await (const domainEventStream of listStream) {\n *   console.log('Received:', domainEventStream);\n * }\n *\n * // Paged event streams\n * const pagedQuery: FilterPagedQuery = {\n *   filter: filter.matchAll()\n * };\n * const paged = await eventStreamQueryClient.paged(pagedQuery);\n * ```\n */\n@api()\nexport class EventStreamQueryClient<\n  DomainEventBody = unknown,\n  FIELDS extends string = string,\n>\n  implements EventStreamQueryApi<DomainEventBody, FIELDS>, ApiMetadataCapable\n{\n  /**\n   * Creates a new EventStreamQueryClient instance.\n   */\n  constructor(public readonly apiMetadata?: ApiMetadata) {\n    bindMethods(this);\n  }\n\n  /** Runs an event stream aggregation and returns all result rows. */\n  @post(EventStreamQueryEndpointPaths.AGGREGATION)\n  /* v8 ignore start */\n  aggregate<\n    Row extends object = DynamicDocument,\n    AGGREGATION_FIELDS extends string = string,\n  >(\n    @body() query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<Row[]> {\n    throw autoGeneratedError(query, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /** Runs an event stream aggregation and streams the result rows, one per server-sent event. */\n  @post(EventStreamQueryEndpointPaths.AGGREGATION, QUERY_STREAM_ENDPOINT)\n  /* v8 ignore start */\n  aggregateStream<\n    Row extends object = DynamicDocument,\n    AGGREGATION_FIELDS extends string = string,\n  >(\n    @body() query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<ReadableStream<Row>> {\n    throw autoGeneratedError(query, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /** Retrieves the next cursor page of domain event streams. */\n  @post(EventStreamQueryEndpointPaths.CURSOR)\n  /* v8 ignore start */\n  cursor<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @body() query: CursorQuery<FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<CursorPage<T>> {\n    throw autoGeneratedError(query, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Counts the number of domain event streams that match the given filter.\n   *\n   * @param filter - The filter expression or legacy condition\n   * @param attributes - Optional shared attributes that can be accessed by interceptors\n   *                     throughout the request lifecycle. These attributes allow passing\n   *                     custom data between different interceptors.\n   * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.\n   * @returns A promise that resolves to the count of matching event streams\n   *\n   * @example\n   * ```typescript\n   * const controller = new AbortController();\n   * const count = await eventStreamQueryClient.count(filter.matchAll(), undefined, controller);\n   * console.log('Total event streams:', count);\n   *\n   * // Cancel the request if needed\n   * controller.abort();\n   * ```\n   */\n  @post(EventStreamQueryEndpointPaths.COUNT)\n  /* v8 ignore start */\n  count(\n    // compat(wow<9): accepts the deprecated Condition, which Wow < 8.11 needs; narrow to FilterExpression in v10.\n    @body() filter: FilterExpression<FIELDS> | Condition<FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<number> {\n    throw autoGeneratedError(filter, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Retrieves a list of domain event streams based on the provided query parameters.\n   *\n   * @param listQuery - The query parameters for listing event streams\n   * @param attributes - Optional shared attributes that can be accessed by interceptors\n   *                     throughout the request lifecycle. These attributes allow passing\n   *                     custom data between different interceptors.\n   * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.\n   * @returns A promise that resolves to an array of partial domain event streams\n   *\n   * @example\n   * ```typescript\n   * const controller = new AbortController();\n   * const listQuery: FilterListQuery = {\n   *   filter: filter.matchAll()\n   * };\n   * const list = await eventStreamQueryClient.list(listQuery, undefined, controller);\n   * for (const domainEventStream of list) {\n   *   console.log('Event stream:', domainEventStream);\n   * }\n   *\n   * // Cancel the request if needed\n   * controller.abort();\n   * ```\n   */\n  @post(EventStreamQueryEndpointPaths.LIST)\n  /* v8 ignore start */\n  list<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @body() listQuery: ListQueryRequest<FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<T[]> {\n    throw autoGeneratedError(listQuery, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Retrieves a stream of domain event streams based on the provided query parameters.\n   * Sets the Accept header to text/event-stream to indicate that the response should be streamed.\n   *\n   * @param listQuery - The query parameters for listing event streams\n   * @param attributes - Optional shared attributes that can be accessed by interceptors\n   *                     throughout the request lifecycle. These attributes allow passing\n   *                     custom data between different interceptors.\n   * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.\n   * @returns A promise that resolves to a readable stream of partial domain event streams\n   *\n   * @example\n   * ```typescript\n   * const controller = new AbortController();\n   * const listQuery: FilterListQuery = {\n   *   filter: filter.matchAll()\n   * };\n   * const listStream = await eventStreamQueryClient.listStream(listQuery, undefined, controller);\n   * for await (const domainEventStream of listStream) {\n   *   console.log('Received event stream:', domainEventStream);\n   * }\n   *\n   * // Cancel the request if needed\n   * controller.abort();\n   * ```\n   */\n  @post(EventStreamQueryEndpointPaths.LIST, QUERY_STREAM_ENDPOINT)\n  /* v8 ignore start */\n  listStream<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @body() listQuery: ListQueryRequest<FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<ReadableStream<T>> {\n    throw autoGeneratedError(listQuery, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Retrieves a paged list of domain event streams based on the provided query parameters.\n   *\n   * @param pagedQuery - The query parameters for paging event streams\n   * @param attributes - Optional shared attributes that can be accessed by interceptors\n   *                     throughout the request lifecycle. These attributes allow passing\n   *                     custom data between different interceptors.\n   * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.\n   * @returns A promise that resolves to a paged list of partial domain event streams\n   *\n   * @example\n   * ```typescript\n   * const controller = new AbortController();\n   * const pagedQuery: FilterPagedQuery = {\n   *   filter: filter.matchAll(),\n   *   pagination: { index: 1, size: 10 }\n   * };\n   * const paged = await eventStreamQueryClient.paged(pagedQuery, undefined, controller);\n   * console.log('Total:', paged.total);\n   * for (const domainEventStream of paged.list) {\n   *   console.log('Event stream:', domainEventStream);\n   * }\n   *\n   * // Cancel the request if needed\n   * controller.abort();\n   * ```\n   */\n  @post(EventStreamQueryEndpointPaths.PAGED)\n  /* v8 ignore start */\n  paged<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @body() pagedQuery: PagedQueryRequest<FIELDS>,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<PagedList<T>> {\n    throw autoGeneratedError(pagedQuery, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Loads one aggregate's event streams from `headVersion` to `tailVersion`,\n   * both inclusive, in version order — how an audit trail or an event\n   * sourcing view replays an aggregate. `GET {id}/event/{headVersion}/{tailVersion}`.\n   *\n   * The server treats the range as a list query: more than its maximum list\n   * size (1000 by default) is refused. The route carries a tenant segment by\n   * default but no owner segment, like the load-state routes.\n   *\n   * @param id - The aggregate id\n   * @param headVersion - The first version, from 1\n   * @param tailVersion - The last version\n   * @param attributes - Optional shared attributes for the interceptors\n   * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.\n   * @returns The event streams of versions `headVersion` to `tailVersion`\n   *\n   * @example\n   * ```typescript\n   * const firstTen = await eventStreamQueryClient.load(cartId, 1, 10);\n   * ```\n   */\n  @get(EventStreamQueryEndpointPaths.LOAD)\n  /* v8 ignore start */\n  load<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @path('id') id: string,\n    @path('headVersion') headVersion: number,\n    @path('tailVersion') tailVersion: number,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<T[]> {\n    throw autoGeneratedError(id, headVersion, tailVersion, attributes, abort);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * {@link load} as a stream, one event stream per server-sent event.\n   * The stream errors with a `WowError` if the server fails midway.\n   */\n  @get(EventStreamQueryEndpointPaths.LOAD, QUERY_STREAM_ENDPOINT)\n  /* v8 ignore start */\n  loadStream<\n    T extends Partial<DomainEventStream<DomainEventBody>> =\n      DomainEventStream<DomainEventBody>,\n  >(\n    @path('id') id: string,\n    @path('headVersion') headVersion: number,\n    @path('tailVersion') tailVersion: number,\n    @attribute() attributes?: Record<string, unknown>,\n    abort?: AbortController | AbortSignal,\n  ): Promise<ReadableStream<T>> {\n    throw autoGeneratedError(id, headVersion, tailVersion, attributes, abort);\n  }\n  /* v8 ignore stop */\n}\n"],"mappings":"qbAmFO,IAAMmB,EAAN,KAKP,CAIE,YAAY,EAA2C,CAA3B,KAAA,YAAAC,EAC1BP,EAAA,YAAY,IAAI,CAClB,CAGA,UAME,EACA,EACA,EACgB,CAChB,MAAA,EAAMb,EAAAA,mBAAAA,CAAmBqB,EAAOC,EAAYC,CAAK,CACnD,CAIA,gBAME,EACA,EACA,EAC8B,CAC9B,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmBqB,EAAOC,EAAYC,CAAK,CACnD,CAIA,OAME,EACA,EACA,EACwB,CACxB,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmBqB,EAAOC,EAAYC,CAAK,CACnD,CAuBA,MAIE,EACA,EACA,EACiB,CACjB,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmBwB,EAAQF,EAAYC,CAAK,CACpD,CA4BA,KAME,EACA,EACA,EACc,CACd,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmByB,EAAWH,EAAYC,CAAK,CACvD,CA6BA,WAME,EACA,EACA,EAC4B,CAC5B,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmByB,EAAWH,EAAYC,CAAK,CACvD,CA8BA,MAME,EACA,EACA,EACuB,CACvB,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmB0B,EAAYJ,EAAYC,CAAK,CACxD,CAwBA,KAME,EACA,EACA,EACA,EACA,EACc,CACd,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmB2B,EAAIC,EAAaC,EAAaP,EAAYC,CAAK,CAC1E,CAOA,WAME,EACA,EACA,EACA,EACA,EAC4B,CAC5B,MAAA,EAAMvB,EAAAA,mBAAAA,CAAmB2B,EAAIC,EAAaC,EAAaP,EAAYC,CAAK,CAC1E,CAEF,cA5PGrB,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,WAAW,EAM5CC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,+NAQZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,YAAaK,EAAAA,qBAAqB,EAMnEJ,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,qOAQZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,MAAM,EAMvCC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,4NA2BZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,KAAK,EAItCC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,2NAgCZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,IAAI,EAMrCC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,0NAiCZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,KAAMK,EAAAA,qBAAqB,EAM5DJ,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,gOAkCZJ,EAAAA,EAAAA,KAAAA,CAAKC,EAAAA,8BAA8B,KAAK,EAMtCC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,KAAAA,CAAK,CAAA,EACLD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,2NA4BZG,EAAAA,EAAAA,IAAAA,CAAIN,EAAAA,8BAA8B,IAAI,EAMpCC,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,IAAI,CAAA,EACTN,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,aAAa,CAAA,EAClBN,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,aAAa,CAAA,EAClBN,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,wOAWZG,EAAAA,EAAAA,IAAAA,CAAIN,EAAAA,8BAA8B,KAAMK,EAAAA,qBAAqB,EAM3DJ,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,IAAI,CAAA,EACTN,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,aAAa,CAAA,EAClBN,EAAAA,QAAA,GAAA,EAAAM,EAAAA,KAAAA,CAAK,aAAa,CAAA,EAClBN,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,kOArQd,EAAAL,EAAAA,QAAA,EAAA,EAAAU,EAAAA,IAAAA,CAAI,EAAAJ,EAAAA,QAAA,oBAAA,CAAA,MAAA,CAAA,CAAA,EAAAY,CAAA"}

package/dist/client/query/event/eventStreamQueryClient.d.cts

@@ -0,0 +1,190 @@
+import { EventStreamQueryApi } from './eventStreamQueryApi.cjs';
+import { AggregationQuery } from '../../../dsl/aggregation/index.cjs';
+import { FilterExpression } from '../../../dsl/filter/index.cjs';
+import { Condition, ListQueryRequest, PagedQueryRequest } from '../requests.cjs';
+import { PagedList } from '../../../dsl/queryable.cjs';
+import { DomainEventStream } from './domainEventStream.cjs';
+import { DynamicDocument } from '../../../dsl/documents.cjs';
+import { CursorPage, CursorQuery } from '../../../dsl/cursorQuery.cjs';
+import { ApiMetadata, ApiMetadataCapable } from '@ahoo-wang/fetcher-decorator';
+/**
+ * Client for querying event streams through HTTP endpoints.
+ * Implements EventStreamQueryApi to provide methods
+ * for querying domain event streams with different query patterns.
+ * This client supports counting, listing, streaming, and paging operations on event streams.
+ *
+ * @example
+ * ```typescript
+ * // Create client options configuration
+ * const clientOptions: ApiMetadata = {
+ *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),
+ *   basePath: 'owner/{ownerId}/cart'
+ * };
+ *
+ * // Create an event stream query client instance
+ * const eventStreamQueryClient = new EventStreamQueryClient(clientOptions);
+ *
+ * // Count event streams
+ * const count = await eventStreamQueryClient.count(filter.matchAll());
+ *
+ * // List event streams
+ * const listQuery: FilterListQuery = {
+ *   filter: filter.matchAll()
+ * };
+ * const list = await eventStreamQueryClient.list(listQuery);
+ *
+ * // List event streams as stream
+ * const listStream = await eventStreamQueryClient.listStream(listQuery);
+ * for await (const domainEventStream of listStream) {
+ *   console.log('Received:', domainEventStream);
+ * }
+ *
+ * // Paged event streams
+ * const pagedQuery: FilterPagedQuery = {
+ *   filter: filter.matchAll()
+ * };
+ * const paged = await eventStreamQueryClient.paged(pagedQuery);
+ * ```
+ */
+export declare class EventStreamQueryClient<DomainEventBody = unknown, FIELDS extends string = string> implements EventStreamQueryApi<DomainEventBody, FIELDS>, ApiMetadataCapable {
+    readonly apiMetadata?: ApiMetadata | undefined;
+    /**
+     * Creates a new EventStreamQueryClient instance.
+     */
+    constructor(apiMetadata?: ApiMetadata | undefined);
+    /** Runs an event stream aggregation and returns all result rows. */
+    aggregate<Row extends object = DynamicDocument, AGGREGATION_FIELDS extends string = string>(query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<Row[]>;
+    /** Runs an event stream aggregation and streams the result rows, one per server-sent event. */
+    aggregateStream<Row extends object = DynamicDocument, AGGREGATION_FIELDS extends string = string>(query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<Row>>;
+    /** Retrieves the next cursor page of domain event streams. */
+    cursor<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(query: CursorQuery<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<CursorPage<T>>;
+    /**
+     * Counts the number of domain event streams that match the given filter.
+     *
+     * @param filter - The filter expression or legacy condition
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to the count of matching event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const count = await eventStreamQueryClient.count(filter.matchAll(), undefined, controller);
+     * console.log('Total event streams:', count);
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    count(filter: FilterExpression<FIELDS> | Condition<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<number>;
+    /**
+     * Retrieves a list of domain event streams based on the provided query parameters.
+     *
+     * @param listQuery - The query parameters for listing event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to an array of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const listQuery: FilterListQuery = {
+     *   filter: filter.matchAll()
+     * };
+     * const list = await eventStreamQueryClient.list(listQuery, undefined, controller);
+     * for (const domainEventStream of list) {
+     *   console.log('Event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    list<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(listQuery: ListQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * Retrieves a stream of domain event streams based on the provided query parameters.
+     * Sets the Accept header to text/event-stream to indicate that the response should be streamed.
+     *
+     * @param listQuery - The query parameters for listing event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to a readable stream of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const listQuery: FilterListQuery = {
+     *   filter: filter.matchAll()
+     * };
+     * const listStream = await eventStreamQueryClient.listStream(listQuery, undefined, controller);
+     * for await (const domainEventStream of listStream) {
+     *   console.log('Received event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    listStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(listQuery: ListQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+    /**
+     * Retrieves a paged list of domain event streams based on the provided query parameters.
+     *
+     * @param pagedQuery - The query parameters for paging event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to a paged list of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const pagedQuery: FilterPagedQuery = {
+     *   filter: filter.matchAll(),
+     *   pagination: { index: 1, size: 10 }
+     * };
+     * const paged = await eventStreamQueryClient.paged(pagedQuery, undefined, controller);
+     * console.log('Total:', paged.total);
+     * for (const domainEventStream of paged.list) {
+     *   console.log('Event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    paged<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(pagedQuery: PagedQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<PagedList<T>>;
+    /**
+     * Loads one aggregate's event streams from `headVersion` to `tailVersion`,
+     * both inclusive, in version order — how an audit trail or an event
+     * sourcing view replays an aggregate. `GET {id}/event/{headVersion}/{tailVersion}`.
+     *
+     * The server treats the range as a list query: more than its maximum list
+     * size (1000 by default) is refused. The route carries a tenant segment by
+     * default but no owner segment, like the load-state routes.
+     *
+     * @param id - The aggregate id
+     * @param headVersion - The first version, from 1
+     * @param tailVersion - The last version
+     * @param attributes - Optional shared attributes for the interceptors
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns The event streams of versions `headVersion` to `tailVersion`
+     *
+     * @example
+     * ```typescript
+     * const firstTen = await eventStreamQueryClient.load(cartId, 1, 10);
+     * ```
+     */
+    load<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * {@link load} as a stream, one event stream per server-sent event.
+     * The stream errors with a `WowError` if the server fails midway.
+     */
+    loadStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+}

package/dist/client/query/event/eventStreamQueryClient.d.ts

@@ -0,0 +1,190 @@
+import { EventStreamQueryApi } from './eventStreamQueryApi.js';
+import { AggregationQuery } from '../../../dsl/aggregation/index.js';
+import { FilterExpression } from '../../../dsl/filter/index.js';
+import { Condition, ListQueryRequest, PagedQueryRequest } from '../requests.js';
+import { PagedList } from '../../../dsl/queryable.js';
+import { DomainEventStream } from './domainEventStream.js';
+import { DynamicDocument } from '../../../dsl/documents.js';
+import { CursorPage, CursorQuery } from '../../../dsl/cursorQuery.js';
+import { ApiMetadata, ApiMetadataCapable } from '@ahoo-wang/fetcher-decorator';
+/**
+ * Client for querying event streams through HTTP endpoints.
+ * Implements EventStreamQueryApi to provide methods
+ * for querying domain event streams with different query patterns.
+ * This client supports counting, listing, streaming, and paging operations on event streams.
+ *
+ * @example
+ * ```typescript
+ * // Create client options configuration
+ * const clientOptions: ApiMetadata = {
+ *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),
+ *   basePath: 'owner/{ownerId}/cart'
+ * };
+ *
+ * // Create an event stream query client instance
+ * const eventStreamQueryClient = new EventStreamQueryClient(clientOptions);
+ *
+ * // Count event streams
+ * const count = await eventStreamQueryClient.count(filter.matchAll());
+ *
+ * // List event streams
+ * const listQuery: FilterListQuery = {
+ *   filter: filter.matchAll()
+ * };
+ * const list = await eventStreamQueryClient.list(listQuery);
+ *
+ * // List event streams as stream
+ * const listStream = await eventStreamQueryClient.listStream(listQuery);
+ * for await (const domainEventStream of listStream) {
+ *   console.log('Received:', domainEventStream);
+ * }
+ *
+ * // Paged event streams
+ * const pagedQuery: FilterPagedQuery = {
+ *   filter: filter.matchAll()
+ * };
+ * const paged = await eventStreamQueryClient.paged(pagedQuery);
+ * ```
+ */
+export declare class EventStreamQueryClient<DomainEventBody = unknown, FIELDS extends string = string> implements EventStreamQueryApi<DomainEventBody, FIELDS>, ApiMetadataCapable {
+    readonly apiMetadata?: ApiMetadata | undefined;
+    /**
+     * Creates a new EventStreamQueryClient instance.
+     */
+    constructor(apiMetadata?: ApiMetadata | undefined);
+    /** Runs an event stream aggregation and returns all result rows. */
+    aggregate<Row extends object = DynamicDocument, AGGREGATION_FIELDS extends string = string>(query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<Row[]>;
+    /** Runs an event stream aggregation and streams the result rows, one per server-sent event. */
+    aggregateStream<Row extends object = DynamicDocument, AGGREGATION_FIELDS extends string = string>(query: AggregationQuery<FIELDS, AGGREGATION_FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<Row>>;
+    /** Retrieves the next cursor page of domain event streams. */
+    cursor<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(query: CursorQuery<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<CursorPage<T>>;
+    /**
+     * Counts the number of domain event streams that match the given filter.
+     *
+     * @param filter - The filter expression or legacy condition
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to the count of matching event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const count = await eventStreamQueryClient.count(filter.matchAll(), undefined, controller);
+     * console.log('Total event streams:', count);
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    count(filter: FilterExpression<FIELDS> | Condition<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<number>;
+    /**
+     * Retrieves a list of domain event streams based on the provided query parameters.
+     *
+     * @param listQuery - The query parameters for listing event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to an array of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const listQuery: FilterListQuery = {
+     *   filter: filter.matchAll()
+     * };
+     * const list = await eventStreamQueryClient.list(listQuery, undefined, controller);
+     * for (const domainEventStream of list) {
+     *   console.log('Event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    list<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(listQuery: ListQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * Retrieves a stream of domain event streams based on the provided query parameters.
+     * Sets the Accept header to text/event-stream to indicate that the response should be streamed.
+     *
+     * @param listQuery - The query parameters for listing event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to a readable stream of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const listQuery: FilterListQuery = {
+     *   filter: filter.matchAll()
+     * };
+     * const listStream = await eventStreamQueryClient.listStream(listQuery, undefined, controller);
+     * for await (const domainEventStream of listStream) {
+     *   console.log('Received event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    listStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(listQuery: ListQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+    /**
+     * Retrieves a paged list of domain event streams based on the provided query parameters.
+     *
+     * @param pagedQuery - The query parameters for paging event streams
+     * @param attributes - Optional shared attributes that can be accessed by interceptors
+     *                     throughout the request lifecycle. These attributes allow passing
+     *                     custom data between different interceptors.
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns A promise that resolves to a paged list of partial domain event streams
+     *
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const pagedQuery: FilterPagedQuery = {
+     *   filter: filter.matchAll(),
+     *   pagination: { index: 1, size: 10 }
+     * };
+     * const paged = await eventStreamQueryClient.paged(pagedQuery, undefined, controller);
+     * console.log('Total:', paged.total);
+     * for (const domainEventStream of paged.list) {
+     *   console.log('Event stream:', domainEventStream);
+     * }
+     *
+     * // Cancel the request if needed
+     * controller.abort();
+     * ```
+     */
+    paged<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(pagedQuery: PagedQueryRequest<FIELDS>, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<PagedList<T>>;
+    /**
+     * Loads one aggregate's event streams from `headVersion` to `tailVersion`,
+     * both inclusive, in version order — how an audit trail or an event
+     * sourcing view replays an aggregate. `GET {id}/event/{headVersion}/{tailVersion}`.
+     *
+     * The server treats the range as a list query: more than its maximum list
+     * size (1000 by default) is refused. The route carries a tenant segment by
+     * default but no owner segment, like the load-state routes.
+     *
+     * @param id - The aggregate id
+     * @param headVersion - The first version, from 1
+     * @param tailVersion - The last version
+     * @param attributes - Optional shared attributes for the interceptors
+     * @param abort - Cancels the request: an `AbortController`, or an `AbortSignal` such as `AbortSignal.timeout(ms)` or the `signal` a data-fetching library passes.
+     * @returns The event streams of versions `headVersion` to `tailVersion`
+     *
+     * @example
+     * ```typescript
+     * const firstTen = await eventStreamQueryClient.load(cartId, 1, 10);
+     * ```
+     */
+    load<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<T[]>;
+    /**
+     * {@link load} as a stream, one event stream per server-sent event.
+     * The stream errors with a `WowError` if the server fails midway.
+     */
+    loadStream<T extends Partial<DomainEventStream<DomainEventBody>> = DomainEventStream<DomainEventBody>>(id: string, headVersion: number, tailVersion: number, attributes?: Record<string, unknown>, abort?: AbortController | AbortSignal): Promise<ReadableStream<T>>;
+}

package/dist/client/query/event/eventStreamQueryClient.es.js

@@ -0,0 +1,160 @@
+import { QUERY_STREAM_ENDPOINT as e } from "../../../transport/endpoints.es.js";
+import { bindMethods as t } from "../../bindMethods.es.js";
+import n from "../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.es.js";
+import r from "../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateParam.es.js";
+import i from "../../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.es.js";
+import { EventStreamQueryEndpointPaths as a } from "./endpointPaths.es.js";
+import { api as o, attribute as s, autoGeneratedError as c, body as l, get as u, path as d, post as f } from "@ahoo-wang/fetcher-decorator";
+//#region src/client/query/event/eventStreamQueryClient.ts
+var p = class {
+	constructor(e) {
+		this.apiMetadata = e, t(this);
+	}
+	aggregate(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	aggregateStream(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	cursor(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	count(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	list(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	listStream(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	paged(e, t, n) {
+		throw c(e, t, n);
+	}
+	/* v8 ignore stop */
+	load(e, t, n, r, i) {
+		throw c(e, t, n, r, i);
+	}
+	/* v8 ignore stop */
+	loadStream(e, t, n, r, i) {
+		throw c(e, t, n, r, i);
+	}
+};
+i([
+	f(a.AGGREGATION),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "aggregate", null), i([
+	f(a.AGGREGATION, e),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "aggregateStream", null), i([
+	f(a.CURSOR),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "cursor", null), i([
+	f(a.COUNT),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "count", null), i([
+	f(a.LIST),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "list", null), i([
+	f(a.LIST, e),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "listStream", null), i([
+	f(a.PAGED),
+	r(0, l()),
+	r(1, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		Object,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "paged", null), i([
+	u(a.LOAD),
+	r(0, d("id")),
+	r(1, d("headVersion")),
+	r(2, d("tailVersion")),
+	r(3, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		String,
+		Number,
+		Number,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "load", null), i([
+	u(a.LOAD, e),
+	r(0, d("id")),
+	r(1, d("headVersion")),
+	r(2, d("tailVersion")),
+	r(3, s()),
+	n("design:type", Function),
+	n("design:paramtypes", [
+		String,
+		Number,
+		Number,
+		typeof Record > "u" ? Object : Record,
+		Object
+	]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], p.prototype, "loadStream", null), p = i([o(), n("design:paramtypes", [Object])], p);
+//#endregion
+export { p as EventStreamQueryClient };
+
+//# sourceMappingURL=eventStreamQueryClient.es.js.map