@brew.new/cli 0.8.0 → 0.9.0

package/dist/bin.js

@@ -281,7 +281,7 @@ function shellQuote(token) {
 
 // src/version.ts
 var CLI_NAME = "brew-cli";
-var CLI_VERSION = "0.8.0" ;
+var CLI_VERSION = "0.9.0" ;
 var CONFIG_KEYS = ["apiKey", "brandId", "apiUrl"];
 function isConfigKey(value) {
   return CONFIG_KEYS.includes(value);
@@ -653,6 +653,10 @@ var IDEMPOTENCY_FLAG = {
   flag: "--idempotency-key <key>",
   summary: "Idempotency-Key for safe retries (auto-generated otherwise)"
 };
+var NON_REPLAYING_IDEMPOTENCY_FLAG = {
+  flag: "--idempotency-key <key>",
+  summary: "Accepted for compatibility only: this route never replays, so a retry runs again"
+};
 var INPUT_FLAG = {
   flag: "--input <json>",
   summary: "Full JSON request body, or - to read stdin (flags override it)"
@@ -857,6 +861,201 @@ var analyticsCampaignsCommand = defineCommand({
   }
 });
 
+// src/lib/raw-request.ts
+async function rawRequest(ctx, request) {
+  const auth = resolveAuth({
+    globals: ctx.globals,
+    env: ctx.io.env,
+    ...request.allowAnonymous === true ? { allowAnonymous: true } : {}
+  });
+  const hasBody = request.body !== void 0;
+  const idempotencyKey = resolveRawIdempotencyKey(
+    request.method,
+    request.idempotencyKey
+  );
+  const headers = buildRawHeaders({
+    auth,
+    path: request.path,
+    hasJsonBody: hasBody,
+    idempotencyKey
+  });
+  const url = new URL(`${auth.apiUrl}${request.path}`);
+  for (const [key, value] of Object.entries(request.query ?? {})) {
+    if (value !== void 0) {
+      url.searchParams.set(key, value);
+    }
+  }
+  const response = await fetch(url, {
+    method: request.method,
+    headers,
+    ...hasBody ? { body: JSON.stringify(request.body) } : {},
+    ...request.signal === void 0 ? {} : { signal: request.signal }
+  });
+  const text = await response.text();
+  const parsed = tryParseJson(text);
+  if (!response.ok) {
+    throw responseToApiError(response, parsed);
+  }
+  if (parsed === void 0) {
+    throw new CliApiError({
+      status: response.status,
+      code: "UNEXPECTED_RESPONSE",
+      type: "internal_error",
+      message: "The API returned a non-JSON success response."
+    });
+  }
+  return parsed;
+}
+function resolveRawIdempotencyKey(method, provided) {
+  if (provided !== void 0 && provided !== "") {
+    return provided;
+  }
+  return method === "POST" ? crypto.randomUUID() : void 0;
+}
+function buildRawHeaders(input) {
+  const headers = new Headers({
+    authorization: `Bearer ${input.auth.apiKey}`,
+    "user-agent": `${CLI_NAME}/${CLI_VERSION}`,
+    accept: "application/json, text/plain;q=0.9"
+  });
+  if (input.hasJsonBody) {
+    headers.set("content-type", "application/json");
+  }
+  if (input.auth.brandId !== void 0 && !isOrgLevelPath(input.path)) {
+    headers.set("x-brand-id", input.auth.brandId);
+  }
+  if (input.idempotencyKey !== void 0 && input.idempotencyKey !== "") {
+    headers.set("idempotency-key", input.idempotencyKey);
+  }
+  return headers;
+}
+function responseToApiError(response, parsed) {
+  const requestId = response.headers.get("x-request-id") ?? void 0;
+  const record = isRecord2(parsed) ? parsed : void 0;
+  const standard = record !== void 0 && isRecord2(record.error) ? record.error : void 0;
+  const envelope = standard ?? record;
+  const readField = (key) => {
+    const value = envelope?.[key];
+    return typeof value === "string" ? value : void 0;
+  };
+  const param = readField("param");
+  const suggestion = readField("suggestion") ?? (envelope === void 0 ? void 0 : suggestionForStatus(response.status));
+  const docs = readField("docs");
+  const details = isRecord2(envelope?.details) ? envelope.details : void 0;
+  return new CliApiError({
+    status: response.status,
+    code: readField("code") ?? "HTTP_ERROR",
+    type: readField("type") ?? errorTypeForStatus(response.status),
+    message: readField("message") ?? `Request failed with status ${response.status}`,
+    ...param === void 0 ? {} : { param },
+    ...suggestion === void 0 ? {} : { suggestion },
+    ...docs === void 0 ? {} : { docs },
+    ...requestId === void 0 ? {} : { requestId },
+    ...details === void 0 ? {} : { details },
+    ...parsed === void 0 ? {} : { body: parsed }
+  });
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function tryParseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+  }
+}
+
+// src/commands/analytics/event-counts.ts
+var analyticsEventCountsCommand = defineCommand({
+  path: ["analytics", "event-counts"],
+  summary: "Count email events per field and/or period (clicks per link, events per day, unsubscribe reasons)",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: { method: "GET", path: "/v1/analytics/events" },
+  commandClass: "read",
+  flags: [
+    {
+      flag: "--group-by <fields>",
+      summary: "One or two comma-separated fields: eventType, emailId, automationId, sendId, source, link, recipientDomain, unsubscribeReason"
+    },
+    {
+      flag: "--bucket <period>",
+      summary: "Count per UTC day, week (Monday start) or month"
+    },
+    { flag: "--since <datetime>", summary: "Window start (ISO-8601)" },
+    { flag: "--until <datetime>", summary: "Window end (ISO-8601)" },
+    {
+      flag: "--event-type <type>",
+      summary: "Only one email event type (e.g. clicked)"
+    },
+    { flag: "--send-id <sendId>", summary: "Only one send" },
+    { flag: "--email-id <emailId>", summary: "Only one design" },
+    {
+      flag: "--recipient <rules>",
+      summary: "CSV of recipient rules (max 10): an address, @domain, or substring; prefix ! to exclude"
+    },
+    INPUT_FLAG
+  ],
+  examples: [
+    "brew-cli analytics event-counts --send-id snd_123 --event-type clicked --group-by link",
+    "brew-cli analytics event-counts --group-by eventType --bucket day",
+    "brew-cli analytics event-counts --group-by unsubscribeReason --json"
+  ],
+  run: async ({ ctx, flags }) => {
+    const base = await readJsonFlag(ctx, flags.input, "--input");
+    const input = mergeInput(base, {
+      groupBy: flagString(flags.groupBy),
+      bucket: flagString(flags.bucket),
+      from: flagString(flags.since),
+      to: flagString(flags.until),
+      eventType: flagString(flags.eventType),
+      sendId: flagString(flags.sendId),
+      emailId: flagString(flags.emailId),
+      recipient: flagString(flags.recipient)
+    });
+    if (input.groupBy === void 0 && input.bucket === void 0) {
+      throw new CliUsageError(
+        "Pass --group-by, --bucket, or both (`analytics events` lists the rows)."
+      );
+    }
+    const query = {};
+    for (const [key, value] of Object.entries(input)) {
+      if (key === "cursor" || key === "limit") {
+        continue;
+      }
+      query[key] = value === void 0 || value === null ? void 0 : Array.isArray(value) ? value.map(String).join(",") : String(value);
+    }
+    const body = await rawRequest(ctx, {
+      method: "GET",
+      path: "/v1/analytics/events",
+      query
+    });
+    return { data: body, human: renderCounts(body) };
+  }
+});
+function renderCounts(body) {
+  if (body.groups.length === 0) {
+    return `No events counted (total ${body.count}).`;
+  }
+  const rows = body.groups.map((group) => ({
+    group: Object.entries(group.key ?? {}).map(([field, value]) => `${field}=${String(value)}`).join(" "),
+    ...group.bucket === void 0 ? {} : { bucket: group.bucket },
+    count: group.count
+  }));
+  const table = renderTable(rows, [
+    { key: "group", header: "GROUP" },
+    ...rows.some((row) => "bucket" in row) ? [{ key: "bucket", header: "PERIOD" }] : [],
+    { key: "count", header: "COUNT" }
+  ]);
+  const footer = [
+    `total ${body.count}`,
+    body.otherCount > 0 ? `${body.otherCount} in unlisted groups` : "",
+    body.truncated ? `truncated (counted from ${body.coveredFrom ?? "?"})` : ""
+  ].filter(Boolean).join(" \xB7 ");
+  return `${table}
+${footer}`;
+}
+
 // src/commands/analytics/events.ts
 var analyticsEventsCommand = defineCommand({
   path: ["analytics", "events"],
@@ -1205,110 +1404,6 @@ var analyticsTriggerInstancesListCommand = defineCommand({
   }
 });
 
-// src/lib/raw-request.ts
-async function rawRequest(ctx, request) {
-  const auth = resolveAuth({
-    globals: ctx.globals,
-    env: ctx.io.env,
-    ...request.allowAnonymous === true ? { allowAnonymous: true } : {}
-  });
-  const hasBody = request.body !== void 0;
-  const idempotencyKey = resolveRawIdempotencyKey(
-    request.method,
-    request.idempotencyKey
-  );
-  const headers = buildRawHeaders({
-    auth,
-    path: request.path,
-    hasJsonBody: hasBody,
-    idempotencyKey
-  });
-  const url = new URL(`${auth.apiUrl}${request.path}`);
-  for (const [key, value] of Object.entries(request.query ?? {})) {
-    if (value !== void 0) {
-      url.searchParams.set(key, value);
-    }
-  }
-  const response = await fetch(url, {
-    method: request.method,
-    headers,
-    ...hasBody ? { body: JSON.stringify(request.body) } : {},
-    ...request.signal === void 0 ? {} : { signal: request.signal }
-  });
-  const text = await response.text();
-  const parsed = tryParseJson(text);
-  if (!response.ok) {
-    throw responseToApiError(response, parsed);
-  }
-  if (parsed === void 0) {
-    throw new CliApiError({
-      status: response.status,
-      code: "UNEXPECTED_RESPONSE",
-      type: "internal_error",
-      message: "The API returned a non-JSON success response."
-    });
-  }
-  return parsed;
-}
-function resolveRawIdempotencyKey(method, provided) {
-  if (provided !== void 0 && provided !== "") {
-    return provided;
-  }
-  return method === "POST" ? crypto.randomUUID() : void 0;
-}
-function buildRawHeaders(input) {
-  const headers = new Headers({
-    authorization: `Bearer ${input.auth.apiKey}`,
-    "user-agent": `${CLI_NAME}/${CLI_VERSION}`,
-    accept: "application/json, text/plain;q=0.9"
-  });
-  if (input.hasJsonBody) {
-    headers.set("content-type", "application/json");
-  }
-  if (input.auth.brandId !== void 0 && !isOrgLevelPath(input.path)) {
-    headers.set("x-brand-id", input.auth.brandId);
-  }
-  if (input.idempotencyKey !== void 0 && input.idempotencyKey !== "") {
-    headers.set("idempotency-key", input.idempotencyKey);
-  }
-  return headers;
-}
-function responseToApiError(response, parsed) {
-  const requestId = response.headers.get("x-request-id") ?? void 0;
-  const record = isRecord2(parsed) ? parsed : void 0;
-  const standard = record !== void 0 && isRecord2(record.error) ? record.error : void 0;
-  const envelope = standard ?? record;
-  const readField = (key) => {
-    const value = envelope?.[key];
-    return typeof value === "string" ? value : void 0;
-  };
-  const param = readField("param");
-  const suggestion = readField("suggestion") ?? (envelope === void 0 ? void 0 : suggestionForStatus(response.status));
-  const docs = readField("docs");
-  const details = isRecord2(envelope?.details) ? envelope.details : void 0;
-  return new CliApiError({
-    status: response.status,
-    code: readField("code") ?? "HTTP_ERROR",
-    type: readField("type") ?? errorTypeForStatus(response.status),
-    message: readField("message") ?? `Request failed with status ${response.status}`,
-    ...param === void 0 ? {} : { param },
-    ...suggestion === void 0 ? {} : { suggestion },
-    ...docs === void 0 ? {} : { docs },
-    ...requestId === void 0 ? {} : { requestId },
-    ...details === void 0 ? {} : { details },
-    ...parsed === void 0 ? {} : { body: parsed }
-  });
-}
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function tryParseJson(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-  }
-}
-
 // src/commands/api.ts
 var METHODS = ["GET", "POST", "PATCH", "DELETE"];
 var ANONYMOUS_PATHS = ["/v1/health", "/v1/help", "/v1/llms.txt"];
@@ -1451,7 +1546,9 @@ var apiKeysCreateCommand = defineCommand({
       summary: "Bind the NEW key to this brand id (omit for an organization-wide key); not the acting --brand"
     },
     INPUT_FLAG,
-    IDEMPOTENCY_FLAG
+    // The route never replays (a replay would disclose the plaintext key
+    // again): a retry mints a second key, whatever the key says.
+    NON_REPLAYING_IDEMPOTENCY_FLAG
   ],
   examples: [
     "brew-cli api-keys create --name CI --permissions emails domains",
@@ -1495,9 +1592,31 @@ var apiKeysListCommand = defineCommand({
   sdkMethod: "apiKeys.list",
   route: { method: "GET", path: "/v1/api-keys" },
   commandClass: "read",
+  flags: [LIMIT_FLAG, CURSOR_FLAG, ALL_FLAG],
   examples: ["brew-cli api-keys list", "brew-cli api-keys list --json"],
-  run: async ({ ctx }) => {
-    const result = await ctx.client().apiKeys.list();
+  run: async ({ ctx, flags }) => {
+    const limit = flagInt(flags.limit, "--limit");
+    const cursor = flagString(flags.cursor);
+    if (limit === void 0 && cursor === void 0 && flags.all !== true) {
+      const result2 = await ctx.client().apiKeys.list();
+      return { data: result2, human: renderApiKeys(result2.data) };
+    }
+    const page = (after) => rawRequest(ctx, {
+      method: "GET",
+      path: "/v1/api-keys",
+      query: {
+        limit: limit === void 0 ? void 0 : String(limit),
+        cursor: after
+      }
+    });
+    if (flags.all === true) {
+      const rows = await collectAll(ctx, (next) => page(next ?? cursor));
+      return {
+        data: { data: rows, pagination: { cursor: null, hasMore: false } },
+        human: renderApiKeys(rows)
+      };
+    }
+    const result = await page(cursor);
     return { data: result, human: renderApiKeys(result.data) };
   }
 });
@@ -3038,21 +3157,37 @@ var brandGetCommand = defineCommand({
 });
 
 // src/commands/brand/get-images.ts
+var RETIRED_FILTERS = {
+  type: "--type (type) was retired by the API: use --kind logo|brand|generated.",
+  aspectRatio: "--aspect-ratio (aspectRatio) was retired by the API: every image carries its width and height."
+};
 var brandGetImagesCommand = defineCommand({
   path: ["brand", "get-images"],
-  summary: "Browse or semantically search the brand's image library",
-  sdkMethod: "brand.getImages",
+  summary: "Browse or semantically search the brand's assets (logos, brand images, images made with Brew)",
+  sdkMethod: null,
+  isRawTransport: true,
   route: { method: "GET", path: "/v1/brand/images" },
   commandClass: "read",
   flags: [
     {
       flag: "--query <text>",
-      summary: "Semantic search over image descriptions"
+      summary: "Semantic search over what the images show (1 credit per new search; logos are not searchable)"
+    },
+    {
+      flag: "--kind <kind>",
+      summary: "logo, brand (from the site or uploaded) or generated"
+    },
+    {
+      flag: "--sort <order>",
+      summary: "Browse order: newest (default) or oldest; ignored by --query"
+    },
+    {
+      flag: "--type <type>",
+      summary: "Retired by the API: use --kind"
     },
-    { flag: "--type <type>", summary: "Filter by image category" },
     {
       flag: "--aspect-ratio <ratio>",
-      summary: "Filter by aspect ratio (e.g. 16:9)"
+      summary: "Retired by the API: rows carry width and height instead of a shape filter"
     },
     LIMIT_FLAG,
     CURSOR_FLAG,
@@ -3061,48 +3196,68 @@ var brandGetImagesCommand = defineCommand({
   ],
   examples: [
     "brew-cli brand get-images",
-    'brew-cli brand get-images --query "team photo" --aspect-ratio 16:9'
+    "brew-cli brand get-images --kind generated --sort oldest --all",
+    'brew-cli brand get-images --query "team photo" --kind brand'
   ],
   run: async ({ ctx, flags }) => {
     const base = await readJsonFlag(ctx, flags.input, "--input");
     const input = mergeInput(base, {
       q: flagString(flags.query),
-      type: flagString(flags.type),
-      aspectRatio: flagString(flags.aspectRatio),
+      kind: flagString(flags.kind),
+      sort: flagString(flags.sort),
       limit: flagInt(flags.limit, "--limit"),
-      cursor: flagString(flags.cursor)
+      cursor: flagString(flags.cursor),
+      type: flagString(flags.type),
+      aspectRatio: flagString(flags.aspectRatio)
+    });
+    for (const [key, message] of Object.entries(RETIRED_FILTERS)) {
+      if (input[key] !== void 0) {
+        throw new CliUsageError(message);
+      }
+    }
+    const page = (cursor) => rawRequest(ctx, {
+      method: "GET",
+      path: "/v1/brand/images",
+      query: toQuery(cursor === void 0 ? input : { ...input, cursor })
     });
-    const brand = ctx.client().brand;
     if (flags.all === true) {
-      const rows = await collectAll(
-        ctx,
-        (cursor) => brand.getImages(
-          asSdkInput({
-            ...input,
-            ...cursor === void 0 ? {} : { cursor }
-          })
-        )
-      );
+      const rows = await collectAll(ctx, page);
       return {
         data: { data: rows, pagination: { cursor: null, hasMore: false } },
-        human: renderImages(rows)
+        human: renderAssets(rows)
       };
     }
-    const result = await brand.getImages(
-      asSdkInput(input)
-    );
-    return { data: result, human: renderImages(result.data) };
+    const result = await page(void 0);
+    return { data: result, human: renderAssets(result.data) };
   }
 });
-function renderImages(rows) {
+function toQuery(input) {
+  const query = {};
+  for (const [key, value] of Object.entries(input)) {
+    query[key] = value === void 0 || value === null ? void 0 : String(value);
+  }
+  return query;
+}
+function renderAssets(rows) {
   if (rows.length === 0) {
-    return "No brand images found.";
+    return "No brand assets found.";
   }
-  return renderTable(rows, [
-    { key: "url", header: "URL" },
-    { key: "category", header: "CATEGORY" },
-    { key: "aspectRatio", header: "ASPECT" }
-  ]);
+  return renderTable(
+    rows.map((row) => ({
+      assetId: row.assetId,
+      kind: row.kind,
+      url: row.url,
+      size: row.width !== void 0 && row.height !== void 0 ? `${row.width}x${row.height}` : "",
+      added: row.addedAt ?? ""
+    })),
+    [
+      { key: "assetId", header: "ASSET ID" },
+      { key: "kind", header: "KIND" },
+      { key: "url", header: "URL" },
+      { key: "size", header: "SIZE" },
+      { key: "added", header: "ADDED" }
+    ]
+  );
 }
 
 // src/commands/brand/update.ts
@@ -3204,10 +3359,43 @@ var brandsListCommand = defineCommand({
   sdkMethod: "brands.list",
   route: { method: "GET", path: "/v1/brands" },
   commandClass: "read",
-  examples: ["brew-cli brands list --json"],
-  run: async ({ ctx }) => ({
-    data: await ctx.client().brands.list()
-  })
+  flags: [
+    {
+      flag: "--status <status>",
+      summary: "Only brands in one lifecycle state: extracting | completed | failed | deleting"
+    },
+    LIMIT_FLAG,
+    CURSOR_FLAG,
+    ALL_FLAG
+  ],
+  examples: [
+    "brew-cli brands list --json",
+    "brew-cli brands list --status completed",
+    "brew-cli brands list --all --json"
+  ],
+  run: async ({ ctx, flags }) => {
+    const input = {
+      status: flagString(flags.status),
+      limit: flagInt(flags.limit, "--limit"),
+      cursor: flagString(flags.cursor)
+    };
+    const brands = ctx.client().brands;
+    if (flags.all === true) {
+      const rows = await collectAll(
+        ctx,
+        (cursor) => brands.list(
+          asSdkInput({
+            ...input,
+            ...cursor === void 0 ? {} : { cursor }
+          })
+        )
+      );
+      return {
+        data: { data: rows, pagination: { cursor: null, hasMore: false } }
+      };
+    }
+    return { data: await brands.list(asSdkInput(input)) };
+  }
 });
 
 // src/commands/chats/get.ts
@@ -3439,35 +3627,65 @@ var contactsGetCommand = defineCommand({
 // src/commands/contacts/import-csv.ts
 var contactsImportCsvCommand = defineCommand({
   path: ["contacts", "import-csv"],
-  summary: "Bulk-import contacts from a CSV file or stdin",
+  summary: "Bulk-import contacts from a CSV file or stdin (free; --validate costs 2 credits per address)",
   sdkMethod: "contacts.importCsv",
   route: { method: "POST", path: "/v1/contacts/import-csv" },
   commandClass: "write",
   flags: [
-    { flag: "--file <path>", summary: "CSV file to import, or - for stdin" },
+    {
+      flag: "--file <path>",
+      summary: "CSV file to import, or - for stdin (or csv in --input)"
+    },
     {
       flag: "--mapping <pairs...>",
       summary: "Column mapping csvColumn=fieldName, repeatable"
     },
+    {
+      flag: "--date-order <order>",
+      summary: "month_first or day_first: how to read dates like 03/04/2026 (a day over 12 in the column wins; default month-first, with a DATE_ORDER_ASSUMED warning)"
+    },
+    {
+      flag: "--validate",
+      summary: "Deliverability-check every imported address (2 credits per address)"
+    },
+    {
+      flag: "--consent-source <source>",
+      summary: "Stamp a marketing consent record on every row: api, form or import (sets the source of a record given in --input)"
+    },
+    INPUT_FLAG,
     IDEMPOTENCY_FLAG
   ],
   examples: [
     "brew-cli contacts import-csv --file contacts.csv",
-    "cat contacts.csv | brew-cli contacts import-csv --file - --mapping Email=email"
+    "cat contacts.csv | brew-cli contacts import-csv --file - --mapping Email=email",
+    "brew-cli contacts import-csv --file eu-signups.csv --date-order day_first --consent-source import"
   ],
   run: async ({ ctx, flags }) => {
-    const csv = await readTextFlag(ctx, flags.file, "--file");
-    if (csv === void 0 || csv.trim() === "") {
+    if (flags.input === "-" && flags.file === "-") {
+      throw new CliUsageError("Only one of --input and --file can read stdin.");
+    }
+    const base = await readJsonFlag(ctx, flags.input, "--input");
+    const consentSource = flagString(flags.consentSource);
+    const input = mergeInput(base, {
+      csv: await readTextFlag(ctx, flags.file, "--file"),
+      mapping: parseKeyValues(flags.mapping, "--mapping"),
+      dateOrder: flagString(flags.dateOrder),
+      validate: flags.validate === true ? true : void 0
+    });
+    if (typeof input.csv !== "string" || input.csv.trim() === "") {
       throw new CliUsageError(
-        "--file is required (a CSV path, or - for stdin)."
+        "Pass the CSV with --file (a path, or - for stdin) or as csv in --input."
       );
     }
-    const mapping = parseKeyValues(flags.mapping, "--mapping");
+    if (consentSource !== void 0) {
+      const record = input.consent;
+      input.consent = {
+        ...typeof record === "object" && record !== null ? record : {},
+        source: consentSource
+      };
+    }
     const result = await ctx.client().contacts.importCsv(
-      asSdkInput({
-        csv,
-        ...mapping === void 0 ? {} : { mapping }
-      }),
+      asSdkInput(input),
       requestOptions(flags)
     );
     return { data: result };
@@ -4071,14 +4289,17 @@ var contractsInferCommand = defineCommand({
   examples: [
     `brew-cli contracts infer --input '{"email":"jane@example.com","order":{"total":9.5}}'`
   ],
-  // Accepts either the bare example object or `{ example: {...} }`.
-  // Un-inferable spots (nulls, empty arrays) come back under `issues`.
+  // Accepts either the bare example object or `{ example: {...} }`; only the
+  // envelope carries `subjectKind` (a bare example may have its own field of
+  // that name). Un-inferable spots (nulls, empty arrays) come back under
+  // `issues`.
   run: async ({ ctx, flags }) => {
     const input = mergeInput(
       await readJsonFlag(ctx, flags.input, "--input"),
       {}
     );
-    const example = input.example ?? input;
+    const isEnvelope = input.example !== void 0;
+    const example = isEnvelope ? input.example : input;
     if (typeof example !== "object" || example === null || Array.isArray(example) || Object.keys(example).length === 0) {
       throw new CliUsageError(
         "--input with a non-empty example object is required (the JSON your system sends)."
@@ -4087,7 +4308,10 @@ var contractsInferCommand = defineCommand({
     const body = await rawRequest(ctx, {
       method: "POST",
       path: "/v1/payload-contracts/infer",
-      body: { example }
+      body: {
+        example,
+        ...isEnvelope && input.subjectKind !== void 0 ? { subjectKind: input.subjectKind } : {}
+      }
     });
     return { data: body };
   }
@@ -4139,6 +4363,10 @@ var SDK_SKIP_LIST = [
     sdkPath: "automations.triggers.validatePayload",
     reason: "covered by `automations triggers contract validate` (raw route, bound pre-SDK-v9)"
   },
+  {
+    sdkPath: "brand.getImages",
+    reason: "covered by `brand get-images` (raw route: SDK 10 cannot send `kind` or `sort`, brew-v2#1713; bind SDK 11.2)"
+  },
   {
     sdkPath: "payloadContracts.infer",
     reason: "covered by `contracts infer` (raw route, bound pre-SDK-v9)"
@@ -4513,6 +4741,194 @@ function renderDomains(rows) {
   ]);
 }
 
+// src/commands/domains/unsubscribes/add.ts
+var domainsUnsubscribesAddCommand = defineCommand({
+  path: ["domains", "unsubscribes", "add"],
+  summary: "Add addresses to a marketing domain's unsubscribe list (that domain only)",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: { method: "POST", path: "/v1/domains/{domainId}/unsubscribes" },
+  commandClass: "write",
+  args: [
+    { name: "domainId", summary: "Marketing domain id", isRequired: true }
+  ],
+  flags: [
+    {
+      flag: "--email <addresses...>",
+      summary: "Address to suppress, repeatable (up to 1,000)"
+    },
+    IDEMPOTENCY_FLAG
+  ],
+  examples: [
+    "brew-cli domains unsubscribes add dom_123 --email ada@example.com --email bo@example.com"
+  ],
+  run: async ({ ctx, args, flags }) => {
+    const emails = toStringArray(flags.email);
+    if (emails === void 0) {
+      throw new CliUsageError("Pass at least one --email.");
+    }
+    const body = await rawRequest(ctx, {
+      method: "POST",
+      path: `/v1/domains/${encodeURIComponent(args.domainId ?? "")}/unsubscribes`,
+      body: { emails },
+      idempotencyKey: flagString(flags.idempotencyKey)
+    });
+    return { data: body };
+  }
+});
+
+// src/commands/domains/unsubscribes/export.ts
+var domainsUnsubscribesExportCommand = defineCommand({
+  path: ["domains", "unsubscribes", "export"],
+  summary: "A domain's unsubscribe list as CSV (truncated when capped)",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: {
+    method: "GET",
+    path: "/v1/domains/{domainId}/unsubscribes/export"
+  },
+  commandClass: "read",
+  args: [
+    { name: "domainId", summary: "Marketing domain id", isRequired: true }
+  ],
+  flags: [
+    {
+      flag: "--scope <scope>",
+      summary: "any (default), domain or all"
+    }
+  ],
+  examples: [
+    "brew-cli domains unsubscribes export dom_123 > optouts.csv",
+    "brew-cli domains unsubscribes export dom_123 --scope all --json"
+  ],
+  run: async ({ ctx, args, flags }) => {
+    const body = await rawRequest(ctx, {
+      method: "GET",
+      path: `/v1/domains/${encodeURIComponent(args.domainId ?? "")}/unsubscribes/export`,
+      query: { scope: flagString(flags.scope) }
+    });
+    return { data: body, human: body.csv };
+  }
+});
+
+// src/commands/domains/unsubscribes/import.ts
+var domainsUnsubscribesImportCommand = defineCommand({
+  path: ["domains", "unsubscribes", "import"],
+  summary: "Add every address in a CSV to a domain's unsubscribe list",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: {
+    method: "POST",
+    path: "/v1/domains/{domainId}/unsubscribes/import"
+  },
+  commandClass: "write",
+  args: [
+    { name: "domainId", summary: "Marketing domain id", isRequired: true }
+  ],
+  flags: [
+    { flag: "--file <path>", summary: "CSV file, or - for stdin" },
+    {
+      flag: "--column <header>",
+      summary: "The column holding the addresses (by header)"
+    },
+    IDEMPOTENCY_FLAG
+  ],
+  examples: [
+    "brew-cli domains unsubscribes import dom_123 --file optouts.csv --column Email"
+  ],
+  run: async ({ ctx, args, flags }) => {
+    const csv = await readTextFlag(ctx, flags.file, "--file");
+    if (csv === void 0 || csv.trim() === "") {
+      throw new CliUsageError(
+        "--file is required (a CSV path, or - for stdin)."
+      );
+    }
+    const column = flagString(flags.column);
+    const body = await rawRequest(ctx, {
+      method: "POST",
+      path: `/v1/domains/${encodeURIComponent(args.domainId ?? "")}/unsubscribes/import`,
+      body: { csv, ...column === void 0 ? {} : { column } },
+      idempotencyKey: flagString(flags.idempotencyKey)
+    });
+    return { data: body };
+  }
+});
+
+// src/commands/domains/unsubscribes/list.ts
+var domainsUnsubscribesListCommand = defineCommand({
+  path: ["domains", "unsubscribes", "list"],
+  summary: "One page of a marketing domain's unsubscribe list, newest first",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: { method: "GET", path: "/v1/domains/{domainId}/unsubscribes" },
+  commandClass: "read",
+  args: [
+    { name: "domainId", summary: "Marketing domain id", isRequired: true }
+  ],
+  flags: [
+    { flag: "--q <text>", summary: "Search by address" },
+    {
+      flag: "--scope <scope>",
+      summary: "any (default), domain (this list only) or all (brand-wide opt-outs)"
+    },
+    LIMIT_FLAG,
+    CURSOR_FLAG
+  ],
+  examples: [
+    "brew-cli domains unsubscribes list dom_123",
+    "brew-cli domains unsubscribes list dom_123 --scope domain --q ada"
+  ],
+  run: async ({ ctx, args, flags }) => {
+    const limit = flagInt(flags.limit, "--limit");
+    const body = await rawRequest(ctx, {
+      method: "GET",
+      path: `/v1/domains/${encodeURIComponent(args.domainId ?? "")}/unsubscribes`,
+      query: {
+        q: flagString(flags.q),
+        scope: flagString(flags.scope),
+        limit: limit === void 0 ? void 0 : String(limit),
+        cursor: flagString(flags.cursor)
+      }
+    });
+    return { data: body, human: renderRows(body.data) };
+  }
+});
+function renderRows(rows) {
+  if (rows.length === 0) {
+    return "No unsubscribes on this list.";
+  }
+  return renderTable(rows, [
+    { key: "email", header: "EMAIL" },
+    { key: "scope", header: "SCOPE" },
+    { key: "unsubscribedAt", header: "UNSUBSCRIBED" }
+  ]);
+}
+
+// src/commands/domains/unsubscribes/remove.ts
+var domainsUnsubscribesRemoveCommand = defineCommand({
+  path: ["domains", "unsubscribes", "remove"],
+  summary: "Take one address off a domain's unsubscribe list (never re-subscribes a brand-wide opt-out)",
+  sdkMethod: null,
+  isRawTransport: true,
+  route: {
+    method: "DELETE",
+    path: "/v1/domains/{domainId}/unsubscribes/{email}"
+  },
+  commandClass: "write",
+  args: [
+    { name: "domainId", summary: "Marketing domain id", isRequired: true },
+    { name: "email", summary: "Address to remove", isRequired: true }
+  ],
+  flags: [],
+  examples: ["brew-cli domains unsubscribes remove dom_123 ada@example.com"],
+  run: async ({ ctx, args }) => ({
+    data: await rawRequest(ctx, {
+      method: "DELETE",
+      path: `/v1/domains/${encodeURIComponent(args.domainId ?? "")}/unsubscribes/${encodeURIComponent(args.email ?? "")}`
+    })
+  })
+});
+
 // src/commands/domains/update.ts
 var domainsUpdateCommand = defineCommand({
   path: ["domains", "update"],
@@ -4658,19 +5074,41 @@ var emailsCloneCommand = defineCommand({
       flag: "--email-version-id <id>",
       summary: "Exact source version to clone (default: latest)"
     },
+    {
+      flag: "--title <title>",
+      summary: "Name for the clone (default: Copy of <source title>)"
+    },
+    {
+      flag: "--group-id <groupId>",
+      summary: "File the clone under an existing group (grp_\u2026), or ungrouped"
+    },
+    {
+      flag: "--group-name <name>",
+      summary: "File the clone under a group found (or created) by this name; not with --group-id"
+    },
     IDEMPOTENCY_FLAG
   ],
   examples: [
     "brew-cli emails clone eml_2SmZOWV3ZQ7W5x6g3m4p",
-    "brew-cli emails clone eml_2SmZOWV3ZQ7W5x6g3m4p --email-version-id emv_9f2kX"
+    "brew-cli emails clone eml_2SmZOWV3ZQ7W5x6g3m4p --email-version-id emv_9f2kX",
+    'brew-cli emails clone eml_2SmZOWV3ZQ7W5x6g3m4p --title "Fall sale (B)" --group-name "Fall campaign"'
   ],
   run: async ({ ctx, args, flags }) => {
     const emailVersionId = flagString(flags.emailVersionId);
+    const title = flagString(flags.title);
+    const groupId = flagString(flags.groupId);
+    const groupName = flagString(flags.groupName);
+    if (groupId !== void 0 && groupName !== void 0) {
+      throw new CliUsageError("Pass --group-id or --group-name, not both.");
+    }
     return {
       data: await ctx.client().emails.clone(
         asSdkInput({
           emailId: args.emailId ?? "",
-          ...emailVersionId === void 0 ? {} : { emailVersionId }
+          ...emailVersionId === void 0 ? {} : { emailVersionId },
+          ...title === void 0 ? {} : { title },
+          ...groupId === void 0 ? {} : { groupId },
+          ...groupName === void 0 ? {} : { groupName }
         }),
         requestOptions(flags)
       )
@@ -4853,12 +5291,16 @@ var emailsExportCommand = defineCommand({
   flags: [
     {
       flag: "--provider <provider>",
-      summary: "Connected ESP: braze, hubspot, klaviyo, mailchimp, iterable, postmark, onesignal, mailgun, sendgrid"
+      summary: "Connected ESP: braze, brevo, hubspot, klaviyo, mailchimp, mailjet, iterable, postmark, onesignal, mailgun, sendgrid"
     },
     {
       flag: "--template-name <name>",
       summary: "Template name in the ESP (default: the email title)"
     },
+    {
+      flag: "--sender-email <email>",
+      summary: "Brevo or Mailjet: the active sender to use (omit when the account has exactly one)"
+    },
     {
       flag: "--dry-run",
       summary: "Validate design, ownership, and ESP connection without creating a template"
@@ -4873,16 +5315,18 @@ var emailsExportCommand = defineCommand({
     const provider = flagString(flags.provider);
     if (provider === void 0) {
       throw new CliUsageError(
-        "--provider is required: braze, hubspot, klaviyo, mailchimp, iterable, postmark, onesignal, mailgun, or sendgrid."
+        "--provider is required: braze, brevo, hubspot, klaviyo, mailchimp, mailjet, iterable, postmark, onesignal, mailgun, or sendgrid."
       );
     }
     const templateName = flagString(flags.templateName);
+    const senderEmail = flagString(flags.senderEmail);
     return {
       data: await ctx.client().emails.export(
         asSdkInput({
           emailId: args.emailId ?? "",
           provider,
           ...templateName === void 0 ? {} : { templateName },
+          ...senderEmail === void 0 ? {} : { senderEmail },
           // The spec field is snake_case, unlike the rest of the API surface.
           ...flags.dryRun === true ? { dryRun: true } : {}
         }),
@@ -4967,20 +5411,44 @@ var emailsGetCommand = defineCommand({
   flags: [
     {
       flag: "--include <tokens>",
-      summary: "Comma-separated expansions: html, versions"
+      summary: "Comma-separated expansions: html, versions, text, links"
+    },
+    {
+      flag: "--email-version-id <emailVersionId>",
+      summary: "Read this saved version instead of the current head (ids from --include versions)"
+    },
+    {
+      flag: "--run-id <runId>",
+      summary: "Read the version a generate or edit run produced (the runId it returned)"
     }
   ],
   examples: [
     "brew-cli emails get eml_2SmZOWV3ZQ7W5x6g3m4p",
-    "brew-cli emails get eml_2SmZOWV3ZQ7W5x6g3m4p --include html,versions"
+    "brew-cli emails get eml_2SmZOWV3ZQ7W5x6g3m4p --include html,versions",
+    "brew-cli emails get eml_2SmZOWV3ZQ7W5x6g3m4p --include text,links",
+    "brew-cli emails get eml_2SmZOWV3ZQ7W5x6g3m4p --email-version-id emv_2SmZOWV3ZQ7W5x6g3m4p --include html"
   ],
   run: async ({ ctx, args, flags }) => {
+    const emailId = args.emailId ?? "";
     const include = flagString(flags.include);
+    const emailVersionId = flagString(flags.emailVersionId);
+    const runId = flagString(flags.runId);
+    if (emailVersionId !== void 0 && runId !== void 0) {
+      throw new CliUsageError(
+        "Pass --email-version-id or --run-id, not both: each selects the version to read."
+      );
+    }
+    if (emailVersionId === void 0 && runId === void 0) {
+      return {
+        data: await ctx.client().emails.get(emailId, include === void 0 ? void 0 : { include })
+      };
+    }
     return {
-      data: await ctx.client().emails.get(
-        args.emailId ?? "",
-        include === void 0 ? void 0 : { include }
-      )
+      data: await rawRequest(ctx, {
+        method: "GET",
+        path: `/v1/emails/${encodeURIComponent(emailId)}`,
+        query: { include, emailVersionId, runId }
+      })
     };
   }
 });
@@ -5000,7 +5468,12 @@ var emailsGetAuditCommand = defineCommand({
       isRequired: true
     }
   ],
-  flags: [LIMIT_FLAG, CURSOR_FLAG],
+  // Its own page size: a saved audit pages 1-50 findings (default 10), not
+  // the shared list's 1-100.
+  flags: [
+    { flag: "--limit <n>", summary: "Findings per page, 1-50 (default 10)" },
+    CURSOR_FLAG
+  ],
   examples: [
     "brew-cli emails get-audit 6f1e2d3c-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
     "brew-cli emails get-audit 6f1e2d3c-4b5a-4c7d-8e9f-0a1b2c3d4e5f --limit 20"
@@ -5340,6 +5813,14 @@ var emailsImportFigmaCommand = defineCommand({
       flag: "--subject-line <text>",
       summary: "The design's default inbox subject line"
     },
+    {
+      flag: "--group-id <groupId>",
+      summary: "File the design under an existing group (grp_\u2026), or ungrouped"
+    },
+    {
+      flag: "--group-name <name>",
+      summary: "File the design under a group found (or created) by this name; not with --group-id"
+    },
     IDEMPOTENCY_FLAG
   ],
   examples: [
@@ -5356,13 +5837,20 @@ var emailsImportFigmaCommand = defineCommand({
     const title = flagString(flags.title);
     const format = flagString(flags.format);
     const subjectLine = flagString(flags.subjectLine);
+    const groupId = flagString(flags.groupId);
+    const groupName = flagString(flags.groupName);
+    if (groupId !== void 0 && groupName !== void 0) {
+      throw new CliUsageError("Pass --group-id or --group-name, not both.");
+    }
     return {
       data: await ctx.client().emails.importFigma(
         asSdkInput({
           figmaUrl,
           ...title === void 0 ? {} : { title },
           ...format === void 0 ? {} : { format },
-          ...subjectLine === void 0 ? {} : { subjectLine }
+          ...subjectLine === void 0 ? {} : { subjectLine },
+          ...groupId === void 0 ? {} : { groupId },
+          ...groupName === void 0 ? {} : { groupName }
         }),
         requestOptions(flags)
       )
@@ -5828,8 +6316,48 @@ var fieldsListCommand = defineCommand({
   sdkMethod: "fields.list",
   route: { method: "GET", path: "/v1/fields" },
   commandClass: "read",
-  examples: ["brew-cli fields list"],
-  run: async ({ ctx }) => ({ data: await ctx.client().fields.list() })
+  flags: [
+    {
+      flag: "--include <tokens>",
+      summary: "Expansions: coverage (per-field fill stats: percent of contacts with a value, and top values)"
+    },
+    {
+      flag: "--audience-id <audienceId>",
+      summary: "Scope --include coverage to one saved audience (ignored without it)"
+    },
+    LIMIT_FLAG,
+    CURSOR_FLAG,
+    ALL_FLAG
+  ],
+  examples: [
+    "brew-cli fields list",
+    "brew-cli fields list --include coverage",
+    "brew-cli fields list --include coverage --audience-id aud_2SmZOWV3ZQ7W5x6g3m4p --all --json"
+  ],
+  run: async ({ ctx, flags }) => {
+    const input = {
+      include: flagString(flags.include),
+      audienceId: flagString(flags.audienceId),
+      limit: flagInt(flags.limit, "--limit"),
+      cursor: flagString(flags.cursor)
+    };
+    const fields = ctx.client().fields;
+    if (flags.all === true) {
+      const rows = await collectAll(
+        ctx,
+        (cursor) => fields.list(
+          asSdkInput({
+            ...input,
+            ...cursor === void 0 ? {} : { cursor }
+          })
+        )
+      );
+      return {
+        data: { data: rows, pagination: { cursor: null, hasMore: false } }
+      };
+    }
+    return { data: await fields.list(asSdkInput(input)) };
+  }
 });
 
 // src/commands/flows/get.ts
@@ -6024,9 +6552,31 @@ var integrationsListCommand = defineCommand({
   sdkMethod: "integrations.list",
   route: { method: "GET", path: "/v1/integrations" },
   commandClass: "read",
+  flags: [LIMIT_FLAG, CURSOR_FLAG, ALL_FLAG],
   examples: ["brew-cli integrations list", "brew-cli integrations list --json"],
-  run: async ({ ctx }) => {
-    const result = await ctx.client().integrations.list();
+  run: async ({ ctx, flags }) => {
+    const limit = flagInt(flags.limit, "--limit");
+    const cursor = flagString(flags.cursor);
+    if (limit === void 0 && cursor === void 0 && flags.all !== true) {
+      const result2 = await ctx.client().integrations.list();
+      return { data: result2, human: renderIntegrations(result2.data) };
+    }
+    const page = (after) => rawRequest(ctx, {
+      method: "GET",
+      path: "/v1/integrations",
+      query: {
+        limit: limit === void 0 ? void 0 : String(limit),
+        cursor: after
+      }
+    });
+    if (flags.all === true) {
+      const rows = await collectAll(ctx, (next) => page(next ?? cursor));
+      return {
+        data: { data: rows, pagination: { cursor: null, hasMore: false } },
+        human: renderIntegrations(rows)
+      };
+    }
+    const result = await page(cursor);
     return { data: result, human: renderIntegrations(result.data) };
   }
 });
@@ -6618,6 +7168,7 @@ var ALL_COMMANDS = [
   analyticsCampaignsCommand,
   analyticsAutomationsCommand,
   analyticsEventsCommand,
+  analyticsEventCountsCommand,
   analyticsSendsListCommand,
   analyticsSendsGetCommand,
   analyticsTriggerInstancesListCommand,
@@ -6637,6 +7188,11 @@ var ALL_COMMANDS = [
   domainsHealthCommand,
   domainsUpdateCommand,
   domainsDeleteCommand,
+  domainsUnsubscribesListCommand,
+  domainsUnsubscribesAddCommand,
+  domainsUnsubscribesRemoveCommand,
+  domainsUnsubscribesImportCommand,
+  domainsUnsubscribesExportCommand,
   contentGenerateImageCommand,
   contentGifCommand,
   contentTransformCommand,