@fayz-ai/sdk 0.9.0-next.1 → 0.10.0

package/dist/chunk-HA5O3CW7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deprecations.json","../src/deprecations.ts"],"names":[],"mappings":"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","file":"chunk-HA5O3CW7.js","sourcesContent":["{\n  \"registryVersion\": 1,\n  \"policy\": {\n    \"minMinorsBeforeRemoval\": 2,\n    \"summary\": \"Nothing is removed without a shim, and the deprecation is enumerable (spine I10). A deprecation is ANNOUNCED in a minor release and REMOVED no earlier than two minor releases later, so a store always has one whole release in which both the old and the new input work. Every shim's warning names its replacement (I2). Every row here carries a codemod id; a codemod that cannot be safe refuses and names the decision a human must make.\"\n  },\n  \"deprecations\": [\n    {\n      \"id\": \"admin.package.saas\",\n      \"package\": \"@fayz-ai/saas\",\n      \"surface\": \"package-name\",\n      \"title\": \"the @fayz-ai/saas package name\",\n      \"deprecatedIn\": \"0.10.0\",\n      \"removeIn\": \"0.12.0\",\n      \"replacement\": \"@fayz-ai/admin — same exports, same subpaths (/ui, /db, /org, /billing, /permissions), renamed because the package is the admin surface (shell, CRUD engine, org, billing, permissions), not the business model\",\n      \"shim\": \"packages/saas is now a thin package that re-exports @fayz-ai/admin, so an app that has not migrated builds and runs unchanged. What it costs is a second package in the graph and one console warning per entry point per session. It ships no implementation, so there is no behaviour to drift.\",\n      \"where\": [\"packages/saas/src/index.ts\", \"packages/saas/package.json\", \"packages/sdk/src/vite.ts\"],\n      \"detect\": \"The app's package.json depends on @fayz-ai/saas, or any file under src/ imports from '@fayz-ai/saas'.\",\n      \"codemod\": \"admin.saas-package-rename\",\n      \"reference\": \"packages/saas/README.md\"\n    },\n    {\n      \"id\": \"shop.provider.productMetadata\",\n      \"package\": \"@fayz-ai/sdk\",\n      \"surface\": \"provider-option\",\n      \"title\": \"createFayzShopProvider({ productMetadata })\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"product variants — plg_shop_product_variants, read through products.bySlug / getProductVariants (admin > product > variants)\",\n      \"shim\": \"The overlay is still merged into each product's metadata for DISPLAY, so a store passing it keeps rendering. What it no longer does is define the option axes checkout sells: 0028 variants are the sellable unit and 0029 prices and names an order line from them. An axis that exists only in the overlay renders a picker that resolves to no variant.\",\n      \"where\": [\"packages/sdk/src/shop.ts\", \"packages/storefront/src/data/product-options.ts\"],\n      \"detect\": \"The app passes `productMetadata` to createFayzShopProvider (usually src/config/shop.ts), or the running provider warns once per session.\",\n      \"codemod\": \"shop.product-metadata-overlay\",\n      \"reference\": \"docs/storefront/storefront-architecture-spine.md (M5), docs/storefront/storefront-contract.md\"\n    },\n    {\n      \"id\": \"storefront.commerce.discounts\",\n      \"package\": \"@fayz-ai/storefront\",\n      \"surface\": \"document-field\",\n      \"title\": \"config.discounts / commerce.discounts (percent coupon codes)\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"promotions.promotions — a rule-engine Promotion with an eligibility rule on `code` and a percentage application method (spine M6, I8)\",\n      \"shim\": \"The provider still honours the legacy path: every `{code, percent}` entry is translated by storefrontDiscountToPromotion and evaluated by the ONE rule engine, so the money is identical. What the legacy shape cannot express is everything the engine exists for — buy-N-get-M, tiers, minimum subtotal, product/category scoping, automatic application.\",\n      \"where\": [\n        \"packages/shop/src/rules/adapter.ts\",\n        \"packages/storefront/src/hooks/use-discount-validator.ts\",\n        \"packages/storefront/src/document/sections.ts\"\n      ],\n      \"detect\": \"commerce.discounts is present in the Store Document (config.discounts in a config-derived document).\",\n      \"codemod\": \"commerce.discounts-to-promotions\",\n      \"reference\": \"docs/storefront/storefront-architecture-spine.md (M6, I8), docs/storefront/storefront-contract.md\"\n    },\n    {\n      \"id\": \"shop.inventory.directCountWrite\",\n      \"package\": \"@fayz-ai/shop\",\n      \"surface\": \"sql-column-write\",\n      \"title\": \"direct writes to plg_shop_product_variants.inventory_count (and plg_shop_products.inventory_count)\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"insert a plg_shop_stock_movements row (receipt / adjustment / loss / count) — the ledger is the truth and inventory_count is its mirror\",\n      \"shim\": \"0036 turns a direct write to a VARIANT count into an `adjustment` movement with reason `legacy_write`, and 0037 forwards a write to the PRODUCT count to that product's default variant the same way. Both RAISE a WARNING. The quantities are exact; the taxonomy is not — the shim is told a number changed and never why, so a sale arriving this way is recorded as an adjustment with no order_id.\",\n      \"where\": [\n        \"packages/shop/migrations/0036_inventory_count_mirror.sql\",\n        \"packages/shop/migrations/0037_default_variant.sql\"\n      ],\n      \"signals\": [\n        \"DEPRECATED (I10): direct write to plg_shop_product_variants.inventory_count\",\n        \"DEPRECATED (I10): direct write to plg_shop_products.inventory_count\"\n      ],\n      \"detect\": \"Not visible in a store's repo: it is a property of the callers writing to a pool. Count the `legacy_write` reason in plg_shop_stock_movements — that count IS the migration backlog.\",\n      \"codemod\": \"shop.inventory-count-write\",\n      \"reference\": \"docs/storefront/inventory-model.md §6, §9 step 3\"\n    },\n    {\n      \"id\": \"shop.placeOrder.variantless\",\n      \"package\": \"@fayz-ai/shop\",\n      \"surface\": \"sql-code-path\",\n      \"title\": \"the variantless leg of shop_place_order\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"every product gets a default variant (migration 0037), and the variant is the universal sellable unit — the order line resolves a variant and the sale reaches the ledger\",\n      \"shim\": \"0039 keeps the leg: a line whose product has no variant at all still sells, guarded against the product-level inventory_count exactly as before 0034. It emits one enumerable NOTICE per order naming the products that took it, so the deprecation is countable rather than silent. Such a sale does NOT reach the stock ledger, so it answers none of the questions inventory-model.md §0 exists for.\",\n      \"where\": [\"packages/shop/migrations/0039_place_order_ledger.sql\"],\n      \"signals\": [\"shop_place_order: DEPRECATED variantless stock path used for\"],\n      \"detect\": \"Not visible in a store's repo: it is pool state. Its exit condition is in 0039's header — the count of products with no variant must read 0 on every pool.\",\n      \"codemod\": \"shop.place-order-variantless\",\n      \"reference\": \"docs/storefront/inventory-model.md §10 q6, packages/shop/migrations/0039_place_order_ledger.sql (header)\"\n    },\n    {\n      \"id\": \"storefront.backend.supabaseUrl\",\n      \"package\": \"@fayz-ai/storefront\",\n      \"surface\": \"document-field\",\n      \"title\": \"config.supabaseUrl / backend.supabaseUrl\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"auth.supabase.url\",\n      \"shim\": \"The legacy field still rides in the backend section so an old config round-trips losslessly, and hydrateStoreDocument still sets config.supabaseUrl from it.\",\n      \"where\": [\"packages/storefront/src/document/sections.ts\", \"packages/storefront/src/document/round-trip.ts\"],\n      \"detect\": \"backend.supabaseUrl is present in the Store Document.\",\n      \"codemod\": \"backend.supabase-to-auth\",\n      \"reference\": \"docs/storefront/storefront-contract.md\"\n    },\n    {\n      \"id\": \"storefront.backend.supabaseAnonKey\",\n      \"package\": \"@fayz-ai/storefront\",\n      \"surface\": \"document-field\",\n      \"title\": \"config.supabaseAnonKey / backend.supabaseAnonKey\",\n      \"deprecatedIn\": \"0.9.0\",\n      \"removeIn\": \"0.11.0\",\n      \"replacement\": \"auth.supabase.anonKey\",\n      \"shim\": \"The legacy field still rides in the backend section so an old config round-trips losslessly, and hydrateStoreDocument still sets config.supabaseAnonKey from it.\",\n      \"where\": [\"packages/storefront/src/document/sections.ts\", \"packages/storefront/src/document/round-trip.ts\"],\n      \"detect\": \"backend.supabaseAnonKey is present in the Store Document.\",\n      \"codemod\": \"backend.supabase-to-auth\",\n      \"reference\": \"docs/storefront/storefront-contract.md\"\n    }\n  ]\n}\n","import registry from './deprecations.json'\n\n// ---------------------------------------------------------------------------\n// The deprecation registry — spine I10, as ROWS.\n//\n// \"Nothing is removed without a shim, and the deprecation is enumerable.\" The\n// enumerable half is this file. WooCommerce keeps 60 deprecated hooks alive\n// through a DECLARED map dispatched at runtime; the reason that works at their\n// scale is that the map is data one tool can read. Ours is\n// `deprecations.json`, and it lives here for the same reason\n// `supported-surface.json` and `release-channels.json` do: @fayz-ai/sdk has no\n// dependencies, so every package, the CLI and a generated app can all read the\n// same table without anyone taking a dependency to do it.\n//\n// Two properties are load-bearing, and both are tested:\n//\n//   1. EVERY warning names its replacement (I2). A shim that can import this\n//      module builds its message with `deprecationMessage(id)`, so the warning\n//      and the row cannot drift. A shim that CANNOT — PL/pgSQL cannot import\n//      JSON — declares its literal marker text in the row's `signals`, and a\n//      test asserts that text really occurs in the named migration.\n//   2. EVERY row carries a codemod id. `fayz upgrade` either transforms the\n//      document or REFUSES and names the decision a human must make. A\n//      deprecation with no answer at all is the thing this registry exists to\n//      make impossible.\n//\n// The policy is a number, not a promise: a deprecation announced in 0.9 is\n// removed no earlier than 0.11, so a fleet always has one whole release in\n// which both the old and the new input work.\n// ---------------------------------------------------------------------------\n\n/** Where a deprecated thing lives, which is also what can detect it. */\nexport type FayzDeprecationSurface =\n  /** A field of the Store Document (and of the config it is derived from). */\n  | 'document-field'\n  /** An option passed to a provider factory in the store's own code. */\n  | 'provider-option'\n  /** A write to a column that is no longer the truth. */\n  | 'sql-column-write'\n  /** A branch of a SQL function kept alive for data that has not migrated. */\n  | 'sql-code-path'\n  /** A package name kept alive by a re-export after the package was renamed. */\n  | 'package-name'\n\nexport interface FayzDeprecation {\n  /** Stable dotted id. The key everything else references. */\n  id: string\n  /** Package that owns the surface. */\n  package: string\n  surface: FayzDeprecationSurface\n  /** What is deprecated, in the words the author would recognize. */\n  title: string\n  /** SDK minor in which the deprecation was ANNOUNCED. */\n  deprecatedIn: string\n  /** SDK minor in which the shim is REMOVED. */\n  removeIn: string\n  /** What to use instead. Every warning for this id names it (I2). */\n  replacement: string\n  /** What keeps working during the window, and precisely what it costs. */\n  shim: string\n  /** Repo paths where the shim lives — the registry has to be auditable. */\n  where: string[]\n  /**\n   * Literal marker text the shim emits at runtime, for shims that cannot build\n   * their message from this row (PL/pgSQL). Asserted against the real file by\n   * packages/shop/src/deprecations.test.ts.\n   */\n  signals?: string[]\n  /** How `fayz upgrade` finds it in a store — including \"you cannot, here is\n   *  the query that counts it in the pool instead\". */\n  detect: string\n  /** Codemod id that retires it. Never empty: a codemod that cannot be safe\n   *  exists anyway and refuses, naming the human decision. */\n  codemod: string\n  /** The design record. */\n  reference: string\n}\n\nexport interface FayzDeprecationPolicy {\n  /** Minimum number of minor releases between announcement and removal. */\n  minMinorsBeforeRemoval: number\n  summary: string\n}\n\nexport interface FayzDeprecationRegistry {\n  registryVersion: number\n  policy: FayzDeprecationPolicy\n  deprecations: FayzDeprecation[]\n}\n\nconst table = registry as unknown as FayzDeprecationRegistry\n\nexport const fayzDeprecationPolicy: FayzDeprecationPolicy = table.policy\n\n/** Every deprecation, in declaration order. */\nexport function listDeprecations(): FayzDeprecation[] {\n  return table.deprecations.map((row) => ({ ...row, where: [...row.where], signals: row.signals ? [...row.signals] : undefined }))\n}\n\n/** One row by id. Unknown ids throw and name the valid set (I2). */\nexport function getDeprecation(id: string): FayzDeprecation {\n  const row = table.deprecations.find((entry) => entry.id === id)\n  if (!row) {\n    throw new Error(\n      `Unknown deprecation id \"${id}\". Valid: ${table.deprecations.map((entry) => entry.id).join(', ')}`,\n    )\n  }\n  return row\n}\n\nexport function hasDeprecation(id: string): boolean {\n  return table.deprecations.some((entry) => entry.id === id)\n}\n\n/** Deprecation ids a given codemod retires. */\nexport function deprecationsForCodemod(codemod: string): FayzDeprecation[] {\n  return table.deprecations.filter((entry) => entry.codemod === codemod)\n}\n\n/** Every codemod id the registry references, deduped, in declaration order. */\nexport function listDeprecationCodemods(): string[] {\n  return [...new Set(table.deprecations.map((entry) => entry.codemod))]\n}\n\n/**\n * The warning text for a deprecation — the ONE place its prose is built.\n *\n * `context` is the caller's specifics (\"on variant abc\", \"at commerce.discounts[0]\");\n * it is appended, never substituted, so no caller can drop the replacement.\n */\nexport function deprecationMessage(id: string, context?: string): string {\n  const row = getDeprecation(id)\n  const where = context ? ` ${context}` : ''\n  return (\n    `DEPRECATED (${row.id}):${where} ${row.title} is deprecated since ${row.deprecatedIn} ` +\n    `and is REMOVED in ${row.removeIn}. Use instead: ${row.replacement}. ` +\n    `Migrate with \\`fayz upgrade\\` (codemod ${row.codemod}).`\n  )\n}\n\nconst warned = new Set<string>()\n\n/**\n * Warn once per id per session.\n *\n * Once, because the alternative is one line per request, which buries the\n * signal this exists to produce. The dedupe key is the ID ALONE, not\n * (id, context): a shim whose context varies per call would otherwise\n * re-warn forever and reintroduce exactly the flood the once-ness exists to\n * prevent. Returns true when it actually warned, so a shim is testable\n * without reading the console.\n */\nexport function warnDeprecated(id: string, context?: string): boolean {\n  if (warned.has(id)) return false\n  warned.add(id)\n  console.warn(deprecationMessage(id, context))\n  return true\n}\n\n/** Test seam — re-arms every once-per-session deprecation warning. */\nexport function resetDeprecationWarnings(): void {\n  warned.clear()\n}\n\nfunction minorOf(version: string): { major: number; minor: number } {\n  const [major = '0', minor = '0'] = version.split('.')\n  return { major: Number(major), minor: Number(minor) }\n}\n\n/**\n * Does `version` still get the shim?\n *\n * The question every consumer actually asks, answered from the table rather\n * than from a comment. Compared on (major, minor) because the policy is stated\n * in minors — a patch never removes anything.\n */\nexport function isDeprecationShimmed(id: string, version: string): boolean {\n  const row = getDeprecation(id)\n  const at = minorOf(version)\n  const gone = minorOf(row.removeIn)\n  if (at.major !== gone.major) return at.major < gone.major\n  return at.minor < gone.minor\n}\n\n/** Minors between announcement and removal — the policy's unit. */\nexport function deprecationWindowMinors(row: FayzDeprecation): number {\n  const from = minorOf(row.deprecatedIn)\n  const to = minorOf(row.removeIn)\n  // Majors are not commensurable with minors; a major bump is treated as\n  // \"far beyond the window\", which is the only safe reading.\n  if (to.major > from.major) return Number.POSITIVE_INFINITY\n  return to.minor - from.minor\n}\n\nexport { table as fayzDeprecationRegistry }\n"]}

