@affiliateo/web 1.6.1 → 2.0.0

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { AffiliateoProvider, useAffiliateRef } from './provider';
+export { AffiliateoProvider, useAffiliateRef, getAttribution } from './provider';
 export type { AffiliateoConfig, AffiliateoContextValue } from './types';

package/dist/index.js

@@ -1,2 +1,2 @@
 'use client';
-export { AffiliateoProvider, useAffiliateRef } from './provider';
+export { AffiliateoProvider, useAffiliateRef, getAttribution } from './provider';

package/dist/provider.d.ts

@@ -4,6 +4,20 @@ import type { AffiliateoConfig, AffiliateoContextValue } from './types';
  * Returns the affiliate ref code and visitor ID.
  */
 export declare function useAffiliateRef(): AffiliateoContextValue;
+/**
+ * Returns attribution data from localStorage for checkout flows.
+ * Call this client-side and include the result in your checkout request body.
+ *
+ * Example:
+ * ```ts
+ * const attribution = getAttribution()
+ * const res = await fetch('/api/checkout', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ ...checkoutData, ...attribution }),
+ * })
+ * ```
+ */
+export declare function getAttribution(): Record<string, string>;
 export declare function AffiliateoProvider({ campaignId, apiUrl, children, }: AffiliateoConfig & {
     children: React.ReactNode;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/provider.js

@@ -2,20 +2,23 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useEffect, useRef, useState } from 'react';
 const DEFAULT_API_URL = 'https://affiliateo.com';
-// Cookie helpers
-function getCookie(name) {
-    if (typeof document === 'undefined')
+const LS_VISITOR_ID = 'affiliateo_visitor_id';
+const LS_REF = 'affiliateo_ref';
+const LS_CAMPAIGN_ID = 'affiliateo_campaign_id';
+// localStorage helpers
+function lsGet(key) {
+    try {
+        return localStorage.getItem(key);
+    }
+    catch {
         return null;
-    const m = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
-    return m ? m[2] : null;
+    }
 }
-function setCookie(name, value, days) {
-    if (typeof document === 'undefined')
-        return;
-    const dt = new Date();
-    dt.setTime(dt.getTime() + days * 864e5);
-    const secure = window.location.protocol === 'https:' ? ';Secure' : '';
-    document.cookie = `${name}=${value};expires=${dt.toUTCString()};path=/;SameSite=Lax${secure}`;
+function lsSet(key, value) {
+    try {
+        localStorage.setItem(key, value);
+    }
+    catch { }
 }
 // Generate UUID
 function uuid() {
@@ -37,6 +40,32 @@ const AffiliateoContext = createContext({
 export function useAffiliateRef() {
     return useContext(AffiliateoContext);
 }
+/**
+ * Returns attribution data from localStorage for checkout flows.
+ * Call this client-side and include the result in your checkout request body.
+ *
+ * Example:
+ * ```ts
+ * const attribution = getAttribution()
+ * const res = await fetch('/api/checkout', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ ...checkoutData, ...attribution }),
+ * })
+ * ```
+ */
+export function getAttribution() {
+    const data = {};
+    const vid = lsGet(LS_VISITOR_ID);
+    const ref = lsGet(LS_REF);
+    const cid = lsGet(LS_CAMPAIGN_ID);
+    if (vid)
+        data.affiliateo_visitor_id = vid;
+    if (ref)
+        data.affiliateo_ref = ref;
+    if (cid)
+        data.affiliateo_campaign_id = cid;
+    return data;
+}
 export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
     const [state, setState] = useState({
         refCode: null,
@@ -49,22 +78,22 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
         if (typeof window === 'undefined')
             return;
         // Get or create visitor ID
-        let vid = getCookie('affiliateo_visitor_id');
+        let vid = lsGet(LS_VISITOR_ID);
         if (!vid) {
             vid = uuid();
         }
-        setCookie('affiliateo_visitor_id', vid, 90);
-        setCookie('affiliateo_campaign_id', campaignIdRef.current, 90);
-        // Read ref from URL params
+        lsSet(LS_VISITOR_ID, vid);
+        lsSet(LS_CAMPAIGN_ID, campaignIdRef.current);
+        // Read ref from URL params or localStorage
         const params = new URLSearchParams(window.location.search);
-        const ref = params.get('ref') || params.get('via') || params.get('source') || getCookie('affiliateo_ref') || null;
+        const ref = params.get('ref') || params.get('via') || params.get('source')
+            || lsGet(LS_REF) || null;
         if (ref) {
-            setCookie('affiliateo_ref', ref, 90);
+            lsSet(LS_REF, ref);
         }
         setState({ refCode: ref, visitorId: vid });
         // Throttle: max 1 pageview per second
         let lastSendTime = 0;
-        // Send pageview
         function sendPageview() {
             const now = Date.now();
             if (now - lastSendTime < 1000)
@@ -78,18 +107,16 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
                 path: window.location.pathname,
                 hostname: window.location.hostname,
                 referrer: document.referrer || '',
-                ref: ref || getCookie('affiliateo_ref') || '',
+                ref: ref || lsGet(LS_REF) || '',
                 utm_source: params.get('utm_source') || '',
                 utm_medium: params.get('utm_medium') || '',
                 utm_campaign: params.get('utm_campaign') || '',
                 screen_width: window.innerWidth,
             };
-            const data = JSON.stringify(payload);
-            // Always use fetch so we can see responses in DevTools Network tab
             fetch(`${apiBase}/api/v1/web/event`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: data,
+                body: JSON.stringify(payload),
                 keepalive: true,
             }).then(async (r) => {
                 if (!r.ok) {
@@ -100,12 +127,12 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
                 console.error('[Affiliateo] Event send error:', err);
             });
         }
-        // Send pageview on mount (first load or page navigation)
+        // Send pageview on mount
         if (!sentRef.current) {
             sentRef.current = true;
             sendPageview();
         }
-        // For SPA: listen for URL changes (popstate + pushState/replaceState)
+        // SPA support: detect URL changes
         let lastPath = window.location.pathname;
         function onUrlChange() {
             if (window.location.pathname !== lastPath) {
@@ -113,9 +140,7 @@ export function AffiliateoProvider({ campaignId, apiUrl, children, }) {
                 sendPageview();
             }
         }
-        // Listen for browser back/forward
         window.addEventListener('popstate', onUrlChange);
-        // Patch pushState/replaceState to detect SPA navigations
         const origPushState = history.pushState;
         const origReplaceState = history.replaceState;
         history.pushState = function (...args) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@affiliateo/web",
-  "version": "1.6.1",
-  "description": "Affiliateo web SDK — affiliate attribution and session tracking for web apps",
+  "version": "2.0.0",
+  "description": "Affiliateo web SDK — affiliate attribution and tracking for web apps",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,11 +10,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.js"
-    },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "require": "./dist/server.js"
     }
   },
   "scripts": {

package/dist/metadata.d.ts

@@ -1,21 +0,0 @@
-/**
- * Extract affiliateo cookies from an incoming request.
- * Works with Next.js (App Router & Pages Router), Express, and any framework
- * that exposes cookies on the request object.
- *
- * Returns metadata object to pass to Stripe checkout session.
- */
-export declare function getMetadata(req: {
-    cookies?: Record<string, string> | {
-        get?: (name: string) => {
-            value: string;
-        } | undefined;
-    };
-    headers?: {
-        cookie?: string;
-    } | Headers;
-}): {
-    affiliateo_visitor_id?: string;
-    affiliateo_ref?: string;
-    campaign_id?: string;
-};

package/dist/metadata.js

@@ -1,60 +0,0 @@
-/**
- * Extract affiliateo cookies from an incoming request.
- * Works with Next.js (App Router & Pages Router), Express, and any framework
- * that exposes cookies on the request object.
- *
- * Returns metadata object to pass to Stripe checkout session.
- */
-export function getMetadata(req) {
-    const metadata = {};
-    // Try Next.js App Router cookies (ReadonlyRequestCookies with .get())
-    if (req.cookies && typeof req.cookies === 'object' && 'get' in req.cookies && typeof req.cookies.get === 'function') {
-        const visitorId = req.cookies.get('affiliateo_visitor_id');
-        const ref = req.cookies.get('affiliateo_ref');
-        const campaignId = req.cookies.get('affiliateo_campaign_id');
-        if (visitorId?.value)
-            metadata.affiliateo_visitor_id = visitorId.value;
-        if (ref?.value)
-            metadata.affiliateo_ref = ref.value;
-        if (campaignId?.value)
-            metadata.campaign_id = campaignId.value;
-        return metadata;
-    }
-    // Try plain object cookies (Express, Pages Router, etc.)
-    if (req.cookies && typeof req.cookies === 'object') {
-        const cookies = req.cookies;
-        if (cookies.affiliateo_visitor_id)
-            metadata.affiliateo_visitor_id = cookies.affiliateo_visitor_id;
-        if (cookies.affiliateo_ref)
-            metadata.affiliateo_ref = cookies.affiliateo_ref;
-        if (cookies.affiliateo_campaign_id)
-            metadata.campaign_id = cookies.affiliateo_campaign_id;
-        return metadata;
-    }
-    // Fallback: parse cookie header manually
-    const cookieHeader = req.headers instanceof Headers
-        ? req.headers.get('cookie')
-        : req.headers?.cookie;
-    if (cookieHeader) {
-        const cookies = parseCookies(cookieHeader);
-        if (cookies.affiliateo_visitor_id)
-            metadata.affiliateo_visitor_id = cookies.affiliateo_visitor_id;
-        if (cookies.affiliateo_ref)
-            metadata.affiliateo_ref = cookies.affiliateo_ref;
-        if (cookies.affiliateo_campaign_id)
-            metadata.campaign_id = cookies.affiliateo_campaign_id;
-    }
-    return metadata;
-}
-/**
- * Parse a cookie header string into key-value pairs.
- */
-function parseCookies(cookieHeader) {
-    const cookies = {};
-    for (const pair of cookieHeader.split(';')) {
-        const [key, ...rest] = pair.trim().split('=');
-        if (key)
-            cookies[key.trim()] = rest.join('=').trim();
-    }
-    return cookies;
-}

package/dist/server.d.ts

@@ -1 +0,0 @@
-export { getMetadata } from './metadata';

package/dist/server.js

@@ -1 +0,0 @@
-export { getMetadata } from './metadata';