@owlmeans/error 0.1.18-rc.3 → 0.1.18-rc.30

package/build/resilient.js

@@ -1,9 +1,76 @@
-import { RESILENT_ERROR, SEPARATOR } from './consts.js';
+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 = [];
+    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);
@@ -11,7 +78,7 @@ export class ResilientError extends Error {
     }
     static ensure(err, throwOnUnknown) {
         err = typeof err === 'string' ? new Error(err) : err;
-        if (err instanceof ResilientError) {
+        if (isResilientError(err)) {
             return err;
         }
         // We don't proceed SyntaxError - system should crash in this case
@@ -33,14 +100,25 @@ export class ResilientError extends Error {
         }
         return new ResilientError(this.typeName, err.message, err.stack);
     }
-    static marshal(err) {
-        if (err instanceof ResilientError) {
-            return new Error([err.type, err.message, err.oiriginalStack].join(this.separator));
+    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([this.typeName, err.message, err.stack].join(this.separator));
+        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;
@@ -51,13 +129,18 @@ export class ResilientError extends Error {
             this.oiriginalStack = this.stack;
         }
     }
-    marshal() {
-        return ResilientError.marshal(this);
+    marshal(opts) {
+        return ResilientError.marshal(this, opts);
     }
     finalizeUnmarshal() { }
 }
-ResilientError.converters.push({
-    ...createErrorConverter(ResilientError),
-    match: () => true
-});
+// 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

@@ -1 +1 @@
-{"version":3,"file":"resilient.js","sourceRoot":"","sources":["../src/resilient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAChC,MAAM,CAAC,SAAS,GAAW,SAAS,CAAA;IAEpC,MAAM,CAAC,QAAQ,GAAW,cAAc,CAAA;IAExC,MAAM,CAAC,UAAU,GAAgB,EAAE,CAAA;IAEnC,MAAM,CAAC,kBAAkB,CAAC,mBAA8C,EAAE,UAA6B;QAC5G,MAAM,SAAS,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAA;QACvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAE/B,OAAO,SAAS,CAAA;IAClB,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,GAAmB,EAAE,cAAwB;QAChE,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QACpD,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,OAAO,GAAG,CAAA;QACZ,CAAC;QAED,kEAAkE;QAClE,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,MAAM,GAAG,CAAA;QACX,CAAC;QAED,6DAA6D;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;QAC9F,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACxB,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;QACzE,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC/B,CAAC;QAED,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,GAAG,CAAA;QACX,CAAC;QAED,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;IAClE,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,GAAU;QAC9B,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,OAAO,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;QACpF,CAAC;QAED,OAAO,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;IAChF,CAAC;IAEM,IAAI,GAAW,cAAc,CAAA;IAE7B,cAAc,CAAS;IAE9B,YAAY,IAAY,EAAE,OAAe,EAAE,KAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAA;QAClC,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,iBAAiB,KAAW,CAAC;CAC9B;AAED,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC;IAC7B,GAAG,oBAAoB,CAAC,cAA2C,CAAC;IACpE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;CAClB,CAAC,CAAA"}
+{"version":3,"file":"resilient.js","sourceRoot":"","sources":["../src/resilient.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -1,5 +1,11 @@
 import type { ResilientError } from './resilient.js';
 export type ValueOrError<T> = T | ResilientError;
+export interface MarshalErrorOptions {
+    /** Defaults to true for backwards compatibility outside an HTTP boundary. */
+    includeStack?: boolean;
+    /** Opaque correlation value appended as the fourth wire field. */
+    incidentId?: string;
+}
 export interface Converter {
     match: (err: Error) => boolean;
     convert: (err: Error) => ResilientError;

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,cAAc,CAAA;AAEhD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAA;IAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,cAAc,CAAA;IACvC,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAA;IACpC,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,cAAc,CAAA;CAC1C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IAClF,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;IACtD,KAAK,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;IACxC,QAAQ,EAAE,MAAM,CAAA;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,cAAc,CAAA;AAEhD,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAA;IAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,cAAc,CAAA;IACvC,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAA;IACpC,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,cAAc,CAAA;CAC1C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IAClF,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;IACtD,KAAK,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;IACxC,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/build/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtE,eAAO,MAAM,oBAAoB,wBACV,yBAAyB,eACjC,gBAAgB,KAC5B,SAQF,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,cAAc,GAAG,cAAc,cAAc,yBAAyB,WAClG,KAAK,KAAG,CAiBb,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtE,eAAO,MAAM,oBAAoB,wBACV,yBAAyB,eACjC,gBAAgB,KAC5B,SAQF,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,cAAc,GAAG,cAAc,cAAc,yBAAyB,WAClG,KAAK,KAAG,CAmBb,CAAA"}

package/build/utils.js

@@ -11,15 +11,19 @@ export const unmarshal = (errorClass) => (err) => {
     if (err instanceof errorClass) {
         return err;
     }
-    const args = err.message.split(ResilientError.separator, 3);
-    if (args.length < 2) {
+    const fields = err.message.split(ResilientError.separator, 4);
+    if (fields.length < 2) {
         throw SyntaxError('Invalid marshaled error');
     }
-    if (args[0] === errorClass.typeName) {
-        args.shift();
-    }
-    const error = new errorClass(...args);
-    error.message = args[0];
+    const [type, message, stack, incidentId] = fields;
+    // The base constructor takes (type, message, stack); subclasses take (message, stack).
+    // Keeping the base's wire type in place avoids shifting a plain Error's message into `type`.
+    const error = errorClass === ResilientError
+        ? new errorClass(type, message, stack)
+        : new errorClass(message, stack);
+    error.type = type;
+    error.message = message;
+    error.incidentId = incidentId;
     error.finalizeUnmarshal();
     return error;
 };

package/build/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,mBAA8C,EAC9C,UAA6B,EAClB,EAAE;IACb,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,IAAI,IAAI,GAAG,YAAY,UAAU;QAC7D,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC;QAC/D,WAAW,EAAE,GAAG,CAAC,EAAE,CACjB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC;QACjF,SAAS,EAAE,SAAS,CAAC,mBAAmB,CAAC;KAC1C,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAA4C,UAAqC,EAAE,EAAE,CAC5G,CAAC,GAAU,EAAK,EAAE;IAChB,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAQ,CAAA;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAA8B,CAAA;IACxF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,WAAW,CAAC,yBAAyB,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,IAAI,CAAC,CAAA;IACrC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACzB,OAAO,KAAU,CAAA;AACnB,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,mBAA8C,EAC9C,UAA6B,EAClB,EAAE;IACb,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,IAAI,IAAI,GAAG,YAAY,UAAU;QAC7D,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC;QAC/D,WAAW,EAAE,GAAG,CAAC,EAAE,CACjB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC;QACjF,SAAS,EAAE,SAAS,CAAC,mBAAmB,CAAC;KAC1C,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAA4C,UAAqC,EAAE,EAAE,CAC5G,CAAC,GAAU,EAAK,EAAE;IAChB,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAQ,CAAA;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC7D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,WAAW,CAAC,yBAAyB,CAAC,CAAA;IAC9C,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,CAAA;IACjD,uFAAuF;IACvF,6FAA6F;IAC7F,MAAM,KAAK,GAAG,UAAU,KAAK,cAAc;QACzC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;QACtC,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,KAAK,CAAC,UAAU,GAAG,UAAU,CAAA;IAC7B,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACzB,OAAO,KAAU,CAAA;AACnB,CAAC,CAAA"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@owlmeans/error",
-  "version": "0.1.18-rc.3",
+  "version": "0.1.18-rc.30",
   "license": "MIT",
   "type": "module",
   "scripts": {
     "build": "tsc -b",
+    "test": "bun test ./tests",
     "dev": "sleep 156 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
     "watch": "tsc -b -w --preserveWatchOutput --pretty"
   },
@@ -21,7 +22,7 @@
     }
   },
   "dependencies": {
-    "@owlmeans/i18n": "^0.1.18-rc.3"
+    "@owlmeans/i18n": "^0.1.18-rc.31"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/consts.ts

@@ -2,3 +2,19 @@
 export const SEPARATOR = '|||'
 
 export const RESILENT_ERROR = 'ResilientError'
+
+/**
+ * Marks every `ResilientError` instance, whichever copy of this module built it.
+ *
+ * A process can hold several copies of this package (`bun --preserve-symlinks` over a linked
+ * workspace resolves one package through several `node_modules` paths), and `instanceof` answers
+ * for one copy only. `Symbol.for` returns the same symbol in every copy, so the brand is the
+ * structural proof `ensure`, `marshal` and `instanceof` read.
+ */
+export const RESILIENT_BRAND: unique symbol = Symbol.for('@owlmeans/error:resilient')
+
+/** The `globalThis` key of the converter registry every copy of this module shares. */
+export const CONVERTER_REGISTRY: unique symbol = Symbol.for('@owlmeans/error:converters')
+
+/** Marks the catch-all converter, so a second module copy does not push another one. */
+export const CATCH_ALL_CONVERTER: unique symbol = Symbol.for('@owlmeans/error:catch-all')

package/src/i18n/fr.json

@@ -0,0 +1,4 @@
+{
+  "minLength": "La valeur est trop courte",
+  "maxLength": "La valeur est trop longue"
+}

package/src/i18n.ts

@@ -7,6 +7,7 @@ import be from './i18n/be.json' with { type: 'json' }
 import uk from './i18n/uk.json' with { type: 'json' }
 import es from './i18n/es.json' with { type: 'json' }
 import de from './i18n/de.json' with { type: 'json' }
+import fr from './i18n/fr.json' with { type: 'json' }
 
 addI18nLib('en', 'errors', en)
 addI18nLib('pl', 'errors', pl)
@@ -15,3 +16,4 @@ addI18nLib('be', 'errors', be)
 addI18nLib('uk', 'errors', uk)
 addI18nLib('es', 'errors', es)
 addI18nLib('de', 'errors', de)
+addI18nLib('fr', 'errors', fr)

package/src/resilient.ts

@@ -1,13 +1,92 @@
-import { RESILENT_ERROR, SEPARATOR } from './consts.js'
-import type { Converter, ResilientErrorConstructor } from './types.js'
+import { CATCH_ALL_CONVERTER, CONVERTER_REGISTRY, RESILENT_ERROR, RESILIENT_BRAND, SEPARATOR } from './consts.js'
+import type { Converter, MarshalErrorOptions, ResilientErrorConstructor } from './types.js'
 import { createErrorConverter } from './utils.js'
 
+type ConverterHolder = typeof globalThis & { [CONVERTER_REGISTRY]?: Converter[] }
+
+/**
+ * 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 = (): Converter[] => {
+  const holder = globalThis as ConverterHolder
+  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: unknown): string[] => {
+  const names: string[] = []
+  let current = ctor
+  while (typeof current === 'function') {
+    if (Object.prototype.hasOwnProperty.call(current, 'typeName')) {
+      const name = (current as { typeName?: unknown }).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: unknown): value is ResilientError => {
+  if (value == null || typeof value !== 'object') {
+    return false
+  }
+  const candidate = value as { [RESILIENT_BRAND]?: unknown, type?: unknown, marshal?: unknown }
+
+  return candidate[RESILIENT_BRAND] === true
+    && typeof candidate.type === 'string'
+    && typeof candidate.marshal === 'function'
+}
+
 export class ResilientError extends Error {
   public static separator: string = SEPARATOR
 
   public static typeName: string = RESILENT_ERROR
 
-  public static converters: Converter[] = []
+  public static converters: Converter[] = 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.
+   */
+  public static override [Symbol.hasInstance]<T extends abstract new (...args: any[]) => any>(
+    this: T, instance: unknown
+  ): instance is InstanceType<T> {
+    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)
+  }
 
   public static registerErrorClass(resilientErrorClass: ResilientErrorConstructor, errorClass?: ErrorConstructor): Converter {
     const converter = createErrorConverter(resilientErrorClass, errorClass)
@@ -18,7 +97,7 @@ export class ResilientError extends Error {
 
   public static ensure(err: Error | string, throwOnUnknown?: boolean): ResilientError {
     err = typeof err === 'string' ? new Error(err) : err
-    if (err instanceof ResilientError) {
+    if (isResilientError(err)) {
       return err
     }
 
@@ -46,18 +125,30 @@ export class ResilientError extends Error {
     return new ResilientError(this.typeName, err.message, err.stack)
   }
 
-  public static marshal(err: Error): Error {
-    if (err instanceof ResilientError) {
-      return new Error([err.type, err.message, err.oiriginalStack].join(this.separator))
+  public static marshal(err: Error, opts?: MarshalErrorOptions): Error {
+    const resilient = isResilientError(err)
+    const structuralType = (err as Error & { type?: unknown }).type
+    const type = resilient
+      ? err.type
+      : typeof structuralType === 'string' ? structuralType : this.typeName
+    const stack = opts?.includeStack === false
+      ? ''
+      : resilient ? err.oiriginalStack : err.stack
+    const fields: Array<string | undefined> = [type, err.message, stack]
+    if (opts?.incidentId != null) {
+      fields.push(opts.incidentId)
     }
 
-    return new Error([this.typeName, err.message, err.stack].join(this.separator))
+    return new Error(fields.join(this.separator))
   }
 
   public type: string = RESILENT_ERROR
 
   public oiriginalStack?: string
 
+  /** Correlates a serialized boundary error with the server log entry that owns its full stack. */
+  public incidentId?: string
+
   constructor(type: string, message: string, stack?: string) {
     super(message)
     this.type = type
@@ -68,14 +159,20 @@ export class ResilientError extends Error {
     }
   }
 
-  marshal(): Error {
-    return ResilientError.marshal(this)
+  marshal(opts?: MarshalErrorOptions): Error {
+    return ResilientError.marshal(this, opts)
   }
 
   finalizeUnmarshal(): void { }
 }
 
-ResilientError.converters.push({
-  ...createErrorConverter(ResilientError as ResilientErrorConstructor),
-  match: () => true
-})
+// 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 as { [CATCH_ALL_CONVERTER]?: unknown })[CATCH_ALL_CONVERTER] === true)) {
+  ResilientError.converters.push(Object.assign({
+    ...createErrorConverter(ResilientError as ResilientErrorConstructor),
+    match: () => true,
+  }, { [CATCH_ALL_CONVERTER]: true }))
+}

package/src/types.ts

@@ -2,6 +2,13 @@ import type { ResilientError } from './resilient.js'
 
 export type ValueOrError<T> = T | ResilientError
 
+export interface MarshalErrorOptions {
+  /** Defaults to true for backwards compatibility outside an HTTP boundary. */
+  includeStack?: boolean
+  /** Opaque correlation value appended as the fourth wire field. */
+  incidentId?: string
+}
+
 export interface Converter {
   match: (err: Error) => boolean
   convert: (err: Error) => ResilientError

package/src/utils.ts

@@ -19,17 +19,19 @@ export const unmarshal = <T extends ResilientError = ResilientError>(errorClass:
     if (err instanceof errorClass) {
       return err as T
     }
-    const args = err.message.split(ResilientError.separator, 3) as [string, string, string?]
-    if (args.length < 2) {
+    const fields = err.message.split(ResilientError.separator, 4)
+    if (fields.length < 2) {
       throw SyntaxError('Invalid marshaled error')
     }
-
-    if (args[0] === errorClass.typeName) {
-      args.shift()
-    }
-
-    const error = new errorClass(...args)
-    error.message = args[0]
+    const [type, message, stack, incidentId] = fields
+    // The base constructor takes (type, message, stack); subclasses take (message, stack).
+    // Keeping the base's wire type in place avoids shifting a plain Error's message into `type`.
+    const error = errorClass === ResilientError
+      ? new errorClass(type, message, stack)
+      : new errorClass(message, stack)
+    error.type = type
+    error.message = message
+    error.incidentId = incidentId
     error.finalizeUnmarshal()
     return error as T
   }

package/tests/copies.spec.ts

@@ -0,0 +1,138 @@
+import { afterAll, beforeAll, describe, expect, test } from 'bun:test'
+import { cpSync, mkdtempSync, rmSync, symlinkSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+
+type Lib = typeof import('../src/index.js')
+
+/**
+ * Two module instances of this package in one process — what `bun --preserve-symlinks` produces
+ * when a linked workspace reaches `@owlmeans/error` through two `node_modules` paths.
+ *
+ * The sources are copied to two directories, so every module of the package (not only the entry)
+ * is loaded twice. `@owlmeans/i18n` resolves through a `node_modules` link to the workspace root.
+ */
+const loadTwice = async (): Promise<{ root: string, a: Lib, b: Lib }> => {
+  const root = mkdtempSync(join(tmpdir(), 'owlmeans-error-copies-'))
+  const workspaceModules = resolve(import.meta.dir, '../../../node_modules')
+  for (const name of ['a', 'b']) {
+    cpSync(resolve(import.meta.dir, '../src'), join(root, name, 'src'), { recursive: true })
+    symlinkSync(workspaceModules, join(root, name, 'node_modules'))
+  }
+  const a = await import(join(root, 'a', 'src', 'index.ts')) as Lib
+  const b = await import(join(root, 'b', 'src', 'index.ts')) as Lib
+
+  return { root, a, b }
+}
+
+/** The same family declared by each copy, the way two copies of one package declare it. */
+const familyOf = (lib: Lib) => {
+  class CopyApiError extends lib.ResilientError {
+    public static override typeName = 'CopyTestApiError'
+
+    constructor(message: string = 'error') {
+      super(CopyApiError.typeName, `copy-api:${message}`)
+    }
+  }
+
+  class CopyAuthFailed extends CopyApiError {
+    public static override typeName = 'CopyTestAuthFailedError'
+
+    constructor(message: string = 'error') {
+      super(`auth:${message}`)
+      this.type = CopyAuthFailed.typeName
+    }
+  }
+
+  class CopyAccess extends CopyApiError {
+    public static override typeName = 'CopyTestAccessError'
+
+    constructor(message: string = 'error') {
+      super(`access:${message}`)
+      this.type = CopyAccess.typeName
+    }
+  }
+
+  lib.ResilientError.registerErrorClass(CopyApiError)
+  lib.ResilientError.registerErrorClass(CopyAuthFailed)
+  lib.ResilientError.registerErrorClass(CopyAccess)
+
+  return { CopyApiError, CopyAuthFailed, CopyAccess }
+}
+
+describe('duplicate module copies behave as one', () => {
+  let root = ''
+  let a: Lib
+  let b: Lib
+  let A: ReturnType<typeof familyOf>
+  let B: ReturnType<typeof familyOf>
+
+  beforeAll(async () => {
+    ({ root, a, b } = await loadTwice())
+    A = familyOf(a)
+    B = familyOf(b)
+  })
+
+  afterAll(() => {
+    if (root !== '') {
+      rmSync(root, { recursive: true, force: true })
+    }
+  })
+
+  test('the two copies are distinct module instances sharing one registry', () => {
+    expect(a.ResilientError).not.toBe(b.ResilientError)
+    expect(a.ResilientError.converters).toBe(b.ResilientError.converters)
+    const catchAll = Symbol.for('@owlmeans/error:catch-all')
+    expect(b.ResilientError.converters.filter(converter => (converter as any)[catchAll] === true)).toHaveLength(1)
+  })
+
+  test('an error thrown by copy A is ensured as-is and marshalled with its type by copy B', () => {
+    const thrown = new A.CopyAuthFailed('no-guard')
+
+    expect(b.ResilientError.ensure(thrown)).toBe(thrown)
+    expect(b.isResilientError(thrown)).toBe(true)
+    const wire = b.ResilientError.marshal(b.ResilientError.ensure(thrown)).message
+    expect(wire.split(b.SEPARATOR).slice(0, 2)).toEqual(['CopyTestAuthFailedError', 'copy-api:auth:no-guard'])
+
+    const rebuilt = b.ResilientError.ensure(wire)
+    // The last registration of the type name wins — copy B registered after copy A.
+    expect(rebuilt.constructor).toBe(B.CopyAuthFailed)
+    expect(rebuilt).toBeInstanceOf(A.CopyAuthFailed)
+    expect(rebuilt.type).toBe('CopyTestAuthFailedError')
+    expect(rebuilt.message).toBe('copy-api:auth:no-guard')
+  })
+
+  test('a class registered by one copy only is rebuilt by the other', () => {
+    class OnlyInA extends a.ResilientError {
+      public static override typeName = 'CopyTestOnlyInA'
+
+      constructor(message: string = 'error') {
+        super(OnlyInA.typeName, `only-a:${message}`)
+      }
+    }
+    a.ResilientError.registerErrorClass(OnlyInA)
+
+    const rebuilt = b.ResilientError.ensure(new OnlyInA('x').marshal().message)
+    expect(rebuilt).toBeInstanceOf(OnlyInA)
+    expect(rebuilt.message).toBe('only-a:x')
+  })
+
+  test('instanceof across copies matches the class and its ancestors, never a sibling or a parent', () => {
+    const thrown = new A.CopyAuthFailed('x')
+    expect(thrown instanceof B.CopyAuthFailed).toBe(true)
+    expect(thrown instanceof B.CopyApiError).toBe(true)
+    expect(thrown instanceof b.ResilientError).toBe(true)
+    expect(thrown instanceof B.CopyAccess).toBe(false)
+    expect(new A.CopyApiError('x') instanceof B.CopyAuthFailed).toBe(false)
+
+    // A subclass without a type name of its own is matched natively only.
+    class Unnamed extends B.CopyAuthFailed { }
+    expect(new A.CopyAuthFailed('x') instanceof Unnamed).toBe(false)
+    expect(new Unnamed('x') instanceof A.CopyAuthFailed).toBe(true)
+
+    // Shape alone is not a resilient error: the brand is.
+    const lookalike = Object.assign(new Error('x'), { type: 'CopyTestAuthFailedError', marshal: () => new Error('x') })
+    expect(lookalike instanceof b.ResilientError).toBe(false)
+    expect(b.ResilientError.ensure(lookalike)).not.toBe(lookalike)
+  })
+})

package/tests/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": [
+    "@owlmeans/dep-config/tsconfig.base.json",
+    "@owlmeans/dep-config/tsconfig.node.json"
+  ],
+  "compilerOptions": {
+    "types": [
+      "bun"
+    ],
+    "rootDir": "../",
+    "noEmit": true
+  },
+  "include": [
+    "./**/*",
+    "../src/**/*"
+  ]
+}