package/dist/chunk-VRUPJGFZ.js

@@ -0,0 +1,135 @@
+// src/release-channels.json
+var release_channels_default = {
+  channels: {
+    stable: {
+      "@fayz-ai/sdk": "^0.10.0",
+      "@fayz-ai/admin": "^0.10.0",
+      "@fayz-ai/core": "^0.10.0",
+      "@fayz-ai/auth": "^0.10.0",
+      "@fayz-ai/ui": "^0.10.0",
+      "@fayz-ai/shop": "^0.10.0",
+      "@fayz-ai/storefront": "^0.10.0",
+      "@fayz-ai/portal": "^0.10.0",
+      "@fayz-ai/courses": "^0.10.0",
+      "@fayz-ai/db": "^0.10.0",
+      "@fayz-ai/plugin-agenda": "^0.9.1",
+      "@fayz-ai/plugin-auth": "^0.9.1",
+      "@fayz-ai/plugin-automations": "^0.9.1",
+      "@fayz-ai/plugin-blog": "^0.10.0",
+      "@fayz-ai/plugin-conversations": "^0.9.1",
+      "@fayz-ai/plugin-courses": "^0.9.1",
+      "@fayz-ai/plugin-crm": "^0.9.1",
+      "@fayz-ai/plugin-dashboard": "^0.9.1",
+      "@fayz-ai/plugin-financial": "^0.9.1",
+      "@fayz-ai/plugin-forms": "^0.9.1",
+      "@fayz-ai/plugin-inventory": "^0.9.1",
+      "@fayz-ai/plugin-marketing": "^0.9.1",
+      "@fayz-ai/plugin-menu": "^0.9.1",
+      "@fayz-ai/plugin-orders": "^0.9.1",
+      "@fayz-ai/plugin-payments": "^0.9.1",
+      "@fayz-ai/plugin-reports": "^0.9.1",
+      "@fayz-ai/plugin-reputation": "^0.9.1",
+      "@fayz-ai/plugin-shop": "^0.9.1",
+      "@fayz-ai/plugin-sites": "^0.9.1",
+      "@fayz-ai/plugin-tables": "^0.9.1",
+      "@fayz-ai/plugin-tasks": "^0.9.1"
+    },
+    latest: {
+      "@fayz-ai/sdk": "^0.10.0",
+      "@fayz-ai/admin": "^0.10.0",
+      "@fayz-ai/core": "^0.10.0",
+      "@fayz-ai/auth": "^0.10.0",
+      "@fayz-ai/ui": "^0.10.0",
+      "@fayz-ai/shop": "^0.10.0",
+      "@fayz-ai/storefront": "^0.10.0",
+      "@fayz-ai/portal": "^0.10.0",
+      "@fayz-ai/courses": "^0.10.0",
+      "@fayz-ai/db": "^0.10.0",
+      "@fayz-ai/plugin-agenda": "^0.9.1",
+      "@fayz-ai/plugin-auth": "^0.9.1",
+      "@fayz-ai/plugin-automations": "^0.9.1",
+      "@fayz-ai/plugin-blog": "^0.10.0",
+      "@fayz-ai/plugin-conversations": "^0.9.1",
+      "@fayz-ai/plugin-courses": "^0.9.1",
+      "@fayz-ai/plugin-crm": "^0.9.1",
+      "@fayz-ai/plugin-dashboard": "^0.9.1",
+      "@fayz-ai/plugin-financial": "^0.9.1",
+      "@fayz-ai/plugin-forms": "^0.9.1",
+      "@fayz-ai/plugin-inventory": "^0.9.1",
+      "@fayz-ai/plugin-marketing": "^0.9.1",
+      "@fayz-ai/plugin-menu": "^0.9.1",
+      "@fayz-ai/plugin-orders": "^0.9.1",
+      "@fayz-ai/plugin-payments": "^0.9.1",
+      "@fayz-ai/plugin-reports": "^0.9.1",
+      "@fayz-ai/plugin-reputation": "^0.9.1",
+      "@fayz-ai/plugin-shop": "^0.9.1",
+      "@fayz-ai/plugin-sites": "^0.9.1",
+      "@fayz-ai/plugin-tables": "^0.9.1",
+      "@fayz-ai/plugin-tasks": "^0.9.1"
+    },
+    preview: {
+      "@fayz-ai/sdk": "^0.10.0",
+      "@fayz-ai/admin": "^0.10.0",
+      "@fayz-ai/core": "^0.10.0",
+      "@fayz-ai/auth": "^0.10.0",
+      "@fayz-ai/ui": "^0.10.0",
+      "@fayz-ai/shop": "^0.10.0",
+      "@fayz-ai/storefront": "^0.10.0",
+      "@fayz-ai/portal": "^0.10.0",
+      "@fayz-ai/courses": "^0.10.0",
+      "@fayz-ai/db": "^0.10.0",
+      "@fayz-ai/plugin-agenda": "^0.9.1",
+      "@fayz-ai/plugin-auth": "^0.9.1",
+      "@fayz-ai/plugin-automations": "^0.9.1",
+      "@fayz-ai/plugin-blog": "^0.10.0",
+      "@fayz-ai/plugin-conversations": "^0.9.1",
+      "@fayz-ai/plugin-courses": "^0.9.1",
+      "@fayz-ai/plugin-crm": "^0.9.1",
+      "@fayz-ai/plugin-dashboard": "^0.9.1",
+      "@fayz-ai/plugin-financial": "^0.9.1",
+      "@fayz-ai/plugin-forms": "^0.9.1",
+      "@fayz-ai/plugin-inventory": "^0.9.1",
+      "@fayz-ai/plugin-marketing": "^0.9.1",
+      "@fayz-ai/plugin-menu": "^0.9.1",
+      "@fayz-ai/plugin-orders": "^0.9.1",
+      "@fayz-ai/plugin-payments": "^0.9.1",
+      "@fayz-ai/plugin-reports": "^0.9.1",
+      "@fayz-ai/plugin-reputation": "^0.9.1",
+      "@fayz-ai/plugin-shop": "^0.9.1",
+      "@fayz-ai/plugin-sites": "^0.9.1",
+      "@fayz-ai/plugin-tables": "^0.9.1",
+      "@fayz-ai/plugin-tasks": "^0.9.1"
+    }
+  }
+};
+
+// src/release-channels.ts
+var releaseChannelPackages = release_channels_default.channels;
+function buildVersionSet(channel) {
+  return {
+    channel,
+    packages: { ...releaseChannelPackages[channel] }
+  };
+}
+var fayzPackageVersionSets = {
+  stable: buildVersionSet("stable"),
+  latest: buildVersionSet("latest"),
+  preview: buildVersionSet("preview")
+};
+function resolveFayzPackageVersions(channel = "stable") {
+  return fayzPackageVersionSets[channel];
+}
+function resolveFayzPackageDependencies(channel = "stable") {
+  return { ...resolveFayzPackageVersions(channel).packages };
+}
+function resolveFayzPackageVersion(packageName, channel = "stable") {
+  const version = resolveFayzPackageVersions(channel).packages[packageName];
+  if (!version) {
+    throw new Error(`No Fayz package version configured for ${packageName} in ${channel} channel`);
+  }
+  return version;
+}
+
+export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPackageVersion, resolveFayzPackageVersions };
+//# sourceMappingURL=chunk-VRUPJGFZ.js.map
+//# sourceMappingURL=chunk-VRUPJGFZ.js.map

