@sudobility/subscription_lib 0.0.1

package/dist/hooks/useSubscriptionForPeriod.d.ts

@@ -0,0 +1,48 @@
+/**
+ * useSubscriptionForPeriod Hook
+ *
+ * Get packages filtered by billing period, sorted by price.
+ */
+import type { SubscriptionPackage } from '../types/subscription';
+import type { SubscriptionPeriod } from '../types/period';
+/**
+ * Result of useSubscriptionForPeriod hook
+ */
+export interface UseSubscriptionForPeriodResult {
+    /** Packages for the period, sorted by price (ascending), includes free tier first */
+    packages: SubscriptionPackage[];
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+}
+/**
+ * Hook to get packages filtered by billing period
+ *
+ * Returns packages sorted by price (ascending):
+ * - Free tier first (if configured)
+ * - Then paid packages from lowest to highest price
+ *
+ * @param offerId Offer identifier
+ * @param period Billing period to filter by
+ * @returns Filtered and sorted packages
+ *
+ * @example
+ * ```typescript
+ * const { packages, isLoading } = useSubscriptionForPeriod('default', 'monthly');
+ *
+ * return (
+ *   <div className="grid">
+ *     {packages.map(pkg => (
+ *       <SubscriptionTile
+ *         key={pkg.packageId}
+ *         title={pkg.name}
+ *         price={pkg.product?.priceString ?? 'Free'}
+ *       />
+ *     ))}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useSubscriptionForPeriod(offerId: string, period: SubscriptionPeriod): UseSubscriptionForPeriodResult;
+//# sourceMappingURL=useSubscriptionForPeriod.d.ts.map

package/dist/hooks/useSubscriptionForPeriod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptionForPeriod.d.ts","sourceRoot":"","sources":["../../src/hooks/useSubscriptionForPeriod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAO1D;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,qFAAqF;IACrF,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,8BAA8B,CA6BhC"}

package/dist/hooks/useSubscriptionForPeriod.js

@@ -0,0 +1,59 @@
+/**
+ * useSubscriptionForPeriod Hook
+ *
+ * Get packages filtered by billing period, sorted by price.
+ */
+import { useMemo } from 'react';
+import { useSubscriptions } from './useSubscriptions';
+import { getSubscriptionInstance, isSubscriptionInitialized, } from '../core/singleton';
+/**
+ * Hook to get packages filtered by billing period
+ *
+ * Returns packages sorted by price (ascending):
+ * - Free tier first (if configured)
+ * - Then paid packages from lowest to highest price
+ *
+ * @param offerId Offer identifier
+ * @param period Billing period to filter by
+ * @returns Filtered and sorted packages
+ *
+ * @example
+ * ```typescript
+ * const { packages, isLoading } = useSubscriptionForPeriod('default', 'monthly');
+ *
+ * return (
+ *   <div className="grid">
+ *     {packages.map(pkg => (
+ *       <SubscriptionTile
+ *         key={pkg.packageId}
+ *         title={pkg.name}
+ *         price={pkg.product?.priceString ?? 'Free'}
+ *       />
+ *     ))}
+ *   </div>
+ * );
+ * ```
+ */
+export function useSubscriptionForPeriod(offerId, period) {
+    const { offer, isLoading, error } = useSubscriptions(offerId);
+    const packages = useMemo(() => {
+        if (!offer)
+            return [];
+        // Filter packages by period
+        const periodPackages = offer.packages.filter(pkg => pkg.product && pkg.product.period === period);
+        // Sort by price ascending
+        periodPackages.sort((a, b) => {
+            const priceA = a.product?.price ?? 0;
+            const priceB = b.product?.price ?? 0;
+            return priceA - priceB;
+        });
+        // Add free tier at the beginning if subscription is initialized
+        if (isSubscriptionInitialized()) {
+            const service = getSubscriptionInstance();
+            const freeTier = service.getFreeTierPackage();
+            return [freeTier, ...periodPackages];
+        }
+        return periodPackages;
+    }, [offer, period]);
+    return { packages, isLoading, error };
+}

package/dist/hooks/useSubscriptionPeriods.d.ts

