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

package/dist/models/CustomProduct.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * CustomProduct — Superwall-style non-StoreKit / non-Play product.
+ *
+ * Spec:     PUR-363, PUR-364
+ *
+ * Used to describe products that don't live in the App Store or Play Console
+ * (Stripe SKUs, Paddle plans, in-house entitlements). Routing is **only**
+ * dispatched through a host-provided PurchaseController; the bundled internal
+ * controller will reject custom products.
+ *
+ * Field names are kept identical to the native iOS (CustomProduct.swift) and
+ * Android (CustomProduct.kt) models so the contract is the same across SDKs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/CustomerInfo.d.ts

@@ -0,0 +1,17 @@
+import type { EntitlementInfo } from './EntitlementInfo';
+/**
+ * Server-authoritative CustomerInfo (PUR-120, PUR-121, PUR-123).
+ */
+export interface CustomerInfo {
+    userId: string;
+    entitlements: EntitlementInfo[];
+    activeSubscriptions: string[];
+    originalAppUserId?: string;
+    isInTrial?: boolean;
+    isInGracePeriod?: boolean;
+    hasExpiredSubscription?: boolean;
+    /** PUR-121: instant local resolution before backend confirms. */
+    productEntitlementMapping: Record<string, string[]>;
+}
+/** PUR-121: resolve entitlements unlocked by a product ID without a server hop. */
+export declare function entitlementsByProductId(info: CustomerInfo, productId: string): EntitlementInfo[];

package/dist/models/CustomerInfo.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entitlementsByProductId = entitlementsByProductId;
+/** PUR-121: resolve entitlements unlocked by a product ID without a server hop. */
+function entitlementsByProductId(info, productId) {
+    var _a;
+    const ids = (_a = info.productEntitlementMapping) === null || _a === void 0 ? void 0 : _a[productId];
+    if (!ids || ids.length === 0)
+        return [];
+    return info.entitlements.filter((e) => ids.includes(e.identifier));
+}

package/dist/models/Delegate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * BillDogDelegate — typed lifecycle callbacks (Android parity:
+ * `BillDog.delegate` at BillDog.kt:71, BillDogDelegate interface).
+ *
+ * Consumers set a delegate via `BillDog.setDelegate(d)`. All callbacks are
+ * optional; the SDK fires the ones that are defined. The contract is
+ * intentionally flat so each platform can implement it as a class, plain
+ * object, or function set as the host conventions dictate.
+ */
+import type { SkipReason } from './Placement';
+export interface BillDogDelegate {
+    onPaywallPresented?: (paywallId: string) => void;
+    onPaywallDismissed?: (paywallId: string) => void;
+    onPaywallSkipped?: (placementId: string, reason: SkipReason) => void;
+    onPurchaseStarted?: (productId: string) => void;
+    onPurchaseCompleted?: (productId: string) => void;
+    onPurchaseFailed?: (productId: string, error: string) => void;
+    onRestoreCompleted?: (itemCount: number) => void;
+    onSubscriptionStatusChanged?: (status: string) => void;
+}

package/dist/models/Delegate.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * BillDogDelegate — typed lifecycle callbacks (Android parity:
+ * `BillDog.delegate` at BillDog.kt:71, BillDogDelegate interface).
+ *
+ * Consumers set a delegate via `BillDog.setDelegate(d)`. All callbacks are
+ * optional; the SDK fires the ones that are defined. The contract is
+ * intentionally flat so each platform can implement it as a class, plain
+ * object, or function set as the host conventions dictate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/EntitlementInfo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Entitlement lifecycle state — 6 canonical cases (PUR-122).
+ */
+export type EntitlementState = 'ACTIVE' | 'TRIAL' | 'GRACE_PERIOD' | 'BILLING_RETRY' | 'EXPIRED' | 'REVOKED' | 'UNKNOWN';
+export interface EntitlementInfo {
+    identifier: string;
+    isActive: boolean;
+    expiresAt?: string;
+    store?: string;
+    grantedAt?: string;
+    displayName?: string;
+    willRenew?: boolean;
+    isLifetime?: boolean;
+    state?: EntitlementState;
+    productIds?: string[];
+    startsAt?: string;
+    renewedAt?: string;
+    latestProductId?: string;
+}

