@shware/purchase 4.2.1 → 5.0.0

package/dist/_virtual/_rolldown/runtime.cjs

@@ -15,7 +15,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/app-store/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/app-store/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nconst addMethod = Symbol('addMethod');\n\nclass Subscription<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends string = never,\n> {\n  readonly plan: PE;\n  readonly billingPeriod: BP;\n  readonly config: AppStoreConfig<NS, PE, BP, PL, PI>;\n  readonly products: Map<string, Metadata>;\n\n  defaultProductId: I | null;\n\n  constructor(config: AppStoreConfig<NS, PE, BP, PL, PI>, plan: PE, billingPeriod: BP) {\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.config = config;\n    this.products = new Map();\n    this.defaultProductId = null;\n  }\n\n  /**\n   * Non-default products stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * sell a legacy product to new users unless that is intentional.\n   */\n  product = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Subscription<NS, PE, BP, PL, PI | K, I | K> => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.products.set(productId, metadata);\n    return this as Subscription<NS, PE, BP, PL, PI | K, I | K>;\n  };\n\n  default = (defaultProductId: I) => {\n    invariant(\n      this.products.has(defaultProductId),\n      `Default product ${defaultProductId} is not declared`\n    );\n    this.defaultProductId = defaultProductId;\n    this.config[addMethod](this as never);\n    return this.config;\n  };\n}\n\ntype Options = { appId: `${number}`; bundleId: string };\n\nexport class AppStoreConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  readonly appId: string;\n  readonly bundleId: string;\n\n  private readonly products: Map<string, Metadata | null>;\n  private readonly consumables: Set<string>;\n  private readonly subscriptions: Map<string, Subscription<NS, PE, BP, PL, PI>>;\n  private readonly nonConsumables: Set<string>;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (subscription: Subscription<NS, PE, BP, PL, PI>) => {\n    const key = `${subscription.plan}:${subscription.billingPeriod}`;\n    invariant(!this.subscriptions.has(key), `Duplicate plan ${key}`);\n    subscription.products.forEach((metadata, productId) => {\n      invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n      this.products.set(productId, metadata);\n    });\n    this.subscriptions.set(key, subscription);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.appId = options.appId;\n    this.bundleId = options.bundleId;\n    this.products = new Map();\n    this.consumables = new Set();\n    this.subscriptions = new Map();\n    this.nonConsumables = new Set();\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new AppStoreConfig<NS, PE, BP>(options);\n  };\n\n  /** The same plan may be declared once per billing period; duplicate pairs are rejected. */\n  subscription = <K extends PE, P extends BP>(\n    plan: K,\n    billingPeriod: `${K}:${P}` extends PL ? never : P\n  ) => {\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- tsc requires the cast (tsgolint false positive)\n    return new Subscription<NS, PE, BP, `${K}:${P}` | PL, PI>(this as never, plan, billingPeriod);\n  };\n\n  consumable = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.consumables.add(productId);\n    this.products.set(productId, metadata);\n    return this as AppStoreConfig<NS, PE, BP, PL, PI | K>;\n  };\n\n  nonConsumable = <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.nonConsumables.add(productId);\n    this.products.set(productId, null);\n    return this as AppStoreConfig<NS, PE, BP, PL, PI | K>;\n  };\n\n  /** Product id that new subscribers should purchase for the plan and billing period. */\n  getDefaultProductId = (plan: PE, billingPeriod: BP): string => {\n    const subscription = this.subscriptions.get(`${plan}:${billingPeriod}`);\n    invariant(subscription, `Subscription not found for ${plan}:${billingPeriod}`);\n    invariant(\n      subscription.defaultProductId,\n      `Default product not found for ${plan}:${billingPeriod}`\n    );\n    return subscription.defaultProductId;\n  };\n\n  getPlan = (productId: string): PE => {\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return subscription.plan;\n    }\n    throw new Error(`Plan not found for product ${productId}`);\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return subscription.billingPeriod;\n    }\n    throw new Error(`Billing period not found for product ${productId}`);\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    if (this.consumables.has(productId) || this.nonConsumables.has(productId)) return 'payment';\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return 'subscription';\n    }\n    throw new Error(`Mode not found for product ${productId}`);\n  };\n\n  getCreditAmount = (productId: string): number => {\n    const config = this.products.get(productId);\n    invariant(config !== undefined, `Product not found for ${productId}`);\n    invariant(config !== null, `Credits not available for non-consumable product ${productId}`);\n    return config.credits;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string): number => {\n    const config = this.products.get(productId);\n    invariant(config, `Product not found for ${productId}`);\n    return ms(config.expiresIn);\n  };\n\n  getCreditExpiresAt = (productId: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../../src/app-store/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nconst addMethod = Symbol('addMethod');\n\nclass Subscription<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends string = never,\n> {\n  readonly plan: PE;\n  readonly billingPeriod: BP;\n  readonly config: AppStoreConfig<NS, PE, BP, PL, PI>;\n  readonly products: Map<string, Metadata>;\n\n  defaultProductId: I | null;\n\n  constructor(config: AppStoreConfig<NS, PE, BP, PL, PI>, plan: PE, billingPeriod: BP) {\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.config = config;\n    this.products = new Map();\n    this.defaultProductId = null;\n  }\n\n  /**\n   * Non-default products stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * sell a legacy product to new users unless that is intentional.\n   */\n  product = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Subscription<NS, PE, BP, PL, PI | K, I | K> => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.products.set(productId, metadata);\n    return this as Subscription<NS, PE, BP, PL, PI | K, I | K>;\n  };\n\n  default = (defaultProductId: I) => {\n    invariant(\n      this.products.has(defaultProductId),\n      `Default product ${defaultProductId} is not declared`\n    );\n    this.defaultProductId = defaultProductId;\n    this.config[addMethod](this as never);\n    return this.config;\n  };\n}\n\ntype Options = { appId: `${number}`; bundleId: string };\n\nexport class AppStoreConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  readonly appId: string;\n  readonly bundleId: string;\n\n  private readonly products: Map<string, Metadata | null>;\n  private readonly consumables: Set<string>;\n  private readonly subscriptions: Map<string, Subscription<NS, PE, BP, PL, PI>>;\n  private readonly nonConsumables: Set<string>;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (subscription: Subscription<NS, PE, BP, PL, PI>) => {\n    const key = `${subscription.plan}:${subscription.billingPeriod}`;\n    invariant(!this.subscriptions.has(key), `Duplicate plan ${key}`);\n    subscription.products.forEach((metadata, productId) => {\n      invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n      this.products.set(productId, metadata);\n    });\n    this.subscriptions.set(key, subscription);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.appId = options.appId;\n    this.bundleId = options.bundleId;\n    this.products = new Map();\n    this.consumables = new Set();\n    this.subscriptions = new Map();\n    this.nonConsumables = new Set();\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new AppStoreConfig<NS, PE, BP>(options);\n  };\n\n  /** The same plan may be declared once per billing period; duplicate pairs are rejected. */\n  subscription = <K extends PE, P extends BP>(\n    plan: K,\n    billingPeriod: `${K}:${P}` extends PL ? never : P\n  ) => {\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- tsc requires the cast (tsgolint false positive)\n    return new Subscription<NS, PE, BP, `${K}:${P}` | PL, PI>(this as never, plan, billingPeriod);\n  };\n\n  consumable = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.consumables.add(productId);\n    this.products.set(productId, metadata);\n    return this as AppStoreConfig<NS, PE, BP, PL, PI | K>;\n  };\n\n  nonConsumable = <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.nonConsumables.add(productId);\n    this.products.set(productId, null);\n    return this as AppStoreConfig<NS, PE, BP, PL, PI | K>;\n  };\n\n  /** Product id that new subscribers should purchase for the plan and billing period. */\n  getDefaultProductId = (plan: PE, billingPeriod: BP): string => {\n    const subscription = this.subscriptions.get(`${plan}:${billingPeriod}`);\n    invariant(subscription, `Subscription not found for ${plan}:${billingPeriod}`);\n    invariant(\n      subscription.defaultProductId,\n      `Default product not found for ${plan}:${billingPeriod}`\n    );\n    return subscription.defaultProductId;\n  };\n\n  getPlan = (productId: string): PE => {\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return subscription.plan;\n    }\n    throw new Error(`Plan not found for product ${productId}`);\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return subscription.billingPeriod;\n    }\n    throw new Error(`Billing period not found for product ${productId}`);\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    if (this.consumables.has(productId) || this.nonConsumables.has(productId)) return 'payment';\n    for (const subscription of this.subscriptions.values()) {\n      if (subscription.products.has(productId)) return 'subscription';\n    }\n    throw new Error(`Mode not found for product ${productId}`);\n  };\n\n  getCreditAmount = (productId: string): number => {\n    const config = this.products.get(productId);\n    invariant(config !== undefined, `Product not found for ${productId}`);\n    invariant(config !== null, `Credits not available for non-consumable product ${productId}`);\n    return config.credits;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string): number => {\n    const config = this.products.get(productId);\n    invariant(config, `Product not found for ${productId}`);\n    return ms(config.expiresIn);\n  };\n\n  getCreditExpiresAt = (productId: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}

package/dist/google-play/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/google-play/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { IsUnique, Metadata } from '../types';\n\nconst addMethod = Symbol('addMethod');\n\nclass Subscription<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PI extends string = never,\n  I extends Lowercase<string> = never,\n> {\n  readonly productId: string;\n  readonly config: GooglePlayConfig<NS, PE, BP, PI>;\n  readonly plans: Map<string, Metadata & { plan?: PE; billingPeriod?: BP }>;\n  readonly defaultPlans: Set<string>;\n\n  constructor(config: GooglePlayConfig<NS, PE, BP, PI>, productId: string) {\n    this.config = config;\n    this.productId = productId;\n    this.plans = new Map();\n    this.defaultPlans = new Set();\n  }\n\n  /**\n   * Non-default base plans stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never sell\n   * a legacy base plan to new users unless that is intentional.\n   */\n  basePlan = <K extends Lowercase<string>>(\n    planId: K extends I ? never : K,\n    plan: PE,\n    billingPeriod: BP,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Subscription<NS, PE, BP, PI, I | K> => {\n    invariant(!this.plans.has(planId), `Duplicate base plan ${planId}`);\n    this.plans.set(planId, { ...metadata, plan, billingPeriod });\n    return this;\n  };\n\n  default = <const T extends readonly [I, ...I[]]>(\n    planIds: T & (IsUnique<T> extends true ? unknown : never)\n  ) => {\n    planIds.forEach((planId) => {\n      invariant(this.plans.has(planId), `Default base plan ${planId} is not declared`);\n      this.defaultPlans.add(planId);\n    });\n    this.config[addMethod](this);\n    return this.config;\n  };\n}\n\ntype Options = { package: string; audience: string };\n\nexport class GooglePlayConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PI extends string = never,\n> {\n  readonly package: string;\n  readonly audience: string;\n  private readonly onetimes: Set<string>;\n  private readonly subscriptions: Map<string, Subscription<NS, PE, BP, PI>>;\n  private readonly products: Map<string, (Metadata & { plan?: PE; billingPeriod?: BP }) | null>;\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (subscription: Subscription<NS, PE, BP, PI>) => {\n    invariant(\n      !this.subscriptions.has(subscription.productId),\n      `Duplicate subscription ${subscription.productId}`\n    );\n    subscription.plans.forEach((metadata, planId) => {\n      const id = this.getId(subscription.productId, planId);\n      invariant(!this.products.has(id), `Duplicate product ${id}`);\n      this.products.set(id, metadata);\n    });\n    this.subscriptions.set(subscription.productId, subscription);\n    return this;\n  };\n\n  private readonly getId = (productId: string, planId?: string) => {\n    return planId ? `${productId}:${planId}` : productId;\n  };\n\n  private constructor(options: Options) {\n    this.package = options.package;\n    this.audience = options.audience;\n    this.products = new Map();\n    this.onetimes = new Set();\n    this.subscriptions = new Map();\n  }\n\n  static create = <\n    NS extends Lowercase<string>,\n    PE extends string = string,\n    BP extends string = string,\n  >(\n    options: Options\n  ) => {\n    return new GooglePlayConfig<NS, PE, BP>(options);\n  };\n\n  subscription = <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K) => {\n    return new Subscription<NS, PE, BP, PI | K>(this, productId);\n  };\n\n  onetime = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.onetimes.add(productId);\n    this.products.set(productId, metadata);\n    return this as GooglePlayConfig<NS, PE, BP, PI | K>;\n  };\n\n  /** Base plan ids that new subscribers should purchase for the product. */\n  getDefaultPlanIds = (productId: string): string[] => {\n    const subscription = this.subscriptions.get(productId);\n    invariant(subscription, `Subscription not found for ${productId}`);\n    return Array.from(subscription.defaultPlans);\n  };\n\n  getPlan = (productId: string, planId: string): PE => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    invariant(metadata.plan, `Plan not found for ${id}`);\n    return metadata.plan;\n  };\n\n  getBillingPeriod = (productId: string, planId: string): BP => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    invariant(metadata.billingPeriod, `Billing period not found for ${id}`);\n    return metadata.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    if (this.onetimes.has(productId)) return 'payment';\n    if (this.subscriptions.has(productId)) return 'subscription';\n    throw new Error(`Mode not found for product ${productId}`);\n  };\n\n  getCreditAmount = (productId: string, planId?: string): number => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    return metadata.credits;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, planId?: string): number => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    return ms(metadata.expiresIn);\n  };\n\n  getCreditExpiresAt = (productId: string, planId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, planId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../../src/google-play/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { IsUnique, Metadata } from '../types';\n\nconst addMethod = Symbol('addMethod');\n\nclass Subscription<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PI extends string = never,\n  I extends Lowercase<string> = never,\n> {\n  readonly productId: string;\n  readonly config: GooglePlayConfig<NS, PE, BP, PI>;\n  readonly plans: Map<string, Metadata & { plan?: PE; billingPeriod?: BP }>;\n  readonly defaultPlans: Set<string>;\n\n  constructor(config: GooglePlayConfig<NS, PE, BP, PI>, productId: string) {\n    this.config = config;\n    this.productId = productId;\n    this.plans = new Map();\n    this.defaultPlans = new Set();\n  }\n\n  /**\n   * Non-default base plans stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never sell\n   * a legacy base plan to new users unless that is intentional.\n   */\n  basePlan = <K extends Lowercase<string>>(\n    planId: K extends I ? never : K,\n    plan: PE,\n    billingPeriod: BP,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Subscription<NS, PE, BP, PI, I | K> => {\n    invariant(!this.plans.has(planId), `Duplicate base plan ${planId}`);\n    this.plans.set(planId, { ...metadata, plan, billingPeriod });\n    return this;\n  };\n\n  default = <const T extends readonly [I, ...I[]]>(\n    planIds: T & (IsUnique<T> extends true ? unknown : never)\n  ) => {\n    planIds.forEach((planId) => {\n      invariant(this.plans.has(planId), `Default base plan ${planId} is not declared`);\n      this.defaultPlans.add(planId);\n    });\n    this.config[addMethod](this);\n    return this.config;\n  };\n}\n\ntype Options = { package: string; audience: string };\n\nexport class GooglePlayConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PI extends string = never,\n> {\n  readonly package: string;\n  readonly audience: string;\n  private readonly onetimes: Set<string>;\n  private readonly subscriptions: Map<string, Subscription<NS, PE, BP, PI>>;\n  private readonly products: Map<string, (Metadata & { plan?: PE; billingPeriod?: BP }) | null>;\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (subscription: Subscription<NS, PE, BP, PI>) => {\n    invariant(\n      !this.subscriptions.has(subscription.productId),\n      `Duplicate subscription ${subscription.productId}`\n    );\n    subscription.plans.forEach((metadata, planId) => {\n      const id = this.getId(subscription.productId, planId);\n      invariant(!this.products.has(id), `Duplicate product ${id}`);\n      this.products.set(id, metadata);\n    });\n    this.subscriptions.set(subscription.productId, subscription);\n    return this;\n  };\n\n  private readonly getId = (productId: string, planId?: string) => {\n    return planId ? `${productId}:${planId}` : productId;\n  };\n\n  private constructor(options: Options) {\n    this.package = options.package;\n    this.audience = options.audience;\n    this.products = new Map();\n    this.onetimes = new Set();\n    this.subscriptions = new Map();\n  }\n\n  static create = <\n    NS extends Lowercase<string>,\n    PE extends string = string,\n    BP extends string = string,\n  >(\n    options: Options\n  ) => {\n    return new GooglePlayConfig<NS, PE, BP>(options);\n  };\n\n  subscription = <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K) => {\n    return new Subscription<NS, PE, BP, PI | K>(this, productId);\n  };\n\n  onetime = <K extends `${NS}.${Lowercase<string>}`>(\n    productId: K extends PI ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ) => {\n    invariant(!this.products.has(productId), `Duplicate product ${productId}`);\n    this.onetimes.add(productId);\n    this.products.set(productId, metadata);\n    return this as GooglePlayConfig<NS, PE, BP, PI | K>;\n  };\n\n  /** Base plan ids that new subscribers should purchase for the product. */\n  getDefaultPlanIds = (productId: string): string[] => {\n    const subscription = this.subscriptions.get(productId);\n    invariant(subscription, `Subscription not found for ${productId}`);\n    return Array.from(subscription.defaultPlans);\n  };\n\n  getPlan = (productId: string, planId: string): PE => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    invariant(metadata.plan, `Plan not found for ${id}`);\n    return metadata.plan;\n  };\n\n  getBillingPeriod = (productId: string, planId: string): BP => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    invariant(metadata.billingPeriod, `Billing period not found for ${id}`);\n    return metadata.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    if (this.onetimes.has(productId)) return 'payment';\n    if (this.subscriptions.has(productId)) return 'subscription';\n    throw new Error(`Mode not found for product ${productId}`);\n  };\n\n  getCreditAmount = (productId: string, planId?: string): number => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    return metadata.credits;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, planId?: string): number => {\n    const id = this.getId(productId, planId);\n    const metadata = this.products.get(id);\n    invariant(metadata, `Product not found for ${id}`);\n    return ms(metadata.expiresIn);\n  };\n\n  getCreditExpiresAt = (productId: string, planId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, planId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}

package/dist/stripe/config.cjs

@@ -33,15 +33,30 @@ var Product = class {
 		this.prices.set(priceId, metadata);
 		return this;
 	};
