deep-link-expo 1.0.0

package/dist/linkforty-sdk.d.ts

@@ -0,0 +1,53 @@
+import type { LinkFortyConfig } from './models/config';
+import type { InstallAttributionResponse } from './models/install-response';
+import type { DeepLinkData } from './models/deep-link-data';
+import type { CreateLinkOptions } from './models/create-link-options';
+import type { CreateLinkResult } from './models/create-link-result';
+import type { DeferredDeepLinkCallback, DeepLinkCallback } from './deeplink/deep-link-handler';
+export declare class LinkFortySDK {
+    private config;
+    private networkManager;
+    private attributionManager;
+    private attributionContext;
+    private deepLinkHandler;
+    private eventTracker;
+    private navigationTracker;
+    private externalUserId;
+    private _isInitialized;
+    get isInitialized(): boolean;
+    initialize(config: LinkFortyConfig): Promise<InstallAttributionResponse>;
+    onDeferredDeepLink(callback: DeferredDeepLinkCallback): void;
+    onDeepLink(callback: DeepLinkCallback): void;
+    handleDeepLink(url: string): void;
+    /**
+     * Sets the external user ID for attribution. This ID will be attached to all
+     * links created via createLink() unless overridden per-call. Pass null to clear.
+     */
+    setExternalUserId(id: string | null): void;
+    /**
+     * Returns the current external user ID, if set.
+     */
+    getExternalUserId(): string | null;
+    trackEvent(name: string, properties?: Record<string, unknown>): Promise<void>;
+    trackRevenue(amount: number, currency: string, properties?: Record<string, unknown>): Promise<void>;
+    flushEvents(): Promise<void>;
+    clearEventQueue(): Promise<void>;
+    get queuedEventCount(): number;
+    createLink(options: CreateLinkOptions): Promise<CreateLinkResult>;
+    getInstallId(): Promise<string | null>;
+    getInstallData(): Promise<DeepLinkData | null>;
+    isFirstLaunch(): Promise<boolean>;
+    clearData(): Promise<void>;
+    reset(): void;
+    /**
+     * Current session id — identifies one app-open journey. Rotates on cold start
+     * and on each new deep-link open. Used to group a visit's screen-flow.
+     */
+    getSessionId(): string | null;
+    private requireInitialized;
+    private requireDeepLinkHandler;
+    private requireEventTracker;
+}
+declare const _default: LinkFortySDK;
+export default _default;
+//# sourceMappingURL=linkforty-sdk.d.ts.map

package/dist/linkforty-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkforty-sdk.d.ts","sourceRoot":"","sources":["../src/linkforty-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAc/F,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAS;IAE/B,IAAI,aAAa,IAAI,OAAO,CAE3B;IAIK,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAmH9E,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAI5D,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI5C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK1C;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAM5B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC;IAIV,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAIK,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6DjE,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,cAAc,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI9C,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAMjC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,KAAK,IAAI,IAAI;IAiBb;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,mBAAmB;CAM5B;;AAED,wBAAkC"}

package/dist/linkforty-sdk.js