package/dist/chunk-VRUPJGFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/release-channels.json","../src/release-channels.ts"],"names":[],"mappings":"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","file":"chunk-VRUPJGFZ.js","sourcesContent":["{\n  \"channels\": {\n    \"stable\": {\n      \"@fayz-ai/sdk\": \"^0.10.0\",\n      \"@fayz-ai/admin\": \"^0.10.0\",\n      \"@fayz-ai/core\": \"^0.10.0\",\n      \"@fayz-ai/auth\": \"^0.10.0\",\n      \"@fayz-ai/ui\": \"^0.10.0\",\n      \"@fayz-ai/shop\": \"^0.10.0\",\n      \"@fayz-ai/storefront\": \"^0.10.0\",\n      \"@fayz-ai/portal\": \"^0.10.0\",\n      \"@fayz-ai/courses\": \"^0.10.0\",\n      \"@fayz-ai/db\": \"^0.10.0\",\n      \"@fayz-ai/plugin-agenda\": \"^0.9.1\",\n      \"@fayz-ai/plugin-auth\": \"^0.9.1\",\n      \"@fayz-ai/plugin-automations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-blog\": \"^0.10.0\",\n      \"@fayz-ai/plugin-conversations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-courses\": \"^0.9.1\",\n      \"@fayz-ai/plugin-crm\": \"^0.9.1\",\n      \"@fayz-ai/plugin-dashboard\": \"^0.9.1\",\n      \"@fayz-ai/plugin-financial\": \"^0.9.1\",\n      \"@fayz-ai/plugin-forms\": \"^0.9.1\",\n      \"@fayz-ai/plugin-inventory\": \"^0.9.1\",\n      \"@fayz-ai/plugin-marketing\": \"^0.9.1\",\n      \"@fayz-ai/plugin-menu\": \"^0.9.1\",\n      \"@fayz-ai/plugin-orders\": \"^0.9.1\",\n      \"@fayz-ai/plugin-payments\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reports\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reputation\": \"^0.9.1\",\n      \"@fayz-ai/plugin-shop\": \"^0.9.1\",\n      \"@fayz-ai/plugin-sites\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tables\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tasks\": \"^0.9.1\"\n    },\n    \"latest\": {\n      \"@fayz-ai/sdk\": \"^0.10.0\",\n      \"@fayz-ai/admin\": \"^0.10.0\",\n      \"@fayz-ai/core\": \"^0.10.0\",\n      \"@fayz-ai/auth\": \"^0.10.0\",\n      \"@fayz-ai/ui\": \"^0.10.0\",\n      \"@fayz-ai/shop\": \"^0.10.0\",\n      \"@fayz-ai/storefront\": \"^0.10.0\",\n      \"@fayz-ai/portal\": \"^0.10.0\",\n      \"@fayz-ai/courses\": \"^0.10.0\",\n      \"@fayz-ai/db\": \"^0.10.0\",\n      \"@fayz-ai/plugin-agenda\": \"^0.9.1\",\n      \"@fayz-ai/plugin-auth\": \"^0.9.1\",\n      \"@fayz-ai/plugin-automations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-blog\": \"^0.10.0\",\n      \"@fayz-ai/plugin-conversations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-courses\": \"^0.9.1\",\n      \"@fayz-ai/plugin-crm\": \"^0.9.1\",\n      \"@fayz-ai/plugin-dashboard\": \"^0.9.1\",\n      \"@fayz-ai/plugin-financial\": \"^0.9.1\",\n      \"@fayz-ai/plugin-forms\": \"^0.9.1\",\n      \"@fayz-ai/plugin-inventory\": \"^0.9.1\",\n      \"@fayz-ai/plugin-marketing\": \"^0.9.1\",\n      \"@fayz-ai/plugin-menu\": \"^0.9.1\",\n      \"@fayz-ai/plugin-orders\": \"^0.9.1\",\n      \"@fayz-ai/plugin-payments\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reports\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reputation\": \"^0.9.1\",\n      \"@fayz-ai/plugin-shop\": \"^0.9.1\",\n      \"@fayz-ai/plugin-sites\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tables\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tasks\": \"^0.9.1\"\n    },\n    \"preview\": {\n      \"@fayz-ai/sdk\": \"^0.10.0\",\n      \"@fayz-ai/admin\": \"^0.10.0\",\n      \"@fayz-ai/core\": \"^0.10.0\",\n      \"@fayz-ai/auth\": \"^0.10.0\",\n      \"@fayz-ai/ui\": \"^0.10.0\",\n      \"@fayz-ai/shop\": \"^0.10.0\",\n      \"@fayz-ai/storefront\": \"^0.10.0\",\n      \"@fayz-ai/portal\": \"^0.10.0\",\n      \"@fayz-ai/courses\": \"^0.10.0\",\n      \"@fayz-ai/db\": \"^0.10.0\",\n      \"@fayz-ai/plugin-agenda\": \"^0.9.1\",\n      \"@fayz-ai/plugin-auth\": \"^0.9.1\",\n      \"@fayz-ai/plugin-automations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-blog\": \"^0.10.0\",\n      \"@fayz-ai/plugin-conversations\": \"^0.9.1\",\n      \"@fayz-ai/plugin-courses\": \"^0.9.1\",\n      \"@fayz-ai/plugin-crm\": \"^0.9.1\",\n      \"@fayz-ai/plugin-dashboard\": \"^0.9.1\",\n      \"@fayz-ai/plugin-financial\": \"^0.9.1\",\n      \"@fayz-ai/plugin-forms\": \"^0.9.1\",\n      \"@fayz-ai/plugin-inventory\": \"^0.9.1\",\n      \"@fayz-ai/plugin-marketing\": \"^0.9.1\",\n      \"@fayz-ai/plugin-menu\": \"^0.9.1\",\n      \"@fayz-ai/plugin-orders\": \"^0.9.1\",\n      \"@fayz-ai/plugin-payments\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reports\": \"^0.9.1\",\n      \"@fayz-ai/plugin-reputation\": \"^0.9.1\",\n      \"@fayz-ai/plugin-shop\": \"^0.9.1\",\n      \"@fayz-ai/plugin-sites\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tables\": \"^0.9.1\",\n      \"@fayz-ai/plugin-tasks\": \"^0.9.1\"\n    }\n  }\n}\n","import releaseChannels from './release-channels.json'\n\nexport type FayzPackageChannel = 'stable' | 'latest' | 'preview'\n\nexport interface FayzPackageVersionSet {\n  channel: FayzPackageChannel\n  packages: Record<string, string>\n}\n\nconst releaseChannelPackages = releaseChannels.channels as Record<FayzPackageChannel, Record<string, string>>\n\nfunction buildVersionSet(channel: FayzPackageChannel): FayzPackageVersionSet {\n  return {\n    channel,\n    packages: { ...releaseChannelPackages[channel] },\n  }\n}\n\nexport const fayzPackageVersionSets: Record<FayzPackageChannel, FayzPackageVersionSet> = {\n  stable: buildVersionSet('stable'),\n  latest: buildVersionSet('latest'),\n  preview: buildVersionSet('preview'),\n}\n\nexport function resolveFayzPackageVersions(channel: FayzPackageChannel = 'stable'): FayzPackageVersionSet {\n  return fayzPackageVersionSets[channel]\n}\n\nexport function resolveFayzPackageDependencies(channel: FayzPackageChannel = 'stable'): Record<string, string> {\n  return { ...resolveFayzPackageVersions(channel).packages }\n}\n\nexport function resolveFayzPackageVersion(packageName: string, channel: FayzPackageChannel = 'stable'): string {\n  const version = resolveFayzPackageVersions(channel).packages[packageName]\n\n  if (!version) {\n    throw new Error(`No Fayz package version configured for ${packageName} in ${channel} channel`)\n  }\n\n  return version\n}\n"]}

