@cms-lab/strapi 1.0.9 → 1.1.0

package/README.md

@@ -15,14 +15,24 @@ cms: {
       urlField: "routing.url",
     },
   ],
+  singleTypes: [
+    {
+      type: "navbar",
+      endpoint: "navbar",
+    },
+  ],
 }
 ```
 
-The adapter reads Strapi REST collection responses and normalizes them into
-cms-lab `CMSDocument` objects. It supports Strapi v4 `attributes` payloads and
-newer flat REST payloads, keeps native SEO/media fields in `document.data`, uses
-`documentId`, `slug`, or numeric `id` as stable identity values, and treats
-non-published statuses as `draft`.
+The adapter reads Strapi REST collection and single-type responses and
+normalizes them into cms-lab `CMSDocument` objects. It supports Strapi v4
+`attributes` payloads and newer flat REST payloads, keeps native SEO/media
+fields in `document.data`, uses `documentId`, `slug`, or numeric `id` as stable
+identity values, and treats non-published statuses as `draft`.
+
+Single types are marked as non-routable by default. cms-lab still runs field,
+SEO, and image-alt checks on them, but it does not report missing route mappings
+for layout or site-wide content such as navbars, footers, and homepage sections.
 
 Use `uidField` or `urlField` when your project stores route values in custom
 fields. Both options read dotted paths from `document.data`.

package/dist/index.d.ts

@@ -1,9 +1,12 @@
-import { FetchLike, StrapiCmsProviderConfig, CMSDocument, StrapiCollectionConfig } from '@cms-lab/core';
+import { FetchLike, StrapiCmsProviderConfig, CMSDocument, StrapiCollectionConfig, StrapiSingleTypeConfig } from '@cms-lab/core';
 
 type FetchStrapiDocumentsOptions = {
     fetch?: FetchLike;
 };
 declare function fetchStrapiDocuments(config: StrapiCmsProviderConfig, options?: FetchStrapiDocumentsOptions): Promise<CMSDocument[]>;
-declare function normalizeStrapiItem(collection: string | StrapiCollectionConfig, item: unknown): CMSDocument;
+declare function normalizeStrapiItem(collection: string | StrapiCollectionConfig | StrapiSingleTypeConfig, item: unknown, options?: {
+    fallbackUid?: boolean;
+    routable?: boolean;
+}): CMSDocument;
 
 export { type FetchStrapiDocumentsOptions, fetchStrapiDocuments, normalizeStrapiItem };

package/dist/index.js

@@ -6,13 +6,10 @@ import {
 async function fetchStrapiDocuments(config, options = {}) {
   const fetchImpl = options.fetch ?? fetch;
   const documents = [];
-  for (const collection of config.collections) {
+  for (const collection of config.collections ?? []) {
     let page = 1;
     while (true) {
-      const url = new URL(
-        `/api/${trimSlashes(collection.endpoint)}`,
-        config.url
-      );
+      const url = strapiEndpointUrl(config.url, collection.endpoint);
       url.searchParams.set("pagination[pageSize]", "100");
       url.searchParams.set("pagination[page]", String(page));
       url.searchParams.set("populate", "*");
@@ -33,9 +30,26 @@ async function fetchStrapiDocuments(config, options = {}) {
       page += 1;
     }
   }
+  for (const singleType of config.singleTypes ?? []) {
+    const url = strapiEndpointUrl(config.url, singleType.endpoint);
+    url.searchParams.set("populate", "*");
+    const response = await fetchJson(
+      fetchImpl,
+      url,
+      authHeaders(config.token)
+    );
+    if (response.data != null) {
+      documents.push(
+        normalizeStrapiItem(singleType, response.data, {
+          fallbackUid: false,
+          routable: false
+        })
+      );
+    }
+  }
   return documents;
 }
-function normalizeStrapiItem(collection, item) {
+function normalizeStrapiItem(collection, item, options = {}) {
   const config = collectionConfig(collection);
   const record = asRecord(item);
   const attributes = optionalRecord(record.attributes);
@@ -44,16 +58,26 @@ function normalizeStrapiItem(collection, item) {
     record.documentId ?? record.id ?? data.id,
     "Strapi item is missing id"
   );
-  return {
+  const document = {
     id,
     type: config.type,
-    uid: optionalString(
-      mappedValue(data, config.uidField) ?? data.uid ?? data.slug ?? record.documentId ?? record.id
-    ),
-    url: optionalString(mappedValue(data, config.urlField)),
     status: normalizeStatus(data),
     data
   };
+  const uid = optionalString(
+    mappedValue(data, config.uidField) ?? data.uid ?? data.slug ?? (options.fallbackUid === false ? void 0 : record.documentId) ?? (options.fallbackUid === false ? void 0 : record.id)
+  );
+  const url = optionalString(mappedValue(data, config.urlField));
+  if (uid) {
+    document.uid = uid;
+  }
+  if (url) {
+    document.url = url;
+  }
+  if (options.routable !== void 0) {
+    document.routable = options.routable;
+  }
+  return document;
 }
 async function fetchJson(fetchImpl, url, headers) {
   let response;
@@ -85,6 +109,9 @@ function trimSlashes(value) {
   }
   return value.slice(start, end);
 }
+function strapiEndpointUrl(baseUrl, endpoint) {
+  return new URL(`/api/${trimSlashes(endpoint)}`, baseUrl);
+}
 function asRecord(value) {
   return value && typeof value === "object" ? value : {};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cms-lab/strapi",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "type": "module",
   "description": "Strapi document adapter for cms-lab.",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cms-lab/core": "1.0.9"
+    "@cms-lab/core": "1.1.0"
   },
   "author": "Afaq Rashid",
   "scripts": {