adsparkle-react-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Viralif
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,286 @@
+# adsparkle-react-native
+
+React Native client SDK for the Viralif / AdBird affiliate attribution platform.  
+Sends postback events to the tracking API and handles deep link click_id attribution.
+
+---
+
+## Installation
+
+```bash
+npm install adsparkle-react-native @react-native-async-storage/async-storage
+```
+
+For Expo managed workflow:
+
+```bash
+npx expo install adsparkle-react-native @react-native-async-storage/async-storage
+```
+
+> **Note:** `@react-native-async-storage/async-storage` is a required peer dependency.  
+> For bare React Native, follow the [AsyncStorage setup guide](https://react-native-async-storage.github.io/async-storage/docs/install/).
+
+---
+
+## Security note
+
+The SDK uses a **publishable company key** (`co_...` prefix).  
+This key is **safe to embed in your app binary** — it is not a secret.  
+No HMAC secret or private key is ever used or required.
+
+---
+
+## Quick start
+
+### 1. Configure (call once at app startup)
+
+```tsx
+// app/_layout.tsx or App.tsx
+import AdSparkle from 'adsparkle-react-native';
+
+AdSparkle.configure({
+  companyKey: 'co_your_key_here',
+  // baseUrl: 'https://api.viralif.co',  // default, no need to set
+  debug: __DEV__,
+});
+```
+
+`configure()` is async; it hydrates persisted state and flushes any events that
+failed in the previous session. You can await it if you need to guarantee
+completion before the first screen renders.
+
+### 2. Set user ID (after login/registration)
+
+```ts
+AdSparkle.setUserId('internal-user-id-123');
+```
+
+### 3. Handle deep links
+
+The SDK does **not** attach itself to `Linking` automatically.  
+You must call `handleDeepLink` from your own Linking wiring.
+
+#### Option A — manual wiring (recommended, full control)
+
+```tsx
+import { useEffect } from 'react';
+import { Linking } from 'react-native';
+import AdSparkle from 'adsparkle-react-native';
+
+export default function RootLayout() {
+  useEffect(() => {
+    // Cold start (app opened via deep link)
+    Linking.getInitialURL().then((url) => {
+      if (url) AdSparkle.handleDeepLink(url);
+    });
+
+    // Warm start / foreground
+    const subscription = Linking.addEventListener('url', ({ url }) => {
+      AdSparkle.handleDeepLink(url);
+    });
+
+    return () => subscription.remove();
+  }, []);
+
+  // ...
+}
+```
+
+#### Option B — attachLinking helper
+
+```tsx
+import { Linking } from 'react-native';
+import AdSparkle from 'adsparkle-react-native';
+
+// In your root component's useEffect:
+AdSparkle.attachLinking(Linking);
+
+// On unmount:
+AdSparkle.detachLinking();
+```
+
+#### Expo Router + expo-linking
+
+```tsx
+import * as Linking from 'expo-linking';
+import { useEffect } from 'react';
+import AdSparkle from 'adsparkle-react-native';
+
+export default function RootLayout() {
+  const url = Linking.useURL();
+
+  useEffect(() => {
+    if (url) AdSparkle.handleDeepLink(url);
+  }, [url]);
+
+  // ...
+}
+```
+
+The SDK looks for the `click_id` query parameter in the URL:
+
+```
+myapp://open?click_id=abc-123-uuid
+https://example.com/promo?click_id=abc-123-uuid&utm_source=viralif
+```
+
+Up to **10** unique click IDs are stored in a chain; duplicates are silently ignored.
+
+---
+
+## Tracking events
+
+### Generic track()
+
+```ts
+await AdSparkle.track('purchase', {
+  transactionId: 'txn_abc',
+  amount: 49.99,
+  currency: 'USD',
+  productIds: ['prod_1', 'prod_2'],
+  customParams: { plan: 'premium' },
+});
+```
+
+### Convenience methods
+
+```ts
+await AdSparkle.trackInstall();
+await AdSparkle.trackSignUp();
+await AdSparkle.trackLogin();
+await AdSparkle.trackDownload();
+
+await AdSparkle.trackPurchase({
+  transactionId: 'txn_abc',   // required
+  amount: 49.99,
+  currency: 'USD',
+});
+
+await AdSparkle.trackSubscription({
+  transactionId: 'sub_xyz',   // required
+  amount: 9.99,
+  currency: 'EUR',
+});
+
+await AdSparkle.trackRefund({
+  transactionId: 'txn_abc',   // required
+});
+```
+
+### Supported event types
+
+| Event type     | transactionId | amount / currency | Notes                        |
+|----------------|:-------------:|:-----------------:|------------------------------|
+| `install`      |               |                   | Fire on first app launch     |
+| `sign_up`      |               |                   | After successful registration|
+| `login`        |               |                   | After successful login       |
+| `download`     |               |                   | In-app content download      |
+| `purchase`     | required      | recommended       | One-time purchase            |
+| `subscription` | required      | recommended       | Recurring subscription start |
+| `refund`       | required      |                   | Order / subscription refund  |
+
+Only the event types listed above are accepted.  
+Derived or custom event type strings are rejected (no-op with a warning in debug mode).
+
+---
+
+## No-op behaviour
+
+`track()` is **always safe to call** — it never throws.
+
+- If `configure()` has not been called: warning logged, no network call.
+- If `userId` is not set: warning logged, no network call.
+- If `clickId` is not set: warning logged, no network call.
+
+Set `debug: true` in `configure()` to see all warnings in the console.
+
+---
+
+## Retry and offline queue
+
+- On **5xx** or **network error**: the SDK retries up to **3 times** with exponential
+  backoff starting at 500 ms.
+- If all retries fail, the event is persisted to an **AsyncStorage queue**.
+- The queue is flushed automatically on the next `configure()` call and before
+  every subsequent `track()` call.
+- **4xx** responses (bad request, auth failure) are **not** retried.
+
+---
+
+## API reference
+
+```ts
+// Setup
+AdSparkle.configure(config: AdSparkleConfig): Promise<void>
+
+// Identity
+AdSparkle.setUserId(userId: string): Promise<void>
+
+// Attribution
+AdSparkle.handleDeepLink(url: string): Promise<void>
+AdSparkle.setClickId(clickId: string): Promise<void>
+AdSparkle.getClickId(): string | null
+
+// Tracking
+AdSparkle.track(eventType: EventType, params?: TrackParams): Promise<void>
+AdSparkle.trackInstall(params?: TrackParams): Promise<void>
+AdSparkle.trackSignUp(params?: TrackParams): Promise<void>
+AdSparkle.trackLogin(params?: TrackParams): Promise<void>
+AdSparkle.trackDownload(params?: TrackParams): Promise<void>
+AdSparkle.trackPurchase(params: TrackParams & { transactionId: string }): Promise<void>
+AdSparkle.trackSubscription(params: TrackParams & { transactionId: string }): Promise<void>
+AdSparkle.trackRefund(params: TrackParams & { transactionId: string }): Promise<void>
+
+// Linking helpers (optional)
+AdSparkle.attachLinking(Linking: LinkingModule): Promise<void>
+AdSparkle.detachLinking(): void
+```
+
+### AdSparkleConfig
+
+| Property     | Type      | Required | Default                      |
+|--------------|-----------|:--------:|------------------------------|
+| `companyKey` | `string`  | yes      | —                            |
+| `baseUrl`    | `string`  | no       | `https://api.viralif.co`     |
+| `debug`      | `boolean` | no       | `false`                      |
+
+### TrackParams
+
+| Property       | Type                     | Notes                                 |
+|----------------|--------------------------|---------------------------------------|
+| `transactionId`| `string`                 | Required for purchase/subscription/refund |
+| `amount`       | `number`                 | Monetary amount                       |
+| `currency`     | `string`                 | ISO 4217 (e.g. `"USD"`)               |
+| `productIds`   | `string[]`               | Product identifiers                   |
+| `customParams` | `Record<string, string>` | Arbitrary metadata                    |
+
+---
+
+## Postback endpoint (reference)
+
+```
+POST {baseUrl}/api/tracking/postback
+Headers:
+  Content-Type: application/json
+  X-Company-Key: co_...
+Body:
+  click_id        string    (required)
+  click_ids       string[]  (optional, stored chain)
+  event_type      string    (required, see table above)
+  user_id         string    (required)
+  transaction_id  string    (required for purchase/subscription/refund)
+  amount          number    (optional)
+  currency        string    (optional)
+  product_ids     string[]  (optional)
+  custom_params   object    (optional)
+```
+
+HTTP 200 = received (processing is asynchronous on the server).  
+HTTP 5xx = retry.  
+HTTP 4xx = permanent failure, do not retry.
+
+---
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import type { PostbackPayload } from './types';
+export interface ClientConfig {
+    companyKey: string;
+    baseUrl?: string;
+    debug?: boolean;
+}
+export interface SendResult {
+    success: boolean;
+    queued: boolean;
+}
+export declare function setDebug(enabled: boolean): void;
+/**
+ * Attempts to POST a payload to the postback endpoint up to MAX_RETRIES times
+ * with exponential backoff. Returns true on success, false after all retries fail.
+ */
+export declare function sendWithRetry(payload: PostbackPayload, config: ClientConfig): Promise<boolean>;
+/**
+ * Sends a postback event. If all retries fail, the event is persisted to the
+ * pending queue so it can be flushed on the next SDK activity.
+ *
+ * This function is designed to be fire-and-forget from the caller's perspective:
+ * it resolves quickly and does retry work in the background, but still returns
+ * a Promise so callers can await it if they care about the final outcome.
+ */
+export declare function sendEvent(payload: PostbackPayload, config: ClientConfig): Promise<SendResult>;
+/**
+ * Drains the persisted pending queue. Called automatically on configure()
+ * and before each new track() call.
+ */
+export declare function flushPendingQueue(config: ClientConfig): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAgB7D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAkBD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,OAAO,CAAC,CA8ClB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB3E"}

package/dist/client.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDebug = setDebug;
+exports.sendWithRetry = sendWithRetry;
+exports.sendEvent = sendEvent;
+exports.flushPendingQueue = flushPendingQueue;
+const storage_1 = require("./storage");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_BASE_URL = 'https://api.viralif.co';
+const POSTBACK_PATH = '/api/tracking/postback';
+const MAX_RETRIES = 3;
+const INITIAL_BACKOFF_MS = 500;
+// ---------------------------------------------------------------------------
+// Logging
+// ---------------------------------------------------------------------------
+let _debug = false;
+function setDebug(enabled) {
+    _debug = enabled;
+}
+function log(...args) {
+    if (_debug)
+        console.log('[AdSparkle]', ...args);
+}
+function warn(...args) {
+    if (_debug)
+        console.warn('[AdSparkle]', ...args);
+}
+// ---------------------------------------------------------------------------
+// Core send with retry
+// ---------------------------------------------------------------------------
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Attempts to POST a payload to the postback endpoint up to MAX_RETRIES times
+ * with exponential backoff. Returns true on success, false after all retries fail.
+ */
+async function sendWithRetry(payload, config) {
+    var _a;
+    const url = `${(_a = config.baseUrl) !== null && _a !== void 0 ? _a : DEFAULT_BASE_URL}${POSTBACK_PATH}`;
+    const headers = {
+        'Content-Type': 'application/json',
+        'X-Company-Key': config.companyKey,
+    };
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            log(`Sending event "${payload.event_type}" (attempt ${attempt}/${MAX_RETRIES})`);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+            });
+            if (response.ok) {
+                log(`Event "${payload.event_type}" accepted (HTTP ${response.status})`);
+                return true;
+            }
+            // 4xx errors are not retryable (bad request, auth failure, etc.)
+            if (response.status >= 400 && response.status < 500) {
+                warn(`Event "${payload.event_type}" rejected with HTTP ${response.status} — not retrying`);
+                return false;
+            }
+            // 5xx — retryable
+            warn(`HTTP ${response.status} on attempt ${attempt}, will retry if attempts remain`);
+        }
+        catch (err) {
+            // Network error — retryable
+            warn(`Network error on attempt ${attempt}:`, err);
+        }
+        if (attempt < MAX_RETRIES) {
+            const backoff = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+            log(`Backing off ${backoff}ms before retry`);
+            await sleep(backoff);
+        }
+    }
+    warn(`All ${MAX_RETRIES} attempts failed for event "${payload.event_type}"`);
+    return false;
+}
+/**
+ * Sends a postback event. If all retries fail, the event is persisted to the
+ * pending queue so it can be flushed on the next SDK activity.
+ *
+ * This function is designed to be fire-and-forget from the caller's perspective:
+ * it resolves quickly and does retry work in the background, but still returns
+ * a Promise so callers can await it if they care about the final outcome.
+ */
+async function sendEvent(payload, config) {
+    const success = await sendWithRetry(payload, config);
+    if (!success) {
+        const pending = { payload, enqueuedAt: Date.now() };
+        await (0, storage_1.appendToPendingQueue)(pending);
+        log(`Event "${payload.event_type}" queued for later retry`);
+        return { success: false, queued: true };
+    }
+    return { success: true, queued: false };
+}
+/**
+ * Drains the persisted pending queue. Called automatically on configure()
+ * and before each new track() call.
+ */
+async function flushPendingQueue(config) {
+    let queue = await (0, storage_1.loadPendingQueue)();
+    if (queue.length === 0)
+        return;
+    log(`Flushing ${queue.length} pending event(s)`);
+    const remaining = [];
+    for (const item of queue) {
+        const success = await sendWithRetry(item.payload, config);
+        if (!success) {
+            remaining.push(item);
+        }
+    }
+    await (0, storage_1.savePendingQueue)(remaining);
+    if (remaining.length > 0) {
+        warn(`${remaining.length} event(s) still pending after flush`);
+    }
+    else {
+        log('Pending queue fully flushed');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/deeplink.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Deep link utilities for extracting click_id from inbound URLs.
+ *
+ * The SDK does NOT automatically attach itself to React Native's Linking module.
+ * The host app is responsible for calling AdSparkle.handleDeepLink(url) from
+ * both Linking.getInitialURL() and the Linking 'url' event listener.
+ * See README for a ready-to-paste integration example.
+ */
+/**
+ * Extracts the `click_id` query parameter from a URL string.
+ * Returns null if the URL is invalid or the parameter is missing/empty.
+ *
+ * Handles all common RN deep link schemes:
+ *   myapp://launch?click_id=abc123
+ *   https://example.com/promo?click_id=abc123&utm_source=viralif
+ */
+export declare function extractClickId(url: string): string | null;
+//# sourceMappingURL=deeplink.d.ts.map

package/dist/deeplink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deeplink.d.ts","sourceRoot":"","sources":["../src/deeplink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4BzD"}

package/dist/deeplink.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Deep link utilities for extracting click_id from inbound URLs.
+ *
+ * The SDK does NOT automatically attach itself to React Native's Linking module.
+ * The host app is responsible for calling AdSparkle.handleDeepLink(url) from
+ * both Linking.getInitialURL() and the Linking 'url' event listener.
+ * See README for a ready-to-paste integration example.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractClickId = extractClickId;
+const CLICK_ID_PARAM = 'click_id';
+/**
+ * Canonical UUID v4-ish format (case-insensitive), matching adsparkle.js UUID_RE.
+ * click_ids that don't match are treated as invalid and ignored.
+ */
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Extracts the `click_id` query parameter from a URL string.
+ * Returns null if the URL is invalid or the parameter is missing/empty.
+ *
+ * Handles all common RN deep link schemes:
+ *   myapp://launch?click_id=abc123
+ *   https://example.com/promo?click_id=abc123&utm_source=viralif
+ */
+function extractClickId(url) {
+    if (!url || typeof url !== 'string')
+        return null;
+    try {
+        // URL() is available in React Native >= 0.63 (Hermes / JSC both support it).
+        // For older RN, we fall back to a manual query-string parser.
+        let searchString;
+        try {
+            const parsed = new URL(url);
+            searchString = parsed.search;
+        }
+        catch (_a) {
+            // Manual fallback: grab everything after '?'
+            const qIdx = url.indexOf('?');
+            if (qIdx === -1)
+                return null;
+            searchString = url.slice(qIdx);
+        }
+        const params = parseQueryString(searchString);
+        const value = params[CLICK_ID_PARAM];
+        const trimmed = value && value.trim() !== '' ? value.trim() : null;
+        // Reject anything that isn't a well-formed UUID (parity with adsparkle.js).
+        if (!trimmed || !UUID_RE.test(trimmed))
+            return null;
+        return trimmed;
+    }
+    catch (_b) {
+        // Any unexpected error — silently return null.
+        return null;
+    }
+}
+/**
+ * Minimal query-string parser that does NOT rely on URLSearchParams
+ * (not universally available in all RN environments).
+ */
+function parseQueryString(search) {
+    const result = {};
+    const qs = search.startsWith('?') ? search.slice(1) : search;
+    if (!qs)
+        return result;
+    for (const pair of qs.split('&')) {
+        const eqIdx = pair.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = safeDecodeURIComponent(pair.slice(0, eqIdx));
+        const val = safeDecodeURIComponent(pair.slice(eqIdx + 1));
+        if (key)
+            result[key] = val;
+    }
+    return result;
+}
+function safeDecodeURIComponent(str) {
+    try {
+        return decodeURIComponent(str.replace(/\+/g, ' '));
+    }
+    catch (_a) {
+        return str;
+    }
+}
+//# sourceMappingURL=deeplink.js.map

package/dist/deeplink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deeplink.js","sourceRoot":"","sources":["../src/deeplink.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAkBH,wCA4BC;AA5CD,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjD,IAAI,CAAC;QACH,6EAA6E;QAC7E,8DAA8D;QAC9D,IAAI,YAAoB,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,CAAC;QAAC,WAAM,CAAC;YACP,6CAA6C;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,IAAI,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7B,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,4EAA4E;QAC5E,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,WAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7D,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * adsparkle-react-native
+ * Viralif / AdBird affiliate attribution SDK for React Native.
+ *
+ * Usage:
+ *   import AdSparkle from 'adsparkle-react-native';
+ *   AdSparkle.configure({ companyKey: 'co_...' });
+ */
+import type { AdSparkleConfig, EventType, TrackParams, PendingEvent } from './types';
+export type { AdSparkleConfig, EventType, TrackParams, PendingEvent };
+/**
+ * Initialises the SDK. Must be called before any tracking.
+ * Hydrates state from AsyncStorage and flushes any pending events.
+ */
+declare function configure(config: AdSparkleConfig): Promise<void>;
+/**
+ * Sets the merchant's internal user identifier.
+ * Persists to storage so it survives app restarts.
+ */
+declare function setUserId(userId: string): Promise<void>;
+/**
+ * Parses a deep link URL, extracts the click_id query parameter, and
+ * adds it to the persisted chain (max 10, no duplicates).
+ *
+ * Call this from both Linking.getInitialURL() and the Linking event listener.
+ * The SDK does NOT attach itself to Linking automatically.
+ */
+declare function handleDeepLink(url: string): Promise<void>;
+/**
+ * Manually sets a click_id (e.g. when received via a custom channel).
+ * Adds to the chain with the same deduplication/cap logic as handleDeepLink.
+ */
+declare function setClickId(clickId: string): Promise<void>;
+/**
+ * Returns the most recently captured click_id, or null if none is set.
+ */
+declare function getClickId(): string | null;
+/**
+ * Core tracking method. Sends an event to the postback endpoint.
+ *
+ * - No-op (with optional debug warning) if clickId or userId is not set.
+ * - Retries on 5xx / network failure (up to 3 times with exponential backoff).
+ * - Falls back to persisted queue if all retries fail.
+ * - Automatically flushes previously queued events before sending.
+ *
+ * @returns A Promise that resolves once the send attempt (or queue) is complete.
+ */
+declare function track(eventType: EventType, params?: TrackParams): Promise<void>;
+declare function trackInstall(params?: TrackParams): Promise<void>;
+declare function trackSignUp(params?: TrackParams): Promise<void>;
+declare function trackLogin(params?: TrackParams): Promise<void>;
+declare function trackDownload(params?: TrackParams): Promise<void>;
+declare function trackPurchase(params?: Omit<TrackParams, 'transactionId'> & {
+    transactionId: string;
+}): Promise<void>;
+declare function trackSubscription(params?: Omit<TrackParams, 'transactionId'> & {
+    transactionId: string;
+}): Promise<void>;
+declare function trackRefund(params?: Omit<TrackParams, 'transactionId'> & {
+    transactionId: string;
+}): Promise<void>;
+/**
+ * Bir store satın alma objesinden otomatik `purchase` event'i gönderir.
+ * `productIds` ve `transactionId` store objesinden KENDİLİĞİNDEN çıkarılır;
+ * merchant SKU'yu elle yazmak zorunda kalmaz. Adjust'ın StoreKit/Play Billing'den
+ * ürün okumasının React Native karşılığıdır. `amount`/`currency` store objesinde
+ * bulunmadığı için yüzde komisyonlu event'lerde params ile geçilmelidir.
+ */
+declare function trackPurchaseFromStore(purchase: unknown, params?: Omit<TrackParams, 'productIds'>): Promise<void>;
+interface LinkingModule {
+    getInitialURL(): Promise<string | null>;
+    addEventListener(event: string, handler: (event: {
+        url: string;
+    }) => void): {
+        remove(): void;
+    };
+}
+/**
+ * Optional convenience helper that automatically wires the SDK to React Native's
+ * Linking module. Call once at app startup (e.g. in your root _layout.tsx).
+ *
+ * You must pass the Linking module explicitly to keep this package free of a
+ * hard dependency on react-native:
+ *
+ *   import { Linking } from 'react-native';
+ *   AdSparkle.attachLinking(Linking);
+ *
+ * Call AdSparkle.detachLinking() to remove the listener (e.g. on unmount).
+ */
+declare function attachLinking(Linking: LinkingModule): Promise<void>;
+declare function detachLinking(): void;
+declare const AdSparkle: {
+    readonly configure: typeof configure;
+    readonly setUserId: typeof setUserId;
+    readonly handleDeepLink: typeof handleDeepLink;
+    readonly setClickId: typeof setClickId;
+    readonly getClickId: typeof getClickId;
+    readonly track: typeof track;
+    readonly trackInstall: typeof trackInstall;
+    readonly trackSignUp: typeof trackSignUp;
+    readonly trackLogin: typeof trackLogin;
+    readonly trackDownload: typeof trackDownload;
+    readonly trackPurchase: typeof trackPurchase;
+    readonly trackSubscription: typeof trackSubscription;
+    readonly trackRefund: typeof trackRefund;
+    readonly trackPurchaseFromStore: typeof trackPurchaseFromStore;
+    readonly attachLinking: typeof attachLinking;
+    readonly detachLinking: typeof detachLinking;
+};
+export default AdSparkle;
+//# 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":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EAET,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAsHtE;;;GAGG;AACH,iBAAe,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B/D;AAED;;;GAGG;AACH,iBAAe,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtD;AAWD;;;;;;GAMG;AACH,iBAAe,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxD;AAED;;;GAGG;AACH,iBAAe,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxD;AAED;;GAEG;AACH,iBAAS,UAAU,IAAI,MAAM,GAAG,IAAI,CAEnC;AAED;;;;;;;;;GASG;AACH,iBAAe,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ClF;AAMD,iBAAe,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,iBAAe,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,iBAAe,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED,iBAAe,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED,iBAAe,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnH;AAED,iBAAe,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvH;AAED,iBAAe,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjH;AAwBD;;;;;;GAMG;AACH,iBAAe,sBAAsB,CACnC,QAAQ,EAAE,OAAO,EACjB,MAAM,GAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAM,GAC3C,OAAO,CAAC,IAAI,CAAC,CAQf;AAMD,UAAU,aAAa;IACrB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CAChG;AAID;;;;;;;;;;;GAWG;AACH,iBAAe,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAalE;AAED,iBAAS,aAAa,IAAI,IAAI,CAM7B;AAMD,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;CAiBL,CAAC;AAEX,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * adsparkle-react-native
+ * Viralif / AdBird affiliate attribution SDK for React Native.
+ *
+ * Usage:
+ *   import AdSparkle from 'adsparkle-react-native';
+ *   AdSparkle.configure({ companyKey: 'co_...' });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const deeplink_1 = require("./deeplink");
+const client_1 = require("./client");
+const storage_1 = require("./storage");
+const types_1 = require("./types");
+const DEFAULT_BASE_URL = 'https://api.viralif.co';
+// Parity with adsparkle.js (MAX_CHAIN_SIZE = 50).
+const MAX_CLICK_ID_CHAIN = 50;
+// 7-day sliding attribution window (ATTRIBUTION_WINDOW_DAYS) in milliseconds.
+const CHAIN_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+// Canonical UUID format (case-insensitive), matching adsparkle.js UUID_RE.
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const state = {
+    companyKey: null,
+    baseUrl: DEFAULT_BASE_URL,
+    debug: false,
+    userId: null,
+    clickId: null,
+    clickIds: [],
+    clickIdsUpdatedAt: 0,
+};
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function isConfigured() {
+    return state.companyKey !== null;
+}
+function clientConfig() {
+    return {
+        companyKey: state.companyKey,
+        baseUrl: state.baseUrl,
+        debug: state.debug,
+    };
+}
+function log(...args) {
+    if (state.debug)
+        console.log('[AdSparkle]', ...args);
+}
+function warn(...args) {
+    if (state.debug)
+        console.warn('[AdSparkle]', ...args);
+}
+/**
+ * Enforces the 7-day sliding window on the in-memory chain. If the chain has not
+ * been updated within CHAIN_TTL_MS, it is considered expired: clickIds/clickId
+ * are cleared and the cleared state is persisted. Returns true if it expired.
+ */
+async function expireChainIfStale() {
+    if (state.clickIds.length === 0)
+        return false;
+    if (Date.now() - state.clickIdsUpdatedAt <= CHAIN_TTL_MS)
+        return false;
+    log('click_id chain expired (>7d since last update) — clearing');
+    state.clickIds = [];
+    state.clickId = null;
+    const current = await (0, storage_1.loadState)();
+    await (0, storage_1.saveState)(Object.assign(Object.assign({}, current), { clickId: undefined, clickIds: [] }));
+    return true;
+}
+/**
+ * Adds a click_id to the chain. Mirrors adsparkle.js addClickId:
+ *   - validates UUID format (silently ignores invalid values)
+ *   - move-to-front recency: if already present, removes the old position and
+ *     re-appends so it becomes the most-recent entry
+ *   - caps at MAX_CLICK_ID_CHAIN (keep the most recent 50)
+ *   - refreshes the sliding-window timestamp on every add
+ * Persists the updated chain to storage.
+ */
+async function addToClickIdChain(clickId) {
+    if (!UUID_RE.test(clickId)) {
+        log(`click_id "${clickId}" is not a valid UUID, ignoring`);
+        return;
+    }
+    // Move-to-front (recency): drop any existing occurrence, then append.
+    const next = state.clickIds.filter((id) => id !== clickId);
+    next.push(clickId);
+    state.clickId = clickId;
+    state.clickIds = next.slice(-MAX_CLICK_ID_CHAIN);
+    state.clickIdsUpdatedAt = Date.now();
+    const current = await (0, storage_1.loadState)();
+    await (0, storage_1.saveState)(Object.assign(Object.assign({}, current), { clickId: state.clickId, clickIds: state.clickIds, clickIdsUpdatedAt: state.clickIdsUpdatedAt }));
+    log(`click_id set to "${clickId}" (chain length: ${state.clickIds.length})`);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Initialises the SDK. Must be called before any tracking.
+ * Hydrates state from AsyncStorage and flushes any pending events.
+ */
+async function configure(config) {
+    var _a, _b, _c;
+    state.companyKey = config.companyKey;
+    state.baseUrl = (_a = config.baseUrl) !== null && _a !== void 0 ? _a : DEFAULT_BASE_URL;
+    state.debug = (_b = config.debug) !== null && _b !== void 0 ? _b : false;
+    (0, client_1.setDebug)(state.debug);
+    log('Configuring SDK', { companyKey: config.companyKey, baseUrl: state.baseUrl });
+    // Hydrate from storage
+    const persisted = await (0, storage_1.loadState)();
+    if (persisted.userId && !state.userId)
+        state.userId = persisted.userId;
+    if (persisted.clickId)
+        state.clickId = persisted.clickId;
+    if (persisted.clickIds)
+        state.clickIds = persisted.clickIds;
+    if (persisted.clickIdsUpdatedAt)
+        state.clickIdsUpdatedAt = persisted.clickIdsUpdatedAt;
+    // Enforce the 7-day sliding window on the hydrated chain.
+    await expireChainIfStale();
+    // Persist latest config values
+    await (0, storage_1.saveState)(Object.assign(Object.assign({}, persisted), { companyKey: state.companyKey, baseUrl: state.baseUrl, clickId: (_c = state.clickId) !== null && _c !== void 0 ? _c : undefined, clickIds: state.clickIds }));
+    // Flush any events that failed in a previous session
+    await (0, client_1.flushPendingQueue)(clientConfig());
+}
+/**
+ * Sets the merchant's internal user identifier.
+ * Persists to storage so it survives app restarts.
+ */
+async function setUserId(userId) {
+    state.userId = userId;
+    const current = await (0, storage_1.loadState)();
+    await (0, storage_1.saveState)(Object.assign(Object.assign({}, current), { userId }));
+    log(`userId set to "${userId}"`);
+}
+/**
+ * Browser SDK (adsparkle.js) paritesi: merchant userId vermediğinde kalıcı bir
+ * anonim oturum kimliği üretir. Böylece aynı cihazdaki tekrar conversion'lar
+ * yine de tek bir kullanıcıya eşlenebilir ve userId çağrısı opsiyonel kalır.
+ */
+function generateAnonId() {
+    return `anon_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Parses a deep link URL, extracts the click_id query parameter, and
+ * adds it to the persisted chain (max 10, no duplicates).
+ *
+ * Call this from both Linking.getInitialURL() and the Linking event listener.
+ * The SDK does NOT attach itself to Linking automatically.
+ */
+async function handleDeepLink(url) {
+    const clickId = (0, deeplink_1.extractClickId)(url);
+    if (!clickId) {
+        log(`No click_id found in URL: ${url}`);
+        return;
+    }
+    await addToClickIdChain(clickId);
+}
+/**
+ * Manually sets a click_id (e.g. when received via a custom channel).
+ * Adds to the chain with the same deduplication/cap logic as handleDeepLink.
+ */
+async function setClickId(clickId) {
+    if (!clickId || typeof clickId !== 'string' || clickId.trim() === '') {
+        warn('setClickId called with empty value — ignoring');
+        return;
+    }
+    await addToClickIdChain(clickId.trim());
+}
+/**
+ * Returns the most recently captured click_id, or null if none is set.
+ */
+function getClickId() {
+    return state.clickId;
+}
+/**
+ * Core tracking method. Sends an event to the postback endpoint.
+ *
+ * - No-op (with optional debug warning) if clickId or userId is not set.
+ * - Retries on 5xx / network failure (up to 3 times with exponential backoff).
+ * - Falls back to persisted queue if all retries fail.
+ * - Automatically flushes previously queued events before sending.
+ *
+ * @returns A Promise that resolves once the send attempt (or queue) is complete.
+ */
+async function track(eventType, params = {}) {
+    if (!isConfigured()) {
+        warn('track() called before configure() — ignoring');
+        return;
+    }
+    if (!types_1.VALID_EVENT_TYPES.includes(eventType)) {
+        warn(`Unknown event type "${eventType}" — ignoring. Valid types: ${types_1.VALID_EVENT_TYPES.join(', ')}`);
+        return;
+    }
+    // Drop the chain if the 7-day sliding window has elapsed since the last update.
+    await expireChainIfStale();
+    if (!state.clickId) {
+        warn(`track("${eventType}") called without a click_id — ignoring (no-op)`);
+        return;
+    }
+    // Browser SDK paritesi: userId verilmediyse kalıcı bir anonim kimlik üret
+    // ve sakla — conversion düşürülmez (eski davranış no-op idi).
+    let userId = state.userId;
+    if (!userId) {
+        userId = generateAnonId();
+        await setUserId(userId);
+    }
+    // Flush leftover queue before sending new event
+    await (0, client_1.flushPendingQueue)(clientConfig());
+    const payload = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ click_id: state.clickId, click_ids: state.clickIds.length > 0 ? state.clickIds : undefined, event_type: eventType, user_id: userId }, (params.transactionId !== undefined && { transaction_id: params.transactionId })), (params.amount !== undefined && { amount: params.amount })), (params.currency !== undefined && { currency: params.currency })), (params.productIds !== undefined && { product_ids: params.productIds })), (params.customParams !== undefined && { custom_params: params.customParams }));
+    log(`Tracking event "${eventType}"`, payload);
+    await (0, client_1.sendEvent)(payload, clientConfig());
+}
+// ---------------------------------------------------------------------------
+// Convenience wrappers
+// ---------------------------------------------------------------------------
+async function trackInstall(params) {
+    return track('install', params);
+}
+async function trackSignUp(params) {
+    return track('sign_up', params);
+}
+async function trackLogin(params) {
+    return track('login', params);
+}
+async function trackDownload(params) {
+    return track('download', params);
+}
+async function trackPurchase(params) {
+    return track('purchase', params);
+}
+async function trackSubscription(params) {
+    return track('subscription', params);
+}
+async function trackRefund(params) {
+    return track('refund', params);
+}
+// ---------------------------------------------------------------------------
+// Adjust-style otomatik ürün yakalama (store satın alma objesinden)
+// ---------------------------------------------------------------------------
+/**
+ * react-native-iap / expo-in-app-purchases gibi kütüphanelerin döndürdüğü satın
+ * alma objesinden ürün kimliklerini çıkarır. Hiçbir kütüphaneye bağımlılık yok:
+ * alanlar duck-typing ile okunur (iOS: `productId`, Android: `productIds`/`skus`).
+ */
+function extractStoreProductIds(purchase) {
+    if (!purchase || typeof purchase !== 'object')
+        return [];
+    if (Array.isArray(purchase.productIds))
+        return purchase.productIds.map(String);
+    if (Array.isArray(purchase.skus))
+        return purchase.skus.map(String);
+    if (purchase.productId != null)
+        return [String(purchase.productId)];
+    return [];
+}
+function extractStoreTransactionId(purchase) {
+    var _a, _b;
+    const id = (_b = (_a = purchase === null || purchase === void 0 ? void 0 : purchase.transactionId) !== null && _a !== void 0 ? _a : purchase === null || purchase === void 0 ? void 0 : purchase.orderId) !== null && _b !== void 0 ? _b : purchase === null || purchase === void 0 ? void 0 : purchase.purchaseToken;
+    return id != null ? String(id) : undefined;
+}
+/**
+ * Bir store satın alma objesinden otomatik `purchase` event'i gönderir.
+ * `productIds` ve `transactionId` store objesinden KENDİLİĞİNDEN çıkarılır;
+ * merchant SKU'yu elle yazmak zorunda kalmaz. Adjust'ın StoreKit/Play Billing'den
+ * ürün okumasının React Native karşılığıdır. `amount`/`currency` store objesinde
+ * bulunmadığı için yüzde komisyonlu event'lerde params ile geçilmelidir.
+ */
+async function trackPurchaseFromStore(purchase, params = {}) {
+    var _a;
+    const productIds = extractStoreProductIds(purchase);
+    const transactionId = (_a = params.transactionId) !== null && _a !== void 0 ? _a : extractStoreTransactionId(purchase);
+    return track('purchase', Object.assign(Object.assign(Object.assign({}, params), (transactionId !== undefined && { transactionId })), (productIds.length > 0 && { productIds })));
+}
+let linkingSubscription = null;
+/**
+ * Optional convenience helper that automatically wires the SDK to React Native's
+ * Linking module. Call once at app startup (e.g. in your root _layout.tsx).
+ *
+ * You must pass the Linking module explicitly to keep this package free of a
+ * hard dependency on react-native:
+ *
+ *   import { Linking } from 'react-native';
+ *   AdSparkle.attachLinking(Linking);
+ *
+ * Call AdSparkle.detachLinking() to remove the listener (e.g. on unmount).
+ */
+async function attachLinking(Linking) {
+    // Handle cold-start deep link
+    const initialUrl = await Linking.getInitialURL();
+    if (initialUrl) {
+        await handleDeepLink(initialUrl);
+    }
+    // Handle warm-start / foreground deep links
+    linkingSubscription = Linking.addEventListener('url', async (event) => {
+        await handleDeepLink(event.url);
+    });
+    log('Linking attached');
+}
+function detachLinking() {
+    if (linkingSubscription) {
+        linkingSubscription.remove();
+        linkingSubscription = null;
+        log('Linking detached');
+    }
+}
+// ---------------------------------------------------------------------------
+// Default export — singleton object
+// ---------------------------------------------------------------------------
+const AdSparkle = {
+    configure,
+    setUserId,
+    handleDeepLink,
+    setClickId,
+    getClickId,
+    track,
+    trackInstall,
+    trackSignUp,
+    trackLogin,
+    trackDownload,
+    trackPurchase,
+    trackSubscription,
+    trackRefund,
+    trackPurchaseFromStore,
+    attachLinking,
+    detachLinking,
+};
+exports.default = AdSparkle;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,8 @@
+import type { PersistedState, PendingEvent } from './types';
+export declare function loadState(): Promise<PersistedState>;
+export declare function saveState(state: PersistedState): Promise<void>;
+export declare function loadPendingQueue(): Promise<PendingEvent[]>;
+export declare function savePendingQueue(queue: PendingEvent[]): Promise<void>;
+export declare function appendToPendingQueue(event: PendingEvent): Promise<void>;
+export declare function clearPendingQueue(): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+C5D,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAQzD;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGhE;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvD"}

package/dist/storage.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadState = loadState;
+exports.saveState = saveState;
+exports.loadPendingQueue = loadPendingQueue;
+exports.savePendingQueue = savePendingQueue;
+exports.appendToPendingQueue = appendToPendingQueue;
+exports.clearPendingQueue = clearPendingQueue;
+const STORAGE_KEY = '@adsparkle/state';
+// Max number of events kept in the offline retry queue. When the queue exceeds
+// this, the oldest event is dropped (FIFO) — mirrors adsparkle.js MAX_QUEUE_SIZE.
+const MAX_QUEUE_SIZE = 100;
+function resolveAsyncStorage() {
+    var _a, _b;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require('@react-native-async-storage/async-storage');
+        return (_b = (_a = mod === null || mod === void 0 ? void 0 : mod.default) !== null && _a !== void 0 ? _a : mod) !== null && _b !== void 0 ? _b : null;
+    }
+    catch (_c) {
+        return null;
+    }
+}
+// In-memory fallback (used when AsyncStorage is unavailable, e.g. in Jest).
+const memoryStore = {};
+const inMemoryStorage = {
+    getItem: (key) => { var _a; return Promise.resolve((_a = memoryStore[key]) !== null && _a !== void 0 ? _a : null); },
+    setItem: (key, value) => {
+        memoryStore[key] = value;
+        return Promise.resolve();
+    },
+};
+function getStorage() {
+    var _a;
+    return (_a = resolveAsyncStorage()) !== null && _a !== void 0 ? _a : inMemoryStorage;
+}
+// ---------------------------------------------------------------------------
+// Public helpers
+// ---------------------------------------------------------------------------
+async function loadState() {
+    try {
+        const raw = await getStorage().getItem(STORAGE_KEY);
+        if (!raw)
+            return {};
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return {};
+    }
+}
+async function saveState(state) {
+    try {
+        await getStorage().setItem(STORAGE_KEY, JSON.stringify(state));
+    }
+    catch (_a) {
+        // Silently ignore persistence failures — tracking should not crash the app.
+    }
+}
+async function loadPendingQueue() {
+    var _a;
+    const state = await loadState();
+    return (_a = state.pendingQueue) !== null && _a !== void 0 ? _a : [];
+}
+async function savePendingQueue(queue) {
+    const state = await loadState();
+    await saveState(Object.assign(Object.assign({}, state), { pendingQueue: queue }));
+}
+async function appendToPendingQueue(event) {
+    const queue = await loadPendingQueue();
+    queue.push(event);
+    // Cap the queue: drop the oldest event(s) when over the limit.
+    while (queue.length > MAX_QUEUE_SIZE)
+        queue.shift();
+    await savePendingQueue(queue);
+}
+async function clearPendingQueue() {
+    const state = await loadState();
+    await saveState(Object.assign(Object.assign({}, state), { pendingQueue: [] }));
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";;AA+CA,8BAQC;AAED,8BAMC;AAED,4CAGC;AAED,4CAGC;AAED,oDAMC;AAED,8CAGC;AApFD,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAEvC,+EAA+E;AAC/E,kFAAkF;AAClF,MAAM,cAAc,GAAG,GAAG,CAAC;AAa3B,SAAS,mBAAmB;;IAC1B,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,2CAA2C,CAAC,CAAC;QACjE,OAAO,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,mCAAI,GAAG,mCAAI,IAAI,CAAC;IACrC,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,WAAW,GAA2B,EAAE,CAAC;AAC/C,MAAM,eAAe,GAAqB;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,WAAC,OAAA,OAAO,CAAC,OAAO,CAAC,MAAA,WAAW,CAAC,GAAG,CAAC,mCAAI,IAAI,CAAC,CAAA,EAAA;IAC3D,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACtB,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC;AAEF,SAAS,UAAU;;IACjB,OAAO,MAAA,mBAAmB,EAAE,mCAAI,eAAe,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAEvE,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,WAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,gBAAgB;;IACpC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,OAAO,MAAA,KAAK,CAAC,YAAY,mCAAI,EAAE,CAAC;AAClC,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,KAAqB;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,SAAS,iCAAM,KAAK,KAAE,YAAY,EAAE,KAAK,IAAG,CAAC;AACrD,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,KAAmB;IAC5D,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,+DAA+D;IAC/D,OAAO,KAAK,CAAC,MAAM,GAAG,cAAc;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACpD,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAEM,KAAK,UAAU,iBAAiB;IACrC,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,SAAS,iCAAM,KAAK,KAAE,YAAY,EAAE,EAAE,IAAG,CAAC;AAClD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Supported event types. Only these values may be sent to the postback endpoint.
+ * Derived or custom event types are NOT permitted.
+ */
+export type EventType = 'install' | 'sign_up' | 'login' | 'download' | 'purchase' | 'subscription' | 'refund';
+export declare const VALID_EVENT_TYPES: readonly EventType[];
+/**
+ * SDK configuration object passed to AdSparkle.configure().
+ */
+export interface AdSparkleConfig {
+    /**
+     * Your publishable company key (starts with "co_").
+     * This is a public key and safe to embed in client apps.
+     * Never use an HMAC secret or private key here.
+     */
+    companyKey: string;
+    /**
+     * Base URL for the tracking API.
+     * @default "https://api.viralif.co"
+     */
+    baseUrl?: string;
+    /**
+     * Enable verbose console logging.
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Optional parameters for track() calls.
+ */
+export interface TrackParams {
+    /** Required for purchase, subscription, and refund events. */
+    transactionId?: string;
+    /** Monetary amount (purchase / subscription). */
+    amount?: number;
+    /** ISO 4217 currency code (e.g. "USD", "EUR"). */
+    currency?: string;
+    /** List of product identifiers involved in the event. */
+    productIds?: string[];
+    /** Arbitrary key-value metadata. Values must be strings. */
+    customParams?: Record<string, string>;
+}
+/**
+ * The JSON body sent to POST {baseUrl}/api/tracking/postback.
+ * Internal type — not part of the public API surface.
+ */
+export interface PostbackPayload {
+    click_id: string;
+    click_ids?: string[];
+    event_type: EventType;
+    user_id: string;
+    transaction_id?: string;
+    amount?: number;
+    currency?: string;
+    product_ids?: string[];
+    custom_params?: Record<string, string>;
+}
+/**
+ * An event that failed all retry attempts and is sitting in the persisted queue.
+ */
+export interface PendingEvent {
+    payload: PostbackPayload;
+    enqueuedAt: number;
+}
+/**
+ * Shape of data persisted to AsyncStorage.
+ */
+export interface PersistedState {
+    companyKey?: string;
+    baseUrl?: string;
+    userId?: string;
+    clickId?: string;
+    clickIds?: string[];
+    /**
+     * Epoch ms of the last time the click_id chain was updated. Used to enforce
+     * the 7-day sliding attribution window: if (now - clickIdsUpdatedAt) exceeds
+     * the window, the chain is considered expired and cleared.
+     */
+    clickIdsUpdatedAt?: number;
+    pendingQueue?: PendingEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,OAAO,GACP,UAAU,GACV,UAAU,GACV,cAAc,GACd,QAAQ,CAAC;AAEb,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAQjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_EVENT_TYPES = void 0;
+exports.VALID_EVENT_TYPES = [
+    'install',
+    'sign_up',
+    'login',
+    'download',
+    'purchase',
+    'subscription',
+    'refund',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAaa,QAAA,iBAAiB,GAAyB;IACrD,SAAS;IACT,SAAS;IACT,OAAO;IACP,UAAU;IACV,UAAU;IACV,cAAc;IACd,QAAQ;CACT,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "adsparkle-react-native",
+  "version": "0.1.0",
+  "description": "Viralif / AdBird affiliate attribution SDK for React Native",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.18.0",
+    "react-native": ">=0.70.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "react-native",
+    "affiliate",
+    "tracking",
+    "attribution",
+    "viralif",
+    "adbird",
+    "sdk"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/viralif/adsparkle-react-native"
+  }
+}