@cms-lab/cli 1.2.3 → 1.2.5

package/README.md

@@ -11,6 +11,7 @@ npx @cms-lab/cli scan
 ```sh
 cms-lab init
 cms-lab init --cms strapi --router pages
+cms-lab init --cms directus --router pages
 cms-lab doctor
 cms-lab doctor --debug --verbose 2
 cms-lab scan --report
@@ -38,10 +39,12 @@ cms-lab explain CMS-ROUTE-404
 cms-lab supports Next.js App Router and Pages Router projects using Prismic,
 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.
+project-specific required fields and relationship minimums.
 
 `cms-lab init --cms strapi --router pages` writes a Strapi starter config with
 collections, single types, route examples, and the Strapi relation route helper.
+`cms-lab init --cms directus --router pages` writes a Directus starter config
+with branch, menu item, category, and non-routable pricing collection examples.
 Use `site.healthPath` or `site.healthUrl` in config when the app root is not the
 right page for the initial health probe.
 

package/dist/bin.js

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

package/dist/{chunk-M5O5QRR3.js → chunk-4XXHRNEA.js}

@@ -100,6 +100,9 @@ function groupForDiagnostic(diagnostic) {
   if (diagnostic.code.startsWith("CMS-FIELD")) {
     return "fields";
   }
+  if (diagnostic.code.startsWith("CMS-RELATIONSHIP")) {
+    return "relationships";
+  }
   if (diagnostic.code.startsWith("SEO-")) {
     return "seo";
   }
@@ -372,7 +375,8 @@ function checksSummary(config) {
     `- Routes: ${checkState(checks?.routes)}`,
     `- SEO: ${checkState(checks?.seo)}`,
     `- Image alt text: ${checkState(checks?.a11y ?? checks?.images)}`,
-    `- Required fields: ${requiredFieldsSummary(config)}`
+    `- Required fields: ${requiredFieldsSummary(config)}`,
+    `- Relationship rules: ${relationshipRulesSummary(config)}`
   ];
   return lines.join("\n");
 }
@@ -398,6 +402,15 @@ function requiredFieldsSummary(config) {
     (field) => `${field.type}.${field.path} (${field.severity ?? "error"})`
   ).join(", ");
 }
+function relationshipRulesSummary(config) {
+  const relationships = config.checks?.relationships ?? [];
+  if (relationships.length === 0) {
+    return "default";
+  }
+  return relationships.map(
+    (rule) => `${rule.from} -> ${rule.to} (${rule.where.fromField} = ${rule.where.toField}, min ${rule.min ?? 1}, ${rule.severity ?? "warning"})`
+  ).join(", ");
+}
 function projectLabel(project) {
   if (project.framework === "next" && project.router === "app") {
     return "Next.js App Router";
@@ -565,7 +578,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.2.3").exitOverride().configureOutput({
+  const program = new Command().name("cms-lab").description("Catch CMS bugs before deploy.").version("1.2.5").exitOverride().configureOutput({
     writeOut: (text) => writeStdout(dependencies, text),
     writeErr: (text) => writeStderr(dependencies, text)
   });
@@ -669,19 +682,20 @@ Examples:
   });
   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",
+    "Starter CMS provider: prismic, strapi, or directus",
     "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(
+  ).option("--strapi-locale <locale>", "Strapi locale query param").option("--directus-url <url>", "Directus API URL", "http://localhost:8055").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 --cms directus --router pages --directus-url http://localhost:8055
   cms-lab init --config cms-lab.config.ts --force
 `
   ).action(async (options) => {
@@ -1403,7 +1417,14 @@ function assertTypeFilterMatched(documents, types) {
   );
 }
 function parseCheckGroups(values) {
-  const allowed = /* @__PURE__ */ new Set(["routes", "seo", "a11y", "images", "fields"]);
+  const allowed = /* @__PURE__ */ new Set([
+    "routes",
+    "seo",
+    "a11y",
+    "images",
+    "fields",
+    "relationships"
+  ]);
   const groups = splitList(values);
   for (const group of groups) {
     if (!allowed.has(group)) {
@@ -1621,8 +1642,10 @@ function plural3(value, singular) {
 }
 function parseInitOptions(options) {
   const cms = options.cms ?? "prismic";
-  if (cms !== "prismic" && cms !== "strapi") {
-    throw new ConfigLoadError("--cms must be one of: prismic, strapi");
+  if (cms !== "prismic" && cms !== "strapi" && cms !== "directus") {
+    throw new ConfigLoadError(
+      "--cms must be one of: prismic, strapi, directus"
+    );
   }
   const router = options.router ?? "app";
   if (router !== "app" && router !== "pages") {
@@ -1634,13 +1657,17 @@ function parseInitOptions(options) {
     repository: options.repository ?? "my-repo",
     url: options.url ?? "http://localhost:3000",
     strapiUrl: options.strapiUrl ?? "http://localhost:1337",
-    strapiLocale: options.strapiLocale
+    strapiLocale: options.strapiLocale,
+    directusUrl: options.directusUrl ?? "http://localhost:8055"
   };
 }
 function starterConfig(options) {
   if (options.cms === "strapi") {
     return strapiStarterConfig(options);
   }
+  if (options.cms === "directus") {
+    return directusStarterConfig(options);
+  }
   return `import { defineConfig } from "@cms-lab/core";
 
 export default defineConfig({
@@ -1662,6 +1689,80 @@ export default defineConfig({
 });
 `;
 }
+function directusStarterConfig(options) {
+  return `import { defineConfig, readCmsDataPath } 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: "directus",
+    url: ${JSON.stringify(options.directusUrl)},
+    token: process.env.DIRECTUS_TOKEN,
+    collections: [
+      { type: "branch", collection: "branches", uidField: "slug" },
+      { type: "menu_item", collection: "menu_items", uidField: "slug" },
+      { type: "category", collection: "menu_categories", uidField: "slug" },
+      {
+        type: "pricing",
+        collection: "item_branch_pricing",
+        uidField: "id",
+        routable: false,
+      },
+    ],
+  },
+  routes: [
+    {
+      type: "branch",
+      pattern: "/branches/:slug",
+      getPath: (doc) => \`/branches/\${doc.uid}\`,
+    },
+    {
+      type: "category",
+      pattern: "/categories/:slug",
+      getPath: (doc) => \`/categories/\${doc.uid}\`,
+    },
+    {
+      type: "menu_item",
+      pattern: "/menu/:branch/:slug",
+      getPath: (doc) => {
+        const branch =
+          readCmsDataPath(doc.data, "branch.slug") ??
+          readCmsDataPath(doc.data, "branch_id.slug") ??
+          "branch";
+
+        return \`/menu/\${branch}/\${doc.uid}\`;
+      },
+    },
+  ],
+  checks: {
+    fields: {
+      required: [
+        { type: "branch", path: "name" },
+        { type: "branch", path: "city" },
+        { type: "menu_item", path: "name" },
+        { type: "menu_item", path: "base_price", severity: "warning" },
+        { type: "pricing", path: "price", severity: "warning" },
+        { type: "pricing", path: "is_available", severity: "warning" },
+      ],
+    },
+    relationships: [
+      {
+        from: "menu_item",
+        to: "pricing",
+        where: { fromField: "id", toField: "menu_item_id" },
+        min: 1,
+        severity: "warning",
+      },
+    ],
+  },
+});
+`;
+}
 function strapiStarterConfig(options) {
   const localeLine = options.strapiLocale ? `
     locale: ${JSON.stringify(options.strapiLocale)},` : "";

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runCli
-} from "./chunk-M5O5QRR3.js";
+} from "./chunk-4XXHRNEA.js";
 export {
   runCli
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cms-lab/cli",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "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/contentful": "1.2.3",
-    "@cms-lab/core": "1.2.3",
-    "@cms-lab/prismic": "1.2.3",
-    "@cms-lab/reporter": "1.2.3",
-    "@cms-lab/sanity": "1.2.3",
-    "@cms-lab/strapi": "1.2.3",
-    "@cms-lab/next": "1.2.3",
-    "@cms-lab/wordpress": "1.2.3",
-    "@cms-lab/directus": "1.2.3"
+    "@cms-lab/contentful": "1.2.5",
+    "@cms-lab/core": "1.2.5",
+    "@cms-lab/directus": "1.2.5",
+    "@cms-lab/next": "1.2.5",
+    "@cms-lab/prismic": "1.2.5",
+    "@cms-lab/reporter": "1.2.5",
+    "@cms-lab/sanity": "1.2.5",
+    "@cms-lab/strapi": "1.2.5",
+    "@cms-lab/wordpress": "1.2.5"
   },
   "author": "Afaq Rashid",
   "scripts": {