From 1a727448772ea15a2a209e76355aad5a11583a44 Mon Sep 17 00:00:00 2001
From: Giuseppe Ciotola <30926550+gciotola@users.noreply.github.com>
Date: Fri, 2 Oct 2026 14:02:23 +0200
Subject: [PATCH 1/3] feat: decide the coupon field from the API version the
 order was created with

---
 .../createdWithVersion.spec.ts                | 36 ++++++++++++
 .../payment_sessions/createdWithVersion.ts    | 42 ++++++++++++++
 .../src/payment_sessions/index.ts             |  1 +
 ...iftCardOrCouponForm.paymentsModel.spec.tsx | 56 +++++++++++++++++++
 .../gift_cards/GiftCardOrCouponForm.tsx       | 24 +++++---
 5 files changed, 152 insertions(+), 7 deletions(-)
 create mode 100644 packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
 create mode 100644 packages/core-components/src/payment_sessions/createdWithVersion.ts

diff --git a/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts b/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
new file mode 100644
index 00000000..dfa7d97f
--- /dev/null
+++ b/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
@@ -0,0 +1,36 @@
+import type { Order } from "@commercelayer/sdk"
+import { describe, expect, it } from "vitest"
+import { isCreatedWithVersion } from "./createdWithVersion"
+
+const order = (extra: Record<string, unknown>): Order =>
+  ({ id: "order-1", ...extra }) as unknown as Order
+
+describe("isCreatedWithVersion", () => {
+  it("compares the version flattened among the attributes", () => {
+    expect(isCreatedWithVersion(order({ created_with_version: "2026-05" }), "2026-05")).toBe(true)
+    expect(isCreatedWithVersion(order({ created_with_version: "2017-08" }), "2026-05")).toBe(false)
+  })
+
+  it("compares the version under meta, where the API sends it", () => {
+    expect(
+      isCreatedWithVersion(order({ meta: { created_with_version: "2017-08" } }), "2017-08")
+    ).toBe(true)
+  })
+
+  it("matches the version exactly", () => {
+    expect(isCreatedWithVersion(order({ created_with_version: "2027-01" }), "2026-05")).toBe(false)
+  })
+
+  it("takes only a version the SDK supports", () => {
+    // @ts-expect-error a mistyped version is a compile error, not a silent false
+    expect(isCreatedWithVersion(order({ created_with_version: "2026-05" }), "2026-5")).toBe(false)
+  })
+
+  it("is undefined when the order does not say which version created it", () => {
+    // What every order looks like until the SDK stops dropping `meta`.
+    expect(isCreatedWithVersion(order({}), "2026-05")).toBeUndefined()
+    expect(isCreatedWithVersion(order({ created_with_version: "" }), "2026-05")).toBeUndefined()
+    expect(isCreatedWithVersion(undefined, "2026-05")).toBeUndefined()
+    expect(isCreatedWithVersion(null, "2026-05")).toBeUndefined()
+  })
+})
diff --git a/packages/core-components/src/payment_sessions/createdWithVersion.ts b/packages/core-components/src/payment_sessions/createdWithVersion.ts
new file mode 100644
index 00000000..64454854
--- /dev/null
+++ b/packages/core-components/src/payment_sessions/createdWithVersion.ts
@@ -0,0 +1,42 @@
+import type { ApiVersion, Order } from "@commercelayer/sdk"
+
+/**
+ * The API version the order was created with.
+ *
+ * Core API sends it as the resource's `meta.created_with_version`, which the
+ * SDK drops when it normalizes a response, so for now it is read from wherever
+ * a newer SDK will put it: flattened among the attributes, or under `meta`.
+ * Undefined until then, and for any order that comes back without it.
+ */
+function readCreatedWithVersion(order?: Order | null): string | undefined {
+  const source = order as
+    | { created_with_version?: unknown; meta?: { created_with_version?: unknown } }
+    | null
+    | undefined
+  const version = source?.created_with_version ?? source?.meta?.created_with_version
+  return typeof version === "string" && version !== "" ? version : undefined
+}
+
+/**
+ * Whether the order was created with exactly this API version, e.g. `2026-05`.
+ *
+ * It matters because Core API fixes some of an order's behaviour once, at
+ * creation, whatever version later requests use: an order created with
+ * `2026-05` is on the payment engine where the older order-level gift card is
+ * neither validated nor applied, and one created with `2017-08` keeps it even
+ * when read with `2026-05`.
+ *
+ * `version` is one the SDK supports, so a mistyped one fails to compile rather
+ * than silently never matching.
+ *
+ * Undefined when the order does not say which version created it, so callers
+ * can keep deciding the way they did before it was available.
+ */
+export function isCreatedWithVersion(
+  order: Order | null | undefined,
+  version: ApiVersion
+): boolean | undefined {
+  const createdWith = readCreatedWithVersion(order)
+  if (createdWith == null) return undefined
+  return createdWith === version
+}
diff --git a/packages/core-components/src/payment_sessions/index.ts b/packages/core-components/src/payment_sessions/index.ts
index acce729e..0ed45038 100644
--- a/packages/core-components/src/payment_sessions/index.ts
+++ b/packages/core-components/src/payment_sessions/index.ts
@@ -2,6 +2,7 @@ export { applyGiftCard } from "./applyGiftCard"
 export type { AuthorizeGiftCardSessionsResult } from "./authorizeGiftCardSessions"
 export { authorizeGiftCardSessions } from "./authorizeGiftCardSessions"
 export { buildGatewayReturnUrl } from "./buildGatewayReturnUrl"
