@riverbankcms/sdk 0.7.4 → 0.8.0

package/dist/client/client.mjs

@@ -16668,6 +16668,15 @@ var ENDPOINT_DEFINITIONS = {
     auth: "user",
     responseKind: "json"
   },
+  // Public routable content for SDK SSG
+  getPublicRoutableContent: {
+    path: "/public/sites/{siteId}/routable-content",
+    method: "GET",
+    revalidate: 60,
+    tags: ["site-{siteId}", "routable-content-{siteId}"],
+    auth: "public",
+    responseKind: "json"
+  },
   // Generic public content preview (preferred)
   getPublishedEntryPreview: {
     path: "/public/content/{siteId}/{type}/{slug}/preview",
@@ -17728,13 +17737,16 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.7.4";
+var SDK_VERSION = "0.8.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
   constructor(apiError) {
     super(apiError.message);
     this.name = "RiverbankApiError";
+    if ("cause" in apiError && apiError.cause) {
+      this.cause = apiError.cause;
+    }
     this.code = apiError.code;
     this.requestId = apiError.requestId;
     this.status = apiError.status;
@@ -17821,6 +17833,54 @@ var RiverbankApiError = class _RiverbankApiError extends Error {
   isServerError() {
     return this.code.startsWith("server:");
   }
+  /**
+   * Returns a human-readable string representation of the error.
+   * Includes all key details for debugging.
+   *
+   * @example
+   * "RiverbankApiError: Content keys cannot access preview content | Code: auth:forbidden | Status: 401 | RequestId: req-abc123"
+   */
+  toString() {
+    const parts = [`RiverbankApiError: ${this.message}`];
+    if (this.code) parts.push(`Code: ${this.code}`);
+    if (this.status) parts.push(`Status: ${this.status}`);
+    if (this.requestId) parts.push(`RequestId: ${this.requestId}`);
+    return parts.join(" | ");
+  }
+  /**
+   * Custom Node.js inspect output for better console.log display.
+   * This ensures that console.log(error) shows all relevant details
+   * instead of just "[Object]" for nested properties.
+   */
+  [Symbol.for("nodejs.util.inspect.custom")]() {
+    return this.toDetailedString();
+  }
+  /**
+   * Returns a detailed multi-line string for debugging.
+   * Used by the Node.js inspect symbol for console output.
+   */
+  toDetailedString() {
+    const lines = [
+      `RiverbankApiError: ${this.message}`,
+      `  Code: ${this.code}`,
+      `  Status: ${this.status}`,
+      `  RequestId: ${this.requestId}`,
+      `  Timestamp: ${this.timestamp}`
+    ];
+    if (this.isRetryable) {
+      lines.push(`  Retryable: true`);
+      if (this.retryAfterMs) {
+        lines.push(`  RetryAfter: ${this.retryAfterMs}ms`);
+      }
+    }
+    if (this.fieldErrors && this.fieldErrors.length > 0) {
+      lines.push("  FieldErrors:");
+      this.fieldErrors.forEach((fe) => {
+        lines.push(`    - ${fe.field}: ${fe.message}`);
+      });
+    }
+    return lines.join("\n");
+  }
 };
 
 // src/client/resilience.ts
@@ -17835,13 +17895,75 @@ var DEFAULT_CIRCUIT_BREAKER_CONFIG = {
   resetTimeoutMs: 3e4,
   halfOpenMaxRequests: 2
 };
+var PERMANENT_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNREFUSED",
+  // Server is not running / port not listening
+  "ENOTFOUND",
+  // DNS lookup failed - hostname doesn't exist
+  "EAI_AGAIN"
+  // DNS lookup timeout (usually permanent for invalid hosts)
+]);
+var TRANSIENT_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNRESET",
+  // Connection was reset mid-request (server dropped it)
+  "EPIPE",
+  // Broken pipe (connection closed while writing)
+  "ETIMEDOUT",
+  // Connection timed out (could be temporary congestion)
+  "ESOCKETTIMEDOUT"
+  // Socket timeout
+]);
+var NODE_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  // Permanent
+  "ECONNREFUSED",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  // Transient
+  "ECONNRESET",
+  "EPIPE",
+  "ETIMEDOUT",
+  "ESOCKETTIMEDOUT"
+]);
+function isNodeNetworkErrorCode(code) {
+  return !code.includes(":") && NODE_NETWORK_ERROR_CODES.has(code);
+}
+function getErrorCodeFromCause(error) {
+  let current = error;
+  while (current) {
+    const nodeError = current;
+    if (nodeError.code && typeof nodeError.code === "string") {
+      if (isNodeNetworkErrorCode(nodeError.code)) {
+        return nodeError.code;
+      }
+    }
+    const errorWithCause = current;
+    current = errorWithCause.cause;
+  }
+  return void 0;
+}
 function isTransientError(error) {
   if (error instanceof RiverbankApiError) {
+    const errorCode = getErrorCodeFromCause(error);
+    if (errorCode && PERMANENT_NETWORK_ERROR_CODES.has(errorCode)) {
+      return false;
+    }
     if (error.status === 0) return true;
     if (error.status === 429) return true;
     if (error.status >= 500) return true;
     return false;
   }
+  if (error instanceof TypeError) {
+    const errorCode = getErrorCodeFromCause(error);
+    if (errorCode) {
+      if (PERMANENT_NETWORK_ERROR_CODES.has(errorCode)) {
+        return false;
+      }
+      if (TRANSIENT_NETWORK_ERROR_CODES.has(errorCode)) {
+        return true;
+      }
+    }
+    return true;
+  }
   return true;
 }
 function calculateBackoff(attempt, config) {
@@ -17978,7 +18100,19 @@ async function fetchWithTimeoutAndRetry(fetcher, config) {
   }
   throw lastError;
 }
