@01.software/sdk 0.42.0 → 0.43.0

package/dist/server.cjs

@@ -675,6 +675,64 @@ async function httpFetch(url, options) {
   throw lastError ?? new NetworkError("Request failed after retries");
 }
 
+// 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"
+  },
+  products: {
+    stockCheck: "/api/products/stock-check",
+    stockSnapshot: "/api/products/stock",
+    listingGroups: "/api/products/listing-groups",
+    listingGroupsCatalog: "/api/products/listing-groups/catalog",
+    listingGroupsQuery: "/api/products/listing-groups/query",
+    listingGroupsQueryCatalog: "/api/products/listing-groups/query/catalog",
+    detail: "/api/products/detail",
+    detailCatalog: "/api/products/detail/catalog",
+    upsert: "/api/products/upsert"
+  }
+};
+var COMMERCE_ENDPOINT_PATHS = Object.values(
+  COMMERCE_ENDPOINTS
+).flatMap((group) => Object.values(group));
+var MEMBERSHIP_ENDPOINTS = {
+  subscribe: "/api/memberships/subscribe",
+  cancel: (id) => `/api/memberships/${id}/cancel`,
+  me: "/api/memberships/me"
+};
+
 // src/core/internal/utils/query-string.ts
 function productDetailQuery(params) {
   const search = new URLSearchParams();
@@ -683,7 +741,7 @@ function productDetailQuery(params) {
   } else {
     search.set("id", params.id);
   }
-  return `/api/products/detail?${search}`;
+  return `${COMMERCE_ENDPOINTS.products.detail}?${search}`;
 }
 function productDetailCatalogQuery(params) {
   const search = new URLSearchParams();
@@ -692,23 +750,20 @@ function productDetailCatalogQuery(params) {
   } else {
     search.set("id", params.id);
   }
-  return `/api/products/detail/catalog?${search}`;
+  return `${COMMERCE_ENDPOINTS.products.detailCatalog}?${search}`;
 }
 function listingGroupsQuery(params) {
-  return `/api/products/listing-groups?ids=${params.productIds.map(encodeURIComponent).join(",")}`;
+  return `${COMMERCE_ENDPOINTS.products.listingGroups}?ids=${params.productIds.map(encodeURIComponent).join(",")}`;
 }
 function listingGroupsCatalogQuery(params) {
-  return `/api/products/listing-groups/catalog?ids=${params.productIds.map(encodeURIComponent).join(",")}`;
+  return `${COMMERCE_ENDPOINTS.products.listingGroupsCatalog}?ids=${params.productIds.map(encodeURIComponent).join(",")}`;
 }
 function appendListingGroupsQuerySearchParams(search, options) {
   if (options?.page != null) search.set("page", String(options.page));
   if (options?.limit != null) search.set("limit", String(options.limit));
   if (options?.sort != null) {
     const sort = options.sort;
-    search.set(
-      "sort",
-      Array.isArray(sort) ? sort.join(",") : sort
-    );
+    search.set("sort", Array.isArray(sort) ? sort.join(",") : sort);
   }
   if (options?.where != null) {
     search.set("whereJson", JSON.stringify(options.where));
@@ -718,16 +773,16 @@ function listingGroupsQueryUrl(options) {
   const search = new URLSearchParams();
   appendListingGroupsQuerySearchParams(search, options);
   const query = search.toString();
-  return `/api/products/listing-groups/query${query ? `?${query}` : ""}`;
+  return `${COMMERCE_ENDPOINTS.products.listingGroupsQuery}${query ? `?${query}` : ""}`;
 }
 function listingGroupsQueryCatalogUrl(options) {
   const search = new URLSearchParams();
   appendListingGroupsQuerySearchParams(search, options);
   const query = search.toString();
-  return `/api/products/listing-groups/query/catalog${query ? `?${query}` : ""}`;
+  return `${COMMERCE_ENDPOINTS.products.listingGroupsQueryCatalog}${query ? `?${query}` : ""}`;
 }
 function stockSnapshotQuery(params) {
-  return `/api/products/stock?variantIds=${params.variantIds.map(encodeURIComponent).join(",")}`;
+  return `${COMMERCE_ENDPOINTS.products.stockSnapshot}?variantIds=${params.variantIds.map(encodeURIComponent).join(",")}`;
 }
 
 // src/core/collection/http-client.ts
@@ -1673,48 +1728,6 @@ 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) {
@@ -2939,7 +2952,10 @@ var ProductApi = class extends BaseApi {
    * to remain available by the time an order is placed.
    */
   stockCheck(params) {
-    return this.request("/api/products/stock-check", params);
+    return this.request(
+      COMMERCE_ENDPOINTS.products.stockCheck,
+      params
+    );
   }
   stockSnapshot(params) {
     return this.request(
@@ -3016,7 +3032,7 @@ var ProductApi = class extends BaseApi {
    */
   upsert(params) {
     return this.request(
-      "/api/products/upsert",
+      COMMERCE_ENDPOINTS.products.upsert,
       normalizeProductUpsertParams(params)
     );
   }
@@ -3413,8 +3429,12 @@ function buildGuestCancelRequestBody(token, params) {
 }
 function buildRangeEndpoint(params) {
   const urlParams = new URLSearchParams();
-  urlParams.set("start", formatDateParam(params.start));
-  urlParams.set("end", formatDateParam(params.end));
+  if (params.start !== void 0) {
+    urlParams.set("start", formatDateParam(params.start));
+  }
+  if (params.end !== void 0) {
+    urlParams.set("end", formatDateParam(params.end));
+  }
   if (params.limit !== void 0) urlParams.set("limit", String(params.limit));
   if (params.page !== void 0) urlParams.set("page", String(params.page));
   appendValues(urlParams, "calendar", params.calendar);
@@ -3459,6 +3479,53 @@ var TenantIntrospectionApi = class extends BaseApi {
   }
 };
 
+// src/core/api/membership-api.ts
+var MembershipApi = class extends BaseApi {
+  constructor(options) {
+    super("MembershipApi", options);
+  }
+  /**
+   * Record a delegated first-charge and activate a membership.
+   * The storefront collected the payment; this endpoint deduplicates by
+   * `subscribeIntentKey` and records the already-paid charge.
+   *
+   * `subscribeIntentKey` is used as the HTTP idempotency key so the call is
+   * safely retryable.
+   */
+  subscribe(params) {
+    const { subscribeIntentKey, ...body } = params;
+    return this.request(
+      MEMBERSHIP_ENDPOINTS.subscribe,
+      body,
+      idempotencyRequestOptions(subscribeIntentKey)
+    );
+  }
+  /**
+   * Cancel a membership by id.
+   * `immediate=false` (default) sets `cancelAtPeriodEnd`; the customer retains
+   * benefits until `currentPeriodEnd`. `immediate=true` cancels now and revokes
+   * membership groups immediately.
+   */
+  cancel(params) {
+    const { id, immediate } = params;
+    return this.request(
+      MEMBERSHIP_ENDPOINTS.cancel(id),
+      immediate !== void 0 ? { immediate } : {}
+    );
+  }
+  /**
+   * Retrieve the authenticated customer's own membership view.
+   * Never returns payment tokens or internal keys.
+   */
+  me() {
+    return this.request(
+      MEMBERSHIP_ENDPOINTS.me,
+      void 0,
+      { method: "GET" }
+    );
+  }
+};
+
 // src/core/client/client.server.ts
 var ServerClient = class {
   constructor(options) {
@@ -3492,6 +3559,12 @@ var ServerClient = class {
       onRequestId
     };
     this.commerce = new ServerCommerceClient(serverOptions);
+    const membershipApi = new MembershipApi(serverOptions);
+    this.memberships = {
+      subscribe: membershipApi.subscribe.bind(membershipApi),
+      cancel: membershipApi.cancel.bind(membershipApi),
+      me: membershipApi.me.bind(membershipApi)
+    };
     const tenantIntrospectionApi = new TenantIntrospectionApi(serverOptions);
     this.tenant = {
       collectionSchema: tenantIntrospectionApi.collectionSchema.bind(