@doswiftly/storefront-sdk 7.0.0 → 7.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,38 @@
1
1
  # Changelog
2
2
 
3
+ ## 7.1.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 0399ef8: Auto-generated, drift-proof docs and AI-agent context shipped inside the package.
8
+
9
+ The package now ships three new files alongside the `.graphql` sources, all
10
+ generated automatically and kept in sync with the schema:
11
+ - **`AGENTS.md`** — entry point for AI coding agents (Cursor, Claude Code,
12
+ GitHub Copilot, Codex, Aider, Gemini CLI, …). Critical conventions and
13
+ anti-hallucination notes — load this once per session.
14
+ - **`llms-full.txt`** — full operation reference: descriptions, typed variables,
15
+ ready-to-execute GraphQL bodies, fragment cross-references.
16
+ - **`operations.json`** — same operations as structured JSON for MCP servers
17
+ and programmatic tools.
18
+
19
+ The `Available Operations` section in `README.md` is now also auto-generated,
20
+ so it can never drift from the actual schema again.
21
+
22
+ **Anti-hallucination conventions** documented in `AGENTS.md`:
23
+ - Cart mutations are `cartAddLines` / `cartUpdateLines` / `cartRemoveLines`
24
+ (NOT the `cart<Object><Verb>` aliases — they do not exist in this API).
25
+ - `userErrors[].code` is a `String`, not an enum. Domain-typed enums exist
26
+ separately for warnings (`CartWarningCode`, `DiscountErrorCode`, etc.).
27
+ - Authentication uses **either** the `customerAccessToken` cookie **or** the
28
+ `Authorization: Bearer` header — never both.
29
+ - `Money.amount` is a string (decimal precision), not a number.
30
+
31
+ No code changes for existing consumers — `schema.graphql`, `queries.graphql`,
32
+ `mutations.graphql`, and `fragments.graphql` are unchanged in surface (only
33
+ non-functional `#` description comments were added in the operation files).
34
+ Codegen continues to produce identical typed documents.
35
+
3
36
  ## 7.0.0
4
37
 
5
38
  ### Major Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@doswiftly/storefront-sdk",
3
- "version": "7.0.0",
3
+ "version": "7.1.0",
4
4
  "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
5
5
  "type": "module",
6
6
  "files": [