@errio/core 1.0.0

package/dist/fingerprint.js

@@ -0,0 +1,74 @@
+import { createHash } from 'node:crypto';
+/**
+ * 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 function normalizeMessage(message) {
+    return (message
+        // ISO timestamps
+        .replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})/g, '<TIMESTAMP>')
+        // Line:column numbers
+        .replace(/:\d+:\d+/g, ':<LINE>:<COL>')
+        // Line number patterns
+        .replace(/\bline\s+\d+/gi, 'line <N>')
+        // Hex addresses
+        .replace(/0x[0-9a-fA-F]{6,}/g, '<ADDR>')
+        // UUIDs
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, '<UUID>')
+        // Temp paths
+        .replace(/\/tmp\/[\w./-]+/g, '<TMPPATH>')
+        // Excessive whitespace
+        .replace(/\s+/g, ' ')
+        .trim());
+}
+/**
+ * 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 function generateFingerprint(...components) {
+    const input = components.join(':');
+    return createHash('sha256').update(input).digest('hex');
+}
+/**
+ * In-memory dedup cache with TTL-based expiry.
+ * Prevents the same error from being sent multiple times within a short window.
+ */
+export class DedupCache {
+    cache = new Map();
+    ttlMs;
+    constructor(ttlMs = 5 * 60 * 1000) {
+        this.ttlMs = ttlMs;
+    }
+    /** Returns true if the fingerprint was recently seen (within TTL). */
+    has(fingerprint) {
+        const ts = this.cache.get(fingerprint);
+        if (ts === undefined)
+            return false;
+        if (Date.now() - ts > this.ttlMs) {
+            this.cache.delete(fingerprint);
+            return false;
+        }
+        return true;
+    }
+    /** Record a fingerprint with the current timestamp. */
+    add(fingerprint) {
+        this.cache.set(fingerprint, Date.now());
+        this.cleanup();
+    }
+    /** Remove expired entries. */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, ts] of this.cache) {
+            if (now - ts > this.ttlMs) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,CACL,OAAO;QACL,iBAAiB;SAChB,OAAO,CAAC,sEAAsE,EAAE,aAAa,CAAC;QAC/F,sBAAsB;SACrB,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC;QACtC,uBAAuB;SACtB,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC;QACtC,gBAAgB;SACf,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC;QACxC,QAAQ;SACP,OAAO,CAAC,gEAAgE,EAAE,QAAQ,CAAC;QACpF,aAAa;SACZ,OAAO,CAAC,kBAAkB,EAAE,WAAW,CAAC;QACzC,uBAAuB;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAG,UAAoB;IACzD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,KAAK,CAAS;IAEtB,YAAY,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,sEAAsE;IACtE,GAAG,CAAC,WAAmB;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAEnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,WAAmB;QACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,8BAA8B;IAC9B,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/git.d.ts

@@ -0,0 +1,12 @@
+import type { GitInfo } from './types.js';
+/**
+ * Parse a Git remote URL into an "owner/repo" string.
+ * Supports SSH and HTTPS URLs with or without .git suffix.
+ */
+export declare function parseRepoFullName(remoteUrl: string): string | null;
+/**
+ * Detect Git repository information from the current working directory.
+ * Returns null fields if git is not available or the directory is not a repo.
+ */
+export declare function detectGitInfo(): GitInfo;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAuCvC"}

package/dist/git.js

@@ -0,0 +1,60 @@
+import { execSync } from 'node:child_process';
+/**
+ * Parse a Git remote URL into an "owner/repo" string.
+ * Supports SSH and HTTPS URLs with or without .git suffix.
+ */
+export function parseRepoFullName(remoteUrl) {
+    // SSH: git@github.com:owner/repo.git
+    const sshMatch = remoteUrl.match(/git@[\w.-]+:([\w.-]+\/[\w.-]+?)(?:\.git)?$/);
+    if (sshMatch)
+        return sshMatch[1];
+    // HTTPS: https://github.com/owner/repo.git
+    const httpsMatch = remoteUrl.match(/https?:\/\/[\w.-]+\/([\w.-]+\/[\w.-]+?)(?:\.git)?$/);
+    if (httpsMatch)
+        return httpsMatch[1];
+    return null;
+}
+/**
+ * Detect Git repository information from the current working directory.
+ * Returns null fields if git is not available or the directory is not a repo.
+ */
+export function detectGitInfo() {
+    const result = {
+        repoFullName: null,
+        commitSha: null,
+        branch: null,
+    };
+    try {
+        const remoteUrl = execSync('git config --get remote.origin.url', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        }).trim();
+        result.repoFullName = parseRepoFullName(remoteUrl);
+    }
+    catch {
+        // Not a git repo or git not available
+    }
+    try {
+        result.commitSha = execSync('git rev-parse HEAD', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        }).trim();
+    }
+    catch {
+        // Ignore
+    }
+    try {
+        result.branch = execSync('git rev-parse --abbrev-ref HEAD', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 3000,
+        }).trim();
+    }
+    catch {
+        // Ignore
+    }
+    return result;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,qCAAqC;IACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjC,2CAA2C;IAC3C,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACzF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAErC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAY;QACtB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI;KACb,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,oCAAoC,EAAE;YAC/D,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,YAAY,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,oBAAoB,EAAE;YAChD,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;YAC1D,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ErrioClient } from './client.js';
+export type { ErrioConfig, ResolvedConfig, ErrioPlugin, ErrioClientInterface, ErrorEvent, ErrorType, Severity, CaptureOptions, CauseEntry, Breadcrumb, RequestContext, ApiResponse, GitInfo, } from './types.js';
+export { getContext, setContext, runWithContext, addBreadcrumb, getBreadcrumbs, clearBreadcrumbs, } from './context.js';
+export { classifyError, defaultSeverity } from './classify.js';
+export { generateFingerprint, normalizeMessage, DedupCache } from './fingerprint.js';
+export { serializeCauseChain, extractFilePaths } from './serializer.js';
+export { redactString, redactObject } from './redact.js';
+export { shouldSample } from './sampling.js';
+export { detectGitInfo, parseRepoFullName } from './git.js';
+export { BatchTransport } from './transport.js';
+export { reportDeploy, type DeployInfo } from './deploy.js';
+//# 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,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,OAAO,GACR,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// Client
+export { ErrioClient } from './client.js';
+// Context propagation
+export { getContext, setContext, runWithContext, addBreadcrumb, getBreadcrumbs, clearBreadcrumbs, } from './context.js';
+// Classification
+export { classifyError, defaultSeverity } from './classify.js';
+// Fingerprinting and dedup
+export { generateFingerprint, normalizeMessage, DedupCache } from './fingerprint.js';
+// Serialization and file path extraction
+export { serializeCauseChain, extractFilePaths } from './serializer.js';
+// PII and secret redaction
+export { redactString, redactObject } from './redact.js';
+// Sampling
+export { shouldSample } from './sampling.js';
+// Git detection
+export { detectGitInfo, parseRepoFullName } from './git.js';
+// Transport
+export { BatchTransport } from './transport.js';
+// Deploy reporting
+export { reportDeploy } from './deploy.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmB1C,sBAAsB;AACtB,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,2BAA2B;AAC3B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAErF,yCAAyC;AACzC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExE,2BAA2B;AAC3B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC"}

