@01.software/sdk 0.72.1 → 0.73.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @01.software/sdk
 
+## 0.73.1
+
+### Patch Changes
+
+- 57e6e15: Sort product options and option values by their orderable `_order` keys in Payload's fractional-indexing (code-unit) order instead of the runtime-locale-dependent `localeCompare` order. For current-format keys this is the order the Admin Panel shows.
+- 623b7e8: Update the generated field descriptions for the tenant base currency and the market exchange rate.
+- 265ad09: Synchronize generated storage types for internal Project invitations and private
+  current-email verification evidence. No invitation SDK API or collection access
+  is added.
+
+## 0.73.0
+
+### Minor Changes
+
+- b271588: Add optional market selection to events.getAdmissionAvailability so callers can display the same market price used by Cart and Checkout. Omitted market uses the catalog default; the public price response keeps its existing fields. Resolved-market reads, including default-market calls, omit admission types whose same-tenant products are not assigned to that market.
+- 41c7d41: Add server-only `memberships.billingCustodyContext` to obtain the Console-owned
+  restore generation through the existing delegated HMAC custody boundary. Keep
+  legacy ciphertext requests and responses compatible. Deploy Console support
+  before publishing the SDK or using the updated Membership and CLUB templates.
+  The bundled starters obtain the generation from Console without a storefront
+  environment variable and retain the generation across custody read/CAS updates.
+
+### Patch Changes
+
+- 163b450: Clarify that form submission email settings are retained for compatibility and do not send notifications, without changing field keys or types.
+- ae622d1: Refresh generated workspace sender, credential, and webhook field descriptions. Public types and API behavior are unchanged.
+- f8a25e1: Clarify that tenant administrators obtain the billing custody restore generation from the authenticated Console delegated billing connection panel.
+- 9cfcc4e: Update generated User membership guidance to point Project workspace member management to Settings > Workspace > Project environments. No SDK type shape or runtime behavior changes.
+- b8a447c: Clarify generated transaction kind and shipping policy descriptions without changing field keys or types.
+- 4781438: Clarify the generated customer address description. Field types and API response shapes are unchanged.
+- 3d0665d: Clarify the generated preview destination description without changing its schema or behavior.
+- 668102b: Webhook.url 필드 설명의 민감정보 경고를 복원합니다. 타입 구조는 변경하지 않습니다.
+- 5ef9bc6: Format the numbers in the `Monthly API usage limit exceeded (current/limit)` error message with a fixed `en-US` locale so the message no longer depends on the runtime's default locale.
+
 ## 0.72.1
 
 ### Patch Changes

package/README.md

@@ -933,6 +933,32 @@ request UUID and the current version; exact retries retain the original values.
 A privacy-erased snapshot has state `erased`, null `externalCustomerId`, and
 null `previousState`. Keep these calls and snapshots in trusted server code.
 
+### Delegated billing ciphertext
+
+The server client obtains the Console-owned restore generation through the
+existing custody endpoint, using its server key and delegated connection HMAC:
+
+```ts
+const { generation } = await server.memberships.billingCustodyContext({
+  membershipId,
+  webhookSecret,
+})
+const stored = await server.memberships.billingCustody({
+  action: 'read',
+  membershipId,
+  webhookSecret,
+  generation,
+})
+```
+
+Keep that generation and `stored.version` for mutations based on this read.
+Obtain a context immediately before a fresh initial upload (`expectedVersion: 0`).
+Generation mismatch stops execution; never fetch a new context to retry an old
+mutation or charge. After recovery, provider re-authorization and a fresh encrypted
+upload/readback are required. Existing explicit-generation requests remain
+supported. Deploy Console support before SDK publication and upgraded template
+use; unsupported servers and malformed contexts fail without fallback.
+
 ## Storefront performance defaults
 
 - **PLP:** prefer `commerce.product.listingPage()` or `useProductListingPage()` (GET `/api/products/listing-groups/query/catalog`, CDN-cacheable, card-ready). Use `listingGroupsCatalog({ productIds })` only when IDs are already known. Treat the full listing-groups response shape as a server-auth escape hatch because it can include operational stock fields. Avoid fetching a product list and then calling `detail()` per card.
@@ -2328,6 +2354,20 @@ replacement API. Pass an empty list to clear codes. Singular `admission`,
 Browser `mine()`/`merge({ guestCartToken })` derive customer identity from the
 JWT; server calls require an explicit `customerToken`.
 
+### Event admission availability
+
+For paid admission choices, call
+`client.events.getAdmissionAvailability({ occurrence, market: 'kr' })` with an
+active market handle or id. Omit `market` for the catalog default. The public
+price includes `amount`, `compareAtPrice`, `currency`, and `marketId` resolved
+from fixed market prices or the market calculation; an unknown market returns
+`404 not_found`. Use the same market for the Cart. Checkout re-reads current
+pricing and eligibility. When a market resolves, admission types are returned
+only when their same-tenant product is assigned to that market. This filter also
+applies to existing calls that omit `market` and use the default market; missing
+products and empty assignments are omitted. With no active market, base pricing
+and the existing unfiltered behavior remain.
+
 ### Customer event registration history
 
 After customer sign-in, `client.events.listMyRegistrations({ page: 1, limit: 10 })`

package/dist/client.cjs

@@ -896,7 +896,7 @@ async function httpFetch(url, options) {
           );
           const usageError = attachRequestId(
             createUsageLimitError(
-              `Monthly API usage limit exceeded (${current.toLocaleString()}/${limit.toLocaleString()})`,
+              `Monthly API usage limit exceeded (${current.toLocaleString("en-US")}/${limit.toLocaleString("en-US")})`,
               { limit, current, remaining },
               {
                 url,
@@ -5613,6 +5613,11 @@ function getRelationID(value) {
   }
   return void 0;
 }
+function compareOrdinal(left, right) {
+  if (left < right) return -1;
+  if (left > right) return 1;
+  return 0;
+}
 function extractEntityId(value) {
   if (typeof value === "string") return value;
   if (typeof value === "number") return String(value);
@@ -6225,7 +6230,7 @@ function compareVariantOrder(a, b) {
   }
   const aId = String(getRelationID(a.id) ?? "");
   const bId = String(getRelationID(b.id) ?? "");
-  return aId.localeCompare(bId);
+  return compareOrdinal(aId, bId);
 }
 function getVariantAvailableForSale(variant) {
   if (variant.isActive === false) return false;
@@ -6830,6 +6835,8 @@ function buildRangeEndpoint(params) {
 function buildAdmissionAvailabilityEndpoint(params) {
   const urlParams = new URLSearchParams();
   urlParams.set("occurrence", params.occurrence);
+  const normalizedMarket2 = params.market?.trim();
+  if (normalizedMarket2) urlParams.set("market", normalizedMarket2);
   return resolveOperationPath(
     EVENTS_ENDPOINT_OPERATIONS.occurrences.admissionAvailability,
     { query: urlParams }