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

package/dist/BillDog.js

@@ -0,0 +1,918 @@
+"use strict";
+/**
+ * BillDog — top-level RN facade.
+ *
+ * Spec:     PUR-063, PUR-064, PUR-080..085, PUR-121, PUR-122, PUR-140..146,
+ *           PUR-224, PUR-350, PUR-360, PUR-362, PUR-363, PUR-364
+ *           (.lovable/purchase-conformance-spec.md)
+ * Standard: mem://architecture/react-native/sdk-unified-standard
+ *           mem://architecture/customer-info-cache-standard
+ *           mem://architecture/entitlements-authoritative-standard
+ *           mem://architecture/purchase-conformance-standard
+ *
+ * Slice J (PUR-364) propagates the v1.4 purchase parity surface to the RN
+ * bridge with iOS/Android wire parity:
+ *  - `purchase(params)` — typed PurchaseParams, returns canonical PurchaseResult
+ *  - `purchase(custom)` — Superwall-style non-StoreKit products via host controller
+ *  - `setPurchaseController(...)` — JS-side controller for EXTERNAL/CUSTOM flows
+ *  - `setProxyURL` / `getProxyURL` — self-hosted proxy
+ *  - `canMakePayments`, `presentCodeRedemptionSheet`,
+ *    `checkTrialOrIntroDiscountEligibility`, `onStorefrontChange`
+ *  - 14-provider attribution matrix + `collectDeviceIdentifiers`
+ *
+ * Every method gracefully falls back when `NativeModules.BillDog` is null so
+ * consumer apps compile against the contract before the native bridge is wired
+ * in their host project. The facade NEVER throws across the public boundary —
+ * store/network errors are surfaced as typed result unions.
+ */
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurchaseParams = exports.BillDog = exports.SDK_VERSION = void 0;
+const CacheFetchPolicy_1 = require("./models/CacheFetchPolicy");
+const CustomerInfo_1 = require("./models/CustomerInfo");
+const PurchaseParams_1 = require("./models/PurchaseParams");
+Object.defineProperty(exports, "PurchaseParams", { enumerable: true, get: function () { return PurchaseParams_1.PurchaseParams; } });
+const Analytics_1 = require("./modules/Analytics");
+const BillDogConfiguration_1 = require("./BillDogConfiguration");
+const ApiClient_1 = require("./utils/ApiClient");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const RN = (() => {
+    try {
+        return require('react-native');
+    }
+    catch {
+        return null;
+    }
+})();
+const native = (_b = (_a = RN === null || RN === void 0 ? void 0 : RN.NativeModules) === null || _a === void 0 ? void 0 : _a.BillDog) !== null && _b !== void 0 ? _b : null;
+// Optional AsyncStorage for persisting currentUserId across launches.
+// Falls back to in-memory if the host app hasn't installed it.
+const AsyncStorage = (() => {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('@react-native-async-storage/async-storage').default;
+    }
+    catch {
+        return null;
+    }
+})();
+// -----------------------------------------------------------------------------
+// Identity API — Android parity (BillDog.kt: logIn, logOut, identify,
+// isAnonymous, getAppUserId, isConfigured, setSandboxMode).
+// Persisted across launches via AsyncStorage when available.
+// -----------------------------------------------------------------------------
+const CURRENT_USER_KEY = 'billdog.rn.currentUserId';
+let _currentUserId = null;
+// Rehydrate from storage on module load — best-effort, never throws.
+if (AsyncStorage === null || AsyncStorage === void 0 ? void 0 : AsyncStorage.getItem) {
+    AsyncStorage.getItem(CURRENT_USER_KEY)
+        .then((id) => {
+        if (id && !_currentUserId)
+            _currentUserId = id;
+    })
+        .catch(() => {
+        /* ignore — degrade to in-memory */
+    });
+}
+class CustomerInfoEmitter {
+    constructor() {
+        this.listeners = new Set();
+        this.lastValue = null;
+    }
+    addListener(fn) {
+        this.listeners.add(fn);
+        if (this.lastValue)
+            fn(this.lastValue);
+        return { remove: () => this.listeners.delete(fn) };
+    }
+    emit(info) {
+        this.lastValue = info;
+        for (const l of this.listeners)
+            l(info);
+    }
+    get latest() {
+        return this.lastValue;
+    }
+}
+const customerInfoEmitter = new CustomerInfoEmitter();
+const storefrontListeners = new Set();
+let activeController = null;
+let activeDelegate = null;
+/** Stamp every receipt posted to BillDog's backend (PUR-185). */
+const sourceForResult = () => activeController ? 'EXTERNAL' : 'INTERNAL';
+const cancelledResult = { type: 'cancelled' };
+const failedResult = (e, category = 'unknown') => {
+    var _a;
+    return ({
+        type: 'failed',
+        error: { category, message: (_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : 'Purchase failed' },
+    });
+};
+/**
+ * Best-effort POST of an EXTERNAL (host-controller) custom-product purchase
+ * to BillDog's `record-external-purchase` endpoint, which resolves the
+ * catalog product from `providerProductId`, grants the entitlement, and
+ * reports revenue with `source = EXTERNAL`.
+ */
+async function recordExternalCustomPurchase(product, transactionId, transactionType = 'initial_purchase') {
+    const userId = exports.BillDog.getAppUserId();
+    if (!userId) {
+        console.warn('[BD-EXTERNAL] Skipping record — app user id unresolved');
+        return;
+    }
+    const txId = transactionId || `ext_${Math.random().toString(36).substring(2)}${Date.now()}`;
+    const body = {
+        user_id: userId,
+        transaction_id: txId,
+        product_id: product.id,
+        provider: product.provider,
+        provider_product_id: product.providerProductId,
+        purchase_date: new Date().toISOString(),
+        store: 'external',
+        price: product.price,
+        currency: product.currency,
+        transaction_type: transactionType,
+    };
+    try {
+        await ApiClient_1.ApiClient.post('record-external-purchase', body);
+        console.log(`[BD-EXTERNAL] Recorded custom purchase '${product.id}' (provider=${product.provider})`);
+    }
+    catch (e) {
+        console.warn(`[BD-EXTERNAL] record-external-purchase failed (not blocking):`, e);
+    }
+}
+/** SDK version constant — Android parity (BillDog.kt:51). */
+exports.SDK_VERSION = '1.0.0-beta.2';
+exports.BillDog = {
+    /** SDK version constant — re-exposed on the singleton for ergonomic access. */
+    SDK_VERSION: exports.SDK_VERSION,
+    // -------------------------------------------------------------------------
+    // PUR-350 / PUR-364 — Unified purchase API
+    // -------------------------------------------------------------------------
+    /**
+     * Purchase a product with typed `PurchaseParams`. Returns canonical
+     * `PurchaseResult` — NEVER throws across the public boundary.
+     *
+     * If a host `PurchaseController` is registered (see `setPurchaseController`),
+     * the controller drives the transaction and the receipt is stamped
+     * `source = EXTERNAL`. Otherwise the bundled native controller is used
+     * (`source = INTERNAL`).
+     */
+    async purchase(params) {
+        if (activeController) {
+            try {
+                return await activeController.purchase(params.productId);
+            }
+            catch (e) {
+                return failedResult(e);
+            }
+        }
+        if (!(native === null || native === void 0 ? void 0 : native.purchase)) {
+            // Bridge not wired in host app — return cancelled so the UI is consistent.
+            return cancelledResult;
+        }
+        try {
+            const raw = await native.purchase({ ...params, source: sourceForResult() });
+            if (raw && typeof raw.type === 'string')
+                return raw;
+            return cancelledResult;
+        }
+        catch (e) {
+            return failedResult(e);
+        }
+    },
+    /**
+     * PUR-363: Purchase a Superwall-style non-StoreKit / non-Play product.
+     * Routing is ONLY through a host-provided PurchaseController.
+     */
+    async purchaseCustom(product) {
+        if (!activeController) {
+            return failedResult(new Error('CustomProduct requires a host PurchaseController. Call BillDog.setPurchaseController() first.'));
+        }
+        try {
+            const raw = await activeController.purchase(product.providerProductId);
+            if (raw && raw.type === 'purchased') {
+                // Best-effort EXTERNAL recording so the entitlement is granted and revenue reported.
+                recordExternalCustomPurchase(product, raw.transactionId).catch(() => { });
+                exports.BillDog.getCustomerInfo('FETCH_CURRENT').catch(() => { });
+            }
+            return raw;
+        }
+        catch (e) {
+            return failedResult(e);
+        }
+    },
+    /** Get the currently-registered host PurchaseController, or null. */
+    getPurchaseController() {
+        return activeController;
+    },
+    /** Flush pending analytics events to the backend. */
+    async flushAnalytics() {
+        try {
+            await Analytics_1.AnalyticsManager.getInstance().flush();
+        }
+        catch { /* best-effort */ }
+    },
+    /** PUR-364: Register a host PurchaseController. Pass `null` to detach. */
+    setPurchaseController(controller) {
+        activeController = controller;
+        if (native === null || native === void 0 ? void 0 : native.setPurchaseControllerActive) {
+            try {
+                native.setPurchaseControllerActive(!!controller);
+            }
+            catch {
+                /* bridge no-op */
+            }
+        }
+    },
+    /**
+     * Restore previous purchases (PUR-080).
+     *
+     *  - `{type:'restored', items: []}`         — nothing to restore
+     *  - `{type:'restored', items: [...]}`      — items resurfaced
+     *  - `{type:'failed', error: BillDogError}` — global failure
+     */
+    async restore() {
+        var _a, _b;
+        if (activeController) {
+            try {
+                return await activeController.restorePurchases();
+            }
+            catch (e) {
+                return {
+                    type: 'failed',
+                    error: { category: 'unknown', message: (_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : 'Restore failed' },
+                };
+            }
+        }
+        if (!(native === null || native === void 0 ? void 0 : native.restore)) {
+            return { type: 'restored', items: [] };
+        }
+        try {
+            const raw = await native.restore();
+            if (raw && (raw.type === 'restored' || raw.type === 'failed')) {
+                return raw;
+            }
+            return { type: 'restored', items: [] };
+        }
+        catch (e) {
+            return {
+                type: 'failed',
+                error: { category: 'unknown', message: (_b = e === null || e === void 0 ? void 0 : e.message) !== null && _b !== void 0 ? _b : 'Restore failed' },
+            };
+        }
+    },
+    // -------------------------------------------------------------------------
+    // PUR-141/224 — CustomerInfo
+    // -------------------------------------------------------------------------
+    async getCustomerInfo(policy = CacheFetchPolicy_1.DEFAULT_CACHE_FETCH_POLICY) {
+        if (!(native === null || native === void 0 ? void 0 : native.getCustomerInfo)) {
+            return customerInfoEmitter.latest;
+        }
+        try {
+            const info = (await native.getCustomerInfo(policy));
+            customerInfoEmitter.emit(info);
+            return info;
+        }
+        catch {
+            return customerInfoEmitter.latest;
+        }
+    },
+    customerInfoEmitter,
+    /**
+     * PUR-121: resolve entitlements unlocked by a [productId] from the local
+     * `productEntitlementMapping`. Used for instant gating.
+     */
+    entitlementsForProduct(productId) {
+        const info = customerInfoEmitter.latest;
+        if (!info)
+            return [];
+        return (0, CustomerInfo_1.entitlementsByProductId)(info, productId);
+    },
+    // -------------------------------------------------------------------------
+    // PUR-201 / PUR-202 / PUR-330 / PUR-037 — store capability surface
+    // -------------------------------------------------------------------------
+    /** PUR-201: Can the device transact at all? (parental controls, MDM) */
+    async canMakePayments() {
+        if (!(native === null || native === void 0 ? void 0 : native.canMakePayments))
+            return true;
+        try {
+            return !!(await native.canMakePayments());
+        }
+        catch {
+            return true;
+        }
+    },
+    /** PUR-330: Present the App Store promo code redemption sheet (iOS-only). */
+    async presentCodeRedemptionSheet() {
+        if (!(native === null || native === void 0 ? void 0 : native.presentCodeRedemptionSheet))
+            return;
+        try {
+            await native.presentCodeRedemptionSheet();
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    /**
+     * PUR-037: Check trial / intro-discount eligibility for an array of product
+     * ids. Returns a map of `productId` -> `'eligible' | 'ineligible' | 'unknown'`.
+     */
+    async checkTrialOrIntroDiscountEligibility(productIds) {
+        if (!(native === null || native === void 0 ? void 0 : native.checkTrialOrIntroDiscountEligibility)) {
+            return Object.fromEntries(productIds.map((id) => [id, 'unknown']));
+        }
+        try {
+            return (await native.checkTrialOrIntroDiscountEligibility(productIds));
+        }
+        catch {
+            return Object.fromEntries(productIds.map((id) => [id, 'unknown']));
+        }
+    },
+    /** PUR-202: Subscribe to storefront country changes (iOS-only producer). */
+    onStorefrontChange(listener) {
+        storefrontListeners.add(listener);
+        if (native === null || native === void 0 ? void 0 : native.subscribeStorefront) {
+            try {
+                native.subscribeStorefront();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return { remove: () => storefrontListeners.delete(listener) };
+    },
+    // -------------------------------------------------------------------------
+    // PUR-362 — Self-hosted proxy
+    // -------------------------------------------------------------------------
+    setProxyURL(url) {
+        if (!(native === null || native === void 0 ? void 0 : native.setProxyURL))
+            return;
+        try {
+            native.setProxyURL(url);
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    // ---------------------------------------------------------------------------
+    // Consent (cross-SDK contract) — delegates to the native ConsentManager when the
+    // host wires the BillDog native module, and degrades to a no-op otherwise (this
+    // package is fallback-by-design; full native enforcement needs the BillDog native
+    // module + bridge registration on both platforms — tracked as a separate task).
+    // ---------------------------------------------------------------------------
+    setConsentRequired(required) {
+        if (!(native === null || native === void 0 ? void 0 : native.setConsentRequired))
+            return;
+        try {
+            native.setConsentRequired(required);
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    setConsent(purpose, granted) {
+        if (!(native === null || native === void 0 ? void 0 : native.setConsent))
+            return;
+        try {
+            native.setConsent(purpose, granted);
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    setConsentGiven(given) {
+        if (!(native === null || native === void 0 ? void 0 : native.setConsentGiven))
+            return;
+        try {
+            native.setConsentGiven(given);
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    async consentHeaderValue() {
+        var _a;
+        if (!(native === null || native === void 0 ? void 0 : native.consentHeaderValue))
+            return null;
+        try {
+            return (_a = (await native.consentHeaderValue())) !== null && _a !== void 0 ? _a : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    getProxyURL() {
+        var _a;
+        if (!(native === null || native === void 0 ? void 0 : native.getProxyURL))
+            return null;
+        try {
+            return (_a = native.getProxyURL()) !== null && _a !== void 0 ? _a : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    // -------------------------------------------------------------------------
+    // PUR-360 — Attribution matrix (14 providers, EXACT parity with the native
+    // SDKs: BillDog.kt / BillDog.swift). Each convenience setter forwards the
+    // provider's attribution key to the native `setAttribution` bridge, which
+    // delegates to the matching consent-gated native setter.
+    //
+    // Two provider groups, both natively backed:
+    //  - 11 "modern" providers routed through the native `setAttribution` map
+    //    (CleverTap … Segment).
+    //  - 3 MMP providers with dedicated native setters (Adjust, AppsFlyer,
+    //    Firebase). They share the same JS/bridge funnel — the bridge maps their
+    //    keys to `setAdjustId` / `setAppsflyerId` / `setFirebaseAppInstanceId`.
+    //
+    // NOTE: Branch, Amplitude and Singular are NOT supported natively and were
+    // removed (they were JS-only no-ops). `setIterableUserID` / `setFBAnonymousID`
+    // replace the previously-misnamed `setIterableID` / `setFirebaseAppInstanceID`.
+    // -------------------------------------------------------------------------
+    /**
+     * Set one or more attribution ids at once. Keys are the provider attribution
+     * keys (e.g. `mixpanelDistinctId`, `cleverTapId`, `iterableId`). Prefer the
+     * named convenience setters below unless batching.
+     */
+    setAttribution(data) {
+        if (!(native === null || native === void 0 ? void 0 : native.setAttribution))
+            return;
+        try {
+            native.setAttribution(data);
+        }
+        catch {
+            /* swallow — attribution is best-effort */
+        }
+    },
+    setCleverTapID: (id) => setAttributionKey('cleverTapId', id),
+    setMixpanelDistinctID: (id) => setAttributionKey('mixpanelDistinctId', id),
+    setOnesignalID: (id) => setAttributionKey('onesignalId', id),
+    setFBAnonymousID: (id) => setAttributionKey('fbAnonymousId', id),
+    setAirshipChannelID: (id) => setAttributionKey('airshipChannelId', id),
+    setMoEngageAnonymousID: (id) => setAttributionKey('moEngageAnonymousId', id),
+    setMparticleID: (id) => setAttributionKey('mparticleId', id),
+    setKochavaDeviceID: (id) => setAttributionKey('kochavaId', id),
+    setTenjinAnalyticsInstallationID: (id) => setAttributionKey('tenjinId', id),
+    setIterableUserID: (id) => setAttributionKey('iterableId', id),
+    setSegmentAnonymousID: (id) => setAttributionKey('segmentId', id),
+    // MMP providers — dedicated native setters, same JS/bridge funnel.
+    setAdjustId: (id) => setAttributionKey('adjustId', id),
+    setAppsflyerId: (id) => setAttributionKey('appsflyerId', id),
+    setFirebaseAppInstanceId: (id) => setAttributionKey('firebaseAppInstanceId', id),
+    /** Collect IDFA / GAID after consent has been granted. */
+    collectDeviceIdentifiers() {
+        if (!(native === null || native === void 0 ? void 0 : native.collectDeviceIdentifiers))
+            return;
+        try {
+            native.collectDeviceIdentifiers();
+        }
+        catch {
+            /* ignore */
+        }
+    },
+    // -------------------------------------------------------------------------
+    // Identity API — Android parity (BillDog.kt:782/807/845/890/894/325)
+    // -------------------------------------------------------------------------
+    /**
+     * Log in an app user. Persists the user id, propagates to the native bridge
+     * (if wired) and the analytics module. Throws on blank ids — mirrors KMP/Unity.
+     */
+    async logIn(appUserId) {
+        if (!appUserId || !appUserId.trim()) {
+            throw new Error('appUserId must be non-blank');
+        }
+        _currentUserId = appUserId;
+        if (AsyncStorage === null || AsyncStorage === void 0 ? void 0 : AsyncStorage.setItem) {
+            try {
+                await AsyncStorage.setItem(CURRENT_USER_KEY, appUserId);
+            }
+            catch {
+                /* ignore — degrade to in-memory */
+            }
+        }
+        if (native === null || native === void 0 ? void 0 : native.logIn) {
+            try {
+                await native.logIn(appUserId);
+            }
+            catch {
+                /* swallow — identity is also tracked locally */
+            }
+        }
+        try {
+            await Analytics_1.AnalyticsManager.getInstance().identify(appUserId);
+        }
+        catch {
+            /* analytics is best-effort */
+        }
+    },
+    /** Log out the current user and return to anonymous state. */
+    async logOut() {
+        _currentUserId = null;
+        if (AsyncStorage === null || AsyncStorage === void 0 ? void 0 : AsyncStorage.removeItem) {
+            try {
+                await AsyncStorage.removeItem(CURRENT_USER_KEY);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        if (native === null || native === void 0 ? void 0 : native.logOut) {
+            try {
+                await native.logOut();
+            }
+            catch {
+                /* swallow */
+            }
+        }
+        try {
+            await Analytics_1.AnalyticsManager.getInstance().reset();
+        }
+        catch {
+            /* best-effort */
+        }
+    },
+    /**
+     * Identify a user with optional attributes. Behaves as `logIn` plus an
+     * analytics super-properties update for the supplied attributes.
+     */
+    async identify(userId, attributes) {
+        await this.logIn(userId);
+        if (attributes && Object.keys(attributes).length > 0) {
+            try {
+                await Analytics_1.AnalyticsManager.getInstance().setSuperProperties(attributes);
+            }
+            catch {
+                /* analytics is best-effort */
+            }
+        }
+    },
+    /** True when no app user is currently logged in. */
+    isAnonymous() {
+        return !_currentUserId;
+    },
+    /** Returns the currently logged-in app user id, or null when anonymous. */
+    getAppUserId() {
+        return _currentUserId;
+    },
+    /**
+     * Mirrors Android `BillDog.isConfigured()` (BillDog.kt:325). Delegates to
+     * the configuration singleton so the apiKey-presence check lives in one place.
+     */
+    isConfigured() {
+        return BillDogConfiguration_1.BillDogConfiguration.isConfigured();
+    },
+    /**
+     * Cross-SDK parity stub matching KMP / Unity / Android. Toggles a local
+     * flag and forwards to the native bridge if wired; otherwise a documented
+     * no-op (sandbox is primarily controlled via API key prefix).
+     */
+    setSandboxMode(enabled) {
+        if (native === null || native === void 0 ? void 0 : native.setSandboxMode) {
+            try {
+                native.setSandboxMode(enabled);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    },
+    // -------------------------------------------------------------------------
+    // Placement registration — Android parity (BillDog.kt:981/990/1024/1938)
+    // -------------------------------------------------------------------------
+    /**
+     * Register a placement and run the canonical placement flow: fetch config →
+     * check entitlement → present paywall if needed. Returns a `PlacementResult`
+     * describing the outcome. Optional `handler` receives lifecycle callbacks
+     * mirroring Android's `PaywallPresentationHandler`.
+     *
+     * Returns `{ type: 'entitled' }` immediately if the user already holds the
+     * placement's required entitlement (no paywall shown). Returns
+     * `{ type: 'error', message }` on any failure — never throws across the
+     * public boundary.
+     */
+    async register(placementId, params, handler) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+        if (!BillDogConfiguration_1.BillDogConfiguration.isConfigured()) {
+            const err = 'BillDog SDK not configured.';
+            (_a = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _a === void 0 ? void 0 : _a.call(handler, 'failed');
+            (_b = handler === null || handler === void 0 ? void 0 : handler.onError) === null || _b === void 0 ? void 0 : _b.call(handler, new Error(err));
+            (_c = handler === null || handler === void 0 ? void 0 : handler.onSkip) === null || _c === void 0 ? void 0 : _c.call(handler, 'error');
+            return { type: 'error', message: err };
+        }
+        (_d = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _d === void 0 ? void 0 : _d.call(handler, 'loading');
+        if (!(native === null || native === void 0 ? void 0 : native.registerPlacement)) {
+            // No native bridge — emit no-op success path so the contract is met.
+            (_e = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _e === void 0 ? void 0 : _e.call(handler, 'ready');
+            (_f = handler === null || handler === void 0 ? void 0 : handler.onSkip) === null || _f === void 0 ? void 0 : _f.call(handler, 'no_paywall_configured');
+            return { type: 'error', message: 'Native placement bridge not wired' };
+        }
+        try {
+            const raw = await native.registerPlacement({ placementId, params: params !== null && params !== void 0 ? params : {} });
+            const result = (raw && typeof raw.type === 'string'
+                ? raw
+                : { type: 'error', message: 'Malformed placement result' });
+            switch (result.type) {
+                case 'entitled':
+                    (_g = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _g === void 0 ? void 0 : _g.call(handler, 'ready');
+                    (_h = handler === null || handler === void 0 ? void 0 : handler.onSkip) === null || _h === void 0 ? void 0 : _h.call(handler, 'user_has_entitlement');
+                    break;
+                case 'purchased':
+                case 'dismissed':
+                case 'restored':
+                    (_j = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _j === void 0 ? void 0 : _j.call(handler, 'ready');
+                    (_k = handler === null || handler === void 0 ? void 0 : handler.onPresent) === null || _k === void 0 ? void 0 : _k.call(handler, placementId);
+                    if (result.type === 'purchased') {
+                        (_l = handler === null || handler === void 0 ? void 0 : handler.onPurchaseSuccess) === null || _l === void 0 ? void 0 : _l.call(handler, result.productId);
+                    }
+                    (_m = handler === null || handler === void 0 ? void 0 : handler.onDismiss) === null || _m === void 0 ? void 0 : _m.call(handler, placementId);
+                    (_o = handler === null || handler === void 0 ? void 0 : handler.onFinish) === null || _o === void 0 ? void 0 : _o.call(handler, placementId, true);
+                    break;
+                case 'error':
+                    (_p = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _p === void 0 ? void 0 : _p.call(handler, 'failed');
+                    (_q = handler === null || handler === void 0 ? void 0 : handler.onError) === null || _q === void 0 ? void 0 : _q.call(handler, new Error(result.message));
+                    (_r = handler === null || handler === void 0 ? void 0 : handler.onSkip) === null || _r === void 0 ? void 0 : _r.call(handler, 'error');
+                    break;
+            }
+            return result;
+        }
+        catch (e) {
+            const msg = (_s = e === null || e === void 0 ? void 0 : e.message) !== null && _s !== void 0 ? _s : 'Placement registration failed';
+            (_t = handler === null || handler === void 0 ? void 0 : handler.onLoadingStateChange) === null || _t === void 0 ? void 0 : _t.call(handler, 'failed');
+            (_u = handler === null || handler === void 0 ? void 0 : handler.onError) === null || _u === void 0 ? void 0 : _u.call(handler, new Error(msg));
+            (_v = handler === null || handler === void 0 ? void 0 : handler.onSkip) === null || _v === void 0 ? void 0 : _v.call(handler, 'error');
+            return { type: 'error', message: msg };
+        }
+    },
+    /**
+     * Synchronous probe — does the current user have access to a placement?
+     * Returns `true` when the placement is unregistered or has no required
+     * entitlement (safe default matching Android's behaviour).
+     */
+    hasAccessForPlacement(placementId) {
+        if (!(native === null || native === void 0 ? void 0 : native.hasAccessForPlacement))
+            return true;
+        try {
+            return !!native.hasAccessForPlacement(placementId);
+        }
+        catch {
+            return true;
+        }
+    },
+    // Experiments & feature flags: the paywall-facade shim was removed. Use the
+    // standalone A/B module (BillDogABTest / ABTestManager) instead.
+    // ── In-app messages — Android parity (BillDog.kt:1969) ────────────
+    /** Open the IAM inbox / present a single message. */
+    async showInAppMessages(placementId) {
+        if (native === null || native === void 0 ? void 0 : native.showInAppMessages) {
+            try {
+                await native.showInAppMessages(placementId !== null && placementId !== void 0 ? placementId : null);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── Deep linking — Android parity (BillDog.kt:684) ────────────────
+    /** Route a deep link through the SDK. Returns true when handled. */
+    async handleDeepLink(uri) {
+        if (native === null || native === void 0 ? void 0 : native.handleDeepLink) {
+            try {
+                return !!(await native.handleDeepLink(uri));
+            }
+            catch { /* ignore */ }
+        }
+        return false;
+    },
+    // ── Component selection state — Android parity (BillDog.kt:1032–1044) ──
+    getSelectedProductIndex(componentId) {
+        if (native === null || native === void 0 ? void 0 : native.getSelectedProductIndex) {
+            try {
+                return native.getSelectedProductIndex(componentId);
+            }
+            catch { /* ignore */ }
+        }
+        return null;
+    },
+    setSelectedProductIndex(componentId, index) {
+        if (native === null || native === void 0 ? void 0 : native.setSelectedProductIndex) {
+            try {
+                native.setSelectedProductIndex(componentId, index);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── Theme override — Android parity (BillDog.kt:184) ──────────────
+    /** Apply runtime theme overrides. Map of token name → value. */
+    updateTheme(overrides) {
+        if (native === null || native === void 0 ? void 0 : native.updateTheme) {
+            try {
+                native.updateTheme(overrides);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    /** Set the SDK-wide interface style. Pass `null` to follow system. */
+    setInterfaceStyle(style) {
+        if (native === null || native === void 0 ? void 0 : native.setInterfaceStyle) {
+            try {
+                native.setInterfaceStyle(style);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── Subscription management — Android parity (BillDog.kt:1500) ────
+    /**
+     * Open the platform-native subscription management UI. iOS routes to
+     * the App Store; Android routes to Play Store; web throws since no
+     * platform UI is available.
+     */
+    async showManageSubscriptions(subscriptionId) {
+        if (native === null || native === void 0 ? void 0 : native.showManageSubscriptions) {
+            try {
+                await native.showManageSubscriptions(subscriptionId !== null && subscriptionId !== void 0 ? subscriptionId : null);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── Cache control — Android parity (BillDog.kt:1074, :1612) ───────
+    /** Clear all SDK caches (paywall configs, customer info, products). */
+    async clearCache() {
+        if (native === null || native === void 0 ? void 0 : native.clearCache) {
+            try {
+                await native.clearCache();
+            }
+            catch { /* ignore */ }
+        }
+    },
+    /** Invalidate the cached customer info — next read triggers a refetch. */
+    async invalidateCustomerInfoCache() {
+        if (native === null || native === void 0 ? void 0 : native.invalidateCustomerInfoCache) {
+            try {
+                await native.invalidateCustomerInfoCache();
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── User attributes — Android parity (BillDog.kt:1714, :1729) ─────
+    /** Set typed attributes on the current user (targeting + analytics). */
+    async setUserAttributes(attributes) {
+        if (native === null || native === void 0 ? void 0 : native.setUserAttributes) {
+            try {
+                await native.setUserAttributes(attributes);
+            }
+            catch { /* ignore */ }
+        }
+        // Also propagate to AnalyticsManager so events carry the same attrs.
+        try {
+            await Analytics_1.AnalyticsManager.getInstance().setSuperProperties(attributes);
+        }
+        catch { /* best-effort */ }
+    },
+    /** Get the current user attributes (snapshot). */
+    async getUserAttributes() {
+        var _a;
+        if (native === null || native === void 0 ? void 0 : native.getUserAttributes) {
+            try {
+                return (_a = (await native.getUserAttributes())) !== null && _a !== void 0 ? _a : {};
+            }
+            catch { /* ignore */ }
+        }
+        return {};
+    },
+    // ── External purchase observation — Android parity (BillDog.kt:1864–1878) ──
+    /** Notify BillDog that an externally-driven purchase has started. */
+    observePurchaseStart(productId) {
+        if (native === null || native === void 0 ? void 0 : native.observePurchaseStart) {
+            try {
+                native.observePurchaseStart(productId);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    /** Notify BillDog that an externally-driven purchase succeeded. */
+    observePurchaseResult(productId, orderId) {
+        if (native === null || native === void 0 ? void 0 : native.observePurchaseResult) {
+            try {
+                native.observePurchaseResult(productId, orderId !== null && orderId !== void 0 ? orderId : null);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    /** Notify BillDog that an externally-driven purchase failed. */
+    observePurchaseError(productId, error) {
+        if (native === null || native === void 0 ? void 0 : native.observePurchaseError) {
+            try {
+                native.observePurchaseError(productId, error);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    // ── BillDogDelegate — Android parity (BillDog.kt:71) ──────────────
+    /**
+     * Set the active delegate. Pass `null` to detach. All delegate callbacks
+     * are optional; the SDK fires the ones that are defined.
+     */
+    setDelegate(delegate) {
+        activeDelegate = delegate;
+    },
+    /** Internal — emit a typed lifecycle event to the delegate (if any). */
+    _emitDelegate(event, ...args) {
+        const fn = activeDelegate === null || activeDelegate === void 0 ? void 0 : activeDelegate[event];
+        if (typeof fn === 'function') {
+            try {
+                fn(...args);
+            }
+            catch {
+                /* delegate errors must not propagate into SDK flow */
+            }
+        }
+    },
+    /**
+     * Evaluate what would happen if `register(placementId)` were called, without
+     * presenting a paywall. Returns one of `paywall`, `userSubscribed`,
+     * `noPaywall`, `holdout`, or `error`.
+     */
+    async getPresentationResult(placementId) {
+        var _a;
+        if (!BillDogConfiguration_1.BillDogConfiguration.isConfigured()) {
+            return { type: 'error', message: 'BillDog SDK not configured.' };
+        }
+        if (!(native === null || native === void 0 ? void 0 : native.getPresentationResult)) {
+            return { type: 'noPaywall', reason: 'Native placement bridge not wired' };
+        }
+        try {
+            const raw = await native.getPresentationResult(placementId);
+            if (raw && typeof raw.type === 'string')
+                return raw;
+            return { type: 'error', message: 'Malformed presentation result' };
+        }
+        catch (e) {
+            return { type: 'error', message: (_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : 'Presentation evaluation failed' };
+        }
+    },
+    /**
+     * Execute a server-side paywall tap action (Route B).
+     * Delegates to native SDK bridge `executeAction` if present; falls back to direct
+     * JavaScript fetch request to `execute-paywall-action` Edge Function if native is absent.
+     */
+    async executeAction(paywallId, componentId, actionType, idempotencyKey = null, metadata) {
+        if (native === null || native === void 0 ? void 0 : native.executeAction) {
+            try {
+                return await native.executeAction(paywallId, componentId, actionType, idempotencyKey, metadata);
+            }
+            catch (e) {
+                throw e;
+            }
+        }
+        try {
+            const endpoint = BillDogConfiguration_1.BillDogConfiguration.resolveEndpoint('execute-paywall-action');
+            const apiKey = BillDogConfiguration_1.BillDogConfiguration.getApiKey();
+            const appUserId = this.getAppUserId();
+            const body = {
+                paywall_id: paywallId,
+                component_id: componentId,
+                action_type: actionType,
+                idempotency_key: idempotencyKey,
+            };
+            if (appUserId) {
+                body.app_user_id = appUserId;
+            }
+            if (metadata) {
+                body.metadata = metadata;
+            }
+            const response = await fetch(endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-BillDog-API-Key': apiKey,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(errorText || `HTTP ${response.status}`);
+            }
+            return await response.json();
+        }
+        catch (e) {
+            if (BillDogConfiguration_1.BillDogConfiguration.config.enableLogging) {
+                console.error('[BillDog] Failed to execute action:', e);
+            }
+            throw e;
+        }
+    },
+};
+/**
+ * Forward a single provider attribution id to the native `setAttribution`
+ * bridge. `null` is a documented no-op (native has no clear). Best-effort —
+ * native/bridge errors are swallowed so attribution never breaks a host app.
+ */
+function setAttributionKey(key, id) {
+    if (!(native === null || native === void 0 ? void 0 : native.setAttribution) || id == null)
+        return;
+    try {
+        native.setAttribution({ [key]: id });
+    }
+    catch {
+        /* swallow — attribution is best-effort */
+    }
+}