@traffical/react-native 0.2.0

package/README.md

@@ -0,0 +1,404 @@
+# @traffical/react-native
+
+React Native SDK for Traffical - a unified parameter decisioning platform for feature flags, A/B testing, and contextual bandits.
+
+Server-evaluated by default. Parameters are resolved on Traffical's edge, cached to AsyncStorage, and refreshed automatically when the app returns to the foreground.
+
+## Installation
+
+```bash
+bun add @traffical/react-native @react-native-async-storage/async-storage
+# or
+npm install @traffical/react-native @react-native-async-storage/async-storage
+```
+
+`@react-native-async-storage/async-storage` is a required peer dependency for persistent caching.
+
+## Quick Start
+
+### 1. Wrap your app with TrafficalRNProvider
+
+```tsx
+import { TrafficalRNProvider } from '@traffical/react-native';
+import { ActivityIndicator } from 'react-native';
+
+function App() {
+  return (
+    <TrafficalRNProvider
+      config={{
+        orgId: 'org_123',
+        projectId: 'proj_456',
+        env: 'production',
+        apiKey: 'pk_...',
+      }}
+      loadingComponent={<ActivityIndicator size="large" />}
+    >
+      <Navigation />
+    </TrafficalRNProvider>
+  );
+}
+```
+
+### 2. Use the `useTraffical` hook in your screens
+
+```tsx
+import { useTraffical } from '@traffical/react-native';
+
+function OnboardingScreen() {
+  const { params, ready, track } = useTraffical({
+    defaults: {
+      'onboarding.ctaText': 'Get Started',
+      'onboarding.showSkip': true,
+      'onboarding.accentColor': '#3b82f6',
+    },
+  });
+
+  const handleCTATap = () => {
+    track('onboarding_cta_tap');
+  };
+
+  return (
+    <View>
+      <Button
+        title={params['onboarding.ctaText']}
+        color={params['onboarding.accentColor']}
+        onPress={handleCTATap}
+      />
+      {params['onboarding.showSkip'] && (
+        <TouchableOpacity onPress={skipOnboarding}>
+          <Text>Skip</Text>
+        </TouchableOpacity>
+      )}
+    </View>
+  );
+}
+```
+
+## API Reference
+
+### TrafficalRNProvider
+
+Initializes the Traffical client with React Native defaults and provides it to child components.
+
+```tsx
+<TrafficalRNProvider
+  config={config}
+  loadingComponent={<ActivityIndicator />}
+>
+  {children}
+</TrafficalRNProvider>
+```
+
+#### Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `config.orgId` | `string` | Yes | Organization ID |
+| `config.projectId` | `string` | Yes | Project ID |
+| `config.env` | `string` | Yes | Environment (e.g., "production", "staging") |
+| `config.apiKey` | `string` | Yes | API key for authentication |
+| `config.baseUrl` | `string` | No | Base URL for the control plane API |
+| `config.evaluationMode` | `"server" \| "bundle"` | No | Resolution mode (default: `"server"`) |
+| `config.refreshIntervalMs` | `number` | No | Background refresh interval (default: 60000) |
+| `config.unitKeyFn` | `() => string` | No | Function to get the unit key. If not provided, uses automatic stable ID |
+| `config.contextFn` | `() => Context` | No | Function to get additional context |
+| `config.deviceInfoProvider` | `DeviceInfoProvider` | No | Provider for device metadata (OS, model, etc.) |
+| `config.cacheMaxAgeMs` | `number` | No | Cache TTL for persisted responses (default: 24 hours) |
+| `config.trackDecisions` | `boolean` | No | Whether to track decision events (default: true) |
+| `config.decisionDeduplicationTtlMs` | `number` | No | Decision dedup TTL (default: 1 hour) |
+| `config.exposureSessionTtlMs` | `number` | No | Exposure dedup session TTL (default: 30 min) |
+| `config.plugins` | `TrafficalPlugin[]` | No | Additional plugins to register |
+| `config.eventBatchSize` | `number` | No | Max events before auto-flush (default: 10) |
+| `config.eventFlushIntervalMs` | `number` | No | Auto-flush interval (default: 30000) |
+| `config.initialParams` | `Record<string, unknown>` | No | Initial params for fallback |
+| `config.localConfig` | `ConfigBundle` | No | Local config bundle for offline fallback |
+| `loadingComponent` | `ReactNode` | No | Shown while the SDK is initializing |
+
+---
+
+### useTraffical
+
+Primary hook for parameter resolution and decision tracking. Identical API to `@traffical/react`.
+
+```tsx
+const { params, decision, ready, error, trackExposure, track, flushEvents } = useTraffical(options);
+```
+
+#### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `defaults` | `T` | Required | Default parameter values |
+| `context` | `Context` | `undefined` | Additional context to merge |
+| `tracking` | `"full" \| "decision" \| "none"` | `"full"` | Tracking mode |
+
+#### Tracking Modes
+
+| Mode | Decision Event | Exposure Event | Use Case |
+|------|----------------|----------------|----------|
+| `"full"` | Yes | Auto | Default. UI shown to users |
+| `"decision"` | Yes | Manual | Manual exposure control (e.g., screen visibility) |
+| `"none"` | No | No | Internal logic, tests |
+
+#### Return Value
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `params` | `T` | Resolved parameter values |
+| `decision` | `DecisionResult \| null` | Decision metadata (null when `tracking="none"`) |
+| `ready` | `boolean` | Whether the client is ready |
+| `error` | `Error \| null` | Any initialization error |
+| `trackExposure` | `() => void` | Manually track exposure |
+| `track` | `(event: string, properties?: object) => void` | Track event with bound decisionId |
+| `flushEvents` | `() => Promise<void>` | Flush all pending events immediately |
+
+#### Examples
+
+```tsx
+// Full tracking (default) - decision + exposure events
+const { params, track } = useTraffical({
+  defaults: { 'checkout.ctaText': 'Buy Now' },
+});
+
+// Decision tracking only - manual exposure control
+const { params, trackExposure } = useTraffical({
+  defaults: { 'checkout.ctaText': 'Buy Now' },
+  tracking: 'decision',
+});
+
+// No tracking - for tests or internal logic
+const { params, ready } = useTraffical({
+  defaults: { 'ui.theme': 'light' },
+  tracking: 'none',
+});
+```
+
+---
+
+### useTrafficalTrack
+
+Standalone hook for tracking events outside of a `useTraffical` decision.
+
+```tsx
+const track = useTrafficalTrack();
+
+const handlePurchase = (amount: number) => {
+  track('purchase', { value: amount, orderId: 'ord_123' });
+};
+```
+
+> **Tip:** For most use cases, use the bound `track` from `useTraffical()` instead — it automatically includes the `decisionId`.
+
+---
+
+### useTrafficalClient
+
+Hook to access the Traffical client directly.
+
+```tsx
+const { client, ready, error } = useTrafficalClient();
+
+if (ready && client) {
+  const version = client.getConfigVersion();
+  const stableId = client.getStableId();
+}
+```
+
+---
+
+### useTrafficalPlugin
+
+Hook to access a registered plugin by name.
+
+```tsx
+const myPlugin = useTrafficalPlugin<MyPlugin>('my-plugin');
+```
+
+---
+
+## How It Works
+
+### Initialization Flow
+
+```
+App Launch
+│
+├─ 1. AsyncStorage preload (all traffical:* keys → memory)
+├─ 2. Load cached server response (if within cache TTL)
+├─ 3. Mark ready with cached data (or show loadingComponent)
+├─ 4. Fetch fresh response from edge (/v1/resolve)
+└─ 5. Update params + persist to cache
+```
+
+### Foreground Resume
+
+When the app returns from the background, the SDK checks whether enough time has elapsed since the last resolve (based on `suggestedRefreshMs` from the server, default 60s). If stale, it triggers a background refresh.
+
+```
+Background → Foreground
+│
+├─ Check: now - lastResolve >= suggestedRefreshMs?
+│   ├─ Yes → refreshConfig() in background
+│   └─ No  → do nothing
+```
+
+### Cache Priority
+
+On cold start, the SDK uses this fallback chain:
+
+| Priority | Source | Behavior |
+|----------|--------|----------|
+| 1 | Cached `ServerResolveResponse` (within TTL) | Ready immediately, background refresh |
+| 2 | Cached response (expired) | Ready immediately, background refresh |
+| 3 | No cache | Wait for server response, show `loadingComponent` |
+| 4 | `localConfig` from options | Offline fallback |
+| 5 | `initialParams` from options | Last-resort override |
+| 6 | `defaults` from `useTraffical` | Absolute fallback |
+
+---
+
+## Use Cases
+
+### Feature Flag
+
+```tsx
+function HomeScreen() {
+  const { params } = useTraffical({
+    defaults: { 'feature.newFeed': false },
+  });
+
+  return params['feature.newFeed'] ? <NewFeed /> : <ClassicFeed />;
+}
+```
+
+### A/B Test with Conversion Tracking
+
+```tsx
+function PaywallScreen() {
+  const { params, track } = useTraffical({
+    defaults: {
+      'paywall.headline': 'Go Premium',
+      'paywall.showTrial': true,
+      'paywall.accentColor': '#6366f1',
+    },
+  });
+
+  const handleSubscribe = (plan: string, price: number) => {
+    track('subscribe', { value: price, plan });
+  };
+
+  return (
+    <View>
+      <Text style={{ color: params['paywall.accentColor'] }}>
+        {params['paywall.headline']}
+      </Text>
+      {params['paywall.showTrial'] && <TrialBanner />}
+      <PlanPicker onSelect={handleSubscribe} />
+    </View>
+  );
+}
+```
+
+### Flushing Events Before Navigation
+
+```tsx
+function CheckoutScreen({ navigation }) {
+  const { params, track, flushEvents } = useTraffical({
+    defaults: { 'checkout.ctaText': 'Complete Purchase' },
+  });
+
+  const handlePurchase = async (total: number) => {
+    track('purchase', { value: total });
+    await flushEvents();
+    navigation.replace('Success');
+  };
+
+  return (
+    <Button
+      title={params['checkout.ctaText']}
+      onPress={() => handlePurchase(99.99)}
+    />
+  );
+}
+```
+
+---
+
+## Differences from @traffical/react
+
+| | `@traffical/react` | `@traffical/react-native` |
+|---|---|---|
+| **Default evaluation** | Bundle (client-side) | Server (edge-evaluated) |
+| **Storage** | localStorage | AsyncStorage (preloaded to memory) |
+| **Lifecycle** | `visibilitychange` / `pagehide` | `AppState` change |
+| **Loading state** | Manual (`if (!ready)`) | Built-in `loadingComponent` prop |
+| **Unload flush** | sendBeacon on page unload | Regular flush (no unload concept) |
+| **DOM plugin** | Available | Not available (no DOM) |
+| **Hook API** | `useTraffical`, `useTrafficalTrack`, etc. | Identical |
+
+---
+
+## Best Practices
+
+### 1. Always Provide Sensible Defaults
+
+Defaults are used when no experiment is running, the user doesn't match targeting, or the SDK is still loading.
+
+```tsx
+// ✅ Good: works without any experiment
+const { params } = useTraffical({
+  defaults: {
+    'pricing.discount': 0,
+    'ui.accentColor': '#3b82f6',
+  },
+});
+```
+
+### 2. Use the loadingComponent Prop
+
+Unlike web apps where a blank flash is acceptable, mobile users expect immediate content. Use `loadingComponent` to show a spinner or skeleton until the first resolve completes.
+
+```tsx
+<TrafficalRNProvider
+  config={config}
+  loadingComponent={<SplashScreen />}
+>
+  <App />
+</TrafficalRNProvider>
+```
+
+### 3. Track Events at Conversion Points
+
+```tsx
+const { params, track } = useTraffical({
+  defaults: { 'checkout.showUpsells': false },
+});
+
+// Track meaningful conversions
+const handlePurchase = (amount: number) => {
+  track('purchase', { value: amount });
+};
+
+// Track micro-conversions too
+const handleAddToCart = () => {
+  track('add_to_cart', { itemId: 'sku_456' });
+};
+```
+
+### 4. Use Consistent Parameter Naming
+
+```
+category.subcategory.name
+
+feature.*     → Feature flags        (boolean)
+ui.*          → Visual variations    (string, number)
+pricing.*     → Pricing experiments  (number)
+copy.*        → Copywriting tests    (string)
+onboarding.*  → Onboarding flow      (mixed)
+```
+
+---
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+import { TrafficalClient, type TrafficalClientOptions } from "@traffical/js-client";
+import type { DeviceInfoProvider } from "./device-info.js";
+export interface TrafficalRNClientOptions extends TrafficalClientOptions {
+    deviceInfoProvider?: DeviceInfoProvider;
+    /** Cache max age in ms for persisted server responses (default: 86400000 = 24 hours) */
+    cacheMaxAgeMs?: number;
+}
+export declare class TrafficalRNClient extends TrafficalClient {
+    private readonly _rnStorage;
+    private readonly _rnLifecycle;
+    readonly deviceInfoProvider?: DeviceInfoProvider;
+    private readonly _cacheMaxAgeMs;
+    private _lastResolveTimestamp;
+    private _suggestedRefreshMs;
+    private _visibilityCallback;
+    constructor(options: TrafficalRNClientOptions);
+    /**
+     * RN-specific initialization:
+     * 1. Wait for AsyncStorage preload
+     * 2. Load cached server response if available
+     * 3. Call parent initialize (fetches from server)
+     * 4. Persist response to cache
+     */
+    initialize(): Promise<void>;
+    destroy(): void;
+    refreshConfig(): Promise<void>;
+    private _setupForegroundRefresh;
+    private _loadCachedResponse;
+    private _loadCachedTimestamp;
+    private _persistCurrentResponse;
+}
+//# 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,EACL,eAAe,EACf,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,mBAAmB,CACpB;gBAEK,OAAO,EAAE,wBAAwB;IAqB7C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxB,OAAO,IAAI,IAAI;IAQT,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7C,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,uBAAuB;CAQhC"}

