@xemahq/contracts 0.29.0 → 0.30.0

package/dist/.source-stamp.json

@@ -1,5 +1,5 @@
 {
   "algorithm": "sha256/len-framed-v1",
-  "hash": "6cd123483ad71f728dbce45284574a277d004671c1fb1805ebab3f1c4af230aa",
-  "fileCount": 537
+  "hash": "fbb3cb25c83a7a491db356fffc6f4f227be0bf49939a4e7b049beaae2b9ad0f1",
+  "fileCount": 540
 }

package/dist/http/index.d.ts

@@ -1,4 +1,6 @@
 export * from './lib/http-method';
 export * from './lib/problem-details';
+export * from './lib/problem-definition';
+export * from './lib/problem-disposition';
 export * from './lib/xema-error';
 //# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

package/dist/http/index.js

@@ -16,5 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/http-method"), exports);
 __exportStar(require("./lib/problem-details"), exports);
+__exportStar(require("./lib/problem-definition"), exports);
+__exportStar(require("./lib/problem-disposition"), exports);
 __exportStar(require("./lib/xema-error"), exports);
 //# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,wDAAsC;AACtC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,wDAAsC;AACtC,2DAAyC;AACzC,4DAA0C;AAC1C,mDAAiC"}

package/dist/http/lib/problem-declared-params.d.ts

@@ -0,0 +1,13 @@
+import type { z } from 'zod';
+export interface DeclaredProblemParams {
+    readonly code: string;
+    readonly values: Readonly<Record<string, string | number | boolean>>;
+}
+export declare function sealProblemParams(code: string, values: Readonly<Record<string, string | number | boolean>>, schema: z.ZodTypeAny): DeclaredProblemParams;
+export declare function sealProblemIssue<T extends object>(issue: T, code: string, schema: z.ZodTypeAny): T;
+export declare function sealedParamsDefect(candidate: unknown, code: string): string | undefined;
+export declare function sealedIssueDefect(issue: {
+    readonly code?: string | undefined;
+    readonly params?: unknown;
+}): string | undefined;
+//# sourceMappingURL=problem-declared-params.d.ts.map

package/dist/http/lib/problem-declared-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-declared-params.d.ts","sourceRoot":"","sources":["../../../src/http/lib/problem-declared-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuB7B,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACtE;AAWD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3D,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,qBAAqB,CAOvB;AAGD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,CAAC,CAIH;AAMD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAsBpB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,MAAM,GAAG,SAAS,CAkBrB"}

package/dist/http/lib/problem-declared-params.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sealProblemParams = sealProblemParams;
+exports.sealProblemIssue = sealProblemIssue;
+exports.sealedParamsDefect = sealedParamsDefect;
+exports.sealedIssueDefect = sealedIssueDefect;
+const SEALED_PARAMS = new WeakMap();
+const SEALED_ISSUES = new WeakMap();
+function sealProblemParams(code, values, schema) {
+    const sealed = Object.freeze({
+        code,
+        values: Object.freeze({ ...values }),
+    });
+    SEALED_PARAMS.set(sealed, { code, schema });
+    return sealed;
+}
+function sealProblemIssue(issue, code, schema) {
+    const frozen = Object.freeze(issue);
+    SEALED_ISSUES.set(frozen, { code, schema });
+    return frozen;
+}
+function sealedParamsDefect(candidate, code) {
+    if (typeof candidate !== 'object' || candidate === null) {
+        return 'params are not a sealed declaration';
+    }
+    const seal = SEALED_PARAMS.get(candidate);
+    if (seal === undefined) {
+        return ('params were not produced by a declared problem (defineProblem) of this ' +
+            'kernel copy; public params cannot be supplied as a free value');
+    }
+    if (seal.code !== code) {
+        return `params were declared for ${seal.code}, not ${code}`;
+    }
+    const parsed = seal.schema.safeParse(candidate.values);
+    return parsed.success
+        ? undefined
+        : `params no longer satisfy ${code}'s declared schema: ${parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+            .join('; ')}`;
+}
+function sealedIssueDefect(issue) {
+    if (issue.params === undefined) {
+        return undefined;
+    }
+    const seal = SEALED_ISSUES.get(issue);
+    if (seal === undefined) {
+        return ('a field issue carrying params was not minted by a declared problem ' +
+            '(definition.issue); public params cannot be supplied as a free value');
+    }
+    if (seal.code !== issue.code) {
+        return `field issue params were declared for ${seal.code}, not ${String(issue.code)}`;
+    }
+    const parsed = seal.schema.safeParse(issue.params);
+    return parsed.success
+        ? undefined
+        : `field issue params no longer satisfy ${seal.code}'s declared schema`;
+}
+//# sourceMappingURL=problem-declared-params.js.map

