@fantastic.dev/better-stripe 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## [0.6.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.5.0...v0.6.0) (2026-10-12)
+
+
+### ⚠ BREAKING CHANGES
+
+* the package name changes to @fantastic.dev/better-stripe; @getdojo/better-stripe receives no further releases.
+
+### Features
+
+* complete Stripe Endive compatibility and release 0.5.0 ([#126](https://github.com/FantasticDevHQ/better-stripe/issues/126)) ([135695f](https://github.com/FantasticDevHQ/better-stripe/commit/135695f51906ea156a36dbe8d0d43cf1d99e5fc1))
+* publish as [@fantastic](https://github.com/fantastic).dev/better-stripe via Release Please and trusted publishing (BTS-114) ([#120](https://github.com/FantasticDevHQ/better-stripe/issues/120)) ([7451eeb](https://github.com/FantasticDevHQ/better-stripe/commit/7451eeb514b09a09656355c74c4bec083e1ddce7))
+
+
+### Bug Fixes
+
+* repair example checkout billing and seller flows ([#125](https://github.com/FantasticDevHQ/better-stripe/issues/125)) ([5911fb8](https://github.com/FantasticDevHQ/better-stripe/commit/5911fb8d8bc585fab62fe48e58e1e964047b8fd9))
+
+
+### Maintenance
+
+* **deps:** update dependencies to latest (BTS-115) ([#122](https://github.com/FantasticDevHQ/better-stripe/issues/122)) ([a7e4161](https://github.com/FantasticDevHQ/better-stripe/commit/a7e416179d20afdd2356668cbd4482e2e3fa4eff))
+
+
+### Continuous Integration
+
+* **release:** open release PRs with the org release GitHub App ([#124](https://github.com/FantasticDevHQ/better-stripe/issues/124)) ([3c94f2e](https://github.com/FantasticDevHQ/better-stripe/commit/3c94f2ef317f939ac039c261f9c148e6b1f14a56))
+
+## 0.5.0
+
+### Features
+
+- Incorporate Dojo's `retryOnHookError` webhook patch upstream. Selected,
+  signature-verified V1 `onEvent`/event hooks must succeed before acknowledgment;
+  failed hooks and unavailable ledger writes return 500, in-flight deliveries
+  return 503, and successful redelivery deduplicates. The default remains
+  best-effort. Add regression coverage using real SDK signatures and the real
+  Convex component ledger, including stale-reservation recovery.
+
+### Bug Fixes
+
+- Complete support for Stripe API **`2026-09-30.endive`** with stripe-node
+  **23.0.0** (already pinned in the 0.4.0 checkout). Verify both client factories'
+  outgoing version headers against the typed single-source API constant.
+- Preserve verified V2 notification context when retrieving accounts; accept
+  related-object pointers without an id and resolve accounts from their URL.
+- Map Endive `rejected`/`restricted` capabilities to `restricted` and pending
+  capabilities to `in_progress`, including nested Stripe balance capabilities.
+- Remount embedded Checkout when its key/client secret changes, using React
+  Stripe.js 7's current `createEmbeddedCheckoutPage` integration.
+- Deprecate the retained, ignored V2 account-link `configurations` option and
+  remove its obsolete internal use.
+
+### Migration
+
+See [MIGRATION.md](MIGRATION.md) for removing the Dojo pnpm patch, upgrading
+0.2.0 webhook wiring, billing-anchor/payment-method request changes, and
+**separate consumer-controlled webhook destination upgrades**. The public
+`V2ThinEvent.related_object.id` is now optional; consumers must guard it.
+No account defaults, event destinations, DNS, or production deployments are
+changed by this release.
+
 ## 0.4.0
 
 **Renamed to `@fantastic.dev/better-stripe`.** This is the first release under the new name, published from `FantasticDevHQ/better-stripe` through npm trusted publishing with provenance. `@getdojo/better-stripe` is deprecated and gets no further releases. To migrate, replace `@getdojo/better-stripe` with `@fantastic.dev/better-stripe` in `package.json`, in imports and in `convex.config.ts`, then run `npx convex dev` to regenerate `_generated/`. The API is unchanged by the rename.

package/MIGRATION.md

@@ -0,0 +1,135 @@
+# Migrating to 0.5.0 and Stripe Endive
+
+## Package and runtime
+
+Install `@fantastic.dev/better-stripe@0.5.0`. The old
+`@getdojo/better-stripe` name is deprecated. Replace imports and the component
+config import with the new name, retaining your existing component instance
+name (for example `betterStripe`) so its stored data remains attached. Run
+`npx convex dev` against your development deployment to regenerate bindings.
+Node.js 20 or newer is required by stripe-node 23.
+
+The package depends on `stripe ~23.0.0`, whose supported API is exactly
+`2026-09-30.endive`. The typed `STRIPE_API_VERSION` constant in
+`src/client/constants.ts` pins app clients, component actions, and webhook
+resource refreshes. This SDK and pin were already present in the 0.4.0 checkout;
+0.5.0 adds fulfillment retries and completes the V2/React compatibility fixes.
+Leave `stripeApiVersion` unset to use this pin. The legacy string override is
+retained for compatibility, but overriding it does not change the SDK's types
+or convert webhook payloads and can make requests inconsistent with them.
+
+## Remove Dojo's consumer patch
+
+Remove the `@getdojo/better-stripe@0.2.0` entry from pnpm's
+`patchedDependencies` and delete `patches/@getdojo__better-stripe@0.2.0.patch`.
+Update the dependency/imports and regenerate the lockfile. The upstream
+`RegisterRoutesConfig.retryOnHookError` has the same signature and V1 semantics
+as that patch. Dojo can keep its existing selector:
+
+```ts
+retryOnHookError: (event) => {
+  if (event.type !== "checkout.session.completed" || !("data" in event)) {
+    return false;
+  }
+  const metadata = (event.data.object as {
+    metadata?: Record<string, string>;
+  }).metadata;
+  return (
+    (metadata?.purchaseType ?? metadata?.purchase_type) === "communityMembership" &&
+    metadata?.dojoMembershipFulfillment === "1"
+  );
+},
+```
+
+For selected **verified V1 events**, component processing commits first;
+`onEvent` and the matching `events[type]` hook then run before the event is marked
+processed. A hook failure records `failed` and returns HTTP 500. A concurrent
+delivery returns 503; ledger reservation/completion failures return 500. Failed
+events can be retried immediately; an abandoned processing reservation can be
+retried after ten minutes. Once processed, redelivery deduplicates without
+re-running the hooks. Selector exceptions also return 500.
+
+Hooks and any sync triggers must be idempotent using `event.id` or a durable
+business key: processing can run again after a hook failure, and hook success
+followed by a failed completion write can rerun a successful hook. This is
+at-least-once fulfillment. Unselected events, V2 hooks, and scheduled
+`asyncWebhook` hooks keep their existing best-effort acknowledgment behavior.
+Put required fulfillment in `onEvent`/`events`, not in a scheduled hook.
+
+### Existing breaking change when coming from 0.2.0
+
+The 0.3.0/0.4.0 webhook wiring change remains required: `triggersApi()` was
+replaced by `webhookHandlers()`. The constructor's `triggers` and `hooks` stay
+the same. Export the two wrappers:
+
+```ts
+export const { syncWebhook, asyncWebhook } = stripe.webhookHandlers();
+```
+
+In `registerRoutes`, replace `triggers: internal.stripe` with
+`webhooks: internal.stripe`. Regenerate Convex bindings before using the pair.
+
+## Stripe request and response changes
+
+- **V2 account links:** `use_case.account_onboarding.configurations` and
+  `use_case.account_update.configurations` are removed. The public
+  `createV2AccountLink({ configurations })` option is retained, deprecated, and
+  ignored. Stripe collects requirements for the account without it.
+- **Billing-cycle anchors:** Endive changes Subscription update/resume and
+  invoice preview `subscription_details.billing_cycle_anchor` to an object,
+  for example `{ type: "now" }` or `{ type: "unchanged" }`. These wrappers
+  currently send no billing-cycle anchor; no scalar anchor request needed
+  rewriting. Consumer raw SDK calls to those endpoints must migrate. Creation
+  and Checkout `subscription_data.billing_cycle_anchor` still accept a Unix
+  timestamp; do not convert those fields to the update format.
+- **Payment methods:** Checkout Session creation and PaymentIntent
+  create/update/confirm and SetupIntent create/update no longer accept
+  `payment_method_types`. Use `allowed_payment_method_types` for a restriction,
+  or omit it for dynamic methods; retain `automatic_payment_methods` only where
+  supported. The package's Checkout requests omit the removed parameter.
+  Update consumer `sessionOverrides` and raw Stripe calls; SDK 23 types catch
+  old parameters. Subscription/invoice `payment_settings.payment_method_types`
+  and PaymentMethod list `type` are separate, still-supported parameters.
+- **Account status:** an applied V2 configuration with a `rejected` or
+  `restricted` capability now maps to public `restricted`; a `pending`
+  capability maps to `in_progress`, including nested `stripe_balance` groups.
+  Unsupported optional payment methods do not block onboarding. Existing public
+  status strings remain unchanged.
+- **V2 notifications:** signature verification uses
+  `parseEventNotificationAsync`. Account refreshes propagate the notification's
+  `context` via `stripeContext`. `related_object.id` is now optional because
+  singleton pointers can omit it; account pointers can resolve from their URL.
+  Consumers reading the public thin-event type must guard an absent id. Other
+  singleton resource events remain outside the account-sync handler's scope.
+- **React embedded Checkout:** React Stripe.js 7 calls the current Stripe.js 10
+  `createEmbeddedCheckoutPage` API. `EmbeddedCheckout` keeps its public props and
+  now remounts the provider when the key or client secret changes, destroying
+  the previous session rather than keeping an immutable provider on it.
+
+## Upgrade webhook payload versions separately
+
+Installing this package pins outgoing API requests. It does **not** change your
+Stripe account's default API version or the version of an existing event
+destination. In particular, a V1 snapshot event keeps the version configured on
+its destination, regardless of `stripeApiVersion`.
+
+1. Deploy and test the consumer upgrade in a Stripe sandbox first. Preserve
+   your current endpoint URL, selected events, and signing secrets.
+2. In Stripe Workbench, review the destination's current version and the
+   [Endive changelog](https://docs.stripe.com/changelog/2026-09-30.endive).
+   Review every intervening breaking release if coming from Dahlia.
+3. Use Stripe's destination-version upgrade/testing procedure to test Endive
+   V1 snapshot payloads and V2 thin notifications separately. V2 uses
+   `webhookSecretV2` if set; otherwise it uses `webhookSecret`.
+4. Verify subscription fulfillment, cancellation, required-hook failure/retry,
+   and deduplication in sandbox before explicitly upgrading production
+   destinations. Keep the Stripe rollback window and its documented limits in
+   mind. Do not change the account default version as part of a package upgrade.
+
+The official [stripe-node 23.0.0 changelog](https://github.com/stripe/stripe-node/blob/v23.0.0/CHANGELOG.md#2300---2026-09-30)
+and installed SDK 23 types were reviewed for the breaking request/response
+changes. Further consumer guidance: [Stripe API changelog](https://docs.stripe.com/changelog),
+[API versioning](https://docs.stripe.com/upgrades), and
+[event destinations](https://docs.stripe.com/event-destinations).
+The docs.stripe.com changelog page returned HTTP 403 in this execution
+environment.

package/README.md

@@ -6,7 +6,7 @@ Built for Convex + Next.js applications. Follows the conventions established by
 
 ## Status
 
-**Version**: `0.4.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
+**Version**: `0.6.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
 
 Used in production by its authors. Webhook pipeline is covered by unit tests and a live E2E harness (`npm run e2e:webhooks`) that fires real Stripe-signed events and asserts the ledger.
 
@@ -28,6 +28,25 @@ Release policy lives in `release-please-config.json`. Keep the workflow file nam
 
 The private `example` workspace isn't published.
 
+### Development toolchain
+
+Install with `pnpm install` from the repository root, then run `pnpm build`
+and `pnpm dev` to start the example at http://localhost:5173. The example needs
+Node.js 22.12+ and a configured Convex development deployment; see
+[the example setup guide](example/README.md).
+
+Builds and typechecks use TypeScript 7 (`@typescript/native` aliases
+`typescript`). ESLint and Convex code generation still need the TypeScript 6
+API, so `typescript` aliases Microsoft's `@typescript/typescript6` compatibility
+package. Keep both aliases when updating dependencies, as described in
+[Microsoft's migration guide](https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/#running-side-by-side-with-typescript-6.0).
+
+Stripe 23 targets API version `2026-09-30.endive`. Account links now collect
+requirements without a `configurations` parameter; callers can still pass the
+legacy option, but it is not sent to Stripe. See the
+[Stripe API changelog](https://docs.stripe.com/changelog) before upgrading an
+existing integration to this API version.
+
 ### Regenerating codegen
 
 The component ships committed Convex codegen output at `src/component/_generated/{api,component,dataModel,server}.ts` — consumers reach the bindings via the `./_generated/component` subpath export. The example app also commits its own codegen at `example/convex/_generated/`. Running `pnpm dev` (which wraps `convex dev`) regenerates these automatically when the schema or function definitions change, but only against the live dev deployment and only while the dev server is watching.
@@ -118,6 +137,8 @@ app.use(betterStripe, {
 export default app;
 ```
 
+> **TypeScript 6+:** `compilerOptions.types` now defaults to `[]`, so installed `@types/*` packages are no longer included automatically. If Convex's typecheck reports `Cannot find name 'process'` for the `process.env` reads below, add `"types": ["node"]` to `convex/tsconfig.json` and make sure `@types/node` is a devDependency.
+
 ### Step 2: Create a BetterStripe instance with triggers
 
 ```typescript
@@ -1017,7 +1038,7 @@ the deployment env — no `app.use` wiring required.
 
 ### Stripe API Version
 
-The component pins the Stripe API version internally (`2026-05-27.dahlia`). Upgrading the pinned version requires a package release and changelog entry. Apps do not need to set `STRIPE_API_VERSION`.
+The component pins the Stripe API version internally (`2026-09-30.endive`) using the installed stripe-node 23 SDK's exact API-version type. Upgrading the pinned version requires a package release and changelog entry. Apps do not need to set `STRIPE_API_VERSION`. See [the migration notes](MIGRATION.md) for removing Dojo's fulfillment-retry patch and upgrading webhook payload versions separately.
 
 ### SDK Management
 

package/dist/client/billing/checkout.d.ts.map

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

package/dist/client/billing/checkout.js

@@ -38,18 +38,30 @@ function deriveFeeRow(params) {
     return {};
 }
 /**
- * Destination charges require the price to live on the PLATFORM account, not a
- * connected account. Best-effort guard: if the price is in the component catalog
- * and its product belongs to a connected account, throw a clear error before
- * hitting Stripe. A price absent from the catalog is left to Stripe to validate.
+ * Destination and separate charges use platform prices. Catalog accountId is a
+ * store attribution tag, not Stripe ownership (createProduct uses the platform).
+ * For tagged products, verify the price in the platform Stripe context before
+ * rejecting it. Untagged/unknown catalog entries are validated by Checkout.
  */
-async function assertPlatformPrice(component, ctx, stripePriceId) {
+async function assertPlatformPrice(stripe, component, ctx, stripePriceId) {
     const price = (await ctx.runQuery(componentRef(component, "products/queries/getPriceByStripeId"), { stripePriceId }));
     if (!price?.stripeProductId)
         return;
     const product = (await ctx.runQuery(componentRef(component, "products/queries/getProductByStripeId"), { stripeProductId: price.stripeProductId }));
     if (product?.accountId) {
-        throwStripeError("INVALID_CONFIGURATION", `Price ${stripePriceId} belongs to connected account ${product.accountId}; destination charges require a platform-owned price.`);
+        try {
+            await stripe.prices.retrieve(stripePriceId);
+        }
+        catch (error) {
+            // Only absence on the platform means the ownership check failed.
+            // Auth/network/rate-limit failures must not be misreported as ownership.
+            if (!error ||
+                typeof error !== "object" ||
+                !("code" in error) ||
+                error.code !== "resource_missing")
+                throw error;
+            throwStripeError("INVALID_CONFIGURATION", `Price ${stripePriceId} is unavailable on the platform account; destination charges require a platform-owned price.`);
+        }
     }
 }
 // =============================================================================
@@ -85,7 +97,9 @@ export async function createCheckoutSession(stripe, component, ctx, opts) {
         ? {
             bsChargeType: "separate",
             bsSplit: JSON.stringify(opts.split),
-            ...(opts.feeConfig ? { bsFeeConfig: JSON.stringify(opts.feeConfig) } : {}),
+            ...(opts.feeConfig
+                ? { bsFeeConfig: JSON.stringify(opts.feeConfig) }
+                : {}),
         }
         : {};
     // Strip the reserved `bs*` namespace from caller metadata so it can't forge
@@ -216,7 +230,7 @@ export async function createCheckoutSession(stripe, component, ctx, opts) {
     const finalPriceId = finalSessionParams.line_items?.[0]?.price;
     if ((isSeparate || feeRow.chargeType === "destination") &&
         typeof finalPriceId === "string") {
-        await assertPlatformPrice(component, ctx, finalPriceId);
+        await assertPlatformPrice(stripe, component, ctx, finalPriceId);
     }
     const session = await stripe.checkout.sessions.create(finalSessionParams);
     await runMutationOrThrow(ctx, componentRef(component, "billing/mutations/upsertCheckoutSession"), {

package/dist/client/billing/checkout.js.map

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

package/dist/client/billing/subscriptionRouting.d.ts

@@ -0,0 +1,24 @@
+import type Stripe from "stripe";
+/** Recover routing from Stripe for both webhook delivery and explicit syncs. */
+export declare function subscriptionRouting(subscription: Stripe.Subscription): {
+    chargeType: "destination";
+    destinationAccountId: string;
+    applicationFeePercent: number | undefined;
+    splitRecipients?: undefined;
+} | {
+    destinationAccountId?: undefined;
+    applicationFeePercent?: undefined;
+    chargeType: "separate";
+    splitRecipients: {
+        amount?: number | undefined;
+        destinationAccountId: string;
+        percent?: number | undefined;
+        role: "affiliate" | "other" | "store";
+    }[];
+} | {
+    destinationAccountId?: undefined;
+    applicationFeePercent?: undefined;
+    chargeType?: undefined;
+    splitRecipients?: undefined;
+};
+//# sourceMappingURL=subscriptionRouting.d.ts.map

package/dist/client/billing/subscriptionRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionRouting.d.ts","sourceRoot":"","sources":["../../../src/client/billing/subscriptionRouting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAKjC,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY;gBAInD,aAAa;;;;;;;gBAWN,UAAU;;;;;;;;;;;;EAGlC"}

package/dist/client/billing/subscriptionRouting.js

@@ -0,0 +1,19 @@
+import { validateSplit } from "../core/fees.js";
+/** Recover routing from Stripe for both webhook delivery and explicit syncs. */
+export function subscriptionRouting(subscription) {
+    const destination = subscription.transfer_data?.destination;
+    if (destination) {
+        return {
+            chargeType: "destination",
+            destinationAccountId: typeof destination === "string" ? destination : destination.id,
+            applicationFeePercent: subscription.application_fee_percent ?? undefined,
+        };
+    }
+    if (subscription.metadata?.bsChargeType === "separate") {
+        const split = JSON.parse(subscription.metadata.bsSplit ?? "null");
+        validateSplit(split);
+        return { chargeType: "separate", splitRecipients: split };
+    }
+    return {};
+}
+//# sourceMappingURL=subscriptionRouting.js.map

package/dist/client/billing/subscriptionRouting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionRouting.js","sourceRoot":"","sources":["../../../src/client/billing/subscriptionRouting.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,YAAiC;IACnE,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,EAAE,WAAW,CAAC;IAC5D,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,UAAU,EAAE,aAAsB;YAClC,oBAAoB,EAClB,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;YAChE,qBAAqB,EAAE,YAAY,CAAC,uBAAuB,IAAI,SAAS;SACzE,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,EAAE,YAAY,KAAK,UAAU,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CACtB,YAAY,CAAC,QAAQ,CAAC,OAAO,IAAI,MAAM,CACpB,CAAC;QACtB,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,UAAmB,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/client/billing/subscriptions.d.ts

@@ -21,6 +21,8 @@ export declare function createSubscription(stripe: Stripe, component: Component,
     split?: SplitRecipient[];
     feeConfig?: PlatformFeeConfig;
     trialDays?: number;
+    /** Attached payment method to use for this subscription. */
+    defaultPaymentMethod?: string;
     /** Platform-default statement-descriptor suffix (BTS-32); see checkout.ts. */
     defaultStatementDescriptorSuffix?: string;
     metadata?: Record<string, string>;
@@ -54,8 +56,8 @@ export declare function updateSubscriptionQuantity(stripe: Stripe, _ctx: RunCtx,
     success: boolean;
 }>;
 /**
- * Pause collection on a subscription. Sets `pause_collection` (Stripe transitions
- * the subscription to `status: "paused"`); the component DB is updated when the
+ * Pause collection on a subscription. Sets `pause_collection` without changing
+ * the subscription status; the component DB is updated when the
  * resulting `customer.subscription.updated` webhook arrives.
  */
 export declare function pauseSubscription(stripe: Stripe, _ctx: RunCtx, opts: {
@@ -66,10 +68,8 @@ export declare function pauseSubscription(stripe: Stripe, _ctx: RunCtx, opts: {
     success: boolean;
 }>;
 /**
- * Resume a paused subscription by clearing `pause_collection`. There is no
- * dedicated Stripe resume endpoint — passing the empty-string sentinel
- * (`Emptyable<PauseCollection>`) clears the field and Stripe returns the
- * subscription to its prior active status.
+ * Resume payment collection by clearing `pause_collection`. The empty-string
+ * sentinel clears the field without changing the subscription status.
  */
 export declare function resumeSubscription(stripe: Stripe, _ctx: RunCtx, opts: {
     stripeSubscriptionId: string;

package/dist/client/billing/subscriptions.d.ts.map

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

package/dist/client/billing/subscriptions.js

@@ -1,3 +1,5 @@
+import { subscriptionRouting } from "./subscriptionRouting.js";
+import { resolveOwnerAccount } from "../utils/owner.js";
 import { isPercentOnlyFee, validateSplit } from "../core/fees.js";
 import { epochToIso, runMutationOrThrow, stripReservedMetadata, } from "../helpers.js";
 import { throwStripeError } from "../errors.js";
@@ -64,6 +66,9 @@ export async function createSubscription(stripe, component, ctx, opts) {
     }
     const params = {
         customer_account: opts.customerAccount,
+        ...(opts.defaultPaymentMethod
+            ? { default_payment_method: opts.defaultPaymentMethod }
+            : {}),
         items: [{ price: opts.stripePriceId }],
         metadata,
     };
@@ -78,7 +83,9 @@ export async function createSubscription(stripe, component, ctx, opts) {
             ...metadata,
             bsChargeType: "separate",
             bsSplit: JSON.stringify(opts.split),
-            ...(opts.feeConfig ? { bsFeeConfig: JSON.stringify(opts.feeConfig) } : {}),
+            ...(opts.feeConfig
+                ? { bsFeeConfig: JSON.stringify(opts.feeConfig) }
+                : {}),
         };
         feeRow.chargeType = "separate";
         feeRow.splitRecipients = opts.split;
@@ -111,13 +118,27 @@ export async function createSubscription(stripe, component, ctx, opts) {
         ? { idempotencyKey: opts.idempotencyKey }
         : undefined;
     const sub = await callStripe("Failed to create subscription", () => stripe.subscriptions.create(params, requestOpts));
+    // Stripe 23 permits future status strings; our ledger accepts only these
+    // known statuses. Reject an unknown value before attempting to persist it.
+    const isKnownStatus = (value) => value === "active" ||
+        value === "canceled" ||
+        value === "incomplete" ||
+        value === "incomplete_expired" ||
+        value === "past_due" ||
+        value === "paused" ||
+        value === "trialing" ||
+        value === "unpaid";
+    const status = sub.status;
+    if (!isKnownStatus(status)) {
+        throwStripeError("STRIPE_API_ERROR", `Unsupported subscription status: ${status}`);
+    }
     const firstItem = sub.items?.data?.[0];
     await runMutationOrThrow(ctx, componentRef(component, "billing/mutations/upsertSubscription"), {
         stripeSubscriptionId: sub.id,
         accountId: opts.customerAccount,
         userId: opts.userId,
         orgId: opts.orgId,
-        status: sub.status,
+        status,
         priceId: firstItem?.price?.id ?? opts.stripePriceId,
         quantity: firstItem?.quantity ?? undefined,
         currentPeriodStart: epochToIso(firstItem?.current_period_start ?? undefined),
@@ -130,7 +151,7 @@ export async function createSubscription(stripe, component, ctx, opts) {
         ...feeRow,
         metadata: sub.metadata ?? undefined,
     });
-    return { stripeSubscriptionId: sub.id, status: sub.status };
+    return { stripeSubscriptionId: sub.id, status };
 }
 export async function getSubscription(component, ctx, opts) {
     return (await ctx.runQuery(componentRef(component, "billing/queries/getSubscription"), opts));
@@ -165,8 +186,8 @@ export async function updateSubscriptionQuantity(stripe, _ctx, opts) {
     return { success: true };
 }
 /**
- * Pause collection on a subscription. Sets `pause_collection` (Stripe transitions
- * the subscription to `status: "paused"`); the component DB is updated when the
+ * Pause collection on a subscription. Sets `pause_collection` without changing
+ * the subscription status; the component DB is updated when the
  * resulting `customer.subscription.updated` webhook arrives.
  */
 export async function pauseSubscription(stripe, _ctx, opts) {
@@ -179,10 +200,8 @@ export async function pauseSubscription(stripe, _ctx, opts) {
     return { success: true };
 }
 /**
- * Resume a paused subscription by clearing `pause_collection`. There is no
- * dedicated Stripe resume endpoint — passing the empty-string sentinel
- * (`Emptyable<PauseCollection>`) clears the field and Stripe returns the
- * subscription to its prior active status.
+ * Resume payment collection by clearing `pause_collection`. The empty-string
+ * sentinel clears the field without changing the subscription status.
  */
 export async function resumeSubscription(stripe, _ctx, opts) {
     await callStripe("Failed to resume subscription", () => stripe.subscriptions.update(opts.stripeSubscriptionId, {
@@ -294,9 +313,8 @@ export async function syncAllSubscriptions(stripe, component, ctx) {
             const periodEnd = firstItem?.current_period_end ?? undefined;
             await runMutationOrThrow(ctx, componentRef(component, "billing/mutations/upsertSubscription"), {
                 stripeSubscriptionId: sub.id,
-                accountId: typeof sub.customer === "string"
-                    ? sub.customer
-                    : (sub.customer?.id ?? ""),
+                ...subscriptionRouting(sub),
+                accountId: resolveOwnerAccount(sub) ?? "",
                 userId,
                 orgId,
                 status: sub.status,
@@ -305,6 +323,7 @@ export async function syncAllSubscriptions(stripe, component, ctx) {
                 currentPeriodStart: epochToIso(periodStart),
                 currentPeriodEnd: epochToIso(periodEnd),
                 cancelAtPeriodEnd: sub.cancel_at_period_end,
+                isCollectionPaused: !!sub.pause_collection,
                 canceledAt: epochToIso(sub.canceled_at),
                 isTrialing: sub.status === "trialing",
                 trialStart: epochToIso(sub.trial_start),