@gobing-ai/ts-infra 0.3.4 → 0.3.6

package/dist/application-node.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Node/Bun convenience bootstrap for `@gobing-ai/ts-infra`.
+ *
+ * Composes the portable `runApplication` with runtime-specific wiring:
+ * - YAML config loading via `@gobing-ai/ts-runtime`
+ * - Application-specific config validation with caller-provided validator
+ * - File log sink via `node:fs`
+ * - Bun SQLite DB adapter creation from config
+ * - Optional Node OTel exporter initialization
+ * - Optional Node scheduler adapter
+ *
+ * This subpath may import runtime-specific adapters. The portable bootstrap
+ * subpath (`@gobing-ai/ts-infra/application`) must not.
+ *
+ * @module application-node
+ */
+import type { ApplicationBootstrapOptions, ApplicationConfigLoader, ApplicationRuntime, ApplicationStopReason, EventMap, InfraEvents } from './application/types';
+/** Error thrown when application config validation fails. Includes file path and section name. */
+export declare class ConfigValidationError extends Error {
+    constructor(message: string);
+}
+/** Options for the Node/Bun convenience {@link runNodeApplication}. */
+export interface NodeApplicationOptions<TAppConfig = unknown, TEvents extends EventMap = InfraEvents> {
+    /** YAML config loading options. When omitted, uses defaults. */
+    readonly configLoader?: ApplicationConfigLoader<TAppConfig>;
+    /** Inline bootstrap config (overrides YAML-loaded config). */
+    readonly config?: ApplicationBootstrapOptions<TAppConfig, TEvents>['config'];
+    /** Pre-built services to inject. */
+    readonly services?: ApplicationBootstrapOptions<TAppConfig, TEvents>['services'];
+    /** User callback: application logic. */
+    readonly start: (app: ApplicationRuntime<TAppConfig, TEvents>) => Promise<void> | void;
+    /** User callback: cleanup before services shut down. */
+    readonly stop?: (app: ApplicationRuntime<TAppConfig, TEvents>, reason: ApplicationStopReason) => Promise<void> | void;
+}
+/**
+ * Node/Bun convenience application bootstrap.
+ *
+ * Extends the portable `runApplication` with:
+ * - YAML config file loading with section splitting
+ * - Application-specific config validation
+ * - File log sink creation from `logging.filePath`
+ * - Bun SQLite DB adapter creation when `database.enabled` + `database.driver`
+ * - Optional Node OTel telemetry exporter
+ * - Optional Node scheduler adapter
+ *
+ * @example
+ * ```ts
+ * import { runNodeApplication } from '@gobing-ai/ts-infra/application-node';
+ *
+ * await runNodeApplication({
+ *     configLoader: {
+ *         configFile: 'config/app.yaml',
+ *         bootstrapSection: 'bootstrap',
+ *         appSection: 'billing',
+ *         appConfig: {
+ *             safeParse(raw) {
+ *                 return billingSchema.safeParse(raw);
+ *             },
+ *         },
+ *     },
+ *     async start(app) {
+ *         app.logger.info('started');
+ *     },
+ * });
+ * ```
+ */
+export declare function runNodeApplication<TAppConfig = unknown, TEvents extends EventMap = InfraEvents>(options: NodeApplicationOptions<TAppConfig, TEvents>): Promise<ApplicationRuntime<TAppConfig, TEvents>>;
+//# sourceMappingURL=application-node.d.ts.map

package/dist/application-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-node.d.ts","sourceRoot":"","sources":["../src/application-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EACR,2BAA2B,EAC3B,uBAAuB,EAEvB,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,WAAW,EAId,MAAM,qBAAqB,CAAC;AAM7B,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAgHD,uEAAuE;AACvE,MAAM,WAAW,sBAAsB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW;IAChG,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7E,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACjF,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvF,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,CACZ,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAC5C,MAAM,EAAE,qBAAqB,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,GAAG,OAAO,EAAE,OAAO,SAAS,QAAQ,GAAG,WAAW,EACjG,OAAO,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CA8FlD"}

