@sudobility/subscription_lib 0.0.1

package/dist/types/period.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Subscription Period Types
+ *
+ * Standard subscription periods and utilities for period comparison.
+ */
+/**
+ * Standard subscription periods
+ */
+export type SubscriptionPeriod = 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'lifetime';
+/**
+ * Period ranking for comparison (higher = longer)
+ */
+export declare const PERIOD_RANKS: Record<SubscriptionPeriod, number>;
+/**
+ * All supported periods in order
+ */
+export declare const ALL_PERIODS: SubscriptionPeriod[];
+//# sourceMappingURL=period.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"period.d.ts","sourceRoot":"","sources":["../../src/types/period.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAM3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,kBAAkB,EAM3C,CAAC"}

package/dist/types/period.js

@@ -0,0 +1,25 @@
+/**
+ * Subscription Period Types
+ *
+ * Standard subscription periods and utilities for period comparison.
+ */
+/**
+ * Period ranking for comparison (higher = longer)
+ */
+export const PERIOD_RANKS = {
+    weekly: 1,
+    monthly: 2,
+    quarterly: 3,
+    yearly: 4,
+    lifetime: 5,
+};
+/**
+ * All supported periods in order
+ */
+export const ALL_PERIODS = [
+    'weekly',
+    'monthly',
+    'quarterly',
+    'yearly',
+    'lifetime',
+];

package/dist/types/subscription.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Subscription Types
+ *
+ * Clean abstraction types for subscription data, independent of RevenueCat SDK.
+ */
+import type { SubscriptionPeriod } from './period';
+/**
+ * Product pricing and billing information
+ */
+export interface SubscriptionProduct {
+    /** Product ID from the store */
+    productId: string;
+    /** Product display name */
+    name: string;
+    /** Product description */
+    description?: string;
+    /** Numeric price value */
+    price: number;
+    /** Formatted price string (e.g., "$9.99") */
+    priceString: string;
+    /** Currency code (e.g., "USD") */
+    currency: string;
+    /** Parsed subscription period */
+    period: SubscriptionPeriod;
+    /** Raw ISO 8601 period duration */
+    periodDuration: string;
+    /** Trial period in ISO 8601 format (e.g., "P7D") */
+    trialPeriod?: string;
+    /** Introductory price string */
+    introPrice?: string;
+    /** Introductory price period in ISO 8601 format */
+    introPricePeriod?: string;
+    /** Number of intro price billing cycles */
+    introPriceCycles?: number;
+}
+/**
+ * Package with optional product (undefined for free tier)
+ */
+export interface SubscriptionPackage {
+    /** Package identifier (e.g., "pro_monthly", "free") */
+    packageId: string;
+    /** Package display name */
+    name: string;
+    /** Product information, undefined for free tier */
+    product?: SubscriptionProduct;
+    /** Entitlement identifiers granted by this package */
+    entitlements: string[];
+}
+/**
+ * Offer containing packages
+ */
+export interface SubscriptionOffer {
+    /** Offer identifier */
+    offerId: string;
+    /** Offer metadata from RevenueCat */
+    metadata?: Record<string, unknown>;
+    /** Packages in this offer */
+    packages: SubscriptionPackage[];
+}
+/**
+ * Current subscription status
+ */
+export interface CurrentSubscription {
+    /** Whether user has an active subscription */
+    isActive: boolean;
+    /** Product identifier of the current subscription */
+    productId?: string;
+    /** Package identifier of the current subscription */
+    packageId?: string;
+    /** Active entitlement identifiers */
+    entitlements: string[];
+    /** Current subscription period */
+    period?: SubscriptionPeriod;
+    /** Subscription expiration date */
+    expirationDate?: Date;
+    /** Whether subscription will auto-renew */
+    willRenew?: boolean;
+}
+/**
+ * Configuration for the free tier
+ */
+export interface FreeTierConfig {
+    /** Package ID for the free tier */
+    packageId: string;
+    /** Display name for the free tier */
+    name: string;
+}
+/**
+ * Package with calculated level for upgrade eligibility
+ */
+export interface PackageWithLevel extends SubscriptionPackage {
+    /** Calculated entitlement level (0 for free, higher = better) */
+    level: number;
+}
+//# sourceMappingURL=subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6BAA6B;IAC7B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,mCAAmC;IACnC,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/subscription.js