+function isAbortError(error) {
+  if (typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    return true;
+  }
+  return false;
+}
 function shouldRetryError(error, customRetryOn) {
+  if (isAbortError(error)) {
+    return false;
+  }
   if (customRetryOn) {
     const statusCode = error instanceof RiverbankApiError ? error.status : void 0;
     return customRetryOn(error, statusCode);
@@ -18022,7 +18156,7 @@ var DEFAULT_SERVER_TIMEOUT_MS = 8e3;
 function generateRequestId2() {
   return `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 }
-function isAbortError(error) {
+function isAbortError2(error) {
   if (error instanceof DOMException && error.name === "AbortError") {
     return true;
   }
@@ -18060,7 +18194,7 @@ function getNetworkErrorCode(error) {
   return "network:connection_error";
 }
 function convertToTypedError(error) {
-  if (isAbortError(error)) {
+  if (isAbortError2(error)) {
     throw error;
   }
   if (error instanceof ApiEnvelopeError) {
@@ -18090,12 +18224,23 @@ function convertToTypedError(error) {
       message: networkError.message || "Network request failed",
       requestId: `local-${Date.now()}`,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      status: 0
+      status: 0,
       // No HTTP response received
+      cause: networkError
+      // Preserve original error for retry/circuit breaker classification
     });
   }
   throw error;
 }
+function detectKeyType(apiKey) {
+  if (apiKey.startsWith("bld_live_sk_") || apiKey.startsWith("bld_test_sk_")) {
+    return "content";
+  }
+  if (apiKey.startsWith("bld_preview_sk_")) {
+    return "preview";
+  }
+  return "unknown";
+}
 function createRiverbankClient(config) {
   if (!config.baseUrl) {
     throw new Error(
@@ -18126,6 +18271,7 @@ function createRiverbankClient(config) {
     resetTimeoutMs: config.resilience?.circuitBreaker?.resetTimeoutMs ?? DEFAULT_CIRCUIT_BREAKER_CONFIG.resetTimeoutMs,
     halfOpenMaxRequests: config.resilience?.circuitBreaker?.halfOpenMaxRequests ?? DEFAULT_CIRCUIT_BREAKER_CONFIG.halfOpenMaxRequests
   };
+  const keyType = detectKeyType(config.apiKey);
   const apiClient = createBearerAPIClient(config.apiKey, config.baseUrl);
   const cache = new SimpleCache({
     maxSize: cacheMaxSize,
@@ -18421,9 +18567,26 @@ function createRiverbankClient(config) {
         });
       }, { signal });
     },
+    async getAllPublishedRoutes(params) {
+      const { siteId, signal } = params;
+      if (!siteId) {
+        throw new Error("getAllPublishedRoutes() requires siteId");
+      }
+      const cacheKey = `routable-content:${siteId}:published`;
+      return resilientFetch(cacheKey, async (sig) => {
+        return await apiClient({
+          endpoint: "getPublicRoutableContent",
+          params: { siteId, publishedOnly: "true" },
+          options: { signal: sig }
+        });
+      }, { signal });
+    },
     clearCache() {
       cache.clear();
     },
+    getKeyType() {
+      return keyType;
+    },
     getLastEmittedStatus() {
       return lastStatus;
     },