@xemahq/contracts 0.28.0 → 0.30.0

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.28.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)",