@01.software/sdk 0.36.0 → 0.38.0

package/dist/client.d.cts

@@ -1,10 +1,10 @@
-import { R as ReadOnlyCollectionClient } from './collection-client-Cv0D2w1Q.cjs';
-import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-Dib-zdK6.cjs';
-export { A as ApiQueryOptions, e as ClientMetadata, D as DebugConfig, f as DeepPartial, g as ExtractArrayType, P as PayloadFindResponse, h as PayloadMutationResponse, R as RetryConfig, i as RootClient, i as RootClientType, j as RootCollectionClient, k as RootReadOnlyQueryBuilder, S as Sort, W as Where } from './types-Dib-zdK6.cjs';
-export { C as Collection, P as PublicCollection } from './const-DVcM7Ac_.cjs';
+import { R as ReadOnlyCollectionClient } from './collection-client-B0J9wMNE.cjs';
+import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-CIGscmus.cjs';
+export { A as AddItemParams, e as ApiQueryOptions, f as ApplyDiscountParams, g as CheckoutParams, h as ClearCartParams, i as ClientMetadata, D as DebugConfig, j as DeepPartial, k as ExtractArrayType, P as PayloadFindResponse, l as PayloadMutationResponse, m as PublicCart, n as PublicCartItem, o as PublicCartReference, p as PublicMediaAsset, q as PublicMediaSize, r as PublicOrder, s as PublicOrderItem, t as PublicOrderReference, R as RemoveDiscountParams, u as RemoveItemParams, v as RetryConfig, w as RootClient, w as RootClientType, x as RootCollectionClient, y as RootReadOnlyQueryBuilder, S as Sort, U as UpdateItemParams, W as Where } from './types-CIGscmus.cjs';
+import './payload-types-m3jjhxk9.cjs';
+export { C as Collection, P as PublicCollection } from './const-B5KT72c7.cjs';
 import './metadata.cjs';
