@koda-sl/baker-cli 0.384.0 → 0.385.0-dev.f7ef4c7e1

package/dist/pages-PMZVNVQM.js

@@ -0,0 +1,66 @@
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-2UFRHW3T.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-ZNQRDLSS.js";
+import {
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/pages.ts
+import { defineCommand } from "citty";
+function pageSelectionHints(data) {
+  if (data.length === 0) return [];
+  const accountHint = "Use a Page only with an ad account listed in its promotingAccountIds. hasPageAccessToken must be true to read instant forms; null means Meta could not check it. Form reads also require the company's lead-ads permissions.";
+  if (data.length > 1) {
+    return [
+      accountHint,
+      "MULTIPLE Pages can run ads from the selected Meta ad accounts \u2014 do NOT guess. Confirm with the user which Page an ad should run from before passing --page to `creatives create`; a wrong Page publishes the ad under the wrong brand identity and staging will not catch it."
+    ];
+  }
+  return [accountHint];
+}
+var pagesCommand = defineCommand({
+  meta: {
+    name: "pages",
+    description: `List the Facebook Pages that the selected Meta ad accounts can promote, showing which accounts can promote each Page. Every Meta ad publishes from a Page, so match its promotingAccountIds to the target account. hasPageAccessToken shows whether the connected person can also read that Page's instant forms. If more than one Page is listed, confirm the brand with the user.
+
+Examples:
+  baker ads meta pages`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/pages", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      const hints = pageSelectionHints(data);
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  pageSelectionHints,
+  pagesCommand
+};
+//# sourceMappingURL=pages-PMZVNVQM.js.map

package/dist/pages-PMZVNVQM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/pages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\n\n/** Page Meta lists as promotable by a selected ad account. */\nexport interface MetaPage {\n  id: string;\n  name?: string;\n  category?: string;\n  promotingAccountIds: string[];\n  hasPageAccessToken: boolean | null;\n}\n\n/**\n * Guide the agent to the right Page and ad-account pairing.\n */\nexport function pageSelectionHints(data: MetaPage[]): string[] {\n  if (data.length === 0) return [];\n  const accountHint =\n    \"Use a Page only with an ad account listed in its promotingAccountIds. hasPageAccessToken must be true to read instant forms; null means Meta could not check it. Form reads also require the company's lead-ads permissions.\";\n  if (data.length > 1) {\n    return [\n      accountHint,\n      \"MULTIPLE Pages can run ads from the selected Meta ad accounts — do NOT guess. Confirm with the user which Page an ad should run from before passing --page to `creatives create`; a wrong Page publishes the ad under the wrong brand identity and staging will not catch it.\",\n    ];\n  }\n  return [accountHint];\n}\n\nexport const pagesCommand = defineCommand({\n  meta: {\n    name: \"pages\",\n    description: `List the Facebook Pages that the selected Meta ad accounts can promote, showing which accounts can promote each Page. Every Meta ad publishes from a Page, so match its promotingAccountIds to the target account. hasPageAccessToken shows whether the connected person can also read that Page's instant forms. If more than one Page is listed, confirm the brand with the user.\n\nExamples:\n  baker ads meta pages`,\n  },\n  args: {\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = {};\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<MetaPage[]>(\"/api/ads/meta/pages\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      const hints = pageSelectionHints(data);\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAkBvB,SAAS,mBAAmB,MAA4B;AAC7D,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAM,cACJ;AACF,MAAI,KAAK,SAAS,GAAG;AACnB,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO,CAAC,WAAW;AACrB;AAEO,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,IACJ,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAAA,EAC1E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,CAAC;AACxC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAmB,uBAAuB,MAAM;AACnE,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAmD,GAAG;AACrE;AAAA,MACF;AACA,YAAM,QAAQ,mBAAmB,IAAI;AACrC,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/performance-ECIJJEFV.js

@@ -0,0 +1,24 @@
+import {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+} from "./chunk-YNWM426O.js";
+import "./chunk-NMGELUIA.js";
+import "./chunk-D46NOXRY.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 "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+};
+//# sourceMappingURL=performance-ECIJJEFV.js.map

package/dist/performance-ECIJJEFV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/pinterest-UDNGOWDM.js

@@ -0,0 +1,96 @@
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/pinterest.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.pinterest",
+  description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    limit: { type: "number", description: "Max results (1-20, default 5)", required: false, default: 5 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides the pin title)",
+      required: false
+    }
+  }
+});
+var pinterestCommand = defineCommand({
+  meta: {
+    name: "pinterest",
+    description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    limit: { type: "string", description: "Max results (1-20)", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.pinterest);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.pinterest}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/pinterest", body);
+      writeJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  pinterestCommand
+};
+//# sourceMappingURL=pinterest-UDNGOWDM.js.map

package/dist/pinterest-UDNGOWDM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/pinterest.ts"],"sourcesContent":["import type { ImagesPinterestRequest, ImagesPinterestResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\n\nregisterSchema({\n  command: \"images.pinterest\",\n  description:\n    \"Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing — Pinterest is unverified, trademark-bearing web content.\",\n  args: {\n    query: { type: \"string\", description: \"Search query\", required: true },\n    limit: { type: \"number\", description: \"Max results (1-20, default 5)\", required: false, default: 5 },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}, default 0) and return Baker-owned URLs on ingested hits`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides the pin title)\",\n      required: false,\n    },\n  },\n});\n\nexport const pinterestCommand = defineCommand({\n  meta: {\n    name: \"pinterest\",\n    description:\n      \"Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery — lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. ⚠ Unverified, trademark-bearing web content — inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\\n\\nExamples:\\n  baker images pinterest 'scandinavian living room'\\n  baker images pinterest 'minimalist skincare product photography' --limit 20\\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query\", required: false },\n    limit: { type: \"string\", description: \"Max results (1-20)\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}) and return Baker-owned URLs on ingested hits`,\n      required: false,\n    },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Query is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesPinterestRequest = { query };\n      if (args.limit) body.limit = Number(args.limit);\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.pinterest);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.pinterest}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n        body.autoIngest = parsed.value;\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesPinterestResponse>(\"/api/images/pinterest\", body);\n      writeJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,UAAU,aAAa,gBAAgB,UAAU,KAAK;AAAA,IACrE,OAAO,EAAE,MAAM,UAAU,aAAa,iCAAiC,UAAU,OAAO,SAAS,EAAE;AAAA,IACnG,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa,wBAAwB,gBAAgB,SAAS;AAAA,MAC9D,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,gBAAgB,UAAU,MAAM;AAAA,IAC1E,OAAO,EAAE,MAAM,UAAU,aAAa,sBAAsB,UAAU,MAAM;AAAA,IAC5E,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa,wBAAwB,gBAAgB,SAAS;AAAA,MAC9D,UAAU;AAAA,IACZ;AAAA,IACA,SAAS,EAAE,MAAM,UAAU,aAAa,0DAA0D,UAAU,MAAM;AAAA,EACpH;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,QAAQ,KAAK;AACnB,UAAI,CAAC,OAAO;AACV,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,oBAAoB,EAAE,CAAC;AAC1F,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,YAAM,OAA+B,EAAE,MAAM;AAC7C,UAAI,KAAK,MAAO,MAAK,QAAQ,OAAO,KAAK,KAAK;AAC9C,UAAI,KAAK,aAAa,MAAM,QAAW;AACrC,cAAM,SAAS,gBAAgB,KAAK,aAAa,GAAG,gBAAgB,SAAS;AAC7E,YAAI,CAAC,OAAO,IAAI;AACd,oBAAU;AAAA,YACR,IAAI;AAAA,YACJ,OAAO;AAAA,cACL,MAAM;AAAA,cACN,SAAS,OAAO;AAAA,cAChB,KAAK;AAAA,gBACH,QAAQ;AAAA,gBACR,aAAa,kCAAkC,gBAAgB,SAAS;AAAA,cAC1E;AAAA,YACF;AAAA,UACF,CAAC;AACD,kBAAQ,KAAK,CAAC;AAAA,QAChB;AACA,aAAK,aAAa,OAAO;AAAA,MAC3B;AACA,UAAI,KAAK,QAAS,MAAK,qBAAqB,KAAK;AAEjD,YAAM,OAAO,MAAM,QAAiC,yBAAyB,IAAI;AACjF,gBAAU,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IAC9B,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/pixels-OYZDGCH3.js

@@ -0,0 +1,108 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleMetaError,
+  resolveAccountIdArg,
+  todayIso
+} from "./chunk-2UFRHW3T.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-EIGXX6KI.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-ZNQRDLSS.js";
+import {
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/pixels.ts
+import { defineCommand } from "citty";
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
+
+Examples:
+  baker ads meta pixels --account-id act_123
+  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID" },
+    "pixel-id": { type: "string", description: "Pixel ID for --stats" },
+    stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
+    aggregation: {
+      type: "string",
+      description: "stats aggregation: event|browser_type|host|pixel_fire",
+      default: "event"
+    },
+    days: { type: "string", description: "Lookback days for --stats (default 7)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      if (args.stats) {
+        await runStats(args);
+        return;
+      }
+      await runList(args);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+async function runStats(args) {
+  const pixelId = args["pixel-id"];
+  if (!pixelId) {
+    handleMetaError(new Error("--pixel-id is required when --stats is set"));
+  }
+  const days = args.days ? Number(args.days) : 7;
+  if (!Number.isInteger(days) || days <= 0 || days > 90) {
+    handleMetaError(new Error("--days must be a positive integer \u2264 90"));
+  }
+  const params = {
+    "pixel-id": pixelId,
+    aggregation: args.aggregation ?? "event",
+    "start-time": daysAgoIso(days),
+    "end-time": todayIso()
+  };
+  if (args["no-cache"]) params["skip-cache"] = "true";
+  const data = await apiGet("/api/ads/meta/pixel-stats", params);
+  emit(data, args);
+}
+async function runList(args) {
+  const accountId = resolveAccountIdArg(args);
+  const params = { "account-id": accountId };
+  if (args["no-cache"]) params["skip-cache"] = "true";
+  const { pixels, restrictedFields } = await apiGet("/api/ads/meta/pixels", params);
+  emit(pixels, args, pixelWarnings(restrictedFields));
+}
+function pixelWarnings(restrictedFields) {
+  if (restrictedFields.length === 0) {
+    return [];
+  }
+  return [
+    {
+      code: "PIXEL_FIELDS_RESTRICTED",
+      message: `Meta withheld ${restrictedFields.join(", ")} for these pixels \u2014 the connected user holds no role in the Business that owns them. IDs, names, creation and last-fired times are complete; install code and setup details are not. To get them, the client assigns the pixel to the connected user in Meta Business settings \u2192 Data sources \u2192 Datasets.`
+    }
+  ];
+}
+function emit(data, args, warnings = []) {
+  const fmt = csvOrJson(args);
+  if (fmt !== "json") {
+    writeAdsOutput(data, fmt);
+    return;
+  }
+  writeAdsJson({ ok: true, data, ...warnings.length > 0 ? { warnings } : {} });
+}
+export {
+  pixelWarnings,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-OYZDGCH3.js.map

package/dist/pixels-OYZDGCH3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport type { AdsWarning } from \"../types.ts\";\nimport { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from \"./shared.ts\";\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.\n\nExamples:\n  baker ads meta pixels --account-id act_123\n  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n    \"pixel-id\": { type: \"string\", description: \"Pixel ID for --stats\" },\n    stats: { type: \"boolean\", description: \"Fetch firing stats for the pixel\" },\n    aggregation: {\n      type: \"string\",\n      description: \"stats aggregation: event|browser_type|host|pixel_fire\",\n      default: \"event\",\n    },\n    days: { type: \"string\", description: \"Lookback days for --stats (default 7)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      if (args.stats) {\n        await runStats(args);\n        return;\n      }\n      await runList(args);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nasync function runStats(args: Record<string, unknown>): Promise<void> {\n  const pixelId = args[\"pixel-id\"] as string | undefined;\n  if (!pixelId) {\n    handleMetaError(new Error(\"--pixel-id is required when --stats is set\"));\n  }\n  const days = args.days ? Number(args.days) : 7;\n  if (!Number.isInteger(days) || days <= 0 || days > 90) {\n    handleMetaError(new Error(\"--days must be a positive integer ≤ 90\"));\n  }\n  const params: Record<string, string> = {\n    \"pixel-id\": pixelId,\n    aggregation: (args.aggregation as string) ?? \"event\",\n    \"start-time\": daysAgoIso(days),\n    \"end-time\": todayIso(),\n  };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/pixel-stats\", params);\n  emit(data, args);\n}\n\nasync function runList(args: Record<string, unknown>): Promise<void> {\n  const accountId = resolveAccountIdArg(args);\n  const params: Record<string, string> = { \"account-id\": accountId };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const { pixels, restrictedFields } = await apiGet<{\n    pixels: Array<Record<string, unknown>>;\n    restrictedFields: string[];\n  }>(\"/api/ads/meta/pixels\", params);\n  emit(pixels, args, pixelWarnings(restrictedFields));\n}\n\n/**\n * A listing Meta trimmed is still a listing — IDs, names and firing times are\n * complete. Say which setup fields are missing and how to get them, so the gap\n * reads as a client-side access grant rather than as a pixel that isn't there.\n */\nexport function pixelWarnings(restrictedFields: string[]): AdsWarning[] {\n  if (restrictedFields.length === 0) {\n    return [];\n  }\n  return [\n    {\n      code: \"PIXEL_FIELDS_RESTRICTED\",\n      message:\n        `Meta withheld ${restrictedFields.join(\", \")} for these pixels — the connected user holds no role in the Business that owns them. ` +\n        \"IDs, names, creation and last-fired times are complete; install code and setup details are not. \" +\n        \"To get them, the client assigns the pixel to the connected user in Meta Business settings → Data sources → Datasets.\",\n    },\n  ];\n}\n\nfunction emit(data: Array<Record<string, unknown>>, args: Record<string, unknown>, warnings: AdsWarning[] = []): void {\n  const fmt = csvOrJson(args);\n  if (fmt !== \"json\") {\n    writeAdsOutput(data, fmt);\n    return;\n  }\n  writeAdsJson({ ok: true, data, ...(warnings.length > 0 ? { warnings } : {}) });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAOvB,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,IAClE,YAAY,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,IAClE,OAAO,EAAE,MAAM,WAAW,aAAa,mCAAmC;AAAA,IAC1E,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,MAAM,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,IAC7E,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAAA,EAC1E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,UAAI,KAAK,OAAO;AACd,cAAM,SAAS,IAAI;AACnB;AAAA,MACF;AACA,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe,SAAS,MAA8C;AACpE,QAAM,UAAU,KAAK,UAAU;AAC/B,MAAI,CAAC,SAAS;AACZ,oBAAgB,IAAI,MAAM,4CAA4C,CAAC;AAAA,EACzE;AACA,QAAM,OAAO,KAAK,OAAO,OAAO,KAAK,IAAI,IAAI;AAC7C,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,QAAQ,KAAK,OAAO,IAAI;AACrD,oBAAgB,IAAI,MAAM,6CAAwC,CAAC;AAAA,EACrE;AACA,QAAM,SAAiC;AAAA,IACrC,YAAY;AAAA,IACZ,aAAc,KAAK,eAA0B;AAAA,IAC7C,cAAc,WAAW,IAAI;AAAA,IAC7B,YAAY,SAAS;AAAA,EACvB;AACA,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,OAAO,MAAM,OAAuC,6BAA6B,MAAM;AAC7F,OAAK,MAAM,IAAI;AACjB;AAEA,eAAe,QAAQ,MAA8C;AACnE,QAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,EAAE,QAAQ,iBAAiB,IAAI,MAAM,OAGxC,wBAAwB,MAAM;AACjC,OAAK,QAAQ,MAAM,cAAc,gBAAgB,CAAC;AACpD;AAOO,SAAS,cAAc,kBAA0C;AACtE,MAAI,iBAAiB,WAAW,GAAG;AACjC,WAAO,CAAC;AAAA,EACV;AACA,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SACE,iBAAiB,iBAAiB,KAAK,IAAI,CAAC;AAAA,IAGhD;AAAA,EACF;AACF;AAEA,SAAS,KAAK,MAAsC,MAA+B,WAAyB,CAAC,GAAS;AACpH,QAAM,MAAM,UAAU,IAAI;AAC1B,MAAI,QAAQ,QAAQ;AAClB,mBAAe,MAAM,GAAG;AACxB;AAAA,EACF;AACA,eAAa,EAAE,IAAI,MAAM,MAAM,GAAI,SAAS,SAAS,IAAI,EAAE,SAAS,IAAI,CAAC,EAAG,CAAC;AAC/E;","names":[]}

package/dist/pixels-XKGNTCFX.js

@@ -0,0 +1,60 @@
+import {
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-E3HYHT7C.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-MIJAGBEP.js";
+import "./chunk-EIGXX6KI.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/pixels.ts
+import { defineCommand } from "citty";
+var CREATE_ARGS = {
+  name: { type: "string", description: "What the pixel is called in Ads Manager, e.g. withbaker.com", required: true }
+};
+function pixelCreateOp(args) {
+  return { kind: "pixel.create", payload: { name: typeof args.name === "string" ? args.name.trim() : args.name } };
+}
+registerSchema({
+  command: "ads.chatgpt.pixels.create",
+  description: "Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var pixelsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new website pixel (applies when the chat is published).
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [
+      `Define what it counts with \`baker ads chatgpt conversions create --pixel ${staged.ref} --name \u2026 --event \u2026\`.`,
+      "After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag."
+    ]);
+  }
+});
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `Website pixels \u2014 what a site installs so ChatGPT Ads can count its conversions. Read them with \`baker ads chatgpt conversions\`.
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  subCommands: { create: pixelsCreateCommand }
+});
+export {
+  pixelCreateOp,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-XKGNTCFX.js.map

package/dist/pixels-XKGNTCFX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE } from \"./shared.ts\";\nimport { schemaArgs, stageChatgptOp } from \"./write-shared.ts\";\n\n/**\n * A new website pixel, staged like every write. Its Pixel ID — what the site\n * installs — exists only after the chat publishes; a conversion staged beside it\n * counts from it by its ref.\n */\n\nconst CREATE_ARGS = {\n  name: { type: \"string\", description: \"What the pixel is called in Ads Manager, e.g. withbaker.com\", required: true },\n} as const;\n\nexport function pixelCreateOp(args: Record<string, unknown>): Record<string, unknown> {\n  return { kind: \"pixel.create\", payload: { name: typeof args.name === \"string\" ? args.name.trim() : args.name } };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.pixels.create\",\n  description:\n    \"Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nconst pixelsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new website pixel (applies when the chat is published).\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [\n      `Define what it counts with \\`baker ads chatgpt conversions create --pixel ${staged.ref} --name … --event …\\`.`,\n      \"After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag.\",\n    ]);\n  },\n});\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `Website pixels — what a site installs so ChatGPT Ads can count its conversions. Read them with \\`baker ads chatgpt conversions\\`.\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  subCommands: { create: pixelsCreateCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAW9B,IAAM,cAAc;AAAA,EAClB,MAAM,EAAE,MAAM,UAAU,aAAa,+DAA+D,UAAU,KAAK;AACrH;AAEO,SAAS,cAAc,MAAwD;AACpF,SAAO,EAAE,MAAM,gBAAgB,SAAS,EAAE,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;AACjH;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,WAAW,WAAW;AAC9B,CAAC;AAED,IAAM,sBAAsB,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,eAAe,cAAc,IAAI,GAAG,sBAAsB,aAAa,CAAC,WAAW;AAAA,MACvF,6EAA6E,OAAO,GAAG;AAAA,MACvF;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,aAAa,EAAE,QAAQ,oBAAoB;AAC7C,CAAC;","names":[]}

package/dist/plan-DZS3TVIJ.js

@@ -0,0 +1,207 @@
+import {
+  TAG_MANAGER_TIMEOUT_MS
+} from "./chunk-YTF3IVMF.js";
+import {
+  funnelStepSchema
+} from "./chunk-HAE4WWFQ.js";
+import {
+  trackingPlanErrorEnvelope
+} from "./chunk-PZ4OM2LK.js";
+import {
+  ANALYTICS_EVENT_DOORS,
+  parseEventKey
+} from "./chunk-QMLGJ5OW.js";
+import "./chunk-EDLZGTGN.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import {
+  getEnv
+} from "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/plan.ts
+import { readFileSync } from "fs";
+
+// ../api/src/analytics/trackingPlanWire.ts
+import { z as z2 } from "zod";
+
+// ../api/src/analytics/trackingPlan.ts
+import { z } from "zod";
+var text = z.string().trim().min(1).max(2e3);
+var key = z.string().trim().min(1).max(100);
+var webUrl = z.url().refine(
+  (value) => URL.canParse(value) && ["https:", "http:"].includes(new URL(value).protocol),
+  "Use a website address"
+);
+var trackingEventSchema = z.object({
+  eventKey: key.refine((value) => parseEventKey(value) !== null, "Use an existing Baker event key"),
+  name: text,
+  purpose: z.enum(["conversion", "progress", "diagnostic", "uncounted"]),
+  door: z.enum(ANALYTICS_EVENT_DOORS),
+  sourceEvent: key.optional(),
+  emitterEvidence: text.optional(),
+  status: z.enum(["prepared", "waiting", "published", "verified"]),
+  requirement: text.optional(),
+  owner: text.optional(),
+  verificationEvidence: text.optional()
+}).superRefine((event, ctx) => {
+  if (event.status === "waiting") {
+    if (!event.requirement || !event.owner)
+      ctx.addIssue({ code: "custom", message: "A waiting event needs its requirement and owner" });
+  } else if (!event.emitterEvidence) {
+    ctx.addIssue({ code: "custom", message: "A prepared event needs evidence that the source emits it" });
+  }
+  if (["published", "verified"].includes(event.status) && !event.verificationEvidence) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Published or verified tracking needs evidence; a staged tag is only prepared"
+    });
+  }
+});
+var trackingJourneySchema = z.object({
+  key,
+  name: text,
+  entryUrls: z.array(webUrl).max(50),
+  destinationUrl: webUrl,
+  strategy: z.enum(["native", "embed", "api", "link"]),
+  status: z.enum(["supported", "waiting"]),
+  requiredFields: z.array(key).max(100),
+  attribution: text,
+  acceptanceEvidence: text.optional(),
+  continuationEvidence: text.optional(),
+  requirement: text.optional(),
+  owner: text.optional()
+}).superRefine((journey, ctx) => {
+  if (journey.strategy === "link" && journey.requiredFields.length > 0)
+    ctx.addIssue({
+      code: "custom",
+      message: "A link handoff must not capture details that the destination asks for again"
+    });
+  if (journey.status === "waiting" && (!journey.requirement || !journey.owner))
+    ctx.addIssue({ code: "custom", message: "A waiting journey needs its requirement and owner" });
+  if (journey.status === "supported" && journey.strategy === "api" && (!journey.acceptanceEvidence || !journey.continuationEvidence))
+    ctx.addIssue({
+      code: "custom",
+      message: "An API replacement needs accepted-submission and continuation evidence"
+    });
+});
+var trackingPlanSchema = z.object({
+  journeys: z.array(trackingJourneySchema).max(30),
+  events: z.array(trackingEventSchema).max(100)
+}).superRefine((plan, ctx) => {
+  for (const entries of [plan.journeys.map((journey) => journey.key), plan.events.map((event) => event.eventKey)]) {
+    if (new Set(entries).size !== entries.length)
+      ctx.addIssue({ code: "custom", message: "Each journey and event must appear once" });
+  }
+});
+
+// ../api/src/analytics/trackingPlanWire.ts
+var key2 = z2.string().trim().min(1).max(100);
+var variableName = z2.string().trim().min(1).max(200).refine((value) => !/[{}<>"'\\\r\n]/.test(value), "Use a plain container variable name");
+var trackingInstallationSchema = z2.object({
+  containerId: key2,
+  baseTagName: key2,
+  folderId: key2.optional(),
+  consent: z2.enum(["auto", "strict"]).default("auto"),
+  measure: z2.enum(["campaigns", "outcomes", "all"]).default("campaigns"),
+  events: z2.array(
+    z2.object({
+      eventKey: key2.refine((value) => parseEventKey(value) !== null, "Use an existing Baker event key"),
+      tagName: key2,
+      triggerId: key2,
+      properties: z2.record(key2, variableName).default({}),
+      eventIdVariable: variableName.optional()
+    })
+  ).max(50)
+});
+var trackingPlanRequestSchema = z2.object({
+  chatId: z2.string().optional(),
+  plan: trackingPlanSchema.optional(),
+  wireConversions: z2.boolean().default(false),
+  steps: z2.array(funnelStepSchema).max(30).optional(),
+  installation: trackingInstallationSchema.optional()
+}).superRefine((request, ctx) => {
+  if (!request.plan && (request.installation || request.wireConversions || request.steps))
+    ctx.addIssue({ code: "custom", message: "Preparation needs the agreed tracking plan" });
+});
+var trackingPlanResponseSchema = z2.object({
+  ok: z2.literal(true),
+  data: z2.object({ plan: trackingPlanSchema.nullable(), staged: z2.boolean() }),
+  hints: z2.array(z2.string()).optional()
+});
+
+// src/commands/analytics/plan.ts
+import { defineCommand } from "citty";
+var description = "Start here before building a replacement Form: read the agreed journeys, event names, purposes and readiness. --json @plan.json stages the complete plan, with optional wireConversions, funnel steps and a managed Tag Manager installation. Each event records its actual emitter or the missing change and owner. Prepared is not verified. See analytics.md for the contract. Repeating installation preparation replaces its own staged tags; applies only at Publish. --full includes evidence; the default keeps the decision inventory compact.";
+var args = {
+  json: {
+    type: "string",
+    description: "Preparation request as JSON or @path; omit to read the effective plan",
+    required: false
+  },
+  full: { type: "boolean", description: "Include all journey and verification evidence", required: false }
+};
+registerSchema({ command: "analytics.plan", description, args });
+var planCommand = defineCommand({
+  meta: { name: "plan", description },
+  args,
+  run: async ({ args: args2 }) => {
+    try {
+      const input = args2.json ? JSON.parse(args2.json.startsWith("@") ? readFileSync(args2.json.slice(1), "utf8") : args2.json) : {};
+      const parsed = trackingPlanRequestSchema.parse(input);
+      const body = { ...parsed, chatId: getEnv().BAKER_CHAT_ID };
+      const response = trackingPlanResponseSchema.parse(
+        // Preparing stages the Tag Manager install, which queues behind other companies' requests.
+        await apiPost("/api/analytics/plan", body, { timeoutMs: TAG_MANAGER_TIMEOUT_MS })
+      );
+      const plan = response.data.plan;
+      writeJsonEnvelope({
+        ...response,
+        data: {
+          ...response.data,
+          plan: args2.full || !plan ? plan : {
+            journeys: plan.journeys.map(
+              ({ key: key3, name, strategy, status, destinationUrl, requirement, owner }) => ({
+                key: key3,
+                name,
+                strategy,
+                status,
+                destinationUrl,
+                requirement,
+                owner
+              })
+            ),
+            events: plan.events.map(
+              ({ eventKey, name, purpose, door, sourceEvent, status, requirement, owner }) => ({
+                eventKey,
+                name,
+                purpose,
+                door,
+                sourceEvent,
+                status,
+                requirement,
+                owner
+              })
+            )
+          }
+        }
+      });
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: trackingPlanErrorEnvelope(error) });
+      process.exitCode = 1;
+    }
+  }
+});
+export {
+  planCommand
+};
+//# sourceMappingURL=plan-DZS3TVIJ.js.map

