@koda-sl/baker-cli 0.567.0 → 0.569.0-dev.1b455b3fe

package/dist/catalogs-2R5RV4L7.js

@@ -0,0 +1,783 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  fileArg,
+  loadJsonFileArg,
+  mergePayload,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  upper
+} from "./chunk-ZOCAGPS5.js";
+import {
+  retailerIdFilter
+} from "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-7TVVYP7K.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import "./chunk-LZR7LSYO.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/catalogs.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var outputArg = { type: "string", description: "json|csv|jsonl|md", default: "json" };
+var accountArg = {
+  type: "string",
+  description: "Numeric account ID or act_N (whose Business owns the catalog)"
+};
+var schemaAccount = { type: "string", description: "Ad account the change is staged under", required: false };
+var schemaOutput = { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" };
+function emit(rows, args, hints) {
+  const fmt = csvOrJson(args);
+  if (fmt !== "json") {
+    writeAdsOutput(rows, fmt, void 0, hints);
+    return;
+  }
+  writeJsonEnvelope(hints.length > 0 ? { ok: true, data: rows, hints } : { ok: true, data: rows });
+}
+function requireCatalogId(args) {
+  const id = args["catalog-id"];
+  if (typeof id !== "string" || id.length === 0) {
+    failWriteValidation("pass --catalog-id (from `baker ads meta catalogs --business-id <id>`, or a meta_temp_* ref)");
+  }
+  return id;
+}
+function stringArg(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function jsonArg(value, flag) {
+  if (typeof value !== "string" || value.length === 0) return void 0;
+  try {
+    return JSON.parse(value);
+  } catch {
+    failWriteValidation(`--${flag} takes JSON, e.g. '{"brand":{"eq":"Acme"}}'`);
+  }
+}
+async function contents(edge, args) {
+  const params = { "catalog-id": requireCatalogId(args), edge };
+  if (args.full) params.full = "true";
+  if (stringArg(args["retailer-id"])) params["retailer-id"] = String(args["retailer-id"]);
+  return await apiGet("/api/ads/meta/catalog-contents", params);
+}
+registerSchema({
+  command: "ads.meta.catalogs",
+  description: "Product catalogs a Business owns (for catalog / Advantage+ catalog ads), or one catalog's product sets with --catalog-id.",
+  args: {
+    "business-id": { type: "string", description: "Business ID (baker ads meta businesses)", required: false },
+    "catalog-id": { type: "string", description: "List this catalog's product sets", required: false },
+    "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
+    output: schemaOutput
+  }
+});
+var catalogsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Product catalogs on a Business, or a catalog's product sets. Runs by default. Example: baker ads meta catalogs --business-id 601050769212882; --catalog-id <id> for its sets"
+  },
+  args: {
+    "business-id": { type: "string", description: "Business ID \u2014 from `baker ads meta businesses`" },
+    "catalog-id": { type: "string", description: "List the product sets of this catalog" },
+    "no-cache": NO_CACHE_ARG,
+    output: outputArg
+  },
+  run: async ({ args }) => {
+    try {
+      const cache = args["no-cache"] ? { "skip-cache": "true" } : {};
+      if (args["catalog-id"]) {
+        const rows2 = await apiGet("/api/ads/meta/product-sets", {
+          "catalog-id": args["catalog-id"],
+          ...cache
+        });
+        emit(rows2, args, [
+          `A catalog ad set promotes one product set: promoted_object {"product_set_id":"<id>"}; product_count 0 means the set's filter matches nothing yet. Read just after a publish with --no-cache.`
+        ]);
+        return;
+      }
+      if (!args["business-id"]) {
+        writeAdsJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "pass --business-id (from `baker ads meta businesses`) or --catalog-id"
+          }
+        });
+        process.exit(1);
+      }
+      const rows = await apiGet("/api/ads/meta/catalogs", {
+        "business-id": args["business-id"],
+        ...cache
+      });
+      emit(
+        rows,
+        args,
+        rows.length === 0 ? [
+          "This Business owns no product catalogs. Stage one with `baker ads meta catalogs create --name \u2026`, or \u2014 for a catalog another Business shares with it \u2014 ask for its id and read it with `catalogs --catalog-id <id>` (shared catalogs are read, never changed)."
+        ] : [
+          "`catalogs --catalog-id <id>` lists a catalog's product sets; `catalogs products --catalog-id <id>` its products."
+        ]
+      );
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.create",
+  description: "Stage a new product catalog on the ad account's own Business, made at publish. Needs the Catalog permission for Meta.",
+  args: {
+    "account-id": schemaAccount,
+    name: { type: "string", description: "Catalog name", required: true },
+    pixel: { type: "string", description: "Pixel to connect (repeatable) \u2014 catalog ads need one", required: false }
+  }
+});
+var catalogCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new product catalog on the ad account's own Business. ${STAGED_NOTE}
+Connect the account's pixel with --pixel (\`baker ads meta pixels\`): Meta runs catalog ads only on a catalog with one.
+Then add products (\`catalogs products create --catalog-id meta_temp_\u2026\`) and a product set to advertise.
+Example: baker ads meta catalogs create --account-id act_123 --name "Spring shop" --pixel 1275507706837548`
+  },
+  args: {
+    "account-id": accountArg,
+    name: { type: "string", description: "Catalog name" },
+    pixel: { type: "string", description: "Pixel to connect once it exists (repeatable) \u2014 catalog ads need one" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const pixels = repeatedValues(rawArgs, "pixel", args.pixel);
+    await stageOp(
+      {
+        kind: "productCatalog.create",
+        accountId: await bareAccountId(args),
+        payload: { name: args.name, event_sources: pixels.length > 0 ? pixels : void 0 }
+      },
+      [
+        "Add products with `catalogs products create --catalog-id <ref>` and a set with `catalogs sets create --catalog-id <ref>`."
+      ]
+    );
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.update",
+  description: "Stage a change to a product catalog the ad account's Business owns: a new name, pixels to connect (catalog ads need one) or disconnect.",
+  args: {
+    id: { type: "positional", description: "Catalog id", required: true },
+    "account-id": schemaAccount,
+    name: { type: "string", description: "New name", required: false },
+    pixel: { type: "string", description: "Pixel to connect (repeatable)", required: false },
+    "unlink-pixel": { type: "string", description: "Pixel to disconnect (repeatable)", required: false }
+  }
+});
+var catalogUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Rename a product catalog, or connect / disconnect pixels. ${STAGED_NOTE}
+Example: baker ads meta catalogs update 1798573158016525 --account-id act_123 --pixel 1275507706837548`
+  },
+  args: {
+    id: { type: "positional", description: "Catalog id", required: true },
+    "account-id": accountArg,
+    name: { type: "string", description: "New name" },
+    pixel: { type: "string", description: "Pixel to connect (repeatable) \u2014 from `baker ads meta pixels`" },
+    "unlink-pixel": { type: "string", description: "Pixel to disconnect (repeatable)" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const pixels = repeatedValues(rawArgs, "pixel", args.pixel);
+    const unlink = repeatedValues(rawArgs, "unlink-pixel", args["unlink-pixel"]);
+    await stageOp({
+      kind: "productCatalog.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "catalog"),
+      payload: {
+        name: args.name,
+        event_sources: pixels.length > 0 ? pixels : void 0,
+        unlink_event_sources: unlink.length > 0 ? unlink : void 0
+      }
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.delete",
+  description: "Stage deleting a product catalog with every product, product set and feed in it. Delete the ads, ad sets and campaigns that use it in the same chat.",
+  args: { id: { type: "positional", description: "Catalog id", required: true }, "account-id": schemaAccount }
+});
+var catalogDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Delete a product catalog and everything in it \u2014 runs after every other change in the publish. ${STAGED_NOTE}
+Example: baker ads meta catalogs delete 1798573158016525 --account-id act_123`
+  },
+  args: { id: { type: "positional", description: "Catalog id", required: true }, "account-id": accountArg },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "productCatalog.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "catalog"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var productFieldArgs = {
+  name: { type: "string", description: "Title shoppers see" },
+  description: { type: "string", description: "Description" },
+  price: { type: "string", description: 'Price in major units, e.g. "19.99"' },
+  "sale-price": { type: "string", description: "Sale price in major units" },
+  currency: { type: "string", description: "Three-letter currency code, e.g. EUR (needed with a price)" },
+  availability: {
+    type: "string",
+    description: '"in stock" (default), "out of stock", "preorder", "available for order", "discontinued"'
+  },
+  condition: { type: "string", description: "new (default), refurbished, used" },
+  url: { type: "string", description: "The product's own page (https) \u2014 where its ad sends people" },
+  "image-url": {
+    type: "string",
+    description: "Public https picture Meta fetches (a library image's address works)"
+  },
+  "additional-image-url": { type: "string", description: "More pictures (repeatable)" },
+  brand: { type: "string", description: "Brand" }
+};
+var productFieldSchema = Object.fromEntries(
+  Object.entries(productFieldArgs).map(([key, arg]) => [key, { ...arg, required: false }])
+);
+function productFieldsFromArgs(args, rawArgs) {
+  const extra = repeatedValues(rawArgs, "additional-image-url", args["additional-image-url"]);
+  return {
+    name: args.name,
+    description: args.description,
+    price: stringArg(args.price),
+    sale_price: stringArg(args["sale-price"]),
+    currency: upper(args.currency),
+    availability: stringArg(args.availability)?.toLowerCase(),
+    condition: stringArg(args.condition)?.toLowerCase(),
+    url: args.url,
+    image_url: args["image-url"],
+    additional_image_urls: extra.length > 0 ? extra : void 0,
+    brand: args.brand
+  };
+}
+registerSchema({
+  command: "ads.meta.catalogs.products",
+  description: "A catalog's products, compact (id, retailer id, name, price, availability, review status); --full for every field and Meta's errors on each.",
+  args: {
+    "catalog-id": { type: "string", description: "Catalog id", required: true },
+    "retailer-id": { type: "string", description: "Only the product with this retailer id", required: false },
+    full: { type: "boolean", description: "Every field, and Meta's errors on each product", required: false },
+    output: schemaOutput
+  }
+});
+var productsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "A catalog's products (up to 500). Runs by default. Example: baker ads meta catalogs products --catalog-id 1798573158016525"
+  },
+  args: {
+    "catalog-id": { type: "string", description: "Catalog id" },
+    "retailer-id": { type: "string", description: "Only the product with this retailer id" },
+    full: { type: "boolean", description: "Every field, and Meta's errors on each product" },
+    output: outputArg
+  },
+  run: async ({ args }) => {
+    try {
+      const rows = await contents("products", args);
+      const rejected = rows.filter((row) => row.review_status === "rejected").length;
+      emit(rows, args, [
+        ...rows.length === 0 ? ["No products yet \u2014 stage some with `catalogs products create`."] : [],
+        ...rejected > 0 ? [
+          `${rejected} product(s) were rejected by Meta's review \u2014 \`--full\` shows why; a rejected product is never shown in an ad.`
+        ] : []
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.products.create",
+  description: "Stage a product in a catalog (or one this chat creates), added at publish. Fake or real, every product needs a retailer id, name, description, price + currency, page URL and picture URL.",
+  args: {
+    "account-id": schemaAccount,
+    "catalog-id": { type: "string", description: "Catalog id or meta_temp_* ref", required: true },
+    "retailer-id": { type: "string", description: "Your own id for the product (SKU)", required: true },
+    ...productFieldSchema,
+    file: { type: "string", description: "JSON file with the whole payload", required: false }
+  }
+});
+var productCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a product in a catalog. ${STAGED_NOTE}
+Example: baker ads meta catalogs products create --account-id act_123 --catalog-id meta_temp_\u2026 --retailer-id SKU-1 --name "Solar panel" --description "400 W panel" --price 199.00 --currency EUR --url https://shop.example/panel --image-url https://shop.example/panel.jpg`
+  },
+  args: {
+    "account-id": accountArg,
+    "catalog-id": { type: "string", description: "Catalog id, or meta_temp_* of a catalog this chat creates" },
+    "retailer-id": { type: "string", description: "Your own id for the product (SKU) \u2014 what product sets filter on" },
+    ...productFieldArgs,
+    ...fileArg("product.create", "JSON file with the whole payload")
+  },
+  run: async ({ args, rawArgs }) => {
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      catalog_id: args["catalog-id"],
+      retailer_id: args["retailer-id"],
+      ...productFieldsFromArgs(args, rawArgs)
+    });
+    await stageOp({ kind: "product.create", accountId: await bareAccountId(args), payload }, [
+      "Group products for an ad with `catalogs sets create --catalog-id <id> --retailer-id <sku> \u2026`."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.products.update",
+  description: "Stage changes to a product's fields (a price names its currency).",
+  args: {
+    id: { type: "positional", description: "Product id", required: true },
+    "account-id": schemaAccount,
+    ...productFieldSchema
+  }
+});
+var productUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Change a product's fields. ${STAGED_NOTE}
+Example: baker ads meta catalogs products update 39108967418750368 --account-id act_123 --price 179.00 --currency EUR --availability "out of stock"`
+  },
+  args: {
+    id: { type: "positional", description: "Product id", required: true },
+    "account-id": accountArg,
+    ...productFieldArgs
+  },
+  run: async ({ args, rawArgs }) => {
+    await stageOp({
+      kind: "product.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "product"),
+      payload: productFieldsFromArgs(args, rawArgs)
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.products.delete",
+  description: "Stage deleting a product from its catalog.",
+  args: { id: { type: "positional", description: "Product id", required: true }, "account-id": schemaAccount }
+});
+var productDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Delete a product from its catalog. ${STAGED_NOTE}
+Example: baker ads meta catalogs products delete 39108967418750368 --account-id act_123`
+  },
+  args: { id: { type: "positional", description: "Product id", required: true }, "account-id": accountArg },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "product.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "product"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var productsCommand = defineCommand({
+  meta: {
+    name: "products",
+    description: `A catalog's products.
+  baker ads meta catalogs products --catalog-id <id> [--full]          \u2014 list
+  baker ads meta catalogs products create --catalog-id <id> --retailer-id SKU-1 --name \u2026 --price 19.99 --currency EUR \u2026
+  baker ads meta catalogs products update <id> --price 17.99 --currency EUR
+  baker ads meta catalogs products delete <id>`
+  },
+  subCommands: {
+    list: productsListCommand,
+    create: productCreateCommand,
+    update: productUpdateCommand,
+    delete: productDeleteCommand
+  },
+  args: {
+    "catalog-id": { type: "string", description: "Catalog id" },
+    "retailer-id": { type: "string", description: "Only the product with this retailer id" },
+    full: { type: "boolean", description: "Every field, and Meta's errors on each product" },
+    output: outputArg
+  },
+  default: "list"
+});
+function productSetFilterFromArgs(args, rawArgs) {
+  const retailerIds = repeatedValues(rawArgs, "retailer-id", args["retailer-id"]).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
+  const filter = jsonArg(args.filter, "filter");
+  if (filter && retailerIds.length > 0) failWriteValidation("pass --filter or --retailer-id, not both");
+  return filter ?? (retailerIds.length > 0 ? retailerIdFilter(retailerIds) : void 0);
+}
+var setRuleArgs = {
+  "retailer-id": {
+    type: "string",
+    description: "A product in the set, by retailer id (repeatable, or comma-separated)"
+  },
+  filter: {
+    type: "string",
+    description: `Meta's rule as JSON, e.g. '{"and":[{"brand":{"eq":"Acme"}},{"price":{"lt":5000}}]}' \u2014 operators: is_any, is_not_any, eq, neq, contains, not_contains, i_contains, i_not_contains, starts_with, lt, lte, gt, gte (a price in minor units)`
+  }
+};
+registerSchema({
+  command: "ads.meta.catalogs.sets",
+  description: "A catalog's product sets, with how many products each matches.",
+  args: {
+    "catalog-id": { type: "string", description: "Catalog id", required: true },
+    "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
+    output: schemaOutput
+  }
+});
+var setsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "A catalog's product sets. Runs by default. Example: baker ads meta catalogs sets --catalog-id 1798573158016525"
+  },
+  args: { "catalog-id": { type: "string", description: "Catalog id" }, "no-cache": NO_CACHE_ARG, output: outputArg },
+  run: async ({ args }) => {
+    try {
+      const params = { "catalog-id": requireCatalogId(args) };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const rows = await apiGet("/api/ads/meta/product-sets", params);
+      emit(rows, args, [
+        "An ad set shows one set (`adsets create --product-set-id <id>`); a catalog creative names it too (`creatives create --type catalog --product-set-id <id>`)."
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.sets.create",
+  description: "Stage a product set \u2014 the products an Advantage+ catalog ad or a collection shows \u2014 by retailer id or Meta's filter rule. Without either it holds the whole catalog.",
+  args: {
+    "account-id": schemaAccount,
+    "catalog-id": { type: "string", description: "Catalog id or meta_temp_* ref", required: true },
+    name: { type: "string", description: "Set name", required: true },
+    "retailer-id": { type: "string", description: "Retailer id of a product (repeatable)", required: false },
+    filter: { type: "string", description: "Meta's filter rule as JSON", required: false }
+  }
+});
+var setCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a product set. ${STAGED_NOTE}
+Example: baker ads meta catalogs sets create --account-id act_123 --catalog-id meta_temp_\u2026 --name "Panels" --retailer-id SKU-1 --retailer-id SKU-2
+Rule: --filter '{"brand":{"eq":"Acme"}}'. Without --retailer-id or --filter the set holds the whole catalog.`
+  },
+  args: {
+    "account-id": accountArg,
+    "catalog-id": { type: "string", description: "Catalog id, or meta_temp_* of a catalog this chat creates" },
+    name: { type: "string", description: "Set name" },
+    ...setRuleArgs
+  },
+  run: async ({ args, rawArgs }) => {
+    await stageOp(
+      {
+        kind: "productSet.create",
+        accountId: await bareAccountId(args),
+        payload: {
+          catalog_id: args["catalog-id"],
+          name: args.name,
+          filter: productSetFilterFromArgs(args, rawArgs)
+        }
+      },
+      [
+        "Advertise it: `adsets create --product-set-id <ref>` under a campaign with `--catalog-id`, then `creatives create --type catalog --product-set-id <ref>`."
+      ]
+    );
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.sets.update",
+  description: "Stage a new name or a new rule for a product set (the whole rule is replaced).",
+  args: {
+    id: { type: "positional", description: "Product set id", required: true },
+    "account-id": schemaAccount,
+    name: { type: "string", description: "New name", required: false },
+    "retailer-id": { type: "string", description: "Retailer id of a product (repeatable)", required: false },
+    filter: { type: "string", description: "Meta's filter rule as JSON", required: false }
+  }
+});
+var setUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Rename a product set or replace its rule. ${STAGED_NOTE}
+Example: baker ads meta catalogs sets update 1748674113031942 --account-id act_123 --retailer-id SKU-1 --retailer-id SKU-3`
+  },
+  args: {
+    id: { type: "positional", description: "Product set id", required: true },
+    "account-id": accountArg,
+    name: { type: "string", description: "New name" },
+    ...setRuleArgs
+  },
+  run: async ({ args, rawArgs }) => {
+    await stageOp({
+      kind: "productSet.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "product set"),
+      payload: { name: args.name, filter: productSetFilterFromArgs(args, rawArgs) }
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.sets.delete",
+  description: "Stage deleting a product set. Delete or repoint the ad sets and creatives that show it in the same chat.",
+  args: { id: { type: "positional", description: "Product set id", required: true }, "account-id": schemaAccount }
+});
+var setDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Delete a product set \u2014 after the ads, ad sets and creatives this chat deletes. ${STAGED_NOTE}
+Example: baker ads meta catalogs sets delete 1748674113031942 --account-id act_123`
+  },
+  args: { id: { type: "positional", description: "Product set id", required: true }, "account-id": accountArg },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "productSet.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "product set"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var setsCommand = defineCommand({
+  meta: {
+    name: "sets",
+    description: `A catalog's product sets.
+  baker ads meta catalogs sets --catalog-id <id>                     \u2014 list
+  baker ads meta catalogs sets create --catalog-id <id> --name \u2026 --retailer-id SKU-1 [--filter '<json>']
+  baker ads meta catalogs sets update <id> --name \u2026
+  baker ads meta catalogs sets delete <id>`
+  },
+  subCommands: { list: setsListCommand, create: setCreateCommand, update: setUpdateCommand, delete: setDeleteCommand },
+  args: { "catalog-id": { type: "string", description: "Catalog id" }, "no-cache": NO_CACHE_ARG, output: outputArg },
+  default: "list"
+});
+var scheduleArgs = {
+  url: { type: "string", description: "https address of the feed file (CSV, TSV, XML) Meta fetches" },
+  interval: { type: "string", description: "HOURLY, DAILY or WEEKLY" },
+  hour: { type: "string", description: "Hour of day 0\u201323" },
+  day: { type: "string", description: "Day for a WEEKLY schedule, e.g. MONDAY" }
+};
+function feedScheduleFromArgs(args) {
+  if (args.url === void 0 && args.interval === void 0 && args.hour === void 0 && args.day === void 0) {
+    return void 0;
+  }
+  return {
+    url: args.url,
+    interval: upper(args.interval) ?? "DAILY",
+    hour: numberFlag(args.hour, "--hour"),
+    day_of_week: upper(args.day)
+  };
+}
+registerSchema({
+  command: "ads.meta.catalogs.feeds",
+  description: "A catalog's data feeds: each one's schedule and its last upload's errors and warnings.",
+  args: { "catalog-id": { type: "string", description: "Catalog id", required: true }, output: schemaOutput }
+});
+var feedsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "A catalog's feeds. Runs by default. Example: baker ads meta catalogs feeds --catalog-id 1798573158016525"
+  },
+  args: { "catalog-id": { type: "string", description: "Catalog id" }, output: outputArg },
+  run: async ({ args }) => {
+    try {
+      emit(await contents("feeds", args), args, []);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.feeds.create",
+  description: "Stage a data feed in a catalog: a file Meta fetches on a schedule and replaces the catalog's products from. Without --url it waits for uploads.",
+  args: {
+    "account-id": schemaAccount,
+    "catalog-id": { type: "string", description: "Catalog id or meta_temp_* ref", required: true },
+    name: { type: "string", description: "Feed name", required: true },
+    url: { type: "string", description: "Feed file address (https)", required: false },
+    interval: { type: "string", description: "HOURLY, DAILY (default) or WEEKLY", required: false },
+    hour: { type: "string", description: "Hour 0\u201323", required: false },
+    day: { type: "string", description: "Day for WEEKLY", required: false }
+  }
+});
+var feedCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a scheduled data feed in a catalog. ${STAGED_NOTE}
+Example: baker ads meta catalogs feeds create --account-id act_123 --catalog-id 1798573158016525 --name "Daily feed" --url https://shop.example/feed.csv --interval DAILY --hour 3`
+  },
+  args: {
+    "account-id": accountArg,
+    "catalog-id": { type: "string", description: "Catalog id, or meta_temp_* of a catalog this chat creates" },
+    name: { type: "string", description: "Feed name" },
+    ...scheduleArgs
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "productFeed.create",
+      accountId: await bareAccountId(args),
+      payload: { catalog_id: args["catalog-id"], name: args.name, schedule: feedScheduleFromArgs(args) }
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.feeds.update",
+  description: "Stage a new name or schedule for a feed (the whole schedule is replaced).",
+  args: {
+    id: { type: "positional", description: "Feed id", required: true },
+    "account-id": schemaAccount,
+    name: { type: "string", description: "New name", required: false },
+    url: { type: "string", description: "Feed file address (https)", required: false },
+    interval: { type: "string", description: "HOURLY, DAILY or WEEKLY", required: false },
+    hour: { type: "string", description: "Hour 0\u201323", required: false },
+    day: { type: "string", description: "Day for WEEKLY", required: false }
+  }
+});
+var feedUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Rename a feed or replace its schedule. ${STAGED_NOTE}
+Example: baker ads meta catalogs feeds update 1157910959893469 --account-id act_123 --url https://shop.example/feed.csv --interval WEEKLY --day MONDAY --hour 4`
+  },
+  args: {
+    id: { type: "positional", description: "Feed id", required: true },
+    "account-id": accountArg,
+    name: { type: "string", description: "New name" },
+    ...scheduleArgs
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "productFeed.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "feed"),
+      payload: { name: args.name, schedule: feedScheduleFromArgs(args) }
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.catalogs.feeds.delete",
+  description: "Stage deleting a feed. Its products stay in the catalog.",
+  args: { id: { type: "positional", description: "Feed id", required: true }, "account-id": schemaAccount }
+});
+var feedDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Delete a data feed; its products stay in the catalog. ${STAGED_NOTE}
+Example: baker ads meta catalogs feeds delete 1157910959893469 --account-id act_123`
+  },
+  args: { id: { type: "positional", description: "Feed id", required: true }, "account-id": accountArg },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "productFeed.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "feed"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var feedsCommand = defineCommand({
+  meta: {
+    name: "feeds",
+    description: `A catalog's data feeds.
+  baker ads meta catalogs feeds --catalog-id <id>                    \u2014 list, with the last upload's errors
+  baker ads meta catalogs feeds create --catalog-id <id> --name \u2026 --url https://\u2026 --interval DAILY
+  baker ads meta catalogs feeds update <id> --interval WEEKLY --day MONDAY --url https://\u2026
+  baker ads meta catalogs feeds delete <id>`
+  },
+  subCommands: {
+    list: feedsListCommand,
+    create: feedCreateCommand,
+    update: feedUpdateCommand,
+    delete: feedDeleteCommand
+  },
+  args: { "catalog-id": { type: "string", description: "Catalog id" }, output: outputArg },
+  default: "list"
+});
+registerSchema({
+  command: "ads.meta.catalogs.diagnostics",
+  description: "Meta's diagnostics for a catalog \u2014 product problems (missing fields, rejected pictures) and event-matching issues, grouped by type.",
+  args: { "catalog-id": { type: "string", description: "Catalog id", required: true }, output: schemaOutput }
+});
+var diagnosticsCommand = defineCommand({
+  meta: {
+    name: "diagnostics",
+    description: "What Meta says is wrong with a catalog. Example: baker ads meta catalogs diagnostics --catalog-id 1798573158016525"
+  },
+  args: { "catalog-id": { type: "string", description: "Catalog id" }, output: outputArg },
+  run: async ({ args }) => {
+    try {
+      const rows = await contents("diagnostics", args);
+      emit(rows, args, rows.length === 0 ? ["Meta reports no problems with this catalog."] : []);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var catalogsCommand = defineCommand({
+  meta: {
+    name: "catalogs",
+    description: `Product catalogs \u2014 what Advantage+ catalog and collection ads show. Reading is open; changing needs the Catalog permission for Meta, and Baker changes only catalogs the ad account's own Business owns.
+  baker ads meta catalogs --business-id <id>                          \u2014 catalogs; --catalog-id <id> for its product sets
+  baker ads meta catalogs create --name \u2026 --pixel <id>  |  update <id> --name \u2026 --pixel <id>  |  delete <id>
+  baker ads meta catalogs products \u2026  |  sets \u2026  |  feeds \u2026  |  diagnostics --catalog-id <id>`
+  },
+  subCommands: {
+    list: catalogsListCommand,
+    create: catalogCreateCommand,
+    update: catalogUpdateCommand,
+    delete: catalogDeleteCommand,
+    products: productsCommand,
+    sets: setsCommand,
+    feeds: feedsCommand,
+    diagnostics: diagnosticsCommand
+  },
+  args: {
+    "business-id": { type: "string", description: "Business ID" },
+    "catalog-id": { type: "string", description: "Catalog id" },
+    "no-cache": NO_CACHE_ARG,
+    output: outputArg
+  },
+  default: "list"
+});
+export {
+  catalogsCommand,
+  feedScheduleFromArgs,
+  productFieldsFromArgs,
+  productSetFilterFromArgs
+};
+//# sourceMappingURL=catalogs-2R5RV4L7.js.map