@billdog.io/react-native 1.0.0-beta.2

package/dist/modules/Analytics.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @billdog.io/react-native — Analytics Module
+ *
+ * Native bridge to BillDogAnalytics (iOS) / billdog-analytics (Android).
+ * The native SDKs handle server-driven config (batch size, flush interval, sampling, etc.)
+ * fetched from the `sdk-config` edge function at init time.
+ * Config priority: client override > server config > SDK defaults (20 batch, 30s flush).
+ */
+export interface AnalyticsEvent {
+    name: string;
+    properties?: Record<string, any>;
+    timestamp?: number;
+}
+export interface RevenueEvent {
+    /** Revenue amount (in the currency's base unit, e.g., dollars not cents) */
+    amount: number;
+    /** ISO 4217 currency code */
+    currency?: string;
+    /** Product identifier */
+    productId?: string;
+    /** Additional properties */
+    properties?: Record<string, any>;
+}
+export interface UserProperties {
+    [key: string]: string | number | boolean | null;
+}
+export type UserPropertyOperation = '$set' | '$set_once' | '$add' | '$append' | '$remove' | '$unset';
+export declare class AnalyticsManager {
+    private static instance;
+    private initialized;
+    private constructor();
+    static getInstance(): AnalyticsManager;
+    /**
+     * Initialize the Analytics module.
+     * Called automatically when `BillDogConfiguration.configure()` includes `apiKey`.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Track a custom event.
+     */
+    track(event: string | AnalyticsEvent, properties?: Record<string, any>): Promise<void>;
+    /**
+     * Track a revenue event (standardized `$revenue` event).
+     */
+    trackRevenue(revenue: RevenueEvent): Promise<void>;
+    /**
+     * Identify a user.
+     */
+    identify(userId: string, properties?: UserProperties): Promise<void>;
+    /**
+     * Set super properties (persisted, merged into every event).
+     */
+    setSuperProperties(properties: Record<string, any>): Promise<void>;
+    /**
+     * Update user properties with a specific operation.
+     */
+    updateUserProperties(operation: UserPropertyOperation, properties: Record<string, any>): Promise<void>;
+    /**
+     * Flush pending events immediately.
+     */
+    flush(): Promise<void>;
+    /** Opt out of analytics tracking (GDPR). */
+    optOut(): Promise<void>;
+    /** Opt back in to analytics tracking. */
+    optIn(): Promise<void>;
+    /** Reset analytics state (clears identity + super properties). */
+    reset(): Promise<void>;
+    /** Alias an anonymous user to a known identity. */
+    alias(newId: string, originalId?: string): Promise<void>;
+    /** Start timing an event — duration emitted on next track() of same name. */
+    timeEvent(eventName: string): Promise<void>;
+    /** Associate this user with a group (B2B analytics). */
+    setGroup(groupType: string, groupId: string): Promise<void>;
+    setGroupProperties(groupType: string, groupId: string, properties: Record<string, any>): Promise<void>;
+    /** Track a screen view manually. */
+    trackScreen(screenName: string, properties?: Record<string, any>): Promise<void>;
+    /** Track a deep-link URL. */
+    trackDeepLink(url: string): Promise<void>;
+    getDeviceId(): Promise<string | null>;
+    getDistinctId(): Promise<string | null>;
+    getSessionId(): Promise<string | null>;
+    registerSuperPropertiesOnce(properties: Record<string, any>): Promise<void>;
+    unregisterSuperProperty(key: string): Promise<void>;
+    clearSuperProperties(): Promise<void>;
+    /** Listen to flush events (debugging). */
+    onFlush(callback: (data: {
+        eventCount: number;
+    }) => void): import("react-native").EmitterSubscription | undefined;
+}
+declare const _default: AnalyticsManager;
+export default _default;

