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

package/dist/criteria/filter-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-entries.js","sourceRoot":"","sources":["../../src/criteria/filter-entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,MAAM,IAAI,GAAG,4BAA4B,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAErC,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,IAAuB;IACrD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAa,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/criteria/filter-entry.d.ts

@@ -0,0 +1,6 @@
+/** One `filter[...]` parameter of a query: the names between its brackets, and its values. */
+export interface FilterEntry {
+    readonly path: readonly string[];
+    readonly values: readonly unknown[];
+}
+//# sourceMappingURL=filter-entry.d.ts.map

package/dist/criteria/filter-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-entry.d.ts","sourceRoot":"","sources":["../../src/criteria/filter-entry.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC"}

package/dist/criteria/filter-entry.js

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

package/dist/criteria/filter-entry.js.map

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

package/dist/criteria/parse-condition.d.ts

@@ -0,0 +1,7 @@
+import type { FieldDeclaration, FilterNode } from '@ddd-ts-kit/kernel';
+/**
+ * The condition `<operator>:<value>` writes on a field, `undefined` when a value does not read
+ * as the type of the field. Without an operator the text is the value of `eq`.
+ */
+export declare function parseCondition(field: string, declared: FieldDeclaration, text: string): FilterNode | undefined;
+//# sourceMappingURL=parse-condition.d.ts.map

package/dist/criteria/parse-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-condition.d.ts","sourceRoot":"","sources":["../../src/criteria/parse-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAc,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAyBnG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAK9G"}

package/dist/criteria/parse-condition.js

@@ -0,0 +1,52 @@
+import { coerceValue } from './coerce-value.js';
+import { splitList } from './split-list.js';
+const OPERATORS = [
+    'eq',
+    'ne',
+    'in',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'contains',
+    'startsWith',
+    'isNull',
+    'between',
+];
+const WRITTEN = /^([A-Za-z]+)(?::(.*))?$/s;
+/**
+ * The condition `<operator>:<value>` writes on a field, `undefined` when a value does not read
+ * as the type of the field. Without an operator the text is the value of `eq`.
+ */
+export function parseCondition(field, declared, text) {
+    const { operator, text: rest } = writtenOf(text);
+    const value = operandOf(declared, operator, rest);
+    return value === undefined ? undefined : { kind: 'condition', field, operator, value };
+}
+function writtenOf(text) {
+    const [, name, rest] = WRITTEN.exec(text) ?? [];
+    const operator = OPERATORS.find((known) => known === name);
+    if (operator === undefined || (rest === undefined && operator !== 'isNull')) {
+        return { operator: 'eq', text };
+    }
+    return { operator, text: rest ?? 'true' };
+}
+function operandOf(declared, operator, text) {
+    switch (operator) {
+        case 'isNull':
+            return coerceValue('boolean', text);
+        case 'contains':
+        case 'startsWith':
+            return text;
+        case 'in':
+        case 'between':
+            return listOf(declared, text);
+        default:
+            return coerceValue(declared.type, text);
+    }
+}
+function listOf(declared, text) {
+    const values = splitList(text).flatMap((item) => coerceValue(declared.type, item) ?? []);
+    return values.length === splitList(text).length ? values : undefined;
+}
+//# sourceMappingURL=parse-condition.js.map

package/dist/criteria/parse-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-condition.js","sourceRoot":"","sources":["../../src/criteria/parse-condition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,SAAS,GAA8B;IAC3C,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,SAAS;CACV,CAAC;AAEF,MAAM,OAAO,GAAG,0BAA0B,CAAC;AAO3C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,QAA0B,EAAE,IAAY;IACpF,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAElD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAE3D,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAChB,QAA0B,EAC1B,QAAwB,EACxB,IAAY;IAEZ,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtC,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,IAAI,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChC;YACE,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,QAA0B,EAAE,IAAY;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAEzF,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/dist/criteria/parse-criteria-query.d.ts

