@errio/core 1.0.0

package/dist/classify.d.ts

@@ -0,0 +1,11 @@
+import type { ErrorType, Severity } from './types.js';
+/**
+ * Classify an error by type based on its name and message.
+ * Uses a priority-ordered rule set: test > build > type > dependency > runtime.
+ */
+export declare function classifyError(error: Error): ErrorType;
+/**
+ * Determine default severity based on how the error was captured.
+ */
+export declare function defaultSeverity(captureSource: 'uncaughtException' | 'unhandledRejection' | 'manual'): Severity;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CA0BrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,QAAQ,GACnE,QAAQ,CASV"}

package/dist/classify.js

@@ -0,0 +1,102 @@
+/**
+ * Classify an error by type based on its name and message.
+ * Uses a priority-ordered rule set: test > build > type > dependency > runtime.
+ */
+export function classifyError(error) {
+    // Fast path: check error.name
+    const name = error.name?.toLowerCase() ?? '';
+    if (name === 'typeerror')
+        return 'type_error';
+    if (name === 'referenceerror' || name === 'rangeerror' || name === 'syntaxerror') {
+        return 'runtime_error';
+    }
+    const message = `${error.name ?? ''}: ${error.message ?? ''}`.toLowerCase();
+    // Test failures (highest priority)
+    if (TEST_PATTERNS.some((p) => p.test(message)))
+        return 'test_failure';
+    // Build failures
+    if (BUILD_PATTERNS.some((p) => p.test(message)))
+        return 'build_failure';
+    // Type errors
+    if (TYPE_PATTERNS.some((p) => p.test(message)))
+        return 'type_error';
+    // Dependency issues
+    if (DEP_PATTERNS.some((p) => p.test(message)))
+        return 'dependency_issue';
+    // Runtime errors
+    if (RUNTIME_PATTERNS.some((p) => p.test(message)))
+        return 'runtime_error';
+    return 'unknown';
+}
+/**
+ * Determine default severity based on how the error was captured.
+ */
+export function defaultSeverity(captureSource) {
+    switch (captureSource) {
+        case 'uncaughtException':
+            return 'critical';
+        case 'unhandledRejection':
+            return 'high';
+        case 'manual':
+            return 'medium';
+    }
+}
+// ---------------------------------------------------------------------------
+// Pattern sets
+// ---------------------------------------------------------------------------
+const TEST_PATTERNS = [
+    /\bexpect\b.*\b(to\s+equal|to\s+be|received|to\s+match)\b/,
+    /\bassert(ion|ed|\.)\b/,
+    /\btest\s+(failed|failure)\b/,
+    /\bfailing\s+tests?\b/,
+    /\b\d+\s+failing\b/,
+    /\bFAIL\b.*\.test\./,
+    /\bdescribe\b.*\bit\b/,
+    /\b(?:jest|vitest|mocha|cypress|playwright|pytest|rspec|junit|testng)\b/,
+    /\bava\b/,
+];
+const BUILD_PATTERNS = [
+    /\bwebpack|esbuild|vite|rollup|parcel|turbopack\b/,
+    /\berror\s+ts\d{4}\b/,
+    /\btsc\b.*\berror\b/,
+    /\bcompilation\s+failed\b/,
+    /\bbuild\s+(failed|error)\b/,
+    /\bsyntax\s+error\b/,
+    /\bexit\s+code\s+[1-9]\b/,
+    /\bdocker\s+build\b/,
+    /\bmake\s*:.*error\b/,
+    /\bgcc|g\+\+|clang|javac|rustc|cargo\s+build|go\s+build\b/,
+];
+const TYPE_PATTERNS = [
+    /\bnot\s+assignable\s+to\b/,
+    /\bcannot\s+read\s+propert(y|ies)\s+of\s+(null|undefined)\b/,
+    /\bis\s+not\s+a\s+function\b/,
+    /\bis\s+not\s+a\s+constructor\b/,
+    /\binvalid\s+type\b/,
+    /\bhas\s+no\s+(method|property)\b/,
+    /\btype\s+'[\w]+'\s+is\s+not\b/,
+];
+const DEP_PATTERNS = [
+    /\bmodule\s+not\s+found\b/,
+    /\bcannot\s+(find|resolve)\s+(module|dependency|package)\b/,
+    /\bno\s+such\s+module\b/,
+    /\bpeer\s+dep(endenc(y|ies))?\b/,
+    /\bnpm\s+err|yarn\s+err|pnpm\s+err\b/,
+    /\bmodulenotfounderror\b/,
+    /\bclassnotfoundexception\b/,
+    /\bloaderror\b/,
+    /\bnomodulenamed\b/,
+];
+const RUNTIME_PATTERNS = [
+    /\buncaught\s+(exception|error)\b/,
+    /\bunhandled\s+(rejection|exception|promise)\b/,
+    /\bsegmentation\s+fault\b/,
+    /\bstack\s+overflow\b/,
+    /\bout\s+of\s+memory\b/,
+    /\bsigkill|sigterm|sigsegv|sigabrt\b/,
+    /\beconnrefused|econnreset|etimedout|enotfound|epipe\b/,
+    /\bpanic\b/,
+    /\bfatal\s+error\b/,
+    /\bnullpointerexception|arrayindexoutofboundsexception|stackoverflowerror\b/,
+];
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+import type { ErrioConfig, ResolvedConfig, ErrioPlugin, ErrioClientInterface, CaptureOptions, Breadcrumb, RequestContext } from './types.js';
+/**
+ * Core Errio client. Manages configuration, plugins, transport, and
+ * error capture lifecycle. This is the central orchestrator of the SDK.
+ */
+export declare class ErrioClient implements ErrioClientInterface {
+    private config;
+    private transport;
+    private dedup;
+    private plugins;
+    private gitInfo;
+    private initialized;
+    constructor(userConfig: ErrioConfig);
+    /**
+     * Register and initialize a plugin.
+     */
+    use(plugin: ErrioPlugin): Promise<void>;
+    /**
+     * Capture and send an error event.
+     */
+    captureError(error: Error, options?: CaptureOptions): void;
+    /**
+     * Capture an error from a global handler (uncaughtException/unhandledRejection).
+     * Used internally by the hooks module.
+     */
+    captureFromHandler(error: Error, source: 'uncaughtException' | 'unhandledRejection'): void;
+    /**
+     * Flush all pending events and shut down the client.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force-flush any buffered events. Useful before process exit.
+     */
+    flush(): Promise<void>;
+    getConfig(): Readonly<ResolvedConfig>;
+    addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void;
+    setContext(ctx: Partial<RequestContext>): void;
+    getContext(): RequestContext | undefined;
+    runWithContext<T>(ctx: RequestContext, fn: () => T): T;
+    private buildEvent;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,oBAAoB,EAEpB,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAqBpB;;;GAGG;AACH,qBAAa,WAAY,YAAW,oBAAoB;IACtD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,WAAW;IA2BnC;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAY1D;;;OAGG;IACH,kBAAkB,CAChB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,GACjD,IAAI;IAaP;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC;IAIrC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;IAI9D,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAI9C,UAAU,IAAI,cAAc,GAAG,SAAS;IAIxC,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAQtD,OAAO,CAAC,UAAU;CAsGnB"}

package/dist/client.js

@@ -0,0 +1,223 @@
+import { BatchTransport } from './transport.js';
+import { DedupCache, generateFingerprint, normalizeMessage } from './fingerprint.js';
+import { classifyError, defaultSeverity } from './classify.js';
+import { serializeCauseChain, extractFilePaths } from './serializer.js';
+import { redactString } from './redact.js';
+import { shouldSample } from './sampling.js';
+import { detectGitInfo } from './git.js';
+import { getContext, setContext, runWithContext, addBreadcrumb as addBreadcrumbToStore, getBreadcrumbs, } from './context.js';
+const DEFAULT_ENDPOINT = 'https://errio.mosaicwellness.in';
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_FLUSH_INTERVAL_MS = 5000;
+const DEFAULT_SAMPLE_RATE = 1.0;
+/**
+ * Core Errio client. Manages configuration, plugins, transport, and
+ * error capture lifecycle. This is the central orchestrator of the SDK.
+ */
+export class ErrioClient {
+    config;
+    transport;
+    dedup;
+    plugins = [];
+    gitInfo = detectGitInfo();
+    initialized = false;
+    constructor(userConfig) {
+        if (!userConfig.apiKey || !userConfig.apiKey.startsWith('ak_')) {
+            throw new Error('[errio] Invalid API key. Must start with "ak_".');
+        }
+        this.config = {
+            apiKey: userConfig.apiKey,
+            endpoint: userConfig.endpoint ?? DEFAULT_ENDPOINT,
+            environment: userConfig.environment ?? process.env.NODE_ENV ?? 'production',
+            serviceName: userConfig.serviceName ?? '',
+            sampleRate: clamp(userConfig.sampleRate ?? DEFAULT_SAMPLE_RATE, 0, 1),
+            batchSize: userConfig.batchSize ?? DEFAULT_BATCH_SIZE,
+            flushIntervalMs: userConfig.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,
+            beforeSend: userConfig.beforeSend ?? null,
+            debug: userConfig.debug ?? false,
+        };
+        this.transport = new BatchTransport(this.config);
+        this.dedup = new DedupCache();
+        if (userConfig.plugins) {
+            for (const plugin of userConfig.plugins) {
+                this.use(plugin);
+            }
+        }
+    }
+    /**
+     * Register and initialize a plugin.
+     */
+    async use(plugin) {
+        if (this.plugins.some((p) => p.name === plugin.name)) {
+            if (this.config.debug) {
+                console.warn(`[errio] Plugin "${plugin.name}" already registered, skipping.`);
+            }
+            return;
+        }
+        this.plugins.push(plugin);
+        await plugin.setup(this);
+        if (this.config.debug) {
+            console.log(`[errio] Plugin "${plugin.name}" initialized.`);
+        }
+    }
+    /**
+     * Capture and send an error event.
+     */
+    captureError(error, options) {
+        try {
+            const event = this.buildEvent(error, options, 'manual');
+            if (!event)
+                return;
+            this.transport.enqueue(event);
+        }
+        catch (err) {
+            if (this.config.debug) {
+                console.error('[errio] Failed to capture error:', err);
+            }
+        }
+    }
+    /**
+     * Capture an error from a global handler (uncaughtException/unhandledRejection).
+     * Used internally by the hooks module.
+     */
+    captureFromHandler(error, source) {
+        try {
+            const severity = defaultSeverity(source);
+            const event = this.buildEvent(error, { severity }, source);
+            if (!event)
+                return;
+            this.transport.enqueue(event);
+        }
+        catch (err) {
+            if (this.config.debug) {
+                console.error('[errio] Failed to capture handler error:', err);
+            }
+        }
+    }
+    /**
+     * Flush all pending events and shut down the client.
+     */
+    async shutdown() {
+        for (const plugin of this.plugins) {
+            try {
+                await plugin.teardown?.();
+            }
+            catch (err) {
+                if (this.config.debug) {
+                    console.error(`[errio] Plugin "${plugin.name}" teardown failed:`, err);
+                }
+            }
+        }
+        await this.transport.shutdown();
+    }
+    /**
+     * Force-flush any buffered events. Useful before process exit.
+     */
+    async flush() {
+        await this.transport.flush();
+    }
+    // -- ErrioClientInterface --
+    getConfig() {
+        return this.config;
+    }
+    addBreadcrumb(breadcrumb) {
+        addBreadcrumbToStore(breadcrumb);
+    }
+    setContext(ctx) {
+        setContext(ctx);
+    }
+    getContext() {
+        return getContext();
+    }
+    runWithContext(ctx, fn) {
+        return runWithContext(ctx, fn);
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    buildEvent(error, options, source) {
+        const errorType = classifyError(error);
+        const message = error.message || String(error);
+        const normalized = normalizeMessage(message);
+        // Fingerprinting
+        const fp = options?.fingerprint ??
+            generateFingerprint(this.gitInfo.repoFullName ?? 'unknown', errorType, normalized);
+        // Sampling
+        if (!shouldSample(fp, this.config.sampleRate)) {
+            return null;
+        }
+        // Dedup
+        if (this.dedup.has(fp)) {
+            if (this.config.debug) {
+                console.log(`[errio] Deduplicated event: ${fp.slice(0, 12)}...`);
+            }
+            return null;
+        }
+        this.dedup.add(fp);
+        // Severity
+        const severity = options?.severity ?? defaultSeverity(source);
+        // Redact sensitive content
+        const safeMessage = redactString(message).slice(0, 2000);
+        const safeStack = error.stack ? redactString(error.stack).slice(0, 10000) : null;
+        // Context from AsyncLocalStorage
+        const ctx = getContext();
+        const breadcrumbs = getBreadcrumbs();
+        // Build the event
+        let event = {
+            source: 'api',
+            error_type: errorType,
+            error_message: safeMessage,
+            stack_trace: safeStack,
+            repo_full_name: this.gitInfo.repoFullName ?? 'unknown/unknown',
+            commit_sha: this.gitInfo.commitSha,
+            branch: this.gitInfo.branch,
+            file_paths: error.stack ? extractFilePaths(error.stack) : [],
+            severity,
+            raw_payload: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            },
+            metadata: {
+                triggered_by: source,
+                environment: this.config.environment,
+                service_name: this.config.serviceName,
+                ...(options?.tags && { tags: options.tags }),
+                ...(options?.extra && { extra: options.extra }),
+            },
+            fingerprint: fp,
+            timestamp: Date.now(),
+        };
+        // Attach cause chain if present
+        if (error.cause) {
+            event.cause_chain = serializeCauseChain(error);
+        }
+        // Attach breadcrumbs
+        if (breadcrumbs.length > 0) {
+            event.breadcrumbs = breadcrumbs;
+        }
+        // Attach request context
+        if (ctx) {
+            event.context = ctx;
+            if (ctx.requestId) {
+                event.correlation_id = ctx.requestId;
+            }
+        }
+        // beforeSend hook — allows users to modify or drop events
+        if (this.config.beforeSend) {
+            const modified = this.config.beforeSend(event);
+            if (modified === null) {
+                if (this.config.debug) {
+                    console.log('[errio] Event dropped by beforeSend hook.');
+                }
+                return null;
+            }
+            event = modified;
+        }
+        return event;
+    }
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,29 @@
+import type { RequestContext, Breadcrumb } from './types.js';
+/**
+ * Run a function within a new async context scope.
+ * Context is automatically propagated through all async operations within fn.
+ */
+export declare function runWithContext<T>(ctx: RequestContext, fn: () => T): T;
+/**
+ * Get the current request context, or undefined if none is set.
+ */
+export declare function getContext(): RequestContext | undefined;
+/**
+ * Merge additional fields into the current request context.
+ * No-op if called outside a context scope.
+ */
+export declare function setContext(ctx: Partial<RequestContext>): void;
+/**
+ * Add a breadcrumb to the current context's ring buffer.
+ * Oldest entries are evicted when the buffer is full.
+ */
+export declare function addBreadcrumb(crumb: Omit<Breadcrumb, 'timestamp'>): void;
+/**
+ * Get a snapshot of the current breadcrumbs (oldest first).
+ */
+export declare function getBreadcrumbs(): Breadcrumb[];
+/**
+ * Clear all breadcrumbs in the current context.
+ */
+export declare function clearBreadcrumbs(): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgB7D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAKrE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,GAAG,SAAS,CAEvD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAexE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/context.js

@@ -0,0 +1,60 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+const MAX_BREADCRUMBS = 30;
+/**
+ * Run a function within a new async context scope.
+ * Context is automatically propagated through all async operations within fn.
+ */
+export function runWithContext(ctx, fn) {
+    return storage.run({ requestContext: { ...ctx }, breadcrumbs: [] }, fn);
+}
+/**
+ * Get the current request context, or undefined if none is set.
+ */
+export function getContext() {
+    return storage.getStore()?.requestContext;
+}
+/**
+ * Merge additional fields into the current request context.
+ * No-op if called outside a context scope.
+ */
+export function setContext(ctx) {
+    const store = storage.getStore();
+    if (store) {
+        Object.assign(store.requestContext, ctx);
+    }
+}
+/**
+ * Add a breadcrumb to the current context's ring buffer.
+ * Oldest entries are evicted when the buffer is full.
+ */
+export function addBreadcrumb(crumb) {
+    const store = storage.getStore();
+    if (!store)
+        return;
+    const entry = {
+        ...crumb,
+        timestamp: Date.now(),
+    };
+    store.breadcrumbs.push(entry);
+    // Ring buffer: evict oldest when over limit
+    if (store.breadcrumbs.length > MAX_BREADCRUMBS) {
+        store.breadcrumbs.splice(0, store.breadcrumbs.length - MAX_BREADCRUMBS);
+    }
+}
+/**
+ * Get a snapshot of the current breadcrumbs (oldest first).
+ */
+export function getBreadcrumbs() {
+    return storage.getStore()?.breadcrumbs.slice() ?? [];
+}
+/**
+ * Clear all breadcrumbs in the current context.
+ */
+export function clearBreadcrumbs() {
+    const store = storage.getStore();
+    if (store) {
+        store.breadcrumbs.length = 0;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAarD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAgB,CAAC;AAEtD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,GAAmB,EAAE,EAAW;IAChE,OAAO,OAAO,CAAC,GAAG,CAChB,EAAE,cAAc,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAC/C,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAA4B;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,MAAM,KAAK,GAAe;QACxB,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9B,4CAA4C;IAC5C,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAC/C,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/deploy.d.ts

@@ -0,0 +1,29 @@
+import type { ResolvedConfig } from './types.js';
+export interface DeployInfo {
+    /** Deployment version (e.g., "v1.2.3", "abc123") */
+    version?: string;
+    /** Git commit SHA for this deploy */
+    commitSha?: string;
+    /** Branch name */
+    branch?: string;
+    /** Environment name (e.g., "production", "staging") */
+    environment: string;
+    /** Who triggered the deploy */
+    deployedBy?: string;
+    /** When the deploy happened (ISO string or Date). Defaults to now. */
+    deployedAt?: string | Date;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Report a deployment event to the Errio API.
+ * This enables deploy correlation — linking errors to the deploy that introduced them.
+ *
+ * Usage:
+ *   import { reportDeploy } from '@errio/core';
+ *   await reportDeploy(config, { environment: 'production', version: 'v1.2.3' });
+ */
+export declare function reportDeploy(config: ResolvedConfig, deploy: DeployInfo): Promise<{
+    deploy_id: string;
+} | null>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA0CvC"}

package/dist/deploy.js

@@ -0,0 +1,50 @@
+import { detectGitInfo } from './git.js';
+/**
+ * Report a deployment event to the Errio API.
+ * This enables deploy correlation — linking errors to the deploy that introduced them.
+ *
+ * Usage:
+ *   import { reportDeploy } from '@errio/core';
+ *   await reportDeploy(config, { environment: 'production', version: 'v1.2.3' });
+ */
+export async function reportDeploy(config, deploy) {
+    const git = detectGitInfo();
+    const payload = {
+        repo_full_name: git.repoFullName ?? 'unknown/unknown',
+        environment: deploy.environment,
+        version: deploy.version,
+        commit_sha: deploy.commitSha ?? git.commitSha,
+        branch: deploy.branch ?? git.branch,
+        deployed_by: deploy.deployedBy,
+        deployed_at: deploy.deployedAt
+            ? typeof deploy.deployedAt === 'string'
+                ? deploy.deployedAt
+                : deploy.deployedAt.toISOString()
+            : new Date().toISOString(),
+        metadata: deploy.metadata,
+    };
+    try {
+        const response = await fetch(`${config.endpoint}/api/v1/deploys`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            if (config.debug) {
+                console.error(`[errio] Failed to report deploy: HTTP ${response.status}`);
+            }
+            return null;
+        }
+        return (await response.json());
+    }
+    catch (err) {
+        if (config.debug) {
+            console.error('[errio] Failed to report deploy:', err);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAmBzC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAAkB;IAElB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAG;QACd,cAAc,EAAE,GAAG,CAAC,YAAY,IAAI,iBAAiB;QACrD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;QAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM;QACnC,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,WAAW,EAAE,MAAM,CAAC,UAAU;YAC5B,CAAC,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBACrC,CAAC,CAAC,MAAM,CAAC,UAAU;gBACnB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE;YACnC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,iBAAiB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,yCAAyC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/fingerprint.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Normalize an error message by stripping variable content.
+ * This improves dedup accuracy by removing noise like timestamps,
+ * line numbers, memory addresses, UUIDs, and temp paths.
+ */
+export declare function normalizeMessage(message: string): string;
+/**
+ * Generate a stable fingerprint for dedup and issue grouping.
+ *
+ * @param components - Strings to include in the fingerprint (e.g., errorType, normalizedMessage)
+ * @returns SHA-256 hex hash
+ */
+export declare function generateFingerprint(...components: string[]): string;
+/**
+ * In-memory dedup cache with TTL-based expiry.
+ * Prevents the same error from being sent multiple times within a short window.
+ */
+export declare class DedupCache {
+    private cache;
+    private ttlMs;
+    constructor(ttlMs?: number);
+    /** Returns true if the fingerprint was recently seen (within TTL). */
+    has(fingerprint: string): boolean;
+    /** Record a fingerprint with the current timestamp. */
+    add(fingerprint: string): void;
+    /** Remove expired entries. */
+    cleanup(): void;
+    get size(): number;
+}
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,SAAgB;IAIjC,sEAAsE;IACtE,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAYjC,uDAAuD;IACvD,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK9B,8BAA8B;IAC9B,OAAO,IAAI,IAAI;IASf,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}