@venizia/ignis 0.1.1-8 → 0.1.1

package/dist/base/datasources/abstract.js.map

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

package/dist/base/datasources/common/types.d.ts

@@ -2,6 +2,8 @@ import type { AnyType, IConfigurable, TClass, TConstValue } from '@venizia/ignis
 export declare class DataSourceDrivers {
     static readonly NODE_POSTGRES = "node-postgres";
     static readonly POSTGRES_JS = "postgres-js";
+    static readonly PGLITE = "pglite";
+    static readonly LIBSQL = "libsql";
     static readonly TYPESENSE = "typesense";
     static readonly MEILISEARCH = "meilisearch";
     static readonly RELATIONAL_SCHEME_SET: Set<string>;
@@ -10,9 +12,11 @@ export declare class DataSourceDrivers {
     static isValid(value: string): boolean;
 }
 export type TDataSourceDriver = TConstValue<typeof DataSourceDrivers> | (string & {});
-/** A driver CLASS, named by `@datasource({ driver })` - the class reference is what carries the
- * peer package into the bundle (a name string carries nothing, and a bare side-effect import may be
- * deleted by a bundler). Untyped: `IRelationalDriver` lives under `connectors/`, off-limits to `base/`. */
+/**
+ * A driver CLASS, named by `@datasource({ driver })`. The class reference is what pulls the peer
+ * package into a bundle - a name string pulls nothing, and a bare side-effect import may be
+ * dropped. Untyped because `IRelationalDriver` lives under `connectors/`, off-limits to `base/`.
+ */
 export type TDataSourceDriverClass = TClass<AnyType>;
 export type TAnyDataSourceSchema = Record<string, any>;
 /** Engine-neutral datasource contract - the root every connector family implements. */
@@ -23,8 +27,10 @@ export interface IDataSource<Settings extends object = {}, Schema extends TAnyDa
     getSettings(): Settings;
     getSchema(): Schema;
 }
-/** Neutral transaction options. Isolation levels are engine vocabulary, so `isolationLevel` stays a
- * loose string here; connectors narrow it in their own `ITransactionOptions` extension. */
+/**
+ * Neutral transaction options - isolation levels are engine vocabulary, so `isolationLevel` stays
+ * a loose string here and connectors narrow it in their own `ITransactionOptions` extension.
+ */
 export interface ITransactionOptions {
     isolationLevel?: string;
 }

package/dist/base/datasources/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1F,qBAAa,iBAAiB;IAE5B,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAG5C,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,qBAAqB,cAAmD;IACxF,MAAM,CAAC,QAAQ,CAAC,iBAAiB,cAA+C;IAEhF,MAAM,CAAC,QAAQ,CAAC,UAAU,cAQvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAID,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtF;;2GAE2G;AAC3G,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,IAAI,QAAQ,CAAC;IACxB,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;2FAC2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iCAAkC,SAAQ,uBAAuB;IAChF,MAAM,CAAC,EAAE;QACP,0DAA0D;QAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;QAEjB,qDAAqD;QACrD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,uDAAuD;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,0CAA0C;QAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1F,qBAAa,iBAAiB;IAE5B,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAGlC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,qBAAqB,cAKlC;IACH,MAAM,CAAC,QAAQ,CAAC,iBAAiB,cAA+C;IAEhF,MAAM,CAAC,QAAQ,CAAC,UAAU,cAUvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAID,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,IAAI,QAAQ,CAAC;IACxB,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iCAAkC,SAAQ,uBAAuB;IAChF,MAAM,CAAC,EAAE;QACP,0DAA0D;QAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;QAEjB,qDAAqD;QACrD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,uDAAuD;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,0CAA0C;QAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH"}

package/dist/base/datasources/common/types.js

