@gobing-ai/ts-infra 0.2.7 → 0.2.9

package/dist/scheduler/factory.js

@@ -1,3 +1,7 @@
+/**
+ * Scheduler factory — selects adapter based on runtime.
+ */
+import { NoopSchedulerAdapter } from './noop.js';
 let runtimeAdapter;
 export function setSchedulerAdapter(adapter) {
     runtimeAdapter = adapter;
@@ -21,7 +25,7 @@ export function getSchedulerAdapter() {
 export function initScheduler(cronEntries) {
     // Default: create a noop adapter. Apps inject their own via setSchedulerAdapter.
     if (!runtimeAdapter) {
-        runtimeAdapter = createNoopScheduler();
+        runtimeAdapter = new NoopSchedulerAdapter();
     }
     if (cronEntries) {
         for (const [cron, action] of cronEntries) {
@@ -30,16 +34,3 @@ export function initScheduler(cronEntries) {
     }
     return runtimeAdapter;
 }
-function createNoopScheduler() {
-    return {
-        register() {
-            /* noop */
-        },
-        start() {
-            return Promise.resolve();
-        },
-        stop() {
-            return Promise.resolve();
-        },
-    };
-}

package/dist/scheduler/node.d.ts

@@ -1,7 +1,3 @@
-/**
- * Node.js scheduler adapter using a simple setInterval-based approach.
- * No external cron library dependency — cron expressions are parsed minimally.
- */
 import type { ScheduledAction, SchedulerAdapter } from './types';
 export declare class NodeSchedulerAdapter implements SchedulerAdapter {
     private readonly entries;

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/scheduler/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA6BjE,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,OAAO,CAAS;;IAIxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAU/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,CAAC,UAAU;YAOJ,gBAAgB;CAOjC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/scheduler/node.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA6BjE,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,OAAO,CAAS;;IAIxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAU/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,CAAC,UAAU;YAOJ,gBAAgB;CAYjC"}

package/dist/scheduler/node.js

@@ -1,3 +1,8 @@
+/**
+ * Node.js scheduler adapter using a simple setInterval-based approach.
+ * No external cron library dependency — cron expressions are parsed minimally.
+ */
+import { getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, } from '../telemetry/metrics.js';
 /** Simple helper to parse cron-like interval strings into milliseconds. */
 function parseInterval(cron) {
     // Support simple patterns: "* * * * *" (every minute), "*/5 * * * *" (every 5 min)
@@ -53,11 +58,17 @@ export class NodeSchedulerAdapter {
         entry.timer = setInterval(this._onScheduledTick.bind(this, entry), interval);
     }
     async _onScheduledTick(entry) {
+        const startMs = performance.now();
+        getSchedulerJobExecutedTotal().add(1, { cron: entry.cron });
         try {
             await entry.action();
         }
         catch {
             // Swallow — scheduler errors should not crash the process
+            getSchedulerJobFailedTotal().add(1, { cron: entry.cron });
+        }
+        finally {
+            getSchedulerJobDuration().record(performance.now() - startMs, { cron: entry.cron });
         }
     }
 }

package/dist/telemetry/config.d.ts

@@ -8,10 +8,6 @@ export interface TelemetryConfig {
     serviceName: string;
     /** Deployment environment (development, staging, production). */
     environment: string;
-    /** OTLP exporter endpoint (e.g. `http://localhost:4318/v1/traces`). */
-    exporterEndpoint?: string | undefined;
-    /** Export protocol — only `http` is supported in v1. */
-    exporterProtocol: 'http';
     /**
      * Debug-only DB statement capture.
      *
@@ -30,7 +26,6 @@ export interface TelemetryConfigPartial {
     enabled?: boolean | undefined;
     serviceName?: string | undefined;
     environment?: string | undefined;
-    exporterEndpoint?: string | undefined;
     dbStatementDebug?: boolean | undefined;
     /** Deployment environment fallback (from app.env). */
     appEnv?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC5B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,sBAA2B,GAAG,eAAe,CAY9F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC5B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,sBAA2B,GAAG,eAAe,CAU9F"}

package/dist/telemetry/config.js

@@ -5,7 +5,6 @@ const DEFAULTS = {
     enabled: true,
     serviceName: 'ts-libs',
     environment: 'development',
-    exporterProtocol: 'http',
 };
 /**
  * Resolve the full telemetry config by merging a partial override with defaults.
@@ -17,8 +16,6 @@ export function getTelemetryConfig(configPartial = {}) {
         enabled,
         serviceName,
         environment: configPartial.environment ?? configPartial.appEnv ?? DEFAULTS.environment,
-        exporterEndpoint: configPartial.exporterEndpoint,
-        exporterProtocol: DEFAULTS.exporterProtocol,
         dbStatementDebug: configPartial.dbStatementDebug ?? false,
     };
 }

package/dist/telemetry/index.d.ts

@@ -1,6 +1,6 @@
 export { getTelemetryConfig, type TelemetryConfig, type TelemetryConfigPartial } from './config';
 export { extractSqlOperation, sanitizeSql } from './db-sanitize';
-export { type Counter, getDbOperationDuration, getDbOperationErrors, getDbOperationTotal, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getHttpServerRequestDuration, getHttpServerRequestErrors, getHttpServerRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, type Histogram, initMetrics, shutdownMetrics, } from './metrics';
+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 type { Span, SpanOptions, Tracer } from './tracing';
 export { addSpanAttributes, addSpanEvent, getActiveSpan, traceAsync, traceSync, withSpan } from './tracing';

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,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,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,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"}

package/dist/telemetry/index.js

@@ -1,5 +1,5 @@
 export { getTelemetryConfig } from './config.js';
 export { extractSqlOperation, sanitizeSql } from './db-sanitize.js';
-export { getDbOperationDuration, getDbOperationErrors, getDbOperationTotal, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getHttpServerRequestDuration, getHttpServerRequestErrors, getHttpServerRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, initMetrics, shutdownMetrics, } from './metrics.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 { addSpanAttributes, addSpanEvent, getActiveSpan, traceAsync, traceSync, withSpan } from './tracing.js';

package/dist/telemetry/metrics.d.ts

@@ -3,20 +3,11 @@
  * All degrade to no-ops when telemetry is disabled.
  */
 import { type Counter, type Histogram } from '@opentelemetry/api';
-import type { MeterProvider } from '@opentelemetry/sdk-metrics';
 export type { Counter, Histogram } from '@opentelemetry/api';
-import type { TelemetryConfig } from './config';
 export declare function isMetricsInitialized(): boolean;
-export declare function getMeterProvider(): MeterProvider;
-export declare function getHttpServerRequestTotal(): Counter;
-export declare function getHttpServerRequestDuration(): Histogram;
-export declare function getHttpServerRequestErrors(): Counter;
 export declare function getHttpClientRequestTotal(): Counter;
 export declare function getHttpClientRequestDuration(): Histogram;
 export declare function getHttpClientRequestErrors(): Counter;
-export declare function getDbOperationTotal(): Counter;
-export declare function getDbOperationDuration(): Histogram;
-export declare function getDbOperationErrors(): Counter;
 export declare function getEventbusEmitsTotal(): Counter;
 export declare function getEventbusErrorsTotal(): Counter;
 export declare function getQueueJobEnqueuedTotal(): Counter;
@@ -26,7 +17,7 @@ export declare function getQueueJobProcessingDuration(): Histogram;
 export declare function getSchedulerJobExecutedTotal(): Counter;
 export declare function getSchedulerJobDuration(): Histogram;
 export declare function getSchedulerJobFailedTotal(): Counter;
-export declare function initMetrics(_config?: Partial<TelemetryConfig>): void;
+export declare function initMetrics(): void;
 export declare function shutdownMetrics(): Promise<void>;
 export declare function _resetMetrics(): void;
 //# sourceMappingURL=metrics.d.ts.map

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;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AA6BD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,4BAA4B,IAAI,SAAS,CAExD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,4BAA4B,IAAI,SAAS,CAExD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,sBAAsB,IAAI,SAAS,CAElD;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAID,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAID,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,6BAA6B,IAAI,SAAS,CAEzD;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,uBAAuB,IAAI,SAAS,CAEnD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAGpE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAG/C;AAED,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,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AA8BD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,4BAA4B,IAAI,SAAS,CAExD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAID,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,6BAA6B,IAAI,SAAS,CAEzD;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,uBAAuB,IAAI,SAAS,CAEnD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAID,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAED,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/telemetry/metrics.js

@@ -3,18 +3,15 @@
  * All degrade to no-ops when telemetry is disabled.
  */
 import { metrics } from '@opentelemetry/api';
-let meterProvider;
 let metricsInitialized = false;
 export function isMetricsInitialized() {
     return metricsInitialized;
 }
-export function getMeterProvider() {
-    return meterProvider ?? metrics.getMeterProvider();
-}
 const METER_NAME = '@gobing-ai/ts-infra';
 const METER_VERSION = '0.1.0';
+/** Meter from the globally-registered provider (no-op when none registered). */
 function getMeter() {
-    return getMeterProvider().getMeter(METER_NAME, METER_VERSION);
+    return metrics.getMeter(METER_NAME, METER_VERSION);
 }
 // ── Instrument cache ────────────────────────────────────────────────
 const instruments = {};
@@ -30,16 +27,6 @@ function getOrCreateHistogram(key, name, description, unit = 'ms') {
     }
     return instruments[key];
 }
-// ── HTTP server ─────────────────────────────────────────────────────
-export function getHttpServerRequestTotal() {
-    return getOrCreateCounter('httpSrvReq', 'http.server.request.total', 'Total inbound HTTP requests', '{request}');
-}
-export function getHttpServerRequestDuration() {
-    return getOrCreateHistogram('httpSrvDur', 'http.server.request.duration', 'Inbound HTTP request duration');
-}
-export function getHttpServerRequestErrors() {
-    return getOrCreateCounter('httpSrvErr', 'http.server.request.errors', 'Inbound HTTP 5xx errors', '{error}');
-}
 // ── HTTP client ─────────────────────────────────────────────────────
 export function getHttpClientRequestTotal() {
     return getOrCreateCounter('httpCliReq', 'http.client.request.total', 'Total outbound HTTP requests', '{request}');
@@ -50,16 +37,6 @@ export function getHttpClientRequestDuration() {
 export function getHttpClientRequestErrors() {
     return getOrCreateCounter('httpCliErr', 'http.client.request.errors', 'Outbound HTTP errors', '{error}');
 }
-// ── DB ──────────────────────────────────────────────────────────────
-export function getDbOperationTotal() {
-    return getOrCreateCounter('dbOpTotal', 'db.client.operation.total', 'Total DB operations', '{operation}');
-}
-export function getDbOperationDuration() {
-    return getOrCreateHistogram('dbOpDur', 'db.client.operation.duration', 'DB operation duration');
-}
-export function getDbOperationErrors() {
-    return getOrCreateCounter('dbOpErr', 'db.client.operation.errors', 'DB operation errors', '{error}');
-}
 // ── Event bus ───────────────────────────────────────────────────────
 export function getEventbusEmitsTotal() {
     return getOrCreateCounter('ebEmit', 'eventbus.emits.total', 'Total event bus emits', '{emit}');
@@ -91,12 +68,18 @@ export function getSchedulerJobFailedTotal() {
     return getOrCreateCounter('schedFail', 'scheduler.jobs.failed', 'Failed scheduled jobs', '{failure}');
 }
 // ── Lifecycle ───────────────────────────────────────────────────────
-export function initMetrics(_config) {
+export function initMetrics() {
     if (metricsInitialized)
         return;
     metricsInitialized = true;
 }
 export function shutdownMetrics() {
+    // The meter provider is owned by whoever registered it globally (the host
+    // app or `@gobing-ai/ts-infra/otel-node`). Here we only drop the instrument
+    // cache so post-shutdown getters rebuild against a fresh meter.
+    for (const key of Object.keys(instruments)) {
+        instruments[key] = undefined;
+    }
     metricsInitialized = false;
     return Promise.resolve();
 }

package/dist/telemetry/otel-node.d.ts

@@ -0,0 +1,37 @@
+/** Options for {@link initNodeTelemetry}. */
+export interface NodeTelemetryOptions {
+    /** Logical service name emitted on every span/metric (resource attribute). */
+    serviceName: string;
+    /** Optional service version (resource attribute). */
+    serviceVersion?: string;
+    /**
+     * OTLP/HTTP collector endpoint base, e.g. `http://localhost:4318`.
+     * Signal-specific paths (`/v1/traces`, `/v1/metrics`) are appended by the
+     * exporters. When omitted, the OTel SDK default (`http://localhost:4318`)
+     * applies, honouring the standard `OTEL_EXPORTER_OTLP_*` env vars.
+     */
+    endpoint?: string;
+    /** Extra headers sent on every OTLP request (e.g. an auth token). */
+    headers?: Record<string, string>;
+    /** Metric export interval in ms. Default: 60_000. */
+    metricExportIntervalMs?: number;
+    /** When false, skip metric export and wire traces only. Default: true. */
+    metrics?: boolean;
+}
+/**
+ * Wire Node OTLP/HTTP export for traces and (by default) metrics, registering
+ * both providers globally. Idempotent: a second call is a no-op until
+ * {@link shutdownNodeTelemetry} runs.
+ *
+ * Call once at process startup, before the first span/metric is recorded.
+ */
+export declare function initNodeTelemetry(options: NodeTelemetryOptions): void;
+/**
+ * Flush and shut down the providers installed by {@link initNodeTelemetry}.
+ * Safe to call when nothing was initialised. Wire this to SIGTERM/SIGINT for a
+ * clean drain of buffered spans and metrics on shutdown.
+ */
+export declare function shutdownNodeTelemetry(): Promise<void>;
+/** Test-only: reset module state without requiring exporter teardown to resolve. */
+export declare function _resetNodeTelemetry(): void;
+//# sourceMappingURL=otel-node.d.ts.map

package/dist/telemetry/otel-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-node.d.ts","sourceRoot":"","sources":["../../src/telemetry/otel-node.ts"],"names":[],"mappings":"AAsBA,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACjC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAKD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAoCrE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3D;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/telemetry/otel-node.js

@@ -0,0 +1,85 @@
+/**
+ * Opt-in Node OTLP wiring for `@gobing-ai/ts-infra`.
+ *
+ * The core telemetry surface (`initTelemetry`, `getTracer`, the metric getters)
+ * only *instruments* — it records spans and metrics against whatever OTel
+ * provider is registered globally, and degrades to no-ops when none is. This
+ * subpath is the convenience layer that actually *exports*: it builds Node
+ * tracer + meter providers wired to OTLP/HTTP and registers them globally, so
+ * the already-instrumented call sites start flowing without any core change.
+ *
+ * Import this only when you want turnkey export. It pulls the OTLP exporter
+ * packages (declared as optional peers); the main barrel never imports them, so
+ * BYO-collector consumers stay lean and avoid global-provider conflicts.
+ */
+import { metrics } from '@opentelemetry/api';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { BatchSpanProcessor, NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+let traceProvider;
+let meterProvider;
+/**
+ * Wire Node OTLP/HTTP export for traces and (by default) metrics, registering
+ * both providers globally. Idempotent: a second call is a no-op until
+ * {@link shutdownNodeTelemetry} runs.
+ *
+ * Call once at process startup, before the first span/metric is recorded.
+ */
+export function initNodeTelemetry(options) {
+    if (traceProvider)
+        return;
+    const { serviceName, serviceVersion, endpoint, headers, metricExportIntervalMs = 60_000 } = options;
+    const wireMetrics = options.metrics ?? true;
+    const resource = resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: serviceName,
+        ...(serviceVersion ? { [ATTR_SERVICE_VERSION]: serviceVersion } : {}),
+    });
+    const traceExporter = new OTLPTraceExporter({
+        ...(endpoint ? { url: `${endpoint.replace(/\/$/, '')}/v1/traces` } : {}),
+        ...(headers ? { headers } : {}),
+    });
+    traceProvider = new NodeTracerProvider({
+        resource,
+        spanProcessors: [new BatchSpanProcessor(traceExporter)],
+    });
+    traceProvider.register();
+    if (wireMetrics) {
+        const metricExporter = new OTLPMetricExporter({
+            ...(endpoint ? { url: `${endpoint.replace(/\/$/, '')}/v1/metrics` } : {}),
+            ...(headers ? { headers } : {}),
+        });
+        const reader = new PeriodicExportingMetricReader({
+            exporter: metricExporter,
+            exportIntervalMillis: metricExportIntervalMs,
+        });
+        meterProvider = new MeterProvider({ resource, readers: [reader] });
+        metrics.setGlobalMeterProvider(meterProvider);
+    }
+}
+/**
+ * Flush and shut down the providers installed by {@link initNodeTelemetry}.
+ * Safe to call when nothing was initialised. Wire this to SIGTERM/SIGINT for a
+ * clean drain of buffered spans and metrics on shutdown.
+ */
+export async function shutdownNodeTelemetry() {
+    const pending = [];
+    if (meterProvider) {
+        pending.push(meterProvider.shutdown());
+        meterProvider = undefined;
+    }
+    if (traceProvider) {
+        pending.push(traceProvider.shutdown());
+        traceProvider = undefined;
+    }
+    metrics.disable();
+    await Promise.all(pending);
+}
+/** Test-only: reset module state without requiring exporter teardown to resolve. */
+export function _resetNodeTelemetry() {
+    meterProvider = undefined;
+    traceProvider = undefined;
+    metrics.disable();
+}

package/dist/telemetry/sdk.d.ts

@@ -1,11 +1,22 @@
 /**
- * OpenTelemetry SDK initialisation and tracer provider management.
+ * Telemetry enablement + tracer access.
+ *
+ * The core only *instruments* against whatever tracer provider is registered
+ * globally — it never constructs or owns a provider. Provider + exporter wiring
+ * is the consumer's concern: either the host app registers its own OTel SDK, or
+ * it opts into `@gobing-ai/ts-infra/otel-node` for turnkey OTLP export. This
+ * keeps the main barrel free of any SDK runtime dependency.
  */
 import { type Tracer } from '@opentelemetry/api';
 import type { TelemetryConfig } from './config';
 export declare function getResolvedConfig(): TelemetryConfig;
+/**
+ * Resolve telemetry config and mark telemetry enabled. Does not register any
+ * provider — spans flow to the globally-registered provider (none ⇒ no-op).
+ */
 export declare function initTelemetry(config?: Partial<TelemetryConfig>): void;
 export declare function shutdownTelemetry(): Promise<void>;
+/** The infra tracer from the globally-registered provider (no-op when none). */
 export declare function getTracer(): Tracer;
 export declare function isTelemetryEnabled(): boolean;
 export declare function _resetTelemetry(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/telemetry/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAShD,wBAAgB,iBAAiB,IAAI,eAAe,CAEnD;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAarE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAWtC;AAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/telemetry/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAShD,wBAAgB,iBAAiB,IAAI,eAAe,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAIrE;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGjD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/telemetry/sdk.js

@@ -1,53 +1,43 @@
 /**
- * OpenTelemetry SDK initialisation and tracer provider management.
+ * Telemetry enablement + tracer access.
+ *
+ * The core only *instruments* against whatever tracer provider is registered
+ * globally — it never constructs or owns a provider. Provider + exporter wiring
+ * is the consumer's concern: either the host app registers its own OTel SDK, or
+ * it opts into `@gobing-ai/ts-infra/otel-node` for turnkey OTLP export. This
+ * keeps the main barrel free of any SDK runtime dependency.
  */
 import { trace } from '@opentelemetry/api';
-import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
 import { getTelemetryConfig } from './config.js';
-let tracerProvider;
+const TRACER_NAME = '@gobing-ai/ts-infra';
+const TRACER_VERSION = '0.1.0';
 let telemetryInitialized = false;
 let resolvedConfig = getTelemetryConfig();
-const DEFAULT_TRACER = trace.getTracer('@gobing-ai/ts-infra', '0.1.0');
 export function getResolvedConfig() {
     return resolvedConfig;
 }
+/**
+ * Resolve telemetry config and mark telemetry enabled. Does not register any
+ * provider — spans flow to the globally-registered provider (none ⇒ no-op).
+ */
 export function initTelemetry(config) {
     if (telemetryInitialized)
         return;
     resolvedConfig = { ...getTelemetryConfig(), ...config };
-    if (!resolvedConfig.enabled) {
-        telemetryInitialized = true;
-        return;
-    }
-    tracerProvider = new NodeTracerProvider();
-    tracerProvider.register();
     telemetryInitialized = true;
 }
-export async function shutdownTelemetry() {
-    if (!tracerProvider) {
-        telemetryInitialized = false;
-        return;
-    }
-    await tracerProvider.shutdown();
-    tracerProvider = undefined;
+export function shutdownTelemetry() {
     telemetryInitialized = false;
+    return Promise.resolve();
 }
+/** The infra tracer from the globally-registered provider (no-op when none). */
 export function getTracer() {
-    return tracerProvider?.getTracer('@gobing-ai/ts-infra', '0.1.0') ?? DEFAULT_TRACER;
+    return trace.getTracer(TRACER_NAME, TRACER_VERSION);
 }
 export function isTelemetryEnabled() {
     return telemetryInitialized && resolvedConfig.enabled;
 }
 export function _resetTelemetry() {
-    if (tracerProvider) {
-        try {
-            tracerProvider.shutdown();
-        }
-        catch {
-            /* swallow */
-        }
-        tracerProvider = undefined;
-    }
     telemetryInitialized = false;
     resolvedConfig = getTelemetryConfig();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-infra",
-    "version": "0.2.7",
+    "version": "0.2.9",
     "description": "@gobing-ai/ts-infra — Infrastructure backbone: event bus, job queue, scheduler, telemetry, API client, and logging.",
     "keywords": [
         "typescript",
@@ -31,6 +31,10 @@
         ".": {
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js"
+        },
+        "./otel-node": {
+            "types": "./dist/telemetry/otel-node.d.ts",
+            "import": "./dist/telemetry/otel-node.js"
         }
     },
     "files": [
@@ -50,18 +54,43 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-infra-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-db": "^0.2.7",
-        "@gobing-ai/ts-runtime": "^0.2.7"
+        "@gobing-ai/ts-db": "^0.2.9"
     },
     "peerDependencies": {
-        "@opentelemetry/api": "^1.9.0"
+        "@opentelemetry/api": "^1.9.0",
+        "@opentelemetry/sdk-trace-node": "^2.0.0",
+        "@opentelemetry/sdk-metrics": "^2.0.0",
+        "@opentelemetry/resources": "^2.0.0",
+        "@opentelemetry/semantic-conventions": "^1.30.0",
+        "@opentelemetry/exporter-trace-otlp-http": ">=0.200.0",
+        "@opentelemetry/exporter-metrics-otlp-http": ">=0.200.0"
+    },
+    "peerDependenciesMeta": {
+        "@opentelemetry/sdk-trace-node": {
+            "optional": true
+        },
+        "@opentelemetry/sdk-metrics": {
+            "optional": true
+        },
+        "@opentelemetry/resources": {
+            "optional": true
+        },
+        "@opentelemetry/exporter-trace-otlp-http": {
+            "optional": true
+        },
+        "@opentelemetry/exporter-metrics-otlp-http": {
+            "optional": true
+        }
     },
     "devDependencies": {
         "@types/bun": "1.3.14",
         "@opentelemetry/api": "^1.9.0",
-        "@opentelemetry/sdk-trace-node": "^1.30.0",
-        "@opentelemetry/sdk-metrics": "^1.30.0",
-        "@opentelemetry/semantic-conventions": "^1.30.0"
+        "@opentelemetry/sdk-trace-node": "^2.0.0",
+        "@opentelemetry/sdk-metrics": "^2.0.0",
+        "@opentelemetry/resources": "^2.0.0",
+        "@opentelemetry/semantic-conventions": "^1.30.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.200.0",
+        "@opentelemetry/exporter-metrics-otlp-http": "^0.200.0"
     },
     "publishConfig": {
         "access": "public"

package/src/event-bus/event-bus.ts

@@ -1,5 +1,6 @@
 import type { JobQueue } from '../job-queue/types';
 import { getLogger, type Logger } from '../logger';
+import { getEventbusEmitsTotal, getEventbusErrorsTotal } from '../telemetry/metrics';
 import type {
     AsyncEnqueuedDetail,
     BusLifecycleEvents,
@@ -144,6 +145,9 @@ export class EventBus<TEvents extends EventMap> {
         const durationMs = performance.now() - startMs;
         const detail = args.length === 1 ? args[0] : args.length > 1 ? args : undefined;
 
+        getEventbusEmitsTotal().add(1, { event: eventName });
+        if (errors > 0) getEventbusErrorsTotal().add(errors, { event: eventName });
+
         this.publishEmitDone({ event: eventName, syncCount, asyncCount, emitDurationMs: durationMs, errors, detail });
 
         if (syncCount === 0 && asyncCount === 0) {

package/src/index.ts

@@ -4,11 +4,6 @@ export { APIClient, type APIClientConfig, APIError, type RequestOptions } from '
 // Event Bus
 export { EventBus, type EventMap, type SubscribeOptions } from './event-bus/index';
 
-// Events
-export type { AppEvents, AppInternalEvents } from './events/index';
-export { createSystemBus } from './events/index';
-
-// Job Queue
 export type {
     EnqueueOptions,
     Job,
@@ -18,6 +13,8 @@ export type {
     QueueConsumerConfig,
     QueueStats,
 } from './job-queue/index';
+// Job Queue
+export { DBJobQueue, DBQueueConsumer } from './job-queue/index';
 
 // Logger
 export { getLogger, initializeLogger, type Logger, type LogLevel } from './logger';
@@ -40,17 +37,11 @@ export {
     addSpanEvent,
     extractSqlOperation,
     getActiveSpan,
-    getDbOperationDuration,
-    getDbOperationErrors,
-    getDbOperationTotal,
     getEventbusEmitsTotal,
     getEventbusErrorsTotal,
     getHttpClientRequestDuration,
     getHttpClientRequestErrors,
     getHttpClientRequestTotal,
-    getHttpServerRequestDuration,
-    getHttpServerRequestErrors,
-    getHttpServerRequestTotal,
     getQueueJobCompletedTotal,
     getQueueJobEnqueuedTotal,
     getQueueJobFailedTotal,