+export { isCreatedWithVersion } from "./createdWithVersion"
 export { createPaymentSession } from "./createPaymentSession"
 export type { PaymentSessionsState } from "./derivePaymentSessionsState"
 export { derivePaymentSessionsState } from "./derivePaymentSessionsState"
diff --git a/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx b/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
index 8f09d2bd..3dee48f6 100644
--- a/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
+++ b/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
@@ -65,3 +65,59 @@ describe("GiftCardOrCouponForm on the payment_sessions model", () => {
     expect(inputName()).toBe("gift_card_or_coupon_code")
   })
 })
+
+describe("GiftCardOrCouponForm by the API version the order was created with", () => {
+  // The API fixes an order's payment engine when it is created. On one created
+  // with 2026-05 the order-level gift card is neither validated nor applied, so
+  // the form offers the coupon alone — even with the older payment methods on
+  // offer, which the same order still accepts.
+  it("offers only the coupon on an order created with 2026-05", () => {
+    renderForm({
+      id: "order-1",
+      available_payment_methods: [{ id: "pm-1" }],
+      created_with_version: "2026-05",
+    } as never)
+    expect(inputName()).toBe("coupon_code")
+  })
+
+  it("overrides an explicit gift_card_code request on an order created with 2026-05", () => {
+    renderForm(
+      {
+        id: "order-1",
+        available_payment_methods: [{ id: "pm-1" }],
+        created_with_version: "2026-05",
+      } as never,
+      "gift_card_code"
+    )
+    expect(inputName()).toBe("coupon_code")
+  })
+
+  it("offers the combined field on an order created with 2017-08", () => {
+    renderForm({
+      id: "order-1",
+      available_payment_methods: [{ id: "pm-1" }],
+      created_with_version: "2017-08",
+    } as never)
+    expect(inputName()).toBe("gift_card_or_coupon_code")
+  })
+
+  // The version is what the API decides on, so it wins over the payments model
+  // the order is on.
+  it("follows the version rather than the payments model", () => {
+    renderForm({
+      id: "order-1",
+      available_payment_settings: [MANUAL],
+      created_with_version: "2017-08",
+    } as never)
+    expect(inputName()).toBe("gift_card_or_coupon_code")
+  })
+
+  it("reads the version where the API sends it, under meta", () => {
+    renderForm({
+      id: "order-1",
+      available_payment_methods: [{ id: "pm-1" }],
+      meta: { created_with_version: "2026-05" },
+    } as never)
+    expect(inputName()).toBe("coupon_code")
+  })
+})
diff --git a/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx b/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
index 0021b26d..0bbe73b6 100644
--- a/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
+++ b/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
@@ -1,3 +1,4 @@
+import { isCreatedWithVersion } from "@commercelayer/core-components"
 import type { Order } from "@commercelayer/sdk"
 import { useRapidForm } from "rapid-form"
 import { type JSX, useCallback, useContext, useEffect, useState } from "react"