package/dist/modules/Analytics.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * @billdog.io/react-native — Analytics Module
+ *
+ * Native bridge to BillDogAnalytics (iOS) / billdog-analytics (Android).
+ * The native SDKs handle server-driven config (batch size, flush interval, sampling, etc.)
+ * fetched from the `sdk-config` edge function at init time.
+ * Config priority: client override > server config > SDK defaults (20 batch, 30s flush).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsManager = void 0;
+const react_native_1 = require("react-native");
+const { BillDogAnalytics } = react_native_1.NativeModules;
+const eventEmitter = BillDogAnalytics ? new react_native_1.NativeEventEmitter(BillDogAnalytics) : null;
+// MARK: - Analytics Manager
+class AnalyticsManager {
+    constructor() {
+        this.initialized = false;
+    }
+    static getInstance() {
+        if (!AnalyticsManager.instance) {
+            AnalyticsManager.instance = new AnalyticsManager();
+        }
+        return AnalyticsManager.instance;
+    }
+    /**
+     * Initialize the Analytics module.
+     * Called automatically when `BillDogConfiguration.configure()` includes `apiKey`.
+     */
+    async initialize() {
+        if (!BillDogAnalytics) {
+            console.warn('[BillDogAnalytics] Native module not linked. Analytics will be no-op.');
+            return;
+        }
+        await BillDogAnalytics.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Track a custom event.
+     */
+    async track(event, properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        const name = typeof event === 'string' ? event : event.name;
+        const props = typeof event === 'string' ? properties : event.properties;
+        await BillDogAnalytics.track(name, props || {});
+    }
+    /**
+     * Track a revenue event (standardized `$revenue` event).
+     */
+    async trackRevenue(revenue) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.trackRevenue(revenue.amount, revenue.currency || 'USD', revenue.productId || null, revenue.properties || {});
+    }
+    /**
+     * Identify a user.
+     */
+    async identify(userId, properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.identify(userId, properties || {});
+    }
+    /**
+     * Set super properties (persisted, merged into every event).
+     */
+    async setSuperProperties(properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.setSuperProperties(properties);
+    }
+    /**
+     * Update user properties with a specific operation.
+     */
+    async updateUserProperties(operation, properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.updateUserProperties(operation, properties);
+    }
+    /**
+     * Flush pending events immediately.
+     */
+    async flush() {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.flush();
+    }
+    /** Opt out of analytics tracking (GDPR). */
+    async optOut() {
+        if (!BillDogAnalytics)
+            return;
+        await BillDogAnalytics.optOut();
+    }
+    /** Opt back in to analytics tracking. */
+    async optIn() {
+        if (!BillDogAnalytics)
+            return;
+        await BillDogAnalytics.optIn();
+    }
+    /** Reset analytics state (clears identity + super properties). */
+    async reset() {
+        if (!BillDogAnalytics)
+            return;
+        await BillDogAnalytics.reset();
+        this.initialized = false;
+    }
+    // ── Parity surface (Sev 2.3 fix) ─────────────────────────────────────
+    // Native (iOS/Android) BillDogAnalytics already implements all of these;
+    // the RN bridge simply needs to expose them.
+    /** Alias an anonymous user to a known identity. */
+    async alias(newId, originalId) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.alias(newId, originalId !== null && originalId !== void 0 ? originalId : null);
+    }
+    /** Start timing an event — duration emitted on next track() of same name. */
+    async timeEvent(eventName) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.timeEvent(eventName);
+    }
+    /** Associate this user with a group (B2B analytics). */
+    async setGroup(groupType, groupId) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.setGroup(groupType, groupId);
+    }
+    async setGroupProperties(groupType, groupId, properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.setGroupProperties(groupType, groupId, properties);
+    }
+    /** Track a screen view manually. */
+    async trackScreen(screenName, properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.trackScreen(screenName, properties !== null && properties !== void 0 ? properties : {});
+    }
+    /** Track a deep-link URL. */
+    async trackDeepLink(url) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.trackDeepLink(url);
+    }
+    async getDeviceId() {
+        if (!BillDogAnalytics)
+            return null;
+        return BillDogAnalytics.getDeviceId();
+    }
+    async getDistinctId() {
+        if (!BillDogAnalytics)
+            return null;
+        return BillDogAnalytics.getDistinctId();
+    }
+    async getSessionId() {
+        if (!BillDogAnalytics)
+            return null;
+        return BillDogAnalytics.getSessionId();
+    }
+    async registerSuperPropertiesOnce(properties) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.registerSuperPropertiesOnce(properties);
+    }
+    async unregisterSuperProperty(key) {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.unregisterSuperProperty(key);
+    }
+    async clearSuperProperties() {
+        if (!this.initialized || !BillDogAnalytics)
+            return;
+        await BillDogAnalytics.clearSuperProperties();
+    }
+    /** Listen to flush events (debugging). */
+    onFlush(callback) {
+        return eventEmitter === null || eventEmitter === void 0 ? void 0 : eventEmitter.addListener('onAnalyticsFlush', callback);
+    }
+}
+exports.AnalyticsManager = AnalyticsManager;
+AnalyticsManager.instance = null;
+exports.default = AnalyticsManager.getInstance();

