@erdoai/cli 0.71.0 → 0.72.0

package/dist/index.js

@@ -332,6 +332,33 @@ var ErdoClient = class {
       { successor_manager_slug: successorManagerSlug }
     );
   }
+  // Reads the Google Ads container a managed org already has under this manager
+  // and creates nothing, so it is safe to run against an org mid-setup: a 404
+  // means the org has no container here, not that anything is broken.
+  getManagedOrganizationAdsContainer(slug) {
+    return this.request(
+      "GET",
+      `/v1/managed-organizations/${encodeURIComponent(slug)}/ads-container`
+    );
+  }
+  // Creates the container — a sub-account under the manager's MCC plus the
+  // delegated connection inside the managed org. `replaceCurrentAccount` is the
+  // one input with consequences: provisioning refuses outright when the org is
+  // already running campaigns in another account, and passing this accepts that
+  // those campaigns are left behind, so the key is sent only when it is asked
+  // for rather than as a `false` the server has to read.
+  provisionManagedOrganizationAdsContainer(slug, input) {
+    const body = {};
+    if (input.descriptiveName) body.descriptive_name = input.descriptiveName;
+    if (input.currencyCode) body.currency_code = input.currencyCode;
+    if (input.timeZone) body.time_zone = input.timeZone;
+    if (input.replaceCurrentAccount) body.replace_current_account = true;
+    return this.request(
+      "POST",
+      `/v1/managed-organizations/${encodeURIComponent(slug)}/ads-container`,
+      body
+    );
+  }
   // --- Custom page domains: the branded hostnames the org's pages serve from ---
   listCustomDomains() {
     return this.request("GET", "/v1/custom-domains");
@@ -2001,6 +2028,76 @@ managed.command("add-member <orgSlug> <email>").description("Seat a person in a
     fail(e);
   }
 });