-import './types-CEzLf3PX.cjs';
-import './payload-types-BCui2Oml.cjs';
+import './types-D0ubzQw0.cjs';
 
 declare class Client {
     commerce: CommerceClient;

package/dist/client.d.ts

@@ -1,10 +1,10 @@
-import { R as ReadOnlyCollectionClient } from './collection-client-Bq5Zd7p7.js';
-import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-DK9EnLwJ.js';
-export { A as ApiQueryOptions, e as ClientMetadata, D as DebugConfig, f as DeepPartial, g as ExtractArrayType, P as PayloadFindResponse, h as PayloadMutationResponse, R as RetryConfig, i as RootClient, i as RootClientType, j as RootCollectionClient, k as RootReadOnlyQueryBuilder, S as Sort, W as Where } from './types-DK9EnLwJ.js';
-export { C as Collection, P as PublicCollection } from './const-BDUKFP9w.js';
+import { R as ReadOnlyCollectionClient } from './collection-client-BroIWHY1.js';
+import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-D2xYdz4P.js';
+export { A as AddItemParams, e as ApiQueryOptions, f as ApplyDiscountParams, g as CheckoutParams, h as ClearCartParams, i as ClientMetadata, D as DebugConfig, j as DeepPartial, k as ExtractArrayType, P as PayloadFindResponse, l as PayloadMutationResponse, m as PublicCart, n as PublicCartItem, o as PublicCartReference, p as PublicMediaAsset, q as PublicMediaSize, r as PublicOrder, s as PublicOrderItem, t as PublicOrderReference, R as RemoveDiscountParams, u as RemoveItemParams, v as RetryConfig, w as RootClient, w as RootClientType, x as RootCollectionClient, y as RootReadOnlyQueryBuilder, S as Sort, U as UpdateItemParams, W as Where } from './types-D2xYdz4P.js';
+import './payload-types-m3jjhxk9.js';
+export { C as Collection, P as PublicCollection } from './const-6XHz_jej.js';
 import './metadata.js';
-import './types-3qV6sY7T.js';
-import './payload-types-BCui2Oml.js';
+import './types-Cmrd1ezc.js';
 
 declare class Client {
     commerce: CommerceClient;

package/dist/client.js

@@ -744,71 +744,14 @@ var HttpClient = class {
   }
 };
 
-// src/utils/types.ts
-var resolveRelation = (ref) => {
-  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
-    return null;
-  return ref;
-};
-
-// src/core/metadata/index.ts
-function extractSeo(doc) {
-  const seo = doc.seo ?? {};
-  const og = seo.openGraph ?? {};
-  return {
-    title: seo.title ?? doc.title ?? null,
-    description: seo.description ?? null,
-    noIndex: seo.noIndex ?? null,
-    canonical: seo.canonical ?? null,
-    openGraph: {
-      title: og.title ?? null,
-      description: og.description ?? null,
-      image: og.image ?? null
-    }
-  };
-}
-function generateMetadata(input, options) {
-  const title = input.title ?? void 0;
-  const description = input.description ?? void 0;
-  const ogTitle = input.openGraph?.title ?? title;
-  const ogDescription = input.openGraph?.description ?? description;
-  const image = resolveMetaImage(input.openGraph?.image);
-  return {
-    title,
-    description,
-    ...input.noIndex && { robots: { index: false, follow: false } },
-    ...input.canonical && { alternates: { canonical: input.canonical } },
-    openGraph: {
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...options?.siteName && { siteName: options.siteName },
-      ...image && { images: [image] }
-    },
-    twitter: {
-      card: image ? "summary_large_image" : "summary",
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...image && { images: [image.url] }
-    }
-  };
-}
-function resolveMetaImage(ref) {
-  const image = resolveRelation(ref);
-  if (!image) return null;
-  const sized = image.sizes?.["1536"];
-  const url = sized?.url || image.url;
-  if (!url) return null;
-  const width = sized?.url ? sized.width : image.width;
-  const height = sized?.url ? sized.height : image.height;
+// src/core/collection/query-builder.ts
+function withDefaultPublicReadOptions(options) {
   return {
-    url,
-    ...width && { width },
-    ...height && { height },
-    ...image.alt && { alt: image.alt }
+    ...options,
+    depth: options?.depth ?? 0,
+    joins: options?.joins ?? false
   };
 }
-
-// src/core/collection/query-builder.ts
 var ReadOnlyCollectionQueryBuilder = class {
   constructor(api, collection) {
     this.api = api;
@@ -817,13 +760,13 @@ var ReadOnlyCollectionQueryBuilder = class {
   async find(options) {
     return this.api.requestFind(
       `/api/${String(this.collection)}`,
-      options
+      withDefaultPublicReadOptions(options)
     );
   }
   async findById(id, options) {
     return this.api.requestFindById(
       `/api/${String(this.collection)}/${String(id)}`,
-      options
+      withDefaultPublicReadOptions(options)
     );
   }
   async count(options) {
@@ -832,22 +775,6 @@ var ReadOnlyCollectionQueryBuilder = class {
       options
     );
   }
-  async findMetadata(options, metadataOptions) {
-    const { docs } = await this.find({ ...options, limit: 1, depth: 1 });
-    const doc = docs[0];
-    if (!doc) return null;
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
-  async findMetadataById(id, metadataOptions) {
-    const doc = await this.findById(id, { depth: 1 });
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
 };
 
 // src/core/collection/collection-client.ts
@@ -863,6 +790,21 @@ var ReadOnlyCollectionClient = class extends HttpClient {
     });
     return this.parseFindResponse(response);
   }
+  async requestFindEndpoint(endpoint, data) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "POST",
+      body: data ? JSON.stringify(data) : void 0
+    });
+    return this.parseFindResponse(response);
+  }
+  async requestFindEndpointGet(endpoint) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseFindResponse(response);
+  }
   async requestFindById(endpoint, options) {
     const url = this.buildUrl(endpoint, options);
     const response = await this.fetchWithTracking(url, {
@@ -927,13 +869,16 @@ async function parseApiResponse(response, endpoint) {
   return data;
 }
 
-// src/core/community/community-client.ts
-var DEFAULT_POST_LIST_SORT = "-lastActivityAt";
-var DEFAULT_COMMENT_LIST_SORT = "-createdAt";
-var CommunityClient = class {
-  constructor(options) {
+// src/core/api/customer-scoped-api.ts
+var CustomerScopedApi = class {
+  constructor(apiName, options) {
+    if (options.requiresCredential !== false && !options.secretKey && !options.customerToken) {
+      throw createConfigError(
+        `Either secretKey or customerToken is required for ${apiName}.`
+      );
+    }
     this.publishableKey = requirePublishableKeyForSecret(
-      "CommunityClient",
+      apiName,
       options.publishableKey,
       options.secretKey
     );
@@ -943,6 +888,44 @@ var CommunityClient = class {
     this.onUnauthorized = options.onUnauthorized;
     this.onRequestId = options.onRequestId;
   }
+  async request(endpoint, options) {
+    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
+    try {
+      const response = await httpFetch(endpoint, {
+        method: options.method,
+        apiUrl: this.apiUrl,
+        publishableKey: this.publishableKey,
+        secretKey: this.secretKey,
+        customerToken: token ?? void 0,
+        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
+        ...options.body !== void 0 && {
+          body: JSON.stringify(options.body)
+        },
+        ...options.headers && { headers: options.headers }
+      });
+      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
+      return parseApiResponse(response, endpoint);
+    } catch (err) {
+      const id = err instanceof SDKError ? err.requestId ?? null : null;
+      this.onRequestId?.(id);
+      throw err;
+    }
+  }
+};
+
+// src/core/community/community-client.ts
+var DEFAULT_POST_LIST_SORT = "-lastActivityAt";
+var DEFAULT_COMMENT_LIST_SORT = "-createdAt";
+function unwrapPayloadDoc(value) {
+  if (value && typeof value === "object" && "doc" in value) {
+    return value.doc;
+  }
+  return value;
+}
+var CommunityClient = class extends CustomerScopedApi {
+  constructor(options) {
+    super("CommunityClient", { ...options, requiresCredential: false });
+  }
   buildQuery(params) {
     if (!params) return "";
     const entries = Object.entries(params).filter((e) => e[1] !== void 0).map(([k, v]) => [k, String(v)]);
@@ -952,7 +935,8 @@ var CommunityClient = class {
     const urlParams = new URLSearchParams();
     const sort = params?.sort ?? DEFAULT_POST_LIST_SORT;
     urlParams.set("sort", sort);
-    if (params?.limit !== void 0) urlParams.set("limit", String(params.limit));
+    if (params?.limit !== void 0)
+      urlParams.set("limit", String(params.limit));
     if (params?.page !== void 0) urlParams.set("page", String(params.page));
     if (params?.categoryId !== void 0) {
       urlParams.set("where[categories][in]", params.categoryId);
@@ -960,7 +944,7 @@ var CommunityClient = class {
     if (params?.tagId !== void 0) {
       urlParams.set("where[tags][in]", params.tagId);
     }
-    return `/api/posts?${urlParams.toString()}`;
+    return `/api/posts/public?${urlParams.toString()}`;
   }
   buildCommentsListQuery(params) {
     const urlParams = new URLSearchParams();
@@ -980,30 +964,21 @@ var CommunityClient = class {
     }
     if (params.limit !== void 0) urlParams.set("limit", String(params.limit));
     if (params.page !== void 0) urlParams.set("page", String(params.page));
-    return `/api/comments?${urlParams.toString()}`;
+    return `/api/comments/public?${urlParams.toString()}`;
   }
   async execute(endpoint, method, body) {
-    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
-    try {
-      const response = await httpFetch(endpoint, {
-        method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        customerToken: token ?? void 0,
-        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
-        ...body !== void 0 && { body: JSON.stringify(body) }
-      });
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint);
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
+    return this.request(endpoint, { method, body });
+  }
+  async executeDoc(endpoint, method, body) {
+    const response = await this.execute(endpoint, method, body);
+    return unwrapPayloadDoc(response);
   }
   createPost(params) {
-    return this.execute("/api/posts", "POST", params);
+    return this.executeDoc(
+      "/api/posts",
+      "POST",
+      params
+    );
   }
   /**
    * Public post feed. Server applies the same visibility contract as
@@ -1060,7 +1035,11 @@ var CommunityClient = class {
     if (parentId !== void 0) {
       body.parent = parentId;
     }
-    return this.execute("/api/comments", "POST", body);
+    return this.executeDoc(
+      "/api/comments",
+      "POST",
+      body
+    );
   }
   /**
    * List comments for a post.
@@ -1098,7 +1077,7 @@ var CommunityClient = class {
   }
   updateComment(params) {
     const { commentId, body } = params;
-    return this.execute(
+    return this.executeDoc(
       `/api/comments/${commentId}`,
       "PATCH",
       { body }
@@ -1129,10 +1108,14 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
-      post: postId,
-      type: reactionType
-    });
+    return this.executeDoc(
+      "/api/reactions",
+      "POST",
+      {
+        post: postId,
+        type: reactionType
+      }
+    );
   }
   removeReaction(params) {
     const { postId, type } = params;
@@ -1151,10 +1134,14 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
-      comment: commentId,
-      type: reactionType
-    });
+    return this.executeDoc(
+      "/api/reactions",
+      "POST",
+      {
+        comment: commentId,
+        type: reactionType
+      }
+    );
   }
   removeCommentReaction(params) {
     const { commentId, type } = params;
@@ -1183,9 +1170,13 @@ var CommunityClient = class {
   }
   // Bookmarks
   addBookmark(params) {
-    return this.execute("/api/bookmarks", "POST", {
-      post: params.postId
-    });
+    return this.executeDoc(
+      "/api/bookmarks",
+      "POST",
+      {
+        post: params.postId
+      }
+    );
   }
   removeBookmark(params) {
     return this.execute(
@@ -1201,10 +1192,7 @@ var CommunityClient = class {
   }
   // Profiles
   listProfileLists(params) {
-    return this.execute(
-      `/api/customer-profile-lists${this.buildQuery(params)}`,
-      "GET"
-    );
+    return this.execute(`/api/customer-profile-lists${this.buildQuery(params)}`, "GET");
   }
   async getProfileList(params) {
     const query = "slug" in params ? `?where[slug][equals]=${encodeURIComponent(params.slug)}&limit=1` : `?where[id][equals]=${encodeURIComponent(params.id)}&limit=1`;
@@ -1434,46 +1422,18 @@ var CustomerNamespace = class {
 };
 
 // src/core/api/cart-api.ts
-var CartApi = class {
+var CartApi = class extends CustomerScopedApi {
   constructor(options) {
-    if (!options.secretKey && !options.customerToken) {
-      throw createConfigError(
-        "Either secretKey or customerToken is required for CartApi."
-      );
-    }
-    this.publishableKey = requirePublishableKeyForSecret(
-      "CartApi",
-      options.publishableKey,
-      options.secretKey
-    );
-    this.secretKey = options.secretKey;
-    this.apiUrl = options.apiUrl;
-    this.customerToken = options.customerToken;
-    this.onUnauthorized = options.onUnauthorized;
-    this.onRequestId = options.onRequestId;
+    super("CartApi", options);
   }
   async execute(endpoint, method, body) {
-    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
-    try {
-      const response = await httpFetch(endpoint, {
-        method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        customerToken: token ?? void 0,
-        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
-        ...body !== void 0 && { body: JSON.stringify(body) }
-      });
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint);
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
+    return this.request(endpoint, { method, body });
   }
   getCart(cartId) {
-    return this.execute(`/api/carts/${cartId}`, "GET");
+    return this.execute(
+      `/api/carts/${cartId}?depth=0&joins=false`,
+      "GET"
+    );
   }
   addItem(params) {
     return this.execute("/api/carts/add-item", "POST", params);
@@ -1537,6 +1497,18 @@ function splitIdempotencyKey(params) {
 }
 
 // src/core/commerce/commerce-client.ts
+var BrowserCommerceApi = class extends CustomerScopedApi {
+  post(endpoint, body, requestOptions) {
+    return this.request(endpoint, {
+      method: "POST",
+      body,
+      headers: requestOptions?.headers
+    });
+  }
+  get(endpoint) {
+    return this.request(endpoint, { method: "GET" });
+  }
+};
 var CommerceClient = class {
   constructor(options) {
     const cartApi = new CartApi({
@@ -1546,52 +1518,23 @@ var CommerceClient = class {
       onUnauthorized: options.onUnauthorized,
       onRequestId: options.onRequestId
     });
-    const execute = async (endpoint, body, requestOptions) => {
-      const token = options.customerToken();
-      try {
-        const response = await httpFetch(endpoint, {
-          method: "POST",
-          apiUrl: options.apiUrl,
-          publishableKey: options.publishableKey,
-          customerToken: token ?? void 0,
-          ...token && options.onUnauthorized && { onUnauthorized: options.onUnauthorized },
-          body: JSON.stringify(body),
-          ...requestOptions?.headers && { headers: requestOptions.headers }
-        });
-        options.onRequestId?.(response.headers.get("x-request-id") ?? null);
-        return parseApiResponse(response, endpoint);
-      } catch (err) {
-        const id = err instanceof SDKError ? err.requestId ?? null : null;
-        options.onRequestId?.(id);
-        throw err;
-      }
-    };
-    const executeGet = async (endpoint) => {
-      const token = options.customerToken();
-      try {
-        const response = await httpFetch(endpoint, {
-          method: "GET",
-          apiUrl: options.apiUrl,
-          publishableKey: options.publishableKey,
-          customerToken: token ?? void 0,
-          ...token && options.onUnauthorized && { onUnauthorized: options.onUnauthorized }
-        });
-        options.onRequestId?.(response.headers.get("x-request-id") ?? null);
-        return parseApiResponse(response, endpoint);
-      } catch (err) {
-        const id = err instanceof SDKError ? err.requestId ?? null : null;
-        options.onRequestId?.(id);
-        throw err;
-      }
-    };
+    const api = new BrowserCommerceApi("CommerceClient", {
+      publishableKey: options.publishableKey,
+      apiUrl: options.apiUrl,
+      customerToken: options.customerToken,
+      onUnauthorized: options.onUnauthorized,
+      onRequestId: options.onRequestId
+    });
     this.product = {
-      stockCheck: (params) => execute("/api/products/stock-check", params),
-      stockSnapshot: (params) => executeGet(stockSnapshotQuery(params)),
-      listingGroups: (params) => executeGet(listingGroupsQuery(params)),
-      listingGroupsCatalog: (params) => executeGet(listingGroupsCatalogQuery(params)),
+      stockCheck: (params) => api.post("/api/products/stock-check", params),
+      stockSnapshot: (params) => api.get(stockSnapshotQuery(params)),
+      listingGroups: (params) => api.get(listingGroupsQuery(params)),
+      listingGroupsCatalog: (params) => api.get(
+        listingGroupsCatalogQuery(params)
+      ),
       detail: async (params) => {
         try {
-          const product = await executeGet(productDetailQuery(params));
+          const product = await api.get(productDetailQuery(params));
           return { found: true, product };
         } catch (err) {
           const notFoundResult = productDetailResultFromError(err);
@@ -1601,7 +1544,7 @@ var CommerceClient = class {
       },
       detailCatalog: async (params) => {
         try {
-          const product = await executeGet(
+          const product = await api.get(
             productDetailCatalogQuery(params)
           );
           return { found: true, product };
@@ -1624,7 +1567,7 @@ var CommerceClient = class {
     this.orders = {
       checkout: (params) => {
         const { body, idempotencyKey } = splitIdempotencyKey(params);
-        return execute(
+        return api.post(
           "/api/orders/checkout",
           body,
           idempotencyRequestOptions(idempotencyKey)
@@ -1633,10 +1576,10 @@ var CommerceClient = class {
       listMine: (params) => options.customerAuth.getMyOrders(params)
     };
     this.discounts = {
-      validate: (params) => execute("/api/discounts/validate", params)
+      validate: (params) => api.post("/api/discounts/validate", params)
     };
     this.shipping = {
-      calculate: (params) => execute("/api/shipping-policies/calculate", params)
+      calculate: (params) => api.post("/api/shipping-policies/calculate", params)
     };
   }
 };