@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/media-5SWJCRHI.js

@@ -0,0 +1,18 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/media.ts
+import { defineCommand } from "citty";
+var metaMediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: "Stage Baker library media uploads to Meta so creatives can reference them (upload), or take an image out of the account's image library (delete --image-hash). Upload publishes an ad-image hash or video id a creative binds via --image-ref/--video-ref."
+  },
+  subCommands: {
+    upload: () => import("./write-commands-5OFOD7TE.js").then((m) => m.mediaUploadCommand),
+    delete: () => import("./asset-writes-DECROLE3.js").then((m) => m.mediaDeleteCommand)
+  }
+});
+export {
+  metaMediaCommand
+};
+//# sourceMappingURL=media-5SWJCRHI.js.map

package/dist/media-WGIEUEZW.js

@@ -0,0 +1,89 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-ZICB4OI5.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MK4HCMEA.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/media.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.media",
+  description: "List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var mediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: `List media assets in the X Ads media library.
+
+Examples:
+  baker ads x media --account-id 18ce53xyz
+  baker ads x media --account-id 18ce53xyz --media-type VIDEO`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `media:${accountId}:${args["media-type"] ?? "ALL"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["media-type"]) params["media-type"] = args["media-type"];
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/media-library", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 6 * 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  mediaCommand
+};
+//# sourceMappingURL=media-WGIEUEZW.js.map

package/dist/media-sources-LFSDIPUB.js

