@doswiftly/storefront-operations 22.8.0 → 22.9.0

package/AGENTS.md

@@ -27,7 +27,7 @@ consumer's `codegen.ts` references this package's `.graphql` files as
 live in the consumer's repo.
 
 <!-- AUTOGEN:STATS:BEGIN — auto-regenerated, do not edit by hand -->
-- **Schema version**: 22.8.0
+- **Schema version**: 22.9.0
 - **Queries**: 52
 - **Mutations**: 44
 - **Fragments**: 105

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## 22.9.0
+
+### Minor Changes
+
+- 36c28ff: Add `customerNote` to the storefront `Order` type — the note a buyer left at checkout (delivery instructions, gift message, etc.). It is selected by the order fragment, so it is available on every order query, and is `null` when the buyer left no note.
+
+  ```tsx
+  // Order confirmation / detail page
+  const note = order.customerNote;
+  if (note) {
+    return <p className="order-note">{note}</p>;
+  }
+  ```
+
+- a399d36: Image loader now produces clean image URLs (no internal storage prefix) on custom domains.
+
+  **Why**: when your storefront is served from its own image domain, the built `<Image>` URLs no longer carry the `/s/{shopId}` storage prefix (`https://img.yourshop.com/_next/static/media/hero.webp?width=256` instead of `.../s/{shopId}/_next/...`). The stored object is unchanged — the platform restores the prefix toward storage — so this is purely a nicer public URL. Branding-friendly, and one fewer internal detail in the markup.
+
+  **This is automatic — no code change.** The common `createImageLoader()` setup reads the flag from the platform-injected env var, so clean URLs simply turn on when your storefront is served from a custom domain configured for them:
+
+  ```ts
+  // lib/image-loader.ts — unchanged; clean URLs turn on automatically.
+  import { createImageLoader } from "@doswiftly/storefront-sdk/next";
+  export default createImageLoader();
+  ```
+
+  **Additive (backward-compatible)**:
+  1. `ImageLoaderConfig` gains an optional `cleanUrl?: boolean` (defaults to `false`).
+  2. `createImageLoader()` reads it automatically from `NEXT_PUBLIC_ASSET_CLEAN_URL`.
+
+  When `cleanUrl` is off (the default), URLs keep the `/s/{shopId}` prefix exactly as before — existing storefronts are unaffected. The boolean is also accepted by the low-level `buildImageLoaderUrl` for non-`<Image>` usage (e.g. CSS backgrounds) or tests:
+
+  ```ts
+  import { buildImageLoaderUrl } from "@doswiftly/storefront-sdk";
+  buildImageLoaderUrl(
+    { shopId, version, cleanUrl: true, cdnBase: "https://img.yourshop.com" },
+    { src: "/hero.webp", width: 256 },
+  );
+  // → https://img.yourshop.com/public/hero.webp?width=256&v=<version>
+  ```
+
+  **Migration checklist for existing storefronts**:
+  - [ ] None required — the default behavior is unchanged. Re-deploy to pick up clean URLs once your custom domain is configured.
+
+## 22.8.1
+
+### Patch Changes
+
+- 61a2841: Fix: images imported in code are optimized again when your build serves static assets from a CDN domain.
+
+  An image you import in code (`import hero from './hero.webp'`) becomes a content-hashed file under `/_next/static/media/`. When your build serves static assets from a CDN domain (`assetPrefix` / `getAssetPrefix()`), Next.js rewrites the `<Image>` `src` to an absolute CDN URL before the loader runs. The loader did not recognize that form, so every `srcset` entry pointed at the full-size original — no resizing or format negotiation.
+
+  The loader now recognizes code-imported images in that absolute form and routes them through the image CDN, so each `srcset` width is resized again — the same behavior as a build without `assetPrefix`. Product images and `public/` images were never affected.
+
+  No API changes — update the package and redeploy.
+
+  (`@doswiftly/storefront-operations` is version-synced with the SDK; no operation changes.)
+
 ## 22.8.0
 
 ### Minor Changes

package/fragments.graphql

@@ -344,6 +344,7 @@ fragment Order on Order {
     ...MailingAddress
   }
   itemCount
+  customerNote
   discountAllocations {
     discountCode
     amount {

package/llms-full.txt

@@ -1,6 +1,6 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **22.8.0**
+> Schema version: **22.9.0**
 > 52 queries · 44 mutations · 105 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
@@ -3052,6 +3052,7 @@ fragment Order on Order {
     ...MailingAddress
   }
   itemCount
+  customerNote
   discountAllocations {
     discountCode
     amount {

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "22.8.0",
+  "schemaVersion": "22.9.0",
   "queries": [
     {
       "name": "Shop",
@@ -2154,7 +2154,7 @@
         "MailingAddress",
         "Money"
       ],
-      "body": "fragment Order on Order {\n  id\n  orderNumber\n  accessToken\n  totals {\n    total {\n      ...Money\n    }\n    subtotal {\n      ...Money\n    }\n    totalTax {\n      ...Money\n    }\n    totalShipping {\n      ...Money\n    }\n  }\n  status\n  paymentStatus\n  fulfillmentStatus\n  processedAt\n  confirmedAt\n  cancelledAt\n  expiredAt\n  shippingAddress {\n    ...MailingAddress\n  }\n  itemCount\n  discountAllocations {\n    discountCode\n    amount {\n      ...Money\n    }\n  }\n  canCreatePayment\n  paymentMethodType\n}",
+      "body": "fragment Order on Order {\n  id\n  orderNumber\n  accessToken\n  totals {\n    total {\n      ...Money\n    }\n    subtotal {\n      ...Money\n    }\n    totalTax {\n      ...Money\n    }\n    totalShipping {\n      ...Money\n    }\n  }\n  status\n  paymentStatus\n  fulfillmentStatus\n  processedAt\n  confirmedAt\n  cancelledAt\n  expiredAt\n  shippingAddress {\n    ...MailingAddress\n  }\n  itemCount\n  customerNote\n  discountAllocations {\n    discountCode\n    amount {\n      ...Money\n    }\n  }\n  canCreatePayment\n  paymentMethodType\n}",
       "onType": "Order"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-operations",
-  "version": "22.8.0",
+  "version": "22.9.0",
   "description": "GraphQL operations for DoSwiftly Storefront - SSOT from backend",
   "homepage": "https://doswiftly.pl",
   "publishConfig": {

package/schema.graphql

@@ -4656,6 +4656,11 @@ type Order implements Node {
   """
   confirmedAt: DateTime
 
+  """
+  The note the buyer left at checkout (delivery instructions, gift message, etc.). Null when no note was provided.
+  """
+  customerNote: String
+
   """
   Per-code discount allocations on the order (parity with `Cart.discountAllocations`). One entry per code that reduced the price; empty when no discount applied. The sum of `amount` equals the order-level discount.
   """