@ddd-ts-kit/http 0.0.0-stage → 0.1.1

package/dist/pagination/issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../src/pagination/issue.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IAC/D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/pagination/limits-of.d.ts

@@ -0,0 +1,3 @@
+import { type PageLimits } from '@ddd-ts-kit/kernel';
+export declare function limitsOf(options: Partial<PageLimits>): PageLimits;
+//# sourceMappingURL=limits-of.d.ts.map

package/dist/pagination/limits-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits-of.d.ts","sourceRoot":"","sources":["../../src/pagination/limits-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAKjE"}

package/dist/pagination/limits-of.js

@@ -0,0 +1,8 @@
+import { DEFAULT_PAGE_LIMITS } from '@ddd-ts-kit/kernel';
+export function limitsOf(options) {
+    return {
+        defaultSize: options.defaultSize ?? DEFAULT_PAGE_LIMITS.defaultSize,
+        maxSize: options.maxSize ?? DEFAULT_PAGE_LIMITS.maxSize,
+    };
+}
+//# sourceMappingURL=limits-of.js.map

package/dist/pagination/limits-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits-of.js","sourceRoot":"","sources":["../../src/pagination/limits-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,oBAAoB,CAAC;AAE1E,MAAM,UAAU,QAAQ,CAAC,OAA4B;IACnD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC,WAAW;QACnE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC,OAAO;KACxD,CAAC;AACJ,CAAC"}

package/dist/pagination/page-body.d.ts

@@ -0,0 +1,7 @@
+/** A page as a JSON body: the kernel `Page`, with a mutable list as schemas infer it. */
+export interface PageBody<T> {
+    items: T[];
+    total?: number;
+    nextCursor?: string;
+}
+//# sourceMappingURL=page-body.d.ts.map

package/dist/pagination/page-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-body.d.ts","sourceRoot":"","sources":["../../src/pagination/page-body.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/pagination/page-body.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page-body.js.map

package/dist/pagination/page-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-body.js","sourceRoot":"","sources":["../../src/pagination/page-body.ts"],"names":[],"mappings":""}

package/dist/pagination/page-query-options.d.ts

@@ -0,0 +1,8 @@
+import type { PageLimits, PageRequest } from '@ddd-ts-kit/kernel';
+export interface PageQueryOptions<Field extends string = never> extends Partial<PageLimits> {
+    /** The closed list of fields a client may sort by. Without it, a `sort` parameter is refused. */
+    readonly sortable?: readonly Field[];
+    /** The variant of a query that names neither `offset` nor `cursor`. Default `offset`. */
+    readonly kind?: PageRequest['kind'];
+}
+//# sourceMappingURL=page-query-options.d.ts.map

package/dist/pagination/page-query-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-query-options.d.ts","sourceRoot":"","sources":["../../src/pagination/page-query-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,KAAK,CAAE,SAAQ,OAAO,CAAC,UAAU,CAAC;IACzF,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACrC,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACrC"}

package/dist/pagination/page-query-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page-query-options.js.map

package/dist/pagination/page-query-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-query-options.js","sourceRoot":"","sources":["../../src/pagination/page-query-options.ts"],"names":[],"mappings":""}

package/dist/pagination/page-query-schema.d.ts

@@ -0,0 +1,6 @@
+import type { PageRequest } from '@ddd-ts-kit/kernel';
+import { type Schema } from '@ddd-ts-kit/validation';
+import type { PageQueryOptions } from './page-query-options.js';
+/** The same reading as a `Schema`, for a route whose whole query is the page: `request: { query }`. */
+export declare function pageQuerySchema<Field extends string = never>(options?: PageQueryOptions<Field>): Schema<PageRequest<Field>>;
+//# sourceMappingURL=page-query-schema.d.ts.map

package/dist/pagination/page-query-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-query-schema.d.ts","sourceRoot":"","sources":["../../src/pagination/page-query-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,KAAK,EAC1D,OAAO,GAAE,gBAAgB,CAAC,KAAK,CAAM,GACpC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAE5B"}

package/dist/pagination/page-query-schema.js