package/dist/http/lib/problem-declared-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-declared-params.js","sourceRoot":"","sources":["../../../src/http/lib/problem-declared-params.ts"],"names":[],"mappings":";;AAuCA,8CAWC;AAGD,4CAQC;AAMD,gDAyBC;AAMD,8CAqBC;AApFD,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgB,CAAC;AAClD,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgB,CAAC;AAGlD,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,MAA2D,EAC3D,MAAoB;IAEpB,MAAM,MAAM,GAA0B,MAAM,CAAC,MAAM,CAAC;QAClD,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;KACrC,CAAC,CAAC;IACH,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,SAAgB,gBAAgB,CAC9B,KAAQ,EACR,IAAY,EACZ,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAMD,SAAgB,kBAAkB,CAChC,SAAkB,EAClB,IAAY;IAEZ,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CACL,yEAAyE;YACzE,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,4BAA4B,IAAI,CAAC,IAAI,SAAS,IAAI,EAAE,CAAC;IAC9D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CACjC,SAAmC,CAAC,MAAM,CAC5C,CAAC;IACF,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,4BAA4B,IAAI,uBAAuB,MAAM,CAAC,KAAK,CAAC,MAAM;aACvE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtB,CAAC;AAMD,SAAgB,iBAAiB,CAAC,KAGjC;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CACL,qEAAqE;YACrE,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,wCAAwC,IAAI,CAAC,IAAI,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,wCAAwC,IAAI,CAAC,IAAI,oBAAoB,CAAC;AAC5E,CAAC"}

package/dist/http/lib/problem-definition.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { type ProblemActionableBy, type ProblemFieldIssue, type ProblemParamValue, type ProblemRetry } from './problem-details';
+import { XemaError, type XemaErrorInit } from './xema-error';
+declare const PARAM_SCHEMA: unique symbol;
+export interface ProblemParamSpec<T extends ProblemParamValue> {
+    readonly [PARAM_SCHEMA]: z.ZodType<T>;
+}
+export declare const problemParam: Readonly<{
+    string(options?: {
+        readonly maxLength?: number;
+    }): ProblemParamSpec<string>;
+    number(): ProblemParamSpec<number>;
+    integer(options?: {
+        readonly min?: number;
+        readonly max?: number;
+    }): ProblemParamSpec<number>;
+    boolean(): ProblemParamSpec<boolean>;
+    oneOf<const V extends readonly [string, ...string[]]>(values: V): ProblemParamSpec<V[number]>;
+}>;
+export type ProblemParamsOf<S> = {
+    readonly [K in keyof S]: S[K] extends ProblemParamSpec<infer T> ? T : never;
+};
+type ParamSpecs = Readonly<Record<string, ProblemParamSpec<ProblemParamValue>>>;
+export type ProblemArgs<S extends ParamSpecs, O> = keyof S extends never ? [options?: O] : [params: ProblemParamsOf<S>, options?: O];
+export interface ProblemDeclaration<S extends ParamSpecs> {
+    readonly code: string;
+    readonly title: string;
+    readonly status: number;
+    readonly actionableBy?: ProblemActionableBy;
+    readonly retry?: ProblemRetry;
+    readonly params?: S;
+}
+export interface ProblemThrowOptions {
+    readonly detail?: string;
+    readonly instance?: string;
+    readonly errors?: readonly ProblemFieldIssue[];
+    readonly extensions?: Readonly<Record<string, unknown>>;
+    readonly cause?: unknown;
+    readonly actionableBy?: ProblemActionableBy;
+    readonly retry?: ProblemRetry;
+}
+export interface ProblemDefinition<S extends ParamSpecs = Record<never, never>> {
+    readonly code: string;
+    readonly title: string;
+    readonly status: number;
+    readonly actionableBy: ProblemActionableBy | undefined;
+    readonly retry: ProblemRetry | undefined;
+    readonly paramNames: readonly string[];
+    init(...args: ProblemArgs<S, ProblemThrowOptions>): XemaErrorInit;
+    create(...args: ProblemArgs<S, ProblemThrowOptions>): XemaError;
+    issue(pointer: string, ...args: ProblemArgs<S, {
+        readonly detail?: string;
+    }>): ProblemFieldIssue;
+    matches(value: unknown): value is XemaError;
+}
+export declare function defineProblem<S extends ParamSpecs = Record<never, never>>(declaration: ProblemDeclaration<S>): ProblemDefinition<S>;
+export {};
+//# sourceMappingURL=problem-definition.d.ts.map

package/dist/http/lib/problem-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-definition.d.ts","sourceRoot":"","sources":["../../../src/http/lib/problem-definition.ts"],"names":[],"mappings":"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"}