package/dist/modules/Survey.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @billdog.io/react-native — Survey Module
+ *
+ * Native bridge to BDSurvey (iOS) / billdog-survey (Android).
+ * Provides survey presentation, response collection, and template loading.
+ */
+import type { SurveyConfiguration, SurveyPage, SurveyQuestion, SurveyChoice, SurveyAnswer, SurveyMobileDisplayConfig } from '../survey-core/types';
+export type { SurveyConfiguration, SurveyPage, SurveyQuestion, SurveyChoice, SurveyAnswer, SurveyMobileDisplayConfig };
+/** Alias for backward compatibility */
+export type Survey = SurveyConfiguration;
+export interface SurveyResponse {
+    survey_id: string;
+    answers: SurveyAnswer[];
+    completed_at?: string;
+    duration_ms?: number;
+}
+export interface SurveyPresentationOptions {
+    /** Survey identifier to display */
+    surveyIdentifier: string;
+    /** Optional customer ID for response attribution */
+    customerId?: string;
+    /** Optional context data passed to the survey */
+    context?: Record<string, any>;
+    /** Whether the survey can be dismissed */
+    isDismissible?: boolean;
+}
+export declare class SurveyManager {
+    private static instance;
+    private initialized;
+    private constructor();
+    static getInstance(): SurveyManager;
+    /**
+     * Initialize the Survey module.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Present a survey to the user.
+     */
+    presentSurvey(options: SurveyPresentationOptions): Promise<SurveyResponse | null>;
+    /**
+     * Fetch a survey configuration without presenting it.
+     */
+    fetchSurvey(surveyIdentifier: string): Promise<Survey | null>;
+    /**
+     * Submit a survey response programmatically.
+     */
+    submitResponse(response: SurveyResponse): Promise<boolean>;
+    /**
+     * Check if a survey is eligible to be shown to the current user.
+     */
+    canShowSurvey(surveyIdentifier: string): Promise<boolean>;
+    /**
+     * Listen to survey completion events.
+     */
+    onSurveyCompleted(callback: (response: SurveyResponse) => void): import("react-native").EmitterSubscription | undefined;
+    /**
+     * Listen to survey dismissal events.
+     */
+    onSurveyDismissed(callback: (data: {
+        surveyId: string;
+        pageIndex: number;
+    }) => void): import("react-native").EmitterSubscription | undefined;
+}
+declare const _default: SurveyManager;
+export default _default;

