@venizia/ignis-kernel 0.4.2 → 0.4.4

package/dist/cjs/base/metadata/routes/rpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../../../src/base/metadata/routes/rpc.ts"],"names":[],"mappings":";;;AACA,2DAAgE;AAChE,0DAAqD;AACrD,qCAAkD;AAElD,wEAAwE;AACjE,MAAM,GAAG,GAAG,CAA0C,IAE5D,EAAE,EAAE;IACH,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,WAA+B;QAE/B,IAAI,CAAC,+BAAsB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,2BAAgB,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC;YACpC,MAAM;YACN,UAAU,EAAE,WAAW;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,GAAG,OAkBd;AAEF,wFAAwF;AACjF,MAAM,KAAK,GAAG,CAA0D,IAE9E,EAAE,EAAE;IACH,OAAO,IAAA,WAAG,EAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAI,CAAC,OAAO,CAAC,KAAK,EAAE;KACzD,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,KAAK,SAMhB;AAEF,8GAA8G;AACvG,MAAM,YAAY,GAAG,CAA0D,IAErF,EAAE,EAAE;IACH,OAAO,IAAA,WAAG,EAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;KACpE,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,YAAY,gBAMvB;AAEF,8GAA8G;AACvG,MAAM,YAAY,GAAG,CAA0D,IAErF,EAAE,EAAE;IACH,OAAO,IAAA,WAAG,EAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;KACpE,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,YAAY,gBAMvB;AAEF,mHAAmH;AAC5G,MAAM,UAAU,GAAG,CAA0D,IAEnF,EAAE,EAAE;IACH,OAAO,IAAA,WAAG,EAAC;QACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAI,CAAC,OAAO,CAAC,cAAc,EAAE;KAClE,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB","sourcesContent":["import type { IRpcMetadata } from '@/helpers/inversion/common/types';\nimport { MetadataRegistry } from '@/helpers/inversion/registry';\nimport { GRPC } from '@venizia/ignis-helpers/common';\nimport { DroppedRouteDecorators } from './common';\n\n/** Generic RPC decorator. Registers RPC config in metadata registry. */\nexport const rpc = <RpcRouteConfigType extends IRpcMetadata>(opts: {\n  configs: RpcRouteConfigType;\n}) => {\n  return function (\n    target: any,\n    propertyKey: string | symbol,\n    _descriptor: PropertyDescriptor,\n  ): void {\n    if (!DroppedRouteDecorators.isLegacyCall({ decorator: 'rpc', propertyKey })) {\n      return;\n    }\n\n    MetadataRegistry.getInstance().addRpc({\n      target,\n      methodName: propertyKey,\n      configs: opts.configs,\n    });\n  };\n};\n\n/** Unary RPC decorator. Equivalent to @rpc but automatically sets method to 'unary'. */\nexport const unary = <RpcRouteConfigType extends Omit<IRpcMetadata, 'method'>>(opts: {\n  configs: RpcRouteConfigType;\n}) => {\n  return rpc({\n    configs: { ...opts.configs, method: GRPC.Methods.UNARY },\n  });\n};\n\n/** Server streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'server_streaming'. */\nexport const serverStream = <RpcRouteConfigType extends Omit<IRpcMetadata, 'method'>>(opts: {\n  configs: RpcRouteConfigType;\n}) => {\n  return rpc({\n    configs: { ...opts.configs, method: GRPC.Methods.SERVER_STREAMING },\n  });\n};\n\n/** Client streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'client_streaming'. */\nexport const clientStream = <RpcRouteConfigType extends Omit<IRpcMetadata, 'method'>>(opts: {\n  configs: RpcRouteConfigType;\n}) => {\n  return rpc({\n    configs: { ...opts.configs, method: GRPC.Methods.CLIENT_STREAMING },\n  });\n};\n\n/** Bidirectional streaming RPC decorator. Equivalent to @rpc but automatically sets method to 'bidi_streaming'. */\nexport const bidiStream = <RpcRouteConfigType extends Omit<IRpcMetadata, 'method'>>(opts: {\n  configs: RpcRouteConfigType;\n}) => {\n  return rpc({\n    configs: { ...opts.configs, method: GRPC.Methods.BIDI_STREAMING },\n  });\n};\n"]}

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

