@01.software/sdk 0.30.1 → 0.31.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-VZuk2tWc.cjs';
-import './payload-types-DPjO_IbQ.cjs';
+import { P as PublicCollection } from './const-AytzliEu.cjs';
+import './payload-types-Wa4-eC6x.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-B75IFDRi.js';
-import './payload-types-DPjO_IbQ.js';
+import { P as PublicCollection } from './const-BGCP-OJL.js';
+import './payload-types-Wa4-eC6x.js';
 
 interface UseRealtimeQueryOptions {
     /** Filter events to specific collections. Empty/undefined = all collections. */

package/dist/server.cjs

@@ -26,6 +26,7 @@ __export(server_exports, {
   ServerClient: () => ServerClient,
   ServerCollectionClient: () => ServerCollectionClient,
   ServerCommerceClient: () => ServerCommerceClient,
+  ServerPreviewClient: () => ServerPreviewClient,
   createServerClient: () => createServerClient
 });
 module.exports = __toCommonJS(server_exports);
@@ -77,8 +78,16 @@ var ValidationError = class extends SDKError {
   }
 };
 var ApiError = class extends SDKError {
-  constructor(message, status, details, userMessage, suggestion) {
-    super("API_ERROR", message, status, details, userMessage, suggestion);
+  constructor(message, status, details, userMessage, suggestion, requestId) {
+    super(
+      "API_ERROR",
+      message,
+      status,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
     this.name = "ApiError";
   }
 };
@@ -109,19 +118,43 @@ var UsageLimitError = class extends SDKError {
 };
 var AuthError = class extends SDKError {
   constructor(message, details, userMessage, suggestion, requestId) {
-    super("auth_error", message, 401, details, userMessage, suggestion, requestId);
+    super(
+      "auth_error",
+      message,
+      401,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
     this.name = "AuthError";
   }
 };
 var PermissionError = class extends SDKError {
   constructor(message, details, userMessage, suggestion, requestId) {
-    super("permission_error", message, 403, details, userMessage, suggestion, requestId);
+    super(
+      "permission_error",
+      message,
+      403,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
     this.name = "PermissionError";
   }
 };
 var NotFoundError = class extends SDKError {
   constructor(message, details, userMessage, suggestion, requestId) {
-    super("not_found", message, 404, details, userMessage, suggestion, requestId);
+    super(
+      "not_found",
+      message,
+      404,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
     this.name = "NotFoundError";
   }
 };
@@ -133,14 +166,22 @@ var ConflictError = class extends SDKError {
 };
 var RateLimitError = class extends SDKError {
   constructor(message, retryAfter, details, userMessage, suggestion, requestId) {
-    super("rate_limit_exceeded", message, 429, details, userMessage, suggestion, requestId);
+    super(
+      "rate_limit_exceeded",
+      message,
+      429,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
   }
 };
 var createNetworkError = (message, status, details, userMessage, suggestion) => new NetworkError(message, status, details, userMessage, suggestion);
 var createValidationError = (message, details, userMessage, suggestion, status) => new ValidationError(message, details, userMessage, suggestion, status);
-var createApiError = (message, status, details, userMessage, suggestion) => new ApiError(message, status, details, userMessage, suggestion);
+var createApiError = (message, status, details, userMessage, suggestion, requestId) => new ApiError(message, status, details, userMessage, suggestion, requestId);
 var createConfigError = (message, details, userMessage, suggestion) => new ConfigError(message, details, userMessage, suggestion);
 var createTimeoutError = (message, details, userMessage, suggestion) => new TimeoutError(message, details, userMessage, suggestion);
 var createUsageLimitError = (message, usage, details, userMessage, suggestion) => new UsageLimitError(message, usage, details, userMessage, suggestion);
@@ -148,7 +189,14 @@ var createAuthError = (message, details, userMessage, suggestion, requestId) =>
 var createPermissionError = (message, details, userMessage, suggestion, requestId) => new PermissionError(message, details, userMessage, suggestion, requestId);
 var createNotFoundError = (message, details, userMessage, suggestion, requestId) => new NotFoundError(message, details, userMessage, suggestion, requestId);
 var createConflictError = (message, details, userMessage, suggestion, requestId) => new ConflictError(message, details, userMessage, suggestion, requestId);
-var createRateLimitError = (message, retryAfter, details, userMessage, suggestion, requestId) => new RateLimitError(message, retryAfter, details, userMessage, suggestion, requestId);
+var createRateLimitError = (message, retryAfter, details, userMessage, suggestion, requestId) => new RateLimitError(
+  message,
+  retryAfter,
+  details,
+  userMessage,
+  suggestion,
+  requestId
+);
 
 // src/core/internal/utils/credentials.ts
 function requirePublishableKeyForSecret(apiName, publishableKey, secretKey) {
@@ -188,6 +236,22 @@ function debugLog(debug, type, message, data) {
     console.groupEnd();
   }
 }
+function redactSensitiveHeader(value) {
+  const prefix = value.toLowerCase().startsWith("bearer ") ? "Bearer " : "";
+  return value.length > 20 ? `${prefix}...****${value.slice(-8)}` : "****";
+}
+function redactSensitiveHeaders(headers) {
+  const redacted = Object.fromEntries(headers.entries());
+  if (redacted.authorization) {
+    redacted.authorization = redactSensitiveHeader(redacted.authorization);
+  }
+  if (redacted["x-preview-token"]) {
+    redacted["x-preview-token"] = redactSensitiveHeader(
+      redacted["x-preview-token"]
+    );
+  }
+  return redacted;
+}
 function getErrorSuggestion(status) {
   if (status === 400)
     return "The request data failed validation. Check field values and types.";
@@ -262,6 +326,12 @@ async function parseErrorBody(response) {
     return fallback;
   }
 }
+function getParsedErrorSuggestion(status, parsed) {
+  if (status === 403 && parsed.reason === "origin_not_allowed") {
+    return "Add the request origin to the tenant Browser API origins, then retry the browser request.";
+  }
+  return getErrorSuggestion(status);
+}
 async function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -275,7 +345,7 @@ function createHttpStatusError(status, parsed, details, requestId) {
     ...parsed.errors && { errors: parsed.errors },
     ...parsed.body && { body: parsed.body }
   };
-  const suggestion = getErrorSuggestion(status);
+  const suggestion = getParsedErrorSuggestion(status, parsed);
   if (status === 400 || status === 422) {
     return attachRequestId(
       createValidationError(
@@ -381,11 +451,7 @@ async function httpFetch(url, options) {
       if (!headers.has("Content-Type") && requestInit.body && !(requestInit.body instanceof FormData)) {
         headers.set("Content-Type", "application/json");
       }
-      const redactedHeaders = Object.fromEntries(headers.entries());
-      if (redactedHeaders["authorization"]) {
-        const token = redactedHeaders["authorization"];
-        redactedHeaders["authorization"] = token.length > 20 ? `Bearer ...****${token.slice(-8)}` : "****";
-      }
+      const redactedHeaders = redactSensitiveHeaders(headers);
       debugLog(debug, "request", url, {
         method: requestInit.method || "GET",
         headers: redactedHeaders,
@@ -403,7 +469,7 @@ async function httpFetch(url, options) {
       debugLog(debug, "response", url, {
         status: response.status,
         statusText: response.statusText,
-        headers: Object.fromEntries(response.headers.entries())
+        headers: redactSensitiveHeaders(response.headers)
       });
       if (!response.ok) {
         if (isUsageLimitExceededResponse(response)) {
@@ -1052,7 +1118,7 @@ async function parseApiResponse(response, endpoint) {
     if (reason === "validation_failed") {
       throw attachRequestId(createValidationError(errorMessage, data, errorMessage), requestId);
     }
-    if (reason === "token_expired" || reason === "token_invalid" || reason === "key_invalid" || reason === "key_revoked") {
+    if (reason === "token_expired" || reason === "token_invalid" || reason === "preview_token_invalid" || reason === "preview_token_required" || reason === "key_invalid" || reason === "key_revoked") {
       throw attachRequestId(createAuthError(errorMessage, data, errorMessage), requestId);
     }
     if (reason === "forbidden") {
@@ -1481,7 +1547,61 @@ var OrderApi = class extends BaseApi {
   }
 };
 
+// src/core/preview/server-preview-client.ts
+var ServerPreviewClient = class extends BaseApi {
+  constructor(options) {
+    super("ServerPreviewClient", options);
+  }
+  async detail(params, options) {
+    let response;
+    try {
+      response = await httpFetch("/api/preview/detail", {
+        method: "POST",
+        apiUrl: this.apiUrl,
+        publishableKey: this.publishableKey,
+        secretKey: this.secretKey,
+        body: JSON.stringify(params),
+        headers: { "X-Preview-Token": options.previewToken }
+      });
+    } catch (err) {
+      const id = err instanceof SDKError ? err.requestId ?? null : null;
+      this.onRequestId?.(id);
+      if (err instanceof NotFoundError) return null;
+      throw err;
+    }
+    const requestId = response.headers.get("x-request-id") ?? null;
+    this.onRequestId?.(requestId);
+    try {
+      return await response.json();
+    } catch (err) {
+      if (err instanceof SyntaxError) {
+        throw createApiError(
+          "Invalid JSON response from /api/preview/detail",
+          200,
+          void 0,
+          "Server returned an invalid response.",
+          "Check if the API endpoint is available.",
+          requestId ?? void 0
+        );
+      }
+      throw err;
+    }
+  }
+};
+
 // src/core/commerce/server-commerce-client.ts
+var PreviewProductApi = class extends ProductApi {
+  constructor(options) {
+    super(options);
+    this.previewApi = new ServerPreviewClient(options);
+  }
+  async previewDetail(params, options) {
+    return this.previewApi.detail(
+      { collection: "products", id: params.id },
+      options
+    );
+  }
+};
 var ServerCommerceClient = class {
   constructor(options) {
     const publishableKey = requirePublishableKeyForSecret(
@@ -1495,7 +1615,7 @@ var ServerCommerceClient = class {
       apiUrl: options.apiUrl,
       onRequestId: options.onRequestId
     };
-    const productApi = new ProductApi(serverOptions);
+    const productApi = new PreviewProductApi(serverOptions);
     const cartApi = new CartApi(serverOptions);
     const discountApi = new DiscountApi(serverOptions);
     const shippingApi = new ShippingApi(serverOptions);
@@ -1504,6 +1624,7 @@ var ServerCommerceClient = class {
       stockCheck: productApi.stockCheck.bind(productApi),
       listingGroups: productApi.listingGroups.bind(productApi),
       detail: productApi.detail.bind(productApi),
+      previewDetail: productApi.previewDetail.bind(productApi),
       upsert: productApi.upsert.bind(productApi)
     };
     this.cart = {
@@ -1570,6 +1691,10 @@ var ServerClient = class {
       onRequestId
     };
     this.commerce = new ServerCommerceClient(serverOptions);
+    const previewApi = new ServerPreviewClient(serverOptions);
+    this.preview = {
+      detail: previewApi.detail.bind(previewApi)
+    };
     const communityClient = new CommunityClient(serverOptions);
     const moderationApi = new ModerationApi(serverOptions);
     this.community = Object.assign(communityClient, {