package/dist/http/lib/problem-definition.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.problemParam = void 0;
+exports.defineProblem = defineProblem;
+const zod_1 = require("zod");
+const problem_declared_params_1 = require("./problem-declared-params");
+const problem_details_1 = require("./problem-details");
+const xema_error_1 = require("./xema-error");
+const PARAM_SCHEMA = Symbol('ProblemParamSpec.schema');
+function spec(schema) {
+    return Object.freeze({ [PARAM_SCHEMA]: schema });
+}
+exports.problemParam = Object.freeze({
+    string(options) {
+        return spec((0, problem_details_1.problemParamStringSchema)(options?.maxLength ?? problem_details_1.PROBLEM_PARAM_MAX_STRING_LENGTH));
+    },
+    number() {
+        return spec(zod_1.z.number().finite());
+    },
+    integer(options) {
+        let schema = zod_1.z.number().int().safe();
+        if (options?.min !== undefined)
+            schema = schema.min(options.min);
+        if (options?.max !== undefined)
+            schema = schema.max(options.max);
+        return spec(schema);
+    },
+    boolean() {
+        return spec(zod_1.z.boolean());
+    },
+    oneOf(values) {
+        for (const value of values) {
+            if (!(0, problem_details_1.problemParamStringSchema)().safeParse(value).success) {
+                throw new problem_details_1.ProblemDetailsError(problem_details_1.ProblemDetailsRefusal.Malformed, `problemParam.oneOf: '${value}' is not a safe params string.`, 'params');
+            }
+        }
+        return spec(zod_1.z.enum(values));
+    },
+});
+function refuseDeclaration(message, member) {
+    throw new problem_details_1.ProblemDetailsError(problem_details_1.ProblemDetailsRefusal.Malformed, message, member);
+}
+function defineProblem(declaration) {
+    const { code, title, status } = declaration;
+    if (!problem_details_1.PROBLEM_CODE_PATTERN.test(code)) {
+        refuseDeclaration(`defineProblem: '${code}' is not SCREAMING_SNAKE_CASE.`, 'code');
+    }
+    if (title.trim() === '') {
+        refuseDeclaration(`defineProblem ${code}: title is empty.`, 'title');
+    }
+    if (!Number.isInteger(status) || status < 400 || status > 599) {
+        refuseDeclaration(`defineProblem ${code}: status ${status} is not 400–599.`, 'status');
+    }
+    if (declaration.actionableBy !== undefined &&
+        !problem_details_1.ProblemActionableBySchema.safeParse(declaration.actionableBy).success) {
+        refuseDeclaration(`defineProblem ${code}: actionableBy is not a ProblemActionableBy.`, 'actionableBy');
+    }
+    if (declaration.retry !== undefined &&
+        !problem_details_1.ProblemRetrySchema.safeParse(declaration.retry).success) {
+        refuseDeclaration(`defineProblem ${code}: retry is not a ProblemRetry.`, 'retry');
+    }
+    const specs = declaration.params ?? {};
+    const paramNames = Object.keys(specs).sort();
+    if (paramNames.length > problem_details_1.PROBLEM_PARAMS_MAX_ENTRIES) {
+        refuseDeclaration(`defineProblem ${code}: ${paramNames.length} params declared, at most ${problem_details_1.PROBLEM_PARAMS_MAX_ENTRIES}.`, 'params');
+    }
+    const shape = {};
+    for (const name of paramNames) {
+        if (!problem_details_1.PROBLEM_PARAM_NAME_PATTERN.test(name)) {
+            refuseDeclaration(`defineProblem ${code}: param '${name}' is not lowerCamelCase.`, 'params');
+        }
+        const schema = specs[name]?.[PARAM_SCHEMA];
+        if (schema === undefined) {
+            refuseDeclaration(`defineProblem ${code}: param '${name}' was not built with problemParam.*.`, 'params');
+        }
+        shape[name] = schema;
+    }
+    const paramsSchema = zod_1.z.object(shape).strict();
+    const sealParams = (params) => {
+        if (paramNames.length === 0) {
+            return undefined;
+        }
+        const parsed = paramsSchema.safeParse(params);
+        if (!parsed.success) {
+            refuseDeclaration(`${code}: params do not satisfy the declaration — ${parsed.error.issues
+                .map((issue) => `${['params', ...issue.path.map(String)].join('.')}: ${issue.message}`)
+                .join('; ')}`, 'params');
+        }
+        return (0, problem_declared_params_1.sealProblemParams)(code, parsed.data, paramsSchema);
+    };
+    const split = (args) => paramNames.length === 0
+        ? { params: undefined, options: args[0] }
+        : { params: args[0], options: args[1] };
+    const init = (...args) => {
+        const { params, options } = split(args);
+        const declaredParams = sealParams(params);
+        const actionableBy = options?.actionableBy ?? declaration.actionableBy;
+        const retry = options?.retry ?? declaration.retry;
+        return {
+            code,
+            title,
+            status,
+            ...(options?.detail === undefined ? {} : { detail: options.detail }),
+            ...(options?.instance === undefined
+                ? {}
+                : { instance: options.instance }),
+            ...(options?.errors === undefined ? {} : { errors: options.errors }),
+            ...(options?.extensions === undefined
+                ? {}
+                : { extensions: options.extensions }),
+            ...(options?.cause === undefined ? {} : { cause: options.cause }),
+            ...(actionableBy === undefined ? {} : { actionableBy }),
+            ...(retry === undefined ? {} : { retry }),
+            ...(declaredParams === undefined ? {} : { declaredParams }),
+        };
+    };
+    return Object.freeze({
+        code,
+        title,
+        status,
+        actionableBy: declaration.actionableBy,
+        retry: declaration.retry,
+        paramNames: Object.freeze(paramNames),
+        init,
+        create: (...args) => new xema_error_1.XemaError(init(...args)),
+        issue: (pointer, ...args) => {
+            if (!pointer.startsWith('/')) {
+                refuseDeclaration(`${code}: issue pointer '${pointer}' is not a JSON Pointer (RFC 6901).`, 'errors');
+            }
+            const { params, options } = split(args);
+            const sealed = sealParams(params);
+            const issue = {
+                pointer,
+                detail: options?.detail ?? title,
+                code,
+                ...(sealed === undefined ? {} : { params: { ...sealed.values } }),
+            };
+            return sealed === undefined
+                ? Object.freeze(issue)
+                : (0, problem_declared_params_1.sealProblemIssue)(issue, code, paramsSchema);
+        },
+        matches: (value) => (0, xema_error_1.isXemaError)(value) && value.code === code,
+    });
+}
+//# sourceMappingURL=problem-definition.js.map