package/dist/modules/Survey.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @billdog.io/react-native — Survey Module
+ *
+ * Native bridge to BDSurvey (iOS) / billdog-survey (Android).
+ * Provides survey presentation, response collection, and template loading.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SurveyManager = void 0;
+const react_native_1 = require("react-native");
+const { BillDogSurvey } = react_native_1.NativeModules;
+const eventEmitter = BillDogSurvey ? new react_native_1.NativeEventEmitter(BillDogSurvey) : null;
+// MARK: - Survey Manager
+class SurveyManager {
+    constructor() {
+        this.initialized = false;
+    }
+    static getInstance() {
+        if (!SurveyManager.instance) {
+            SurveyManager.instance = new SurveyManager();
+        }
+        return SurveyManager.instance;
+    }
+    /**
+     * Initialize the Survey module.
+     */
+    async initialize() {
+        if (!BillDogSurvey) {
+            console.warn('[BillDogSurvey] Native module not linked. Surveys will be no-op.');
+            return;
+        }
+        await BillDogSurvey.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Present a survey to the user.
+     */
+    async presentSurvey(options) {
+        if (!this.initialized || !BillDogSurvey)
+            return null;
+        return await BillDogSurvey.presentSurvey(options);
+    }
+    /**
+     * Fetch a survey configuration without presenting it.
+     */
+    async fetchSurvey(surveyIdentifier) {
+        if (!this.initialized || !BillDogSurvey)
+            return null;
+        return await BillDogSurvey.fetchSurvey(surveyIdentifier);
+    }
+    /**
+     * Submit a survey response programmatically.
+     */
+    async submitResponse(response) {
+        if (!this.initialized || !BillDogSurvey)
+            return false;
+        return await BillDogSurvey.submitResponse(response);
+    }
+    /**
+     * Check if a survey is eligible to be shown to the current user.
+     */
+    async canShowSurvey(surveyIdentifier) {
+        if (!this.initialized || !BillDogSurvey)
+            return false;
+        return await BillDogSurvey.canShowSurvey(surveyIdentifier);
+    }
+    /**
+     * Listen to survey completion events.
+     */
+    onSurveyCompleted(callback) {
+        return eventEmitter === null || eventEmitter === void 0 ? void 0 : eventEmitter.addListener('onSurveyCompleted', callback);
+    }
+    /**
+     * Listen to survey dismissal events.
+     */
+    onSurveyDismissed(callback) {
+        return eventEmitter === null || eventEmitter === void 0 ? void 0 : eventEmitter.addListener('onSurveyDismissed', callback);
+    }
+}
+exports.SurveyManager = SurveyManager;
+SurveyManager.instance = null;
+exports.default = SurveyManager.getInstance();

package/dist/modules/VirtualCurrency.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @billdog.io/react-native — Virtual Currency Module
+ * Version: 1.0.0
+ */
+export interface VirtualCurrency {
+    id: string;
+    name: string;
+    code: string;
+    symbol: string;
+    balance: number;
+}
+export interface VirtualCurrencyTransaction {
+    id: string;
+    currencyId: string;
+    amount: number;
+    type: 'earn' | 'spend' | 'grant' | 'exchange';
+    reason?: string;
+    timestamp: number;
+    metadata?: Record<string, any>;
+}
+export interface ExchangeResult {
+    success: boolean;
+    fromCurrencyId: string;
+    toCurrencyId: string;
+    fromAmount: number;
+    toAmount: number;
+    exchangeRate: number;
+    newFromBalance: number;
+    newToBalance: number;
+    error?: string;
+}
+export interface VirtualCurrencyConfig {
+    apiKey: string;
+    customerId: string;
+    enableLogging?: boolean;
+}
+export declare class VirtualCurrencyManager {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): VirtualCurrencyManager;
+    initialize(config: VirtualCurrencyConfig): Promise<void>;
+    /** True when the native Virtual Currency bridge is linked into the host app. */
+    isAvailable(): boolean;
+    getBalance(currencyId: string): Promise<number>;
+    addCurrency(currencyId: string, amount: number, reason?: string, metadata?: Record<string, any>): Promise<number>;
+    deductCurrency(currencyId: string, amount: number, reason?: string, metadata?: Record<string, any>): Promise<number>;
+    grantCurrency(currencyId: string, amount: number, reason?: string): Promise<number>;
+    getTransactionHistory(currencyId?: string, limit?: number): Promise<VirtualCurrencyTransaction[]>;
+    exchangeCurrency(fromCurrencyId: string, toCurrencyId: string, fromAmount: number): Promise<ExchangeResult>;
+    getAllCurrencies(): Promise<VirtualCurrency[]>;
+    onBalanceChanged(callback: (data: {
+        currencyId: string;
+        newBalance: number;
+    }) => void): import("react-native").EmitterSubscription | {
+        remove(): void;
+    };
+    onTransaction(callback: (transaction: VirtualCurrencyTransaction) => void): import("react-native").EmitterSubscription | {
+        remove(): void;
+    };
+}
+declare const _default: VirtualCurrencyManager;
+export default _default;

