@usebillow/sdk 0.5.0

package/dist/config.d.cts

@@ -0,0 +1,104 @@
+import { Billow } from './index.cjs';
+import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-DZ4rIyg7.cjs';
+import './billing-status-BZQN_gm7.cjs';
+import './status.cjs';
+import './credits-C3Fe3TO0.cjs';
+import 'zod';
+
+/**
+ * Code-as-config sync (ARCHITECTURE §12 "code-as-config sync"). Keep your catalog
+ * — features, products, coupons — in a typed config file and `syncConfig` it into
+ * a billow server. Sync is **declarative and additive**: it creates whatever is
+ * missing and *reports drift* on what already exists, but never deletes and never
+ * rewrites an existing product (catalog edits are made deliberately through the
+ * dashboard/API — ADR-0015 — not silently on every sync).
+ *
+ *   import { defineConfig, syncConfig } from "@usebillow/sdk/config";
+ *   const config = defineConfig({ features: [...], products: [...], coupons: [...] });
+ *   await syncConfig(billow, config, { onProgress: console.log });
+ */
+
+interface ConfigFeature {
+    slug: string;
+    name: string;
+    kind: FeatureKind;
+    /**
+     * For a `metered` feature: how its usage aggregates (ADR-0011). Omit to get a `sum`
+     * meter. Set it here so sync creates the meter you want instead of the default — after
+     * usage is recorded the aggregation can no longer change.
+     */
+    meter?: MeterConfig;
+}
+/** A product entry — the same shape as `billow.products.create`. */
+type ConfigProduct = CreateProductInput;
+/**
+ * A coupon entry. Unlike `billow.coupons.create`, the `code` is **required** — it
+ * is the stable identity sync diffs against (a code-less coupon can't be matched).
+ */
+type ConfigCoupon = Omit<CreateCouponInput, "code"> & {
+    code: string;
+};
+interface BillowConfig {
+    features?: ConfigFeature[];
+    products?: ConfigProduct[];
+    coupons?: ConfigCoupon[];
+}
+/** Identity helper — returns its argument, typed, for editor completion + checks. */
+declare function defineConfig(config: BillowConfig): BillowConfig;
+type SyncAction = "create" | "unchanged" | "drift";
+interface SyncItem {
+    kind: "feature" | "product" | "coupon";
+    /** Slug (features/products) or code (coupons). */
+    id: string;
+    action: SyncAction;
+    /** For `drift`: which aspects differ from the server (human-readable). */
+    changes?: string[];
+}
+interface SyncPlan {
+    features: SyncItem[];
+    products: SyncItem[];
+    coupons: SyncItem[];
+}
+interface SyncResult {
+    plan: SyncPlan;
+    created: {
+        features: string[];
+        products: string[];
+        coupons: string[];
+    };
+    /**
+     * Items that still differ from the config after the sync - reported, not applied. With
+     * `applyMetadata`, product metadata that was written is removed from here (see `applied`).
+     */
+    drift: SyncItem[];
+    /** Product slugs whose metadata was written this run (only when `applyMetadata` is set). */
+    applied: {
+        productMetadata: string[];
+    };
+}
+/**
+ * Diff a config against the server without writing anything. Each entry is
+ * `create` (missing), `unchanged` (matches), or `drift` (exists but differs).
+ */
+declare function planConfig(billow: Billow, config: BillowConfig): Promise<SyncPlan>;
+/**
+ * Apply a config: create everything missing (features → products → coupons, the
+ * dependency order, since products reference feature slugs), and return what was
+ * created plus any drift it found.
+ *
+ * Structural drift (prices, entitlements, name, ...) is never auto-applied - those edits are
+ * version-bearing (ADR-0015: collected at renewal) and belong to a deliberate `products.update`.
+ * With `applyMetadata: true`, product **metadata** drift IS written, because metadata lives on
+ * the product row (not the version), so updating it is version-independent and cannot rewrite
+ * billed history. This closes the write-side gap where a config's product metadata could only
+ * be reported, never pushed. The write is a full-map replace (config is authoritative): a key
+ * present on the server but absent from the config is cleared.
+ */
+declare function syncConfig(billow: Billow, config: BillowConfig, opts?: {
+    onProgress?: (message: string) => void;
+    applyMetadata?: boolean;
+}): Promise<SyncResult>;
+/** A one-line-per-item summary of a plan, for CLI output. */
+declare function formatPlan(plan: SyncPlan): string;
+
+export { type BillowConfig, type ConfigCoupon, type ConfigFeature, type ConfigProduct, type SyncAction, type SyncItem, type SyncPlan, type SyncResult, defineConfig, formatPlan, planConfig, syncConfig };