@@ -0,0 +1,6 @@
+/**
+ * Subscription Types
+ *
+ * Clean abstraction types for subscription data, independent of RevenueCat SDK.
+ */
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility Exports
+ */
+export { parseISO8601Period, getPeriodRank, comparePeriods, isPeriodGreaterOrEqual, } from './period-parser';
+export { calculatePackageLevels, addLevelsToPackages, getPackageLevel, findUpgradeablePackages, } from './level-calculator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * Utility Exports
+ */
+export { parseISO8601Period, getPeriodRank, comparePeriods, isPeriodGreaterOrEqual, } from './period-parser';
+export { calculatePackageLevels, addLevelsToPackages, getPackageLevel, findUpgradeablePackages, } from './level-calculator';

package/dist/utils/level-calculator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Level Calculator Utilities
+ *
+ * Calculate entitlement levels based on price comparison within the same period.
+ */
+import type { PackageWithLevel, SubscriptionPackage } from '../types/subscription';
+/**
+ * Calculate entitlement levels for packages
+ *
+ * Level is determined by comparing prices of packages with the same period.
+ * Higher price = higher level. Free tier always has level 0.
+ *
+ * @param packages List of packages to calculate levels for
+ * @returns Map of packageId to level
+ *
+ * @example
+ * // Given packages:
+ * // - free (no product)
+ * // - basic_monthly ($5)
+ * // - pro_monthly ($10)
+ * // - basic_yearly ($50)
+ * // - pro_yearly ($100)
+ * //
+ * // Returns:
+ * // - free: 0
+ * // - basic_monthly: 1
+ * // - pro_monthly: 2
+ * // - basic_yearly: 1
+ * // - pro_yearly: 2
+ */
+export declare function calculatePackageLevels(packages: SubscriptionPackage[]): Map<string, number>;
+/**
+ * Add level information to packages
+ *
+ * @param packages List of packages
+ * @returns Packages with level information
+ */
+export declare function addLevelsToPackages(packages: SubscriptionPackage[]): PackageWithLevel[];
+/**
+ * Get the level of a specific package
+ *
+ * @param packageId Package ID to look up
+ * @param packages All packages for context
+ * @returns Level number (0 for free, higher = better)
+ */
+export declare function getPackageLevel(packageId: string, packages: SubscriptionPackage[]): number;
+/**
+ * Parameters for findUpgradeablePackages
+ */
+export interface FindUpgradeableParams {
+    /** Current package ID */
+    packageId?: string | null;
+    /** Current product ID (fallback if packageId not found) */
+    productId?: string | null;
+}
+/**
+ * Find packages that are upgrades from the current package
+ *
+ * A package is an upgrade if:
+ * - Its period is >= current period, AND
+ * - Its level is >= current level (but not the exact same package)
+ *
+ * @param current Current package/product identifiers (or null/undefined for no subscription)
+ * @param packages All available packages
+ * @returns List of package IDs that are valid upgrades
+ */
+export declare function findUpgradeablePackages(current: string | FindUpgradeableParams | null | undefined, packages: SubscriptionPackage[]): string[];
+//# sourceMappingURL=level-calculator.d.ts.map

package/dist/utils/level-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-calculator.d.ts","sourceRoot":"","sources":["../../src/utils/level-calculator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiDrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,gBAAgB,EAAE,CAOpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CAGR;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAC1D,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,EAAE,CA2EV"}

package/dist/utils/level-calculator.js