@@ -2,18 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourceDrivers = void 0;
 class DataSourceDrivers {
-    // Relational
+    // Relational - PGlite is a Postgres DRIVER (Postgres compiled to WASM), not a separate engine.
     static { this.NODE_POSTGRES = 'node-postgres'; }
     static { this.POSTGRES_JS = 'postgres-js'; }
+    static { this.PGLITE = 'pglite'; }
+    static { this.LIBSQL = 'libsql'; }
     // Search
     static { this.TYPESENSE = 'typesense'; }
     static { this.MEILISEARCH = 'meilisearch'; }
-    static { this.RELATIONAL_SCHEME_SET = new Set([this.NODE_POSTGRES, this.POSTGRES_JS]); }
+    static { this.RELATIONAL_SCHEME_SET = new Set([
+        this.NODE_POSTGRES,
+        this.POSTGRES_JS,
+        this.PGLITE,
+        this.LIBSQL,
+    ]); }
     static { this.SEARCH_SCHEME_SET = new Set([this.TYPESENSE, this.MEILISEARCH]); }
     static { this.SCHEME_SET = new Set([
         // Relational
         this.NODE_POSTGRES,
         this.POSTGRES_JS,
+        this.PGLITE,
+        this.LIBSQL,
         // Search
         this.TYPESENSE,
         this.MEILISEARCH,

package/dist/base/datasources/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAC5B,aAAa;aACG,kBAAa,GAAG,eAAe,CAAC;aAChC,gBAAW,GAAG,aAAa,CAAC;IAE5C,SAAS;aACO,cAAS,GAAG,WAAW,CAAC;aACxB,gBAAW,GAAG,aAAa,CAAC;aAE5B,0BAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;aACxE,sBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;aAEhE,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,aAAa;QACb,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,WAAW;QAEhB,SAAS;QACT,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,WAAW;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAxBH,8CAyBC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAC5B,+FAA+F;aAC/E,kBAAa,GAAG,eAAe,CAAC;aAChC,gBAAW,GAAG,aAAa,CAAC;aAC5B,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;IAElC,SAAS;aACO,cAAS,GAAG,WAAW,CAAC;aACxB,gBAAW,GAAG,aAAa,CAAC;aAE5B,0BAAqB,GAAG,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;KACZ,CAAC,CAAC;aACa,sBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;aAEhE,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,aAAa;QACb,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QAEX,SAAS;QACT,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,WAAW;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAjCH,8CAkCC"}

package/dist/base/metadata/persistents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACd,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cAiBhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAI3D,CAAC;AAwIF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAC/C,cAcF,CAAC"}
+{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACd,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cA0BhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAI3D,CAAC;AAgJF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAC/C,cAaF,CAAC"}

package/dist/base/metadata/persistents.js

@@ -14,6 +14,14 @@ const model = (metadata) => {
                 message: `[model][${target.name}] Invalid 'defaultLimit' | Expected a positive integer | Got: ${defaultLimit}`,
             });
         }
+        // Validated at DECORATION time, like defaultLimit: a bad ceiling is a wiring mistake, and
+        // catching it at boot beats catching it on the one request that happens to reach the limit.
+        const maxLimit = metadata.settings?.maxLimit;
+        if (maxLimit !== undefined && (!Number.isInteger(maxLimit) || maxLimit <= 0)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[model][${target.name}] Invalid 'maxLimit' | Expected a positive integer | Got: ${maxLimit}`,
+            });
+        }
         // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set
         const principal = metadata.settings?.authorize?.principal;
         if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {
@@ -44,32 +52,34 @@ const validateRepositoryMetadata = (opts) => {
         });
     }
 };
+/** Asserts the constructor's first parameter is an AbstractDataSource compatible with what @repository declared. */
+const validateFirstConstructorParameter = (opts) => {
+    const { target, firstParamType, resolvedDataSource } = opts;
+    const isDataSourceType = firstParamType === datasources_1.AbstractDataSource || firstParamType.prototype instanceof datasources_1.AbstractDataSource;
+    if (!isDataSourceType) {
+        throw (0, ignis_helpers_1.getError)({
+            message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,
+        });
+    }
+    if (typeof resolvedDataSource !== 'function') {
+        return;
+    }
+    const isCompatible = firstParamType === resolvedDataSource || resolvedDataSource.prototype instanceof firstParamType;
+    if (!isCompatible) {
+        throw (0, ignis_helpers_1.getError)({
+            message: `[@repository][${target.name}] Invalid constructor | Type mismatch | Constructor expects '${firstParamType.name}' but @repository specifies '${resolvedDataSource.name}'`,
+        });
+    }
+};
 /** Auto-injects dataSource at constructor param[0] unless explicit @inject exists. */
 const registerDataSourceInjection = (opts) => {
     const { target, registry, resolvedDataSource } = opts;
     const paramTypes = Reflect.getMetadata('design:paramtypes', target);
     const firstParamType = paramTypes?.[0];
     if (firstParamType) {
-        const isDataSourceType = firstParamType === datasources_1.AbstractDataSource ||
-            firstParamType.prototype instanceof datasources_1.AbstractDataSource;
-        if (!isDataSourceType) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,
-            });
-        }
-        if (typeof resolvedDataSource === 'function') {
-            const isCompatible = firstParamType === resolvedDataSource ||
-                resolvedDataSource.prototype instanceof firstParamType;
-            if (!isCompatible) {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[@repository][${target.name}] Invalid constructor | Type mismatch | Constructor expects '${firstParamType.name}' but @repository specifies '${resolvedDataSource.name}'`,
-                });
-            }
-        }
+        validateFirstConstructorParameter({ target, firstParamType, resolvedDataSource });
     }
