nugi-ts-logs-sdk 1.0.0

package/dist/transport/batcher.js

@@ -0,0 +1,129 @@
+"use strict";
+// Buffers telemetry events and ships them in batches. Responsibilities:
+//   - Buffering: bounded in-memory queue; oldest events dropped on overflow.
+//   - Batching: flush on size threshold or a periodic timer.
+//   - Retries: delegate to the transport's retry, re-buffer transient failures.
+//   - Backpressure/safety: a single in-flight flush; never throws to callers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Batcher = void 0;
+const transport_1 = require("./transport");
+const retry_1 = require("./retry");
+class Batcher {
+    constructor(config, resource, transport, diagnostics) {
+        this.config = config;
+        this.resource = resource;
+        this.transport = transport;
+        this.diagnostics = diagnostics;
+        this.buffer = [];
+        this.flushing = false;
+        this.droppedSinceLastFlush = 0;
+        this.closed = false;
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, this.config.flushIntervalMs);
+        // Background flushing shouldn't keep the process alive on its own.
+        this.timer.unref?.();
+    }
+    /** Add an event to the buffer. Non-blocking; triggers a flush when full. */
+    enqueue(event) {
+        if (this.closed)
+            return;
+        this.buffer.push(event);
+        if (this.buffer.length > this.config.maxBufferSize) {
+            // Drop oldest to preserve the most recent signal under sustained overload.
+            const overflow = this.buffer.length - this.config.maxBufferSize;
+            this.buffer.splice(0, overflow);
+            this.droppedSinceLastFlush += overflow;
+        }
+        if (this.buffer.length >= this.config.batchSize) {
+            void this.flush();
+        }
+    }
+    /** Flush all currently buffered events. Never rejects. */
+    async flush() {
+        if (this.flushing)
+            return;
+        if (this.buffer.length === 0)
+            return;
+        this.flushing = true;
+        try {
+            if (this.droppedSinceLastFlush > 0) {
+                this.diagnostics.debug(`dropped ${this.droppedSinceLastFlush} events due to buffer overflow`);
+                this.droppedSinceLastFlush = 0;
+            }
+            // Drain in batch-sized chunks until the buffer is empty or a send fails
+            // permanently for this cycle.
+            while (this.buffer.length > 0) {
+                const batch = this.buffer.splice(0, this.config.batchSize);
+                const delivered = await this.deliver(batch);
+                if (!delivered)
+                    break; // transient failure: stop; retry next interval
+            }
+        }
+        catch (error) {
+            this.diagnostics.error('unexpected flush failure', error);
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    /**
+     * Attempt to deliver one batch with retries. Returns true on success.
+     * On a transient failure the batch is re-buffered (front) for a later cycle;
+     * on a fatal failure (e.g. 401/400) the batch is dropped.
+     */
+    async deliver(batch) {
+        if (!this.transport.enabled) {
+            // No endpoint configured — surface locally only, don't accumulate forever.
+            return true;
+        }
+        const envelope = {
+            resource: this.resource,
+            events: batch,
+            sentAt: new Date().toISOString(),
+        };
+        try {
+            await (0, retry_1.withRetry)(() => this.transport.send(envelope), {
+                maxRetries: this.config.maxRetries,
+                baseDelayMs: this.config.retryBaseDelayMs,
+                maxDelayMs: this.config.retryMaxDelayMs,
+                isRetryable: (e) => e instanceof transport_1.TransportError ? e.retryable : true,
+                onRetry: (attempt, delayMs, error) => this.diagnostics.debug(`retrying batch (attempt ${attempt}, delay ${delayMs}ms)`, error?.message),
+            });
+            return true;
+        }
+        catch (error) {
+            const transient = error instanceof transport_1.TransportError ? error.retryable : true;
+            if (transient && !this.closed) {
+                // Re-buffer at the front, then re-apply the overflow cap.
+                this.buffer.unshift(...batch);
+                if (this.buffer.length > this.config.maxBufferSize) {
+                    const overflow = this.buffer.length - this.config.maxBufferSize;
+                    this.buffer.splice(0, overflow);
+                    this.droppedSinceLastFlush += overflow;
+                }
+                this.diagnostics.error('batch delivery failed; will retry', error);
+            }
+            else {
+                this.diagnostics.error(`dropping ${batch.length} events (non-retryable delivery failure)`, error);
+            }
+            return false;
+        }
+    }
+    /** Stop the timer and flush remaining events. Idempotent. */
+    async shutdown() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        // Final drain (allow re-buffering to be skipped by marking closed after).
+        await this.flush();
+        this.closed = true;
+    }
+    /** Current number of buffered events (for tests/diagnostics). */
+    get size() {
+        return this.buffer.length;
+    }
+}
+exports.Batcher = Batcher;
+//# sourceMappingURL=batcher.js.map