package/dist/http/lib/problem-definition.js.map

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

package/dist/http/lib/problem-details.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { type DeclaredProblemParams } from './problem-declared-params';
+export type { DeclaredProblemParams } from './problem-declared-params';
 export declare const PROBLEM_DETAILS_CONTENT_TYPE = "application/problem+json";
 export declare const PROBLEM_TYPE_NAMESPACE = "https://xema.dev/problems/";
 export declare const PROBLEM_CODE_PATTERN: RegExp;
@@ -16,9 +18,32 @@ export declare class ProblemDetailsError extends Error {
 }
 export declare function problemTypeUri(code: string): string;
 export declare function problemCodeFromTypeUri(typeUri: string): string | null;
+export declare enum ProblemActionableBy {
+    User = "user",
+    OrgAdmin = "org-admin",
+    Platform = "platform",
+    None = "none"
+}
+export declare const ProblemActionableBySchema: z.ZodEnum<typeof ProblemActionableBy>;
+export declare enum ProblemRetry {
+    Transient = "transient",
+    AfterChange = "after-change",
+    Never = "never"
+}
+export declare const ProblemRetrySchema: z.ZodEnum<typeof ProblemRetry>;
+export declare const PROBLEM_PARAM_NAME_PATTERN: RegExp;
+export declare const PROBLEM_PARAM_MAX_STRING_LENGTH = 200;
+export declare const PROBLEM_PARAMS_MAX_ENTRIES = 16;
+export declare function problemParamStringSchema(maxLength?: number): z.ZodString;
+export declare const ProblemParamValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+export type ProblemParamValue = z.infer<typeof ProblemParamValueSchema>;
+export declare const ProblemParamsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+export type ProblemParams = z.infer<typeof ProblemParamsSchema>;
 export declare const ProblemFieldIssueSchema: z.ZodObject<{
     pointer: z.ZodString;
     detail: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
 }, z.core.$strict>;
 export type ProblemFieldIssue = z.infer<typeof ProblemFieldIssueSchema>;
 export declare const ProblemDetailsSchema: z.ZodObject<{
@@ -32,13 +57,26 @@ export declare const ProblemDetailsSchema: z.ZodObject<{
     errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
         pointer: z.ZodString;
         detail: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
     }, z.core.$strict>>>;
+    actionableBy: z.ZodOptional<z.ZodEnum<typeof ProblemActionableBy>>;
+    retry: z.ZodOptional<z.ZodEnum<typeof ProblemRetry>>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
 }, z.core.$catchall<z.ZodUnknown>>;
 export type ProblemDetails = z.infer<typeof ProblemDetailsSchema>;
 export type ProblemDetailsReservedMember = keyof typeof ProblemDetailsSchema.shape;
 export declare const PROBLEM_DETAILS_RESERVED_MEMBERS: readonly ProblemDetailsReservedMember[];
 export declare function isReservedProblemMember(name: string): name is ProblemDetailsReservedMember;
 export declare function assertNoReservedExtensionMembers(extensions: Readonly<Record<string, unknown>> | undefined): void;
