@01.software/sdk 0.36.0 → 0.37.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-zOmnxwdA.cjs';
+import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-BWMUr3Zw.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-BWMUr3Zw.cjs';
+export { C as Collection, P as PublicCollection } from './const-CK_FPaIn.cjs';
 import './metadata.cjs';
-import './types-CEzLf3PX.cjs';
-import './payload-types-BCui2Oml.cjs';
+import './types-BkZNhuBh.cjs';
+import './payload-types-CREOjFNT.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-DyELGUcL.js';
+import { C as CommerceClient, a as CommunityClient, E as EventsClient, b as CustomerNamespace, c as ClientState, d as ClientConfig } from './types-DMvVHdb1.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-DMvVHdb1.js';
+export { C as Collection, P as PublicCollection } from './const-Dqz05oaG.js';
 import './metadata.js';
-import './types-3qV6sY7T.js';
-import './payload-types-BCui2Oml.js';
+import './types-CxzWHspI.js';
+import './payload-types-CREOjFNT.js';
 
 declare class Client {
     commerce: CommerceClient;

package/dist/client.js

@@ -745,13 +745,15 @@ var HttpClient = class {
 };
 
 // src/utils/types.ts
-var resolveRelation = (ref) => {
+function resolveRelation(ref) {
   if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
     return null;
   return ref;
-};
+}
 
 // src/core/metadata/index.ts
+var OPEN_GRAPH_IMAGE_SIZE = "1200";
+var LEGACY_OPEN_GRAPH_IMAGE_SIZE = "1536";
 function extractSeo(doc) {
   const seo = doc.seo ?? {};
   const og = seo.openGraph ?? {};
@@ -795,7 +797,7 @@ function generateMetadata(input, options) {
 function resolveMetaImage(ref) {
   const image = resolveRelation(ref);
   if (!image) return null;
-  const sized = image.sizes?.["1536"];
+  const sized = image.sizes?.[OPEN_GRAPH_IMAGE_SIZE] ?? image.sizes?.[LEGACY_OPEN_GRAPH_IMAGE_SIZE];
   const url = sized?.url || image.url;
   if (!url) return null;
   const width = sized?.url ? sized.width : image.width;
@@ -927,13 +929,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 +948,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)]);
@@ -983,27 +1026,14 @@ var CommunityClient = class {
     return `/api/comments?${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 +1090,7 @@ 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 +1128,7 @@ var CommunityClient = class {
   }
   updateComment(params) {
     const { commentId, body } = params;
-    return this.execute(
+    return this.executeDoc(
       `/api/comments/${commentId}`,
       "PATCH",
       { body }
@@ -1129,7 +1159,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       post: postId,
       type: reactionType
     });
@@ -1151,7 +1181,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       comment: commentId,
       type: reactionType
     });
@@ -1183,7 +1213,7 @@ var CommunityClient = class {
   }
   // Bookmarks
   addBookmark(params) {
-    return this.execute("/api/bookmarks", "POST", {
+    return this.executeDoc("/api/bookmarks", "POST", {
       post: params.postId
     });
   }
@@ -1434,43 +1464,12 @@ 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");
@@ -1537,6 +1536,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 +1557,21 @@ 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 +1581,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 +1604,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 +1613,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)
     };
   }
 };