@@ -0,0 +1,5 @@
+import { Criteria, type CriteriaDefinition, type Result } from '@ddd-ts-kit/kernel';
+import type { ValidationIssue } from '@ddd-ts-kit/validation';
+import type { CriteriaQueryOptions } from './criteria-query-options.js';
+export declare function parseCriteriaQuery<Row>(input: unknown, definition: CriteriaDefinition<Row>, options?: CriteriaQueryOptions): Result<Criteria<Row>, ValidationIssue[]>;
+//# sourceMappingURL=parse-criteria-query.d.ts.map

package/dist/criteria/parse-criteria-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-criteria-query.d.ts","sourceRoot":"","sources":["../../src/criteria/parse-criteria-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA6B,KAAK,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAQxE,wBAAgB,kBAAkB,CAAC,GAAG,EACpC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,EACnC,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC,CA0B1C"}

package/dist/criteria/parse-criteria-query.js

@@ -0,0 +1,31 @@
+import { Criteria, err, ok, validateCriteria } from '@ddd-ts-kit/kernel';
+import { parsePageQuery } from '../pagination/parse-page-query.js';
+import { isRecord } from '../support/is-record.js';
+import { filterEntries } from './filter-entries.js';
+import { parseFilters } from './parse-filters.js';
+import { sortableFields } from './sortable-fields.js';
+/** `page.limit` of a criteria is the `limit` parameter of the query, and so on. */
+const PARAMETERS = { 'page.limit': 'limit', 'page.cursor': 'cursor' };
+export function parseCriteriaQuery(input, definition, options = {}) {
+    const query = isRecord(input) ? input : {};
+    const { defaultPageSize, maxPageSize } = definition.limits;
+    const issues = [];
+    const filters = parseFilters(filterEntries(query), { definition, issues });
+    const page = parsePageQuery(query, {
+        ...options,
+        sortable: sortableFields(definition),
+        defaultSize: defaultPageSize,
+        maxSize: maxPageSize,
+    });
+    if (!page.ok) {
+        return err([...issues, ...page.error]);
+    }
+    const criteria = Criteria.from({ filters, page: page.value });
+    const refused = validateCriteria(definition, criteria).map(({ path, code, message }) => ({
+        path: PARAMETERS[path] ?? path,
+        code,
+        message,
+    }));
+    return issues.length + refused.length > 0 ? err([...issues, ...refused]) : ok(criteria);
+}
+//# sourceMappingURL=parse-criteria-query.js.map

package/dist/criteria/parse-criteria-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-criteria-query.js","sourceRoot":"","sources":["../../src/criteria/parse-criteria-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,gBAAgB,EAAwC,MAAM,oBAAoB,CAAC;AAE/G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,mFAAmF;AACnF,MAAM,UAAU,GAAqC,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAExG,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,UAAmC,EACnC,OAAO,GAAyB,EAAE;IAElC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IAC3D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3E,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE;QACjC,GAAG,OAAO;QACV,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC;QACpC,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI;QAC9B,IAAI;QACJ,OAAO;KACR,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC1F,CAAC"}

package/dist/criteria/parse-filters.d.ts

@@ -0,0 +1,15 @@
+import type { CriteriaDefinition, FilterNode } from '@ddd-ts-kit/kernel';
+import type { ValidationIssue } from '@ddd-ts-kit/validation';
+import type { FilterEntry } from './filter-entry.js';
+interface Reading<Row> {
+    readonly definition: CriteriaDefinition<Row>;
+    readonly issues: ValidationIssue[];
+}
+/**
+ * The filters the `filter[...]` parameters of a query write, in the order they come. What
+ * cannot be read is added to `issues` under `filter.<field>`; whether the read port accepts
+ * what was read is for `validateCriteria` to say.
+ */
+export declare function parseFilters<Row>(entries: readonly FilterEntry[], reading: Reading<Row>): FilterNode[];
+export {};
+//# sourceMappingURL=parse-filters.d.ts.map

package/dist/criteria/parse-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-filters.d.ts","sourceRoot":"","sources":["../../src/criteria/parse-filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,UAAU,OAAO,CAAC,GAAG;IACnB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,CAoBtG"}

