@linkforty/core 1.0.0 → 1.2.1

package/dist/lib/fingerprint.js

@@ -0,0 +1,343 @@
+import crypto from 'crypto';
+import { db } from './database.js';
+/**
+ * Scoring weights for probabilistic matching
+ * Total should equal 100 for percentage-based confidence
+ */
+const FINGERPRINT_WEIGHTS = {
+    IP_ADDRESS: 40,
+    USER_AGENT: 30,
+    TIMEZONE: 10,
+    LANGUAGE: 10,
+    SCREEN_RESOLUTION: 10,
+};
+/**
+ * Default attribution window in hours (7 days)
+ */
+export const DEFAULT_ATTRIBUTION_WINDOW_HOURS = 168;
+/**
+ * Minimum confidence threshold for attribution (70%)
+ */
+export const CONFIDENCE_THRESHOLD = 70;
+/**
+ * Generate a fingerprint hash from device data
+ * Uses SHA-256 hash of concatenated device attributes
+ */
+export function generateFingerprintHash(data) {
+    const components = [
+        data.ipAddress || '',
+        data.userAgent || '',
+        data.timezone || '',
+        data.language || '',
+        data.screenWidth?.toString() || '',
+        data.screenHeight?.toString() || '',
+        data.platform || '',
+        data.platformVersion || '',
+    ];
+    const concatenated = components.join('|');
+    return crypto.createHash('sha256').update(concatenated).digest('hex');
+}
+/**
+ * Normalize IP address for comparison
+ * Handles IPv4 and IPv6, removes subnet variations
+ */
+function normalizeIP(ip) {
+    if (!ip)
+        return '';
+    // For IPv4, use first 3 octets (e.g., 192.168.1.x)
+    if (ip.includes('.')) {
+        const parts = ip.split('.');
+        return parts.slice(0, 3).join('.');
+    }
+    // For IPv6, use first 4 groups (e.g., 2001:0db8:85a3:0000:xxxx)
+    if (ip.includes(':')) {
+        const parts = ip.split(':');
+        return parts.slice(0, 4).join(':');
+    }
+    return ip;
+}
+/**
+ * Normalize user agent for comparison
+ * Extracts key identifiers and removes version numbers
+ */
+function normalizeUserAgent(ua) {
+    if (!ua)
+        return '';
+    // Extract platform (iOS, Android, Windows, Mac, Linux)
+    const platformMatch = ua.match(/(iPhone|iPad|Android|Windows|Macintosh|Linux)/i);
+    const platform = platformMatch ? platformMatch[1] : '';
+    // Extract browser (Chrome, Safari, Firefox, Edge)
+    const browserMatch = ua.match(/(Chrome|Safari|Firefox|Edge|Opera)/i);
+    const browser = browserMatch ? browserMatch[1] : '';
+    return `${platform}|${browser}`.toLowerCase();
+}
+/**
+ * Calculate confidence score by comparing two fingerprints
+ * Returns a score from 0-100 based on matched components
+ */
+export function calculateConfidenceScore(fingerprint1, fingerprint2) {
+    let score = 0;
+    const matchedFactors = [];
+    // Compare IP addresses (normalized to /24 subnet for IPv4)
+    if (fingerprint1.ipAddress && fingerprint2.ipAddress) {
+        const ip1 = normalizeIP(fingerprint1.ipAddress);
+        const ip2 = normalizeIP(fingerprint2.ipAddress);
+        if (ip1 === ip2) {
+            score += FINGERPRINT_WEIGHTS.IP_ADDRESS;
+            matchedFactors.push('ip');
+        }
+    }
+    // Compare user agents (normalized to platform + browser)
+    if (fingerprint1.userAgent && fingerprint2.userAgent) {
+        const ua1 = normalizeUserAgent(fingerprint1.userAgent);
+        const ua2 = normalizeUserAgent(fingerprint2.userAgent);
+        if (ua1 === ua2) {
+            score += FINGERPRINT_WEIGHTS.USER_AGENT;
+            matchedFactors.push('user_agent');
+        }
+    }
+    // Compare timezone
+    if (fingerprint1.timezone && fingerprint2.timezone) {
+        if (fingerprint1.timezone === fingerprint2.timezone) {
+            score += FINGERPRINT_WEIGHTS.TIMEZONE;
+            matchedFactors.push('timezone');
+        }
+    }
+    // Compare language
+    if (fingerprint1.language && fingerprint2.language) {
+        // Match first 2 characters (e.g., "en-US" matches "en-GB")
+        const lang1 = fingerprint1.language.substring(0, 2).toLowerCase();
+        const lang2 = fingerprint2.language.substring(0, 2).toLowerCase();
+        if (lang1 === lang2) {
+            score += FINGERPRINT_WEIGHTS.LANGUAGE;
+            matchedFactors.push('language');
+        }
+    }
+    // Compare screen resolution
+    if (fingerprint1.screenWidth &&
+        fingerprint1.screenHeight &&
+        fingerprint2.screenWidth &&
+        fingerprint2.screenHeight) {
+        if (fingerprint1.screenWidth === fingerprint2.screenWidth &&
+            fingerprint1.screenHeight === fingerprint2.screenHeight) {
+            score += FINGERPRINT_WEIGHTS.SCREEN_RESOLUTION;
+            matchedFactors.push('screen');
+        }
+    }
+    return { score, matchedFactors };
+}
+/**
+ * Match an install event to potential click events via probabilistic fingerprinting
+ * Returns the best match above confidence threshold within attribution window
+ *
+ * Note: Uses link-specific attribution windows - each link can have its own window
+ */
+export async function matchInstallToClick(installFingerprint, attributionWindowHours = DEFAULT_ATTRIBUTION_WINDOW_HOURS) {
+    // Query recent click events within maximum possible attribution window (90 days)
+    // We'll validate against each link's specific window during matching
+    const maxWindowHours = 2160; // 90 days
+    const cutoffTime = new Date(Date.now() - maxWindowHours * 60 * 60 * 1000);
+    const clicksResult = await db.query(`SELECT
+       ce.id as click_id,
+       ce.link_id,
+       ce.clicked_at,
+       l.attribution_window_hours,
+       df.ip_address,
+       df.user_agent,
+       df.timezone,
+       df.language,
+       df.screen_width,
+       df.screen_height,
+       df.platform,
+       df.platform_version
+     FROM click_events ce
+     INNER JOIN device_fingerprints df ON df.click_id = ce.id
+     INNER JOIN links l ON ce.link_id = l.id
+     WHERE ce.clicked_at >= $1
+     ORDER BY ce.clicked_at DESC
+     LIMIT 1000`, [cutoffTime]);
+    if (clicksResult.rows.length === 0) {
+        return null;
+    }
+    const installTime = new Date();
+    // Calculate confidence score for each potential match
+    let bestMatch = null;
+    let highestScore = 0;
+    for (const row of clicksResult.rows) {
+        // Check if click is within the link's specific attribution window
+        const linkWindowHours = row.attribution_window_hours || DEFAULT_ATTRIBUTION_WINDOW_HOURS;
+        const clickTime = new Date(row.clicked_at);
+        const timeDiffHours = (installTime.getTime() - clickTime.getTime()) / (1000 * 60 * 60);
+        if (timeDiffHours > linkWindowHours) {
+            // Click is too old for this link's attribution window, skip it
+            continue;
+        }
+        const clickFingerprint = {
+            ipAddress: row.ip_address,
+            userAgent: row.user_agent,
+            timezone: row.timezone,
+            language: row.language,
+            screenWidth: row.screen_width,
+            screenHeight: row.screen_height,
+            platform: row.platform,
+            platformVersion: row.platform_version,
+        };
+        const { score, matchedFactors } = calculateConfidenceScore(installFingerprint, clickFingerprint);
+        // Track the best match
+        if (score > highestScore && score >= CONFIDENCE_THRESHOLD) {
+            highestScore = score;
+            bestMatch = {
+                clickId: row.click_id,
+                linkId: row.link_id,
+                confidenceScore: score,
+                matchedFactors,
+                clickedAt: new Date(row.clicked_at),
+            };
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Store device fingerprint for a click event
+ */
+export async function storeFingerprintForClick(clickId, fingerprintData) {
+    const fingerprintHash = generateFingerprintHash(fingerprintData);
+    await db.query(`INSERT INTO device_fingerprints (
+      click_id,
+      fingerprint_hash,
+      ip_address,
+      user_agent,
+      timezone,
+      language,
+      screen_width,
+      screen_height,
+      platform,
+      platform_version
+    ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)`, [
+        clickId,
+        fingerprintHash,
+        fingerprintData.ipAddress,
+        fingerprintData.userAgent,
+        fingerprintData.timezone || null,
+        fingerprintData.language || null,
+        fingerprintData.screenWidth || null,
+        fingerprintData.screenHeight || null,
+        fingerprintData.platform || null,
+        fingerprintData.platformVersion || null,
+    ]);
+}
+/**
+ * Record an install event and attempt to match it to a click
+ */
+export async function recordInstallEvent(fingerprintData, deviceId, attributionWindowHours = DEFAULT_ATTRIBUTION_WINDOW_HOURS) {
+    const fingerprintHash = generateFingerprintHash(fingerprintData);
+    // Attempt to match install to a click
+    const match = await matchInstallToClick(fingerprintData, attributionWindowHours);
+    // Insert install event
+    const installResult = await db.query(`INSERT INTO install_events (
+      link_id,
+      click_id,
+      fingerprint_hash,
+      confidence_score,
+      installed_at,
+      first_open_at,
+      attribution_window_hours,
+      ip_address,
+      user_agent,
+      timezone,
+      language,
+      screen_width,
+      screen_height,
+      platform,
+      platform_version,
+      device_id,
+      deep_link_data
+    ) VALUES ($1, $2, $3, $4, NOW(), NOW(), $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)
+    RETURNING id, deep_link_data`, [
+        match?.linkId || null,
+        match?.clickId || null,
+        fingerprintHash,
+        match?.confidenceScore || null,
+        attributionWindowHours,
+        fingerprintData.ipAddress,
+        fingerprintData.userAgent,
+        fingerprintData.timezone || null,
+        fingerprintData.language || null,
+        fingerprintData.screenWidth || null,
+        fingerprintData.screenHeight || null,
+        fingerprintData.platform || null,
+        fingerprintData.platformVersion || null,
+        deviceId || null,
+        match ? JSON.stringify({}) : JSON.stringify({}), // Will be populated from link data
+    ]);
+    const installId = installResult.rows[0].id;
+    let deepLinkData = {};
+    // If we have a match, retrieve the deep link data from the original link
+    if (match) {
+        const linkResult = await db.query(`SELECT
+         short_code,
+         original_url,
+         ios_url,
+         android_url,
+         web_fallback_url,
+         utm_parameters,
+         targeting_rules
+       FROM links
+       WHERE id = $1`, [match.linkId]);
+        if (linkResult.rows.length > 0) {
+            const link = linkResult.rows[0];
+            deepLinkData = {
+                shortCode: link.short_code,
+                originalUrl: link.original_url,
+                iosUrl: link.ios_url,
+                androidUrl: link.android_url,
+                webFallbackUrl: link.web_fallback_url,
+                utmParameters: link.utm_parameters,
+                targetingRules: link.targeting_rules,
+                clickedAt: match.clickedAt,
+                confidenceScore: match.confidenceScore,
+                matchedFactors: match.matchedFactors,
+            };
+            // Update the install event with deep link data
+            await db.query(`UPDATE install_events
+         SET deep_link_data = $1,
+             deep_link_retrieved = true
+         WHERE id = $2`, [JSON.stringify(deepLinkData), installId]);
+            // Trigger webhooks for install_event (only if attributed)
+            try {
+                // Get the link's user_id for webhook lookup
+                const linkUserResult = await db.query('SELECT user_id FROM links WHERE id = $1', [match.linkId]);
+                if (linkUserResult.rows.length > 0) {
+                    const userId = linkUserResult.rows[0].user_id;
+                    const webhooksResult = await db.query('SELECT * FROM webhooks WHERE user_id = $1 AND is_active = true', [userId]);
+                    if (webhooksResult.rows.length > 0) {
+                        const { triggerWebhooks } = await import('./webhook.js');
+                        const installEventData = {
+                            id: installId,
+                            linkId: match.linkId,
+                            fingerprintHash,
+                            confidenceScore: match.confidenceScore,
+                            installedAt: new Date().toISOString(),
+                            deepLinkData,
+                            ipAddress: fingerprintData.ipAddress,
+                            userAgent: fingerprintData.userAgent,
+                            platform: fingerprintData.platform,
+                        };
+                        // Trigger webhooks without delivery logging (basic version)
+                        // For delivery logging, use @linkforty/cloud premium features
+                        await triggerWebhooks(webhooksResult.rows, 'install_event', installId, installEventData);
+                    }
+                }
+            }
+            catch (webhookError) {
+                console.error(`Error triggering install webhooks: ${webhookError}`);
+            }
+        }
+    }
+    return {
+        installId,
+        match,
+        deepLinkData,
+    };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/lib/fingerprint.js.map

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

package/dist/lib/utils.d.ts

@@ -2,6 +2,7 @@ export declare function generateShortCode(length?: number): string;
 export declare function parseUserAgent(userAgent: string): {
     deviceType: string;
     platform: string;
+    platformVersion: string | undefined;
     browser: string;
 };
 export declare function getLocationFromIP(ip: string): {

package/dist/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;;EAS/C;AAoDD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;EAwB3C;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAYR;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAYzE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;;;EAU/C;AAoDD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;EAwB3C;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAYR;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAYzE"}

package/dist/lib/utils.js

@@ -1,25 +1,16 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateShortCode = generateShortCode;
-exports.parseUserAgent = parseUserAgent;
-exports.getLocationFromIP = getLocationFromIP;
-exports.buildRedirectUrl = buildRedirectUrl;
-exports.detectDevice = detectDevice;
-const nanoid_1 = require("nanoid");
-const geoip_lite_1 = __importDefault(require("geoip-lite"));
-const ua_parser_js_1 = __importDefault(require("ua-parser-js"));
-function generateShortCode(length = 8) {
-    return (0, nanoid_1.nanoid)(length);
+import { nanoid } from 'nanoid';
+import geoip from 'geoip-lite';
+import UAParser from 'ua-parser-js';
+export function generateShortCode(length = 8) {
+    return nanoid(length);
 }
-function parseUserAgent(userAgent) {
-    const parser = new ua_parser_js_1.default(userAgent);
+export function parseUserAgent(userAgent) {
+    const parser = new UAParser(userAgent);
     const result = parser.getResult();
     return {
         deviceType: result.device.type || 'desktop',
         platform: result.os.name || 'unknown',
+        platformVersion: result.os.version || undefined,
         browser: result.browser.name || 'unknown',
     };
 }
@@ -72,8 +63,8 @@ const COUNTRY_NAMES = {
     HU: 'Hungary',
     RO: 'Romania',
 };
-function getLocationFromIP(ip) {
-    const geo = geoip_lite_1.default.lookup(ip);
+export function getLocationFromIP(ip) {
+    const geo = geoip.lookup(ip);
     if (!geo) {
         return {
             countryCode: null,
@@ -95,7 +86,7 @@ function getLocationFromIP(ip) {
         timezone: geo.timezone,
     };
 }
-function buildRedirectUrl(originalUrl, utmParameters) {
+export function buildRedirectUrl(originalUrl, utmParameters) {
     const url = new URL(originalUrl);
     if (utmParameters) {
         Object.entries(utmParameters).forEach(([key, value]) => {
@@ -106,7 +97,7 @@ function buildRedirectUrl(originalUrl, utmParameters) {
     }
     return url.toString();
 }
-function detectDevice(userAgent) {
+export function detectDevice(userAgent) {
     const ua = userAgent.toLowerCase();
     if (ua.includes('iphone') || ua.includes('ipad') || ua.includes('ipod')) {
         return 'ios';

package/dist/lib/utils.js.map

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

package/dist/lib/webhook.d.ts

@@ -0,0 +1,18 @@
+import type { Webhook, WebhookPayload, WebhookDeliveryResult, WebhookEvent } from '../types/index.js';
+/**
+ * Generate HMAC SHA-256 signature for webhook payload
+ */
+export declare function generateWebhookSignature(payload: string, secret: string): string;
+/**
+ * Generate a secure random secret for webhook signing
+ */
+export declare function generateWebhookSecret(): string;
+/**
+ * Deliver webhook with retry logic and exponential backoff
+ */
+export declare function deliverWebhook(webhook: Webhook, payload: WebhookPayload, logDelivery?: (result: WebhookDeliveryResult) => Promise<void>): Promise<WebhookDeliveryResult>;
+/**
+ * Trigger webhooks for a specific event (fire and forget)
+ */
+export declare function triggerWebhooks(webhooks: Webhook[], event: WebhookEvent, eventId: string, data: any, logDelivery?: (webhookId: string, result: WebhookDeliveryResult) => Promise<void>): Promise<void>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/lib/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/lib/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtG;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AA4ED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7D,OAAO,CAAC,qBAAqB,CAAC,CAmChC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,EACT,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAChF,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/lib/webhook.js

@@ -0,0 +1,141 @@
+import crypto from 'crypto';
+/**
+ * Generate HMAC SHA-256 signature for webhook payload
+ */
+export function generateWebhookSignature(payload, secret) {
+    return crypto.createHmac('sha256', secret).update(payload).digest('hex');
+}
+/**
+ * Generate a secure random secret for webhook signing
+ */
+export function generateWebhookSecret() {
+    return crypto.randomBytes(32).toString('hex');
+}
+/**
+ * Sleep utility for retry delays
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Attempt a single webhook delivery
+ */
+async function attemptWebhookDelivery(webhook, payload, attemptNumber) {
+    const payloadString = JSON.stringify(payload);
+    const signature = generateWebhookSignature(payloadString, webhook.secret);
+    const headers = {
+        'Content-Type': 'application/json',
+        'X-LinkForty-Signature': `sha256=${signature}`,
+        'X-LinkForty-Event': payload.event,
+        'X-LinkForty-Event-ID': payload.event_id,
+        'User-Agent': 'LinkForty-Webhook/1.0',
+        ...webhook.headers,
+    };
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), webhook.timeout_ms);
+    try {
+        const response = await fetch(webhook.url, {
+            method: 'POST',
+            headers,
+            body: payloadString,
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        const responseBody = await response.text().catch(() => '');
+        const result = {
+            success: response.ok,
+            webhookId: webhook.id,
+            eventType: payload.event,
+            eventId: payload.event_id,
+            responseStatus: response.status,
+            responseBody: responseBody.substring(0, 1000), // Limit response body size
+            attemptNumber,
+            deliveredAt: response.ok ? new Date().toISOString() : undefined,
+        };
+        if (!response.ok) {
+            result.errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+        }
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        return {
+            success: false,
+            webhookId: webhook.id,
+            eventType: payload.event,
+            eventId: payload.event_id,
+            errorMessage: error.name === 'AbortError'
+                ? `Timeout after ${webhook.timeout_ms}ms`
+                : error.message || 'Unknown error',
+            attemptNumber,
+        };
+    }
+}
+/**
+ * Deliver webhook with retry logic and exponential backoff
+ */
+export async function deliverWebhook(webhook, payload, logDelivery) {
+    const maxRetries = webhook.retry_count || 3;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        const result = await attemptWebhookDelivery(webhook, payload, attempt);
+        // Log delivery attempt if logging function provided
+        if (logDelivery) {
+            await logDelivery(result).catch(err => {
+                console.error('Failed to log webhook delivery:', err);
+            });
+        }
+        // If successful, return immediately
+        if (result.success) {
+            return result;
+        }
+        // If not the last attempt, wait before retrying with exponential backoff
+        if (attempt < maxRetries) {
+            // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 30s (capped at 30s)
+            const delayMs = Math.min(1000 * Math.pow(2, attempt - 1), 30000);
+            await sleep(delayMs);
+        }
+    }
+    // Return the last failed result
+    return {
+        success: false,
+        webhookId: webhook.id,
+        eventType: payload.event,
+        eventId: payload.event_id,
+        errorMessage: `Failed after ${maxRetries} attempts`,
+        attemptNumber: maxRetries,
+    };
+}
+/**
+ * Trigger webhooks for a specific event (fire and forget)
+ */
+export async function triggerWebhooks(webhooks, event, eventId, data, logDelivery) {
+    // Create webhook payload
+    const payload = {
+        event,
+        event_id: eventId,
+        timestamp: new Date().toISOString(),
+        data,
+    };
+    // Filter webhooks that should receive this event
+    const relevantWebhooks = webhooks.filter(webhook => webhook.is_active && webhook.events.includes(event));
+    if (relevantWebhooks.length === 0) {
+        return; // No webhooks to trigger
+    }
+    // Fire and forget - don't await these deliveries
+    const deliveryPromises = relevantWebhooks.map(async (webhook) => {
+        try {
+            const result = await deliverWebhook(webhook, payload, logDelivery ? (result) => logDelivery(webhook.id, result) : undefined);
+            if (!result.success) {
+                console.error(`Webhook ${webhook.id} delivery failed:`, result.errorMessage);
+            }
+        }
+        catch (error) {
+            console.error(`Webhook ${webhook.id} delivery error:`, error);
+        }
+    });
+    // Fire and forget - log errors but don't block
+    Promise.all(deliveryPromises).catch(err => {
+        console.error('Webhook delivery batch error:', err);
+    });
+}
+//# sourceMappingURL=webhook.js.map

package/dist/lib/webhook.js.map

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