@gobing-ai/ts-infra 0.3.5 → 0.3.7

package/src/application/types.ts

@@ -13,6 +13,8 @@ import type { BusLifecycleEvents, EventMap } from '../event-bus/types';
 import type { InfraEvents } from '../events';
 import type { Logger, LogLevel } from '../logger';
 import type { SchedulerAdapter } from '../scheduler/types';
+import type { PluginHost } from './plugins/host';
+import type { Plugin } from './plugins/types';
 
 // ── Feature flag option groups ────────────────────────────────────────────
 
@@ -93,6 +95,8 @@ export interface ApplicationServices<TEvents extends EventMap = InfraEvents> {
     lifecycleBus?: EventBus<BusLifecycleEvents>;
     db?: DbAdapterLike;
     scheduler?: SchedulerAdapter;
+    /** Pre-built plugin host (when injecting instead of constructing). */
+    pluginHost?: PluginHost;
 }
 
 /**
@@ -130,6 +134,7 @@ export interface ApplicationRuntime<TAppConfig = unknown, TEvents extends EventM
     readonly db?: DbAdapterLike;
     /** Scheduler adapter (when enabled). */
     readonly scheduler?: SchedulerAdapter;
+    readonly pluginHost: PluginHost;
     /** Graceful shutdown. Idempotent — safe to call multiple times. */
     stop(reason?: ApplicationStopReason): Promise<void>;
 }
@@ -151,6 +156,8 @@ export interface ApplicationBootstrapOptions<TAppConfig = unknown, TEvents exten
     readonly appConfig?: TAppConfig;
     /** Pre-built services to inject instead of creating defaults. */
     readonly services?: Partial<ApplicationServices<TEvents>>;
+    /** Plugins to register and lifecycle-manage via PluginHost. */
+    readonly plugins?: Plugin[];
     /** User callback: application logic. Called after all services are ready. */
     readonly start: (app: ApplicationRuntime<TAppConfig, TEvents>) => Promise<void> | void;
     /** User callback: cleanup before services shut down. */

package/src/application-node.ts

@@ -22,6 +22,8 @@ import { createDbAdapter, type DbAdapter } from '@gobing-ai/ts-db';
 import { interpolateTree, parseYamlObject } from '@gobing-ai/ts-runtime';
 
 import { runApplication } from './application/index';
