@01.software/sdk 0.41.0 → 0.42.0

package/dist/server.d.cts

@@ -1,11 +1,11 @@
-import { S as ServerCollectionClient } from './collection-client-Bymfni8u.cjs';
-export { C as CollectionClient } from './collection-client-Bymfni8u.cjs';
-import { N as BaseApi, O as ServerApiOptions, Q as ServerCommerceClient, T as TenantIntrospectionClient, a as CommunityClient, V as BanCustomerParams, X as CommunityBan, Y as UnbanCustomerParams, d as ClientState, Z as ClientServerConfig, E as EventsClient, _ as RootServerClientWithEvents } from './types-Bl-m9ttd.cjs';
-export { A as AddItemParams, g as ApplyDiscountParams, h as CheckoutParams, i as ClearCartParams, $ as CollectionFieldSchema, a0 as CollectionSchemaResponse, a1 as EventGuestCancelParams, a2 as EventGuestRegistration, a3 as EventGuestRegistrationResponse, a4 as EventRegistrationAnswerInput, a5 as EventRegistrationAttendeeInput, a6 as EventRegistrationPublic, a7 as EventRegistrationRegisterParams, a8 as EventRegistrationRegisterResponse, a9 as EventsCalendarItem, aa as EventsClientOptions, ab as EventsDateParam, ac as EventsExternalSource, ad as EventsLocation, ae as EventsOccurrenceLocation, af as EventsRangeEvent, ag as EventsRangeOccurrence, ah as EventsRangeParams, ai as EventsRangeResponse, aj as EventsTaxonomyItem, ak as ModerationApi, o as PublicCart, p as PublicCartItem, q as PublicCartReference, r as PublicMediaAsset, s as PublicMediaSize, t as PublicOrder, u as PublicOrderItem, v as PublicOrderReference, R as RemoveDiscountParams, w as RemoveItemParams, al as RootServerClient, am as TenantFeatureProgressEvidenceValue, an as TenantFeatureProgressFeature, ao as TenantFeatureProgressGroup, ap as TenantFeatureProgressInput, aq as TenantFeatureProgressItem, ar as TenantFeatureProgressItemState, as as TenantFeatureProgressResponse, at as TenantFeatureProgressSeverity, au as TenantFeatureProgressStatus, av as TenantIntrospectionApi, aw as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-Bl-m9ttd.cjs';
-import './payload-types-DC0xzR9i.cjs';
+import { S as ServerCollectionClient } from './collection-client-B-qVIBnJ.cjs';
+export { C as CollectionClient } from './collection-client-B-qVIBnJ.cjs';
+import { N as BaseApi, O as ServerApiOptions, Q as ServerCommerceClient, T as TenantIntrospectionClient, a as CommunityClient, V as BanCustomerParams, X as CommunityBan, Y as UnbanCustomerParams, d as ClientState, Z as ClientServerConfig, E as EventsClient, _ as RootServerClientWithEvents } from './types-BL7M-EUV.cjs';
+export { A as AddItemParams, g as ApplyDiscountParams, h as CheckoutParams, i as ClearCartParams, $ as CollectionFieldSchema, a0 as CollectionSchemaResponse, a1 as EventGuestCancelParams, a2 as EventGuestRegistration, a3 as EventGuestRegistrationResponse, a4 as EventRegistrationAnswerInput, a5 as EventRegistrationAttendeeInput, a6 as EventRegistrationPublic, a7 as EventRegistrationRegisterParams, a8 as EventRegistrationRegisterResponse, a9 as EventsCalendarItem, aa as EventsClientOptions, ab as EventsDateParam, ac as EventsExternalSource, ad as EventsLocation, ae as EventsOccurrenceLocation, af as EventsRangeEvent, ag as EventsRangeOccurrence, ah as EventsRangeParams, ai as EventsRangeResponse, aj as EventsTaxonomyItem, ak as ModerationApi, o as PublicCart, p as PublicCartItem, q as PublicCartReference, r as PublicMediaAsset, s as PublicMediaSize, t as PublicOrder, u as PublicOrderItem, v as PublicOrderReference, R as RemoveDiscountParams, w as RemoveItemParams, al as RootServerClient, am as TenantFeatureProgressEvidenceValue, an as TenantFeatureProgressFeature, ao as TenantFeatureProgressGroup, ap as TenantFeatureProgressInput, aq as TenantFeatureProgressItem, ar as TenantFeatureProgressItemState, as as TenantFeatureProgressResponse, at as TenantFeatureProgressSeverity, au as TenantFeatureProgressStatus, av as TenantIntrospectionApi, aw as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-BL7M-EUV.cjs';
+import './payload-types-C7Ul4ElL.cjs';
 import './metadata.cjs';
-import './const-4BUtUdGU.cjs';
-import './types-BvpjooU-.cjs';
+import './const-BiDujixF.cjs';
+import './types-ChV1t4ei.cjs';
 
 type PreviewDetailParams = {
     collection: string;

package/dist/server.d.ts

@@ -1,11 +1,11 @@
-import { S as ServerCollectionClient } from './collection-client-CN4lj6gi.js';
-export { C as CollectionClient } from './collection-client-CN4lj6gi.js';
-import { N as BaseApi, O as ServerApiOptions, Q as ServerCommerceClient, T as TenantIntrospectionClient, a as CommunityClient, V as BanCustomerParams, X as CommunityBan, Y as UnbanCustomerParams, d as ClientState, Z as ClientServerConfig, E as EventsClient, _ as RootServerClientWithEvents } from './types-CHrzs2GB.js';
-export { A as AddItemParams, g as ApplyDiscountParams, h as CheckoutParams, i as ClearCartParams, $ as CollectionFieldSchema, a0 as CollectionSchemaResponse, a1 as EventGuestCancelParams, a2 as EventGuestRegistration, a3 as EventGuestRegistrationResponse, a4 as EventRegistrationAnswerInput, a5 as EventRegistrationAttendeeInput, a6 as EventRegistrationPublic, a7 as EventRegistrationRegisterParams, a8 as EventRegistrationRegisterResponse, a9 as EventsCalendarItem, aa as EventsClientOptions, ab as EventsDateParam, ac as EventsExternalSource, ad as EventsLocation, ae as EventsOccurrenceLocation, af as EventsRangeEvent, ag as EventsRangeOccurrence, ah as EventsRangeParams, ai as EventsRangeResponse, aj as EventsTaxonomyItem, ak as ModerationApi, o as PublicCart, p as PublicCartItem, q as PublicCartReference, r as PublicMediaAsset, s as PublicMediaSize, t as PublicOrder, u as PublicOrderItem, v as PublicOrderReference, R as RemoveDiscountParams, w as RemoveItemParams, al as RootServerClient, am as TenantFeatureProgressEvidenceValue, an as TenantFeatureProgressFeature, ao as TenantFeatureProgressGroup, ap as TenantFeatureProgressInput, aq as TenantFeatureProgressItem, ar as TenantFeatureProgressItemState, as as TenantFeatureProgressResponse, at as TenantFeatureProgressSeverity, au as TenantFeatureProgressStatus, av as TenantIntrospectionApi, aw as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-CHrzs2GB.js';
-import './payload-types-DC0xzR9i.js';
+import { S as ServerCollectionClient } from './collection-client-BhCMwIus.js';
+export { C as CollectionClient } from './collection-client-BhCMwIus.js';
+import { N as BaseApi, O as ServerApiOptions, Q as ServerCommerceClient, T as TenantIntrospectionClient, a as CommunityClient, V as BanCustomerParams, X as CommunityBan, Y as UnbanCustomerParams, d as ClientState, Z as ClientServerConfig, E as EventsClient, _ as RootServerClientWithEvents } from './types-D5dSNIGs.js';
+export { A as AddItemParams, g as ApplyDiscountParams, h as CheckoutParams, i as ClearCartParams, $ as CollectionFieldSchema, a0 as CollectionSchemaResponse, a1 as EventGuestCancelParams, a2 as EventGuestRegistration, a3 as EventGuestRegistrationResponse, a4 as EventRegistrationAnswerInput, a5 as EventRegistrationAttendeeInput, a6 as EventRegistrationPublic, a7 as EventRegistrationRegisterParams, a8 as EventRegistrationRegisterResponse, a9 as EventsCalendarItem, aa as EventsClientOptions, ab as EventsDateParam, ac as EventsExternalSource, ad as EventsLocation, ae as EventsOccurrenceLocation, af as EventsRangeEvent, ag as EventsRangeOccurrence, ah as EventsRangeParams, ai as EventsRangeResponse, aj as EventsTaxonomyItem, ak as ModerationApi, o as PublicCart, p as PublicCartItem, q as PublicCartReference, r as PublicMediaAsset, s as PublicMediaSize, t as PublicOrder, u as PublicOrderItem, v as PublicOrderReference, R as RemoveDiscountParams, w as RemoveItemParams, al as RootServerClient, am as TenantFeatureProgressEvidenceValue, an as TenantFeatureProgressFeature, ao as TenantFeatureProgressGroup, ap as TenantFeatureProgressInput, aq as TenantFeatureProgressItem, ar as TenantFeatureProgressItemState, as as TenantFeatureProgressResponse, at as TenantFeatureProgressSeverity, au as TenantFeatureProgressStatus, av as TenantIntrospectionApi, aw as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-D5dSNIGs.js';
+import './payload-types-C7Ul4ElL.js';
 import './metadata.js';
-import './const-ymprfiPf.js';
-import './types-Bh2p-EMc.js';
+import './const-pmHlwm3E.js';
+import './types-Bf2iCjy8.js';
 
 type PreviewDetailParams = {
     collection: string;

package/dist/server.js

@@ -70,6 +70,26 @@ var TimeoutError = class extends SDKError {
     this.name = "TimeoutError";
   }
 };
+var GoneError = class extends SDKError {
+  constructor(message = "The requested resource is no longer available.", details, userMessage, suggestion) {
+    super("GONE_ERROR", message, 410, details, userMessage, suggestion);
+    this.name = "GoneError";
+  }
+};
+var ServiceUnavailableError = class extends SDKError {
+  constructor(message = "Service temporarily unavailable.", retryAfter, details, userMessage, suggestion) {
+    super(
+      "SERVICE_UNAVAILABLE_ERROR",
+      message,
+      503,
+      details,
+      userMessage,
+      suggestion
+    );
+    this.name = "ServiceUnavailableError";
+    this.retryAfter = retryAfter;
+  }
+};
 var UsageLimitError = class extends SDKError {
   constructor(message, usage, details, userMessage, suggestion) {
     super("USAGE_LIMIT_ERROR", message, 429, details, userMessage, suggestion);
@@ -151,6 +171,14 @@ var createValidationError = (message, details, userMessage, suggestion, status)
 var createApiError = (message, status, details, userMessage, suggestion, requestId) => new ApiError(message, status, details, userMessage, suggestion, requestId);
 var createConfigError = (message, details, userMessage, suggestion) => new ConfigError(message, details, userMessage, suggestion);
 var createTimeoutError = (message, details, userMessage, suggestion) => new TimeoutError(message, details, userMessage, suggestion);
+var createGoneError = (message, details, userMessage, suggestion) => new GoneError(message, details, userMessage, suggestion);
+var createServiceUnavailableError = (message, retryAfter, details, userMessage, suggestion) => new ServiceUnavailableError(
+  message,
+  retryAfter,
+  details,
+  userMessage,
+  suggestion
+);
 var createUsageLimitError = (message, usage, details, userMessage, suggestion) => new UsageLimitError(message, usage, details, userMessage, suggestion);
 var createAuthError = (message, details, userMessage, suggestion, requestId) => new AuthError(message, details, userMessage, suggestion, requestId);
 var createPermissionError = (message, details, userMessage, suggestion, requestId) => new PermissionError(message, details, userMessage, suggestion, requestId);
@@ -175,7 +203,7 @@ function requirePublishableKeyForSecret(apiName, publishableKey, secretKey) {
   return publishableKey ?? "";
 }
 
-// src/core/client/types.ts
+// src/core/internal/utils/api-url.ts
 function resolveApiUrl(apiUrl) {
   if (apiUrl) {
     return apiUrl.replace(/\/$/, "");
@@ -192,7 +220,7 @@ function resolveApiUrl(apiUrl) {
 // src/core/internal/utils/http.ts
 var DEFAULT_TIMEOUT = 3e4;
 var STOREFRONT_BROWSER_TIMEOUT = 15e3;
-var DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
+var DEFAULT_RETRYABLE_STATUSES = [408, 500, 502, 503, 504];
 var NON_RETRYABLE_STATUSES = [400, 401, 403, 404, 409, 422];
 var SAFE_METHODS = ["GET", "HEAD", "OPTIONS"];
 var DEFAULT_MAX_RETRIES = 3;
@@ -309,7 +337,12 @@ function attachRequestId(err, id) {
   if (id) err.requestId = id;
   return err;
 }
-function createHttpStatusError(status, parsed, details, requestId) {
+function parseRetryAfter(response) {
+  const raw = response.headers.get("Retry-After");
+  if (!raw) return void 0;
+  return parseInt(raw, 10) || void 0;
+}
+function mapResponseToError(status, parsed, details, requestId, retryAfter) {
   const errorDetails = {
     ...details,
     ...parsed.errors && { errors: parsed.errors },
@@ -372,6 +405,41 @@ function createHttpStatusError(status, parsed, details, requestId) {
       requestId
     );
   }
+  if (status === 410) {
+    return attachRequestId(
+      createGoneError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  if (status === 429) {
+    return attachRequestId(
+      createRateLimitError(
+        parsed.errorMessage,
+        retryAfter,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  if (status === 503) {
+    return attachRequestId(
+      createServiceUnavailableError(
+        parsed.errorMessage,
+        retryAfter,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
   return attachRequestId(
     createNetworkError(
       parsed.errorMessage,
@@ -490,26 +558,17 @@ async function httpFetch(url, options) {
           method: requestInit.method || "GET",
           attempt: attempt + 1
         };
-        if (NON_RETRYABLE_STATUSES.includes(response.status)) {
-          throw createHttpStatusError(
-            response.status,
-            parsed,
-            details,
-            requestId
-          );
-        }
-        const error = attachRequestId(
-          createNetworkError(
-            parsed.errorMessage,
-            response.status,
-            details,
-            parsed.userMessage,
-            getErrorSuggestion(response.status)
-          ),
-          requestId
+        const retryAfter = parseRetryAfter(response);
+        const error = mapResponseToError(
+          response.status,
+          parsed,
+          details,
+          requestId,
+          retryAfter
         );
         const method2 = (requestInit.method || "GET").toUpperCase();
-        if (attempt < retryConfig.maxRetries && SAFE_METHODS.includes(method2) && retryConfig.retryableStatuses.includes(response.status)) {
+        const isTerminal = error instanceof RateLimitError || error instanceof UsageLimitError;
+        if (attempt < retryConfig.maxRetries && SAFE_METHODS.includes(method2) && !isTerminal && !NON_RETRYABLE_STATUSES.includes(response.status) && retryConfig.retryableStatuses.includes(response.status)) {
           lastError = error;
           const retryDelay = retryConfig.retryDelay(attempt);
           debugLog(debug, "error", `Retrying in ${retryDelay}ms...`, error);
@@ -951,9 +1010,10 @@ var CollectionQueryBuilder = class {
    * DELETE /api/{collection}/{id}
    * @returns Deleted document object directly (no wrapper)
    */
-  async remove(id) {
+  async remove(id, options) {
     return this.api.requestDelete(
-      `/api/${String(this.collection)}/${String(id)}`
+      `/api/${String(this.collection)}/${String(id)}`,
+      options
     );
   }
   /**
@@ -1085,8 +1145,9 @@ var CollectionClient = class extends HttpClient {
    * Delete document
    * DELETE /api/{collection}/{id}
    */
-  async requestDelete(endpoint) {
-    const response = await this.fetchWithTracking(endpoint, {
+  async requestDelete(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
+    const response = await this.fetchWithTracking(url, {
       ...this.defaultOptions,
       method: "DELETE"
     });
@@ -1577,42 +1638,123 @@ var ModerationApi = class extends BaseApi {
   }
 };
 
+// src/core/api/endpoints.ts
+var COMMERCE_ENDPOINTS = {
+  orders: {
+    create: "/api/orders/create",
+    update: "/api/orders/update",
+    confirmPayment: "/api/orders/confirm-payment",
+    byPayment: "/api/orders/by-payment",
+    cancel: "/api/orders/cancel",
+    resolveCancelRefund: "/api/orders/resolve-cancel-refund",
+    checkout: "/api/orders/checkout",
+    createFulfillment: "/api/orders/create-fulfillment",
+    updateFulfillment: "/api/orders/update-fulfillment"
+  },
+  transactions: {
+    update: "/api/transactions/update"
+  },
+  returns: {
+    create: "/api/returns/create",
+    update: "/api/returns/update",
+    returnRefund: "/api/returns/return-refund"
+  },
+  fulfillmentOrders: {
+    prepare: "/api/fulfillment-orders/prepare-fulfillment-order"
+  },
+  fulfillments: {
+    bulkImport: "/api/fulfillments/bulk-import"
+  },
+  carts: {
+    mine: "/api/carts/mine",
+    merge: "/api/carts/merge",
+    addItem: "/api/carts/add-item",
+    updateItem: "/api/carts/update-item",
+    removeItem: "/api/carts/remove-item",
+    applyDiscount: "/api/carts/apply-discount",
+    removeDiscount: "/api/carts/remove-discount",
+    clear: "/api/carts/clear"
+  }
+};
+var COMMERCE_ENDPOINT_PATHS = Object.values(
+  COMMERCE_ENDPOINTS
+).flatMap((group) => Object.values(group));
+
 // src/core/api/cart-api.ts
 var CartApi = class extends CustomerScopedApi {
   constructor(options) {
-    super("CartApi", options);
+    super("CartApi", { ...options, requiresCredential: false });
   }
   async execute(endpoint, method, body) {
     return this.request(endpoint, { method, body });
   }
-  getCart(cartId) {
+  /**
+   * Create a cart and receive its `cartToken`. Store the token and pass it to
+   * every subsequent cart operation.
+   */
+  createCart(params = {}) {
+    return this.execute("/api/carts/create", "POST", params);
+  }
+  getCart(cartToken) {
+    return this.execute("/api/carts/get", "POST", { cartToken });
+  }
+  merge(params) {
     return this.execute(
-      `/api/carts/${cartId}?depth=0&joins=false`,
-      "GET"
+      COMMERCE_ENDPOINTS.carts.merge,
+      "POST",
+      params
+    );
+  }
+  /**
+   * Resolve the authenticated customer's active cart by JWT (no `cartToken`
+   * required). Returns the cart and its capability handle, or both `null` when
+   * the customer has no active cart. Requires a customer token.
+   */
+  mine() {
+    return this.execute(
+      COMMERCE_ENDPOINTS.carts.mine,
+      "POST",
+      {}
     );
   }
   addItem(params) {
-    return this.execute("/api/carts/add-item", "POST", params);
+    return this.execute(
+      COMMERCE_ENDPOINTS.carts.addItem,
+      "POST",
+      params
+    );
   }
   updateItem(params) {
-    return this.execute("/api/carts/update-item", "POST", params);
+    return this.execute(
+      COMMERCE_ENDPOINTS.carts.updateItem,
+      "POST",
+      params
+    );
   }
   removeItem(params) {
     return this.execute(
-      "/api/carts/remove-item",
+      COMMERCE_ENDPOINTS.carts.removeItem,
       "POST",
       params
     );
   }
   applyDiscount(params) {
-    return this.execute("/api/carts/apply-discount", "POST", params);
+    return this.execute(
+      COMMERCE_ENDPOINTS.carts.applyDiscount,
+      "POST",
+      params
+    );
   }
   removeDiscount(params) {
-    return this.execute("/api/carts/remove-discount", "POST", params);
+    return this.execute(
+      COMMERCE_ENDPOINTS.carts.removeDiscount,
+      "POST",
+      params
+    );
   }
   clearCart(params) {
     return this.execute(
-      "/api/carts/clear",
+      COMMERCE_ENDPOINTS.carts.clear,
       "POST",
       params
     );
@@ -2423,6 +2565,7 @@ function compareVariantOrder(a, b) {
 function getVariantAvailableForSale(variant) {
   if (variant.isActive === false) return false;
   if (variant.isUnlimited) return true;
+  if (variant.inventoryPolicy === "continue") return true;
   return (variant.stock ?? 0) - (variant.reservedStock ?? 0) > 0;
 }
 function isVariantAvailableForSale(variant) {
@@ -2888,26 +3031,61 @@ var OrderApi = class extends BaseApi {
     const { idempotencyKey } = params;
     const normalizedBody = normalizeCreateOrderBody(params);
     return this.request(
-      "/api/orders/create",
+      COMMERCE_ENDPOINTS.orders.create,
       normalizedBody,
       idempotencyRequestOptions(idempotencyKey)
     );
   }
   updateOrder(params) {
-    return this.request("/api/orders/update", params);
+    return this.request(COMMERCE_ENDPOINTS.orders.update, params);
   }
   updateTransaction(params) {
-    return this.request("/api/transactions/update", params);
+    return this.request(
+      COMMERCE_ENDPOINTS.transactions.update,
+      params
+    );
   }
   confirmPayment(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     const headerKey = idempotencyKey ?? params.providerEventId;
     return this.request(
-      "/api/orders/confirm-payment",
+      COMMERCE_ENDPOINTS.orders.confirmPayment,
       body,
       idempotencyRequestOptions(headerKey)
     );
   }
+  /**
+   * Resolve an order + its payment transaction by PG payment id. Replaces raw
+   * `transactions.find({ where: { pgPaymentId } })` + a local file index in
+   * storefronts. Server-only (sk01_) read of the full populated Order.
+   */
+  getByPaymentId(params) {
+    const query = new URLSearchParams({
+      pgProvider: params.pgProvider,
+      pgPaymentId: params.pgPaymentId
+    }).toString();
+    return this.request(
+      `${COMMERCE_ENDPOINTS.orders.byPayment}?${query}`,
+      void 0,
+      { method: "GET" }
+    );
+  }
+  /**
+   * Composed facade: confirm a provider payment, then resolve the
+   * depth-populated order/transaction by the same payment id. `confirmPayment`'s
+   * wire response carries only IDs (its contract is `.strict()`); this returns
+   * the populated `Order` so storefronts stop reconstructing order state
+   * locally. Two round trips by design — the alternative (widening the strict
+   * confirm-payment wire contract to embed a full Order) is rejected.
+   */
+  async confirmPaymentReturningOrder(params) {
+    const confirmation = await this.confirmPayment(params);
+    const { order, transaction } = await this.getByPaymentId({
+      pgProvider: params.pgProvider,
+      pgPaymentId: params.pgPaymentId
+    });
+    return { ...confirmation, order, transaction };
+  }
   cancelOrder(params) {
     const { idempotencyKey } = params;
     const body = {
@@ -2916,14 +3094,14 @@ var OrderApi = class extends BaseApi {
       reasonDetail: params.reasonDetail
     };
     return this.request(
-      "/api/orders/cancel",
+      COMMERCE_ENDPOINTS.orders.cancel,
       body,
       idempotencyKey ? { headers: { "X-Idempotency-Key": idempotencyKey } } : void 0
     );
   }
   resolveCancelRefund(params) {
     return this.request(
-      "/api/orders/resolve-cancel-refund",
+      COMMERCE_ENDPOINTS.orders.resolveCancelRefund,
       {
         orderNumber: params.orderNumber,
         idempotencyKey: params.idempotencyKey,
@@ -2944,7 +3122,7 @@ var OrderApi = class extends BaseApi {
   checkout(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
-      "/api/orders/checkout",
+      COMMERCE_ENDPOINTS.orders.checkout,
       body,
       idempotencyRequestOptions(idempotencyKey)
     );
@@ -2952,30 +3130,33 @@ var OrderApi = class extends BaseApi {
   createFulfillment(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
-      "/api/orders/create-fulfillment",
+      COMMERCE_ENDPOINTS.orders.createFulfillment,
       body,
       idempotencyRequestOptions(idempotencyKey)
     );
   }
   prepareFulfillmentOrder(params) {
     return this.request(
-      "/api/fulfillment-orders/prepare-fulfillment-order",
+      COMMERCE_ENDPOINTS.fulfillmentOrders.prepare,
       params
     );
   }
   updateFulfillment(params) {
-    return this.request("/api/orders/update-fulfillment", params);
+    return this.request(
+      COMMERCE_ENDPOINTS.orders.updateFulfillment,
+      params
+    );
   }
   bulkImportFulfillments(params) {
     return this.request(
-      "/api/fulfillments/bulk-import",
+      COMMERCE_ENDPOINTS.fulfillments.bulkImport,
       params
     );
   }
   returnWithRefund(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
-      "/api/returns/return-refund",
+      COMMERCE_ENDPOINTS.returns.returnRefund,
       body,
       idempotencyRequestOptions(idempotencyKey)
     );
@@ -2983,13 +3164,13 @@ var OrderApi = class extends BaseApi {
   createReturn(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
-      "/api/returns/create",
+      COMMERCE_ENDPOINTS.returns.create,
       body,
       idempotencyRequestOptions(idempotencyKey)
     );
   }
   updateReturn(params) {
-    return this.request("/api/returns/update", params);
+    return this.request(COMMERCE_ENDPOINTS.returns.update, params);
   }
 };
 
@@ -3075,13 +3256,16 @@ var ServerCommerceClient = class {
       upsert: productApi.upsert.bind(productApi)
     };
     this.cart = {
+      create: cartApi.createCart.bind(cartApi),
       get: cartApi.getCart.bind(cartApi),
       addItem: cartApi.addItem.bind(cartApi),
       updateItem: cartApi.updateItem.bind(cartApi),
       removeItem: cartApi.removeItem.bind(cartApi),
       applyDiscount: cartApi.applyDiscount.bind(cartApi),
       removeDiscount: cartApi.removeDiscount.bind(cartApi),
-      clear: cartApi.clearCart.bind(cartApi)
+      clear: cartApi.clearCart.bind(cartApi),
+      merge: cartApi.merge.bind(cartApi),
+      mine: cartApi.mine.bind(cartApi)
     };
     this.orders = {
       checkout: orderApi.checkout.bind(orderApi),
@@ -3089,6 +3273,8 @@ var ServerCommerceClient = class {
       update: orderApi.updateOrder.bind(orderApi),
       updateTransaction: orderApi.updateTransaction.bind(orderApi),
       confirmPayment: orderApi.confirmPayment.bind(orderApi),
+      confirmPaymentReturningOrder: orderApi.confirmPaymentReturningOrder.bind(orderApi),
+      getByPaymentId: orderApi.getByPaymentId.bind(orderApi),
       cancelOrder: orderApi.cancelOrder.bind(orderApi),
       resolveCancelRefund: orderApi.resolveCancelRefund.bind(orderApi),
       createFulfillment: orderApi.createFulfillment.bind(orderApi),