package/dist/application-node.js

@@ -0,0 +1,228 @@
+/**
+ * Node/Bun convenience bootstrap for `@gobing-ai/ts-infra`.
+ *
+ * Composes the portable `runApplication` with runtime-specific wiring:
+ * - YAML config loading via `@gobing-ai/ts-runtime`
+ * - Application-specific config validation with caller-provided validator
+ * - File log sink via `node:fs`
+ * - Bun SQLite DB adapter creation from config
+ * - Optional Node OTel exporter initialization
+ * - Optional Node scheduler adapter
+ *
+ * This subpath may import runtime-specific adapters. The portable bootstrap
+ * subpath (`@gobing-ai/ts-infra/application`) must not.
+ *
+ * @module application-node
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createDbAdapter } from '@gobing-ai/ts-db';
+import { interpolateTree, parseYamlObject } from '@gobing-ai/ts-runtime';
+import { runApplication } from './application/index.js';
+import { dbPlugin } from './application/plugins/builtins.js';
+import { NodeSchedulerAdapter } from './scheduler-node.js';
+import { initNodeTelemetry, shutdownNodeTelemetry } from './telemetry/otel-node.js';
+// ── Errors ────────────────────────────────────────────────────────────────
+/** Error thrown when application config validation fails. Includes file path and section name. */
+export class ConfigValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigValidationError';
+    }
+}
+// ── Config validation helper ──────────────────────────────────────────────
+/**
+ * Validate a raw config section using the caller-provided validator.
+ * Supports structural `safeParse`, `validate()`, `parse()`, and bare function forms.
+ */
+function validateAppConfig(validator, raw, section, filePath) {
+    if (typeof validator === 'object' && 'safeParse' in validator) {
+        const result = validator.safeParse(raw);
+        if (!result.success) {
+            const details = result.errors?.map((e) => `${e.path}: ${e.message}`).join('; ') ?? 'unknown error';
+            throw new ConfigValidationError(`Application config validation failed in section "${section}"` +
+                (filePath ? ` (file: ${filePath})` : '') +
+                `: ${details}`);
+        }
+        return result.data;
+    }
+    if (typeof validator === 'function') {
+        return validator(raw);
+    }
+    if (typeof validator === 'object' && 'validate' in validator) {
+        return validator.validate(raw);
+    }
+    if (typeof validator === 'object' && 'parse' in validator) {
+        return validator.parse(raw);
+    }
+    throw new ConfigValidationError(`Unsupported validator shape for section "${section}"`);
+}
+// ── File sink helper ──────────────────────────────────────────────────────
+function createFileSink(filePath) {
+    return (line) => {
+        try {
+            mkdirSync(dirname(filePath), { recursive: true });
+            appendFileSync(filePath, line);
+        }
+        catch {
+            // Best-effort — don't crash on log write failure
+        }
+    };
+}
+function loadYamlConfig(loader, fileContent) {
+    const bootstrapSection = loader.bootstrapSection ?? 'bootstrap';
+    let raw;
+    if (fileContent !== undefined) {
+        raw = parseYamlObject(fileContent);
+    }
+    else if (loader.overrides) {
+        raw = { ...loader.overrides };
+    }
+    else {
+        raw = {};
+    }
+    // Interpolate environment variables (Node/Bun only)
+    raw = interpolateTree(raw);
+    // Extract bootstrap section
+    const bootstrapSection_ = raw[bootstrapSection];
+    const bootstrapConfig = typeof bootstrapSection_ === 'object' && bootstrapSection_ !== null
+        ? bootstrapSection_
+        : {};
+    // Extract app config section
+    let appConfig;
+    if (loader.appConfig) {
+        const appSection = loader.appSection;
+        const appRaw = appSection
+            ? raw[appSection]
+            : (() => {
+                // Default: full remaining object minus bootstrap section
+                const remaining = {};
+                for (const [key, value] of Object.entries(raw)) {
+                    if (key !== bootstrapSection) {
+                        remaining[key] = value;
+                    }
+                }
+                return remaining;
+            })();
+        appConfig = validateAppConfig(loader.appConfig, appRaw, appSection ?? '*', loader.configFile);
+    }
+    return { bootstrapConfig, appConfig };
+}
+// ── Public API ────────────────────────────────────────────────────────────
+/**
+ * Node/Bun convenience application bootstrap.
+ *
+ * Extends the portable `runApplication` with:
+ * - YAML config file loading with section splitting
+ * - Application-specific config validation
+ * - File log sink creation from `logging.filePath`
+ * - Bun SQLite DB adapter creation when `database.enabled` + `database.driver`
+ * - Optional Node OTel telemetry exporter
+ * - Optional Node scheduler adapter
+ *
+ * @example
+ * ```ts
+ * import { runNodeApplication } from '@gobing-ai/ts-infra/application-node';
+ *
+ * await runNodeApplication({
+ *     configLoader: {
+ *         configFile: 'config/app.yaml',
+ *         bootstrapSection: 'bootstrap',
+ *         appSection: 'billing',
+ *         appConfig: {
+ *             safeParse(raw) {
+ *                 return billingSchema.safeParse(raw);
+ *             },
+ *         },
+ *     },
+ *     async start(app) {
+ *         app.logger.info('started');
+ *     },
+ * });
+ * ```
+ */
+export async function runNodeApplication(options) {
+    // ── Load config ─────────────────────────────────────────────────────
+    let loadedAppConfig;
+    let yamlBootstrap = {};
+    if (options.configLoader?.configFile) {
+        const fileContent = readFileSync(options.configLoader.configFile, 'utf-8');
+        const loaded = loadYamlConfig(options.configLoader, fileContent);
+        yamlBootstrap = loaded.bootstrapConfig;
+        loadedAppConfig = loaded.appConfig;
+    }
+    else if (options.configLoader) {
+        const loaded = loadYamlConfig(options.configLoader, undefined);
+        yamlBootstrap = loaded.bootstrapConfig;
+        loadedAppConfig = loaded.appConfig;
+    }
+    // ── Resolve bootstrap config from YAML + inline options ────────────
+    const yamlLog = yamlBootstrap.logging;
+    const yamlTel = yamlBootstrap.telemetry;
+    const yamlSched = yamlBootstrap.scheduler;
+    const databaseOpts = (yamlBootstrap.database ?? {});
+    const loggingOpts = { ...yamlLog, ...options.config?.logging };
+    const telemetryOpts = { ...yamlTel, ...options.config?.telemetry };
+    const schedulerOpts = { ...yamlSched, ...options.config?.scheduler };
+    const logFilePath = yamlBootstrap.logging?.filePath;
+    const loggingConfig = typeof logFilePath === 'string' ? { ...loggingOpts, fileSink: createFileSink(logFilePath) } : loggingOpts;
+    // ── Scheduler adapter ───────────────────────────────────────────────
+    const schedulerConfig = {};
+    const rawSched = { ...schedulerOpts };
+    if (rawSched.enabled === true) {
+        schedulerConfig.enabled = true;
+        schedulerConfig.autoStart = schedulerOpts.autoStart;
+        schedulerConfig.adapter = new NodeSchedulerAdapter();
+    }
+    // ── Node-owned plugins ──────────────────────────────────────────────
+    const plugins = [];
+    let dbAdapter = options.services?.db;
+    const rawTel = { ...telemetryOpts };
+    // Node OTel telemetry as a failFast plugin
+    if (rawTel.enabled !== false && rawTel.endpoint) {
+        plugins.push({
+            name: 'builtin:node-telemetry',
+            version: '0.0.0',
+            failFast: true,
+            onLoad: async () => { },
+            onStart: async () => {
+                initNodeTelemetry({
+                    serviceName: rawTel.serviceName ?? 'ts-libs',
+                    endpoint: rawTel.endpoint,
+                    headers: rawTel.headers,
+                });
+            },
+            onStop: async () => {
+                await shutdownNodeTelemetry();
+            },
+        });
+    }
+    // DB adapter (owned — registered as a plugin with fail-soft close)
+    if (!dbAdapter && databaseOpts.enabled === true) {
+        const driver = databaseOpts.driver;
+        if (driver === 'bun-sqlite') {
+            const adapter = await createDbAdapter({
+                driver: 'bun-sqlite',
+                url: databaseOpts.url,
+            });
+            dbAdapter = adapter;
+            plugins.push(dbPlugin(dbAdapter));
+        }
+        else {
+            throw new ConfigValidationError(`database.enabled is true but driver ${driver ? `"${driver}"` : 'is missing'} is not supported ` +
+                `(expected "bun-sqlite"). Provide a supported driver or inject a DbAdapter via services.db.`);
+        }
+    }
+    // ── Delegate to portable runApplication ─────────────────────────────
+    // Node-specific cleanup is handled by plugins in the service ring —
+    // node-telemetry onStop, owned-db onStop. No manual try/catch or stop
+    // override needed.
+    return await runApplication({
+        config: { ...options.config, logging: loggingConfig, telemetry: telemetryOpts, scheduler: schedulerConfig },
+        appConfig: loadedAppConfig,
+        services: { ...options.services, ...(dbAdapter ? { db: dbAdapter } : {}) },
+        start: options.start,
+        stop: options.stop,
+        plugins: plugins.length ? plugins : undefined,
+    });
+}