package/dist/client.js

@@ -0,0 +1,89 @@
+import { TrafficalClient, } from "@traffical/js-client";
+import { createPreloadedAsyncStorage, } from "./storage.js";
+import { createRNLifecycleProvider } from "./lifecycle.js";
+const CACHED_RESPONSE_KEY = "server_resolve_cache";
+const CACHED_RESPONSE_TIMESTAMP_KEY = "server_resolve_cache_ts";
+const DEFAULT_CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+const DEFAULT_SUGGESTED_REFRESH_MS = 60_000; // 60 seconds
+export class TrafficalRNClient extends TrafficalClient {
+    _rnStorage;
+    _rnLifecycle;
+    deviceInfoProvider;
+    _cacheMaxAgeMs;
+    _lastResolveTimestamp = 0;
+    _suggestedRefreshMs = DEFAULT_SUGGESTED_REFRESH_MS;
+    _visibilityCallback = null;
+    constructor(options) {
+        const rnStorage = options.storage ??
+            createPreloadedAsyncStorage();
+        const lifecycle = options.lifecycleProvider ?? createRNLifecycleProvider();
+        super({
+            ...options,
+            evaluationMode: options.evaluationMode ?? "server",
+            storage: rnStorage,
+            lifecycleProvider: lifecycle,
+        });
+        this._rnStorage = rnStorage;
+        this._rnLifecycle = lifecycle;
+        this.deviceInfoProvider = options.deviceInfoProvider;
+        this._cacheMaxAgeMs = options.cacheMaxAgeMs ?? DEFAULT_CACHE_MAX_AGE_MS;
+        this._setupForegroundRefresh();
+    }
+    /**
+     * RN-specific initialization:
+     * 1. Wait for AsyncStorage preload
+     * 2. Load cached server response if available
+     * 3. Call parent initialize (fetches from server)
+     * 4. Persist response to cache
+     */
+    async initialize() {
+        await this._rnStorage.waitUntilReady();
+        const cached = this._loadCachedResponse();
+        if (cached) {
+            this._lastResolveTimestamp = this._loadCachedTimestamp();
+            if (cached.suggestedRefreshMs) {
+                this._suggestedRefreshMs = cached.suggestedRefreshMs;
+            }
+        }
+        await super.initialize();
+        this._persistCurrentResponse();
+    }
+    destroy() {
+        if (this._visibilityCallback) {
+            this._rnLifecycle.removeVisibilityListener(this._visibilityCallback);
+            this._visibilityCallback = null;
+        }
+        super.destroy();
+    }
+    async refreshConfig() {
+        await super.refreshConfig();
+        this._lastResolveTimestamp = Date.now();
+        this._persistCurrentResponse();
+    }
+    _setupForegroundRefresh() {
+        this._visibilityCallback = (state) => {
+            if (state === "foreground") {
+                const elapsed = Date.now() - this._lastResolveTimestamp;
+                if (elapsed >= this._suggestedRefreshMs) {
+                    this.refreshConfig().catch(() => { });
+                }
+            }
+        };
+        this._rnLifecycle.onVisibilityChange(this._visibilityCallback);
+    }
+    _loadCachedResponse() {
+        return this._rnStorage.get(CACHED_RESPONSE_KEY);
+    }
+    _loadCachedTimestamp() {
+        return this._rnStorage.get(CACHED_RESPONSE_TIMESTAMP_KEY) ?? 0;
+    }
+    _persistCurrentResponse() {
+        const version = this.getConfigVersion();
+        if (!version)
+            return;
+        const now = Date.now();
+        this._lastResolveTimestamp = now;
+        this._rnStorage.set(CACHED_RESPONSE_TIMESTAMP_KEY, now, this._cacheMaxAgeMs);
+    }
+}
+//# 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/context.d.ts