@@ -0,0 +1,8 @@
+import { customSchema } from '@ddd-ts-kit/validation';
+import { pageRequestParameters } from './page-request-parameters.js';
+import { parsePageQuery } from './parse-page-query.js';
+/** The same reading as a `Schema`, for a route whose whole query is the page: `request: { query }`. */
+export function pageQuerySchema(options = {}) {
+    return customSchema((query) => parsePageQuery(query, options), pageRequestParameters(options));
+}
+//# sourceMappingURL=page-query-schema.js.map

package/dist/pagination/page-query-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-query-schema.js","sourceRoot":"","sources":["../../src/pagination/page-query-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAe,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,uGAAuG;AACvG,MAAM,UAAU,eAAe,CAC7B,OAAO,GAA4B,EAAE;IAErC,OAAO,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AACjG,CAAC"}

package/dist/pagination/page-request-from.d.ts

@@ -0,0 +1,9 @@
+import type { PageRequest } from '@ddd-ts-kit/kernel';
+import type { PageQueryOptions } from './page-query-options.js';
+/**
+ * Reads `limit`, `offset`, `cursor` and `sort` (`placedAt,-total`: a leading `-` is
+ * descending) from a query, as strings or already coerced. Throws the `ValidationError` of the
+ * pipeline, so a wrong parameter is answered 422 with one issue per parameter.
+ */
+export declare function pageRequestFrom<Field extends string = never>(query: unknown, options?: PageQueryOptions<Field>): PageRequest<Field>;
+//# sourceMappingURL=page-request-from.d.ts.map

package/dist/pagination/page-request-from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-request-from.d.ts","sourceRoot":"","sources":["../../src/pagination/page-request-from.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,KAAK,EAC1D,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAgB,CAAC,KAAK,CAAM,GACpC,WAAW,CAAC,KAAK,CAAC,CAUpB"}

package/dist/pagination/page-request-from.js

@@ -0,0 +1,16 @@
+import { ValidationError } from '@ddd-ts-kit/validation';
+import { parsePageQuery } from './parse-page-query.js';
+/**
+ * Reads `limit`, `offset`, `cursor` and `sort` (`placedAt,-total`: a leading `-` is
+ * descending) from a query, as strings or already coerced. Throws the `ValidationError` of the
+ * pipeline, so a wrong parameter is answered 422 with one issue per parameter.
+ */
+export function pageRequestFrom(query, options = {}) {
+    const parsed = parsePageQuery(query, options);
+    if (parsed.ok) {
+        return parsed.value;
+    }
+    const issues = parsed.error.map((issue) => ({ ...issue, path: `query.${issue.path}` }));
+    throw new ValidationError(issues, 'The request is not valid.');
+}
+//# sourceMappingURL=page-request-from.js.map

package/dist/pagination/page-request-from.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-request-from.js","sourceRoot":"","sources":["../../src/pagination/page-request-from.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,OAAO,GAA4B,EAAE;IAErC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAExF,MAAM,IAAI,eAAe,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AACjE,CAAC"}

package/dist/pagination/page-request-parameters.d.ts

@@ -0,0 +1,9 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+import type { PageQueryOptions } from './page-query-options.js';
+/**
+ * The query parameters of a page as a JSON Schema object: one OpenAPI parameter per property
+ * once it is the `toJsonSchema()` of a query schema. Merge `properties` into a wider schema
+ * when the route has filters too.
+ */
+export declare function pageRequestParameters(options?: PageQueryOptions<string>): JsonSchema;
+//# sourceMappingURL=page-request-parameters.d.ts.map

package/dist/pagination/page-request-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-request-parameters.d.ts","sourceRoot":"","sources":["../../src/pagination/page-request-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,gBAAgB,CAAC,MAAM,CAAM,GAAG,UAAU,CAiBxF"}

package/dist/pagination/page-request-parameters.js