@@ -0,0 +1,164 @@
+/**
+ * Level Calculator Utilities
+ *
+ * Calculate entitlement levels based on price comparison within the same period.
+ */
+/**
+ * Calculate entitlement levels for packages
+ *
+ * Level is determined by comparing prices of packages with the same period.
+ * Higher price = higher level. Free tier always has level 0.
+ *
+ * @param packages List of packages to calculate levels for
+ * @returns Map of packageId to level
+ *
+ * @example
+ * // Given packages:
+ * // - free (no product)
+ * // - basic_monthly ($5)
+ * // - pro_monthly ($10)
+ * // - basic_yearly ($50)
+ * // - pro_yearly ($100)
+ * //
+ * // Returns:
+ * // - free: 0
+ * // - basic_monthly: 1
+ * // - pro_monthly: 2
+ * // - basic_yearly: 1
+ * // - pro_yearly: 2
+ */
+export function calculatePackageLevels(packages) {
+    const levels = new Map();
+    // Group packages by period
+    const byPeriod = new Map();
+    for (const pkg of packages) {
+        if (!pkg.product) {
+            // Free tier
+            levels.set(pkg.packageId, 0);
+            continue;
+        }
+        const period = pkg.product.period;
+        const existing = byPeriod.get(period) ?? [];
+        existing.push(pkg);
+        byPeriod.set(period, existing);
+    }
+    // For each period, sort by price and assign levels
+    for (const [_period, periodPackages] of byPeriod) {
+        // Sort by price ascending
+        const sorted = [...periodPackages].sort((a, b) => {
+            const priceA = a.product?.price ?? 0;
+            const priceB = b.product?.price ?? 0;
+            return priceA - priceB;
+        });
+        // Assign levels (1, 2, 3, ...)
+        // Same price = same level
+        let currentLevel = 0;
+        let lastPrice = null;
+        for (const pkg of sorted) {
+            const price = pkg.product?.price ?? 0;
+            if (lastPrice === null || price > lastPrice) {
+                currentLevel++;
+                lastPrice = price;
+            }
+            levels.set(pkg.packageId, currentLevel);
+        }
+    }
+    return levels;
+}
+/**
+ * Add level information to packages
+ *
+ * @param packages List of packages
+ * @returns Packages with level information
+ */
+export function addLevelsToPackages(packages) {
+    const levels = calculatePackageLevels(packages);
+    return packages.map(pkg => ({
+        ...pkg,
+        level: levels.get(pkg.packageId) ?? 0,
+    }));
+}
+/**
+ * Get the level of a specific package
+ *
+ * @param packageId Package ID to look up
+ * @param packages All packages for context
+ * @returns Level number (0 for free, higher = better)
+ */
+export function getPackageLevel(packageId, packages) {
+    const levels = calculatePackageLevels(packages);
+    return levels.get(packageId) ?? 0;
+}
+/**
+ * Find packages that are upgrades from the current package
+ *
+ * A package is an upgrade if:
+ * - Its period is >= current period, AND
+ * - Its level is >= current level (but not the exact same package)
+ *
+ * @param current Current package/product identifiers (or null/undefined for no subscription)
+ * @param packages All available packages
+ * @returns List of package IDs that are valid upgrades
+ */
+export function findUpgradeablePackages(current, packages) {
+    // Normalize parameters
+    let currentPackageId;
+    let currentProductId;
+    if (typeof current === 'string') {
+        currentPackageId = current;
+    }
+    else if (current) {
+        currentPackageId = current.packageId;
+        currentProductId = current.productId;
+    }
+    // No current subscription = all packages are subscribable
+    if (!currentPackageId && !currentProductId) {
+        return packages.map(p => p.packageId);
+    }
+    // Try to find by packageId first, then by productId
+    let currentPkg = currentPackageId
+        ? packages.find(p => p.packageId === currentPackageId)
+        : undefined;
+    if (!currentPkg && currentProductId) {
+        currentPkg = packages.find(p => p.product?.productId === currentProductId);
+    }
+    if (!currentPkg) {
+        // Current package not found, return all
+        return packages.map(p => p.packageId);
+    }
+    // Use the matched package's ID (important when matched by productId)
+    const matchedPackageId = currentPkg.packageId;
+    // Free tier current = all paid packages are upgrades
+    if (!currentPkg.product) {
+        return packages.filter(p => p.product !== undefined).map(p => p.packageId);
+    }
+    const levels = calculatePackageLevels(packages);
+    const currentLevel = levels.get(matchedPackageId) ?? 0;
+    const currentPeriod = currentPkg.product.period;
+    const upgrades = [];
+    for (const pkg of packages) {
+        // Skip free tier (can't upgrade to free)
+        if (!pkg.product)
+            continue;
+        // Skip current package (by packageId)
+        if (pkg.packageId === matchedPackageId) {
+            continue;
+        }
+        const pkgLevel = levels.get(pkg.packageId) ?? 0;
+        const pkgPeriod = pkg.product.period;
+        // Must have >= period and >= level
+        const periodRanks = {
+            weekly: 1,
+            monthly: 2,
+            quarterly: 3,
+            yearly: 4,
+            lifetime: 5,
+        };
+        const isPeriodOk = periodRanks[pkgPeriod] >= periodRanks[currentPeriod];
+        const isLevelOk = pkgLevel >= currentLevel;
+        if (isPeriodOk && isLevelOk) {
+            upgrades.push(pkg.packageId);
+        }
+    }
+    return upgrades;
+}