+import { dbPlugin } from './application/plugins/builtins';
+import type { Plugin } from './application/plugins/types';
 import type {
     ApplicationBootstrapOptions,
     ApplicationConfigLoader,
@@ -213,8 +215,6 @@ export interface NodeApplicationOptions<TAppConfig = unknown, TEvents extends Ev
 export async function runNodeApplication<TAppConfig = unknown, TEvents extends EventMap = InfraEvents>(
     options: NodeApplicationOptions<TAppConfig, TEvents>,
 ): Promise<ApplicationRuntime<TAppConfig, TEvents>> {
-    let nodeTelemetryInitialized = false;
-
     // ── Load config ─────────────────────────────────────────────────────
     let loadedAppConfig: TAppConfig | undefined;
     let yamlBootstrap: Record<string, unknown> = {};
@@ -231,44 +231,54 @@ export async function runNodeApplication<TAppConfig = unknown, TEvents extends E
     }
 
     // ── Resolve bootstrap config from YAML + inline options ────────────
-    // YAML loads as Record<string, unknown>; bridge into typed options.
-    // Inline options (options.config) take precedence over YAML sections.
     const yamlLog = yamlBootstrap.logging as Partial<LoggingOptions> | undefined;
     const yamlTel = yamlBootstrap.telemetry as Partial<TelemetryOptions> | undefined;
     const yamlSched = yamlBootstrap.scheduler as Partial<SchedulerOptions> | undefined;
     const databaseOpts = (yamlBootstrap.database ?? {}) as Record<string, unknown>;
 
-    const loggingOpts: Partial<LoggingOptions> = {
-        ...yamlLog,
-        ...options.config?.logging,
-    };
-    const telemetryOpts: Partial<TelemetryOptions> = {
-        ...yamlTel,
-        ...options.config?.telemetry,
-    };
-    const schedulerOpts: Partial<SchedulerOptions> = {
-        ...yamlSched,
-        ...options.config?.scheduler,
-    };
+    const loggingOpts: Partial<LoggingOptions> = { ...yamlLog, ...options.config?.logging };
+    const telemetryOpts: Partial<TelemetryOptions> = { ...yamlTel, ...options.config?.telemetry };
+    const schedulerOpts: Partial<SchedulerOptions> = { ...yamlSched, ...options.config?.scheduler };
 
-    // File sink from logging.filePath
     const logFilePath = (yamlBootstrap.logging as Record<string, unknown> | undefined)?.filePath as string | undefined;
     const loggingConfig: Partial<LoggingOptions> =
         typeof logFilePath === 'string' ? { ...loggingOpts, fileSink: createFileSink(logFilePath) } : loggingOpts;
 
-    // ── Node OTel telemetry ─────────────────────────────────────────────
+    // ── Scheduler adapter ───────────────────────────────────────────────
+    const schedulerConfig: SchedulerOptions = {};
+    const rawSched = { ...schedulerOpts } as Record<string, unknown>;
+    if (rawSched.enabled === true) {
+        schedulerConfig.enabled = true;
+        schedulerConfig.autoStart = schedulerOpts.autoStart;
+        schedulerConfig.adapter = new NodeSchedulerAdapter();
+    }
+
+    // ── Node-owned plugins ──────────────────────────────────────────────
+    const plugins: Plugin[] = [];
+    let dbAdapter: DbAdapterLike | undefined = options.services?.db;
     const rawTel = { ...telemetryOpts } as Record<string, unknown>;
+
+    // Node OTel telemetry as a failFast plugin
     if (rawTel.enabled !== false && rawTel.endpoint) {
-        initNodeTelemetry({
-            serviceName: (rawTel.serviceName as string | undefined) ?? 'ts-libs',
-            endpoint: rawTel.endpoint as string,
-            headers: rawTel.headers as Record<string, string> | undefined,
+        plugins.push({
+            name: 'builtin:node-telemetry',
+            version: '0.0.0',
+            failFast: true,
+            onLoad: async () => {},
+            onStart: async () => {
+                initNodeTelemetry({
+                    serviceName: (rawTel.serviceName as string | undefined) ?? 'ts-libs',
+                    endpoint: rawTel.endpoint as string,
+                    headers: rawTel.headers as Record<string, string> | undefined,
+                });
+            },
+            onStop: async () => {
+                await shutdownNodeTelemetry();
+            },
         });
-        nodeTelemetryInitialized = true;
     }
 
-    // ── DB adapter ──────────────────────────────────────────────────────
-    let dbAdapter: DbAdapterLike | undefined = options.services?.db;
+    // DB adapter (owned — registered as a plugin with fail-soft close)
     if (!dbAdapter && databaseOpts.enabled === true) {
         const driver = databaseOpts.driver as string | undefined;
         if (driver === 'bun-sqlite') {
@@ -277,6 +287,7 @@ export async function runNodeApplication<TAppConfig = unknown, TEvents extends E
                 url: databaseOpts.url as string | undefined,
             });
             dbAdapter = adapter as DbAdapter;
+            plugins.push(dbPlugin(dbAdapter));
         } else {
             throw new ConfigValidationError(
                 `database.enabled is true but driver ${driver ? `"${driver}"` : 'is missing'} is not supported ` +
@@ -285,45 +296,16 @@ export async function runNodeApplication<TAppConfig = unknown, TEvents extends E
         }
     }
 
-    // ── Scheduler adapter ───────────────────────────────────────────────
-    const schedulerConfig: SchedulerOptions = {};
-    const rawSched = { ...schedulerOpts } as Record<string, unknown>;
-    if (rawSched.enabled === true) {
-        schedulerConfig.enabled = true;
-        schedulerConfig.autoStart = schedulerOpts.autoStart;
-        // Use Node scheduler adapter by default in this subpath
-        schedulerConfig.adapter = new NodeSchedulerAdapter();
-    }
-
     // ── Delegate to portable runApplication ─────────────────────────────
-    const app = await runApplication<TAppConfig, TEvents>({
-        config: {
-            ...options.config,
-            logging: loggingConfig,
-            telemetry: telemetryOpts,
-            scheduler: schedulerConfig,
-        },
+    // 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<TAppConfig, TEvents>({
+        config: { ...options.config, logging: loggingConfig, telemetry: telemetryOpts, scheduler: schedulerConfig },
         appConfig: loadedAppConfig,
-        services: {
-            ...options.services,
-            ...(dbAdapter ? { db: dbAdapter } : {}),
-        },
+        services: { ...options.services, ...(dbAdapter ? { db: dbAdapter } : {}) },
         start: options.start,
         stop: options.stop,
+        plugins: plugins.length ? plugins : undefined,
     });
-
-    // ── Compose a handle with Node-specific cleanup on stop ─────────────
-    const originalStop = app.stop.bind(app);
-    return {
-        ...app,
-        stop: async (reason?: ApplicationStopReason) => {
-            await originalStop(reason);
-
-            // Node-specific cleanup (after portable shutdown):
-            // 5. Shut down Node telemetry exporter
-            if (nodeTelemetryInitialized) {
-                await shutdownNodeTelemetry();
-            }
-        },
-    };
 }

package/src/index.ts

@@ -52,7 +52,6 @@ export {
     ActionRegistry,
     type CreateDefaultRegistryOptions,
     createDefaultRegistry,
-    getSchedulerAdapter,
     HealthPingAction,
     type HealthPingWriter,
     initScheduler,
@@ -63,7 +62,6 @@ export {
     type ScheduledAction,
     type SchedulerAction,
     type SchedulerAdapter,
-    setSchedulerAdapter,
     toScheduledAction,
     wrapScheduledHandler,
 } from './scheduler/index';

package/src/scheduler/cloudflare.ts

@@ -2,7 +2,11 @@
  * Cloudflare Workers scheduler adapter using Cron Triggers.
  * Uses minimal local type declarations — no @cloudflare/workers-types dependency.
  */
-import { getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal } from '../telemetry/metrics';
+import {
+    getSchedulerJobDuration,
+    getSchedulerJobExecutedTotal,
+    getSchedulerJobFailedTotal,
+} from '../telemetry/metrics';
 import type { ScheduledAction, SchedulerAdapter } from './types';
 
 interface CfScheduledEvent {
@@ -46,12 +50,19 @@ export class CloudflareSchedulerAdapter implements SchedulerAdapter {
     handleScheduledEvent(event: CfScheduledEvent, ctx: CfEventContext): void {
         const action = this.entries.get(event.cron);
         if (action) {
+            const startMs = performance.now();
             getSchedulerJobExecutedTotal().add(1, { cron: event.cron });
             ctx.waitUntil(
-                action().catch((error: unknown) => {
-                    getSchedulerJobFailedTotal().add(1, { cron: event.cron });
-                    throw error;
-                }),
+                action()
+                    .catch((error: unknown) => {
+                        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/src/scheduler/factory.ts

@@ -1,26 +1,13 @@
 /**
- * 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';
 import type { ScheduledAction, SchedulerAdapter } from './types';
 
-let runtimeAdapter: SchedulerAdapter | undefined;
-
-/** Set the runtime scheduler adapter. Call before {@link initScheduler}. */
-export function setSchedulerAdapter(adapter: SchedulerAdapter): void {
-    runtimeAdapter = adapter;
-}
-
-/** Reset the scheduler adapter singleton. For testing. */
-export function resetSchedulerAdapter(): void {
-    runtimeAdapter = undefined;
-}
-
-/** Get the currently configured scheduler adapter, or `undefined` if not set. */
-export function getSchedulerAdapter(): SchedulerAdapter | undefined {
-    return runtimeAdapter;
-}
-
 /**
  * Initialize the scheduler adapter and register cron entries.
  *
@@ -28,19 +15,21 @@ export 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 function initScheduler(cronEntries?: Array<[string, ScheduledAction]>): SchedulerAdapter {
-    // Default: create a noop adapter. Apps inject their own via setSchedulerAdapter.
-    if (!runtimeAdapter) {
-        runtimeAdapter = new NoopSchedulerAdapter();
-    }
+export function initScheduler(
+    adapter?: SchedulerAdapter,
+    cronEntries?: Array<[string, ScheduledAction]>,
+): SchedulerAdapter {
+    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/src/scheduler/index.ts

@@ -10,7 +10,7 @@ export {
     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/src/scheduler/wrap-handler.ts

@@ -7,10 +7,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/src/telemetry/index.ts

@@ -1,4 +1,3 @@
-export { getTelemetryConfig, type TelemetryConfig, type TelemetryConfigPartial } from './config';
 export { extractSqlOperation, sanitizeSql } from './db-sanitize';
 export {
     type Counter,
@@ -18,6 +17,14 @@ export {
     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';

package/src/telemetry/metrics.ts

@@ -109,9 +109,30 @@ export function getSchedulerJobFailedTotal(): Counter {
 
 // ── 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(): void {
     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;
 }
 

package/src/telemetry/sdk.ts

@@ -8,8 +8,57 @@
  * keeps the main barrel free of any SDK runtime dependency.
  */
 import { type Tracer, trace } from '@opentelemetry/api';
-import type { TelemetryConfig } from './config';
-import { getTelemetryConfig } from './config';
+
+// ── Configuration ───────────────────────────────────────────────────────────
+
+/**
+ * Full telemetry configuration: master enable switch, service name,
+ * environment, and debug-level DB statement capture.
+ */
+export interface TelemetryConfig {
+    /** Master switch — when false, all tracing degrades to no-ops. */
+    enabled: boolean;
+    /** Logical service name emitted on every span. */
+    serviceName: string;
+    /** Deployment environment (development, staging, production). */
+    environment: string;
+    /**
+     * Debug-only DB statement capture.
+     *
+     * When true, DB spans may include sanitized SQL text in a `db.statement`
+     * attribute. SQL text is redacted — parameter values, literals, and
+     * identifiers are stripped before capture.
+     *
+     * Default: `false`. Controlled by `OTEL_DB_STATEMENT_DEBUG` env var.
+     */
+    dbStatementDebug: boolean;
+}
+
+/** Partial telemetry config from the centralized config system. */
+export interface TelemetryConfigPartial {
+    enabled?: boolean | undefined;
+    serviceName?: string | undefined;
+    environment?: string | undefined;
+    dbStatementDebug?: boolean | undefined;
+    /** Deployment environment fallback (from app.env). */
+    appEnv?: string | undefined;
+}
+
+const CONFIG_DEFAULTS = {
+    enabled: true as const,
+    serviceName: 'ts-libs' as const,
+    environment: 'development' as const,
+};
+
+/** Resolve the full telemetry config by merging a partial override with defaults. */
+export function getTelemetryConfig(configPartial: TelemetryConfigPartial = {}): TelemetryConfig {
+    return {
+        enabled: configPartial.enabled ?? CONFIG_DEFAULTS.enabled,
+        serviceName: configPartial.serviceName ?? CONFIG_DEFAULTS.serviceName,
+        environment: configPartial.environment ?? configPartial.appEnv ?? CONFIG_DEFAULTS.environment,
+        dbStatementDebug: configPartial.dbStatementDebug ?? false,
+    };
+}
 
 const TRACER_NAME = '@gobing-ai/ts-infra';
 const TRACER_VERSION = '0.1.0';

package/dist/telemetry/config.d.ts

@@ -1,41 +0,0 @@
-/**
- * Telemetry configuration interface.
- */
-/**
- * Full telemetry configuration: master enable switch, service name,
- * environment, and debug-level DB statement capture.
- */
-export interface TelemetryConfig {
-    /** Master switch — when false, all tracing degrades to no-ops. */
-    enabled: boolean;
-    /** Logical service name emitted on every span. */
-    serviceName: string;
-    /** Deployment environment (development, staging, production). */
-    environment: string;
-    /**
-     * Debug-only DB statement capture.
-     *
-     * When true, DB spans may include sanitized SQL text in a `db.statement`
-     * attribute. SQL text is redacted — parameter values, literals, and
-     * identifiers are stripped before capture.
-     *
-     * Default: `false`. Controlled by `OTEL_DB_STATEMENT_DEBUG` env var.
-     */
-    dbStatementDebug: boolean;
-}
-/**
- * Partial telemetry config from the centralized config system.
- */
-export interface TelemetryConfigPartial {
-    enabled?: boolean | undefined;
-    serviceName?: string | undefined;
-    environment?: string | undefined;
-    dbStatementDebug?: boolean | undefined;
-    /** Deployment environment fallback (from app.env). */
-    appEnv?: string | undefined;
-}
-/**
- * Resolve the full telemetry config by merging a partial override with defaults.
- */
-export declare function getTelemetryConfig(configPartial?: TelemetryConfigPartial): TelemetryConfig;
-//# sourceMappingURL=config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,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

@@ -1,21 +0,0 @@
-/**
- * Telemetry configuration interface.
- */
-const DEFAULTS = {
-    enabled: true,
-    serviceName: 'ts-libs',
-    environment: 'development',
-};
-/**
- * Resolve the full telemetry config by merging a partial override with defaults.
- */
-export function getTelemetryConfig(configPartial = {}) {
-    const enabled = configPartial.enabled ?? DEFAULTS.enabled;
-    const serviceName = configPartial.serviceName ?? DEFAULTS.serviceName;
-    return {
-        enabled,
-        serviceName,
-        environment: configPartial.environment ?? configPartial.appEnv ?? DEFAULTS.environment,
-        dbStatementDebug: configPartial.dbStatementDebug ?? false,
-    };
-}

package/src/telemetry/config.ts

@@ -1,59 +0,0 @@
-/**
- * Telemetry configuration interface.
- */
-
-/**
- * Full telemetry configuration: master enable switch, service name,
- * environment, and debug-level DB statement capture.
- */
-export interface TelemetryConfig {
-    /** Master switch — when false, all tracing degrades to no-ops. */
-    enabled: boolean;
-    /** Logical service name emitted on every span. */
-    serviceName: string;
-    /** Deployment environment (development, staging, production). */
-    environment: string;
-    /**
-     * Debug-only DB statement capture.
-     *
-     * When true, DB spans may include sanitized SQL text in a `db.statement`
-     * attribute. SQL text is redacted — parameter values, literals, and
-     * identifiers are stripped before capture.
-     *
-     * Default: `false`. Controlled by `OTEL_DB_STATEMENT_DEBUG` env var.
-     */
-    dbStatementDebug: boolean;
-}
-
-/**
- * Partial telemetry config from the centralized config system.
- */
-export interface TelemetryConfigPartial {
-    enabled?: boolean | undefined;
-    serviceName?: string | undefined;
-    environment?: string | undefined;
-    dbStatementDebug?: boolean | undefined;
-    /** Deployment environment fallback (from app.env). */
-    appEnv?: string | undefined;
-}
-
-const DEFAULTS = {
-    enabled: true as const,
-    serviceName: 'ts-libs' as const,
-    environment: 'development' as const,
-};
-
-/**
- * Resolve the full telemetry config by merging a partial override with defaults.
- */
-export function getTelemetryConfig(configPartial: TelemetryConfigPartial = {}): TelemetryConfig {
-    const enabled = configPartial.enabled ?? DEFAULTS.enabled;
-    const serviceName = configPartial.serviceName ?? DEFAULTS.serviceName;
-
-    return {
-        enabled,
-        serviceName,
-        environment: configPartial.environment ?? configPartial.appEnv ?? DEFAULTS.environment,
-        dbStatementDebug: configPartial.dbStatementDebug ?? false,
-    };
-}