-    // Own metadata only: `getInjectMetadata` walks the prototype chain, so a repository extending
-    // another @repository class would see the BASE class's injection at param[0], skip its own
-    // auto-injection, and silently resolve the base's dataSource.
+    // Own metadata only: `getInjectMetadata` walks the prototype chain, so a repository extending another @repository class would see the BASE's injection at param[0] and silently resolve the base's dataSource.
     const ownInjects = Reflect.getOwnMetadata(inversion_1.MetadataKeys.INJECT, target);
     const injectAtIndex0 = ownInjects?.find(entry => entry?.index === 0);
     if (injectAtIndex0) {
@@ -84,8 +94,7 @@ const registerDataSourceInjection = (opts) => {
     }
     const dsName = typeof resolvedDataSource === 'string' ? resolvedDataSource : resolvedDataSource.name;
     const dsBindingKey = inversion_1.BindingKeys.build({ namespace: bindings_1.BindingNamespaces.DATASOURCE, key: dsName });
-    // Copy-on-write for the same reason: setInjectMetadata mutates the array it reads through the
-    // prototype chain, which would rewrite the base repository's param[0] with this class's key.
+    // Copy-on-write for the same reason: setInjectMetadata mutates the array it reads through the prototype chain, which would rewrite the base repository's param[0] with this class's key.
     if (!ownInjects) {
         const inheritedInjects = registry.getInjectMetadata({ target });
         Reflect.defineMetadata(inversion_1.MetadataKeys.INJECT, [...(inheritedInjects ?? [])], target);
@@ -122,8 +131,7 @@ const repository = (metadata) => {
     return target => {
         const registry = inversion_1.MetadataRegistry.getInstance();
         const resolved = resolveRepositoryMetadata({ metadata, target, registry });
-        // `_resolved` is an internal cache field, not part of the public IRepositoryMetadata surface
-        // callers author - it's added here, so the merged literal needs the widened local type.
+        // `_resolved` is an internal cache field, not part of the public IRepositoryMetadata surface callers author - it is added here, so the merged literal needs the widened local type.
         registry.setRepositoryMetadata({
             target,
             metadata: { ...metadata, _resolved: resolved },

package/dist/base/metadata/persistents.js.map

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

package/dist/base/metadata/routes/common.d.ts

@@ -1,7 +1,4 @@
-/** Route/rpc decorators are legacy (`experimentalDecorators`) decorators: a TC39-semantics runtime
- * calls them `(method, context)` - no prototype to attach metadata to, so the route silently 404s.
- * True for the legacy call shape; otherwise records the drop for {@link reportDroppedRouteDecorators},
- * which runs at configure() time - importing a module must stay free of side effects. */
+/** True for the legacy (`experimentalDecorators`) call shape - under TC39 semantics decorators get `(method, context)` with no prototype to attach metadata to, so the route silently 404s; the drop is recorded instead for {@link reportDroppedRouteDecorators} to report at configure() time, since importing a module must stay free of side effects. */
 export declare const isLegacyMethodDecoratorCall: (opts: {
     decorator: string;
     propertyKey: unknown;

package/dist/base/metadata/routes/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":"AAGA;;;yFAGyF;AACzF,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,KAAG,IAAI,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAU5D,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE,CAAC;CACtE,KAAG,IAWH,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,QAAO,KAAK,CAAC,MAAM,CAExD,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":"AAGA,6VAA6V;AAC7V,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,KAAG,IAAI,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAU5D,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE,CAAC;CACtE,KAAG,IAWH,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,QAAO,KAAK,CAAC,MAAM,CAExD,CAAC"}

package/dist/base/metadata/routes/common.js

@@ -3,10 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDroppedRouteDecorators = exports.reportDroppedRouteDecorators = exports.isLegacyMethodDecoratorCall = void 0;
 const droppedRouteDecorators = [];
 let isReported = false;
-/** Route/rpc decorators are legacy (`experimentalDecorators`) decorators: a TC39-semantics runtime
- * calls them `(method, context)` - no prototype to attach metadata to, so the route silently 404s.
- * True for the legacy call shape; otherwise records the drop for {@link reportDroppedRouteDecorators},
- * which runs at configure() time - importing a module must stay free of side effects. */
+/** True for the legacy (`experimentalDecorators`) call shape - under TC39 semantics decorators get `(method, context)` with no prototype to attach metadata to, so the route silently 404s; the drop is recorded instead for {@link reportDroppedRouteDecorators} to report at configure() time, since importing a module must stay free of side effects. */
 const isLegacyMethodDecoratorCall = (opts) => {
     const { decorator, propertyKey } = opts;
     if (typeof propertyKey === 'string' || typeof propertyKey === 'symbol') {

package/dist/base/metadata/routes/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":";;;AAAA,MAAM,sBAAsB,GAAkB,EAAE,CAAC;AACjD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;yFAGyF;AAClF,MAAM,2BAA2B,GAAG,CAAC,IAG3C,EAA+D,EAAE;IAChE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAExC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAI,WAAiC,EAAE,IAAI,IAAI,SAAS,CAAC;IACzE,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAbW,QAAA,2BAA2B,+BAatC;AAEF,mFAAmF;AAC5E,MAAM,4BAA4B,GAAG,CAAC,IAE5C,EAAQ,EAAE;IACT,IAAI,UAAU,IAAI,sBAAsB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO;IACT,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,8SAA8S,EAC9S,sBAAsB,CAAC,MAAM,EAC7B,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,4BAA4B,gCAavC;AAEF,qFAAqF;AAC9E,MAAM,yBAAyB,GAAG,GAAkB,EAAE;IAC3D,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC;AACrC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/base/metadata/routes/common.ts"],"names":[],"mappings":";;;AAAA,MAAM,sBAAsB,GAAkB,EAAE,CAAC;AACjD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,6VAA6V;AACtV,MAAM,2BAA2B,GAAG,CAAC,IAG3C,EAA+D,EAAE;IAChE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAExC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAI,WAAiC,EAAE,IAAI,IAAI,SAAS,CAAC;IACzE,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAbW,QAAA,2BAA2B,+BAatC;AAEF,mFAAmF;AAC5E,MAAM,4BAA4B,GAAG,CAAC,IAE5C,EAAQ,EAAE;IACT,IAAI,UAAU,IAAI,sBAAsB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO;IACT,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,8SAA8S,EAC9S,sBAAsB,CAAC,MAAM,EAC7B,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,4BAA4B,gCAavC;AAEF,qFAAqF;AAC9E,MAAM,yBAAyB,GAAG,GAAkB,EAAE;IAC3D,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC;AACrC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}

package/dist/base/middlewares/app-error/app-error.middleware.d.ts

@@ -2,14 +2,16 @@ import type { ILogger } from '@venizia/ignis-helpers';
 import { BaseHelper } from '@venizia/ignis-helpers';
 import type { IProvider } from '@venizia/ignis-inversion';
 import type { ErrorHandler } from 'hono/types';
-/** Application error handler (Hono `onError`): ZodError -> 422; DB client error (class 22/23/44) ->
- * 400; transient DB conflict (40001/40P01) -> 409; intentional `getError` -> its own status/message;
- * anything else -> 500 (generic message in production). */
+/** Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` -> its own status, else 500. */
 export declare class AppErrorMiddleware extends BaseHelper implements IProvider<ErrorHandler> {
     private rootKey;
+    private intentionalStackFrames;
+    private unexpectedStackFrames;
     constructor(opts?: {
         logger?: ILogger;
         rootKey?: string;
+        intentionalStackFrames?: number;
+        unexpectedStackFrames?: number;
     });
     private withRootKey;
     /** Fail-closed: an unset or unrecognized env is production. */
@@ -18,6 +20,10 @@ export declare class AppErrorMiddleware extends BaseHelper implements IProvider<
     /** An ApplicationError's `normalized` is authoritative - a `transform` may have reworded `text`. */
     private build;
     private resolve;
+    /** A throw site may set `logLevel` via `getError`; anything unset or malformed logs at `error`. */
+    private resolveLogLevel;
+    /** The one place a thrown error reaches the log - called once the status is known, so it carries it. */
+    private logError;
     value(): ErrorHandler;
 }
 //# sourceMappingURL=app-error.middleware.d.ts.map

package/dist/base/middlewares/app-error/app-error.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.middleware.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAkC,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAgBlE;;2DAE2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAW,YAAW,SAAS,CAAC,YAAY,CAAC;IACnF,OAAO,CAAC,OAAO,CAAoB;gBAEvB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAUzD,OAAO,CAAC,WAAW;IAInB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,QAAQ;IAkBhB,oGAAoG;IACpG,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,OAAO;IA0Cf,KAAK,IAAI,YAAY;CAiDtB"}
+{"version":3,"file":"app-error.middleware.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAwB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACL,UAAU,EAMX,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAoBlE,kIAAkI;AAClI,qBAAa,kBAAmB,SAAQ,UAAW,YAAW,SAAS,CAAC,YAAY,CAAC;IACnF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC;IAYD,OAAO,CAAC,WAAW;IAInB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,QAAQ;IAkBhB,oGAAoG;IACpG,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,OAAO;IA+Cf,mGAAmG;IACnG,OAAO,CAAC,eAAe;IAUvB,wGAAwG;IACxG,OAAO,CAAC,QAAQ;IAgChB,KAAK,IAAI,YAAY;CAiDtB"}

package/dist/base/middlewares/app-error/app-error.middleware.js

@@ -7,13 +7,16 @@ const database_handler_1 = require("./database.handler");
 const definition_1 = require("./definition");
 const zod_handler_1 = require("./zod.handler");
 const DEFAULT_INTERNAL_ERROR_MESSAGE = 'Internal Server Error';
-/** Application error handler (Hono `onError`): ZodError -> 422; DB client error (class 22/23/44) ->
- * 400; transient DB conflict (40001/40P01) -> 409; intentional `getError` -> its own status/message;
- * anything else -> 500 (generic message in production). */
+/** An intentional error's throw site is still worth naming; its caller chain is framework plumbing, so it gets a smaller budget than an unexpected one. */
+const DEFAULT_INTENTIONAL_STACK_FRAMES = 5;
+const DEFAULT_UNEXPECTED_STACK_FRAMES = 10;
+/** Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` -> its own status, else 500. */
 class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
     constructor(opts) {
         super({ scope: AppErrorMiddleware.name });
         this.rootKey = opts?.rootKey;
+        this.intentionalStackFrames = opts?.intentionalStackFrames ?? DEFAULT_INTENTIONAL_STACK_FRAMES;
+        this.unexpectedStackFrames = opts?.unexpectedStackFrames ?? DEFAULT_UNEXPECTED_STACK_FRAMES;
         if (opts?.logger) {
             this.logger = opts.logger;
         }
@@ -26,7 +29,7 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
         const { context, error, requestId } = opts;
         const env = [context.env?.NODE_ENV, process.env.NODE_ENV].find(Boolean);
         if (!env) {
-            this.logger.error('[%s] INVALID ENV IDENTIFIER | env: %s | path: %s | method: %s | url: %s | Error: %s', requestId, env, context.req.path, context.req.method, context.req.url, error);
+            this.logger.error('[%s] INVALID ENV IDENTIFIER | env: %s | path: %s | method: %s | url: %s\n%s', requestId, env, context.req.path, context.req.method, context.req.url, ignis_helpers_1.ErrorPrettier.format({ error }));
             return true;
         }
         return !ignis_helpers_1.Environment.DEVELOPMENT_ENVS.has(env.toLowerCase());
@@ -46,22 +49,24 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
     }
     /** An ApplicationError's `normalized` is authoritative - a `transform` may have reworded `text`. */
     build(opts) {
-        const { error, statusCode, message, messageCode } = opts;
+        const { error, statusCode, message, type, messageCode } = opts;
         // Fallback for a FOREIGN error that sets its own code; an ApplicationError reports via `normalized`.
         const code = messageCode ??
             ignis_helpers_1.MessageCode.resolve('messageCode' in error ? error.messageCode : undefined);
         const normalized = 'normalized' in error
             ? error.normalized
             : { text: message, code, args: {} };
-        return { statusCode, message, normalized };
+        return { statusCode, message, normalized, type };
     }
     resolve(opts) {
         const { error, isProduction } = opts;
         const dbError = (0, database_handler_1.isDatabaseClientError)({ error, isProduction });
-        switch (this.classify({ error, dbError })) {
+        const type = this.classify({ error, dbError });
+        switch (type) {
             case definition_1.ApplicationErrorTypes.DATABASE_CLIENT: {
                 return this.build({
                     error,
+                    type,
                     statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.BadRequest,
                     // The fallback is unreachable today; it keeps the driver's raw text from ever surfacing.
                     message: dbError.message ?? DEFAULT_INTERNAL_ERROR_MESSAGE,
@@ -70,6 +75,7 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
             case definition_1.ApplicationErrorTypes.DATABASE_RETRYABLE: {
                 return this.build({
                     error,
+                    type,
                     statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.Conflict,
                     message: definition_1.DATABASE_RETRYABLE_ERROR_MESSAGE,
                     messageCode: definition_1.DATABASE_RETRYABLE_ERROR_CODE,
@@ -78,6 +84,7 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
             case definition_1.ApplicationErrorTypes.INTENTIONAL: {
                 return this.build({
                     error,
+                    type,
                     statusCode: error.statusCode,
                     message: error.message,
                 });
@@ -85,6 +92,7 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
             default: {
                 return this.build({
                     error,
+                    type: definition_1.ApplicationErrorTypes.UNEXPECTED,
                     statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_5.InternalServerError,
                     // Never leak a raw message - it may carry SQL, schema names or connection details.
                     message: isProduction ? DEFAULT_INTERNAL_ERROR_MESSAGE : error.message,
@@ -92,10 +100,32 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
             }
         }
     }
+    /** A throw site may set `logLevel` via `getError`; anything unset or malformed logs at `error`. */
+    resolveLogLevel(opts) {
+        const candidate = opts.error.logLevel;
+        if (typeof candidate === 'string' && ignis_helpers_1.LogLevels.isValid(candidate)) {
+            return candidate;
+        }
+        return ignis_helpers_1.LogLevels.ERROR;
+    }
+    /** The one place a thrown error reaches the log - called once the status is known, so it carries it. */
+    logError(opts) {
+        const { error, context, requestId, statusCode, messageCode, type } = opts;
+        this.logger.log(this.resolveLogLevel({ error }), '[%s] REQUEST ERROR | %s | %s %s\n%s', requestId, statusCode, context.req.method, context.req.url, ignis_helpers_1.ErrorPrettier.format({
+            error,
+            // The default code means "no code" - logging it on every error would be a noise line.
+            messageCode: messageCode === ignis_helpers_1.MessageCode.DEFAULT ? undefined : messageCode,
+            extra: 'extra' in error ? error.extra : undefined,
+            includeStack: true,
+            // An intentional error still needs its throw site; it just does not need the caller chain behind it.
+            maxStackFrames: type === definition_1.ApplicationErrorTypes.UNEXPECTED
+                ? this.unexpectedStackFrames
+                : this.intentionalStackFrames,
+        }));
+    }
     value() {
         return async (error, context) => {
             const requestId = context.get(request_spy_1.RequestSpyMiddleware.REQUEST_ID_KEY);
-            this.logger.error('[%s] REQUEST ERROR | path: %s | method: %s | url: %s | Error: %s', requestId, context.req.path, context.req.method, context.req.url, error);
             const isProduction = this.isProduction({ context, error, requestId });
             if (error.name === 'ZodError') {
                 const rs = (0, zod_handler_1.formatZodError)({
@@ -105,9 +135,17 @@ class AppErrorMiddleware extends ignis_helpers_1.BaseHelper {
                     path: context.req.path,
                     error,
                 });
+                this.logError({
+                    error,
+                    context,
+                    requestId,
+                    statusCode: rs.statusCode,
+                    messageCode: rs.response.normalized.code,
+                });
                 return context.json(this.withRootKey(rs.response), rs.statusCode);
             }
-            const { statusCode, message, normalized } = this.resolve({ error, isProduction });
+            const { statusCode, message, normalized, type } = this.resolve({ error, isProduction });
+            this.logError({ error, context, requestId, statusCode, messageCode: normalized.code, type });
             const rs = {
                 message,
                 statusCode,

package/dist/base/middlewares/app-error/app-error.middleware.js.map

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

package/dist/base/middlewares/app-error/database.handler.d.ts

@@ -1,6 +1,4 @@
-/** True for a database error caused by the request (SQLSTATE class 22/23/44) -> HTTP 400. In
- * production the detail/table/constraint context is suppressed so no row values or schema internals
- * leak; in non-production it is appended to aid debugging. */
+/** True for a database error caused by the request (SQLSTATE class 22/23/44) -> HTTP 400; in production the detail/table/constraint context is suppressed so no row values or schema internals leak. */
 export declare const isDatabaseClientError: (opts: {
     error: Error;
     isProduction: boolean;
@@ -8,10 +6,7 @@ export declare const isDatabaseClientError: (opts: {
     isClientError: boolean;
     message?: string;
 };
-/**
- * Checks if error is a transient, retryable DB transaction conflict (serialization failure /
- * deadlock — SQLSTATE 40001 / 40P01). These map to HTTP 409: the client can retry the same request.
- */
+/** True for a transient, retryable transaction conflict (serialization failure / deadlock - SQLSTATE 40001 / 40P01) -> HTTP 409: the client can retry the same request. */
 export declare const isRetryableDatabaseError: (opts: {
     error: Error;
 }) => boolean;

package/dist/base/middlewares/app-error/database.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.handler.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/database.handler.ts"],"names":[],"mappings":"AAQA;;8DAE8D;AAC9D,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB,KAAG;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAwC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,KAAG,OAIjE,CAAC"}
+{"version":3,"file":"database.handler.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/database.handler.ts"],"names":[],"mappings":"AAQA,wMAAwM;AACxM,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB,KAAG;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAqC7C,CAAC;AAEF,2KAA2K;AAC3K,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,KAAG,OAIjE,CAAC"}

package/dist/base/middlewares/app-error/database.handler.js

@@ -2,23 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isRetryableDatabaseError = exports.isDatabaseClientError = void 0;
 const definition_1 = require("./definition");
-/** True for a database error caused by the request (SQLSTATE class 22/23/44) -> HTTP 400. In
- * production the detail/table/constraint context is suppressed so no row values or schema internals
- * leak; in non-production it is appended to aid debugging. */
+/** True for a database error caused by the request (SQLSTATE class 22/23/44) -> HTTP 400; in production the detail/table/constraint context is suppressed so no row values or schema internals leak. */
 const isDatabaseClientError = (opts) => {
     const { error, isProduction } = opts;
     const dbError = error;
     const cause = dbError.cause;
     const code = [dbError.code, cause?.code].find(Boolean);
-    // Only request-caused SQLSTATE classes are client errors; anything else stays 500. A missing or
-    // non-string code (e.g. a gRPC numeric code) is non-client and must never crash this
-    // last-resort handler.
+    // Only request-caused SQLSTATE classes are client errors; a missing or non-string code (e.g. a gRPC numeric one) is non-client and must never crash this last-resort handler.
     if (typeof code !== 'string' || !definition_1.POSTGRES_CLIENT_ERROR_CLASSES.includes(code.slice(0, 2))) {
         return { isClientError: false };
     }
     const baseMessage = definition_1.DATABASE_CLIENT_ERROR_MESSAGES[code] ?? definition_1.DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE;
-    // In production, expose ONLY the generic base message. `detail` can echo row values
-    // (e.g. "Key (email)=(a@b.com) already exists") and `table`/`constraint` reveal schema internals.
+    // In production expose ONLY the generic base message: `detail` can echo row values and `table`/`constraint` reveal schema internals.
     if (isProduction) {
         return { isClientError: true, message: baseMessage };
     }
@@ -39,10 +34,7 @@ const isDatabaseClientError = (opts) => {
     };
 };
 exports.isDatabaseClientError = isDatabaseClientError;
-/**
- * Checks if error is a transient, retryable DB transaction conflict (serialization failure /
- * deadlock — SQLSTATE 40001 / 40P01). These map to HTTP 409: the client can retry the same request.
- */
+/** True for a transient, retryable transaction conflict (serialization failure / deadlock - SQLSTATE 40001 / 40P01) -> HTTP 409: the client can retry the same request. */
 const isRetryableDatabaseError = (opts) => {
     const dbError = opts.error;
     const code = [dbError.code, dbError.cause?.code].find(Boolean);

package/dist/base/middlewares/app-error/database.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.handler.js","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/database.handler.ts"],"names":[],"mappings":";;;AAAA,6CAKsB;AAGtB;;8DAE8D;AACvD,MAAM,qBAAqB,GAAG,CAAC,IAGrC,EAAgD,EAAE;IACjD,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,KAAuB,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,gGAAgG;IAChG,qFAAqF;IACrF,uBAAuB;IACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,0CAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GACf,2CAA8B,CAAC,IAAI,CAAC,IAAI,mDAAsC,CAAC;IAEjF,oFAAoF;IACpF,kGAAkG;IAClG,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvD,CAAC;IAED,mEAAmE;IACnE,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,EAAE,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1B,CAAC;AACJ,CAAC,CAAC;AA3CW,QAAA,qBAAqB,yBA2ChC;AAEF;;;GAGG;AACI,MAAM,wBAAwB,GAAG,CAAC,IAAsB,EAAW,EAAE;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAuB,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,2CAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC,CAAC;AAJW,QAAA,wBAAwB,4BAInC"}
+{"version":3,"file":"database.handler.js","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/database.handler.ts"],"names":[],"mappings":";;;AAAA,6CAKsB;AAGtB,wMAAwM;AACjM,MAAM,qBAAqB,GAAG,CAAC,IAGrC,EAAgD,EAAE;IACjD,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,KAAuB,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,8KAA8K;IAC9K,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,0CAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GACf,2CAA8B,CAAC,IAAI,CAAC,IAAI,mDAAsC,CAAC;IAEjF,qIAAqI;IACrI,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvD,CAAC;IAED,mEAAmE;IACnE,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,EAAE,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1B,CAAC;AACJ,CAAC,CAAC;AAxCW,QAAA,qBAAqB,yBAwChC;AAEF,2KAA2K;AACpK,MAAM,wBAAwB,GAAG,CAAC,IAAsB,EAAW,EAAE;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAuB,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,2CAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC,CAAC;AAJW,QAAA,wBAAwB,4BAInC"}

package/dist/base/middlewares/app-error/definition.d.ts

@@ -1,6 +1,4 @@
-/** PostgreSQL SQLSTATE codes that represent a CLIENT error (HTTP 400) - caused by the request/data,
- * not a server fault. Grouped by SQLSTATE class.
- * @see https://www.postgresql.org/docs/current/errcodes-appendix.html */
+/** PostgreSQL SQLSTATE codes representing a CLIENT error (HTTP 400) - caused by the request/data, not a server fault. @see https://www.postgresql.org/docs/current/errcodes-appendix.html */
 export declare const PostgresErrorCodes: {
     readonly DATA_EXCEPTION: "22000";
     readonly STRING_DATA_TOO_LONG: "22001";
@@ -29,16 +27,13 @@ export declare const PostgresErrorCodes: {
     readonly EXCLUSION_VIOLATION: "23P01";
     readonly WITH_CHECK_OPTION_VIOLATION: "44000";
 };
-/** SQLSTATE classes (first two chars) mapped to HTTP 400; codes without a specific message use
- * {@link DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE}. Deliberately excluded (stay 500): classes 42, 53,
- * 0A, 25, 28, 21, 54. Class 40 (serialization/deadlock) is transient/retryable, NOT a 400. */
+/** SQLSTATE classes (first two chars) mapped to HTTP 400; codes without a specific message use {@link DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE}. Deliberately excluded (stay 500): 42, 53, 0A, 25, 28, 21, 54; class 40 is transient/retryable, NOT a 400. */
 export declare const POSTGRES_CLIENT_ERROR_CLASSES: readonly string[];
 /** Human-readable message per specific SQLSTATE code. */
 export declare const DATABASE_CLIENT_ERROR_MESSAGES: Record<string, string>;
 /** Fallback message for a client-class (22/23/44) error that has no specific message above. */
 export declare const DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE = "Invalid database request";
-/** SQLSTATE codes for transient, retryable transaction conflicts (-> HTTP 409). The transaction
- * lost a concurrency race - not bad input (400), not a server bug (500); a retry usually succeeds. */
+/** SQLSTATE codes for transient, retryable transaction conflicts (-> HTTP 409) - the transaction lost a concurrency race, not bad input (400) and not a server bug (500). */
 export declare const POSTGRES_RETRYABLE_ERROR_CODES: readonly string[];
 /** Safe, generic message + stable code for a retryable DB conflict (never leaks internals). */
 export declare const DATABASE_RETRYABLE_ERROR_MESSAGE = "The request conflicted with a concurrent operation; please retry.";

package/dist/base/middlewares/app-error/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/definition.ts"],"names":[],"mappings":"AACA;;yEAEyE;AACzE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BrB,CAAC;AAEX;;8FAE8F;AAC9F,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAAuB,CAAC;AAEnF,yDAAyD;AACzD,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8BjE,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,sCAAsC,6BAA6B,CAAC;AAEjF;sGACsG;AACtG,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAG3D,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,gCAAgC,sEACwB,CAAC;AACtE,eAAO,MAAM,6BAA6B,QAAmC,CAAC;AAE9E,2DAA2D;AAC3D,qBAAa,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,wBAAwB;IAC1D,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;CAC3C"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/base/middlewares/app-error/definition.ts"],"names":[],"mappings":"AACA,6LAA6L;AAC7L,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BrB,CAAC;AAEX,4PAA4P;AAC5P,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAAuB,CAAC;AAEnF,yDAAyD;AACzD,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8BjE,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,sCAAsC,6BAA6B,CAAC;AAEjF,6KAA6K;AAC7K,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAG3D,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,gCAAgC,sEACwB,CAAC;AACtE,eAAO,MAAM,6BAA6B,QAAmC,CAAC;AAE9E,2DAA2D;AAC3D,qBAAa,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,wBAAwB;IAC1D,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;CAC3C"}