@@ -0,0 +1,30 @@
+import { limitsOf } from './limits-of.js';
+/**
+ * The query parameters of a page as a JSON Schema object: one OpenAPI parameter per property
+ * once it is the `toJsonSchema()` of a query schema. Merge `properties` into a wider schema
+ * when the route has filters too.
+ */
+export function pageRequestParameters(options = {}) {
+    const { defaultSize, maxSize } = limitsOf(options);
+    const sortable = options.sortable ?? [];
+    return {
+        type: 'object',
+        properties: {
+            limit: { type: 'integer', minimum: 1, maximum: maxSize, default: defaultSize, description: 'Size of the page.' },
+            offset: { type: 'integer', minimum: 0, description: 'Items to skip. Not with `cursor`.' },
+            cursor: {
+                type: 'string',
+                minLength: 1,
+                description: 'The `nextCursor` of the previous page. Not with `offset`.',
+            },
+            ...(sortable.length === 0 ? {} : { sort: sortParameter(sortable) }),
+        },
+    };
+}
+function sortParameter(sortable) {
+    return {
+        type: 'string',
+        description: `Comma-separated fields, a leading "-" for descending. Sortable: ${sortable.join(', ')}.`,
+    };
+}
+//# sourceMappingURL=page-request-parameters.js.map

package/dist/pagination/page-request-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-request-parameters.js","sourceRoot":"","sources":["../../src/pagination/page-request-parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAA6B,EAAE;IAC1E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAChH,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE;YACzF,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,2DAA2D;aACzE;YACD,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;SACpE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAA2B;IAChD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mEAAmE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACvG,CAAC;AACJ,CAAC"}

package/dist/pagination/page-response.d.ts

@@ -0,0 +1,5 @@
+import type { Page } from '@ddd-ts-kit/kernel';
+import type { PageBody } from './page-body.js';
+/** The body of a search answer: the items through `map`, `total` and `nextCursor` when the page has them. */
+export declare function pageResponse<T, U>(page: Page<T>, map: (item: T) => U): PageBody<U>;
+//# sourceMappingURL=page-response.d.ts.map

package/dist/pagination/page-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-response.d.ts","sourceRoot":"","sources":["../../src/pagination/page-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAMlF"}

package/dist/pagination/page-response.js

@@ -0,0 +1,9 @@
+/** The body of a search answer: the items through `map`, `total` and `nextCursor` when the page has them. */
+export function pageResponse(page, map) {
+    return {
+        items: page.items.map(map),
+        ...(page.total === undefined ? {} : { total: page.total }),
+        ...(page.nextCursor === undefined ? {} : { nextCursor: page.nextCursor }),
+    };
+}
+//# sourceMappingURL=page-response.js.map

package/dist/pagination/page-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-response.js","sourceRoot":"","sources":["../../src/pagination/page-response.ts"],"names":[],"mappings":"AAGA,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAO,IAAa,EAAE,GAAmB;IACnE,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC"}

package/dist/pagination/page-schema-of.d.ts

@@ -0,0 +1,9 @@
+import { type Schema } from '@ddd-ts-kit/validation';
+import type { PageBody } from './page-body.js';
+/**
+ * The schema of a page of items, from the schema of one item: validates the envelope and each
+ * item, and describes both in the contract. Local `$defs` of the item schema move to the top,
+ * where the OpenAPI generator collects them.
+ */
+export declare function pageSchemaOf<T>(item: Schema<T>): Schema<PageBody<T>>;
+//# sourceMappingURL=page-schema-of.d.ts.map

package/dist/pagination/page-schema-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-schema-of.d.ts","sourceRoot":"","sources":["../../src/pagination/page-schema-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,MAAM,EAAwB,MAAM,wBAAwB,CAAC;AAG1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEpE"}

package/dist/pagination/page-schema-of.js

