@01.software/sdk 0.43.0 → 0.44.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @01.software/sdk
 
+## 0.44.0
+
+### Minor Changes
+
+- 14f6a6a: BREAKING (0.x minor): require `pgProvider` alongside `pgPaymentId` for paid
+  order creation and checkout inputs so storefronts persist the same
+  provider-scoped payment key used by confirmation and payment recovery. Free
+  orders omit both fields.
+
+### Patch Changes
+
+- 2e5c223: Expose registry-backed market country and currency fields in generated Payload collection types.
+- 99727ac: Expose the product `unlisted` status in generated SDK Payload types. Product
+  visibility now lives on `status`; Console migrations add the `unlisted` enum
+  value, convert legacy product visibility values into status, and remove the
+  legacy visibility storage.
+
 ## 0.43.0
 
 ### Minor Changes

package/README.md

@@ -226,7 +226,8 @@ const order = await server.commerce.orders.create({
     { product: productId, variant: variantId, option: optionId, quantity: 1 },
   ],
   totalAmount: 10000,
-  pgPaymentId: 'provider-payment-id', // optional (omit for free orders)
+  pgProvider: 'portone', // required with pgPaymentId
+  pgPaymentId: 'provider-payment-id', // omit both fields for free orders
   discountCode: 'WELCOME10', // optional
 })
 
@@ -346,14 +347,13 @@ mismatches, still throw
 typed `SDKError` subclasses and preserve request IDs through the existing
 `lastRequestId` / `onRequestId` path.
 
-Public product visibility has two axes. Lifecycle `status` must still be
-`published` and `publishedAt` must be current or empty. Then
-`storefrontVisibility` decides storefront exposure: `listed` products appear in
-listing helpers and direct detail, `unlisted` products are omitted from listing
-helpers but can be fetched by direct detail slug/id, and `hidden` products return
-`{ found: false, reason: 'not_published' }` from detail and are omitted from
-listings. Legacy products without `storefrontVisibility` are treated as
-`listed`.
+Public product visibility is driven by product `status` and `publishedAt`.
+Listing helpers return products with `status: 'published'` when `publishedAt`
+is current or empty. Direct detail and checkout admission also allow
+`status: 'unlisted'`, so an unlisted product can be opened by slug/id without
+appearing in PLP/search/curated listing helpers. Draft, archived, scheduled, or
+malformed lifecycle states return `{ found: false, reason: 'not_published' }`
+from detail and are omitted from listings.
 
 The successful product payload exposes inventory rollups without sentinel
 values: `product.totalInventory` is the tracked stock sum across non-unlimited
@@ -457,13 +457,6 @@ const { docs } = await server.collections.from('products').find({
           { publishedAt: { equals: null } },
         ],
       },
-      {
-        or: [
-          { storefrontVisibility: { equals: 'listed' } },
-          { storefrontVisibility: { exists: false } },
-          { storefrontVisibility: { equals: null } },
-        ],
-      },
     ],
   },
   limit: 24,
@@ -775,7 +768,7 @@ Dotted-path filters (`where: { 'product.slug': { equals } }`) are Payload-native
 
 Checklist when `find()` returns `docs: []` unexpectedly, in order of likelihood:
 
-1. **Access control filtered the document.** Many collections enforce public read filters. Products require `status: 'published'`, a current or unset `publishedAt`, and listable storefront visibility (`listed`, legacy missing, or `null`) for publishable-key raw listing reads. Draft, future, `unlisted`, `hidden`, or malformed products silently disappear from raw listing results even when their slug or ID matches. Use the shaped product detail helper for direct-link `unlisted` products. Correlate with backend logs via `client.lastRequestId` (or catch `SDKError.requestId`).
+1. **Access control filtered the document.** Many collections enforce public read filters. Product listing reads require `status: 'published'` plus a current or unset `publishedAt`. Draft, future, `unlisted`, archived, or malformed products silently disappear from raw listing results even when their slug or ID matches. Use `commerce.product.detail({ slug | id })` for `unlisted` products. Correlate with backend logs via `client.lastRequestId` (or catch `SDKError.requestId`).
 2. **Build-time publishable key / API URL differs from runtime.** SSG `generateStaticParams` / `generateMetadata` / the page render must all see the same tenant context. A wrong or missing key at build time produces a baked-in empty response.
 3. **Next.js SSG fetch cache served a stale empty response.** Use `cache: 'no-store'` or `export const revalidate = 0` on server components that should reflect live data.
 4. **`where: { slug: 'x' }` string shorthand.** Always use `{ slug: { equals: 'x' } }` — bare strings silently match nothing.
@@ -1103,7 +1096,7 @@ Available on ServerClient via `server.commerce.orders.*`. `checkout` and `listMi
 // Orders
 await server.commerce.orders.create(params)
 await server.commerce.orders.update({ orderNumber, status: 'confirmed' })
-await server.commerce.orders.checkout({ cartId, pgPaymentId?, orderNumber, customerSnapshot, discountCode? })
+await server.commerce.orders.checkout({ cartId, orderNumber, customerSnapshot, pgProvider, pgPaymentId, discountCode? })
 
 // Single-order lookup (getOrder endpoint removed — use collection find)
 const { docs: [order] } = await server.collections.from('orders').find({
@@ -1129,6 +1122,12 @@ await server.commerce.orders.confirmPayment({
   providerEventId,
 })
 
+// For paid create/checkout flows, pass pgProvider with the same provider slug
+// you will later use for confirmPayment and getByPaymentId. pgProvider and
+// pgPaymentId are a pair: omit both for free orders, or provide both for paid
+// payment windows. getByPaymentId({ pgProvider, pgPaymentId }) is strict and
+// only resolves payment transactions stored with the same provider.
+
 // Low-level transaction annotation / compatibility path. Prefer confirmPayment()
 // for normal provider-verified paid transitions.
 // status: 'failed' records a retryable PG failure on the Transaction only; the