@koda-sl/baker-cli 0.538.0-dev.fc2958a1d → 0.538.0

package/dist/chunk-GCFC2MNR.js

@@ -1,228 +0,0 @@
-import {
-  NUMERIC_ID_REGEX
-} from "./chunk-BNO3EFGR.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-GCFC2MNR.js.map

package/dist/chunk-GQ4D3BT6.js

@@ -1,207 +0,0 @@
-import {
-  handleConnectionError,
-  needsConnectionFix,
-  writeAdsJson
-} from "./chunk-EAHBTBVR.js";
-import {
-  LINKEDIN_SEARCH_STATUSES,
-  unsupportedLinkedinSearchStatuses
-} from "./chunk-XXS6SUVM.js";
-import {
-  ApiError
-} from "./chunk-C35UMKYG.js";
-import {
-  MissingChatIdError,
-  getEnv
-} from "./chunk-LBIF6FJY.js";
-
-// src/commands/ads/linkedin/shared.ts
-import { readFileSync } from "fs";
-var DAY_MS = 864e5;
-function handleLinkedinError(err) {
-  if (err instanceof ApiError) {
-    if (needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    if (isNoAccountsSelectedError(err.code, err.message)) {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    const explanation = explainLinkedinError(err);
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: {
-          action: explanation.action,
-          explanation: explanation.message,
-          correctedCommand: explanation.correctedCommand
-        },
-        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  writeAdsJson(unexpectedErrorEnvelope(err));
-  process.exit(1);
-}
-function unexpectedErrorEnvelope(err) {
-  if (err instanceof MissingChatIdError) {
-    return {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: {
-          action: "reject",
-          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
-        },
-        retryable: false
-      }
-    };
-  }
-  const message = err instanceof Error ? err.message : "Unexpected error";
-  return { ok: false, error: { code: "NETWORK_ERROR", message } };
-}
-function isNoAccountsSelectedError(code, message) {
-  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
-}
-function explainLinkedinError(err) {
-  const lower = err.message.toLowerCase();
-  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
-    return {
-      action: "retry_with_flag",
-      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
-      correctedCommand: void 0
-    };
-  }
-  if (err.code === "RATE_LIMITED") {
-    return {
-      action: "wait_and_retry",
-      message: "LinkedIn asked Baker to wait. A short wait is already sat out for you, so this one is long \u2014 up to LinkedIn's daily limit, which resets at midnight UTC. Don't retry in a loop: carry on with the rest of the job without this LinkedIn data, and tell the user it can be read again later."
-    };
-  }
-  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
-    return {
-      action: "reject",
-      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
-    };
-  }
-  return { action: "reject", message: err.message };
-}
-var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
-function resolveAccountIdArg(args) {
-  const fromArgs = args["account-id"] ?? args["account-urn"];
-  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
-  if (!id) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
-      }
-    });
-    process.exit(1);
-  }
-  if (!LI_ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
-      }
-    });
-    process.exit(1);
-  }
-  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
-}
-function todayIso() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-function daysAgoIso(days) {
-  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
-}
-function csvOrJson(args) {
-  return args.output ?? "json";
-}
-function statusesArgDescription(level) {
-  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
-}
-function statusFilterError(level, statuses) {
-  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
-  if (unsupported.length === 0) {
-    return null;
-  }
-  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
-  return {
-    ok: false,
-    error: {
-      code: "INVALID_STATUS",
-      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
-      fix: {
-        action: "retry_with_flag",
-        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
-      },
-      retryable: false
-    }
-  };
-}
-function resolveStatusFilter(args, level) {
-  if (args["all-statuses"]) {
-    return void 0;
-  }
-  const explicit = args.statuses;
-  if (!explicit) {
-    return ["ACTIVE"];
-  }
-  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
-  const error = statusFilterError(level, statuses);
-  if (error) {
-    writeAdsJson(error);
-    process.exit(1);
-  }
-  return statuses;
-}
-function loadTargetingArg(args) {
-  const inline = args.targeting;
-  if (inline) {
-    try {
-      return JSON.parse(inline);
-    } catch {
-      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
-    }
-  }
-  const file = args["targeting-file"];
-  if (file) {
-    try {
-      return JSON.parse(readFileSync(file, "utf-8"));
-    } catch (e) {
-      handleLinkedinError(
-        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
-      );
-    }
-  }
-  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
-}
-function exitOnInvalidArgs(issues, flagByField) {
-  const messages = issues.map((issue) => {
-    const field = String(issue.path[0] ?? "");
-    return `${flagByField[field] ?? (field || "args")}: ${issue.message}`;
-  });
-  writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: messages.join("; ") } });
-  process.exit(1);
-}
-
-export {
-  handleLinkedinError,
-  resolveAccountIdArg,
-  todayIso,
-  daysAgoIso,
-  csvOrJson,
-  statusesArgDescription,
-  resolveStatusFilter,
-  loadTargetingArg,
-  exitOnInvalidArgs
-};
-//# sourceMappingURL=chunk-GQ4D3BT6.js.map

package/dist/chunk-HMFIOE4P.js

@@ -1,63 +0,0 @@
-import {
-  sheetDelimiter,
-  targetAccountsFrom
-} from "./chunk-RM5T4MA6.js";
-
-// src/commands/accounts/targets.ts
-import { parse } from "csv-parse/sync";
-var COLUMN_OF_HEADER = {
-  domain: "domain",
-  website: "domain",
-  url: "domain",
-  companydomain: "domain",
-  companywebsite: "domain",
-  name: "name",
-  company: "name",
-  companyname: "name",
-  account: "name",
-  accountname: "name",
-  tier: "tier"
-};
-var headerKey = (header) => header.toLowerCase().replace(/[\s_-]+/g, "");
-function csvEntries(text) {
-  const rows = parse(text, {
-    bom: true,
-    columns: true,
-    delimiter: sheetDelimiter(text),
-    skip_empty_lines: true,
-    relax_column_count: true,
-    trim: true
-  });
-  const columns = Object.keys(rows[0] ?? {}).flatMap((header) => {
-    const field = COLUMN_OF_HEADER[headerKey(header)];
-    return field ? [[header, field]] : [];
-  });
-  if (!columns.some(([, field]) => field === "domain")) {
-    throw new Error(
-      `The file has no domain column (found: ${Object.keys(rows[0] ?? {}).join(", ") || "nothing"}). Name one "domain" or "website".`
-    );
-  }
-  return rows.map((row) => {
-    const entry = {};
-    for (const [header, field] of columns) entry[field] ??= row[header] ?? "";
-    return entry;
-  });
-}
-function jsonEntries(text) {
-  const parsed = JSON.parse(text);
-  if (!Array.isArray(parsed)) {
-    throw new Error('The JSON file must be an array: ["acme.com", \u2026] or [{"domain": "acme.com", "tier": 1}, \u2026].');
-  }
-  return parsed.map(
-    (item) => typeof item === "string" ? { domain: item } : typeof item === "object" && item !== null ? item : {}
-  );
-}
-function readTargetsFile(path, text) {
-  const entries = path.toLowerCase().endsWith(".json") ? jsonEntries(text) : csvEntries(text);
-  return targetAccountsFrom(entries);
-}
-
-export {
-  readTargetsFile
-};
-//# sourceMappingURL=chunk-HMFIOE4P.js.map