package/dist/plan-DZS3TVIJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/plan.ts","../../api/src/analytics/trackingPlanWire.ts","../../api/src/analytics/trackingPlan.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { trackingPlanRequestSchema, trackingPlanResponseSchema } from \"@baker/api/analytics/trackingPlanWire\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { TAG_MANAGER_TIMEOUT_MS } from \"../tag-manager/shared.ts\";\nimport { trackingPlanErrorEnvelope } from \"./errorEnvelope.ts\";\n\nconst description =\n  \"Start here before building a replacement Form: read the agreed journeys, event names, purposes and readiness. --json @plan.json stages the complete plan, with optional wireConversions, funnel steps and a managed Tag Manager installation. Each event records its actual emitter or the missing change and owner. Prepared is not verified. See analytics.md for the contract. Repeating installation preparation replaces its own staged tags; applies only at Publish. --full includes evidence; the default keeps the decision inventory compact.\";\nconst args = {\n  json: {\n    type: \"string\" as const,\n    description: \"Preparation request as JSON or @path; omit to read the effective plan\",\n    required: false,\n  },\n  full: { type: \"boolean\" as const, description: \"Include all journey and verification evidence\", required: false },\n};\nregisterSchema({ command: \"analytics.plan\", description, args });\n\nexport const planCommand = defineCommand({\n  meta: { name: \"plan\", description },\n  args,\n  run: async ({ args }) => {\n    try {\n      const input: unknown = args.json\n        ? JSON.parse(args.json.startsWith(\"@\") ? readFileSync(args.json.slice(1), \"utf8\") : args.json)\n        : {};\n      const parsed = trackingPlanRequestSchema.parse(input);\n      const body = { ...parsed, chatId: getEnv().BAKER_CHAT_ID };\n      const response = trackingPlanResponseSchema.parse(\n        // Preparing stages the Tag Manager install, which queues behind other companies' requests.\n        await apiPost(\"/api/analytics/plan\", body, { timeoutMs: TAG_MANAGER_TIMEOUT_MS }),\n      );\n      const plan = response.data.plan;\n      writeJsonEnvelope({\n        ...response,\n        data: {\n          ...response.data,\n          plan:\n            args.full || !plan\n              ? plan\n              : {\n                  journeys: plan.journeys.map(\n                    ({ key, name, strategy, status, destinationUrl, requirement, owner }) => ({\n                      key,\n                      name,\n                      strategy,\n                      status,\n                      destinationUrl,\n                      requirement,\n                      owner,\n                    }),\n                  ),\n                  events: plan.events.map(\n                    ({ eventKey, name, purpose, door, sourceEvent, status, requirement, owner }) => ({\n                      eventKey,\n                      name,\n                      purpose,\n                      door,\n                      sourceEvent,\n                      status,\n                      requirement,\n                      owner,\n                    }),\n                  ),\n                },\n        },\n      });\n    } catch (error) {\n      writeJsonEnvelope({ ok: false, error: trackingPlanErrorEnvelope(error) });\n      process.exitCode = 1;\n    }\n  },\n});\n","import { z } from \"zod\";\nimport { funnelStepSchema } from \"../funnel/wire\";\nimport { parseEventKey } from \"./eventKey\";\nimport { trackingPlanSchema } from \"./trackingPlan\";\n\nconst key = z.string().trim().min(1).max(100);\nconst variableName = z\n  .string()\n  .trim()\n  .min(1)\n  .max(200)\n  .refine((value) => !/[{}<>\"'\\\\\\r\\n]/.test(value), \"Use a plain container variable name\");\nexport const trackingInstallationSchema = z.object({\n  containerId: key,\n  baseTagName: key,\n  folderId: key.optional(),\n  consent: z.enum([\"auto\", \"strict\"]).default(\"auto\"),\n  measure: z.enum([\"campaigns\", \"outcomes\", \"all\"]).default(\"campaigns\"),\n  events: z\n    .array(\n      z.object({\n        eventKey: key.refine((value) => parseEventKey(value) !== null, \"Use an existing Baker event key\"),\n        tagName: key,\n        triggerId: key,\n        properties: z.record(key, variableName).default({}),\n        eventIdVariable: variableName.optional(),\n      }),\n    )\n    .max(50),\n});\nexport type TrackingInstallation = z.infer<typeof trackingInstallationSchema>;\nexport const trackingPlanRequestSchema = z\n  .object({\n    chatId: z.string().optional(),\n    plan: trackingPlanSchema.optional(),\n    wireConversions: z.boolean().default(false),\n    steps: z.array(funnelStepSchema).max(30).optional(),\n    installation: trackingInstallationSchema.optional(),\n  })\n  .superRefine((request, ctx) => {\n    if (!request.plan && (request.installation || request.wireConversions || request.steps))\n      ctx.addIssue({ code: \"custom\", message: \"Preparation needs the agreed tracking plan\" });\n  });\nexport const trackingPlanResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({ plan: trackingPlanSchema.nullable(), staged: z.boolean() }),\n  hints: z.array(z.string()).optional(),\n});\nexport type TrackingPlanResponse = z.infer<typeof trackingPlanResponseSchema>;\n","import { z } from \"zod\";\nimport { parseEventKey } from \"./eventKey\";\nimport { describeSendEvent } from \"./sends\";\nimport { ANALYTICS_EVENT_DOORS } from \"./wire\";\n\nconst text = z.string().trim().min(1).max(2000);\nconst key = z.string().trim().min(1).max(100);\nconst webUrl = z\n  .url()\n  .refine(\n    (value) => URL.canParse(value) && [\"https:\", \"http:\"].includes(new URL(value).protocol),\n    \"Use a website address\",\n  );\n\nconst trackingEventSchema = z\n  .object({\n    eventKey: key.refine((value) => parseEventKey(value) !== null, \"Use an existing Baker event key\"),\n    name: text,\n    purpose: z.enum([\"conversion\", \"progress\", \"diagnostic\", \"uncounted\"]),\n    door: z.enum(ANALYTICS_EVENT_DOORS),\n    sourceEvent: key.optional(),\n    emitterEvidence: text.optional(),\n    status: z.enum([\"prepared\", \"waiting\", \"published\", \"verified\"]),\n    requirement: text.optional(),\n    owner: text.optional(),\n    verificationEvidence: text.optional(),\n  })\n  .superRefine((event, ctx) => {\n    if (event.status === \"waiting\") {\n      if (!event.requirement || !event.owner)\n        ctx.addIssue({ code: \"custom\", message: \"A waiting event needs its requirement and owner\" });\n    } else if (!event.emitterEvidence) {\n      ctx.addIssue({ code: \"custom\", message: \"A prepared event needs evidence that the source emits it\" });\n    }\n    if ([\"published\", \"verified\"].includes(event.status) && !event.verificationEvidence) {\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Published or verified tracking needs evidence; a staged tag is only prepared\",\n      });\n    }\n  });\nexport type TrackingEvent = z.infer<typeof trackingEventSchema>;\n\nconst trackingJourneySchema = z\n  .object({\n    key,\n    name: text,\n    entryUrls: z.array(webUrl).max(50),\n    destinationUrl: webUrl,\n    strategy: z.enum([\"native\", \"embed\", \"api\", \"link\"]),\n    status: z.enum([\"supported\", \"waiting\"]),\n    requiredFields: z.array(key).max(100),\n    attribution: text,\n    acceptanceEvidence: text.optional(),\n    continuationEvidence: text.optional(),\n    requirement: text.optional(),\n    owner: text.optional(),\n  })\n  .superRefine((journey, ctx) => {\n    if (journey.strategy === \"link\" && journey.requiredFields.length > 0)\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"A link handoff must not capture details that the destination asks for again\",\n      });\n    if (journey.status === \"waiting\" && (!journey.requirement || !journey.owner))\n      ctx.addIssue({ code: \"custom\", message: \"A waiting journey needs its requirement and owner\" });\n    if (\n      journey.status === \"supported\" &&\n      journey.strategy === \"api\" &&\n      (!journey.acceptanceEvidence || !journey.continuationEvidence)\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"An API replacement needs accepted-submission and continuation evidence\",\n      });\n  });\n\nexport const trackingPlanSchema = z\n  .object({\n    journeys: z.array(trackingJourneySchema).max(30),\n    events: z.array(trackingEventSchema).max(100),\n  })\n  .superRefine((plan, ctx) => {\n    for (const entries of [plan.journeys.map((journey) => journey.key), plan.events.map((event) => event.eventKey)]) {\n      if (new Set(entries).size !== entries.length)\n        ctx.addIssue({ code: \"custom\", message: \"Each journey and event must appear once\" });\n    }\n  });\nexport type TrackingPlan = z.infer<typeof trackingPlanSchema>;\n\nexport const TRACKING_STATUS_LABEL = {\n  prepared: \"Prepared\",\n  waiting: \"Waiting for a change\",\n  published: \"Published\",\n  verified: \"Verified\",\n} as const;\n\nexport const TRACKING_PURPOSE_LABEL = {\n  conversion: \"Conversion\",\n  progress: \"Progress\",\n  diagnostic: \"Diagnostic\",\n  uncounted: \"Not counted\",\n} as const;\n\nexport const TRACKING_DOOR_LABEL = {\n  pages: \"Baker pages\",\n  website: \"Website pixel\",\n  server: \"Your server\",\n  integrations: \"Integration\",\n} as const;\n\n/** Review the journey, event mapping, requirements and supporting evidence. */\nexport function describeTrackingPlan(plan: TrackingPlan | null | undefined): string {\n  if (!plan) return \"No tracking plan\";\n  return (\n    [\n      ...plan.journeys.map((journey) =>\n        [\n          journey.name,\n          (\n            {\n              native: \"Existing platform form\",\n              embed: \"Embedded Form\",\n              api: \"Connected submission\",\n              link: \"Link to existing Form\",\n            } as const\n          )[journey.strategy],\n          journey.status === \"supported\" ? \"Supported\" : \"Waiting for a change\",\n          journey.entryUrls.join(\", \"),\n          `to ${journey.destinationUrl}`,\n          `Fields: ${journey.requiredFields.join(\", \") || \"none\"}`,\n          journey.attribution,\n          journey.acceptanceEvidence,\n          journey.continuationEvidence,\n          journey.requirement,\n          journey.owner,\n        ]\n          .filter(Boolean)\n          .join(\" · \"),\n      ),\n      ...plan.events.map((event) =>\n        [\n          event.name,\n          `${event.sourceEvent ? `App event: ${event.sourceEvent} → ` : \"\"}Report event: ${describeSendEvent(event.eventKey)}`,\n          TRACKING_PURPOSE_LABEL[event.purpose],\n          TRACKING_DOOR_LABEL[event.door],\n          TRACKING_STATUS_LABEL[event.status],\n          event.emitterEvidence,\n          event.requirement,\n          event.owner,\n          event.verificationEvidence,\n        ]\n          .filter(Boolean)\n          .join(\" · \"),\n      ),\n    ].join(\"\\n\") || \"No journeys or events\"\n  );\n}\n"],"mappings":"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","names":["z","key","z","args","key"]}