@@ -0,0 +1,60 @@
+import { err, ok } from '@ddd-ts-kit/kernel';
+import { customSchema } from '@ddd-ts-kit/validation';
+import { isRecord } from '../support/is-record.js';
+import { issue } from './issue.js';
+/**
+ * The schema of a page of items, from the schema of one item: validates the envelope and each
+ * item, and describes both in the contract. Local `$defs` of the item schema move to the top,
+ * where the OpenAPI generator collects them.
+ */
+export function pageSchemaOf(item) {
+    return customSchema((input) => parsePageBody(input, item), pageJsonSchema(item.toJsonSchema()));
+}
+function parsePageBody(input, item) {
+    if (!isRecord(input) || !Array.isArray(input['items'])) {
+        return err([issue('items', 'invalid_page', 'A page has a list of items.')]);
+    }
+    const issues = [];
+    const items = itemsOf(input['items'], item, issues);
+    const more = moreOf(input, issues);
+    return issues.length > 0 ? err(issues) : ok({ items, ...more });
+}
+function itemsOf(inputs, item, issues) {
+    return inputs.flatMap((input, index) => {
+        const parsed = item.parse(input);
+        if (parsed.ok) {
+            return [parsed.value];
+        }
+        for (const found of parsed.error) {
+            const path = found.path === '' ? `items.${String(index)}` : `items.${String(index)}.${found.path}`;
+            issues.push({ ...found, path });
+        }
+        return [];
+    });
+}
+function moreOf(input, issues) {
+    const { total, nextCursor } = input;
+    const counted = typeof total === 'number' && Number.isSafeInteger(total) && total >= 0;
+    if (total !== undefined && !counted) {
+        issues.push(issue('total', 'invalid_page', 'Must be a non-negative integer.'));
+    }
+    if (nextCursor !== undefined && typeof nextCursor !== 'string') {
+        issues.push(issue('nextCursor', 'invalid_page', 'Must be a string.'));
+    }
+    return { ...(counted ? { total } : {}), ...(typeof nextCursor === 'string' ? { nextCursor } : {}) };
+}
+function pageJsonSchema(itemSchema) {
+    const { $schema: _dialect, $defs, definitions, ...item } = itemSchema;
+    return {
+        type: 'object',
+        required: ['items'],
+        properties: {
+            items: { type: 'array', items: item },
+            total: { type: 'integer', minimum: 0, description: 'Present when it is cheap to count.' },
+            nextCursor: { type: 'string', description: 'Present when more items follow.' },
+        },
+        ...($defs === undefined ? {} : { $defs }),
+        ...(definitions === undefined ? {} : { definitions }),
+    };
+}
+//# sourceMappingURL=page-schema-of.js.map

package/dist/pagination/page-schema-of.js.map

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

package/dist/pagination/parse-page-query.d.ts

@@ -0,0 +1,5 @@
+import { type PageRequest, type Result } from '@ddd-ts-kit/kernel';
+import type { ValidationIssue } from '@ddd-ts-kit/validation';
+import type { PageQueryOptions } from './page-query-options.js';
+export declare function parsePageQuery<Field extends string>(input: unknown, options: PageQueryOptions<Field>): Result<PageRequest<Field>, ValidationIssue[]>;
+//# sourceMappingURL=parse-page-query.d.ts.map

package/dist/pagination/parse-page-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-page-query.d.ts","sourceRoot":"","sources":["../../src/pagination/parse-page-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgBhE,wBAAgB,cAAc,CAAC,KAAK,SAAS,MAAM,EACjD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAC/B,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC,CAoB/C"}

package/dist/pagination/parse-page-query.js