package/dist/models/EntitlementInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/Placement.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Placement-registration types — Android parity contract.
+ *
+ * Reference: native-sdks/android/billdog-core/src/main/java/com/billdog/core/BillDog.kt
+ *  - register() at line 981 / 990
+ *  - hasAccessForPlacement() at line 1024
+ *  - getPresentationResult() at line 1938
+ *  - PlacementResult sealed class (PlacementManager.kt)
+ *  - PaywallPresentationHandler (PaywallPresentationHandler.kt)
+ *  - PresentationResult sealed class (BillDog.kt:2059)
+ *  - SkipReason enum (BillDogDelegate.kt)
+ *  - PaywallLoadingState enum
+ */
+/** Outcome of a placement registration call. */
+export type PlacementResult = {
+    type: 'entitled';
+} | {
+    type: 'purchased';
+    productId: string;
+} | {
+    type: 'dismissed';
+} | {
+    type: 'restored';
+} | {
+    type: 'error';
+    message: string;
+};
+/** Synchronous "what would happen if I registered this placement?" answer. */
+export type PresentationResult = {
+    type: 'paywall';
+} | {
+    type: 'userSubscribed';
+} | {
+    type: 'noPaywall';
+    reason: string;
+} | {
+    type: 'holdout';
+} | {
+    type: 'error';
+    message: string;
+};
+export type PaywallLoadingState = 'loading' | 'ready' | 'failed';
+export type SkipReason = 'user_has_entitlement' | 'holdout' | 'no_paywall_configured' | 'error';
+export type PostPurchaseBehavior = 'close' | 'keep_open';
+/** Optional lifecycle callbacks for `register()`. All callbacks are optional. */
+export interface PaywallPresentationHandler {
+    onPresent?: (paywallId: string) => void;
+    onDismiss?: (paywallId: string) => void;
+    onError?: (error: Error) => void;
+    onSkip?: (reason: SkipReason) => void;
+    onPurchaseSuccess?: (productId: string) => PostPurchaseBehavior | void;
+    onFinish?: (paywallId: string, shouldDismiss: boolean) => boolean;
+    onLoadingStateChange?: (state: PaywallLoadingState) => void;
+}

package/dist/models/Placement.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Placement-registration types — Android parity contract.
+ *
+ * Reference: native-sdks/android/billdog-core/src/main/java/com/billdog/core/BillDog.kt
+ *  - register() at line 981 / 990
+ *  - hasAccessForPlacement() at line 1024
+ *  - getPresentationResult() at line 1938
+ *  - PlacementResult sealed class (PlacementManager.kt)
+ *  - PaywallPresentationHandler (PaywallPresentationHandler.kt)
+ *  - PresentationResult sealed class (BillDog.kt:2059)
+ *  - SkipReason enum (BillDogDelegate.kt)
+ *  - PaywallLoadingState enum
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/PurchaseParams.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PurchaseParams — RN bridge mirror of iOS/Android `PurchaseParams.Builder`.
+ *
+ * Spec:     PUR-314, PUR-350, PUR-364
+ * Standard: mem://architecture/purchase-conformance-standard
+ *
+ * Cross-platform typed parameters for `BillDog.purchase(params)`. All fields
+ * other than `productId` are optional. Use the static `builder()` for fluent
+ * construction matching the native SDKs.
+ */
+export type GoogleReplacementMode = 'WITH_TIME_PRORATION' | 'CHARGE_PRORATED_PRICE' | 'WITHOUT_PRORATION' | 'CHARGE_FULL_PRICE' | 'DEFERRED';
+export interface PurchaseParams {
+    productId: string;
+    offerToken?: string;
+    promoOfferId?: string;
+    winBackOfferId?: string;
+    appAccountToken?: string;
+    obfuscatedProfileId?: string;
+    quantity?: number;
+    isPersonalizedOffer?: boolean;
+    replacementMode?: GoogleReplacementMode;
+}
+export declare class PurchaseParamsBuilder {
+    private params;
+    constructor(productId: string);
+    offerToken(value: string | undefined): this;
+    promoOfferId(value: string | undefined): this;
+    winBackOfferId(value: string | undefined): this;
+    appAccountToken(value: string | undefined): this;
+    obfuscatedProfileId(value: string | undefined): this;
+    quantity(value: number): this;
+    isPersonalizedOffer(value: boolean | undefined): this;
+    replacementMode(value: GoogleReplacementMode | undefined): this;
+    build(): PurchaseParams;
+}
+export declare const PurchaseParams: {
+    /** Fluent builder — mirrors RevenueCat 5.x `PurchaseParams.Builder`. */
+    builder(productId: string): PurchaseParamsBuilder;
+};