@@ -41,13 +42,22 @@ export function GiftCardOrCouponForm(props: Props): JSX.Element | null {
 
   // Derive the active code type from the current order state
   useEffect(() => {
-    // On the `payment_sessions` model a gift card is not an order-level code:
-    // it is spent by creating a Payment Session against a gift-card Payment
-    // Setting, so it appears among the payment methods instead. Writing
-    // `gift_card_code` on the order there is meaningless, and letting it
-    // through would silently apply a gift card that no session reflects — so
-    // this overrides an explicit `codeType` too, rather than trusting it.
-    if (paymentsModel === "payment_sessions") {
+    // An order created with API version 2026-05 takes only the coupon here.
+    // Its gift cards are spent by creating a Payment Session against a
+    // gift-card Payment Setting, and the API no longer validates nor applies
+    // the order-level one: `gift_card_code` is stored unchecked, and so is
+    // anything sent as `gift_card_or_coupon_code`, which tries the gift card
+    // first — a coupon typed there is kept as a gift card code and never
+    // discounts. This holds even when the order also offers the older
+    // payment methods, and it overrides an explicit `codeType` too.
+    //
+    // What decides it is the version the order was created with, since the API
+    // fixes the payment engine then. Until that is readable — the SDK drops the
+    // `meta` it arrives in — the payments model stands in for it, as it did
+    // before.
+    const couponOnly =
+      isCreatedWithVersion(order, "2026-05") ?? paymentsModel === "payment_sessions"
+    if (couponOnly) {
       setType("coupon_code")
       return
     }

From a8d7ac5e295b218eb75898822026514547ed934e Mon Sep 17 00:00:00 2001
From: Giuseppe Ciotola <30926550+gciotola@users.noreply.github.com>
Date: Mon, 5 Oct 2026 15:17:06 +0200
Subject: [PATCH 2/3] feat: read created_with_version from the SDK resource
 meta

---
 packages/core-components/package.json         |  2 +-
 .../createdWithVersion.spec.ts                | 29 ++++++++---------
 .../payment_sessions/createdWithVersion.ts    | 31 +++++--------------
 packages/docs/package.json                    |  2 +-
 packages/react-components/package.json        |  2 +-
 ...iftCardOrCouponForm.paymentsModel.spec.tsx | 17 +++-------
 .../gift_cards/GiftCardOrCouponForm.tsx       |  5 ++-
 packages/react-hooks-components/package.json  |  2 +-
 pnpm-lock.yaml                                | 24 +++++++-------
 9 files changed, 43 insertions(+), 71 deletions(-)

diff --git a/packages/core-components/package.json b/packages/core-components/package.json
index d763973b..dbb42e43 100644
--- a/packages/core-components/package.json
+++ b/packages/core-components/package.json
@@ -56,6 +56,6 @@
   },
   "dependencies": {
     "@commercelayer/js-auth": "^8.0.0",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@57f8b0a"
+    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f"
   }
 }
diff --git a/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts b/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
index dfa7d97f..2a3afbf0 100644
--- a/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
+++ b/packages/core-components/src/payment_sessions/createdWithVersion.spec.ts
@@ -2,34 +2,31 @@ import type { Order } from "@commercelayer/sdk"
 import { describe, expect, it } from "vitest"
 import { isCreatedWithVersion } from "./createdWithVersion"
 
-const order = (extra: Record<string, unknown>): Order =>
-  ({ id: "order-1", ...extra }) as unknown as Order
+// The version as the SDK returns it: under the resource's `meta`.
+const order = (createdWithVersion?: string): Order =>
+  ({
+    id: "order-1",
+    ...(createdWithVersion != null ? { meta: { created_with_version: createdWithVersion } } : {}),
+  }) as unknown as Order
 
 describe("isCreatedWithVersion", () => {
-  it("compares the version flattened among the attributes", () => {
-    expect(isCreatedWithVersion(order({ created_with_version: "2026-05" }), "2026-05")).toBe(true)
-    expect(isCreatedWithVersion(order({ created_with_version: "2017-08" }), "2026-05")).toBe(false)
-  })
-
-  it("compares the version under meta, where the API sends it", () => {
-    expect(
-      isCreatedWithVersion(order({ meta: { created_with_version: "2017-08" } }), "2017-08")
-    ).toBe(true)
+  it("compares the version the API reports in the order's meta", () => {
+    expect(isCreatedWithVersion(order("2026-05"), "2026-05")).toBe(true)
+    expect(isCreatedWithVersion(order("2017-08"), "2026-05")).toBe(false)
   })
 
   it("matches the version exactly", () => {
-    expect(isCreatedWithVersion(order({ created_with_version: "2027-01" }), "2026-05")).toBe(false)
+    expect(isCreatedWithVersion(order("2027-01"), "2026-05")).toBe(false)
   })
 
   it("takes only a version the SDK supports", () => {
     // @ts-expect-error a mistyped version is a compile error, not a silent false
-    expect(isCreatedWithVersion(order({ created_with_version: "2026-05" }), "2026-5")).toBe(false)
+    expect(isCreatedWithVersion(order("2026-05"), "2026-5")).toBe(false)
   })
 
   it("is undefined when the order does not say which version created it", () => {
-    // What every order looks like until the SDK stops dropping `meta`.
-    expect(isCreatedWithVersion(order({}), "2026-05")).toBeUndefined()
-    expect(isCreatedWithVersion(order({ created_with_version: "" }), "2026-05")).toBeUndefined()
+    expect(isCreatedWithVersion(order(), "2026-05")).toBeUndefined()
+    expect(isCreatedWithVersion(order(""), "2026-05")).toBeUndefined()
     expect(isCreatedWithVersion(undefined, "2026-05")).toBeUndefined()
     expect(isCreatedWithVersion(null, "2026-05")).toBeUndefined()
   })
diff --git a/packages/core-components/src/payment_sessions/createdWithVersion.ts b/packages/core-components/src/payment_sessions/createdWithVersion.ts
index 64454854..c01bd583 100644
--- a/packages/core-components/src/payment_sessions/createdWithVersion.ts
+++ b/packages/core-components/src/payment_sessions/createdWithVersion.ts
@@ -1,22 +1,5 @@
 import type { ApiVersion, Order } from "@commercelayer/sdk"
 
-/**
- * The API version the order was created with.
- *
- * Core API sends it as the resource's `meta.created_with_version`, which the
- * SDK drops when it normalizes a response, so for now it is read from wherever
- * a newer SDK will put it: flattened among the attributes, or under `meta`.
- * Undefined until then, and for any order that comes back without it.
- */
-function readCreatedWithVersion(order?: Order | null): string | undefined {
-  const source = order as
-    | { created_with_version?: unknown; meta?: { created_with_version?: unknown } }
-    | null
-    | undefined
-  const version = source?.created_with_version ?? source?.meta?.created_with_version
-  return typeof version === "string" && version !== "" ? version : undefined
-}
-
 /**
  * Whether the order was created with exactly this API version, e.g. `2026-05`.
  *
@@ -26,17 +9,19 @@ function readCreatedWithVersion(order?: Order | null): string | undefined {
  * neither validated nor applied, and one created with `2017-08` keeps it even
  * when read with `2026-05`.
  *
- * `version` is one the SDK supports, so a mistyped one fails to compile rather
- * than silently never matching.
+ * The version is the one the API reports in the order's `meta`. `version` is
+ * one the SDK supports, so a mistyped one fails to compile rather than silently
+ * never matching.
  *
- * Undefined when the order does not say which version created it, so callers
- * can keep deciding the way they did before it was available.
+ * Undefined when the order does not say which version created it — the API did
+ * not report it, or the order was not fetched from the API — so callers can
+ * keep deciding the way they would without it.
  */
 export function isCreatedWithVersion(
   order: Order | null | undefined,
   version: ApiVersion
 ): boolean | undefined {
-  const createdWith = readCreatedWithVersion(order)
-  if (createdWith == null) return undefined
+  const createdWith = order?.meta?.created_with_version
+  if (createdWith == null || createdWith === "") return undefined
   return createdWith === version
 }
diff --git a/packages/docs/package.json b/packages/docs/package.json
index f55b947c..484bde5e 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -21,7 +21,7 @@
     "@babel/core": "^7.29.7",
     "@babel/preset-env": "^7.29.7",
     "@commercelayer/js-auth": "^8.0.0",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@57f8b0a",
+    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
     "@mdx-js/react": "^3.1.1",
     "@storybook/addon-actions": "^9.0.8",
     "@storybook/addon-backgrounds": "^9.0.8",
diff --git a/packages/react-components/package.json b/packages/react-components/package.json
index 39cccaeb..ea6c3892 100644
--- a/packages/react-components/package.json
+++ b/packages/react-components/package.json
@@ -64,7 +64,7 @@
     "@commercelayer/core-components": "workspace:*",
     "@commercelayer/organization-config": "^2.8.4",
     "@commercelayer/react-hooks-components": "workspace:*",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@57f8b0a",
+    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
     "@stripe/react-stripe-js": "^6.8.1",
     "@stripe/stripe-js": "^9.10.0",
     "@tanstack/react-table": "^8.21.3",
diff --git a/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx b/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
index 3dee48f6..1e3bdb67 100644
--- a/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
+++ b/packages/react-components/specs/gift_cards/GiftCardOrCouponForm.paymentsModel.spec.tsx
@@ -75,7 +75,7 @@ describe("GiftCardOrCouponForm by the API version the order was created with", (
     renderForm({
       id: "order-1",
       available_payment_methods: [{ id: "pm-1" }],
-      created_with_version: "2026-05",
+      meta: { created_with_version: "2026-05" },
     } as never)
     expect(inputName()).toBe("coupon_code")
   })
@@ -85,7 +85,7 @@ describe("GiftCardOrCouponForm by the API version the order was created with", (
       {
         id: "order-1",
         available_payment_methods: [{ id: "pm-1" }],
-        created_with_version: "2026-05",
+        meta: { created_with_version: "2026-05" },
       } as never,
       "gift_card_code"
     )
@@ -96,7 +96,7 @@ describe("GiftCardOrCouponForm by the API version the order was created with", (
     renderForm({
       id: "order-1",
       available_payment_methods: [{ id: "pm-1" }],
-      created_with_version: "2017-08",
+      meta: { created_with_version: "2017-08" },
     } as never)
     expect(inputName()).toBe("gift_card_or_coupon_code")
   })
@@ -107,17 +107,8 @@ describe("GiftCardOrCouponForm by the API version the order was created with", (
     renderForm({
       id: "order-1",
       available_payment_settings: [MANUAL],
-      created_with_version: "2017-08",
+      meta: { created_with_version: "2017-08" },
     } as never)
     expect(inputName()).toBe("gift_card_or_coupon_code")
   })
-
-  it("reads the version where the API sends it, under meta", () => {
-    renderForm({
-      id: "order-1",
-      available_payment_methods: [{ id: "pm-1" }],
-      meta: { created_with_version: "2026-05" },
-    } as never)
-    expect(inputName()).toBe("coupon_code")
-  })
 })
diff --git a/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx b/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
index 0bbe73b6..a8e4c422 100644
--- a/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
+++ b/packages/react-components/src/components/gift_cards/GiftCardOrCouponForm.tsx
@@ -52,9 +52,8 @@ export function GiftCardOrCouponForm(props: Props): JSX.Element | null {
     // payment methods, and it overrides an explicit `codeType` too.
     //
     // What decides it is the version the order was created with, since the API
-    // fixes the payment engine then. Until that is readable — the SDK drops the
-    // `meta` it arrives in — the payments model stands in for it, as it did
-    // before.
+    // fixes the payment engine then. When the order does not say — the API did
+    // not report it — the payments model stands in for it.
     const couponOnly =
       isCreatedWithVersion(order, "2026-05") ?? paymentsModel === "payment_sessions"
     if (couponOnly) {
diff --git a/packages/react-hooks-components/package.json b/packages/react-hooks-components/package.json
index 21ca0771..522849b7 100644
--- a/packages/react-hooks-components/package.json
+++ b/packages/react-hooks-components/package.json
@@ -50,7 +50,7 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@babel/core": "^8.0.1",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@57f8b0a",
+    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
     "@rolldown/plugin-babel": "^0.2.3",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a77d7503..42c3f171 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -63,8 +63,8 @@ importers:
         specifier: ^8.0.0
         version: 8.0.0
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
-        version: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
+        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
     devDependencies:
       '@arethetypeswrong/cli':
         specifier: ^0.18.5
@@ -110,8 +110,8 @@ importers:
         specifier: ^8.0.0
         version: 8.0.0
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
-        version: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
+        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
       '@mdx-js/react':
         specifier: ^3.1.1
         version: 3.1.1(@types/react@19.2.18)(react@19.2.8)
@@ -188,8 +188,8 @@ importers:
         specifier: workspace:*
         version: link:../react-hooks-components
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
-        version: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
+        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
       '@stripe/react-stripe-js':
         specifier: ^6.8.1
         version: 6.8.1(@stripe/stripe-js@9.13.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
@@ -316,8 +316,8 @@ importers:
         specifier: ^8.0.1
         version: 8.0.1
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
-        version: https://pkg.pr.new/@commercelayer/sdk@57f8b0a
+        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
       '@rolldown/plugin-babel':
         specifier: ^0.2.3
         version: 0.2.3(@babel/core@8.0.1)(@babel/runtime@7.29.7)(rolldown@1.2.3)(vite@8.2.1(@types/node@26.2.0)(esbuild@0.28.2)(yaml@2.9.0))
@@ -1113,9 +1113,9 @@ packages:
     resolution: {integrity: sha512-ZlgIhQx7vu89ZD3eOCSkCe7kNb5LgEGy0p4Gayi75sxfHfJRXKkoX2NC+nkp2pFosi4SBYhlQFcd/EtzStAQGw==}
     engines: {node: '>=18', pnpm: '>=7'}
 
-  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@57f8b0a':
-    resolution: {integrity: sha512-cWoOVjEpvet39vKAz5ZDKc04B7+fOzJjSEj9ryQ+5M4Tvylj6ssiJ7Mi6q2yh/TORlaqUj8IZv52SgvH7oCuXw==, tarball: https://pkg.pr.new/@commercelayer/sdk@57f8b0a}
-    version: 8.0.0-beta.13
+  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@4d57c9f':
+    resolution: {integrity: sha512-3sDEllwNuK+P3Nz5EVWJuRho/SgSKC01h2aA/H/1tIbb2upSMC5Yg6ldMGXJDIa3NLrST+b4kC0zgQPgzsZq+Q==, tarball: https://pkg.pr.new/@commercelayer/sdk@4d57c9f}
+    version: 8.0.0-beta.14
     engines: {node: '>=20'}
 
   '@csstools/color-helpers@6.1.0':
@@ -4853,7 +4853,7 @@ snapshots:
       '@commercelayer/js-auth': 7.4.2
       merge-anything: 5.1.7
 
-  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@57f8b0a': {}
+  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@4d57c9f': {}
 
   '@csstools/color-helpers@6.1.0': {}
 

From 1ba7d7caea57a8728c96cec9a2c76652e8025251 Mon Sep 17 00:00:00 2001
From: Giuseppe Ciotola <30926550+gciotola@users.noreply.github.com>
Date: Tue, 6 Oct 2026 10:03:05 +0200
Subject: [PATCH 3/3] chore: update commercelayer/sdk version

---
 packages/core-components/package.json        |  2 +-
 packages/docs/package.json                   |  2 +-
 packages/react-components/package.json       |  2 +-
 packages/react-hooks-components/package.json |  2 +-
 pnpm-lock.yaml                               | 23 ++++++++++----------
 pnpm-workspace.yaml                          |  1 +
 6 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/core-components/package.json b/packages/core-components/package.json
index dbb42e43..3d1cfead 100644
--- a/packages/core-components/package.json
+++ b/packages/core-components/package.json
@@ -56,6 +56,6 @@
   },
   "dependencies": {
     "@commercelayer/js-auth": "^8.0.0",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f"
+    "@commercelayer/sdk": "^8.0.0"
   }
 }
diff --git a/packages/docs/package.json b/packages/docs/package.json
index 484bde5e..596ad2d3 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -21,7 +21,7 @@
     "@babel/core": "^7.29.7",
     "@babel/preset-env": "^7.29.7",
     "@commercelayer/js-auth": "^8.0.0",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
+    "@commercelayer/sdk": "^8.0.0",
     "@mdx-js/react": "^3.1.1",
     "@storybook/addon-actions": "^9.0.8",
     "@storybook/addon-backgrounds": "^9.0.8",
diff --git a/packages/react-components/package.json b/packages/react-components/package.json
index ea6c3892..504aee14 100644
--- a/packages/react-components/package.json
+++ b/packages/react-components/package.json
@@ -64,7 +64,7 @@
     "@commercelayer/core-components": "workspace:*",
     "@commercelayer/organization-config": "^2.8.4",
     "@commercelayer/react-hooks-components": "workspace:*",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
+    "@commercelayer/sdk": "^8.0.0",
     "@stripe/react-stripe-js": "^6.8.1",
     "@stripe/stripe-js": "^9.10.0",
     "@tanstack/react-table": "^8.21.3",
diff --git a/packages/react-hooks-components/package.json b/packages/react-hooks-components/package.json
index 522849b7..cec2b9ad 100644
--- a/packages/react-hooks-components/package.json
+++ b/packages/react-hooks-components/package.json
@@ -50,7 +50,7 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@babel/core": "^8.0.1",
-    "@commercelayer/sdk": "https://pkg.pr.new/@commercelayer/sdk@4d57c9f",
+    "@commercelayer/sdk": "^8.0.0",
     "@rolldown/plugin-babel": "^0.2.3",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 42c3f171..f9515716 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -63,8 +63,8 @@ importers:
         specifier: ^8.0.0
         version: 8.0.0
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
-        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        specifier: ^8.0.0
+        version: 8.0.0
     devDependencies:
       '@arethetypeswrong/cli':
         specifier: ^0.18.5
@@ -110,8 +110,8 @@ importers:
         specifier: ^8.0.0
         version: 8.0.0
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
-        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        specifier: ^8.0.0
+        version: 8.0.0
       '@mdx-js/react':
         specifier: ^3.1.1
         version: 3.1.1(@types/react@19.2.18)(react@19.2.8)
@@ -188,8 +188,8 @@ importers:
         specifier: workspace:*
         version: link:../react-hooks-components
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
-        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        specifier: ^8.0.0
+        version: 8.0.0
       '@stripe/react-stripe-js':
         specifier: ^6.8.1
         version: 6.8.1(@stripe/stripe-js@9.13.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
@@ -316,8 +316,8 @@ importers:
         specifier: ^8.0.1
         version: 8.0.1
       '@commercelayer/sdk':
-        specifier: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
-        version: https://pkg.pr.new/@commercelayer/sdk@4d57c9f
+        specifier: ^8.0.0
+        version: 8.0.0
       '@rolldown/plugin-babel':
         specifier: ^0.2.3
         version: 0.2.3(@babel/core@8.0.1)(@babel/runtime@7.29.7)(rolldown@1.2.3)(vite@8.2.1(@types/node@26.2.0)(esbuild@0.28.2)(yaml@2.9.0))
@@ -1113,9 +1113,8 @@ packages:
     resolution: {integrity: sha512-ZlgIhQx7vu89ZD3eOCSkCe7kNb5LgEGy0p4Gayi75sxfHfJRXKkoX2NC+nkp2pFosi4SBYhlQFcd/EtzStAQGw==}
     engines: {node: '>=18', pnpm: '>=7'}
 
-  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@4d57c9f':
-    resolution: {integrity: sha512-3sDEllwNuK+P3Nz5EVWJuRho/SgSKC01h2aA/H/1tIbb2upSMC5Yg6ldMGXJDIa3NLrST+b4kC0zgQPgzsZq+Q==, tarball: https://pkg.pr.new/@commercelayer/sdk@4d57c9f}
-    version: 8.0.0-beta.14
+  '@commercelayer/sdk@8.0.0':
+    resolution: {integrity: sha512-cdlMwi3wvK79hs9LTlE8nLsEx7JM1JNPJmtOCDRNzjG/sUiezfO96qDbQmP1Qd2PtUtapcAEqUgDmj59rtGlVw==}
     engines: {node: '>=20'}
 
   '@csstools/color-helpers@6.1.0':
@@ -4853,7 +4852,7 @@ snapshots:
       '@commercelayer/js-auth': 7.4.2
       merge-anything: 5.1.7
 
-  '@commercelayer/sdk@https://pkg.pr.new/@commercelayer/sdk@4d57c9f': {}
+  '@commercelayer/sdk@8.0.0': {}
 
   '@csstools/color-helpers@6.1.0': {}
 
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index e90265d6..d522e25c 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -35,6 +35,7 @@ minimumReleaseAgeExclude:
   - valibot@1.4.2
   - nx@22.7.2 || 22.7.7
   - nanoid@3.3.16 || 3.3.17
+  - '@commercelayer/sdk'
 
 onlyBuiltDependencies:
   - esbuild