@01.software/sdk 0.42.0 → 0.43.0

package/dist/server.d.cts

@@ -1,11 +1,11 @@
-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 { S as ServerCollectionClient } from './collection-client-U70KizLf.cjs';
+export { C as CollectionClient } from './collection-client-U70KizLf.cjs';
+import { O as BaseApi, Q as ServerApiOptions, T as ServerCommerceClient, V as TenantIntrospectionClient, X as SubscribeMembershipParams, Y as SubscribeMembershipResponse, Z as CancelMembershipParams, _ as CancelMembershipResponse, d as CustomerMembershipView, a as CommunityClient, $ as BanCustomerParams, a0 as CommunityBan, a1 as UnbanCustomerParams, e as ClientState, a2 as ClientServerConfig, E as EventsClient, a3 as RootServerClientWithEvents } from './types-Bpx5sYKo.cjs';
+export { A as AddItemParams, h as ApplyDiscountParams, i as CheckoutParams, j as ClearCartParams, a4 as CollectionFieldSchema, a5 as CollectionSchemaResponse, a6 as EventGuestCancelParams, a7 as EventGuestRegistration, a8 as EventGuestRegistrationResponse, a9 as EventRegistrationAnswerInput, aa as EventRegistrationAttendeeInput, ab as EventRegistrationPublic, ac as EventRegistrationRegisterParams, ad as EventRegistrationRegisterResponse, ae as EventsCalendarItem, af as EventsClientOptions, ag as EventsDateParam, ah as EventsExternalSource, ai as EventsLocation, aj as EventsOccurrenceLocation, ak as EventsRangeEvent, al as EventsRangeOccurrence, am as EventsRangeParams, an as EventsRangeResponse, ao as EventsTaxonomyItem, ap as ModerationApi, p as PublicCart, q as PublicCartItem, r as PublicCartReference, s as PublicMediaAsset, t as PublicMediaSize, u as PublicOrder, v as PublicOrderItem, w as PublicOrderReference, R as RemoveDiscountParams, x as RemoveItemParams, aq as RootServerClient, ar as TenantFeatureProgressEvidenceValue, as as TenantFeatureProgressFeature, at as TenantFeatureProgressGroup, au as TenantFeatureProgressInput, av as TenantFeatureProgressItem, aw as TenantFeatureProgressItemState, ax as TenantFeatureProgressResponse, ay as TenantFeatureProgressSeverity, az as TenantFeatureProgressStatus, aA as TenantIntrospectionApi, aB as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-Bpx5sYKo.cjs';
+import './payload-types-DLxkB7Mv.cjs';
 import './metadata.cjs';
-import './const-BiDujixF.cjs';
-import './types-ChV1t4ei.cjs';
+import './const-BBynifk0.cjs';
+import './types-B1ngKbWI.cjs';
 
 type PreviewDetailParams = {
     collection: string;
@@ -31,6 +31,11 @@ declare class ServerPreviewClient extends BaseApi {
 declare class ServerClient {
     commerce: ServerCommerceClient;
     tenant: TenantIntrospectionClient;
+    memberships: {
+        subscribe: (params: SubscribeMembershipParams) => Promise<SubscribeMembershipResponse>;
+        cancel: (params: CancelMembershipParams) => Promise<CancelMembershipResponse>;
+        me: () => Promise<CustomerMembershipView | null>;
+    };
     private _events?;
     community: CommunityClient & {
         moderation: {

package/dist/server.d.ts

@@ -1,11 +1,11 @@
-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 { S as ServerCollectionClient } from './collection-client-gWsA7BVP.js';
+export { C as CollectionClient } from './collection-client-gWsA7BVP.js';
+import { O as BaseApi, Q as ServerApiOptions, T as ServerCommerceClient, V as TenantIntrospectionClient, X as SubscribeMembershipParams, Y as SubscribeMembershipResponse, Z as CancelMembershipParams, _ as CancelMembershipResponse, d as CustomerMembershipView, a as CommunityClient, $ as BanCustomerParams, a0 as CommunityBan, a1 as UnbanCustomerParams, e as ClientState, a2 as ClientServerConfig, E as EventsClient, a3 as RootServerClientWithEvents } from './types-B9lGhZlB.js';
+export { A as AddItemParams, h as ApplyDiscountParams, i as CheckoutParams, j as ClearCartParams, a4 as CollectionFieldSchema, a5 as CollectionSchemaResponse, a6 as EventGuestCancelParams, a7 as EventGuestRegistration, a8 as EventGuestRegistrationResponse, a9 as EventRegistrationAnswerInput, aa as EventRegistrationAttendeeInput, ab as EventRegistrationPublic, ac as EventRegistrationRegisterParams, ad as EventRegistrationRegisterResponse, ae as EventsCalendarItem, af as EventsClientOptions, ag as EventsDateParam, ah as EventsExternalSource, ai as EventsLocation, aj as EventsOccurrenceLocation, ak as EventsRangeEvent, al as EventsRangeOccurrence, am as EventsRangeParams, an as EventsRangeResponse, ao as EventsTaxonomyItem, ap as ModerationApi, p as PublicCart, q as PublicCartItem, r as PublicCartReference, s as PublicMediaAsset, t as PublicMediaSize, u as PublicOrder, v as PublicOrderItem, w as PublicOrderReference, R as RemoveDiscountParams, x as RemoveItemParams, aq as RootServerClient, ar as TenantFeatureProgressEvidenceValue, as as TenantFeatureProgressFeature, at as TenantFeatureProgressGroup, au as TenantFeatureProgressInput, av as TenantFeatureProgressItem, aw as TenantFeatureProgressItemState, ax as TenantFeatureProgressResponse, ay as TenantFeatureProgressSeverity, az as TenantFeatureProgressStatus, aA as TenantIntrospectionApi, aB as TenantIntrospectionApiOptions, U as UpdateItemParams } from './types-B9lGhZlB.js';
+import './payload-types-DLxkB7Mv.js';
 import './metadata.js';
-import './const-pmHlwm3E.js';
-import './types-Bf2iCjy8.js';
+import './const-_WWHU-gX.js';
+import './types-BiKNBwRA.js';
 
 type PreviewDetailParams = {
     collection: string;
@@ -31,6 +31,11 @@ declare class ServerPreviewClient extends BaseApi {
 declare class ServerClient {
     commerce: ServerCommerceClient;
     tenant: TenantIntrospectionClient;
+    memberships: {
+        subscribe: (params: SubscribeMembershipParams) => Promise<SubscribeMembershipResponse>;
+        cancel: (params: CancelMembershipParams) => Promise<CancelMembershipResponse>;
+        me: () => Promise<CustomerMembershipView | null>;
+    };
     private _events?;
     community: CommunityClient & {
         moderation: {

package/dist/server.js

@@ -640,6 +640,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();
@@ -648,7 +706,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();
@@ -657,23 +715,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));
@@ -683,16 +738,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
@@ -1638,48 +1693,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) {
@@ -2904,7 +2917,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(
@@ -2981,7 +2997,7 @@ var ProductApi = class extends BaseApi {
    */
   upsert(params) {
     return this.request(
-      "/api/products/upsert",
+      COMMERCE_ENDPOINTS.products.upsert,
       normalizeProductUpsertParams(params)
     );
   }
@@ -3378,8 +3394,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);
@@ -3424,6 +3444,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) {
@@ -3457,6 +3524,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(