package/dist/modules/VirtualCurrency.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * @billdog.io/react-native — Virtual Currency Module
+ * Version: 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualCurrencyManager = void 0;
+const react_native_1 = require("react-native");
+const BillDogConfiguration_1 = require("../BillDogConfiguration");
+const { BillDogVirtualCurrency } = react_native_1.NativeModules;
+const eventEmitter = BillDogVirtualCurrency ? new react_native_1.NativeEventEmitter(BillDogVirtualCurrency) : null;
+/**
+ * Fail loud with a clear, actionable message when the native module is not linked
+ * (e.g. Expo Go, a JS-only Metro run, or a host app that hasn't rebuilt after
+ * adding the SDK) instead of a cryptic `Cannot read property '…' of undefined`.
+ * The native module is registered by `BillDogVirtualCurrencyPackage` on Android
+ * and `BillDogVirtualCurrencyBridge` on iOS — both require a native rebuild.
+ */
+function requireNative() {
+    if (!BillDogVirtualCurrency) {
+        throw new Error('[BillDogVirtualCurrency] Native module not linked. Rebuild the app with the ' +
+            'native SDK (npx expo prebuild + a dev-client/EAS build, or pod install + ' +
+            'gradle sync) — the Virtual Currency bridge is not available in Expo Go.');
+    }
+    return BillDogVirtualCurrency;
+}
+/**
+ * Normalize a native transaction row into the declared `VirtualCurrencyTransaction`
+ * shape. The native bridges resolve the backend row as-is, which is snake_case
+ * (`currency_id`, `created_at`); this maps both snake_case and camelCase so the
+ * public type is honest on iOS and Android alike.
+ */
+function normalizeTransaction(raw) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const ts = typeof (raw === null || raw === void 0 ? void 0 : raw.timestamp) === 'number'
+        ? raw.timestamp
+        : (raw === null || raw === void 0 ? void 0 : raw.created_at)
+            ? Date.parse(raw.created_at) || 0
+            : 0;
+    return {
+        id: String((_a = raw === null || raw === void 0 ? void 0 : raw.id) !== null && _a !== void 0 ? _a : ''),
+        currencyId: (_c = (_b = raw === null || raw === void 0 ? void 0 : raw.currencyId) !== null && _b !== void 0 ? _b : raw === null || raw === void 0 ? void 0 : raw.currency_id) !== null && _c !== void 0 ? _c : '',
+        amount: Number((_d = raw === null || raw === void 0 ? void 0 : raw.amount) !== null && _d !== void 0 ? _d : 0),
+        type: ((_e = raw === null || raw === void 0 ? void 0 : raw.type) !== null && _e !== void 0 ? _e : 'earn'),
+        reason: (_f = raw === null || raw === void 0 ? void 0 : raw.reason) !== null && _f !== void 0 ? _f : undefined,
+        timestamp: ts,
+        metadata: (_g = raw === null || raw === void 0 ? void 0 : raw.metadata) !== null && _g !== void 0 ? _g : undefined,
+    };
+}
+/**
+ * Normalize a native currency row into the declared `VirtualCurrency` shape.
+ * The all-balances backend route returns `{ currency: {id,code,name,icon}, balance }`
+ * (nested; the display symbol lives in `icon`), so map that shape as well as a
+ * flat one. See supabase/functions/virtual-currency/index.ts (handleGetAllBalances).
+ */
+function normalizeCurrency(raw) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const c = (_a = raw === null || raw === void 0 ? void 0 : raw.currency) !== null && _a !== void 0 ? _a : raw;
+    return {
+        id: String((_b = c === null || c === void 0 ? void 0 : c.id) !== null && _b !== void 0 ? _b : ''),
+        name: (_c = c === null || c === void 0 ? void 0 : c.name) !== null && _c !== void 0 ? _c : '',
+        code: (_d = c === null || c === void 0 ? void 0 : c.code) !== null && _d !== void 0 ? _d : '',
+        symbol: (_f = (_e = c === null || c === void 0 ? void 0 : c.symbol) !== null && _e !== void 0 ? _e : c === null || c === void 0 ? void 0 : c.icon) !== null && _f !== void 0 ? _f : '',
+        balance: Number((_h = (_g = raw === null || raw === void 0 ? void 0 : raw.balance) !== null && _g !== void 0 ? _g : c === null || c === void 0 ? void 0 : c.balance) !== null && _h !== void 0 ? _h : 0),
+    };
+}
+/**
+ * Normalize a native exchange result into the declared `ExchangeResult` shape.
+ * The iOS bridge resolves the raw backend payload (snake_case: `to_amount`,
+ * `exchange_rate`, `new_from_balance`); the Android bridge already emits
+ * camelCase. Accept both so the public type is honest on either platform.
+ */
+function normalizeExchange(raw, fromCurrencyId, toCurrencyId, fromAmount) {
+    var _a, _b, _c, _d, _e, _f;
+    const num = (a, b, d = 0) => { var _a; return Number((_a = a !== null && a !== void 0 ? a : b) !== null && _a !== void 0 ? _a : d); };
+    return {
+        success: (_a = raw === null || raw === void 0 ? void 0 : raw.success) !== null && _a !== void 0 ? _a : !(raw === null || raw === void 0 ? void 0 : raw.error),
+        fromCurrencyId: (_c = (_b = raw === null || raw === void 0 ? void 0 : raw.fromCurrencyId) !== null && _b !== void 0 ? _b : raw === null || raw === void 0 ? void 0 : raw.from_currency_id) !== null && _c !== void 0 ? _c : fromCurrencyId,
+        toCurrencyId: (_e = (_d = raw === null || raw === void 0 ? void 0 : raw.toCurrencyId) !== null && _d !== void 0 ? _d : raw === null || raw === void 0 ? void 0 : raw.to_currency_id) !== null && _e !== void 0 ? _e : toCurrencyId,
+        fromAmount: num(raw === null || raw === void 0 ? void 0 : raw.fromAmount, raw === null || raw === void 0 ? void 0 : raw.from_amount, fromAmount),
+        toAmount: num(raw === null || raw === void 0 ? void 0 : raw.toAmount, raw === null || raw === void 0 ? void 0 : raw.to_amount),
+        exchangeRate: num(raw === null || raw === void 0 ? void 0 : raw.exchangeRate, raw === null || raw === void 0 ? void 0 : raw.exchange_rate),
+        newFromBalance: num(raw === null || raw === void 0 ? void 0 : raw.newFromBalance, raw === null || raw === void 0 ? void 0 : raw.new_from_balance),
+        newToBalance: num(raw === null || raw === void 0 ? void 0 : raw.newToBalance, raw === null || raw === void 0 ? void 0 : raw.new_to_balance),
+        error: (_f = raw === null || raw === void 0 ? void 0 : raw.error) !== null && _f !== void 0 ? _f : undefined,
+    };
+}
+class VirtualCurrencyManager {
+    constructor() {
+        this.config = null;
+    }
+    static getInstance() {
+        if (!VirtualCurrencyManager.instance) {
+            VirtualCurrencyManager.instance = new VirtualCurrencyManager();
+        }
+        return VirtualCurrencyManager.instance;
+    }
+    async initialize(config) {
+        this.config = config;
+        // baseUrl is the single branded host (api.billdog.io/v1), not caller-supplied.
+        await requireNative().initialize({
+            ...config,
+            baseUrl: BillDogConfiguration_1.BillDogConfiguration.getApiBaseUrl(),
+        });
+    }
+    /** True when the native Virtual Currency bridge is linked into the host app. */
+    isAvailable() {
+        return !!BillDogVirtualCurrency;
+    }
+    async getBalance(currencyId) {
+        return await requireNative().getBalance(currencyId);
+    }
+    async addCurrency(currencyId, amount, reason, metadata) {
+        return await requireNative().addCurrency(currencyId, amount, reason, metadata);
+    }
+    async deductCurrency(currencyId, amount, reason, metadata) {
+        return await requireNative().deductCurrency(currencyId, amount, reason, metadata);
+    }
+    async grantCurrency(currencyId, amount, reason) {
+        return await requireNative().grantCurrency(currencyId, amount, reason);
+    }
+    async getTransactionHistory(currencyId, limit = 50) {
+        const raw = await requireNative().getTransactionHistory(currencyId, limit);
+        return Array.isArray(raw) ? raw.map(normalizeTransaction) : [];
+    }
+    async exchangeCurrency(fromCurrencyId, toCurrencyId, fromAmount) {
+        const raw = await requireNative().exchangeCurrency(fromCurrencyId, toCurrencyId, fromAmount);
+        return normalizeExchange(raw, fromCurrencyId, toCurrencyId, fromAmount);
+    }
+    async getAllCurrencies() {
+        const raw = await requireNative().getAllCurrencies();
+        return Array.isArray(raw) ? raw.map(normalizeCurrency) : [];
+    }
+    onBalanceChanged(callback) {
+        if (!eventEmitter)
+            return { remove() { } };
+        return eventEmitter.addListener('onBalanceChanged', callback);
+    }
+    onTransaction(callback) {
+        if (!eventEmitter)
+            return { remove() { } };
+        return eventEmitter.addListener('onTransaction', callback);
+    }
+}
+exports.VirtualCurrencyManager = VirtualCurrencyManager;
+VirtualCurrencyManager.instance = null;
+exports.default = VirtualCurrencyManager.getInstance();