@@ -0,0 +1,38 @@
+import type { TrafficalClient, TrafficalPlugin } from "@traffical/js-client";
+import type { ConfigBundle, Context } from "@traffical/core";
+export interface TrafficalRNProviderConfig {
+    orgId: string;
+    projectId: string;
+    env: string;
+    apiKey: string;
+    baseUrl?: string;
+    localConfig?: ConfigBundle;
+    refreshIntervalMs?: number;
+    unitKeyFn?: () => string;
+    contextFn?: () => Context;
+    trackDecisions?: boolean;
+    decisionDeduplicationTtlMs?: number;
+    exposureSessionTtlMs?: number;
+    plugins?: TrafficalPlugin[];
+    eventBatchSize?: number;
+    eventFlushIntervalMs?: number;
+    initialParams?: Record<string, unknown>;
+    /** Evaluation mode (default: "server" for RN) */
+    evaluationMode?: "bundle" | "server";
+    /** Device info provider for enriching context */
+    deviceInfoProvider?: import("./device-info.js").DeviceInfoProvider;
+    /** Cache max age in ms for persisted server responses (default: 86400000 = 24 hours) */
+    cacheMaxAgeMs?: number;
+}
+export interface TrafficalContextValue {
+    client: TrafficalClient | null;
+    ready: boolean;
+    error: Error | null;
+    getUnitKey: () => string;
+    getContext: () => Context;
+    initialParams?: Record<string, unknown>;
+    localConfig?: ConfigBundle;
+}
+export declare const TrafficalContext: import("react").Context<TrafficalContextValue | null>;
+export declare function useTrafficalContext(): TrafficalContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAE1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAE5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC,iDAAiD;IACjD,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,EAAE,kBAAkB,CAAC;IACnE,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,uDAE5B,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,qBAAqB,CAQ3D"}