package/dist/deprecations.d.ts

@@ -0,0 +1,98 @@
+/** Where a deprecated thing lives, which is also what can detect it. */
+export type FayzDeprecationSurface = 
+/** A field of the Store Document (and of the config it is derived from). */
+'document-field'
+/** An option passed to a provider factory in the store's own code. */
+ | 'provider-option'
+/** A write to a column that is no longer the truth. */
+ | 'sql-column-write'
+/** A branch of a SQL function kept alive for data that has not migrated. */
+ | 'sql-code-path'
+/** A package name kept alive by a re-export after the package was renamed. */
+ | 'package-name';
+export interface FayzDeprecation {
+    /** Stable dotted id. The key everything else references. */
+    id: string;
+    /** Package that owns the surface. */
+    package: string;
+    surface: FayzDeprecationSurface;
+    /** What is deprecated, in the words the author would recognize. */
+    title: string;
+    /** SDK minor in which the deprecation was ANNOUNCED. */
+    deprecatedIn: string;
+    /** SDK minor in which the shim is REMOVED. */
+    removeIn: string;
+    /** What to use instead. Every warning for this id names it (I2). */
+    replacement: string;
+    /** What keeps working during the window, and precisely what it costs. */
+    shim: string;
+    /** Repo paths where the shim lives — the registry has to be auditable. */
+    where: string[];
+    /**
+     * Literal marker text the shim emits at runtime, for shims that cannot build
+     * their message from this row (PL/pgSQL). Asserted against the real file by
+     * packages/shop/src/deprecations.test.ts.
+     */
+    signals?: string[];
+    /** How `fayz upgrade` finds it in a store — including "you cannot, here is
+     *  the query that counts it in the pool instead". */
+    detect: string;
+    /** Codemod id that retires it. Never empty: a codemod that cannot be safe
+     *  exists anyway and refuses, naming the human decision. */
+    codemod: string;
+    /** The design record. */
+    reference: string;
+}
+export interface FayzDeprecationPolicy {
+    /** Minimum number of minor releases between announcement and removal. */
+    minMinorsBeforeRemoval: number;
+    summary: string;
+}
+export interface FayzDeprecationRegistry {
+    registryVersion: number;
+    policy: FayzDeprecationPolicy;
+    deprecations: FayzDeprecation[];
+}
+declare const table: FayzDeprecationRegistry;
+export declare const fayzDeprecationPolicy: FayzDeprecationPolicy;
+/** Every deprecation, in declaration order. */
+export declare function listDeprecations(): FayzDeprecation[];
+/** One row by id. Unknown ids throw and name the valid set (I2). */
+export declare function getDeprecation(id: string): FayzDeprecation;
+export declare function hasDeprecation(id: string): boolean;
+/** Deprecation ids a given codemod retires. */
+export declare function deprecationsForCodemod(codemod: string): FayzDeprecation[];
+/** Every codemod id the registry references, deduped, in declaration order. */
+export declare function listDeprecationCodemods(): string[];
+/**
+ * The warning text for a deprecation — the ONE place its prose is built.
+ *
+ * `context` is the caller's specifics ("on variant abc", "at commerce.discounts[0]");
+ * it is appended, never substituted, so no caller can drop the replacement.
+ */
+export declare function deprecationMessage(id: string, context?: string): string;
+/**
+ * Warn once per id per session.
+ *
+ * Once, because the alternative is one line per request, which buries the
+ * signal this exists to produce. The dedupe key is the ID ALONE, not
+ * (id, context): a shim whose context varies per call would otherwise
+ * re-warn forever and reintroduce exactly the flood the once-ness exists to
+ * prevent. Returns true when it actually warned, so a shim is testable
+ * without reading the console.
+ */
+export declare function warnDeprecated(id: string, context?: string): boolean;
+/** Test seam — re-arms every once-per-session deprecation warning. */
+export declare function resetDeprecationWarnings(): void;
+/**
+ * Does `version` still get the shim?
+ *
+ * The question every consumer actually asks, answered from the table rather
+ * than from a comment. Compared on (major, minor) because the policy is stated
+ * in minors — a patch never removes anything.
+ */
+export declare function isDeprecationShimmed(id: string, version: string): boolean;
+/** Minors between announcement and removal — the policy's unit. */
+export declare function deprecationWindowMinors(row: FayzDeprecation): number;
+export { table as fayzDeprecationRegistry };
+//# sourceMappingURL=deprecations.d.ts.map

