@cmssy/cli 11.2.0 → 11.3.0

package/dist/index.js

@@ -1008,7 +1008,7 @@ async function runLink(options, deps) {
 }
 
 // src/types-command.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync6, readdirSync, writeFileSync as writeFileSync4 } from "fs";
 import { dirname as dirname3, relative, resolve as resolvePath } from "path";
 import { DEFAULT_CMSSY_API_URL } from "@cmssy/core";
 
@@ -1178,6 +1178,42 @@ function generateModelTypes(models, options) {
   return blocks.join("\n");
 }
 
+// src/operations-file.ts
+import { CMSSY_DELIVERY_OPERATIONS } from "@cmssy/core/internal";
+var DEFAULT_OPERATIONS_OUT = "cmssy/operations.graphql";
+var OPERATION_NAME = /^\s*(?:query|mutation|subscription)\s+([A-Za-z_]\w*)/m;
+function operationNames() {
+  return CMSSY_DELIVERY_OPERATIONS.map((operation) => {
+    const match = OPERATION_NAME.exec(operation.document);
+    if (!match?.[1]) {
+      throw new Error(
+        "cmssy: a delivery operation has no name - anonymous documents cannot be vendored"
+      );
+    }
+    return match[1];
+  });
+}
+function generateOperationsFile() {
+  const header = [
+    "# Generated by `cmssy types`. Do not edit - it is rewritten on every run.",
+    "#",
+    "# The delivery reads the SDK itself performs, vendored so your codegen",
+    "# types them like any other document. Point `documents` in codegen.ts at",
+    "# this file. Need a different selection set? Write your own query, under",
+    "# your own operation name - two documents cannot share one.",
+    ""
+  ].join("\n");
+  const documents = CMSSY_DELIVERY_OPERATIONS.map(
+    // A newline in `purpose` would emit bare prose into the document and break
+    // parsing for every consumer.
+    (operation) => `# ${operation.purpose.replace(/\s+/g, " ").trim()}
+${operation.document}`
+  ).join("\n\n");
+  return `${header}
+${documents}
+`;
+}
+
 // src/types-command.ts
 var DEFAULT_OUT = "cmssy/models.ts";
 var SITE_CONFIG_QUERY = `query CliSiteConfig($workspaceSlug: String!) {
@@ -1272,9 +1308,96 @@ function resolve3(value, fromEnv, variable) {
   }
   return resolved;
 }
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  "build",
+  ".next",
+  ".git",
+  ".turbo",
+  ".vercel"
+]);
+var ANY_OPERATION_NAME = /^\s*(?:query|mutation|subscription)\s+([A-Za-z_]\w*)/gm;
+function existingOperationNames(cwd, skipPath) {
+  const found = /* @__PURE__ */ new Map();
+  let entries;
+  try {
+    entries = readdirSync(cwd, { recursive: true });
+  } catch {
+    return found;
+  }
+  for (const entry of entries) {
+    if (typeof entry !== "string" || !entry.endsWith(".graphql")) continue;
+    if (entry.split(/[\\/]/).some((part) => SKIP_DIRS.has(part))) continue;
+    const full = resolvePath(cwd, entry);
+    if (full === skipPath) continue;
+    let source;
+    try {
+      source = readFileSync6(full, "utf8");
+    } catch {
+      continue;
+    }
+    for (const match of source.matchAll(ANY_OPERATION_NAME)) {
+      const name = match[1];
+      if (name && !found.has(name)) found.set(name, entry);
+    }
+  }
+  return found;
+}
+function syncOperations(options, deps) {
+  if (options.noOperations) return 0;
+  const requested = options.operationsOut?.trim() || DEFAULT_OPERATIONS_OUT;
+  const outPath = resolvePath(deps.cwd, requested);
+  const inside = relative(deps.cwd, outPath);
+  const shown = inside && !inside.startsWith("..") ? inside : outPath;
+  const source = generateOperationsFile();
+  let previous = null;
+  try {
+    previous = readFileSync6(outPath, "utf8");
+  } catch {
+    previous = null;
+  }
+  const existing = existingOperationNames(deps.cwd, outPath);
+  const clashes = operationNames().map((name) => ({ name, file: existing.get(name) })).filter((clash) => !!clash.file);
+  if (clashes.length > 0) {
+    deps.log(
+      `cmssy: ${shown} would collide with operations this app already declares`
+    );
+    for (const clash of clashes) {
+      deps.log(`  ${clash.name} - already in ${clash.file}`);
+    }
+    deps.log(
+      "  delete those documents to use the vendored ones, or pass --no-operations to keep yours"
+    );
+    return 1;
+  }
+  if (previous === source) return 0;
+  if (options.check) {
+    deps.log(
+      previous === null ? `cmssy: ${shown} is missing - run \`cmssy types\` and commit it` : `cmssy: ${shown} is out of date with this CLI's delivery operations`
+    );
+    deps.log("  run `cmssy types` and commit the result");
+    return 1;
+  }
+  try {
+    mkdirSync3(dirname3(outPath), { recursive: true });
+    writeFileSync4(outPath, source);
+  } catch (error) {
+    throw new CliError(
+      `could not write ${shown}: ${error.message}`,
+      "check the path is writable, or pass --operations-out"
+    );
+  }
+  const names = operationNames();
+  deps.log(`cmssy: wrote ${shown} - ${names.length} operations`);
+  deps.log(`  ${names.join(", ")}`);
+  return 0;
+}
 async function runTypes(options, deps) {
+  let operationsStatus = 0;
   try {
     loadEnvFiles(deps.cwd, deps.env);
+    operationsStatus = syncOperations(options, deps);
     const org = resolve3(options.org, deps.env.CMSSY_ORG_SLUG, "CMSSY_ORG_SLUG");
     const workspace = resolve3(
       options.workspace,
@@ -1296,7 +1419,7 @@ async function runTypes(options, deps) {
       deps.log(
         `cmssy: the "${workspace}" workspace has no models yet - nothing to generate`
       );
-      return 0;
+      return operationsStatus;
     }
     const requested = options.out?.trim() || DEFAULT_OUT;
     const outPath = resolvePath(deps.cwd, requested);
@@ -1311,7 +1434,7 @@ async function runTypes(options, deps) {
     }
     if (previous === source) {
       deps.log(`cmssy: ${shown} is up to date`);
-      return 0;
+      return operationsStatus;
     }
     if (options.check) {
       deps.log(
@@ -1335,7 +1458,7 @@ async function runTypes(options, deps) {
     deps.log(
       `  ${models.map((model) => model.slug).join(", ")}`
     );
-    return 0;
+    return operationsStatus;
   } catch (error) {
     if (error instanceof CliError) {
       deps.log(`cmssy: ${error.message}`);
@@ -1352,7 +1475,8 @@ var USAGE = [
   "  cmssy init [--dir <path>] [--force]",
   "  cmssy add block <name> [--dir <path>]",
   "  cmssy link [--token <cs_...>] [--workspace <slug>] [--preview-url <url>]",
-  "  cmssy types [--out <path>] [--check] [--org <slug>] [--workspace <slug>]"
+  "  cmssy types [--out <path>] [--operations-out <path>] [--no-operations]",
+  "              [--check] [--org <slug>] [--workspace <slug>]"
 ].join("\n");
 function flagValue(args, name) {
   const index = args.findIndex((arg) => arg === name);
@@ -1416,7 +1540,9 @@ async function main() {
         out: flagValue(args, "--out"),
         org: flagValue(args, "--org"),
         workspace: flagValue(args, "--workspace"),
-        check: hasFlag(args, "--check")
+        check: hasFlag(args, "--check"),
+        operationsOut: flagValue(args, "--operations-out"),
+        noOperations: hasFlag(args, "--no-operations")
       },
       {
         cwd: process.cwd(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/cli",
-  "version": "11.2.0",
+  "version": "11.3.0",
   "description": "The cmssy CLI: `cmssy init` wires cmssy into an existing Next.js, Astro or React Router app; `cmssy link` connects it to a workspace and verifies the editor wiring.",
   "keywords": [
     "cmssy",
@@ -27,13 +27,14 @@
     "assets"
   ],
   "dependencies": {
-    "@cmssy/core": "11.2.0"
+    "@cmssy/core": "11.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "vitest": "^2.1.0",
+    "graphql": "^16.10.0"
   },
   "scripts": {
     "build": "tsup",