package/dist/criteria/parse-filters.js

@@ -0,0 +1,52 @@
+import { parseCondition } from './parse-condition.js';
+const GROUPS = ['and', 'or', 'not'];
+const INDEX = /^\d+$/;
+/**
+ * The filters the `filter[...]` parameters of a query write, in the order they come. What
+ * cannot be read is added to `issues` under `filter.<field>`; whether the read port accepts
+ * what was read is for `validateCriteria` to say.
+ */
+export function parseFilters(entries, reading) {
+    const heads = [...new Set(entries.map(({ path }) => path[0] ?? ''))];
+    return heads.flatMap((head) => {
+        const under = entries
+            .filter(({ path }) => (path[0] ?? '') === head)
+            .map(({ path, values }) => ({ path: path.slice(1), values }));
+        const group = GROUPS.find((kind) => kind === head);
+        if (group !== undefined) {
+            return [{ kind: group, filters: parseFilters(under, reading) }];
+        }
+        if (INDEX.test(head)) {
+            return member(parseFilters(under, reading));
+        }
+        return under.flatMap((entry) => conditions(head, entry, reading));
+    });
+}
+/** The filters written under one index of a group: one filter, or all of them together. */
+function member(filters) {
+    return filters.length === 1 ? filters : [{ kind: 'and', filters }];
+}
+function conditions(field, { path, values }, { definition, issues }) {
+    const declared = Object.hasOwn(definition.fields, field) ? definition.fields[field] : undefined;
+    const texts = values.filter((value) => typeof value === 'string');
+    if (field === '' || path.length > 0 || texts.length !== values.length) {
+        issues.push({
+            path: field === '' ? 'filter' : `filter.${field}`,
+            code: 'invalid_filter',
+            message: 'A filter is written filter[<field>]=<operator>:<value>.',
+        });
+        return [];
+    }
+    // Left for the read port to refuse: it answers the same `unknown_field` whoever built the criteria.
+    if (declared === undefined) {
+        return [{ kind: 'condition', field, operator: 'eq', value: '' }];
+    }
+    return texts.flatMap((text) => {
+        const condition = parseCondition(field, declared, text);
+        if (condition === undefined) {
+            issues.push({ path: `filter.${field}`, code: 'invalid_value', message: `Must read as a ${declared.type}.` });
+        }
+        return condition ?? [];
+    });
+}
+//# sourceMappingURL=parse-filters.js.map

package/dist/criteria/parse-filters.js.map

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

package/dist/criteria/sortable-fields.d.ts

@@ -0,0 +1,4 @@
+import type { CriteriaDefinition } from '@ddd-ts-kit/kernel';
+/** The fields a client may sort by: those declared sortable, and the tie-breaker. */
+export declare function sortableFields<Row>(definition: CriteriaDefinition<Row>): string[];
+//# sourceMappingURL=sortable-fields.d.ts.map

package/dist/criteria/sortable-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortable-fields.d.ts","sourceRoot":"","sources":["../../src/criteria/sortable-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAIjF"}

package/dist/criteria/sortable-fields.js

@@ -0,0 +1,6 @@
+/** The fields a client may sort by: those declared sortable, and the tie-breaker. */
+export function sortableFields(definition) {
+    const declared = Object.entries(definition.fields).flatMap(([field, { sortable }]) => (sortable ? [field] : []));
+    return [...new Set([...declared, definition.tieBreaker])];
+}
+//# sourceMappingURL=sortable-fields.js.map

package/dist/criteria/sortable-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortable-fields.js","sourceRoot":"","sources":["../../src/criteria/sortable-fields.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAM,UAAmC;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/criteria/split-list.d.ts

@@ -0,0 +1,3 @@
+/** The values of a comma-separated list. A comma inside a value is written `\,`, a backslash `\\`. */
+export declare function splitList(text: string): string[];
+//# sourceMappingURL=split-list.d.ts.map

package/dist/criteria/split-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-list.d.ts","sourceRoot":"","sources":["../../src/criteria/split-list.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBhD"}