@@ -0,0 +1,108 @@
+import { cursorPage, err, offsetPage, ok, } from '@ddd-ts-kit/kernel';
+import { isRecord } from '../support/is-record.js';
+import { issue } from './issue.js';
+import { limitsOf } from './limits-of.js';
+export function parsePageQuery(input, options) {
+    const reading = { query: isRecord(input) ? input : {}, issues: [] };
+    const limits = limitsOf(options);
+    const asked = {
+        limit: limitOf(reading, limits),
+        offset: offsetOf(reading),
+        cursor: cursorOf(reading),
+        sort: sortOf(reading, options.sortable ?? []),
+    };
+    if (asked.offset !== undefined && asked.cursor !== undefined) {
+        reading.issues.push(issue('cursor', 'offset_with_cursor', 'A page is asked by offset or by cursor, not both.'));
+    }
+    if (reading.issues.length > 0) {
+        return err(reading.issues);
+    }
+    return ok(options.kind === 'cursor' ? cursorFirst(asked, limits) : offsetFirst(asked, limits));
+}
+function limitOf({ query, issues }, limits) {
+    if (query['limit'] === undefined) {
+        return limits.defaultSize;
+    }
+    const limit = integerOf(query['limit']);
+    if (limit !== undefined && limit >= 1 && limit <= limits.maxSize) {
+        return limit;
+    }
+    issues.push(issue('limit', 'invalid_limit', `Must be an integer between 1 and ${String(limits.maxSize)}.`));
+    return limits.defaultSize;
+}
+function integerOf(value) {
+    const text = typeof value === 'number' ? String(value) : value;
+    if (typeof text !== 'string' || !/^\d{1,15}$/.test(text)) {
+        return undefined;
+    }
+    return Number(text);
+}
+function offsetOf({ query, issues }) {
+    if (query['offset'] === undefined) {
+        return undefined;
+    }
+    const offset = integerOf(query['offset']);
+    if (offset !== undefined && offset >= 0) {
+        return offset;
+    }
+    issues.push(issue('offset', 'invalid_offset', 'Must be a non-negative integer.'));
+    return undefined;
+}
+function cursorOf({ query, issues }) {
+    const cursor = query['cursor'];
+    if (cursor === undefined) {
+        return undefined;
+    }
+    if (typeof cursor === 'string' && cursor !== '') {
+        return cursor;
+    }
+    issues.push(issue('cursor', 'invalid_cursor', 'Must be the nextCursor of a previous page.'));
+    return undefined;
+}
+function sortOf({ query, issues }, sortable) {
+    const terms = sortTermsOf(query['sort']);
+    if (terms === undefined) {
+        issues.push(issue('sort', 'invalid_sort', 'Must be a comma-separated list of fields.'));
+        return [];
+    }
+    return terms.flatMap((term) => {
+        const descending = term.startsWith('-');
+        const field = sortable.find((allowed) => allowed === (descending ? term.slice(1) : term));
+        if (field !== undefined) {
+            return [{ field, direction: descending ? 'desc' : 'asc' }];
+        }
+        issues.push(issue('sort', 'unsortable_field', `Sortable fields: ${sortable.join(', ') || 'none'}.`));
+        return [];
+    });
+}
+/** `sort=a,-b` and a repeated `sort=a&sort=-b` read the same. `undefined` for anything else. */
+function sortTermsOf(sort) {
+    if (sort === undefined) {
+        return [];
+    }
+    const values = Array.isArray(sort) ? sort : [sort];
+    if (!values.every((value) => typeof value === 'string')) {
+        return undefined;
+    }
+    return values
+        .flatMap((value) => value.split(','))
+        .map((term) => term.trim())
+        .filter((term) => term !== '');
+}
+/** A cursor page unless the query names an offset. */
+function cursorFirst(asked, limits) {
+    const { limit, sort, offset, cursor } = asked;
+    if (offset !== undefined) {
+        return offsetPage({ limit, sort, offset }, limits);
+    }
+    return cursorPage({ limit, sort, ...(cursor === undefined ? {} : { cursor }) }, limits);
+}
+/** An offset page unless the query names a cursor. */
+function offsetFirst(asked, limits) {
+    const { limit, sort, offset, cursor } = asked;
+    if (cursor !== undefined) {
+        return cursorPage({ limit, sort, cursor }, limits);
+    }
+    return offsetPage({ limit, sort, ...(offset === undefined ? {} : { offset }) }, limits);
+}
+//# sourceMappingURL=parse-page-query.js.map

package/dist/pagination/parse-page-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-page-query.js","sourceRoot":"","sources":["../../src/pagination/parse-page-query.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,GAAG,EACH,UAAU,EACV,EAAE,GAKH,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiB1C,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAgC;IAEhC,MAAM,OAAO,GAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAiB;QAC1B,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;QAC/B,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;QACzB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;KAC9C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,EAAE,mDAAmD,CAAC,CAAC,CAAC;IAClH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAW,EAAE,MAAkB;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,oCAAoC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5G,OAAO,MAAM,CAAC,WAAW,CAAC;AAC5B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAW;IAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,iCAAiC,CAAC,CAAC,CAAC;IAElF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAW;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,4CAA4C,CAAC,CAAC,CAAC;IAE7F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,MAAM,CAAuB,EAAE,KAAK,EAAE,MAAM,EAAW,EAAE,QAA0B;IAC1F,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,2CAA2C,CAAC,CAAC,CAAC;QAExF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE1F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;QAErG,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gGAAgG;AAChG,SAAS,WAAW,CAAC,IAAa;IAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAuB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM;SACV,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,sDAAsD;AACtD,SAAS,WAAW,CAAuB,KAAmB,EAAE,MAAkB;IAChF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,sDAAsD;AACtD,SAAS,WAAW,CAAuB,KAAmB,EAAE,MAAkB;IAChF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC"}

package/dist/pipeline/assert-declared-response.d.ts