-	default = (defaultPriceId) => {
-		(0, _shware_utils.invariant)(this.prices.has(defaultPriceId), `Default price ${defaultPriceId} is not declared`);
-		this.defaultPriceId = defaultPriceId;
+	/**
+	* `test` is the sandbox twin of the default price. In test mode it is what
+	* checkouts are created with, and it resolves to the default price's
+	* entitlement, so credits are declared once and cannot drift between the
+	* two modes. Legacy prices need no twin: a sandbox holds no grandfathered
+	* subscribers. Live mode ignores it, so a test price reaching a live config
+	* still fails as an unknown price instead of being granted an entitlement.
+	*/
+	default = (defaultPriceId, twin) => {
+		const metadata = this.prices.get(defaultPriceId);
+		(0, _shware_utils.invariant)(metadata, `Default price ${defaultPriceId} is not declared`);
+		if (this.config.mode === "test") {
+			(0, _shware_utils.invariant)(twin, `Test price not declared for default ${defaultPriceId} of ${this.id}`);
+			(0, _shware_utils.invariant)(!this.prices.has(twin.test), `Duplicate price ${twin.test}`);
+			this.prices.set(twin.test, metadata);
+			this.defaultPriceId = twin.test;
+		} else this.defaultPriceId = defaultPriceId;
 		this.config[addMethod](this);
 		return this.config;
 	};
 };
 var StripeConfig = class StripeConfig {
 	products = /* @__PURE__ */ new Map();
+	mode;
 	returnUrl;
 	cancelUrl;
 	successUrl;
@@ -57,6 +72,7 @@ var StripeConfig = class StripeConfig {
 		return this;
 	};
 	constructor(options) {
+		this.mode = options.mode;
 		this.returnUrl = options.returnUrl;
 		this.cancelUrl = options.cancelUrl;
 		this.successUrl = options.successUrl;
@@ -88,6 +104,7 @@ var StripeConfig = class StripeConfig {
 		(0, _shware_utils.invariant)(product, `Product not found for ${productId}`);
 		return product.plan === null ? "payment" : "subscription";
 	};
+	/** The price new checkouts are created with: the default, or its test twin in test mode. */
 	getPriceId = (productId) => {
 		const product = this.products.get(productId);
 		(0, _shware_utils.invariant)(product, `Product not found for ${productId}`);

package/dist/stripe/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/stripe/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nexport type PriceId = `price_${string}`;\n\nconst addMethod = Symbol('addMethod');\n\nclass Product<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends PriceId = never,\n> {\n  readonly id: string;\n  readonly config: StripeConfig<NS, PE, BP, PL, PI>;\n  readonly plan: PE | null;\n  readonly billingPeriod: BP | null;\n  readonly prices: Map<PriceId, Metadata>;\n\n  defaultPriceId: I | null;\n\n  constructor(\n    config: StripeConfig<NS, PE, BP, PL, PI>,\n    id: string,\n    plan: PE | null = null,\n    billingPeriod: BP | null = null\n  ) {\n    this.id = id;\n    this.config = config;\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.prices = new Map();\n    this.defaultPriceId = null;\n  }\n\n  /**\n   * Non-default prices stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * create new checkouts with a legacy price unless that is intentional.\n   */\n  price = <K extends PriceId>(\n    priceId: K extends I ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Product<NS, PE, BP, PL, PI, I | K> => {\n    invariant(!this.prices.has(priceId), `Duplicate price ${priceId}`);\n    this.prices.set(priceId, metadata);\n    return this as Product<NS, PE, BP, PL, PI, I | K>;\n  };\n\n  default = (defaultPriceId: I) => {\n    invariant(this.prices.has(defaultPriceId), `Default price ${defaultPriceId} is not declared`);\n    this.defaultPriceId = defaultPriceId;\n    this.config[addMethod](this as never);\n    return this.config;\n  };\n}\n\ntype Options = {\n  returnUrl: string;\n  cancelUrl: string;\n  successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  cancellationCouponId: string;\n  allowPromotionCodes: boolean;\n};\n\nexport class StripeConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  private readonly products: Map<string, Product<NS, PE, BP, PL, PI>> = new Map();\n\n  public returnUrl: string;\n  public cancelUrl: string;\n  public successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  public cancellationCouponId: string;\n  public allowPromotionCodes: boolean;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (product: Product<NS, PE, BP, PL, PI>) => {\n    invariant(!this.products.has(product.id), `Duplicate product ${product.id}`);\n    if (product.plan !== null) {\n      for (const existing of this.products.values()) {\n        invariant(\n          existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod,\n          `Duplicate plan ${product.plan}:${product.billingPeriod}`\n        );\n      }\n    }\n    this.products.set(product.id, product);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.returnUrl = options.returnUrl;\n    this.cancelUrl = options.cancelUrl;\n    this.successUrl = options.successUrl;\n    this.cancellationCouponId = options.cancellationCouponId;\n    this.allowPromotionCodes = options.allowPromotionCodes;\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new StripeConfig<NS, PE, BP>(options);\n  };\n\n  /**\n   * One-time products take no extra args; subscriptions require both plan and billingPeriod.\n   * A plan+period pair may be declared on only one product — version its prices in that chain.\n   */\n  product: {\n    <K extends `${NS}.${Lowercase<string>}`>(\n      productId: K extends PI ? never : K\n    ): Product<NS, PE, BP, PL, K | PI>;\n    <K extends `${NS}.${Lowercase<string>}`, L extends PE, P extends BP>(\n      productId: K extends PI ? never : K,\n      plan: L,\n      billingPeriod: `${L}:${P}` extends PL ? never : P\n    ): Product<NS, PE, BP, `${L}:${P}` | PL, K | PI>;\n  } = (productId: string, plan: PE | null = null, billingPeriod: BP | null = null) =>\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- widens to the overloads' accumulated generics\n    new Product(this, productId, plan, billingPeriod) as never;\n\n  getPlan = (productId: string): PE => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.plan, `Product ${productId} is not a subscription`);\n    return product.plan;\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.billingPeriod, `Product ${productId} is not a subscription`);\n    return product.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    return product.plan === null ? 'payment' : 'subscription';\n  };\n\n  getPriceId = (productId: string): PriceId => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.defaultPriceId;\n  };\n\n  getCreditAmount = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return price.credits;\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.prices.get(product.defaultPriceId)?.credits ?? 0;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return ms(price.expiresIn);\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return ms(product.prices.get(product.defaultPriceId)?.expiresIn ?? '0');\n  };\n\n  getCreditExpiresAt = (productId: string, priceId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, priceId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../../src/stripe/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nexport type PriceId = `price_${string}`;\n\n/**\n * Which Stripe object space the config addresses. Test and live prices are\n * disjoint, so a config is built for exactly one of them. Derive it from the\n * secret key (`sk_test_` vs `sk_live_`) rather than from the deployment\n * environment: the key is what actually decides which space API calls hit.\n */\nexport type StripeMode = 'live' | 'test';\n\nconst addMethod = Symbol('addMethod');\n\nclass Product<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends PriceId = never,\n> {\n  readonly id: string;\n  readonly config: StripeConfig<NS, PE, BP, PL, PI>;\n  readonly plan: PE | null;\n  readonly billingPeriod: BP | null;\n  readonly prices: Map<PriceId, Metadata>;\n\n  defaultPriceId: PriceId | null;\n\n  constructor(\n    config: StripeConfig<NS, PE, BP, PL, PI>,\n    id: string,\n    plan: PE | null = null,\n    billingPeriod: BP | null = null\n  ) {\n    this.id = id;\n    this.config = config;\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.prices = new Map();\n    this.defaultPriceId = null;\n  }\n\n  /**\n   * Non-default prices stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * create new checkouts with a legacy price unless that is intentional.\n   */\n  price = <K extends PriceId>(\n    priceId: K extends I ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Product<NS, PE, BP, PL, PI, I | K> => {\n    invariant(!this.prices.has(priceId), `Duplicate price ${priceId}`);\n    this.prices.set(priceId, metadata);\n    return this as Product<NS, PE, BP, PL, PI, I | K>;\n  };\n\n  /**\n   * `test` is the sandbox twin of the default price. In test mode it is what\n   * checkouts are created with, and it resolves to the default price's\n   * entitlement, so credits are declared once and cannot drift between the\n   * two modes. Legacy prices need no twin: a sandbox holds no grandfathered\n   * subscribers. Live mode ignores it, so a test price reaching a live config\n   * still fails as an unknown price instead of being granted an entitlement.\n   */\n  default = (defaultPriceId: I, twin?: { test: PriceId }) => {\n    const metadata = this.prices.get(defaultPriceId);\n    invariant(metadata, `Default price ${defaultPriceId} is not declared`);\n    if (this.config.mode === 'test') {\n      invariant(twin, `Test price not declared for default ${defaultPriceId} of ${this.id}`);\n      invariant(!this.prices.has(twin.test), `Duplicate price ${twin.test}`);\n      this.prices.set(twin.test, metadata);\n      this.defaultPriceId = twin.test;\n    } else {\n      this.defaultPriceId = defaultPriceId;\n    }\n    this.config[addMethod](this);\n    return this.config;\n  };\n}\n\ntype Options = {\n  mode: StripeMode;\n  returnUrl: string;\n  cancelUrl: string;\n  successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  cancellationCouponId: string;\n  allowPromotionCodes: boolean;\n};\n\nexport class StripeConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  private readonly products: Map<string, Product<NS, PE, BP, PL, PI>> = new Map();\n\n  public readonly mode: StripeMode;\n  public returnUrl: string;\n  public cancelUrl: string;\n  public successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  public cancellationCouponId: string;\n  public allowPromotionCodes: boolean;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (product: Product<NS, PE, BP, PL, PI>) => {\n    invariant(!this.products.has(product.id), `Duplicate product ${product.id}`);\n    if (product.plan !== null) {\n      for (const existing of this.products.values()) {\n        invariant(\n          existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod,\n          `Duplicate plan ${product.plan}:${product.billingPeriod}`\n        );\n      }\n    }\n    this.products.set(product.id, product);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.mode = options.mode;\n    this.returnUrl = options.returnUrl;\n    this.cancelUrl = options.cancelUrl;\n    this.successUrl = options.successUrl;\n    this.cancellationCouponId = options.cancellationCouponId;\n    this.allowPromotionCodes = options.allowPromotionCodes;\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new StripeConfig<NS, PE, BP>(options);\n  };\n\n  /**\n   * One-time products take no extra args; subscriptions require both plan and billingPeriod.\n   * A plan+period pair may be declared on only one product — version its prices in that chain.\n   */\n  product: {\n    <K extends `${NS}.${Lowercase<string>}`>(\n      productId: K extends PI ? never : K\n    ): Product<NS, PE, BP, PL, K | PI>;\n    <K extends `${NS}.${Lowercase<string>}`, L extends PE, P extends BP>(\n      productId: K extends PI ? never : K,\n      plan: L,\n      billingPeriod: `${L}:${P}` extends PL ? never : P\n    ): Product<NS, PE, BP, `${L}:${P}` | PL, K | PI>;\n  } = (productId: string, plan: PE | null = null, billingPeriod: BP | null = null) =>\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- widens to the overloads' accumulated generics\n    new Product(this, productId, plan, billingPeriod) as never;\n\n  getPlan = (productId: string): PE => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.plan, `Product ${productId} is not a subscription`);\n    return product.plan;\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.billingPeriod, `Product ${productId} is not a subscription`);\n    return product.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    return product.plan === null ? 'payment' : 'subscription';\n  };\n\n  /** The price new checkouts are created with: the default, or its test twin in test mode. */\n  getPriceId = (productId: string): PriceId => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.defaultPriceId;\n  };\n\n  getCreditAmount = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return price.credits;\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.prices.get(product.defaultPriceId)?.credits ?? 0;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return ms(price.expiresIn);\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return ms(product.prices.get(product.defaultPriceId)?.expiresIn ?? '0');\n  };\n\n  getCreditExpiresAt = (productId: string, priceId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, priceId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}

package/dist/stripe/config.d.cts

@@ -1,6 +1,13 @@
 import { Metadata } from "../types.cjs";
 //#region src/stripe/config.d.ts
 type PriceId = `price_${string}`;
+/**
+ * Which Stripe object space the config addresses. Test and live prices are
+ * disjoint, so a config is built for exactly one of them. Derive it from the
+ * secret key (`sk_test_` vs `sk_live_`) rather than from the deployment
+ * environment: the key is what actually decides which space API calls hit.
+ */
+type StripeMode = 'live' | 'test';
 declare const addMethod: unique symbol;
 declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never, I extends PriceId = never> {
   readonly id: string;
@@ -8,7 +15,7 @@ declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE exten
   readonly plan: PE | null;
   readonly billingPeriod: BP | null;
   readonly prices: Map<PriceId, Metadata>;
-  defaultPriceId: I | null;
+  defaultPriceId: PriceId | null;
   constructor(config: StripeConfig<NS, PE, BP, PL, PI>, id: string, plan?: PE | null, billingPeriod?: BP | null);
   /**
    * Non-default prices stay declared on purpose: they keep resolving for
@@ -16,9 +23,20 @@ declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE exten
    * create new checkouts with a legacy price unless that is intentional.
    */
   price: <K extends PriceId>(priceId: K extends I ? never : K, metadata?: Metadata) => Product<NS, PE, BP, PL, PI, I | K>;
-  default: (defaultPriceId: I) => StripeConfig<NS, PE, BP, PL, PI>;
+  /**
+   * `test` is the sandbox twin of the default price. In test mode it is what
+   * checkouts are created with, and it resolves to the default price's
+   * entitlement, so credits are declared once and cannot drift between the
+   * two modes. Legacy prices need no twin: a sandbox holds no grandfathered
+   * subscribers. Live mode ignores it, so a test price reaching a live config
+   * still fails as an unknown price instead of being granted an entitlement.
+   */
+  default: (defaultPriceId: I, twin?: {
+    test: PriceId;
+  }) => StripeConfig<NS, PE, BP, PL, PI>;
 }
 type Options = {
+  mode: StripeMode;
   returnUrl: string;
   cancelUrl: string;
   successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;
@@ -27,6 +45,7 @@ type Options = {
 };
 declare class StripeConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   private readonly products;
+  readonly mode: StripeMode;
   returnUrl: string;
   cancelUrl: string;
   successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;
@@ -47,11 +66,12 @@ declare class StripeConfig<NS extends Lowercase<string> = Lowercase<string>, PE
   getPlan: (productId: string) => PE;
   getBillingPeriod: (productId: string) => BP;
   getMode: (productId: string) => 'payment' | 'subscription';
+  /** The price new checkouts are created with: the default, or its test twin in test mode. */
   getPriceId: (productId: string) => PriceId;
   getCreditAmount: (productId: string, priceId?: string) => number;
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string, priceId?: string) => string;
 }
 //#endregion
-export { PriceId, StripeConfig };
+export { PriceId, StripeConfig, StripeMode };
 //# sourceMappingURL=config.d.cts.map

package/dist/stripe/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;KAIY;cAEN;cAEA,QACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA,UAAU;WAED;WACA,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI;WACrC,MAAM;WACN,eAAe;WACf,QAAQ,IAAI,SAAS;EAE9B,gBAAgB;EAEhB,YACE,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI,KACrC,YACA,OAAM,WACN,gBAAe;;;;;;EAejB,QAAS,UAAU,SAAO,SACf,UAAU,YAAY,GAAC,WACtB,aACT,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;EAMnC,UAAO,gBAAoB,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;;KAQzB;EACH;EACA;EACA;EACA;EACA;;cAGW,aACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;mBAEiB;EAEV;EACA;EACA;EACA;EACA;MAEH;GAMH,aAAU,SAAa,QAAQ,IAAI,IAAI,IAAI,IAAI;UAczC;SAQA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,aAAA,MAAA,MAAA;;;;;EASlB;KACG,aAAa,MAAM,qBAClB,WAAW,UAAU,aAAa,IACjC,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI;KAC9B,aAAa,MAAM,qBAAqB,UAAU,IAAI,UAAU,IAC/D,WAAW,UAAU,aAAa,GAClC,MAAM,GACN,kBAAkB,KAAK,YAAY,aAAa,IAC/C,QAAQ,IAAI,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI;;EAK/C,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAMP,aAAU,sBAAwB;EAOlC,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;KAIY;;;;;;;KAQA;cAEN;cAEA,QACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA,UAAU;WAED;WACA,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI;WACrC,MAAM;WACN,eAAe;WACf,QAAQ,IAAI,SAAS;EAE9B,gBAAgB;EAEhB,YACE,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI,KACrC,YACA,OAAM,WACN,gBAAe;;;;;;EAejB,QAAS,UAAU,SAAO,SACf,UAAU,YAAY,GAAC,WACtB,aACT,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;;;;;;;;;EAcnC,UAAO,gBAAoB,GAAC;IAAW,MAAM;QAAS,aAAA,IAAA,IAAA,IAAA,IAAA;;KAgBnD;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;;cAGW,aACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;mBAEiB;WAED,MAAM;EACf;EACA;EACA;EACA;EACA;MAEH;GAMH,aAAU,SAAa,QAAQ,IAAI,IAAI,IAAI,IAAI;UAczC;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,aAAA,MAAA,MAAA;;;;;EASlB;KACG,aAAa,MAAM,qBAClB,WAAW,UAAU,aAAa,IACjC,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI;KAC9B,aAAa,MAAM,qBAAqB,UAAU,IAAI,UAAU,IAC/D,WAAW,UAAU,aAAa,GAClC,MAAM,GACN,kBAAkB,KAAK,YAAY,aAAa,IAC/C,QAAQ,IAAI,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI;;EAK/C,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;;EAOP,aAAU,sBAAwB;EAOlC,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}

package/dist/stripe/config.d.mts

@@ -1,6 +1,13 @@
 import { Metadata } from "../types.mjs";
 //#region src/stripe/config.d.ts
 type PriceId = `price_${string}`;
+/**
+ * Which Stripe object space the config addresses. Test and live prices are
+ * disjoint, so a config is built for exactly one of them. Derive it from the
+ * secret key (`sk_test_` vs `sk_live_`) rather than from the deployment
+ * environment: the key is what actually decides which space API calls hit.
+ */
+type StripeMode = 'live' | 'test';
 declare const addMethod: unique symbol;
 declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never, I extends PriceId = never> {
   readonly id: string;
@@ -8,7 +15,7 @@ declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE exten
   readonly plan: PE | null;
   readonly billingPeriod: BP | null;
   readonly prices: Map<PriceId, Metadata>;
-  defaultPriceId: I | null;
+  defaultPriceId: PriceId | null;
   constructor(config: StripeConfig<NS, PE, BP, PL, PI>, id: string, plan?: PE | null, billingPeriod?: BP | null);
   /**
    * Non-default prices stay declared on purpose: they keep resolving for
@@ -16,9 +23,20 @@ declare class Product<NS extends Lowercase<string> = Lowercase<string>, PE exten
    * create new checkouts with a legacy price unless that is intentional.
    */
   price: <K extends PriceId>(priceId: K extends I ? never : K, metadata?: Metadata) => Product<NS, PE, BP, PL, PI, I | K>;
-  default: (defaultPriceId: I) => StripeConfig<NS, PE, BP, PL, PI>;
+  /**
+   * `test` is the sandbox twin of the default price. In test mode it is what
+   * checkouts are created with, and it resolves to the default price's
+   * entitlement, so credits are declared once and cannot drift between the
+   * two modes. Legacy prices need no twin: a sandbox holds no grandfathered
+   * subscribers. Live mode ignores it, so a test price reaching a live config
+   * still fails as an unknown price instead of being granted an entitlement.
+   */
+  default: (defaultPriceId: I, twin?: {
+    test: PriceId;
+  }) => StripeConfig<NS, PE, BP, PL, PI>;
 }
 type Options = {
+  mode: StripeMode;
   returnUrl: string;
   cancelUrl: string;
   successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;
@@ -27,6 +45,7 @@ type Options = {
 };
 declare class StripeConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   private readonly products;
+  readonly mode: StripeMode;
   returnUrl: string;
   cancelUrl: string;
   successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;
@@ -47,11 +66,12 @@ declare class StripeConfig<NS extends Lowercase<string> = Lowercase<string>, PE
   getPlan: (productId: string) => PE;
   getBillingPeriod: (productId: string) => BP;
   getMode: (productId: string) => 'payment' | 'subscription';
+  /** The price new checkouts are created with: the default, or its test twin in test mode. */
   getPriceId: (productId: string) => PriceId;
   getCreditAmount: (productId: string, priceId?: string) => number;
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string, priceId?: string) => string;
 }
 //#endregion
