@gobing-ai/ts-infra 0.1.0

package/dist/event-bus/event-bus.js

@@ -0,0 +1,211 @@
+import { getLogger } from '../logger.js';
+let _busLogger;
+function busLogger() {
+    if (!_busLogger)
+        _busLogger = getLogger('event-bus');
+    return _busLogger;
+}
+/**
+ * Type-safe event bus supporting both synchronous (in-process) and
+ * asynchronous handlers with optional job-queue enqueue instrumentation.
+ */
+export class EventBus {
+    syncHandlers = new Map();
+    asyncHandlers = new Map();
+    asyncHandlerIds = new WeakMap();
+    jobQueue;
+    lifecycleBus;
+    nextAsyncHandlerId = 0;
+    constructor(opts) {
+        this.jobQueue = opts?.jobQueue ?? null;
+        this.lifecycleBus = opts?.lifecycleBus ?? null;
+    }
+    on(event, handler, opts) {
+        if (opts?.async) {
+            this.registerAsync(event, handler);
+        }
+        else {
+            this.registerSync(event, handler);
+        }
+    }
+    once(event, handler, opts) {
+        const wrapped = ((...args) => {
+            this.off(event, wrapped);
+            handler(...args);
+        });
+        this.on(event, wrapped, opts);
+    }
+    off(event, handler) {
+        const syncSet = this.syncHandlers.get(event);
+        if (syncSet) {
+            syncSet.delete(handler);
+            if (syncSet.size === 0) {
+                this.syncHandlers.delete(event);
+            }
+        }
+        const asyncSet = this.asyncHandlers.get(event);
+        if (asyncSet) {
+            asyncSet.delete(handler);
+            if (asyncSet.size === 0) {
+                this.asyncHandlers.delete(event);
+            }
+        }
+    }
+    removeAllListeners(event) {
+        if (event !== undefined) {
+            this.syncHandlers.delete(event);
+            this.asyncHandlers.delete(event);
+        }
+        else {
+            this.syncHandlers.clear();
+            this.asyncHandlers.clear();
+        }
+    }
+    async emit(event, ...args) {
+        const eventName = String(event);
+        const startMs = performance.now();
+        let syncCount = 0;
+        let asyncCount = 0;
+        let errors = 0;
+        const syncSet = this.syncHandlers.get(event);
+        if (syncSet) {
+            syncCount = syncSet.size;
+            for (const handler of syncSet) {
+                try {
+                    handler(...args);
+                }
+                catch (error) {
+                    errors++;
+                    const message = error instanceof Error ? error.message : String(error);
+                    busLogger().error('sync handler threw', { event: eventName, error: message });
+                    this.publishHandlerError(eventName, 'sync', message);
+                }
+            }
+        }
+        const asyncSet = this.asyncHandlers.get(event);
+        if (asyncSet && asyncSet.size > 0) {
+            const handlers = [...asyncSet];
+            asyncCount = handlers.length;
+            for (const handler of handlers) {
+                if (this.jobQueue) {
+                    try {
+                        const jobId = await this.jobQueue.enqueue(eventName, {
+                            event: eventName,
+                            args,
+                            handlerId: this.getAsyncHandlerId(handler),
+                        });
+                        busLogger().debug('async job enqueued', { event: eventName, jobId, handlerCount: 1 });
+                        this.publishAsyncEnqueued(eventName, jobId, 1);
+                    }
+                    catch (error) {
+                        errors++;
+                        const message = error instanceof Error ? error.message : String(error);
+                        busLogger().error('async enqueue failed', { event: eventName, error: message });
+                        this.publishHandlerError(eventName, 'async', message);
+                        continue;
+                    }
+                }
+                else {
+                    busLogger().warn('async handlers registered but no JobQueue injected', {
+                        event: eventName,
+                    });
+                }
+                try {
+                    await Promise.resolve().then(() => handler(...args));
+                }
+                catch (error) {
+                    errors++;
+                    const message = error instanceof Error ? error.message : String(error);
+                    busLogger().error('async handler threw', { event: eventName, error: message });
+                    this.publishHandlerError(eventName, 'async', message);
+                }
+            }
+        }
+        const durationMs = performance.now() - startMs;
+        const detail = args.length === 1 ? args[0] : args.length > 1 ? args : undefined;
+        this.publishEmitDone({ event: eventName, syncCount, asyncCount, emitDurationMs: durationMs, errors, detail });
+        if (syncCount === 0 && asyncCount === 0) {
+            busLogger().debug('emit with zero handlers', { event: eventName });
+            this.publishEmitNoop(eventName);
+        }
+    }
+    listenerCount(event, mode) {
+        const sync = mode !== 'async' ? (this.syncHandlers.get(event)?.size ?? 0) : 0;
+        const async = mode !== 'sync' ? (this.asyncHandlers.get(event)?.size ?? 0) : 0;
+        return sync + async;
+    }
+    eventNames() {
+        const names = new Set();
+        for (const key of this.syncHandlers.keys())
+            names.add(String(key));
+        for (const key of this.asyncHandlers.keys())
+            names.add(String(key));
+        return [...names];
+    }
+    registerSync(event, handler) {
+        let set = this.syncHandlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.syncHandlers.set(event, set);
+        }
+        set.add(handler);
+    }
+    registerAsync(event, handler) {
+        let set = this.asyncHandlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.asyncHandlers.set(event, set);
+        }
+        set.add(handler);
+    }
+    getAsyncHandlerId(handler) {
+        const existing = this.asyncHandlerIds.get(handler);
+        if (existing)
+            return existing;
+        const id = `handler-${++this.nextAsyncHandlerId}`;
+        this.asyncHandlerIds.set(handler, id);
+        return id;
+    }
+    publishEmitDone(detail) {
+        if (this.lifecycleBus) {
+            try {
+                void this.lifecycleBus.emit('bus.emit.done', detail);
+            }
+            catch {
+                // Lifecycle bus failures must never affect the primary bus.
+            }
+        }
+    }
+    publishEmitNoop(event) {
+        if (this.lifecycleBus) {
+            try {
+                void this.lifecycleBus.emit('bus.emit.noop', { event });
+            }
+            catch {
+                // Swallow.
+            }
+        }
+    }
+    publishHandlerError(event, mode, error) {
+        if (this.lifecycleBus) {
+            const detail = { event, mode, error };
+            try {
+                void this.lifecycleBus.emit('bus.handler.error', detail);
+            }
+            catch {
+                // Swallow.
+            }
+        }
+    }
+    publishAsyncEnqueued(event, jobId, handlerCount) {
+        if (this.lifecycleBus) {
+            const detail = { event, jobId, handlerCount };
+            try {
+                void this.lifecycleBus.emit('bus.handler.async.enqueued', detail);
+            }
+            catch {
+                // Swallow.
+            }
+        }
+    }
+}

package/dist/event-bus/index.d.ts

@@ -0,0 +1,3 @@
+export { EventBus } from './event-bus';
+export type { AsyncEnqueuedDetail, BusLifecycleEvents, EmitDoneDetail, EventMap, HandlerErrorDetail, SubscribeOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/event-bus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-bus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACR,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}

package/dist/event-bus/index.js

@@ -0,0 +1 @@
+export { EventBus } from './event-bus.js';

package/dist/event-bus/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Event bus types — shared constraints for typed pub-sub.
+ */
+export type EventMap = Record<string, (...args: never[]) => void>;
+export interface SubscribeOptions {
+    /** When true, the handler is dispatched through the async handler path. */
+    async?: boolean;
+}
+export interface EmitDoneDetail {
+    event: string;
+    syncCount: number;
+    asyncCount: number;
+    emitDurationMs: number;
+    errors: number;
+    detail?: unknown;
+}
+export interface HandlerErrorDetail {
+    event: string;
+    mode: 'sync' | 'async';
+    error: string;
+}
+export interface AsyncEnqueuedDetail {
+    event: string;
+    jobId: string;
+    handlerCount: number;
+}
+export type BusLifecycleEvents = {
+    'bus.emit.done': (detail: EmitDoneDetail) => void;
+    'bus.emit.noop': (detail: {
+        event: string;
+    }) => void;
+    'bus.handler.error': (detail: HandlerErrorDetail) => void;
+    'bus.handler.async.enqueued': (detail: AsyncEnqueuedDetail) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/event-bus/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event-bus/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,eAAe,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrD,mBAAmB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1D,4BAA4B,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvE,CAAC"}

package/dist/event-bus/types.js

@@ -0,0 +1,3 @@
+/**
+ * Event bus types — shared constraints for typed pub-sub.
+ */

package/dist/events/app-events.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Application event definitions — generic typed event map pattern.
+ * Apps extend this with their own event types.
+ */
+export type AppEvents = Record<string, (...args: never[]) => void>;
+export type AppInternalEvents = Record<string, (...args: never[]) => void>;
+//# sourceMappingURL=app-events.d.ts.map

package/dist/events/app-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-events.d.ts","sourceRoot":"","sources":["../../src/events/app-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC"}

package/dist/events/app-events.js

@@ -0,0 +1,4 @@
+/**
+ * Application event definitions — generic typed event map pattern.
+ * Apps extend this with their own event types.
+ */

package/dist/events/create-system-bus.d.ts

@@ -0,0 +1,6 @@
+import { EventBus } from '../event-bus/event-bus';
+/**
+ * Factory that creates a configured system event bus.
+ */
+export declare function createSystemBus(): EventBus<Record<string, (...args: never[]) => void>>;
+//# sourceMappingURL=create-system-bus.d.ts.map

package/dist/events/create-system-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-system-bus.d.ts","sourceRoot":"","sources":["../../src/events/create-system-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;GAEG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC,CAEtF"}

package/dist/events/create-system-bus.js

@@ -0,0 +1,7 @@
+import { EventBus } from '../event-bus/event-bus.js';
+/**
+ * Factory that creates a configured system event bus.
+ */
+export function createSystemBus() {
+    return new EventBus();
+}

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export type { AppEvents, AppInternalEvents } from './app-events';
+export { createSystemBus } from './create-system-bus';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1 @@
+export { createSystemBus } from './create-system-bus.js';

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { APIClient, type APIClientConfig, APIError, type RequestOptions } from './api-client';
+export { EventBus, type EventMap, type SubscribeOptions } from './event-bus/index';
+export type { AppEvents, AppInternalEvents } from './events/index';
+export { createSystemBus } from './events/index';
+export type { EnqueueOptions, Job, JobHandler, JobQueue, QueueConsumer, QueueConsumerConfig, QueueStats, } from './job-queue/index';
+export { getLogger, initializeLogger, type Logger, type LogLevel } from './logger';
+export { CloudflareSchedulerAdapter, getSchedulerAdapter, initScheduler, NodeSchedulerAdapter, NoopSchedulerAdapter, type ScheduledAction, type SchedulerAdapter, setSchedulerAdapter, } from './scheduler/index';
+export { addSpanAttributes, addSpanEvent, extractSqlOperation, getActiveSpan, getDbOperationDuration, getDbOperationErrors, getDbOperationTotal, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getHttpServerRequestDuration, getHttpServerRequestErrors, getHttpServerRequestTotal, 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

@@ -0,0 +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,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGnF,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,mBAAmB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,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,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

@@ -0,0 +1,11 @@
+// API Client
+export { APIClient, APIError } from './api-client.js';
+// Event Bus
+export { EventBus } from './event-bus/index.js';
+export { createSystemBus } from './events/index.js';
+// Logger
+export { getLogger, initializeLogger } from './logger.js';
+// Scheduler
+export { CloudflareSchedulerAdapter, getSchedulerAdapter, initScheduler, NodeSchedulerAdapter, NoopSchedulerAdapter, setSchedulerAdapter, } from './scheduler/index.js';
+// Telemetry
+export { addSpanAttributes, addSpanEvent, extractSqlOperation, getActiveSpan, getDbOperationDuration, getDbOperationErrors, getDbOperationTotal, getEventbusEmitsTotal, getEventbusErrorsTotal, getHttpClientRequestDuration, getHttpClientRequestErrors, getHttpClientRequestTotal, getHttpServerRequestDuration, getHttpServerRequestErrors, getHttpServerRequestTotal, getQueueJobCompletedTotal, getQueueJobEnqueuedTotal, getQueueJobFailedTotal, getQueueJobProcessingDuration, getSchedulerJobDuration, getSchedulerJobExecutedTotal, getSchedulerJobFailedTotal, getTelemetryConfig, getTracer, initMetrics, initTelemetry, isTelemetryEnabled, sanitizeSql, shutdownMetrics, shutdownTelemetry, traceAsync, traceSync, withSpan, } from './telemetry/index.js';

package/dist/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "85EEE2840539F19364756E2164756E21",
+  "names": []
+}

package/dist/job-queue/index.d.ts

@@ -0,0 +1,2 @@
+export type { EnqueueOptions, Job, JobHandler, JobQueue, QueueConsumer, QueueConsumerConfig, QueueStats, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/job-queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/job-queue/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,cAAc,EACd,GAAG,EACH,UAAU,EACV,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,GACb,MAAM,SAAS,CAAC"}

package/dist/job-queue/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Job queue types for async work processing with retry.
+ *
+ * **Types only** — the DB-backed `DbQueue` and `DbConsumer` implementations
+ * that drive the job-queue subsystem live in `@spur/core`. These interfaces
+ * are provided here so `EventBus` and other infra components can reference
+ * the queue contract without a circular dependency on the DB layer.
+ */
+export interface Job<T = unknown> {
+    id: string;
+    type: string;
+    payload: T;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    attempts: number;
+    maxRetries: number;
+    createdAt: number;
+    updatedAt: number;
+    nextRetryAt: number | null;
+    lastError: string | null;
+    processingAt: number | null;
+}
+export interface EnqueueOptions {
+    maxRetries?: number;
+    delay?: number;
+    ttlMs?: number;
+}
+export interface JobQueue<T = unknown> {
+    enqueue(type: string, payload: T, options?: EnqueueOptions): Promise<string>;
+    enqueueBatch(jobs: Array<{
+        type: string;
+        payload: T;
+    } & EnqueueOptions>): Promise<string[]>;
+}
+export type JobHandler<T = unknown> = (job: Job<T>) => Promise<void>;
+export interface QueueStats {
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+}
+export interface QueueConsumerConfig {
+    pollInterval?: number;
+    batchSize?: number;
+    maxConcurrency?: number;
+    visibilityTimeout?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    drainTimeoutMs?: number;
+    maxPollBackoff?: number;
+}
+export interface QueueConsumer<T = unknown> {
+    register(type: string, handler: JobHandler<T>): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    stats(): Promise<QueueStats>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/job-queue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/job-queue/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,OAAO;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/F;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAChC"}

package/dist/job-queue/types.js

@@ -0,0 +1,8 @@
+/**
+ * Job queue types for async work processing with retry.
+ *
+ * **Types only** — the DB-backed `DbQueue` and `DbConsumer` implementations
+ * that drive the job-queue subsystem live in `@spur/core`. These interfaces
+ * are provided here so `EventBus` and other infra components can reference
+ * the queue contract without a circular dependency on the DB layer.
+ */

package/dist/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Structured JSON logger with levels (trace/debug/info/warn/error/fatal).
+ *
+ * No external dependencies — console-based implementation.
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface Logger {
+    trace(msg: string, data?: Record<string, unknown>): void;
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+    fatal(msg: string, data?: Record<string, unknown>): void;
+    child(context: Record<string, unknown>): Logger;
+}
+/**
+ * Mute or unmute all logger console output. Useful for tests.
+ */
+export declare function setLoggerMuted(muted: boolean): void;
+/**
+ * Get or create a logger for the given category.
+ */
+export declare function getLogger(category: string): Logger;
+/**
+ * Initialize the logger subsystem with a minimum log level.
+ */
+export declare function initializeLogger(level?: LogLevel): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAW/E,MAAM,WAAW,MAAM;IACnB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CACnD;AAwED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,QAAiB,GAAG,IAAI,CAG/D"}

package/dist/logger.js

@@ -0,0 +1,100 @@
+/**
+ * Structured JSON logger with levels (trace/debug/info/warn/error/fatal).
+ *
+ * No external dependencies — console-based implementation.
+ */
+const LEVEL_ORDER = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+class ConsoleLogger {
+    category;
+    minLevel;
+    context;
+    constructor(category, minLevel = 'info', context = {}) {
+        this.category = category;
+        this.minLevel = minLevel;
+        this.context = { category, ...context };
+    }
+    log(level, msg, data) {
+        if (LEVEL_ORDER[level] < LEVEL_ORDER[this.minLevel])
+            return;
+        if (globalMuted)
+            return;
+        const entry = {
+            level,
+            message: msg,
+            timestamp: new Date().toISOString(),
+            ...this.context,
+            ...data,
+        };
+        const json = JSON.stringify(entry);
+        switch (level) {
+            case 'error':
+            case 'fatal':
+                console.error(json);
+                break;
+            case 'warn':
+                console.warn(json);
+                break;
+            case 'debug':
+            case 'trace':
+                console.debug(json);
+                break;
+            default:
+                console.log(json);
+        }
+    }
+    trace(msg, data) {
+        this.log('trace', msg, data);
+    }
+    debug(msg, data) {
+        this.log('debug', msg, data);
+    }
+    info(msg, data) {
+        this.log('info', msg, data);
+    }
+    warn(msg, data) {
+        this.log('warn', msg, data);
+    }
+    error(msg, data) {
+        this.log('error', msg, data);
+    }
+    fatal(msg, data) {
+        this.log('fatal', msg, data);
+    }
+    child(context) {
+        return new ConsoleLogger(this.category, this.minLevel, { ...this.context, ...context });
+    }
+}
+const loggers = new Map();
+let globalLevel = 'info';
+let globalMuted = false;
+/**
+ * Mute or unmute all logger console output. Useful for tests.
+ */
+export function setLoggerMuted(muted) {
+    globalMuted = muted;
+}
+/**
+ * Get or create a logger for the given category.
+ */
+export function getLogger(category) {
+    const existing = loggers.get(category);
+    if (existing)
+        return existing;
+    const logger = new ConsoleLogger(category, globalLevel);
+    loggers.set(category, logger);
+    return logger;
+}
+/**
+ * Initialize the logger subsystem with a minimum log level.
+ */
+export function initializeLogger(level = 'info') {
+    globalLevel = level;
+    loggers.clear();
+}

package/dist/scheduler/action.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scheduler action type re-export.
+ */
+export type { ScheduledAction } from './types';
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/scheduler/action.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/scheduler/cloudflare.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cloudflare Workers scheduler adapter using Cron Triggers.
+ * Uses minimal local type declarations — no @cloudflare/workers-types dependency.
+ */
+import type { ScheduledAction, SchedulerAdapter } from './types';
+interface CfScheduledEvent {
+    cron: string;
+    scheduledTime: number;
+    waitUntil(promise: Promise<unknown>): void;
+}
+interface CfEventContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
+export declare class CloudflareSchedulerAdapter implements SchedulerAdapter {
+    private readonly entries;
+    constructor();
+    register(cron: string, action: ScheduledAction): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Handle a Cloudflare Workers Cron Trigger event.
+     * Call this from the Worker's `scheduled()` export.
+     */
+    handleScheduledEvent(event: CfScheduledEvent, ctx: CfEventContext): void;
+}
+export {};
+//# sourceMappingURL=cloudflare.d.ts.map

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

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

package/dist/scheduler/cloudflare.js

@@ -0,0 +1,24 @@
+export class CloudflareSchedulerAdapter {
+    entries = new Map();
+    constructor() { }
+    register(cron, action) {
+        this.entries.set(cron, action);
+    }
+    async start() {
+        // Cloudflare Workers use cron triggers defined in wrangler.toml.
+        // The `scheduled()` handler should call `handleScheduledEvent()`.
+    }
+    async stop() {
+        this.entries.clear();
+    }
+    /**
+     * Handle a Cloudflare Workers Cron Trigger event.
+     * Call this from the Worker's `scheduled()` export.
+     */
+    handleScheduledEvent(event, ctx) {
+        const action = this.entries.get(event.cron);
+        if (action) {
+            ctx.waitUntil(action());
+        }
+    }
+}