nugi-ts-logs-sdk 1.0.0

package/dist/internal/metadata.js.map

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

package/dist/internal/propagation.d.ts

@@ -0,0 +1,30 @@
+export interface SpanContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    /** Whether this trace is sampled (recorded/exported). */
+    sampled: boolean;
+    traceState?: string;
+}
+export declare const TRACEPARENT_HEADER = "traceparent";
+export declare const TRACESTATE_HEADER = "tracestate";
+/** Parse an incoming traceparent header into its parts, if valid. */
+export declare function parseTraceparent(header: string | undefined): {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+} | undefined;
+/** Format a SpanContext as a traceparent header value. */
+export declare function formatTraceparent(ctx: SpanContext): string;
+/**
+ * Extract a parent SpanContext from inbound carrier headers. Returns undefined
+ * when no valid trace context is present (caller then starts a fresh trace).
+ *
+ * Supports W3C `traceparent` plus vendor fallbacks (`x-trace-id`, B3, ALB).
+ */
+export declare function extractContext(headers?: Record<string, unknown>): SpanContext | undefined;
+/** Inject a SpanContext into an outbound carrier (e.g. outgoing HTTP headers). */
+export declare function injectContext(ctx: SpanContext, carrier: Record<string, string>): Record<string, string>;
+/** Create a brand-new root context. */
+export declare function createRootContext(sampled: boolean): SpanContext;
+//# sourceMappingURL=propagation.d.ts.map

package/dist/internal/propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../src/internal/propagation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAW9C,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GACvD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrD,SAAS,CAQZ;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,WAAW,GAAG,SAAS,CAuCzB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAC3B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAM/D"}

package/dist/internal/propagation.js

@@ -0,0 +1,99 @@
+"use strict";
+// W3C Trace Context propagation (traceparent / tracestate).
+// https://www.w3.org/TR/trace-context/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACESTATE_HEADER = exports.TRACEPARENT_HEADER = void 0;
+exports.parseTraceparent = parseTraceparent;
+exports.formatTraceparent = formatTraceparent;
+exports.extractContext = extractContext;
+exports.injectContext = injectContext;
+exports.createRootContext = createRootContext;
+const ids_1 = require("./ids");
+exports.TRACEPARENT_HEADER = 'traceparent';
+exports.TRACESTATE_HEADER = 'tracestate';
+function headerValue(headers, name) {
+    const raw = headers[name] ?? headers[name.toLowerCase()];
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    return typeof value === 'string' && value.length ? value : undefined;
+}
+/** Parse an incoming traceparent header into its parts, if valid. */
+function parseTraceparent(header) {
+    if (!header)
+        return undefined;
+    const parts = header.trim().split('-');
+    if (parts.length < 4)
+        return undefined;
+    const [, traceId, spanId, flags] = parts;
+    if (!(0, ids_1.isValidTraceId)(traceId) || !(0, ids_1.isValidSpanId)(spanId))
+        return undefined;
+    const sampled = (parseInt(flags, 16) & 0x01) === 0x01;
+    return { traceId, spanId, sampled };
+}
+/** Format a SpanContext as a traceparent header value. */
+function formatTraceparent(ctx) {
+    const flags = ctx.sampled ? '01' : '00';
+    return `00-${ctx.traceId}-${ctx.spanId}-${flags}`;
+}
+/**
+ * Extract a parent SpanContext from inbound carrier headers. Returns undefined
+ * when no valid trace context is present (caller then starts a fresh trace).
+ *
+ * Supports W3C `traceparent` plus vendor fallbacks (`x-trace-id`, B3, ALB).
+ */
+function extractContext(headers = {}) {
+    const parsed = parseTraceparent(headerValue(headers, exports.TRACEPARENT_HEADER));
+    if (parsed) {
+        return {
+            traceId: parsed.traceId,
+            // The inbound span id becomes our parent.
+            spanId: parsed.spanId,
+            parentSpanId: parsed.spanId,
+            sampled: parsed.sampled,
+            traceState: headerValue(headers, exports.TRACESTATE_HEADER),
+        };
+    }
+    const vendorTrace = headerValue(headers, 'x-trace-id') ||
+        headerValue(headers, 'x-b3-traceid') ||
+        headerValue(headers, 'x-amzn-trace-id');
+    if (!vendorTrace)
+        return undefined;
+    let traceId = vendorTrace.replace(/[^a-fA-F0-9]/g, '').toLowerCase();
+    if (traceId.length > 32)
+        traceId = traceId.slice(0, 32);
+    if (traceId.length < 32)
+        traceId = traceId.padStart(32, '0');
+    if (!(0, ids_1.isValidTraceId)(traceId))
+        return undefined;
+    const vendorSpan = headerValue(headers, 'x-span-id') ||
+        headerValue(headers, 'x-b3-spanid') ||
+        (0, ids_1.generateSpanId)();
+    let spanId = vendorSpan.replace(/[^a-fA-F0-9]/g, '').toLowerCase();
+    if (spanId.length > 16)
+        spanId = spanId.slice(0, 16);
+    if (spanId.length < 16)
+        spanId = spanId.padStart(16, '0');
+    if (!(0, ids_1.isValidSpanId)(spanId))
+        spanId = (0, ids_1.generateSpanId)();
+    return {
+        traceId,
+        spanId,
+        parentSpanId: spanId,
+        sampled: true,
+    };
+}
+/** Inject a SpanContext into an outbound carrier (e.g. outgoing HTTP headers). */
+function injectContext(ctx, carrier) {
+    carrier[exports.TRACEPARENT_HEADER] = formatTraceparent(ctx);
+    if (ctx.traceState)
+        carrier[exports.TRACESTATE_HEADER] = ctx.traceState;
+    return carrier;
+}
+/** Create a brand-new root context. */
+function createRootContext(sampled) {
+    return {
+        traceId: (0, ids_1.generateTraceId)(),
+        spanId: (0, ids_1.generateSpanId)(),
+        sampled,
+    };
+}
+//# sourceMappingURL=propagation.js.map

