@venturekit-pro/billing 0.0.0-dev.20260323005827

package/dist/plans/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Plans & Feature Mapping
+ *
+ * Defines plans with feature limits and provides a generic mapping
+ * between app features and invoice line items.
+ *
+ * The feature_key is the bridge:
+ *   - billing_plan_features.feature_key defines what a plan includes
+ *   - billing_invoice_items.feature_key links usage to the line item
+ *
+ * This is generic enough to cover most apps:
+ *   - SaaS seats: feature_key = 'seats'
+ *   - Storage:    feature_key = 'storage_gb'
+ *   - API calls:  feature_key = 'api_calls'
+ *   - Custom:     feature_key = 'whatever_you_need'
+ */
+import type { BillingInterval } from '../types/index.js';
+/**
+ * A plan feature with its limit and pricing for invoicing.
+ */
+export interface PlanFeature {
+    /** Unique key identifying the feature (e.g. 'seats', 'storage_gb') */
+    featureKey: string;
+    /** Whether this feature is enabled in this plan */
+    enabled: boolean;
+    /** Usage limit (null = unlimited) */
+    limit?: number | null;
+    /** Unit price for overage/metered billing (in smallest currency unit) */
+    unitPrice?: number;
+    /** Human-readable description for invoice line items */
+    description: string;
+}
+/**
+ * A plan definition with its features.
+ */
+export interface PlanDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    currency: string;
+    interval: BillingInterval;
+    intervalCount?: number;
+    trialDays?: number;
+    active: boolean;
+    features: PlanFeature[];
+}
+/**
+ * Define a set of plans for your application.
+ *
+ * @example
+ * ```typescript
+ * const plans = definePlans([
+ *   {
+ *     id: 'free',
+ *     name: 'Free',
+ *     price: 0,
+ *     currency: 'USD',
+ *     interval: 'month',
+ *     active: true,
+ *     features: [
+ *       { featureKey: 'seats', enabled: true, limit: 1, description: 'Team seats' },
+ *       { featureKey: 'storage_gb', enabled: true, limit: 1, description: 'Storage (GB)' },
+ *       { featureKey: 'api_calls', enabled: true, limit: 1000, description: 'API calls / month' },
+ *     ],
+ *   },
+ *   {
+ *     id: 'pro',
+ *     name: 'Pro',
+ *     price: 2900, // $29.00
+ *     currency: 'USD',
+ *     interval: 'month',
+ *     active: true,
+ *     features: [
+ *       { featureKey: 'seats', enabled: true, limit: 10, unitPrice: 500, description: 'Team seats' },
+ *       { featureKey: 'storage_gb', enabled: true, limit: 50, description: 'Storage (GB)' },
+ *       { featureKey: 'api_calls', enabled: true, limit: 100000, description: 'API calls / month' },
+ *       { featureKey: 'priority_support', enabled: true, description: 'Priority support' },
+ *     ],
+ *   },
+ * ]);
+ * ```
+ */
+export declare function definePlans(plans: PlanDefinition[]): PlanDefinition[];
+/**
+ * Look up a feature limit for a given plan.
+ * Returns the limit (number), null (unlimited), or undefined (feature not in plan).
+ */
+export declare function getFeatureLimit(plan: PlanDefinition, featureKey: string): number | null | undefined;
+/**
+ * Check if a feature is enabled for a plan.
+ */
+export declare function hasFeature(plan: PlanDefinition, featureKey: string): boolean;
+/**
+ * Map feature usage to invoice line items.
+ *
+ * Given a plan and a usage record (featureKey → quantity used),
+ * generates invoice line items. This is the bridge between
+ * "what the customer did" and "what we charge them".
+ *
+ * For features within limits, generates a line item at the plan's base rate.
+ * For metered/overage features with unitPrice, generates overage items.
+ *
+ * @example
+ * ```typescript
+ * const items = mapUsageToLineItems(proPlan, {
+ *   seats: 12,       // 10 included, 2 overage at $5 each
+ *   storage_gb: 30,  // within limit
+ *   api_calls: 95000, // within limit
+ * });
+ * // Returns:
+ * // [
+ * //   { featureKey: 'seats', description: 'Team seats (2 extra)', quantity: 2, unitPrice: 500, amount: 1000 },
+ * // ]
+ * ```
+ */
+export declare function mapUsageToLineItems(plan: PlanDefinition, usage: Record<string, number>): Array<{
+    featureKey: string;
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    amount: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plans/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAErE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,GAAG,SAAS,CAI3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,KAAK,CAAC;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CA2BD"}

package/dist/plans/index.js

@@ -0,0 +1,116 @@
+/**
+ * Plans & Feature Mapping
+ *
+ * Defines plans with feature limits and provides a generic mapping
+ * between app features and invoice line items.
+ *
+ * The feature_key is the bridge:
+ *   - billing_plan_features.feature_key defines what a plan includes
+ *   - billing_invoice_items.feature_key links usage to the line item
+ *
+ * This is generic enough to cover most apps:
+ *   - SaaS seats: feature_key = 'seats'
+ *   - Storage:    feature_key = 'storage_gb'
+ *   - API calls:  feature_key = 'api_calls'
+ *   - Custom:     feature_key = 'whatever_you_need'
+ */
+/**
+ * Define a set of plans for your application.
+ *
+ * @example
+ * ```typescript
+ * const plans = definePlans([
+ *   {
+ *     id: 'free',
+ *     name: 'Free',
+ *     price: 0,
+ *     currency: 'USD',
+ *     interval: 'month',
+ *     active: true,
+ *     features: [
+ *       { featureKey: 'seats', enabled: true, limit: 1, description: 'Team seats' },
+ *       { featureKey: 'storage_gb', enabled: true, limit: 1, description: 'Storage (GB)' },
+ *       { featureKey: 'api_calls', enabled: true, limit: 1000, description: 'API calls / month' },
+ *     ],
+ *   },
+ *   {
+ *     id: 'pro',
+ *     name: 'Pro',
+ *     price: 2900, // $29.00
+ *     currency: 'USD',
+ *     interval: 'month',
+ *     active: true,
+ *     features: [
+ *       { featureKey: 'seats', enabled: true, limit: 10, unitPrice: 500, description: 'Team seats' },
+ *       { featureKey: 'storage_gb', enabled: true, limit: 50, description: 'Storage (GB)' },
+ *       { featureKey: 'api_calls', enabled: true, limit: 100000, description: 'API calls / month' },
+ *       { featureKey: 'priority_support', enabled: true, description: 'Priority support' },
+ *     ],
+ *   },
+ * ]);
+ * ```
+ */
+export function definePlans(plans) {
+    return plans;
+}
+/**
+ * Look up a feature limit for a given plan.
+ * Returns the limit (number), null (unlimited), or undefined (feature not in plan).
+ */
+export function getFeatureLimit(plan, featureKey) {
+    const feature = plan.features.find((f) => f.featureKey === featureKey);
+    if (!feature || !feature.enabled)
+        return undefined;
+    return feature.limit ?? null;
+}
+/**
+ * Check if a feature is enabled for a plan.
+ */
+export function hasFeature(plan, featureKey) {
+    const feature = plan.features.find((f) => f.featureKey === featureKey);
+    return feature?.enabled ?? false;
+}
+/**
+ * Map feature usage to invoice line items.
+ *
+ * Given a plan and a usage record (featureKey → quantity used),
+ * generates invoice line items. This is the bridge between
+ * "what the customer did" and "what we charge them".
+ *
+ * For features within limits, generates a line item at the plan's base rate.
+ * For metered/overage features with unitPrice, generates overage items.
+ *
+ * @example
+ * ```typescript
+ * const items = mapUsageToLineItems(proPlan, {
+ *   seats: 12,       // 10 included, 2 overage at $5 each
+ *   storage_gb: 30,  // within limit
+ *   api_calls: 95000, // within limit
+ * });
+ * // Returns:
+ * // [
+ * //   { featureKey: 'seats', description: 'Team seats (2 extra)', quantity: 2, unitPrice: 500, amount: 1000 },
+ * // ]
+ * ```
+ */
+export function mapUsageToLineItems(plan, usage) {
+    const items = [];
+    for (const [featureKey, used] of Object.entries(usage)) {
+        const feature = plan.features.find((f) => f.featureKey === featureKey);
+        if (!feature || !feature.enabled)
+            continue;
+        // If feature has a limit and usage exceeds it, and there's a unit price for overage
+        if (feature.limit != null && used > feature.limit && feature.unitPrice) {
+            const overage = used - feature.limit;
+            items.push({
+                featureKey,
+                description: `${feature.description} (${overage} extra)`,
+                quantity: overage,
+                unitPrice: feature.unitPrice,
+                amount: overage * feature.unitPrice,
+            });
+        }
+    }
+    return items;
+}
+//# sourceMappingURL=index.js.map

package/dist/plans/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plans/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAoB,EACpB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACvE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,UAAkB;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACvE,OAAO,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAoB,EACpB,KAA6B;IAQ7B,MAAM,KAAK,GAMN,EAAE,CAAC;IAER,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,SAAS;QAE3C,oFAAoF;QACpF,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC;gBACT,UAAU;gBACV,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,KAAK,OAAO,SAAS;gBACxD,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/subscriptions/manager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * VentureKit Subscription Manager
+ *
+ * Manages subscription lifecycle: create, upgrade, downgrade,
+ * cancel, pause, resume, and trial management.
+ *
+ * Storage backend is pluggable via SubscriptionStore interface.
+ */
+import type { Subscription, CreateSubscriptionInput } from '../types/subscription.js';
+import type { PlanDefinition } from '../plans/index.js';
+/**
+ * Subscription store interface
+ */
+export interface SubscriptionStore {
+    create(subscription: Subscription): Promise<Subscription>;
+    get(id: string): Promise<Subscription | null>;
+    getByCustomer(customerId: string): Promise<Subscription | null>;
+    update(id: string, updates: Partial<Subscription>): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * Subscription manager options
+ */
+export interface SubscriptionManagerOptions {
+    store: SubscriptionStore;
+    plans: PlanDefinition[];
+    /** Default trial days if plan doesn't specify */
+    defaultTrialDays?: number;
+}
+/**
+ * Proration calculation result
+ */
+export interface ProrationResult {
+    /** Credit for unused time on current plan */
+    credit: number;
+    /** Charge for remaining time on new plan */
+    charge: number;
+    /** Net amount (charge - credit, can be negative) */
+    netAmount: number;
+    /** Days remaining in current period */
+    daysRemaining: number;
+    /** Total days in current period */
+    totalDays: number;
+}
+/**
+ * Calculate proration for a mid-cycle plan change
+ */
+export declare function calculateProration(currentPlan: PlanDefinition, newPlan: PlanDefinition, periodStart: Date, periodEnd: Date, changeDate?: Date): ProrationResult;
+/**
+ * Create a subscription manager
+ */
+export declare function createSubscriptionManager(options: SubscriptionManagerOptions): {
+    /**
+     * Create a new subscription
+     */
+    create(input: CreateSubscriptionInput): Promise<Subscription>;
+    /**
+     * Get a subscription by ID
+     */
+    get(id: string): Promise<Subscription | null>;
+    /**
+     * Get a customer's active subscription
+     */
+    getByCustomer(customerId: string): Promise<Subscription | null>;
+    /**
+     * Change plan (upgrade or downgrade)
+     */
+    changePlan(subscriptionId: string, newPlanId: string, options?: {
+        immediate?: boolean;
+    }): Promise<{
+        subscription: Subscription;
+        proration?: ProrationResult;
+    }>;
+    /**
+     * Cancel subscription
+     */
+    cancel(subscriptionId: string, options?: {
+        immediate?: boolean;
+        reason?: string;
+    }): Promise<Subscription>;
+    /**
+     * Pause subscription
+     */
+    pause(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Resume a paused subscription
+     */
+    resume(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Calculate proration for a plan change
+     */
+    previewProration(subscriptionId: string, newPlanId: string): Promise<ProrationResult>;
+};
+/**
+ * In-memory subscription store (for dev/testing)
+ */
+export declare function createMemorySubscriptionStore(): SubscriptionStore;
+//# sourceMappingURL=manager.d.ts.map

package/dist/subscriptions/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/subscriptions/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,IAAI,EACjB,SAAS,EAAE,IAAI,EACf,UAAU,GAAE,IAAiB,GAC5B,eAAe,CAqBjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B;IAezE;;OAEG;kBACiB,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmDnE;;OAEG;YACW,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAInD;;OAEG;8BAC6B,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIrE;;OAEG;+BAEe,MAAM,aACX,MAAM,YACP;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,SAAS,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC;IAyCvE;;OAEG;2BAEe,MAAM,YACZ;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,YAAY,CAAC;IA2BxB;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa1D;;OAEG;2BAC0B,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa3D;;OAEG;qCAEe,MAAM,aACX,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC;EAe9B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,iBAAiB,CA6BjE"}

package/dist/subscriptions/manager.js

@@ -0,0 +1,245 @@
+/**
+ * VentureKit Subscription Manager
+ *
+ * Manages subscription lifecycle: create, upgrade, downgrade,
+ * cancel, pause, resume, and trial management.
+ *
+ * Storage backend is pluggable via SubscriptionStore interface.
+ */
+/**
+ * Calculate proration for a mid-cycle plan change
+ */
+export function calculateProration(currentPlan, newPlan, periodStart, periodEnd, changeDate = new Date()) {
+    const totalMs = periodEnd.getTime() - periodStart.getTime();
+    const elapsedMs = changeDate.getTime() - periodStart.getTime();
+    const remainingMs = totalMs - elapsedMs;
+    const totalDays = Math.max(1, Math.round(totalMs / (1000 * 60 * 60 * 24)));
+    const daysRemaining = Math.max(0, Math.round(remainingMs / (1000 * 60 * 60 * 24)));
+    const dailyRateCurrent = currentPlan.price / totalDays;
+    const dailyRateNew = newPlan.price / totalDays;
+    const credit = Math.round(dailyRateCurrent * daysRemaining);
+    const charge = Math.round(dailyRateNew * daysRemaining);
+    return {
+        credit,
+        charge,
+        netAmount: charge - credit,
+        daysRemaining,
+        totalDays,
+    };
+}
+/**
+ * Create a subscription manager
+ */
+export function createSubscriptionManager(options) {
+    const { store, plans, defaultTrialDays } = options;
+    function getPlan(planId) {
+        const plan = plans.find(p => p.id === planId);
+        if (!plan)
+            throw new Error(`Plan '${planId}' not found`);
+        if (!plan.active)
+            throw new Error(`Plan '${planId}' is not active`);
+        return plan;
+    }
+    function generateId() {
+        return `sub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    return {
+        /**
+         * Create a new subscription
+         */
+        async create(input) {
+            // Check for existing active subscription
+            const existing = await store.getByCustomer(input.customerId);
+            if (existing && !['canceled', 'unpaid'].includes(existing.status)) {
+                throw new Error(`Customer '${input.customerId}' already has an active subscription`);
+            }
+            const plan = getPlan(input.planId);
+            const now = new Date();
+            const trialDays = input.trialDays ?? plan.trialDays ?? defaultTrialDays ?? 0;
+            const isTrialing = trialDays > 0;
+            const periodEnd = new Date(now);
+            if (isTrialing) {
+                periodEnd.setDate(periodEnd.getDate() + trialDays);
+            }
+            else {
+                // Set period based on interval
+                switch (plan.interval) {
+                    case 'day':
+                        periodEnd.setDate(periodEnd.getDate() + (plan.intervalCount ?? 1));
+                        break;
+                    case 'week':
+                        periodEnd.setDate(periodEnd.getDate() + 7 * (plan.intervalCount ?? 1));
+                        break;
+                    case 'month':
+                        periodEnd.setMonth(periodEnd.getMonth() + (plan.intervalCount ?? 1));
+                        break;
+                    case 'year':
+                        periodEnd.setFullYear(periodEnd.getFullYear() + (plan.intervalCount ?? 1));
+                        break;
+                }
+            }
+            const subscription = {
+                id: generateId(),
+                customerId: input.customerId,
+                planId: input.planId,
+                status: isTrialing ? 'trialing' : 'active',
+                currentPeriodStart: now,
+                currentPeriodEnd: periodEnd,
+                cancelAtPeriodEnd: false,
+                trialStart: isTrialing ? now : undefined,
+                trialEnd: isTrialing ? periodEnd : undefined,
+                createdAt: now,
+                updatedAt: now,
+                metadata: input.metadata,
+            };
+            return store.create(subscription);
+        },
+        /**
+         * Get a subscription by ID
+         */
+        async get(id) {
+            return store.get(id);
+        },
+        /**
+         * Get a customer's active subscription
+         */
+        async getByCustomer(customerId) {
+            return store.getByCustomer(customerId);
+        },
+        /**
+         * Change plan (upgrade or downgrade)
+         */
+        async changePlan(subscriptionId, newPlanId, options) {
+            const sub = await store.get(subscriptionId);
+            if (!sub)
+                throw new Error(`Subscription '${subscriptionId}' not found`);
+            if (sub.status === 'canceled')
+                throw new Error('Cannot change plan on a canceled subscription');
+            const currentPlan = getPlan(sub.planId);
+            const newPlan = getPlan(newPlanId);
+            if (sub.planId === newPlanId) {
+                throw new Error('Already on this plan');
+            }
+            const immediate = options?.immediate ?? true;
+            if (immediate) {
+                const proration = calculateProration(currentPlan, newPlan, sub.currentPeriodStart, sub.currentPeriodEnd);
+                await store.update(subscriptionId, {
+                    planId: newPlanId,
+                    updatedAt: new Date(),
+                });
+                const updated = await store.get(subscriptionId);
+                return { subscription: updated, proration };
+            }
+            // Schedule change at period end (no proration)
+            await store.update(subscriptionId, {
+                metadata: { ...sub.metadata, pendingPlanId: newPlanId },
+                updatedAt: new Date(),
+            });
+            const updated = await store.get(subscriptionId);
+            return { subscription: updated };
+        },
+        /**
+         * Cancel subscription
+         */
+        async cancel(subscriptionId, options) {
+            const sub = await store.get(subscriptionId);
+            if (!sub)
+                throw new Error(`Subscription '${subscriptionId}' not found`);
+            if (sub.status === 'canceled')
+                throw new Error('Subscription is already canceled');
+            const immediate = options?.immediate ?? false;
+            const now = new Date();
+            if (immediate) {
+                await store.update(subscriptionId, {
+                    status: 'canceled',
+                    canceledAt: now,
+                    cancelAtPeriodEnd: false,
+                    updatedAt: now,
+                    metadata: { ...sub.metadata, cancelReason: options?.reason },
+                });
+            }
+            else {
+                await store.update(subscriptionId, {
+                    cancelAtPeriodEnd: true,
+                    updatedAt: now,
+                    metadata: { ...sub.metadata, cancelReason: options?.reason },
+                });
+            }
+            return (await store.get(subscriptionId));
+        },
+        /**
+         * Pause subscription
+         */
+        async pause(subscriptionId) {
+            const sub = await store.get(subscriptionId);
+            if (!sub)
+                throw new Error(`Subscription '${subscriptionId}' not found`);
+            if (sub.status !== 'active')
+                throw new Error('Can only pause active subscriptions');
+            await store.update(subscriptionId, {
+                status: 'paused',
+                updatedAt: new Date(),
+            });
+            return (await store.get(subscriptionId));
+        },
+        /**
+         * Resume a paused subscription
+         */
+        async resume(subscriptionId) {
+            const sub = await store.get(subscriptionId);
+            if (!sub)
+                throw new Error(`Subscription '${subscriptionId}' not found`);
+            if (sub.status !== 'paused')
+                throw new Error('Can only resume paused subscriptions');
+            await store.update(subscriptionId, {
+                status: 'active',
+                updatedAt: new Date(),
+            });
+            return (await store.get(subscriptionId));
+        },
+        /**
+         * Calculate proration for a plan change
+         */
+        async previewProration(subscriptionId, newPlanId) {
+            const sub = await store.get(subscriptionId);
+            if (!sub)
+                throw new Error(`Subscription '${subscriptionId}' not found`);
+            const currentPlan = getPlan(sub.planId);
+            const newPlan = getPlan(newPlanId);
+            return calculateProration(currentPlan, newPlan, sub.currentPeriodStart, sub.currentPeriodEnd);
+        },
+    };
+}
+/**
+ * In-memory subscription store (for dev/testing)
+ */
+export function createMemorySubscriptionStore() {
+    const subscriptions = new Map();
+    return {
+        async create(subscription) {
+            subscriptions.set(subscription.id, { ...subscription });
+            return subscription;
+        },
+        async get(id) {
+            return subscriptions.get(id) ?? null;
+        },
+        async getByCustomer(customerId) {
+            for (const sub of subscriptions.values()) {
+                if (sub.customerId === customerId && sub.status !== 'canceled') {
+                    return sub;
+                }
+            }
+            return null;
+        },
+        async update(id, updates) {
+            const existing = subscriptions.get(id);
+            if (existing) {
+                subscriptions.set(id, { ...existing, ...updates });
+            }
+        },
+        async delete(id) {
+            subscriptions.delete(id);
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/subscriptions/manager.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Billing Configuration Types
+ *
+ * This package handles invoicing, plans, usage tracking, and feature gating.
+ * Payment processing is NOT included — integrate any provider separately.
+ */
+import type { SubscriptionPlan } from './subscription.js';
+/**
+ * Billing configuration
+ */
+export interface BillingConfig {
+    /** Default currency (ISO 4217) */
+    defaultCurrency: string;
+    /** Available plans */
+    plans?: SubscriptionPlan[];
+    /** Tax rate as percentage (e.g., 20 for 20%) */
+    taxRate?: number;
+    /** Tax ID label (e.g., "VAT", "ICE" for Morocco) */
+    taxIdLabel?: string;
+    /** Invoice number prefix (e.g., "INV-") */
+    invoicePrefix?: string;
+    /** Default payment terms in days (default: 30) */
+    paymentTermsDays?: number;
+}
+/**
+ * Billing config input (partial for overrides)
+ */
+export interface BillingConfigInput {
+    defaultCurrency?: string;
+    plans?: SubscriptionPlan[];
+    taxRate?: number;
+    taxIdLabel?: string;
+    invoicePrefix?: string;
+    paymentTermsDays?: number;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IAExB,sBAAsB;IACtB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE3B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/config.js

@@ -0,0 +1,8 @@
+/**
+ * Billing Configuration Types
+ *
+ * This package handles invoicing, plans, usage tracking, and feature gating.
+ * Payment processing is NOT included — integrate any provider separately.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}