package/dist/transport/batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.js","sourceRoot":"","sources":["../../src/transport/batcher.ts"],"names":[],"mappings":"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"}

package/dist/transport/legacy-logs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fire-and-forget POST to the legacy single-event `/api/v1/logs` endpoint.
+ * Used for DB query events (and any other Nest-SDK-compatible shapes) so data
+ * lands in the same Influx measurements as nugi-logs-sdk.
+ */
+export interface LegacyLogsTransportOptions {
+    endpoint?: string;
+    apiKey: string;
+    requestTimeoutMs?: number;
+    onError?: (error: Error) => void;
+}
+export declare function resolveLogsUrl(endpoint?: string): string | undefined;
+export declare class LegacyLogsTransport {
+    private readonly options;
+    private readonly url?;
+    private readonly timeoutMs;
+    constructor(options: LegacyLogsTransportOptions);
+    post(body: Record<string, unknown>): void;
+    private send;
+}
+//# sourceMappingURL=legacy-logs.d.ts.map

package/dist/transport/legacy-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-logs.d.ts","sourceRoot":"","sources":["../../src/transport/legacy-logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMpE;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,0BAA0B;IAKhE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;YAI3B,IAAI;CA4BnB"}

package/dist/transport/legacy-logs.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Fire-and-forget POST to the legacy single-event `/api/v1/logs` endpoint.
+ * Used for DB query events (and any other Nest-SDK-compatible shapes) so data
+ * lands in the same Influx measurements as nugi-logs-sdk.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LegacyLogsTransport = void 0;
+exports.resolveLogsUrl = resolveLogsUrl;
+function resolveLogsUrl(endpoint) {
+    if (!endpoint)
+        return undefined;
+    const cleaned = endpoint.replace(/\/$/, '');
+    if (/\/logs\/?$/i.test(cleaned))
+        return cleaned;
+    if (/\/api\/v1$/i.test(cleaned))
+        return `${cleaned}/logs`;
+    return `${cleaned}/api/v1/logs`;
+}
+class LegacyLogsTransport {
+    constructor(options) {
+        this.options = options;
+        this.url = resolveLogsUrl(options.endpoint);
+        this.timeoutMs = options.requestTimeoutMs ?? 5000;
+    }
+    post(body) {
+        void this.send(body);
+    }
+    async send(body) {
+        try {
+            if (!this.url)
+                return;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                await fetch(this.url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-API-Key': this.options.apiKey,
+                    },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        catch (err) {
+            try {
+                this.options.onError?.(err instanceof Error ? err : new Error(String(err)));
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+exports.LegacyLogsTransport = LegacyLogsTransport;
+//# sourceMappingURL=legacy-logs.js.map

package/dist/transport/legacy-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-logs.js","sourceRoot":"","sources":["../../src/transport/legacy-logs.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AASH,wCAMC;AAND,SAAgB,cAAc,CAAC,QAAiB;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,OAAO,OAAO,CAAC;IAC1D,OAAO,GAAG,OAAO,cAAc,CAAC;AAClC,CAAC;AAED,MAAa,mBAAmB;IAI9B,YAA6B,OAAmC;QAAnC,YAAO,GAAP,OAAO,CAA4B;QAC9D,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,IAA6B;QAChC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAA6B;QAC9C,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YACtB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;oBACpB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;qBACjC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CACpB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACpD,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAzCD,kDAyCC"}

package/dist/transport/retry.d.ts

@@ -0,0 +1,16 @@
+export interface RetryOptions {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    isRetryable: (error: unknown) => boolean;
+    onRetry?: (attempt: number, delayMs: number, error: unknown) => void;
+}
+export declare function sleep(ms: number): Promise<void>;
+/** Compute a backoff delay with full jitter for a given attempt (0-based). */
+export declare function backoffDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
+/**
+ * Run `fn`, retrying on retryable errors up to `maxRetries` additional attempts.
+ * Rejects with the last error when retries are exhausted or the error is fatal.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/transport/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/transport/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/C;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/transport/retry.js

@@ -0,0 +1,43 @@
+"use strict";
+// Exponential backoff with full jitter, used to retry failed flushes.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.backoffDelay = backoffDelay;
+exports.withRetry = withRetry;
+function sleep(ms) {
+    // Not unref'd on purpose: a backoff is awaited by an in-flight flush (often an
+    // explicit flush()/shutdown()), so it must keep the event loop alive until it
+    // resolves. The idle/periodic timer in the batcher is what gets unref'd.
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/** Compute a backoff delay with full jitter for a given attempt (0-based). */
+function backoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
+    // Full jitter: random in [0, exponential].
+    return Math.floor(Math.random() * exponential);
+}
+/**
+ * Run `fn`, retrying on retryable errors up to `maxRetries` additional attempts.
+ * Rejects with the last error when retries are exhausted or the error is fatal.
+ */
+async function withRetry(fn, opts) {
+    let attempt = 0;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt >= opts.maxRetries || !opts.isRetryable(error)) {
+                throw error;
+            }
+            const delay = backoffDelay(attempt, opts.baseDelayMs, opts.maxDelayMs);
+            opts.onRetry?.(attempt + 1, delay, error);
+            await sleep(delay);
+            attempt++;
+        }
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/transport/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/transport/retry.ts"],"names":[],"mappings":";AAAA,sEAAsE;;AAUtE,sBAOC;AAGD,oCAQC;AAMD,8BAmBC;AA3CD,SAAgB,KAAK,CAAC,EAAU;IAC9B,+EAA+E;IAC/E,8EAA8E;IAC9E,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,SAAgB,YAAY,CAC1B,OAAe,EACf,WAAmB,EACnB,UAAkB;IAElB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;IACrE,2CAA2C;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,IAAkB;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,iDAAiD;IACjD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACvE,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/transport/transport.d.ts

@@ -0,0 +1,14 @@
+import { EventEnvelope } from '../types';
+import { ResolvedConfig } from '../config';
+export declare class TransportError extends Error {
+    readonly retryable: boolean;
+    readonly status?: number | undefined;
+    constructor(message: string, retryable: boolean, status?: number | undefined);
+}
+export interface Transport {
+    send(envelope: EventEnvelope): Promise<void>;
+    /** Whether the transport can actually deliver (endpoint configured, fetch available). */
+    readonly enabled: boolean;
+}
+export declare function createHttpTransport(config: ResolvedConfig): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,SAAS,EAAE,OAAO;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE,MAAM,YAAA;CAK3B;AASD,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CA4DrE"}

package/dist/transport/transport.js

@@ -0,0 +1,70 @@
+"use strict";
+// HTTP transport. Dependency-free: uses the global fetch/AbortController present
+// in Node 18+ (and modern runtimes/edge). Retryability is classified so the
+// batcher can decide whether to re-buffer a failed batch.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportError = void 0;
+exports.createHttpTransport = createHttpTransport;
+class TransportError extends Error {
+    constructor(message, retryable, status) {
+        super(message);
+        this.retryable = retryable;
+        this.status = status;
+        this.name = 'TransportError';
+    }
+}
+exports.TransportError = TransportError;
+function createHttpTransport(config) {
+    const url = config.endpoint
+        ? joinUrl(config.endpoint, config.ingestPath)
+        : undefined;
+    // A configured endpoint means we intend to deliver; fetch is resolved lazily
+    // at send time so polyfilled/late-bound fetch implementations still work.
+    const enabled = !!url;
+    return {
+        enabled,
+        async send(envelope) {
+            const fetchFn = globalThis.fetch;
+            if (!url || typeof fetchFn !== 'function') {
+                // No endpoint / no fetch available: nothing to deliver to. Not retryable.
+                return;
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), config.requestTimeoutMs);
+            timer.unref?.();
+            let response;
+            try {
+                response = await fetchFn(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-API-Key': config.apiKey,
+                        'User-Agent': `nugi-ts-logs-sdk/${envelope.resource.host.sdkVersion}`,
+                    },
+                    body: JSON.stringify(envelope),
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                // Network error / timeout / abort — retryable.
+                throw new TransportError(`network error: ${error?.message ?? error}`, true);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (response.ok)
+                return;
+            // 408/429 and 5xx are transient; other 4xx are fatal (bad request/auth).
+            const retryable = response.status === 408 ||
+                response.status === 429 ||
+                response.status >= 500;
+            throw new TransportError(`HTTP ${response.status} ${response.statusText}`, retryable, response.status);
+        },
+    };
+}
+function joinUrl(base, path) {
+    const b = base.replace(/\/+$/, '');
+    const p = path.replace(/^\/+/, '');
+    return `${b}/${p}`;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4EAA4E;AAC5E,0DAA0D;;;AA6B1D,kDA4DC;AApFD,MAAa,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACN,SAAkB,EAClB,MAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,cAAS,GAAT,SAAS,CAAS;QAClB,WAAM,GAAN,MAAM,CAAS;QAGxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AATD,wCASC;AAeD,SAAgB,mBAAmB,CAAC,MAAsB;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ;QACzB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IACd,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC;IAEtB,OAAO;QACL,OAAO;QACP,KAAK,CAAC,IAAI,CAAC,QAAuB;YAChC,MAAM,OAAO,GAAI,UAAkC,CAAC,KAAK,CAAC;YAC1D,IAAI,CAAC,GAAG,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC1C,0EAA0E;gBAC1E,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,MAAM,CAAC,gBAAgB,CACxB,CAAC;YACF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAEhB,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;oBAC5B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,WAAW,EAAE,MAAM,CAAC,MAAM;wBAC1B,YAAY,EAAE,oBAAoB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE;qBACtE;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;oBAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+CAA+C;gBAC/C,MAAM,IAAI,cAAc,CACtB,kBAAmB,KAAe,EAAE,OAAO,IAAI,KAAK,EAAE,EACtD,IAAI,CACL,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAED,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO;YAExB,yEAAyE;YACzE,MAAM,SAAS,GACb,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACvB,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACvB,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;YACzB,MAAM,IAAI,cAAc,CACtB,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAChD,SAAS,EACT,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,136 @@
+export type Severity = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+export type SpanKind = 'server' | 'client' | 'internal' | 'producer' | 'consumer';
+export type SpanStatus = 'unset' | 'ok' | 'error';
+export type Attributes = Record<string, unknown>;
+export interface StackFrame {
+    filename: string;
+    absPath?: string;
+    function: string;
+    lineno?: number;
+    colno?: number;
+    inApp: boolean;
+    contextLine?: string;
+    preContext?: string[];
+    postContext?: string[];
+    module?: string;
+    raw?: string;
+}
+export interface HostMetadata {
+    hostname: string;
+    serverIp: string;
+    /** All resolved non-internal server IPs. */
+    serverIps?: {
+        ipv4: string[];
+        ipv6: string[];
+    };
+    sdkVersion: string;
+    nodeVersion: string;
+    os: string;
+    pid: number;
+}
+export interface RuntimeMetadata {
+    memoryUsage: {
+        rss: number;
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+    };
+    cpuUsage: {
+        percent: number;
+        user: number;
+        system: number;
+    };
+}
+/** Immutable descriptor of the service emitting telemetry. */
+export interface Resource {
+    appId: string;
+    serviceName: string;
+    environment: string;
+    /** Deploy / release version (low cardinality). */
+    release?: string;
+    host: HostMetadata;
+}
+export interface BaseEvent {
+    /** ISO-8601 wall-clock time the event was recorded. */
+    timestamp: string;
+    traceId?: string;
+    spanId?: string;
+    attributes?: Attributes;
+}
+export interface LogEvent extends BaseEvent {
+    kind: 'log';
+    level: Severity;
+    message: string;
+}
+export interface MetricEvent extends BaseEvent {
+    kind: 'metric';
+    name: string;
+    type: MetricType;
+    value: number;
+    unit?: string;
+}
+export interface SpanEventEntry {
+    name: string;
+    timestamp: string;
+    attributes?: Attributes;
+}
+export interface SpanEvent extends BaseEvent {
+    kind: 'span';
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    spanKind: SpanKind;
+    startTime: string;
+    endTime: string;
+    durationMs: number;
+    status: SpanStatus;
+    statusMessage?: string;
+    events?: SpanEventEntry[];
+    /** Per-call runtime snapshot (memory/CPU) when available. */
+    runtime?: RuntimeMetadata;
+}
+export interface Breadcrumb {
+    timestamp: string;
+    type: string;
+    level: Severity;
+    message: string;
+    data?: Attributes;
+}
+export interface ErrorEvent extends BaseEvent {
+    kind: 'error';
+    name: string;
+    message: string;
+    stack?: string;
+    /** Sentry-style structured frames with optional source context. */
+    frames?: StackFrame[];
+    code?: string | number;
+    /** false when the error was uncaught / crashed a request. */
+    handled: boolean;
+    /** How the error was captured, e.g. 'auto.node.uncaughtException'. */
+    mechanism?: string;
+    /** Trail of events (console/logs/http) captured before the error. */
+    breadcrumbs?: Breadcrumb[];
+    runtime?: RuntimeMetadata;
+}
+/** Database query timing event (also dual-written to legacy /logs when configured). */
+export interface QueryEvent extends BaseEvent {
+    kind: 'query';
+    query: string;
+    durationMs: number;
+    orm?: string;
+    success?: boolean;
+    slow?: boolean;
+    error?: string;
+    requestId?: string;
+    release?: string;
+}
+export type TelemetryEvent = LogEvent | MetricEvent | SpanEvent | ErrorEvent | QueryEvent;
+/** A batch of events sharing one Resource — the transport payload. */
+export interface EventEnvelope {
+    resource: Resource;
+    events: TelemetryEvent[];
+    sentAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Shared telemetry model. Every signal (log, metric, span, error) is normalised
+// into a TelemetryEvent and shipped inside an EventEnvelope that also carries the
+// immutable Resource describing the emitting service/host.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,kFAAkF;AAClF,2DAA2D;AAC3D,8EAA8E"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "nugi-ts-logs-sdk",
+  "version": "1.0.0",
+  "description": "Framework-agnostic TypeScript observability SDK (logs, metrics, traces, queries, check-ins, distributed tracing) with batching, retries and buffering. Works with Express, Fastify, NestJS and plain Node.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "observability",
+    "logging",
+    "metrics",
+    "tracing",
+    "distributed-tracing",
+    "telemetry",
+    "express",
+    "fastify",
+    "nestjs",
+    "opentelemetry",
+    "sql",
+    "database"
+  ],
+  "author": "Agbama Achu-ulim Akem",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@types/node": "^20.0.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.8.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
+    "rxjs": "^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  }
+}