package/dist/utils/period-parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Period Parser Utilities
+ *
+ * Parse ISO 8601 duration strings to standard subscription periods.
+ */
+import type { SubscriptionPeriod } from '../types/period';
+/**
+ * Parse ISO 8601 duration string to SubscriptionPeriod
+ *
+ * @param duration ISO 8601 duration (e.g., "P1M", "P1Y", "P7D", "P1W")
+ * @returns Parsed SubscriptionPeriod
+ *
+ * @example
+ * parseISO8601Period("P1M")  // "monthly"
+ * parseISO8601Period("P1Y")  // "yearly"
+ * parseISO8601Period("P7D")  // "weekly"
+ * parseISO8601Period("P1W")  // "weekly"
+ * parseISO8601Period("P3M")  // "quarterly"
+ * parseISO8601Period(null)   // "lifetime"
+ */
+export declare function parseISO8601Period(duration: string | null | undefined): SubscriptionPeriod;
+/**
+ * Get numeric rank for a period (higher = longer)
+ *
+ * @param period SubscriptionPeriod
+ * @returns Numeric rank (1-5)
+ */
+export declare function getPeriodRank(period: SubscriptionPeriod): number;
+/**
+ * Compare two periods
+ *
+ * @param a First period
+ * @param b Second period
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+export declare function comparePeriods(a: SubscriptionPeriod, b: SubscriptionPeriod): number;
+/**
+ * Check if period A is greater than or equal to period B
+ *
+ * @param a Period to check
+ * @param b Period to compare against
+ * @returns true if a >= b
+ */
+export declare function isPeriodGreaterOrEqual(a: SubscriptionPeriod, b: SubscriptionPeriod): boolean;
+//# sourceMappingURL=period-parser.d.ts.map

package/dist/utils/period-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"period-parser.d.ts","sourceRoot":"","sources":["../../src/utils/period-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,kBAAkB,CA2DpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,kBAAkB,EACrB,CAAC,EAAE,kBAAkB,GACpB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,kBAAkB,EACrB,CAAC,EAAE,kBAAkB,GACpB,OAAO,CAET"}

package/dist/utils/period-parser.js

