@erdoai/cli 0.67.0 → 0.68.0

package/dist/index.js

@@ -331,8 +331,30 @@ var ErdoClient = class {
   listCustomDomains() {
     return this.request("GET", "/v1/custom-domains");
   }
-  createCustomDomain(domain) {
-    return this.request("POST", "/v1/custom-domains", { domain });
+  // `managerDefault` registers the domain and points the orgs this one manages at
+  // it in one step, for a manager setting up its very first branded hostname. The
+  // key is left out of the body when false so an ordinary registration sends what
+  // it always sent; changing the flag on a domain that is already live goes
+  // through setCustomDomainManagerDefault, which does not touch the certificate.
+  createCustomDomain(domain, managerDefault) {
+    return this.request(
+      "POST",
+      "/v1/custom-domains",
+      managerDefault ? { domain, manager_default: true } : { domain }
+    );
+  }
+  // Marks a domain the org already owns as the one its managed orgs serve their
+  // pages from, or clears it. At most one domain per org carries the flag, so
+  // promoting a second demotes the first in the same write — the managed orgs
+  // never see a moment with no default and fall back to platform URLs. Only a
+  // manager account with at least one client org can set it; clearing is always
+  // allowed, so an org that has since let its last client go can still tidy up.
+  setCustomDomainManagerDefault(domain, managerDefault) {
+    return this.request(
+      "PATCH",
+      `/v1/custom-domains/${encodeURIComponent(domain)}/manager-default`,
+      { manager_default: managerDefault }
+    );
   }
   deleteCustomDomain(domain) {
     return this.request(
@@ -888,6 +910,69 @@ var ErdoClient = class {
   listDatasetRevisions(slug) {
     return this.request("GET", `/v1/datasets/${encodeURIComponent(slug)}/revisions`);
   }
+  // --- bounded outreach ---
+  putOutreachBatch(batch, body) {
+    return this.request(
+      "PUT",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}`,
+      body
+    );
+  }
+  listOutreachBatches(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    if (opts.initiative_ref) q.set("initiative_ref", opts.initiative_ref);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-batches${qs ? `?${qs}` : ""}`
+    );
+  }
+  getOutreachBatch(batch) {
+    return this.request(
+      "GET",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}`
+    );
+  }
+  listOutreachBatchRecipients(batch, opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}/recipients${qs ? `?${qs}` : ""}`
+    );
+  }
+  actOnOutreachBatch(batch, body) {
+    return this.request(
+      "POST",
+      `/v1/outreach-batches/${encodeURIComponent(batch)}/actions`,
+      body
+    );
+  }
+  putOutreachConsent(body) {
+    return this.request("PUT", "/v1/outreach-consents", body);
+  }
+  listOutreachConsents(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.limit !== void 0) q.set("limit", String(opts.limit));
+    if (opts.cursor) q.set("cursor", opts.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/outreach-consents${qs ? `?${qs}` : ""}`
+    );
+  }
+  getOutreachConsent(opts) {
+    const q = new URLSearchParams();
+    if (opts.grant_ref) q.set("grant_ref", opts.grant_ref);
+    if (opts.recipient_ref) q.set("recipient_ref", opts.recipient_ref);
+    if (opts.phone_raw) q.set("phone_raw", opts.phone_raw);
+    if (opts.default_country) q.set("default_country", opts.default_country);
+    return this.request("GET", `/v1/outreach-consents?${q.toString()}`);
+  }
   uploadDatasetFile(body) {
     return this.request("POST", "/v1/datasets-upload", body);
   }
@@ -1534,6 +1619,25 @@ function timedOutMessage(threadID) {
 function print(value) {
   console.log(JSON.stringify(value, null, 2));
 }
+function readJSONObject(file, label) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync4(file, "utf8"));
+  } catch (error) {
+    throw new Error(`${label} must be a readable JSON file: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  if (parsed === null || Array.isArray(parsed) || typeof parsed !== "object") {
+    throw new Error(`${label} must contain one JSON object`);
+  }
+  return parsed;
+}
+function requireOutreachProject() {
+  if (!process.env.ERDO_PROJECT?.trim()) {
+    throw new Error(
+      "outreach commands require a project: pass --project <uuid> (and --org when the key can reach more than one organization)"
+    );
+  }
+}
 function printPageReview(review) {
   if (!review) return;
   if (!review.reviewed) {
@@ -3924,17 +4028,21 @@ domainsCmd.command("list").description("List the org's custom domains with live
     }
     for (const d of domains) {
       const checked = d.last_checked_at ? `checked ${d.last_checked_at}` : "never checked";
+      const managerDefault = d.manager_default ? "	manager default" : "";
       const reason = d.error_reason ? `	${d.error_reason}` : "";
-      console.log(`${d.domain}	${d.status}	${checked}${reason}`);
+      console.log(`${d.domain}	${d.status}	${checked}${managerDefault}${reason}`);
     }
   } catch (e) {
     fail(e);
   }
 });
-domainsCmd.command("add <domain>").description("Register a custom domain (a direct subdomain, e.g. pages.acme.com) and print the DNS records to create").action(async (domain) => {
+domainsCmd.command("add <domain>").description("Register a custom domain (a direct subdomain, e.g. pages.acme.com) and print the DNS records to create").option(
+  "--manager-default",
+  "also point the orgs you manage at this domain, for a manager registering its first branded hostname"
+).action(async (domain, opts) => {
   try {
-    const d = await new ErdoClient().createCustomDomain(domain);
-    console.log(`${d.domain}: ${d.status}`);
+    const d = await new ErdoClient().createCustomDomain(domain, opts.managerDefault);
+    console.log(`${d.domain}: ${d.status}${d.manager_default ? " (manager default)" : ""}`);
     if (d.dns_records.length > 0) {
       process.stderr.write("Create these records at the domain's DNS provider:\n");
       for (const r of d.dns_records) {
@@ -3945,6 +4053,20 @@ domainsCmd.command("add <domain>").description("Register a custom domain (a dire
     fail(e);
   }
 });
+domainsCmd.command("manager-default <domain>").description(
+  "Make this the domain the orgs you manage serve their pages from when they have registered none of their own \u2014 a client with its own domain keeps it \u2014 or clear that with --unset"
+).option("--unset", "clear the flag instead, returning the managed orgs to the platform pages host").action(async (domain, opts) => {
+  try {
+    const d = await new ErdoClient().setCustomDomainManagerDefault(domain, !opts.unset);
+    if (d.manager_default) {
+      console.log(`${d.domain} is now the default domain for the orgs you manage (status: ${d.status})`);
+    } else {
+      console.log(`${d.domain} is no longer the default domain for the orgs you manage`);
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
 domainsCmd.command("remove <domain>").description("Remove a custom domain registration (stops it serving pages)").action(async (domain) => {
   try {
     const res = await new ErdoClient().deleteCustomDomain(domain);
@@ -4168,6 +4290,98 @@ sentEmailsCmd.command("list").description("List sent email, newest first, includ
     }
   }
 );
+var outreachCmd = program.command("outreach").description("Consent-gated SMS outreach to an explicit reviewed selection of up to 700 people");
+var outreachBatchesCmd = outreachCmd.command("batches").description("Prepare and control outreach batches");
+outreachBatchesCmd.command("put <batch>").description("Create one immutable draft preview from a JSON declaration; this never starts sending").requiredOption("-f, --file <path>", "JSON object containing the batch declaration and recipients").action(async (batch, opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().putOutreachBatch(batch, readJSONObject(opts.file, "--file")));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("list").description("List outreach batches in the required project").option("-l, --limit <n>", "max batches to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding page").option("--initiative <ref>", "return only this outreach initiative before pagination").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().listOutreachBatches({
+      limit: opts.limit,
+      cursor: opts.cursor,
+      initiative_ref: opts.initiative
+    }));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("get <batch>").description("Read a batch summary, or its paged recipient receipts").option("--recipients", "return recipient eligibility, delivery, and response receipts").option("-l, --limit <n>", "max recipients to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding recipient page").action(async (batch, opts) => {
+  try {
+    requireOutreachProject();
+    const client = new ErdoClient();
+    print(
+      opts.recipients ? await client.listOutreachBatchRecipients(batch, opts) : await client.getOutreachBatch(batch)
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachBatchesCmd.command("act <batch> <action>").description("Apply a replay-safe arm, pause, resume, or cancel action").requiredOption("--action-ref <ref>", "stable idempotency reference for this operator action").option("--preview-revision <revision>", "arm only this reviewed preview revision").option("--eligible-count <n>", "arm only when this many recipients remain eligible", (v) => parseInt(v, 10)).option("--message-hash <hash>", "arm only the reviewed message hash").option("--source-snapshot <ref>", "pause, resume, or cancel only the rendered source snapshot").option("--batch-state <state>", "pause, resume, or cancel only the rendered batch state").option("--batch-updated-at <timestamp>", "pause, resume, or cancel only the rendered batch version").action(
+  async (batch, action, opts) => {
+    try {
+      requireOutreachProject();
+      print(
+        await new ErdoClient().actOnOutreachBatch(batch, {
+          action,
+          action_ref: opts.actionRef,
+          expected_preview_revision: opts.previewRevision,
+          expected_eligible_count: opts.eligibleCount,
+          expected_message_hash: opts.messageHash,
+          expected_source_snapshot_ref: opts.sourceSnapshot,
+          expected_batch_state: opts.batchState,
+          expected_batch_updated_at: opts.batchUpdatedAt
+        })
+      );
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+var outreachConsentsCmd = outreachCmd.command("consents").description("Declare and read auditable SMS consent evidence");
+outreachConsentsCmd.command("put").description("Declare or revoke one consent grant from a JSON object").requiredOption("-f, --file <path>", "JSON object containing the consent declaration").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().putOutreachConsent(readJSONObject(opts.file, "--file")));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachConsentsCmd.command("list").description("List consent grants in the required project").option("-l, --limit <n>", "max grants to return", (v) => parseInt(v, 10)).option("--cursor <cursor>", "opaque next_cursor from the preceding page").action(async (opts) => {
+  try {
+    requireOutreachProject();
+    print(await new ErdoClient().listOutreachConsents(opts));
+  } catch (e) {
+    fail(e);
+  }
+});
+outreachConsentsCmd.command("get [grant-ref]").description("Read one consent grant by reference, or by recipient and phone").option("--recipient-ref <ref>", "stable lead identity when the grant reference is not known").option("--phone <phone>", "source phone recorded for the recipient").option("--country <code>", "ISO country hint used to normalize --phone").action(async (grantRef, opts) => {
+  try {
+    requireOutreachProject();
+    const byGrant = Boolean(grantRef);
+    const byRecipient = Boolean(opts.recipientRef || opts.phone || opts.country);
+    if (byGrant === byRecipient) {
+      throw new Error("consents get requires either <grant-ref> or all of --recipient-ref, --phone, and --country");
+    }
+    if (!byGrant && !(opts.recipientRef && opts.phone && opts.country)) {
+      throw new Error("consents get by recipient requires --recipient-ref, --phone, and --country together");
+    }
+    print(await new ErdoClient().getOutreachConsent({
+      grant_ref: grantRef,
+      recipient_ref: opts.recipientRef,
+      phone_raw: opts.phone,
+      default_country: opts.country
+    }));
+  } catch (e) {
+    fail(e);
+  }
+});
 sentEmailsCmd.command("get <emailID>").description("Read one sent email, including exact bodies and delivery evidence").action(async (emailID) => {
   try {
     print(await new ErdoClient().getSentEmail(emailID));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.67.0",
+  "version": "0.68.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {
@@ -35,7 +35,7 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",
     "build:check": "tsc --noEmit",
-    "test": "node --import tsx --test src/input.test.ts",
+    "test": "node --import tsx --test src/*.test.ts",
     "dev": "tsx src/index.ts",
     "postinstall": "node scripts/postinstall.mjs",
     "prepublishOnly": "npm run build"