@shware/purchase 7.0.0 → 7.2.0

package/dist/index.cjs

@@ -8,6 +8,7 @@ exports.AppStoreConfig = require_app_store_config.AppStoreConfig;
 exports.CANCELLATION_FEEDBACKS = require_subscription_index.CANCELLATION_FEEDBACKS;
 exports.CANCELLATION_INITIATORS = require_subscription_index.CANCELLATION_INITIATORS;
 exports.GooglePlayConfig = require_google_play_config.GooglePlayConfig;
+exports.PAYMENT_TYPES = require_subscription_index.PAYMENT_TYPES;
 exports.PLATFORMS = require_subscription_index.PLATFORMS;
 exports.RESUBSCRIBE_INTENTS = require_subscription_index.RESUBSCRIBE_INTENTS;
 exports.SUBSCRIPTION_STATUSES = require_subscription_index.SUBSCRIPTION_STATUSES;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AppStoreConfig } from "./app-store/config.cjs";
-import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PLATFORMS, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.cjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PAYMENT_TYPES, PLATFORMS, PaymentType, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.cjs";
 import { GooglePlayConfig } from "./google-play/config.cjs";
 import { StripeConfig } from "./stripe/config.cjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PLATFORMS, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PAYMENT_TYPES, PLATFORMS, type PaymentType, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { AppStoreConfig } from "./app-store/config.mjs";
-import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PLATFORMS, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.mjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PAYMENT_TYPES, PLATFORMS, PaymentType, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.mjs";
 import { GooglePlayConfig } from "./google-play/config.mjs";
 import { StripeConfig } from "./stripe/config.mjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PLATFORMS, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PAYMENT_TYPES, PLATFORMS, type PaymentType, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES } from "./subscription/index.mjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, PAYMENT_TYPES, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES } from "./subscription/index.mjs";
 import { AppStoreConfig } from "./app-store/config.mjs";
 import { GooglePlayConfig } from "./google-play/config.mjs";
 import { StripeConfig } from "./stripe/config.mjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, GooglePlayConfig, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES, StripeConfig };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, GooglePlayConfig, PAYMENT_TYPES, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES, StripeConfig };

package/dist/stripe/config.cjs

@@ -67,6 +67,7 @@ var StripeConfig = class StripeConfig {
 	}
 	[addMethod] = (product) => {
 		(0, _shware_utils.invariant)(!this.products.has(product.id), `Duplicate product ${product.id}`);
+		for (const existing of this.products.values()) for (const priceId of product.prices.keys()) (0, _shware_utils.invariant)(!existing.prices.has(priceId), `Duplicate price ${priceId} on ${existing.id}`);
 		if (product.plan !== null) for (const existing of this.products.values()) (0, _shware_utils.invariant)(existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod, `Duplicate plan ${product.plan}:${product.billingPeriod}`);
 		this.products.set(product.id, product);
 		return this;
@@ -111,6 +112,16 @@ var StripeConfig = class StripeConfig {
 		(0, _shware_utils.invariant)(product.defaultPriceId, `Default price not found for product ${productId}`);
 		return product.defaultPriceId;
 	};
+	/**
+	* The product that declares `priceId` (a legacy price or the test twin included), or null for a
+	* price this config does not know: one set up by hand in the dashboard, or a test price reaching
+	* a live config. Reading the product from the price a Stripe object charged, rather than from
+	* metadata that may already name the next plan, is what an invoice should be credited by.
+	*/
+	getProductId = (priceId) => {
+		for (const product of this.products.values()) if (product.prices.has(priceId)) return product.id;
+		return null;
+	};
 	getCreditAmount = (productId, priceId) => {
 		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\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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"}
+{"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    // A Stripe price belongs to one Stripe product, and getProductId must have one answer.\n    for (const existing of this.products.values()) {\n      for (const priceId of product.prices.keys()) {\n        invariant(!existing.prices.has(priceId), `Duplicate price ${priceId} on ${existing.id}`);\n      }\n    }\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  /**\n   * The product that declares `priceId` (a legacy price or the test twin included), or null for a\n   * price this config does not know: one set up by hand in the dashboard, or a test price reaching\n   * a live config. Reading the product from the price a Stripe object charged, rather than from\n   * metadata that may already name the next plan, is what an invoice should be credited by.\n   */\n  getProductId = (priceId: string): string | null => {\n    for (const product of this.products.values()) {\n      if (product.prices.has(priceId as PriceId)) return product.id;\n    }\n    return null;\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

@@ -68,6 +68,13 @@ export declare class StripeConfig<NS extends Lowercase<string> = Lowercase<strin
   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;
+  /**
+   * The product that declares `priceId` (a legacy price or the test twin included), or null for a
+   * price this config does not know: one set up by hand in the dashboard, or a test price reaching
+   * a live config. Reading the product from the price a Stripe object charged, rather than from
+   * metadata that may already name the next plan, is what an invoice should be credited by.
+   */
+  getProductId: (priceId: string) => string | null;
   getCreditAmount: (productId: string, priceId?: string) => number;
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string, priceId?: string) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;YAIY;;;;;;;YAQA;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;;qBAGW,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"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;YAIY;;;;;;;YAQA;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;;qBAGW,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;UAoBzC;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;;;;;;;EAalC,eAAY;EAOZ,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}

package/dist/stripe/config.d.mts

@@ -68,6 +68,13 @@ export declare class StripeConfig<NS extends Lowercase<string> = Lowercase<strin
   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;
+  /**
+   * The product that declares `priceId` (a legacy price or the test twin included), or null for a
+   * price this config does not know: one set up by hand in the dashboard, or a test price reaching
+   * a live config. Reading the product from the price a Stripe object charged, rather than from
+   * metadata that may already name the next plan, is what an invoice should be credited by.
+   */
+  getProductId: (priceId: string) => string | null;
   getCreditAmount: (productId: string, priceId?: string) => number;
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string, priceId?: string) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;YAIY;;;;;;;YAQA;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;;qBAGW,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"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/stripe/config.ts"],"mappings":";;YAIY;;;;;;;YAQA;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;;qBAGW,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;UAoBzC;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;;;;;;;EAalC,eAAY;EAOZ,kBAAe,mBAAqB;mBAanB;EAajB,qBAAkB,mBAAqB"}

package/dist/stripe/config.mjs

