@cms-lab/strapi 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Afaq Rashid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @cms-lab/strapi
+
+Strapi adapter for cms-lab.
+
+```ts
+cms: {
+  provider: "strapi",
+  url: "http://localhost:1337",
+  token: process.env.STRAPI_TOKEN,
+  collections: [{ type: "page", endpoint: "pages" }],
+}
+```
+
+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`.
+
+## Open Source
+
+MIT licensed. See the repository [license](https://github.com/i-afaqrashid/cms-lab/blob/main/LICENSE), [contributing guide](https://github.com/i-afaqrashid/cms-lab/blob/main/CONTRIBUTING.md), and [support guide](https://github.com/i-afaqrashid/cms-lab/blob/main/SUPPORT.md).

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,114 @@
+// src/index.ts
+import {
+  CmsFetchError
+} from "@cms-lab/core";
+async function fetchStrapiDocuments(config, options = {}) {
+  const fetchImpl = options.fetch ?? fetch;
+  const documents = [];
+  for (const collection of config.collections) {
+    let page = 1;
+    while (true) {
+      const url = new URL(
+        `/api/${trimSlashes(collection.endpoint)}`,
+        config.url
+      );
+      url.searchParams.set("pagination[pageSize]", "100");
+      url.searchParams.set("pagination[page]", String(page));
+      url.searchParams.set("populate", "*");
+      const response = await fetchJson(
+        fetchImpl,
+        url,
+        authHeaders(config.token)
+      );
+      documents.push(
+        ...(response.data ?? []).map(
+          (item) => normalizeStrapiItem(collection.type, item)
+        )
+      );
+      const pageCount = response.meta?.pagination?.pageCount ?? page;
+      if (page >= pageCount) {
+        break;
+      }
+      page += 1;
+    }
+  }
+  return documents;
+}
+function normalizeStrapiItem(type, item) {
+  const record = asRecord(item);
+  const attributes = optionalRecord(record.attributes);
+  const data = attributes ? { id: record.id, ...attributes } : record;
+  const id = stringFrom(
+    record.documentId ?? record.id ?? data.id,
+    "Strapi item is missing id"
+  );
+  return {
+    id,
+    type,
+    uid: optionalString(
+      data.uid ?? data.slug ?? record.documentId ?? record.id
+    ),
+    status: normalizeStatus(data),
+    data
+  };
+}
+async function fetchJson(fetchImpl, url, headers) {
+  let response;
+  try {
+    response = await fetchImpl(url, { headers });
+  } catch (error) {
+    throw new CmsFetchError(
+      error instanceof Error ? error.message : `Failed to reach ${url}`
+    );
+  }
+  if (!response.ok) {
+    throw new CmsFetchError(
+      `Strapi request failed with HTTP ${response.status}`
+    );
+  }
+  return await response.json();
+}
+function authHeaders(token) {
+  return token ? { Accept: "application/json", Authorization: `Bearer ${token}` } : { Accept: "application/json" };
+}
+function trimSlashes(value) {
+  return value.replace(/^\/+|\/+$/g, "");
+}
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function optionalRecord(value) {
+  return value && typeof value === "object" ? value : void 0;
+}
+function stringFrom(value, message) {
+  if (typeof value === "string" && value.length > 0) {
+    return value;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  throw new CmsFetchError(message);
+}
+function optionalString(value) {
+  if (typeof value === "string" && value.length > 0) {
+    return value;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  return void 0;
+}
+function normalizeStatus(data) {
+  if ("publishedAt" in data && data.publishedAt === null) {
+    return "draft";
+  }
+  const status = optionalString(data.status)?.toLowerCase();
+  if (status && !["publish", "published", "live"].includes(status)) {
+    return "draft";
+  }
+  return "published";
+}
+export {
+  fetchStrapiDocuments,
+  normalizeStrapiItem
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@cms-lab/strapi",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Strapi document adapter for cms-lab.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/i-afaqrashid/cms-lab.git",
+    "directory": "packages/strapi"
+  },
+  "homepage": "https://cms-lab.dev",
+  "bugs": {
+    "url": "https://github.com/i-afaqrashid/cms-lab/issues"
+  },
+  "keywords": [
+    "cms",
+    "strapi",
+    "testing"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cms-lab/core": "1.0.0"
+  },
+  "author": "Afaq Rashid",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --tsconfig ../../tsconfig.base.json"
+  }
+}