@@ -1,82 +0,0 @@
-import type { ILogger } from '@venizia/ignis-helpers/core';
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { IProvider } from '@venizia/ignis-inversion';
-import type { ErrorHandler } from 'hono/types';
-/** How a thrown error is rendered into the log line. Must never throw - a throw inside the error handler turns a handled failure into an unhandled one. */
-export type TErrorLogFormatter = (opts: {
-    error: unknown;
-    messageCode?: string;
-    extra?: Record<string, unknown>;
-    includeStack?: boolean;
-    maxStackFrames?: number;
-}) => string;
-/**
- * Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` ->
- * its own status, else 500. Browser-pure: the two reads that need a host - the ambient environment
- * name and the error formatter - are constructor OPTIONS, not methods to subclass.
- *
- * They were hooks once, and three subclasses existed to answer them and nothing else. A class seam
- * is also unreachable from application code, so the browser example had to fake the environment with
- * a Hono middleware assigning `context.env`. `@venizia/ignis`'s `AppErrorMiddleware` now just
- * supplies `process.env.NODE_ENV` and `ErrorPrettier` as options.
- */
-export declare class BaseAppErrorMiddleware extends BaseHelper implements IProvider<ErrorHandler> {
-    private rootKey;
-    private intentionalStackFrames;
-    private unexpectedStackFrames;
-    /**
-     * How this host reads its ambient environment name, and the ONE option that says whether it has
-     * one at all: absent means it does not (a browser), so an unresolved name is by design; present
-     * but returning `undefined` means a host that should have one is misconfigured. Either way
-     * {@link isProduction} fails closed.
-     *
-     * A function, not a string: `process.env.NODE_ENV` has to be read per request, since a test - and
-     * a `--env-file` reload - can change it after the middleware is built.
-     */
-    private readonly environment?;
-    /** Replaces {@link renderErrorForLog} - `@venizia/ignis` passes `ErrorPrettier`, which reaches `node:util` and so cannot live here. */
-    private readonly formatErrorOverride?;
-    constructor(opts?: {
-        logger?: ILogger;
-        rootKey?: string;
-        intentionalStackFrames?: number;
-        unexpectedStackFrames?: number;
-        environment?: () => string | undefined;
-        formatError?: TErrorLogFormatter;
-    });
-    /** Renders a thrown error for the log, through the `formatError` option when one was given. */
-    protected formatError(opts: {
-        error: unknown;
-        messageCode?: string;
-        extra?: Record<string, unknown>;
-        includeStack?: boolean;
-        maxStackFrames?: number;
-    }): string;
-    /**
-     * The default log rendering: pure and deliberately small, so the whole middleware stays
-     * browser-pure.
-     *
-     * Must never throw, cycles included: a throw inside the error handler turns a handled failure
-     * into an unhandled one.
-     */
-    private renderErrorForLog;
-    private withRootKey;
-    /** Fail-closed: an unset or unrecognized env is production. */
-    private isProduction;
-    private classify;
-    /** Hono's `HTTPException` carries `status`, not `statusCode`. Only a 4xx is the caller's fault; a 5xx stays unexpected, so its message is sanitized. */
-    private readClientErrorStatus;
-    /** `getError` sets `statusCode`, and it wins when a foreign error carries both. Neither usable is a 500. */
-    private readIntentionalStatus;
-    /** 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;
-    /** Only an intentional error's message is a catalog template; every other branch writes its own text, so it passes through as is. */
-    private renderMessage;
-    value(): ErrorHandler;
-}
-//# sourceMappingURL=app-error.middleware.d.ts.map

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

@@ -1 +0,0 @@
-{"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,6BAA6B,CAAC;AAEtE,OAAO,EACL,UAAU,EAKX,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAiBlE,2JAA2J;AAC3J,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAK,MAAM,CAAC;AA8Cb;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,SAAQ,UAAW,YAAW,SAAS,CAAC,YAAY,CAAC;IACvF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA2B;IAExD,uIAAuI;IACvI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAqB;gBAE9C,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;QAC/B,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;QACvC,WAAW,CAAC,EAAE,kBAAkB,CAAC;KAClC;IAgBD,+FAA+F;IAC/F,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1B,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,MAAM;IAIV;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,WAAW;IAInB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,QAAQ;IAkBhB,wJAAwJ;IACxJ,OAAO,CAAC,qBAAqB;IAc7B,4GAA4G;IAC5G,OAAO,CAAC,qBAAqB;IAU7B,oGAAoG;IACpG,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,OAAO;IA+Cf,mGAAmG;IACnG,OAAO,CAAC,eAAe;IAUvB,wGAAwG;IACxG,OAAO,CAAC,QAAQ;IAgChB,qIAAqI;IACrI,OAAO,CAAC,aAAa;IA6BrB,KAAK,IAAI,YAAY;CAkDtB"}

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