package/dist/deprecations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecations.d.ts","sourceRoot":"","sources":["../src/deprecations.ts"],"names":[],"mappings":"AA+BA,wEAAwE;AACxE,MAAM,MAAM,sBAAsB;AAChC,4EAA4E;AAC1E,gBAAgB;AAClB,sEAAsE;GACpE,iBAAiB;AACnB,uDAAuD;GACrD,kBAAkB;AACpB,4EAA4E;GAC1E,eAAe;AACjB,8EAA8E;GAC5E,cAAc,CAAA;AAElB,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,sBAAsB,CAAA;IAC/B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB;yDACqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd;gEAC4D;IAC5D,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAA;CAChC;AAED,QAAA,MAAM,KAAK,EAA0B,uBAAuB,CAAA;AAE5D,eAAO,MAAM,qBAAqB,EAAE,qBAAoC,CAAA;AAExE,+CAA+C;AAC/C,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAEpD;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAQ1D;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAEzE;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQvE;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAOD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMzE;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAOpE;AAED,OAAO,EAAE,KAAK,IAAI,uBAAuB,EAAE,CAAA"}

package/dist/deprecations.js

@@ -0,0 +1,3 @@
+export { deprecationMessage, deprecationWindowMinors, deprecationsForCodemod, fayzDeprecationPolicy, table as fayzDeprecationRegistry, getDeprecation, hasDeprecation, isDeprecationShimmed, listDeprecationCodemods, listDeprecations, resetDeprecationWarnings, warnDeprecated } from './chunk-HA5O3CW7.js';
+//# sourceMappingURL=deprecations.js.map
+//# sourceMappingURL=deprecations.js.map

