@owlmeans/error 0.1.18-rc.38 → 0.1.18-rc.39

package/README.md

@@ -12,7 +12,7 @@ framework packages already ship: authentication and authorization failures from
 ## Installation
 
 ```bash
-bun add @owlmeans/error@^0.1.18-rc.38
+bun add @owlmeans/error@^0.1.18-rc.39
 ```
 
 ## Concepts
@@ -272,7 +272,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.49
+npx @owlmeans/agent-skills@^0.1.18-rc.57
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
-  "schemaVersion": 2,
+  "schemaVersion": 3,
   "package": "@owlmeans/error",
-  "version": "0.1.18-rc.38",
-  "generatedAt": "2026-10-05T21:03:06.410Z",
+  "version": "0.1.18-rc.39",
+  "generatedAt": "2026-10-20T23:19:58.641Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/error/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/error
 
 **Layer:** Core
-**Install:** `"@owlmeans/error": "^0.1.18-rc.38"` in `dependencies`
+**Install:** `"@owlmeans/error": "^0.1.18-rc.39"` in `dependencies`
 
 ## Key Exports
 

package/build/resilient.d.ts

@@ -0,0 +1,33 @@
+import type { Converter, MarshalErrorOptions, ResilientErrorConstructor } from './types.js';
+/**
+ * Whether a value is a `ResilientError` built by ANY copy of this module.
+ *
+ * Structural: the shared brand plus the `type` and `marshal` every instance carries.
+ */
+export declare const isResilientError: (value: unknown) => value is ResilientError;
+export declare class ResilientError extends Error {
+    static separator: string;
+    static typeName: string;
+    static converters: Converter[];
+    /**
+     * `instanceof` that holds across module copies.
+     *
+     * The native prototype check answers first. Failing that, a branded instance matches when its
+     * class lineage ENDS WITH this class's lineage — the same own type names, in the same order, up
+     * to the base. So `instanceof AuthFailedError` accepts an `AuthFailedError` (or a subclass of it)
+     * from another copy, and never a sibling class or a parent. A class that does not declare its
+     * own `typeName` cannot be told apart structurally and answers natively only.
+     */
+    static [Symbol.hasInstance]<T extends abstract new (...args: any[]) => any>(this: T, instance: unknown): instance is InstanceType<T>;
+    static registerErrorClass(resilientErrorClass: ResilientErrorConstructor, errorClass?: ErrorConstructor): Converter;
+    static ensure(err: Error | string, throwOnUnknown?: boolean): ResilientError;
+    static marshal(err: Error, opts?: MarshalErrorOptions): Error;
+    type: string;
+    oiriginalStack?: string;
+    /** Correlates a serialized boundary error with the server log entry that owns its full stack. */
+    incidentId?: string;
+    constructor(type: string, message: string, stack?: string);
+    marshal(opts?: MarshalErrorOptions): Error;
+    finalizeUnmarshal(): void;
+}
+//# sourceMappingURL=resilient.d.ts.map

package/build/resilient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient.d.ts","sourceRoot":"","sources":["../src/resilient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAyC3F;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,KAAK,IAAI,cAS1D,CAAA;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,OAAc,SAAS,EAAE,MAAM,CAAY;IAE3C,OAAc,QAAQ,EAAE,MAAM,CAAiB;IAE/C,OAAc,UAAU,EAAE,SAAS,EAAE,CAAqB;IAE1D;;;;;;;;OAQG;IACH,OAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxF,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,GACzB,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAY7B;IAED,OAAc,kBAAkB,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAKzH;IAED,OAAc,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,cAAc,CA4BlF;IAED,OAAc,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAenE;IAEM,IAAI,EAAE,MAAM,CAAiB;IAE7B,cAAc,CAAC,EAAE,MAAM,CAAA;IAE9B,iGAAiG;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAA;IAE1B,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAQxD;IAED,OAAO,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAEzC;IAED,iBAAiB,IAAI,IAAI,CAAI;CAC9B"}

package/build/resilient.js