package/dist/internal/propagation.js.map

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

package/dist/internal/sanitize.d.ts

@@ -0,0 +1,11 @@
+export declare const REDACTED = "[REDACTED]";
+/**
+ * Deep-redact sensitive fields in an object/array. Returns a sanitized copy,
+ * never mutates input. Depth-limited and cycle-safe; never throws.
+ *
+ * @param extraKeys additional field names to redact (from the `redact` option).
+ */
+export declare function sanitizeBody(body: unknown, extraKeys?: string[], maxDepth?: number): unknown;
+/** Sanitize headers: redact known auth headers and any sensitive-looking name. */
+export declare function sanitizeHeaders(headers?: Record<string, unknown>, extraKeys?: string[]): Record<string, unknown>;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/internal/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/internal/sanitize.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,QAAQ,eAAe,CAAC;AAmBrC;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,SAAS,GAAE,MAAM,EAAO,EACxB,QAAQ,SAAI,GACX,OAAO,CAMT;AA0BD,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,SAAS,GAAE,MAAM,EAAO,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/internal/sanitize.js

@@ -0,0 +1,77 @@
+"use strict";
+// Redaction of sensitive data before it leaves the process. Applied to request/
+// response bodies and captured headers. Built-in patterns are case-insensitive
+// and substring-based (userPassword, access_token, x-api-key are caught).
+// Callers may pass extra field names to redact (case-insensitive exact match),
+// e.g. the SDK's `redact` config option.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REDACTED = void 0;
+exports.sanitizeBody = sanitizeBody;
+exports.sanitizeHeaders = sanitizeHeaders;
+exports.REDACTED = '[REDACTED]';
+const SENSITIVE_KEY_PATTERNS = [
+    'password', 'passwd', 'pwd', 'token', 'secret', 'apikey', 'api-key',
+    'authorization', 'auth', 'cookie', 'session', 'credential', 'private',
+];
+const SENSITIVE_HEADERS = [
+    'authorization', 'cookie', 'set-cookie', 'x-api-key',
+    'x-auth-token', 'proxy-authorization',
+];
+function isSensitiveKey(key, extraKeys) {
+    const lower = key.toLowerCase();
+    if (SENSITIVE_KEY_PATTERNS.some((p) => lower.includes(p)))
+        return true;
+    // User-provided fields match exactly (case-insensitive) to avoid over-redacting.
+    return extraKeys.some((k) => k.toLowerCase() === lower);
+}
+/**
+ * Deep-redact sensitive fields in an object/array. Returns a sanitized copy,
+ * never mutates input. Depth-limited and cycle-safe; never throws.
+ *
+ * @param extraKeys additional field names to redact (from the `redact` option).
+ */
+function sanitizeBody(body, extraKeys = [], maxDepth = 6) {
+    try {
+        return redact(body, extraKeys, maxDepth, new WeakSet());
+    }
+    catch {
+        return body;
+    }
+}
+function redact(value, extraKeys, depth, seen) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (depth <= 0)
+        return Array.isArray(value) ? '[Array]' : '[Object]';
+    if (seen.has(value))
+        return '[Circular]';
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item, extraKeys, depth - 1, seen));
+    }
+    const out = {};
+    for (const key of Object.keys(value)) {
+        out[key] = isSensitiveKey(key, extraKeys)
+            ? exports.REDACTED
+            : redact(value[key], extraKeys, depth - 1, seen);
+    }
+    return out;
+}
+/** Sanitize headers: redact known auth headers and any sensitive-looking name. */
+function sanitizeHeaders(headers = {}, extraKeys = []) {
+    try {
+        const out = {};
+        for (const key of Object.keys(headers)) {
+            const lower = key.toLowerCase();
+            out[key] =
+                SENSITIVE_HEADERS.includes(lower) || isSensitiveKey(key, extraKeys)
+                    ? exports.REDACTED
+                    : headers[key];
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/internal/sanitize.js.map

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

package/dist/internal/stacktrace.d.ts

@@ -0,0 +1,29 @@
+/** Sentry-style stack frame with optional source context. */
+export interface StackFrame {
+    filename: string;
+    absPath?: string;
+    function: string;
+    lineno?: number;
+    colno?: number;
+    inApp: boolean;
+    /** The source line that threw. */
+    contextLine?: string;
+    /** Lines immediately before contextLine. */
+    preContext?: string[];
+    /** Lines immediately after contextLine. */
+    postContext?: string[];
+    module?: string;
+    raw?: string;
+}
+/**
+ * Parse a V8/Node stack string into structured frames.
+ * When `withSourceContext` is true (default), reads source files from disk
+ * and attaches pre_context / context_line / post_context (Sentry-style).
+ */
+export declare function buildStackFrames(stack?: string, options?: {
+    withSourceContext?: boolean;
+}): StackFrame[];
+export declare function isInApp(file: string): boolean;
+/** Clear the source-file cache (useful in tests). */
+export declare function clearStackSourceCache(): void;
+//# sourceMappingURL=stacktrace.d.ts.map

package/dist/internal/stacktrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacktrace.d.ts","sourceRoot":"","sources":["../../src/internal/stacktrace.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAaD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5C,UAAU,EAAE,CAkDd;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO7C;AAgED,qDAAqD;AACrD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/internal/stacktrace.js

@@ -0,0 +1,182 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStackFrames = buildStackFrames;
+exports.isInApp = isInApp;
+exports.clearStackSourceCache = clearStackSourceCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const AT_RE = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?\s*$/;
+const AT_NOLOC_RE = /^\s*at\s+(.+?)\s*$/;
+/** How many source lines to include above/below the crashing line. */
+const CONTEXT_LINES = 7;
+/** Cap frames we enrich with disk I/O so reporting stays fast. */
+const MAX_CONTEXT_FRAMES = 40;
+const fileCache = new Map();
+/**
+ * Parse a V8/Node stack string into structured frames.
+ * When `withSourceContext` is true (default), reads source files from disk
+ * and attaches pre_context / context_line / post_context (Sentry-style).
+ */
+function buildStackFrames(stack, options = {}) {
+    if (!stack)
+        return [];
+    const withSourceContext = options.withSourceContext !== false;
+    const frames = [];
+    for (const line of stack.split('\n')) {
+        if (!line.trim().startsWith('at '))
+            continue;
+        const m = AT_RE.exec(line);
+        if (m) {
+            const [, fn, file, ln, col] = m;
+            frames.push({
+                function: fn || '<anonymous>',
+                filename: file,
+                absPath: file,
+                lineno: Number(ln),
+                colno: Number(col),
+                inApp: isInApp(file),
+                module: moduleFromPath(file),
+                raw: line.trim(),
+            });
+        }
+        else {
+            const nm = AT_NOLOC_RE.exec(line);
+            const file = nm?.[1] ?? line.trim();
+            frames.push({
+                function: '<anonymous>',
+                filename: file,
+                absPath: file,
+                inApp: isInApp(file),
+                module: moduleFromPath(file),
+                raw: line.trim(),
+            });
+        }
+    }
+    if (!withSourceContext)
+        return frames;
+    let enriched = 0;
+    for (const frame of frames) {
+        if (enriched >= MAX_CONTEXT_FRAMES)
+            break;
+        if (frame.lineno == null || !frame.absPath)
+            continue;
+        if (!looksLikeFilePath(frame.absPath))
+            continue;
+        const ctx = readSourceContext(frame.absPath, frame.lineno);
+        if (!ctx)
+            continue;
+        frame.preContext = ctx.preContext;
+        frame.contextLine = ctx.contextLine;
+        frame.postContext = ctx.postContext;
+        enriched += 1;
+    }
+    return frames;
+}
+function isInApp(file) {
+    if (!file)
+        return false;
+    if (file.startsWith('node:') || file.startsWith('internal/'))
+        return false;
+    if (file.includes(`${path.sep}node_modules${path.sep}`) || file.includes('/node_modules/')) {
+        return false;
+    }
+    return file.includes('/') || file.includes('\\');
+}
+function moduleFromPath(file) {
+    if (!file)
+        return undefined;
+    if (file.startsWith('node:'))
+        return file;
+    const parts = file.split(/[\\/]/);
+    const nm = parts.lastIndexOf('node_modules');
+    if (nm >= 0 && parts[nm + 1]) {
+        // @scope/pkg or pkg
+        if (parts[nm + 1].startsWith('@') && parts[nm + 2]) {
+            return `${parts[nm + 1]}/${parts[nm + 2]}`;
+        }
+        return parts[nm + 1];
+    }
+    return parts[parts.length - 1];
+}
+function looksLikeFilePath(file) {
+    if (file.startsWith('node:') || file.startsWith('internal/'))
+        return false;
+    // Native addons / eval frames
+    if (file.includes('native') && !file.includes(path.sep) && !file.includes('/'))
+        return false;
+    return true;
+}
+function readSourceContext(filePath, lineno) {
+    try {
+        let lines = fileCache.get(filePath);
+        if (lines === undefined) {
+            if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+                fileCache.set(filePath, null);
+                return null;
+            }
+            // Cap file size — skip huge generated bundles.
+            const stat = fs.statSync(filePath);
+            if (stat.size > 2 * 1024 * 1024) {
+                fileCache.set(filePath, null);
+                return null;
+            }
+            const raw = fs.readFileSync(filePath, 'utf8');
+            lines = raw.split(/\r?\n/);
+            fileCache.set(filePath, lines);
+        }
+        if (!lines || lines.length === 0)
+            return null;
+        const idx = lineno - 1;
+        if (idx < 0 || idx >= lines.length)
+            return null;
+        const start = Math.max(0, idx - CONTEXT_LINES);
+        const end = Math.min(lines.length - 1, idx + CONTEXT_LINES);
+        return {
+            preContext: lines.slice(start, idx),
+            contextLine: lines[idx] ?? '',
+            postContext: lines.slice(idx + 1, end + 1),
+        };
+    }
+    catch {
+        fileCache.set(filePath, null);
+        return null;
+    }
+}
+/** Clear the source-file cache (useful in tests). */
+function clearStackSourceCache() {
+    fileCache.clear();
+}
+//# sourceMappingURL=stacktrace.js.map

package/dist/internal/stacktrace.js.map

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

package/dist/signals/checkins.d.ts

@@ -0,0 +1,28 @@
+/** Cron / heartbeat check-ins for monitor slugs. Fire-and-forget via fetch. */
+export type CheckinStatus = 'ok' | 'error' | 'in_progress';
+export interface CheckinsOptions {
+    /** Base endpoint, e.g. https://logs.example.com */
+    endpoint?: string;
+    apiKey: string;
+    appId: string;
+    requestTimeoutMs?: number;
+    onError?: (error: Error) => void;
+}
+/**
+ * Derive the monitor check-in URL from a logs ingest URL or host base.
+ * typical: http://host/api/v1/logs → http://host/api/v1/monitors/checkins
+ *          http://host → http://host/api/v1/monitors/checkins
+ */
+export declare function resolveCheckinUrl(endpointOrLogsUrl?: string): string | undefined;
+export declare class Checkins {
+    private readonly options;
+    private readonly url?;
+    private readonly timeoutMs;
+    constructor(options: CheckinsOptions);
+    /** Record a cron monitor check-in. `slug` must match the monitor config. */
+    capture(slug: string, status?: CheckinStatus, message?: string): void;
+    ok(slug: string, message?: string): void;
+    error(slug: string, message?: string): void;
+    private emit;
+}
+//# sourceMappingURL=checkins.d.ts.map

package/dist/signals/checkins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkins.d.ts","sourceRoot":"","sources":["../../src/signals/checkins.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUhF;AAED,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,eAAe;IAKrD,4EAA4E;IAC5E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,aAAoB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3E,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;YAI7B,IAAI;CAqCnB"}

package/dist/signals/checkins.js

@@ -0,0 +1,76 @@
+"use strict";
+/** Cron / heartbeat check-ins for monitor slugs. Fire-and-forget via fetch. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Checkins = void 0;
+exports.resolveCheckinUrl = resolveCheckinUrl;
+/**
+ * Derive the monitor check-in URL from a logs ingest URL or host base.
+ * typical: http://host/api/v1/logs → http://host/api/v1/monitors/checkins
+ *          http://host → http://host/api/v1/monitors/checkins
+ */
+function resolveCheckinUrl(endpointOrLogsUrl) {
+    if (!endpointOrLogsUrl)
+        return undefined;
+    const cleaned = endpointOrLogsUrl.replace(/\/$/, '');
+    if (/\/logs\/?$/i.test(cleaned)) {
+        return cleaned.replace(/\/logs\/?$/i, '/monitors/checkins');
+    }
+    if (/\/api\/v1$/i.test(cleaned)) {
+        return `${cleaned}/monitors/checkins`;
+    }
+    return `${cleaned}/api/v1/monitors/checkins`;
+}
+class Checkins {
+    constructor(options) {
+        this.options = options;
+        this.url = resolveCheckinUrl(options.endpoint);
+        this.timeoutMs = options.requestTimeoutMs ?? 5000;
+    }
+    /** Record a cron monitor check-in. `slug` must match the monitor config. */
+    capture(slug, status = 'ok', message) {
+        void this.emit(slug, status, message);
+    }
+    ok(slug, message) {
+        void this.emit(slug, 'ok', message);
+    }
+    error(slug, message) {
+        void this.emit(slug, 'error', message);
+    }
+    async emit(slug, status, message) {
+        try {
+            if (!this.url || !slug || typeof slug !== 'string')
+                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({
+                        appId: this.options.appId,
+                        slug,
+                        status,
+                        message,
+                    }),
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        catch (err) {
+            try {
+                this.options.onError?.(err instanceof Error ? err : new Error(String(err)));
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+exports.Checkins = Checkins;
+//# sourceMappingURL=checkins.js.map

package/dist/signals/checkins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkins.js","sourceRoot":"","sources":["../../src/signals/checkins.ts"],"names":[],"mappings":";AAAA,+EAA+E;;;AAkB/E,8CAUC;AAfD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,iBAA0B;IAC1D,IAAI,CAAC,iBAAiB;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,OAAO,oBAAoB,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,OAAO,2BAA2B,CAAC;AAC/C,CAAC;AAED,MAAa,QAAQ;IAInB,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QACnD,IAAI,CAAC,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACpD,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,IAAY,EAAE,SAAwB,IAAI,EAAE,OAAgB;QAClE,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,EAAE,CAAC,IAAY,EAAE,OAAgB;QAC/B,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAgB;QAClC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,MAAqB,EACrB,OAAgB;QAEhB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC3D,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;wBACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;wBACzB,IAAI;wBACJ,MAAM;wBACN,OAAO;qBACR,CAAC;oBACF,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;AA3DD,4BA2DC"}

package/dist/signals/logger.d.ts

@@ -0,0 +1,26 @@
+import { Attributes, Severity, TelemetryEvent } from '../types';
+import { BreadcrumbBuffer } from '../internal/breadcrumbs';
+export type EventSink = (event: TelemetryEvent) => void;
+/**
+ * Structured logger. Every record is automatically correlated with the active
+ * trace/span (via AsyncLocalStorage) so logs join up with request spans. Each
+ * record is also recorded as a breadcrumb (when a buffer is provided) so it can
+ * travel with any subsequent error.
+ */
+export declare class Logger {
+    private readonly sink;
+    private readonly boundAttributes;
+    private readonly breadcrumbs?;
+    constructor(sink: EventSink, boundAttributes?: Attributes, breadcrumbs?: BreadcrumbBuffer | undefined);
+    /** Create a child logger with additional default attributes merged in. */
+    child(attributes: Attributes): Logger;
+    debug(message: string, attributes?: Attributes): void;
+    info(message: string, attributes?: Attributes): void;
+    warn(message: string, attributes?: Attributes): void;
+    error(message: string, attributes?: Attributes): void;
+    fatal(message: string, attributes?: Attributes): void;
+    log(level: Severity, message: string, attributes?: Attributes): void;
+    private write;
+    private mergeAttributes;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/signals/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/signals/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAY,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAFZ,IAAI,EAAE,SAAS,EACf,eAAe,GAAE,UAAe,EAChC,WAAW,CAAC,EAAE,gBAAgB,YAAA;IAGjD,0EAA0E;IAC1E,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAIrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAGrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAGpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAGpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAGrD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAIrD,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAIpE,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,eAAe;CAMxB"}