+function printAdsContainer(c) {
+  console.log(`org: ${c.org_slug}`);
+  console.log(`customer id: ${c.customer_id}`);
+  console.log(`manager (login customer id): ${c.login_customer_id}`);
+  console.log(`integration: ${c.integration_id}`);
+  if (c.descriptive_name) {
+    console.log(`name: ${c.descriptive_name}`);
+  }
+  console.log(`billing: ${c.billing_status}`);
+  if (c.billing_status === "unknown") {
+    process.stderr.write(
+      `Billing could not be checked for ${c.customer_id} \u2014 open the account in the Google Ads UI and confirm; this is not evidence that billing is missing.
+`
+    );
+  } else if (!c.billing_configured) {
+    process.stderr.write(
+      `Billing is ${c.billing_status}: ${c.customer_id} cannot serve until a payments profile is linked to it in the Google Ads UI.
+`
+    );
+  }
+}
+managed.command("ads-container <orgSlug>").description(
+  "Read the Google Ads account a managed org runs its campaigns in, or --provision one under your manager account"
+).option("--provision", "create the account and the org's delegated google_ads connection instead of reading them").option(
+  "--replace-current-account",
+  "with --provision: go ahead even though the org already runs campaigns in another account. Google Ads cannot move a campaign, so those campaigns stay behind and have to be rebuilt"
+).option("--name <descriptiveName>", "display name for the new account (default: the org's name and slug)").option("--currency <code>", "ISO currency code for the new account, e.g. USD").option("--time-zone <tz>", "IANA time zone for the new account, e.g. America/New_York").action(
+  async (orgSlug, opts) => {
+    try {
+      if (opts.replaceCurrentAccount && !opts.provision) {
+        fail(new Error("--replace-current-account only applies with --provision"));
+      }
+      const api = new ErdoClient();
+      if (!opts.provision) {
+        try {
+          printAdsContainer(await api.getManagedOrganizationAdsContainer(orgSlug));
+        } catch (e) {
+          if (e instanceof ErdoApiError && e.status === 404) {
+            fail(
+              new Error(
+                `${orgSlug} has no Google Ads container under this manager. Create one with: erdo org managed ads-container ${orgSlug} --provision`
+              )
+            );
+          }
+          throw e;
+        }
+        return;
+      }
+      const c = await api.provisionManagedOrganizationAdsContainer(orgSlug, {
+        descriptiveName: opts.name,
+        currencyCode: opts.currency,
+        timeZone: opts.timeZone,
+        replaceCurrentAccount: opts.replaceCurrentAccount
+      });
+      console.log(
+        c.already_provisioned ? `Google Ads container already existed for ${c.org_slug}` : `Created Google Ads container for ${c.org_slug}`
+      );
+      printAdsContainer(c);
+      const leftBehind = c.previous_campaign_count ?? 0;
+      if (c.previous_customer_id && leftBehind > 0) {
+        process.stderr.write(
+          `${leftBehind} campaign${leftBehind === 1 ? "" : "s"} stayed in ${c.previous_customer_id}, the account this replaced. Google Ads cannot move a campaign between accounts and nothing in ${c.org_slug} resolves that account any more, so they have to be rebuilt in ${c.customer_id}.
+`
+        );
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 managed.command("handoff-token <orgSlug>").description("Mint a one-time token offering an ownerless managed org to another manager; shown ONCE").requiredOption("--successor <managerOrgSlug>", "the manager org allowed to redeem the token").action(async (orgSlug, opts) => {
   try {
     const res = await new ErdoClient().createManagedOrganizationHandoffToken(orgSlug, opts.successor);
@@ -4009,7 +4106,13 @@ function grantList(v) {
 pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/--css accept @file").requiredOption("--title <title>", "page title").requiredOption("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option("--runtime <runtime>", "react-tailwind (default) or none").option(
   "--meta-title <title>",
   "public SEO title (browser tab + shared-link headline) \u2014 distinct from --title, the internal name"
-).option("--meta-description <description>", "public SEO description (shared-link preview / search result blurb)").option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
+).option("--meta-description <description>", "public SEO description (shared-link preview / search result blurb)").option(
+  "--meta-icon-asset <attachmentId>",
+  "public favicon: a Brand Style attachment id (apple-icon-180x180 / favicon-32x32) for the browser-tab icon"
+).option(
+  "--meta-image-asset <attachmentId>",
+  "public share image: a Brand Style attachment id (og-image / hero photo) for the link-preview card"
+).option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
   async (opts) => {
     try {
       const csv = (v) => v ? v.split(",").map((s) => s.trim()) : void 0;
@@ -4021,6 +4124,8 @@ pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/
         runtime: opts.runtime,
         meta_title: opts.metaTitle,
         meta_description: opts.metaDescription,
+        meta_icon_asset_id: opts.metaIconAsset,
+        meta_image_asset_id: opts.metaImageAsset,
         dataset_slugs: csv(opts.datasets),
         writable_dataset_slugs: csv(opts.writableDatasets),
         kv_slugs: csv(opts.kv),
@@ -4039,7 +4144,13 @@ pagesCmd.command("update <id>").description(
 ).option("--title <title>", "new title").option("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option(
   "--meta-title <title>",
   'new public SEO title (omit to keep current; pass "" to clear back to the default)'
-).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
+).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option(
+  "--meta-icon-asset <attachmentId>",
+  'new public favicon: a Brand Style attachment id (apple-icon-180x180 / favicon-32x32) (omit to keep current; pass "" to clear back to the default)'
+).option(
+  "--meta-image-asset <attachmentId>",
+  'new public share image: a Brand Style attachment id (og-image / hero photo) (omit to keep current; pass "" to clear)'
+).option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
   "--request-review",
   "ask the judge lenses to review the page after this update and report findings -- for material edits to a LIVE page (layout, forms/CTA, legal/compliance copy, restructured sections), not cosmetic tweaks. First builds and full rewrites are already reviewed automatically"
 ).action(
@@ -4052,6 +4163,8 @@ pagesCmd.command("update <id>").description(
         css: readMaybeFile(opts.css),
         meta_title: opts.metaTitle,
         meta_description: opts.metaDescription,
+        meta_icon_asset_id: opts.metaIconAsset,
+        meta_image_asset_id: opts.metaImageAsset,
         dataset_slugs: grantList(opts.datasets),
         writable_dataset_slugs: grantList(opts.writableDatasets),
         kv_slugs: grantList(opts.kv),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.71.0",
+  "version": "0.72.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {