pipework 0.164.0 → 0.165.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.165.0
+
+- **Fixed: pipework errors are recognized across physical copies of the same version** (#703). When a workspace and a library it links each resolve their own copy of pipework, `instanceof` on any pipework error class (`QuotaExhaustedError`, `JobLaterError`, `JobPermanentError`, the HTTP error classes) now holds for the same error constructed by the other copy, keyed on the shared `Symbol.for('pipework.error')` brand and the class name in its prototype chain. A job that throws a `QuotaExhaustedError` from the library's copy is handed back to pending until `resetAt` with no attempt counted, instead of failing an attempt. Unbranded look-alikes are not matched.
+
 ## 0.164.0
 
 - **Added: outbound quota from a process outside the manifold** (#701). `quota.create({ reserve, connection: tap(url) })` takes, records and reads the shared budget over a standalone `tap()` connection, with no manifold and no request, job or `flow.run` context, so a plain Node worker spends the same `outbound_quota` budget as the pipework app (which must have migrated the table with blueprint `quota: {}`). A refusal throws `QuotaExhaustedError` (with `resetAt`) to the caller. The caller owns the connection's lifecycle. Passing both `connection` and `database` throws.

package/dist/core/errors/base.d.ts

@@ -3,6 +3,7 @@ export declare abstract class PipeworkError extends Error {
     abstract readonly httpStatus: number;
     readonly details: Record<string, unknown>;
     constructor(message: string, details?: Record<string, unknown>);
+    static [Symbol.hasInstance](value: unknown): boolean;
 }
 /**
  * True for any PipeworkError, including one thrown across a module-realm boundary

package/dist/core/errors/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":"AASA,8BAAsB,aAAc,SAAQ,KAAK;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":"AASA,8BAAsB,aAAc,SAAQ,KAAK;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;WASlD,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAS9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE"}

package/dist/core/errors/base.js

@@ -14,6 +14,21 @@ export class PipeworkError extends Error {
         this.details = details;
         Object.defineProperty(this, PIPEWORK_ERROR, { value: true, enumerable: false });
     }
+    // The brand is the identity across physical copies of pipework: a branded error is an
+    // instance of the class its prototype chain names, whichever copy constructed it.
+    static [Symbol.hasInstance](value) {
+        if (Function.prototype[Symbol.hasInstance].call(this, value))
+            return true;
+        if (!isPipeworkError(value))
+            return false;
+        if (this === PipeworkError)
+            return true;
+        for (let proto = Object.getPrototypeOf(value); proto !== null; proto = Object.getPrototypeOf(proto)) {
+            if (proto.constructor?.name === this.name)
+                return true;
+        }
+        return false;
+    }
 }
 /**
  * True for any PipeworkError, including one thrown across a module-realm boundary

package/dist/core/errors/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,mFAAmF;AACnF,qFAAqF;AACrF,+DAA+D;AAC/D,sGAAsG;AACtG,+FAA+F;AAC/F,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;AAEnD,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAGtC,OAAO,CAAyB;IAEzC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IACjF,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,cAAc,CAAC,KAAK,IAAI;QAC3D,OAAQ,KAAkC,CAAC,UAAU,KAAK,QAAQ;QAClE,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAA;AACH,CAAC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/core/errors/base.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,mFAAmF;AACnF,qFAAqF;AACrF,+DAA+D;AAC/D,sGAAsG;AACtG,+FAA+F;AAC/F,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;AAEnD,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAGtC,OAAO,CAAyB;IAEzC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IACjF,CAAC;IAED,sFAAsF;IACtF,kFAAkF;IAClF,MAAM,CAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAc;QACjD,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACzE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QACzC,IAAI,IAAI,KAAK,aAAa;YAAE,OAAO,IAAI,CAAA;QACvC,KAAK,IAAI,KAAK,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7G,IAAK,KAA8C,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAA;QAClG,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,cAAc,CAAC,KAAK,IAAI;QAC3D,OAAQ,KAAkC,CAAC,UAAU,KAAK,QAAQ;QAClE,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pipework",
-  "version": "0.164.0",
+  "version": "0.165.0",
   "description": "TypeScript framework for multi-tenant SaaS applications. PostgreSQL-only.",
   "type": "module",
   "license": "MIT",