@@ -0,0 +1,255 @@
+import { validateConfig } from './models/config';
+import { LinkFortyError } from './errors/linkforty-error';
+import { NetworkManager } from './network/network-manager';
+import { StorageManager } from './storage/storage-manager';
+import { FingerprintCollector } from './fingerprint/fingerprint-collector';
+import { AttributionManager } from './attribution/attribution-manager';
+import { AttributionContext } from './attribution/attribution-context';
+import { DeepLinkHandler } from './deeplink/deep-link-handler';
+import { EventTracker } from './events/event-tracker';
+import { EventQueue } from './events/event-queue';
+import { NavigationTracker } from './navigation/navigation-tracker';
+import { logger } from './logger';
+export class LinkFortySDK {
+    config = null;
+    networkManager = null;
+    attributionManager = null;
+    attributionContext = null;
+    deepLinkHandler = null;
+    eventTracker = null;
+    navigationTracker = null;
+    externalUserId = null;
+    _isInitialized = false;
+    get isInitialized() {
+        return this._isInitialized;
+    }
+    // -- Initialization --
+    async initialize(config) {
+        if (this._isInitialized) {
+            throw LinkFortyError.alreadyInitialized();
+        }
+        validateConfig(config);
+        this.config = config;
+        logger.setDebug(config.debug ?? false);
+        logger.log('Initializing SDK with config:', {
+            baseUrl: config.baseUrl,
+            debug: config.debug,
+            attributionWindowHours: config.attributionWindowHours,
+            linkPathPrefix: config.linkPathPrefix,
+            apiKey: config.apiKey ? '***' : undefined,
+        });
+        // Create managers
+        const networkManager = new NetworkManager(config.baseUrl, config.apiKey);
+        const storageManager = new StorageManager();
+        const fingerprintCollector = new FingerprintCollector();
+        const eventQueue = new EventQueue();
+        await eventQueue.load();
+        this.networkManager = networkManager;
+        this.attributionManager = new AttributionManager(networkManager, storageManager, fingerprintCollector);
+        // Last-click attribution context: restore any persisted active link before
+        // we attribute the install or handle deep links.
+        const attributionContext = new AttributionContext();
+        await attributionContext.load();
+        this.attributionContext = attributionContext;
+        this.eventTracker = new EventTracker(networkManager, storageManager, eventQueue, attributionContext);
+        const deepLinkHandler = new DeepLinkHandler(config.baseUrl, networkManager, fingerprintCollector, config.linkPathPrefix);
+        this.deepLinkHandler = deepLinkHandler;
+        // Record every direct (re-engagement) deep-link open into the attribution
+        // context so subsequent events credit the link the user just tapped — not
+        // their original install link. Registered before any developer callbacks.
+        deepLinkHandler.onDeepLink((_url, data) => {
+            if (data?.linkId) {
+                void attributionContext.recordDeepLinkOpen(data.linkId);
+            }
+        });
+        this._isInitialized = true;
+        // Report install
+        const attributionWindowHours = config.attributionWindowHours ?? 168;
+        const response = await this.attributionManager.reportInstall(attributionWindowHours, undefined, // deviceId — IDFA/GAID not collected by Expo SDK
+        config.appToken);
+        // If attributed, deliver deferred deep link + seed the attribution context so
+        // the new user's first-session events credit the install link.
+        if (response.attributed && response.deepLinkData) {
+            if (response.deepLinkData.linkId) {
+                await attributionContext.recordDeepLinkOpen(response.deepLinkData.linkId);
+            }
+            deepLinkHandler.deliverDeferredDeepLink(response.deepLinkData);
+        }
+        else {
+            deepLinkHandler.deliverDeferredDeepLink(null);
+        }
+        // Start listening for direct deep links
+        deepLinkHandler.startListening();
+        // Optional auto screen-view tracking. Screen views flow through trackEvent,
+        // so they inherit the attribution stamp. Guarded: a missing/invalid
+        // navigationRef (or no react-navigation) is a no-op.
+        if (config.autoTrackNavigation) {
+            if (config.navigationRef) {
+                const navOptions = typeof config.autoTrackNavigation === 'object' ? config.autoTrackNavigation : {};
+                this.navigationTracker = new NavigationTracker(config.navigationRef, (name, properties) => {
+                    void this.trackEvent(name, properties);
+                }, { captureParams: navOptions.captureParams, debounceMs: navOptions.debounceMs });
+                this.navigationTracker.start();
+            }
+            else {
+                logger.warn('autoTrackNavigation is enabled but no navigationRef was provided — screen tracking is disabled.');
+            }
+        }
+        logger.log('SDK initialized successfully (attributed:', response.attributed, ')');
+        return response;
+    }
+    // -- Deep Linking --
+    onDeferredDeepLink(callback) {
+        this.requireDeepLinkHandler().onDeferredDeepLink(callback);
+    }
+    onDeepLink(callback) {
+        this.requireDeepLinkHandler().onDeepLink(callback);
+    }
+    handleDeepLink(url) {
+        this.requireDeepLinkHandler().handleDeepLink(url);
+    }
+    // -- User Identity --
+    /**
+     * Sets the external user ID for attribution. This ID will be attached to all
+     * links created via createLink() unless overridden per-call. Pass null to clear.
+     */
+    setExternalUserId(id) {
+        this.externalUserId = id;
+        logger.log('External user ID set:', id);
+    }
+    /**
+     * Returns the current external user ID, if set.
+     */
+    getExternalUserId() {
+        return this.externalUserId;
+    }
+    // -- Event Tracking --
+    async trackEvent(name, properties) {
+        return this.requireEventTracker().trackEvent(name, properties);
+    }
+    async trackRevenue(amount, currency, properties) {
+        return this.requireEventTracker().trackRevenue(amount, currency, properties);
+    }
+    async flushEvents() {
+        return this.requireEventTracker().flushQueue();
+    }
+    async clearEventQueue() {
+        return this.requireEventTracker().clearQueue();
+    }
+    get queuedEventCount() {
+        return this.eventTracker?.queuedEventCount ?? 0;
+    }
+    // -- Link Creation --
+    async createLink(options) {
+        this.requireInitialized();
+        if (!this.config.apiKey) {
+            throw LinkFortyError.missingApiKey();
+        }
+        const body = {};
+        if (options.templateId)
+            body.templateId = options.templateId;
+        if (options.deepLinkParameters)
+            body.deepLinkParameters = options.deepLinkParameters;
+        if (options.title)
+            body.title = options.title;
+        if (options.description)
+            body.description = options.description;
+        if (options.customCode)
+            body.customCode = options.customCode;
+        if (options.utmParameters)
+            body.utmParameters = options.utmParameters;
+        if (options.webFallbackUrl)
+            body.webFallbackUrl = options.webFallbackUrl;
+        // Per-call externalUserId takes precedence, then fall back to SDK-level value
+        const resolvedUserId = options.externalUserId ?? this.externalUserId;
+        if (resolvedUserId)
+            body.externalUserId = resolvedUserId;
+        const useSimplifiedEndpoint = !options.templateId;
+        const endpoint = useSimplifiedEndpoint ? '/api/sdk/v1/links' : '/api/links';
+        const response = await this.networkManager.request(endpoint, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+        // SDK endpoint returns { url, shortCode, linkId, deduplicated? } directly
+        if (useSimplifiedEndpoint && response.url) {
+            return {
+                url: response.url,
+                shortCode: response.shortCode || response.short_code,
+                linkId: response.linkId || response.id,
+                deduplicated: response.deduplicated,
+            };
+        }
+        // Dashboard endpoint returns { id, short_code } — build URL from parts
+        const shortCode = response.short_code;
+        const baseUrl = this.config.baseUrl.replace(/\/+$/, '');
+        const prefix = (options.templateSlug || this.config.linkPathPrefix || '').replace(/^\/+|\/+$/g, '');
+        const url = prefix
+            ? `${baseUrl}/${prefix}/${shortCode}`
+            : `${baseUrl}/${shortCode}`;
+        return {
+            url,
+            shortCode,
+            linkId: response.id,
+        };
+    }
+    // -- Attribution Data --
+    async getInstallId() {
+        return this.attributionManager?.getInstallId() ?? null;
+    }
+    async getInstallData() {
+        return this.attributionManager?.getInstallData() ?? null;
+    }
+    async isFirstLaunch() {
+        return this.attributionManager?.isFirstLaunch() ?? true;
+    }
+    // -- Data Management --
+    async clearData() {
+        await this.attributionManager?.clearData();
+        await this.attributionContext?.clear();
+        await this.eventTracker?.clearQueue();
+        this.deepLinkHandler?.clearCallbacks();
+        this.externalUserId = null;
+        logger.log('All SDK data cleared');
+    }
+    reset() {
+        this.deepLinkHandler?.cleanup();
+        this.navigationTracker?.stop();
+        this.config = null;
+        this.networkManager = null;
+        this.attributionManager = null;
+        this.attributionContext = null;
+        this.deepLinkHandler = null;
+        this.eventTracker = null;
+        this.navigationTracker = null;
+        this.externalUserId = null;
+        this._isInitialized = false;
+        logger.log('SDK reset to uninitialized state');
+    }
+    // -- Attribution Session --
+    /**
+     * Current session id — identifies one app-open journey. Rotates on cold start
+     * and on each new deep-link open. Used to group a visit's screen-flow.
+     */
+    getSessionId() {
+        return this.attributionContext?.getSessionId() ?? null;
+    }
+    // -- Guards --
+    requireInitialized() {
+        if (!this._isInitialized) {
+            throw LinkFortyError.notInitialized();
+        }
+    }
+    requireDeepLinkHandler() {
+        if (!this._isInitialized || !this.deepLinkHandler) {
+            throw LinkFortyError.notInitialized();
+        }
+        return this.deepLinkHandler;
+    }
+    requireEventTracker() {
+        if (!this._isInitialized || !this.eventTracker) {
+            throw LinkFortyError.notInitialized();
+        }
+        return this.eventTracker;
+    }
+}
+export default new LinkFortySDK();

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    setDebug(enabled: boolean): void;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM;sBACC,OAAO,GAAG,IAAI;iBAInB,OAAO,EAAE,GAAG,IAAI;kBAMf,OAAO,EAAE,GAAG,IAAI;mBAIf,OAAO,EAAE,GAAG,IAAI;CAGhC,CAAC"}

package/dist/logger.js

@@ -0,0 +1,18 @@
+const TAG = '[LinkForty]';
+let debugEnabled = false;
+export const logger = {
+    setDebug(enabled) {
+        debugEnabled = enabled;
+    },
+    log(...args) {
+        if (debugEnabled) {
+            console.log(TAG, ...args);
+        }
+    },
+    warn(...args) {
+        console.warn(TAG, ...args);
+    },
+    error(...args) {
+        console.error(TAG, ...args);
+    },
+};

package/dist/models/attribution.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Last-click attribution models (SIT-237).
+ *
+ * In-app activity (screen views + custom events) is attributed to the deep link
+ * that drove it. Every deep-link open pins an active context; the newest open
+ * supersedes the previous one; events are stamped with the active context so the
+ * backend can credit the link under a last-click + window model.
+ */
+/** The deep link currently credited for in-app activity (last-click). */
+export interface ActiveAttribution {
+    /** The link the deep link resolved to (`DeepLinkData.linkId`) */
+    linkId: string;
+    /** Optional originating click id (link-level attribution works without it) */
+    clickId?: string;
+    /** ISO timestamp of when this deep link opened the app */
+    openedAt: string;
+}
+/**
+ * Attribution fields merged into every event payload. `sessionId` is always
+ * present; the link fields are absent for organic activity (no deep link yet).
+ */
+export interface AttributionStamp {
+    attributedLinkId?: string;
+    attributedClickId?: string;
+    linkOpenedAt?: string;
+    sessionId: string;
+}
+//# sourceMappingURL=attribution.d.ts.map

package/dist/models/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/models/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/models/attribution.js

@@ -0,0 +1,9 @@
+/**
+ * Last-click attribution models (SIT-237).
+ *
+ * In-app activity (screen views + custom events) is attributed to the deep link
+ * that drove it. Every deep-link open pins an active context; the newest open
+ * supersedes the previous one; events are stamped with the active context so the
+ * backend can credit the link under a last-click + window model.
+ */
+export {};

package/dist/models/config.d.ts

@@ -0,0 +1,72 @@
+export interface LinkFortyConfig {
+    /** Base URL of your LinkForty instance (e.g., 'https://go.yourdomain.com') */
+    baseUrl: string;
+    /**
+     * Per-app short-link path prefix (e.g. '/mQuDYblrf6'). Required when multiple
+     * apps share one domain so short codes resolve under this app's path.
+     */
+    linkPathPrefix?: string;
+    /** Optional API key for Cloud authentication */
+    apiKey?: string;
+    /**
+     * Public workspace token (LinkForty Cloud only). Recommended — required
+     * for organic installs (App Store discovery, social mentions, etc.) to
+     * be attributed to your workspace. Find it in the dashboard under
+     * Workspace Settings → App Token. Safe to ship in your app bundle.
+     * Format: `at_<32 hex chars>`.
+     */
+    appToken?: string;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Attribution window in hours (default: 168 = 7 days) */
+    attributionWindowHours?: number;
+    /**
+     * Auto-emit `screen_view` events from React Navigation state (no manual
+     * per-screen calls). Requires `navigationRef`. Off by default.
+     *
+     * Pass `true` for the privacy-safe default (screen name only, no params). To
+     * capture specific non-PII params, pass an options object with an explicit
+     * allow-list: `{ captureParams: ['productId', 'category'] }`. Screen views flow
+     * through the normal event pipeline and carry the active deep-link attribution
+     * context. Apps without react-navigation are unaffected.
+     */
+    autoTrackNavigation?: boolean | AutoTrackNavigationOptions;
+    /**
+     * The app's React Navigation container ref (`createNavigationContainerRef()`),
+     * required when `autoTrackNavigation` is enabled. Typed structurally so this
+     * SDK never has a compile-time dependency on `@react-navigation/native`.
+     */
+    navigationRef?: NavigationContainerRefLike;
+}
+/**
+ * Options for `autoTrackNavigation`. No route params are captured by default;
+ * opt in per key via `captureParams`.
+ */
+export interface AutoTrackNavigationOptions {
+    /**
+     * Explicit allow-list of route param keys whose primitive values may be
+     * captured on `screen_view`. Omitted/empty = capture no params. Never list
+     * keys that can hold personal data.
+     */
+    captureParams?: string[];
+    /** Debounce window for rapid transitions, in ms. Default 350. */
+    debounceMs?: number;
+}
+/**
+ * The slice of a React Navigation route the SDK reads. Structural — matches
+ * `getCurrentRoute()` without importing `@react-navigation/native`.
+ */
+export interface NavigationRouteLike {
+    name: string;
+    params?: Record<string, unknown>;
+}
+/** The slice of a React Navigation container ref the SDK uses. Structural. */
+export interface NavigationContainerRefLike {
+    addListener: (type: 'state', callback: (event?: unknown) => void) => (() => void) | {
+        remove?: () => void;
+    } | void;
+    getCurrentRoute: () => NavigationRouteLike | undefined;
+    isReady?: () => boolean;
+}
+export declare function validateConfig(config: LinkFortyConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/models/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/models/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,0BAA0B,CAAC;IAC3D;;;;OAIG;IACH,aAAa,CAAC,EAAE,0BAA0B,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,CACX,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,KAChC,CAAC,MAAM,IAAI,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,eAAe,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACzB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA6B5D"}

package/dist/models/config.js

@@ -0,0 +1,26 @@
+import { LinkFortyError } from '../errors/linkforty-error';
+const LOCALHOST_HOSTS = ['localhost', '127.0.0.1', '0.0.0.0', '10.0.2.2'];
+export function validateConfig(config) {
+    if (!config.baseUrl) {
+        throw LinkFortyError.invalidConfiguration('baseUrl is required');
+    }
+    // Parse URL to validate scheme
+    let parsed;
+    try {
+        parsed = new URL(config.baseUrl);
+    }
+    catch {
+        throw LinkFortyError.invalidConfiguration(`Invalid base URL: ${config.baseUrl}`);
+    }
+    // HTTPS required except for localhost
+    if (parsed.protocol !== 'https:' && !LOCALHOST_HOSTS.includes(parsed.hostname)) {
+        throw LinkFortyError.invalidConfiguration('Base URL must use HTTPS (HTTP only allowed for localhost)');
+    }
+    // Validate attribution window bounds
+    const windowHours = config.attributionWindowHours;
+    if (windowHours !== undefined) {
+        if (!Number.isFinite(windowHours) || windowHours < 1 || windowHours > 2160) {
+            throw LinkFortyError.invalidConfiguration('Attribution window must be between 1 and 2160 hours');
+        }
+    }
+}

package/dist/models/create-link-options.d.ts

@@ -0,0 +1,15 @@
+import type { UTMParameters } from './utm-parameters';
+export interface CreateLinkOptions {
+    templateId?: string;
+    templateSlug?: string;
+    deepLinkParameters?: Record<string, string>;
+    title?: string;
+    description?: string;
+    customCode?: string;
+    utmParameters?: UTMParameters;
+    /** Identifier for the app user creating the link (enables per-user deduplication and share attribution) */
+    externalUserId?: string;
+    /** Web fallback URL — used when the app is not installed or on desktop browsers */
+    webFallbackUrl?: string;
+}
+//# sourceMappingURL=create-link-options.d.ts.map

package/dist/models/create-link-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-link-options.d.ts","sourceRoot":"","sources":["../../src/models/create-link-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/models/create-link-options.js

@@ -0,0 +1 @@
+export {};

package/dist/models/create-link-result.d.ts

@@ -0,0 +1,8 @@
+export interface CreateLinkResult {
+    url: string;
+    shortCode: string;
+    linkId: string;
+    /** True if an existing link was returned instead of creating a new one (per-user deduplication) */
+    deduplicated?: boolean;
+}
+//# sourceMappingURL=create-link-result.d.ts.map

package/dist/models/create-link-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-link-result.d.ts","sourceRoot":"","sources":["../../src/models/create-link-result.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/models/create-link-result.js

@@ -0,0 +1 @@
+export {};

package/dist/models/deep-link-data.d.ts

@@ -0,0 +1,14 @@
+import type { UTMParameters } from './utm-parameters';
+export interface DeepLinkData {
+    shortCode: string;
+    iosUrl?: string;
+    androidUrl?: string;
+    webUrl?: string;
+    utmParameters?: UTMParameters;
+    customParameters?: Record<string, string>;
+    deepLinkPath?: string;
+    appScheme?: string;
+    clickedAt?: string;
+    linkId?: string;
+}
+//# sourceMappingURL=deep-link-data.d.ts.map

package/dist/models/deep-link-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-link-data.d.ts","sourceRoot":"","sources":["../../src/models/deep-link-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/models/deep-link-data.js

@@ -0,0 +1 @@
+export {};

package/dist/models/device-fingerprint.d.ts

@@ -0,0 +1,13 @@
+export interface DeviceFingerprint {
+    userAgent: string;
+    timezone: string;
+    language: string;
+    screenWidth: number;
+    screenHeight: number;
+    platform: string;
+    platformVersion: string;
+    appVersion: string;
+    deviceId?: string;
+    attributionWindowHours: number;
+}
+//# sourceMappingURL=device-fingerprint.d.ts.map

package/dist/models/device-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-fingerprint.d.ts","sourceRoot":"","sources":["../../src/models/device-fingerprint.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC"}

package/dist/models/device-fingerprint.js

@@ -0,0 +1 @@
+export {};

package/dist/models/event-request.d.ts

@@ -0,0 +1,13 @@
+export interface EventRequest {
+    installId: string;
+    eventName: string;
+    eventData: Record<string, unknown>;
+    timestamp: string;
+    attributedLinkId?: string;
+    attributedClickId?: string;
+    linkOpenedAt?: string;
+    sessionId?: string;
+    sdkName?: string;
+    sdkVersion?: string;
+}
+//# sourceMappingURL=event-request.d.ts.map

package/dist/models/event-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-request.d.ts","sourceRoot":"","sources":["../../src/models/event-request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAGlB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/models/event-request.js

@@ -0,0 +1 @@
+export {};

package/dist/models/install-response.d.ts

@@ -0,0 +1,9 @@
+import type { DeepLinkData } from './deep-link-data';
+export interface InstallAttributionResponse {
+    installId: string;
+    attributed: boolean;
+    confidenceScore: number;
+    matchedFactors: string[];
+    deepLinkData: DeepLinkData | null;
+}
+//# sourceMappingURL=install-response.d.ts.map

package/dist/models/install-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-response.d.ts","sourceRoot":"","sources":["../../src/models/install-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}

package/dist/models/install-response.js

@@ -0,0 +1 @@
+export {};

package/dist/models/utm-parameters.d.ts

@@ -0,0 +1,8 @@
+export interface UTMParameters {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+}
+//# sourceMappingURL=utm-parameters.d.ts.map

package/dist/models/utm-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm-parameters.d.ts","sourceRoot":"","sources":["../../src/models/utm-parameters.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/models/utm-parameters.js

@@ -0,0 +1 @@
+export {};