@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/schema-RYTVKPLZ.js

@@ -0,0 +1,132 @@
+import {
+  describeSlots
+} from "./chunk-3LYMIKKN.js";
+import "./chunk-O6UM5WWH.js";
+import {
+  FLOW_CATALOG,
+  FLOW_FORM_FIELD_TYPES,
+  flowCatalogEntry,
+  flowCatalogTypes,
+  flowNodeTriggers
+} from "./chunk-O6XZIQXZ.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-I2DNBEV6.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/schema.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "flows.schema",
+  description: "The shape of one node or side-effect type: a pasteable skeleton, who fills each part, and the reference file with the craft. Start here before authoring anything in a form's _data.json.",
+  args: {
+    kind: { type: "positional", description: "node | side-effect. Omit to list both vocabularies.", required: false },
+    type: { type: "positional", description: "The type, e.g. customForm or googleSpreadsheet", required: false }
+  }
+});
+var KINDS = ["node", "side-effect"];
+function triggerReport(triggers) {
+  return {
+    fires: triggers.completion,
+    available: triggers.available,
+    ...triggers.why ? { why: triggers.why } : {}
+  };
+}
+function triggerHints(triggers) {
+  if (!triggers) return [];
+  if (!triggers.completion) return [`No side effect can be added to this step as it stands: ${triggers.why}`];
+  const others = triggers.available.filter((id) => id !== triggers.completion);
+  return [
+    `A side effect on this step carries \`triggerId: "${triggers.completion}"\`, and \`baker flows add-side-effect\` writes it for you. The trigger belongs to the STEP, not to the side-effect type: one that does not match is valid, ships, and never runs.` + (others.length > 0 ? ` Other moments this step raises: ${others.join(", ")}.` : "")
+  ];
+}
+var schemaCommand = defineCommand({
+  meta: {
+    name: "schema",
+    description: "Show a node or side-effect type's shape. Start here: baker flows schema node customForm \xB7 baker flows schema side-effect googleSpreadsheet \xB7 baker flows schema (lists both)"
+  },
+  args: {
+    kind: { type: "positional", description: "node | side-effect", required: false },
+    type: { type: "positional", description: "The type name", required: false }
+  },
+  run: ({ args }) => {
+    const kind = args.kind ? String(args.kind) : void 0;
+    const type = args.type ? String(args.type) : void 0;
+    if (!kind) {
+      writeJson({
+        ok: true,
+        data: {
+          node: flowCatalogTypes("node"),
+          "side-effect": flowCatalogTypes("side-effect"),
+          formFieldTypes: FLOW_FORM_FIELD_TYPES
+        },
+        hints: [
+          "baker flows schema node <type> \xB7 baker flows schema side-effect <type>",
+          "`hubspot` is in both lists and they are different things: the node embeds a form on the page, the side effect fires a behavioural event.",
+          "formFieldTypes are the `fieldtype` values INSIDE a customForm \u2014 a third vocabulary, not node types."
+        ]
+      });
+      return;
+    }
+    if (!KINDS.includes(kind)) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: `Unknown kind "${kind}".`, fix: `Expected: ${KINDS.join(" | ")}` }
+      });
+      process.exit(1);
+    }
+    if (!type) {
+      writeJson({
+        ok: true,
+        data: { kind, types: flowCatalogTypes(kind) },
+        hints: [`baker flows schema ${kind} <type>`]
+      });
+      return;
+    }
+    const entry = flowCatalogEntry(kind, type);
+    if (!entry) {
+      const alternate = FLOW_CATALOG.find((candidate) => candidate.type === type);
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No ${kind} type "${type}".`,
+          fix: alternate ? `"${type}" is a ${alternate.kind} type, not a ${kind} type. Try: baker flows schema ${alternate.kind} ${type}` : `Known ${kind} types: ${flowCatalogTypes(kind).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    const mappable = kind === "side-effect" ? describeSlots(type) : [];
+    const triggers = kind === "node" ? flowNodeTriggers(entry.skeleton.nodeData) : null;
+    writeJson({
+      ok: true,
+      data: {
+        ...entry,
+        ...mappable.length > 0 ? { mappable } : {},
+        ...triggers ? { triggers: triggerReport(triggers) } : {}
+      },
+      hints: [
+        `Full schema, gotchas and a worked example: ${entry.reference}`,
+        ...triggerHints(triggers),
+        ...mappable.length > 0 ? [
+          `Mappable with \`baker flows map\`: ${mappable.map((slot) => slot.slot).join(", ")}. Run \`baker flows map <slug> --side-effect <id>\` with no --map to see the legal keys for one you already have.`
+        ] : [],
+        ...entry.owners ? [
+          `You author everything except: ${Object.entries(entry.owners).filter(([, owner]) => owner !== "agent").map(([key, owner]) => `${key} (${owner})`).join(", ")}`
+        ] : []
+      ].filter(Boolean)
+    });
+  }
+});
+export {
+  schemaCommand
+};
+//# sourceMappingURL=schema-RYTVKPLZ.js.map