@@ -0,0 +1,113 @@
+/**
+ * Period Parser Utilities
+ *
+ * Parse ISO 8601 duration strings to standard subscription periods.
+ */
+import { PERIOD_RANKS } from '../types/period';
+/**
+ * Parse ISO 8601 duration string to SubscriptionPeriod
+ *
+ * @param duration ISO 8601 duration (e.g., "P1M", "P1Y", "P7D", "P1W")
+ * @returns Parsed SubscriptionPeriod
+ *
+ * @example
+ * parseISO8601Period("P1M")  // "monthly"
+ * parseISO8601Period("P1Y")  // "yearly"
+ * parseISO8601Period("P7D")  // "weekly"
+ * parseISO8601Period("P1W")  // "weekly"
+ * parseISO8601Period("P3M")  // "quarterly"
+ * parseISO8601Period(null)   // "lifetime"
+ */
+export function parseISO8601Period(duration) {
+    if (!duration) {
+        return 'lifetime';
+    }
+    const normalized = duration.toUpperCase();
+    // Weekly: P1W or P7D
+    if (normalized === 'P1W' || normalized === 'P7D') {
+        return 'weekly';
+    }
+    // Monthly: P1M
+    if (normalized === 'P1M') {
+        return 'monthly';
+    }
+    // Quarterly: P3M
+    if (normalized === 'P3M') {
+        return 'quarterly';
+    }
+    // Yearly: P1Y or P12M
+    if (normalized === 'P1Y' || normalized === 'P12M') {
+        return 'yearly';
+    }
+    // Try to parse more complex durations
+    const match = normalized.match(/^P(\d+)([DWMY])$/);
+    if (match) {
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case 'D':
+                if (value === 7)
+                    return 'weekly';
+                if (value >= 28 && value <= 31)
+                    return 'monthly';
+                if (value >= 84 && value <= 93)
+                    return 'quarterly';
+                if (value >= 365)
+                    return 'yearly';
+                break;
+            case 'W':
+                if (value === 1)
+                    return 'weekly';
+                if (value === 4 || value === 5)
+                    return 'monthly';
+                if (value === 13)
+                    return 'quarterly';
+                if (value === 52)
+                    return 'yearly';
+                break;
+            case 'M':
+                if (value === 1)
+                    return 'monthly';
+                if (value === 3)
+                    return 'quarterly';
+                if (value === 6)
+                    return 'quarterly'; // Treat 6 months as quarterly for simplicity
+                if (value === 12)
+                    return 'yearly';
+                break;
+            case 'Y':
+                return 'yearly';
+        }
+    }
+    // Default to monthly for unrecognized patterns
+    return 'monthly';
+}
+/**
+ * Get numeric rank for a period (higher = longer)
+ *
+ * @param period SubscriptionPeriod
+ * @returns Numeric rank (1-5)
+ */
+export function getPeriodRank(period) {
+    return PERIOD_RANKS[period];
+}
+/**
+ * Compare two periods
+ *
+ * @param a First period
+ * @param b Second period
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+export function comparePeriods(a, b) {
+    return getPeriodRank(a) - getPeriodRank(b);
+}
+/**
+ * Check if period A is greater than or equal to period B
+ *
+ * @param a Period to check
+ * @param b Period to compare against
+ * @returns true if a >= b
+ */
+export function isPeriodGreaterOrEqual(a, b) {
+    return getPeriodRank(a) >= getPeriodRank(b);
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@sudobility/subscription_lib",
+  "version": "0.0.1",
+  "description": "Cross-platform subscription management with RevenueCat adapter pattern",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "bunx tsc --noEmit",
+    "lint": "bunx eslint src",
+    "lint:fix": "bunx eslint src --fix",
+    "format": "bunx prettier --write \"src/**/*.{ts,tsx,js,jsx,json}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.4",
+    "@eslint/js": "^9.0.0",
+    "@types/bun": "^1.2.8",
+    "@types/react": "^19.2.5",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "~5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sudobility/subscription_lib.git"
+  },
+  "license": "MIT"
+}