@venizia/ignis 0.4.3 → 0.4.4

package/dist/components/health-check/controller.js

@@ -1,157 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-var HealthCheckController_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HealthCheckController = void 0;
-const controllers_1 = require("../../base/controllers");
-const metadata_1 = require("../../base/metadata");
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const zod_openapi_1 = require("@hono/zod-openapi");
-const common_1 = require("@venizia/ignis-helpers/common");
-const common_2 = require("./common");
-const reporter_1 = require("./reporter");
-const RouteConfigs = {
-    ROOT: {
-        method: common_1.HTTP.Methods.GET,
-        path: common_2.HealthCheckRestPaths.ROOT,
-        responses: (0, ignis_kernel_1.jsonResponse)({
-            schema: zod_openapi_1.z.object({ status: zod_openapi_1.z.string(), timestamp: zod_openapi_1.z.iso.datetime() }).openapi({
-                description: 'HealthCheck Schema',
-                examples: [{ status: 'ok', timestamp: new Date().toISOString() }],
-            }),
-            description: 'Health check status',
-        }),
-    },
-    STATS: {
-        method: common_1.HTTP.Methods.GET,
-        path: common_2.HealthCheckRestPaths.STATS,
-        request: {
-            headers: zod_openapi_1.z.object({
-                [common_2.HealthCheckHeaders.SECRET_KEY]: zod_openapi_1.z.string().optional().openapi({
-                    description: 'The stats key',
-                }),
-            }),
-        },
-        responses: (0, ignis_kernel_1.jsonResponse)({
-            schema: zod_openapi_1.z
-                .object({
-                status: zod_openapi_1.z.string(),
-                timestamp: zod_openapi_1.z.iso.datetime(),
-                build: zod_openapi_1.z.object({
-                    service: zod_openapi_1.z.string(),
-                    version: zod_openapi_1.z.string(),
-                    commit: zod_openapi_1.z.string(),
-                    branch: zod_openapi_1.z.string(),
-                    builtAt: zod_openapi_1.z.string(),
-                }),
-                process: zod_openapi_1.z.object({
-                    pid: zod_openapi_1.z.number(),
-                    uptime: zod_openapi_1.z.number(),
-                    uptimeHuman: zod_openapi_1.z.string(),
-                    runtime: zod_openapi_1.z.string(),
-                    environment: zod_openapi_1.z.string(),
-                }),
-                memory: zod_openapi_1.z.object({ rss: zod_openapi_1.z.string(), heapUsed: zod_openapi_1.z.string(), heapTotal: zod_openapi_1.z.string() }),
-            })
-                .openapi({ description: 'HealthCheck Stats Schema' }),
-            description: 'Build stamp, process and memory - closed outside the development environments unless enabled',
-        }),
-    },
-    PING: {
-        method: common_1.HTTP.Methods.POST,
-        path: common_2.HealthCheckRestPaths.PING,
-        request: {
-            body: (0, ignis_kernel_1.jsonContent)({
-                description: 'PING | Request body',
-                schema: zod_openapi_1.z.object({
-                    type: zod_openapi_1.z.string().optional().default('PING'),
-                    message: zod_openapi_1.z.string().min(1).max(255),
-                }),
-            }),
-        },
-        responses: (0, ignis_kernel_1.jsonResponse)({
-            schema: zod_openapi_1.z
-                .object({
-                type: zod_openapi_1.z.string().optional().default('PONG'),
-                date: zod_openapi_1.z.iso.datetime(),
-                message: zod_openapi_1.z.string(),
-            })
-                .openapi({
-                description: 'HealthCheck PingPong Schema',
-                examples: [{ date: new Date().toISOString(), message: 'ok' }],
-            }),
-            description: 'HealthCheck PingPong Message',
-        }),
-    },
-};
-let HealthCheckController = HealthCheckController_1 = class HealthCheckController extends controllers_1.BaseRestController {
-    /**
-     * Both dependencies arrive through the container, so two applications in one process each get
-     * their own gate - a static field would let the last one to boot decide for every other.
-     */
-    constructor(healthOptions = {}, appInfo) {
-        super({ scope: HealthCheckController_1.name });
-        this.healthOptions = healthOptions;
-        this.appInfo = appInfo;
-        // Note: This is optional declare internal controller route definitions
-        this.definitions = RouteConfigs;
-    }
-    binding() {
-        // Public liveness probe: status and clock only. Nothing here names a runtime or a version.
-        this.bindRoute({ configs: RouteConfigs.ROOT }).to({
-            handler: (context) => {
-                return context.json(reporter_1.HealthCheckReporter.buildSummary(), common_1.HTTP.ResultCodes.RS_2.Ok);
-            },
-        });
-        if (!reporter_1.HealthCheckReporter.isStatsEnabled({ options: this.healthOptions })) {
-            this.logger
-                .for(this.binding.name)
-                .debug('Stats route disabled | path: %s', common_2.HealthCheckRestPaths.STATS);
-            return;
-        }
-        this.bindRoute({ configs: RouteConfigs.STATS }).to({
-            handler: (context) => {
-                // `context.notFound()`, not a thrown 404: it runs the application's own notFound handler,
-                // so the refusal is byte-identical to the answer for a route that was never mounted. A
-                // thrown `ApplicationError` serializes a different body and would confirm the route exists.
-                if (!reporter_1.HealthCheckReporter.isStatsAuthorized({
-                    options: this.healthOptions,
-                    header: context.req.header(common_2.HealthCheckHeaders.SECRET_KEY),
-                })) {
-                    return context.notFound();
-                }
-                return context.json(reporter_1.HealthCheckReporter.buildStats({ options: this.healthOptions, appInfo: this.appInfo }), common_1.HTTP.ResultCodes.RS_2.Ok);
-            },
-        });
-    }
-    // Method 3: Using 'decorators' to create a controller route, with an explicit type assertion for the validated request data
-    pingPong(context) {
-        const { message } = context.req.valid('json');
-        // Return type is automatically validated against the response schema
-        return context.json({ type: 'PONG', date: new Date().toISOString(), message }, common_1.HTTP.ResultCodes.RS_2.Ok);
-    }
-};
-exports.HealthCheckController = HealthCheckController;
-__decorate([
-    (0, metadata_1.api)({ configs: RouteConfigs.PING }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
-], HealthCheckController.prototype, "pingPong", null);
-exports.HealthCheckController = HealthCheckController = HealthCheckController_1 = __decorate([
-    __param(0, (0, metadata_1.inject)({ key: common_2.HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS, isOptional: true })),
-    __param(1, (0, metadata_1.inject)({ key: common_2.HealthCheckBindingKeys.APPLICATION_INFO, isOptional: true })),
-    __metadata("design:paramtypes", [Object, Object])
-], HealthCheckController);
-//# sourceMappingURL=controller.js.map

package/dist/components/health-check/controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/components/health-check/controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseRestController, type TRouteContext } from '@/base/controllers';\nimport { api, inject } from '@/base/metadata';\nimport { jsonContent, jsonResponse } from '@venizia/ignis-kernel';\nimport type { IApplicationInfo } from '@venizia/ignis-kernel';\nimport { z } from '@hono/zod-openapi';\nimport { HTTP, type ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport {\n  HealthCheckBindingKeys,\n  HealthCheckHeaders,\n  HealthCheckRestPaths,\n  type IHealthCheckOptions,\n} from './common';\nimport { HealthCheckReporter } from './reporter';\n\nconst RouteConfigs = {\n  ROOT: {\n    method: HTTP.Methods.GET,\n    path: HealthCheckRestPaths.ROOT,\n    responses: jsonResponse({\n      schema: z.object({ status: z.string(), timestamp: z.iso.datetime() }).openapi({\n        description: 'HealthCheck Schema',\n        examples: [{ status: 'ok', timestamp: new Date().toISOString() }],\n      }),\n      description: 'Health check status',\n    }),\n  },\n  STATS: {\n    method: HTTP.Methods.GET,\n    path: HealthCheckRestPaths.STATS,\n    request: {\n      headers: z.object({\n        [HealthCheckHeaders.SECRET_KEY]: z.string().optional().openapi({\n          description: 'The stats key',\n        }),\n      }),\n    },\n    responses: jsonResponse({\n      schema: z\n        .object({\n          status: z.string(),\n          timestamp: z.iso.datetime(),\n          build: z.object({\n            service: z.string(),\n            version: z.string(),\n            commit: z.string(),\n            branch: z.string(),\n            builtAt: z.string(),\n          }),\n          process: z.object({\n            pid: z.number(),\n            uptime: z.number(),\n            uptimeHuman: z.string(),\n            runtime: z.string(),\n            environment: z.string(),\n          }),\n          memory: z.object({ rss: z.string(), heapUsed: z.string(), heapTotal: z.string() }),\n        })\n        .openapi({ description: 'HealthCheck Stats Schema' }),\n      description:\n        'Build stamp, process and memory - closed outside the development environments unless enabled',\n    }),\n  },\n  PING: {\n    method: HTTP.Methods.POST,\n    path: HealthCheckRestPaths.PING,\n    request: {\n      body: jsonContent({\n        description: 'PING | Request body',\n        schema: z.object({\n          type: z.string().optional().default('PING'),\n          message: z.string().min(1).max(255),\n        }),\n      }),\n    },\n    responses: jsonResponse({\n      schema: z\n        .object({\n          type: z.string().optional().default('PONG'),\n          date: z.iso.datetime(),\n          message: z.string(),\n        })\n        .openapi({\n          description: 'HealthCheck PingPong Schema',\n          examples: [{ date: new Date().toISOString(), message: 'ok' }],\n        }),\n      description: 'HealthCheck PingPong Message',\n    }),\n  },\n} as const;\n\nexport class HealthCheckController extends BaseRestController {\n  /**\n   * Both dependencies arrive through the container, so two applications in one process each get\n   * their own gate - a static field would let the last one to boot decide for every other.\n   */\n  constructor(\n    @inject({ key: HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS, isOptional: true })\n    private readonly healthOptions: IHealthCheckOptions = {},\n    @inject({ key: HealthCheckBindingKeys.APPLICATION_INFO, isOptional: true })\n    private readonly appInfo?: IApplicationInfo,\n  ) {\n    super({ scope: HealthCheckController.name });\n\n    // Note: This is optional declare internal controller route definitions\n    this.definitions = RouteConfigs;\n  }\n\n  override binding(): ValueOrPromise<void> {\n    // Public liveness probe: status and clock only. Nothing here names a runtime or a version.\n    this.bindRoute({ configs: RouteConfigs.ROOT }).to({\n      handler: (context) => {\n        return context.json(HealthCheckReporter.buildSummary(), HTTP.ResultCodes.RS_2.Ok);\n      },\n    });\n\n    if (!HealthCheckReporter.isStatsEnabled({ options: this.healthOptions })) {\n      this.logger\n        .for(this.binding.name)\n        .debug('Stats route disabled | path: %s', HealthCheckRestPaths.STATS);\n      return;\n    }\n\n    this.bindRoute({ configs: RouteConfigs.STATS }).to({\n      handler: (context) => {\n        // `context.notFound()`, not a thrown 404: it runs the application's own notFound handler,\n        // so the refusal is byte-identical to the answer for a route that was never mounted. A\n        // thrown `ApplicationError` serializes a different body and would confirm the route exists.\n        if (\n          !HealthCheckReporter.isStatsAuthorized({\n            options: this.healthOptions,\n            header: context.req.header(HealthCheckHeaders.SECRET_KEY),\n          })\n        ) {\n          return context.notFound();\n        }\n\n        return context.json(\n          HealthCheckReporter.buildStats({ options: this.healthOptions, appInfo: this.appInfo }),\n          HTTP.ResultCodes.RS_2.Ok,\n        );\n      },\n    });\n  }\n\n  // Method 3: Using 'decorators' to create a controller route, with an explicit type assertion for the validated request data\n  @api({ configs: RouteConfigs.PING })\n  pingPong(context: TRouteContext) {\n    const { message } = context.req.valid<{ type?: string; message: string }>('json');\n\n    // Return type is automatically validated against the response schema\n    return context.json(\n      { type: 'PONG', date: new Date().toISOString(), message },\n      HTTP.ResultCodes.RS_2.Ok,\n    );\n  }\n}\n"]}

package/dist/components/health-check/index.d.ts

@@ -1,5 +0,0 @@
-export * from './common';
-export * from './component';
-export * from './controller';
-export * from './reporter';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/health-check/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/health-check/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/components/health-check/index.js

@@ -1,21 +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("./common"), exports);
-__exportStar(require("./component"), exports);
-__exportStar(require("./controller"), exports);
-__exportStar(require("./reporter"), exports);
-//# sourceMappingURL=index.js.map

package/dist/components/health-check/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/health-check/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B","sourcesContent":["export * from './common';\nexport * from './component';\nexport * from './controller';\nexport * from './reporter';\n"]}

package/dist/components/health-check/reporter.d.ts

@@ -1,98 +0,0 @@
-import { type TBuildInfoRecord } from '@venizia/ignis-helpers/core';
-import type { IApplicationInfo } from '@venizia/ignis-kernel';
-import type { IHealthCheckOptions } from './common';
-/**
- * Assembles what `GET /health` and `GET /health/stats` answer.
- *
- * Never reads the filesystem and never spawns `git`: the build stamp is PUSHED in at the
- * entrypoint through {@link BuildInfoRegistry} (or the component's own options), so a
- * `bun build --compile` binary and a Distroless image - neither of which has `node_modules`,
- * `.git` or a readable `package.json` - report exactly what a dev machine does.
- */
-export declare class HealthCheckReporter {
-    private static readonly BYTES_PER_MB;
-    /** Public liveness answer: liveness and the server clock, nothing a probe cannot already see. */
-    static buildSummary(): {
-        status: string;
-        timestamp: string;
-    };
-    /**
-     * Fail-closed, copying `AppErrorMiddleware.isProduction`: the default is MEMBERSHIP in
-     * `DEVELOPMENT_ENVS`, never inequality against `production`. `staging`, `uat`, `alpha` and a
-     * typo all keep this route shut, because the runtime and release it names are what picks an
-     * exploit. `ambient`, not `current`: an unset `NODE_ENV` is a host that cannot prove it is a dev
-     * machine, and `current` would mask it as `development`.
-     *
-     * `enable` is compared to `true`/`false` rather than read through `??`: this binding is
-     * env/config driven, and a JSON-derived `"false"` is truthy - an operator who wrote false would
-     * otherwise get the route mounted.
-     */
-    static isStatsEnabled(opts: {
-        options: IHealthCheckOptions;
-        /** Reads the ambient environment; injected by tests so nothing has to write `process.env`. */
-        environment?: () => string | undefined;
-    }): boolean;
-    /**
-     * No `secretKey` configured leaves the route open to whatever can reach the port - stated, not
-     * implied. Anything that is not a non-blank string fails CLOSED: a blank or config-derived
-     * non-string key is a pipeline that lost the variable, and reading it as "no key" would publish
-     * the route the operator meant to lock.
-     *
-     * The comparison is a plain `===`: a remote timing attack on a header compare is not practical
-     * through an HTTP stack, and a constant-time digest compare would buy nothing here.
-     */
-    /**
-     * Whether the stats route is mounted, unauthenticated, and on a host that cannot be shown to be a
-     * development one. That combination stays LEGAL - on a cluster-internal port it is often the right
-     * call - so this reports rather than refuses, and the component turns it into one warning at boot.
-     *
-     * It exists because `enable: true` bypasses the environment gate entirely: an operator who sets it
-     * for a local run and ships the same code publishes the runtime version, the release and the
-     * memory profile to whatever can reach the port. A blank `secretKey` is NOT unguarded - that fails
-     * closed in {@link isStatsAuthorized}.
-     */
-    static isStatsUnguarded(opts: {
-        options: IHealthCheckOptions;
-        environment?: () => string | undefined;
-    }): boolean;
-    static isStatsAuthorized(opts: {
-        options: IHealthCheckOptions;
-        header?: string;
-    }): boolean;
-    /** The slot is a process-wide `globalThis` entry any dependency can write, and `IBuildInfo` types it without checking - so a non-string never reaches the response schema, which declares `z.string()`. */
-    private static extractText;
-    /**
-     * Explicit options win over the registry, and the application's own `getAppInfo()` fills what
-     * neither carries - so a host that ran no generator still reports its real name and version.
-     */
-    static resolveBuildInfo(opts: {
-        options: IHealthCheckOptions;
-        appInfo?: IApplicationInfo;
-    }): TBuildInfoRecord;
-    /** `3661` -> `1h 1m 1s`: an operator reads a restart out of this faster than out of a float. */
-    static toHumanUptime(opts: {
-        seconds: number;
-    }): string;
-    private static toMegabytes;
-    static buildStats(opts: {
-        options: IHealthCheckOptions;
-        appInfo?: IApplicationInfo;
-    }): {
-        build: Required<import("@venizia/ignis-helpers").IBuildInfo>;
-        process: {
-            pid: number;
-            uptime: number;
-            uptimeHuman: string;
-            runtime: string;
-            environment: string;
-        };
-        memory: {
-            rss: string;
-            heapUsed: string;
-            heapTotal: string;
-        };
-        status: string;
-        timestamp: string;
-    };
-}
-//# sourceMappingURL=reporter.d.ts.map

package/dist/components/health-check/reporter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/components/health-check/reporter.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAe;IAEnD,iGAAiG;IACjG,MAAM,CAAC,YAAY,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAI5D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAC1B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,8FAA8F;QAC9F,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;KACxC,GAAG,OAAO;IAcX;;;;;;;;OAQG;IACH;;;;;;;;;OASG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;KACxC,GAAG,OAAO;IAiBX,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,mBAAmB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAa1F,2MAA2M;IAC3M,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,OAAO,CAAC,EAAE,gBAAgB,CAAC;KAC5B,GAAG,gBAAgB;IAepB,gGAAgG;IAChG,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IASvD,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,mBAAmB,CAAC;QAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAE;;;;;;;;;;;;;;gBA9HnD,MAAM;mBAAa,MAAM;;CAqJ3D"}

package/dist/components/health-check/reporter.js

@@ -1,138 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HealthCheckReporter = void 0;
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const core_1 = require("@venizia/ignis-helpers/core");
-/**
- * Assembles what `GET /health` and `GET /health/stats` answer.
- *
- * Never reads the filesystem and never spawns `git`: the build stamp is PUSHED in at the
- * entrypoint through {@link BuildInfoRegistry} (or the component's own options), so a
- * `bun build --compile` binary and a Distroless image - neither of which has `node_modules`,
- * `.git` or a readable `package.json` - report exactly what a dev machine does.
- */
-class HealthCheckReporter {
-    static { this.BYTES_PER_MB = 1024 * 1024; }
-    /** Public liveness answer: liveness and the server clock, nothing a probe cannot already see. */
-    static buildSummary() {
-        return { status: 'ok', timestamp: new Date().toISOString() };
-    }
-    /**
-     * Fail-closed, copying `AppErrorMiddleware.isProduction`: the default is MEMBERSHIP in
-     * `DEVELOPMENT_ENVS`, never inequality against `production`. `staging`, `uat`, `alpha` and a
-     * typo all keep this route shut, because the runtime and release it names are what picks an
-     * exploit. `ambient`, not `current`: an unset `NODE_ENV` is a host that cannot prove it is a dev
-     * machine, and `current` would mask it as `development`.
-     *
-     * `enable` is compared to `true`/`false` rather than read through `??`: this binding is
-     * env/config driven, and a JSON-derived `"false"` is truthy - an operator who wrote false would
-     * otherwise get the route mounted.
-     */
-    static isStatsEnabled(opts) {
-        const { enable } = opts.options.stats ?? {};
-        if (typeof enable === 'boolean') {
-            return enable;
-        }
-        const ambient = opts.environment ? opts.environment() : ignis_helpers_1.Environment.ambient;
-        if (ambient === undefined) {
-            return false;
-        }
-        return ignis_helpers_1.Environment.DEVELOPMENT_ENVS.has(ambient.toLowerCase());
-    }
-    /**
-     * No `secretKey` configured leaves the route open to whatever can reach the port - stated, not
-     * implied. Anything that is not a non-blank string fails CLOSED: a blank or config-derived
-     * non-string key is a pipeline that lost the variable, and reading it as "no key" would publish
-     * the route the operator meant to lock.
-     *
-     * The comparison is a plain `===`: a remote timing attack on a header compare is not practical
-     * through an HTTP stack, and a constant-time digest compare would buy nothing here.
-     */
-    /**
-     * Whether the stats route is mounted, unauthenticated, and on a host that cannot be shown to be a
-     * development one. That combination stays LEGAL - on a cluster-internal port it is often the right
-     * call - so this reports rather than refuses, and the component turns it into one warning at boot.
-     *
-     * It exists because `enable: true` bypasses the environment gate entirely: an operator who sets it
-     * for a local run and ships the same code publishes the runtime version, the release and the
-     * memory profile to whatever can reach the port. A blank `secretKey` is NOT unguarded - that fails
-     * closed in {@link isStatsAuthorized}.
-     */
-    static isStatsUnguarded(opts) {
-        if (!HealthCheckReporter.isStatsEnabled(opts)) {
-            return false;
-        }
-        if (opts.options.stats?.secretKey !== undefined) {
-            return false;
-        }
-        const ambient = opts.environment ? opts.environment() : ignis_helpers_1.Environment.ambient;
-        if (ambient === undefined) {
-            return true;
-        }
-        return !ignis_helpers_1.Environment.DEVELOPMENT_ENVS.has(ambient.toLowerCase());
-    }
-    static isStatsAuthorized(opts) {
-        const secretKey = opts.options.stats?.secretKey;
-        if (secretKey === undefined) {
-            return true;
-        }
-        if (typeof secretKey !== 'string' || secretKey.trim().length === 0) {
-            return false;
-        }
-        return opts.header === secretKey;
-    }
-    /** The slot is a process-wide `globalThis` entry any dependency can write, and `IBuildInfo` types it without checking - so a non-string never reaches the response schema, which declares `z.string()`. */
-    static extractText(opts) {
-        return typeof opts.value === 'string' && opts.value.length > 0 ? opts.value : undefined;
-    }
-    /**
-     * Explicit options win over the registry, and the application's own `getAppInfo()` fills what
-     * neither carries - so a host that ran no generator still reports its real name and version.
-     */
-    static resolveBuildInfo(opts) {
-        const stamp = opts.options.stats?.buildInfo ?? core_1.BuildInfoRegistry.get() ?? {};
-        const extract = HealthCheckReporter.extractText;
-        return {
-            service: extract({ value: stamp.service }) ?? opts.appInfo?.name ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-            version: extract({ value: stamp.version }) ?? opts.appInfo?.version ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-            commit: extract({ value: stamp.commit }) ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-            branch: extract({ value: stamp.branch }) ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-            builtAt: extract({ value: stamp.builtAt }) ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-        };
-    }
-    /** `3661` -> `1h 1m 1s`: an operator reads a restart out of this faster than out of a float. */
-    static toHumanUptime(opts) {
-        const total = Math.floor(opts.seconds);
-        const hours = Math.floor(total / 3600);
-        const minutes = Math.floor((total % 3600) / 60);
-        const seconds = total % 60;
-        return `${hours}h ${minutes}m ${seconds}s`;
-    }
-    static toMegabytes(opts) {
-        return `${(opts.bytes / HealthCheckReporter.BYTES_PER_MB).toFixed(1)} MB`;
-    }
-    static buildStats(opts) {
-        const memory = process.memoryUsage();
-        const uptime = process.uptime();
-        return {
-            ...HealthCheckReporter.buildSummary(),
-            build: HealthCheckReporter.resolveBuildInfo(opts),
-            process: {
-                pid: process.pid,
-                uptime,
-                uptimeHuman: HealthCheckReporter.toHumanUptime({ seconds: uptime }),
-                // `versions.node` carries no `v` prefix, so both runtimes read `<name> <semver>`.
-                runtime: ignis_helpers_1.RuntimeModules.isBun() ? `bun ${Bun.version}` : `node ${process.versions.node}`,
-                // `ambient`, not `current`: an unset `NODE_ENV` is reported as such, never dressed up as `development`.
-                environment: ignis_helpers_1.Environment.ambient ?? core_1.BuildInfoRegistry.UNSPECIFIED,
-            },
-            memory: {
-                rss: HealthCheckReporter.toMegabytes({ bytes: memory.rss }),
-                heapUsed: HealthCheckReporter.toMegabytes({ bytes: memory.heapUsed }),
-                heapTotal: HealthCheckReporter.toMegabytes({ bytes: memory.heapTotal }),
-            },
-        };
-    }
-}
-exports.HealthCheckReporter = HealthCheckReporter;
-//# sourceMappingURL=reporter.js.map

package/dist/components/health-check/reporter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../src/components/health-check/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { Environment, RuntimeModules } from '@venizia/ignis-helpers';\nimport { BuildInfoRegistry, type TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport type { IApplicationInfo } from '@venizia/ignis-kernel';\nimport type { IHealthCheckOptions } from './common';\n\n/**\n * Assembles what `GET /health` and `GET /health/stats` answer.\n *\n * Never reads the filesystem and never spawns `git`: the build stamp is PUSHED in at the\n * entrypoint through {@link BuildInfoRegistry} (or the component's own options), so a\n * `bun build --compile` binary and a Distroless image - neither of which has `node_modules`,\n * `.git` or a readable `package.json` - report exactly what a dev machine does.\n */\nexport class HealthCheckReporter {\n  private static readonly BYTES_PER_MB = 1024 * 1024;\n\n  /** Public liveness answer: liveness and the server clock, nothing a probe cannot already see. */\n  static buildSummary(): { status: string; timestamp: string } {\n    return { status: 'ok', timestamp: new Date().toISOString() };\n  }\n\n  /**\n   * Fail-closed, copying `AppErrorMiddleware.isProduction`: the default is MEMBERSHIP in\n   * `DEVELOPMENT_ENVS`, never inequality against `production`. `staging`, `uat`, `alpha` and a\n   * typo all keep this route shut, because the runtime and release it names are what picks an\n   * exploit. `ambient`, not `current`: an unset `NODE_ENV` is a host that cannot prove it is a dev\n   * machine, and `current` would mask it as `development`.\n   *\n   * `enable` is compared to `true`/`false` rather than read through `??`: this binding is\n   * env/config driven, and a JSON-derived `\"false\"` is truthy - an operator who wrote false would\n   * otherwise get the route mounted.\n   */\n  static isStatsEnabled(opts: {\n    options: IHealthCheckOptions;\n    /** Reads the ambient environment; injected by tests so nothing has to write `process.env`. */\n    environment?: () => string | undefined;\n  }): boolean {\n    const { enable } = opts.options.stats ?? {};\n    if (typeof enable === 'boolean') {\n      return enable;\n    }\n\n    const ambient = opts.environment ? opts.environment() : Environment.ambient;\n    if (ambient === undefined) {\n      return false;\n    }\n\n    return Environment.DEVELOPMENT_ENVS.has(ambient.toLowerCase());\n  }\n\n  /**\n   * No `secretKey` configured leaves the route open to whatever can reach the port - stated, not\n   * implied. Anything that is not a non-blank string fails CLOSED: a blank or config-derived\n   * non-string key is a pipeline that lost the variable, and reading it as \"no key\" would publish\n   * the route the operator meant to lock.\n   *\n   * The comparison is a plain `===`: a remote timing attack on a header compare is not practical\n   * through an HTTP stack, and a constant-time digest compare would buy nothing here.\n   */\n  /**\n   * Whether the stats route is mounted, unauthenticated, and on a host that cannot be shown to be a\n   * development one. That combination stays LEGAL - on a cluster-internal port it is often the right\n   * call - so this reports rather than refuses, and the component turns it into one warning at boot.\n   *\n   * It exists because `enable: true` bypasses the environment gate entirely: an operator who sets it\n   * for a local run and ships the same code publishes the runtime version, the release and the\n   * memory profile to whatever can reach the port. A blank `secretKey` is NOT unguarded - that fails\n   * closed in {@link isStatsAuthorized}.\n   */\n  static isStatsUnguarded(opts: {\n    options: IHealthCheckOptions;\n    environment?: () => string | undefined;\n  }): boolean {\n    if (!HealthCheckReporter.isStatsEnabled(opts)) {\n      return false;\n    }\n\n    if (opts.options.stats?.secretKey !== undefined) {\n      return false;\n    }\n\n    const ambient = opts.environment ? opts.environment() : Environment.ambient;\n    if (ambient === undefined) {\n      return true;\n    }\n\n    return !Environment.DEVELOPMENT_ENVS.has(ambient.toLowerCase());\n  }\n\n  static isStatsAuthorized(opts: { options: IHealthCheckOptions; header?: string }): boolean {\n    const secretKey = opts.options.stats?.secretKey;\n    if (secretKey === undefined) {\n      return true;\n    }\n\n    if (typeof secretKey !== 'string' || secretKey.trim().length === 0) {\n      return false;\n    }\n\n    return opts.header === secretKey;\n  }\n\n  /** The slot is a process-wide `globalThis` entry any dependency can write, and `IBuildInfo` types it without checking - so a non-string never reaches the response schema, which declares `z.string()`. */\n  private static extractText(opts: { value: unknown }): string | undefined {\n    return typeof opts.value === 'string' && opts.value.length > 0 ? opts.value : undefined;\n  }\n\n  /**\n   * Explicit options win over the registry, and the application's own `getAppInfo()` fills what\n   * neither carries - so a host that ran no generator still reports its real name and version.\n   */\n  static resolveBuildInfo(opts: {\n    options: IHealthCheckOptions;\n    appInfo?: IApplicationInfo;\n  }): TBuildInfoRecord {\n    const stamp = opts.options.stats?.buildInfo ?? BuildInfoRegistry.get() ?? {};\n    const extract = HealthCheckReporter.extractText;\n\n    return {\n      service:\n        extract({ value: stamp.service }) ?? opts.appInfo?.name ?? BuildInfoRegistry.UNSPECIFIED,\n      version:\n        extract({ value: stamp.version }) ?? opts.appInfo?.version ?? BuildInfoRegistry.UNSPECIFIED,\n      commit: extract({ value: stamp.commit }) ?? BuildInfoRegistry.UNSPECIFIED,\n      branch: extract({ value: stamp.branch }) ?? BuildInfoRegistry.UNSPECIFIED,\n      builtAt: extract({ value: stamp.builtAt }) ?? BuildInfoRegistry.UNSPECIFIED,\n    };\n  }\n\n  /** `3661` -> `1h 1m 1s`: an operator reads a restart out of this faster than out of a float. */\n  static toHumanUptime(opts: { seconds: number }): string {\n    const total = Math.floor(opts.seconds);\n    const hours = Math.floor(total / 3600);\n    const minutes = Math.floor((total % 3600) / 60);\n    const seconds = total % 60;\n\n    return `${hours}h ${minutes}m ${seconds}s`;\n  }\n\n  private static toMegabytes(opts: { bytes: number }): string {\n    return `${(opts.bytes / HealthCheckReporter.BYTES_PER_MB).toFixed(1)} MB`;\n  }\n\n  static buildStats(opts: { options: IHealthCheckOptions; appInfo?: IApplicationInfo }) {\n    const memory = process.memoryUsage();\n    const uptime = process.uptime();\n\n    return {\n      ...HealthCheckReporter.buildSummary(),\n      build: HealthCheckReporter.resolveBuildInfo(opts),\n      process: {\n        pid: process.pid,\n        uptime,\n        uptimeHuman: HealthCheckReporter.toHumanUptime({ seconds: uptime }),\n        // `versions.node` carries no `v` prefix, so both runtimes read `<name> <semver>`.\n        runtime: RuntimeModules.isBun() ? `bun ${Bun.version}` : `node ${process.versions.node}`,\n        // `ambient`, not `current`: an unset `NODE_ENV` is reported as such, never dressed up as `development`.\n        environment: Environment.ambient ?? BuildInfoRegistry.UNSPECIFIED,\n      },\n      memory: {\n        rss: HealthCheckReporter.toMegabytes({ bytes: memory.rss }),\n        heapUsed: HealthCheckReporter.toMegabytes({ bytes: memory.heapUsed }),\n        heapTotal: HealthCheckReporter.toMegabytes({ bytes: memory.heapTotal }),\n      },\n    };\n  }\n}\n"]}

package/dist/components/index.d.ts

@@ -1,6 +0,0 @@
-export * from './auth';
-export * from './controller';
-export * from './health-check';
-export * from './request-tracker';
-export * from './api-reference';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/components/index.js

@@ -1,23 +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("./auth"), exports);
-__exportStar(require("./controller"), exports);
-__exportStar(require("./health-check"), exports);
-__exportStar(require("./request-tracker"), exports);
-__exportStar(require("./api-reference"), exports);
-// Excluded from the barrel - import directly from the subpath: mail, socket-io, static-asset, websocket
-//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,iDAA+B;AAC/B,oDAAkC;AAClC,kDAAgC;AAEhC,wGAAwG","sourcesContent":["export * from './auth';\nexport * from './controller';\nexport * from './health-check';\nexport * from './request-tracker';\nexport * from './api-reference';\n\n// Excluded from the barrel - import directly from the subpath: mail, socket-io, static-asset, websocket\n"]}

package/dist/components/mail/common/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,iBAAiB,KAAK;IACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,yBAAyB;IACtD,mFAAmF;IACnF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,SAAoB;CACzD;AAED,yKAAyK;AACzK,qBAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,qBAAqB,SAElC;IACH,MAAM,CAAC,QAAQ,CAAC,WAAW,SAAiE;IAC5F,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAEhC;IACH,MAAM,CAAC,QAAQ,CAAC,iBAAiB,SAE9B;IACH,MAAM,CAAC,QAAQ,CAAC,iBAAiB,SAE9B;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,SAE/B;IACH,MAAM,CAAC,QAAQ,CAAC,uBAAuB,SAEpC;IACH,MAAM,CAAC,QAAQ,CAAC,oBAAoB,SAEjC;IACH,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAEhC;CACJ;AAED,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,QAAQ,CAAC,iBAAiB,mDAAmD;CACrF;AAED,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAoE;IAC9F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAmE;IAC3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;CAC3C;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,iHAAiH;AACjH,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAmD;IAE7E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/components/mail/common/constants.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MailBackoffTypes = exports.MailProviders = exports.BullMQExecutorModes = exports.MailQueueExecutorTypes = exports.MailExecutorErrors = exports.MailErrorCodes = exports.MailDefaults = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-class MailDefaults {
-    static { this.BATCH_CONCURRENCY = 5; }
-    static { this.FALLBACK_FROM = 'noreply@example.com'; }
-    /** Bytes of attachment content one message may carry, all attachments together. */
-    static { this.MAX_ATTACHMENT_BYTES = 25 * 1024 * 1024; }
-}
-exports.MailDefaults = MailDefaults;
-/** Built via {@link MessageCode.build}: `ApplicationError` lower-cases codes, so a SCREAMING_CASE literal would reach the client in a spelling no const here matches. */
-class MailErrorCodes {
-    static { this.INVALID_CONFIGURATION = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'invalid_configuration'],
-    }); }
-    static { this.SEND_FAILED = core_1.MessageCode.build({ parts: ['core', 'mail', 'send_failed'] }); }
-    static { this.VERIFICATION_FAILED = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'verification_failed'],
-    }); }
-    static { this.INVALID_RECIPIENT = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'invalid_recipient'],
-    }); }
-    static { this.BATCH_SEND_FAILED = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'batch_send_failed'],
-    }); }
-    static { this.TEMPLATE_NOT_FOUND = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'template_not_found'],
-    }); }
-    static { this.ATTACHMENT_PATH_REFUSED = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'attachment_path_refused'],
-    }); }
-    static { this.ATTACHMENT_TOO_LARGE = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'attachment_too_large'],
-    }); }
-    static { this.BODY_SOURCE_REFUSED = core_1.MessageCode.build({
-        parts: ['core', 'mail', 'body_source_refused'],
-    }); }
-}
-exports.MailErrorCodes = MailErrorCodes;
-class MailExecutorErrors {
-    static { this.PROCESSOR_NOT_SET = 'Processor not set. Call setProcessor() first.'; }
-}
-exports.MailExecutorErrors = MailExecutorErrors;
-class MailQueueExecutorTypes {
-    static { this.DIRECT = 'direct'; }
-    static { this.INTERNAL_QUEUE = 'internal-queue'; }
-    static { this.BULLMQ = 'bullmq'; }
-    static { this.SCHEME_SET = new Set([this.DIRECT, this.INTERNAL_QUEUE, this.BULLMQ]); }
-    static isValid(value) {
-        return this.SCHEME_SET.has(value);
-    }
-}
-exports.MailQueueExecutorTypes = MailQueueExecutorTypes;
-class BullMQExecutorModes {
-    static { this.QUEUE_ONLY = 'queue-only'; }
-    static { this.WORKER_ONLY = 'worker-only'; }
-    static { this.BOTH = 'both'; }
-    static { this.MODE_SET = new Set([this.QUEUE_ONLY, this.WORKER_ONLY, this.BOTH]); }
-    static isValid(value) {
-        return this.MODE_SET.has(value);
-    }
-}
-exports.BullMQExecutorModes = BullMQExecutorModes;
-class MailProviders {
-    static { this.NODEMAILER = 'nodemailer'; }
-    static { this.MAILGUN = 'mailgun'; }
-    static { this.CUSTOM = 'custom'; }
-    // Amazon SES supports both SMTP and HTTPS - this provider is the HTTPS API path; SMTP goes through NODEMAILER instead.
-    static { this.AMAZON_SES = 'amazon-ses'; }
-}
-exports.MailProviders = MailProviders;
-/** How the delay between two attempts to send a queued mail grows: FIXED stays the same, EXPONENTIAL doubles. */
-class MailBackoffTypes {
-    static { this.FIXED = 'fixed'; }
-    static { this.EXPONENTIAL = 'exponential'; }
-    static { this.SCHEME_SET = new Set([this.FIXED, this.EXPONENTIAL]); }
-    static isValid(value) {
-        return this.SCHEME_SET.has(value);
-    }
-}
-exports.MailBackoffTypes = MailBackoffTypes;
-//# sourceMappingURL=constants.js.map