@@ -64,6 +64,7 @@ var StripeConfig = class StripeConfig {
 	}
 	[addMethod] = (product) => {
 		invariant(!this.products.has(product.id), `Duplicate product ${product.id}`);
+		for (const existing of this.products.values()) for (const priceId of product.prices.keys()) invariant(!existing.prices.has(priceId), `Duplicate price ${priceId} on ${existing.id}`);
 		if (product.plan !== null) for (const existing of this.products.values()) invariant(existing.plan !== product.plan || existing.billingPeriod !== product.billingPeriod, `Duplicate plan ${product.plan}:${product.billingPeriod}`);
 		this.products.set(product.id, product);
 		return this;
@@ -108,6 +109,16 @@ var StripeConfig = class StripeConfig {
 		invariant(product.defaultPriceId, `Default price not found for product ${productId}`);
 		return product.defaultPriceId;
 	};
+	/**
+	* The product that declares `priceId` (a legacy price or the test twin included), or null for a
+	* price this config does not know: one set up by hand in the dashboard, or a test price reaching
+	* a live config. Reading the product from the price a Stripe object charged, rather than from
+	* metadata that may already name the next plan, is what an invoice should be credited by.
+	*/
+	getProductId = (priceId) => {
+		for (const product of this.products.values()) if (product.prices.has(priceId)) return product.id;
+		return null;
+	};
 	getCreditAmount = (productId, priceId) => {
 		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\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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"}
+{"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    // A Stripe price belongs to one Stripe product, and getProductId must have one answer.\n    for (const existing of this.products.values()) {\n      for (const priceId of product.prices.keys()) {\n        invariant(!existing.prices.has(priceId), `Duplicate price ${priceId} on ${existing.id}`);\n      }\n    }\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  /**\n   * The product that declares `priceId` (a legacy price or the test twin included), or null for a\n   * price this config does not know: one set up by hand in the dashboard, or a test price reaching\n   * a live config. Reading the product from the price a Stripe object charged, rather than from\n   * metadata that may already name the next plan, is what an invoice should be credited by.\n   */\n  getProductId = (priceId: string): string | null => {\n    for (const product of this.products.values()) {\n      if (product.prices.has(priceId as PriceId)) return product.id;\n    }\n    return null;\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/expandable.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/stripe/expandable.ts
+function idOf(ref) {
+	if (!ref) return null;
+	return typeof ref === "string" ? ref : ref.id;
+}
+function expanded(ref, what) {
+	if (!ref) return null;
+	if (typeof ref === "string") throw new Error(`${what} ${ref} was retrieved without expanding it`);
+	return ref;
+}
+//#endregion
+exports.expanded = expanded;
+exports.idOf = idOf;
+
+//# sourceMappingURL=expandable.cjs.map

package/dist/stripe/expandable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expandable.cjs","names":[],"sources":["../../src/stripe/expandable.ts"],"sourcesContent":["/**\n * Helpers for Stripe's expandable fields: a reference Stripe returns as a bare id, or as the whole\n * object when the request asked for it with `expand`.\n */\n\ntype Ref<T extends { id: string }> = string | T | null | undefined;\n\n/** The id behind an expandable field, whether it came back expanded or not. */\nexport function idOf<T extends { id: string }>(ref: string | T): string;\nexport function idOf<T extends { id: string }>(ref: Ref<T>): string | null;\nexport function idOf<T extends { id: string }>(ref: Ref<T>): string | null {\n  if (!ref) return null;\n  return typeof ref === 'string' ? ref : ref.id;\n}\n\n/**\n * The object behind an expandable field the caller retrieved with `expand`. A bare id means the\n * request forgot the expansion, a bug in the caller rather than anything Stripe can fix on a retry,\n * so it throws; an absent reference stays null. `what` names the field for the error message.\n */\nexport function expanded<T extends { id: string }>(ref: string | T, what: string): T;\nexport function expanded<T extends { id: string }>(ref: Ref<T>, what: string): T | null;\nexport function expanded<T extends { id: string }>(ref: Ref<T>, what: string): T | null {\n  if (!ref) return null;\n  if (typeof ref === 'string') throw new Error(`${what} ${ref} was retrieved without expanding it`);\n  return ref;\n}\n"],"mappings":";;AAUA,SAAgB,KAA+B,KAA4B;CACzE,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC7C;AASA,SAAgB,SAAmC,KAAa,MAAwB;CACtF,IAAI,CAAC,KAAK,OAAO;CACjB,IAAI,OAAO,QAAQ,UAAU,MAAM,IAAI,MAAM,GAAG,KAAK,GAAG,IAAI,oCAAoC;CAChG,OAAO;AACT"}

package/dist/stripe/expandable.d.cts

@@ -0,0 +1,29 @@
+//#region src/stripe/expandable.d.ts
+/**
+ * Helpers for Stripe's expandable fields: a reference Stripe returns as a bare id, or as the whole
+ * object when the request asked for it with `expand`.
+ */
+type Ref<T extends {
+  id: string;
+}> = string | T | null | undefined;
+/** The id behind an expandable field, whether it came back expanded or not. */
+export declare function idOf<T extends {
+  id: string;
+}>(ref: string | T): string;
+export declare function idOf<T extends {
+  id: string;
+}>(ref: Ref<T>): string | null;
+/**
+ * The object behind an expandable field the caller retrieved with `expand`. A bare id means the
+ * request forgot the expansion, a bug in the caller rather than anything Stripe can fix on a retry,
+ * so it throws; an absent reference stays null. `what` names the field for the error message.
+ */
+export declare function expanded<T extends {
+  id: string;
+}>(ref: string | T, what: string): T;
+export declare function expanded<T extends {
+  id: string;
+}>(ref: Ref<T>, what: string): T | null;
+//#endregion
+export {};
+//# sourceMappingURL=expandable.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expandable.d.cts","names":[],"sources":["../../src/stripe/expandable.ts"],"mappings":";;;;;KAKK,IAAI;EAAY;cAAyB;;wBAG9B,KAAK;EAAY;GAAc,cAAc;wBAC7C,KAAK;EAAY;GAAc,KAAK,IAAI;;;;;;wBAWxC,SAAS;EAAY;GAAc,cAAc,GAAG,eAAe;wBACnE,SAAS;EAAY;GAAc,KAAK,IAAI,IAAI,eAAe"}

package/dist/stripe/expandable.d.mts

@@ -0,0 +1,29 @@
+//#region src/stripe/expandable.d.ts
+/**
+ * Helpers for Stripe's expandable fields: a reference Stripe returns as a bare id, or as the whole
+ * object when the request asked for it with `expand`.
+ */
+type Ref<T extends {
+  id: string;
+}> = string | T | null | undefined;
+/** The id behind an expandable field, whether it came back expanded or not. */
+export declare function idOf<T extends {
+  id: string;
+}>(ref: string | T): string;
+export declare function idOf<T extends {
+  id: string;
+}>(ref: Ref<T>): string | null;
+/**
+ * The object behind an expandable field the caller retrieved with `expand`. A bare id means the
+ * request forgot the expansion, a bug in the caller rather than anything Stripe can fix on a retry,
+ * so it throws; an absent reference stays null. `what` names the field for the error message.
+ */
+export declare function expanded<T extends {
+  id: string;
+}>(ref: string | T, what: string): T;
+export declare function expanded<T extends {
+  id: string;
+}>(ref: Ref<T>, what: string): T | null;
+//#endregion
+export {};
+//# sourceMappingURL=expandable.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expandable.d.mts","names":[],"sources":["../../src/stripe/expandable.ts"],"mappings":";;;;;KAKK,IAAI;EAAY;cAAyB;;wBAG9B,KAAK;EAAY;GAAc,cAAc;wBAC7C,KAAK;EAAY;GAAc,KAAK,IAAI;;;;;;wBAWxC,SAAS;EAAY;GAAc,cAAc,GAAG,eAAe;wBACnE,SAAS;EAAY;GAAc,KAAK,IAAI,IAAI,eAAe"}

package/dist/stripe/expandable.mjs

@@ -0,0 +1,14 @@
+//#region src/stripe/expandable.ts
+function idOf(ref) {
+	if (!ref) return null;
+	return typeof ref === "string" ? ref : ref.id;
+}
+function expanded(ref, what) {
+	if (!ref) return null;
+	if (typeof ref === "string") throw new Error(`${what} ${ref} was retrieved without expanding it`);
+	return ref;
+}
+//#endregion
+export { expanded, idOf };
+
+//# sourceMappingURL=expandable.mjs.map

package/dist/stripe/expandable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expandable.mjs","names":[],"sources":["../../src/stripe/expandable.ts"],"sourcesContent":["/**\n * Helpers for Stripe's expandable fields: a reference Stripe returns as a bare id, or as the whole\n * object when the request asked for it with `expand`.\n */\n\ntype Ref<T extends { id: string }> = string | T | null | undefined;\n\n/** The id behind an expandable field, whether it came back expanded or not. */\nexport function idOf<T extends { id: string }>(ref: string | T): string;\nexport function idOf<T extends { id: string }>(ref: Ref<T>): string | null;\nexport function idOf<T extends { id: string }>(ref: Ref<T>): string | null {\n  if (!ref) return null;\n  return typeof ref === 'string' ? ref : ref.id;\n}\n\n/**\n * The object behind an expandable field the caller retrieved with `expand`. A bare id means the\n * request forgot the expansion, a bug in the caller rather than anything Stripe can fix on a retry,\n * so it throws; an absent reference stays null. `what` names the field for the error message.\n */\nexport function expanded<T extends { id: string }>(ref: string | T, what: string): T;\nexport function expanded<T extends { id: string }>(ref: Ref<T>, what: string): T | null;\nexport function expanded<T extends { id: string }>(ref: Ref<T>, what: string): T | null {\n  if (!ref) return null;\n  if (typeof ref === 'string') throw new Error(`${what} ${ref} was retrieved without expanding it`);\n  return ref;\n}\n"],"mappings":";AAUA,SAAgB,KAA+B,KAA4B;CACzE,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC7C;AASA,SAAgB,SAAmC,KAAa,MAAwB;CACtF,IAAI,CAAC,KAAK,OAAO;CACjB,IAAI,OAAO,QAAQ,UAAU,MAAM,IAAI,MAAM,GAAG,KAAK,GAAG,IAAI,oCAAoC;CAChG,OAAO;AACT"}

package/dist/stripe/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_stripe_config = require("./config.cjs");
+const require_stripe_expandable = require("./expandable.cjs");
 const require_stripe_handler = require("./handler.cjs");
 const require_stripe_mapper = require("./mapper.cjs");
 const require_stripe_thin_handler = require("./thin-handler.cjs");
@@ -13,19 +14,23 @@ exports.StripeThinEventHandler = require_stripe_thin_handler.StripeThinEventHand
 exports.addPendingCheckout = require_stripe_pending_checkout.addPendingCheckout;
 exports.cancellationDetailsSchema = require_stripe_schema.cancellationDetailsSchema;
 exports.createCheckoutSessionSchema = require_stripe_schema.createCheckoutSessionSchema;
+exports.expanded = require_stripe_expandable.expanded;
 exports.getBeginCheckoutProperties = require_stripe_mapper.getBeginCheckoutProperties;
 exports.getPendingCheckouts = require_stripe_pending_checkout.getPendingCheckouts;
 exports.getPurchaseProperties = require_stripe_mapper.getPurchaseProperties;
+exports.idOf = require_stripe_expandable.idOf;
 exports.mapCancellationDetails = require_stripe_mapper.mapCancellationDetails;
 exports.mapCharge = require_stripe_mapper.mapCharge;
 exports.mapCheckoutSession = require_stripe_mapper.mapCheckoutSession;
 exports.mapInvoice = require_stripe_mapper.mapInvoice;
 exports.mapLineItem = require_stripe_mapper.mapLineItem;
 exports.mapPaymentIntent = require_stripe_mapper.mapPaymentIntent;
+exports.mapPaymentType = require_stripe_mapper.mapPaymentType;
 exports.mapPrice = require_stripe_mapper.mapPrice;
 exports.mapSubscriptionStatus = require_stripe_mapper.mapSubscriptionStatus;
 exports.mapTime = require_stripe_mapper.mapTime;
 exports.minorUnits = require_stripe_mapper.minorUnits;
+exports.money = require_stripe_mapper.money;
 exports.price = require_stripe_mapper.price;
 exports.removePendingCheckout = require_stripe_pending_checkout.removePendingCheckout;
 exports.returnUrlSchema = require_stripe_schema.returnUrlSchema;

package/dist/stripe/index.d.cts

@@ -1,10 +1,11 @@
 import { CancellationDetails } from "../subscription/index.cjs";
 import { PriceId, StripeConfig, StripeMode } from "./config.cjs";
+import { expanded, idOf } from "./expandable.cjs";
 import { StripeEventHandler } from "./handler.cjs";
-import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.cjs";
+import { BeginCheckoutProperties, CheckoutSession, LineItem, Money, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price } from "./mapper.cjs";
 import { StripeThinEventHandler, StripeThinEventNotificationOf, StripeThinEventType } from "./thin-handler.cjs";
 import { AllowedOrigins, CreateCheckoutSessionDTO, CreateCheckoutSessionSchemaOptions, cancellationDetailsSchema, createCheckoutSessionSchema, returnUrlSchema } from "./schema.cjs";
 import { METADATA_KEYS } from "./metadata.cjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.cjs";
 import { Stripe } from "stripe";
-export { type AllowedOrigins, type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type CreateCheckoutSessionSchemaOptions, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, StripeThinEventHandler, type StripeThinEventNotificationOf, type StripeThinEventType, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout, returnUrlSchema };
+export { type AllowedOrigins, type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type CreateCheckoutSessionSchemaOptions, type LineItem, METADATA_KEYS, type Money, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, StripeThinEventHandler, type StripeThinEventNotificationOf, type StripeThinEventType, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, expanded, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, idOf, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price, removePendingCheckout, returnUrlSchema };

package/dist/stripe/index.d.mts

@@ -1,10 +1,11 @@
 import { CancellationDetails } from "../subscription/index.mjs";
 import { PriceId, StripeConfig, StripeMode } from "./config.mjs";
+import { expanded, idOf } from "./expandable.mjs";
 import { StripeEventHandler } from "./handler.mjs";
-import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
+import { BeginCheckoutProperties, CheckoutSession, LineItem, Money, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price } from "./mapper.mjs";
 import { StripeThinEventHandler, StripeThinEventNotificationOf, StripeThinEventType } from "./thin-handler.mjs";
 import { AllowedOrigins, CreateCheckoutSessionDTO, CreateCheckoutSessionSchemaOptions, cancellationDetailsSchema, createCheckoutSessionSchema, returnUrlSchema } from "./schema.mjs";
 import { METADATA_KEYS } from "./metadata.mjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.mjs";
 import { Stripe } from "stripe";
-export { type AllowedOrigins, type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type CreateCheckoutSessionSchemaOptions, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, StripeThinEventHandler, type StripeThinEventNotificationOf, type StripeThinEventType, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout, returnUrlSchema };
+export { type AllowedOrigins, type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type CreateCheckoutSessionSchemaOptions, type LineItem, METADATA_KEYS, type Money, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, StripeThinEventHandler, type StripeThinEventNotificationOf, type StripeThinEventType, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, expanded, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, idOf, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price, removePendingCheckout, returnUrlSchema };

package/dist/stripe/index.mjs

@@ -1,8 +1,9 @@
 import { StripeConfig } from "./config.mjs";
+import { expanded, idOf } from "./expandable.mjs";
 import { StripeEventHandler } from "./handler.mjs";
-import { getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
+import { getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price } from "./mapper.mjs";
 import { StripeThinEventHandler } from "./thin-handler.mjs";
 import { cancellationDetailsSchema, createCheckoutSessionSchema, returnUrlSchema } from "./schema.mjs";
 import { METADATA_KEYS } from "./metadata.mjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.mjs";
-export { METADATA_KEYS, StripeConfig, StripeEventHandler, StripeThinEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout, returnUrlSchema };
+export { METADATA_KEYS, StripeConfig, StripeEventHandler, StripeThinEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, expanded, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, idOf, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price, removePendingCheckout, returnUrlSchema };

package/dist/stripe/mapper.cjs

@@ -115,6 +115,22 @@ function mapSubscriptionStatus(status) {
 			throw new Error(`Invalid stripe status: ${String(status)}`);
 	}
 }
+/**
+* What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is
+* a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting
+* that as a renewal would inflate the renewal rate by every upgrade.
+*/
+function mapPaymentType(invoice) {
+	switch (invoice.billing_reason) {
+		case "subscription_create": return "SUBSCRIPTION_START";
+		case "subscription_cycle": return "SUBSCRIPTION_RENEWAL";
+		case "subscription_update": return "SUBSCRIPTION_UPDATE";
+		case "manual": return "SUBSCRIPTION_UPDATE";
+		default:
+			console.warn(`Invoice ${invoice.id} has billing_reason ${invoice.billing_reason}`);
+			return "SUBSCRIPTION_UPDATE";
+	}
+}
 /** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */
 function minorUnits(currency) {
 	return (0, _shware_utils.stripeMinorUnits)(currency);
@@ -122,6 +138,13 @@ function minorUnits(currency) {
 function price(value, currency) {
 	return value / minorUnits(currency);
 }
+/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */
+function money(value, currency) {
+	return {
+		amount: price(value, currency),
+		currency
+	};
+}
 const GOOGLE_ADS_TRANSACTION_ID_MAX = 64;
 /**
 * GA4 purchase events feed Google Ads conversions, whose transaction IDs are
@@ -214,10 +237,12 @@ exports.mapCheckoutSession = mapCheckoutSession;
 exports.mapInvoice = mapInvoice;
 exports.mapLineItem = mapLineItem;
 exports.mapPaymentIntent = mapPaymentIntent;
+exports.mapPaymentType = mapPaymentType;
 exports.mapPrice = mapPrice;
 exports.mapSubscriptionStatus = mapSubscriptionStatus;
 exports.mapTime = mapTime;
 exports.minorUnits = minorUnits;
+exports.money = money;
 exports.price = price;
 
 //# sourceMappingURL=mapper.cjs.map

package/dist/stripe/mapper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.cjs","names":["stripeMinorUnits","CANCELLATION_FEEDBACKS"],"sources":["../../src/stripe/mapper.ts"],"sourcesContent":["import { stripeMinorUnits } from '@shware/utils';\nimport type { Stripe } from 'stripe';\nimport {\n  CANCELLATION_FEEDBACKS,\n  type CancellationDetails,\n  type CancellationFeedback,\n  type SubscriptionStatus,\n} from '../subscription/index';\n\nexport function mapTime<T extends number | null>(\n  stripeTimestampSeconds: T\n): T extends number ? string : null {\n  if (!stripeTimestampSeconds) return null as T extends number ? string : null;\n  return new Date(stripeTimestampSeconds * 1000).toISOString() as T extends number ? string : null;\n}\n\nexport type Price = {\n  id: string;\n  type: Stripe.Price.Type;\n  active: boolean;\n  billing_scheme: Stripe.Price.BillingScheme;\n  currency: Stripe.Price['currency'];\n  unit_amount: number | null;\n  unit_amount_decimal: string | null;\n  recurring: Stripe.Price.Recurring | null;\n};\n\nexport function mapPrice(price: Stripe.Price): Price {\n  return {\n    id: price.id,\n    type: price.type,\n    active: price.active,\n    billing_scheme: price.billing_scheme,\n    currency: price.currency,\n    unit_amount: price.unit_amount,\n    unit_amount_decimal: price.unit_amount_decimal?.toString() ?? null,\n    recurring: price.recurring,\n  };\n}\n\nexport interface LineItem {\n  id: string;\n  currency: string;\n  quantity: number | null;\n  description: string | null;\n  amount_tax: number;\n  amount_total: number;\n  amount_subtotal: number;\n  amount_discount: number;\n  price: Price | null;\n}\n\nexport function mapLineItem(item: Stripe.LineItem): LineItem {\n  return {\n    id: item.price\n      ? typeof item.price.product === 'string'\n        ? item.price.product\n        : item.price.product.id\n      : item.id,\n    currency: item.currency,\n    quantity: item.quantity,\n    description: item.description,\n    amount_tax: item.amount_tax,\n    amount_total: item.amount_total,\n    amount_subtotal: item.amount_subtotal,\n    amount_discount: item.amount_discount,\n    price: item.price ? mapPrice(item.price) : null,\n  };\n}\n\n// Re-exported under our own name so consumers need not reach into stripe's namespace.\n// Open-ended since stripe 22.4: a status the API adds later is not a type error.\nexport type PaymentStatus = Stripe.Checkout.Session.PaymentStatus;\n\n// Declared rather than inferred from mapCheckoutSession: an inferred shape is\n// structural, so a consumer's declaration emit has to spell out payment_status\n// through stripe's internal module path — TS2883 in any package that reaches\n// stripe transitively instead of depending on it (see line_items/price too).\nexport interface CheckoutSession {\n  id: string;\n  url: string | null;\n  coupon: string | undefined;\n  livemode: boolean;\n  expires_at: number;\n  payment_status: PaymentStatus;\n  currency: string | null;\n  amount_total: number | null;\n  line_items: LineItem[] | undefined;\n}\n\nexport function mapCheckoutSession(session: Stripe.Checkout.Session): CheckoutSession {\n  let coupon: string | undefined = undefined;\n  if (Array.isArray(session.discounts) && session.discounts.length !== 0) {\n    const discount = session.discounts[0];\n    if (discount.coupon && typeof discount.coupon === 'object') {\n      coupon = discount.coupon.id;\n    } else if (typeof discount.coupon === 'string') {\n      coupon = discount.coupon;\n    } else {\n      coupon = undefined;\n    }\n  }\n\n  return {\n    id: session.id,\n    url: session.url,\n    coupon,\n    livemode: session.livemode,\n    expires_at: session.expires_at,\n    payment_status: session.payment_status,\n    currency: session.currency,\n    amount_total: session.amount_total,\n    line_items: session.line_items?.data.map(mapLineItem),\n  };\n}\n\nexport function mapInvoice(i: Stripe.Invoice) {\n  return {\n    id: i.id,\n    number: i.number,\n    total: i.total,\n    subtotal: i.subtotal,\n    amount_due: i.amount_due,\n    amount_paid: i.amount_paid,\n    amount_remaining: i.amount_remaining,\n    currency: i.currency,\n    billing_reason: i.billing_reason,\n    hosted_invoice_url: i.hosted_invoice_url,\n    invoice_pdf: i.invoice_pdf,\n    receipt_number: i.receipt_number,\n    status: i.status,\n    created: i.created,\n    period_start: i.period_start,\n    period_end: i.period_end,\n  };\n}\n\nexport function mapPaymentIntent(intent: Stripe.PaymentIntent) {\n  return {\n    id: intent.id,\n    amount: intent.amount,\n    amount_capturable: intent.amount_capturable,\n    amount_received: intent.amount_received,\n    currency: intent.currency,\n    client_secret: intent.client_secret,\n    description: intent.description,\n    status: intent.status,\n    created: intent.created,\n  };\n}\n\nexport function mapCharge(charge: Stripe.Charge) {\n  return {\n    id: charge.id,\n    description: charge.description,\n    currency: charge.currency,\n    amount: charge.amount,\n    amount_captured: charge.amount_captured,\n    amount_refunded: charge.amount_refunded,\n    receipt_email: charge.receipt_email,\n    receipt_number: charge.receipt_number,\n    receipt_url: charge.receipt_url,\n    status: charge.status,\n    created: charge.created,\n    payment_intent:\n      charge.payment_intent && typeof charge.payment_intent === 'object'\n        ? mapPaymentIntent(charge.payment_intent)\n        : undefined,\n  };\n}\n\nexport type ProductPrice = {\n  id: string;\n  type: Stripe.Price.Type;\n  unit_amount: number;\n  currency: Stripe.Price['currency'];\n  product: {\n    id: Stripe.Product['id'];\n    name: Stripe.Product['name'];\n    description: Stripe.Product['description'];\n    livemode: Stripe.Product['livemode'];\n  };\n};\n\nexport function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus {\n  switch (status) {\n    case 'active':\n      return 'ACTIVE';\n    case 'canceled':\n      return 'CANCELED';\n    case 'incomplete':\n      return 'INCOMPLETE';\n    case 'incomplete_expired':\n      return 'INCOMPLETE_EXPIRED';\n    case 'past_due':\n      return 'PAST_DUE';\n    case 'paused':\n      return 'PAUSED';\n    case 'trialing':\n      return 'TRIALING';\n    case 'unpaid':\n      return 'UNPAID';\n    default: {\n      console.error(`Invalid stripe status: ${String(status)}`);\n      throw new Error(`Invalid stripe status: ${String(status)}`);\n    }\n  }\n}\n\nexport { ZERO_DECIMAL_CURRENCIES } from '@shware/utils';\n\n/** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */\nexport function minorUnits(currency: string) {\n  return stripeMinorUnits(currency);\n}\n\nexport function price(value: number, currency: string) {\n  return value / minorUnits(currency);\n}\n\nexport interface Item {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n}\n\nexport interface PurchaseProperties {\n  currency: string;\n  value: number;\n  transaction_id: string;\n  coupon?: string;\n  shipping?: number;\n  tax?: number;\n  items?: Item[];\n}\n\nexport interface BeginCheckoutProperties {\n  currency: string;\n  value: number;\n  coupon?: string;\n  items: Item[];\n}\n\n// Google Ads rejects conversion transaction IDs longer than 64 characters.\n// https://support.google.com/google-ads/answer/6386790\nconst GOOGLE_ADS_TRANSACTION_ID_MAX = 64;\n\n/**\n * GA4 purchase events feed Google Ads conversions, whose transaction IDs are\n * capped at 64 characters — but Stripe checkout session ids exceed that:\n * around 2021 they grew from ~32 chars (`cs_live_` + 24 random chars) to ~66\n * (`cs_live_a` + 57), with no announcement. Stripe treats id length/format as\n * opaque and backwards-compatible, guaranteeing only that ids never exceed\n * 255 chars, so they may grow again at any time.\n *\n * Dropping the fixed `cs_live_`/`cs_test_` prefix brings the id under 64\n * while staying reversible: prepend the prefix (livemode tells which) to\n * reconstruct the full session id for Stripe dashboard lookups. The payment\n * intent id (~27 chars) is not a substitute — it only exists on\n * `mode: 'payment'` sessions (subscription-mode sessions carry it on the\n * invoice instead), and its short length is just as unguaranteed as the\n * session id's was.\n *\n * Must stay deterministic: GA4/Google Ads dedupe purchases by\n * transaction_id, and the same session may be tracked from multiple paths.\n */\nfunction toTransactionId(sessionId: string): string {\n  const stripped = sessionId.replace(/^cs_(live|test)_/, '');\n  if (stripped.length > GOOGLE_ADS_TRANSACTION_ID_MAX) {\n    console.warn(\n      `transaction_id still exceeds ${GOOGLE_ADS_TRANSACTION_ID_MAX} chars after stripping ` +\n        `the prefix — Stripe may have lengthened session ids again; truncating: ${sessionId}`\n    );\n  }\n  return stripped.slice(0, GOOGLE_ADS_TRANSACTION_ID_MAX);\n}\n\nexport function getPurchaseProperties(session: CheckoutSession): PurchaseProperties {\n  let value: number;\n  let currency: string;\n  if (!session.amount_total || !session.currency) {\n    value = session.line_items?.reduce((acc, item) => acc + item.amount_total, 0) ?? 0;\n    currency = session.line_items?.[0]?.currency ?? 'usd';\n  } else {\n    value = session.amount_total;\n    currency = session.currency;\n  }\n\n  return {\n    transaction_id: toTransactionId(session.id),\n    value: price(value, currency),\n    currency: currency.toUpperCase(),\n    coupon: session.coupon,\n    items: session.line_items?.map((item, index) => ({\n      index,\n      item_id: item.id,\n      item_name: item.description ?? '',\n      price: price(item.amount_total, item.currency),\n      quantity: item.quantity ?? 1,\n      discount: price(item.amount_discount, item.currency),\n    })),\n  };\n}\n\nexport function getBeginCheckoutProperties(p: ProductPrice): BeginCheckoutProperties {\n  return {\n    currency: p.currency.toUpperCase(),\n    value: price(p.unit_amount, p.currency),\n    items: [\n      {\n        item_id: p.product.id,\n        item_name: p.product.name,\n        price: price(p.unit_amount, p.currency),\n      },\n    ],\n  };\n}\n\n/**\n * Stripe's `cancellation_details` in the shared shape. The object is present on every\n * subscription with all three fields null, so an active one maps to null rather than an empty\n * record. `reason` says who acted: `cancellation_requested` is the customer (or us on their\n * behalf), the payment reasons are Stripe ending it.\n */\nexport function mapCancellationDetails(\n  subscription: Pick<Stripe.Subscription, 'cancellation_details'>\n): CancellationDetails | null {\n  const details = subscription.cancellation_details;\n  if (!details || (!details.reason && !details.feedback && !details.comment)) return null;\n  return {\n    initiator:\n      details.reason === 'payment_failed' || details.reason === 'payment_disputed'\n        ? 'system'\n        : 'user',\n    reason: details.reason ?? null,\n    // Stripe's feedback vocabulary is ours; anything it adds later is reported as \"other\".\n    feedback: details.feedback\n      ? (CANCELLATION_FEEDBACKS as readonly string[]).includes(details.feedback)\n        ? (details.feedback as CancellationFeedback)\n        : 'other'\n      : null,\n    comment: details.comment ?? null,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"mapper.cjs","names":["stripeMinorUnits","CANCELLATION_FEEDBACKS"],"sources":["../../src/stripe/mapper.ts"],"sourcesContent":["import { stripeMinorUnits } from '@shware/utils';\nimport type { Stripe } from 'stripe';\nimport {\n  CANCELLATION_FEEDBACKS,\n  type CancellationDetails,\n  type CancellationFeedback,\n  type PaymentType,\n  type SubscriptionStatus,\n} from '../subscription/index';\n\nexport function mapTime<T extends number | null>(\n  stripeTimestampSeconds: T\n): T extends number ? string : null {\n  if (!stripeTimestampSeconds) return null as T extends number ? string : null;\n  return new Date(stripeTimestampSeconds * 1000).toISOString() as T extends number ? string : null;\n}\n\nexport type Price = {\n  id: string;\n  type: Stripe.Price.Type;\n  active: boolean;\n  billing_scheme: Stripe.Price.BillingScheme;\n  currency: Stripe.Price['currency'];\n  unit_amount: number | null;\n  unit_amount_decimal: string | null;\n  recurring: Stripe.Price.Recurring | null;\n};\n\nexport function mapPrice(price: Stripe.Price): Price {\n  return {\n    id: price.id,\n    type: price.type,\n    active: price.active,\n    billing_scheme: price.billing_scheme,\n    currency: price.currency,\n    unit_amount: price.unit_amount,\n    unit_amount_decimal: price.unit_amount_decimal?.toString() ?? null,\n    recurring: price.recurring,\n  };\n}\n\nexport interface LineItem {\n  id: string;\n  currency: string;\n  quantity: number | null;\n  description: string | null;\n  amount_tax: number;\n  amount_total: number;\n  amount_subtotal: number;\n  amount_discount: number;\n  price: Price | null;\n}\n\nexport function mapLineItem(item: Stripe.LineItem): LineItem {\n  return {\n    id: item.price\n      ? typeof item.price.product === 'string'\n        ? item.price.product\n        : item.price.product.id\n      : item.id,\n    currency: item.currency,\n    quantity: item.quantity,\n    description: item.description,\n    amount_tax: item.amount_tax,\n    amount_total: item.amount_total,\n    amount_subtotal: item.amount_subtotal,\n    amount_discount: item.amount_discount,\n    price: item.price ? mapPrice(item.price) : null,\n  };\n}\n\n// Re-exported under our own name so consumers need not reach into stripe's namespace.\n// Open-ended since stripe 22.4: a status the API adds later is not a type error.\nexport type PaymentStatus = Stripe.Checkout.Session.PaymentStatus;\n\n// Declared rather than inferred from mapCheckoutSession: an inferred shape is\n// structural, so a consumer's declaration emit has to spell out payment_status\n// through stripe's internal module path — TS2883 in any package that reaches\n// stripe transitively instead of depending on it (see line_items/price too).\nexport interface CheckoutSession {\n  id: string;\n  url: string | null;\n  coupon: string | undefined;\n  livemode: boolean;\n  expires_at: number;\n  payment_status: PaymentStatus;\n  currency: string | null;\n  amount_total: number | null;\n  line_items: LineItem[] | undefined;\n}\n\nexport function mapCheckoutSession(session: Stripe.Checkout.Session): CheckoutSession {\n  let coupon: string | undefined = undefined;\n  if (Array.isArray(session.discounts) && session.discounts.length !== 0) {\n    const discount = session.discounts[0];\n    if (discount.coupon && typeof discount.coupon === 'object') {\n      coupon = discount.coupon.id;\n    } else if (typeof discount.coupon === 'string') {\n      coupon = discount.coupon;\n    } else {\n      coupon = undefined;\n    }\n  }\n\n  return {\n    id: session.id,\n    url: session.url,\n    coupon,\n    livemode: session.livemode,\n    expires_at: session.expires_at,\n    payment_status: session.payment_status,\n    currency: session.currency,\n    amount_total: session.amount_total,\n    line_items: session.line_items?.data.map(mapLineItem),\n  };\n}\n\nexport function mapInvoice(i: Stripe.Invoice) {\n  return {\n    id: i.id,\n    number: i.number,\n    total: i.total,\n    subtotal: i.subtotal,\n    amount_due: i.amount_due,\n    amount_paid: i.amount_paid,\n    amount_remaining: i.amount_remaining,\n    currency: i.currency,\n    billing_reason: i.billing_reason,\n    hosted_invoice_url: i.hosted_invoice_url,\n    invoice_pdf: i.invoice_pdf,\n    receipt_number: i.receipt_number,\n    status: i.status,\n    created: i.created,\n    period_start: i.period_start,\n    period_end: i.period_end,\n  };\n}\n\nexport function mapPaymentIntent(intent: Stripe.PaymentIntent) {\n  return {\n    id: intent.id,\n    amount: intent.amount,\n    amount_capturable: intent.amount_capturable,\n    amount_received: intent.amount_received,\n    currency: intent.currency,\n    client_secret: intent.client_secret,\n    description: intent.description,\n    status: intent.status,\n    created: intent.created,\n  };\n}\n\nexport function mapCharge(charge: Stripe.Charge) {\n  return {\n    id: charge.id,\n    description: charge.description,\n    currency: charge.currency,\n    amount: charge.amount,\n    amount_captured: charge.amount_captured,\n    amount_refunded: charge.amount_refunded,\n    receipt_email: charge.receipt_email,\n    receipt_number: charge.receipt_number,\n    receipt_url: charge.receipt_url,\n    status: charge.status,\n    created: charge.created,\n    payment_intent:\n      charge.payment_intent && typeof charge.payment_intent === 'object'\n        ? mapPaymentIntent(charge.payment_intent)\n        : undefined,\n  };\n}\n\nexport type ProductPrice = {\n  id: string;\n  type: Stripe.Price.Type;\n  unit_amount: number;\n  currency: Stripe.Price['currency'];\n  product: {\n    id: Stripe.Product['id'];\n    name: Stripe.Product['name'];\n    description: Stripe.Product['description'];\n    livemode: Stripe.Product['livemode'];\n  };\n};\n\nexport function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus {\n  switch (status) {\n    case 'active':\n      return 'ACTIVE';\n    case 'canceled':\n      return 'CANCELED';\n    case 'incomplete':\n      return 'INCOMPLETE';\n    case 'incomplete_expired':\n      return 'INCOMPLETE_EXPIRED';\n    case 'past_due':\n      return 'PAST_DUE';\n    case 'paused':\n      return 'PAUSED';\n    case 'trialing':\n      return 'TRIALING';\n    case 'unpaid':\n      return 'UNPAID';\n    default: {\n      console.error(`Invalid stripe status: ${String(status)}`);\n      throw new Error(`Invalid stripe status: ${String(status)}`);\n    }\n  }\n}\n\n/**\n * What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is\n * a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting\n * that as a renewal would inflate the renewal rate by every upgrade.\n */\nexport function mapPaymentType(\n  invoice: Pick<Stripe.Invoice, 'id' | 'billing_reason'>\n): Exclude<PaymentType, 'ONE_TIME'> {\n  switch (invoice.billing_reason) {\n    // Exactly once per subscription: its first invoice (after a trial, the first paid one is a cycle).\n    case 'subscription_create':\n      return 'SUBSCRIPTION_START';\n    case 'subscription_cycle':\n      return 'SUBSCRIPTION_RENEWAL';\n    case 'subscription_update':\n      return 'SUBSCRIPTION_UPDATE';\n    // An invoice made by hand on the subscription (dashboard or API): off-cycle money, not a renewal.\n    case 'manual':\n      return 'SUBSCRIPTION_UPDATE';\n    default:\n      // subscription_threshold (metered billing) and the rest are not reasons flat-priced\n      // subscriptions produce. Off-cycle is the safe reading: it leaves renewals alone.\n      console.warn(`Invoice ${invoice.id} has billing_reason ${invoice.billing_reason}`);\n      return 'SUBSCRIPTION_UPDATE';\n  }\n}\n\nexport { ZERO_DECIMAL_CURRENCIES } from '@shware/utils';\n\n/** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */\nexport function minorUnits(currency: string) {\n  return stripeMinorUnits(currency);\n}\n\nexport function price(value: number, currency: string) {\n  return value / minorUnits(currency);\n}\n\nexport type Money = { amount: number; currency: string };\n\n/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */\nexport function money(value: number, currency: string): Money {\n  return { amount: price(value, currency), currency };\n}\n\nexport interface Item {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n}\n\nexport interface PurchaseProperties {\n  currency: string;\n  value: number;\n  transaction_id: string;\n  coupon?: string;\n  shipping?: number;\n  tax?: number;\n  items?: Item[];\n}\n\nexport interface BeginCheckoutProperties {\n  currency: string;\n  value: number;\n  coupon?: string;\n  items: Item[];\n}\n\n// Google Ads rejects conversion transaction IDs longer than 64 characters.\n// https://support.google.com/google-ads/answer/6386790\nconst GOOGLE_ADS_TRANSACTION_ID_MAX = 64;\n\n/**\n * GA4 purchase events feed Google Ads conversions, whose transaction IDs are\n * capped at 64 characters — but Stripe checkout session ids exceed that:\n * around 2021 they grew from ~32 chars (`cs_live_` + 24 random chars) to ~66\n * (`cs_live_a` + 57), with no announcement. Stripe treats id length/format as\n * opaque and backwards-compatible, guaranteeing only that ids never exceed\n * 255 chars, so they may grow again at any time.\n *\n * Dropping the fixed `cs_live_`/`cs_test_` prefix brings the id under 64\n * while staying reversible: prepend the prefix (livemode tells which) to\n * reconstruct the full session id for Stripe dashboard lookups. The payment\n * intent id (~27 chars) is not a substitute — it only exists on\n * `mode: 'payment'` sessions (subscription-mode sessions carry it on the\n * invoice instead), and its short length is just as unguaranteed as the\n * session id's was.\n *\n * Must stay deterministic: GA4/Google Ads dedupe purchases by\n * transaction_id, and the same session may be tracked from multiple paths.\n */\nfunction toTransactionId(sessionId: string): string {\n  const stripped = sessionId.replace(/^cs_(live|test)_/, '');\n  if (stripped.length > GOOGLE_ADS_TRANSACTION_ID_MAX) {\n    console.warn(\n      `transaction_id still exceeds ${GOOGLE_ADS_TRANSACTION_ID_MAX} chars after stripping ` +\n        `the prefix — Stripe may have lengthened session ids again; truncating: ${sessionId}`\n    );\n  }\n  return stripped.slice(0, GOOGLE_ADS_TRANSACTION_ID_MAX);\n}\n\nexport function getPurchaseProperties(session: CheckoutSession): PurchaseProperties {\n  let value: number;\n  let currency: string;\n  if (!session.amount_total || !session.currency) {\n    value = session.line_items?.reduce((acc, item) => acc + item.amount_total, 0) ?? 0;\n    currency = session.line_items?.[0]?.currency ?? 'usd';\n  } else {\n    value = session.amount_total;\n    currency = session.currency;\n  }\n\n  return {\n    transaction_id: toTransactionId(session.id),\n    value: price(value, currency),\n    currency: currency.toUpperCase(),\n    coupon: session.coupon,\n    items: session.line_items?.map((item, index) => ({\n      index,\n      item_id: item.id,\n      item_name: item.description ?? '',\n      price: price(item.amount_total, item.currency),\n      quantity: item.quantity ?? 1,\n      discount: price(item.amount_discount, item.currency),\n    })),\n  };\n}\n\nexport function getBeginCheckoutProperties(p: ProductPrice): BeginCheckoutProperties {\n  return {\n    currency: p.currency.toUpperCase(),\n    value: price(p.unit_amount, p.currency),\n    items: [\n      {\n        item_id: p.product.id,\n        item_name: p.product.name,\n        price: price(p.unit_amount, p.currency),\n      },\n    ],\n  };\n}\n\n/**\n * Stripe's `cancellation_details` in the shared shape. The object is present on every\n * subscription with all three fields null, so an active one maps to null rather than an empty\n * record. `reason` says who acted: `cancellation_requested` is the customer (or us on their\n * behalf), the payment reasons are Stripe ending it.\n */\nexport function mapCancellationDetails(\n  subscription: Pick<Stripe.Subscription, 'cancellation_details'>\n): CancellationDetails | null {\n  const details = subscription.cancellation_details;\n  if (!details || (!details.reason && !details.feedback && !details.comment)) return null;\n  return {\n    initiator:\n      details.reason === 'payment_failed' || details.reason === 'payment_disputed'\n        ? 'system'\n        : 'user',\n    reason: details.reason ?? null,\n    // Stripe's feedback vocabulary is ours; anything it adds later is reported as \"other\".\n    feedback: details.feedback\n      ? (CANCELLATION_FEEDBACKS as readonly string[]).includes(details.feedback)\n        ? (details.feedback as CancellationFeedback)\n        : 'other'\n      : null,\n    comment: details.comment ?? null,\n  };\n}\n"],"mappings":"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"}

package/dist/stripe/mapper.d.cts

@@ -1,4 +1,4 @@
-import { CancellationDetails, SubscriptionStatus } from "../subscription/index.cjs";
+import { CancellationDetails, PaymentType, SubscriptionStatus } from "../subscription/index.cjs";
 import { Stripe } from "stripe";
 import { ZERO_DECIMAL_CURRENCIES } from "@shware/utils";
 //#region src/stripe/mapper.d.ts
@@ -105,9 +105,21 @@ export type ProductPrice = {
   };
 };
 export declare function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus;
+/**
+ * What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is
+ * a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting
+ * that as a renewal would inflate the renewal rate by every upgrade.
+ */
+export declare function mapPaymentType(invoice: Pick<Stripe.Invoice, 'id' | 'billing_reason'>): Exclude<PaymentType, 'ONE_TIME'>;
 /** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */
 export declare function minorUnits(currency: string): 1 | 100 | 1000;
 export declare function price(value: number, currency: string): number;
+export type Money = {
+  amount: number;
+  currency: string;
+};
+/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */
+export declare function money(value: number, currency: string): Money;
 export interface Item {
   item_id: string;
   item_name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/stripe/mapper.ts"],"mappings":";;;;wBASgB,QAAQ,yBACtB,wBAAwB,IACvB;YAKS;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,gBAAgB,OAAO,MAAM;EAC7B,UAAU,OAAO;EACjB;EACA;EACA,WAAW,OAAO,MAAM;;wBAGV,SAAS,OAAO,OAAO,QAAQ;iBAa9B;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;;wBAGO,YAAY,MAAM,OAAO,WAAW;YAoBxC,gBAAgB,OAAO,SAAS,QAAQ;iBAMnC;EACf;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA,YAAY;;wBAGE,mBAAmB,SAAS,OAAO,SAAS,UAAU;wBA0BtD,WAAW,GAAG,OAAO;EAEjC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAc,OAAA,QAAA;EACd;EACA;EACA;EACA,QAAM,OAAA,QAAA;EACN;EACA;EACA;;wBAIY,iBAAiB,QAAQ,OAAO;EAE5C;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,cAAA;EACN;;wBAIY,UAAU,QAAQ,OAAO;EAErC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,OAAA;EACN;EACA;;;;;;;;;;;;YAOQ;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,UAAU,OAAO;EACjB;IACE,IAAI,OAAO;IACX,MAAM,OAAO;IACb,aAAa,OAAO;IACpB,UAAU,OAAO;;;wBAIL,sBAAsB,QAAQ,OAAO,aAAa,SAAS;;wBA4B3D,WAAW;wBAIX,MAAM,eAAe;iBAIpB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA,OAAO;;wBAqCO,sBAAsB,SAAS,kBAAkB;wBA2BjD,2BAA2B,GAAG,eAAe;;;;;;;wBAoB7C,uBACd,cAAc,KAAK,OAAO,wCACzB"}
+{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/stripe/mapper.ts"],"mappings":";;;;wBAUgB,QAAQ,yBACtB,wBAAwB,IACvB;YAKS;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,gBAAgB,OAAO,MAAM;EAC7B,UAAU,OAAO;EACjB;EACA;EACA,WAAW,OAAO,MAAM;;wBAGV,SAAS,OAAO,OAAO,QAAQ;iBAa9B;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;;wBAGO,YAAY,MAAM,OAAO,WAAW;YAoBxC,gBAAgB,OAAO,SAAS,QAAQ;iBAMnC;EACf;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA,YAAY;;wBAGE,mBAAmB,SAAS,OAAO,SAAS,UAAU;wBA0BtD,WAAW,GAAG,OAAO;EAEjC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAc,OAAA,QAAA;EACd;EACA;EACA;EACA,QAAM,OAAA,QAAA;EACN;EACA;EACA;;wBAIY,iBAAiB,QAAQ,OAAO;EAE5C;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,cAAA;EACN;;wBAIY,UAAU,QAAQ,OAAO;EAErC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,OAAA;EACN;EACA;;;;;;;;;;;;YAOQ;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,UAAU,OAAO;EACjB;IACE,IAAI,OAAO;IACX,MAAM,OAAO;IACb,aAAa,OAAO;IACpB,UAAU,OAAO;;;wBAIL,sBAAsB,QAAQ,OAAO,aAAa,SAAS;;;;;;wBA8B3D,eACd,SAAS,KAAK,OAAO,oCACpB,QAAQ;;wBAuBK,WAAW;wBAIX,MAAM,eAAe;YAIzB;EAAU;EAAgB;;;wBAGtB,MAAM,eAAe,mBAAmB;iBAIvC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA,OAAO;;wBAqCO,sBAAsB,SAAS,kBAAkB;wBA2BjD,2BAA2B,GAAG,eAAe;;;;;;;wBAoB7C,uBACd,cAAc,KAAK,OAAO,wCACzB"}

package/dist/stripe/mapper.d.mts

@@ -1,4 +1,4 @@
-import { CancellationDetails, SubscriptionStatus } from "../subscription/index.mjs";
+import { CancellationDetails, PaymentType, SubscriptionStatus } from "../subscription/index.mjs";
 import { ZERO_DECIMAL_CURRENCIES } from "@shware/utils";
 import { Stripe } from "stripe";
 //#region src/stripe/mapper.d.ts
@@ -105,9 +105,21 @@ export type ProductPrice = {
   };
 };
 export declare function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus;
+/**
+ * What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is
+ * a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting
+ * that as a renewal would inflate the renewal rate by every upgrade.
+ */
+export declare function mapPaymentType(invoice: Pick<Stripe.Invoice, 'id' | 'billing_reason'>): Exclude<PaymentType, 'ONE_TIME'>;
 /** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */
 export declare function minorUnits(currency: string): 1 | 100 | 1000;
 export declare function price(value: number, currency: string): number;
+export type Money = {
+  amount: number;
+  currency: string;
+};
+/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */
+export declare function money(value: number, currency: string): Money;
 export interface Item {
   item_id: string;
   item_name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.mts","names":[],"sources":["../../src/stripe/mapper.ts"],"mappings":";;;;wBASgB,QAAQ,yBACtB,wBAAwB,IACvB;YAKS;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,gBAAgB,OAAO,MAAM;EAC7B,UAAU,OAAO;EACjB;EACA;EACA,WAAW,OAAO,MAAM;;wBAGV,SAAS,OAAO,OAAO,QAAQ;iBAa9B;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;;wBAGO,YAAY,MAAM,OAAO,WAAW;YAoBxC,gBAAgB,OAAO,SAAS,QAAQ;iBAMnC;EACf;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA,YAAY;;wBAGE,mBAAmB,SAAS,OAAO,SAAS,UAAU;wBA0BtD,WAAW,GAAG,OAAO;EAEjC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAc,OAAA,QAAA;EACd;EACA;EACA;EACA,QAAM,OAAA,QAAA;EACN;EACA;EACA;;wBAIY,iBAAiB,QAAQ,OAAO;EAE5C;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,cAAA;EACN;;wBAIY,UAAU,QAAQ,OAAO;EAErC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,OAAA;EACN;EACA;;;;;;;;;;;;YAOQ;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,UAAU,OAAO;EACjB;IACE,IAAI,OAAO;IACX,MAAM,OAAO;IACb,aAAa,OAAO;IACpB,UAAU,OAAO;;;wBAIL,sBAAsB,QAAQ,OAAO,aAAa,SAAS;;wBA4B3D,WAAW;wBAIX,MAAM,eAAe;iBAIpB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA,OAAO;;wBAqCO,sBAAsB,SAAS,kBAAkB;wBA2BjD,2BAA2B,GAAG,eAAe;;;;;;;wBAoB7C,uBACd,cAAc,KAAK,OAAO,wCACzB"}
+{"version":3,"file":"mapper.d.mts","names":[],"sources":["../../src/stripe/mapper.ts"],"mappings":";;;;wBAUgB,QAAQ,yBACtB,wBAAwB,IACvB;YAKS;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,gBAAgB,OAAO,MAAM;EAC7B,UAAU,OAAO;EACjB;EACA;EACA,WAAW,OAAO,MAAM;;wBAGV,SAAS,OAAO,OAAO,QAAQ;iBAa9B;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;;wBAGO,YAAY,MAAM,OAAO,WAAW;YAoBxC,gBAAgB,OAAO,SAAS,QAAQ;iBAMnC;EACf;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA,YAAY;;wBAGE,mBAAmB,SAAS,OAAO,SAAS,UAAU;wBA0BtD,WAAW,GAAG,OAAO;EAEjC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAc,OAAA,QAAA;EACd;EACA;EACA;EACA,QAAM,OAAA,QAAA;EACN;EACA;EACA;;wBAIY,iBAAiB,QAAQ,OAAO;EAE5C;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,cAAA;EACN;;wBAIY,UAAU,QAAQ,OAAO;EAErC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAM,OAAA,OAAA;EACN;EACA;;;;;;;;;;;;YAOQ;EACV;EACA,MAAM,OAAO,MAAM;EACnB;EACA,UAAU,OAAO;EACjB;IACE,IAAI,OAAO;IACX,MAAM,OAAO;IACb,aAAa,OAAO;IACpB,UAAU,OAAO;;;wBAIL,sBAAsB,QAAQ,OAAO,aAAa,SAAS;;;;;;wBA8B3D,eACd,SAAS,KAAK,OAAO,oCACpB,QAAQ;;wBAuBK,WAAW;wBAIX,MAAM,eAAe;YAIzB;EAAU;EAAgB;;;wBAGtB,MAAM,eAAe,mBAAmB;iBAIvC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA,OAAO;;wBAqCO,sBAAsB,SAAS,kBAAkB;wBA2BjD,2BAA2B,GAAG,eAAe;;;;;;;wBAoB7C,uBACd,cAAc,KAAK,OAAO,wCACzB"}

package/dist/stripe/mapper.mjs

@@ -114,6 +114,22 @@ function mapSubscriptionStatus(status) {
 			throw new Error(`Invalid stripe status: ${String(status)}`);
 	}
 }
+/**
+* What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is
+* a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting
+* that as a renewal would inflate the renewal rate by every upgrade.
+*/
+function mapPaymentType(invoice) {
+	switch (invoice.billing_reason) {
+		case "subscription_create": return "SUBSCRIPTION_START";
+		case "subscription_cycle": return "SUBSCRIPTION_RENEWAL";
+		case "subscription_update": return "SUBSCRIPTION_UPDATE";
+		case "manual": return "SUBSCRIPTION_UPDATE";
+		default:
+			console.warn(`Invoice ${invoice.id} has billing_reason ${invoice.billing_reason}`);
+			return "SUBSCRIPTION_UPDATE";
+	}
+}
 /** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */
 function minorUnits(currency) {
 	return stripeMinorUnits(currency);
@@ -121,6 +137,13 @@ function minorUnits(currency) {
 function price(value, currency) {
 	return value / minorUnits(currency);
 }
+/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */
+function money(value, currency) {
+	return {
+		amount: price(value, currency),
+		currency
+	};
+}
 const GOOGLE_ADS_TRANSACTION_ID_MAX = 64;
 /**
 * GA4 purchase events feed Google Ads conversions, whose transaction IDs are
@@ -199,6 +222,6 @@ function mapCancellationDetails(subscription) {
 	};
 }
 //#endregion
-export { ZERO_DECIMAL_CURRENCIES, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price };
+export { ZERO_DECIMAL_CURRENCIES, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPaymentType, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, money, price };
 
 //# sourceMappingURL=mapper.mjs.map

package/dist/stripe/mapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.mjs","names":[],"sources":["../../src/stripe/mapper.ts"],"sourcesContent":["import { stripeMinorUnits } from '@shware/utils';\nimport type { Stripe } from 'stripe';\nimport {\n  CANCELLATION_FEEDBACKS,\n  type CancellationDetails,\n  type CancellationFeedback,\n  type SubscriptionStatus,\n} from '../subscription/index';\n\nexport function mapTime<T extends number | null>(\n  stripeTimestampSeconds: T\n): T extends number ? string : null {\n  if (!stripeTimestampSeconds) return null as T extends number ? string : null;\n  return new Date(stripeTimestampSeconds * 1000).toISOString() as T extends number ? string : null;\n}\n\nexport type Price = {\n  id: string;\n  type: Stripe.Price.Type;\n  active: boolean;\n  billing_scheme: Stripe.Price.BillingScheme;\n  currency: Stripe.Price['currency'];\n  unit_amount: number | null;\n  unit_amount_decimal: string | null;\n  recurring: Stripe.Price.Recurring | null;\n};\n\nexport function mapPrice(price: Stripe.Price): Price {\n  return {\n    id: price.id,\n    type: price.type,\n    active: price.active,\n    billing_scheme: price.billing_scheme,\n    currency: price.currency,\n    unit_amount: price.unit_amount,\n    unit_amount_decimal: price.unit_amount_decimal?.toString() ?? null,\n    recurring: price.recurring,\n  };\n}\n\nexport interface LineItem {\n  id: string;\n  currency: string;\n  quantity: number | null;\n  description: string | null;\n  amount_tax: number;\n  amount_total: number;\n  amount_subtotal: number;\n  amount_discount: number;\n  price: Price | null;\n}\n\nexport function mapLineItem(item: Stripe.LineItem): LineItem {\n  return {\n    id: item.price\n      ? typeof item.price.product === 'string'\n        ? item.price.product\n        : item.price.product.id\n      : item.id,\n    currency: item.currency,\n    quantity: item.quantity,\n    description: item.description,\n    amount_tax: item.amount_tax,\n    amount_total: item.amount_total,\n    amount_subtotal: item.amount_subtotal,\n    amount_discount: item.amount_discount,\n    price: item.price ? mapPrice(item.price) : null,\n  };\n}\n\n// Re-exported under our own name so consumers need not reach into stripe's namespace.\n// Open-ended since stripe 22.4: a status the API adds later is not a type error.\nexport type PaymentStatus = Stripe.Checkout.Session.PaymentStatus;\n\n// Declared rather than inferred from mapCheckoutSession: an inferred shape is\n// structural, so a consumer's declaration emit has to spell out payment_status\n// through stripe's internal module path — TS2883 in any package that reaches\n// stripe transitively instead of depending on it (see line_items/price too).\nexport interface CheckoutSession {\n  id: string;\n  url: string | null;\n  coupon: string | undefined;\n  livemode: boolean;\n  expires_at: number;\n  payment_status: PaymentStatus;\n  currency: string | null;\n  amount_total: number | null;\n  line_items: LineItem[] | undefined;\n}\n\nexport function mapCheckoutSession(session: Stripe.Checkout.Session): CheckoutSession {\n  let coupon: string | undefined = undefined;\n  if (Array.isArray(session.discounts) && session.discounts.length !== 0) {\n    const discount = session.discounts[0];\n    if (discount.coupon && typeof discount.coupon === 'object') {\n      coupon = discount.coupon.id;\n    } else if (typeof discount.coupon === 'string') {\n      coupon = discount.coupon;\n    } else {\n      coupon = undefined;\n    }\n  }\n\n  return {\n    id: session.id,\n    url: session.url,\n    coupon,\n    livemode: session.livemode,\n    expires_at: session.expires_at,\n    payment_status: session.payment_status,\n    currency: session.currency,\n    amount_total: session.amount_total,\n    line_items: session.line_items?.data.map(mapLineItem),\n  };\n}\n\nexport function mapInvoice(i: Stripe.Invoice) {\n  return {\n    id: i.id,\n    number: i.number,\n    total: i.total,\n    subtotal: i.subtotal,\n    amount_due: i.amount_due,\n    amount_paid: i.amount_paid,\n    amount_remaining: i.amount_remaining,\n    currency: i.currency,\n    billing_reason: i.billing_reason,\n    hosted_invoice_url: i.hosted_invoice_url,\n    invoice_pdf: i.invoice_pdf,\n    receipt_number: i.receipt_number,\n    status: i.status,\n    created: i.created,\n    period_start: i.period_start,\n    period_end: i.period_end,\n  };\n}\n\nexport function mapPaymentIntent(intent: Stripe.PaymentIntent) {\n  return {\n    id: intent.id,\n    amount: intent.amount,\n    amount_capturable: intent.amount_capturable,\n    amount_received: intent.amount_received,\n    currency: intent.currency,\n    client_secret: intent.client_secret,\n    description: intent.description,\n    status: intent.status,\n    created: intent.created,\n  };\n}\n\nexport function mapCharge(charge: Stripe.Charge) {\n  return {\n    id: charge.id,\n    description: charge.description,\n    currency: charge.currency,\n    amount: charge.amount,\n    amount_captured: charge.amount_captured,\n    amount_refunded: charge.amount_refunded,\n    receipt_email: charge.receipt_email,\n    receipt_number: charge.receipt_number,\n    receipt_url: charge.receipt_url,\n    status: charge.status,\n    created: charge.created,\n    payment_intent:\n      charge.payment_intent && typeof charge.payment_intent === 'object'\n        ? mapPaymentIntent(charge.payment_intent)\n        : undefined,\n  };\n}\n\nexport type ProductPrice = {\n  id: string;\n  type: Stripe.Price.Type;\n  unit_amount: number;\n  currency: Stripe.Price['currency'];\n  product: {\n    id: Stripe.Product['id'];\n    name: Stripe.Product['name'];\n    description: Stripe.Product['description'];\n    livemode: Stripe.Product['livemode'];\n  };\n};\n\nexport function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus {\n  switch (status) {\n    case 'active':\n      return 'ACTIVE';\n    case 'canceled':\n      return 'CANCELED';\n    case 'incomplete':\n      return 'INCOMPLETE';\n    case 'incomplete_expired':\n      return 'INCOMPLETE_EXPIRED';\n    case 'past_due':\n      return 'PAST_DUE';\n    case 'paused':\n      return 'PAUSED';\n    case 'trialing':\n      return 'TRIALING';\n    case 'unpaid':\n      return 'UNPAID';\n    default: {\n      console.error(`Invalid stripe status: ${String(status)}`);\n      throw new Error(`Invalid stripe status: ${String(status)}`);\n    }\n  }\n}\n\nexport { ZERO_DECIMAL_CURRENCIES } from '@shware/utils';\n\n/** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */\nexport function minorUnits(currency: string) {\n  return stripeMinorUnits(currency);\n}\n\nexport function price(value: number, currency: string) {\n  return value / minorUnits(currency);\n}\n\nexport interface Item {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n}\n\nexport interface PurchaseProperties {\n  currency: string;\n  value: number;\n  transaction_id: string;\n  coupon?: string;\n  shipping?: number;\n  tax?: number;\n  items?: Item[];\n}\n\nexport interface BeginCheckoutProperties {\n  currency: string;\n  value: number;\n  coupon?: string;\n  items: Item[];\n}\n\n// Google Ads rejects conversion transaction IDs longer than 64 characters.\n// https://support.google.com/google-ads/answer/6386790\nconst GOOGLE_ADS_TRANSACTION_ID_MAX = 64;\n\n/**\n * GA4 purchase events feed Google Ads conversions, whose transaction IDs are\n * capped at 64 characters — but Stripe checkout session ids exceed that:\n * around 2021 they grew from ~32 chars (`cs_live_` + 24 random chars) to ~66\n * (`cs_live_a` + 57), with no announcement. Stripe treats id length/format as\n * opaque and backwards-compatible, guaranteeing only that ids never exceed\n * 255 chars, so they may grow again at any time.\n *\n * Dropping the fixed `cs_live_`/`cs_test_` prefix brings the id under 64\n * while staying reversible: prepend the prefix (livemode tells which) to\n * reconstruct the full session id for Stripe dashboard lookups. The payment\n * intent id (~27 chars) is not a substitute — it only exists on\n * `mode: 'payment'` sessions (subscription-mode sessions carry it on the\n * invoice instead), and its short length is just as unguaranteed as the\n * session id's was.\n *\n * Must stay deterministic: GA4/Google Ads dedupe purchases by\n * transaction_id, and the same session may be tracked from multiple paths.\n */\nfunction toTransactionId(sessionId: string): string {\n  const stripped = sessionId.replace(/^cs_(live|test)_/, '');\n  if (stripped.length > GOOGLE_ADS_TRANSACTION_ID_MAX) {\n    console.warn(\n      `transaction_id still exceeds ${GOOGLE_ADS_TRANSACTION_ID_MAX} chars after stripping ` +\n        `the prefix — Stripe may have lengthened session ids again; truncating: ${sessionId}`\n    );\n  }\n  return stripped.slice(0, GOOGLE_ADS_TRANSACTION_ID_MAX);\n}\n\nexport function getPurchaseProperties(session: CheckoutSession): PurchaseProperties {\n  let value: number;\n  let currency: string;\n  if (!session.amount_total || !session.currency) {\n    value = session.line_items?.reduce((acc, item) => acc + item.amount_total, 0) ?? 0;\n    currency = session.line_items?.[0]?.currency ?? 'usd';\n  } else {\n    value = session.amount_total;\n    currency = session.currency;\n  }\n\n  return {\n    transaction_id: toTransactionId(session.id),\n    value: price(value, currency),\n    currency: currency.toUpperCase(),\n    coupon: session.coupon,\n    items: session.line_items?.map((item, index) => ({\n      index,\n      item_id: item.id,\n      item_name: item.description ?? '',\n      price: price(item.amount_total, item.currency),\n      quantity: item.quantity ?? 1,\n      discount: price(item.amount_discount, item.currency),\n    })),\n  };\n}\n\nexport function getBeginCheckoutProperties(p: ProductPrice): BeginCheckoutProperties {\n  return {\n    currency: p.currency.toUpperCase(),\n    value: price(p.unit_amount, p.currency),\n    items: [\n      {\n        item_id: p.product.id,\n        item_name: p.product.name,\n        price: price(p.unit_amount, p.currency),\n      },\n    ],\n  };\n}\n\n/**\n * Stripe's `cancellation_details` in the shared shape. The object is present on every\n * subscription with all three fields null, so an active one maps to null rather than an empty\n * record. `reason` says who acted: `cancellation_requested` is the customer (or us on their\n * behalf), the payment reasons are Stripe ending it.\n */\nexport function mapCancellationDetails(\n  subscription: Pick<Stripe.Subscription, 'cancellation_details'>\n): CancellationDetails | null {\n  const details = subscription.cancellation_details;\n  if (!details || (!details.reason && !details.feedback && !details.comment)) return null;\n  return {\n    initiator:\n      details.reason === 'payment_failed' || details.reason === 'payment_disputed'\n        ? 'system'\n        : 'user',\n    reason: details.reason ?? null,\n    // Stripe's feedback vocabulary is ours; anything it adds later is reported as \"other\".\n    feedback: details.feedback\n      ? (CANCELLATION_FEEDBACKS as readonly string[]).includes(details.feedback)\n        ? (details.feedback as CancellationFeedback)\n        : 'other'\n      : null,\n    comment: details.comment ?? null,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"mapper.mjs","names":[],"sources":["../../src/stripe/mapper.ts"],"sourcesContent":["import { stripeMinorUnits } from '@shware/utils';\nimport type { Stripe } from 'stripe';\nimport {\n  CANCELLATION_FEEDBACKS,\n  type CancellationDetails,\n  type CancellationFeedback,\n  type PaymentType,\n  type SubscriptionStatus,\n} from '../subscription/index';\n\nexport function mapTime<T extends number | null>(\n  stripeTimestampSeconds: T\n): T extends number ? string : null {\n  if (!stripeTimestampSeconds) return null as T extends number ? string : null;\n  return new Date(stripeTimestampSeconds * 1000).toISOString() as T extends number ? string : null;\n}\n\nexport type Price = {\n  id: string;\n  type: Stripe.Price.Type;\n  active: boolean;\n  billing_scheme: Stripe.Price.BillingScheme;\n  currency: Stripe.Price['currency'];\n  unit_amount: number | null;\n  unit_amount_decimal: string | null;\n  recurring: Stripe.Price.Recurring | null;\n};\n\nexport function mapPrice(price: Stripe.Price): Price {\n  return {\n    id: price.id,\n    type: price.type,\n    active: price.active,\n    billing_scheme: price.billing_scheme,\n    currency: price.currency,\n    unit_amount: price.unit_amount,\n    unit_amount_decimal: price.unit_amount_decimal?.toString() ?? null,\n    recurring: price.recurring,\n  };\n}\n\nexport interface LineItem {\n  id: string;\n  currency: string;\n  quantity: number | null;\n  description: string | null;\n  amount_tax: number;\n  amount_total: number;\n  amount_subtotal: number;\n  amount_discount: number;\n  price: Price | null;\n}\n\nexport function mapLineItem(item: Stripe.LineItem): LineItem {\n  return {\n    id: item.price\n      ? typeof item.price.product === 'string'\n        ? item.price.product\n        : item.price.product.id\n      : item.id,\n    currency: item.currency,\n    quantity: item.quantity,\n    description: item.description,\n    amount_tax: item.amount_tax,\n    amount_total: item.amount_total,\n    amount_subtotal: item.amount_subtotal,\n    amount_discount: item.amount_discount,\n    price: item.price ? mapPrice(item.price) : null,\n  };\n}\n\n// Re-exported under our own name so consumers need not reach into stripe's namespace.\n// Open-ended since stripe 22.4: a status the API adds later is not a type error.\nexport type PaymentStatus = Stripe.Checkout.Session.PaymentStatus;\n\n// Declared rather than inferred from mapCheckoutSession: an inferred shape is\n// structural, so a consumer's declaration emit has to spell out payment_status\n// through stripe's internal module path — TS2883 in any package that reaches\n// stripe transitively instead of depending on it (see line_items/price too).\nexport interface CheckoutSession {\n  id: string;\n  url: string | null;\n  coupon: string | undefined;\n  livemode: boolean;\n  expires_at: number;\n  payment_status: PaymentStatus;\n  currency: string | null;\n  amount_total: number | null;\n  line_items: LineItem[] | undefined;\n}\n\nexport function mapCheckoutSession(session: Stripe.Checkout.Session): CheckoutSession {\n  let coupon: string | undefined = undefined;\n  if (Array.isArray(session.discounts) && session.discounts.length !== 0) {\n    const discount = session.discounts[0];\n    if (discount.coupon && typeof discount.coupon === 'object') {\n      coupon = discount.coupon.id;\n    } else if (typeof discount.coupon === 'string') {\n      coupon = discount.coupon;\n    } else {\n      coupon = undefined;\n    }\n  }\n\n  return {\n    id: session.id,\n    url: session.url,\n    coupon,\n    livemode: session.livemode,\n    expires_at: session.expires_at,\n    payment_status: session.payment_status,\n    currency: session.currency,\n    amount_total: session.amount_total,\n    line_items: session.line_items?.data.map(mapLineItem),\n  };\n}\n\nexport function mapInvoice(i: Stripe.Invoice) {\n  return {\n    id: i.id,\n    number: i.number,\n    total: i.total,\n    subtotal: i.subtotal,\n    amount_due: i.amount_due,\n    amount_paid: i.amount_paid,\n    amount_remaining: i.amount_remaining,\n    currency: i.currency,\n    billing_reason: i.billing_reason,\n    hosted_invoice_url: i.hosted_invoice_url,\n    invoice_pdf: i.invoice_pdf,\n    receipt_number: i.receipt_number,\n    status: i.status,\n    created: i.created,\n    period_start: i.period_start,\n    period_end: i.period_end,\n  };\n}\n\nexport function mapPaymentIntent(intent: Stripe.PaymentIntent) {\n  return {\n    id: intent.id,\n    amount: intent.amount,\n    amount_capturable: intent.amount_capturable,\n    amount_received: intent.amount_received,\n    currency: intent.currency,\n    client_secret: intent.client_secret,\n    description: intent.description,\n    status: intent.status,\n    created: intent.created,\n  };\n}\n\nexport function mapCharge(charge: Stripe.Charge) {\n  return {\n    id: charge.id,\n    description: charge.description,\n    currency: charge.currency,\n    amount: charge.amount,\n    amount_captured: charge.amount_captured,\n    amount_refunded: charge.amount_refunded,\n    receipt_email: charge.receipt_email,\n    receipt_number: charge.receipt_number,\n    receipt_url: charge.receipt_url,\n    status: charge.status,\n    created: charge.created,\n    payment_intent:\n      charge.payment_intent && typeof charge.payment_intent === 'object'\n        ? mapPaymentIntent(charge.payment_intent)\n        : undefined,\n  };\n}\n\nexport type ProductPrice = {\n  id: string;\n  type: Stripe.Price.Type;\n  unit_amount: number;\n  currency: Stripe.Price['currency'];\n  product: {\n    id: Stripe.Product['id'];\n    name: Stripe.Product['name'];\n    description: Stripe.Product['description'];\n    livemode: Stripe.Product['livemode'];\n  };\n};\n\nexport function mapSubscriptionStatus(status: Stripe.Subscription.Status): SubscriptionStatus {\n  switch (status) {\n    case 'active':\n      return 'ACTIVE';\n    case 'canceled':\n      return 'CANCELED';\n    case 'incomplete':\n      return 'INCOMPLETE';\n    case 'incomplete_expired':\n      return 'INCOMPLETE_EXPIRED';\n    case 'past_due':\n      return 'PAST_DUE';\n    case 'paused':\n      return 'PAUSED';\n    case 'trialing':\n      return 'TRIALING';\n    case 'unpaid':\n      return 'UNPAID';\n    default: {\n      console.error(`Invalid stripe status: ${String(status)}`);\n      throw new Error(`Invalid stripe status: ${String(status)}`);\n    }\n  }\n}\n\n/**\n * What a paid subscription invoice was for, by its `billing_reason`. Only `subscription_cycle` is\n * a renewal: a plan change invoices its proration mid-period (`subscription_update`), and counting\n * that as a renewal would inflate the renewal rate by every upgrade.\n */\nexport function mapPaymentType(\n  invoice: Pick<Stripe.Invoice, 'id' | 'billing_reason'>\n): Exclude<PaymentType, 'ONE_TIME'> {\n  switch (invoice.billing_reason) {\n    // Exactly once per subscription: its first invoice (after a trial, the first paid one is a cycle).\n    case 'subscription_create':\n      return 'SUBSCRIPTION_START';\n    case 'subscription_cycle':\n      return 'SUBSCRIPTION_RENEWAL';\n    case 'subscription_update':\n      return 'SUBSCRIPTION_UPDATE';\n    // An invoice made by hand on the subscription (dashboard or API): off-cycle money, not a renewal.\n    case 'manual':\n      return 'SUBSCRIPTION_UPDATE';\n    default:\n      // subscription_threshold (metered billing) and the rest are not reasons flat-priced\n      // subscriptions produce. Off-cycle is the safe reading: it leaves renewals alone.\n      console.warn(`Invoice ${invoice.id} has billing_reason ${invoice.billing_reason}`);\n      return 'SUBSCRIPTION_UPDATE';\n  }\n}\n\nexport { ZERO_DECIMAL_CURRENCIES } from '@shware/utils';\n\n/** How many Stripe API amount units make one unit of `currency` (1, 100 or 1000). */\nexport function minorUnits(currency: string) {\n  return stripeMinorUnits(currency);\n}\n\nexport function price(value: number, currency: string) {\n  return value / minorUnits(currency);\n}\n\nexport type Money = { amount: number; currency: string };\n\n/** A Stripe amount in minor units (cents, yen, fils) as an amount in `currency` itself. */\nexport function money(value: number, currency: string): Money {\n  return { amount: price(value, currency), currency };\n}\n\nexport interface Item {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n}\n\nexport interface PurchaseProperties {\n  currency: string;\n  value: number;\n  transaction_id: string;\n  coupon?: string;\n  shipping?: number;\n  tax?: number;\n  items?: Item[];\n}\n\nexport interface BeginCheckoutProperties {\n  currency: string;\n  value: number;\n  coupon?: string;\n  items: Item[];\n}\n\n// Google Ads rejects conversion transaction IDs longer than 64 characters.\n// https://support.google.com/google-ads/answer/6386790\nconst GOOGLE_ADS_TRANSACTION_ID_MAX = 64;\n\n/**\n * GA4 purchase events feed Google Ads conversions, whose transaction IDs are\n * capped at 64 characters — but Stripe checkout session ids exceed that:\n * around 2021 they grew from ~32 chars (`cs_live_` + 24 random chars) to ~66\n * (`cs_live_a` + 57), with no announcement. Stripe treats id length/format as\n * opaque and backwards-compatible, guaranteeing only that ids never exceed\n * 255 chars, so they may grow again at any time.\n *\n * Dropping the fixed `cs_live_`/`cs_test_` prefix brings the id under 64\n * while staying reversible: prepend the prefix (livemode tells which) to\n * reconstruct the full session id for Stripe dashboard lookups. The payment\n * intent id (~27 chars) is not a substitute — it only exists on\n * `mode: 'payment'` sessions (subscription-mode sessions carry it on the\n * invoice instead), and its short length is just as unguaranteed as the\n * session id's was.\n *\n * Must stay deterministic: GA4/Google Ads dedupe purchases by\n * transaction_id, and the same session may be tracked from multiple paths.\n */\nfunction toTransactionId(sessionId: string): string {\n  const stripped = sessionId.replace(/^cs_(live|test)_/, '');\n  if (stripped.length > GOOGLE_ADS_TRANSACTION_ID_MAX) {\n    console.warn(\n      `transaction_id still exceeds ${GOOGLE_ADS_TRANSACTION_ID_MAX} chars after stripping ` +\n        `the prefix — Stripe may have lengthened session ids again; truncating: ${sessionId}`\n    );\n  }\n  return stripped.slice(0, GOOGLE_ADS_TRANSACTION_ID_MAX);\n}\n\nexport function getPurchaseProperties(session: CheckoutSession): PurchaseProperties {\n  let value: number;\n  let currency: string;\n  if (!session.amount_total || !session.currency) {\n    value = session.line_items?.reduce((acc, item) => acc + item.amount_total, 0) ?? 0;\n    currency = session.line_items?.[0]?.currency ?? 'usd';\n  } else {\n    value = session.amount_total;\n    currency = session.currency;\n  }\n\n  return {\n    transaction_id: toTransactionId(session.id),\n    value: price(value, currency),\n    currency: currency.toUpperCase(),\n    coupon: session.coupon,\n    items: session.line_items?.map((item, index) => ({\n      index,\n      item_id: item.id,\n      item_name: item.description ?? '',\n      price: price(item.amount_total, item.currency),\n      quantity: item.quantity ?? 1,\n      discount: price(item.amount_discount, item.currency),\n    })),\n  };\n}\n\nexport function getBeginCheckoutProperties(p: ProductPrice): BeginCheckoutProperties {\n  return {\n    currency: p.currency.toUpperCase(),\n    value: price(p.unit_amount, p.currency),\n    items: [\n      {\n        item_id: p.product.id,\n        item_name: p.product.name,\n        price: price(p.unit_amount, p.currency),\n      },\n    ],\n  };\n}\n\n/**\n * Stripe's `cancellation_details` in the shared shape. The object is present on every\n * subscription with all three fields null, so an active one maps to null rather than an empty\n * record. `reason` says who acted: `cancellation_requested` is the customer (or us on their\n * behalf), the payment reasons are Stripe ending it.\n */\nexport function mapCancellationDetails(\n  subscription: Pick<Stripe.Subscription, 'cancellation_details'>\n): CancellationDetails | null {\n  const details = subscription.cancellation_details;\n  if (!details || (!details.reason && !details.feedback && !details.comment)) return null;\n  return {\n    initiator:\n      details.reason === 'payment_failed' || details.reason === 'payment_disputed'\n        ? 'system'\n        : 'user',\n    reason: details.reason ?? null,\n    // Stripe's feedback vocabulary is ours; anything it adds later is reported as \"other\".\n    feedback: details.feedback\n      ? (CANCELLATION_FEEDBACKS as readonly string[]).includes(details.feedback)\n        ? (details.feedback as CancellationFeedback)\n        : 'other'\n      : null,\n    comment: details.comment ?? null,\n  };\n}\n"],"mappings":"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"}

package/dist/subscription/index.cjs

@@ -6,6 +6,21 @@ const PLATFORMS = [
 	"STRIPE"
 ];
 /**
+* What a payment was for, on every platform.
+*
+* - ONE_TIME: a one-time purchase.
+* - SUBSCRIPTION_START: the first paid charge of a subscription.
+* - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.
+* - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or
+*   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.
+*/
+const PAYMENT_TYPES = [
+	"ONE_TIME",
+	"SUBSCRIPTION_START",
+	"SUBSCRIPTION_RENEWAL",
+	"SUBSCRIPTION_UPDATE"
+];
+/**
 * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)
 * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)
 *
@@ -59,6 +74,7 @@ const RESUBSCRIBE_INTENTS = [
 exports.AVAILABLE_STATUSES = AVAILABLE_STATUSES;
 exports.CANCELLATION_FEEDBACKS = CANCELLATION_FEEDBACKS;
 exports.CANCELLATION_INITIATORS = CANCELLATION_INITIATORS;
+exports.PAYMENT_TYPES = PAYMENT_TYPES;
 exports.PLATFORMS = PLATFORMS;
 exports.RESUBSCRIBE_INTENTS = RESUBSCRIBE_INTENTS;
 exports.SUBSCRIPTION_STATUSES = SUBSCRIPTION_STATUSES;

package/dist/subscription/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/subscription/index.ts"],"sourcesContent":["export const PLATFORMS = ['APPLE', 'GOOGLE', 'STRIPE'] as const;\n\nexport type Platform = (typeof PLATFORMS)[number];\n\n/**\n * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)\n * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)\n *\n * provision product for customer when Status = TRIALING, ACTIVE, IN_GRACE_PERIOD\n */\nexport const SUBSCRIPTION_STATUSES = [\n  /**\n   * The subscription is currently in a trial period and it’s safe to provision your product for\n   * your customer. The subscription transitions automatically to active when the first payment\n   * is made.\n   *\n   * Google: play(LineItems[0].OfferDetails.OfferId == 'xx')\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'TRIALING',\n\n  /**\n   * The subscription is in good standing and the most recent payment is successful. It’s safe to\n   * provision your product for your customer.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'ACTIVE',\n\n  /**\n   * Apple: The subscription enters the billing retry period. If the subtype is GRACE_PERIOD,\n   * continue to provide service through the grace period. If the subtype is empty, the\n   * subscription isn’t in a grace period and you can stop providing the subscription service.\n   *\n   * Google: Subscription is in grace period. The state is only available when the subscription\n   * is an auto renewing plan. In this state, all items are in grace period.\n   *\n   * Platform: Apple, Google\n   * */\n  'IN_GRACE_PERIOD',\n\n  /**\n   * A successful payment needs to be made within 23 hours to activate the subscription. Or the\n   * payment requires action, like customer authentication. Subscriptions can also be incomplete\n   * if there’s a pending payment and the PaymentIntent status would be processing.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE',\n\n  /**\n   * The initial payment on the subscription failed and no successful payment was made within 23\n   * hours of creating the subscription. These subscriptions don’t bill customers. This status\n   * exists so you can track customers that failed to activate their subscriptions.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE_EXPIRED',\n\n  /**\n   * Subscription was created but awaiting payment during signup. In this state, all items are\n   * awaiting payment.\n   *\n   * Platform: Google\n   * */\n  'PENDING',\n\n  /**\n   * Pending transaction for subscription is canceled. If this pending purchase was for an\n   * existing subscription, use linkedPurchaseToken to get the current state of that subscription.\n   *\n   * Platform: Google\n   * */\n  'PENDING_PURCHASE_CANCELED',\n\n  /**\n   * Payment on the latest finalized invoice either failed or wasn’t attempted. The subscription\n   * continues to create invoices. Your subscription settings determine the subscription’s next\n   * state. If the invoice is still unpaid after all Smart Retries have been attempted, you can\n   * configure the subscription to move to canceled, unpaid, or leave it as past_due. To move the\n   * subscription to active, pay the most recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'PAST_DUE',\n\n  /**\n   * Subscription is on hold (suspended). The state is only available when the subscription is an\n   * auto renewing plan. In this state, all items are on hold. Grace period ends or Active period\n   * ends but not grace period\n   *\n   * Platform: Google\n   * */\n  'ON_HOLD',\n\n  /**\n   * The subscription has been canceled. During cancellation, automatic collection for all unpaid\n   * invoices is disabled (auto_advance=false). This is a terminal state that can’t be updated.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'CANCELED',\n\n  /**\n   * The latest invoice hasn’t been paid but the subscription remains in place. The latest invoice\n   * remains open and invoices continue to be generated but payments aren’t attempted. You should\n   * revoke access to your product when the subscription is unpaid since payments were already\n   * attempted and retried when it was past_due. To move the subscription to active, pay the most\n   * recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'UNPAID',\n\n  /**\n   * Google: Subscription is paused. The state is only available when the subscription is an auto\n   * renewing plan. In this state, all items are in paused state.\n   *\n   * Stripe: The subscription has ended its trial period without a default payment method and the\n   * trial_settings.end_behavior.missing_payment_method is set to pause. Invoices will no longer\n   * be created for the subscription. After a default payment method has been attached to the\n   * customer, you can resume the subscription.\n   *\n   * Platform: Google, Stripe\n   * */\n  'PAUSED',\n\n  /**\n   * For example, a user buys a subscription and receives a purchase token A. The\n   * linkedPurchaseToken field will not be set in the API response because the purchase token\n   * belongs to a brand new subscription.\n   *\n   * If the user upgrades their subscription, a new purchase token B will be generated. Since the\n   * upgrade is replacing the subscription from purchase token A, the linkedPurchaseToken field\n   * for token B will be set to point to token A. Notice it points backwards in time to the\n   * original purchase token.\n   *\n   * +---------------------------+  +------------------------+  +------------------------+\n   * | Step 1 first purchase     |  | Step 2 upgrades        |  | Step 3 downgrades      |\n   * | purchaseToken: A          |->| purchaseToken: B       |->| purchaseToken: C       |\n   * | linkedPurchaseToken: null |  | linkedPurchaseToken: A |  | linkedPurchaseToken: B |\n   * +---------------------------+  +------------------------+  +------------------------+\n   *\n   * Platform: Google\n   * */\n  'REPLACED',\n\n  /**\n   * Google: Subscription is expired. All items have expiryTime in the past.\n   *\n   * Platform: Apple, Google\n   * */\n  'EXPIRED',\n] as const;\n\nexport type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];\n\n/** statuses where it is safe to provision your product for the customer */\nexport const AVAILABLE_STATUSES = [\n  'ACTIVE',\n  'TRIALING',\n  'IN_GRACE_PERIOD',\n] as const satisfies readonly SubscriptionStatus[];\n\n/** Who stopped the subscription from renewing. */\nexport const CANCELLATION_INITIATORS = [\n  /** The customer: the store's cancel flow, our own cancel dialog, or a declined price increase. */\n  'user',\n  /** The platform: a failed payment, a refund or revocation, a product no longer for sale. */\n  'system',\n  /** Us: a cancellation through the platform's API or console. */\n  'developer',\n] as const;\n\nexport type CancellationInitiator = (typeof CANCELLATION_INITIATORS)[number];\n\n/** What a cancel survey may report, whichever platform asked the question. */\nexport const CANCELLATION_FEEDBACKS = [\n  'customer_service',\n  'low_quality',\n  'missing_features',\n  'switched_service',\n  'too_complex',\n  'too_expensive',\n  'unused',\n  'other',\n] as const;\n\nexport type CancellationFeedback = (typeof CANCELLATION_FEEDBACKS)[number];\n\nexport const RESUBSCRIBE_INTENTS = ['maybe', 'no', 'yes'] as const;\n\nexport type ResubscribeIntent = (typeof RESUBSCRIBE_INTENTS)[number];\n\n/**\n * Why a subscription stopped renewing, in one record shared by every platform. Every key is\n * optional and every value a string, so a platform may add what only it reports without a\n * schema change; the keys below are the ones they have in common. When the subscription was\n * cancelled is not in here: it is a column of its own, `canceledAt`.\n *\n * - `initiator`: see {@link CANCELLATION_INITIATORS}.\n * - `reason`: the platform's own code, kept verbatim for analytics — Stripe's\n *   `cancellation_details.reason`, Google's `cancelSurveyResult.reason`, Apple's notification\n *   subtype or `expirationIntent`.\n * - `feedback`: the customer's survey answer in the shared vocabulary {@link CANCELLATION_FEEDBACKS}.\n * - `comment`: free text the customer typed.\n * - `resubscribeIntent`: whether they said they would come back, when the cancel flow asked.\n */\nexport interface CancellationDetails {\n  [key: string]: string | null | undefined;\n  initiator?: CancellationInitiator | null;\n  reason?: string | null;\n  feedback?: CancellationFeedback | null;\n  comment?: string | null;\n  resubscribeIntent?: ResubscribeIntent | null;\n}\n"],"mappings":";;AAAA,MAAa,YAAY;CAAC;CAAS;CAAU;AAAQ;;;;;;;AAUrD,MAAa,wBAAwB;CAUnC;CAQA;CAYA;CASA;CASA;CAQA;CAQA;CAWA;CASA;CAQA;CAWA;CAaA;CAoBA;CAOA;AACF;;AAKA,MAAa,qBAAqB;CAChC;CACA;CACA;AACF;;AAGA,MAAa,0BAA0B;CAErC;CAEA;CAEA;AACF;;AAKA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,MAAa,sBAAsB;CAAC;CAAS;CAAM;AAAK"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/subscription/index.ts"],"sourcesContent":["export const PLATFORMS = ['APPLE', 'GOOGLE', 'STRIPE'] as const;\n\nexport type Platform = (typeof PLATFORMS)[number];\n\n/**\n * What a payment was for, on every platform.\n *\n * - ONE_TIME: a one-time purchase.\n * - SUBSCRIPTION_START: the first paid charge of a subscription.\n * - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.\n * - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or\n *   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.\n */\nexport const PAYMENT_TYPES = [\n  'ONE_TIME',\n  'SUBSCRIPTION_START',\n  'SUBSCRIPTION_RENEWAL',\n  'SUBSCRIPTION_UPDATE',\n] as const;\n\nexport type PaymentType = (typeof PAYMENT_TYPES)[number];\n\n/**\n * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)\n * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)\n *\n * provision product for customer when Status = TRIALING, ACTIVE, IN_GRACE_PERIOD\n */\nexport const SUBSCRIPTION_STATUSES = [\n  /**\n   * The subscription is currently in a trial period and it’s safe to provision your product for\n   * your customer. The subscription transitions automatically to active when the first payment\n   * is made.\n   *\n   * Google: play(LineItems[0].OfferDetails.OfferId == 'xx')\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'TRIALING',\n\n  /**\n   * The subscription is in good standing and the most recent payment is successful. It’s safe to\n   * provision your product for your customer.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'ACTIVE',\n\n  /**\n   * Apple: The subscription enters the billing retry period. If the subtype is GRACE_PERIOD,\n   * continue to provide service through the grace period. If the subtype is empty, the\n   * subscription isn’t in a grace period and you can stop providing the subscription service.\n   *\n   * Google: Subscription is in grace period. The state is only available when the subscription\n   * is an auto renewing plan. In this state, all items are in grace period.\n   *\n   * Platform: Apple, Google\n   * */\n  'IN_GRACE_PERIOD',\n\n  /**\n   * A successful payment needs to be made within 23 hours to activate the subscription. Or the\n   * payment requires action, like customer authentication. Subscriptions can also be incomplete\n   * if there’s a pending payment and the PaymentIntent status would be processing.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE',\n\n  /**\n   * The initial payment on the subscription failed and no successful payment was made within 23\n   * hours of creating the subscription. These subscriptions don’t bill customers. This status\n   * exists so you can track customers that failed to activate their subscriptions.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE_EXPIRED',\n\n  /**\n   * Subscription was created but awaiting payment during signup. In this state, all items are\n   * awaiting payment.\n   *\n   * Platform: Google\n   * */\n  'PENDING',\n\n  /**\n   * Pending transaction for subscription is canceled. If this pending purchase was for an\n   * existing subscription, use linkedPurchaseToken to get the current state of that subscription.\n   *\n   * Platform: Google\n   * */\n  'PENDING_PURCHASE_CANCELED',\n\n  /**\n   * Payment on the latest finalized invoice either failed or wasn’t attempted. The subscription\n   * continues to create invoices. Your subscription settings determine the subscription’s next\n   * state. If the invoice is still unpaid after all Smart Retries have been attempted, you can\n   * configure the subscription to move to canceled, unpaid, or leave it as past_due. To move the\n   * subscription to active, pay the most recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'PAST_DUE',\n\n  /**\n   * Subscription is on hold (suspended). The state is only available when the subscription is an\n   * auto renewing plan. In this state, all items are on hold. Grace period ends or Active period\n   * ends but not grace period\n   *\n   * Platform: Google\n   * */\n  'ON_HOLD',\n\n  /**\n   * The subscription has been canceled. During cancellation, automatic collection for all unpaid\n   * invoices is disabled (auto_advance=false). This is a terminal state that can’t be updated.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'CANCELED',\n\n  /**\n   * The latest invoice hasn’t been paid but the subscription remains in place. The latest invoice\n   * remains open and invoices continue to be generated but payments aren’t attempted. You should\n   * revoke access to your product when the subscription is unpaid since payments were already\n   * attempted and retried when it was past_due. To move the subscription to active, pay the most\n   * recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'UNPAID',\n\n  /**\n   * Google: Subscription is paused. The state is only available when the subscription is an auto\n   * renewing plan. In this state, all items are in paused state.\n   *\n   * Stripe: The subscription has ended its trial period without a default payment method and the\n   * trial_settings.end_behavior.missing_payment_method is set to pause. Invoices will no longer\n   * be created for the subscription. After a default payment method has been attached to the\n   * customer, you can resume the subscription.\n   *\n   * Platform: Google, Stripe\n   * */\n  'PAUSED',\n\n  /**\n   * For example, a user buys a subscription and receives a purchase token A. The\n   * linkedPurchaseToken field will not be set in the API response because the purchase token\n   * belongs to a brand new subscription.\n   *\n   * If the user upgrades their subscription, a new purchase token B will be generated. Since the\n   * upgrade is replacing the subscription from purchase token A, the linkedPurchaseToken field\n   * for token B will be set to point to token A. Notice it points backwards in time to the\n   * original purchase token.\n   *\n   * +---------------------------+  +------------------------+  +------------------------+\n   * | Step 1 first purchase     |  | Step 2 upgrades        |  | Step 3 downgrades      |\n   * | purchaseToken: A          |->| purchaseToken: B       |->| purchaseToken: C       |\n   * | linkedPurchaseToken: null |  | linkedPurchaseToken: A |  | linkedPurchaseToken: B |\n   * +---------------------------+  +------------------------+  +------------------------+\n   *\n   * Platform: Google\n   * */\n  'REPLACED',\n\n  /**\n   * Google: Subscription is expired. All items have expiryTime in the past.\n   *\n   * Platform: Apple, Google\n   * */\n  'EXPIRED',\n] as const;\n\nexport type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];\n\n/** statuses where it is safe to provision your product for the customer */\nexport const AVAILABLE_STATUSES = [\n  'ACTIVE',\n  'TRIALING',\n  'IN_GRACE_PERIOD',\n] as const satisfies readonly SubscriptionStatus[];\n\n/** Who stopped the subscription from renewing. */\nexport const CANCELLATION_INITIATORS = [\n  /** The customer: the store's cancel flow, our own cancel dialog, or a declined price increase. */\n  'user',\n  /** The platform: a failed payment, a refund or revocation, a product no longer for sale. */\n  'system',\n  /** Us: a cancellation through the platform's API or console. */\n  'developer',\n] as const;\n\nexport type CancellationInitiator = (typeof CANCELLATION_INITIATORS)[number];\n\n/** What a cancel survey may report, whichever platform asked the question. */\nexport const CANCELLATION_FEEDBACKS = [\n  'customer_service',\n  'low_quality',\n  'missing_features',\n  'switched_service',\n  'too_complex',\n  'too_expensive',\n  'unused',\n  'other',\n] as const;\n\nexport type CancellationFeedback = (typeof CANCELLATION_FEEDBACKS)[number];\n\nexport const RESUBSCRIBE_INTENTS = ['maybe', 'no', 'yes'] as const;\n\nexport type ResubscribeIntent = (typeof RESUBSCRIBE_INTENTS)[number];\n\n/**\n * Why a subscription stopped renewing, in one record shared by every platform. Every key is\n * optional and every value a string, so a platform may add what only it reports without a\n * schema change; the keys below are the ones they have in common. When the subscription was\n * cancelled is not in here: it is a column of its own, `canceledAt`.\n *\n * - `initiator`: see {@link CANCELLATION_INITIATORS}.\n * - `reason`: the platform's own code, kept verbatim for analytics — Stripe's\n *   `cancellation_details.reason`, Google's `cancelSurveyResult.reason`, Apple's notification\n *   subtype or `expirationIntent`.\n * - `feedback`: the customer's survey answer in the shared vocabulary {@link CANCELLATION_FEEDBACKS}.\n * - `comment`: free text the customer typed.\n * - `resubscribeIntent`: whether they said they would come back, when the cancel flow asked.\n */\nexport interface CancellationDetails {\n  [key: string]: string | null | undefined;\n  initiator?: CancellationInitiator | null;\n  reason?: string | null;\n  feedback?: CancellationFeedback | null;\n  comment?: string | null;\n  resubscribeIntent?: ResubscribeIntent | null;\n}\n"],"mappings":";;AAAA,MAAa,YAAY;CAAC;CAAS;CAAU;AAAQ;;;;;;;;;;AAarD,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;AACF;;;;;;;AAUA,MAAa,wBAAwB;CAUnC;CAQA;CAYA;CASA;CASA;CAQA;CAQA;CAWA;CASA;CAQA;CAWA;CAaA;CAoBA;CAOA;AACF;;AAKA,MAAa,qBAAqB;CAChC;CACA;CACA;AACF;;AAGA,MAAa,0BAA0B;CAErC;CAEA;CAEA;AACF;;AAKA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,MAAa,sBAAsB;CAAC;CAAS;CAAM;AAAK"}

package/dist/subscription/index.d.cts

@@ -1,6 +1,17 @@
 //#region src/subscription/index.d.ts
 export declare const PLATFORMS: readonly ['APPLE', 'GOOGLE', 'STRIPE'];
 export type Platform = (typeof PLATFORMS)[number];
+/**
+ * What a payment was for, on every platform.
+ *
+ * - ONE_TIME: a one-time purchase.
+ * - SUBSCRIPTION_START: the first paid charge of a subscription.
+ * - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.
+ * - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or
+ *   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.
+ */
+export declare const PAYMENT_TYPES: readonly ['ONE_TIME', 'SUBSCRIPTION_START', 'SUBSCRIPTION_RENEWAL', 'SUBSCRIPTION_UPDATE'];
+export type PaymentType = (typeof PAYMENT_TYPES)[number];
 /**
  * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)
  * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)

package/dist/subscription/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscription/index.ts"],"mappings":";qBAAa;YAED,mBAAmB;;;;;;;qBAQlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkJD,6BAA6B;;qBAG5B;;qBAOA;;;;;;;YASD,gCAAgC;;qBAG/B;YAWD,+BAA+B;qBAE9B;YAED,4BAA4B;;;;;;;;;;;;;;;iBAgBvB;GACd;EACD,YAAY;EACZ;EACA,WAAW;EACX;EACA,oBAAoB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscription/index.ts"],"mappings":";qBAAa;YAED,mBAAmB;;;;;;;;;;qBAWlB;YAOD,sBAAsB;;;;;;;qBAQrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkJD,6BAA6B;;qBAG5B;;qBAOA;;;;;;;YASD,gCAAgC;;qBAG/B;YAWD,+BAA+B;qBAE9B;YAED,4BAA4B;;;;;;;;;;;;;;;iBAgBvB;GACd;EACD,YAAY;EACZ;EACA,WAAW;EACX;EACA,oBAAoB"}

package/dist/subscription/index.d.mts

@@ -1,6 +1,17 @@
 //#region src/subscription/index.d.ts
 export declare const PLATFORMS: readonly ['APPLE', 'GOOGLE', 'STRIPE'];
 export type Platform = (typeof PLATFORMS)[number];
+/**
+ * What a payment was for, on every platform.
+ *
+ * - ONE_TIME: a one-time purchase.
+ * - SUBSCRIPTION_START: the first paid charge of a subscription.
+ * - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.
+ * - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or
+ *   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.
+ */
+export declare const PAYMENT_TYPES: readonly ['ONE_TIME', 'SUBSCRIPTION_START', 'SUBSCRIPTION_RENEWAL', 'SUBSCRIPTION_UPDATE'];
+export type PaymentType = (typeof PAYMENT_TYPES)[number];
 /**
  * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)
  * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)

package/dist/subscription/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscription/index.ts"],"mappings":";qBAAa;YAED,mBAAmB;;;;;;;qBAQlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkJD,6BAA6B;;qBAG5B;;qBAOA;;;;;;;YASD,gCAAgC;;qBAG/B;YAWD,+BAA+B;qBAE9B;YAED,4BAA4B;;;;;;;;;;;;;;;iBAgBvB;GACd;EACD,YAAY;EACZ;EACA,WAAW;EACX;EACA,oBAAoB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscription/index.ts"],"mappings":";qBAAa;YAED,mBAAmB;;;;;;;;;;qBAWlB;YAOD,sBAAsB;;;;;;;qBAQrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkJD,6BAA6B;;qBAG5B;;qBAOA;;;;;;;YASD,gCAAgC;;qBAG/B;YAWD,+BAA+B;qBAE9B;YAED,4BAA4B;;;;;;;;;;;;;;;iBAgBvB;GACd;EACD,YAAY;EACZ;EACA,WAAW;EACX;EACA,oBAAoB"}

package/dist/subscription/index.mjs

@@ -5,6 +5,21 @@ const PLATFORMS = [
 	"STRIPE"
 ];
 /**
+* What a payment was for, on every platform.
+*
+* - ONE_TIME: a one-time purchase.
+* - SUBSCRIPTION_START: the first paid charge of a subscription.
+* - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.
+* - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or
+*   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.
+*/
+const PAYMENT_TYPES = [
+	"ONE_TIME",
+	"SUBSCRIPTION_START",
+	"SUBSCRIPTION_RENEWAL",
+	"SUBSCRIPTION_UPDATE"
+];
+/**
 * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)
 * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)
 *
@@ -55,6 +70,6 @@ const RESUBSCRIBE_INTENTS = [
 	"yes"
 ];
 //#endregion
-export { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES };
+export { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, PAYMENT_TYPES, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES };
 
 //# sourceMappingURL=index.mjs.map

package/dist/subscription/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscription/index.ts"],"sourcesContent":["export const PLATFORMS = ['APPLE', 'GOOGLE', 'STRIPE'] as const;\n\nexport type Platform = (typeof PLATFORMS)[number];\n\n/**\n * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)\n * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)\n *\n * provision product for customer when Status = TRIALING, ACTIVE, IN_GRACE_PERIOD\n */\nexport const SUBSCRIPTION_STATUSES = [\n  /**\n   * The subscription is currently in a trial period and it’s safe to provision your product for\n   * your customer. The subscription transitions automatically to active when the first payment\n   * is made.\n   *\n   * Google: play(LineItems[0].OfferDetails.OfferId == 'xx')\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'TRIALING',\n\n  /**\n   * The subscription is in good standing and the most recent payment is successful. It’s safe to\n   * provision your product for your customer.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'ACTIVE',\n\n  /**\n   * Apple: The subscription enters the billing retry period. If the subtype is GRACE_PERIOD,\n   * continue to provide service through the grace period. If the subtype is empty, the\n   * subscription isn’t in a grace period and you can stop providing the subscription service.\n   *\n   * Google: Subscription is in grace period. The state is only available when the subscription\n   * is an auto renewing plan. In this state, all items are in grace period.\n   *\n   * Platform: Apple, Google\n   * */\n  'IN_GRACE_PERIOD',\n\n  /**\n   * A successful payment needs to be made within 23 hours to activate the subscription. Or the\n   * payment requires action, like customer authentication. Subscriptions can also be incomplete\n   * if there’s a pending payment and the PaymentIntent status would be processing.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE',\n\n  /**\n   * The initial payment on the subscription failed and no successful payment was made within 23\n   * hours of creating the subscription. These subscriptions don’t bill customers. This status\n   * exists so you can track customers that failed to activate their subscriptions.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE_EXPIRED',\n\n  /**\n   * Subscription was created but awaiting payment during signup. In this state, all items are\n   * awaiting payment.\n   *\n   * Platform: Google\n   * */\n  'PENDING',\n\n  /**\n   * Pending transaction for subscription is canceled. If this pending purchase was for an\n   * existing subscription, use linkedPurchaseToken to get the current state of that subscription.\n   *\n   * Platform: Google\n   * */\n  'PENDING_PURCHASE_CANCELED',\n\n  /**\n   * Payment on the latest finalized invoice either failed or wasn’t attempted. The subscription\n   * continues to create invoices. Your subscription settings determine the subscription’s next\n   * state. If the invoice is still unpaid after all Smart Retries have been attempted, you can\n   * configure the subscription to move to canceled, unpaid, or leave it as past_due. To move the\n   * subscription to active, pay the most recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'PAST_DUE',\n\n  /**\n   * Subscription is on hold (suspended). The state is only available when the subscription is an\n   * auto renewing plan. In this state, all items are on hold. Grace period ends or Active period\n   * ends but not grace period\n   *\n   * Platform: Google\n   * */\n  'ON_HOLD',\n\n  /**\n   * The subscription has been canceled. During cancellation, automatic collection for all unpaid\n   * invoices is disabled (auto_advance=false). This is a terminal state that can’t be updated.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'CANCELED',\n\n  /**\n   * The latest invoice hasn’t been paid but the subscription remains in place. The latest invoice\n   * remains open and invoices continue to be generated but payments aren’t attempted. You should\n   * revoke access to your product when the subscription is unpaid since payments were already\n   * attempted and retried when it was past_due. To move the subscription to active, pay the most\n   * recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'UNPAID',\n\n  /**\n   * Google: Subscription is paused. The state is only available when the subscription is an auto\n   * renewing plan. In this state, all items are in paused state.\n   *\n   * Stripe: The subscription has ended its trial period without a default payment method and the\n   * trial_settings.end_behavior.missing_payment_method is set to pause. Invoices will no longer\n   * be created for the subscription. After a default payment method has been attached to the\n   * customer, you can resume the subscription.\n   *\n   * Platform: Google, Stripe\n   * */\n  'PAUSED',\n\n  /**\n   * For example, a user buys a subscription and receives a purchase token A. The\n   * linkedPurchaseToken field will not be set in the API response because the purchase token\n   * belongs to a brand new subscription.\n   *\n   * If the user upgrades their subscription, a new purchase token B will be generated. Since the\n   * upgrade is replacing the subscription from purchase token A, the linkedPurchaseToken field\n   * for token B will be set to point to token A. Notice it points backwards in time to the\n   * original purchase token.\n   *\n   * +---------------------------+  +------------------------+  +------------------------+\n   * | Step 1 first purchase     |  | Step 2 upgrades        |  | Step 3 downgrades      |\n   * | purchaseToken: A          |->| purchaseToken: B       |->| purchaseToken: C       |\n   * | linkedPurchaseToken: null |  | linkedPurchaseToken: A |  | linkedPurchaseToken: B |\n   * +---------------------------+  +------------------------+  +------------------------+\n   *\n   * Platform: Google\n   * */\n  'REPLACED',\n\n  /**\n   * Google: Subscription is expired. All items have expiryTime in the past.\n   *\n   * Platform: Apple, Google\n   * */\n  'EXPIRED',\n] as const;\n\nexport type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];\n\n/** statuses where it is safe to provision your product for the customer */\nexport const AVAILABLE_STATUSES = [\n  'ACTIVE',\n  'TRIALING',\n  'IN_GRACE_PERIOD',\n] as const satisfies readonly SubscriptionStatus[];\n\n/** Who stopped the subscription from renewing. */\nexport const CANCELLATION_INITIATORS = [\n  /** The customer: the store's cancel flow, our own cancel dialog, or a declined price increase. */\n  'user',\n  /** The platform: a failed payment, a refund or revocation, a product no longer for sale. */\n  'system',\n  /** Us: a cancellation through the platform's API or console. */\n  'developer',\n] as const;\n\nexport type CancellationInitiator = (typeof CANCELLATION_INITIATORS)[number];\n\n/** What a cancel survey may report, whichever platform asked the question. */\nexport const CANCELLATION_FEEDBACKS = [\n  'customer_service',\n  'low_quality',\n  'missing_features',\n  'switched_service',\n  'too_complex',\n  'too_expensive',\n  'unused',\n  'other',\n] as const;\n\nexport type CancellationFeedback = (typeof CANCELLATION_FEEDBACKS)[number];\n\nexport const RESUBSCRIBE_INTENTS = ['maybe', 'no', 'yes'] as const;\n\nexport type ResubscribeIntent = (typeof RESUBSCRIBE_INTENTS)[number];\n\n/**\n * Why a subscription stopped renewing, in one record shared by every platform. Every key is\n * optional and every value a string, so a platform may add what only it reports without a\n * schema change; the keys below are the ones they have in common. When the subscription was\n * cancelled is not in here: it is a column of its own, `canceledAt`.\n *\n * - `initiator`: see {@link CANCELLATION_INITIATORS}.\n * - `reason`: the platform's own code, kept verbatim for analytics — Stripe's\n *   `cancellation_details.reason`, Google's `cancelSurveyResult.reason`, Apple's notification\n *   subtype or `expirationIntent`.\n * - `feedback`: the customer's survey answer in the shared vocabulary {@link CANCELLATION_FEEDBACKS}.\n * - `comment`: free text the customer typed.\n * - `resubscribeIntent`: whether they said they would come back, when the cancel flow asked.\n */\nexport interface CancellationDetails {\n  [key: string]: string | null | undefined;\n  initiator?: CancellationInitiator | null;\n  reason?: string | null;\n  feedback?: CancellationFeedback | null;\n  comment?: string | null;\n  resubscribeIntent?: ResubscribeIntent | null;\n}\n"],"mappings":";AAAA,MAAa,YAAY;CAAC;CAAS;CAAU;AAAQ;;;;;;;AAUrD,MAAa,wBAAwB;CAUnC;CAQA;CAYA;CASA;CASA;CAQA;CAQA;CAWA;CASA;CAQA;CAWA;CAaA;CAoBA;CAOA;AACF;;AAKA,MAAa,qBAAqB;CAChC;CACA;CACA;AACF;;AAGA,MAAa,0BAA0B;CAErC;CAEA;CAEA;AACF;;AAKA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,MAAa,sBAAsB;CAAC;CAAS;CAAM;AAAK"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscription/index.ts"],"sourcesContent":["export const PLATFORMS = ['APPLE', 'GOOGLE', 'STRIPE'] as const;\n\nexport type Platform = (typeof PLATFORMS)[number];\n\n/**\n * What a payment was for, on every platform.\n *\n * - ONE_TIME: a one-time purchase.\n * - SUBSCRIPTION_START: the first paid charge of a subscription.\n * - SUBSCRIPTION_RENEWAL: a charge for a new billing period on the regular cycle.\n * - SUBSCRIPTION_UPDATE: a charge mid-period, outside the cycle: the proration of a plan change, or\n *   a manual invoice on the subscription. Kept apart from renewals so renewal rates stay honest.\n */\nexport const PAYMENT_TYPES = [\n  'ONE_TIME',\n  'SUBSCRIPTION_START',\n  'SUBSCRIPTION_RENEWAL',\n  'SUBSCRIPTION_UPDATE',\n] as const;\n\nexport type PaymentType = (typeof PAYMENT_TYPES)[number];\n\n/**\n * [Stripe Subscription Status](https://stripe.com/docs/api/subscriptions/object#subscription_object-status)\n * [Stripe Subscription Lifecycle](https://docs.stripe.com/billing/subscriptions/overview)\n *\n * provision product for customer when Status = TRIALING, ACTIVE, IN_GRACE_PERIOD\n */\nexport const SUBSCRIPTION_STATUSES = [\n  /**\n   * The subscription is currently in a trial period and it’s safe to provision your product for\n   * your customer. The subscription transitions automatically to active when the first payment\n   * is made.\n   *\n   * Google: play(LineItems[0].OfferDetails.OfferId == 'xx')\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'TRIALING',\n\n  /**\n   * The subscription is in good standing and the most recent payment is successful. It’s safe to\n   * provision your product for your customer.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'ACTIVE',\n\n  /**\n   * Apple: The subscription enters the billing retry period. If the subtype is GRACE_PERIOD,\n   * continue to provide service through the grace period. If the subtype is empty, the\n   * subscription isn’t in a grace period and you can stop providing the subscription service.\n   *\n   * Google: Subscription is in grace period. The state is only available when the subscription\n   * is an auto renewing plan. In this state, all items are in grace period.\n   *\n   * Platform: Apple, Google\n   * */\n  'IN_GRACE_PERIOD',\n\n  /**\n   * A successful payment needs to be made within 23 hours to activate the subscription. Or the\n   * payment requires action, like customer authentication. Subscriptions can also be incomplete\n   * if there’s a pending payment and the PaymentIntent status would be processing.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE',\n\n  /**\n   * The initial payment on the subscription failed and no successful payment was made within 23\n   * hours of creating the subscription. These subscriptions don’t bill customers. This status\n   * exists so you can track customers that failed to activate their subscriptions.\n   *\n   * Platform: Stripe\n   * */\n  'INCOMPLETE_EXPIRED',\n\n  /**\n   * Subscription was created but awaiting payment during signup. In this state, all items are\n   * awaiting payment.\n   *\n   * Platform: Google\n   * */\n  'PENDING',\n\n  /**\n   * Pending transaction for subscription is canceled. If this pending purchase was for an\n   * existing subscription, use linkedPurchaseToken to get the current state of that subscription.\n   *\n   * Platform: Google\n   * */\n  'PENDING_PURCHASE_CANCELED',\n\n  /**\n   * Payment on the latest finalized invoice either failed or wasn’t attempted. The subscription\n   * continues to create invoices. Your subscription settings determine the subscription’s next\n   * state. If the invoice is still unpaid after all Smart Retries have been attempted, you can\n   * configure the subscription to move to canceled, unpaid, or leave it as past_due. To move the\n   * subscription to active, pay the most recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'PAST_DUE',\n\n  /**\n   * Subscription is on hold (suspended). The state is only available when the subscription is an\n   * auto renewing plan. In this state, all items are on hold. Grace period ends or Active period\n   * ends but not grace period\n   *\n   * Platform: Google\n   * */\n  'ON_HOLD',\n\n  /**\n   * The subscription has been canceled. During cancellation, automatic collection for all unpaid\n   * invoices is disabled (auto_advance=false). This is a terminal state that can’t be updated.\n   *\n   * Platform: Apple, Google, Stripe\n   * */\n  'CANCELED',\n\n  /**\n   * The latest invoice hasn’t been paid but the subscription remains in place. The latest invoice\n   * remains open and invoices continue to be generated but payments aren’t attempted. You should\n   * revoke access to your product when the subscription is unpaid since payments were already\n   * attempted and retried when it was past_due. To move the subscription to active, pay the most\n   * recent invoice before its due date.\n   *\n   * Platform: Stripe\n   * */\n  'UNPAID',\n\n  /**\n   * Google: Subscription is paused. The state is only available when the subscription is an auto\n   * renewing plan. In this state, all items are in paused state.\n   *\n   * Stripe: The subscription has ended its trial period without a default payment method and the\n   * trial_settings.end_behavior.missing_payment_method is set to pause. Invoices will no longer\n   * be created for the subscription. After a default payment method has been attached to the\n   * customer, you can resume the subscription.\n   *\n   * Platform: Google, Stripe\n   * */\n  'PAUSED',\n\n  /**\n   * For example, a user buys a subscription and receives a purchase token A. The\n   * linkedPurchaseToken field will not be set in the API response because the purchase token\n   * belongs to a brand new subscription.\n   *\n   * If the user upgrades their subscription, a new purchase token B will be generated. Since the\n   * upgrade is replacing the subscription from purchase token A, the linkedPurchaseToken field\n   * for token B will be set to point to token A. Notice it points backwards in time to the\n   * original purchase token.\n   *\n   * +---------------------------+  +------------------------+  +------------------------+\n   * | Step 1 first purchase     |  | Step 2 upgrades        |  | Step 3 downgrades      |\n   * | purchaseToken: A          |->| purchaseToken: B       |->| purchaseToken: C       |\n   * | linkedPurchaseToken: null |  | linkedPurchaseToken: A |  | linkedPurchaseToken: B |\n   * +---------------------------+  +------------------------+  +------------------------+\n   *\n   * Platform: Google\n   * */\n  'REPLACED',\n\n  /**\n   * Google: Subscription is expired. All items have expiryTime in the past.\n   *\n   * Platform: Apple, Google\n   * */\n  'EXPIRED',\n] as const;\n\nexport type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];\n\n/** statuses where it is safe to provision your product for the customer */\nexport const AVAILABLE_STATUSES = [\n  'ACTIVE',\n  'TRIALING',\n  'IN_GRACE_PERIOD',\n] as const satisfies readonly SubscriptionStatus[];\n\n/** Who stopped the subscription from renewing. */\nexport const CANCELLATION_INITIATORS = [\n  /** The customer: the store's cancel flow, our own cancel dialog, or a declined price increase. */\n  'user',\n  /** The platform: a failed payment, a refund or revocation, a product no longer for sale. */\n  'system',\n  /** Us: a cancellation through the platform's API or console. */\n  'developer',\n] as const;\n\nexport type CancellationInitiator = (typeof CANCELLATION_INITIATORS)[number];\n\n/** What a cancel survey may report, whichever platform asked the question. */\nexport const CANCELLATION_FEEDBACKS = [\n  'customer_service',\n  'low_quality',\n  'missing_features',\n  'switched_service',\n  'too_complex',\n  'too_expensive',\n  'unused',\n  'other',\n] as const;\n\nexport type CancellationFeedback = (typeof CANCELLATION_FEEDBACKS)[number];\n\nexport const RESUBSCRIBE_INTENTS = ['maybe', 'no', 'yes'] as const;\n\nexport type ResubscribeIntent = (typeof RESUBSCRIBE_INTENTS)[number];\n\n/**\n * Why a subscription stopped renewing, in one record shared by every platform. Every key is\n * optional and every value a string, so a platform may add what only it reports without a\n * schema change; the keys below are the ones they have in common. When the subscription was\n * cancelled is not in here: it is a column of its own, `canceledAt`.\n *\n * - `initiator`: see {@link CANCELLATION_INITIATORS}.\n * - `reason`: the platform's own code, kept verbatim for analytics — Stripe's\n *   `cancellation_details.reason`, Google's `cancelSurveyResult.reason`, Apple's notification\n *   subtype or `expirationIntent`.\n * - `feedback`: the customer's survey answer in the shared vocabulary {@link CANCELLATION_FEEDBACKS}.\n * - `comment`: free text the customer typed.\n * - `resubscribeIntent`: whether they said they would come back, when the cancel flow asked.\n */\nexport interface CancellationDetails {\n  [key: string]: string | null | undefined;\n  initiator?: CancellationInitiator | null;\n  reason?: string | null;\n  feedback?: CancellationFeedback | null;\n  comment?: string | null;\n  resubscribeIntent?: ResubscribeIntent | null;\n}\n"],"mappings":";AAAA,MAAa,YAAY;CAAC;CAAS;CAAU;AAAQ;;;;;;;;;;AAarD,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;AACF;;;;;;;AAUA,MAAa,wBAAwB;CAUnC;CAQA;CAYA;CASA;CASA;CAQA;CAQA;CAWA;CASA;CAQA;CAWA;CAaA;CAoBA;CAOA;AACF;;AAKA,MAAa,qBAAqB;CAChC;CACA;CACA;AACF;;AAGA,MAAa,0BAA0B;CAErC;CAEA;CAEA;AACF;;AAKA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,MAAa,sBAAsB;CAAC;CAAS;CAAM;AAAK"}

package/package.json

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