@@ -1,294 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseAppErrorMiddleware = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-const common_2 = require("../common");
-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';
-/** 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;
-/**
- * Renders a value into one log-safe fragment.
- *
- * Redaction is not optional here. This runs on `extra`, which is whatever a throw site chose to
- * attach - `getError({ extra: { apiKey } })` is a shape applications write - and in a Worker this
- * fragment lands in the browser console. `toJsonSafe` masks secret-shaped keys; a hand-rolled
- * `JSON.stringify` does not, and the server path has always redacted.
- *
- * The BigInt replacer stays: `toJsonSafe` leaves BigInt intact and `JSON.stringify` refuses it, so
- * without this a single BigInt would collapse the whole fragment to the marker below. Anything else
- * it refuses yields that marker rather than a throw - this is the last-resort error handler, where a
- * throw turns a handled failure into an unhandled one.
- */
-const renderValue = (opts) => {
-    const { value } = opts;
-    if (typeof value === 'string') {
-        return value;
-    }
-    const safe = (0, common_1.toJsonSafe)({ value });
-    try {
-        return JSON.stringify(safe) ?? String(value);
-    }
-    catch {
-        // A replacer is 6x the cost of plain stringify and deopts every key, so it is installed only
-        // once BigInt has actually thrown - the case it exists for, and the rare one.
-        try {
-            const rendered = JSON.stringify(safe, (_key, entry) => typeof entry === 'bigint' ? entry.toString() : entry);
-            return rendered ?? String(value);
-        }
-        catch {
-            // Not a swallowed failure: this marker IS the report, and it lands in the log line the caller
-            // is building.
-            return '[unrenderable]';
-        }
-    }
-};
-/**
- * Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` ->
- * its own status, else 500. Browser-pure: the two reads that need a host - the ambient environment
- * name and the error formatter - are constructor OPTIONS, not methods to subclass.
- *
- * They were hooks once, and three subclasses existed to answer them and nothing else. A class seam
- * is also unreachable from application code, so the browser example had to fake the environment with
- * a Hono middleware assigning `context.env`. `@venizia/ignis`'s `AppErrorMiddleware` now just
- * supplies `process.env.NODE_ENV` and `ErrorPrettier` as options.
- */
-class BaseAppErrorMiddleware extends core_1.BaseHelper {
-    constructor(opts) {
-        // `new.target`, not a literal: a subclass logs under its own name, so `@venizia/ignis`'s
-        // `AppErrorMiddleware` keeps the scope it has always logged under.
-        super({ scope: new.target.name });
-        this.rootKey = opts?.rootKey;
-        this.intentionalStackFrames = opts?.intentionalStackFrames ?? DEFAULT_INTENTIONAL_STACK_FRAMES;
-        this.unexpectedStackFrames = opts?.unexpectedStackFrames ?? DEFAULT_UNEXPECTED_STACK_FRAMES;
-        this.environment = opts?.environment;
-        this.formatErrorOverride = opts?.formatError;
-        if (opts?.logger) {
-            this.logger = opts.logger;
-        }
-    }
-    /** Renders a thrown error for the log, through the `formatError` option when one was given. */
-    formatError(opts) {
-        return (this.formatErrorOverride ?? ((o) => this.renderErrorForLog(o)))(opts);
-    }
-    /**
-     * The default log rendering: pure and deliberately small, so the whole middleware stays
-     * browser-pure.
-     *
-     * Must never throw, cycles included: a throw inside the error handler turns a handled failure
-     * into an unhandled one.
-     */
-    renderErrorForLog(opts) {
-        const { error, messageCode, extra, includeStack = true, maxStackFrames } = opts;
-        const thrown = error;
-        const lines = [];
-        if (typeof thrown?.name === 'string') {
-            lines.push(`name: ${thrown.name}`);
-        }
-        lines.push(`message: ${typeof thrown?.message === 'string' ? thrown.message : renderValue({ value: error })}`);
-        if (messageCode) {
-            lines.push(`code: ${messageCode}`);
-        }
-        if (extra && Object.keys(extra).length > 0) {
-            lines.push(`extra: ${renderValue({ value: extra })}`);
-        }
-        if (includeStack && typeof thrown?.stack === 'string') {
-            const frames = thrown.stack.split('\n').filter((line) => line.trimStart().startsWith('at '));
-            const capped = maxStackFrames === undefined ? frames : frames.slice(0, maxStackFrames);
-            if (capped.length > 0) {
-                lines.push(`stack:\n${capped.join('\n')}`);
-            }
-        }
-        return lines.map((line) => `- ${line}`).join('\n');
-    }
-    withRootKey(payload) {
-        return this.rootKey ? { [this.rootKey]: payload } : payload;
-    }
-    /** Fail-closed: an unset or unrecognized env is production. */
-    isProduction(opts) {
-        const { context, error, requestId } = opts;
-        const env = [context.env?.NODE_ENV, this.environment?.()].find(Boolean);
-        if (!env) {
-            // Only a host that HAS an ambient environment can be misconfigured about it. In a browser the
-            // absence is by design, and shouting it at error level on every request buries the error the
-            // reader is actually looking at. Both paths still sanitize.
-            if (this.environment) {
-                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, this.formatError({ error }));
-            }
-            else {
-                this.logger.debug('[%s] No ambient environment - sanitizing as production | path: %s | set NODE_ENV on the Hono env binding to opt out', requestId, context.req.path);
-            }
-            return true;
-        }
-        return !core_1.EnvironmentNames.DEVELOPMENT_ENVS.has(env.toLowerCase());
-    }
-    classify(opts) {
-        const { error, dbError } = opts;
-        if (dbError.isClientError) {
-            return definition_1.ApplicationErrorTypes.DATABASE_CLIENT;
-        }
-        if ((0, database_handler_1.isRetryableDatabaseError)({ error })) {
-            return definition_1.ApplicationErrorTypes.DATABASE_RETRYABLE;
-        }
-        if ('statusCode' in error || this.readClientErrorStatus({ error }) !== undefined) {
-            return definition_1.ApplicationErrorTypes.INTENTIONAL;
-        }
-        return definition_1.ApplicationErrorTypes.UNEXPECTED;
-    }
-    /** Hono's `HTTPException` carries `status`, not `statusCode`. Only a 4xx is the caller's fault; a 5xx stays unexpected, so its message is sanitized. */
-    readClientErrorStatus(opts) {
-        const { error } = opts;
-        if (!('getResponse' in error) || !('status' in error) || typeof error.status !== 'number') {
-            return undefined;
-        }
-        const isClientError = error.status >= common_1.HTTP.ResultCodes.RS_4.BadRequest &&
-            error.status < common_1.HTTP.ResultCodes.RS_5.InternalServerError;
-        return isClientError ? error.status : undefined;
-    }
-    /** `getError` sets `statusCode`, and it wins when a foreign error carries both. Neither usable is a 500. */
-    readIntentionalStatus(opts) {
-        const { error } = opts;
-        if ('statusCode' in error && typeof error.statusCode === 'number') {
-            return error.statusCode;
-        }
-        return this.readClientErrorStatus({ error }) ?? common_1.HTTP.ResultCodes.RS_5.InternalServerError;
-    }
-    /** An ApplicationError's `normalized` is authoritative - a `transform` may have reworded `text`. */
-    build(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 ??
-            core_1.MessageCode.resolve('messageCode' in error ? error.messageCode : undefined);
-        const normalized = 'normalized' in error
-            ? error.normalized
-            : { text: message, code, args: {} };
-        return { statusCode, message, normalized, type };
-    }
-    resolve(opts) {
-        const { error, isProduction } = opts;
-        const dbError = (0, database_handler_1.isDatabaseClientError)({ error, isProduction });
-        const type = this.classify({ error, dbError });
-        switch (type) {
-            case definition_1.ApplicationErrorTypes.DATABASE_CLIENT: {
-                return this.build({
-                    error,
-                    type,
-                    statusCode: common_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,
-                });
-            }
-            case definition_1.ApplicationErrorTypes.DATABASE_RETRYABLE: {
-                return this.build({
-                    error,
-                    type,
-                    statusCode: common_1.HTTP.ResultCodes.RS_4.Conflict,
-                    message: definition_1.DATABASE_RETRYABLE_ERROR_MESSAGE,
-                    messageCode: definition_1.DATABASE_RETRYABLE_ERROR_CODE,
-                });
-            }
-            case definition_1.ApplicationErrorTypes.INTENTIONAL: {
-                return this.build({
-                    error,
-                    type,
-                    statusCode: this.readIntentionalStatus({ error }),
-                    message: error.message,
-                });
-            }
-            default: {
-                return this.build({
-                    error,
-                    type: definition_1.ApplicationErrorTypes.UNEXPECTED,
-                    statusCode: common_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,
-                });
-            }
-        }
-    }
-    /** 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' && core_1.LogLevels.isValid(candidate)) {
-            return candidate;
-        }
-        return core_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, this.formatError({
-            error,
-            // The default code means "no code" - logging it on every error would be a noise line.
-            messageCode: messageCode === core_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,
-        }));
-    }
-    /** Only an intentional error's message is a catalog template; every other branch writes its own text, so it passes through as is. */
-    renderMessage(opts) {
-        const { resolved, isProduction, requestId } = opts;
-        if (resolved.type !== definition_1.ApplicationErrorTypes.INTENTIONAL) {
-            return resolved.message;
-        }
-        const { text, missing } = core_1.MessageTemplate.render({
-            text: resolved.message,
-            args: resolved.normalized.args,
-        });
-        // Production stays silent and renders what it can; anywhere else a missing arg is a throw site to fix.
-        if (missing.length > 0 && !isProduction) {
-            this.logger.warn('[%s] MESSAGE PLACEHOLDER WITHOUT ARG | code: %s | keys: %s', requestId, resolved.normalized.code, missing.join(', '));
-        }
-        return text;
-    }
-    value() {
-        return async (error, context) => {
-            const requestId = context.get(common_2.REQUEST_ID_KEY);
-            const isProduction = this.isProduction({ context, error, requestId });
-            if (error.name === 'ZodError') {
-                const rs = (0, zod_handler_1.formatZodError)({
-                    isProduction,
-                    requestId,
-                    url: context.req.url,
-                    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 resolved = this.resolve({ error, isProduction });
-            const { statusCode, normalized, type } = resolved;
-            this.logError({ error, context, requestId, statusCode, messageCode: normalized.code, type });
-            const rs = {
-                message: this.renderMessage({ resolved, isProduction, requestId }),
-                statusCode,
-                normalized,
-                requestId,
-                extra: 'extra' in error ? error?.extra : undefined,
-                details: {
-                    url: context.req.url,
-                    path: context.req.path,
-                    stack: !isProduction ? error.stack : undefined,
-                    cause: !isProduction ? error.cause : undefined,
-                },
-            };
-            return context.json(this.withRootKey(rs), statusCode);
-        };
-    }
-}
-exports.BaseAppErrorMiddleware = BaseAppErrorMiddleware;
-//# sourceMappingURL=app-error.middleware.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"app-error.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/app-error.middleware.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ILogger, TLogLevel } from '@venizia/ignis-helpers/core';\nimport type { TNullable } from '@venizia/ignis-helpers/common';\nimport {\n  BaseHelper,\n  EnvironmentNames,\n  LogLevels,\n  MessageCode,\n  MessageTemplate,\n} from '@venizia/ignis-helpers/core';\nimport { HTTP, toJsonSafe } from '@venizia/ignis-helpers/common';\nimport type { IProvider } from '@venizia/ignis-inversion';\nimport type { Context } from 'hono';\nimport type { ErrorHandler, HTTPResponseError } from 'hono/types';\nimport { REQUEST_ID_KEY } from '../common';\nimport { isDatabaseClientError, isRetryableDatabaseError } from './database.handler';\nimport {\n  ApplicationErrorTypes,\n  DATABASE_RETRYABLE_ERROR_CODE,\n  DATABASE_RETRYABLE_ERROR_MESSAGE,\n} from './definition';\nimport type { IResolvedApplicationError, TApplicationErrorType } from './common';\nimport { formatZodError } from './zod.handler';\n\nconst DEFAULT_INTERNAL_ERROR_MESSAGE = 'Internal Server Error';\n\n/** 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. */\nconst DEFAULT_INTENTIONAL_STACK_FRAMES = 5;\nconst DEFAULT_UNEXPECTED_STACK_FRAMES = 10;\n\n/** How a thrown error is rendered into the log line. Must never throw - a throw inside the error handler turns a handled failure into an unhandled one. */\nexport type TErrorLogFormatter = (opts: {\n  error: unknown;\n  messageCode?: string;\n  extra?: Record<string, unknown>;\n  includeStack?: boolean;\n  maxStackFrames?: number;\n}) => string;\n\ntype TThrown = Error | HTTPResponseError;\ntype TDatabaseClientError = ReturnType<typeof isDatabaseClientError>;\n\n/**\n * Renders a value into one log-safe fragment.\n *\n * Redaction is not optional here. This runs on `extra`, which is whatever a throw site chose to\n * attach - `getError({ extra: { apiKey } })` is a shape applications write - and in a Worker this\n * fragment lands in the browser console. `toJsonSafe` masks secret-shaped keys; a hand-rolled\n * `JSON.stringify` does not, and the server path has always redacted.\n *\n * The BigInt replacer stays: `toJsonSafe` leaves BigInt intact and `JSON.stringify` refuses it, so\n * without this a single BigInt would collapse the whole fragment to the marker below. Anything else\n * it refuses yields that marker rather than a throw - this is the last-resort error handler, where a\n * throw turns a handled failure into an unhandled one.\n */\nconst renderValue = (opts: { value: unknown }): string => {\n  const { value } = opts;\n\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  const safe = toJsonSafe({ value });\n\n  try {\n    return JSON.stringify(safe) ?? String(value);\n  } catch {\n    // A replacer is 6x the cost of plain stringify and deopts every key, so it is installed only\n    // once BigInt has actually thrown - the case it exists for, and the rare one.\n    try {\n      const rendered = JSON.stringify(safe, (_key, entry: unknown) =>\n        typeof entry === 'bigint' ? entry.toString() : entry,\n      );\n\n      return rendered ?? String(value);\n    } catch {\n      // Not a swallowed failure: this marker IS the report, and it lands in the log line the caller\n      // is building.\n      return '[unrenderable]';\n    }\n  }\n};\n\n/**\n * Hono `onError`: ZodError -> 422, DB client error -> 400, retryable conflict -> 409, `getError` ->\n * its own status, else 500. Browser-pure: the two reads that need a host - the ambient environment\n * name and the error formatter - are constructor OPTIONS, not methods to subclass.\n *\n * They were hooks once, and three subclasses existed to answer them and nothing else. A class seam\n * is also unreachable from application code, so the browser example had to fake the environment with\n * a Hono middleware assigning `context.env`. `@venizia/ignis`'s `AppErrorMiddleware` now just\n * supplies `process.env.NODE_ENV` and `ErrorPrettier` as options.\n */\nexport class BaseAppErrorMiddleware extends BaseHelper implements IProvider<ErrorHandler> {\n  private rootKey: TNullable<string>;\n  private intentionalStackFrames: number;\n  private unexpectedStackFrames: number;\n\n  /**\n   * How this host reads its ambient environment name, and the ONE option that says whether it has\n   * one at all: absent means it does not (a browser), so an unresolved name is by design; present\n   * but returning `undefined` means a host that should have one is misconfigured. Either way\n   * {@link isProduction} fails closed.\n   *\n   * A function, not a string: `process.env.NODE_ENV` has to be read per request, since a test - and\n   * a `--env-file` reload - can change it after the middleware is built.\n   */\n  private readonly environment?: () => string | undefined;\n\n  /** Replaces {@link renderErrorForLog} - `@venizia/ignis` passes `ErrorPrettier`, which reaches `node:util` and so cannot live here. */\n  private readonly formatErrorOverride?: TErrorLogFormatter;\n\n  constructor(opts?: {\n    logger?: ILogger;\n    rootKey?: string;\n    intentionalStackFrames?: number;\n    unexpectedStackFrames?: number;\n    environment?: () => string | undefined;\n    formatError?: TErrorLogFormatter;\n  }) {\n    // `new.target`, not a literal: a subclass logs under its own name, so `@venizia/ignis`'s\n    // `AppErrorMiddleware` keeps the scope it has always logged under.\n    super({ scope: new.target.name });\n\n    this.rootKey = opts?.rootKey;\n    this.intentionalStackFrames = opts?.intentionalStackFrames ?? DEFAULT_INTENTIONAL_STACK_FRAMES;\n    this.unexpectedStackFrames = opts?.unexpectedStackFrames ?? DEFAULT_UNEXPECTED_STACK_FRAMES;\n    this.environment = opts?.environment;\n    this.formatErrorOverride = opts?.formatError;\n\n    if (opts?.logger) {\n      this.logger = opts.logger;\n    }\n  }\n\n  /** Renders a thrown error for the log, through the `formatError` option when one was given. */\n  protected formatError(opts: {\n    error: unknown;\n    messageCode?: string;\n    extra?: Record<string, unknown>;\n    includeStack?: boolean;\n    maxStackFrames?: number;\n  }): string {\n    return (this.formatErrorOverride ?? ((o) => this.renderErrorForLog(o)))(opts);\n  }\n\n  /**\n   * The default log rendering: pure and deliberately small, so the whole middleware stays\n   * browser-pure.\n   *\n   * Must never throw, cycles included: a throw inside the error handler turns a handled failure\n   * into an unhandled one.\n   */\n  private renderErrorForLog(opts: {\n    error: unknown;\n    messageCode?: string;\n    extra?: Record<string, unknown>;\n    includeStack?: boolean;\n    maxStackFrames?: number;\n  }): string {\n    const { error, messageCode, extra, includeStack = true, maxStackFrames } = opts;\n    const thrown = error as Partial<Error> | null | undefined;\n    const lines: Array<string> = [];\n\n    if (typeof thrown?.name === 'string') {\n      lines.push(`name: ${thrown.name}`);\n    }\n\n    lines.push(\n      `message: ${typeof thrown?.message === 'string' ? thrown.message : renderValue({ value: error })}`,\n    );\n\n    if (messageCode) {\n      lines.push(`code: ${messageCode}`);\n    }\n\n    if (extra && Object.keys(extra).length > 0) {\n      lines.push(`extra: ${renderValue({ value: extra })}`);\n    }\n\n    if (includeStack && typeof thrown?.stack === 'string') {\n      const frames = thrown.stack.split('\\n').filter((line) => line.trimStart().startsWith('at '));\n      const capped = maxStackFrames === undefined ? frames : frames.slice(0, maxStackFrames);\n\n      if (capped.length > 0) {\n        lines.push(`stack:\\n${capped.join('\\n')}`);\n      }\n    }\n\n    return lines.map((line) => `- ${line}`).join('\\n');\n  }\n\n  private withRootKey(payload: object) {\n    return this.rootKey ? { [this.rootKey]: payload } : payload;\n  }\n\n  /** Fail-closed: an unset or unrecognized env is production. */\n  private isProduction(opts: { context: Context; error: TThrown; requestId: string }): boolean {\n    const { context, error, requestId } = opts;\n    const env = [context.env?.NODE_ENV, this.environment?.()].find(Boolean);\n\n    if (!env) {\n      // Only a host that HAS an ambient environment can be misconfigured about it. In a browser the\n      // absence is by design, and shouting it at error level on every request buries the error the\n      // reader is actually looking at. Both paths still sanitize.\n      if (this.environment) {\n        this.logger.error(\n          '[%s] INVALID ENV IDENTIFIER | env: %s | path: %s | method: %s | url: %s\\n%s',\n          requestId,\n          env,\n          context.req.path,\n          context.req.method,\n          context.req.url,\n          this.formatError({ error }),\n        );\n      } else {\n        this.logger.debug(\n          '[%s] No ambient environment - sanitizing as production | path: %s | set NODE_ENV on the Hono env binding to opt out',\n          requestId,\n          context.req.path,\n        );\n      }\n\n      return true;\n    }\n\n    return !EnvironmentNames.DEVELOPMENT_ENVS.has(env.toLowerCase());\n  }\n\n  private classify(opts: { error: TThrown; dbError: TDatabaseClientError }): TApplicationErrorType {\n    const { error, dbError } = opts;\n\n    if (dbError.isClientError) {\n      return ApplicationErrorTypes.DATABASE_CLIENT;\n    }\n\n    if (isRetryableDatabaseError({ error })) {\n      return ApplicationErrorTypes.DATABASE_RETRYABLE;\n    }\n\n    if ('statusCode' in error || this.readClientErrorStatus({ error }) !== undefined) {\n      return ApplicationErrorTypes.INTENTIONAL;\n    }\n\n    return ApplicationErrorTypes.UNEXPECTED;\n  }\n\n  /** Hono's `HTTPException` carries `status`, not `statusCode`. Only a 4xx is the caller's fault; a 5xx stays unexpected, so its message is sanitized. */\n  private readClientErrorStatus(opts: { error: TThrown }): number | undefined {\n    const { error } = opts;\n\n    if (!('getResponse' in error) || !('status' in error) || typeof error.status !== 'number') {\n      return undefined;\n    }\n\n    const isClientError =\n      error.status >= HTTP.ResultCodes.RS_4.BadRequest &&\n      error.status < HTTP.ResultCodes.RS_5.InternalServerError;\n\n    return isClientError ? error.status : undefined;\n  }\n\n  /** `getError` sets `statusCode`, and it wins when a foreign error carries both. Neither usable is a 500. */\n  private readIntentionalStatus(opts: { error: TThrown }): number {\n    const { error } = opts;\n\n    if ('statusCode' in error && typeof error.statusCode === 'number') {\n      return error.statusCode;\n    }\n\n    return this.readClientErrorStatus({ error }) ?? HTTP.ResultCodes.RS_5.InternalServerError;\n  }\n\n  /** An ApplicationError's `normalized` is authoritative - a `transform` may have reworded `text`. */\n  private build(opts: {\n    error: TThrown;\n    statusCode: number;\n    message: string;\n    type: TApplicationErrorType;\n    messageCode?: string;\n  }): IResolvedApplicationError {\n    const { error, statusCode, message, type, messageCode } = opts;\n\n    // Fallback for a FOREIGN error that sets its own code; an ApplicationError reports via `normalized`.\n    const code =\n      messageCode ??\n      MessageCode.resolve('messageCode' in error ? (error.messageCode as string) : undefined);\n\n    const normalized =\n      'normalized' in error\n        ? (error.normalized as IResolvedApplicationError['normalized'])\n        : { text: message, code, args: {} };\n\n    return { statusCode, message, normalized, type };\n  }\n\n  private resolve(opts: { error: TThrown; isProduction: boolean }): IResolvedApplicationError {\n    const { error, isProduction } = opts;\n    const dbError = isDatabaseClientError({ error, isProduction });\n    const type = this.classify({ error, dbError });\n\n    switch (type) {\n      case ApplicationErrorTypes.DATABASE_CLIENT: {\n        return this.build({\n          error,\n          type,\n          statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n          // The fallback is unreachable today; it keeps the driver's raw text from ever surfacing.\n          message: dbError.message ?? DEFAULT_INTERNAL_ERROR_MESSAGE,\n        });\n      }\n\n      case ApplicationErrorTypes.DATABASE_RETRYABLE: {\n        return this.build({\n          error,\n          type,\n          statusCode: HTTP.ResultCodes.RS_4.Conflict,\n          message: DATABASE_RETRYABLE_ERROR_MESSAGE,\n          messageCode: DATABASE_RETRYABLE_ERROR_CODE,\n        });\n      }\n\n      case ApplicationErrorTypes.INTENTIONAL: {\n        return this.build({\n          error,\n          type,\n          statusCode: this.readIntentionalStatus({ error }),\n          message: error.message,\n        });\n      }\n\n      default: {\n        return this.build({\n          error,\n          type: ApplicationErrorTypes.UNEXPECTED,\n          statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n          // Never leak a raw message - it may carry SQL, schema names or connection details.\n          message: isProduction ? DEFAULT_INTERNAL_ERROR_MESSAGE : error.message,\n        });\n      }\n    }\n  }\n\n  /** A throw site may set `logLevel` via `getError`; anything unset or malformed logs at `error`. */\n  private resolveLogLevel(opts: { error: TThrown }): TLogLevel {\n    const candidate = (opts.error as { logLevel?: unknown }).logLevel;\n\n    if (typeof candidate === 'string' && LogLevels.isValid(candidate)) {\n      return candidate as TLogLevel;\n    }\n\n    return LogLevels.ERROR;\n  }\n\n  /** The one place a thrown error reaches the log - called once the status is known, so it carries it. */\n  private logError(opts: {\n    error: TThrown;\n    context: Context;\n    requestId: string;\n    statusCode: number;\n    messageCode: string;\n    type?: TApplicationErrorType;\n  }) {\n    const { error, context, requestId, statusCode, messageCode, type } = opts;\n\n    this.logger.log(\n      this.resolveLogLevel({ error }),\n      '[%s] REQUEST ERROR | %s | %s %s\\n%s',\n      requestId,\n      statusCode,\n      context.req.method,\n      context.req.url,\n      this.formatError({\n        error,\n        // The default code means \"no code\" - logging it on every error would be a noise line.\n        messageCode: messageCode === MessageCode.DEFAULT ? undefined : messageCode,\n        extra: 'extra' in error ? (error.extra as Record<string, unknown>) : undefined,\n        includeStack: true,\n        // An intentional error still needs its throw site; it just does not need the caller chain behind it.\n        maxStackFrames:\n          type === ApplicationErrorTypes.UNEXPECTED\n            ? this.unexpectedStackFrames\n            : this.intentionalStackFrames,\n      }),\n    );\n  }\n\n  /** Only an intentional error's message is a catalog template; every other branch writes its own text, so it passes through as is. */\n  private renderMessage(opts: {\n    resolved: IResolvedApplicationError;\n    isProduction: boolean;\n    requestId: string;\n  }): string {\n    const { resolved, isProduction, requestId } = opts;\n\n    if (resolved.type !== ApplicationErrorTypes.INTENTIONAL) {\n      return resolved.message;\n    }\n\n    const { text, missing } = MessageTemplate.render({\n      text: resolved.message,\n      args: resolved.normalized.args,\n    });\n\n    // Production stays silent and renders what it can; anywhere else a missing arg is a throw site to fix.\n    if (missing.length > 0 && !isProduction) {\n      this.logger.warn(\n        '[%s] MESSAGE PLACEHOLDER WITHOUT ARG | code: %s | keys: %s',\n        requestId,\n        resolved.normalized.code,\n        missing.join(', '),\n      );\n    }\n\n    return text;\n  }\n\n  value(): ErrorHandler {\n    return async (error, context) => {\n      const requestId = context.get(REQUEST_ID_KEY);\n      const isProduction = this.isProduction({ context, error, requestId });\n\n      if (error.name === 'ZodError') {\n        const rs = formatZodError({\n          isProduction,\n          requestId,\n          url: context.req.url,\n          path: context.req.path,\n          error,\n        });\n\n        this.logError({\n          error,\n          context,\n          requestId,\n          statusCode: rs.statusCode,\n          messageCode: rs.response.normalized.code,\n        });\n\n        return context.json(\n          this.withRootKey(rs.response),\n          rs.statusCode as Parameters<typeof context.json>[1],\n        );\n      }\n\n      const resolved = this.resolve({ error, isProduction });\n      const { statusCode, normalized, type } = resolved;\n\n      this.logError({ error, context, requestId, statusCode, messageCode: normalized.code, type });\n\n      const rs = {\n        message: this.renderMessage({ resolved, isProduction, requestId }),\n        statusCode,\n        normalized,\n        requestId,\n        extra: 'extra' in error ? error?.extra : undefined,\n        details: {\n          url: context.req.url,\n          path: context.req.path,\n          stack: !isProduction ? error.stack : undefined,\n          cause: !isProduction ? error.cause : undefined,\n        },\n      };\n\n      return context.json(this.withRootKey(rs), statusCode as Parameters<typeof context.json>[1]);\n    };\n  }\n}\n"]}

package/dist/cjs/base/middlewares/app-error/common/index.d.ts

@@ -1,2 +0,0 @@
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/base/middlewares/app-error/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/cjs/base/middlewares/app-error/common/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/middlewares/app-error/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB","sourcesContent":["export * from './types';\n"]}

package/dist/cjs/base/middlewares/app-error/common/types.d.ts

@@ -1,32 +0,0 @@
-import type { TConstValue } from '@venizia/ignis-helpers/common';
-import type { ApplicationErrorTypes } from '../definition';
-export interface IDatabaseError extends Error {
-    code?: string;
-    cause?: {
-        code?: string;
-        detail?: string;
-        table?: string;
-        constraint?: string;
-    };
-}
-export interface IZodIssueLike {
-    path: Array<string | number>;
-    message: string;
-    code?: string;
-    params?: Record<string, unknown>;
-    expected?: unknown;
-    received?: unknown;
-}
-export type TApplicationErrorType = TConstValue<typeof ApplicationErrorTypes>;
-export interface IResolvedApplicationError {
-    statusCode: number;
-    message: string;
-    normalized: {
-        text: string;
-        code: string;
-        args: Record<string, unknown>;
-    };
-    /** Drives whether the log carries a stack - only an UNEXPECTED failure needs one. */
-    type: TApplicationErrorType;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/base/middlewares/app-error/common/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC1E,qFAAqF;IACrF,IAAI,EAAE,qBAAqB,CAAC;CAC7B"}

package/dist/cjs/base/middlewares/app-error/common/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cjs/base/middlewares/app-error/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/base/middlewares/app-error/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport type { ApplicationErrorTypes } from '../definition';\n\nexport interface IDatabaseError extends Error {\n  code?: string;\n  cause?: {\n    code?: string;\n    detail?: string;\n    table?: string;\n    constraint?: string;\n  };\n}\n\nexport interface IZodIssueLike {\n  path: Array<string | number>;\n  message: string;\n  code?: string;\n  params?: Record<string, unknown>;\n  expected?: unknown;\n  received?: unknown;\n}\n\nexport type TApplicationErrorType = TConstValue<typeof ApplicationErrorTypes>;\n\nexport interface IResolvedApplicationError {\n  statusCode: number;\n  message: string;\n  normalized: { text: string; code: string; args: Record<string, unknown> };\n  /** Drives whether the log carries a stack - only an UNEXPECTED failure needs one. */\n  type: TApplicationErrorType;\n}\n"]}

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

@@ -1,13 +0,0 @@
-/** 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;
-}) => {
-    isClientError: boolean;
-    message?: string;
-};
-/** 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;
-//# sourceMappingURL=database.handler.d.ts.map

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

@@ -1 +0,0 @@
-{"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/cjs/base/middlewares/app-error/database.handler.js

@@ -1,44 +0,0 @@
-"use strict";
-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. */
-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; 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 and `table`/`constraint` reveal schema internals.
-    if (isProduction) {
-        return { isClientError: true, message: baseMessage };
-    }
-    // Non-production: append driver-provided context to aid debugging.
-    const lines = [baseMessage];
-    if (cause?.detail) {
-        lines.push(`Detail: ${cause.detail}`);
-    }
-    if (cause?.table) {
-        lines.push(`Table: ${cause.table}`);
-    }
-    if (cause?.constraint) {
-        lines.push(`Constraint: ${cause.constraint}`);
-    }
-    return {
-        isClientError: true,
-        message: lines.join('\n'),
-    };
-};
-exports.isDatabaseClientError = isDatabaseClientError;
-/** 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);
-    return typeof code === 'string' && definition_1.POSTGRES_RETRYABLE_ERROR_CODES.includes(code);
-};
-exports.isRetryableDatabaseError = isRetryableDatabaseError;
-//# sourceMappingURL=database.handler.js.map

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

@@ -1 +0,0 @@
-{"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","sourcesContent":["import {\n  DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE,\n  DATABASE_CLIENT_ERROR_MESSAGES,\n  POSTGRES_CLIENT_ERROR_CLASSES,\n  POSTGRES_RETRYABLE_ERROR_CODES,\n} from './definition';\nimport type { IDatabaseError } from './common';\n\n/** 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. */\nexport const isDatabaseClientError = (opts: {\n  error: Error;\n  isProduction: boolean;\n}): { isClientError: boolean; message?: string } => {\n  const { error, isProduction } = opts;\n  const dbError = error as IDatabaseError;\n  const cause = dbError.cause;\n  const code = [dbError.code, cause?.code].find(Boolean);\n\n  // 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.\n  if (typeof code !== 'string' || !POSTGRES_CLIENT_ERROR_CLASSES.includes(code.slice(0, 2))) {\n    return { isClientError: false };\n  }\n\n  const baseMessage =\n    DATABASE_CLIENT_ERROR_MESSAGES[code] ?? DATABASE_CLIENT_ERROR_FALLBACK_MESSAGE;\n\n  // In production expose ONLY the generic base message: `detail` can echo row values and `table`/`constraint` reveal schema internals.\n  if (isProduction) {\n    return { isClientError: true, message: baseMessage };\n  }\n\n  // Non-production: append driver-provided context to aid debugging.\n  const lines = [baseMessage];\n  if (cause?.detail) {\n    lines.push(`Detail: ${cause.detail}`);\n  }\n\n  if (cause?.table) {\n    lines.push(`Table: ${cause.table}`);\n  }\n\n  if (cause?.constraint) {\n    lines.push(`Constraint: ${cause.constraint}`);\n  }\n\n  return {\n    isClientError: true,\n    message: lines.join('\\n'),\n  };\n};\n\n/** True for a transient, retryable transaction conflict (serialization failure / deadlock - SQLSTATE 40001 / 40P01) -> HTTP 409: the client can retry the same request. */\nexport const isRetryableDatabaseError = (opts: { error: Error }): boolean => {\n  const dbError = opts.error as IDatabaseError;\n  const code = [dbError.code, dbError.cause?.code].find(Boolean);\n  return typeof code === 'string' && POSTGRES_RETRYABLE_ERROR_CODES.includes(code);\n};\n"]}