package/dist/criteria/split-list.js

@@ -0,0 +1,19 @@
+/** The values of a comma-separated list. A comma inside a value is written `\,`, a backslash `\\`. */
+export function splitList(text) {
+    const values = [''];
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text.charAt(index);
+        const escaped = character === '\\' && index + 1 < text.length;
+        if (character === ',') {
+            values.push('');
+        }
+        else {
+            values[values.length - 1] += escaped ? text.charAt(index + 1) : character;
+        }
+        if (escaped) {
+            index += 1;
+        }
+    }
+    return values;
+}
+//# sourceMappingURL=split-list.js.map

package/dist/criteria/split-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-list.js","sourceRoot":"","sources":["../../src/criteria/split-list.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,SAAS,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAE9D,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/docs/docs-page.d.ts

@@ -0,0 +1,11 @@
+import type { DocsUi } from './docs-ui.js';
+interface DocsPage {
+    readonly ui: DocsUi;
+    readonly title: string;
+    readonly specUrl: string;
+    readonly assets: string;
+}
+/** The HTML page that loads the chosen UI and points it at the contract. */
+export declare function docsPage({ ui, title, specUrl, assets }: DocsPage): string;
+export {};
+//# sourceMappingURL=docs-page.d.ts.map

package/dist/docs/docs-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-page.d.ts","sourceRoot":"","sources":["../../src/docs/docs-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAG,MAAM,CAazE"}

package/dist/docs/docs-page.js

@@ -0,0 +1,18 @@
+/** The HTML page that loads the chosen UI and points it at the contract. */
+export function docsPage({ ui, title, specUrl, assets }) {
+    const head = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(title)}</title>`;
+    const spec = escapeHtml(specUrl);
+    const base = escapeHtml(assets);
+    switch (ui) {
+        case 'swagger':
+            return `${head}<link rel="stylesheet" href="${base}/swagger-ui.css"></head><body><div id="ui"></div><script src="${base}/swagger-ui-bundle.js"></script><script>SwaggerUIBundle({ url: ${JSON.stringify(specUrl)}, dom_id: '#ui' });</script></body></html>`;
+        case 'scalar':
+            return `${head}</head><body><script id="api-reference" data-url="${spec}"></script><script src="${base}"></script></body></html>`;
+        case 'redoc':
+            return `${head}</head><body><redoc spec-url="${spec}"></redoc><script src="${base}/redoc.standalone.js"></script></body></html>`;
+    }
+}
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (char) => `&#${char.charCodeAt(0)};`);
+}
+//# sourceMappingURL=docs-page.js.map

package/dist/docs/docs-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-page.js","sourceRoot":"","sources":["../../src/docs/docs-page.ts"],"names":[],"mappings":"AASA,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAY;IAC/D,MAAM,IAAI,GAAG,wIAAwI,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;IACjL,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEhC,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,GAAG,IAAI,gCAAgC,IAAI,iEAAiE,IAAI,kEAAkE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,4CAA4C,CAAC;QAC/P,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,qDAAqD,IAAI,2BAA2B,IAAI,2BAA2B,CAAC;QACpI,KAAK,OAAO;YACV,OAAO,GAAG,IAAI,iCAAiC,IAAI,0BAA0B,IAAI,+CAA+C,CAAC;IACrI,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACzE,CAAC"}

package/dist/docs/docs-ui.d.ts

@@ -0,0 +1,2 @@
+export type DocsUi = 'swagger' | 'scalar' | 'redoc';
+//# sourceMappingURL=docs-ui.d.ts.map

package/dist/docs/docs-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-ui.d.ts","sourceRoot":"","sources":["../../src/docs/docs-ui.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/docs/docs-ui.js

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

package/dist/docs/docs-ui.js.map

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

package/dist/docs/open-api-docs-routes.d.ts

