@shware/purchase 7.5.0 → 8.0.0

package/README.md

@@ -63,19 +63,24 @@ const entitled = (AVAILABLE_STATUSES as readonly SubscriptionStatus[]).includes(
 
 ## Product catalogs
 
-Each config is built with a fluent, type-checked chain. Type parameters are the product id
-namespace, your plan type and your billing period type; product ids must start with the namespace,
-and duplicate products or plan/period pairs fail at compile time and at runtime. Credit metadata
+Each config is built with a fluent, type-checked chain. Every config takes the product id
+`namespace`, your `plans` (lowest tier first) and your `billingPeriods` (shortest first), and infers
+its types from them, so no type arguments are needed; a config with no subscriptions passes empty
+arrays. Product ids must start with the namespace, plans and periods must be declared ones, and
+duplicate products or plan/period pairs fail at compile time and at runtime. Credit metadata
 is `{ credits: number; expiresIn: string }` where `expiresIn` is an
 [`ms`](https://github.com/vercel/ms) duration.
 
 ```ts
-import { AppStoreConfig, GooglePlayConfig, StripeConfig } from '@shware/purchase';
+import { defineAppStoreConfig, defineGooglePlayConfig, defineStripeConfig } from '@shware/purchase';
 
-type Plan = 'STARTER' | 'PRO';
-type BillingPeriod = 'MONTHLY' | 'YEARLY';
+const PLANS = ['STARTER', 'PRO'] as const;
+const BILLING_PERIODS = ['MONTHLY', 'YEARLY'] as const;
 
-export const stripe = StripeConfig.create<'com.example.stripe', Plan, BillingPeriod>({
+export const stripe = defineStripeConfig({
+  namespace: 'com.example.stripe',
+  plans: PLANS,
+  billingPeriods: BILLING_PERIODS,
   mode: env.STRIPE_SECRET_KEY.startsWith('sk_test_') ? 'test' : 'live',
   allowPromotionCodes: false,
   cancellationCouponId: 'retention_30pct_3mo',
@@ -93,7 +98,10 @@ export const stripe = StripeConfig.create<'com.example.stripe', Plan, BillingPer
   .price('price_live_starter_v1', { credits: 100, expiresIn: '30 days' }) // grandfathered
   .default('price_live_starter_v2', { test: 'price_test_starter' });
 
-export const appStore = AppStoreConfig.create<'com.example.appstore', Plan, BillingPeriod>({
+export const appStore = defineAppStoreConfig({
+  namespace: 'com.example.appstore',
+  plans: PLANS,
+  billingPeriods: BILLING_PERIODS,
   appId: '1234567890',
   bundleId: 'com.example.app',
 })
@@ -102,7 +110,10 @@ export const appStore = AppStoreConfig.create<'com.example.appstore', Plan, Bill
   .product('com.example.appstore.sub.monthly.starter.v1', { credits: 100, expiresIn: '30d' })
   .default('com.example.appstore.sub.monthly.starter.v1');
 
-export const googlePlay = GooglePlayConfig.create<'com.example.googleplay', Plan, BillingPeriod>({
+export const googlePlay = defineGooglePlayConfig({
+  namespace: 'com.example.googleplay',
+  plans: PLANS,
+  billingPeriods: BILLING_PERIODS,
   package: 'com.example.app',
   audience: 'api.example.com', // expected audience of the RTDN push OIDC token
 })
@@ -115,11 +126,11 @@ export const googlePlay = GooglePlayConfig.create<'com.example.googleplay', Plan
 
 Lookups:
 
-| Config             | Methods                                                                                                                                                                                                       |
-| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `StripeConfig`     | `productIds`, `getPriceId(productId)`, `getPlan`, `getBillingPeriod`, `getMode`, `getCreditAmount(productId, priceId?)`, `getCreditExpiresAt(productId, priceId?)`                                            |
-| `AppStoreConfig`   | `productIds`, `getDefaultProductId(plan, billingPeriod)`, `getPlan`, `getBillingPeriod`, `getMode`, `getCreditAmount`, `getCreditExpiresAt`                                                                   |
-| `GooglePlayConfig` | `productIds`, `getDefaultPlanIds(productId)`, `getPlan(productId, planId)`, `getBillingPeriod(productId, planId)`, `getMode`, `getCreditAmount(productId, planId?)`, `getCreditExpiresAt(productId, planId?)` |
+| Config             | Methods                                                                                                                                                                                                                                 |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `StripeConfig`     | `productIds`, `getPriceId(productId)`, `getProductId(priceId)`, `getPlan`, `getBillingPeriod`, `getMode`, `isSubscription`, `comparePlans(from, to)`, `getCreditAmount(productId, priceId?)`, `getCreditExpiresAt(productId, priceId?)` |
+| `AppStoreConfig`   | `productIds`, `getDefaultProductId(plan, billingPeriod)`, `getPlan`, `getBillingPeriod`, `getMode`, `getCreditAmount`, `getCreditExpiresAt`                                                                                             |
+| `GooglePlayConfig` | `productIds`, `getDefaultPlanIds(productId)`, `getPlan(productId, planId)`, `getBillingPeriod(productId, planId)`, `getMode`, `getCreditAmount(productId, planId?)`, `getCreditExpiresAt(productId, planId?)`                           |
 
 In Stripe test mode the `test` twin of the default price is what `getPriceId` returns, and it
 resolves to the default price's credits. Non-default prices, products and base plans stay declared

package/dist/app-store/config.cjs

@@ -1,10 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_catalog = require("../catalog.cjs");
 let _shware_utils = require("@shware/utils");
 let ms = require("ms");
 ms = require_runtime.__toESM(ms, 1);
 //#region src/app-store/config.ts
 const addMethod = Symbol("addMethod");
+/** The private constructor's one door, for this module's `define` function only. */
+const construct = Symbol("construct");
 var Subscription = class {
 	plan;
 	billingPeriod;
@@ -27,6 +30,7 @@ var Subscription = class {
 		credits: 0,
 		expiresIn: "0"
 	}) => {
+		require_catalog.assertInNamespace(this.config.namespace, productId);
 		(0, _shware_utils.invariant)(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.products.set(productId, metadata);
 		return this;
@@ -41,6 +45,9 @@ var Subscription = class {
 var AppStoreConfig = class AppStoreConfig {
 	appId;
 	bundleId;
+	namespace;
+	plans;
+	billingPeriods;
 	products;
 	consumables;
 	subscriptions;
@@ -59,6 +66,10 @@ var AppStoreConfig = class AppStoreConfig {
 		return this;
 	};
 	constructor(options) {
+		require_catalog.assertCatalog(options);
+		this.namespace = options.namespace;
+		this.plans = options.plans;
+		this.billingPeriods = options.billingPeriods;
 		this.appId = options.appId;
 		this.bundleId = options.bundleId;
 		this.products = /* @__PURE__ */ new Map();
@@ -66,23 +77,24 @@ var AppStoreConfig = class AppStoreConfig {
 		this.subscriptions = /* @__PURE__ */ new Map();
 		this.nonConsumables = /* @__PURE__ */ new Set();
 	}
-	static create = (options) => {
-		return new AppStoreConfig(options);
-	};
+	static [construct] = (options) => new AppStoreConfig(options);
 	/** The same plan may be declared once per billing period; duplicate pairs are rejected. */
 	subscription = (plan, billingPeriod) => {
+		require_catalog.assertDeclared(this, plan, billingPeriod);
 		return new Subscription(this, plan, billingPeriod);
 	};
 	consumable = (productId, metadata = {
 		credits: 0,
 		expiresIn: "0"
 	}) => {
+		require_catalog.assertInNamespace(this.namespace, productId);
 		(0, _shware_utils.invariant)(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.consumables.add(productId);
 		this.products.set(productId, metadata);
 		return this;
 	};
 	nonConsumable = (productId) => {
+		require_catalog.assertInNamespace(this.namespace, productId);
 		(0, _shware_utils.invariant)(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.nonConsumables.add(productId);
 		this.products.set(productId, null);
@@ -124,7 +136,16 @@ var AppStoreConfig = class AppStoreConfig {
 		return new Date(Date.now() + expiresIn).toISOString();
 	};
 };
+/**
+* Declare the AppStore product catalog. Every type parameter is inferred from the options:
+* the namespace from `namespace`, the plans and billing periods from `plans` and `billingPeriods`
+* (`const`, so a literal array needs no `as const`). Products are then added with the fluent chain.
+*/
+function defineAppStoreConfig(options) {
+	return AppStoreConfig[construct](options);
+}
 //#endregion
 exports.AppStoreConfig = AppStoreConfig;
+exports.defineAppStoreConfig = defineAppStoreConfig;
 
 //# sourceMappingURL=config.cjs.map

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

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

package/dist/app-store/config.d.cts

@@ -1,6 +1,9 @@
+import { Catalog } from "../catalog.cjs";
 import { Metadata } from "../types.cjs";
 //#region src/app-store/config.d.ts
 declare const addMethod: unique symbol;
+/** The private constructor's one door, for this module's `define` function only. */
+declare const construct: unique symbol;
 declare class Subscription<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never, I extends string = never> {
   readonly plan: PE;
   readonly billingPeriod: BP;
@@ -16,13 +19,16 @@ declare class Subscription<NS extends Lowercase<string> = Lowercase<string>, PE
   product: <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K, metadata?: Metadata) => Subscription<NS, PE, BP, PL, PI | K, I | K>;
   default: (defaultProductId: I) => AppStoreConfig<NS, PE, BP, PL, PI>;
 }
-type Options = {
+type Options<NS extends Lowercase<string>, PE extends string, BP extends string> = Catalog<NS, PE, BP> & {
   appId: `${number}`;
   bundleId: string;
 };
 export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   readonly appId: string;
   readonly bundleId: string;
+  readonly namespace: NS;
+  readonly plans: readonly PE[];
+  readonly billingPeriods: readonly BP[];
   private readonly products;
   private readonly consumables;
   private readonly subscriptions;
@@ -30,7 +36,7 @@ export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<str
   get productIds(): string[];
   [addMethod]: (subscription: Subscription<NS, PE, BP, PL, PI>) => this;
   private constructor();
-  static create: <NS_1 extends Lowercase<string>, PE_1 extends string, BP_1 extends string = string>(options: Options) => AppStoreConfig<NS_1, PE_1, BP_1, never, never>;
+  static [construct]: <NS_1 extends Lowercase<string>, PE_1 extends string, BP_1 extends string>(options: Options<NS_1, PE_1, BP_1>) => AppStoreConfig<NS_1, PE_1, BP_1, never, never>;
   /** The same plan may be declared once per billing period; duplicate pairs are rejected. */
   subscription: <K extends PE, P extends BP>(plan: K, billingPeriod: `${K}:${P}` extends PL ? never : P) => Subscription<NS, PE, BP, PL | `${K}:${P}`, PI, never>;
   consumable: <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K, metadata?: Metadata) => AppStoreConfig<NS, PE, BP, PL, PI | K>;
@@ -44,6 +50,12 @@ export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<str
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string) => string;
 }
+/**
+ * Declare the AppStore product catalog. Every type parameter is inferred from the options:
+ * the namespace from `namespace`, the plans and billing periods from `plans` and `billingPeriods`
+ * (`const`, so a literal array needs no `as const`). Products are then added with the fluent chain.
+ */
+export declare function defineAppStoreConfig<const NS extends Lowercase<string>, const PE extends string, const BP extends string>(options: Options<NS, PE, BP>): AppStoreConfig<NS, PE, BP>;
 //#endregion
 export {};
 //# sourceMappingURL=config.d.cts.map

package/dist/app-store/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;qBAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;;cAKM;;cAEA;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAO5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B,QAAQ,WAAW,mBAAmB,mBAAmB,qBAAqB,QACjF,IACA,IACA;EACI;EAAoB;;qBAEb,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;WACA,WAAW;WACX,gBAAgB;WAChB,yBAAyB;mBAEjB;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;UAaC,aAAc,aAAW,mBAAmB,qBAAmB,qBAAiB,SAC7E,QAAQ,MAAI,MAAI,UAAG,eAAA,MAAA,MAAA;;EAI9B,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAOnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAMK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAK1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB;;;;;;;wBAWJ,2BACR,WAAW,yBACX,yBACA,mBACN,SAAS,QAAQ,IAAI,IAAI,MAAM,eAAe,IAAI,IAAI"}

package/dist/app-store/config.d.mts

@@ -1,6 +1,9 @@
+import { Catalog } from "../catalog.mjs";
 import { Metadata } from "../types.mjs";
 //#region src/app-store/config.d.ts
 declare const addMethod: unique symbol;
+/** The private constructor's one door, for this module's `define` function only. */
+declare const construct: unique symbol;
 declare class Subscription<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never, I extends string = never> {
   readonly plan: PE;
   readonly billingPeriod: BP;
@@ -16,13 +19,16 @@ declare class Subscription<NS extends Lowercase<string> = Lowercase<string>, PE
   product: <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K, metadata?: Metadata) => Subscription<NS, PE, BP, PL, PI | K, I | K>;
   default: (defaultProductId: I) => AppStoreConfig<NS, PE, BP, PL, PI>;
 }
-type Options = {
+type Options<NS extends Lowercase<string>, PE extends string, BP extends string> = Catalog<NS, PE, BP> & {
   appId: `${number}`;
   bundleId: string;
 };
 export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   readonly appId: string;
   readonly bundleId: string;
+  readonly namespace: NS;
+  readonly plans: readonly PE[];
+  readonly billingPeriods: readonly BP[];
   private readonly products;
   private readonly consumables;
   private readonly subscriptions;
@@ -30,7 +36,7 @@ export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<str
   get productIds(): string[];
   [addMethod]: (subscription: Subscription<NS, PE, BP, PL, PI>) => this;
   private constructor();
-  static create: <NS_1 extends Lowercase<string>, PE_1 extends string, BP_1 extends string = string>(options: Options) => AppStoreConfig<NS_1, PE_1, BP_1, never, never>;
+  static [construct]: <NS_1 extends Lowercase<string>, PE_1 extends string, BP_1 extends string>(options: Options<NS_1, PE_1, BP_1>) => AppStoreConfig<NS_1, PE_1, BP_1, never, never>;
   /** The same plan may be declared once per billing period; duplicate pairs are rejected. */
   subscription: <K extends PE, P extends BP>(plan: K, billingPeriod: `${K}:${P}` extends PL ? never : P) => Subscription<NS, PE, BP, PL | `${K}:${P}`, PI, never>;
   consumable: <K extends `${NS}.${Lowercase<string>}`>(productId: K extends PI ? never : K, metadata?: Metadata) => AppStoreConfig<NS, PE, BP, PL, PI | K>;
@@ -44,6 +50,12 @@ export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<str
   private readonly getCreditExpiresIn;
   getCreditExpiresAt: (productId: string) => string;
 }
+/**
+ * Declare the AppStore product catalog. Every type parameter is inferred from the options:
+ * the namespace from `namespace`, the plans and billing periods from `plans` and `billingPeriods`
+ * (`const`, so a literal array needs no `as const`). Products are then added with the fluent chain.
+ */
+export declare function defineAppStoreConfig<const NS extends Lowercase<string>, const PE extends string, const BP extends string>(options: Options<NS, PE, BP>): AppStoreConfig<NS, PE, BP>;
 //#endregion
 export {};
 //# sourceMappingURL=config.d.mts.map

package/dist/app-store/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;qBAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;;cAKM;;cAEA;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAO5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B,QAAQ,WAAW,mBAAmB,mBAAmB,qBAAqB,QACjF,IACA,IACA;EACI;EAAoB;;qBAEb,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;WACA,WAAW;WACX,gBAAgB;WAChB,yBAAyB;mBAEjB;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;UAaC,aAAc,aAAW,mBAAmB,qBAAmB,qBAAiB,SAC7E,QAAQ,MAAI,MAAI,UAAG,eAAA,MAAA,MAAA;;EAI9B,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAOnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAMK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAK1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB;;;;;;;wBAWJ,2BACR,WAAW,yBACX,yBACA,mBACN,SAAS,QAAQ,IAAI,IAAI,MAAM,eAAe,IAAI,IAAI"}

package/dist/app-store/config.mjs

@@ -1,7 +1,10 @@
+import { assertCatalog, assertDeclared, assertInNamespace } from "../catalog.mjs";
 import { invariant } from "@shware/utils";
 import ms from "ms";
 //#region src/app-store/config.ts
 const addMethod = Symbol("addMethod");
+/** The private constructor's one door, for this module's `define` function only. */
+const construct = Symbol("construct");
 var Subscription = class {
 	plan;
 	billingPeriod;
@@ -24,6 +27,7 @@ var Subscription = class {
 		credits: 0,
 		expiresIn: "0"
 	}) => {
+		assertInNamespace(this.config.namespace, productId);
 		invariant(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.products.set(productId, metadata);
 		return this;
@@ -38,6 +42,9 @@ var Subscription = class {
 var AppStoreConfig = class AppStoreConfig {
 	appId;
 	bundleId;
+	namespace;
+	plans;
+	billingPeriods;
 	products;
 	consumables;
 	subscriptions;
@@ -56,6 +63,10 @@ var AppStoreConfig = class AppStoreConfig {
 		return this;
 	};
 	constructor(options) {
+		assertCatalog(options);
+		this.namespace = options.namespace;
+		this.plans = options.plans;
+		this.billingPeriods = options.billingPeriods;
 		this.appId = options.appId;
 		this.bundleId = options.bundleId;
 		this.products = /* @__PURE__ */ new Map();
@@ -63,23 +74,24 @@ var AppStoreConfig = class AppStoreConfig {
 		this.subscriptions = /* @__PURE__ */ new Map();
 		this.nonConsumables = /* @__PURE__ */ new Set();
 	}
-	static create = (options) => {
-		return new AppStoreConfig(options);
-	};
+	static [construct] = (options) => new AppStoreConfig(options);
 	/** The same plan may be declared once per billing period; duplicate pairs are rejected. */
 	subscription = (plan, billingPeriod) => {
+		assertDeclared(this, plan, billingPeriod);
 		return new Subscription(this, plan, billingPeriod);
 	};
 	consumable = (productId, metadata = {
 		credits: 0,
 		expiresIn: "0"
 	}) => {
+		assertInNamespace(this.namespace, productId);
 		invariant(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.consumables.add(productId);
 		this.products.set(productId, metadata);
 		return this;
 	};
 	nonConsumable = (productId) => {
+		assertInNamespace(this.namespace, productId);
 		invariant(!this.products.has(productId), `Duplicate product ${productId}`);
 		this.nonConsumables.add(productId);
 		this.products.set(productId, null);
@@ -121,7 +133,15 @@ var AppStoreConfig = class AppStoreConfig {
 		return new Date(Date.now() + expiresIn).toISOString();
 	};
 };
+/**
+* Declare the AppStore product catalog. Every type parameter is inferred from the options:
+* the namespace from `namespace`, the plans and billing periods from `plans` and `billingPeriods`
+* (`const`, so a literal array needs no `as const`). Products are then added with the fluent chain.
+*/
+function defineAppStoreConfig(options) {
+	return AppStoreConfig[construct](options);
+}
 //#endregion
-export { AppStoreConfig };
+export { AppStoreConfig, defineAppStoreConfig };
 
 //# sourceMappingURL=config.mjs.map

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

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

package/dist/app-store/index.cjs

@@ -4,4 +4,6 @@ const require_app_store_handler = require("./handler.cjs");
 const require_app_store_mapper = require("./mapper.cjs");
 exports.AppStoreConfig = require_app_store_config.AppStoreConfig;
 exports.AppStoreNotificationHandler = require_app_store_handler.AppStoreNotificationHandler;
+exports.defineAppStoreConfig = require_app_store_config.defineAppStoreConfig;
 exports.mapCancellationDetails = require_app_store_mapper.mapCancellationDetails;
+exports.mapPaymentType = require_app_store_mapper.mapPaymentType;

package/dist/app-store/index.d.cts

@@ -1,4 +1,4 @@
-import { AppStoreConfig } from "./config.cjs";
+import { AppStoreConfig, defineAppStoreConfig } from "./config.cjs";
 import { AppStoreNotificationEvent, AppStoreNotificationHandler } from "./handler.cjs";
-import { AppStoreCancellationSource, mapCancellationDetails } from "./mapper.cjs";
-export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, mapCancellationDetails };
+import { AppStoreCancellationSource, AppStorePaymentSource, mapCancellationDetails, mapPaymentType } from "./mapper.cjs";
+export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, type AppStorePaymentSource, defineAppStoreConfig, mapCancellationDetails, mapPaymentType };

package/dist/app-store/index.d.mts

@@ -1,4 +1,4 @@
-import { AppStoreConfig } from "./config.mjs";
+import { AppStoreConfig, defineAppStoreConfig } from "./config.mjs";
 import { AppStoreNotificationEvent, AppStoreNotificationHandler } from "./handler.mjs";
-import { AppStoreCancellationSource, mapCancellationDetails } from "./mapper.mjs";
-export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, mapCancellationDetails };
+import { AppStoreCancellationSource, AppStorePaymentSource, mapCancellationDetails, mapPaymentType } from "./mapper.mjs";
+export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, type AppStorePaymentSource, defineAppStoreConfig, mapCancellationDetails, mapPaymentType };

package/dist/app-store/index.mjs

@@ -1,4 +1,4 @@
-import { AppStoreConfig } from "./config.mjs";
+import { AppStoreConfig, defineAppStoreConfig } from "./config.mjs";
 import { AppStoreNotificationHandler } from "./handler.mjs";
-import { mapCancellationDetails } from "./mapper.mjs";
-export { AppStoreConfig, AppStoreNotificationHandler, mapCancellationDetails };
+import { mapCancellationDetails, mapPaymentType } from "./mapper.mjs";
+export { AppStoreConfig, AppStoreNotificationHandler, defineAppStoreConfig, mapCancellationDetails, mapPaymentType };

package/dist/app-store/mapper.cjs

@@ -31,6 +31,27 @@ function mapCancellationDetails(source) {
 		default: return null;
 	}
 }
+/**
+* The payment a subscription notification's transaction is, if it is one: the first purchase
+* (`SUBSCRIBED`, or a redeemed offer code that starts or resumes the subscription), a renewal
+* (`DID_RENEW`), or an upgrade. An upgrade counts as a renewal: Apple charges the higher plan in
+* full and starts a new period at once, refunding what is left of the old one separately, so it is
+* a regular period charge rather than an off-cycle proration. A downgrade, an auto-renew change
+* and the like carry the current transaction, already paid, and are null.
+*
+* ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+*/
+function mapPaymentType({ notificationType, subtype }) {
+	switch (notificationType) {
+		case "SUBSCRIBED": return "SUBSCRIPTION_START";
+		case "DID_RENEW": return "SUBSCRIPTION_RENEWAL";
+		case "DID_CHANGE_RENEWAL_PREF": return subtype === "UPGRADE" ? "SUBSCRIPTION_RENEWAL" : null;
+		case "OFFER_REDEEMED":
+			if (subtype === "INITIAL_BUY" || subtype === "RESUBSCRIBE") return "SUBSCRIPTION_START";
+			return subtype === "UPGRADE" ? "SUBSCRIPTION_RENEWAL" : null;
+		default: return null;
+	}
+}
 /** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */
 function expirationIntentSubtype(intent) {
 	switch (intent) {
@@ -43,5 +64,6 @@ function expirationIntentSubtype(intent) {
 }
 //#endregion
 exports.mapCancellationDetails = mapCancellationDetails;
+exports.mapPaymentType = mapPaymentType;
 
 //# sourceMappingURL=mapper.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"mapper.cjs","names":[],"sources":["../../src/app-store/mapper.ts"],"sourcesContent":["import type { CancellationDetails } from '../subscription/index';\n\n/**\n * The App Store Server Notification fields that say why a subscription stops renewing: the\n * notification type and subtype, plus `expirationIntent` from the renewal info once it has\n * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the\n * App Store Server Library.\n */\nexport interface AppStoreCancellationSource {\n  notificationType: string;\n  subtype?: string | null;\n  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */\n  expirationIntent?: number | null;\n}\n\n/**\n * Who ended an App Store subscription and why, from the notification that reported it. Null for\n * anything that is not a cancellation, including the customer turning auto-renew back on.\n *\n * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)\n * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)\n */\nexport function mapCancellationDetails(\n  source: AppStoreCancellationSource\n): CancellationDetails | null {\n  const { notificationType, subtype, expirationIntent } = source;\n  const details = (initiator: CancellationDetails['initiator'], reason: string) => ({\n    initiator,\n    reason,\n    feedback: null,\n    comment: null,\n  });\n\n  switch (notificationType) {\n    case 'DID_CHANGE_RENEWAL_STATUS':\n      return subtype === 'AUTO_RENEW_DISABLED' ? details('user', subtype) : null;\n    case 'EXPIRED':\n      switch (subtype ?? expirationIntentSubtype(expirationIntent)) {\n        case 'VOLUNTARY':\n          return details('user', 'VOLUNTARY');\n        case 'BILLING_RETRY':\n          return details('system', 'BILLING_RETRY');\n        case 'PRICE_INCREASE':\n          return details('user', 'PRICE_INCREASE');\n        case 'PRODUCT_NOT_FOR_SALE':\n          return details('developer', 'PRODUCT_NOT_FOR_SALE');\n        default:\n          return details('system', 'EXPIRED');\n      }\n    case 'DID_FAIL_TO_RENEW':\n    case 'GRACE_PERIOD_EXPIRED':\n    case 'REFUND':\n    case 'REVOKE':\n      return details('system', notificationType);\n    default:\n      return null;\n  }\n}\n\n/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */\nfunction expirationIntentSubtype(intent: number | null | undefined) {\n  switch (intent) {\n    case 1:\n      return 'VOLUNTARY';\n    case 2:\n      return 'BILLING_RETRY';\n    case 3:\n      return 'PRICE_INCREASE';\n    case 4:\n      return 'PRODUCT_NOT_FOR_SALE';\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,uBACd,QAC4B;CAC5B,MAAM,EAAE,kBAAkB,SAAS,qBAAqB;CACxD,MAAM,WAAW,WAA6C,YAAoB;EAChF;EACA;EACA,UAAU;EACV,SAAS;CACX;CAEA,QAAQ,kBAAR;EACE,KAAK,6BACH,OAAO,YAAY,wBAAwB,QAAQ,QAAQ,OAAO,IAAI;EACxE,KAAK,WACH,QAAQ,WAAW,wBAAwB,gBAAgB,GAA3D;GACE,KAAK,aACH,OAAO,QAAQ,QAAQ,WAAW;GACpC,KAAK,iBACH,OAAO,QAAQ,UAAU,eAAe;GAC1C,KAAK,kBACH,OAAO,QAAQ,QAAQ,gBAAgB;GACzC,KAAK,wBACH,OAAO,QAAQ,aAAa,sBAAsB;GACpD,SACE,OAAO,QAAQ,UAAU,SAAS;EACtC;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,UACH,OAAO,QAAQ,UAAU,gBAAgB;EAC3C,SACE,OAAO;CACX;AACF;;AAGA,SAAS,wBAAwB,QAAmC;CAClE,QAAQ,QAAR;EACE,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,SACE;CACJ;AACF"}
+{"version":3,"file":"mapper.cjs","names":[],"sources":["../../src/app-store/mapper.ts"],"sourcesContent":["import type { CancellationDetails, PaymentType } from '../subscription/index';\n\n/**\n * The App Store Server Notification fields that say why a subscription stops renewing: the\n * notification type and subtype, plus `expirationIntent` from the renewal info once it has\n * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the\n * App Store Server Library.\n */\nexport interface AppStoreCancellationSource {\n  notificationType: string;\n  subtype?: string | null;\n  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */\n  expirationIntent?: number | null;\n}\n\n/**\n * Who ended an App Store subscription and why, from the notification that reported it. Null for\n * anything that is not a cancellation, including the customer turning auto-renew back on.\n *\n * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)\n * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)\n */\nexport function mapCancellationDetails(\n  source: AppStoreCancellationSource\n): CancellationDetails | null {\n  const { notificationType, subtype, expirationIntent } = source;\n  const details = (initiator: CancellationDetails['initiator'], reason: string) => ({\n    initiator,\n    reason,\n    feedback: null,\n    comment: null,\n  });\n\n  switch (notificationType) {\n    case 'DID_CHANGE_RENEWAL_STATUS':\n      return subtype === 'AUTO_RENEW_DISABLED' ? details('user', subtype) : null;\n    case 'EXPIRED':\n      switch (subtype ?? expirationIntentSubtype(expirationIntent)) {\n        case 'VOLUNTARY':\n          return details('user', 'VOLUNTARY');\n        case 'BILLING_RETRY':\n          return details('system', 'BILLING_RETRY');\n        case 'PRICE_INCREASE':\n          return details('user', 'PRICE_INCREASE');\n        case 'PRODUCT_NOT_FOR_SALE':\n          return details('developer', 'PRODUCT_NOT_FOR_SALE');\n        default:\n          return details('system', 'EXPIRED');\n      }\n    case 'DID_FAIL_TO_RENEW':\n    case 'GRACE_PERIOD_EXPIRED':\n    case 'REFUND':\n    case 'REVOKE':\n      return details('system', notificationType);\n    default:\n      return null;\n  }\n}\n\n/** The App Store Server Notification fields that say whether a notification is a payment. */\nexport interface AppStorePaymentSource {\n  notificationType?: string | null;\n  subtype?: string | null;\n}\n\n/**\n * The payment a subscription notification's transaction is, if it is one: the first purchase\n * (`SUBSCRIBED`, or a redeemed offer code that starts or resumes the subscription), a renewal\n * (`DID_RENEW`), or an upgrade. An upgrade counts as a renewal: Apple charges the higher plan in\n * full and starts a new period at once, refunding what is left of the old one separately, so it is\n * a regular period charge rather than an off-cycle proration. A downgrade, an auto-renew change\n * and the like carry the current transaction, already paid, and are null.\n *\n * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)\n */\nexport function mapPaymentType({\n  notificationType,\n  subtype,\n}: AppStorePaymentSource): Exclude<PaymentType, 'ONE_TIME'> | null {\n  switch (notificationType) {\n    case 'SUBSCRIBED':\n      return 'SUBSCRIPTION_START';\n    case 'DID_RENEW':\n      return 'SUBSCRIPTION_RENEWAL';\n    case 'DID_CHANGE_RENEWAL_PREF':\n      return subtype === 'UPGRADE' ? 'SUBSCRIPTION_RENEWAL' : null;\n    case 'OFFER_REDEEMED':\n      if (subtype === 'INITIAL_BUY' || subtype === 'RESUBSCRIBE') return 'SUBSCRIPTION_START';\n      return subtype === 'UPGRADE' ? 'SUBSCRIPTION_RENEWAL' : null;\n    default:\n      return null;\n  }\n}\n\n/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */\nfunction expirationIntentSubtype(intent: number | null | undefined) {\n  switch (intent) {\n    case 1:\n      return 'VOLUNTARY';\n    case 2:\n      return 'BILLING_RETRY';\n    case 3:\n      return 'PRICE_INCREASE';\n    case 4:\n      return 'PRODUCT_NOT_FOR_SALE';\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,uBACd,QAC4B;CAC5B,MAAM,EAAE,kBAAkB,SAAS,qBAAqB;CACxD,MAAM,WAAW,WAA6C,YAAoB;EAChF;EACA;EACA,UAAU;EACV,SAAS;CACX;CAEA,QAAQ,kBAAR;EACE,KAAK,6BACH,OAAO,YAAY,wBAAwB,QAAQ,QAAQ,OAAO,IAAI;EACxE,KAAK,WACH,QAAQ,WAAW,wBAAwB,gBAAgB,GAA3D;GACE,KAAK,aACH,OAAO,QAAQ,QAAQ,WAAW;GACpC,KAAK,iBACH,OAAO,QAAQ,UAAU,eAAe;GAC1C,KAAK,kBACH,OAAO,QAAQ,QAAQ,gBAAgB;GACzC,KAAK,wBACH,OAAO,QAAQ,aAAa,sBAAsB;GACpD,SACE,OAAO,QAAQ,UAAU,SAAS;EACtC;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,UACH,OAAO,QAAQ,UAAU,gBAAgB;EAC3C,SACE,OAAO;CACX;AACF;;;;;;;;;;;AAkBA,SAAgB,eAAe,EAC7B,kBACA,WACiE;CACjE,QAAQ,kBAAR;EACE,KAAK,cACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,2BACH,OAAO,YAAY,YAAY,yBAAyB;EAC1D,KAAK;GACH,IAAI,YAAY,iBAAiB,YAAY,eAAe,OAAO;GACnE,OAAO,YAAY,YAAY,yBAAyB;EAC1D,SACE,OAAO;CACX;AACF;;AAGA,SAAS,wBAAwB,QAAmC;CAClE,QAAQ,QAAR;EACE,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,SACE;CACJ;AACF"}

package/dist/app-store/mapper.d.cts

@@ -1,4 +1,4 @@
-import { CancellationDetails } from "../subscription/index.cjs";
+import { CancellationDetails, PaymentType } from "../subscription/index.cjs";
 //#region src/app-store/mapper.d.ts
 /**
  * The App Store Server Notification fields that say why a subscription stops renewing: the
@@ -20,5 +20,21 @@ export interface AppStoreCancellationSource {
  * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)
  */
 export declare function mapCancellationDetails(source: AppStoreCancellationSource): CancellationDetails | null;
+/** The App Store Server Notification fields that say whether a notification is a payment. */
+export interface AppStorePaymentSource {
+  notificationType?: string | null;
+  subtype?: string | null;
+}
+/**
+ * The payment a subscription notification's transaction is, if it is one: the first purchase
+ * (`SUBSCRIBED`, or a redeemed offer code that starts or resumes the subscription), a renewal
+ * (`DID_RENEW`), or an upgrade. An upgrade counts as a renewal: Apple charges the higher plan in
+ * full and starts a new period at once, refunding what is left of the old one separately, so it is
+ * a regular period charge rather than an off-cycle proration. A downgrade, an auto-renew change
+ * and the like carry the current transaction, already paid, and are null.
+ *
+ * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+ */
+export declare function mapPaymentType({ notificationType, subtype }: AppStorePaymentSource): Exclude<PaymentType, 'ONE_TIME'> | null;
 //#endregion
 //# sourceMappingURL=mapper.d.cts.map

package/dist/app-store/mapper.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/app-store/mapper.ts"],"mappings":";;;;;;;;iBAQiB;EACf;EACA;;EAEA;;;;;;;;;wBAUc,uBACd,QAAQ,6BACP"}
+{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/app-store/mapper.ts"],"mappings":";;;;;;;;iBAQiB;EACf;EACA;;EAEA;;;;;;;;;wBAUc,uBACd,QAAQ,6BACP;;iBAoCc;EACf;EACA;;;;;;;;;;;;wBAac,iBACd,kBACA,WACC,wBAAwB,QAAQ"}