package/dist/index.d.ts

@@ -3,6 +3,6 @@ export { attachDefaultObservers, attachFileObserver, attachLogObserver, attachTe
 export type { ApiClientEvents, ApiRequestErrorDetail, DbConnectionErrorDetail, DbEvents, InfraEvents, QueueEvents, QueueJobFailedDetail, QueueJobRetryingDetail, SchedulerEvents, SchedulerJobExecutedDetail, } from './events';
 export type { EnqueueOptions, Job, JobHandler, JobQueue, QueueConsumer, QueueConsumerConfig, QueueStats, } from './job-queue/index';
 export { getLogger, type InitLoggerOptions, initializeLogger, type Logger, type LogLevel, setLoggerMuted, } from './logger';
-export { ActionRegistry, type CreateDefaultRegistryOptions, createDefaultRegistry, getSchedulerAdapter, HealthPingAction, type HealthPingWriter, initScheduler, LogAction, NoopSchedulerAdapter, QueueStatsAction, type QueueStatsDaoProvider, type ScheduledAction, type SchedulerAction, type SchedulerAdapter, setSchedulerAdapter, toScheduledAction, wrapScheduledHandler, } from './scheduler/index';
+export { ActionRegistry, type CreateDefaultRegistryOptions, createDefaultRegistry, HealthPingAction, type HealthPingWriter, initScheduler, LogAction, NoopSchedulerAdapter, QueueStatsAction, type QueueStatsDaoProvider, type ScheduledAction, type SchedulerAction, type SchedulerAdapter, toScheduledAction, wrapScheduledHandler, } from './scheduler/index';
 export { addSpanAttributes, addSpanEvent, extractSqlOperation, getActiveSpan, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, getTelemetryConfig, getTracer, initMetrics, initTelemetry, isTelemetryEnabled, sanitizeSql, shutdownMetrics, shutdownTelemetry, type TelemetryConfig, type TelemetryConfigPartial, traceAsync, traceSync, withSpan, } from './telemetry/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9F,OAAO,EACH,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACR,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,GAC7B,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,SAAS,EACT,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,cAAc,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,UAAU,EACV,SAAS,EACT,QAAQ,GACX,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9F,OAAO,EACH,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACR,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,GAC7B,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,SAAS,EACT,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,cAAc,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,UAAU,EACV,SAAS,EACT,QAAQ,GACX,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -5,6 +5,6 @@ export { attachDefaultObservers, attachFileObserver, attachLogObserver, attachTe
 // Logger
 export { getLogger, initializeLogger, setLoggerMuted, } from './logger.js';
 // Scheduler
-export { ActionRegistry, createDefaultRegistry, getSchedulerAdapter, HealthPingAction, initScheduler, LogAction, NoopSchedulerAdapter, QueueStatsAction, setSchedulerAdapter, toScheduledAction, wrapScheduledHandler, } from './scheduler/index.js';
+export { ActionRegistry, createDefaultRegistry, HealthPingAction, initScheduler, LogAction, NoopSchedulerAdapter, QueueStatsAction, toScheduledAction, wrapScheduledHandler, } from './scheduler/index.js';
 // Telemetry
 export { addSpanAttributes, addSpanEvent, extractSqlOperation, getActiveSpan, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, getTelemetryConfig, getTracer, initMetrics, initTelemetry, isTelemetryEnabled, sanitizeSql, shutdownMetrics, shutdownTelemetry, traceAsync, traceSync, withSpan, } from './telemetry/index.js';

package/dist/scheduler/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/scheduler/cloudflare.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE,UAAU,gBAAgB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,UAAU,cAAc;IACpB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;;IAI9D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAI/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;CAY3E"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/scheduler/cloudflare.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE,UAAU,gBAAgB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,UAAU,cAAc;IACpB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;;IAI9D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAI/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;CAmB3E"}