-export { PriceId, StripeConfig };
+export { PriceId, StripeConfig, StripeMode };
 //# sourceMappingURL=config.d.mts.map

package/dist/stripe/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;KAIY;cAEN;cAEA,QACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA,UAAU;WAED;WACA,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI;WACrC,MAAM;WACN,eAAe;WACf,QAAQ,IAAI,SAAS;EAE9B,gBAAgB;EAEhB,YACE,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI,KACrC,YACA,OAAM,WACN,gBAAe;;;;;;EAejB,QAAS,UAAU,SAAO,SACf,UAAU,YAAY,GAAC,WACtB,aACT,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;EAMnC,UAAO,gBAAoB,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;;KAQzB;EACH;EACA;EACA;EACA;EACA;;cAGW,aACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;mBAEiB;EAEV;EACA;EACA;EACA;EACA;MAEH;GAMH,aAAU,SAAa,QAAQ,IAAI,IAAI,IAAI,IAAI;UAczC;SAQA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,aAAA,MAAA,MAAA;;;;;EASlB;KACG,aAAa,MAAM,qBAClB,WAAW,UAAU,aAAa,IACjC,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI;KAC9B,aAAa,MAAM,qBAAqB,UAAU,IAAI,UAAU,IAC/D,WAAW,UAAU,aAAa,GAClC,MAAM,GACN,kBAAkB,KAAK,YAAY,aAAa,IAC/C,QAAQ,IAAI,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI;;EAK/C,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAMP,aAAU,sBAAwB;EAOlC,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;KAIY;;;;;;;KAQA;cAEN;cAEA,QACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA,UAAU;WAED;WACA,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI;WACrC,MAAM;WACN,eAAe;WACf,QAAQ,IAAI,SAAS;EAE9B,gBAAgB;EAEhB,YACE,QAAQ,aAAa,IAAI,IAAI,IAAI,IAAI,KACrC,YACA,OAAM,WACN,gBAAe;;;;;;EAejB,QAAS,UAAU,SAAO,SACf,UAAU,YAAY,GAAC,WACtB,aACT,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;;;;;;;;;EAcnC,UAAO,gBAAoB,GAAC;IAAW,MAAM;QAAS,aAAA,IAAA,IAAA,IAAA,IAAA;;KAgBnD;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;;cAGW,aACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;mBAEiB;WAED,MAAM;EACf;EACA;EACA;EACA;EACA;MAEH;GAMH,aAAU,SAAa,QAAQ,IAAI,IAAI,IAAI,IAAI;UAczC;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,aAAA,MAAA,MAAA;;;;;EASlB;KACG,aAAa,MAAM,qBAClB,WAAW,UAAU,aAAa,IACjC,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI;KAC9B,aAAa,MAAM,qBAAqB,UAAU,IAAI,UAAU,IAC/D,WAAW,UAAU,aAAa,GAClC,MAAM,GACN,kBAAkB,KAAK,YAAY,aAAa,IAC/C,QAAQ,IAAI,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI;;EAK/C,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;;EAOP,aAAU,sBAAwB;EAOlC,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}