@@ -0,0 +1,38 @@
+/**
+ * useSubscriptionPeriods Hook
+ *
+ * Extract unique billing periods from an offer's packages.
+ */
+import type { SubscriptionPeriod } from '../types/period';
+/**
+ * Result of useSubscriptionPeriods hook
+ */
+export interface UseSubscriptionPeriodsResult {
+    /** Available periods sorted (weekly → monthly → quarterly → yearly → lifetime) */
+    periods: SubscriptionPeriod[];
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+}
+/**
+ * Hook to get available billing periods from an offer
+ *
+ * @param offerId Offer identifier
+ * @returns Available periods, sorted from shortest to longest
+ *
+ * @example
+ * ```typescript
+ * const { periods, isLoading } = useSubscriptionPeriods('default');
+ *
+ * return (
+ *   <SegmentedControl
+ *     options={periods.map(p => ({ value: p, label: capitalize(p) }))}
+ *     value={selectedPeriod}
+ *     onChange={setSelectedPeriod}
+ *   />
+ * );
+ * ```
+ */
+export declare function useSubscriptionPeriods(offerId: string): UseSubscriptionPeriodsResult;
+//# sourceMappingURL=useSubscriptionPeriods.d.ts.map

package/dist/hooks/useSubscriptionPeriods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptionPeriods.d.ts","sourceRoot":"","sources":["../../src/hooks/useSubscriptionPeriods.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GACd,4BAA4B,CAoB9B"}

package/dist/hooks/useSubscriptionPeriods.js

@@ -0,0 +1,44 @@
+/**
+ * useSubscriptionPeriods Hook
+ *
+ * Extract unique billing periods from an offer's packages.
+ */
+import { useMemo } from 'react';
+import { ALL_PERIODS } from '../types/period';
+import { useSubscriptions } from './useSubscriptions';
+/**
+ * Hook to get available billing periods from an offer
+ *
+ * @param offerId Offer identifier
+ * @returns Available periods, sorted from shortest to longest
+ *
+ * @example
+ * ```typescript
+ * const { periods, isLoading } = useSubscriptionPeriods('default');
+ *
+ * return (
+ *   <SegmentedControl
+ *     options={periods.map(p => ({ value: p, label: capitalize(p) }))}
+ *     value={selectedPeriod}
+ *     onChange={setSelectedPeriod}
+ *   />
+ * );
+ * ```
+ */
+export function useSubscriptionPeriods(offerId) {
+    const { offer, isLoading, error } = useSubscriptions(offerId);
+    const periods = useMemo(() => {
+        if (!offer)
+            return [];
+        // Collect unique periods from packages that have products
+        const periodSet = new Set();
+        for (const pkg of offer.packages) {
+            if (pkg.product) {
+                periodSet.add(pkg.product.period);
+            }
+        }
+        // Sort by the standard order
+        return ALL_PERIODS.filter(p => periodSet.has(p));
+    }, [offer]);
+    return { periods, isLoading, error };
+}