package/dist/scheduler/cloudflare.js

@@ -2,7 +2,7 @@
  * Cloudflare Workers scheduler adapter using Cron Triggers.
  * Uses minimal local type declarations — no @cloudflare/workers-types dependency.
  */
-import { getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal } from '../telemetry/metrics.js';
+import { getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, } from '../telemetry/metrics.js';
 /**
  * Scheduler adapter for Cloudflare Workers Cron Triggers.
  *
@@ -29,10 +29,17 @@ export class CloudflareSchedulerAdapter {
     handleScheduledEvent(event, ctx) {
         const action = this.entries.get(event.cron);
         if (action) {
+            const startMs = performance.now();
             getSchedulerJobExecutedTotal().add(1, { cron: event.cron });
-            ctx.waitUntil(action().catch((error) => {
+            ctx.waitUntil(action()
+                .catch((error) => {
                 getSchedulerJobFailedTotal().add(1, { cron: event.cron });
                 throw error;
+            })
+                .finally(() => {
+                // Duration parity with NodeSchedulerAdapter — record the job
+                // duration metric keyed by cron for both runtimes.
+                getSchedulerJobDuration().record(performance.now() - startMs, { cron: event.cron });
             }));
         }
     }

package/dist/scheduler/factory.d.ts

@@ -1,10 +1,4 @@
 import type { ScheduledAction, SchedulerAdapter } from './types';
-/** Set the runtime scheduler adapter. Call before {@link initScheduler}. */
-export declare function setSchedulerAdapter(adapter: SchedulerAdapter): void;
-/** Reset the scheduler adapter singleton. For testing. */
-export declare function resetSchedulerAdapter(): void;
-/** Get the currently configured scheduler adapter, or `undefined` if not set. */
-export declare function getSchedulerAdapter(): SchedulerAdapter | undefined;
 /**
  * Initialize the scheduler adapter and register cron entries.
  *
@@ -12,7 +6,9 @@ export declare function getSchedulerAdapter(): SchedulerAdapter | undefined;
  * running, newly registered entries will NOT be started until the next
  * `start()` call.
  *
- * Returns the configured adapter (defaults to noop if none set).
+ * @param adapter - Adapter to use. Defaults to a {@link NoopSchedulerAdapter}.
+ * @param cronEntries - `[cron, action]` pairs to register on the adapter.
+ * @returns The configured adapter.
  */
