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

package/README.zh-CN.md

@@ -0,0 +1,267 @@
+# `@ahoo-wang/wow-client`
+
+面向 Wow 命令、快照、领域事件、过滤、分页与聚合的类型化 Fetcher 客户端和契约。只在
+对接 Wow HTTP 端点时使用。
+
+支持的服务端：Wow 8.11 及以后通过 `filter` API；Wow 8.10 通过
+[`/legacy`](#wow-810-服务端ahoo-wangwow-clientlegacy)。CI 用同版本的服务端测试
+客户端，并对 Wow 8.11.5、9.1.3、9.1.5 做运行时冒烟测试；对 8.10.8 只检查生成代码的类型。
+Node `>=22.12.0` 或现代浏览器。TypeScript 6 或更高版本：CI 测试 6.0 到最新的 7.x。详见
+[兼容性矩阵](https://wow.ahoo.me/zh/guide/typescript/compatibility)。
+
+随 Wow 9.2.0 发布，与 Wow 同一个 tag、同一个版本号。
+
+## 安装
+
+```bash
+pnpm add @ahoo-wang/fetcher @ahoo-wang/fetcher-decorator \
+  @ahoo-wang/fetcher-eventstream @ahoo-wang/wow-client
+```
+
+版本号跟随 Wow，次版本可能带有破坏性改动：用 `save-prefix=~` 或 `--save-exact` 让 Wow 包停在同一个次版本上，见[版本范围](https://wow.ahoo.me/zh/guide/typescript/compatibility#版本范围)。
+
+Peer 依赖：`fetcher`、`fetcher-decorator` 和 `fetcher-eventstream`。
+
+## 查询
+
+```ts
+import { Fetcher } from '@ahoo-wang/fetcher';
+import { SnapshotQueryClient, filter, listQuery } from '@ahoo-wang/wow-client';
+
+interface CartState {
+  status: 'ACTIVE' | 'CHECKED_OUT';
+}
+
+const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
+const snapshots = new SnapshotQueryClient<CartState>({
+  fetcher,
+  basePath: 'cart',
+});
+
+const carts = await snapshots.listState(
+  listQuery({
+    filter: filter.and([
+      filter.ownerId('u-42'),
+      filter.eq('state.status', 'ACTIVE'),
+    ]),
+    limit: 50,
+  }),
+);
+```
+
+`listQuery()`、`pagedQuery()`、`singleQuery()` 不传过滤条件时匹配全部。`listQuery()`
+只在给出 `limit` 时才发送它；不带 `limit` 时服务端怎么做，取决于它的版本：
+
+- Wow 9.1.5 及以后：用服务端的默认列表大小（未另行配置时为 100）。
+- Wow 8.11～9.1.3：以 `IllegalArgument` 拒绝，信息里有
+  `limit[0] must be between 1 and 1000`；列表是 HTTP 400，列表流以这个错误事件结束。对这些服务端请显式传 `limit`；
+  这次拒绝得到的 `WowError` 也会这样提示。
+
+相对时间由服务端求值，不用浏览器的时钟。`filter.beforeNow` 与 `filter.afterNow`
+把时间字段与服务端的「现在 + ISO-8601 `offset`」做严格比较（默认 `PT0S`，负值表示回看），
+每个查询只取一次时钟，所以保存的视图在每个客户端上含义相同：
+
+```ts
+import { filter } from '@ahoo-wang/wow-client';
+
+const overdue = filter.beforeNow('state.timeoutAt');
+const lastHalfHour = filter.afterNow('state.createTime', '-PT30M');
+```
+
+`BEFORE_NOW` 与 `AFTER_NOW` 需要 Wow 9.2.0 及以上；更早的服务端会拒绝该查询。
+
+## 服务端能查什么：能力描述
+
+`QueryDescriptorClient` 读取 `GET {aggregate}/snapshot/schema` 与
+`GET {aggregate}/event/schema`（Wow 9.2.0 及以上）：一份 `QueryModelDescriptor`，
+列出每个可查询字段允许的过滤算子、排序与聚合，哪些指标是估算值、日期直方图可用哪些单位、按日期部分分组可用哪些部分、日期差可用哪些单位、`FIRST` 与 `LAST` 未指定时按哪个字段排序，
+以及分页方式、全文检索（记录上的，以及存储支持时元素内的）和该入口的上限。
+它列出的每项能力单独使用都会被接受，没列出的都会被拒绝。用它只提供服务端接受的选项，
+不必把算子表和上限写死。
+
+<!-- typecheck-context
+import type { Fetcher } from '@ahoo-wang/fetcher';
+declare const fetcher: Fetcher;
+-->
+
+```ts
+import { FilterOperator, QueryDescriptorClient } from '@ahoo-wang/wow-client';
+
+// schema 路由没有租户、所有者段。
+const descriptors = new QueryDescriptorClient({ fetcher, basePath: 'cart' });
+
+const first = await descriptors.describeSnapshot();
+if (!first.notModified) {
+  const productId = first.descriptor.fields.find(
+    field => field.path === 'state.items.productId',
+  );
+  const canSearchByPrefix = productId?.filter.operators.includes(
+    FilterOperator.STARTS_WITH,
+  );
+}
+
+// 重新验证手上的副本：304 时得到 { notModified: true, version }。
+const again = await descriptors.describeSnapshot(first.version);
+```
+
+描述与调用者无关，`version` 同时是 ETag。持有它，下次把版本（或 ETag）传回：
+方法会发送 `If-None-Match`，服务端答 304 时得到 `{ notModified: true, version }`。
+`QueryClientFactory.createQueryDescriptorClient()` 拼基础路径时不带工厂的资源归属。
+服务端每隔几分钟重新加载 schema，所以长时间打开的页面应当重新验证，而不是永久缓存。
+
+## 发送命令
+
+<!-- typecheck-context
+import { Fetcher } from '@ahoo-wang/fetcher';
+declare const fetcher: Fetcher;
+-->
+
+```ts
+import {
+  CommandClient,
+  CommandStage,
+  commandHeaders,
+  waitStrategy,
+} from '@ahoo-wang/wow-client';
+
+const commands = new CommandClient({ fetcher, basePath: 'cart' });
+const result = await commands.send({
+  path: 'add_cart_item',
+  method: 'POST',
+  headers: {
+    ...commandHeaders({ ownerId: 'u-42', requestId: crypto.randomUUID() }),
+    ...waitStrategy({ stage: CommandStage.SNAPSHOT, timeoutMs: 10_000 }),
+  },
+  body: { productId: 'p-1', quantity: 1 },
+});
+```
+
+`CommandRequestHeaders` 按服务端的解析方式给每个命令头定类型：等待阶段必须是
+`CommandStage`，超时是整数毫秒。`waitStrategy()` 也能构建 Wow 的等待链
+（`SAGA_HANDLED` 加 `tail`）。`sendAndWaitStream()` 在命令每到达一个阶段时产出一个
+`CommandResult`。
+
+## 错误
+
+服务端返回的错误是 `WowError`，带着服务端的 `ErrorInfo`（`errorCode`、`errorMsg`、
+`bindingErrors`）和 HTTP 状态码。用 `ErrorCodes` 比较 `errorCode`。Wow 以 HTTP 错误
+状态应答被拒绝的请求，包括命令处理函数失败的命令，所以调用会拒绝（reject）。
+
+```ts
+import {
+  ErrorCodes,
+  toWowError,
+  type SnapshotQueryClient,
+} from '@ahoo-wang/wow-client';
+
+async function findCart(snapshots: SnapshotQueryClient<unknown>, id: string) {
+  try {
+    return await snapshots.getStateById(id);
+  } catch (error) {
+    const wowError = await toWowError(error);
+    if (wowError?.errorCode === ErrorCodes.NOT_FOUND) return undefined;
+    throw wowError ?? error;
+  }
+}
+```
+
+- 请求失败时抛出的是 fetcher 的错误。`toWowError()` 读取响应体里的 `ErrorInfo`，
+  读不到时读 `Wow-Error-Code` 响应头；不是 Wow 服务端的应答（网络故障、超时、取消、
+  代理自己的错误页）时返回 `undefined`。
+- 流（`listStream`、`aggregateStream`、`sendAndWaitStream` 等）中途失败时，流以
+  `WowError` 结束，`for await` 会抛出它。服务端此时的 HTTP 状态仍是 200，错误作为
+  最后一个事件发出；不这样处理的话，错误会被当成一行数据。
+- 被拒绝的查询（解码阶段为 `IllegalArgument`，准入阶段为 `QuerySchemaValidation`）
+  会说明违反了哪条规则、在哪里：`wowError.violation` 为 `{ code, path, message }`，
+  `code` 取自 `QueryErrorCodes`，`path` 是 JSON 路径（`filter.state`）或逻辑字段
+  （`state.items.sku`）。码的列表只增不改，未处理的码回退到 `errorMsg`。从 Wow 9.2
+  起，预算与闸门类拒绝也带码（`SIZE_OUT_OF_RANGE`、`EXPENSIVE_OPERATOR_DISABLED` 等）；更早的
+  服务端只给文字（`HTTP list query limit[...]`）。服务端自身的故障应答 HTTP 500
+  `InternalServerError`，不带码。
+
+<!-- typecheck-context
+import type { WowError } from '@ahoo-wang/wow-client';
+declare const wowError: WowError;
+declare function markField(path: string, message: string): void;
+-->
+
+```ts
+import { QueryErrorCodes } from '@ahoo-wang/wow-client';
+
+const violation = wowError.violation;
+if (violation?.code === QueryErrorCodes.UNKNOWN_FIELD) {
+  markField(violation.path, violation.message);
+}
+```
+
+## 取消
+
+每个查询方法的最后一个参数（在拦截器属性之后）接受 `AbortController` 或
+`AbortSignal`：
+
+<!-- typecheck-context
+import type { FilterPagedQuery, SnapshotQueryClient } from '@ahoo-wang/wow-client';
+declare const snapshots: SnapshotQueryClient<unknown>;
+declare const query: FilterPagedQuery;
+-->
+
+```ts
+const page = await snapshots.pagedState(
+  query,
+  undefined,
+  AbortSignal.timeout(5_000),
+);
+```
+
+## 不带 HTTP 的查询构建：`@ahoo-wang/wow-client/dsl`
+
+`filter`、`aggregation`、排序、投影、分页、游标查询、查询工厂和能力描述的类型，不带客户端：不加载
+Fetcher、装饰器、`reflect-metadata`，也不装 `fetcher-eventstream` 的全局流补丁。
+只构建查询的包从这里导入。
+
+## Wow 8.10 服务端：`@ahoo-wang/wow-client/legacy`
+
+根入口只使用 `FilterExpression`，Wow 8.11 及以后的服务端都支持。Wow 8.10 只认
+已弃用的 Condition 模型，本包把它放在单独的子路径里，保留到 v10：
+
+<!-- typecheck-context
+import type { SnapshotQueryClient } from '@ahoo-wang/wow-client';
+declare const snapshots: SnapshotQueryClient<unknown>;
+-->
+
+```ts
+import { and, eq, listQuery, ownerId } from '@ahoo-wang/wow-client/legacy';
+
+const carts = await snapshots.listState(
+  listQuery({ condition: and(ownerId('u-42'), eq('state.status', 'ACTIVE')) }),
+);
+```
+
+查询客户端两种查询都接受，其余一切都从根入口导入。这个子路径在 v10 删除。
+
+## 核心能力
+
+- 命令结果与流式等待阶段。
+- 快照、领域事件、状态加载与所有者状态客户端；按版本区间加载事件流
+  （`EventStreamQueryClient.load`）；服务端元数据（`WowMetadataClient`）；
+  支持条件请求的查询能力描述（`QueryDescriptorClient`）。
+- 提前校验的数组优先 `FilterExpression` 构建器。
+- 单条、列表、分页、游标、计数与流查询契约。
+- 投影、排序、嵌套聚合、建模、ABAC 与元数据类型。
+- `aggregation.query()` 按 Wow 服务端同样的规则校验整个聚合查询，
+  让错误在构建处暴露，而不是等到请求被拒。
+
+暂时没有客户端的：`GET {id}/snapshot`、`GET {id}/state/tracing`，以及
+`/wow/command/send` 路由（用 `CommandClient` 加上 `COMMAND_AGGREGATE_CONTEXT`、
+`COMMAND_AGGREGATE_NAME`、`COMMAND_TYPE` 三个头发送）。
+
+## 文档
+
+- [快速开始：调用 Wow 服务](https://wow.ahoo.me/zh/guide/typescript/quick-start)
+- [错误处理](https://wow.ahoo.me/zh/guide/typescript/error-handling)与
+  [认证](https://wow.ahoo.me/zh/guide/typescript/authentication)
+- [TypeScript 指南](https://wow.ahoo.me/zh/guide/typescript/)
+- [wow-client 参考](https://wow.ahoo.me/zh/reference/typescript/wow-client/)
+- [交互式查询 Story](https://wow.ahoo.me/storybook/)
+
+[English](./README.md) · [许可证](https://github.com/Ahoo-Wang/Wow/blob/main/LICENSE)

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.cjs

@@ -0,0 +1 @@
+function e(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}exports.default=e;

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.es.js

@@ -0,0 +1,9 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
+function e(e, t, n, r) {
+	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
+	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
+	else for (var s = e.length - 1; s >= 0; s--) (o = e[s]) && (a = (i < 3 ? o(a) : i > 3 ? o(t, n, a) : o(t, n)) || a);
+	return i > 3 && a && Object.defineProperty(t, n, a), a;
+}
+//#endregion
+export { e as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.cjs

@@ -0,0 +1 @@
+function e(e,t){if(typeof Reflect==`object`&&typeof Reflect.metadata==`function`)return Reflect.metadata(e,t)}exports.default=e;

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.es.js

@@ -0,0 +1,6 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
+function e(e, t) {
+	if (typeof Reflect == "object" && typeof Reflect.metadata == "function") return Reflect.metadata(e, t);
+}
+//#endregion
+export { e as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateParam.cjs

@@ -0,0 +1 @@
+function e(e,t){return function(n,r){t(n,r,e)}}exports.default=e;

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateParam.es.js

@@ -0,0 +1,8 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateParam.js
+function e(e, t) {
+	return function(n, r) {
+		t(n, r, e);
+	};
+}
+//#endregion
+export { e as default };

package/dist/client/bindMethods.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=new Set(Object.getOwnPropertyNames(e));for(let n=Object.getPrototypeOf(e);n!==null&&n!==Object.prototype;n=Object.getPrototypeOf(n))for(let r of Object.getOwnPropertyNames(n)){if(r===`constructor`||t.has(r))continue;t.add(r);let i=Object.getOwnPropertyDescriptor(n,r)?.value;typeof i==`function`&&Object.defineProperty(e,r,{value:i.bind(e),writable:!0,configurable:!0,enumerable:!1})}}exports.bindMethods=e;
+//# sourceMappingURL=bindMethods.cjs.map

package/dist/client/bindMethods.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindMethods.cjs","names":["bindMethods","seen","client","prototype","name","method"],"sources":["../../src/client/bindMethods.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\n/**\n * (internal) Binds every method a client inherits to the client itself, so a\n * method handed on as a function — `execute: client.listState` in a\n * wow-react hook, `ids.map(client.getStateById)` — still reaches its fetcher.\n * The decorated methods read the client's metadata through `this`; unbound,\n * they failed with `Cannot read properties of undefined`.\n *\n * Each bound copy is an own, non-enumerable property, so spreading or\n * serialising a client is unchanged, and the prototype keeps the methods for\n * reflection. A subclass's override is the one bound: the lookup starts at\n * the instance.\n */\nexport function bindMethods(client: object): void {\n  const seen = new Set(Object.getOwnPropertyNames(client));\n  for (\n    let prototype: object | null = Object.getPrototypeOf(client);\n    prototype !== null && prototype !== Object.prototype;\n    prototype = Object.getPrototypeOf(prototype)\n  ) {\n    for (const name of Object.getOwnPropertyNames(prototype)) {\n      if (name === 'constructor' || seen.has(name)) continue;\n      seen.add(name);\n      // The first prototype that names it is the one a lookup finds; a\n      // getter is left alone rather than run.\n      const method: unknown = Object.getOwnPropertyDescriptor(\n        prototype,\n        name,\n      )?.value;\n      if (typeof method !== 'function') continue;\n      Object.defineProperty(client, name, {\n        value: method.bind(client),\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n    }\n  }\n}\n"],"mappings":"AAyBA,SAAgBA,EAAY,EAAsB,CAChD,IAAMC,EAAO,IAAI,IAAI,OAAO,oBAAoBC,CAAM,CAAC,EACvD,IACE,IAAIC,EAA2B,OAAO,eAAeD,CAAM,EAC3DC,IAAc,MAAQA,IAAc,OAAO,UAC3C,EAAY,OAAO,eAAeA,CAAS,EAE3C,IAAK,IAAMC,KAAQ,OAAO,oBAAoBD,CAAS,EAAG,CACxD,GAAIC,IAAS,eAAiBH,EAAK,IAAIG,CAAI,EAAG,SAC9CH,EAAK,IAAIG,CAAI,EAGb,IAAMC,EAAkB,OAAO,yBAC7BF,EACAC,CACF,CAAC,EAAE,MACC,OAAOC,GAAW,YACtB,OAAO,eAAeH,EAAQE,EAAM,CAClC,MAAOC,EAAO,KAAKH,CAAM,EACzB,SAAU,GACV,aAAc,GACd,WAAY,EACd,CAAC,CACH,CAEJ"}

package/dist/client/bindMethods.d.cts

@@ -0,0 +1,13 @@
+/**
+ * (internal) Binds every method a client inherits to the client itself, so a
+ * method handed on as a function — `execute: client.listState` in a
+ * wow-react hook, `ids.map(client.getStateById)` — still reaches its fetcher.
+ * The decorated methods read the client's metadata through `this`; unbound,
+ * they failed with `Cannot read properties of undefined`.
+ *
+ * Each bound copy is an own, non-enumerable property, so spreading or
+ * serialising a client is unchanged, and the prototype keeps the methods for
+ * reflection. A subclass's override is the one bound: the lookup starts at
+ * the instance.
+ */
+export declare function bindMethods(client: object): void;

package/dist/client/bindMethods.d.ts

@@ -0,0 +1,13 @@
+/**
+ * (internal) Binds every method a client inherits to the client itself, so a
+ * method handed on as a function — `execute: client.listState` in a
+ * wow-react hook, `ids.map(client.getStateById)` — still reaches its fetcher.
+ * The decorated methods read the client's metadata through `this`; unbound,
+ * they failed with `Cannot read properties of undefined`.
+ *
+ * Each bound copy is an own, non-enumerable property, so spreading or
+ * serialising a client is unchanged, and the prototype keeps the methods for
+ * reflection. A subclass's override is the one bound: the lookup starts at
+ * the instance.
+ */
+export declare function bindMethods(client: object): void;

package/dist/client/bindMethods.es.js

@@ -0,0 +1,19 @@
+//#region src/client/bindMethods.ts
+function e(e) {
+	let t = new Set(Object.getOwnPropertyNames(e));
+	for (let n = Object.getPrototypeOf(e); n !== null && n !== Object.prototype; n = Object.getPrototypeOf(n)) for (let r of Object.getOwnPropertyNames(n)) {
+		if (r === "constructor" || t.has(r)) continue;
+		t.add(r);
+		let i = Object.getOwnPropertyDescriptor(n, r)?.value;
+		typeof i == "function" && Object.defineProperty(e, r, {
+			value: i.bind(e),
+			writable: !0,
+			configurable: !0,
+			enumerable: !1
+		});
+	}
+}
+//#endregion
+export { e as bindMethods };
+
+//# sourceMappingURL=bindMethods.es.js.map

package/dist/client/bindMethods.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindMethods.es.js","names":["bindMethods","seen","client","prototype","name","method"],"sources":["../../src/client/bindMethods.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\n/**\n * (internal) Binds every method a client inherits to the client itself, so a\n * method handed on as a function — `execute: client.listState` in a\n * wow-react hook, `ids.map(client.getStateById)` — still reaches its fetcher.\n * The decorated methods read the client's metadata through `this`; unbound,\n * they failed with `Cannot read properties of undefined`.\n *\n * Each bound copy is an own, non-enumerable property, so spreading or\n * serialising a client is unchanged, and the prototype keeps the methods for\n * reflection. A subclass's override is the one bound: the lookup starts at\n * the instance.\n */\nexport function bindMethods(client: object): void {\n  const seen = new Set(Object.getOwnPropertyNames(client));\n  for (\n    let prototype: object | null = Object.getPrototypeOf(client);\n    prototype !== null && prototype !== Object.prototype;\n    prototype = Object.getPrototypeOf(prototype)\n  ) {\n    for (const name of Object.getOwnPropertyNames(prototype)) {\n      if (name === 'constructor' || seen.has(name)) continue;\n      seen.add(name);\n      // The first prototype that names it is the one a lookup finds; a\n      // getter is left alone rather than run.\n      const method: unknown = Object.getOwnPropertyDescriptor(\n        prototype,\n        name,\n      )?.value;\n      if (typeof method !== 'function') continue;\n      Object.defineProperty(client, name, {\n        value: method.bind(client),\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n    }\n  }\n}\n"],"mappings":";AAyBA,SAAgBA,EAAY,GAAsB;CAChD,IAAMC,IAAO,IAAI,IAAI,OAAO,oBAAoBC,CAAM,CAAC;CACvD,KACE,IAAIC,IAA2B,OAAO,eAAeD,CAAM,GAC3DC,MAAc,QAAQA,MAAc,OAAO,WAC3C,IAAY,OAAO,eAAeA,CAAS,GAE3C,KAAK,IAAMC,KAAQ,OAAO,oBAAoBD,CAAS,GAAG;EACxD,IAAIC,MAAS,iBAAiBH,EAAK,IAAIG,CAAI,GAAG;EAC9C,EAAK,IAAIA,CAAI;EAGb,IAAMC,IAAkB,OAAO,yBAC7BF,GACAC,CACF,CAAC,EAAE;EACH,AAAI,OAAOC,KAAW,cACtB,OAAO,eAAeH,GAAQE,GAAM;GAClC,OAAOC,EAAO,KAAKH,CAAM;GACzB,UAAU;GACV,cAAc;GACd,YAAY;EACd,CAAC;CACH;AAEJ"}

package/dist/client/command/commandClient.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");let a=require("@ahoo-wang/fetcher-decorator");var o=class{constructor(e){this.apiMetadata=e,t.bindMethods(this)}send(e,t){throw(0,a.autoGeneratedError)(e,t)}sendAndWaitStream(e,t){throw(0,a.autoGeneratedError)(e,t)}};i.default([(0,a.endpoint)(),r.default(0,(0,a.request)()),r.default(1,(0,a.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],o.prototype,`send`,null),i.default([(0,a.endpoint)(void 0,void 0,e.COMMAND_STREAM_ENDPOINT),r.default(0,(0,a.request)()),r.default(1,(0,a.attribute)()),n.default(`design:type`,Function),n.default(`design:paramtypes`,[Object,typeof Record>`u`?Object:Record]),n.default(`design:returntype`,typeof Promise>`u`?Object:Promise)],o.prototype,`sendAndWaitStream`,null),o=i.default([(0,a.api)(),n.default(`design:paramtypes`,[Object])],o),Object.defineProperty(exports,"CommandClient",{enumerable:!0,get:function(){return o}});
+//# sourceMappingURL=commandClient.cjs.map

package/dist/client/command/commandClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandClient.cjs","names":["autoGeneratedError","_decorate","endpoint","_decorateParam","request","attribute","_decorateMetadata","COMMAND_STREAM_ENDPOINT","api","require_endpoints","require_bindMethods","require_decorateMetadata","require_decorateParam","require_decorate","_ahoo_wang_fetcher_decorator","CommandClient","apiMetadata","commandRequest","attributes"],"sources":["../../../src/client/command/commandClient.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 CommandRequest } from './commandRequest.js';\nimport type { CommandResult } from '../../model/index.js';\nimport type { CommandResultEventStream } from './commandResult.js';\nimport { COMMAND_STREAM_ENDPOINT } from '../../transport/endpoints.js';\n\nimport type {\n  ApiMetadata,\n  ApiMetadataCapable,\n} from '@ahoo-wang/fetcher-decorator';\nimport {\n  api,\n  attribute,\n  autoGeneratedError,\n  endpoint,\n  request,\n} from '@ahoo-wang/fetcher-decorator';\nimport { bindMethods } from '../bindMethods.js';\n\n/**\n * Sends commands to a Wow command route.\n *\n * The request's `path` names the command route, relative to the client's base\n * path; its `headers` say who the command is for and what to wait for (see\n * {@link commandHeaders} and {@link waitStrategy}); its `body` is the command.\n * The body type is chosen per call, so one client sends every command of an\n * aggregate.\n *\n * @example\n * ```typescript\n * const commandClient = new CommandClient({\n *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),\n *   basePath: 'owner/{ownerId}/cart',\n * });\n *\n * const result = await commandClient.send<{ productId: string; quantity: number }>({\n *   path: 'add_cart_item',\n *   method: 'POST',\n *   urlParams: { path: { ownerId: 'user-1' } },\n *   headers: waitStrategy({ stage: CommandStage.SNAPSHOT }),\n *   body: { productId: 'product-1', quantity: 1 },\n * });\n * ```\n */\n@api()\nexport class CommandClient implements ApiMetadataCapable {\n  constructor(public readonly apiMetadata?: ApiMetadata) {\n    bindMethods(this);\n  }\n\n  /**\n   * Sends a command and resolves to the result of the stage it waited for\n   * (`PROCESSED` unless the headers say otherwise). A command the server\n   * refuses or fails to process rejects: Wow answers the failed result with\n   * the HTTP status its `errorCode` maps to. Read it with `toWowError`.\n   *\n   * @param commandRequest - The route path, headers and body of the command\n   * @param attributes - Optional shared attributes for the interceptors\n   * @returns The command result\n   */\n  @endpoint()\n  /* v8 ignore start */\n  send<C extends object = object>(\n    @request() commandRequest: CommandRequest<C>,\n    @attribute() attributes?: Record<string, unknown>,\n  ): Promise<CommandResult> {\n    throw autoGeneratedError(commandRequest, attributes);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Sends a command and streams one result for every stage it reaches, up to\n   * the one it waits for. The stream errors with a `WowError` if the server\n   * fails midway, for example when the wait times out.\n   *\n   * @param commandRequest - The route path, headers and body of the command\n   * @param attributes - Optional shared attributes for the interceptors\n   * @returns A stream of command results\n   *\n   * @example\n   * ```typescript\n   * const results = await commandClient.sendAndWaitStream({\n   *   path: 'add_cart_item',\n   *   method: 'POST',\n   *   headers: waitStrategy({ stage: CommandStage.PROJECTED }),\n   *   body: { productId: 'product-1', quantity: 2 },\n   * });\n   * for await (const result of results) {\n   *   console.log(result.stage);\n   * }\n   * ```\n   */\n  @endpoint(undefined, undefined, COMMAND_STREAM_ENDPOINT)\n  /* v8 ignore start */\n  sendAndWaitStream<C extends object = object>(\n    @request() commandRequest: CommandRequest<C>,\n    @attribute() attributes?: Record<string, unknown>,\n  ): Promise<CommandResultEventStream> {\n    throw autoGeneratedError(commandRequest, attributes);\n  }\n  /* v8 ignore stop */\n}\n"],"mappings":"qYAyDO,IAAMe,EAAN,KAAkD,CACvD,YAAY,EAA2C,CAA3B,KAAA,YAAAC,EAC1BN,EAAA,YAAY,IAAI,CAClB,CAYA,KAGE,EACA,EACwB,CACxB,MAAA,EAAMV,EAAAA,mBAAAA,CAAmBiB,EAAgBC,CAAU,CACrD,CAyBA,kBAGE,EACA,EACmC,CACnC,MAAA,EAAMlB,EAAAA,mBAAAA,CAAmBiB,EAAgBC,CAAU,CACrD,CAEF,cAzCGhB,EAAAA,EAAAA,SAAAA,CAAS,EAGPC,EAAAA,QAAA,GAAA,EAAAC,EAAAA,QAAAA,CAAQ,CAAA,EACRD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,mNA4BZH,EAAAA,EAAAA,SAAAA,CAAS,IAAA,GAAW,IAAA,GAAWK,EAAAA,uBAAuB,EAGpDJ,EAAAA,QAAA,GAAA,EAAAC,EAAAA,QAAAA,CAAQ,CAAA,EACRD,EAAAA,QAAA,GAAA,EAAAE,EAAAA,UAAAA,CAAU,CAAA,oNApDd,EAAAJ,EAAAA,QAAA,EAAA,EAAAO,EAAAA,IAAAA,CAAI,EAAAF,EAAAA,QAAA,oBAAA,CAAA,MAAA,CAAA,CAAA,EAAAS,CAAA"}

package/dist/client/command/commandClient.d.cts

@@ -0,0 +1,67 @@
+import { CommandRequest } from './commandRequest.cjs';
+import { CommandResult } from '../../model/index.cjs';
+import { CommandResultEventStream } from './commandResult.cjs';
+import { ApiMetadata, ApiMetadataCapable } from '@ahoo-wang/fetcher-decorator';
+/**
+ * Sends commands to a Wow command route.
+ *
+ * The request's `path` names the command route, relative to the client's base
+ * path; its `headers` say who the command is for and what to wait for (see
+ * {@link commandHeaders} and {@link waitStrategy}); its `body` is the command.
+ * The body type is chosen per call, so one client sends every command of an
+ * aggregate.
+ *
+ * @example
+ * ```typescript
+ * const commandClient = new CommandClient({
+ *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),
+ *   basePath: 'owner/{ownerId}/cart',
+ * });
+ *
+ * const result = await commandClient.send<{ productId: string; quantity: number }>({
+ *   path: 'add_cart_item',
+ *   method: 'POST',
+ *   urlParams: { path: { ownerId: 'user-1' } },
+ *   headers: waitStrategy({ stage: CommandStage.SNAPSHOT }),
+ *   body: { productId: 'product-1', quantity: 1 },
+ * });
+ * ```
+ */
+export declare class CommandClient implements ApiMetadataCapable {
+    readonly apiMetadata?: ApiMetadata | undefined;
+    constructor(apiMetadata?: ApiMetadata | undefined);
+    /**
+     * Sends a command and resolves to the result of the stage it waited for
+     * (`PROCESSED` unless the headers say otherwise). A command the server
+     * refuses or fails to process rejects: Wow answers the failed result with
+     * the HTTP status its `errorCode` maps to. Read it with `toWowError`.
+     *
+     * @param commandRequest - The route path, headers and body of the command
+     * @param attributes - Optional shared attributes for the interceptors
+     * @returns The command result
+     */
+    send<C extends object = object>(commandRequest: CommandRequest<C>, attributes?: Record<string, unknown>): Promise<CommandResult>;
+    /**
+     * Sends a command and streams one result for every stage it reaches, up to
+     * the one it waits for. The stream errors with a `WowError` if the server
+     * fails midway, for example when the wait times out.
+     *
+     * @param commandRequest - The route path, headers and body of the command
+     * @param attributes - Optional shared attributes for the interceptors
+     * @returns A stream of command results
+     *
+     * @example
+     * ```typescript
+     * const results = await commandClient.sendAndWaitStream({
+     *   path: 'add_cart_item',
+     *   method: 'POST',
+     *   headers: waitStrategy({ stage: CommandStage.PROJECTED }),
+     *   body: { productId: 'product-1', quantity: 2 },
+     * });
+     * for await (const result of results) {
+     *   console.log(result.stage);
+     * }
+     * ```
+     */
+    sendAndWaitStream<C extends object = object>(commandRequest: CommandRequest<C>, attributes?: Record<string, unknown>): Promise<CommandResultEventStream>;
+}

package/dist/client/command/commandClient.d.ts

@@ -0,0 +1,67 @@
+import { CommandRequest } from './commandRequest.js';
+import { CommandResult } from '../../model/index.js';
+import { CommandResultEventStream } from './commandResult.js';
+import { ApiMetadata, ApiMetadataCapable } from '@ahoo-wang/fetcher-decorator';
+/**
+ * Sends commands to a Wow command route.
+ *
+ * The request's `path` names the command route, relative to the client's base
+ * path; its `headers` say who the command is for and what to wait for (see
+ * {@link commandHeaders} and {@link waitStrategy}); its `body` is the command.
+ * The body type is chosen per call, so one client sends every command of an
+ * aggregate.
+ *
+ * @example
+ * ```typescript
+ * const commandClient = new CommandClient({
+ *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),
+ *   basePath: 'owner/{ownerId}/cart',
+ * });
+ *
+ * const result = await commandClient.send<{ productId: string; quantity: number }>({
+ *   path: 'add_cart_item',
+ *   method: 'POST',
+ *   urlParams: { path: { ownerId: 'user-1' } },
+ *   headers: waitStrategy({ stage: CommandStage.SNAPSHOT }),
+ *   body: { productId: 'product-1', quantity: 1 },
+ * });
+ * ```
+ */
+export declare class CommandClient implements ApiMetadataCapable {
+    readonly apiMetadata?: ApiMetadata | undefined;
+    constructor(apiMetadata?: ApiMetadata | undefined);
+    /**
+     * Sends a command and resolves to the result of the stage it waited for
+     * (`PROCESSED` unless the headers say otherwise). A command the server
+     * refuses or fails to process rejects: Wow answers the failed result with
+     * the HTTP status its `errorCode` maps to. Read it with `toWowError`.
+     *
+     * @param commandRequest - The route path, headers and body of the command
+     * @param attributes - Optional shared attributes for the interceptors
+     * @returns The command result
+     */
+    send<C extends object = object>(commandRequest: CommandRequest<C>, attributes?: Record<string, unknown>): Promise<CommandResult>;
+    /**
+     * Sends a command and streams one result for every stage it reaches, up to
+     * the one it waits for. The stream errors with a `WowError` if the server
+     * fails midway, for example when the wait times out.
+     *
+     * @param commandRequest - The route path, headers and body of the command
+     * @param attributes - Optional shared attributes for the interceptors
+     * @returns A stream of command results
+     *
+     * @example
+     * ```typescript
+     * const results = await commandClient.sendAndWaitStream({
+     *   path: 'add_cart_item',
+     *   method: 'POST',
+     *   headers: waitStrategy({ stage: CommandStage.PROJECTED }),
+     *   body: { productId: 'product-1', quantity: 2 },
+     * });
+     * for await (const result of results) {
+     *   console.log(result.stage);
+     * }
+     * ```
+     */
+    sendAndWaitStream<C extends object = object>(commandRequest: CommandRequest<C>, attributes?: Record<string, unknown>): Promise<CommandResultEventStream>;
+}

package/dist/client/command/commandClient.es.js

@@ -0,0 +1,38 @@
+import { COMMAND_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 { api as a, attribute as o, autoGeneratedError as s, endpoint as c, request as l } from "@ahoo-wang/fetcher-decorator";
+//#region src/client/command/commandClient.ts
+var u = class {
+	constructor(e) {
+		this.apiMetadata = e, t(this);
+	}
+	send(e, t) {
+		throw s(e, t);
+	}
+	/* v8 ignore stop */
+	sendAndWaitStream(e, t) {
+		throw s(e, t);
+	}
+};
+i([
+	c(),
+	r(0, l()),
+	r(1, o()),
+	n("design:type", Function),
+	n("design:paramtypes", [Object, typeof Record > "u" ? Object : Record]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], u.prototype, "send", null), i([
+	c(void 0, void 0, e),
+	r(0, l()),
+	r(1, o()),
+	n("design:type", Function),
+	n("design:paramtypes", [Object, typeof Record > "u" ? Object : Record]),
+	n("design:returntype", typeof Promise > "u" ? Object : Promise)
+], u.prototype, "sendAndWaitStream", null), u = i([a(), n("design:paramtypes", [Object])], u);
+//#endregion
+export { u as CommandClient };
+
+//# sourceMappingURL=commandClient.es.js.map

package/dist/client/command/commandClient.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandClient.es.js","names":["_decorate","_decorateParam","_decorateMetadata","__decorateMetadata","__decorateParam","__decorate","CommandClient","apiMetadata","bindMethods","autoGeneratedError","commandRequest","attributes","endpoint","request","attribute","COMMAND_STREAM_ENDPOINT","api"],"sources":["../../../src/client/command/commandClient.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 CommandRequest } from './commandRequest.js';\nimport type { CommandResult } from '../../model/index.js';\nimport type { CommandResultEventStream } from './commandResult.js';\nimport { COMMAND_STREAM_ENDPOINT } from '../../transport/endpoints.js';\n\nimport type {\n  ApiMetadata,\n  ApiMetadataCapable,\n} from '@ahoo-wang/fetcher-decorator';\nimport {\n  api,\n  attribute,\n  autoGeneratedError,\n  endpoint,\n  request,\n} from '@ahoo-wang/fetcher-decorator';\nimport { bindMethods } from '../bindMethods.js';\n\n/**\n * Sends commands to a Wow command route.\n *\n * The request's `path` names the command route, relative to the client's base\n * path; its `headers` say who the command is for and what to wait for (see\n * {@link commandHeaders} and {@link waitStrategy}); its `body` is the command.\n * The body type is chosen per call, so one client sends every command of an\n * aggregate.\n *\n * @example\n * ```typescript\n * const commandClient = new CommandClient({\n *   fetcher: new Fetcher({ baseURL: 'http://localhost:8080/' }),\n *   basePath: 'owner/{ownerId}/cart',\n * });\n *\n * const result = await commandClient.send<{ productId: string; quantity: number }>({\n *   path: 'add_cart_item',\n *   method: 'POST',\n *   urlParams: { path: { ownerId: 'user-1' } },\n *   headers: waitStrategy({ stage: CommandStage.SNAPSHOT }),\n *   body: { productId: 'product-1', quantity: 1 },\n * });\n * ```\n */\n@api()\nexport class CommandClient implements ApiMetadataCapable {\n  constructor(public readonly apiMetadata?: ApiMetadata) {\n    bindMethods(this);\n  }\n\n  /**\n   * Sends a command and resolves to the result of the stage it waited for\n   * (`PROCESSED` unless the headers say otherwise). A command the server\n   * refuses or fails to process rejects: Wow answers the failed result with\n   * the HTTP status its `errorCode` maps to. Read it with `toWowError`.\n   *\n   * @param commandRequest - The route path, headers and body of the command\n   * @param attributes - Optional shared attributes for the interceptors\n   * @returns The command result\n   */\n  @endpoint()\n  /* v8 ignore start */\n  send<C extends object = object>(\n    @request() commandRequest: CommandRequest<C>,\n    @attribute() attributes?: Record<string, unknown>,\n  ): Promise<CommandResult> {\n    throw autoGeneratedError(commandRequest, attributes);\n  }\n  /* v8 ignore stop */\n\n  /**\n   * Sends a command and streams one result for every stage it reaches, up to\n   * the one it waits for. The stream errors with a `WowError` if the server\n   * fails midway, for example when the wait times out.\n   *\n   * @param commandRequest - The route path, headers and body of the command\n   * @param attributes - Optional shared attributes for the interceptors\n   * @returns A stream of command results\n   *\n   * @example\n   * ```typescript\n   * const results = await commandClient.sendAndWaitStream({\n   *   path: 'add_cart_item',\n   *   method: 'POST',\n   *   headers: waitStrategy({ stage: CommandStage.PROJECTED }),\n   *   body: { productId: 'product-1', quantity: 2 },\n   * });\n   * for await (const result of results) {\n   *   console.log(result.stage);\n   * }\n   * ```\n   */\n  @endpoint(undefined, undefined, COMMAND_STREAM_ENDPOINT)\n  /* v8 ignore start */\n  sendAndWaitStream<C extends object = object>(\n    @request() commandRequest: CommandRequest<C>,\n    @attribute() attributes?: Record<string, unknown>,\n  ): Promise<CommandResultEventStream> {\n    throw autoGeneratedError(commandRequest, attributes);\n  }\n  /* v8 ignore stop */\n}\n"],"mappings":";;;;;;;AAyDO,IAAMM,IAAN,MAAkD;CACvD,YAAY,GAA2C;EACrD,AAD0B,KAAA,cAAAC,GAC1BC,EAAY,IAAI;CAClB;CAYA,KAGE,GACA,GACwB;EACxB,MAAMC,EAAmBC,GAAgBC,CAAU;CACrD;;CAyBA,kBAGE,GACA,GACmC;EACnC,MAAMF,EAAmBC,GAAgBC,CAAU;CACrD;AAEF;;CAzCGC,EAAS;CAGPX,EAAA,GAAAY,EAAQ,CAAA;CACRZ,EAAA,GAAAa,EAAU,CAAA;;;;;CA4BZF,EAAS,KAAA,GAAW,KAAA,GAAWG,CAAuB;CAGpDd,EAAA,GAAAY,EAAQ,CAAA;CACRZ,EAAA,GAAAa,EAAU,CAAA;;;;4CApDd,IAAAd,EAAA,CAAAgB,EAAI,GAAAd,EAAA,qBAAA,CAAA,MAAA,CAAA,CAAA,GAAAI,CAAA"}

package/dist/client/command/commandHeaders.cjs

@@ -0,0 +1,2 @@
+const e=require("../../error/headers.cjs");var t=Object.freeze({COMMAND_HEADERS_PREFIX:`Command-`,TENANT_ID:`Command-Tenant-Id`,OWNER_ID:`Command-Owner-Id`,SPACE_ID:e.WowHeaders.SPACE_ID,AGGREGATE_ID:`Command-Aggregate-Id`,AGGREGATE_VERSION:`Command-Aggregate-Version`,WAIT_PREFIX:`Command-Wait-`,WAIT_TIME_OUT:`Command-Wait-Timeout`,WAIT_STAGE:`Command-Wait-Stage`,WAIT_CONTEXT:`Command-Wait-Context`,WAIT_PROCESSOR:`Command-Wait-Processor`,WAIT_FUNCTION:`Command-Wait-Function`,WAIT_TAIL_PREFIX:`Command-Wait-Tail-`,WAIT_TAIL_STAGE:`Command-Wait-Tail-Stage`,WAIT_TAIL_CONTEXT:`Command-Wait-Tail-Context`,WAIT_TAIL_PROCESSOR:`Command-Wait-Tail-Processor`,WAIT_TAIL_FUNCTION:`Command-Wait-Tail-Function`,REQUEST_ID:`Command-Request-Id`,LOCAL_FIRST:`Command-Local-First`,COMMAND_AGGREGATE_CONTEXT:`Command-Aggregate-Context`,COMMAND_AGGREGATE_NAME:`Command-Aggregate-Name`,COMMAND_TYPE:`Command-Type`,COMMAND_HEADER_X_PREFIX:`Command-Header-`});exports.CommandHeaders=t;
+//# sourceMappingURL=commandHeaders.cjs.map

package/dist/client/command/commandHeaders.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandHeaders.cjs","names":["WowHeaders","require_headers","CommandHeaders"],"sources":["../../../src/client/command/commandHeaders.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 { WowHeaders } from '../../error/headers.js';\n\n/**\n * Command Header Constants\n *\n * The HTTP headers a Wow command route reads. Each value is a string literal\n * type, so `CommandRequestHeaders` can type the value of every header by its\n * name. {@link commandHeaders} and {@link waitStrategy} build them from typed\n * options.\n *\n * Mirrors `CommandComponent.Header` in\n * `wow-openapi/src/main/kotlin/me/ahoo/wow/openapi/aggregate/command/CommandComponent.kt`.\n *\n * @example\n * ```typescript\n * const headers: CommandRequestHeaders = {\n *   [CommandHeaders.TENANT_ID]: 'tenant-123',\n *   [CommandHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,\n * };\n * ```\n */\nexport const CommandHeaders = Object.freeze({\n  /** Prefix of the command headers */\n  COMMAND_HEADERS_PREFIX: 'Command-',\n\n  /** Tenant of the command, when the route has no tenant path segment */\n  TENANT_ID: 'Command-Tenant-Id',\n\n  /** Owner of the command, when the route has no owner path segment */\n  OWNER_ID: 'Command-Owner-Id',\n\n  /**\n   * Space identifier header, `Wow-Space-Id`\n   * Used to send the command into a space. The server reads it only for an\n   * aggregate declared `@AggregateRoute(spaced = true)`; any other aggregate\n   * ignores it and keeps the default space.\n   *\n   * The server shares this header with queries, so it has the `Wow-` prefix\n   * rather than `Command-`; it is the same value as {@link WowHeaders.SPACE_ID}.\n   */\n  SPACE_ID: WowHeaders.SPACE_ID,\n\n  /** Aggregate the command targets, when the route has no id path segment */\n  AGGREGATE_ID: 'Command-Aggregate-Id',\n\n  /** The aggregate version the command expects; a mismatch is a conflict */\n  AGGREGATE_VERSION: 'Command-Aggregate-Version',\n\n  /** Prefix of the wait headers */\n  WAIT_PREFIX: 'Command-Wait-',\n\n  /** How long the server waits for the wait stage, in milliseconds */\n  WAIT_TIME_OUT: 'Command-Wait-Timeout',\n\n  /** The stage to wait for; the server waits for `PROCESSED` when absent */\n  WAIT_STAGE: 'Command-Wait-Stage',\n\n  /** The bounded context whose processing the wait stage refers to */\n  WAIT_CONTEXT: 'Command-Wait-Context',\n\n  /** The processor whose processing the wait stage refers to */\n  WAIT_PROCESSOR: 'Command-Wait-Processor',\n\n  /** The function whose processing the wait stage refers to */\n  WAIT_FUNCTION: 'Command-Wait-Function',\n\n  /** Prefix of the wait-chain tail headers */\n  WAIT_TAIL_PREFIX: 'Command-Wait-Tail-',\n\n  /** The stage the command a saga sends must reach; only with `SAGA_HANDLED` */\n  WAIT_TAIL_STAGE: 'Command-Wait-Tail-Stage',\n\n  /** The bounded context of the wait-chain tail */\n  WAIT_TAIL_CONTEXT: 'Command-Wait-Tail-Context',\n\n  /** The processor of the wait-chain tail */\n  WAIT_TAIL_PROCESSOR: 'Command-Wait-Tail-Processor',\n\n  /** The function of the wait-chain tail */\n  WAIT_TAIL_FUNCTION: 'Command-Wait-Tail-Function',\n\n  /** Idempotency key of the command; a repeated one is refused */\n  REQUEST_ID: 'Command-Request-Id',\n\n  /** Whether the server may process the command locally, `true` or `false` */\n  LOCAL_FIRST: 'Command-Local-First',\n\n  /** Bounded context of the aggregate, for the `/wow/command/send` route */\n  COMMAND_AGGREGATE_CONTEXT: 'Command-Aggregate-Context',\n\n  /** Name of the aggregate, for the `/wow/command/send` route */\n  COMMAND_AGGREGATE_NAME: 'Command-Aggregate-Name',\n\n  /** Fully qualified command type, for the `/wow/command/send` route */\n  COMMAND_TYPE: 'Command-Type',\n\n  /** Prefix of the custom headers the server copies into the command header */\n  COMMAND_HEADER_X_PREFIX: 'Command-Header-',\n} as const);\n"],"mappings":"2CAkCA,IAAaE,EAAiB,OAAO,OAAO,CAE1C,uBAAwB,WAGxB,UAAW,oBAGX,SAAU,mBAWV,SAAUF,EAAAA,WAAW,SAGrB,aAAc,uBAGd,kBAAmB,4BAGnB,YAAa,gBAGb,cAAe,uBAGf,WAAY,qBAGZ,aAAc,uBAGd,eAAgB,yBAGhB,cAAe,wBAGf,iBAAkB,qBAGlB,gBAAiB,0BAGjB,kBAAmB,4BAGnB,oBAAqB,8BAGrB,mBAAoB,6BAGpB,WAAY,qBAGZ,YAAa,sBAGb,0BAA2B,4BAG3B,uBAAwB,yBAGxB,aAAc,eAGd,wBAAyB,iBAC3B,CAAU"}