package/dist/config.d.ts

@@ -0,0 +1,104 @@
+import { Billow } from './index.js';
+import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-C4RIMgH_.js';
+import './billing-status-BZQN_gm7.js';
+import './status.js';
+import './credits-C3Fe3TO0.js';
+import 'zod';
+
+/**
+ * Code-as-config sync (ARCHITECTURE §12 "code-as-config sync"). Keep your catalog
+ * — features, products, coupons — in a typed config file and `syncConfig` it into
+ * a billow server. Sync is **declarative and additive**: it creates whatever is
+ * missing and *reports drift* on what already exists, but never deletes and never
+ * rewrites an existing product (catalog edits are made deliberately through the
+ * dashboard/API — ADR-0015 — not silently on every sync).
+ *
+ *   import { defineConfig, syncConfig } from "@usebillow/sdk/config";
+ *   const config = defineConfig({ features: [...], products: [...], coupons: [...] });
+ *   await syncConfig(billow, config, { onProgress: console.log });
+ */
+
+interface ConfigFeature {
+    slug: string;
+    name: string;
+    kind: FeatureKind;
+    /**
+     * For a `metered` feature: how its usage aggregates (ADR-0011). Omit to get a `sum`
+     * meter. Set it here so sync creates the meter you want instead of the default — after
+     * usage is recorded the aggregation can no longer change.
+     */
+    meter?: MeterConfig;
+}
+/** A product entry — the same shape as `billow.products.create`. */
+type ConfigProduct = CreateProductInput;
+/**
+ * A coupon entry. Unlike `billow.coupons.create`, the `code` is **required** — it
+ * is the stable identity sync diffs against (a code-less coupon can't be matched).
+ */
+type ConfigCoupon = Omit<CreateCouponInput, "code"> & {
+    code: string;
+};
+interface BillowConfig {
+    features?: ConfigFeature[];
+    products?: ConfigProduct[];
+    coupons?: ConfigCoupon[];
+}
+/** Identity helper — returns its argument, typed, for editor completion + checks. */
+declare function defineConfig(config: BillowConfig): BillowConfig;
+type SyncAction = "create" | "unchanged" | "drift";
+interface SyncItem {
+    kind: "feature" | "product" | "coupon";
+    /** Slug (features/products) or code (coupons). */
+    id: string;
+    action: SyncAction;
+    /** For `drift`: which aspects differ from the server (human-readable). */
+    changes?: string[];
+}
+interface SyncPlan {
+    features: SyncItem[];
+    products: SyncItem[];
+    coupons: SyncItem[];
+}
+interface SyncResult {
+    plan: SyncPlan;
+    created: {
+        features: string[];
+        products: string[];
+        coupons: string[];
+    };
+    /**
+     * Items that still differ from the config after the sync - reported, not applied. With
+     * `applyMetadata`, product metadata that was written is removed from here (see `applied`).
+     */
+    drift: SyncItem[];
+    /** Product slugs whose metadata was written this run (only when `applyMetadata` is set). */
+    applied: {
+        productMetadata: string[];
+    };
+}
+/**
+ * Diff a config against the server without writing anything. Each entry is
+ * `create` (missing), `unchanged` (matches), or `drift` (exists but differs).
+ */
+declare function planConfig(billow: Billow, config: BillowConfig): Promise<SyncPlan>;
+/**
+ * Apply a config: create everything missing (features → products → coupons, the
+ * dependency order, since products reference feature slugs), and return what was
+ * created plus any drift it found.
+ *
+ * Structural drift (prices, entitlements, name, ...) is never auto-applied - those edits are
+ * version-bearing (ADR-0015: collected at renewal) and belong to a deliberate `products.update`.
+ * With `applyMetadata: true`, product **metadata** drift IS written, because metadata lives on
+ * the product row (not the version), so updating it is version-independent and cannot rewrite
+ * billed history. This closes the write-side gap where a config's product metadata could only
+ * be reported, never pushed. The write is a full-map replace (config is authoritative): a key
+ * present on the server but absent from the config is cleared.
+ */
+declare function syncConfig(billow: Billow, config: BillowConfig, opts?: {
+    onProgress?: (message: string) => void;
+    applyMetadata?: boolean;
+}): Promise<SyncResult>;
+/** A one-line-per-item summary of a plan, for CLI output. */
+declare function formatPlan(plan: SyncPlan): string;
+
+export { type BillowConfig, type ConfigCoupon, type ConfigFeature, type ConfigProduct, type SyncAction, type SyncItem, type SyncPlan, type SyncResult, defineConfig, formatPlan, planConfig, syncConfig };

