@cms-lab/cli 1.0.10 → 1.2.0

package/README.md

@@ -10,6 +10,7 @@ npx @cms-lab/cli scan
 
 ```sh
 cms-lab init
+cms-lab init --cms strapi --router pages
 cms-lab doctor
 cms-lab doctor --debug --verbose 2
 cms-lab scan --report
@@ -37,6 +38,11 @@ Strapi, Directus, WordPress, Contentful, and Sanity. It validates configured CMS
 route mappings, route reachability, UID gaps, SEO metadata, image alt text, and
 project-specific required fields.
 
+`cms-lab init --cms strapi --router pages` writes a Strapi starter config with
+collections, single types, route examples, and the Strapi relation route helper.
+Use `site.healthPath` or `site.healthUrl` in config when the app root is not the
+right page for the initial health probe.
+
 Debug logs use stderr and support `--debug` plus `--verbose <0|1|2|3>`, so JSON
 scan output remains clean on stdout. Raw CMS document `data` is redacted from
 `--json` output, along with document URLs, UIDs, and absolute project paths,

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-VARQUY5N.js";
+} from "./chunk-34UP25NH.js";
 
 // src/bin.ts
 var exitCode = await runCli(process.argv.slice(2));

package/dist/{chunk-VARQUY5N.js → chunk-34UP25NH.js}

@@ -9,6 +9,7 @@ import {
   SiteUnreachableError,
   explainDiagnostic,
   loadCmsLabConfig,
+  resolveSiteHealthUrl,
   scanDocuments
 } from "@cms-lab/core";
 import { fetchContentfulDocuments as defaultFetchContentfulDocuments } from "@cms-lab/contentful";
@@ -325,7 +326,8 @@ function cmsDetails(config) {
   if (config.provider === "strapi") {
     return `## CMS details
 
-- Collections: ${config.collections.map((collection) => `${collection.type} (${collection.endpoint})`).join(", ")}`;
+- Collections: ${(config.collections ?? []).map((collection) => `${collection.type} (${collection.endpoint})`).join(", ") || "none"}
+- Single types: ${(config.singleTypes ?? []).map((singleType) => `${singleType.type} (${singleType.endpoint})`).join(", ") || "none"}`;
   }
   if (config.provider === "directus") {
     return `## CMS details
@@ -513,7 +515,7 @@ var noColor = {
 // src/index.ts
 async function runCli(argv, dependencies = {}) {
   let exitCode = 0;
-  const program = new Command().name("cms-lab").description("Catch CMS bugs before deploy.").version("1.0.10").exitOverride().configureOutput({
+  const program = new Command().name("cms-lab").description("Catch CMS bugs before deploy.").version("1.2.0").exitOverride().configureOutput({
     writeOut: (text) => writeStdout(dependencies, text),
     writeErr: (text) => writeStderr(dependencies, text)
   });
@@ -612,12 +614,21 @@ Examples:
   ).action((code) => {
     exitCode = runExplain(code, dependencies);
   });
-  program.command("init").description("Create a starter cms-lab.config.ts file.").option("--config <path>", "Config file path", "cms-lab.config.ts").option("--force", "Overwrite an existing config file").option("--repository <name>", "Prismic repository name", "my-repo").option("--url <url>", "Site URL", "http://localhost:3000").addHelpText(
+  program.command("init").description("Create a starter cms-lab.config.ts file.").option("--config <path>", "Config file path", "cms-lab.config.ts").option("--force", "Overwrite an existing config file").option(
+    "--cms <provider>",
+    "Starter CMS provider: prismic or strapi",
+    "prismic"
+  ).option("--router <router>", "Next.js router: app or pages", "app").option("--repository <name>", "Prismic repository name", "my-repo").option("--url <url>", "Site URL", "http://localhost:3000").option(
+    "--strapi-url <url>",
+    "Strapi REST API URL",
+    "http://localhost:1337"
+  ).option("--strapi-locale <locale>", "Strapi locale query param").addHelpText(
     "after",
     `
 Examples:
   cms-lab init
   cms-lab init --repository my-prismic-repo --url http://localhost:3000
+  cms-lab init --cms strapi --router pages --strapi-url http://localhost:1337
   cms-lab init --config cms-lab.config.ts --force
 `
   ).action(async (options) => {
@@ -897,9 +908,10 @@ async function runDoctor(options, dependencies) {
 `
     );
     const endSite = debug.time("site probe", 2);
-    await fetchSite(config.site.url, dependencies.fetch, timeoutMs, retries);
+    const healthUrl = resolveSiteHealthUrl(config.site).toString();
+    await fetchSite(healthUrl, dependencies.fetch, timeoutMs, retries);
     endSite();