-export declare function initScheduler(cronEntries?: Array<[string, ScheduledAction]>): SchedulerAdapter;
+export declare function initScheduler(adapter?: SchedulerAdapter, cronEntries?: Array<[string, ScheduledAction]>): SchedulerAdapter;
 //# sourceMappingURL=factory.d.ts.map

package/dist/scheduler/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/scheduler/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIjE,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEnE;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,gBAAgB,CAa9F"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/scheduler/factory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CACzB,OAAO,CAAC,EAAE,gBAAgB,EAC1B,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAC/C,gBAAgB,CAUlB"}

package/dist/scheduler/factory.js

@@ -1,20 +1,11 @@
 /**
- * Scheduler factory — selects adapter based on runtime.
+ * Scheduler factory — initializes an adapter and registers cron entries.
+ *
+ * The adapter is passed in explicitly (dependency injection); there is no
+ * process-global adapter state. Callers that don't supply one get a
+ * {@link NoopSchedulerAdapter}.
  */
 import { NoopSchedulerAdapter } from './noop.js';
-let runtimeAdapter;
-/** Set the runtime scheduler adapter. Call before {@link initScheduler}. */
-export function setSchedulerAdapter(adapter) {
-    runtimeAdapter = adapter;
-}
-/** Reset the scheduler adapter singleton. For testing. */
-export function resetSchedulerAdapter() {
-    runtimeAdapter = undefined;
-}
-/** Get the currently configured scheduler adapter, or `undefined` if not set. */
-export function getSchedulerAdapter() {
-    return runtimeAdapter;
-}
 /**
  * Initialize the scheduler adapter and register cron entries.
  *
@@ -22,17 +13,16 @@ export function getSchedulerAdapter() {
  * running, newly registered entries will NOT be started until the next
  * `start()` call.
  *
- * Returns the configured adapter (defaults to noop if none set).
+ * @param adapter - Adapter to use. Defaults to a {@link NoopSchedulerAdapter}.
+ * @param cronEntries - `[cron, action]` pairs to register on the adapter.
+ * @returns The configured adapter.
  */
