@01.software/sdk 0.35.0 → 0.37.0

package/dist/realtime.d.cts

@@ -1,7 +1,7 @@
 import { R as RealtimeEvent } from './realtime-D7HtUpqt.cjs';
 export { a as RealtimeConnection, b as RealtimeListener } from './realtime-D7HtUpqt.cjs';
-import { P as PublicCollection } from './const-BTvdrXtY.cjs';
-import './payload-types-C7tb7Xbs.cjs';
+import { P as PublicCollection } from './const-CK_FPaIn.cjs';
+import './payload-types-CREOjFNT.cjs';
 
 interface UseRealtimeQueryOptions {
     /** Filter events to specific collections. Empty/undefined = all collections. */

package/dist/realtime.d.ts

@@ -1,7 +1,7 @@
 import { R as RealtimeEvent } from './realtime-D7HtUpqt.js';
 export { a as RealtimeConnection, b as RealtimeListener } from './realtime-D7HtUpqt.js';
-import { P as PublicCollection } from './const-CdqCauHQ.js';
-import './payload-types-C7tb7Xbs.js';
+import { P as PublicCollection } from './const-Dqz05oaG.js';
+import './payload-types-CREOjFNT.js';
 
 interface UseRealtimeQueryOptions {
     /** Filter events to specific collections. Empty/undefined = all collections. */

package/dist/server.cjs

@@ -780,13 +780,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 ?? {};
@@ -830,7 +832,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;
@@ -1188,13 +1190,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
     );
@@ -1204,6 +1209,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)]);
@@ -1244,27 +1287,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
@@ -1321,7 +1351,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.
@@ -1359,7 +1389,7 @@ var CommunityClient = class {
   }
   updateComment(params) {
     const { commentId, body } = params;
-    return this.execute(
+    return this.executeDoc(
       `/api/comments/${commentId}`,
       "PATCH",
       { body }
@@ -1390,7 +1420,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       post: postId,
       type: reactionType
     });
@@ -1412,7 +1442,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       comment: commentId,
       type: reactionType
     });
@@ -1444,7 +1474,7 @@ var CommunityClient = class {
   }
   // Bookmarks
   addBookmark(params) {
-    return this.execute("/api/bookmarks", "POST", {
+    return this.executeDoc("/api/bookmarks", "POST", {
       post: params.postId
     });
   }
@@ -1539,43 +1569,12 @@ var ModerationApi = class extends BaseApi {
 };
 
 // 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");
@@ -1775,15 +1774,24 @@ function splitIdempotencyKey(params) {
   const { idempotencyKey, ...body } = params;
   return { body, idempotencyKey };
 }
+function normalizeCreateOrderBody(params) {
+  if (params.items !== void 0) {
+    const { idempotencyKey: _idempotencyKey2, items, ...rest } = params;
+    return { ...rest, orderItems: items };
+  }
+  const { idempotencyKey: _idempotencyKey, ...body } = params;
+  return body;
+}
 var OrderApi = class extends BaseApi {
   constructor(options) {
     super("OrderApi", options);
   }
   createOrder(params) {
-    const { body, idempotencyKey } = splitIdempotencyKey(params);
+    const { idempotencyKey } = params;
+    const normalizedBody = normalizeCreateOrderBody(params);
     return this.request(
       "/api/orders/create",
-      body,
+      normalizedBody,
       idempotencyRequestOptions(idempotencyKey)
     );
   }
@@ -1815,6 +1823,20 @@ var OrderApi = class extends BaseApi {
       idempotencyKey ? { headers: { "X-Idempotency-Key": idempotencyKey } } : void 0
     );
   }
+  resolveCancelRefund(params) {
+    return this.request(
+      "/api/orders/resolve-cancel-refund",
+      {
+        orderNumber: params.orderNumber,
+        idempotencyKey: params.idempotencyKey,
+        outcome: params.outcome,
+        refundedAmount: params.refundedAmount,
+        pgProvider: params.pgProvider,
+        ...params.pgRefundId ? { pgRefundId: params.pgRefundId } : {}
+      },
+      idempotencyRequestOptions(params.idempotencyKey)
+    );
+  }
   checkout(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
@@ -1831,6 +1853,12 @@ var OrderApi = class extends BaseApi {
       idempotencyRequestOptions(idempotencyKey)
     );
   }
+  prepareFulfillmentOrder(params) {
+    return this.request(
+      "/api/fulfillment-orders/prepare-fulfillment-order",
+      params
+    );
+  }
   updateFulfillment(params) {
     return this.request("/api/orders/update-fulfillment", params);
   }
@@ -1957,7 +1985,9 @@ var ServerCommerceClient = class {
       updateTransaction: orderApi.updateTransaction.bind(orderApi),
       confirmPayment: orderApi.confirmPayment.bind(orderApi),
       cancelOrder: orderApi.cancelOrder.bind(orderApi),
+      resolveCancelRefund: orderApi.resolveCancelRefund.bind(orderApi),
       createFulfillment: orderApi.createFulfillment.bind(orderApi),
+      prepareFulfillmentOrder: orderApi.prepareFulfillmentOrder.bind(orderApi),
       updateFulfillment: orderApi.updateFulfillment.bind(orderApi),
       bulkImportFulfillments: orderApi.bulkImportFulfillments.bind(orderApi),
       createReturn: orderApi.createReturn.bind(orderApi),