+export declare function problemParamsDefect(input: {
+    readonly code: string;
+    readonly params?: unknown;
+    readonly errors?: readonly {
+        readonly code?: string | undefined;
+        readonly params?: unknown;
+    }[] | undefined;
+}): string | undefined;
 export declare function buildProblemDetails(input: {
     code: string;
     title: string;
@@ -47,6 +85,9 @@ export declare function buildProblemDetails(input: {
     instance?: string;
     traceId?: string;
     errors?: readonly ProblemFieldIssue[];
+    actionableBy?: ProblemActionableBy;
+    retry?: ProblemRetry;
+    params?: DeclaredProblemParams;
     extensions?: Readonly<Record<string, unknown>>;
 }): ProblemDetails;
 export declare function assertProblemDetails(document: unknown): ProblemDetails;

package/dist/http/lib/problem-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"problem-details.d.ts","sourceRoot":"","sources":["../../../src/http/lib/problem-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmFxB,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAUvE,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAUnE,eAAO,MAAM,oBAAoB,QAAoC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,aAM3B,CAAC;AAGJ,oBAAY,qBAAqB;IAE/B,SAAS,cAAc;IAKvB,gBAAgB,uBAAuB;IAEvC,gBAAgB,wBAAwB;IAOxC,uBAAuB,8BAA8B;CACtD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IAOvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAPf,OAAO,EAAE,qBAAqB,EACvC,OAAO,EAAE,MAAM,EAMN,MAAM,CAAC,EAAE,MAAM,YAAA;CAK3B;AAUD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAQD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrE;AASD,eAAO,MAAM,uBAAuB;;;kBAOzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAYxE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;kCAqBT,CAAC;AAEzB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,MAAM,MAAM,4BAA4B,GAAG,MAAM,OAAO,oBAAoB,CAAC,KAAK,CAAC;AAyBnF,eAAO,MAAM,gCAAgC,EAAE,SAAS,4BAA4B,EAGjF,CAAC;AAOJ,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,GACX,IAAI,IAAI,4BAA4B,CAEtC;AAYD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACxD,IAAI,CAgBN;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAMtC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD,GAAG,cAAc,CAsBjB;AAWD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAsBtE;AAiBD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAW9E"}
+{"version":3,"file":"problem-details.d.ts","sourceRoot":"","sources":["../../../src/http/lib/problem-details.ts"],"names":[],"mappings":"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"}

package/dist/http/lib/problem-details.js

@@ -1,14 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROBLEM_DETAILS_RESERVED_MEMBERS = exports.ProblemDetailsSchema = exports.ProblemFieldIssueSchema = exports.ProblemDetailsError = exports.ProblemDetailsRefusal = exports.ProblemCodeSchema = exports.PROBLEM_CODE_PATTERN = exports.PROBLEM_TYPE_NAMESPACE = exports.PROBLEM_DETAILS_CONTENT_TYPE = void 0;
+exports.PROBLEM_DETAILS_RESERVED_MEMBERS = exports.ProblemDetailsSchema = exports.ProblemFieldIssueSchema = exports.ProblemParamsSchema = exports.ProblemParamValueSchema = exports.PROBLEM_PARAMS_MAX_ENTRIES = exports.PROBLEM_PARAM_MAX_STRING_LENGTH = exports.PROBLEM_PARAM_NAME_PATTERN = exports.ProblemRetrySchema = exports.ProblemRetry = exports.ProblemActionableBySchema = exports.ProblemActionableBy = exports.ProblemDetailsError = exports.ProblemDetailsRefusal = exports.ProblemCodeSchema = exports.PROBLEM_CODE_PATTERN = exports.PROBLEM_TYPE_NAMESPACE = exports.PROBLEM_DETAILS_CONTENT_TYPE = void 0;
 exports.problemTypeUri = problemTypeUri;
 exports.problemCodeFromTypeUri = problemCodeFromTypeUri;
+exports.problemParamStringSchema = problemParamStringSchema;
 exports.isReservedProblemMember = isReservedProblemMember;
 exports.assertNoReservedExtensionMembers = assertNoReservedExtensionMembers;
+exports.problemParamsDefect = problemParamsDefect;
 exports.buildProblemDetails = buildProblemDetails;
 exports.assertProblemDetails = assertProblemDetails;
 exports.isProblemDetails = isProblemDetails;
 const zod_1 = require("zod");
+const problem_declared_params_1 = require("./problem-declared-params");
 exports.PROBLEM_DETAILS_CONTENT_TYPE = 'application/problem+json';
 exports.PROBLEM_TYPE_NAMESPACE = 'https://xema.dev/problems/';
 exports.PROBLEM_CODE_PATTERN = /^[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*$/;
@@ -51,12 +54,48 @@ function problemCodeFromTypeUri(typeUri) {
     const code = slug.toUpperCase().replaceAll('-', '_');
     return exports.PROBLEM_CODE_PATTERN.test(code) ? code : null;
 }
+var ProblemActionableBy;
+(function (ProblemActionableBy) {
+    ProblemActionableBy["User"] = "user";
+    ProblemActionableBy["OrgAdmin"] = "org-admin";
+    ProblemActionableBy["Platform"] = "platform";
+    ProblemActionableBy["None"] = "none";
+})(ProblemActionableBy || (exports.ProblemActionableBy = ProblemActionableBy = {}));
+exports.ProblemActionableBySchema = zod_1.z.nativeEnum(ProblemActionableBy);
+var ProblemRetry;
+(function (ProblemRetry) {
+    ProblemRetry["Transient"] = "transient";
+    ProblemRetry["AfterChange"] = "after-change";
+    ProblemRetry["Never"] = "never";
+})(ProblemRetry || (exports.ProblemRetry = ProblemRetry = {}));
+exports.ProblemRetrySchema = zod_1.z.nativeEnum(ProblemRetry);
+exports.PROBLEM_PARAM_NAME_PATTERN = /^[a-z][a-zA-Z0-9]*$/;
+exports.PROBLEM_PARAM_MAX_STRING_LENGTH = 200;
+exports.PROBLEM_PARAMS_MAX_ENTRIES = 16;
+function problemParamStringSchema(maxLength = exports.PROBLEM_PARAM_MAX_STRING_LENGTH) {
+    return zod_1.z
+        .string()
+        .max(Math.min(maxLength, exports.PROBLEM_PARAM_MAX_STRING_LENGTH))
+        .regex(/^[^\u0000-\u001f\u007f]*$/, 'A params value carries no control characters or line breaks.');
+}
+exports.ProblemParamValueSchema = zod_1.z.union([
+    problemParamStringSchema(),
+    zod_1.z.number().finite(),
+    zod_1.z.boolean(),
+]);
+exports.ProblemParamsSchema = zod_1.z
+    .record(zod_1.z
+    .string()
+    .regex(exports.PROBLEM_PARAM_NAME_PATTERN, 'A params key is lowerCamelCase — the name of an i18n placeholder.'), exports.ProblemParamValueSchema)
+    .refine((params) => Object.keys(params).length <= exports.PROBLEM_PARAMS_MAX_ENTRIES, `A params map carries at most ${exports.PROBLEM_PARAMS_MAX_ENTRIES} entries.`);
 exports.ProblemFieldIssueSchema = zod_1.z
     .object({
     pointer: zod_1.z
         .string()
         .startsWith('/', 'A JSON Pointer starts with "/" (RFC 6901).'),
     detail: zod_1.z.string().min(1),
+    code: exports.ProblemCodeSchema.optional(),
+    params: exports.ProblemParamsSchema.optional(),
 })
     .strict();
 exports.ProblemDetailsSchema = zod_1.z
@@ -69,6 +108,9 @@ exports.ProblemDetailsSchema = zod_1.z
     code: exports.ProblemCodeSchema,
     traceId: zod_1.z.string().optional(),
     errors: zod_1.z.array(exports.ProblemFieldIssueSchema).optional(),
+    actionableBy: exports.ProblemActionableBySchema.optional(),
+    retry: exports.ProblemRetrySchema.optional(),
+    params: exports.ProblemParamsSchema.optional(),
 })
     .catchall(zod_1.z.unknown());
 exports.PROBLEM_DETAILS_RESERVED_MEMBERS = Object.freeze(Object.keys(exports.ProblemDetailsSchema.shape));
@@ -89,8 +131,27 @@ function assertNoReservedExtensionMembers(extensions) {
         }
     }
 }
