@koda-sl/baker-cli 0.499.0 → 0.501.0-dev.6e96f50b9

package/dist/chunk-ANLLW3KZ.js

@@ -1,228 +0,0 @@
-import {
-  NUMERIC_ID_REGEX
-} from "./chunk-ERSL4WZT.js";
-
-// ../api/src/ads-google/change-history.ts
-var CHANGE_SCOPES = ["detail", "summary"];
-var CHANGE_SCOPE_MAX_DAYS = {
-  detail: 30,
-  summary: 90
-};
-var DEFAULT_CHANGE_DAYS = 7;
-var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
-function isChangeLookbackWithinReach(days, scope) {
-  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
-}
-
-// ../api/src/ads-google/keyword-planning.ts
-import { z } from "zod";
-var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-var micros = z.number().int().positive();
-var FORECAST_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
-var googleForecastBiddingSchema = z.discriminatedUnion("strategy", [
-  z.object({ strategy: z.literal("MANUAL_CPC"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),
-  z.object({
-    strategy: z.literal("MAXIMIZE_CLICKS"),
-    dailyTargetSpendMicros: micros,
-    maxCpcBidCeilingMicros: micros.optional()
-  }),
-  z.object({ strategy: z.literal("MAXIMIZE_CONVERSIONS"), dailyTargetSpendMicros: micros })
-]);
-var googleKeywordForecastRequestSchema = z.object({
-  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z.string().optional(),
-  /** One forecast ad group per entry; most forecasts are a single group. */
-  adGroups: z.array(
-    z.object({
-      keywords: z.array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) })).min(1)
-    })
-  ).min(1),
-  locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),
-  languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),
-  bidding: googleForecastBiddingSchema,
-  /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */
-  startDate: z.string().regex(ISO_DATE).optional(),
-  endDate: z.string().regex(ISO_DATE).optional(),
-  currencyCode: z.string().length(3).optional()
-}).refine((body) => body.startDate === void 0 === (body.endDate === void 0), {
-  message: "Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)",
-  path: ["endDate"]
-});
-var KEYWORD_FORECAST_SOURCE = "keyword_planner_forecast";
-var googleKeywordForecastResponseSchema = z.object({
-  source: z.literal(KEYWORD_FORECAST_SOURCE),
-  period: z.object({ startDate: z.string(), endDate: z.string() }),
-  forecast_clicks: z.number().nullable(),
-  forecast_cost_micros: z.number().nullable(),
-  forecast_conversions: z.number().nullable(),
-  forecast_average_cpc_micros: z.number().nullable(),
-  forecast_average_cpa_micros: z.number().nullable()
-});
-var googleAdGroupThemesRequestSchema = z.object({
-  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z.string().optional(),
-  keywords: z.array(z.string().trim().min(1)).min(1),
-  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */
-  adGroups: z.array(z.string().min(1)).min(1)
-});
-var googleAdGroupThemesResponseSchema = z.object({
-  suggestions: z.array(
-    z.object({
-      keyword: z.string(),
-      suggested_keyword: z.string(),
-      match_type: z.string(),
-      ad_group: z.string(),
-      campaign: z.string()
-    })
-  ),
-  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() }))
-});
-
-// ../api/src/ads-google/url-options.ts
-import { z as z2 } from "zod";
-var URL_OPTION_LEVELS = ["account", "campaign", "ad_group", "ad"];
-var googleUrlOptionValueSchema = z2.discriminatedUnion("state", [
-  z2.object({ state: z2.literal("set"), value: z2.string() }),
-  z2.object({ state: z2.literal("not_set") }),
-  z2.object({ state: z2.literal("not_read"), reason: z2.string() })
-]);
-var googleUrlOptionsRequestSchema = z2.object({
-  customerId: z2.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z2.string().optional(),
-  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */
-  full: z2.boolean().optional(),
-  skipCache: z2.boolean().optional()
-});
-var googleUrlOptionsCampaignSchema = z2.object({
-  id: z2.string(),
-  name: z2.string(),
-  status: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsAdGroupSchema = z2.object({
-  id: z2.string(),
-  name: z2.string(),
-  status: z2.string(),
-  campaign_id: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsAdSchema = z2.object({
-  id: z2.string(),
-  status: z2.string(),
-  ad_group_id: z2.string(),
-  campaign_id: z2.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsResponseSchema = z2.object({
-  customer_id: z2.string(),
-  account: z2.object({
-    level: z2.literal("account"),
-    read: z2.boolean(),
-    final_url_suffix: googleUrlOptionValueSchema,
-    tracking_url_template: googleUrlOptionValueSchema
-  }),
-  campaigns: z2.object({
-    level: z2.literal("campaign"),
-    read: z2.boolean(),
-    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */
-    campaigns_read: z2.number().int().nonnegative(),
-    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */
-    campaigns_without_override: z2.number().int().nonnegative(),
-    overrides: z2.array(googleUrlOptionsCampaignSchema),
-    /** Compact mode only: campaigns read but not listed because they carry no override. */
-    omitted: z2.number().int().nonnegative()
-  }),
-  /**
-   * Ad groups and ads that carry an override of their own — read by asking Google only for the
-   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.
-   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.
-   * `truncated` means more overriding entities exist than one page listed.
-   */
-  ad_groups: z2.object({
-    level: z2.literal("ad_group"),
-    read: z2.boolean(),
-    overrides: z2.array(googleUrlOptionsAdGroupSchema),
-    truncated: z2.boolean()
-  }),
-  ads: z2.object({
-    level: z2.literal("ad"),
-    read: z2.boolean(),
-    overrides: z2.array(googleUrlOptionsAdSchema),
-    truncated: z2.boolean()
-  }),
-  /** Levels this command could not read. Nothing here may be reported as "not configured". */
-  levels_not_read: z2.array(z2.object({ level: z2.enum(URL_OPTION_LEVELS), reason: z2.string() }))
-});
-var ACCOUNT_URL_OPTIONS_LOCATION = "Google Ads UI \u2192 Admin \u2192 Account settings \u2192 Tracking (account-level tracking template and final URL suffix)";
-var ACCOUNT_URL_OPTIONS_STAGE_COMMAND = 'baker ads google account update --customer-id <id> --final-url-suffix "utm_agency=baker"';
-function isSet(value) {
-  return value.state === "set";
-}
-function entityOverrideHints(label, plural, field, level) {
-  if (!level.read) return [];
-  const hints = [];
-  const overriding = level.overrides.filter((entity) => isSet(entity.final_url_suffix));
-  if (overriding.length > 0) {
-    const named = overriding.slice(0, 5).map((entity) => entity.name || entity.id).join(", ");
-    hints.push(
-      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? ", \u2026" : ""}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`
-    );
-  }
-  if (level.truncated) {
-    hints.push(
-      `More ${plural} override the URL options than one page lists \u2014 read them all with \`baker ads google query\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`
-    );
-  }
-  return hints;
-}
-function urlOptionsHints(report) {
-  const hints = [];
-  const { account, campaigns } = report;
-  if (!account.read) {
-    hints.push(
-      "The account level did NOT read \u2014 its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging."
-    );
-  } else if (account.final_url_suffix.state === "not_set") {
-    hints.push(
-      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=\u2026) belongs at the account level so it reaches every ad \u2014 stage it with \`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`
-    );
-  }
-  if (!campaigns.read) {
-    hints.push(
-      "Campaign-level URL options did NOT read \u2014 do not report that no campaign overrides exist. Re-run before concluding."
-    );
-  } else {
-    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));
-    if (overriding.length > 0) {
-      const named = overriding.slice(0, 5).map((c) => c.name || c.id).join(", ");
-      hints.push(
-        `A campaign's final URL suffix REPLACES the account-level one for that campaign \u2014 it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? ", \u2026" : ""}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`
-      );
-    }
-  }
-  hints.push(...entityOverrideHints("ad group", "ad groups", "ad_group", report.ad_groups));
-  hints.push(...entityOverrideHints("ad", "ads", "ad_group_ad.ad", report.ads));
-  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== "account");
-  if (overridingLevelsNotRead.length > 0) {
-    hints.push(
-      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(", ")}. A suffix set there still wins over the levels above it.`
-    );
-  }
-  if (campaigns.omitted > 0) {
-    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed \u2014 pass --full.`);
-  }
-  return hints;
-}
-
-export {
-  CHANGE_SCOPES,
-  CHANGE_SCOPE_MAX_DAYS,
-  DEFAULT_CHANGE_DAYS,
-  isChangeLookbackWithinReach,
-  googleKeywordForecastRequestSchema,
-  urlOptionsHints
-};
-//# sourceMappingURL=chunk-ANLLW3KZ.js.map

