@shware/purchase 7.6.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,5 +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, AppStorePaymentSource, mapCancellationDetails, mapPaymentType } from "./mapper.cjs";
-export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, type AppStorePaymentSource, mapCancellationDetails, mapPaymentType };
+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, AppStorePaymentSource, mapCancellationDetails, mapPaymentType } from "./mapper.mjs";
-export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, type AppStorePaymentSource, mapCancellationDetails, mapPaymentType };
+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, mapPaymentType } from "./mapper.mjs";
-export { AppStoreConfig, AppStoreNotificationHandler, mapCancellationDetails, mapPaymentType };
+export { AppStoreConfig, AppStoreNotificationHandler, defineAppStoreConfig, mapCancellationDetails, mapPaymentType };

package/dist/catalog.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _shware_utils = require("@shware/utils");
+//#region src/catalog.ts
+function assertCatalog({ plans, billingPeriods }) {
+	(0, _shware_utils.invariant)(new Set(plans).size === plans.length, "Duplicate plan in plans");
+	(0, _shware_utils.invariant)(new Set(billingPeriods).size === billingPeriods.length, "Duplicate billing period in billingPeriods");
+}
+/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */
+function assertInNamespace(namespace, productId) {
+	(0, _shware_utils.invariant)(productId.startsWith(`${namespace}.`), `Product ${productId} is not in namespace ${namespace}`);
+}
+/** Runtime mirror of the plan and period unions. */
+function assertDeclared({ plans, billingPeriods }, plan, billingPeriod) {
+	(0, _shware_utils.invariant)(plan === null || plans.includes(plan), `Plan ${plan} is not in plans`);
+	(0, _shware_utils.invariant)(billingPeriod === null || billingPeriods.includes(billingPeriod), `Billing period ${billingPeriod} is not in billingPeriods`);
+}
+//#endregion
+exports.assertCatalog = assertCatalog;
+exports.assertDeclared = assertDeclared;
+exports.assertInNamespace = assertInNamespace;
+
+//# sourceMappingURL=catalog.cjs.map

package/dist/catalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.cjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\n\n/**\n * What every store config is declared over, and what its type parameters are inferred from: the\n * prefix of every product id, the plans lowest tier first, the billing periods shortest first. A\n * config with no subscriptions passes empty arrays.\n */\nexport interface Catalog<NS extends Lowercase<string>, PE extends string, BP extends string> {\n  /** The prefix every product id starts with (`io.example` for `io.example.pro.monthly`). */\n  namespace: NS;\n  /** Every plan, lowest tier first: its level, as Apple orders a subscription group. */\n  plans: readonly PE[];\n  /** Every billing period, shortest first. */\n  billingPeriods: readonly BP[];\n}\n\nexport function assertCatalog({\n  plans,\n  billingPeriods,\n}: Catalog<Lowercase<string>, string, string>) {\n  invariant(new Set(plans).size === plans.length, 'Duplicate plan in plans');\n  invariant(\n    new Set(billingPeriods).size === billingPeriods.length,\n    'Duplicate billing period in billingPeriods'\n  );\n}\n\n/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */\nexport function assertInNamespace(namespace: string, productId: string) {\n  invariant(\n    productId.startsWith(`${namespace}.`),\n    `Product ${productId} is not in namespace ${namespace}`\n  );\n}\n\n/** Runtime mirror of the plan and period unions. */\nexport function assertDeclared(\n  { plans, billingPeriods }: Catalog<Lowercase<string>, string, string>,\n  plan: string | null,\n  billingPeriod: string | null\n) {\n  invariant(plan === null || plans.includes(plan), `Plan ${plan} is not in plans`);\n  invariant(\n    billingPeriod === null || billingPeriods.includes(billingPeriod),\n    `Billing period ${billingPeriod} is not in billingPeriods`\n  );\n}\n"],"mappings":";;;AAgBA,SAAgB,cAAc,EAC5B,OACA,kBAC6C;CAC7C,CAAA,GAAA,cAAA,UAAA,CAAU,IAAI,IAAI,KAAK,CAAC,CAAC,SAAS,MAAM,QAAQ,yBAAyB;CACzE,CAAA,GAAA,cAAA,UAAA,CACE,IAAI,IAAI,cAAc,CAAC,CAAC,SAAS,eAAe,QAChD,4CACF;AACF;;AAGA,SAAgB,kBAAkB,WAAmB,WAAmB;CACtE,CAAA,GAAA,cAAA,UAAA,CACE,UAAU,WAAW,GAAG,UAAU,EAAE,GACpC,WAAW,UAAU,uBAAuB,WAC9C;AACF;;AAGA,SAAgB,eACd,EAAE,OAAO,kBACT,MACA,eACA;CACA,CAAA,GAAA,cAAA,UAAA,CAAU,SAAS,QAAQ,MAAM,SAAS,IAAI,GAAG,QAAQ,KAAK,iBAAiB;CAC/E,CAAA,GAAA,cAAA,UAAA,CACE,kBAAkB,QAAQ,eAAe,SAAS,aAAa,GAC/D,kBAAkB,cAAc,0BAClC;AACF"}