package/dist/stripe/config.mjs

@@ -30,15 +30,30 @@ var Product = class {
 		this.prices.set(priceId, metadata);
 		return this;
 	};
-	default = (defaultPriceId) => {
-		invariant(this.prices.has(defaultPriceId), `Default price ${defaultPriceId} is not declared`);
-		this.defaultPriceId = defaultPriceId;
+	/**
+	* `test` is the sandbox twin of the default price. In test mode it is what
+	* checkouts are created with, and it resolves to the default price's
+	* entitlement, so credits are declared once and cannot drift between the
+	* two modes. Legacy prices need no twin: a sandbox holds no grandfathered
+	* subscribers. Live mode ignores it, so a test price reaching a live config
+	* still fails as an unknown price instead of being granted an entitlement.
+	*/
+	default = (defaultPriceId, twin) => {
+		const metadata = this.prices.get(defaultPriceId);
+		invariant(metadata, `Default price ${defaultPriceId} is not declared`);
+		if (this.config.mode === "test") {
+			invariant(twin, `Test price not declared for default ${defaultPriceId} of ${this.id}`);
+			invariant(!this.prices.has(twin.test), `Duplicate price ${twin.test}`);
+			this.prices.set(twin.test, metadata);
+			this.defaultPriceId = twin.test;
+		} else this.defaultPriceId = defaultPriceId;
 		this.config[addMethod](this);
 		return this.config;
 	};
 };
 var StripeConfig = class StripeConfig {
 	products = /* @__PURE__ */ new Map();
+	mode;
 	returnUrl;
 	cancelUrl;
 	successUrl;
@@ -54,6 +69,7 @@ var StripeConfig = class StripeConfig {
 		return this;
 	};
 	constructor(options) {
+		this.mode = options.mode;
 		this.returnUrl = options.returnUrl;
 		this.cancelUrl = options.cancelUrl;
 		this.successUrl = options.successUrl;
@@ -85,6 +101,7 @@ var StripeConfig = class StripeConfig {
 		invariant(product, `Product not found for ${productId}`);
 		return product.plan === null ? "payment" : "subscription";
 	};
+	/** The price new checkouts are created with: the default, or its test twin in test mode. */
 	getPriceId = (productId) => {
 		const product = this.products.get(productId);
 		invariant(product, `Product not found for ${productId}`);

package/dist/stripe/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/stripe/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nexport type PriceId = `price_${string}`;\n\nconst addMethod = Symbol('addMethod');\n\nclass Product<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends PriceId = never,\n> {\n  readonly id: string;\n  readonly config: StripeConfig<NS, PE, BP, PL, PI>;\n  readonly plan: PE | null;\n  readonly billingPeriod: BP | null;\n  readonly prices: Map<PriceId, Metadata>;\n\n  defaultPriceId: I | null;\n\n  constructor(\n    config: StripeConfig<NS, PE, BP, PL, PI>,\n    id: string,\n    plan: PE | null = null,\n    billingPeriod: BP | null = null\n  ) {\n    this.id = id;\n    this.config = config;\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.prices = new Map();\n    this.defaultPriceId = null;\n  }\n\n  /**\n   * Non-default prices stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * create new checkouts with a legacy price unless that is intentional.\n   */\n  price = <K extends PriceId>(\n    priceId: K extends I ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Product<NS, PE, BP, PL, PI, I | K> => {\n    invariant(!this.prices.has(priceId), `Duplicate price ${priceId}`);\n    this.prices.set(priceId, metadata);\n    return this as Product<NS, PE, BP, PL, PI, I | K>;\n  };\n\n  default = (defaultPriceId: I) => {\n    invariant(this.prices.has(defaultPriceId), `Default price ${defaultPriceId} is not declared`);\n    this.defaultPriceId = defaultPriceId;\n    this.config[addMethod](this as never);\n    return this.config;\n  };\n}\n\ntype Options = {\n  returnUrl: string;\n  cancelUrl: string;\n  successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  cancellationCouponId: string;\n  allowPromotionCodes: boolean;\n};\n\nexport class StripeConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  private readonly products: Map<string, Product<NS, PE, BP, PL, PI>> = new Map();\n\n  public returnUrl: string;\n  public cancelUrl: string;\n  public successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  public cancellationCouponId: string;\n  public allowPromotionCodes: boolean;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (product: Product<NS, PE, BP, PL, PI>) => {\n    invariant(!this.products.has(product.id), `Duplicate product ${product.id}`);\n    if (product.plan !== null) {\n      for (const existing of this.products.values()) {\n        invariant(\n          existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod,\n          `Duplicate plan ${product.plan}:${product.billingPeriod}`\n        );\n      }\n    }\n    this.products.set(product.id, product);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.returnUrl = options.returnUrl;\n    this.cancelUrl = options.cancelUrl;\n    this.successUrl = options.successUrl;\n    this.cancellationCouponId = options.cancellationCouponId;\n    this.allowPromotionCodes = options.allowPromotionCodes;\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new StripeConfig<NS, PE, BP>(options);\n  };\n\n  /**\n   * One-time products take no extra args; subscriptions require both plan and billingPeriod.\n   * A plan+period pair may be declared on only one product — version its prices in that chain.\n   */\n  product: {\n    <K extends `${NS}.${Lowercase<string>}`>(\n      productId: K extends PI ? never : K\n    ): Product<NS, PE, BP, PL, K | PI>;\n    <K extends `${NS}.${Lowercase<string>}`, L extends PE, P extends BP>(\n      productId: K extends PI ? never : K,\n      plan: L,\n      billingPeriod: `${L}:${P}` extends PL ? never : P\n    ): Product<NS, PE, BP, `${L}:${P}` | PL, K | PI>;\n  } = (productId: string, plan: PE | null = null, billingPeriod: BP | null = null) =>\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- widens to the overloads' accumulated generics\n    new Product(this, productId, plan, billingPeriod) as never;\n\n  getPlan = (productId: string): PE => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.plan, `Product ${productId} is not a subscription`);\n    return product.plan;\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.billingPeriod, `Product ${productId} is not a subscription`);\n    return product.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    return product.plan === null ? 'payment' : 'subscription';\n  };\n\n  getPriceId = (productId: string): PriceId => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.defaultPriceId;\n  };\n\n  getCreditAmount = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return price.credits;\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.prices.get(product.defaultPriceId)?.credits ?? 0;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return ms(price.expiresIn);\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return ms(product.prices.get(product.defaultPriceId)?.expiresIn ?? '0');\n  };\n\n  getCreditExpiresAt = (productId: string, priceId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, priceId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/stripe/config.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\nimport ms from 'ms';\nimport type { Metadata } from '../types';\n\nexport type PriceId = `price_${string}`;\n\n/**\n * Which Stripe object space the config addresses. Test and live prices are\n * disjoint, so a config is built for exactly one of them. Derive it from the\n * secret key (`sk_test_` vs `sk_live_`) rather than from the deployment\n * environment: the key is what actually decides which space API calls hit.\n */\nexport type StripeMode = 'live' | 'test';\n\nconst addMethod = Symbol('addMethod');\n\nclass Product<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n  I extends PriceId = never,\n> {\n  readonly id: string;\n  readonly config: StripeConfig<NS, PE, BP, PL, PI>;\n  readonly plan: PE | null;\n  readonly billingPeriod: BP | null;\n  readonly prices: Map<PriceId, Metadata>;\n\n  defaultPriceId: PriceId | null;\n\n  constructor(\n    config: StripeConfig<NS, PE, BP, PL, PI>,\n    id: string,\n    plan: PE | null = null,\n    billingPeriod: BP | null = null\n  ) {\n    this.id = id;\n    this.config = config;\n    this.plan = plan;\n    this.billingPeriod = billingPeriod;\n    this.prices = new Map();\n    this.defaultPriceId = null;\n  }\n\n  /**\n   * Non-default prices stay declared on purpose: they keep resolving for\n   * grandfathered subscribers and serve as price-experiment arms. Never\n   * create new checkouts with a legacy price unless that is intentional.\n   */\n  price = <K extends PriceId>(\n    priceId: K extends I ? never : K,\n    metadata: Metadata = { credits: 0, expiresIn: '0' }\n  ): Product<NS, PE, BP, PL, PI, I | K> => {\n    invariant(!this.prices.has(priceId), `Duplicate price ${priceId}`);\n    this.prices.set(priceId, metadata);\n    return this as Product<NS, PE, BP, PL, PI, I | K>;\n  };\n\n  /**\n   * `test` is the sandbox twin of the default price. In test mode it is what\n   * checkouts are created with, and it resolves to the default price's\n   * entitlement, so credits are declared once and cannot drift between the\n   * two modes. Legacy prices need no twin: a sandbox holds no grandfathered\n   * subscribers. Live mode ignores it, so a test price reaching a live config\n   * still fails as an unknown price instead of being granted an entitlement.\n   */\n  default = (defaultPriceId: I, twin?: { test: PriceId }) => {\n    const metadata = this.prices.get(defaultPriceId);\n    invariant(metadata, `Default price ${defaultPriceId} is not declared`);\n    if (this.config.mode === 'test') {\n      invariant(twin, `Test price not declared for default ${defaultPriceId} of ${this.id}`);\n      invariant(!this.prices.has(twin.test), `Duplicate price ${twin.test}`);\n      this.prices.set(twin.test, metadata);\n      this.defaultPriceId = twin.test;\n    } else {\n      this.defaultPriceId = defaultPriceId;\n    }\n    this.config[addMethod](this);\n    return this.config;\n  };\n}\n\ntype Options = {\n  mode: StripeMode;\n  returnUrl: string;\n  cancelUrl: string;\n  successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  cancellationCouponId: string;\n  allowPromotionCodes: boolean;\n};\n\nexport class StripeConfig<\n  NS extends Lowercase<string> = Lowercase<string>,\n  PE extends string = string,\n  BP extends string = string,\n  PL extends string = never,\n  PI extends string = never,\n> {\n  private readonly products: Map<string, Product<NS, PE, BP, PL, PI>> = new Map();\n\n  public readonly mode: StripeMode;\n  public returnUrl: string;\n  public cancelUrl: string;\n  public successUrl: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n  public cancellationCouponId: string;\n  public allowPromotionCodes: boolean;\n\n  get productIds(): string[] {\n    return Array.from(this.products.keys());\n  }\n\n  // runtime mirror of the type-level guards: generic accumulation only\n  // protects a single fluent chain, not statement-style re-entry or casts\n  [addMethod] = (product: Product<NS, PE, BP, PL, PI>) => {\n    invariant(!this.products.has(product.id), `Duplicate product ${product.id}`);\n    if (product.plan !== null) {\n      for (const existing of this.products.values()) {\n        invariant(\n          existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod,\n          `Duplicate plan ${product.plan}:${product.billingPeriod}`\n        );\n      }\n    }\n    this.products.set(product.id, product);\n    return this;\n  };\n\n  private constructor(options: Options) {\n    this.mode = options.mode;\n    this.returnUrl = options.returnUrl;\n    this.cancelUrl = options.cancelUrl;\n    this.successUrl = options.successUrl;\n    this.cancellationCouponId = options.cancellationCouponId;\n    this.allowPromotionCodes = options.allowPromotionCodes;\n  }\n\n  static create = <NS extends Lowercase<string>, PE extends string, BP extends string = string>(\n    options: Options\n  ) => {\n    return new StripeConfig<NS, PE, BP>(options);\n  };\n\n  /**\n   * One-time products take no extra args; subscriptions require both plan and billingPeriod.\n   * A plan+period pair may be declared on only one product — version its prices in that chain.\n   */\n  product: {\n    <K extends `${NS}.${Lowercase<string>}`>(\n      productId: K extends PI ? never : K\n    ): Product<NS, PE, BP, PL, K | PI>;\n    <K extends `${NS}.${Lowercase<string>}`, L extends PE, P extends BP>(\n      productId: K extends PI ? never : K,\n      plan: L,\n      billingPeriod: `${L}:${P}` extends PL ? never : P\n    ): Product<NS, PE, BP, `${L}:${P}` | PL, K | PI>;\n  } = (productId: string, plan: PE | null = null, billingPeriod: BP | null = null) =>\n    // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- widens to the overloads' accumulated generics\n    new Product(this, productId, plan, billingPeriod) as never;\n\n  getPlan = (productId: string): PE => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.plan, `Product ${productId} is not a subscription`);\n    return product.plan;\n  };\n\n  getBillingPeriod = (productId: string): BP => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.billingPeriod, `Product ${productId} is not a subscription`);\n    return product.billingPeriod;\n  };\n\n  getMode = (productId: string): 'payment' | 'subscription' => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    return product.plan === null ? 'payment' : 'subscription';\n  };\n\n  /** The price new checkouts are created with: the default, or its test twin in test mode. */\n  getPriceId = (productId: string): PriceId => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.defaultPriceId;\n  };\n\n  getCreditAmount = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return price.credits;\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return product.prices.get(product.defaultPriceId)?.credits ?? 0;\n  };\n\n  private readonly getCreditExpiresIn = (productId: string, priceId?: string): number => {\n    const product = this.products.get(productId);\n    invariant(product, `Product not found for ${productId}`);\n    if (priceId) {\n      const price = product.prices.get(priceId as PriceId);\n      invariant(price, `Price not found for ${priceId}`);\n      return ms(price.expiresIn);\n    }\n\n    invariant(product.defaultPriceId, `Default price not found for product ${productId}`);\n    return ms(product.prices.get(product.defaultPriceId)?.expiresIn ?? '0');\n  };\n\n  getCreditExpiresAt = (productId: string, priceId?: string): string => {\n    const expiresIn = this.getCreditExpiresIn(productId, priceId);\n    return new Date(Date.now() + expiresIn).toISOString();\n  };\n}\n"],"mappings":"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"}

package/dist/stripe/index.d.cts

@@ -1,8 +1,8 @@
-import { PriceId, StripeConfig } from "./config.cjs";
+import { PriceId, StripeConfig, StripeMode } from "./config.cjs";
 import { StripeEventHandler } from "./handler.cjs";
 import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.cjs";
 import { CancellationDetails, CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.cjs";
 import { METADATA_KEYS } from "./metadata.cjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.cjs";
 import { Stripe } from "stripe";
-export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };
+export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };

package/dist/stripe/index.d.mts

@@ -1,8 +1,8 @@
-import { PriceId, StripeConfig } from "./config.mjs";
+import { PriceId, StripeConfig, StripeMode } from "./config.mjs";
 import { StripeEventHandler } from "./handler.mjs";
 import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
 import { CancellationDetails, CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.mjs";
 import { METADATA_KEYS } from "./metadata.mjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.mjs";
 import { Stripe } from "stripe";
-export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };
+export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };

package/dist/stripe/pending-checkout.cjs

@@ -19,7 +19,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 */
 const KEY = "pending-checkout";
 /** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */
-const TTL = 3600 * 1e3;
+const TTL = 36e5;
 function isFresh(entry) {
 	return Date.now() - entry.ts <= TTL;
 }

package/dist/stripe/pending-checkout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pending-checkout.cjs","names":[],"sources":["../../src/stripe/pending-checkout.ts"],"sourcesContent":["/**\n * Tracks checkouts that have been started but may not have been confirmed\n * yet — e.g. the user paid on Stripe and closed the tab before being\n * redirected back to the success page (where `confirmCheckoutSession` runs).\n *\n * IMPORTANT: this stores only the *session ids to retry confirmation on*, a\n * best-effort retry hint — NOT the user's paid/balance state. The server\n * remains the single source of truth for entitlements; on the next app boot\n * we simply re-run the (idempotent, ownership-checked) confirm for each\n * session so the credit balance reflects the purchase without waiting on the\n * async Stripe webhook. Scoped to a single browser; cross-device is covered by\n * the webhook backstop.\n *\n * A *list* (not a single value) is kept on purpose: localStorage is shared\n * across tabs, so two concurrent checkouts — or a second checkout started\n * before the first was reconciled — must not clobber each other.\n */\n\nconst KEY = 'pending-checkout';\n\n/** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */\nconst TTL = 60 * 60 * 1000; // 1 hour\n\n/** Cap the list so a string of abandoned checkouts can't grow it unbounded. */\nconst MAX = 5;\n\ntype Entry = { sessionId: string; ts: number };\n\nfunction isFresh(entry: Entry): boolean {\n  return Date.now() - entry.ts <= TTL;\n}\n\nfunction read(): Entry[] {\n  try {\n    const raw = localStorage.getItem(KEY);\n    if (!raw) return [];\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    return parsed.filter(\n      (e): e is Entry => !!e && typeof e.sessionId === 'string' && typeof e.ts === 'number'\n    );\n  } catch {\n    return [];\n  }\n}\n\nfunction write(entries: Entry[]) {\n  try {\n    if (entries.length === 0) localStorage.removeItem(KEY);\n    else localStorage.setItem(KEY, JSON.stringify(entries.slice(-MAX)));\n  } catch {\n    // ignore — storage unavailable / quota; the webhook still reconciles.\n  }\n}\n\n/** Record a started checkout to retry confirmation on later. Dedupes by session id. */\nexport function addPendingCheckout(sessionId: string) {\n  const entries = read().filter((e) => isFresh(e) && e.sessionId !== sessionId);\n  entries.push({ sessionId, ts: Date.now() });\n  write(entries);\n}\n\n/** Fresh session ids awaiting confirmation. Persists the pruned list as a side effect. */\nexport function getPendingCheckouts(): string[] {\n  const all = read();\n  const fresh = all.filter(isFresh);\n  if (fresh.length !== all.length) write(fresh);\n  return fresh.map((e) => e.sessionId);\n}\n\n/** Drop one session once it's confirmed (or known not to belong to this user). */\nexport function removePendingCheckout(sessionId: string) {\n  write(read().filter((e) => isFresh(e) && e.sessionId !== sessionId));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAM,MAAM;;AAGZ,MAAM,MAAM,OAAU;AAOtB,SAAS,QAAQ,OAAuB;CACtC,OAAO,KAAK,IAAI,IAAI,MAAM,MAAM;AAClC;AAEA,SAAS,OAAgB;CACvB,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,GAAG;EACpC,IAAI,CAAC,KAAK,OAAO,CAAC;EAClB,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,QACX,MAAkB,CAAC,CAAC,KAAK,OAAO,EAAE,cAAc,YAAY,OAAO,EAAE,OAAO,QAC/E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,MAAM,SAAkB;CAC/B,IAAI;EACF,IAAI,QAAQ,WAAW,GAAG,aAAa,WAAW,GAAG;OAChD,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,MAAM,EAAI,CAAC,CAAC;CACpE,QAAQ,CAER;AACF;;AAGA,SAAgB,mBAAmB,WAAmB;CACpD,MAAM,UAAU,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS;CAC5E,QAAQ,KAAK;EAAE;EAAW,IAAI,KAAK,IAAI;CAAE,CAAC;CAC1C,MAAM,OAAO;AACf;;AAGA,SAAgB,sBAAgC;CAC9C,MAAM,MAAM,KAAK;CACjB,MAAM,QAAQ,IAAI,OAAO,OAAO;CAChC,IAAI,MAAM,WAAW,IAAI,QAAQ,MAAM,KAAK;CAC5C,OAAO,MAAM,KAAK,MAAM,EAAE,SAAS;AACrC;;AAGA,SAAgB,sBAAsB,WAAmB;CACvD,MAAM,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS,CAAC;AACrE"}
+{"version":3,"file":"pending-checkout.cjs","names":[],"sources":["../../src/stripe/pending-checkout.ts"],"sourcesContent":["/**\n * Tracks checkouts that have been started but may not have been confirmed\n * yet — e.g. the user paid on Stripe and closed the tab before being\n * redirected back to the success page (where `confirmCheckoutSession` runs).\n *\n * IMPORTANT: this stores only the *session ids to retry confirmation on*, a\n * best-effort retry hint — NOT the user's paid/balance state. The server\n * remains the single source of truth for entitlements; on the next app boot\n * we simply re-run the (idempotent, ownership-checked) confirm for each\n * session so the credit balance reflects the purchase without waiting on the\n * async Stripe webhook. Scoped to a single browser; cross-device is covered by\n * the webhook backstop.\n *\n * A *list* (not a single value) is kept on purpose: localStorage is shared\n * across tabs, so two concurrent checkouts — or a second checkout started\n * before the first was reconciled — must not clobber each other.\n */\n\nconst KEY = 'pending-checkout';\n\n/** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */\nconst TTL = 60 * 60 * 1000; // 1 hour\n\n/** Cap the list so a string of abandoned checkouts can't grow it unbounded. */\nconst MAX = 5;\n\ntype Entry = { sessionId: string; ts: number };\n\nfunction isFresh(entry: Entry): boolean {\n  return Date.now() - entry.ts <= TTL;\n}\n\nfunction read(): Entry[] {\n  try {\n    const raw = localStorage.getItem(KEY);\n    if (!raw) return [];\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    return parsed.filter(\n      (e): e is Entry => !!e && typeof e.sessionId === 'string' && typeof e.ts === 'number'\n    );\n  } catch {\n    return [];\n  }\n}\n\nfunction write(entries: Entry[]) {\n  try {\n    if (entries.length === 0) localStorage.removeItem(KEY);\n    else localStorage.setItem(KEY, JSON.stringify(entries.slice(-MAX)));\n  } catch {\n    // ignore — storage unavailable / quota; the webhook still reconciles.\n  }\n}\n\n/** Record a started checkout to retry confirmation on later. Dedupes by session id. */\nexport function addPendingCheckout(sessionId: string) {\n  const entries = read().filter((e) => isFresh(e) && e.sessionId !== sessionId);\n  entries.push({ sessionId, ts: Date.now() });\n  write(entries);\n}\n\n/** Fresh session ids awaiting confirmation. Persists the pruned list as a side effect. */\nexport function getPendingCheckouts(): string[] {\n  const all = read();\n  const fresh = all.filter(isFresh);\n  if (fresh.length !== all.length) write(fresh);\n  return fresh.map((e) => e.sessionId);\n}\n\n/** Drop one session once it's confirmed (or known not to belong to this user). */\nexport function removePendingCheckout(sessionId: string) {\n  write(read().filter((e) => isFresh(e) && e.sessionId !== sessionId));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAM,MAAM;;AAGZ,MAAM,MAAM;AAOZ,SAAS,QAAQ,OAAuB;CACtC,OAAO,KAAK,IAAI,IAAI,MAAM,MAAM;AAClC;AAEA,SAAS,OAAgB;CACvB,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,GAAG;EACpC,IAAI,CAAC,KAAK,OAAO,CAAC;EAClB,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,QACX,MAAkB,CAAC,CAAC,KAAK,OAAO,EAAE,cAAc,YAAY,OAAO,EAAE,OAAO,QAC/E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,MAAM,SAAkB;CAC/B,IAAI;EACF,IAAI,QAAQ,WAAW,GAAG,aAAa,WAAW,GAAG;OAChD,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,MAAM,EAAI,CAAC,CAAC;CACpE,QAAQ,CAER;AACF;;AAGA,SAAgB,mBAAmB,WAAmB;CACpD,MAAM,UAAU,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS;CAC5E,QAAQ,KAAK;EAAE;EAAW,IAAI,KAAK,IAAI;CAAE,CAAC;CAC1C,MAAM,OAAO;AACf;;AAGA,SAAgB,sBAAgC;CAC9C,MAAM,MAAM,KAAK;CACjB,MAAM,QAAQ,IAAI,OAAO,OAAO;CAChC,IAAI,MAAM,WAAW,IAAI,QAAQ,MAAM,KAAK;CAC5C,OAAO,MAAM,KAAK,MAAM,EAAE,SAAS;AACrC;;AAGA,SAAgB,sBAAsB,WAAmB;CACvD,MAAM,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS,CAAC;AACrE"}

package/dist/stripe/pending-checkout.mjs

@@ -18,7 +18,7 @@
 */
 const KEY = "pending-checkout";
 /** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */
-const TTL = 3600 * 1e3;
+const TTL = 36e5;
 function isFresh(entry) {
 	return Date.now() - entry.ts <= TTL;
 }

package/dist/stripe/pending-checkout.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pending-checkout.mjs","names":[],"sources":["../../src/stripe/pending-checkout.ts"],"sourcesContent":["/**\n * Tracks checkouts that have been started but may not have been confirmed\n * yet — e.g. the user paid on Stripe and closed the tab before being\n * redirected back to the success page (where `confirmCheckoutSession` runs).\n *\n * IMPORTANT: this stores only the *session ids to retry confirmation on*, a\n * best-effort retry hint — NOT the user's paid/balance state. The server\n * remains the single source of truth for entitlements; on the next app boot\n * we simply re-run the (idempotent, ownership-checked) confirm for each\n * session so the credit balance reflects the purchase without waiting on the\n * async Stripe webhook. Scoped to a single browser; cross-device is covered by\n * the webhook backstop.\n *\n * A *list* (not a single value) is kept on purpose: localStorage is shared\n * across tabs, so two concurrent checkouts — or a second checkout started\n * before the first was reconciled — must not clobber each other.\n */\n\nconst KEY = 'pending-checkout';\n\n/** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */\nconst TTL = 60 * 60 * 1000; // 1 hour\n\n/** Cap the list so a string of abandoned checkouts can't grow it unbounded. */\nconst MAX = 5;\n\ntype Entry = { sessionId: string; ts: number };\n\nfunction isFresh(entry: Entry): boolean {\n  return Date.now() - entry.ts <= TTL;\n}\n\nfunction read(): Entry[] {\n  try {\n    const raw = localStorage.getItem(KEY);\n    if (!raw) return [];\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    return parsed.filter(\n      (e): e is Entry => !!e && typeof e.sessionId === 'string' && typeof e.ts === 'number'\n    );\n  } catch {\n    return [];\n  }\n}\n\nfunction write(entries: Entry[]) {\n  try {\n    if (entries.length === 0) localStorage.removeItem(KEY);\n    else localStorage.setItem(KEY, JSON.stringify(entries.slice(-MAX)));\n  } catch {\n    // ignore — storage unavailable / quota; the webhook still reconciles.\n  }\n}\n\n/** Record a started checkout to retry confirmation on later. Dedupes by session id. */\nexport function addPendingCheckout(sessionId: string) {\n  const entries = read().filter((e) => isFresh(e) && e.sessionId !== sessionId);\n  entries.push({ sessionId, ts: Date.now() });\n  write(entries);\n}\n\n/** Fresh session ids awaiting confirmation. Persists the pruned list as a side effect. */\nexport function getPendingCheckouts(): string[] {\n  const all = read();\n  const fresh = all.filter(isFresh);\n  if (fresh.length !== all.length) write(fresh);\n  return fresh.map((e) => e.sessionId);\n}\n\n/** Drop one session once it's confirmed (or known not to belong to this user). */\nexport function removePendingCheckout(sessionId: string) {\n  write(read().filter((e) => isFresh(e) && e.sessionId !== sessionId));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAM,MAAM;;AAGZ,MAAM,MAAM,OAAU;AAOtB,SAAS,QAAQ,OAAuB;CACtC,OAAO,KAAK,IAAI,IAAI,MAAM,MAAM;AAClC;AAEA,SAAS,OAAgB;CACvB,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,GAAG;EACpC,IAAI,CAAC,KAAK,OAAO,CAAC;EAClB,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,QACX,MAAkB,CAAC,CAAC,KAAK,OAAO,EAAE,cAAc,YAAY,OAAO,EAAE,OAAO,QAC/E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,MAAM,SAAkB;CAC/B,IAAI;EACF,IAAI,QAAQ,WAAW,GAAG,aAAa,WAAW,GAAG;OAChD,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,MAAM,EAAI,CAAC,CAAC;CACpE,QAAQ,CAER;AACF;;AAGA,SAAgB,mBAAmB,WAAmB;CACpD,MAAM,UAAU,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS;CAC5E,QAAQ,KAAK;EAAE;EAAW,IAAI,KAAK,IAAI;CAAE,CAAC;CAC1C,MAAM,OAAO;AACf;;AAGA,SAAgB,sBAAgC;CAC9C,MAAM,MAAM,KAAK;CACjB,MAAM,QAAQ,IAAI,OAAO,OAAO;CAChC,IAAI,MAAM,WAAW,IAAI,QAAQ,MAAM,KAAK;CAC5C,OAAO,MAAM,KAAK,MAAM,EAAE,SAAS;AACrC;;AAGA,SAAgB,sBAAsB,WAAmB;CACvD,MAAM,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS,CAAC;AACrE"}
+{"version":3,"file":"pending-checkout.mjs","names":[],"sources":["../../src/stripe/pending-checkout.ts"],"sourcesContent":["/**\n * Tracks checkouts that have been started but may not have been confirmed\n * yet — e.g. the user paid on Stripe and closed the tab before being\n * redirected back to the success page (where `confirmCheckoutSession` runs).\n *\n * IMPORTANT: this stores only the *session ids to retry confirmation on*, a\n * best-effort retry hint — NOT the user's paid/balance state. The server\n * remains the single source of truth for entitlements; on the next app boot\n * we simply re-run the (idempotent, ownership-checked) confirm for each\n * session so the credit balance reflects the purchase without waiting on the\n * async Stripe webhook. Scoped to a single browser; cross-device is covered by\n * the webhook backstop.\n *\n * A *list* (not a single value) is kept on purpose: localStorage is shared\n * across tabs, so two concurrent checkouts — or a second checkout started\n * before the first was reconciled — must not clobber each other.\n */\n\nconst KEY = 'pending-checkout';\n\n/** Drop a hint after this long — an abandoned/unpaid checkout shouldn't retry forever. */\nconst TTL = 60 * 60 * 1000; // 1 hour\n\n/** Cap the list so a string of abandoned checkouts can't grow it unbounded. */\nconst MAX = 5;\n\ntype Entry = { sessionId: string; ts: number };\n\nfunction isFresh(entry: Entry): boolean {\n  return Date.now() - entry.ts <= TTL;\n}\n\nfunction read(): Entry[] {\n  try {\n    const raw = localStorage.getItem(KEY);\n    if (!raw) return [];\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    return parsed.filter(\n      (e): e is Entry => !!e && typeof e.sessionId === 'string' && typeof e.ts === 'number'\n    );\n  } catch {\n    return [];\n  }\n}\n\nfunction write(entries: Entry[]) {\n  try {\n    if (entries.length === 0) localStorage.removeItem(KEY);\n    else localStorage.setItem(KEY, JSON.stringify(entries.slice(-MAX)));\n  } catch {\n    // ignore — storage unavailable / quota; the webhook still reconciles.\n  }\n}\n\n/** Record a started checkout to retry confirmation on later. Dedupes by session id. */\nexport function addPendingCheckout(sessionId: string) {\n  const entries = read().filter((e) => isFresh(e) && e.sessionId !== sessionId);\n  entries.push({ sessionId, ts: Date.now() });\n  write(entries);\n}\n\n/** Fresh session ids awaiting confirmation. Persists the pruned list as a side effect. */\nexport function getPendingCheckouts(): string[] {\n  const all = read();\n  const fresh = all.filter(isFresh);\n  if (fresh.length !== all.length) write(fresh);\n  return fresh.map((e) => e.sessionId);\n}\n\n/** Drop one session once it's confirmed (or known not to belong to this user). */\nexport function removePendingCheckout(sessionId: string) {\n  write(read().filter((e) => isFresh(e) && e.sessionId !== sessionId));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAM,MAAM;;AAGZ,MAAM,MAAM;AAOZ,SAAS,QAAQ,OAAuB;CACtC,OAAO,KAAK,IAAI,IAAI,MAAM,MAAM;AAClC;AAEA,SAAS,OAAgB;CACvB,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,GAAG;EACpC,IAAI,CAAC,KAAK,OAAO,CAAC;EAClB,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,QACX,MAAkB,CAAC,CAAC,KAAK,OAAO,EAAE,cAAc,YAAY,OAAO,EAAE,OAAO,QAC/E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,MAAM,SAAkB;CAC/B,IAAI;EACF,IAAI,QAAQ,WAAW,GAAG,aAAa,WAAW,GAAG;OAChD,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,MAAM,EAAI,CAAC,CAAC;CACpE,QAAQ,CAER;AACF;;AAGA,SAAgB,mBAAmB,WAAmB;CACpD,MAAM,UAAU,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS;CAC5E,QAAQ,KAAK;EAAE;EAAW,IAAI,KAAK,IAAI;CAAE,CAAC;CAC1C,MAAM,OAAO;AACf;;AAGA,SAAgB,sBAAgC;CAC9C,MAAM,MAAM,KAAK;CACjB,MAAM,QAAQ,IAAI,OAAO,OAAO;CAChC,IAAI,MAAM,WAAW,IAAI,QAAQ,MAAM,KAAK;CAC5C,OAAO,MAAM,KAAK,MAAM,EAAE,SAAS;AACrC;;AAGA,SAAgB,sBAAsB,WAAmB;CACvD,MAAM,KAAK,CAAC,CAAC,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,cAAc,SAAS,CAAC;AACrE"}

package/dist/stripe/schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.cjs","names":[],"sources":["../../src/stripe/schema.ts"],"sourcesContent":["import type { Stripe } from 'stripe';\nimport {\n  _default,\n  enum as _enum,\n  gte,\n  int,\n  maxLength,\n  nullable,\n  object,\n  optional,\n  type output,\n  string,\n  url,\n} from 'zod/mini';\n\nexport const cancellationDetailsSchema = object({\n  comment: optional(nullable(string().check(maxLength(1024)))),\n  feedback: optional(\n    nullable(\n      _enum([\n        'customer_service',\n        'low_quality',\n        'missing_features',\n        'switched_service',\n        'too_complex',\n        'too_expensive',\n        'unused',\n        'other',\n      ])\n    )\n  ),\n  resubscribeIntent: optional(nullable(_enum(['maybe', 'no', 'yes']))),\n});\n\nexport function createCheckoutSessionSchema(productIds: string[]) {\n  return object({\n    quantity: _default(int().check(gte(1)), 1),\n    productId: _enum(productIds),\n    cancelUrl: optional(url()),\n    successUrl: optional(url()),\n  });\n}\n\n// The schema validates what a client may send; this is the stored/returned shape,\n// so `feedback` and `reason` take stripe's own open-ended enums — since 22.4 both\n// carry `OtherString`, and a Subscription.cancellation_details is assigned here\n// verbatim.\nexport interface CancellationDetails extends Omit<\n  output<typeof cancellationDetailsSchema>,\n  'feedback'\n> {\n  feedback?: Stripe.Subscription.CancellationDetails.Feedback | null;\n  reason?: Stripe.Subscription.CancellationDetails.Reason | null;\n}\n\nexport interface CreateCheckoutSessionDTO {\n  productId: string;\n  cancelUrl?: string;\n  successUrl?: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n}\n"],"mappings":";;;AAeA,MAAa,6BAAA,GAAA,SAAA,OAAA,CAAmC;CAC9C,UAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,OAAA,CAAkC,CAAC,CAAC,OAAA,GAAA,SAAA,UAAA,CAAgB,IAAI,CAAC,CAAC,CAAC;CAC3D,WAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,KAAA,CAEU;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CACH,CACF;CACA,oBAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,KAAA,CAA2C;EAAC;EAAS;EAAM;CAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,4BAA4B,YAAsB;CAChE,QAAA,GAAA,SAAA,OAAA,CAAc;EACZ,WAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,IAAA,CAAuB,CAAC,CAAC,OAAA,GAAA,SAAA,IAAA,CAAU,CAAC,CAAC,GAAG,CAAC;EACzC,YAAA,GAAA,SAAA,KAAA,CAAiB,UAAU;EAC3B,YAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,IAAA,CAAwB,CAAC;EACzB,aAAA,GAAA,SAAA,SAAA,EAAA,GAAA,SAAA,IAAA,CAAyB,CAAC;CAC5B,CAAC;AACH"}
+{"version":3,"file":"schema.cjs","names":["object","optional","nullable","string","maxLength","_enum","_default","int","gte","url"],"sources":["../../src/stripe/schema.ts"],"sourcesContent":["import type { Stripe } from 'stripe';\nimport {\n  _default,\n  enum as _enum,\n  gte,\n  int,\n  maxLength,\n  nullable,\n  object,\n  optional,\n  type output,\n  string,\n  url,\n} from 'zod/mini';\n\nexport const cancellationDetailsSchema = object({\n  comment: optional(nullable(string().check(maxLength(1024)))),\n  feedback: optional(\n    nullable(\n      _enum([\n        'customer_service',\n        'low_quality',\n        'missing_features',\n        'switched_service',\n        'too_complex',\n        'too_expensive',\n        'unused',\n        'other',\n      ])\n    )\n  ),\n  resubscribeIntent: optional(nullable(_enum(['maybe', 'no', 'yes']))),\n});\n\nexport function createCheckoutSessionSchema(productIds: string[]) {\n  return object({\n    quantity: _default(int().check(gte(1)), 1),\n    productId: _enum(productIds),\n    cancelUrl: optional(url()),\n    successUrl: optional(url()),\n  });\n}\n\n// The schema validates what a client may send; this is the stored/returned shape,\n// so `feedback` and `reason` take stripe's own open-ended enums — since 22.4 both\n// carry `OtherString`, and a Subscription.cancellation_details is assigned here\n// verbatim.\nexport interface CancellationDetails extends Omit<\n  output<typeof cancellationDetailsSchema>,\n  'feedback'\n> {\n  feedback?: Stripe.Subscription.CancellationDetails.Feedback | null;\n  reason?: Stripe.Subscription.CancellationDetails.Reason | null;\n}\n\nexport interface CreateCheckoutSessionDTO {\n  productId: string;\n  cancelUrl?: string;\n  successUrl?: `${string}session_id={CHECKOUT_SESSION_ID}${string}`;\n}\n"],"mappings":";;;AAeA,MAAa,6BAAA,GAA4BA,SAAAA,OAAAA,CAAO;CAC9C,UAAA,GAASC,SAAAA,SAAAA,EAAAA,GAASC,SAAAA,SAAAA,EAAAA,GAASC,SAAAA,OAAAA,CAAO,CAAC,CAAC,OAAA,GAAMC,SAAAA,UAAAA,CAAU,IAAI,CAAC,CAAC,CAAC;CAC3D,WAAA,GAAUH,SAAAA,SAAAA,EAAAA,GACRC,SAAAA,SAAAA,EAAAA,GACEG,SAAAA,KAAAA,CAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CACH,CACF;CACA,oBAAA,GAAmBJ,SAAAA,SAAAA,EAAAA,GAASC,SAAAA,SAAAA,EAAAA,GAASG,SAAAA,KAAAA,CAAM;EAAC;EAAS;EAAM;CAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,4BAA4B,YAAsB;CAChE,QAAA,GAAOL,SAAAA,OAAAA,CAAO;EACZ,WAAA,GAAUM,SAAAA,SAAAA,EAAAA,GAASC,SAAAA,IAAAA,CAAI,CAAC,CAAC,OAAA,GAAMC,SAAAA,IAAAA,CAAI,CAAC,CAAC,GAAG,CAAC;EACzC,YAAA,GAAWH,SAAAA,KAAAA,CAAM,UAAU;EAC3B,YAAA,GAAWJ,SAAAA,SAAAA,EAAAA,GAASQ,SAAAA,IAAAA,CAAI,CAAC;EACzB,aAAA,GAAYR,SAAAA,SAAAA,EAAAA,GAASQ,SAAAA,IAAAA,CAAI,CAAC;CAC5B,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shware/purchase",
-  "version": "4.2.1",
+  "version": "5.0.0",
   "private": false,
   "repository": {
     "type": "git",