package/dist/context.js

@@ -0,0 +1,10 @@
+import { createContext, useContext } from "react";
+export const TrafficalContext = createContext(null);
+export function useTrafficalContext() {
+    const context = useContext(TrafficalContext);
+    if (!context) {
+        throw new Error("useTrafficalContext must be used within a TrafficalRNProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA8ClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAC3C,IAAI,CACL,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/device-info.d.ts

@@ -0,0 +1,17 @@
+export interface DeviceInfo {
+    appVersion?: string;
+    appBuildNumber?: string;
+    deviceModel?: string;
+    deviceModelName?: string;
+    osName?: string;
+    osVersion?: string;
+    locale?: string;
+    timezone?: string;
+    screenWidth?: number;
+    screenHeight?: number;
+    pixelRatio?: number;
+}
+export interface DeviceInfoProvider {
+    getDeviceInfo(): DeviceInfo;
+}
+//# sourceMappingURL=device-info.d.ts.map

package/dist/device-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-info.d.ts","sourceRoot":"","sources":["../src/device-info.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,IAAI,UAAU,CAAC;CAC7B"}

package/dist/device-info.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=device-info.js.map

package/dist/device-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-info.js","sourceRoot":"","sources":["../src/device-info.ts"],"names":[],"mappings":""}

package/dist/hooks.d.ts

@@ -0,0 +1,36 @@
+import type { ParameterValue, DecisionResult, Context } from "@traffical/core";
+import type { TrafficalPlugin } from "@traffical/js-client";
+export interface UseTrafficalOptions<T> {
+    defaults: T;
+    context?: Context;
+    /**
+     * Tracking mode (default: "full")
+     * - "full": Track decision + exposure (default, recommended for UI)
+     * - "decision": Track decision only, manual exposure control
+     * - "none": No tracking (internal logic, tests)
+     */
+    tracking?: "full" | "decision" | "none";
+}
+export interface BoundTrackOptions {
+    properties?: Record<string, unknown>;
+}
+export interface UseTrafficalResult<T> {
+    params: T;
+    decision: DecisionResult | null;
+    ready: boolean;
+    error: Error | null;
+    trackExposure: () => void;
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    flushEvents: () => Promise<void>;
+}
+export declare function useTraffical<T extends Record<string, ParameterValue>>(options: UseTrafficalOptions<T>): UseTrafficalResult<T>;
+export declare function useTrafficalTrack(): (event: string, properties?: Record<string, unknown>, options?: {
+    decisionId?: string;
+}) => void;
+export declare function useTrafficalPlugin<T extends TrafficalPlugin = TrafficalPlugin>(name: string): T | undefined;
+export declare function useTrafficalClient(): {
+    client: import("@traffical/js-client").TrafficalClient | null;
+    ready: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,OAAO,EACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA8B5D,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACnE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,kBAAkB,CAAC,CAAC,CAAC,CAwLvB;AAMD,wBAAgB,iBAAiB,YAKpB,MAAM,eACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAC1B;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,UAkBtC;AAMD,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,eAAe,GAAG,eAAe,EAC3C,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAQ7B;AAMD,wBAAgB,kBAAkB;;;;EAGjC"}

package/dist/hooks.js

@@ -0,0 +1,203 @@
+import { useState, useEffect, useCallback, useRef } from "react";
+import { resolveParameters } from "@traffical/core";
+import { useTrafficalContext } from "./context.js";
+// =============================================================================
+// Internal Utilities
+// =============================================================================
+function createStableKey(obj) {
+    if (obj === null || obj === undefined) {
+        return String(obj);
+    }
+    if (typeof obj !== "object") {
+        return String(obj);
+    }
+    return JSON.stringify(obj, Object.keys(obj).sort());
+}
+function useStableObject(obj) {
+    const stableKey = createStableKey(obj);
+    const ref = useRef(obj);
+    if (createStableKey(ref.current) !== stableKey) {
+        ref.current = obj;
+    }
+    return ref.current;
+}
+export function useTraffical(options) {
+    const { client, ready, error, getContext, getUnitKey, initialParams, localConfig, } = useTrafficalContext();
+    const trackingMode = options.tracking ?? "full";
+    const shouldTrackDecision = trackingMode !== "none";
+    const shouldAutoTrackExposure = trackingMode === "full";
+    const stableDefaults = useStableObject(options.defaults);
+    const stableContext = useStableObject(options.context);
+    const resolvedSyncRef = useRef(false);
+    const syncDecisionRef = useRef(null);
+    const [params, setParams] = useState(() => {
+        if (client && ready) {
+            resolvedSyncRef.current = true;
+            const context = {
+                ...getContext(),
+                ...(options.context ?? {}),
+            };
+            if (shouldTrackDecision) {
+                const result = client.decide({ context, defaults: options.defaults });
+                syncDecisionRef.current = result;
+                return result.assignments;
+            }
+            else {
+                return client.getParams({ context, defaults: options.defaults });
+            }
+        }
+        if (localConfig) {
+            try {
+                const context = getContext();
+                if (context.userId) {
+                    resolvedSyncRef.current = true;
+                    const fullContext = {
+                        ...context,
+                        ...(options.context ?? {}),
+                    };
+                    const resolved = resolveParameters(localConfig, fullContext, options.defaults);
+                    return resolved;
+                }
+            }
+            catch {
+                // Fall through to defaults
+            }
+        }
+        if (initialParams) {
+            return { ...stableDefaults, ...initialParams };
+        }
+        return stableDefaults;
+    });
+    const [decision, setDecision] = useState(() => syncDecisionRef.current);
+    const [hasTrackedExposure, setHasTrackedExposure] = useState(false);
+    const trackExposure = useCallback(() => {
+        if (trackingMode === "none")
+            return;
+        if (!client || !decision || hasTrackedExposure)
+            return;
+        client.trackExposure(decision);
+        setHasTrackedExposure(true);
+    }, [client, decision, hasTrackedExposure, trackingMode]);
+    useEffect(() => {
+        if (!client || !ready)
+            return;
+        if (resolvedSyncRef.current && syncDecisionRef.current) {
+            resolvedSyncRef.current = false;
+            return;
+        }
+        resolvedSyncRef.current = false;
+        const context = {
+            ...getContext(),
+            ...stableContext,
+        };
+        if (shouldTrackDecision) {
+            const result = client.decide({ context, defaults: stableDefaults });
+            setParams(result.assignments);
+            setDecision(result);
+            setHasTrackedExposure(false);
+        }
+        else {
+            const resolved = client.getParams({
+                context,
+                defaults: stableDefaults,
+            });
+            setParams(resolved);
+            setDecision(null);
+        }
+    }, [
+        client,
+        ready,
+        getContext,
+        stableContext,
+        stableDefaults,
+        shouldTrackDecision,
+    ]);
+    useEffect(() => {
+        if (shouldAutoTrackExposure && decision && !hasTrackedExposure) {
+            trackExposure();
+        }
+    }, [shouldAutoTrackExposure, decision, hasTrackedExposure, trackExposure]);
+    const decisionRef = useRef(null);
+    decisionRef.current = decision;
+    const pendingTracksRef = useRef([]);
+    useEffect(() => {
+        if (decision && client && pendingTracksRef.current.length > 0) {
+            const pending = pendingTracksRef.current;
+            pendingTracksRef.current = [];
+            for (const { event, properties } of pending) {
+                client.track(event, properties, {
+                    decisionId: decision.decisionId,
+                    unitKey: getUnitKey(),
+                });
+            }
+        }
+    }, [decision, client, getUnitKey]);
+    const track = useCallback((event, properties) => {
+        if (!client) {
+            console.warn("[Traffical] Client not initialized, cannot track event");
+            return;
+        }
+        const currentDecision = decisionRef.current;
+        if (!currentDecision) {
+            if (trackingMode === "none") {
+                console.warn("[Traffical] Cannot track event with tracking: 'none'. Use tracking: 'full' or 'decision'.");
+                return;
+            }
+            pendingTracksRef.current.push({ event, properties });
+            return;
+        }
+        client.track(event, properties, {
+            decisionId: currentDecision.decisionId,
+            unitKey: getUnitKey(),
+        });
+    }, [client, getUnitKey, trackingMode]);
+    const flushEvents = useCallback(async () => {
+        if (!client)
+            return;
+        await client.flushEvents();
+    }, [client]);
+    return {
+        params,
+        decision,
+        ready,
+        error,
+        trackExposure,
+        track,
+        flushEvents,
+    };
+}
+// =============================================================================
+// useTrafficalTrack
+// =============================================================================
+export function useTrafficalTrack() {
+    const { client, getUnitKey } = useTrafficalContext();
+    const track = useCallback((event, properties, options) => {
+        if (!client) {
+            console.warn("[Traffical] Client not initialized, cannot track event");
+            return;
+        }
+        client.track(event, properties, {
+            decisionId: options?.decisionId,
+            unitKey: getUnitKey(),
+        });
+    }, [client, getUnitKey]);
+    return track;
+}
+// =============================================================================
+// useTrafficalPlugin
+// =============================================================================
+export function useTrafficalPlugin(name) {
+    const { client, ready } = useTrafficalContext();
+    if (!client || !ready) {
+        return undefined;
+    }
+    return client.getPlugin(name);
+}
+// =============================================================================
+// useTrafficalClient
+// =============================================================================
+export function useTrafficalClient() {
+    const { client, ready, error } = useTrafficalContext();
+    return { client, ready, error };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "@traffical/core";
+export { TrafficalClient, type TrafficalClientOptions, type LifecycleProvider, type VisibilityState, type VisibilityCallback, type StorageProvider, MemoryStorageProvider, type TrafficalPlugin, type PluginOptions, ErrorBoundary, type ErrorBoundaryOptions, } from "@traffical/js-client";
+export { TrafficalRNClient, type TrafficalRNClientOptions, } from "./client.js";
+export { createPreloadedAsyncStorage, type PreloadedAsyncStorageProvider, } from "./storage.js";
+export { createRNLifecycleProvider } from "./lifecycle.js";
+export { type DeviceInfo, type DeviceInfoProvider } from "./device-info.js";
+export { TrafficalRNProvider, type TrafficalRNProviderProps, } from "./provider.js";
+export { TrafficalContext, useTrafficalContext, type TrafficalRNProviderConfig, type TrafficalContextValue, } from "./context.js";
+export { useTraffical, type UseTrafficalOptions, type UseTrafficalResult, useTrafficalTrack, useTrafficalPlugin, useTrafficalClient, } from "./hooks.js";
+//# 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":"AACA,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,EAC3B,KAAK,6BAA6B,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Re-export everything from core
+export * from "@traffical/core";
+// Re-export client utilities (excluding browser-specific: DOM plugin, LocalStorageProvider)
+export { TrafficalClient, MemoryStorageProvider, ErrorBoundary, } from "@traffical/js-client";
+// RN-specific exports
+export { TrafficalRNClient, } from "./client.js";
+export { createPreloadedAsyncStorage, } from "./storage.js";
+export { createRNLifecycleProvider } from "./lifecycle.js";
+// Provider and hooks
+export { TrafficalRNProvider, } from "./provider.js";
+export { TrafficalContext, useTrafficalContext, } from "./context.js";
+export { useTraffical, useTrafficalTrack, useTrafficalPlugin, useTrafficalClient, } from "./hooks.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,4FAA4F;AAC5F,OAAO,EACL,eAAe,EAMf,qBAAqB,EAGrB,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,GAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,qBAAqB;AACrB,OAAO,EACL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAGpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EAGZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { LifecycleProvider } from "@traffical/js-client";
+export declare function createRNLifecycleProvider(): LifecycleProvider;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,yBAAyB,IAAI,iBAAiB,CAoB7D"}

package/dist/lifecycle.js

@@ -0,0 +1,23 @@
+import { AppState } from "react-native";
+export function createRNLifecycleProvider() {
+    const listeners = [];
+    AppState.addEventListener("change", (nextState) => {
+        const visibility = nextState === "active" ? "foreground" : "background";
+        for (const cb of listeners)
+            cb(visibility);
+    });
+    return {
+        onVisibilityChange(callback) {
+            listeners.push(callback);
+        },
+        removeVisibilityListener(callback) {
+            const idx = listeners.indexOf(callback);
+            if (idx !== -1)
+                listeners.splice(idx, 1);
+        },
+        isUnloading() {
+            return false;
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,cAAc,CAAC;AAM7D,MAAM,UAAU,yBAAyB;IACvC,MAAM,SAAS,GAAyB,EAAE,CAAC;IAE3C,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,SAAyB,EAAE,EAAE;QAChE,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACxE,KAAK,MAAM,EAAE,IAAI,SAAS;YAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kBAAkB,CAAC,QAA4B;YAC7C,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QACD,wBAAwB,CAAC,QAA4B;YACnD,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,WAAW;YACT,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,10 @@
+import React, { type ReactNode } from "react";
+import { type TrafficalRNProviderConfig } from "./context.js";
+export interface TrafficalRNProviderProps {
+    config: TrafficalRNProviderConfig;
+    children: ReactNode;
+    /** Component to render while the SDK is loading (before first resolve completes) */
+    loadingComponent?: ReactNode;
+}
+export declare function TrafficalRNProvider({ config, children, loadingComponent, }: TrafficalRNProviderProps): React.ReactElement;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,yBAAyB,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,QAAQ,EACR,gBAAgB,GACjB,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CAsI/C"}

package/dist/provider.js

@@ -0,0 +1,115 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState, useCallback, useMemo, useRef, } from "react";
+import { TrafficalContext, } from "./context.js";
+import { TrafficalRNClient } from "./client.js";
+export function TrafficalRNProvider({ config, children, loadingComponent, }) {
+    const [client, setClient] = useState(null);
+    const [ready, setReady] = useState(false);
+    const [error, setError] = useState(null);
+    const clientRef = useRef(null);
+    const getUnitKey = useCallback(() => {
+        if (config.unitKeyFn) {
+            return config.unitKeyFn();
+        }
+        return clientRef.current?.getStableId() ?? "";
+    }, [config.unitKeyFn]);
+    const getContext = useCallback(() => {
+        const unitKey = getUnitKey();
+        const additionalContext = config.contextFn?.() ?? {};
+        const deviceInfo = config.deviceInfoProvider?.getDeviceInfo();
+        return {
+            ...additionalContext,
+            ...(deviceInfo ?? {}),
+            userId: unitKey,
+            deviceId: unitKey,
+            anonymousId: unitKey,
+        };
+    }, [getUnitKey, config.contextFn, config.deviceInfoProvider]);
+    useEffect(() => {
+        let mounted = true;
+        const initClient = async () => {
+            try {
+                const newClient = new TrafficalRNClient({
+                    orgId: config.orgId,
+                    projectId: config.projectId,
+                    env: config.env,
+                    apiKey: config.apiKey,
+                    baseUrl: config.baseUrl,
+                    localConfig: config.localConfig,
+                    refreshIntervalMs: config.refreshIntervalMs,
+                    trackDecisions: config.trackDecisions,
+                    decisionDeduplicationTtlMs: config.decisionDeduplicationTtlMs,
+                    exposureSessionTtlMs: config.exposureSessionTtlMs,
+                    eventBatchSize: config.eventBatchSize,
+                    eventFlushIntervalMs: config.eventFlushIntervalMs,
+                    plugins: config.plugins,
+                    evaluationMode: config.evaluationMode ?? "server",
+                    deviceInfoProvider: config.deviceInfoProvider,
+                    cacheMaxAgeMs: config.cacheMaxAgeMs,
+                });
+                clientRef.current = newClient;
+                if (mounted) {
+                    setClient(newClient);
+                    if (config.localConfig) {
+                        setReady(true);
+                    }
+                }
+                await newClient.initialize();
+                if (mounted) {
+                    setReady(true);
+                }
+            }
+            catch (err) {
+                if (mounted) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                    setReady(true);
+                }
+            }
+        };
+        initClient();
+        return () => {
+            mounted = false;
+            clientRef.current?.destroy();
+            clientRef.current = null;
+        };
+    }, [
+        config.orgId,
+        config.projectId,
+        config.env,
+        config.apiKey,
+        config.baseUrl,
+        config.localConfig,
+        config.refreshIntervalMs,
+        config.trackDecisions,
+        config.decisionDeduplicationTtlMs,
+        config.exposureSessionTtlMs,
+        config.eventBatchSize,
+        config.eventFlushIntervalMs,
+        config.plugins,
+        config.evaluationMode,
+        config.deviceInfoProvider,
+        config.cacheMaxAgeMs,
+    ]);
+    const contextValue = useMemo(() => ({
+        client,
+        ready,
+        error,
+        getUnitKey,
+        getContext,
+        initialParams: config.initialParams,
+        localConfig: config.localConfig,
+    }), [
+        client,
+        ready,
+        error,
+        getUnitKey,
+        getContext,
+        config.initialParams,
+        config.localConfig,
+    ]);
+    if (!ready && loadingComponent) {
+        return (_jsx(TrafficalContext.Provider, { value: contextValue, children: loadingComponent }));
+    }
+    return (_jsx(TrafficalContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,6 @@
+import type { StorageProvider } from "@traffical/js-client";
+export interface PreloadedAsyncStorageProvider extends StorageProvider {
+    waitUntilReady(): Promise<void>;
+}
+export declare function createPreloadedAsyncStorage(): PreloadedAsyncStorageProvider;
+//# 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":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAS5D,MAAM,WAAW,6BAA8B,SAAQ,eAAe;IACpE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,wBAAgB,2BAA2B,IAAI,6BAA6B,CAsE3E"}

package/dist/storage.js

@@ -0,0 +1,69 @@
+import AsyncStorage from "@react-native-async-storage/async-storage";
+const STORAGE_PREFIX = "traffical:";
+export function createPreloadedAsyncStorage() {
+    const inMemoryStore = {};
+    let isReady = false;
+    let readyPromise = null;
+    function waitUntilReady() {
+        if (isReady)
+            return Promise.resolve();
+        if (!readyPromise) {
+            readyPromise = prefetch().then(() => {
+                isReady = true;
+            });
+        }
+        return readyPromise;
+    }
+    async function prefetch() {
+        const keys = await AsyncStorage.getAllKeys();
+        const trafficalKeys = keys.filter((k) => k.startsWith(STORAGE_PREFIX));
+        if (trafficalKeys.length === 0)
+            return;
+        const entries = await AsyncStorage.multiGet(trafficalKeys);
+        for (const [key, value] of entries) {
+            if (value != null)
+                inMemoryStore[key] = value;
+        }
+    }
+    const provider = {
+        waitUntilReady,
+        get(key) {
+            const raw = inMemoryStore[STORAGE_PREFIX + key];
+            if (!raw)
+                return null;
+            try {
+                const stored = JSON.parse(raw);
+                if (stored.expiresAt && Date.now() > stored.expiresAt) {
+                    provider.remove(key);
+                    return null;
+                }
+                return stored.value;
+            }
+            catch {
+                return null;
+            }
+        },
+        set(key, value, ttlMs) {
+            const stored = {
+                value,
+                ...(ttlMs && { expiresAt: Date.now() + ttlMs }),
+            };
+            const serialized = JSON.stringify(stored);
+            inMemoryStore[STORAGE_PREFIX + key] = serialized;
+            AsyncStorage.setItem(STORAGE_PREFIX + key, serialized).catch(() => { });
+        },
+        remove(key) {
+            delete inMemoryStore[STORAGE_PREFIX + key];
+            AsyncStorage.removeItem(STORAGE_PREFIX + key).catch(() => { });
+        },
+        clear() {
+            const keys = Object.keys(inMemoryStore).filter((k) => k.startsWith(STORAGE_PREFIX));
+            for (const k of keys) {
+                delete inMemoryStore[k];
+            }
+            AsyncStorage.multiRemove(keys).catch(() => { });
+        },
+    };
+    return provider;
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@traffical/react-native",
+  "version": "0.2.0",
+  "description": "Traffical SDK for React Native - server-evaluated feature flags, A/B testing, and adaptive optimization",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@traffical/core": "0.3.0",
+    "@traffical/js-client": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^18.2.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-native": "*",
+    "@react-native-async-storage/async-storage": "1.* || 2.*"
+  },
+  "keywords": [
+    "traffical",
+    "feature-flags",
+    "experimentation",
+    "a/b-testing",
+    "react-native"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/traffical/js-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}