package/dist/models/PurchaseParams.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * PurchaseParams — RN bridge mirror of iOS/Android `PurchaseParams.Builder`.
+ *
+ * Spec:     PUR-314, PUR-350, PUR-364
+ * Standard: mem://architecture/purchase-conformance-standard
+ *
+ * Cross-platform typed parameters for `BillDog.purchase(params)`. All fields
+ * other than `productId` are optional. Use the static `builder()` for fluent
+ * construction matching the native SDKs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurchaseParams = exports.PurchaseParamsBuilder = void 0;
+class PurchaseParamsBuilder {
+    constructor(productId) {
+        this.params = { productId, quantity: 1 };
+    }
+    offerToken(value) {
+        this.params.offerToken = value;
+        return this;
+    }
+    promoOfferId(value) {
+        this.params.promoOfferId = value;
+        return this;
+    }
+    winBackOfferId(value) {
+        this.params.winBackOfferId = value;
+        return this;
+    }
+    appAccountToken(value) {
+        this.params.appAccountToken = value;
+        return this;
+    }
+    obfuscatedProfileId(value) {
+        this.params.obfuscatedProfileId = value;
+        return this;
+    }
+    quantity(value) {
+        this.params.quantity = value < 1 ? 1 : value;
+        return this;
+    }
+    isPersonalizedOffer(value) {
+        this.params.isPersonalizedOffer = value;
+        return this;
+    }
+    replacementMode(value) {
+        this.params.replacementMode = value;
+        return this;
+    }
+    build() {
+        return { ...this.params };
+    }
+}
+exports.PurchaseParamsBuilder = PurchaseParamsBuilder;
+exports.PurchaseParams = {
+    /** Fluent builder — mirrors RevenueCat 5.x `PurchaseParams.Builder`. */
+    builder(productId) {
+        return new PurchaseParamsBuilder(productId);
+    },
+};

package/dist/models/PurchaseResult.d.ts

@@ -0,0 +1,30 @@
+/**
+ * PurchaseResult — canonical 5-case discriminated union for any purchase op.
+ *
+ * Spec:     PUR-180, PUR-181, PUR-182, PUR-058, PUR-059, PUR-364
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *
+ * Mirrored byte-identically with iOS/Android. User cancellation MUST surface
+ * as `cancelled` (never `failed`); Ask-to-Buy / Android PENDING MUST surface
+ * as `pending`.
+ */
+import type { BillDogError } from './BillDogError';
+export type PurchaseResult = {
+    type: 'purchased';
+    transactionId: string;
+    productId: string;
+    originalTransactionId?: string;
+} | {
+    type: 'cancelled';
+} | {
+    type: 'pending';
+} | {
+    type: 'failed';
+    error: BillDogError;
+} | {
+    type: 'restored';
+    transactionId: string;
+    productId: string;
+    originalTransactionId?: string;
+};
+export declare const isSuccess: (r: PurchaseResult) => boolean;

package/dist/models/PurchaseResult.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * PurchaseResult — canonical 5-case discriminated union for any purchase op.
+ *
+ * Spec:     PUR-180, PUR-181, PUR-182, PUR-058, PUR-059, PUR-364
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *
+ * Mirrored byte-identically with iOS/Android. User cancellation MUST surface
+ * as `cancelled` (never `failed`); Ask-to-Buy / Android PENDING MUST surface
+ * as `pending`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSuccess = void 0;
+const isSuccess = (r) => r.type === 'purchased' || r.type === 'restored';
+exports.isSuccess = isSuccess;