@@ -0,0 +1,146 @@
+import { CATCH_ALL_CONVERTER, CONVERTER_REGISTRY, RESILENT_ERROR, RESILIENT_BRAND, SEPARATOR } from './consts.js';
+import { createErrorConverter } from './utils.js';
+/**
+ * The one converter registry of the process.
+ *
+ * Kept on `globalThis` so every copy of this module registers into, and unmarshals from, the same
+ * list: a class registered by one copy is rebuilt by another. Registration order is kept across
+ * copies, so the last registration of a type name still wins.
+ */
+const sharedConverters = () => {
+    const holder = globalThis;
+    holder[CONVERTER_REGISTRY] ??= [];
+    return holder[CONVERTER_REGISTRY];
+};
+/**
+ * The type names a class declares itself and inherits, nearest first — only names a class owns.
+ *
+ * A class that does not redeclare `typeName` inherits its parent's value, and counting that twice
+ * would let a check against the subclass match any instance of the parent.
+ */
+const lineageOf = (ctor) => {
+    const names = [];
+    let current = ctor;
+    while (typeof current === 'function') {
+        if (Object.prototype.hasOwnProperty.call(current, 'typeName')) {
+            const name = current.typeName;
+            if (typeof name === 'string') {
+                names.push(name);
+            }
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return names;
+};
+/**
+ * Whether a value is a `ResilientError` built by ANY copy of this module.
+ *
+ * Structural: the shared brand plus the `type` and `marshal` every instance carries.
+ */
+export const isResilientError = (value) => {
+    if (value == null || typeof value !== 'object') {
+        return false;
+    }
+    const candidate = value;
+    return candidate[RESILIENT_BRAND] === true
+        && typeof candidate.type === 'string'
+        && typeof candidate.marshal === 'function';
+};
+export class ResilientError extends Error {
+    static separator = SEPARATOR;
+    static typeName = RESILENT_ERROR;
+    static converters = sharedConverters();
+    /**
+     * `instanceof` that holds across module copies.
+     *
+     * The native prototype check answers first. Failing that, a branded instance matches when its
+     * class lineage ENDS WITH this class's lineage — the same own type names, in the same order, up
+     * to the base. So `instanceof AuthFailedError` accepts an `AuthFailedError` (or a subclass of it)
+     * from another copy, and never a sibling class or a parent. A class that does not declare its
+     * own `typeName` cannot be told apart structurally and answers natively only.
+     */
+    static [Symbol.hasInstance](instance) {
+        if (Function.prototype[Symbol.hasInstance].call(this, instance)) {
+            return true;
+        }
+        if (!isResilientError(instance) || !Object.prototype.hasOwnProperty.call(this, 'typeName')) {
+            return false;
+        }
+        const expected = lineageOf(this);
+        const actual = lineageOf(Object.getPrototypeOf(instance)?.constructor);
+        const offset = actual.length - expected.length;
+        return offset >= 0 && expected.every((name, index) => actual[offset + index] === name);
+    }
+    static registerErrorClass(resilientErrorClass, errorClass) {
+        const converter = createErrorConverter(resilientErrorClass, errorClass);
+        this.converters.push(converter);
+        return converter;
+    }
+    static ensure(err, throwOnUnknown) {
+        err = typeof err === 'string' ? new Error(err) : err;
+        if (isResilientError(err)) {
+            return err;
+        }
+        // We don't proceed SyntaxError - system should crash in this case
+        if (err instanceof SyntaxError) {
+            throw err;
+        }
+        // Umarshal marhalled error that is wrapepd to ordinary error
+        const unmarhaller = this.converters.toReversed().find(converter => converter.isMarshaled(err));
+        if (unmarhaller != null) {
+            return unmarhaller.unmarshal(err);
+        }
+        // Convert object of Error subtypes to ResilientError subtype
+        const converter = this.converters.find(converter => converter.match(err));
+        if (converter != null) {
+            return converter.convert(err);
+        }
+        if (throwOnUnknown === true) {
+            throw err;
+        }
+        return new ResilientError(this.typeName, err.message, err.stack);
+    }
+    static marshal(err, opts) {
+        const resilient = isResilientError(err);
+        const structuralType = err.type;
+        const type = resilient
+            ? err.type
+            : typeof structuralType === 'string' ? structuralType : this.typeName;
+        const stack = opts?.includeStack === false
+            ? ''
+            : resilient ? err.oiriginalStack : err.stack;
+        const fields = [type, err.message, stack];
+        if (opts?.incidentId != null) {
+            fields.push(opts.incidentId);
+        }
+        return new Error(fields.join(this.separator));
+    }
+    type = RESILENT_ERROR;
+    oiriginalStack;
+    /** Correlates a serialized boundary error with the server log entry that owns its full stack. */
+    incidentId;
+    constructor(type, message, stack) {
+        super(message);
+        this.type = type;
+        if (stack != null) {
+            this.oiriginalStack = stack;
+        }
+        else {
+            this.oiriginalStack = this.stack;
+        }
+    }
+    marshal(opts) {
+        return ResilientError.marshal(this, opts);
+    }
+    finalizeUnmarshal() { }
+}
+// On the prototype, not the instance: non-enumerable, and inherited by every subclass of this copy.
+Object.defineProperty(ResilientError.prototype, RESILIENT_BRAND, { value: true });
+// One catch-all per process: a second module copy finds the first copy's entry and adds none.
+if (!ResilientError.converters.some(converter => converter[CATCH_ALL_CONVERTER] === true)) {
+    ResilientError.converters.push(Object.assign({
+        ...createErrorConverter(ResilientError),
+        match: () => true,
+    }, { [CATCH_ALL_CONVERTER]: true }));
+}
+//# sourceMappingURL=resilient.js.map

package/build/resilient.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/error",
-  "version": "0.1.18-rc.38",
+  "version": "0.1.18-rc.39",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,7 +22,7 @@
     }
   },
   "dependencies": {
-    "@owlmeans/i18n": "^0.1.18-rc.39"
+    "@owlmeans/i18n": "^0.1.18-rc.40"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",