package/dist/components/mail/common/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/components/mail/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport { MessageCode } from '@venizia/ignis-helpers/core';\n\nexport class MailDefaults {\n  static readonly BATCH_CONCURRENCY = 5;\n  static readonly FALLBACK_FROM = 'noreply@example.com';\n  /** Bytes of attachment content one message may carry, all attachments together. */\n  static readonly MAX_ATTACHMENT_BYTES = 25 * 1024 * 1024;\n}\n\n/** Built via {@link MessageCode.build}: `ApplicationError` lower-cases codes, so a SCREAMING_CASE literal would reach the client in a spelling no const here matches. */\nexport class MailErrorCodes {\n  static readonly INVALID_CONFIGURATION = MessageCode.build({\n    parts: ['core', 'mail', 'invalid_configuration'],\n  });\n  static readonly SEND_FAILED = MessageCode.build({ parts: ['core', 'mail', 'send_failed'] });\n  static readonly VERIFICATION_FAILED = MessageCode.build({\n    parts: ['core', 'mail', 'verification_failed'],\n  });\n  static readonly INVALID_RECIPIENT = MessageCode.build({\n    parts: ['core', 'mail', 'invalid_recipient'],\n  });\n  static readonly BATCH_SEND_FAILED = MessageCode.build({\n    parts: ['core', 'mail', 'batch_send_failed'],\n  });\n  static readonly TEMPLATE_NOT_FOUND = MessageCode.build({\n    parts: ['core', 'mail', 'template_not_found'],\n  });\n  static readonly ATTACHMENT_PATH_REFUSED = MessageCode.build({\n    parts: ['core', 'mail', 'attachment_path_refused'],\n  });\n  static readonly ATTACHMENT_TOO_LARGE = MessageCode.build({\n    parts: ['core', 'mail', 'attachment_too_large'],\n  });\n  static readonly BODY_SOURCE_REFUSED = MessageCode.build({\n    parts: ['core', 'mail', 'body_source_refused'],\n  });\n}\n\nexport class MailExecutorErrors {\n  static readonly PROCESSOR_NOT_SET = 'Processor not set. Call setProcessor() first.';\n}\n\nexport class MailQueueExecutorTypes {\n  static readonly DIRECT = 'direct';\n  static readonly INTERNAL_QUEUE = 'internal-queue';\n  static readonly BULLMQ = 'bullmq';\n\n  static readonly SCHEME_SET = new Set<string>([this.DIRECT, this.INTERNAL_QUEUE, this.BULLMQ]);\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport class BullMQExecutorModes {\n  static readonly QUEUE_ONLY = 'queue-only';\n  static readonly WORKER_ONLY = 'worker-only';\n  static readonly BOTH = 'both';\n\n  static readonly MODE_SET = new Set<string>([this.QUEUE_ONLY, this.WORKER_ONLY, this.BOTH]);\n  static isValid(value: string): boolean {\n    return this.MODE_SET.has(value);\n  }\n}\n\nexport class MailProviders {\n  static readonly NODEMAILER = 'nodemailer';\n  static readonly MAILGUN = 'mailgun';\n  static readonly CUSTOM = 'custom';\n  // Amazon SES supports both SMTP and HTTPS - this provider is the HTTPS API path; SMTP goes through NODEMAILER instead.\n  static readonly AMAZON_SES = 'amazon-ses';\n}\n\nexport type TMailProvider = TConstValue<typeof MailProviders>;\n\n/** How the delay between two attempts to send a queued mail grows: FIXED stays the same, EXPONENTIAL doubles. */\nexport class MailBackoffTypes {\n  static readonly FIXED = 'fixed';\n  static readonly EXPONENTIAL = 'exponential';\n\n  static readonly SCHEME_SET = new Set<string>([this.FIXED, this.EXPONENTIAL]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\n/** Valid mail backoff type values. */\nexport type TMailBackoffType = TConstValue<typeof MailBackoffTypes>;\n"]}

package/dist/components/mail/common/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/common/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAIrF,oPAAoP;AACpP,qTAAqT;AACrT,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;IAgBrB,gIAAgI;;;;;;;;;;;;;;;;;;;;;;;;;CAsB7E,CAAC;AAEtD,2GAA2G;AAC3G,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,iBAAkB,SAAQ,eAAe,CAAC,OAAO,UAAU,CAAC;KAAG;CAC1E"}