package/dist/models/RestoreResult.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Canonical RestoreResult — 2-case discriminated union for restore operations.
+ *
+ * Spec:     PUR-080, PUR-081, PUR-082 (.lovable/purchase-conformance-spec.md)
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *           mem://architecture/react-native/sdk-unified-standard
+ *
+ * Mirrored byte-identically across iOS/Android/Flutter.
+ *
+ *  - `restored` : restore succeeded; `items` MAY be empty (= nothing
+ *                 to restore, PUR-080). Callers MUST NOT treat empty
+ *                 as failure.
+ *  - `failed`   : global failure (network, store sync threw).
+ *                 Per-transaction failures live in `RestoredItem.status`,
+ *                 never here.
+ */
+import type { BillDogError } from './BillDogError';
+import type { RestoredItem } from './RestoredItem';
+export type RestoreResult = {
+    type: 'restored';
+    items: RestoredItem[];
+} | {
+    type: 'failed';
+    error: BillDogError;
+};
+/** Convenience: was the restore globally successful? */
+export declare const isRestoreOk: (r: RestoreResult) => r is {
+    type: "restored";
+    items: RestoredItem[];
+};

package/dist/models/RestoreResult.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Canonical RestoreResult — 2-case discriminated union for restore operations.
+ *
+ * Spec:     PUR-080, PUR-081, PUR-082 (.lovable/purchase-conformance-spec.md)
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *           mem://architecture/react-native/sdk-unified-standard
+ *
+ * Mirrored byte-identically across iOS/Android/Flutter.
+ *
+ *  - `restored` : restore succeeded; `items` MAY be empty (= nothing
+ *                 to restore, PUR-080). Callers MUST NOT treat empty
+ *                 as failure.
+ *  - `failed`   : global failure (network, store sync threw).
+ *                 Per-transaction failures live in `RestoredItem.status`,
+ *                 never here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRestoreOk = void 0;
+/** Convenience: was the restore globally successful? */
+const isRestoreOk = (r) => r.type === 'restored';
+exports.isRestoreOk = isRestoreOk;

package/dist/models/RestoredItem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * RestoredItem & RestoreItemStatus — canonical per-transaction restore record.
+ *
+ * Spec:     PUR-081, PUR-082 (.lovable/purchase-conformance-spec.md)
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *           mem://architecture/react-native/sdk-unified-standard
+ *
+ * Mirrored byte-identically across iOS/Android/Flutter. Per-transaction
+ * failure MUST be reported in `status` — never collapsed into a global
+ * `RestoreResult.failed`.
+ */
+import type { BillDogError } from './BillDogError';
+export type RestoreItemStatus = {
+    type: 'restored';
+} | {
+    type: 'expired';
+} | {
+    type: 'failed';
+    error: BillDogError;
+};
+export interface RestoredItem {
+    productId: string;
+    transactionId: string;
+    originalTransactionId?: string;
+    status: RestoreItemStatus;
+}