-export function initScheduler(cronEntries) {
-    // Default: create a noop adapter. Apps inject their own via setSchedulerAdapter.
-    if (!runtimeAdapter) {
-        runtimeAdapter = new NoopSchedulerAdapter();
-    }
+export function initScheduler(adapter, cronEntries) {
+    const resolved = adapter ?? new NoopSchedulerAdapter();
     if (cronEntries) {
         for (const [cron, action] of cronEntries) {
-            runtimeAdapter.register(cron, action);
+            resolved.register(cron, action);
         }
     }
-    return runtimeAdapter;
+    return resolved;
 }

package/dist/scheduler/index.d.ts

@@ -1,5 +1,5 @@
 export { ActionRegistry, type CreateDefaultRegistryOptions, createDefaultRegistry, HealthPingAction, type HealthPingWriter, LogAction, QueueStatsAction, type QueueStatsDaoProvider, type SchedulerAction, toScheduledAction, } from './action';
-export { getSchedulerAdapter, initScheduler, resetSchedulerAdapter, setSchedulerAdapter } from './factory';
+export { initScheduler } from './factory';
 export { NoopSchedulerAdapter } from './noop';
 export type { ScheduledAction, SchedulerAdapter } from './types';
 export { wrapScheduledHandler } from './wrap-handler';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,SAAS,EACT,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC3G,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,SAAS,EACT,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/scheduler/index.js

@@ -1,4 +1,4 @@
 export { ActionRegistry, createDefaultRegistry, HealthPingAction, LogAction, QueueStatsAction, toScheduledAction, } from './action.js';
-export { getSchedulerAdapter, initScheduler, resetSchedulerAdapter, setSchedulerAdapter } from './factory.js';
+export { initScheduler } from './factory.js';
 export { NoopSchedulerAdapter } from './noop.js';
 export { wrapScheduledHandler } from './wrap-handler.js';

package/dist/scheduler/wrap-handler.d.ts

@@ -5,10 +5,14 @@ import type { ScheduledAction } from './types';
  * Wrap a scheduled action with OTel tracing, duration measurement, and
  * `scheduler.job.executed` event emission.
  *
- * Composes *on top of* the adapter's inline metrics (executed/failed/duration
- * counters live in the Node/Cloudflare adapters) — this wrapper adds the named
- * tracing span and the lifecycle event, neither of which the adapters provide.
- * Opt-in: wrap an action before registering it when you want that visibility.
+ * Observability is split by design across two axes, not duplicated:
+ * - The adapters (`NodeSchedulerAdapter`, `CloudflareSchedulerAdapter`) record
+ *   executed/failed/duration **metrics keyed by `cron`** for aggregate dashboards.
+ * - This opt-in wrapper adds a named **tracing span + lifecycle event keyed by
+ *   the human `name`**, for per-job diagnosis. Its timer measures the inner action
+ *   scope; the adapter's measures the full tick — nested, not double-counted.
+ *
+ * Wrap an action before registering it when you want the named span/event.
  *
  * @param name - Job name, surfaced as `scheduler.job_name` on the span/event.
  * @param action - The action to wrap (new no-arg `ScheduledAction` signature).