package/dist/config.js

@@ -0,0 +1,228 @@
+// src/config.ts
+function defineConfig(config) {
+  return config;
+}
+async function planConfig(billow, config) {
+  const [features, products, coupons] = await Promise.all([
+    billow.features.list({ limit: 100 }).listAll(),
+    billow.products.list(),
+    billow.coupons.list({ limit: 100 }).listAll()
+  ]);
+  const featureBySlug = new Map(features.map((f) => [f.slug, f]));
+  const productBySlug = new Map(products.map((p) => [p.slug, p]));
+  const couponByCode = new Map(coupons.filter((c) => c.code).map((c) => [c.code, c]));
+  return {
+    features: (config.features ?? []).map((f) => planFeature(f, featureBySlug.get(f.slug))),
+    products: (config.products ?? []).map((p) => planProduct(p, productBySlug.get(p.slug))),
+    coupons: (config.coupons ?? []).map((c) => planCoupon(c, couponByCode.get(c.code)))
+  };
+}
+async function syncConfig(billow, config, opts = {}) {
+  const plan = await planConfig(billow, config);
+  const progress = opts.onProgress ?? (() => {
+  });
+  const created = {
+    features: await createMissing(
+      plan.features,
+      config.features ?? [],
+      (f) => f.slug,
+      "feature",
+      (f) => billow.features.create(f),
+      progress
+    ),
+    products: await createMissing(
+      plan.products,
+      config.products ?? [],
+      (p) => p.slug,
+      "product",
+      (p) => billow.products.create(p),
+      progress
+    ),
+    coupons: await createMissing(
+      plan.coupons,
+      config.coupons ?? [],
+      (c) => c.code,
+      "coupon",
+      (c) => billow.coupons.create(c),
+      progress
+    )
+  };
+  const applied = { productMetadata: [] };
+  if (opts.applyMetadata) {
+    const isMetadataChange = (c) => c.startsWith("metadata");
+    const productDefBySlug = new Map((config.products ?? []).map((p) => [p.slug, p]));
+    for (const item of plan.products) {
+      if (item.action !== "drift" || !item.changes?.some(isMetadataChange)) continue;
+      const def = productDefBySlug.get(item.id);
+      if (!def) continue;
+      await billow.products.update(item.id, { metadata: def.metadata ?? {} });
+      applied.productMetadata.push(item.id);
+      progress(`~ product ${item.id} (metadata applied)`);
+      item.changes = item.changes.filter((c) => !isMetadataChange(c));
+      if (item.changes.length === 0) item.action = "unchanged";
+    }
+  }
+  const drift = [...plan.features, ...plan.products, ...plan.coupons].filter(
+    (i) => i.action === "drift"
+  );
+  return { plan, created, drift, applied };
+}
+async function createMissing(items, defs, idOf, label, create, progress) {
+  const byId = new Map(defs.map((d) => [idOf(d), d]));
+  const created = [];
+  for (const item of items) {
+    if (item.action !== "create") continue;
+    const def = byId.get(item.id);
+    if (!def) continue;
+    await create(def);
+    created.push(item.id);
+    progress(`+ ${label} ${item.id}`);
+  }
+  return created;
+}
+function formatPlan(plan) {
+  const mark = { create: "+", unchanged: "=", drift: "~" };
+  const lines = [];
+  for (const item of [...plan.features, ...plan.products, ...plan.coupons]) {
+    const detail = item.changes?.length ? `  (${item.changes.join(", ")})` : "";
+    lines.push(`${mark[item.action]} ${item.kind} ${item.id}${detail}`);
+  }
+  return lines.join("\n");
+}
+function planFeature(def, existing) {
+  if (!existing) return { kind: "feature", id: def.slug, action: "create" };
+  const changes = diffFields([
+    ["name", def.name, existing.name],
+    ["kind", def.kind, existing.kind],
+    // A metered feature with no explicit meter gets a `sum` meter server-side; normalize
+    // both sides so an aggregation change is reported as drift, not "unchanged".
+    [
+      "meter",
+      normMeter(def.kind, def.meter),
+      normMeter(existing.kind, existing.meter ?? void 0)
+    ]
+  ]);
+  return { kind: "feature", id: def.slug, action: changes.length ? "drift" : "unchanged", changes };
+}
+function planProduct(def, existing) {
+  if (!existing) return { kind: "product", id: def.slug, action: "create" };
+  const changes = diffFields([
+    ["name", def.name, existing.name],
+    ["type", def.type, existing.type],
+    ["isAddOn", def.isAddOn ?? false, existing.isAddOn],
+    ["metadata", normMeta(def.metadata), normMeta(existing.metadata)]
+  ]);
+  if (!sameSet(def.prices.map(normPrice), (existing.prices ?? []).map(normPrice))) {
+    changes.push("prices");
+  }
+  if (!sameSet((def.entitlements ?? []).map(normEnt), (existing.entitlements ?? []).map(normEnt))) {
+    changes.push("entitlements");
+  }
+  return { kind: "product", id: def.slug, action: changes.length ? "drift" : "unchanged", changes };
+}
+function planCoupon(def, existing) {
+  if (!existing) return { kind: "coupon", id: def.code, action: "create" };
+  const changes = diffFields([
+    ["kind", def.kind, existing.kind],
+    ["value", def.value, existing.value],
+    ["currency", def.currency?.toUpperCase() ?? null, existing.currency],
+    ["duration", def.duration, existing.duration],
+    ["durationCycles", def.durationCycles ?? null, existing.durationCycles],
+    ["maxRedemptions", def.maxRedemptions ?? null, existing.maxRedemptions],
+    ["expiresAt", epochOrNull(def.expiresAt), epochOrNull(existing.expiresAt)]
+  ]);
+  if (!sameSet(def.productRestrictions ?? [], existing.productRestrictions ?? [])) {
+    changes.push("productRestrictions");
+  }
+  return { kind: "coupon", id: def.code, action: changes.length ? "drift" : "unchanged", changes };
+}
+function normMeta(metadata) {
+  const entries = Object.entries(metadata ?? {}).sort(
+    (a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0
+  );
+  return JSON.stringify(entries);
+}
+function normMeter(kind, meter) {
+  if (kind !== "metered") return null;
+  return JSON.stringify({
+    aggregation: meter?.aggregation ?? "sum",
+    eventProperty: meter?.eventProperty ?? null,
+    // The filter list and each filter's values are unordered sets — sort both so a mere
+    // reordering isn't reported as drift (matches the server's no-op semantics).
+    filters: (meter?.filters ?? []).map((f) => ({ key: f.key, values: [...f.values].sort() })).sort((a, b) => {
+      if (a.key !== b.key) return a.key < b.key ? -1 : 1;
+      const av = JSON.stringify(a.values);
+      const bv = JSON.stringify(b.values);
+      return av < bv ? -1 : av > bv ? 1 : 0;
+    }),
+    roundingMode: meter?.roundingMode ?? "none",
+    roundingScale: meter?.roundingScale ?? null,
+    // Reset anchoring (plan 07). Server omits these for cycle meters, so default to cycle/null
+    // on both sides — an omitted anchor and an explicit `cycle` compare equal (no false drift).
+    resetAnchor: meter?.resetAnchor ?? "cycle",
+    resetTz: meter?.resetTz ?? null
+  });
+}
+function normPrice(p) {
+  return JSON.stringify({
+    kind: p.kind,
+    interval: p.interval ?? null,
+    intervalCount: p.intervalCount ?? 1,
+    amount: p.amount,
+    currency: p.currency.toUpperCase(),
+    meterFeature: p.meterFeature ?? null,
+    // Usage prices default to graduated server-side; normalize so a model change
+    // (or package/percentage param change) is detected as drift, not "unchanged".
+    usageModel: p.kind === "usage" ? p.usageModel ?? "graduated" : null,
+    usageTiers: canonTiers(p.usageTiers),
+    packageSize: p.packageSize ?? null,
+    rateBps: p.rateBps ?? null,
+    // Tax overrides (Phase E) — null = inherit org default; included so a change
+    // is detected as drift.
+    taxRateBps: p.taxRateBps ?? null,
+    taxBehavior: p.taxBehavior ?? null
+  });
+}
+function canonTiers(tiers) {
+  if (!Array.isArray(tiers)) return null;
+  return tiers.map((t) => {
+    const tier = t ?? {};
+    return {
+      upTo: tier.upTo ?? null,
+      unitAmount: tier.unitAmount ?? null,
+      flatAmount: tier.flatAmount ?? null
+    };
+  });
+}
+function normEnt(e) {
+  return JSON.stringify({
+    feature: e.feature,
+    allowance: e.allowance ?? null,
+    resetInterval: e.resetInterval ?? null,
+    rollover: e.rollover ?? false
+  });
+}
+function diffFields(fields) {
+  const changes = [];
+  for (const [name, want, have] of fields) {
+    if (want !== have) changes.push(`${name}: ${fmt(have)} \u2192 ${fmt(want)}`);
+  }
+  return changes;
+}
+function sameSet(a, b) {
+  if (a.length !== b.length) return false;
+  const sortedA = [...a].sort();
+  const sortedB = [...b].sort();
+  return sortedA.every((v, i) => v === sortedB[i]);
+}
+function epochOrNull(value) {
+  return value ? new Date(value).getTime() : null;
+}
+function fmt(value) {
+  if (value === null || value === void 0) return "\u2205";
+  return String(value);
+}
+
+export { defineConfig, formatPlan, planConfig, syncConfig };
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":"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","file":"config.js","sourcesContent":["/**\n * Code-as-config sync (ARCHITECTURE §12 \"code-as-config sync\"). Keep your catalog\n * — features, products, coupons — in a typed config file and `syncConfig` it into\n * a billow server. Sync is **declarative and additive**: it creates whatever is\n * missing and *reports drift* on what already exists, but never deletes and never\n * rewrites an existing product (catalog edits are made deliberately through the\n * dashboard/API — ADR-0015 — not silently on every sync).\n *\n *   import { defineConfig, syncConfig } from \"@usebillow/sdk/config\";\n *   const config = defineConfig({ features: [...], products: [...], coupons: [...] });\n *   await syncConfig(billow, config, { onProgress: console.log });\n */\nimport type {\n  Billow,\n  Coupon,\n  CreateCouponInput,\n  CreateProductInput,\n  Feature,\n  FeatureKind,\n  MeterConfig,\n  Product,\n} from \"./index\";\n\nexport interface ConfigFeature {\n  slug: string;\n  name: string;\n  kind: FeatureKind;\n  /**\n   * For a `metered` feature: how its usage aggregates (ADR-0011). Omit to get a `sum`\n   * meter. Set it here so sync creates the meter you want instead of the default — after\n   * usage is recorded the aggregation can no longer change.\n   */\n  meter?: MeterConfig;\n}\n\n/** A product entry — the same shape as `billow.products.create`. */\nexport type ConfigProduct = CreateProductInput;\n\n/**\n * A coupon entry. Unlike `billow.coupons.create`, the `code` is **required** — it\n * is the stable identity sync diffs against (a code-less coupon can't be matched).\n */\nexport type ConfigCoupon = Omit<CreateCouponInput, \"code\"> & { code: string };\n\nexport interface BillowConfig {\n  features?: ConfigFeature[];\n  products?: ConfigProduct[];\n  coupons?: ConfigCoupon[];\n}\n\n/** Identity helper — returns its argument, typed, for editor completion + checks. */\nexport function defineConfig(config: BillowConfig): BillowConfig {\n  return config;\n}\n\nexport type SyncAction = \"create\" | \"unchanged\" | \"drift\";\n\nexport interface SyncItem {\n  kind: \"feature\" | \"product\" | \"coupon\";\n  /** Slug (features/products) or code (coupons). */\n  id: string;\n  action: SyncAction;\n  /** For `drift`: which aspects differ from the server (human-readable). */\n  changes?: string[];\n}\n\nexport interface SyncPlan {\n  features: SyncItem[];\n  products: SyncItem[];\n  coupons: SyncItem[];\n}\n\nexport interface SyncResult {\n  plan: SyncPlan;\n  created: { features: string[]; products: string[]; coupons: string[] };\n  /**\n   * Items that still differ from the config after the sync - reported, not applied. With\n   * `applyMetadata`, product metadata that was written is removed from here (see `applied`).\n   */\n  drift: SyncItem[];\n  /** Product slugs whose metadata was written this run (only when `applyMetadata` is set). */\n  applied: { productMetadata: string[] };\n}\n\n/**\n * Diff a config against the server without writing anything. Each entry is\n * `create` (missing), `unchanged` (matches), or `drift` (exists but differs).\n */\nexport async function planConfig(billow: Billow, config: BillowConfig): Promise<SyncPlan> {\n  // Collect the whole catalog in as few round-trips as the server allows (page size caps at 100).\n  const [features, products, coupons] = await Promise.all([\n    billow.features.list({ limit: 100 }).listAll(),\n    billow.products.list(),\n    billow.coupons.list({ limit: 100 }).listAll(),\n  ]);\n\n  const featureBySlug = new Map(features.map((f) => [f.slug, f]));\n  const productBySlug = new Map(products.map((p) => [p.slug, p]));\n  const couponByCode = new Map(coupons.filter((c) => c.code).map((c) => [c.code as string, c]));\n\n  return {\n    features: (config.features ?? []).map((f) => planFeature(f, featureBySlug.get(f.slug))),\n    products: (config.products ?? []).map((p) => planProduct(p, productBySlug.get(p.slug))),\n    coupons: (config.coupons ?? []).map((c) => planCoupon(c, couponByCode.get(c.code))),\n  };\n}\n\n/**\n * Apply a config: create everything missing (features → products → coupons, the\n * dependency order, since products reference feature slugs), and return what was\n * created plus any drift it found.\n *\n * Structural drift (prices, entitlements, name, ...) is never auto-applied - those edits are\n * version-bearing (ADR-0015: collected at renewal) and belong to a deliberate `products.update`.\n * With `applyMetadata: true`, product **metadata** drift IS written, because metadata lives on\n * the product row (not the version), so updating it is version-independent and cannot rewrite\n * billed history. This closes the write-side gap where a config's product metadata could only\n * be reported, never pushed. The write is a full-map replace (config is authoritative): a key\n * present on the server but absent from the config is cleared.\n */\nexport async function syncConfig(\n  billow: Billow,\n  config: BillowConfig,\n  opts: { onProgress?: (message: string) => void; applyMetadata?: boolean } = {},\n): Promise<SyncResult> {\n  const plan = await planConfig(billow, config);\n  const progress = opts.onProgress ?? (() => {});\n\n  // Create in dependency order — features → products → coupons — since products\n  // reference feature slugs. Each kind is created before the next begins.\n  const created = {\n    features: await createMissing(\n      plan.features,\n      config.features ?? [],\n      (f) => f.slug,\n      \"feature\",\n      (f) => billow.features.create(f),\n      progress,\n    ),\n    products: await createMissing(\n      plan.products,\n      config.products ?? [],\n      (p) => p.slug,\n      \"product\",\n      (p) => billow.products.create(p),\n      progress,\n    ),\n    coupons: await createMissing(\n      plan.coupons,\n      config.coupons ?? [],\n      (c) => c.code,\n      \"coupon\",\n      (c) => billow.coupons.create(c),\n      progress,\n    ),\n  };\n\n  // Version-independent metadata is the one field safe to auto-write (a product-row column,\n  // not a version). Apply it before computing drift so a resolved item drops out of the report.\n  const applied = { productMetadata: [] as string[] };\n  if (opts.applyMetadata) {\n    const isMetadataChange = (c: string) => c.startsWith(\"metadata\");\n    const productDefBySlug = new Map((config.products ?? []).map((p) => [p.slug, p]));\n    for (const item of plan.products) {\n      if (item.action !== \"drift\" || !item.changes?.some(isMetadataChange)) continue;\n      const def = productDefBySlug.get(item.id);\n      if (!def) continue;\n      await billow.products.update(item.id, { metadata: def.metadata ?? {} });\n      applied.productMetadata.push(item.id);\n      progress(`~ product ${item.id} (metadata applied)`);\n      // Reflect the write in the plan: drop metadata from this item, and mark it unchanged if\n      // it had no other drift, so the returned drift no longer reports what we just fixed.\n      item.changes = item.changes.filter((c) => !isMetadataChange(c));\n      if (item.changes.length === 0) item.action = \"unchanged\";\n    }\n  }\n\n  const drift = [...plan.features, ...plan.products, ...plan.coupons].filter(\n    (i) => i.action === \"drift\",\n  );\n  return { plan, created, drift, applied };\n}\n\n/**\n * Create the `action: \"create\"` items of one kind, matching each plan item back to\n * its config definition by id (a Map, not a scan), and return the ids created.\n */\nasync function createMissing<T>(\n  items: SyncItem[],\n  defs: T[],\n  idOf: (def: T) => string,\n  label: string,\n  create: (def: T) => Promise<unknown>,\n  progress: (message: string) => void,\n): Promise<string[]> {\n  const byId = new Map(defs.map((d) => [idOf(d), d]));\n  const created: string[] = [];\n  for (const item of items) {\n    if (item.action !== \"create\") continue;\n    const def = byId.get(item.id);\n    if (!def) continue;\n    await create(def);\n    created.push(item.id);\n    progress(`+ ${label} ${item.id}`);\n  }\n  return created;\n}\n\n/** A one-line-per-item summary of a plan, for CLI output. */\nexport function formatPlan(plan: SyncPlan): string {\n  const mark = { create: \"+\", unchanged: \"=\", drift: \"~\" } as const;\n  const lines: string[] = [];\n  for (const item of [...plan.features, ...plan.products, ...plan.coupons]) {\n    const detail = item.changes?.length ? `  (${item.changes.join(\", \")})` : \"\";\n    lines.push(`${mark[item.action]} ${item.kind} ${item.id}${detail}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Per-entity diffing\n// ---------------------------------------------------------------------------\n\nfunction planFeature(def: ConfigFeature, existing: Feature | undefined): SyncItem {\n  if (!existing) return { kind: \"feature\", id: def.slug, action: \"create\" };\n  const changes = diffFields([\n    [\"name\", def.name, existing.name],\n    [\"kind\", def.kind, existing.kind],\n    // A metered feature with no explicit meter gets a `sum` meter server-side; normalize\n    // both sides so an aggregation change is reported as drift, not \"unchanged\".\n    [\n      \"meter\",\n      normMeter(def.kind, def.meter),\n      normMeter(existing.kind, existing.meter ?? undefined),\n    ],\n  ]);\n  return { kind: \"feature\", id: def.slug, action: changes.length ? \"drift\" : \"unchanged\", changes };\n}\n\nfunction planProduct(def: ConfigProduct, existing: Product | undefined): SyncItem {\n  if (!existing) return { kind: \"product\", id: def.slug, action: \"create\" };\n  const changes = diffFields([\n    [\"name\", def.name, existing.name],\n    [\"type\", def.type, existing.type],\n    [\"isAddOn\", def.isAddOn ?? false, existing.isAddOn],\n    [\"metadata\", normMeta(def.metadata), normMeta(existing.metadata)],\n  ]);\n  if (!sameSet(def.prices.map(normPrice), (existing.prices ?? []).map(normPrice))) {\n    changes.push(\"prices\");\n  }\n  if (!sameSet((def.entitlements ?? []).map(normEnt), (existing.entitlements ?? []).map(normEnt))) {\n    changes.push(\"entitlements\");\n  }\n  return { kind: \"product\", id: def.slug, action: changes.length ? \"drift\" : \"unchanged\", changes };\n}\n\nfunction planCoupon(def: ConfigCoupon, existing: Coupon | undefined): SyncItem {\n  if (!existing) return { kind: \"coupon\", id: def.code, action: \"create\" };\n  const changes = diffFields([\n    [\"kind\", def.kind, existing.kind],\n    [\"value\", def.value, existing.value],\n    [\"currency\", def.currency?.toUpperCase() ?? null, existing.currency],\n    [\"duration\", def.duration, existing.duration],\n    [\"durationCycles\", def.durationCycles ?? null, existing.durationCycles],\n    [\"maxRedemptions\", def.maxRedemptions ?? null, existing.maxRedemptions],\n    [\"expiresAt\", epochOrNull(def.expiresAt), epochOrNull(existing.expiresAt)],\n  ]);\n  if (!sameSet(def.productRestrictions ?? [], existing.productRestrictions ?? [])) {\n    changes.push(\"productRestrictions\");\n  }\n  return { kind: \"coupon\", id: def.code, action: changes.length ? \"drift\" : \"unchanged\", changes };\n}\n\n// ---------------------------------------------------------------------------\n// Normalization helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Canonicalize a feature's meter for drift comparison. A boolean feature has no meter\n * (null); a metered feature with no explicit config gets the server's `sum` default, so\n * an omitted meter and an explicit `sum` meter compare equal. Filter objects are reshaped\n * to a fixed key order (a jsonb round-trip can reorder keys) while list order is preserved.\n */\n/**\n * Canonicalize a product's metadata map for drift comparison: sort keys so a mere\n * key-order difference (jsonb round-trips keys in insertion order) isn't reported as drift.\n * An omitted map and an empty map compare equal.\n */\nfunction normMeta(metadata: Record<string, string> | undefined): string {\n  const entries = Object.entries(metadata ?? {}).sort((a, b) =>\n    a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0,\n  );\n  return JSON.stringify(entries);\n}\n\nfunction normMeter(kind: FeatureKind, meter: MeterConfig | undefined): string | null {\n  if (kind !== \"metered\") return null;\n  return JSON.stringify({\n    aggregation: meter?.aggregation ?? \"sum\",\n    eventProperty: meter?.eventProperty ?? null,\n    // The filter list and each filter's values are unordered sets — sort both so a mere\n    // reordering isn't reported as drift (matches the server's no-op semantics).\n    filters: (meter?.filters ?? [])\n      .map((f) => ({ key: f.key, values: [...f.values].sort() }))\n      // Total order: by key, then by (already-sorted) values, so same-key duplicate\n      // filters canonicalize too rather than keeping input order.\n      .sort((a, b) => {\n        if (a.key !== b.key) return a.key < b.key ? -1 : 1;\n        const av = JSON.stringify(a.values);\n        const bv = JSON.stringify(b.values);\n        return av < bv ? -1 : av > bv ? 1 : 0;\n      }),\n    roundingMode: meter?.roundingMode ?? \"none\",\n    roundingScale: meter?.roundingScale ?? null,\n    // Reset anchoring (plan 07). Server omits these for cycle meters, so default to cycle/null\n    // on both sides — an omitted anchor and an explicit `cycle` compare equal (no false drift).\n    resetAnchor: meter?.resetAnchor ?? \"cycle\",\n    resetTz: meter?.resetTz ?? null,\n  });\n}\n\nfunction normPrice(p: {\n  kind: string;\n  interval?: string | null;\n  intervalCount?: number;\n  amount: number;\n  currency: string;\n  meterFeature?: string | null;\n  usageModel?: string | null;\n  usageTiers?: unknown;\n  packageSize?: number | null;\n  rateBps?: number | null;\n  taxRateBps?: number | null;\n  taxBehavior?: string | null;\n}): string {\n  return JSON.stringify({\n    kind: p.kind,\n    interval: p.interval ?? null,\n    intervalCount: p.intervalCount ?? 1,\n    amount: p.amount,\n    currency: p.currency.toUpperCase(),\n    meterFeature: p.meterFeature ?? null,\n    // Usage prices default to graduated server-side; normalize so a model change\n    // (or package/percentage param change) is detected as drift, not \"unchanged\".\n    usageModel: p.kind === \"usage\" ? (p.usageModel ?? \"graduated\") : null,\n    usageTiers: canonTiers(p.usageTiers),\n    packageSize: p.packageSize ?? null,\n    rateBps: p.rateBps ?? null,\n    // Tax overrides (Phase E) — null = inherit org default; included so a change\n    // is detected as drift.\n    taxRateBps: p.taxRateBps ?? null,\n    taxBehavior: p.taxBehavior ?? null,\n  });\n}\n\n/**\n * Canonicalize usage tiers to a fixed key order before comparison. A jsonb\n * round-trip can reorder object keys, so raw `JSON.stringify` would report drift\n * on an unchanged tier set — normalize each tier to `{ upTo, unitAmount, flatAmount }`.\n */\nfunction canonTiers(\n  tiers: unknown,\n): { upTo: unknown; unitAmount: unknown; flatAmount: unknown }[] | null {\n  if (!Array.isArray(tiers)) return null;\n  return tiers.map((t) => {\n    const tier = (t ?? {}) as { upTo?: unknown; unitAmount?: unknown; flatAmount?: unknown };\n    return {\n      upTo: tier.upTo ?? null,\n      unitAmount: tier.unitAmount ?? null,\n      flatAmount: tier.flatAmount ?? null,\n    };\n  });\n}\n\nfunction normEnt(e: {\n  feature: string;\n  allowance?: number | null;\n  resetInterval?: string | null;\n  rollover?: boolean;\n}): string {\n  return JSON.stringify({\n    feature: e.feature,\n    allowance: e.allowance ?? null,\n    resetInterval: e.resetInterval ?? null,\n    rollover: e.rollover ?? false,\n  });\n}\n\n/** Field-by-field equality, returning `\"field: a → b\"` for each mismatch. */\nfunction diffFields(fields: [string, unknown, unknown][]): string[] {\n  const changes: string[] = [];\n  for (const [name, want, have] of fields) {\n    if (want !== have) changes.push(`${name}: ${fmt(have)} → ${fmt(want)}`);\n  }\n  return changes;\n}\n\n/** Order-insensitive equality of two string lists (compared as multisets). */\nfunction sameSet(a: string[], b: string[]): boolean {\n  if (a.length !== b.length) return false;\n  const sortedA = [...a].sort();\n  const sortedB = [...b].sort();\n  return sortedA.every((v, i) => v === sortedB[i]);\n}\n\nfunction epochOrNull(value: string | null | undefined): number | null {\n  return value ? new Date(value).getTime() : null;\n}\n\nfunction fmt(value: unknown): string {\n  if (value === null || value === undefined) return \"∅\";\n  return String(value);\n}\n"]}