@@ -0,0 +1,35 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/index.ts
+import { defineCommand } from "citty";
+var mediaSourcesCommand = defineCommand({
+  meta: {
+    name: "media-sources",
+    description: `Follow social accounts \u2014 the company's pages and its key people (CEO, CTO, head of sales\u2026) \u2014 on Instagram, TikTok, YouTube (videos), LinkedIn (pages and /in/ profiles) and Facebook. Their posts fill Posts (\`baker posts\`), their images and videos the libraries. A Google Drive folder is picked by the user in the chat (request_connection, platform google-drive, choose media-folder), never added here; once connected, list, sync, schedule and remove manage it like any source. Subcommands: add, update, list, sync, schedule, reset, remove.
+
+Examples:
+  baker media-sources add https://www.tiktok.com/@acme
+  baker media-sources add @acme --platform instagram --every daily
+  baker media-sources add https://www.linkedin.com/in/jane-doe --role ceo
+  baker media-sources update linkedin:in/jane-doe --role ceo --title "CEO & co-founder"
+  baker media-sources list
+  baker media-sources sync youtube:acme
+  baker media-sources schedule linkedin:acme --every monthly
+  baker media-sources reset instagram:acme        # unstick an import that never finished
+  baker media-sources remove facebook:acme
+Full guide: __tooling__/docs/tools/baker/media-sources.md`
+  },
+  subCommands: {
+    add: () => import("./add-QXI627AS.js").then((m) => m.addCommand),
+    update: () => import("./update-CADTFTYC.js").then((m) => m.updateCommand),
+    list: () => import("./list-E7JG27WS.js").then((m) => m.listCommand),
+    sync: () => import("./sync-TANGFXUN.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-XFEPEQTN.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-MVTWA3HT.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-6FXTPEB6.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  mediaSourcesCommand
+};
+//# sourceMappingURL=media-sources-LFSDIPUB.js.map

package/dist/members-KGKQQFMN.js

@@ -0,0 +1,47 @@
+import {
+  failApi
+} from "./chunk-UJTIMPEE.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/members.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.members",
+  description: "The teammates a Task can be assigned to \u2014 everyone with access to this company that the person behind this chat can see, as { userId, name, email, role }. Pass a userId or email from here to `baker actions assign --to`. Read-only.",
+  args: {}
+});
+var membersCommand = defineCommand({
+  meta: {
+    name: "members",
+    description: "Teammates a Task can be assigned to. Example: baker actions members"
+  },
+  run: async () => {
+    try {
+      const response = await apiPost("/api/actions/members", {});
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  membersCommand
+};
+//# sourceMappingURL=members-KGKQQFMN.js.map

package/dist/meta-DRDMT5X4.js

@@ -0,0 +1,124 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/index.ts
+import { defineCommand } from "citty";
+var metaCommand = defineCommand({
+  meta: {
+    name: "meta",
+    description: `Meta Marketing API \u2014 AI-first command surface (Facebook + Instagram ads).
+
+Discovery:
+  baker ads meta accounts                                \u2014 accounts in this company's connected scope
+  baker ads meta businesses                              \u2014 Business Manager IDs
+  baker ads meta pages                                   \u2014 Facebook Pages the selected ad accounts can promote (an ad's identity)
+  baker ads meta lead-forms --page-id 100635183117758    \u2014 instant (lead) forms on a Page, with lead counts
+  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json \u2014 stage a new form
+  baker ads meta leads --form-id 987654321               \u2014 the leads one form collected (contact details masked)
+
+Snapshot a running account (default = ACTIVE only):
+  baker ads meta campaigns --account-id act_123
+  baker ads meta adsets --campaign-id 6123
+  baker ads meta ads --adset-id 6123
+  baker ads meta campaigns --account-id act_123 --all-statuses        \u2014 include paused, archived
+
+Build targeting (Meta takes ids, never names \u2014 look them up first):
+  baker ads meta targeting search --account-id act_123 --q "solar energy"  \u2014 interest/behavior/employer\u2026 ids
+  baker ads meta targeting geo --account-id act_123 --q Madrid             \u2014 location keys
+  baker ads meta targeting validate --account-id act_123 --targeting-file t.json
+  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION
+  baker ads meta targeting describe --account-id act_123 --adset-id 6123   \u2014 the audience in Meta's words
+
+Identities and libraries:
+  baker ads meta instagram-accounts --account-id act_123              \u2014 the --instagram-user an ad can run as
+  baker ads meta apps --account-id act_123                            \u2014 apps it can promote
+  baker ads meta dsa-recommendations --account-id act_123             \u2014 EU DSA beneficiary/payor names
+  baker ads meta images --account-id act_123                          \u2014 image hashes already on Meta
+  baker ads meta labels --account-id act_123
+  baker ads meta catalogs --business-id 601050769212882               \u2014 product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics
+  baker ads meta page-photos upload --page-id \u2026 --image-id \u2026           \u2014 a photo on a Page, not posted (Instant Experiences)
+  baker ads meta instant-experiences --page-id 904238019441800        \u2014 full-screen pages an ad can open (collection ads)
+  baker ads meta studies --account-id act_123                         \u2014 A/B tests; --study-id for results
+  baker ads meta high-demand-periods --campaign-id 6123               \u2014 budget boosts
+  baker ads meta page-posts --page-id 904238019441800                 \u2014 posts an ad can boost; instagram-media for Instagram
+  baker ads meta block-lists --account-id act_123                     \u2014 sites and apps ads stay off (brand safety)
+  baker ads meta reach-frequency --account-id act_123                 \u2014 reach & frequency quotes; predict | reserve | cancel
+  baker ads meta account-settings --account-id act_123 --spending-limit 5000 \u2014 account name / spending limit (staged)
+  baker ads meta comments --ad-id 120211234567890                     \u2014 comments on an ad's post
+  baker ads meta account-details --account-id act_123 --show users    \u2014 people, Meta's suggestions, Advantage+ controls, playables, page sets
+
+Drill in:
+  baker ads meta account --account-id act_123                         \u2014 currency, balance, business, whether it can deliver
+  baker ads meta creatives --creative-id 9988,9989                    \u2014 creatives' copy, link and assets, several at once
+  baker ads meta audiences --name-contains buyers                     \u2014 one audience and its lookalikes
+  baker ads meta custom-conversions --account-id act_123              \u2014 the marketer's own conversions ("my conversions")
+  baker ads meta pixels --account-id act_123                          \u2014 pixel list
+  baker ads meta pixels --pixel-id 9988 --stats --days 7              \u2014 firing health
+
+Performance (the workhorse):
+  baker ads meta insights --object act_123                                                    \u2014 defaults: level=account, intent=baseline, last_7d
+  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
+  baker ads meta insights --object act_123 --level ad --intent ranking                        \u2014 flag creatives to refresh
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  \u2014 placement \xD7 age
+  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   \u2014 auto-async
+  baker ads meta insights --list-intents
+
+Automated rules (run on Meta, unattended, once published):
+  baker ads meta rules --account-id act_123                           \u2014 every rule and what it does
+  baker ads meta rules history --rule-id 1132635173044914             \u2014 what a rule did and when
+  baker ads meta rules create --name "Stop expensive ads" --apply-to ad --when "cost_per_result>20" --action pause
+
+A/B tests (Meta splits the audience between versions and calls the winner):
+  baker ads meta adsets duplicate 6123 --name "\u2026 \u2013 lookalike"         \u2014 then change ONE thing on the copy
+  baker ads meta studies create --name "Broad vs lookalike" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14
+
+Audit & review:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta preview --ad-id 9988 --ad-format MOBILE_FEED_STANDARD             \u2014 SEE the ad: displayed text + a picture
+  baker ads meta videos --ad-id 9988,9989                                         \u2014 download the ads' video files (MP4) to watch or cut
+Full guide: __tooling__/docs/tools/baker/ads-meta.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-OSVXKNSI.js").then((m) => m.accountsCommand),
+    account: () => import("./account-OUKPRB7C.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-HECSW3EL.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-UH6XEZBO.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-AEXWNBAT.js").then((m) => m.leadFormsCommand),
+    "instant-experiences": () => import("./instant-experiences-M2JYG2QS.js").then((m) => m.instantExperiencesCommand),
+    leads: () => import("./leads-AEXWNBAT.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-S62KEFVL.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-R75LSEV5.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-L6SMNOUM.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-N7V2BSOW.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-V773XHP2.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-BFMGX2M3.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-PYNK73UG.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-FRA33VZZ.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-AVNMRFQ4.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-7E4E3QPT.js").then((m) => m.previewCommand),
+    videos: () => import("./videos-AHOLXU42.js").then((m) => m.videosCommand),
+    targeting: () => import("./targeting-ZBGR2PSX.js").then((m) => m.targetingCommand),
+    "instagram-accounts": () => import("./account-assets-HOOPV5KR.js").then((m) => m.instagramAccountsCommand),
+    apps: () => import("./account-assets-HOOPV5KR.js").then((m) => m.appsCommand),
+    "dsa-recommendations": () => import("./account-assets-HOOPV5KR.js").then((m) => m.dsaRecommendationsCommand),
+    images: () => import("./account-assets-HOOPV5KR.js").then((m) => m.imagesCommand),
+    labels: () => import("./account-assets-HOOPV5KR.js").then((m) => m.labelsCommand),
+    studies: () => import("./studies-XNJXWD7I.js").then((m) => m.studiesCommand),
+    catalogs: () => import("./catalogs-G33WT5PS.js").then((m) => m.catalogsCommand),
+    "page-photos": () => import("./page-photos-PDSKTR2Z.js").then((m) => m.pagePhotosCommand),
+    "page-posts": () => import("./account-level-3QWMJTZQ.js").then((m) => m.pagePostsCommand),
+    "instagram-media": () => import("./account-level-3QWMJTZQ.js").then((m) => m.instagramMediaCommand),
+    comments: () => import("./account-level-3QWMJTZQ.js").then((m) => m.commentsCommand),
+    "account-settings": () => import("./account-level-3QWMJTZQ.js").then((m) => m.accountSettingsCommand),
+    "account-details": () => import("./account-level-3QWMJTZQ.js").then((m) => m.accountDetailsCommand),
+    "block-lists": () => import("./account-level-3QWMJTZQ.js").then((m) => m.blockListsCommand),
+    "reach-frequency": () => import("./account-level-3QWMJTZQ.js").then((m) => m.reachFrequencyCommand),
+    "high-demand-periods": () => import("./account-assets-HOOPV5KR.js").then((m) => m.highDemandPeriodsCommand),
+    rules: () => import("./rules-NRH2X4BM.js").then((m) => m.rulesCommand),
+    media: () => import("./media-5SWJCRHI.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-JYZA3BFD.js").then((m) => m.metaDraftCommand)
+  }
+});
+export {
+  metaCommand
+};
+//# sourceMappingURL=meta-DRDMT5X4.js.map

package/dist/metrics-NCAYDJNO.js

@@ -0,0 +1,152 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-IGCS3X4F.js";
+import "./chunk-BMMXYR7A.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/metrics.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.metrics",
+  description: 'Get historical market metrics for specific keywords. Returns { source: "keyword_planner_estimate", historical_metrics: [...] }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
+    location: {
+      type: "string",
+      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function stampMetricsResponse(data) {
+  return { ...data, source: PLANNER_SOURCE, historical_metrics: stampPlannerRows(data.historical_metrics ?? []) };
+}
+function handleMetricsError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var metricsCommand = defineCommand({
+  meta: {
+    name: "metrics",
+    description: `Get historical search metrics for specific keywords.
+
+Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
+
+Examples:
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes,adidas shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "seo tools" --location 2826`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    keywords: { type: "string", description: "Comma-separated keywords", required: true },
+    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+    language: { type: "string", description: "Language ID (default 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const queryContext = buildAdsQueryContext(args.location, args.language);
+    const keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
+    if (keywords.length === 0) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "At least one keyword is required" } });
+      process.exit(1);
+    }
+    if (keywords.length > 200) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Maximum 200 keywords per request" } });
+      process.exit(1);
+    }
+    const body = { customerId, keywords };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId) body.managerId = managerId;
+    if (args.location) body.locationIds = [args.location];
+    if (args.language) body.languageId = args.language;
+    const useCache = !args["no-cache"];
+    if (!useCache) body.skipCache = true;
+    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("keywords", cacheKey);
+      if (cached) {
+        warnDefaults(queryContext);
+        writeAdsJson({ ok: true, data: stampMetricsResponse(cached.data), cached: true, query_context: queryContext });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/google/keywords/metrics", body);
+      if (useCache) {
+        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      warnDefaults(queryContext);
+      const stamped = stampMetricsResponse(data);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(stamped.historical_metrics, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
+    } catch (err) {
+      handleMetricsError(err);
+    }
+  }
+});
+export {
+  metricsCommand,
+  stampMetricsResponse
+};
+//# sourceMappingURL=metrics-NCAYDJNO.js.map

package/dist/normalize-DQPKM3MG.js

@@ -0,0 +1,144 @@
+import {
+  flowDataPath,
+  listFlowSlugs,
+  readFlowTree,
+  walkNodes,
+  writeFlowTree
+} from "./chunk-AIK2HPDZ.js";
+import {
+  looksLikeUnresolvedVariable,
+  parseEmailRecipients
+} from "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/normalize.ts
+import { defineCommand } from "citty";
+var OPTIONAL_STRINGS = ["oauthProviderId"];
+var ARRAY_FIELDS = [
+  "fieldMapping",
+  "columnMapping",
+  "payloadKeys",
+  "eventParams",
+  "eventProperties",
+  "dataLayerParams",
+  "goalParams",
+  "fields",
+  "tagIds"
+];
+var ARRAY_OWNERS = ["", "body"];
+function dropUnsetOptionals(sideEffect, path) {
+  return OPTIONAL_STRINGS.flatMap((key) => {
+    if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
+    delete sideEffect[key];
+    return [{ path, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+  });
+}
+function fillNulledArrays(target, prefix, path) {
+  return ARRAY_FIELDS.flatMap((key) => {
+    if (!(key in target) || target[key] !== null) return [];
+    target[key] = [];
+    return [{ path, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+  });
+}
+function tidyEmailRecipients(sideEffect, path) {
+  if (sideEffect.type !== "email") return [];
+  const config = sideEffect.encryptedConfig;
+  if (!config || typeof config !== "object" || Array.isArray(config)) return [];
+  const raw = config.email;
+  if (typeof raw !== "string" || looksLikeUnresolvedVariable(raw)) return [];
+  const { to, invalid } = parseEmailRecipients(raw);
+  if (invalid.length > 0 || to.length === 0) return [];
+  const tidied = to.join(", ");
+  if (tidied === raw) return [];
+  config.email = tidied;
+  return [{ path, change: "tidied the recipient list's spacing and separators" }];
+}
+function sideEffectsOf(node) {
+  if (!Array.isArray(node.sideEffects)) return [];
+  return node.sideEffects.filter(
+    (sideEffect) => Boolean(sideEffect) && typeof sideEffect === "object"
+  );
+}
+function normalizeSideEffect(sideEffect, where) {
+  const path = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const arrays = ARRAY_OWNERS.flatMap((owner) => {
+    const target = owner ? sideEffect[owner] : sideEffect;
+    if (!target || typeof target !== "object") return [];
+    return fillNulledArrays(target, owner ? `${owner}.` : "", path);
+  });
+  return [...dropUnsetOptionals(sideEffect, path), ...arrays, ...tidyEmailRecipients(sideEffect, path)];
+}
+function normalizeFlowTree(tree) {
+  const changes = [];
+  for (const node of walkNodes(tree)) {
+    const where = typeof node.name === "string" && node.name ? String(node.name) : String(node.id ?? "node");
+    if (!("condition" in node)) {
+      node.condition = null;
+      changes.push({ path: where, change: "added the missing `condition: null`" });
+    }
+    for (const sideEffect of sideEffectsOf(node)) {
+      changes.push(...normalizeSideEffect(sideEffect, where));
+    }
+  }
+  return changes;
+}
+registerSchema({
+  command: "flows.normalize",
+  description: "Fix the shapes a form file is allowed to get slightly wrong: a nulled optional string, a nulled array, a missing condition. Runs automatically before a commit; you rarely need to call it.",
+  args: {
+    slug: { type: "positional", description: "Form slug. Omit to check every form.", required: false },
+    write: {
+      type: "boolean",
+      description: "Apply the fixes. Without it, reports and changes nothing",
+      required: false
+    }
+  }
+});
+var normalizeCommand = defineCommand({
+  meta: {
+    name: "normalize",
+    description: "Repair the shapes a form file is allowed to get slightly wrong. Example: baker flows normalize contact --write"
+  },
+  args: {
+    // `required: false` matters: citty makes a positional required by default,
+    // so without it the documented bare `baker flows normalize` printed a wall
+    // of usage text and exited 1 instead of checking every form.
+    slug: { type: "positional", description: "Form slug (omit for every form)", required: false },
+    write: { type: "boolean", description: "Apply the fixes" }
+  },
+  run: ({ args }) => {
+    const slugs = args.slug ? [String(args.slug)] : listFlowSlugs();
+    const forms = slugs.flatMap((slug) => {
+      const tree = readFlowTree(slug);
+      const changes = normalizeFlowTree(tree);
+      if (changes.length === 0) return [];
+      if (args.write === true) writeFlowTree(slug, tree);
+      return [{ slug, path: flowDataPath(slug), changes }];
+    });
+    const total = forms.reduce((sum, form) => sum + form.changes.length, 0);
+    writeJson({
+      ok: true,
+      data: { forms, changed: total, written: args.write === true },
+      hints: total === 0 ? ["Nothing to fix."] : args.write === true ? [`Fixed ${total} field(s).`] : [`${total} field(s) can be fixed. Re-run with --write.`]
+    });
+  }
+});
+export {
+  normalizeCommand,
+  normalizeFlowTree
+};
+//# sourceMappingURL=normalize-DQPKM3MG.js.map