package/dist/schema-RYTVKPLZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flows/schema.ts"],"sourcesContent":["import {\n  FLOW_CATALOG,\n  FLOW_FORM_FIELD_TYPES,\n  type FlowNodeTriggers,\n  flowCatalogEntry,\n  flowCatalogTypes,\n  flowNodeTriggers,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { describeSlots } from \"./mapping.ts\";\n\nregisterSchema({\n  command: \"flows.schema\",\n  description:\n    \"The shape of one node or side-effect type: a pasteable skeleton, who fills each part, and the reference file with the craft. Start here before authoring anything in a form's _data.json.\",\n  args: {\n    kind: { type: \"positional\", description: \"node | side-effect. Omit to list both vocabularies.\", required: false },\n    type: { type: \"positional\", description: \"The type, e.g. customForm or googleSpreadsheet\", required: false },\n  },\n});\n\n/**\n * `hubspot` is a node type AND a side-effect type, and the reference file they\n * used to share put them at different heading depths — which is why the doc\n * carried a paragraph about heading depths. Taking the kind as an argument makes\n * that ambiguity unreachable, so it is required as soon as a type is named.\n */\nconst KINDS = [\"node\", \"side-effect\"] as const;\n\n/**\n * The trigger half of a node's answer.\n *\n * Carried on `schema node <type>` because `triggerId` is the one field on a\n * side effect that its own type does not decide — the STEP does. A mismatch is\n * written, passes every validator in the repo, and never runs, so the moment to\n * learn which id a step raises is before anything is authored, not after a CRM\n * quietly receives nothing.\n */\nfunction triggerReport(triggers: FlowNodeTriggers) {\n  return {\n    fires: triggers.completion,\n    available: triggers.available,\n    ...(triggers.why ? { why: triggers.why } : {}),\n  };\n}\n\nfunction triggerHints(triggers: FlowNodeTriggers | null): string[] {\n  if (!triggers) return [];\n  if (!triggers.completion) return [`No side effect can be added to this step as it stands: ${triggers.why}`];\n  const others = triggers.available.filter((id) => id !== triggers.completion);\n  return [\n    `A side effect on this step carries \\`triggerId: \"${triggers.completion}\"\\`, and \\`baker flows add-side-effect\\` writes it for you. The trigger belongs to the STEP, not to the side-effect type: one that does not match is valid, ships, and never runs.` +\n      (others.length > 0 ? ` Other moments this step raises: ${others.join(\", \")}.` : \"\"),\n  ];\n}\n\nexport const schemaCommand = defineCommand({\n  meta: {\n    name: \"schema\",\n    description:\n      \"Show a node or side-effect type's shape. Start here: baker flows schema node customForm · baker flows schema side-effect googleSpreadsheet · baker flows schema (lists both)\",\n  },\n  args: {\n    kind: { type: \"positional\", description: \"node | side-effect\", required: false },\n    type: { type: \"positional\", description: \"The type name\", required: false },\n  },\n  run: ({ args }) => {\n    const kind = args.kind ? String(args.kind) : undefined;\n    const type = args.type ? String(args.type) : undefined;\n\n    if (!kind) {\n      writeJson({\n        ok: true,\n        data: {\n          node: flowCatalogTypes(\"node\"),\n          \"side-effect\": flowCatalogTypes(\"side-effect\"),\n          formFieldTypes: FLOW_FORM_FIELD_TYPES,\n        },\n        hints: [\n          \"baker flows schema node <type> · baker flows schema side-effect <type>\",\n          \"`hubspot` is in both lists and they are different things: the node embeds a form on the page, the side effect fires a behavioural event.\",\n          \"formFieldTypes are the `fieldtype` values INSIDE a customForm — a third vocabulary, not node types.\",\n        ],\n      });\n      return;\n    }\n\n    if (!(KINDS as readonly string[]).includes(kind)) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: `Unknown kind \"${kind}\".`, fix: `Expected: ${KINDS.join(\" | \")}` },\n      });\n      process.exit(1);\n    }\n\n    if (!type) {\n      writeJson({\n        ok: true,\n        data: { kind, types: flowCatalogTypes(kind as \"node\" | \"side-effect\") },\n        hints: [`baker flows schema ${kind} <type>`],\n      });\n      return;\n    }\n\n    const entry = flowCatalogEntry(kind as \"node\" | \"side-effect\", type);\n    if (!entry) {\n      const alternate = FLOW_CATALOG.find((candidate) => candidate.type === type);\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No ${kind} type \"${type}\".`,\n          fix: alternate\n            ? `\"${type}\" is a ${alternate.kind} type, not a ${kind} type. Try: baker flows schema ${alternate.kind} ${type}`\n            : `Known ${kind} types: ${flowCatalogTypes(kind as \"node\" | \"side-effect\").join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    // What can be mapped into it, and where the key names come from. The\n    // skeleton shows a closed set only as a side effect of every key being\n    // required — `eventParams: []` teaches nothing, and an account-sourced slot\n    // teaches nothing either. This says it outright, before anything is authored.\n    const mappable = kind === \"side-effect\" ? describeSlots(type) : [];\n\n    // Which trigger a side effect on this step would have to carry. Resolved\n    // from the skeleton above rather than described separately, so it always\n    // answers for the exact node `baker flows add-node` mints — a `text` step\n    // raises a different id depending on `allowNextNode`, and this way the two\n    // can never disagree.\n    const triggers = kind === \"node\" ? flowNodeTriggers(entry.skeleton.nodeData) : null;\n\n    writeJson({\n      ok: true,\n      data: {\n        ...entry,\n        ...(mappable.length > 0 ? { mappable } : {}),\n        ...(triggers ? { triggers: triggerReport(triggers) } : {}),\n      },\n      hints: [\n        `Full schema, gotchas and a worked example: ${entry.reference}`,\n        ...triggerHints(triggers),\n        ...(mappable.length > 0\n          ? [\n              `Mappable with \\`baker flows map\\`: ${mappable.map((slot) => slot.slot).join(\", \")}. Run \\`baker flows map <slug> --side-effect <id>\\` with no --map to see the legal keys for one you already have.`,\n            ]\n          : []),\n        ...(entry.owners\n          ? [\n              `You author everything except: ${Object.entries(entry.owners)\n                .filter(([, owner]) => owner !== \"agent\")\n                .map(([key, owner]) => `${key} (${owner})`)\n                .join(\", \")}`,\n            ]\n          : []),\n      ].filter(Boolean),\n    });\n  },\n});\n"],"mappings":"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","names":[]}