@koda-sl/baker-cli 0.512.0 → 0.514.0-dev.555f7007e

package/dist/ad-writes-XRCPK4SP.js

@@ -0,0 +1,176 @@
+import {
+  clearableArg,
+  compact,
+  cropArg,
+  lowerArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-3M45PYU7.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-EW7JSTRZ.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.ads;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Internal ad name (3+ characters)" },
+  title: { type: "string", description: "Card title, 3\u201350 characters" },
+  body: { type: "string", description: "Card text, up to 100 characters" },
+  "target-url": { type: "string", description: "Landing page, https://" },
+  "image-url": {
+    type: "string",
+    description: "Card image, https:// \u2014 PNG, JPEG, WebP or AVIF; square and 640 \xD7 640 px or larger reads best"
+  },
+  "image-crop": {
+    type: "string",
+    description: "The square of the image the card shows, as x,y,width,height shares from 0 to 1, e.g. 0.1,0,0.8,0.8 (default: chosen by ChatGPT Ads)"
+  },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to this card's landing page, e.g. ad_id={ad_id} \u2014 none clears"
+  },
+  status: { type: "string", description: "paused (default) | active" }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "ad-group-id": { type: "string", description: "adgrp_\u2026 or a staged chatgpt_temp_ ref", required: true },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: { type: "string", description: "Card title, 3\u201350 characters", required: true },
+  body: { type: "string", description: "Card text, up to 100 characters", required: true },
+  "target-url": { type: "string", description: "Landing page, https://", required: true },
+  "image-url": { type: "string", description: "Card image, https://, at least 640 \xD7 640 px", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Ad id (ad_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    title: args.title,
+    body: args.body,
+    targetUrl: args["target-url"],
+    imageUrl: args["image-url"],
+    imageCrop: cropArg(args["image-crop"], "--image-crop"),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    status: lowerArg(args.status)
+  };
+}
+function adCreateOp(args) {
+  return { kind: "ad.create", payload: compact({ ...sharedPayload(args), adGroupId: args["ad-group-id"] }) };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create",
+  description: "Stage a new chat card under a live ad group (adgrp_\u2026) or one staged in this chat. Every new card goes through ChatGPT Ads' review after publish before it serves.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var adsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new chat card (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "Solar from 0 upfront" \\
+    --body "Get a quote in two minutes." --target-url https://example.com/solar --image-url https://example.com/card.png`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(adCreateOp(args), REFERENCE, () => [
+      "Review everything staged with `baker ads chatgpt draft`. It applies when the chat is published."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.ads.update",
+  description: "Stage a change to a chat card \u2014 any of title, body, landing page, image, name or status; the rest is kept from the live card. Changing the card sends it back to review.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var adsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a chat card; what you do not pass is kept.
+
+Examples:
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads update ad_123 --target-url https://example.com/solar-v2`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(
+      { kind: "ad.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
+      REFERENCE
+    );
+  }
+});
+var adsPauseCommand = statusCommand("ad", "pause", REFERENCE);
+var adsResumeCommand = statusCommand("ad", "resume", REFERENCE);
+var adsArchiveCommand = statusCommand("ad", "archive", REFERENCE);
+var PRODUCT_ARGS = {
+  "ad-group-id": {
+    type: "string",
+    description: "adgrp_\u2026 under a catalog campaign, or a staged chatgpt_temp_ ref",
+    required: true
+  },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: {
+    type: "string",
+    description: "Title template (default {{product.title}}) \u2014 text with {{brand}}, {{product.title}}, {{product.body}}, {{product.price}}"
+  },
+  "tracking-template": { type: "string", description: "Query string added to each product's landing page" },
+  status: { type: "string", description: "paused (default) | active" }
+};
+function productAdCreateOp(args) {
+  return {
+    kind: "ad.create",
+    payload: compact({
+      format: "product_template",
+      adGroupId: args["ad-group-id"],
+      name: args.name,
+      title: args.title,
+      trackingTemplate: args["tracking-template"],
+      status: lowerArg(args.status)
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create-product",
+  description: "Stage the product ad of a catalog ad group: one template each product fills with its own title, text, price, image and link. One per ad group.",
+  args: schemaArgs(PRODUCT_ARGS)
+});
+var adsCreateProductCommand = defineCommand({
+  meta: {
+    name: "create-product",
+    description: `Stage a product ad for a catalog ad group (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create-product --ad-group-id adgrp_123 --name "Catalog ad" --title "{{brand}}: {{product.title}}"`
+  },
+  args: PRODUCT_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(productAdCreateOp(args), REFERENCE);
+  }
+});
+export {
+  adCreateOp,
+  adsArchiveCommand,
+  adsCreateCommand,
+  adsCreateProductCommand,
+  adsPauseCommand,
+  adsResumeCommand,
+  adsUpdateCommand,
+  productAdCreateOp
+};
+//# sourceMappingURL=ad-writes-XRCPK4SP.js.map

package/dist/ad-writes-XRCPK4SP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/ad-writes.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE } from \"./shared.ts\";\nimport {\n  clearableArg,\n  compact,\n  cropArg,\n  lowerArg,\n  requireTarget,\n  schemaArgs,\n  stageChatgptOp,\n  statusCommand,\n} from \"./write-shared.ts\";\n\n/**\n * Staged ad (chat card) writes. The image is uploaded to ChatGPT Ads at\n * publish, not now; an update is completed from the live card, since ChatGPT\n * Ads replaces a card whole.\n */\n\nconst REFERENCE = CHATGPT_ADS_REFERENCE.ads;\n\nconst SHARED_ARGS = {\n  name: { type: \"string\", description: \"Internal ad name (3+ characters)\" },\n  title: { type: \"string\", description: \"Card title, 3–50 characters\" },\n  body: { type: \"string\", description: \"Card text, up to 100 characters\" },\n  \"target-url\": { type: \"string\", description: \"Landing page, https://\" },\n  \"image-url\": {\n    type: \"string\",\n    description: \"Card image, https:// — PNG, JPEG, WebP or AVIF; square and 640 × 640 px or larger reads best\",\n  },\n  \"image-crop\": {\n    type: \"string\",\n    description:\n      \"The square of the image the card shows, as x,y,width,height shares from 0 to 1, e.g. 0.1,0,0.8,0.8 (default: chosen by ChatGPT Ads)\",\n  },\n  \"tracking-template\": {\n    type: \"string\",\n    description: \"Query string added to this card's landing page, e.g. ad_id={ad_id} — none clears\",\n  },\n  status: { type: \"string\", description: \"paused (default) | active\" },\n} as const;\n\nconst CREATE_ARGS = {\n  ...SHARED_ARGS,\n  \"ad-group-id\": { type: \"string\", description: \"adgrp_… or a staged chatgpt_temp_ ref\", required: true },\n  name: { type: \"string\", description: \"Internal ad name (3+ characters)\", required: true },\n  title: { type: \"string\", description: \"Card title, 3–50 characters\", required: true },\n  body: { type: \"string\", description: \"Card text, up to 100 characters\", required: true },\n  \"target-url\": { type: \"string\", description: \"Landing page, https://\", required: true },\n  \"image-url\": { type: \"string\", description: \"Card image, https://, at least 640 × 640 px\", required: true },\n} as const;\n\nconst UPDATE_ARGS = {\n  id: { type: \"positional\", description: \"Ad id (ad_…) or a staged chatgpt_temp_ ref\", required: true },\n  ...SHARED_ARGS,\n} as const;\n\ntype Args = Record<string, unknown>;\n\nfunction sharedPayload(args: Args): Record<string, unknown> {\n  return {\n    name: args.name,\n    title: args.title,\n    body: args.body,\n    targetUrl: args[\"target-url\"],\n    imageUrl: args[\"image-url\"],\n    imageCrop: cropArg(args[\"image-crop\"], \"--image-crop\"),\n    trackingTemplate: clearableArg(args[\"tracking-template\"]),\n    status: lowerArg(args.status),\n  };\n}\n\nexport function adCreateOp(args: Args): Record<string, unknown> {\n  return { kind: \"ad.create\", payload: compact({ ...sharedPayload(args), adGroupId: args[\"ad-group-id\"] }) };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.ads.create\",\n  description:\n    \"Stage a new chat card under a live ad group (adgrp_…) or one staged in this chat. Every new card goes through ChatGPT Ads' review after publish before it serves.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nexport const adsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new chat card (applies when the chat is published).\n\nExample:\n  baker ads chatgpt ads create --ad-group-id adgrp_123 --name \"Card A\" --title \"Solar from 0 upfront\" \\\\\n    --body \"Get a quote in two minutes.\" --target-url https://example.com/solar --image-url https://example.com/card.png`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(adCreateOp(args), REFERENCE, () => [\n      \"Review everything staged with `baker ads chatgpt draft`. It applies when the chat is published.\",\n    ]);\n  },\n});\n\nregisterSchema({\n  command: \"ads.chatgpt.ads.update\",\n  description:\n    \"Stage a change to a chat card — any of title, body, landing page, image, name or status; the rest is kept from the live card. Changing the card sends it back to review.\",\n  args: schemaArgs(UPDATE_ARGS),\n});\n\nexport const adsUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Stage a change to a chat card; what you do not pass is kept.\n\nExamples:\n  baker ads chatgpt ads update ad_123 --title \"Solar with no upfront cost\"\n  baker ads chatgpt ads update ad_123 --target-url https://example.com/solar-v2`,\n  },\n  args: UPDATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(\n      { kind: \"ad.update\", target: requireTarget(args, \"id\"), payload: compact(sharedPayload(args)) },\n      REFERENCE,\n    );\n  },\n});\n\nexport const adsPauseCommand = statusCommand(\"ad\", \"pause\", REFERENCE);\nexport const adsResumeCommand = statusCommand(\"ad\", \"resume\", REFERENCE);\nexport const adsArchiveCommand = statusCommand(\"ad\", \"archive\", REFERENCE);\n\nconst PRODUCT_ARGS = {\n  \"ad-group-id\": {\n    type: \"string\",\n    description: \"adgrp_… under a catalog campaign, or a staged chatgpt_temp_ ref\",\n    required: true,\n  },\n  name: { type: \"string\", description: \"Internal ad name (3+ characters)\", required: true },\n  title: {\n    type: \"string\",\n    description:\n      \"Title template (default {{product.title}}) — text with {{brand}}, {{product.title}}, {{product.body}}, {{product.price}}\",\n  },\n  \"tracking-template\": { type: \"string\", description: \"Query string added to each product's landing page\" },\n  status: { type: \"string\", description: \"paused (default) | active\" },\n} as const;\n\nexport function productAdCreateOp(args: Args): Record<string, unknown> {\n  return {\n    kind: \"ad.create\",\n    payload: compact({\n      format: \"product_template\",\n      adGroupId: args[\"ad-group-id\"],\n      name: args.name,\n      title: args.title,\n      trackingTemplate: args[\"tracking-template\"],\n      status: lowerArg(args.status),\n    }),\n  };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.ads.create-product\",\n  description:\n    \"Stage the product ad of a catalog ad group: one template each product fills with its own title, text, price, image and link. One per ad group.\",\n  args: schemaArgs(PRODUCT_ARGS),\n});\n\nexport const adsCreateProductCommand = defineCommand({\n  meta: {\n    name: \"create-product\",\n    description: `Stage a product ad for a catalog ad group (applies when the chat is published).\n\nExample:\n  baker ads chatgpt ads create-product --ad-group-id adgrp_123 --name \"Catalog ad\" --title \"{{brand}}: {{product.title}}\"`,\n  },\n  args: PRODUCT_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(productAdCreateOp(args), REFERENCE);\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/add-2EF7S4NK.js

@@ -0,0 +1,305 @@
+import {
+  flowDataPath,
+  isUsableStepNameKey,
+  readFlowTree,
+  requestFlowInputCall,
+  stepNameKey,
+  walkNodes,
+  writeFlowTree
+} from "./chunk-5T73MMBL.js";
+import {
+  flowCatalogEntry,
+  flowCatalogTypes,
+  flowNodeTriggers
+} from "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/add.ts
+import { randomUUID } from "crypto";
+import { defineCommand } from "citty";
+function unknownType(kind, type) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `No ${kind} type "${type}".`,
+      fix: `Known types: ${flowCatalogTypes(kind).join(", ")}. See: baker flows schema ${kind}`
+    }
+  });
+  process.exit(1);
+}
+function concrete(skeleton, replacements) {
+  return { ...structuredClone(skeleton), ...replacements };
+}
+function stepNameRefusal(nodes, name) {
+  const key = stepNameKey(name);
+  if (!isUsableStepNameKey(key)) {
+    return {
+      message: `"${name}" cannot be a step name: it becomes the constant \`${key || "(empty)"}\`, which is not a valid identifier.`,
+      fix: 'A step name becomes `export const <NAME> = \u2026` in the form\'s generated code, so it must start with a letter and hold only letters, digits, spaces and dashes. Try "Your Details" rather than "1. Your details".'
+    };
+  }
+  const clash = nodes.find((node) => typeof node.name === "string" && stepNameKey(node.name) === key);
+  if (!clash) return null;
+  return {
+    message: `This form already has a step named "${clash.name}", which collides with "${name}".`,
+    fix: `Both become the constant \`${key}\`, and the form's generated code cannot hold it twice. Pick a name that differs by more than case, spacing or punctuation.`
+  };
+}
+registerSchema({
+  command: "flows.add-node",
+  description: "Add a step to a form with a valid skeleton \u2014 fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type (see: baker flows schema node)", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id. Omit to append to the root's children.", required: false }
+  }
+});
+var addNodeCommand = defineCommand({
+  meta: {
+    name: "add-node",
+    description: 'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name "Contact Info"'
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id (default: the root)" }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const name = String(args.name).trim();
+    const entry = flowCatalogEntry("node", type) ?? unknownType("node", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const refusal = stepNameRefusal(nodes, name);
+    if (refusal) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: refusal.message.replace("This form", `"${slug}"`),
+          fix: refusal.fix
+        }
+      });
+      process.exit(1);
+    }
+    const parent = args.parent ? nodes.find((node2) => node2.id === String(args.parent)) : tree;
+    if (!parent) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.parent}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((node2) => `${node2.id} (${node2.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    const node = concrete(entry.skeleton, { id: randomUUID(), name });
+    if (!Array.isArray(parent.children)) parent.children = [];
+    parent.children.push(node);
+    writeFlowTree(slug, tree);
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },
+      hints: [
+        `Now fill in this step's \`ai\` field and its copy by editing ${flowDataPath(slug)}.`,
+        // Said on every step added, because the moment a Form's shape changes
+        // is the moment its outcome can move — and a Form nobody named an
+        // outcome for reports zero conversions rather than an error.
+        `Say what this Form counts before you finish: \`baker analytics conversions --flow ${slug}\` lists every ending already spelled as an event key, including this step's. Nothing in _data.json decides it.`,
+        ...entry.owners?.["nodeData.form.external"] === "request_flow_input" ? [
+          `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem("node", String(node.id), type))}.`
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+function resolveTrigger(node, requested) {
+  const triggers = flowNodeTriggers(node.nodeData);
+  const where = `Step "${String(node.name ?? node.id)}"${triggers.type ? ` (a ${triggers.type} step)` : ""}`;
+  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(", ")}.` : triggers.why ?? "";
+  const no = (message, fix) => ({ ok: false, message, fix });
+  if (!triggers.known) {
+    return requested ? { ok: true, triggerId: requested } : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? "");
+  }
+  if (requested) {
+    return triggers.available.includes(requested) ? { ok: true, triggerId: requested } : no(
+      `${where} never raises \`${requested}\`, so a side effect carrying it would be written, pass every check, and never run.`,
+      raises
+    );
+  }
+  return triggers.completion ? { ok: true, triggerId: triggers.completion } : no(`${where} has no trigger a side effect can answer.`, raises);
+}
+function freeSideEffectId(type, taken) {
+  for (let n = 1; ; n++) {
+    const candidate = `se-${type}-${n}`;
+    if (!taken.has(candidate)) return candidate;
+  }
+}
+function sameTrackingSideEffect(node, type, triggerId) {
+  if (flowCatalogEntry("side-effect", type)?.owners?.tagIds !== "tags") return null;
+  const effects = Array.isArray(node.sideEffects) ? node.sideEffects : [];
+  for (const raw of effects) {
+    const effect = raw;
+    if (effect?.type === type && effect.triggerId === triggerId) return effect;
+  }
+  return null;
+}
+function secondPixelHint(node, type, triggerId) {
+  const already = sameTrackingSideEffect(node, type, triggerId);
+  if (!already) return null;
+  const event = typeof already.eventName === "string" ? ` with event "${already.eventName}"` : "";
+  return `"${String(node.name ?? node.id)}" already reports \`${triggerId}\` to ${type} as "${String(already.id)}"${event}. Give this one a different event; to change that conversion, edit "${String(already.id)}" and delete this one \u2014 the same event to the same tag counts every conversion twice.`;
+}
+function pendingItem(target, nodeId, kind, sideEffectId) {
+  return {
+    target,
+    nodeId,
+    kind,
+    status: `${kind} \u2014 not configured`,
+    needsInput: true,
+    ...sideEffectId ? { sideEffectId } : {}
+  };
+}
+function configureHints(slug, nodeId, id, type, needsCard) {
+  if (!needsCard) return [];
+  return [
+    `Configure it: ${requestFlowInputCall(slug, pendingItem("sideEffect", nodeId, type, id))}. Read the destination off that call's result.`
+  ];
+}
+registerSchema({
+  command: "flows.add-side-effect",
+  description: "Add a side effect to a step with a valid skeleton \u2014 encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type (see: baker flows schema side-effect)", required: true },
+    id: { type: "string", description: "Side-effect id. Defaults to se-{type}-{n}.", required: false },
+    trigger: {
+      type: "string",
+      description: "triggerId. Defaults to the moment the step named by --node completes, which is a different id per node type. Pass this only for a non-completion moment (a HubSpot form's onFormReady, a Calendly page view, one of several iframe events); an id the step never raises is refused.",
+      required: false
+    }
+  }
+});
+var addSideEffectCommand = defineCommand({
+  meta: {
+    name: "add-side-effect",
+    description: "Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet"
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type", required: true },
+    id: { type: "string", description: "Side-effect id (default se-{type}-{n})" },
+    trigger: {
+      type: "string",
+      description: "triggerId, for a non-completion moment. Default: whatever the step named by --node raises"
+    }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const entry = flowCatalogEntry("side-effect", type) ?? unknownType("side-effect", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const node = nodes.find((candidate) => candidate.id === String(args.node));
+    if (!node) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.node}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];
+    const existing = node.sideEffects;
+    const takenIds = new Set(
+      nodes.flatMap((n) => (n.sideEffects ?? []).map((se) => String(se?.id ?? "")))
+    );
+    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);
+    if (takenIds.has(id)) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `"${slug}" already has a side effect with id "${id}".`,
+          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`
+        }
+      });
+      process.exit(1);
+    }
+    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : void 0);
+    if (!trigger.ok) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: trigger.message, ...trigger.fix ? { fix: trigger.fix } : {} }
+      });
+      process.exit(1);
+    }
+    const triggerId = trigger.triggerId;
+    const secondPixel = secondPixelHint(node, type, triggerId);
+    const sideEffect = concrete(entry.skeleton, { id, triggerId });
+    existing.push(sideEffect);
+    writeFlowTree(slug, tree);
+    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== "agent");
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },
+      hints: [
+        `Fires on \`${triggerId}\` \u2014 the moment "${String(node.name ?? node.id)}" raises. A side effect only runs when its triggerId is the one its own step raises, so this is set from the step, never from the side-effect type.`,
+        // A pixel side effect is the thing most often mistaken for "setting the
+        // conversion". It tells the ad platform; it tells Baker nothing, and a
+        // Form can fire every pixel it has while every Baker report says it
+        // converted nobody.
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          `This reports the conversion to ${type}. It does NOT make Baker count anything: what Baker counts is a named event, set with \`baker analytics conversions --flow ${slug}\`. Do both \u2014 they are two different systems asked the same question.`
+        ] : [],
+        ...secondPixel ? [secondPixel] : [],
+        ...configureHints(
+          slug,
+          String(node.id),
+          id,
+          type,
+          needsUser.some(([, owner]) => owner === "request_flow_input" || owner === "connect")
+        ),
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          "Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one."
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+export {
+  addNodeCommand,
+  addSideEffectCommand,
+  freeSideEffectId,
+  resolveTrigger,
+  sameTrackingSideEffect,
+  secondPixelHint,
+  stepNameRefusal
+};
+//# sourceMappingURL=add-2EF7S4NK.js.map