package/dist/deprecations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"deprecations.js"}

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPack
 export type { FayzPackageChannel, FayzPackageVersionSet } from './release-channels';
 export { getSupportedPackages, getInternalPackages, isSupportedPackage, fayzSupportedSurface, } from './supported-surface';
 export type { FayzPackageTier, FayzSupportedSurface } from './supported-surface';
+export { deprecationMessage, deprecationWindowMinors, deprecationsForCodemod, fayzDeprecationPolicy, fayzDeprecationRegistry, getDeprecation, hasDeprecation, isDeprecationShimmed, listDeprecationCodemods, listDeprecations, resetDeprecationWarnings, warnDeprecated, } from './deprecations';
+export type { FayzDeprecation, FayzDeprecationPolicy, FayzDeprecationRegistry, FayzDeprecationSurface, } from './deprecations';
 export { AI_BUILDER_REQUEST_CLASSES, AI_BUILDER_REQUEST_CLASS_IDS, isAllowedRequestClass, } from './ai-builder';
 export type { FayzLayer, AiBuilderRequestClass, AiBuilderRequestClassDef, } from './ai-builder';
 export { createFayzRuntimeClient, FayzRuntimeError, } from './runtime';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC/D,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC/D,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,aAAa,GACd,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,2BAA2B,EAC3B,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC/D,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC/D,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,aAAa,GACd,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,2BAA2B,EAC3B,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,QAAQ,CAAA;AACf,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -1,10 +1,11 @@
