@delightstack/stripe 0.1.0

package/dist/server/billing.config.d.ts

@@ -0,0 +1,189 @@
+import type { RequestEvent } from '@sveltejs/kit';
+/**
+ * A plan definition that maps to a Stripe Product + Price.
+ * Defined in code, synced to Stripe.
+ */
+export interface PlanDefinition {
+    /** Unique plan identifier (used in code, stored as Stripe product metadata) */
+    id: string;
+    /** Human-readable name (synced to Stripe product name) */
+    name: string;
+    /** Plan description (synced to Stripe product description) */
+    description?: string;
+    /** Stripe lookup_key for the price. Allows price migration without code changes. */
+    lookup_key: string;
+    /** Price amount in smallest currency unit (e.g. 999 = $9.99) */
+    amount: number;
+    /** Currency code (lowercase) @default 'usd' */
+    currency?: string;
+    /** Billing interval */
+    interval: 'month' | 'year' | 'week' | 'day';
+    /** Number of intervals between billings @default 1 */
+    interval_count?: number;
+    /**
+     * Entitlement names this plan grants.
+     * Maps to the auth package's entitlements array.
+     * @example ['premium', 'video-uploads']
+     */
+    entitlements?: string[];
+    /** Trial period in days @default undefined (no trial) */
+    trial_days?: number;
+    /** Whether this plan is archived (hidden from new subscriptions) */
+    archived?: boolean;
+    /** Additional Stripe product metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * A usage meter definition for billing based on consumption.
+ * Maps to Stripe Billing Meters.
+ */
+export interface MeterDefinition {
+    /** Unique meter identifier */
+    id: string;
+    /** Human-readable display name */
+    display_name: string;
+    /** Event name used in meter event API */
+    event_name: string;
+    /** Aggregation formula */
+    aggregation: 'sum' | 'count' | 'max' | 'last';
+    /** Value key in the event payload @default 'value' */
+    value_key?: string;
+}
+/** Minimal RPC interface for the auth server (avoids hard dependency) */
+export interface AuthServerRpc {
+    updateOrg(id: string, data: {
+        plan?: number;
+        json?: string;
+    }): unknown;
+    /**
+     * Optional read of the org record. When provided, the billing package
+     * read-modify-writes the org's `json` metadata instead of overwriting it.
+     */
+    getOrg?(id: string): {
+        json?: string | null;
+    } | null | undefined | Promise<{
+        json?: string | null;
+    } | null | undefined>;
+}
+/**
+ * Store used to deduplicate Stripe webhook events by event ID.
+ * Provide a durable implementation (e.g. Durable Object storage) for
+ * multi-isolate deployments. Defaults to an in-memory store with a TTL/cap.
+ */
+export interface WebhookEventStore {
+    /** Returns true if the given Stripe event ID was already processed */
+    has(event_id: string): boolean | Promise<boolean>;
+    /** Marks the given Stripe event ID as processed */
+    add(event_id: string): void | Promise<void>;
+}
+/** Minimal RPC interface for the websocket server (avoids hard dependency) */
+export interface WebsocketRpc {
+    broadcast(message: Record<string, unknown>): void;
+}
+/**
+ * Configuration for the billing/stripe integration.
+ * Pass to `defineBillingConfig()` to fill in defaults.
+ */
+export interface BillingConfig<E extends string = string> {
+    /** Stripe secret key (sk_live_... or sk_test_...) */
+    secret_key: string;
+    /** Stripe publishable key (pk_live_... or pk_test_...) */
+    publishable_key: string;
+    /**
+     * Stripe webhook signing secret. If omitted, webhooks are
+     * auto-registered and the secret is derived from the registration.
+     * Provide this to use a manually configured webhook.
+     */
+    webhook_secret?: string;
+    /** Whether the app is in dev mode @default false */
+    dev?: boolean;
+    /** Base path for billing API routes @default '/api/billing' */
+    base_path?: string;
+    /** Plan definitions — products and prices defined in code */
+    plans?: PlanDefinition[];
+    /** Usage meter definitions */
+    meters?: MeterDefinition[];
+    /**
+     * Entitlement names that correspond to the auth package's entitlements array.
+     * Array index = bit position. Must match the auth config's entitlements array.
+     * Used to map plan entitlements to the auth system's bitwise encoding.
+     * @example ['premium', 'video-uploads', 'extra-usage']
+     */
+    entitlements?: readonly E[];
+    /**
+     * Whether billing is scoped to orgs or users.
+     * - 'org': Stripe customer = org. Subscription managed by org owner.
+     * - 'user': Stripe customer = user. Each user manages their own subscription.
+     * @default 'org'
+     */
+    billing_scope?: 'org' | 'user';
+    /**
+     * The public URL of the app (used for webhook registration and Billing Portal return URL).
+     * If omitted, derived from the first request's origin.
+     */
+    app_url?: string;
+    /**
+     * Additional origins that a client-provided `return_url` may point to
+     * (for Billing Portal and Checkout). The app's own origin is always allowed.
+     * Any other origin is rejected to prevent open-redirect/phishing.
+     * @example ['https://app.example.com']
+     */
+    allowed_return_origins?: string[];
+    /**
+     * Store used to deduplicate Stripe webhook events (idempotency).
+     * Defaults to an in-memory store (per-isolate, 24h TTL, capped size).
+     * Provide a durable implementation for multi-isolate deployments.
+     */
+    webhook_event_store?: WebhookEventStore;
+    /**
+     * Billing Portal configuration.
+     * @default { enabled: true }
+     */
+    portal?: {
+        /** Enable the Stripe Billing Portal @default true */
+        enabled?: boolean;
+    };
+    /** Lifecycle hooks for billing events */
+    hooks?: {
+        /** Called after a subscription is created, updated, canceled, or deleted */
+        onSubscriptionChange?: (ctx: {
+            customer_id: string;
+            subscription_id: string;
+            status: string;
+            plan_id: string | null;
+            entitlements: string[];
+            event: RequestEvent;
+        }) => void | Promise<void>;
+        /** Called after a payment succeeds. `amount` is an integer in the smallest currency unit (cents). */
+        onPaymentSuccess?: (ctx: {
+            customer_id: string;
+            /** Integer amount in the smallest currency unit (e.g. cents) */
+            amount: number;
+            currency: string;
+            invoice_id: string;
+        }) => void | Promise<void>;
+        /** Called after a payment fails. `amount` is an integer in the smallest currency unit (cents). */
+        onPaymentFailed?: (ctx: {
+            customer_id: string;
+            /** Integer amount in the smallest currency unit (e.g. cents) */
+            amount: number;
+            currency: string;
+            invoice_id: string;
+        }) => void | Promise<void>;
+        /** Called when a customer is created in Stripe */
+        onCustomerCreated?: (ctx: {
+            customer_id: string;
+            org_id?: string;
+            user_id?: string;
+        }) => void | Promise<void>;
+    };
+}
+/** Resolved billing config with all defaults filled in */
+export interface ResolvedBillingConfig<E extends string = string> extends BillingConfig<E> {
+    base_path: string;
+    billing_scope: 'org' | 'user';
+    portal: Required<NonNullable<BillingConfig['portal']>>;
+}
+/** Creates a billing config with sensible defaults */
+export declare function defineBillingConfig<const E extends string>(config: BillingConfig<E>): ResolvedBillingConfig<E>;
+//# sourceMappingURL=billing.config.d.ts.map

package/dist/server/billing.config.d.ts.map

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

package/dist/server/billing.config.js

@@ -0,0 +1,37 @@
+/** Creates a billing config with sensible defaults */
+export function defineBillingConfig(config) {
+    if (!config.secret_key?.startsWith('sk_')) {
+        throw new Error('Billing config: secret_key must be a valid Stripe secret key (sk_...)');
+    }
+    if (!config.publishable_key?.startsWith('pk_')) {
+        throw new Error('Billing config: publishable_key must be a valid Stripe publishable key (pk_...)');
+    }
+    // Validate plan definitions
+    if (config.plans) {
+        const ids = new Set();
+        const keys = new Set();
+        for (const plan of config.plans) {
+            if (ids.has(plan.id)) {
+                throw new Error(`Billing config: duplicate plan id '${plan.id}'`);
+            }
+            if (keys.has(plan.lookup_key)) {
+                throw new Error(`Billing config: duplicate lookup_key '${plan.lookup_key}'`);
+            }
+            ids.add(plan.id);
+            keys.add(plan.lookup_key);
+        }
+    }
+    // Validate entitlements limit
+    if (config.entitlements && config.entitlements.length > 32) {
+        throw new Error(`Billing config: entitlements array exceeds 32 entries (got ${config.entitlements.length}). ` +
+            'Bitwise encoding uses a 32-bit integer.');
+    }
+    return {
+        ...config,
+        base_path: config.base_path ?? '/api/billing',
+        billing_scope: config.billing_scope ?? 'org',
+        portal: {
+            enabled: config.portal?.enabled ?? true,
+        },
+    };
+}

package/dist/server/billing.handler.d.ts

@@ -0,0 +1,46 @@
+import type { Handle, RequestEvent } from '@sveltejs/kit';
+import type { BillingConfig, AuthServerRpc, WebsocketRpc } from './billing.config';
+/** Options for `createBillingHandle()` */
+export interface BillingHandleOptions<Config extends BillingConfig = BillingConfig> {
+    /** The billing configuration (pass result of `defineBillingConfig()` or raw config) */
+    config: Config;
+    /**
+     * Get the auth server for entitlement updates.
+     * Return undefined if not using auth integration.
+     */
+    getAuthServer?: (event: RequestEvent) => AuthServerRpc | undefined;
+    /**
+     * Get the WebSocket server for real-time billing events.
+     * Return undefined if not using WebSocket integration.
+     */
+    getWebsocket?: (event: RequestEvent) => WebsocketRpc | undefined;
+    /** Whether the app is building (static build step) @default false */
+    building?: boolean;
+    /**
+     * Sync product/price/meter definitions to Stripe on first request.
+     * @default false
+     */
+    sync_on_startup?: boolean;
+}
+/**
+ * Creates a SvelteKit Handle for billing.
+ * Composable with SvelteKit's `sequence()`.
+ *
+ * Routes handled:
+ * - POST   /api/billing/webhook              Stripe webhook endpoint
+ * - GET    /api/billing/subscription          Get current subscription
+ * - POST   /api/billing/subscription          Create/update subscription
+ * - DELETE  /api/billing/subscription          Cancel subscription
+ * - GET    /api/billing/invoice               List invoices
+ * - GET    /api/billing/payment-method        List payment methods
+ * - POST   /api/billing/payment-method        Add payment method (create setup session)
+ * - PATCH  /api/billing/payment-method/:id    Set default payment method
+ * - DELETE  /api/billing/payment-method/:id    Remove payment method
+ * - POST   /api/billing/portal                Create Billing Portal session
+ * - POST   /api/billing/checkout              Create Checkout session
+ * - GET    /api/billing/plan                  List available plans
+ * - POST   /api/billing/sync                  Force subscription sync
+ * - GET    /api/billing/config                Get client-safe config
+ */
+export declare function createBillingHandle<Config extends BillingConfig>(options: BillingHandleOptions<Config>): Handle;
+//# sourceMappingURL=billing.handler.d.ts.map

package/dist/server/billing.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.handler.d.ts","sourceRoot":"","sources":["../../src/server/billing.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EACX,aAAa,EAEb,aAAa,EACb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAO1B,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACjF,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,aAAa,GAAG,SAAS,CAAC;IAEnE;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAAG,SAAS,CAAC;IAEjE,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,aAAa,EAC/D,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACnC,MAAM,CAqDR"}

package/dist/server/billing.handler.js

@@ -0,0 +1,73 @@
+import { DelightError } from '@delightstack/utilities';
+import { defineBillingConfig } from './billing.config';
+import { handleBillingRoute } from './billing.routes';
+import { handleWebhook } from './billing.webhook';
+import { syncAll } from './billing.products';
+/**
+ * Creates a SvelteKit Handle for billing.
+ * Composable with SvelteKit's `sequence()`.
+ *
+ * Routes handled:
+ * - POST   /api/billing/webhook              Stripe webhook endpoint
+ * - GET    /api/billing/subscription          Get current subscription
+ * - POST   /api/billing/subscription          Create/update subscription
+ * - DELETE  /api/billing/subscription          Cancel subscription
+ * - GET    /api/billing/invoice               List invoices
+ * - GET    /api/billing/payment-method        List payment methods
+ * - POST   /api/billing/payment-method        Add payment method (create setup session)
+ * - PATCH  /api/billing/payment-method/:id    Set default payment method
+ * - DELETE  /api/billing/payment-method/:id    Remove payment method
+ * - POST   /api/billing/portal                Create Billing Portal session
+ * - POST   /api/billing/checkout              Create Checkout session
+ * - GET    /api/billing/plan                  List available plans
+ * - POST   /api/billing/sync                  Force subscription sync
+ * - GET    /api/billing/config                Get client-safe config
+ */
+export function createBillingHandle(options) {
+    const config = defineBillingConfig(options.config);
+    let product_sync_started = false;
+    return async ({ event, resolve }) => {
+        if (options.building)
+            return resolve(event);
+        // Trigger product sync once on first request (non-blocking)
+        if (options.sync_on_startup && !product_sync_started) {
+            product_sync_started = true;
+            syncAll(config).catch((err) => {
+                console.error('[@delightstack/stripe] Product sync failed:', err);
+            });
+        }
+        const pathname = event.url.pathname;
+        const base_path = config.base_path;
+        if (!pathname.startsWith(base_path)) {
+            return resolve(event);
+        }
+        const route_path = pathname.slice(base_path.length) || '/';
+        const method = event.request.method;
+        // Webhook route does NOT require auth (Stripe sends it)
+        if (route_path === '/webhook' && method === 'POST') {
+            try {
+                return await handleWebhook(event, config, {
+                    getAuthServer: options.getAuthServer,
+                    getWebsocket: options.getWebsocket,
+                });
+            }
+            catch (error) {
+                return DelightError.from(error).toResponse();
+            }
+        }
+        // All other routes require authentication
+        const locals = event.locals;
+        if (!locals.session) {
+            return DelightError.unauthorized('Authentication required').toResponse();
+        }
+        try {
+            return await handleBillingRoute(event, config, route_path, method, {
+                getAuthServer: options.getAuthServer,
+                getWebsocket: options.getWebsocket,
+            });
+        }
+        catch (error) {
+            return DelightError.from(error).toResponse();
+        }
+    };
+}

package/dist/server/billing.meter.d.ts

@@ -0,0 +1,41 @@
+import type { ResolvedBillingConfig } from './billing.config';
+/**
+ * Reports a usage event to a Stripe Billing Meter.
+ *
+ * @example
+ * ```ts
+ * await reportMeterEvent(config, {
+ *   meter_id: 'ai-tokens',
+ *   customer_id: 'cus_xxx',
+ *   value: result.usage.total_tokens,
+ * });
+ * ```
+ */
+export declare function reportMeterEvent(config: ResolvedBillingConfig, options: {
+    /** The meter ID (matches MeterDefinition.id from config) */
+    meter_id: string;
+    /** The Stripe customer ID to attribute the usage to */
+    customer_id: string;
+    /** The usage value to report */
+    value: number;
+    /** Unix timestamp in seconds @default now */
+    timestamp?: number;
+    /** Idempotency key to prevent duplicate events */
+    idempotency_key?: string;
+}): Promise<void>;
+/**
+ * Creates a helper function bound to a specific meter and config.
+ * Designed for integration with the AI package.
+ *
+ * @example
+ * ```ts
+ * // In your Durable Object:
+ * const reportTokenUsage = createMeterReporter(billingConfig, 'ai-tokens');
+ *
+ * // After each AI completion:
+ * const result = await ai.complete(options);
+ * await reportTokenUsage(customer_id, result.usage.total_tokens);
+ * ```
+ */
+export declare function createMeterReporter(config: ResolvedBillingConfig, meter_id: string): (customer_id: string, value: number, idempotency_key?: string) => Promise<void>;
+//# sourceMappingURL=billing.meter.d.ts.map

package/dist/server/billing.meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.meter.d.ts","sourceRoot":"","sources":["../../src/server/billing.meter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI9D;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE;IACR,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB,GACC,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,IAEjF,aAAa,MAAM,EACnB,OAAO,MAAM,EACb,kBAAkB,MAAM,KACtB,OAAO,CAAC,IAAI,CAAC,CAShB"}

package/dist/server/billing.meter.js

@@ -0,0 +1,55 @@
+import { getStripe, stripeCall } from './billing.stripe';
+import { DelightError } from '@delightstack/utilities';
+/**
+ * Reports a usage event to a Stripe Billing Meter.
+ *
+ * @example
+ * ```ts
+ * await reportMeterEvent(config, {
+ *   meter_id: 'ai-tokens',
+ *   customer_id: 'cus_xxx',
+ *   value: result.usage.total_tokens,
+ * });
+ * ```
+ */
+export async function reportMeterEvent(config, options) {
+    const meter_def = config.meters?.find((m) => m.id === options.meter_id);
+    if (!meter_def) {
+        throw DelightError.badRequest(`Unknown meter: ${options.meter_id}`);
+    }
+    const stripe = getStripe(config);
+    await stripeCall(() => stripe.billing.meterEvents.create({
+        event_name: meter_def.event_name,
+        payload: {
+            stripe_customer_id: options.customer_id,
+            [meter_def.value_key ?? 'value']: String(options.value),
+        },
+        timestamp: options.timestamp ?? Math.floor(Date.now() / 1000),
+    }, options.idempotency_key ? { idempotencyKey: options.idempotency_key } : undefined));
+}
+/**
+ * Creates a helper function bound to a specific meter and config.
+ * Designed for integration with the AI package.
+ *
+ * @example
+ * ```ts
+ * // In your Durable Object:
+ * const reportTokenUsage = createMeterReporter(billingConfig, 'ai-tokens');
+ *
+ * // After each AI completion:
+ * const result = await ai.complete(options);
+ * await reportTokenUsage(customer_id, result.usage.total_tokens);
+ * ```
+ */
+export function createMeterReporter(config, meter_id) {
+    return async (customer_id, value, idempotency_key) => {
+        if (value <= 0)
+            return; // Skip zero/negative usage
+        await reportMeterEvent(config, {
+            meter_id,
+            customer_id,
+            value,
+            idempotency_key,
+        });
+    };
+}

package/dist/server/billing.products.d.ts

@@ -0,0 +1,24 @@
+import type { ResolvedBillingConfig } from './billing.config';
+/**
+ * Syncs plan definitions to Stripe products and prices.
+ * Uses lookup_keys so that prices can be updated without changing code references.
+ * Idempotent — safe to call on every startup.
+ *
+ * Strategy:
+ * - Products are matched by metadata.plan_id
+ * - Prices are matched by lookup_key (Stripe's built-in mechanism)
+ * - Existing resources are updated; missing ones are created
+ * - Nothing is deleted (archived plans stay in Stripe)
+ */
+export declare function syncProducts(config: ResolvedBillingConfig): Promise<void>;
+/**
+ * Syncs meter definitions to Stripe Billing Meters.
+ * Idempotent — creates meters that do not exist.
+ */
+export declare function syncMeters(config: ResolvedBillingConfig): Promise<void>;
+/**
+ * Run a full sync of products, prices, and meters.
+ * Called automatically on first request if `sync_on_startup` is enabled.
+ */
+export declare function syncAll(config: ResolvedBillingConfig): Promise<void>;
+//# sourceMappingURL=billing.products.d.ts.map

package/dist/server/billing.products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.products.d.ts","sourceRoot":"","sources":["../../src/server/billing.products.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAO9D;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF/E;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B7E;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E"}

package/dist/server/billing.products.js

@@ -0,0 +1,124 @@
+import { getStripe, stripeCall } from './billing.stripe';
+/** Track whether sync has been performed this lifecycle */
+let products_synced = false;
+let meters_synced = false;
+/**
+ * Syncs plan definitions to Stripe products and prices.
+ * Uses lookup_keys so that prices can be updated without changing code references.
+ * Idempotent — safe to call on every startup.
+ *
+ * Strategy:
+ * - Products are matched by metadata.plan_id
+ * - Prices are matched by lookup_key (Stripe's built-in mechanism)
+ * - Existing resources are updated; missing ones are created
+ * - Nothing is deleted (archived plans stay in Stripe)
+ */
+export async function syncProducts(config) {
+    if (products_synced || !config.plans?.length)
+        return;
+    products_synced = true;
+    const stripe = getStripe(config);
+    for (const plan of config.plans) {
+        // 1. Ensure product exists
+        let product;
+        // Search by metadata.plan_id
+        const products = await stripeCall(() => stripe.products.search({
+            query: `metadata['plan_id']:'${plan.id}'`,
+        }));
+        product = products.data[0];
+        if (!product) {
+            // Create new product
+            product = await stripeCall(() => stripe.products.create({
+                name: plan.name,
+                description: plan.description,
+                metadata: { plan_id: plan.id, ...plan.metadata },
+            }));
+        }
+        else {
+            // Update existing product
+            await stripeCall(() => stripe.products.update(product.id, {
+                name: plan.name,
+                description: plan.description,
+                active: !plan.archived,
+                metadata: { plan_id: plan.id, ...plan.metadata },
+            }));
+        }
+        // 2. Ensure price exists with the correct lookup_key
+        const prices = await stripeCall(() => stripe.prices.list({ lookup_keys: [plan.lookup_key], limit: 1 }));
+        if (!prices.data.length) {
+            // Create price with lookup_key
+            await stripeCall(() => stripe.prices.create({
+                product: product.id,
+                unit_amount: plan.amount,
+                currency: plan.currency ?? 'usd',
+                recurring: {
+                    interval: plan.interval,
+                    interval_count: plan.interval_count ?? 1,
+                },
+                lookup_key: plan.lookup_key,
+                transfer_lookup_key: true,
+                metadata: { plan_id: plan.id },
+            }));
+        }
+        else {
+            // If price exists but amount/interval changed, create new price
+            // and transfer the lookup_key
+            const existing_price = prices.data[0];
+            if (existing_price.unit_amount !== plan.amount ||
+                existing_price.recurring?.interval !== plan.interval ||
+                (existing_price.recurring?.interval_count ?? 1) !== (plan.interval_count ?? 1)) {
+                await stripeCall(() => stripe.prices.create({
+                    product: product.id,
+                    unit_amount: plan.amount,
+                    currency: plan.currency ?? 'usd',
+                    recurring: {
+                        interval: plan.interval,
+                        interval_count: plan.interval_count ?? 1,
+                    },
+                    lookup_key: plan.lookup_key,
+                    transfer_lookup_key: true,
+                    metadata: { plan_id: plan.id },
+                }));
+            }
+        }
+    }
+}
+/**
+ * Syncs meter definitions to Stripe Billing Meters.
+ * Idempotent — creates meters that do not exist.
+ */
+export async function syncMeters(config) {
+    if (meters_synced || !config.meters?.length)
+        return;
+    meters_synced = true;
+    const stripe = getStripe(config);
+    // List existing meters
+    const existing = await stripeCall(() => stripe.billing.meters.list({ limit: 100 }));
+    for (const meter of config.meters) {
+        const found = existing.data.find((m) => m.event_name === meter.event_name);
+        if (!found) {
+            await stripeCall(() => stripe.billing.meters.create({
+                display_name: meter.display_name,
+                event_name: meter.event_name,
+                default_aggregation: {
+                    formula: meter.aggregation,
+                },
+                customer_mapping: {
+                    type: 'by_id',
+                    event_payload_key: 'stripe_customer_id',
+                },
+                value_settings: {
+                    event_payload_key: meter.value_key ?? 'value',
+                },
+            }));
+        }
+    }
+}
+/**
+ * Run a full sync of products, prices, and meters.
+ * Called automatically on first request if `sync_on_startup` is enabled.
+ */
+export async function syncAll(config) {
+    await syncProducts(config);
+    await syncMeters(config);
+}

package/dist/server/billing.routes.d.ts

@@ -0,0 +1,8 @@
+import type { RequestEvent } from '@sveltejs/kit';
+import type { ResolvedBillingConfig, AuthServerRpc, WebsocketRpc } from './billing.config';
+export interface RouteContext {
+    getAuthServer?: (event: RequestEvent) => AuthServerRpc | undefined;
+    getWebsocket?: (event: RequestEvent) => WebsocketRpc | undefined;
+}
+export declare function handleBillingRoute(event: RequestEvent, config: ResolvedBillingConfig, route_path: string, method: string, ctx: RouteContext): Promise<Response>;
+//# sourceMappingURL=billing.routes.d.ts.map

package/dist/server/billing.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.routes.d.ts","sourceRoot":"","sources":["../../src/server/billing.routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EACX,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAa1B,MAAM,WAAW,YAAY;IAC5B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,aAAa,GAAG,SAAS,CAAC;IACnE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAAG,SAAS,CAAC;CACjE;AAoLD,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,YAAY,GACf,OAAO,CAAC,QAAQ,CAAC,CA+XnB"}