package/dist/scheduler/wrap-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-handler.d.ts","sourceRoot":"","sources":["../../src/scheduler/wrap-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAC7C,eAAe,CA2BjB"}
+{"version":3,"file":"wrap-handler.d.ts","sourceRoot":"","sources":["../../src/scheduler/wrap-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAC7C,eAAe,CA2BjB"}

package/dist/scheduler/wrap-handler.js

@@ -3,10 +3,14 @@ import { addSpanAttributes, addSpanEvent, traceAsync } from '../telemetry/tracin
  * Wrap a scheduled action with OTel tracing, duration measurement, and
  * `scheduler.job.executed` event emission.
  *
- * Composes *on top of* the adapter's inline metrics (executed/failed/duration
- * counters live in the Node/Cloudflare adapters) — this wrapper adds the named
- * tracing span and the lifecycle event, neither of which the adapters provide.
- * Opt-in: wrap an action before registering it when you want that visibility.
+ * Observability is split by design across two axes, not duplicated:
+ * - The adapters (`NodeSchedulerAdapter`, `CloudflareSchedulerAdapter`) record
+ *   executed/failed/duration **metrics keyed by `cron`** for aggregate dashboards.
+ * - This opt-in wrapper adds a named **tracing span + lifecycle event keyed by
+ *   the human `name`**, for per-job diagnosis. Its timer measures the inner action
+ *   scope; the adapter's measures the full tick — nested, not double-counted.
+ *
+ * Wrap an action before registering it when you want the named span/event.
  *
  * @param name - Job name, surfaced as `scheduler.job_name` on the span/event.
  * @param action - The action to wrap (new no-arg `ScheduledAction` signature).

package/dist/telemetry/index.d.ts

@@ -1,7 +1,6 @@
-export { getTelemetryConfig, type TelemetryConfig, type TelemetryConfigPartial } from './config';
 export { extractSqlOperation, sanitizeSql } from './db-sanitize';
 export { type Counter, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, type Histogram, initMetrics, shutdownMetrics, } from './metrics';
-export { getTracer, initTelemetry, isTelemetryEnabled, shutdownTelemetry } from './sdk';
+export { getTelemetryConfig, getTracer, initTelemetry, isTelemetryEnabled, shutdownTelemetry, type TelemetryConfig, type TelemetryConfigPartial, } from './sdk';
 export type { Span, SpanOptions, Tracer } from './tracing';
 export { addSpanAttributes, addSpanEvent, getActiveSpan, traceAsync, traceSync, withSpan } from './tracing';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACH,KAAK,OAAO,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,SAAS,EACd,WAAW,EACX,eAAe,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACxF,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACH,KAAK,OAAO,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,SAAS,EACd,WAAW,EACX,eAAe,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC9B,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/telemetry/index.js