@@ -0,0 +1,22 @@
+import type { OpenApiDocument } from '../openapi/open-api-document.js';
+import type { Route } from '../route/route.js';
+import type { DocsUi } from './docs-ui.js';
+export interface DocsRoutesOptions {
+    /** Where the JSON contract is served. Default `/openapi.json`. */
+    readonly jsonPath?: string;
+    /** Where the interactive page is served. Default `/docs`. */
+    readonly uiPath?: string;
+    readonly ui?: DocsUi;
+    /**
+     * Base URL of the UI assets. Defaults to a public CDN, pinned to a major version. Point it
+     * at self-hosted files when the page must work offline or under a strict CSP.
+     */
+    readonly assetsUrl?: string;
+    readonly title?: string;
+}
+/**
+ * Two routes serving the generated contract and an interactive page for it. Mount them next
+ * to the application routes; they are deliberately not part of the contract they display.
+ */
+export declare function openApiDocsRoutes(document: OpenApiDocument, options?: DocsRoutesOptions): readonly Route[];
+//# sourceMappingURL=open-api-docs-routes.d.ts.map

package/dist/docs/open-api-docs-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-docs-routes.d.ts","sourceRoot":"","sources":["../../src/docs/open-api-docs-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB,GAAG,SAAS,KAAK,EAAE,CA6B9G"}

package/dist/docs/open-api-docs-routes.js

@@ -0,0 +1,54 @@
+import { ok } from '@ddd-ts-kit/kernel';
+import { customSchema } from '@ddd-ts-kit/validation';
+import { stringifyOpenApi } from '../openapi/stringify-open-api.js';
+import { defineRoute } from '../route/define-route.js';
+import { docsPage } from './docs-page.js';
+const DEFAULT_ASSETS = {
+    swagger: 'https://cdn.jsdelivr.net/npm/swagger-ui-dist@5',
+    scalar: 'https://cdn.jsdelivr.net/npm/@scalar/api-reference@1',
+    redoc: 'https://cdn.jsdelivr.net/npm/redoc@2/bundles',
+};
+const text = customSchema((input) => ok(String(input)), { type: 'string' });
+/**
+ * Two routes serving the generated contract and an interactive page for it. Mount them next
+ * to the application routes; they are deliberately not part of the contract they display.
+ */
+export function openApiDocsRoutes(document, options = {}) {
+    const jsonPath = options.jsonPath ?? '/openapi.json';
+    const ui = options.ui ?? 'swagger';
+    const html = docsPage({
+        ui,
+        title: options.title ?? document.info.title,
+        specUrl: jsonPath,
+        assets: options.assetsUrl ?? DEFAULT_ASSETS[ui],
+    });
+    return [
+        textRoute({
+            path: jsonPath,
+            operationId: 'getOpenApiDocument',
+            summary: 'OpenAPI contract',
+            description: 'The OpenAPI 3.1 document.',
+            contentType: 'application/json; charset=utf-8',
+            body: stringifyOpenApi(document),
+        }),
+        textRoute({
+            path: options.uiPath ?? '/docs',
+            operationId: 'getOpenApiUi',
+            summary: 'Interactive API documentation',
+            description: 'An HTML page.',
+            contentType: 'text/html; charset=utf-8',
+            body: html,
+        }),
+    ];
+}
+function textRoute(route) {
+    return defineRoute({
+        method: 'GET',
+        path: route.path,
+        operationId: route.operationId,
+        summary: route.summary,
+        responses: { 200: { description: route.description, body: text } },
+        security: false,
+    }, async () => ({ status: 200, body: route.body, headers: { 'content-type': route.contentType } }));
+}
+//# sourceMappingURL=open-api-docs-routes.js.map

