@riverbankcms/sdk 0.81.0 → 0.82.0

package/dist/server/index.mjs

@@ -6489,11 +6489,22 @@ function appendQueryParam(queryParams, key, value) {
         stack.push(...[...item].reverse());
         continue;
       }
-      queryParams.append(key, String(item));
+      const serialized2 = serializeQueryValue(item);
+      if (serialized2 !== null) queryParams.append(key, serialized2);
     }
     return;
   }
-  queryParams.append(key, String(value));
+  const serialized = serializeQueryValue(value);
+  if (serialized !== null) queryParams.append(key, serialized);
+}
+function serializeQueryValue(value) {
+  if (value === void 0 || value === null) return null;
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (typeof value === "symbol") return value.description ? `Symbol(${value.description})` : "Symbol()";
+  if (value instanceof Date) return value.toISOString();
+  return null;
 }
 function serializePathParam(endpoint, key, value) {
   if (typeof value === "string") {
@@ -6915,7 +6926,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.81.0";
+var SDK_VERSION = "0.82.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
@@ -7062,7 +7073,8 @@ var RiverbankApiError = class _RiverbankApiError extends Error {
 };
 var resilienceStatusSymbol = /* @__PURE__ */ Symbol.for("riverbankcms.sdk.resilienceStatus");
 function attachResilienceStatusToError(error, resilienceStatus) {
-  const target = error !== null && (typeof error === "object" || typeof error === "function") ? error : new Error(error === void 0 ? "Unknown error" : String(error));
+  const message = typeof error === "string" || typeof error === "number" || typeof error === "boolean" || typeof error === "bigint" ? String(error) : "Unknown error";
+  const target = error !== null && (typeof error === "object" || typeof error === "function") ? error : new Error(message);
   Object.defineProperty(target, resilienceStatusSymbol, {
     configurable: true,
     enumerable: false,
@@ -7385,12 +7397,32 @@ function withDefaultHeaders(apiClient, defaultHeaders) {
 setSdkVersion(SDK_VERSION);
 var DEFAULT_BROWSER_TIMEOUT_MS = 5e3;
 var DEFAULT_SERVER_TIMEOUT_MS = 8e3;
+var MAX_GET_ENTRIES_BY_IDENTIFIERS_REFS = 50;
 function generateRequestId2() {
   return `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 }
 function toRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
+function normalizeEntryIdentifierRefs(identifiers) {
+  const trimmed = identifiers.map((identifier) => identifier.trim()).filter((identifier) => identifier.length > 0);
+  if (trimmed.length === 0) {
+    return { kind: "empty" };
+  }
+  if (trimmed.length > MAX_GET_ENTRIES_BY_IDENTIFIERS_REFS) {
+    throw new Error(
+      `getEntriesByIdentifiers() accepts at most ${MAX_GET_ENTRIES_BY_IDENTIFIERS_REFS} identifiers`
+    );
+  }
+  const refs = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const ref of trimmed) {
+    if (seen.has(ref)) continue;
+    seen.add(ref);
+    refs.push(ref);
+  }
+  return { kind: "refs", refs };
+}
 function normalizePublicFormResponse(response) {
   const { form } = response;
   return {
@@ -7814,7 +7846,8 @@ function createRiverbankClient(config) {
         `getSite() requires at least one identifier: slug, domain, or id. Received: ${JSON.stringify(params)}`
       );
     }
-    const cacheKey = `site:${slug || domain || id}:${currentPath ?? ""}`;
+    const siteIdentifier = slug || domain || id;
+    const cacheKey = `site:${siteIdentifier ?? "unknown"}:${currentPath ?? ""}`;
     const siteId = id || slug || domain;
     return resilientFetch(
       cacheKey,
@@ -7862,6 +7895,61 @@ function createRiverbankClient(config) {
       }
     );
   }
+  async function getEntriesInternal(params) {
+    const {
+      siteId,
+      contentType,
+      limit,
+      offset,
+      order,
+      preview = false,
+      mode,
+      entryIds,
+      includeMeta,
+      signal
+    } = params;
+    const entryIdsCacheKey = mode === "manual" && entryIds?.length ? entryIds.join(",") : "";
+    const cacheKey = `entries:${siteId}:${contentType}:${limit ?? ""}:${offset ?? ""}:${order ?? ""}:${preview}:${mode ?? ""}:${entryIdsCacheKey}:${includeMeta ?? ""}`;
+    return resilientFetchData(
+      cacheKey,
+      async (sig) => {
+        let orderParam;
+        if (order === "newest") {
+          orderParam = "published_at.desc";
+        } else if (order === "oldest") {
+          orderParam = "published_at.asc";
+        } else if (order === "title") {
+          orderParam = "title.asc";
+        } else if (order === "manual") {
+          orderParam = "manual.asc";
+        }
+        const apiParams = {
+          siteId,
+          type: contentType,
+          ...typeof limit === "number" && { limit: String(limit) },
+          ...typeof offset === "number" && { offset: String(offset) },
+          ...includeMeta && { meta: "true" },
+          ...orderParam && { order: orderParam },
+          ...preview && { stage: "preview" },
+          ...mode === "manual" && entryIds?.length && {
+            mode: "manual",
+            entryIds: JSON.stringify(entryIds)
+          }
+        };
+        return await apiClient({
+          endpoint: "listPublishedEntries",
+          params: apiParams,
+          options: { signal: sig }
+        });
+      },
+      {
+        preview,
+        signal,
+        // The prebuild loader itself declines preview/manual requests it cannot satisfy.
+        prebuildFallback: prebuildLoader && !preview ? () => prebuildLoader.loadEntries(siteId, params) : void 0
+      }
+    );
+  }
   return {
     async getSite(params) {
       return (await getSiteWithResilienceInternal(params)).data;
@@ -7876,59 +7964,22 @@ function createRiverbankClient(config) {
       return getPageWithResilienceInternal(params);
     },
     async getEntries(params) {
-      const {
+      return getEntriesInternal(params);
+    },
+    async getEntriesByIdentifiers(params) {
+      const { siteId, contentType, identifiers, preview, signal } = params;
+      const normalized = normalizeEntryIdentifierRefs(identifiers);
+      if (normalized.kind === "empty") {
+        return { entries: [] };
+      }
+      return getEntriesInternal({
         siteId,
         contentType,
-        limit,
-        offset,
-        order,
-        preview = false,
-        mode,
-        entryIds,
-        includeMeta,
-        signal
-      } = params;
-      const entryIdsCacheKey = mode === "manual" && entryIds?.length ? entryIds.join(",") : "";
-      const cacheKey = `entries:${siteId}:${contentType}:${limit ?? ""}:${offset ?? ""}:${order ?? ""}:${preview}:${mode ?? ""}:${entryIdsCacheKey}:${includeMeta ?? ""}`;
-      return resilientFetchData(
-        cacheKey,
-        async (sig) => {
-          let orderParam;
-          if (order === "newest") {
-            orderParam = "published_at.desc";
-          } else if (order === "oldest") {
-            orderParam = "published_at.asc";
-          } else if (order === "title") {
-            orderParam = "title.asc";
-          } else if (order === "manual") {
-            orderParam = "manual.asc";
-          }
-          const apiParams = {
-            siteId,
-            type: contentType,
-            ...typeof limit === "number" && { limit: String(limit) },
-            ...typeof offset === "number" && { offset: String(offset) },
-            ...includeMeta && { meta: "true" },
-            ...orderParam && { order: orderParam },
-            ...preview && { stage: "preview" },
-            ...mode === "manual" && entryIds?.length && {
-              mode: "manual",
-              entryIds: JSON.stringify(entryIds)
-            }
-          };
-          return await apiClient({
-            endpoint: "listPublishedEntries",
-            params: apiParams,
-            options: { signal: sig }
-          });
-        },
-        {
-          preview,
-          signal,
-          // Prebuild fallback only for published entries (not preview, not manual mode)
-          prebuildFallback: prebuildLoader && !preview ? () => prebuildLoader.loadEntries(siteId, params) : void 0
-        }
-      );
+        preview,
+        signal,
+        mode: "manual",
+        entryIds: normalized.refs
+      });
     },
     async getEntry(params) {
       const { siteId, contentType, slug, signal } = params;
@@ -8668,6 +8719,7 @@ async function prebuildCache(options) {
   }
   for (const file of files.filter((f) => f.startsWith("entries/") && f.endsWith("/all.json"))) {
     const contentType = file.split("/")[1];
+    if (!contentType) continue;
     keyToFile[`entries-all:${siteId}:${contentType}`] = file;
   }
   if (files.includes("forms/forms.json")) {