package/dist/hooks/useSubscriptions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * useSubscriptions Hook
+ *
+ * Fetch and manage subscription offer data.
+ */
+import type { SubscriptionOffer } from '../types/subscription';
+/**
+ * Result of useSubscriptions hook
+ */
+export interface UseSubscriptionsResult {
+    /** The requested offer, null if not found or loading */
+    offer: SubscriptionOffer | null;
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+    /** Manually refetch the data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to get subscription offer data
+ *
+ * @param offerId Offer identifier to fetch
+ * @returns Offer data, loading state, and error
+ *
+ * @example
+ * ```typescript
+ * const { offer, isLoading, error } = useSubscriptions('default');
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ *
+ * return (
+ *   <div>
+ *     {offer?.packages.map(pkg => (
+ *       <SubscriptionTile key={pkg.packageId} package={pkg} />
+ *     ))}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useSubscriptions(offerId: string): UseSubscriptionsResult;
+//# sourceMappingURL=useSubscriptions.d.ts.map

package/dist/hooks/useSubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscriptions.d.ts","sourceRoot":"","sources":["../../src/hooks/useSubscriptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAsDxE"}

package/dist/hooks/useSubscriptions.js

@@ -0,0 +1,80 @@
+/**
+ * useSubscriptions Hook
+ *
+ * Fetch and manage subscription offer data.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { getSubscriptionInstance, isSubscriptionInitialized, } from '../core/singleton';
+/**
+ * Hook to get subscription offer data
+ *
+ * @param offerId Offer identifier to fetch
+ * @returns Offer data, loading state, and error
+ *
+ * @example
+ * ```typescript
+ * const { offer, isLoading, error } = useSubscriptions('default');
+ *
+ * if (isLoading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ *
+ * return (
+ *   <div>
+ *     {offer?.packages.map(pkg => (
+ *       <SubscriptionTile key={pkg.packageId} package={pkg} />
+ *     ))}
+ *   </div>
+ * );
+ * ```
+ */
+export function useSubscriptions(offerId) {
+    const [offer, setOffer] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const loadData = useCallback(async () => {
+        if (!isSubscriptionInitialized()) {
+            setError(new Error('Subscription not initialized'));
+            setIsLoading(false);
+            return;
+        }
+        const service = getSubscriptionInstance();
+        try {
+            setIsLoading(true);
+            setError(null);
+            // Load offerings if not already loaded
+            if (!service.hasLoadedOfferings()) {
+                await service.loadOfferings();
+            }
+            const loadedOffer = service.getOffer(offerId);
+            setOffer(loadedOffer);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to load offer'));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [offerId]);
+    useEffect(() => {
+        loadData();
+    }, [loadData]);
+    const refetch = useCallback(async () => {
+        if (!isSubscriptionInitialized())
+            return;
+        const service = getSubscriptionInstance();
+        try {
+            setIsLoading(true);
+            setError(null);
+            await service.loadOfferings();
+            const loadedOffer = service.getOffer(offerId);
+            setOffer(loadedOffer);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to load offer'));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [offerId]);
+    return { offer, isLoading, error, refetch };
+}

package/dist/hooks/useUserSubscription.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useUserSubscription Hook
+ *
+ * Fetch and manage current user's subscription status.
+ */
+import type { CurrentSubscription } from '../types/subscription';
+/**
+ * Result of useUserSubscription hook
+ */
+export interface UseUserSubscriptionResult {
+    /** Current subscription info, null if loading */
+    subscription: CurrentSubscription | null;
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+    /** Manually refetch the data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to get current user's subscription status
+ *
+ * @returns Current subscription data, loading state, and error
+ *
+ * @example
+ * ```typescript
+ * const { subscription, isLoading } = useUserSubscription();
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * if (subscription?.isActive) {
+ *   return <div>Your plan: {subscription.entitlements.join(', ')}</div>;
+ * } else {
+ *   return <div>No active subscription</div>;
+ * }
+ * ```
+ */
+export declare function useUserSubscription(): UseUserSubscriptionResult;
+//# sourceMappingURL=useUserSubscription.d.ts.map

package/dist/hooks/useUserSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserSubscription.d.ts","sourceRoot":"","sources":["../../src/hooks/useUserSubscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CA4D/D"}

package/dist/hooks/useUserSubscription.js

@@ -0,0 +1,76 @@
+/**
+ * useUserSubscription Hook
+ *
+ * Fetch and manage current user's subscription status.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { getSubscriptionInstance, isSubscriptionInitialized, } from '../core/singleton';
+/**
+ * Hook to get current user's subscription status
+ *
+ * @returns Current subscription data, loading state, and error
+ *
+ * @example
+ * ```typescript
+ * const { subscription, isLoading } = useUserSubscription();
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * if (subscription?.isActive) {
+ *   return <div>Your plan: {subscription.entitlements.join(', ')}</div>;
+ * } else {
+ *   return <div>No active subscription</div>;
+ * }
+ * ```
+ */
+export function useUserSubscription() {
+    const [subscription, setSubscription] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const loadData = useCallback(async () => {
+        if (!isSubscriptionInitialized()) {
+            setError(new Error('Subscription not initialized'));
+            setIsLoading(false);
+            return;
+        }
+        const service = getSubscriptionInstance();
+        try {
+            setIsLoading(true);
+            setError(null);
+            // Load customer info if not already loaded
+            if (!service.hasLoadedCustomerInfo()) {
+                await service.loadCustomerInfo();
+            }
+            const currentSub = service.getCurrentSubscription();
+            setSubscription(currentSub);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to load subscription'));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, []);
+    useEffect(() => {
+        loadData();
+    }, [loadData]);
+    const refetch = useCallback(async () => {
+        if (!isSubscriptionInitialized())
+            return;
+        const service = getSubscriptionInstance();
+        try {
+            setIsLoading(true);
+            setError(null);
+            await service.loadCustomerInfo();
+            const currentSub = service.getCurrentSubscription();
+            setSubscription(currentSub);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to load subscription'));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, []);
+    return { subscription, isLoading, error, refetch };
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @sudobility/subscription_lib
+ *
+ * Cross-platform subscription management library with RevenueCat adapter pattern.
+ * Works with both React (web) and React Native.
+ */
+export { initializeSubscription, getSubscriptionInstance, isSubscriptionInitialized, resetSubscription, refreshSubscription, SubscriptionService, type SubscriptionConfig, type SubscriptionServiceConfig, } from './core';
+export { useSubscriptions, useUserSubscription, useSubscriptionPeriods, useSubscriptionForPeriod, useSubscribable, type UseSubscriptionsResult, type UseUserSubscriptionResult, type UseSubscriptionPeriodsResult, type UseSubscriptionForPeriodResult, type UseSubscribableResult, } from './hooks';
+export type { SubscriptionAdapter, AdapterOfferings, AdapterOffering, AdapterPackage, AdapterProduct, AdapterSubscriptionOption, AdapterPricingPhase, AdapterCustomerInfo, AdapterEntitlementInfo, AdapterPurchaseParams, AdapterPurchaseResult, SubscriptionProduct, SubscriptionPackage, SubscriptionOffer, CurrentSubscription, FreeTierConfig, PackageWithLevel, SubscriptionPeriod, } from './types';
+export { PERIOD_RANKS, ALL_PERIODS } from './types';
+export { parseISO8601Period, getPeriodRank, comparePeriods, isPeriodGreaterOrEqual, calculatePackageLevels, addLevelsToPackages, getPackageLevel, findUpgradeablePackages, } from './utils';
+//# 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":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,GAC3B,MAAM,SAAS,CAAC;AAGjB,YAAY,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EAErB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAEhB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @sudobility/subscription_lib
+ *
+ * Cross-platform subscription management library with RevenueCat adapter pattern.
+ * Works with both React (web) and React Native.
+ */
+// Core
+export { initializeSubscription, getSubscriptionInstance, isSubscriptionInitialized, resetSubscription, refreshSubscription, SubscriptionService, } from './core';
+// Hooks
+export { useSubscriptions, useUserSubscription, useSubscriptionPeriods, useSubscriptionForPeriod, useSubscribable, } from './hooks';
+export { PERIOD_RANKS, ALL_PERIODS } from './types';
+// Utils
+export { parseISO8601Period, getPeriodRank, comparePeriods, isPeriodGreaterOrEqual, calculatePackageLevels, addLevelsToPackages, getPackageLevel, findUpgradeablePackages, } from './utils';

package/dist/types/adapter.d.ts

@@ -0,0 +1,149 @@
+/**
+ * RevenueCat Adapter Interface
+ *
+ * Platform-agnostic interface that abstracts RevenueCat SDK differences
+ * between web (@revenuecat/purchases-js) and React Native (react-native-purchases).
+ */
+/**
+ * Pricing phase information for trials and intro prices
+ */
+export interface AdapterPricingPhase {
+    /** Duration in ISO 8601 format (e.g., "P7D", "P1M") */
+    periodDuration: string | null;
+    /** Price in standard units (not micros), null for free trials */
+    price: number | null;
+    /** Formatted price string, null for free trials */
+    priceString: string | null;
+    /** Number of billing cycles for this phase */
+    cycleCount: number;
+}
+/**
+ * Subscription option with trial and intro price information
+ */
+export interface AdapterSubscriptionOption {
+    /** Unique identifier for this option */
+    id: string;
+    /** Trial phase information, null if no trial */
+    trial: AdapterPricingPhase | null;
+    /** Introductory price phase, null if no intro price */
+    introPrice: AdapterPricingPhase | null;
+}
+/**
+ * Product information from RevenueCat
+ */
+export interface AdapterProduct {
+    /** Product ID from the store */
+    identifier: string;
+    /** Display title */
+    title: string;
+    /** Product description */
+    description: string | null;
+    /** Price in standard units (e.g., 9.99 not 9990000) */
+    price: number;
+    /** Formatted price string (e.g., "$9.99") */
+    priceString: string;
+    /** Currency code (e.g., "USD") */
+    currencyCode: string;
+    /** Billing period in ISO 8601 format (e.g., "P1M", "P1Y"), null for non-subscriptions */
+    normalPeriodDuration: string | null;
+    /** Available subscription options with offers */
+    subscriptionOptions?: Record<string, AdapterSubscriptionOption>;
+}
+/**
+ * Package containing a product
+ */
+export interface AdapterPackage {
+    /** Package identifier (e.g., "pro_monthly") */
+    identifier: string;
+    /** Package type (e.g., "$rc_monthly", "custom") */
+    packageType: string;
+    /** The product in this package */
+    product: AdapterProduct;
+}
+/**
+ * Offering containing packages
+ */
+export interface AdapterOffering {
+    /** Offering identifier */
+    identifier: string;
+    /** Offering metadata from RevenueCat dashboard */
+    metadata: Record<string, unknown> | null;
+    /** Available packages in this offering */
+    availablePackages: AdapterPackage[];
+}
+/**
+ * All offerings response
+ */
+export interface AdapterOfferings {
+    /** Map of all offerings by identifier */
+    all: Record<string, AdapterOffering>;
+    /** Current/default offering */
+    current: AdapterOffering | null;
+}
+/**
+ * Entitlement info for a customer
+ */
+export interface AdapterEntitlementInfo {
+    /** Entitlement identifier */
+    identifier: string;
+    /** Product that granted this entitlement */
+    productIdentifier: string;
+    /** Expiration date in ISO format, null for lifetime */
+    expirationDate: string | null;
+    /** Whether subscription will auto-renew */
+    willRenew: boolean;
+}
+/**
+ * Customer info from RevenueCat
+ */
+export interface AdapterCustomerInfo {
+    /** Set of active subscription product identifiers */
+    activeSubscriptions: string[];
+    /** Entitlements information */
+    entitlements: {
+        /** Active entitlements map */
+        active: Record<string, AdapterEntitlementInfo>;
+    };
+}
+/**
+ * Parameters for making a purchase
+ */
+export interface AdapterPurchaseParams {
+    /** Package identifier to purchase */
+    packageId: string;
+    /** Offering identifier the package belongs to */
+    offeringId: string;
+    /** Customer email for web billing */
+    customerEmail?: string;
+}
+/**
+ * Result of a purchase operation
+ */
+export interface AdapterPurchaseResult {
+    /** Updated customer info after purchase */
+    customerInfo: AdapterCustomerInfo;
+}
+/**
+ * RevenueCat Adapter Interface
+ *
+ * Implement this interface to provide platform-specific RevenueCat SDK integration.
+ */
+export interface SubscriptionAdapter {
+    /**
+     * Get all configured offerings
+     * @param params Optional parameters like currency
+     */
+    getOfferings(params?: {
+        currency?: string;
+    }): Promise<AdapterOfferings>;
+    /**
+     * Get current customer info including entitlements
+     */
+    getCustomerInfo(): Promise<AdapterCustomerInfo>;
+    /**
+     * Make a purchase
+     * @param params Purchase parameters
+     */
+    purchase(params: AdapterPurchaseParams): Promise<AdapterPurchaseResult>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/adapter.d.ts.map

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

package/dist/types/adapter.js

@@ -0,0 +1,7 @@
+/**
+ * RevenueCat Adapter Interface
+ *
+ * Platform-agnostic interface that abstracts RevenueCat SDK differences
+ * between web (@revenuecat/purchases-js) and React Native (react-native-purchases).
+ */
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Type Exports
+ */
+export type { SubscriptionAdapter, AdapterOfferings, AdapterOffering, AdapterPackage, AdapterProduct, AdapterSubscriptionOption, AdapterPricingPhase, AdapterCustomerInfo, AdapterEntitlementInfo, AdapterPurchaseParams, AdapterPurchaseResult, } from './adapter';
+export type { SubscriptionProduct, SubscriptionPackage, SubscriptionOffer, CurrentSubscription, FreeTierConfig, PackageWithLevel, } from './subscription';
+export type { SubscriptionPeriod } from './period';
+export { PERIOD_RANKS, ALL_PERIODS } from './period';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+/**
+ * Type Exports
+ */
+export { PERIOD_RANKS, ALL_PERIODS } from './period';