@@ -0,0 +1,4 @@
+import type { RouteOutput } from '../route/route-output.js';
+import type { Route } from '../route/route.js';
+export declare function assertDeclaredResponse(route: Route, { status, body }: RouteOutput): void;
+//# sourceMappingURL=assert-declared-response.d.ts.map

package/dist/pipeline/assert-declared-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-declared-response.d.ts","sourceRoot":"","sources":["../../src/pipeline/assert-declared-response.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,GAAG,IAAI,CAyBxF"}

package/dist/pipeline/assert-declared-response.js

@@ -0,0 +1,18 @@
+import { ResponseContractError } from '../error/response-contract-error.js';
+export function assertDeclaredResponse(route, { status, body }) {
+    const declared = route.responses[status];
+    if (declared === undefined) {
+        throw new ResponseContractError(`Route "${route.operationId}" answered ${status}, which it does not declare.`);
+    }
+    if (declared.body === undefined) {
+        if (body !== undefined) {
+            throw new ResponseContractError(`Route "${route.operationId}" answered ${status} with a body, but declares none.`);
+        }
+        return;
+    }
+    const result = declared.body.parse(body);
+    if (!result.ok) {
+        throw new ResponseContractError(`Route "${route.operationId}" answered ${status} with a body that does not match its schema.`, result.error);
+    }
+}
+//# sourceMappingURL=assert-declared-response.js.map

package/dist/pipeline/assert-declared-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-declared-response.js","sourceRoot":"","sources":["../../src/pipeline/assert-declared-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAI5E,MAAM,UAAU,sBAAsB,CAAC,KAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAe;IAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,qBAAqB,CAAC,UAAU,KAAK,CAAC,WAAW,cAAc,MAAM,8BAA8B,CAAC,CAAC;IACjH,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,qBAAqB,CAC7B,UAAU,KAAK,CAAC,WAAW,cAAc,MAAM,kCAAkC,CAClF,CAAC;QACJ,CAAC;QAED,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAC7B,UAAU,KAAK,CAAC,WAAW,cAAc,MAAM,8CAA8C,EAC7F,MAAM,CAAC,KAAK,CACb,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/pipeline/correlation-header.d.ts

@@ -0,0 +1,2 @@
+export declare const CORRELATION_HEADER = "x-correlation-id";
+//# sourceMappingURL=correlation-header.d.ts.map

package/dist/pipeline/correlation-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-header.d.ts","sourceRoot":"","sources":["../../src/pipeline/correlation-header.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,qBAAqB,CAAC"}

package/dist/pipeline/correlation-header.js

@@ -0,0 +1,2 @@
+export const CORRELATION_HEADER = 'x-correlation-id';
+//# sourceMappingURL=correlation-header.js.map

package/dist/pipeline/correlation-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-header.js","sourceRoot":"","sources":["../../src/pipeline/correlation-header.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC"}

package/dist/pipeline/correlation-id-of.d.ts

@@ -0,0 +1,4 @@
+import type { RawHeaders } from '../route/raw-headers.js';
+/** The incoming `x-correlation-id` when it is well formed; otherwise the request starts the chain. */
+export declare function correlationIdOf(headers: Readonly<RawHeaders>, requestId: string): string;
+//# sourceMappingURL=correlation-id-of.d.ts.map

package/dist/pipeline/correlation-id-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-id-of.d.ts","sourceRoot":"","sources":["../../src/pipeline/correlation-id-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExF"}

package/dist/pipeline/correlation-id-of.js

@@ -0,0 +1,7 @@
+import { CORRELATION_HEADER } from './correlation-header.js';
+import { wellFormedIdentifier } from './well-formed-identifier.js';
+/** The incoming `x-correlation-id` when it is well formed; otherwise the request starts the chain. */
+export function correlationIdOf(headers, requestId) {
+    return wellFormedIdentifier(headers[CORRELATION_HEADER]) ?? requestId;
+}
+//# sourceMappingURL=correlation-id-of.js.map

package/dist/pipeline/correlation-id-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-id-of.js","sourceRoot":"","sources":["../../src/pipeline/correlation-id-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,OAA6B,EAAE,SAAiB;IAC9E,OAAO,oBAAoB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,SAAS,CAAC;AACxE,CAAC"}