package/dist/docs/open-api-docs-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-docs-routes.js","sourceRoot":"","sources":["../../src/docs/open-api-docs-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA0B1C,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,gDAAgD;IACzD,MAAM,EAAE,sDAAsD;IAC9D,KAAK,EAAE,8CAA8C;CACtD,CAAC;AAEF,MAAM,IAAI,GAAG,YAAY,CAAS,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAyB,EAAE,OAAO,GAAsB,EAAE;IAC1F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;IAEnC,MAAM,IAAI,GAAG,QAAQ,CAAC;QACpB,EAAE;QACF,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK;QAC3C,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,cAAc,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,kBAAkB;YAC3B,WAAW,EAAE,2BAA2B;YACxC,WAAW,EAAE,iCAAiC;YAC9C,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC;SACjC,CAAC;QACF,SAAS,CAAC;YACR,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO;YAC/B,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE,+BAA+B;YACxC,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,0BAA0B;YACvC,IAAI,EAAE,IAAI;SACX,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAgB;IACjC,OAAO,WAAW,CAChB;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAClE,QAAQ,EAAE,KAAK;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAChG,CAAC;AACJ,CAAC"}

package/dist/docs.d.ts

@@ -0,0 +1,3 @@
+export type { DocsUi } from './docs/docs-ui.js';
+export { openApiDocsRoutes, type DocsRoutesOptions } from './docs/open-api-docs-routes.js';
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/docs.js

@@ -0,0 +1,2 @@
+export { openApiDocsRoutes } from './docs/open-api-docs-routes.js';
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,gCAAgC,CAAC"}

package/dist/error/create-error-mapper.d.ts

@@ -0,0 +1,10 @@
+import type { ErrorMapper } from './error-mapper.js';
+import type { ErrorMapping } from './error-mapping.js';
+export interface ErrorMapperOptions {
+    /** Status of a `DomainError` whose code is not mapped. Defaults to 422. */
+    readonly fallbackStatus?: number;
+    /** Builds the problem `type` URI of a code. Defaults to `urn:problem:<code-in-kebab-case>`. */
+    readonly typeOf?: (code: string) => string;
+}
+export declare function createErrorMapper(overrides?: ErrorMapping, options?: ErrorMapperOptions): ErrorMapper;
+//# sourceMappingURL=create-error-mapper.d.ts.map

package/dist/error/create-error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-error-mapper.d.ts","sourceRoot":"","sources":["../../src/error/create-error-mapper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,YAAiB,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAW7G"}

package/dist/error/create-error-mapper.js

@@ -0,0 +1,12 @@
+import { DEFAULT_ERROR_MAPPING } from './default-error-mapping.js';
+export function createErrorMapper(overrides = {}, options = {}) {
+    const mapping = { ...DEFAULT_ERROR_MAPPING, ...overrides };
+    const fallbackStatus = options.fallbackStatus ?? 422;
+    const typeOf = options.typeOf ?? ((code) => `urn:problem:${code.toLowerCase().replaceAll('_', '-')}`);
+    return {
+        mapping,
+        statusOf: (code) => mapping[code] ?? fallbackStatus,
+        typeOf,
+    };
+}
+//# sourceMappingURL=create-error-mapper.js.map

package/dist/error/create-error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-error-mapper.js","sourceRoot":"","sources":["../../src/error/create-error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAWnE,MAAM,UAAU,iBAAiB,CAAC,SAAS,GAAiB,EAAE,EAAE,OAAO,GAAuB,EAAE;IAC9F,MAAM,OAAO,GAAiB,EAAE,GAAG,qBAAqB,EAAE,GAAG,SAAS,EAAE,CAAC;IACzE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC;IAErD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAE9G,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,cAAc;QACnD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/error/default-error-mapping.d.ts

@@ -0,0 +1,3 @@
+import type { ErrorMapping } from './error-mapping.js';
+export declare const DEFAULT_ERROR_MAPPING: ErrorMapping;
+//# sourceMappingURL=default-error-mapping.d.ts.map

package/dist/error/default-error-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-error-mapping.d.ts","sourceRoot":"","sources":["../../src/error/default-error-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,YAOnC,CAAC"}

package/dist/error/default-error-mapping.js

@@ -0,0 +1,9 @@
+export const DEFAULT_ERROR_MAPPING = {
+    VALIDATION_FAILED: 422,
+    NOT_FOUND: 404,
+    CONFLICT: 409,
+    INVARIANT_VIOLATION: 422,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+};
+//# sourceMappingURL=default-error-mapping.js.map

