@linkforty/core 1.6.6 → 1.13.6

package/README.md

@@ -257,7 +257,7 @@ DELETE /api/webhooks/:id?userId=user-uuid
 POST   /api/webhooks/:id/test?userId=user-uuid
 ```
 
-Events: `click_event`, `install_event`, `conversion_event`. Payloads are HMAC SHA-256 signed.
+Events: `click_event`, `install_event`, `conversion_event`, `sdk_event`. Payloads are HMAC SHA-256 signed.
 
 ### Mobile SDK Endpoints
 
@@ -312,9 +312,14 @@ interface ServerOptions {
     origin: string | string[];  // CORS allowed origins (default: '*')
   };
   logger?: boolean;         // Enable Fastify logger (default: true)
+  trustProxy?: boolean | number;  // Trust X-Forwarded-For when behind a proxy (default: false)
 }
 ```
 
+### Running behind a reverse proxy
+
+When Core runs behind a reverse proxy, CDN, or load balancer, set `trustProxy` so the server uses the real client IP from `X-Forwarded-For` for redirect targeting, geo, attribution, and fingerprinting. Pass it when creating the server (e.g. `trustProxy: true` or a number of proxy hops) or set the `TRUST_PROXY` environment variable (e.g. `TRUST_PROXY=1`). Client-provided `ipAddress` in the SDK install request body is **not** used as the trusted IP; it is optional debug metadata only and must not be relied on for attribution.
+
 ### Environment Variables
 
 ```bash
@@ -323,6 +328,8 @@ REDIS_URL=redis://localhost:6379
 PORT=3000
 NODE_ENV=production
 CORS_ORIGIN=*
+# When behind a reverse proxy: TRUST_PROXY=1 (or number of hops) so client IP is read from X-Forwarded-For
+# TRUST_PROXY=1
 
 # Mobile SDK (optional — for iOS Universal Links and Android App Links)
 IOS_TEAM_ID=ABC123XYZ

package/dist/index.d.ts

@@ -9,9 +9,12 @@ export interface ServerOptions {
         origin: string | string[];
     };
     logger?: boolean;
+    /** When true or a number (proxy hop count), Fastify trusts X-Forwarded-For so request.ip is the real client IP. Set when behind a reverse proxy. */
+    trustProxy?: boolean | number;
 }
 export declare function createServer(options?: ServerOptions): Promise<FastifyInstance<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
 export * from './lib/utils.js';
+export * from './lib/client-ip.js';
 export * from './lib/database.js';
 export * from './lib/fingerprint.js';
 export * from './lib/webhook.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAsB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,kTA+B7D;AAGD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAsB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oJAAoJ;IACpJ,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,kTAgC7D;AAGD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -13,6 +13,7 @@ import { wellKnownRoutes } from './routes/well-known.js';
 export async function createServer(options = {}) {
     const fastify = Fastify({
         logger: options.logger !== undefined ? options.logger : true,
+        trustProxy: options.trustProxy,
     });
     // CORS
     await fastify.register(cors, {
@@ -39,6 +40,7 @@ export async function createServer(options = {}) {
 }
 // Re-export utilities and types
 export * from './lib/utils.js';
+export * from './lib/client-ip.js';
 export * from './lib/database.js';
 export * from './lib/fingerprint.js';
 export * from './lib/webhook.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4B,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAmB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAazD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAyB,EAAE;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;KAC7D,CAAC,CAAC;IAEH,OAAO;IACP,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG;KACpC,CAAC,CAAC;IAEH,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC5B,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;SACvB,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,MAAM,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C,SAAS;IACT,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gCAAgC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAA4B,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAmB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAezD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAyB,EAAE;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC5D,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IAEH,OAAO;IACP,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG;KACpC,CAAC,CAAC;IAEH,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC5B,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;SACvB,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,MAAM,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C,SAAS;IACT,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gCAAgC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lib/client-ip.d.ts

@@ -0,0 +1,10 @@
+import type { FastifyRequest } from 'fastify';
+/**
+ * Returns the trusted client IP for the request.
+ * Use this everywhere client IP is needed (targeting, attribution, fingerprinting).
+ * When the server is behind a reverse proxy, set Fastify's trustProxy option
+ * so that request.ip is populated from X-Forwarded-For; this helper then
+ * returns that trusted value.
+ */
+export declare function getClientIp(request: FastifyRequest): string;
+//# sourceMappingURL=client-ip.d.ts.map

package/dist/lib/client-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.d.ts","sourceRoot":"","sources":["../../src/lib/client-ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAQ3D"}

package/dist/lib/client-ip.js

@@ -0,0 +1,18 @@
+/**
+ * Returns the trusted client IP for the request.
+ * Use this everywhere client IP is needed (targeting, attribution, fingerprinting).
+ * When the server is behind a reverse proxy, set Fastify's trustProxy option
+ * so that request.ip is populated from X-Forwarded-For; this helper then
+ * returns that trusted value.
+ */
+export function getClientIp(request) {
+    const ip = request.ip ?? request.socket?.remoteAddress;
+    if (ip && typeof ip === 'string') {
+        // IPv6-mapped IPv4: ::ffff:192.168.1.1 -> 192.168.1.1
+        if (ip.startsWith('::ffff:'))
+            return ip.slice(7);
+        return ip;
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=client-ip.js.map

package/dist/lib/client-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.js","sourceRoot":"","sources":["../../src/lib/client-ip.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAuB;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAK,OAAe,CAAC,MAAM,EAAE,aAAa,CAAC;IAChE,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACjC,sDAAsD;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/client-ip.test.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    var __capturedInstallFingerprint: {
+        ipAddress: string;
+    } | null;
+}
+export {};
+//# sourceMappingURL=client-ip.test.d.ts.map

package/dist/lib/client-ip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.test.d.ts","sourceRoot":"","sources":["../../src/lib/client-ip.test.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,4BAA4B,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE"}

package/dist/lib/client-ip.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getClientIp } from './client-ip';
+describe('getClientIp', () => {
+    it('returns request.ip when set', () => {
+        const request = { ip: '192.168.1.1' };
+        expect(getClientIp(request)).toBe('192.168.1.1');
+    });
+    it('returns socket.remoteAddress when request.ip is undefined', () => {
+        const request = {
+            ip: undefined,
+            socket: { remoteAddress: '10.0.0.2' },
+        };
+        expect(getClientIp(request)).toBe('10.0.0.2');
+    });
+    it('unwraps IPv6-mapped IPv4', () => {
+        const request = { ip: '::ffff:192.168.1.1' };
+        expect(getClientIp(request)).toBe('192.168.1.1');
+    });
+    it('returns "unknown" when neither ip nor socket.remoteAddress is available', () => {
+        const request = { ip: undefined, socket: {} };
+        expect(getClientIp(request)).toBe('unknown');
+    });
+    it('returns "unknown" when request has no socket', () => {
+        const request = { ip: undefined };
+        expect(getClientIp(request)).toBe('unknown');
+    });
+});
+describe('getClientIp with Fastify trustProxy (proxied request)', () => {
+    it('uses X-Forwarded-For when trustProxy is true', async () => {
+        const Fastify = (await import('fastify')).default;
+        const { getClientIp: getIp } = await import('./client-ip.js');
+        const app = Fastify({ trustProxy: true });
+        app.get('/ip', async (request, reply) => {
+            return reply.send({ ip: getIp(request) });
+        });
+        const res = await app.inject({
+            method: 'GET',
+            url: '/ip',
+            headers: { 'x-forwarded-for': '203.0.113.50' },
+        });
+        expect(res.statusCode).toBe(200);
+        const body = res.json();
+        expect(body.ip).toBe('203.0.113.50');
+    });
+});
+vi.mock('./fingerprint.js', async (importOriginal) => {
+    const mod = (await importOriginal());
+    return {
+        ...mod,
+        recordInstallEvent: vi.fn().mockImplementation(async (data) => {
+            globalThis.__capturedInstallFingerprint = data;
+            return { installId: 'test-id', match: null, deepLinkData: null };
+        }),
+    };
+});
+describe('SDK install does not trust client-provided ipAddress', () => {
+    it('uses connection/proxy IP for attribution, not body ipAddress', async () => {
+        globalThis.__capturedInstallFingerprint = null;
+        const Fastify = (await import('fastify')).default;
+        const { sdkRoutes } = await import('../routes/sdk.js');
+        const app = Fastify({ trustProxy: true });
+        await app.register(sdkRoutes);
+        const res = await app.inject({
+            method: 'POST',
+            url: '/api/sdk/v1/install',
+            payload: { ipAddress: '1.2.3.4', userAgent: 'Mozilla/5.0 Test' },
+            headers: { 'x-forwarded-for': '203.0.113.50', 'content-type': 'application/json' },
+        });
+        expect(res.statusCode).toBe(200);
+        expect(globalThis.__capturedInstallFingerprint).not.toBeNull();
+        expect(globalThis.__capturedInstallFingerprint.ipAddress).toBe('203.0.113.50');
+        const body = res.json();
+        expect(body.clientReportedIp).toBe('1.2.3.4');
+    });
+});
+//# sourceMappingURL=client-ip.test.js.map

package/dist/lib/client-ip.test.js.map

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

package/dist/lib/event-emitter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-emitter.test.d.ts.map

package/dist/lib/event-emitter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.test.d.ts","sourceRoot":"","sources":["../../src/lib/event-emitter.test.ts"],"names":[],"mappings":""}

package/dist/lib/event-emitter.test.js

@@ -0,0 +1,162 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { clickEventEmitter, emitClickEvent, subscribeToClickEvents, } from './event-emitter';
+const mockClickEvent = {
+    eventId: 'evt-123',
+    timestamp: '2026-03-10T00:00:00.000Z',
+    linkId: 'link-abc',
+    shortCode: 'abc123',
+    userId: 'user-1',
+    organizationId: 'org-1',
+    ipAddress: '1.2.3.4',
+    userAgent: 'Mozilla/5.0',
+    country: 'US',
+    city: 'New York',
+    deviceType: 'web',
+    platform: 'Windows',
+    browser: 'Chrome',
+    redirectUrl: 'https://example.com',
+    redirectReason: 'web_fallback',
+    targetingMatched: true,
+    utmParameters: {
+        source: 'newsletter',
+        medium: 'email',
+        campaign: 'spring',
+    },
+    referer: 'https://google.com',
+    language: 'en-US',
+};
+describe('clickEventEmitter', () => {
+    it('should be an EventEmitter instance', () => {
+        expect(clickEventEmitter).toBeDefined();
+        expect(typeof clickEventEmitter.on).toBe('function');
+        expect(typeof clickEventEmitter.emit).toBe('function');
+        expect(typeof clickEventEmitter.off).toBe('function');
+    });
+});
+describe('emitClickEvent', () => {
+    beforeEach(() => {
+        clickEventEmitter.removeAllListeners('click');
+    });
+    it('should emit a click event with the provided data', () => {
+        const handler = vi.fn();
+        clickEventEmitter.on('click', handler);
+        emitClickEvent(mockClickEvent);
+        expect(handler).toHaveBeenCalledOnce();
+        expect(handler).toHaveBeenCalledWith(mockClickEvent);
+    });
+    it('should emit to all registered listeners', () => {
+        const handler1 = vi.fn();
+        const handler2 = vi.fn();
+        clickEventEmitter.on('click', handler1);
+        clickEventEmitter.on('click', handler2);
+        emitClickEvent(mockClickEvent);
+        expect(handler1).toHaveBeenCalledOnce();
+        expect(handler2).toHaveBeenCalledOnce();
+    });
+    it('should emit multiple times when called multiple times', () => {
+        const handler = vi.fn();
+        clickEventEmitter.on('click', handler);
+        emitClickEvent(mockClickEvent);
+        emitClickEvent({ ...mockClickEvent, eventId: 'evt-456' });
+        expect(handler).toHaveBeenCalledTimes(2);
+    });
+    it('should pass the exact event data to the handler', () => {
+        const handler = vi.fn();
+        clickEventEmitter.on('click', handler);
+        const eventData = {
+            ...mockClickEvent,
+            deviceType: 'ios',
+            country: 'CA',
+            targetingMatched: false,
+        };
+        emitClickEvent(eventData);
+        expect(handler).toHaveBeenCalledWith(eventData);
+    });
+    it('should work with minimal required fields', () => {
+        const handler = vi.fn();
+        clickEventEmitter.on('click', handler);
+        const minimalEvent = {
+            eventId: 'evt-min',
+            timestamp: '2026-03-10T00:00:00.000Z',
+            linkId: 'link-min',
+            shortCode: 'min',
+            ipAddress: '0.0.0.0',
+            userAgent: '',
+            deviceType: 'web',
+            redirectUrl: 'https://example.com',
+            redirectReason: 'default',
+            targetingMatched: true,
+        };
+        emitClickEvent(minimalEvent);
+        expect(handler).toHaveBeenCalledWith(minimalEvent);
+    });
+});
+describe('subscribeToClickEvents', () => {
+    beforeEach(() => {
+        clickEventEmitter.removeAllListeners('click');
+    });
+    it('should call the callback when a click event is emitted', () => {
+        const callback = vi.fn();
+        subscribeToClickEvents(callback);
+        emitClickEvent(mockClickEvent);
+        expect(callback).toHaveBeenCalledOnce();
+        expect(callback).toHaveBeenCalledWith(mockClickEvent);
+    });
+    it('should return an unsubscribe function', () => {
+        const callback = vi.fn();
+        const unsubscribe = subscribeToClickEvents(callback);
+        expect(typeof unsubscribe).toBe('function');
+    });
+    it('should stop receiving events after unsubscribing', () => {
+        const callback = vi.fn();
+        const unsubscribe = subscribeToClickEvents(callback);
+        emitClickEvent(mockClickEvent);
+        expect(callback).toHaveBeenCalledOnce();
+        unsubscribe();
+        emitClickEvent(mockClickEvent);
+        expect(callback).toHaveBeenCalledOnce(); // still only once
+    });
+    it('should allow multiple subscribers independently', () => {
+        const callback1 = vi.fn();
+        const callback2 = vi.fn();
+        const unsubscribe1 = subscribeToClickEvents(callback1);
+        subscribeToClickEvents(callback2);
+        emitClickEvent(mockClickEvent);
+        expect(callback1).toHaveBeenCalledOnce();
+        expect(callback2).toHaveBeenCalledOnce();
+        unsubscribe1();
+        emitClickEvent(mockClickEvent);
+        expect(callback1).toHaveBeenCalledOnce(); // no new calls
+        expect(callback2).toHaveBeenCalledTimes(2);
+    });
+    it('should not affect other subscribers when one unsubscribes', () => {
+        const callback1 = vi.fn();
+        const callback2 = vi.fn();
+        const unsubscribe1 = subscribeToClickEvents(callback1);
+        subscribeToClickEvents(callback2);
+        unsubscribe1();
+        emitClickEvent(mockClickEvent);
+        expect(callback1).not.toHaveBeenCalled();
+        expect(callback2).toHaveBeenCalledOnce();
+    });
+    it('should handle unsubscribe called multiple times without error', () => {
+        const callback = vi.fn();
+        const unsubscribe = subscribeToClickEvents(callback);
+        expect(() => {
+            unsubscribe();
+            unsubscribe();
+        }).not.toThrow();
+    });
+    it('should pass event data correctly to callback', () => {
+        const received = [];
+        subscribeToClickEvents((data) => received.push(data));
+        const event1 = { ...mockClickEvent, eventId: 'e1', deviceType: 'ios' };
+        const event2 = { ...mockClickEvent, eventId: 'e2', deviceType: 'android' };
+        emitClickEvent(event1);
+        emitClickEvent(event2);
+        expect(received).toHaveLength(2);
+        expect(received[0]).toEqual(event1);
+        expect(received[1]).toEqual(event2);
+    });
+});
+//# sourceMappingURL=event-emitter.test.js.map

package/dist/lib/event-emitter.test.js.map

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

package/dist/lib/fingerprint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fingerprint.test.d.ts.map

package/dist/lib/fingerprint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.test.d.ts","sourceRoot":"","sources":["../../src/lib/fingerprint.test.ts"],"names":[],"mappings":""}

package/dist/lib/fingerprint.test.js

@@ -0,0 +1,227 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock the database module so tests don't require a real Postgres connection.
+vi.mock('./database', () => ({
+    db: {
+        query: vi.fn(),
+    },
+}));
+import * as fingerprint from './fingerprint';
+import { db } from './database';
+const mockDbQuery = db.query;
+const baseFingerprint = {
+    ipAddress: '192.168.1.100',
+    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.69 Safari/537.36',
+    timezone: 'America/Los_Angeles',
+    language: 'en-US',
+    screenWidth: 1080,
+    screenHeight: 1920,
+    platform: 'Windows',
+    platformVersion: '10',
+};
+describe('generateFingerprintHash', () => {
+    it('produces a deterministic 64-character SHA-256 hash', () => {
+        const hash1 = fingerprint.generateFingerprintHash(baseFingerprint);
+        const hash2 = fingerprint.generateFingerprintHash(baseFingerprint);
+        expect(hash1).toHaveLength(64);
+        expect(hash1).toBe(hash2);
+    });
+    it('produces different hashes for different data', () => {
+        const other = { ...baseFingerprint, ipAddress: '10.0.0.1' };
+        const hash1 = fingerprint.generateFingerprintHash(baseFingerprint);
+        const hash2 = fingerprint.generateFingerprintHash(other);
+        expect(hash1).not.toBe(hash2);
+    });
+});
+describe('calculateConfidenceScore', () => {
+    it('returns 0 score when nothing matches', () => {
+        const a = { ...baseFingerprint };
+        const b = {
+            ...baseFingerprint,
+            ipAddress: '10.0.0.1',
+            userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/537.36',
+            timezone: 'Asia/Tokyo',
+            language: 'ja-JP',
+            screenWidth: 800,
+            screenHeight: 600,
+            platform: 'Macintosh',
+            platformVersion: '11.0',
+        };
+        const { score, matchedFactors } = fingerprint.calculateConfidenceScore(a, b);
+        expect(score).toBe(0);
+        expect(matchedFactors).toEqual([]);
+    });
+    it('matches IP within the same /24 subnet and normalizes user agent', () => {
+        const click = {
+            ...baseFingerprint,
+            ipAddress: '192.168.1.250',
+            timezone: 'Africa/Cairo',
+            language: 'fr-FR',
+            screenWidth: 800,
+            screenHeight: 600,
+            platform: 'Linux',
+        };
+        const install = {
+            ...baseFingerprint,
+            ipAddress: '192.168.1.123',
+            userAgent: baseFingerprint.userAgent.replace('Chrome/95.0.4638.69', 'Chrome/116.0.0.0'),
+            timezone: 'Europe/London',
+            language: 'de-DE',
+            screenWidth: 1200,
+            screenHeight: 900,
+            platform: 'Windows',
+        };
+        const { score, matchedFactors } = fingerprint.calculateConfidenceScore(click, install);
+        expect(score).toBe(70);
+        expect(matchedFactors).toContain('ip');
+        expect(matchedFactors).toContain('user_agent');
+    });
+    it('matches language by first two characters', () => {
+        const a = {
+            ...baseFingerprint,
+            ipAddress: '10.0.0.1',
+            userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/537.36',
+            timezone: 'Asia/Tokyo',
+            screenWidth: 800,
+            screenHeight: 600,
+            platform: 'Macintosh',
+            platformVersion: '11.0',
+            language: 'en-US',
+        };
+        const b = {
+            ...a,
+            ipAddress: '172.16.0.1',
+            userAgent: 'Mozilla/5.0 (Linux; Android 10; SM-G973F) Chrome/91.0.4472.120 Mobile Safari/537.36',
+            timezone: 'UTC',
+            screenWidth: 1024,
+            screenHeight: 768,
+            platform: 'Linux',
+            platformVersion: '10',
+            language: 'en-GB',
+        };
+        const { score, matchedFactors } = fingerprint.calculateConfidenceScore(a, b);
+        expect(score).toBe(10);
+        expect(matchedFactors).toEqual(['language']);
+    });
+    it('matches timezone and resolution', () => {
+        const a = {
+            ...baseFingerprint,
+            ipAddress: '10.0.0.1',
+            userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/537.36',
+            language: 'ja-JP',
+            platform: 'Macintosh',
+            platformVersion: '11.0',
+            timezone: 'UTC',
+            screenWidth: 100,
+            screenHeight: 200,
+        };
+        const b = {
+            ...a,
+            ipAddress: '172.16.0.1',
+            userAgent: 'Mozilla/5.0 (Linux; Android 10; SM-G973F) Chrome/91.0.4472.120 Mobile Safari/537.36',
+            language: 'fr-FR',
+        };
+        const { score, matchedFactors } = fingerprint.calculateConfidenceScore(a, b);
+        expect(score).toBe(20);
+        expect(matchedFactors.sort()).toEqual(['screen', 'timezone'].sort());
+    });
+});
+describe('matchInstallToClick', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2025-01-01T00:00:00Z'));
+        mockDbQuery.mockReset();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns null when there are no click rows', async () => {
+        mockDbQuery.mockResolvedValueOnce({ rows: [] });
+        const result = await fingerprint.matchInstallToClick(baseFingerprint);
+        expect(result).toBeNull();
+    });
+    it('returns the best match above the confidence threshold', async () => {
+        const clickTime = new Date('2024-12-31T23:00:00Z');
+        // First row: only IP match (score 40)
+        const rowA = {
+            click_id: 'click-a',
+            link_id: 'link-a',
+            clicked_at: clickTime.toISOString(),
+            attribution_window_hours: 24,
+            ip_address: '192.168.1.200',
+            user_agent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/537.36',
+            timezone: 'Asia/Tokyo',
+            language: 'ja-JP',
+            screen_width: 720,
+            screen_height: 1280,
+            platform: 'Macintosh',
+            platform_version: '11.0',
+        };
+        // Second row: IP + user agent + timezone + language + screen (score 100)
+        const rowB = {
+            click_id: 'click-b',
+            link_id: 'link-b',
+            clicked_at: clickTime.toISOString(),
+            attribution_window_hours: 24,
+            ip_address: '192.168.1.250',
+            user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36',
+            timezone: 'America/Los_Angeles',
+            language: 'en-US',
+            screen_width: 1080,
+            screen_height: 1920,
+            platform: 'Windows',
+            platform_version: '10',
+        };
+        mockDbQuery.mockResolvedValueOnce({ rows: [rowA, rowB] });
+        const installFingerprint = {
+            ...baseFingerprint,
+            ipAddress: '192.168.1.123',
+            userAgent: baseFingerprint.userAgent.replace('Chrome/95.0.4638.69', 'Chrome/116.0.0.0'),
+        };
+        const result = await fingerprint.matchInstallToClick(installFingerprint);
+        expect(result).not.toBeNull();
+        expect(result?.clickId).toBe('click-b');
+        expect(result?.confidenceScore).toBe(100);
+        expect(result?.matchedFactors).toEqual(expect.arrayContaining(['ip', 'user_agent', 'timezone', 'language', 'screen']));
+    });
+    it('skips clicks that are outside the attribution window', async () => {
+        const oldClickTime = new Date('2024-01-01T00:00:00Z');
+        mockDbQuery.mockResolvedValueOnce({
+            rows: [
+                {
+                    click_id: 'click-old',
+                    link_id: 'link-old',
+                    clicked_at: oldClickTime.toISOString(),
+                    attribution_window_hours: 1,
+                    ip_address: baseFingerprint.ipAddress,
+                    user_agent: baseFingerprint.userAgent,
+                    timezone: baseFingerprint.timezone,
+                    language: baseFingerprint.language,
+                    screen_width: baseFingerprint.screenWidth,
+                    screen_height: baseFingerprint.screenHeight,
+                    platform: baseFingerprint.platform,
+                    platform_version: baseFingerprint.platformVersion,
+                },
+            ],
+        });
+        const result = await fingerprint.matchInstallToClick(baseFingerprint);
+        expect(result).toBeNull();
+    });
+});
+describe('recordInstallEvent', () => {
+    beforeEach(() => {
+        mockDbQuery.mockReset();
+    });
+    it('inserts an install event and returns the install id when no match is found', async () => {
+        // matchInstallToClick is invoked internally by recordInstallEvent.
+        // The first db query is used to find click events. Return an empty list to force a null match.
+        mockDbQuery.mockResolvedValueOnce({ rows: [] });
+        mockDbQuery.mockResolvedValueOnce({ rows: [{ id: 'install-123', deep_link_data: {} }] });
+        const result = await fingerprint.recordInstallEvent(baseFingerprint, 'device-1');
+        expect(result.installId).toBe('install-123');
+        expect(result.match).toBeNull();
+        expect(result.deepLinkData).toEqual({});
+        expect(mockDbQuery).toHaveBeenCalledTimes(2);
+        expect(mockDbQuery).toHaveBeenLastCalledWith(expect.any(String), expect.arrayContaining([null, null, expect.any(String), null, expect.any(String), expect.any(String), null, null, null, null, null, null, null, 'device-1', null]));
+    });
+});
+//# sourceMappingURL=fingerprint.test.js.map