@doswiftly/storefront-sdk 7.0.0 → 9.0.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 9.0.0
+
+### Major Changes
+
+- 5c4e080: **BREAKING (version-only)**: Bump `@doswiftly/storefront-sdk` to 8.0.0 to stay in lockstep with `@doswiftly/storefront-operations@8.0.0` (linked package contract — same major between them).
+
+  ### Why this release
+
+  The SDK code itself is unchanged. This is a version-sync release that matches the BREAKING operations rename shipped in `@doswiftly/storefront-operations@8.0.0` (26 operations renamed to verb-first to match the GraphQL schema field names — see operations 8.0.0 CHANGELOG for the full migration table).
+
+  ### Migration
+
+  If you upgrade `@doswiftly/storefront-sdk` from `7.x` → `8.x`, you MUST also upgrade `@doswiftly/storefront-operations` to `8.x` (they are linked). After upgrading:
+  1. Regenerate codegen against the new operations package.
+  2. Update operation imports per the migration table in `@doswiftly/storefront-operations@8.0.0` CHANGELOG (e.g. `CheckoutDiscountCodeApply` → `CheckoutApplyDiscountCode`, `$checkoutId` → `$id`).
+  3. No SDK API surface change beyond the operation name re-exports — runtime client behavior is identical.
+
+## 7.1.0
+
+### Minor Changes
+
+- 0399ef8: Auto-generated, drift-proof docs and AI-agent context shipped inside the package.
+
+  The package now ships three new files alongside the `.graphql` sources, all
+  generated automatically and kept in sync with the schema:
+  - **`AGENTS.md`** — entry point for AI coding agents (Cursor, Claude Code,
+    GitHub Copilot, Codex, Aider, Gemini CLI, …). Critical conventions and
+    anti-hallucination notes — load this once per session.
+  - **`llms-full.txt`** — full operation reference: descriptions, typed variables,
+    ready-to-execute GraphQL bodies, fragment cross-references.
+  - **`operations.json`** — same operations as structured JSON for MCP servers
+    and programmatic tools.
+
+  The `Available Operations` section in `README.md` is now also auto-generated,
+  so it can never drift from the actual schema again.
+
+  **Anti-hallucination conventions** documented in `AGENTS.md`:
+  - Cart mutations are `cartAddLines` / `cartUpdateLines` / `cartRemoveLines`
+    (NOT the `cart<Object><Verb>` aliases — they do not exist in this API).
+  - `userErrors[].code` is a `String`, not an enum. Domain-typed enums exist
+    separately for warnings (`CartWarningCode`, `DiscountErrorCode`, etc.).
+  - Authentication uses **either** the `customerAccessToken` cookie **or** the
+    `Authorization: Bearer` header — never both.
+  - `Money.amount` is a string (decimal precision), not a number.
+
+  No code changes for existing consumers — `schema.graphql`, `queries.graphql`,
+  `mutations.graphql`, and `fragments.graphql` are unchanged in surface (only
+  non-functional `#` description comments were added in the operation files).
+  Codegen continues to produce identical typed documents.
+
 ## 7.0.0
 
 ### Major Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "7.0.0",
+  "version": "9.0.0",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
   "files": [