@@ -1,5 +1,4 @@
-export { getTelemetryConfig } from './config.js';
 export { extractSqlOperation, sanitizeSql } from './db-sanitize.js';
 export { getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, initMetrics, shutdownMetrics, } from './metrics.js';
-export { getTracer, initTelemetry, isTelemetryEnabled, shutdownTelemetry } from './sdk.js';
+export { getTelemetryConfig, getTracer, initTelemetry, isTelemetryEnabled, shutdownTelemetry, } from './sdk.js';
 export { addSpanAttributes, addSpanEvent, getActiveSpan, traceAsync, traceSync, withSpan } from './tracing.js';

package/dist/telemetry/metrics.d.ts

@@ -30,7 +30,15 @@ export declare function getSchedulerJobExecutedTotal(): Counter;
 export declare function getSchedulerJobDuration(): Histogram;
 /** Counter for failed scheduled job executions. */
 export declare function getSchedulerJobFailedTotal(): Counter;
-/** Mark the metrics subsystem as initialized. Idempotent. */
+/**
+ * Pre-warm every instrument against the currently-registered meter and mark the
+ * subsystem initialized. Idempotent.
+ *
+ * Instruments are otherwise created lazily on first getter call (so metrics keep
+ * working even if this is never called — see the module contract). Calling this
+ * during bootstrap eagerly materializes them, so `isMetricsInitialized()` reflects
+ * real wiring rather than being a flag that gates nothing.
+ */
 export declare function initMetrics(): void;
 /** Clear the instrument cache and mark metrics as uninitialized. */
 export declare function shutdownMetrics(): Promise<void>;

package/dist/telemetry/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,oBAAoB,CAAC;AAE3E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AA8BD,kFAAkF;AAClF,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,SAAS,CAExD;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,yCAAyC;AACzC,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAID,uCAAuC;AACvC,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,6BAA6B,IAAI,SAAS,CAEzD;AAID,kDAAkD;AAClD,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,IAAI,SAAS,CAEnD;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,oBAAoB,CAAC;AAE3E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AA8BD,kFAAkF;AAClF,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,SAAS,CAExD;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,yCAAyC;AACzC,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAID,uCAAuC;AACvC,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,6BAA6B,IAAI,SAAS,CAEzD;AAID,kDAAkD;AAClD,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,IAAI,SAAS,CAEnD;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAgBlC;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/telemetry/metrics.js

@@ -81,10 +81,31 @@ export function getSchedulerJobFailedTotal() {
     return getOrCreateCounter('schedFail', 'scheduler.jobs.failed', 'Failed scheduled jobs', '{failure}');
 }
 // ── Lifecycle ───────────────────────────────────────────────────────
-/** Mark the metrics subsystem as initialized. Idempotent. */
+/**
+ * Pre-warm every instrument against the currently-registered meter and mark the
+ * subsystem initialized. Idempotent.
+ *
+ * Instruments are otherwise created lazily on first getter call (so metrics keep
+ * working even if this is never called — see the module contract). Calling this
+ * during bootstrap eagerly materializes them, so `isMetricsInitialized()` reflects
+ * real wiring rather than being a flag that gates nothing.
+ */
 export function initMetrics() {
     if (metricsInitialized)
         return;
+    // Eagerly materialize all instruments against the live meter.
+    getHttpClientRequestTotal();
+    getHttpClientRequestDuration();
+    getHttpClientRequestErrors();
+    getEventbusEmitsTotal();
+    getEventbusErrorsTotal();
+    getQueueJobEnqueuedTotal();
+    getQueueJobCompletedTotal();
+    getQueueJobFailedTotal();
+    getQueueJobProcessingDuration();
+    getSchedulerJobExecutedTotal();
+    getSchedulerJobDuration();
+    getSchedulerJobFailedTotal();
     metricsInitialized = true;
 }
 /** Clear the instrument cache and mark metrics as uninitialized. */