package/dist/redact.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PII and secret redaction for error messages, stack traces, and metadata.
+ *
+ * This runs before events are sent to the API to prevent accidental
+ * exposure of sensitive data. It uses pattern matching — not parsing —
+ * so it is fast but not exhaustive. Callers should also use allowlists
+ * for payload fields in production.
+ */
+/**
+ * Redact secrets and PII from a string.
+ * Returns a new string with sensitive values replaced by [REDACTED].
+ */
+export declare function redactString(input: string): string;
+/**
+ * Redact secrets and PII from all string values in a plain object (shallow).
+ * Non-string values are left unchanged.
+ */
+export declare function redactObject(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsCH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAclF"}

package/dist/redact.js

@@ -0,0 +1,86 @@
+/**
+ * PII and secret redaction for error messages, stack traces, and metadata.
+ *
+ * This runs before events are sent to the API to prevent accidental
+ * exposure of sensitive data. It uses pattern matching — not parsing —
+ * so it is fast but not exhaustive. Callers should also use allowlists
+ * for payload fields in production.
+ */
+const REDACTION_PLACEHOLDER = '[REDACTED]';
+const SECRET_PATTERNS = [
+    // API keys (common formats)
+    { pattern: /\b(sk[-_]live[-_][\w]{20,})\b/g, label: 'stripe_key' },
+    { pattern: /\b(sk-ant-[\w-]{20,})\b/g, label: 'anthropic_key' },
+    { pattern: /\b(sk-[\w]{20,})\b/g, label: 'openai_key' },
+    { pattern: /\b(ak_[\w]{32,})\b/g, label: 'errio_key' },
+    { pattern: /\b(ghp_[\w]{36,})\b/g, label: 'github_pat' },
+    { pattern: /\b(ghs_[\w]{36,})\b/g, label: 'github_server_token' },
+    { pattern: /\b(AKIA[\w]{16})\b/g, label: 'aws_access_key' },
+    { pattern: /\b(xox[bposa]-[\w-]{10,})\b/g, label: 'slack_token' },
+    // Generic bearer/auth tokens in headers
+    { pattern: /(Bearer\s+)[\w.=-]{20,}/gi, label: 'bearer_token' },
+    { pattern: /(Authorization:\s*)[\w.=-]{20,}/gi, label: 'auth_header' },
+    // Passwords in URLs (e.g., mysql://user:password@host)
+    { pattern: /:\/\/([\w.-]+):([^@\s]{3,})@/g, label: 'url_password' },
+    // Generic password/secret assignments
+    { pattern: /(password|passwd|secret|token|api_key|apikey|access_key|private_key)\s*[=:]\s*['"]?([^\s'"]{8,})/gi, label: 'key_value_secret' },
+    // JWTs (3 base64 segments separated by dots)
+    { pattern: /\beyJ[\w-]+\.eyJ[\w-]+\.[\w-]+\b/g, label: 'jwt' },
+    // Email addresses
+    { pattern: /\b[\w.+-]+@[\w.-]+\.\w{2,}\b/g, label: 'email' },
+    // SSN-like patterns (US)
+    { pattern: /\b\d{3}-\d{2}-\d{4}\b/g, label: 'ssn' },
+    // Credit card numbers (basic Luhn-candidate patterns)
+    { pattern: /\b(?:\d{4}[-\s]?){3}\d{4}\b/g, label: 'credit_card' },
+];
+/**
+ * Redact secrets and PII from a string.
+ * Returns a new string with sensitive values replaced by [REDACTED].
+ */
+export function redactString(input) {
+    if (!input)
+        return input;
+    let result = input;
+    for (const { pattern, label } of SECRET_PATTERNS) {
+        // Reset regex state (global flag means lastIndex persists)
+        pattern.lastIndex = 0;
+        switch (label) {
+            case 'url_password':
+                // Preserve the URL structure but redact the password
+                result = result.replace(pattern, `://$1:${REDACTION_PLACEHOLDER}@`);
+                break;
+            case 'key_value_secret':
+                // Preserve the key name, redact the value
+                result = result.replace(pattern, `$1=${REDACTION_PLACEHOLDER}`);
+                break;
+            case 'bearer_token':
+            case 'auth_header':
+                // Preserve the prefix, redact the token
+                result = result.replace(pattern, `$1${REDACTION_PLACEHOLDER}`);
+                break;
+            default:
+                result = result.replace(pattern, REDACTION_PLACEHOLDER);
+        }
+    }
+    return result;
+}
+/**
+ * Redact secrets and PII from all string values in a plain object (shallow).
+ * Non-string values are left unchanged.
+ */
+export function redactObject(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'string') {
+            result[key] = redactString(value);
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            result[key] = redactObject(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

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

package/dist/sampling.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Deterministic sampling based on fingerprint hash.
+ *
+ * Given the same fingerprint and sample rate, this always returns the same
+ * decision. This ensures related events within the same dedup window are
+ * consistently included or excluded.
+ *
+ * @param fingerprint - Stable identifier for the event (e.g., error fingerprint)
+ * @param sampleRate  - Value between 0.0 (drop all) and 1.0 (keep all)
+ * @returns true if the event should be sampled (kept)
+ */
+export declare function shouldSample(fingerprint: string, sampleRate: number): boolean;
+//# sourceMappingURL=sampling.d.ts.map

package/dist/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAS7E"}

package/dist/sampling.js

@@ -0,0 +1,23 @@
+import { createHash } from 'node:crypto';
+/**
+ * Deterministic sampling based on fingerprint hash.
+ *
+ * Given the same fingerprint and sample rate, this always returns the same
+ * decision. This ensures related events within the same dedup window are
+ * consistently included or excluded.
+ *
+ * @param fingerprint - Stable identifier for the event (e.g., error fingerprint)
+ * @param sampleRate  - Value between 0.0 (drop all) and 1.0 (keep all)
+ * @returns true if the event should be sampled (kept)
+ */
+export function shouldSample(fingerprint, sampleRate) {
+    if (sampleRate >= 1.0)
+        return true;
+    if (sampleRate <= 0.0)
+        return false;
+    // Use first 4 bytes of SHA-256 as a deterministic random value
+    const hash = createHash('sha256').update(fingerprint).digest();
+    const value = hash.readUInt32BE(0) / 0xffffffff;
+    return value < sampleRate;
+}
+//# sourceMappingURL=sampling.js.map

package/dist/sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,UAAkB;IAClE,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IAEpC,+DAA+D;IAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IAEhD,OAAO,KAAK,GAAG,UAAU,CAAC;AAC5B,CAAC"}

package/dist/serializer.d.ts

@@ -0,0 +1,16 @@
+import type { CauseEntry } from './types.js';
+/**
+ * Walk the Error.cause chain and serialize each level into a flat array.
+ * Handles circular references and enforces a depth limit.
+ *
+ * @param error - The root error to serialize
+ * @returns Array of cause entries (root cause first, deepest last)
+ */
+export declare function serializeCauseChain(error: Error): CauseEntry[];
+/**
+ * Extract file paths from a stack trace string.
+ * Supports JavaScript/TypeScript, Python, Go, Java, Ruby formats.
+ * Excludes paths from node_modules, vendor, .yarn, and internal directories.
+ */
+export declare function extractFilePaths(stackTrace: string): string[];
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,CAyC9D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmC7D"}

package/dist/serializer.js

@@ -0,0 +1,92 @@
+const MAX_CAUSE_DEPTH = 5;
+const MAX_MESSAGE_LENGTH = 2000;
+const MAX_STACK_LENGTH = 10000;
+/**
+ * Walk the Error.cause chain and serialize each level into a flat array.
+ * Handles circular references and enforces a depth limit.
+ *
+ * @param error - The root error to serialize
+ * @returns Array of cause entries (root cause first, deepest last)
+ */
+export function serializeCauseChain(error) {
+    const chain = [];
+    const seen = new WeakSet();
+    let current = error.cause;
+    let depth = 0;
+    while (current && depth < MAX_CAUSE_DEPTH) {
+        if (typeof current === 'object' && current !== null) {
+            // Circular reference guard
+            if (seen.has(current))
+                break;
+            seen.add(current);
+        }
+        if (current instanceof Error) {
+            chain.push({
+                name: current.name || 'Error',
+                message: truncate(current.message, MAX_MESSAGE_LENGTH),
+                stack: current.stack ? truncate(current.stack, MAX_STACK_LENGTH) : undefined,
+            });
+            current = current.cause;
+        }
+        else if (typeof current === 'object' && current !== null) {
+            // Handle non-Error cause objects (some libraries throw plain objects)
+            const obj = current;
+            chain.push({
+                name: String(obj.name || 'Object'),
+                message: truncate(String(obj.message || JSON.stringify(current)), MAX_MESSAGE_LENGTH),
+            });
+            current = obj.cause;
+        }
+        else {
+            // Primitive cause value
+            chain.push({
+                name: 'Unknown',
+                message: truncate(String(current), MAX_MESSAGE_LENGTH),
+            });
+            break;
+        }
+        depth++;
+    }
+    return chain;
+}
+/**
+ * Extract file paths from a stack trace string.
+ * Supports JavaScript/TypeScript, Python, Go, Java, Ruby formats.
+ * Excludes paths from node_modules, vendor, .yarn, and internal directories.
+ */
+export function extractFilePaths(stackTrace) {
+    const paths = new Set();
+    const patterns = [
+        // JS/TS: at Object.func (file.ts:42:10) or at file.ts:42:10
+        /(?:at\s+(?:[\w.<>]+\s+)?\(?)((?:\/|\.\/|\.\.\/|[a-zA-Z]:\\)[\w./_\\-]+\.\w+)(?::\d+)?(?::\d+)?\)?/g,
+        // Python: File "path/file.py", line 42
+        /File\s+"([\w./_\\-]+\.py)",\s+line\s+\d+/g,
+        // Go: path/file.go:42
+        /([\w./_-]+\.go):\d+/g,
+        // Java: at pkg.Class(file.java:42)
+        /at\s+[\w.]+\(([\w./_-]+\.java):\d+\)/g,
+        // Ruby: from path/file.rb:42
+        /from\s+([\w./_-]+\.rb):\d+/g,
+    ];
+    const excludePatterns = [
+        /node_modules/,
+        /vendor\//,
+        /\.yarn\//,
+        /internal\//,
+        /<anonymous>/,
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(stackTrace)) !== null) {
+            const filePath = match[1];
+            if (filePath && !excludePatterns.some((p) => p.test(filePath))) {
+                paths.add(filePath);
+            }
+        }
+    }
+    return [...paths];
+}
+function truncate(str, maxLength) {
+    return str.length > maxLength ? str.slice(0, maxLength) : str;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,39 @@
+import type { ErrorEvent, ResolvedConfig } from './types.js';
+/**
+ * Batched HTTP transport for error events.
+ *
+ * Events are buffered in memory and flushed either when the batch is full,
+ * on a timer interval, or on process shutdown. This reduces HTTP overhead
+ * while ensuring events are not lost on process exit.
+ */
+export declare class BatchTransport {
+    private buffer;
+    private flushTimer;
+    private shutdownRegistered;
+    private flushing;
+    private config;
+    constructor(config: ResolvedConfig);
+    /**
+     * Enqueue an event for batched delivery.
+     * Triggers an immediate flush if the buffer reaches batchSize.
+     */
+    enqueue(event: ErrorEvent): void;
+    /**
+     * Flush all buffered events to the API.
+     * Safe to call concurrently — uses a lock to prevent overlapping flushes.
+     */
+    flush(): Promise<void>;
+    /**
+     * Stop the flush timer and flush remaining events.
+     * Called during graceful shutdown.
+     */
+    shutdown(): Promise<void>;
+    /** Number of events currently buffered. */
+    get pendingCount(): number;
+    private startFlushTimer;
+    private registerShutdownHooks;
+    private sendWithRetry;
+    private sendEvent;
+    private sleep;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAe,cAAc,EAAE,MAAM,YAAY,CAAC;AAM1E;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;IAMlC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQhC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,2CAA2C;IAC3C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAMD,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,qBAAqB;YAaf,aAAa;YAmBb,SAAS;IAyBvB,OAAO,CAAC,KAAK;CAMd"}