package/dist/models/RestoredItem.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * RestoredItem & RestoreItemStatus — canonical per-transaction restore record.
+ *
+ * Spec:     PUR-081, PUR-082 (.lovable/purchase-conformance-spec.md)
+ * Standard: mem://architecture/purchase-authoritative-standard
+ *           mem://architecture/react-native/sdk-unified-standard
+ *
+ * Mirrored byte-identically across iOS/Android/Flutter. Per-transaction
+ * failure MUST be reported in `status` — never collapsed into a global
+ * `RestoreResult.failed`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/ABTest.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @billdog.io/react-native — A/B Testing Module
+ *
+ * Native bridge to BillDogABTest (iOS) / billdog-abtest (Android).
+ * Provides experiment assignment, variant retrieval, and conversion tracking.
+ *
+ * Types and methods align 1:1 with the native SDK surface.
+ */
+export interface ExperimentAssignment {
+    experimentId: string;
+    variantId: string;
+    variantName: string;
+    config: Record<string, any>;
+    isControl: boolean;
+}
+export declare class ABTestManager {
+    private static instance;
+    private initialized;
+    private constructor();
+    static getInstance(): ABTestManager;
+    /**
+     * Initialize the A/B Testing module.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the variant assignment for an experiment.
+     * Returns the cached assignment if available, otherwise fetches from the server.
+     */
+    getVariant(experimentId: string): Promise<ExperimentAssignment | null>;
+    /**
+     * Track a conversion event for an experiment.
+     */
+    trackConversion(experimentId: string, value?: number, metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Track an impression event for an experiment.
+     */
+    trackImpression(experimentId: string): Promise<void>;
+    /**
+     * Set the user ID for server-side experiment assignment.
+     * Triggers automatic experiment refresh (matching native behavior).
+     */
+    setUserId(id: string): Promise<void>;
+    /**
+     * Set user attributes for experiment targeting.
+     */
+    setAttributes(attributes: Record<string, any>): Promise<void>;
+    /**
+     * Get a feature flag value.
+     */
+    getFeatureFlag(key: string): Promise<any>;
+    /**
+     * Refresh experiment assignments from the server.
+     */
+    refreshExperiments(): Promise<void>;
+    /**
+     * Reset all experiment state and cached assignments.
+     */
+    reset(): Promise<void>;
+    /**
+     * Listen to assignment changes (e.g., after refresh).
+     */
+    onAssignmentChanged(callback: (assignment: ExperimentAssignment) => void): import("react-native").EmitterSubscription | undefined;
+}
+declare const _default: ABTestManager;
+export default _default;

package/dist/modules/ABTest.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * @billdog.io/react-native — A/B Testing Module
+ *
+ * Native bridge to BillDogABTest (iOS) / billdog-abtest (Android).
+ * Provides experiment assignment, variant retrieval, and conversion tracking.
+ *
+ * Types and methods align 1:1 with the native SDK surface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ABTestManager = void 0;
+const react_native_1 = require("react-native");
+const { BillDogABTest } = react_native_1.NativeModules;
+const eventEmitter = BillDogABTest ? new react_native_1.NativeEventEmitter(BillDogABTest) : null;
+// MARK: - A/B Test Manager
+class ABTestManager {
+    constructor() {
+        this.initialized = false;
+    }
+    static getInstance() {
+        if (!ABTestManager.instance) {
+            ABTestManager.instance = new ABTestManager();
+        }
+        return ABTestManager.instance;
+    }
+    /**
+     * Initialize the A/B Testing module.
+     */
+    async initialize() {
+        if (!BillDogABTest) {
+            console.warn('[BillDogABTest] Native module not linked. A/B Testing will be no-op.');
+            return;
+        }
+        await BillDogABTest.initialize();
+        this.initialized = true;
+    }
+    /**
+     * Get the variant assignment for an experiment.
+     * Returns the cached assignment if available, otherwise fetches from the server.
+     */
+    async getVariant(experimentId) {
+        if (!this.initialized || !BillDogABTest)
+            return null;
+        return await BillDogABTest.getVariant(experimentId);
+    }
+    /**
+     * Track a conversion event for an experiment.
+     */
+    async trackConversion(experimentId, value, metadata) {
+        if (!this.initialized || !BillDogABTest)
+            return;
+        await BillDogABTest.trackConversion(experimentId, value !== null && value !== void 0 ? value : 1, metadata !== null && metadata !== void 0 ? metadata : {});
+    }
+    /**
+     * Track an impression event for an experiment.
+     */
+    async trackImpression(experimentId) {
+        if (!this.initialized || !BillDogABTest)
+            return;
+        await BillDogABTest.trackImpression(experimentId);
+    }
+    /**
+     * Set the user ID for server-side experiment assignment.
+     * Triggers automatic experiment refresh (matching native behavior).
+     */
+    async setUserId(id) {
+        if (!BillDogABTest)
+            return;
+        await BillDogABTest.setUserId(id);
+    }
+    /**
+     * Set user attributes for experiment targeting.
+     */
+    async setAttributes(attributes) {
+        if (!BillDogABTest)
+            return;
+        await BillDogABTest.setAttributes(attributes);
+    }
+    /**
+     * Get a feature flag value.
+     */
+    async getFeatureFlag(key) {
+        if (!this.initialized || !BillDogABTest)
+            return null;
+        return await BillDogABTest.getFeatureFlag(key);
+    }
+    /**
+     * Refresh experiment assignments from the server.
+     */
+    async refreshExperiments() {
+        if (!this.initialized || !BillDogABTest)
+            return;
+        await BillDogABTest.refreshExperiments();
+    }
+    /**
+     * Reset all experiment state and cached assignments.
+     */
+    async reset() {
+        if (!BillDogABTest)
+            return;
+        await BillDogABTest.reset();
+        this.initialized = false;
+    }
+    /**
+     * Listen to assignment changes (e.g., after refresh).
+     */
+    onAssignmentChanged(callback) {
+        return eventEmitter === null || eventEmitter === void 0 ? void 0 : eventEmitter.addListener('onExperimentAssignmentChanged', callback);
+    }
+}
+exports.ABTestManager = ABTestManager;
+ABTestManager.instance = null;
+exports.default = ABTestManager.getInstance();