package/dist/error/default-error-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-error-mapping.js","sourceRoot":"","sources":["../../src/error/default-error-mapping.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,iBAAiB,EAAE,GAAG;IACtB,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,mBAAmB,EAAE,GAAG;IACxB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;CACf,CAAC"}

package/dist/error/error-mapper.d.ts

@@ -0,0 +1,12 @@
+import type { ErrorMapping } from './error-mapping.js';
+/**
+ * Says which status and which problem `type` a domain error code answers. One per application:
+ * the server and the contract generator must be given the same one.
+ */
+export declare abstract class ErrorMapper {
+    static readonly tokenKey = "http.ErrorMapper";
+    abstract readonly mapping: ErrorMapping;
+    abstract statusOf(code: string): number;
+    abstract typeOf(code: string): string;
+}
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/error/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../src/error/error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,8BAAsB,WAAW;IAC/B,MAAM,CAAC,QAAQ,CAAC,QAAQ,sBAAsB;IAE9C,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAExC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAExC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC"}

package/dist/error/error-mapper.js

@@ -0,0 +1,8 @@
+/**
+ * Says which status and which problem `type` a domain error code answers. One per application:
+ * the server and the contract generator must be given the same one.
+ */
+export class ErrorMapper {
+    static tokenKey = 'http.ErrorMapper';
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/error/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../src/error/error-mapper.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAgB,WAAW;IAC/B,MAAM,CAAU,QAAQ,GAAG,kBAAkB,CAAC;CAO/C"}

package/dist/error/error-mapping.d.ts

@@ -0,0 +1,3 @@
+/** Domain error `code` to HTTP status. */
+export type ErrorMapping = Readonly<Record<string, number>>;
+//# sourceMappingURL=error-mapping.d.ts.map

package/dist/error/error-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapping.d.ts","sourceRoot":"","sources":["../../src/error/error-mapping.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/error/error-mapping.js

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

package/dist/error/error-mapping.js.map

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

package/dist/error/forbidden-error.d.ts

@@ -0,0 +1,5 @@
+import { DomainError } from '@ddd-ts-kit/kernel';
+export declare class ForbiddenError extends DomainError {
+    readonly code = "FORBIDDEN";
+}
+//# sourceMappingURL=forbidden-error.d.ts.map

package/dist/error/forbidden-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden-error.d.ts","sourceRoot":"","sources":["../../src/error/forbidden-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,IAAI,eAAe;CAC7B"}

package/dist/error/forbidden-error.js

@@ -0,0 +1,5 @@
+import { DomainError } from '@ddd-ts-kit/kernel';
+export class ForbiddenError extends DomainError {
+    code = 'FORBIDDEN';
+}
+//# sourceMappingURL=forbidden-error.js.map

package/dist/error/forbidden-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden-error.js","sourceRoot":"","sources":["../../src/error/forbidden-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,IAAI,GAAG,WAAW,CAAC;CAC7B"}

package/dist/error/internal-error-code.d.ts

@@ -0,0 +1,2 @@
+export declare const INTERNAL_ERROR_CODE = "INTERNAL_ERROR";
+//# sourceMappingURL=internal-error-code.d.ts.map

package/dist/error/internal-error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error-code.d.ts","sourceRoot":"","sources":["../../src/error/internal-error-code.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,mBAAmB,CAAC"}

package/dist/error/internal-error-code.js

@@ -0,0 +1,2 @@
+export const INTERNAL_ERROR_CODE = 'INTERNAL_ERROR';
+//# sourceMappingURL=internal-error-code.js.map

package/dist/error/internal-error-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error-code.js","sourceRoot":"","sources":["../../src/error/internal-error-code.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC"}

package/dist/error/problem.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationIssue } from '@ddd-ts-kit/validation';
+export interface Problem {
+    readonly type: string;
+    readonly title: string;
+    readonly status: number;
+    readonly code: string;
+    readonly detail?: string;
+    readonly issues?: readonly ValidationIssue[];
+    readonly requestId: string;
+}
+//# sourceMappingURL=problem.d.ts.map