package/dist/catalog.d.cts

@@ -0,0 +1,21 @@
+//#region src/catalog.d.ts
+/**
+ * What every store config is declared over, and what its type parameters are inferred from: the
+ * prefix of every product id, the plans lowest tier first, the billing periods shortest first. A
+ * config with no subscriptions passes empty arrays.
+ */
+export interface Catalog<NS extends Lowercase<string>, PE extends string, BP extends string> {
+  /** The prefix every product id starts with (`io.example` for `io.example.pro.monthly`). */
+  namespace: NS;
+  /** Every plan, lowest tier first: its level, as Apple orders a subscription group. */
+  plans: readonly PE[];
+  /** Every billing period, shortest first. */
+  billingPeriods: readonly BP[];
+}
+export declare function assertCatalog({ plans, billingPeriods }: Catalog<Lowercase<string>, string, string>): void;
+/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */
+export declare function assertInNamespace(namespace: string, productId: string): void;
+/** Runtime mirror of the plan and period unions. */
+export declare function assertDeclared({ plans, billingPeriods }: Catalog<Lowercase<string>, string, string>, plan: string | null, billingPeriod: string | null): void;
+//#endregion
+//# sourceMappingURL=catalog.d.cts.map

package/dist/catalog.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.cts","names":[],"sources":["../src/catalog.ts"],"mappings":";;;;;;iBAOiB,QAAQ,WAAW,mBAAmB,mBAAmB;;EAExE,WAAW;;EAEX,gBAAgB;;EAEhB,yBAAyB;;wBAGX,gBACd,OACA,kBACC,QAAQ;;wBASK,kBAAkB,mBAAmB;;wBAQrC,iBACZ,OAAO,kBAAkB,QAAQ,oCACnC,qBACA"}

package/dist/catalog.d.mts

@@ -0,0 +1,21 @@
+//#region src/catalog.d.ts
+/**
+ * What every store config is declared over, and what its type parameters are inferred from: the
+ * prefix of every product id, the plans lowest tier first, the billing periods shortest first. A
+ * config with no subscriptions passes empty arrays.
+ */
+export interface Catalog<NS extends Lowercase<string>, PE extends string, BP extends string> {
+  /** The prefix every product id starts with (`io.example` for `io.example.pro.monthly`). */
+  namespace: NS;
+  /** Every plan, lowest tier first: its level, as Apple orders a subscription group. */
+  plans: readonly PE[];
+  /** Every billing period, shortest first. */
+  billingPeriods: readonly BP[];
+}
+export declare function assertCatalog({ plans, billingPeriods }: Catalog<Lowercase<string>, string, string>): void;
+/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */
+export declare function assertInNamespace(namespace: string, productId: string): void;
+/** Runtime mirror of the plan and period unions. */
+export declare function assertDeclared({ plans, billingPeriods }: Catalog<Lowercase<string>, string, string>, plan: string | null, billingPeriod: string | null): void;
+//#endregion
+//# sourceMappingURL=catalog.d.mts.map

package/dist/catalog.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.mts","names":[],"sources":["../src/catalog.ts"],"mappings":";;;;;;iBAOiB,QAAQ,WAAW,mBAAmB,mBAAmB;;EAExE,WAAW;;EAEX,gBAAgB;;EAEhB,yBAAyB;;wBAGX,gBACd,OACA,kBACC,QAAQ;;wBASK,kBAAkB,mBAAmB;;wBAQrC,iBACZ,OAAO,kBAAkB,QAAQ,oCACnC,qBACA"}

package/dist/catalog.mjs

@@ -0,0 +1,19 @@
+import { invariant } from "@shware/utils";
+//#region src/catalog.ts
+function assertCatalog({ plans, billingPeriods }) {
+	invariant(new Set(plans).size === plans.length, "Duplicate plan in plans");
+	invariant(new Set(billingPeriods).size === billingPeriods.length, "Duplicate billing period in billingPeriods");
+}
+/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */
+function assertInNamespace(namespace, productId) {
+	invariant(productId.startsWith(`${namespace}.`), `Product ${productId} is not in namespace ${namespace}`);
+}
+/** Runtime mirror of the plan and period unions. */
+function assertDeclared({ plans, billingPeriods }, plan, billingPeriod) {
+	invariant(plan === null || plans.includes(plan), `Plan ${plan} is not in plans`);
+	invariant(billingPeriod === null || billingPeriods.includes(billingPeriod), `Billing period ${billingPeriod} is not in billingPeriods`);
+}
+//#endregion
+export { assertCatalog, assertDeclared, assertInNamespace };
+
+//# sourceMappingURL=catalog.mjs.map

package/dist/catalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.mjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { invariant } from '@shware/utils';\n\n/**\n * What every store config is declared over, and what its type parameters are inferred from: the\n * prefix of every product id, the plans lowest tier first, the billing periods shortest first. A\n * config with no subscriptions passes empty arrays.\n */\nexport interface Catalog<NS extends Lowercase<string>, PE extends string, BP extends string> {\n  /** The prefix every product id starts with (`io.example` for `io.example.pro.monthly`). */\n  namespace: NS;\n  /** Every plan, lowest tier first: its level, as Apple orders a subscription group. */\n  plans: readonly PE[];\n  /** Every billing period, shortest first. */\n  billingPeriods: readonly BP[];\n}\n\nexport function assertCatalog({\n  plans,\n  billingPeriods,\n}: Catalog<Lowercase<string>, string, string>) {\n  invariant(new Set(plans).size === plans.length, 'Duplicate plan in plans');\n  invariant(\n    new Set(billingPeriods).size === billingPeriods.length,\n    'Duplicate billing period in billingPeriods'\n  );\n}\n\n/** Runtime mirror of the template-literal type, for ids built at runtime or cast. */\nexport function assertInNamespace(namespace: string, productId: string) {\n  invariant(\n    productId.startsWith(`${namespace}.`),\n    `Product ${productId} is not in namespace ${namespace}`\n  );\n}\n\n/** Runtime mirror of the plan and period unions. */\nexport function assertDeclared(\n  { plans, billingPeriods }: Catalog<Lowercase<string>, string, string>,\n  plan: string | null,\n  billingPeriod: string | null\n) {\n  invariant(plan === null || plans.includes(plan), `Plan ${plan} is not in plans`);\n  invariant(\n    billingPeriod === null || billingPeriods.includes(billingPeriod),\n    `Billing period ${billingPeriod} is not in billingPeriods`\n  );\n}\n"],"mappings":";;AAgBA,SAAgB,cAAc,EAC5B,OACA,kBAC6C;CAC7C,UAAU,IAAI,IAAI,KAAK,CAAC,CAAC,SAAS,MAAM,QAAQ,yBAAyB;CACzE,UACE,IAAI,IAAI,cAAc,CAAC,CAAC,SAAS,eAAe,QAChD,4CACF;AACF;;AAGA,SAAgB,kBAAkB,WAAmB,WAAmB;CACtE,UACE,UAAU,WAAW,GAAG,UAAU,EAAE,GACpC,WAAW,UAAU,uBAAuB,WAC9C;AACF;;AAGA,SAAgB,eACd,EAAE,OAAO,kBACT,MACA,eACA;CACA,UAAU,SAAS,QAAQ,MAAM,SAAS,IAAI,GAAG,QAAQ,KAAK,iBAAiB;CAC/E,UACE,kBAAkB,QAAQ,eAAe,SAAS,aAAa,GAC/D,kBAAkB,cAAc,0BAClC;AACF"}