package/dist/pipeline/error-context.d.ts

@@ -0,0 +1,15 @@
+import type { ExecutionContext } from '@ddd-ts-kit/kernel';
+import type { Problem } from '../error/problem.js';
+import type { HttpMethod } from '../route/http-method.js';
+export interface ErrorContext {
+    readonly requestId: string;
+    readonly correlationId: string;
+    readonly operationId: string;
+    readonly method: HttpMethod;
+    readonly path: string;
+    /** The response the client receives for this error. */
+    readonly problem: Problem;
+    /** The execution context of the request, when the failure happened after it was built: not for a refused credential or an invalid request. */
+    readonly execution?: ExecutionContext;
+}
+//# sourceMappingURL=error-context.d.ts.map

package/dist/pipeline/error-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/pipeline/error-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8IAA8I;IAC9I,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC"}

package/dist/pipeline/error-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-context.js.map

package/dist/pipeline/error-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/pipeline/error-context.ts"],"names":[],"mappings":""}

package/dist/pipeline/execute-options.d.ts

@@ -0,0 +1,40 @@
+import type { Clock, ExecutionScope } from '@ddd-ts-kit/kernel';
+import type { ErrorMapper } from '../error/error-mapper.js';
+import type { ErrorContext } from './error-context.js';
+import type { RawRequest } from './raw-request.js';
+import type { RouteAround } from './route-around.js';
+export interface ExecuteOptions {
+    readonly errorMapper?: ErrorMapper;
+    /** Authenticates the request; throw `UnauthorizedError` to refuse it. */
+    readonly resolvePrincipal?: (raw: unknown) => unknown;
+    /**
+     * Runs every handler inside a scope that knows the principal, typically an ambient actor
+     * context, so that no route can forget to open it.
+     */
+    readonly withPrincipal?: <T>(principal: unknown, work: () => Promise<T>) => Promise<T>;
+    /** Called for every error answered as a problem, expected or not. Meant for logging. */
+    readonly onError?: (error: unknown, context: ErrorContext) => void;
+    /** Checks each response against the route declaration. Meant for tests. */
+    readonly validateResponses?: boolean;
+    /** Defaults to the incoming `x-request-id` header when it is well formed, else a UUID. */
+    readonly requestId?: (request: RawRequest) => string;
+    /**
+     * Runs every handler inside `scope.run(execution, ...)`, so loggers, audit columns and tenant
+     * scoping read the execution context of the request. Opened outside of `withPrincipal`.
+     */
+    readonly executionScope?: ExecutionScope;
+    /**
+     * Gives every request a `deadline` in its execution context, this many milliseconds after it
+     * arrived. The pipeline does not interrupt a handler: what honours the deadline reads it.
+     */
+    readonly requestTimeoutMs?: number;
+    /** The instant a request arrived at, for `requestTimeoutMs`. Defaults to the system clock. */
+    readonly clock?: Clock;
+    /**
+     * Wraps the whole handling of each request, from authentication to the answer, refusals
+     * included. This is where a tracer names the request after its route: `tracedRoutes()` of
+     * `@ddd-ts-kit/tracing` fits as it is.
+     */
+    readonly around?: RouteAround;
+}
+//# sourceMappingURL=execute-options.d.ts.map

package/dist/pipeline/execute-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-options.d.ts","sourceRoot":"","sources":["../../src/pipeline/execute-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvF,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACnE,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B"}

package/dist/pipeline/execute-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execute-options.js.map

package/dist/pipeline/execute-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-options.js","sourceRoot":"","sources":["../../src/pipeline/execute-options.ts"],"names":[],"mappings":""}

package/dist/pipeline/execute-route.d.ts

@@ -0,0 +1,6 @@
+import type { Route } from '../route/route.js';
+import type { ExecuteOptions } from './execute-options.js';
+import type { RawRequest } from './raw-request.js';
+import type { RouteResponse } from './route-response.js';
+export declare function executeRoute(route: Route, request: RawRequest, options?: ExecuteOptions): Promise<RouteResponse>;
+//# sourceMappingURL=execute-route.d.ts.map

package/dist/pipeline/execute-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-route.d.ts","sourceRoot":"","sources":["../../src/pipeline/execute-route.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkBzD,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAOxB"}