+export { AI_BUILDER_REQUEST_CLASSES, AI_BUILDER_REQUEST_CLASS_IDS, isAllowedRequestClass } from './chunk-BJFMBVMP.js';
 export { FayzApiError, createFayzClient, fayz } from './chunk-UWOQAD5A.js';
 export { FayzRuntimeError, createFayzRuntimeClient } from './chunk-FRIOW6KW.js';
 export { appParams, resolveAppParams } from './chunk-YGX37DT3.js';
 export { FayzAgentError, createFayzAgentClient } from './chunk-LSBVNW75.js';
-export { FayzShopError, createFayzShopProvider } from './chunk-V4GWI7WH.js';
-export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPackageVersion, resolveFayzPackageVersions } from './chunk-YZQW3BJA.js';
-export { surface as fayzSupportedSurface, getInternalPackages, getSupportedPackages, isSupportedPackage } from './chunk-2YJXKDHO.js';
-export { AI_BUILDER_REQUEST_CLASSES, AI_BUILDER_REQUEST_CLASS_IDS, isAllowedRequestClass } from './chunk-7XM4LONE.js';
+export { FayzShopError, createFayzShopProvider } from './chunk-7UXTYT6I.js';
+export { deprecationMessage, deprecationWindowMinors, deprecationsForCodemod, fayzDeprecationPolicy, table as fayzDeprecationRegistry, getDeprecation, hasDeprecation, isDeprecationShimmed, listDeprecationCodemods, listDeprecations, resetDeprecationWarnings, warnDeprecated } from './chunk-HA5O3CW7.js';
+export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPackageVersion, resolveFayzPackageVersions } from './chunk-VRUPJGFZ.js';
+export { surface as fayzSupportedSurface, getInternalPackages, getSupportedPackages, isSupportedPackage } from './chunk-6UZOXHGJ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/release-channels.js

@@ -1,3 +1,3 @@
-export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPackageVersion, resolveFayzPackageVersions } from './chunk-YZQW3BJA.js';
+export { fayzPackageVersionSets, resolveFayzPackageDependencies, resolveFayzPackageVersion, resolveFayzPackageVersions } from './chunk-VRUPJGFZ.js';
 //# sourceMappingURL=release-channels.js.map
 //# sourceMappingURL=release-channels.js.map

package/dist/shop.d.ts

@@ -70,6 +70,10 @@ export declare class FayzShopError extends Error {
     readonly responseBody?: unknown | undefined;
     constructor(message: string, status: number, responseBody?: unknown | undefined);
 }