package/dist/add-2EF7S4NK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flows/add.ts"],"sourcesContent":["/**\n * `add-node` and `add-side-effect`: emit a valid skeleton and splice it in.\n *\n * The point is not to save typing — it is that the skeleton is right. A node\n * needs a fresh UUID, an explicit `condition: null`, the correct `nodeData`\n * discriminator, and — for a widget — `form.external: null` rather than an\n * invented resource. A side effect needs `encryptedConfig: null` and no\n * `oauthProviderId` key at all. Every one of those is a rule the flow-builder\n * skill used to spend prose on, and each was a real defect when got wrong.\n *\n * Deliberately scoped to creating the skeleton. Copy, conditions, autofill and\n * the `ai` field stay hand-edited: they are judgement, and a flag-based API for\n * them would be worse than JSON.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { type FlowConfigStatus, flowCatalogEntry, flowCatalogTypes, flowNodeTriggers } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  flowDataPath,\n  isUsableStepNameKey,\n  readFlowTree,\n  requestFlowInputCall,\n  stepNameKey,\n  walkNodes,\n  writeFlowTree,\n} from \"./shared.ts\";\n\ntype AnyRecord = Record<string, unknown>;\n\nfunction unknownType(kind: \"node\" | \"side-effect\", type: string): never {\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `No ${kind} type \"${type}\".`,\n      fix: `Known types: ${flowCatalogTypes(kind).join(\", \")}. See: baker flows schema ${kind}`,\n    },\n  });\n  process.exit(1);\n}\n\n/** Replace the catalog's `<placeholder>` strings with real values where we have them. */\nfunction concrete(skeleton: AnyRecord, replacements: Record<string, unknown>): AnyRecord {\n  return { ...structuredClone(skeleton), ...replacements };\n}\n\n/**\n * Whether this name can be a step in this form, and why not when it cannot.\n *\n * Both answers are about the same fact: the name becomes a constant in the\n * form's generated `_query.ts` (`export const <KEY> = \"<node id>\";`), and\n * `flow-typed.mjs` writes it without checking either that it parses or that no\n * other step already produced it. So both failures land on a generated file\n * rather than on the name that caused them — one as a syntax error, one as\n * `Duplicate flow node name` — and `_query.ts` stops regenerating for the whole\n * form. A name is minted once, here, which makes here the only cheap place to\n * say so.\n *\n * Returns `null` when the name is fine.\n */\nexport function stepNameRefusal(nodes: readonly AnyRecord[], name: string): { message: string; fix: string } | null {\n  const key = stepNameKey(name);\n  if (!isUsableStepNameKey(key)) {\n    return {\n      message: `\"${name}\" cannot be a step name: it becomes the constant \\`${key || \"(empty)\"}\\`, which is not a valid identifier.`,\n      fix: 'A step name becomes `export const <NAME> = …` in the form\\'s generated code, so it must start with a letter and hold only letters, digits, spaces and dashes. Try \"Your Details\" rather than \"1. Your details\".',\n    };\n  }\n  const clash = nodes.find((node) => typeof node.name === \"string\" && stepNameKey(node.name) === key);\n  if (!clash) return null;\n  return {\n    message: `This form already has a step named \"${clash.name}\", which collides with \"${name}\".`,\n    fix: `Both become the constant \\`${key}\\`, and the form's generated code cannot hold it twice. Pick a name that differs by more than case, spacing or punctuation.`,\n  };\n}\n\nregisterSchema({\n  command: \"flows.add-node\",\n  description:\n    \"Add a step to a form with a valid skeleton — fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type (see: baker flows schema node)\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id. Omit to append to the root's children.\", required: false },\n  },\n});\n\nexport const addNodeCommand = defineCommand({\n  meta: {\n    name: \"add-node\",\n    description:\n      'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name \"Contact Info\"',\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id (default: the root)\" },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    // Trimmed before anything reads it, because the generator does not trim:\n    // ` Contact Info ` becomes the constant `_CONTACT_INFO_`, which is legal,\n    // permanent, and not what anyone typed.\n    const name = String(args.name).trim();\n    const entry = flowCatalogEntry(\"node\", type) ?? unknownType(\"node\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n\n    const refusal = stepNameRefusal(nodes, name);\n    if (refusal) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: refusal.message.replace(\"This form\", `\"${slug}\"`),\n          fix: refusal.fix,\n        },\n      });\n      process.exit(1);\n    }\n\n    const parent = args.parent ? nodes.find((node) => node.id === String(args.parent)) : tree;\n    if (!parent) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.parent}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((node) => `${node.id} (${node.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const node = concrete(entry.skeleton, { id: randomUUID(), name });\n    if (!Array.isArray(parent.children)) parent.children = [];\n    (parent.children as AnyRecord[]).push(node);\n    writeFlowTree(slug, tree);\n\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },\n      hints: [\n        `Now fill in this step's \\`ai\\` field and its copy by editing ${flowDataPath(slug)}.`,\n        // Said on every step added, because the moment a Form's shape changes\n        // is the moment its outcome can move — and a Form nobody named an\n        // outcome for reports zero conversions rather than an error.\n        `Say what this Form counts before you finish: \\`baker analytics conversions --flow ${slug}\\` lists every ending already spelled as an event key, including this step's. Nothing in _data.json decides it.`,\n        ...(entry.owners?.[\"nodeData.form.external\"] === \"request_flow_input\"\n          ? [\n              `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem(\"node\", String(node.id), type))}.`,\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n\n/**\n * The `triggerId` a side effect on this step has to carry.\n *\n * This is the one field on a side effect that is decided by its STEP rather\n * than by its own type, and getting it wrong is silent in every direction:\n * `fireSideEffects` filters on `triggerId` equality, so a mismatch means the\n * side effect never runs — no error, no log, nothing half-written. Every\n * validator in the repo passes, because the file is valid; it just does nothing.\n *\n * Taking the skeleton's default was that failure. `SIDE_EFFECT_ENVELOPE` carries\n * `customForm.onFormSubmitted`, which is right for a `customForm` step and wrong\n * for the five widget types that raise an id of their own — so the command that\n * exists to emit a skeleton the agent cannot get wrong emitted a dead side\n * effect on any booking or embedded-form step.\n */\nexport type TriggerChoice = { ok: true; triggerId: string } | { ok: false; message: string; fix: string };\n\nexport function resolveTrigger(node: AnyRecord, requested: string | undefined): TriggerChoice {\n  const triggers = flowNodeTriggers(node.nodeData);\n  const where = `Step \"${String(node.name ?? node.id)}\"${triggers.type ? ` (a ${triggers.type} step)` : \"\"}`;\n  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(\", \")}.` : (triggers.why ?? \"\");\n  const no = (message: string, fix: string): TriggerChoice => ({ ok: false, message, fix });\n\n  // A node type the table does not cover is a table that has fallen behind, not\n  // a form that is wrong — so an explicit trigger is taken at its word there.\n  // Refusing instead would let a stale table reject a form the engine handles.\n  if (!triggers.known) {\n    return requested\n      ? { ok: true, triggerId: requested }\n      : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? \"\");\n  }\n\n  if (requested) {\n    return triggers.available.includes(requested)\n      ? { ok: true, triggerId: requested }\n      : no(\n          `${where} never raises \\`${requested}\\`, so a side effect carrying it would be written, pass every check, and never run.`,\n          raises,\n        );\n  }\n\n  return triggers.completion\n    ? { ok: true, triggerId: triggers.completion }\n    : no(`${where} has no trigger a side effect can answer.`, raises);\n}\n\n/**\n * The first `se-{type}-{n}` nobody is using.\n *\n * Counting the same-type side effects instead was wrong whenever the numbering\n * had a gap — a form holding `se-hubspotForm-1` and `se-hubspotForm-3`, or one\n * where `se-meta-1` was deleted and `se-meta-2` left behind. The count then\n * names an id that already exists and the command refuses, which is the one\n * outcome a skeleton-minting command should never produce for a form it can see\n * in full.\n */\nexport function freeSideEffectId(type: string, taken: ReadonlySet<string>): string {\n  for (let n = 1; ; n++) {\n    const candidate = `se-${type}-${n}`;\n    if (!taken.has(candidate)) return candidate;\n  }\n}\n\n/**\n * The pixel already reporting this step's moment to the same platform, if any.\n *\n * Only pixel types (those fed a tag ref) can double-count: two emails or two\n * CRMs on one step are a real need.\n */\nexport function sameTrackingSideEffect(node: AnyRecord, type: string, triggerId: string): AnyRecord | null {\n  if (flowCatalogEntry(\"side-effect\", type)?.owners?.tagIds !== \"tags\") return null;\n  const effects = Array.isArray(node.sideEffects) ? (node.sideEffects as unknown[]) : [];\n  for (const raw of effects) {\n    const effect = raw as AnyRecord | null;\n    if (effect?.type === type && effect.triggerId === triggerId) return effect;\n  }\n  return null;\n}\n\n/**\n * What a second pixel of one platform on one moment must not repeat.\n *\n * Two chats each wired GA4 `generate_lead` onto one submit and every lead\n * counted twice — but GA4 `sign_up` beside it is a second conversion, and the\n * skeleton added here has no event yet. So this warns instead of refusing;\n * the same event to the same tag is refused by the Form check at verify.\n */\nexport function secondPixelHint(node: AnyRecord, type: string, triggerId: string): string | null {\n  const already = sameTrackingSideEffect(node, type, triggerId);\n  if (!already) return null;\n  const event = typeof already.eventName === \"string\" ? ` with event \"${already.eventName}\"` : \"\";\n  return `\"${String(node.name ?? node.id)}\" already reports \\`${triggerId}\\` to ${type} as \"${String(already.id)}\"${event}. Give this one a different event; to change that conversion, edit \"${String(already.id)}\" and delete this one — the same event to the same tag counts every conversion twice.`;\n}\n\n/** The one row `requestFlowInputCall` needs, for an item this command just added unconfigured. */\nfunction pendingItem(\n  target: \"node\" | \"sideEffect\",\n  nodeId: string,\n  kind: string,\n  sideEffectId?: string,\n): FlowConfigStatus {\n  return {\n    target,\n    nodeId,\n    kind,\n    status: `${kind} — not configured`,\n    needsInput: true,\n    ...(sideEffectId ? { sideEffectId } : {}),\n  };\n}\n\nfunction configureHints(slug: string, nodeId: string, id: string, type: string, needsCard: boolean): string[] {\n  if (!needsCard) return [];\n  return [\n    `Configure it: ${requestFlowInputCall(slug, pendingItem(\"sideEffect\", nodeId, type, id))}. Read the destination off that call's result.`,\n  ];\n}\n\nregisterSchema({\n  command: \"flows.add-side-effect\",\n  description:\n    \"Add a side effect to a step with a valid skeleton — encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type (see: baker flows schema side-effect)\", required: true },\n    id: { type: \"string\", description: \"Side-effect id. Defaults to se-{type}-{n}.\", required: false },\n    trigger: {\n      type: \"string\",\n      description:\n        \"triggerId. Defaults to the moment the step named by --node completes, which is a different id per node type. Pass this only for a non-completion moment (a HubSpot form's onFormReady, a Calendly page view, one of several iframe events); an id the step never raises is refused.\",\n      required: false,\n    },\n  },\n});\n\nexport const addSideEffectCommand = defineCommand({\n  meta: {\n    name: \"add-side-effect\",\n    description:\n      \"Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet\",\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type\", required: true },\n    id: { type: \"string\", description: \"Side-effect id (default se-{type}-{n})\" },\n    trigger: {\n      type: \"string\",\n      description: \"triggerId, for a non-completion moment. Default: whatever the step named by --node raises\",\n    },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    const entry = flowCatalogEntry(\"side-effect\", type) ?? unknownType(\"side-effect\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n    const node = nodes.find((candidate) => candidate.id === String(args.node));\n    if (!node) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.node}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];\n    const existing = node.sideEffects as AnyRecord[];\n    const takenIds = new Set(\n      nodes.flatMap((n) => ((n.sideEffects as AnyRecord[] | undefined) ?? []).map((se) => String(se?.id ?? \"\"))),\n    );\n    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);\n\n    // Only an id the caller chose can still collide — the generated one is free\n    // by construction.\n    if (takenIds.has(id)) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `\"${slug}\" already has a side effect with id \"${id}\".`,\n          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : undefined);\n    if (!trigger.ok) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: trigger.message, ...(trigger.fix ? { fix: trigger.fix } : {}) },\n      });\n      process.exit(1);\n    }\n    const triggerId = trigger.triggerId;\n\n    const secondPixel = secondPixelHint(node, type, triggerId);\n\n    const sideEffect = concrete(entry.skeleton, { id, triggerId });\n    existing.push(sideEffect);\n    writeFlowTree(slug, tree);\n\n    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== \"agent\");\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },\n      hints: [\n        `Fires on \\`${triggerId}\\` — the moment \"${String(node.name ?? node.id)}\" raises. A side effect only runs when its triggerId is the one its own step raises, so this is set from the step, never from the side-effect type.`,\n        // A pixel side effect is the thing most often mistaken for \"setting the\n        // conversion\". It tells the ad platform; it tells Baker nothing, and a\n        // Form can fire every pixel it has while every Baker report says it\n        // converted nobody.\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              `This reports the conversion to ${type}. It does NOT make Baker count anything: what Baker counts is a named event, set with \\`baker analytics conversions --flow ${slug}\\`. Do both — they are two different systems asked the same question.`,\n            ]\n          : []),\n        ...(secondPixel ? [secondPixel] : []),\n        ...configureHints(\n          slug,\n          String(node.id),\n          id,\n          type,\n          needsUser.some(([, owner]) => owner === \"request_flow_input\" || owner === \"connect\"),\n        ),\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              \"Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one.\",\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n"],"mappings":"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","names":["node"]}