package/dist/murmur.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MurmurHash3 (x86_32) — the ONE canonical deterministic bucketing hash.
+ *
+ * React Native port of the backend canonical `murmurhash3`
+ * (`supabase/functions/_shared/edge-serving/pure.ts`) and the dashboard copy
+ * (`src/lib/murmur.ts`). Used to derive the render-time `user.seed` Dynamic
+ * Values variable so a user buckets IDENTICALLY on every surface.
+ *
+ * RN-SPECIFIC: uses a manual UTF-8 encoder instead of `TextEncoder`, because
+ * Hermes historically ships without `TextEncoder`. The bytes it produces are
+ * identical to `TextEncoder().encode(...)` for the fixture inputs (incl.
+ * surrogate-pair emoji), so it stays pinned to the same corpus.
+ *
+ * CONTRACT (do not change without regenerating the fixture on ALL ports):
+ *   user.seed = murmurhash3(appUserId) % 1000   → range 0..999
+ *
+ * Conformance-pinned to `native-sdks/_test-fixtures/conformance/core_user_seed.json`.
+ * Never validated against another SDK port.
+ */
+export declare function murmurhash3(key: string, seed?: number): number;
+export declare const USER_SEED_MODULUS = 1000;
+/** Canonical `user.seed` derivation: 0..999 bucket from a stable user id. */
+export declare function userSeedBucket(appUserId: string | null | undefined): number;