package/dist/chunk-BBBWMD5R.js

@@ -1,274 +0,0 @@
-import {
-  chatgptDraftOpInputSchema,
-  chatgptFailure
-} from "./chunk-EBEZFAUH.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import {
-  requireChatId
-} from "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-
-// src/commands/ads/chatgpt/write-shared.ts
-import { defineCommand } from "citty";
-function fail(envelope) {
-  writeJsonEnvelope({ ...envelope });
-  process.exit(1);
-}
-function failWriteValidation(message) {
-  fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: { action: "add_required_field", explanation: `${message}. Nothing was staged.` },
-      retryable: false
-    }
-  });
-}
-function writeFailure(err, reference) {
-  if (!(err instanceof ApiError) && err instanceof Error && err.message.includes("BAKER_CHAT_ID")) {
-    return {
-      ok: false,
-      error: {
-        code: "NO_CHAT",
-        message: err.message,
-        fix: {
-          action: "reject",
-          explanation: "ChatGPT Ads changes are staged on a chat and apply when it is published; run this from the chat."
-        },
-        retryable: false
-      }
-    };
-  }
-  return chatgptFailure(err, reference);
-}
-function decimalPlaces(value) {
-  const [mantissa, exponent] = String(value).trim().split(/e/i);
-  const written = (mantissa?.split(".")[1] ?? "").length;
-  return Math.max(0, written - (exponent ? Number(exponent) : 0));
-}
-function parseChatgptMoney(value) {
-  if (value === void 0 || value === "") {
-    return { ok: true, micros: void 0 };
-  }
-  const amount = Number(value);
-  if (!Number.isFinite(amount) || amount <= 0) {
-    return { ok: false, reason: "must be a positive amount, for example 12.50" };
-  }
-  if (decimalPlaces(value) > 6) {
-    return { ok: false, reason: "is finer than ChatGPT Ads can express" };
-  }
-  return { ok: true, micros: Math.round(amount * 1e6) };
-}
-function microsFromArg(value, flag) {
-  const parsed = parseChatgptMoney(value);
-  if (!parsed.ok) {
-    failWriteValidation(`${flag} ${parsed.reason}`);
-  }
-  return parsed.micros;
-}
-function csvArg(value) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    return void 0;
-  }
-  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
-  return parts.length > 0 ? parts : void 0;
-}
-function schemaArgs(args) {
-  return Object.fromEntries(
-    Object.entries(args).map(([name, arg]) => [
-      name,
-      {
-        type: arg.type,
-        description: arg.description,
-        required: arg.required === true
-      }
-    ])
-  );
-}
-function lowerArg(value) {
-  return typeof value === "string" && value.trim() !== "" ? value.trim().toLowerCase() : void 0;
-}
-function lowerCsvArg(value) {
-  return csvArg(value)?.map((part) => part.toLowerCase());
-}
-function compact(payload) {
-  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0 && value !== ""));
-}
-function requireTarget(args, name) {
-  const value = args[name];
-  if (typeof value !== "string" || value.trim().length === 0) {
-    failWriteValidation(`${name} is required`);
-  }
-  return value.trim();
-}
-function requireTargets(args, name) {
-  const ids = csvArg(args[name]);
-  if (!ids) {
-    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
-  }
-  return ids;
-}
-function preflight(raw) {
-  const parsed = chatgptDraftOpInputSchema.safeParse(raw);
-  if (parsed.success) {
-    return parsed.data;
-  }
-  const fields = parsed.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
-  const message = fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; ");
-  return fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: {
-        action: "retry_with_modified_query",
-        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is as it was before this call."
-      },
-      retryable: false
-    }
-  });
-}
-async function postStage(chatId, op) {
-  return await apiPost("/api/ads/chatgpt/draft/stage", { chatId, op });
-}
-async function stageChatgptOp(raw, reference, hintsFor) {
-  const op = preflight(raw);
-  try {
-    const staged = await postStage(requireChatId(), op);
-    const hints = hintsFor?.(staged) ?? [];
-    writeJsonEnvelope({ ok: true, data: staged, ...hints.length > 0 ? { hints } : {} });
-  } catch (err) {
-    fail(writeFailure(err, reference));
-  }
-}
-async function stageChatgptOps(raws, reference) {
-  if (raws.length === 1 && raws[0]) {
-    await stageChatgptOp(raws[0], reference);
-    return;
-  }
-  const ops = raws.map(preflight);
-  const staged = [];
-  try {
-    const chatId = requireChatId();
-    for (const op of ops) {
-      staged.push(await postStage(chatId, op));
-    }
-    writeJsonEnvelope({ ok: true, data: staged });
-  } catch (err) {
-    const failure = writeFailure(err, reference);
-    if (staged.length > 0) {
-      failure.error.message = `${failure.error.message} (already staged: ${staged.map((s) => s.summary).join("; ")})`;
-    }
-    fail(failure);
-  }
-}
-function clearableCsvArg(value) {
-  return typeof value === "string" && value.trim().toLowerCase() === "none" ? [] : csvArg(value);
-}
-function clearableArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  return value.trim().toLowerCase() === "none" ? null : value.trim();
-}
-function cropArg(value, flag) {
-  const parts = csvArg(value);
-  if (!parts) {
-    return void 0;
-  }
-  const numbers = parts.map(Number);
-  const [x, y, width, height] = numbers;
-  if (numbers.length !== 4 || numbers.some(Number.isNaN) || x === void 0 || y === void 0 || width === void 0 || height === void 0) {
-    failWriteValidation(`${flag} takes four shares of the image, x,y,width,height \u2014 e.g. 0.1,0,0.8,0.8`);
-  }
-  return { x, y, width, height };
-}
-var STATUS_OF = {
-  pause: "paused",
-  resume: "active",
-  archive: "archived"
-};
-function statusOps(entity, ids, status) {
-  return ids.map((id) => ({ kind: `${entity}.update`, target: id, payload: { status } }));
-}
-var STATUS_NOUN = {
-  campaign: { command: "campaigns", plural: "campaigns", example: "cmpn_123,cmpn_456" },
-  adGroup: { command: "ad-groups", plural: "ad groups", example: "adgrp_123,adgrp_456" },
-  ad: { command: "ads", plural: "cards", example: "ad_123,ad_456" }
-};
-var STATUS_DOING = { pause: "pausing", resume: "resuming", archive: "archiving" };
-function statusCommand(entity, verb, reference) {
-  const noun = STATUS_NOUN[entity];
-  const args = {
-    ids: { type: "positional", description: `${noun.plural} ids, comma-separated`, required: true }
-  };
-  const forGood = verb === "archive" ? ` Archiving is for good: ChatGPT Ads cannot bring archived ${noun.plural} back, and their results stay in reports. Pause instead unless the user asked to archive.` : "";
-  registerSchema({
-    command: `ads.chatgpt.${noun.command}.${verb}`,
-    description: `Stage ${STATUS_DOING[verb]} one or more ChatGPT Ads ${noun.plural}. Pass every id in one call.${forGood}`,
-    args: schemaArgs(args)
-  });
-  return defineCommand({
-    meta: {
-      name: verb,
-      description: `Stage ${STATUS_DOING[verb]} ${noun.plural}.${forGood}
-
-Example:
-  baker ads chatgpt ${noun.command} ${verb} ${noun.example}`
-    },
-    args,
-    run: async ({ args: parsed }) => {
-      await stageChatgptOps(statusOps(entity, requireTargets(parsed, "ids"), STATUS_OF[verb]), reference);
-    }
-  });
-}
-function productFiltersArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  if (value.trim().toLowerCase() === "none") {
-    return [];
-  }
-  return value.split(";").map((condition) => condition.trim()).filter(Boolean).map((condition) => {
-    const match = /^(\S+)\s+(\S+)\s+(.+)$/.exec(condition);
-    if (!match?.[1] || !match[2] || !match[3]) {
-      failWriteValidation(
-        `"${condition}" is not a product filter \u2014 write field operator values, e.g. price lte 5000`
-      );
-    }
-    return {
-      field: match[1],
-      operator: match[2].toLowerCase(),
-      values: match[3].split("|").map((part) => part.trim()).filter(Boolean)
-    };
-  });
-}
-
-export {
-  failWriteValidation,
-  microsFromArg,
-  csvArg,
-  schemaArgs,
-  lowerArg,
-  lowerCsvArg,
-  compact,
-  requireTarget,
-  requireTargets,
-  stageChatgptOp,
-  stageChatgptOps,
-  clearableCsvArg,
-  clearableArg,
-  cropArg,
-  statusCommand,
-  productFiltersArg
-};
-//# sourceMappingURL=chunk-BBBWMD5R.js.map