-    writeStdout(dependencies, `site ok - ${config.site.url}
+    writeStdout(dependencies, `site ok - ${siteUrlForOutput(healthUrl)}
 `);
     const endCms = debug.time("cms fetch", 2);
     const documents = await fetchCmsDocuments(config.cms, dependencies);
@@ -978,13 +990,7 @@ async function runInit(options, dependencies) {
       return 2;
     }
     await mkdir(dirname(target), { recursive: true });
-    await writeFile(
-      target,
-      starterConfig({
-        repository: options.repository ?? "my-repo",
-        url: options.url ?? "http://localhost:3000"
-      })
-    );
+    await writeFile(target, starterConfig(parseInitOptions(options)));
     writeStdout(dependencies, `created ${target}
 `);
     return 0;
@@ -1206,7 +1212,9 @@ function describeCms(config) {
   }
   if (config.provider === "strapi") {
     return `strapi url=${safeUrl(config.url)} collections=${formatList(
-      config.collections.map((collection) => collection.endpoint)
+      (config.collections ?? []).map((collection) => collection.endpoint)
+    )} singleTypes=${formatList(
+      (config.singleTypes ?? []).map((singleType) => singleType.endpoint)
     )}`;
   }
   if (config.provider === "directus") {
@@ -1250,6 +1258,16 @@ function safeUrl(value) {
     return "<invalid-url>";
   }
 }
+function siteUrlForOutput(value) {
+  try {
+    const url = new URL(value);
+    const auth = url.username || url.password ? "[redacted]@" : "";
+    const hash = url.hash ? "#[redacted]" : "";
+    return `${url.protocol}//${auth}${url.host}${url.pathname}${url.search ? "?[redacted]" : ""}${hash}`;
+  } catch {
+    return redactSensitive(value);
+  }
+}
 function formatList(values) {
   return values.length > 0 ? values.join(",") : "none";
 }
@@ -1516,12 +1534,33 @@ async function fileExists(path) {
 function plural3(value, singular) {
   return value === 1 ? singular : `${singular}s`;
 }
+function parseInitOptions(options) {
+  const cms = options.cms ?? "prismic";
+  if (cms !== "prismic" && cms !== "strapi") {
+    throw new ConfigLoadError("--cms must be one of: prismic, strapi");
+  }
+  const router = options.router ?? "app";
+  if (router !== "app" && router !== "pages") {
+    throw new ConfigLoadError("--router must be one of: app, pages");
+  }
+  return {
+    cms,
+    router,
+    repository: options.repository ?? "my-repo",
+    url: options.url ?? "http://localhost:3000",
+    strapiUrl: options.strapiUrl ?? "http://localhost:1337",
+    strapiLocale: options.strapiLocale
+  };
+}
 function starterConfig(options) {
+  if (options.cms === "strapi") {
+    return strapiStarterConfig(options);
+  }
   return `import { defineConfig } from "@cms-lab/core";
 
 export default defineConfig({
   site: { url: ${JSON.stringify(options.url)} },
-  framework: { type: "next", router: "app" },
+  framework: { type: "next", router: ${JSON.stringify(options.router)} },
   cms: {
     provider: "prismic",
     repositoryName: ${JSON.stringify(options.repository)},
@@ -1538,6 +1577,45 @@ export default defineConfig({
 });
 `;
 }
+function strapiStarterConfig(options) {
+  const localeLine = options.strapiLocale ? `
+    locale: ${JSON.stringify(options.strapiLocale)},` : "";
+  return `import { defineConfig, strapiRelationSlug } from "@cms-lab/core";
+
+export default defineConfig({
+  site: {
+    url: ${JSON.stringify(options.url)},
+    // Use healthPath when your app's root redirects or errors but a locale route is healthy.
+    // healthPath: "/en",
+  },
+  framework: { type: "next", router: ${JSON.stringify(options.router)} },
+  cms: {
+    provider: "strapi",
+    url: ${JSON.stringify(options.strapiUrl)},
+    token: process.env.STRAPI_TOKEN,${localeLine}
+    collections: [
+      { type: "page", endpoint: "pages", uidField: "slug" },
+      { type: "article", endpoint: "articles", uidField: "slug" },
+    ],
+    singleTypes: [
+      { type: "navbar", endpoint: "navbar" },
+      { type: "footer", endpoint: "footer" },
+    ],
+  },
+  routes: [
+    { type: "page", pattern: "/:slug", getPath: (doc) => \`/\${doc.uid}\` },
+    {
+      type: "article",
+      pattern: "/blog/:topic/:slug",
+      getPath: (doc) => {
+        const topic = strapiRelationSlug(doc.data, "topic") ?? "uncategorized";
+        return \`/blog/\${topic}/\${doc.uid}\`;
+      },
+    },
+  ],
+});
+`;
+}
 
 export {
   runCli

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runCli
-} from "./chunk-VARQUY5N.js";
+} from "./chunk-34UP25NH.js";
 export {
   runCli
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cms-lab/cli",
-  "version": "1.0.10",
+  "version": "1.2.0",
   "type": "module",
   "description": "Catch CMS bugs before deploy.",
   "license": "MIT",
@@ -47,15 +47,15 @@
   "dependencies": {
     "commander": "^14.0.2",
     "picocolors": "^1.1.1",
-    "@cms-lab/core": "1.0.10",
-    "@cms-lab/contentful": "1.0.10",
-    "@cms-lab/directus": "1.0.10",
-    "@cms-lab/prismic": "1.0.10",
-    "@cms-lab/reporter": "1.0.10",
-    "@cms-lab/next": "1.0.10",
-    "@cms-lab/sanity": "1.0.10",
-    "@cms-lab/wordpress": "1.0.10",
-    "@cms-lab/strapi": "1.0.10"
+    "@cms-lab/contentful": "1.2.0",
+    "@cms-lab/core": "1.2.0",
+    "@cms-lab/directus": "1.2.0",
+    "@cms-lab/prismic": "1.2.0",
+    "@cms-lab/reporter": "1.2.0",
+    "@cms-lab/sanity": "1.2.0",
+    "@cms-lab/wordpress": "1.2.0",
+    "@cms-lab/strapi": "1.2.0",
+    "@cms-lab/next": "1.2.0"
   },
   "author": "Afaq Rashid",
   "scripts": {