@koda-sl/baker-cli 0.489.0-dev.63e618e80 → 0.490.0

package/dist/companies-CACKHSY5.js

@@ -1,195 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError
-} from "./chunk-Y2GH4YWA.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import {
-  linkedinCompaniesRequestSchema
-} from "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import {
-  getEnv
-} from "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/companies.ts
-import { defineCommand } from "citty";
-var COMPANIES_PAGE_SIZE = 100;
-var COMPANIES_TIMEOUT_MS = 18e4;
-var CSV_FIELDS = [
-  "org",
-  "name",
-  "domain",
-  "domainSource",
-  "impressions",
-  "clicks",
-  "engagements",
-  "costLocal",
-  "videoViews",
-  "months",
-  "campaigns"
-];
-function companiesHints(data, request) {
-  const hints = [];
-  if (data.rows.length === 0) {
-    hints.push(
-      `No company shows up for ${data.query.start} to ${data.query.end}${data.query.minImpressions > 0 ? ` at --min-impressions ${data.query.minImpressions}` : ""}. LinkedIn reports companies 12-24h late and leaves out any with fewer than 3 events in a month, so a small or new campaign can have none yet. Try a longer period (--last-months 24), drop --min-impressions, or check the campaigns delivered with \`baker ads linkedin analytics\`.`
-    );
-    return hints;
-  }
-  const withDomain = data.rows.filter((row) => row.domain !== void 0).length;
-  if (withDomain > 0) {
-    hints.push(
-      `${withDomain} companies came back with a website domain \u2014 if HubSpot is connected, \`baker hubspot companies search --domains <domain,domain,\u2026> --with-deals\` (up to 100 per call) shows which are already accounts and which have deals.`
-    );
-  } else if (!request.withDomains && data.rows.length > 0) {
-    hints.push(
-      "Add --with-domains to get each company's website domain, ready for matching against your customer list."
-    );
-  }
-  if (data.totalCompanies > data.rows.length) {
-    const page = data.page ?? 1;
-    const first = (page - 1) * COMPANIES_PAGE_SIZE + 1;
-    const last = first + data.rows.length - 1;
-    const next = last < data.totalCompanies ? ` \u2014 --page ${page + 1} for the next ${COMPANIES_PAGE_SIZE}, ` : " \u2014 ";
-    hints.push(
-      `Showing companies ${first}-${last} of ${data.totalCompanies.toLocaleString("en")}, most engaged first${next}--full for all, or --min-impressions to trim the tail.`
-    );
-  }
-  if (data.query.by === "none" && data.rows.length > 0) {
-    hints.push("--by month shows when each company warmed up; --by campaign shows which campaigns reached it.");
-  }
-  return hints;
-}
-function csvList(raw) {
-  if (typeof raw !== "string") return void 0;
-  const items = raw.split(",").map((s) => s.trim()).filter(Boolean);
-  return items.length > 0 ? items : void 0;
-}
-var FLAG_OF_FIELD = {
-  accountId: "--account-id",
-  campaignIds: "--campaign-id",
-  lastMonths: "--last-months",
-  start: "--start",
-  end: "--end",
-  by: "--by",
-  minImpressions: "--min-impressions",
-  page: "--page"
-};
-function flagOf(field) {
-  return FLAG_OF_FIELD[field.split(".")[0] ?? ""] ?? (field || "args");
-}
-function optionalNumber(raw) {
-  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
-}
-function bareAccountId(raw) {
-  return raw?.startsWith("urn:") ? raw.split(":").pop() : raw;
-}
-var companiesCommand = defineCommand({
-  meta: {
-    name: "companies",
-    description: `Which companies your LinkedIn ads reached \u2014 one row per company over the whole period, most engaged first.
-
-Start here for "which companies are our ads warming", ABM reporting, or building a warm-account list.
-Rows: {org, name, impressions, clicks, engagements, costLocal}. Defaults: the last 12 calendar
-months, the only selected ad account, 100 companies a page (--page 2 for the next, --full for all).
-
-Examples:
-  baker ads linkedin companies                                          # last 12 months, whole account
-  baker ads linkedin companies --page 2                                 # the next 100 companies
-  baker ads linkedin companies --by month --min-impressions 50          # when each company warmed up
-  baker ads linkedin companies --campaign-id 333728193,810055513 --by campaign
-  baker ads linkedin companies --with-domains --output csv              # + website domain, for CRM matching
-  baker ads linkedin companies --last-months 3 --stats                  # + how complete LinkedIn's data is
-
-LinkedIn reports companies 12-24h late and leaves out any company with fewer than 3 events in a month,
-so small companies are undercounted. engagements = LinkedIn's totalEngagements.`
-  },
-  args: {
-    "account-id": {
-      type: "string",
-      description: "Ad account id (numeric or urn:li:sponsoredAccount:N). Default: the only selected account"
-    },
-    "campaign-id": { type: "string", description: "Comma-separated campaign ids \u2014 read only these campaigns" },
-    "last-months": { type: "string", description: "Calendar months back, including this one (1-24, default 12)" },
-    start: { type: "string", description: "Start date YYYY-MM-DD (instead of --last-months)" },
-    end: { type: "string", description: "End date YYYY-MM-DD (default today)" },
-    by: { type: "string", description: "none | month | campaign \u2014 break each company down (default none)" },
-    "with-domains": { type: "boolean", description: "Add each company's website domain and domainSource" },
-    "min-impressions": { type: "string", description: "Leave out companies under N impressions over the period" },
-    full: { type: "boolean", description: "Every company (not just a page of 100), plus videoViews" },
-    page: {
-      type: "string",
-      description: "Which page of 100 companies, most engaged first (default 1); totalCompanies counts them all"
-    },
-    stats: { type: "boolean", description: "Add read-quality stats: row counts, cost/reach/domain coverage" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const input = {
-      accountId: bareAccountId(args["account-id"] || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID),
-      campaignIds: csvList(args["campaign-id"]),
-      lastMonths: optionalNumber(args["last-months"]),
-      start: args.start,
-      end: args.end,
-      by: args.by,
-      withDomains: Boolean(args["with-domains"]),
-      minImpressions: optionalNumber(args["min-impressions"]),
-      full: Boolean(args.full),
-      page: optionalNumber(args.page),
-      stats: Boolean(args.stats),
-      skipCache: Boolean(args["no-cache"])
-    };
-    const parsed = linkedinCompaniesRequestSchema.safeParse(input);
-    const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
-    if (!parsed.success || formatRefusal !== null) {
-      const issues = parsed.success ? [] : parsed.error.issues;
-      const messages = issues.map((issue) => `${flagOf(issue.path.join("."))}: ${issue.message}`);
-      writeAdsJson({
-        ok: false,
-        error: { code: "INVALID_ARGS", message: [...messages, ...formatRefusal ? [formatRefusal] : []].join("; ") }
-      });
-      process.exit(1);
-    }
-    try {
-      const { data } = await apiPost(
-        "/api/ads/linkedin/companies",
-        input,
-        { timeoutMs: COMPANIES_TIMEOUT_MS }
-      );
-      const hints = companiesHints(data, parsed.data);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        const notes = [...data.warnings.map((w) => `${w.code}: ${w.message}`), ...hints];
-        writeAdsOutput(data.rows, fmt, CSV_FIELDS, notes);
-        return;
-      }
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  companiesCommand,
-  companiesHints
-};
-//# sourceMappingURL=companies-CACKHSY5.js.map

package/dist/complete-IHLTYFT2.js

@@ -1,81 +0,0 @@
-import {
-  failApi,
-  failValidation,
-  isTempId,
-  writeOk
-} from "./chunk-6VZHOXP6.js";
-import {
-  ACTION_COMPLETE_NOTE_MIN
-} from "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import {
-  requireChatId
-} from "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/actions/complete.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "actions.complete",
-  description: "Stage completion of an action (it was done). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is required and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Don't use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
-  args: {
-    id: { type: "string", description: "Action ID or temp ID", required: true },
-    note: {
-      type: "string",
-      description: "REQUIRED. Detailed description of what you did to resolve this: what changed, where, and the outcome. This is the durable, client-facing record shown by `baker actions log`.",
-      required: true
-    }
-  }
-});
-var completeCommand = defineCommand({
-  meta: {
-    name: "complete",
-    description: "Stage completion of an action. Accepts real IDs (claimed) or temp IDs (same draft). Example: baker actions complete <id>"
-  },
-  args: {
-    id: { type: "positional", description: "Action ID or temp ID", required: false },
-    "action-id": { type: "string", description: "Action ID or temp ID", required: false },
-    note: {
-      type: "string",
-      description: "REQUIRED. What you did to resolve this: what changed, where, and the outcome.",
-      required: false
-    }
-  },
-  run: async ({ args }) => {
-    try {
-      const id = args.id || args["action-id"];
-      if (!id) {
-        failValidation("Action ID is required.");
-      }
-      if (!isTempId(id)) {
-        validateConvexId(id);
-      }
-      const note = args.note?.trim() ?? "";
-      if (note.length < ACTION_COMPLETE_NOTE_MIN) {
-        failValidation(
-          `--note is required and must describe what you did (\u2265${ACTION_COMPLETE_NOTE_MIN} chars): what changed, where, and the outcome. This becomes the client-facing record surfaced by \`baker actions log\`.`
-        );
-      }
-      const chatId = requireChatId();
-      await apiPost("/api/actions/complete", { chatId, actionRef: id, note });
-      writeOk();
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-export {
-  completeCommand
-};
-//# sourceMappingURL=complete-IHLTYFT2.js.map

package/dist/connect-J722BTO4.js

@@ -1,42 +0,0 @@
-import {
-  attachDestination,
-  attachSettings,
-  attachStep,
-  connectCommand,
-  copyDestination,
-  destinationRefusal,
-  restatableTargets,
-  sealRequestFor,
-  targetsFor,
-  unpickedSteps,
-  unwiredHubspotForms,
-  unwiredSideEffects
-} from "./chunk-6KULDLLR.js";
-import "./chunk-5562QFVB.js";
-import "./chunk-C6BFE4X2.js";
-import "./chunk-6VZHOXP6.js";
-import "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-export {
-  attachDestination,
-  attachSettings,
-  attachStep,
-  connectCommand,
-  copyDestination,
-  destinationRefusal,
-  restatableTargets,
-  sealRequestFor,
-  targetsFor,
-  unpickedSteps,
-  unwiredHubspotForms,
-  unwiredSideEffects
-};
-//# sourceMappingURL=connect-J722BTO4.js.map

package/dist/conversation-HRNJJJW5.js

@@ -1,93 +0,0 @@
-import {
-  csvOrJson,
-  daysAgoIso,
-  handleLinkedinError,
-  todayIso
-} from "./chunk-Y2GH4YWA.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/conversation.ts
-import { defineCommand } from "citty";
-var conversationCommand = defineCommand({
-  meta: {
-    name: "conversation",
-    description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.
-
-Returns one row per CONVERSATION_NODE_BUTTON pivot, sorted by clicks desc.
-Use this to A/B test button copy and the cascade tree.
-
-Examples:
-  baker ads linkedin conversation --campaign-id 1234
-  baker ads linkedin conversation --campaign-id 1234 --last-days 30 --output csv`
-  },
-  args: {
-    "campaign-id": {
-      type: "string",
-      description: "Comma-separated campaign IDs (Conversation Ad campaigns)",
-      required: true
-    },
-    start: { type: "string", description: "Start date YYYY-MM-DD" },
-    end: { type: "string", description: "End date YYYY-MM-DD" },
-    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const campaignIdsRaw = args["campaign-id"];
-    if (!campaignIdsRaw) {
-      handleLinkedinError(new Error("--campaign-id is required"));
-    }
-    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
-    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
-    const end = args.end ?? todayIso();
-    try {
-      const data = await apiPost("/api/ads/linkedin/analytics", {
-        request: {
-          level: "campaign",
-          ids,
-          intent: "inmail",
-          pivot: "conversation-node-button",
-          start,
-          end,
-          granularity: "ALL",
-          limit: 500
-        },
-        skipCache: Boolean(args["no-cache"])
-      });
-      const sorted = [...data.rows].sort((a, b) => Number(b.clicks ?? 0) - Number(a.clicks ?? 0));
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(sorted, fmt, data.fields);
-        return;
-      }
-      writeAdsJson({
-        ok: true,
-        data: { query: { campaigns: ids, start, end }, rows: sorted, warnings: data.warnings }
-      });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  conversationCommand
-};
-//# sourceMappingURL=conversation-HRNJJJW5.js.map

package/dist/conversion-report-KL4LIVY5.js

@@ -1,125 +0,0 @@
-import {
-  CHATGPT_ADS_REFERENCE,
-  CHATGPT_CONVERSION_REPORT_LEVELS,
-  chatgptAdsConversionReportRequestSchema,
-  numberArg,
-  reportCsvArg,
-  runChatgptRead,
-  stringArg
-} from "./chunk-3BKNGXCL.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-SWL4AAPP.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/conversion-report.ts
-import { defineCommand } from "citty";
-var ARGS = {
-  level: {
-    type: "string",
-    description: `What one row is: ${CHATGPT_CONVERSION_REPORT_LEVELS.join("|")} (default campaign)`
-  },
-  ids: {
-    type: "string",
-    description: "Campaign, ad group or ad ids, comma-separated \u2014 one row each. Left out: one total for the account"
-  },
-  days: { type: "string", description: "Last N complete days, ending the account's yesterday (default 7, max 365)" },
-  since: { type: "string", description: "First day, YYYY-MM-DD, account timezone (instead of --days)" },
-  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD" },
-  granularity: { type: "string", description: "none (default: one total) | daily" },
-  segment: { type: "string", description: "Break rows down by device or country" },
-  "click-window": { type: "string", description: "Days after a click that count: 7, 14 or 30 (default 30)" },
-  "view-window": { type: "string", description: "Days after a view that count: 1 (default) or 0 to leave views out" },
-  events: {
-    type: "string",
-    description: "Event names to detail, comma-separated, as the site sends them \u2014 goal or not (implies --with-events)"
-  },
-  "with-events": { type: "boolean", description: "Detail every attributed event, not just goal conversions" }
-};
-function conversionReportRequestFromArgs(args) {
-  return {
-    level: stringArg(args, "level"),
-    ids: reportCsvArg(args, "ids"),
-    since: stringArg(args, "since"),
-    until: stringArg(args, "until"),
-    days: numberArg(args, "days"),
-    granularity: stringArg(args, "granularity"),
-    segment: stringArg(args, "segment"),
-    clickWindowDays: numberArg(args, "click-window"),
-    viewWindowDays: numberArg(args, "view-window"),
-    events: reportCsvArg(args, "events"),
-    withEvents: args["with-events"] === true ? true : void 0
-  };
-}
-function reportHints(report) {
-  const nothing = report.rows.every((row) => row.conversions === 0 && (row.events ?? []).length === 0);
-  return nothing ? [
-    "No attributed conversions in this window. Before concluding the ads do not convert: `conversions events` shows whether the site's events arrive at all, and `campaigns` whether anything served."
-  ] : [
-    `Counted with a ${report.clickWindowDays}-day click and ${report.viewWindowDays}-day view window; a conversion eligible for both counts once, as a click. The latest days are still filling in.`
-  ];
-}
-registerSchema({
-  command: "ads.chatgpt.conversions.report",
-  description: "Conversions ChatGPT Ads attributes to campaigns, ad groups or ads: goal conversions split into click-through and view-through, purchase value, and optionally every attributed event (goal or not), per day and by device or country, with the click (7/14/30) and view (0/1) windows chosen. At most 365 days.",
-  args: {
-    level: { type: "string", description: ARGS.level.description, required: false },
-    ids: { type: "string", description: ARGS.ids.description, required: false },
-    days: { type: "string", description: ARGS.days.description, required: false },
-    since: { type: "string", description: ARGS.since.description, required: false },
-    until: { type: "string", description: ARGS.until.description, required: false },
-    granularity: { type: "string", description: ARGS.granularity.description, required: false },
-    segment: { type: "string", description: ARGS.segment.description, required: false },
-    "click-window": { type: "string", description: ARGS["click-window"].description, required: false },
-    "view-window": { type: "string", description: ARGS["view-window"].description, required: false },
-    events: { type: "string", description: ARGS.events.description, required: false },
-    "with-events": { type: "boolean", description: ARGS["with-events"].description, required: false }
-  }
-});
-var conversionsReportCommand = defineCommand({
-  meta: {
-    name: "report",
-    description: `Conversions ChatGPT Ads attributes, click-through beside view-through.
-
-Examples:
-  baker ads chatgpt conversions report                                   # account total, last 7 days
-  baker ads chatgpt conversions report --ids cmpn_1,cmpn_2 --days 30 --segment device
-  baker ads chatgpt conversions report --view-window 0 --click-window 7   # clicks only, 7-day window
-  baker ads chatgpt conversions report --events quote_requested --granularity daily`
-  },
-  args: ARGS,
-  run: async ({ args }) => {
-    const parsed = chatgptAdsConversionReportRequestSchema.safeParse(conversionReportRequestFromArgs(args));
-    if (!parsed.success) {
-      const message = parsed.error.issues[0]?.message ?? "Invalid conversion report request";
-      writeJsonEnvelope({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message,
-          fix: { action: "retry_with_modified_query", explanation: message },
-          retryable: false
-        }
-      });
-      process.exit(1);
-    }
-    await runChatgptRead(
-      CHATGPT_ADS_REFERENCE.conversions,
-      () => apiPost("/api/ads/chatgpt/conversions/report", parsed.data),
-      reportHints
-    );
-  }
-});
-export {
-  conversionReportRequestFromArgs,
-  conversionsReportCommand
-};
-//# sourceMappingURL=conversion-report-KL4LIVY5.js.map