+/** The registry id this shim answers to. */
+export declare const PRODUCT_METADATA_OVERLAY_DEPRECATION = "shop.provider.productMetadata";
+/** Test seam — re-arms the once-per-session overlay deprecation warning. */
+export declare function resetProductMetadataOverlayDeprecationWarning(): void;
 declare function updateOrderPayload(input: {
     status?: FayzShopOrderStatus;
     financialStatus?: FayzShopFinancialStatus;
@@ -241,6 +245,32 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
     deleteProduct(): Promise<never>;
     uploadProductImage(): Promise<never>;
     deleteProductImage(): Promise<never>;
+    /**
+     * Option axes + variants from the 0028 tables (spine M5) — the read that
+     * replaces the productMetadata overlay as the source of product options.
+     * Anon reads are already scoped by the storefront RLS (active variants of
+     * publicly readable products only).
+     */
+    getProductVariants(productId: string): Promise<{
+        options: {
+            id: string;
+            name: string;
+            values: string[];
+            position: number;
+        }[];
+        variants: {
+            id: string;
+            productId: string;
+            options: Record<string, string>;
+            sku: string | null;
+            price: number | null;
+            compareAtPrice: number | null;
+            inventoryCount: number;
+            position: number;
+            status: "active" | "archived";
+            imageId: string | null;
+        }[];
+    }>;
     listCategories(): Promise<{
         id: string;
         tenantId: string;
@@ -474,8 +504,10 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
             label?: string;
         };
         paymentMethod?: "pix" | "credit_card" | "debit_card" | "boleto" | "cash" | "other";
+        metadata?: Record<string, unknown>;
         items: Array<{
             productId: string;
+            variantId?: string;
             quantity: number;
             optionsLabel?: string;
         }>;

package/dist/shop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shop.d.ts","sourceRoot":"","sources":["../src/shop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shop.d.ts","sourceRoot":"","sources":["../src/shop.ts"],"names":[],"mappings":"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"}

package/dist/shop.js

@@ -1,3 +1,4 @@
-export { FayzShopError, createFayzShopProvider, setShopAccessTokenResolver } from './chunk-V4GWI7WH.js';
+export { FayzShopError, PRODUCT_METADATA_OVERLAY_DEPRECATION, createFayzShopProvider, resetProductMetadataOverlayDeprecationWarning, setShopAccessTokenResolver } from './chunk-7UXTYT6I.js';
+import './chunk-HA5O3CW7.js';
 //# sourceMappingURL=shop.js.map
 //# sourceMappingURL=shop.js.map

package/dist/supported-surface.d.ts

@@ -1,4 +1,4 @@
-export type FayzPackageTier = 'stable';
+export type FayzPackageTier = 'stable' | 'deprecated';
 export interface FayzSupportedSurface {
     surfaceVersion: number;
     supported: Record<string, FayzPackageTier>;
@@ -15,5 +15,12 @@ export declare function getInternalPackages(): string[];
  * Non-Fayz packages (no `@fayz-ai/` prefix) are out of scope and return true.
  */
 export declare function isSupportedPackage(packageName: string): boolean;
+/**
+ * True when `packageName` is on the surface but scheduled for removal. Such a
+ * package still builds — `fayz doctor` reports it as a migration to do, not as
+ * a boundary violation. The replacement and removal version live in
+ * `deprecations.json`.
+ */
+export declare function isDeprecatedPackage(packageName: string): boolean;
 export { surface as fayzSupportedSurface };
 //# sourceMappingURL=supported-surface.d.ts.map

package/dist/supported-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supported-surface.d.ts","sourceRoot":"","sources":["../src/supported-surface.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEtC,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,QAAA,MAAM,OAAO,EAAkC,oBAAoB,CAAA;AAEnE,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"supported-surface.d.ts","sourceRoot":"","sources":["../src/supported-surface.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAA;AAErD,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,QAAA,MAAM,OAAO,EAAkC,oBAAoB,CAAA;AAEnE,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,CAAA"}

package/dist/supported-surface.js

@@ -1,3 +1,3 @@
-export { surface as fayzSupportedSurface, getInternalPackages, getSupportedPackages, isSupportedPackage } from './chunk-2YJXKDHO.js';
+export { surface as fayzSupportedSurface, getInternalPackages, getSupportedPackages, isDeprecatedPackage, isSupportedPackage } from './chunk-6UZOXHGJ.js';
 //# sourceMappingURL=supported-surface.js.map
 //# sourceMappingURL=supported-surface.js.map

package/dist/vite.d.ts

@@ -8,7 +8,13 @@ export interface FayzViteOptions {
     aliases?: Record<string, string>;
     /** Extra Vite plugins, appended after @vitejs/plugin-react. */
     plugins?: PluginOption[];
-    /** SDK source location relative to the app root (default ../../fayz-sdk). */
+    /**
+     * SDK source location, absolute or relative to the app root
+     * (default `../../fayz-sdk`).
+     *
+     * The `FAYZ_SDK_DIR` environment variable OVERRIDES this — see
+     * {@link resolveSdkDir}.
+     */
     sdkDir?: string;
     /** App root directory (default process.cwd()). */
     root?: string;
@@ -36,9 +42,32 @@ export interface FayzViteOptions {
  *     import { fayzVite } from '@fayz-ai/sdk/vite'
  *     export default defineConfig(fayzVite({ port: 5185, plugins: [react()] }))
  *
+ * Where that local source is read from is {@link resolveSdkDir}: `FAYZ_SDK_DIR`
+ * beats the `sdkDir` option beats `../../fayz-sdk`.
+ *
  * The app passes its own `@vitejs/plugin-react` so `@fayz-ai/sdk` carries no
  * build-tool peer deps (which otherwise choke npm's peer resolution, since sdk
  * sits in every dependency path).
  */
+/** Env var that redirects local-source resolution to another SDK checkout. */
+export declare const FAYZ_SDK_DIR_ENV = "FAYZ_SDK_DIR";
+/**
+ * Where the local SDK source is, as an absolute path. Resolution order:
+ *
+ *   1. `FAYZ_SDK_DIR` (env)          — wins, absolute or root-relative
+ *   2. `sdkDir` (option)             — what the app's vite config declares
+ *   3. `../../fayz-sdk`              — the sibling-checkout convention
+ *
+ * Env wins deliberately. `sdkDir` lives in the app's COMMITTED vite config, so
+ * without an override there was no way to build, dev or `fayz validate` a
+ * store against a different SDK tree (a worktree, a release branch) short of
+ * editing that committed file or dropping an untracked config shim next to it
+ * — which is exactly what the fleet ended up doing. An env var is the one
+ * knob a CLI flag and a container can both set without touching the repo.
+ *
+ * Exported so the CLI and the tests agree on the precedence by construction
+ * rather than by comment.
+ */
+export declare function resolveSdkDir(root: string, sdkDir?: string, env?: Record<string, string | undefined>): string;
 export declare function fayzVite(opts?: FayzViteOptions): UserConfig;
 //# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAgB,MAAM,MAAM,CAAA;AAelE,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,UAAU,CA6D/D"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAgB,MAAM,MAAM,CAAA;AAiBlE,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,iBAAiB,CAAA;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAGR;AAED,wBAAgB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,UAAU,CA6D/D"}

package/dist/vite.js

@@ -3,10 +3,13 @@ import { resolve } from 'path';
 
 // src/vite.ts
 var SDK_PACKAGES = [
+  // 'saas' is the deprecated compat shim for 'admin' — kept so an app that has
+  // not migrated its imports still resolves in source mode (removed in 0.12.0).
   "sdk",
   "core",
   "auth",
   "ui",
+  "admin",
   "saas",
   "shop",
   "storefront",
@@ -37,9 +40,14 @@ var SDK_PLUGINS = [
   "tables",
   "tasks"
 ];
+var FAYZ_SDK_DIR_ENV = "FAYZ_SDK_DIR";
+function resolveSdkDir(root, sdkDir, env = process.env) {
+  const fromEnv = env[FAYZ_SDK_DIR_ENV]?.trim();
+  return resolve(root, fromEnv || sdkDir || "../../fayz-sdk");
+}
 function fayzVite(opts = {}) {
   const root = opts.root ?? process.cwd();
-  const fayzSdk = resolve(root, opts.sdkDir ?? "../../fayz-sdk");
+  const fayzSdk = resolveSdkDir(root, opts.sdkDir);
   const wantLocal = process.env.FAYZ_SDK_SOURCE !== "published";
   const localPresent = existsSync(resolve(fayzSdk, "packages/core/src/index.ts"));
   const useLocal = wantLocal && localPresent;
@@ -94,6 +102,6 @@ function fayzVite(opts = {}) {
   };
 }
 
-export { fayzVite };
+export { FAYZ_SDK_DIR_ENV, fayzVite, resolveSdkDir };
 //# sourceMappingURL=vite.js.map
 //# sourceMappingURL=vite.js.map