+function problemParamsDefect(input) {
+    if (input.params !== undefined) {
+        const defect = (0, problem_declared_params_1.sealedParamsDefect)(input.params, input.code);
+        if (defect !== undefined) {
+            return defect;
+        }
+    }
+    for (const [index, issue] of (input.errors ?? []).entries()) {
+        const defect = (0, problem_declared_params_1.sealedIssueDefect)(issue);
+        if (defect !== undefined) {
+            return `errors[${index}]: ${defect}`;
+        }
+    }
+    return undefined;
+}
 function buildProblemDetails(input) {
     assertNoReservedExtensionMembers(input.extensions);
+    const paramsDefect = problemParamsDefect(input);
+    if (paramsDefect !== undefined) {
+        throw new ProblemDetailsError(ProblemDetailsRefusal.Malformed, `${input.code}: ${paramsDefect}.`, 'params');
+    }
     const document = {
         ...(input.extensions ?? {}),
         type: problemTypeUri(input.code),
@@ -110,6 +171,15 @@ function buildProblemDetails(input) {
     if (input.errors !== undefined) {
         document.errors = [...input.errors];
     }
+    if (input.actionableBy !== undefined) {
+        document.actionableBy = input.actionableBy;
+    }
+    if (input.retry !== undefined) {
+        document.retry = input.retry;
+    }
+    if (input.params !== undefined) {
+        document.params = { ...input.params.values };
+    }
     return assertProblemDetails(document);
 }
 function assertProblemDetails(document) {

package/dist/http/lib/problem-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"problem-details.js","sourceRoot":"","sources":["../../../src/http/lib/problem-details.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"problem-details.js","sourceRoot":"","sources":["../../../src/http/lib/problem-details.ts"],"names":[],"mappings":"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"}

package/dist/http/lib/problem-disposition.d.ts

@@ -0,0 +1,8 @@
+import { ProblemActionableBy, ProblemRetry } from './problem-details';
+export interface ProblemDisposition {
+    readonly actionableBy?: ProblemActionableBy;
+    readonly retry?: ProblemRetry;
+}
+export declare function problemDispositionForStatus(status: number): ProblemDisposition;
+export declare function resolveProblemDisposition(status: number, stated: ProblemDisposition): ProblemDisposition;
+//# sourceMappingURL=problem-disposition.d.ts.map

package/dist/http/lib/problem-disposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-disposition.d.ts","sourceRoot":"","sources":["../../../src/http/lib/problem-disposition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA2CtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,GACb,kBAAkB,CAgCpB;AAMD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAQpB"}

package/dist/http/lib/problem-disposition.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.problemDispositionForStatus = problemDispositionForStatus;
+exports.resolveProblemDisposition = resolveProblemDisposition;
+const problem_details_1 = require("./problem-details");
+function problemDispositionForStatus(status) {
+    switch (status) {
+        case 400:
+        case 401:
+        case 413:
+        case 422:
+            return {
+                actionableBy: problem_details_1.ProblemActionableBy.User,
+                retry: problem_details_1.ProblemRetry.AfterChange,
+            };
+        case 403:
+            return { retry: problem_details_1.ProblemRetry.AfterChange };
+        case 408:
+        case 425:
+        case 429:
+            return { retry: problem_details_1.ProblemRetry.Transient };
+        case 500:
+        case 501:
+            return {
+                actionableBy: problem_details_1.ProblemActionableBy.Platform,
+                retry: problem_details_1.ProblemRetry.Never,
+            };
+        case 503:
+            return {
+                actionableBy: problem_details_1.ProblemActionableBy.Platform,
+                retry: problem_details_1.ProblemRetry.Transient,
+            };
+        default:
+            return status >= 500 && status <= 599
+                ? { actionableBy: problem_details_1.ProblemActionableBy.Platform }
+                : {};
+    }
+}
+function resolveProblemDisposition(status, stated) {
+    const fallback = problemDispositionForStatus(status);
+    const actionableBy = stated.actionableBy ?? fallback.actionableBy;
+    const retry = stated.retry ?? fallback.retry;
+    return {
+        ...(actionableBy === undefined ? {} : { actionableBy }),
+        ...(retry === undefined ? {} : { retry }),
+    };
+}
+//# sourceMappingURL=problem-disposition.js.map

package/dist/http/lib/problem-disposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-disposition.js","sourceRoot":"","sources":["../../../src/http/lib/problem-disposition.ts"],"names":[],"mappings":";;AAgDA,kEAkCC;AAMD,8DAWC;AAnGD,uDAAsE;AAgDtE,SAAgB,2BAA2B,CACzC,MAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO;gBACL,YAAY,EAAE,qCAAmB,CAAC,IAAI;gBACtC,KAAK,EAAE,8BAAY,CAAC,WAAW;aAChC,CAAC;QACJ,KAAK,GAAG;YACN,OAAO,EAAE,KAAK,EAAE,8BAAY,CAAC,WAAW,EAAE,CAAC;QAC7C,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,EAAE,KAAK,EAAE,8BAAY,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO;gBACL,YAAY,EAAE,qCAAmB,CAAC,QAAQ;gBAC1C,KAAK,EAAE,8BAAY,CAAC,KAAK;aAC1B,CAAC;QACJ,KAAK,GAAG;YACN,OAAO;gBACL,YAAY,EAAE,qCAAmB,CAAC,QAAQ;gBAC1C,KAAK,EAAE,8BAAY,CAAC,SAAS;aAC9B,CAAC;QACJ;YACE,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG;gBACnC,CAAC,CAAC,EAAE,YAAY,EAAE,qCAAmB,CAAC,QAAQ,EAAE;gBAChD,CAAC,CAAC,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAMD,SAAgB,yBAAyB,CACvC,MAAc,EACd,MAA0B;IAE1B,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC;IAC7C,OAAO;QACL,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/http/lib/xema-error.d.ts

@@ -1,4 +1,5 @@
-import { type ProblemDetails, type ProblemFieldIssue } from './problem-details';
+import type { DeclaredProblemParams } from './problem-declared-params';
+import { ProblemActionableBy, ProblemRetry, type ProblemDetails, type ProblemFieldIssue } from './problem-details';
 export declare const XEMA_ERROR_BRAND = "@xemahq/kernel-contracts/http#XemaError";
 export interface XemaErrorInit {
     readonly code: string;
@@ -7,6 +8,9 @@ export interface XemaErrorInit {
     readonly detail?: string;
     readonly instance?: string;
     readonly errors?: readonly ProblemFieldIssue[];
+    readonly actionableBy?: ProblemActionableBy;
+    readonly retry?: ProblemRetry;
+    readonly declaredParams?: DeclaredProblemParams;
     readonly extensions?: Readonly<Record<string, unknown>>;
     readonly cause?: unknown;
 }
@@ -18,6 +22,10 @@ export declare class XemaError extends Error {
     readonly detail: string;
     readonly instance: string | undefined;
     readonly errors: readonly ProblemFieldIssue[] | undefined;
+    readonly actionableBy: ProblemActionableBy | undefined;
+    readonly retry: ProblemRetry | undefined;
+    readonly params: DeclaredProblemParams['values'] | undefined;
+    readonly declaredParams: DeclaredProblemParams | undefined;
     readonly extensions: Readonly<Record<string, unknown>> | undefined;
     constructor(init: XemaErrorInit);
     toProblemDetails(overrides?: {

package/dist/http/lib/xema-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xema-error.d.ts","sourceRoot":"","sources":["../../../src/http/lib/xema-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AA2E3B,eAAO,MAAM,gBAAgB,4CAA4C,CAAC;AAG1E,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAM/C,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAExD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,SAAU,SAAQ,KAAK;IAElC,QAAQ,CAAC,cAAc,6CAAoB;IAE3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;gBAEvD,IAAI,EAAE,aAAa;IAsD/B,gBAAgB,CAAC,SAAS,CAAC,EAAE;QAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,cAAc;CAiBnB;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAW9D"}
+{"version":3,"file":"xema-error.d.ts","sourceRoot":"","sources":["../../../src/http/lib/xema-error.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAEL,mBAAmB,EAKnB,YAAY,EAKZ,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AA2E3B,eAAO,MAAM,gBAAgB,4CAA4C,CAAC;AAG1E,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAO/C,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAE5C,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAO9B,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAMhD,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAExD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,SAAU,SAAQ,KAAK;IAElC,QAAQ,CAAC,cAAc,6CAAoB;IAE3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAEzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;gBAEvD,IAAI,EAAE,aAAa;IAsF/B,gBAAgB,CAAC,SAAS,CAAC,EAAE;QAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,cAAc;CAsBnB;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAW9D"}

package/dist/http/lib/xema-error.js

@@ -12,6 +12,10 @@ class XemaError extends Error {
     detail;
     instance;
     errors;
+    actionableBy;
+    retry;
+    params;
+    declaredParams;
     extensions;
     constructor(init) {
         const detail = init.detail ?? init.title;
@@ -29,6 +33,17 @@ class XemaError extends Error {
                 'is not one.');
         }
         (0, problem_details_1.assertNoReservedExtensionMembers)(init.extensions);
+        assertWellFormed('errors', problem_details_1.ProblemFieldIssueSchema.array(), init.errors);
+        assertWellFormed('actionableBy', problem_details_1.ProblemActionableBySchema, init.actionableBy);
+        assertWellFormed('retry', problem_details_1.ProblemRetrySchema, init.retry);
+        const paramsDefect = (0, problem_details_1.problemParamsDefect)({
+            code: init.code,
+            params: init.declaredParams,
+            errors: init.errors,
+        });
+        if (paramsDefect !== undefined) {
+            throw new problem_details_1.ProblemDetailsError(problem_details_1.ProblemDetailsRefusal.Malformed, `XemaError ${init.code}: ${paramsDefect}.`, 'params');
+        }
         this.name = new.target.name;
         this.code = init.code;
         this.title = init.title;
@@ -36,6 +51,10 @@ class XemaError extends Error {
         this.detail = detail;
         this.instance = init.instance;
         this.errors = init.errors === undefined ? undefined : [...init.errors];
+        this.actionableBy = init.actionableBy;
+        this.retry = init.retry;
+        this.declaredParams = init.declaredParams;
+        this.params = init.declaredParams?.values;
         this.extensions = init.extensions;
         Object.setPrototypeOf(this, new.target.prototype);
     }
@@ -51,9 +70,14 @@ class XemaError extends Error {
                 ? {}
                 : { traceId: overrides.traceId }),
             ...(this.errors === undefined ? {} : { errors: this.errors }),
-            ...(this.extensions === undefined
+            ...(this.actionableBy === undefined
+                ? {}
+                : { actionableBy: this.actionableBy }),
+            ...(this.retry === undefined ? {} : { retry: this.retry }),
+            ...(this.declaredParams === undefined
                 ? {}
-                : { extensions: this.extensions }),
+                : { params: this.declaredParams }),
+            ...(this.extensions === undefined ? {} : { extensions: this.extensions }),
         });
     }
 }
@@ -68,4 +92,16 @@ function isXemaError(value) {
         typeof candidate.title === 'string' &&
         typeof candidate.status === 'number');
 }
+function assertWellFormed(member, schema, value) {
+    if (value === undefined) {
+        return;
+    }
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        const reasons = parsed.error.issues
+            .map((issue) => `${[member, ...issue.path.map(String)].join('.')}: ${issue.message}`)
+            .join('; ');
+        throw new problem_details_1.ProblemDetailsError(problem_details_1.ProblemDetailsRefusal.Malformed, `XemaError ${member} is malformed — ${reasons}`, member);
+    }
+}
 //# sourceMappingURL=xema-error.js.map

package/dist/http/lib/xema-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"xema-error.js","sourceRoot":"","sources":["../../../src/http/lib/xema-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xema-error.js","sourceRoot":"","sources":["../../../src/http/lib/xema-error.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/contracts",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",