@erdoai/cli 0.45.0 → 0.47.0

package/dist/index.js

@@ -281,12 +281,41 @@ var ErdoClient = class {
   createManagerKey() {
     return this.request("POST", "/v1/manager-key");
   }
+  // --- Custom page domains: the branded hostnames the org's pages serve from ---
+  listCustomDomains() {
+    return this.request("GET", "/v1/custom-domains");
+  }
+  createCustomDomain(domain) {
+    return this.request("POST", "/v1/custom-domains", { domain });
+  }
+  deleteCustomDomain(domain) {
+    return this.request(
+      "DELETE",
+      `/v1/custom-domains/${encodeURIComponent(domain)}`
+    );
+  }
+  // Moves a domain to another org you also administer, keeping its CDN hostname
+  // and certificate — the cutover is atomic, with no re-validation downtime.
+  transferCustomDomain(domain, targetOrg) {
+    return this.request(
+      "POST",
+      `/v1/custom-domains/${encodeURIComponent(domain)}/transfer`,
+      { target_org: targetOrg }
+    );
+  }
   // Run a read-only HogQL query against the org's page-analytics events. Rows are
   // positional per columns; enabled:false means page analytics is off for the org
   // (not zero traffic). A rejected query surfaces PostHog's message as the error.
   queryPageAnalytics(query) {
     return this.request("POST", "/v1/page-analytics/query", { query });
   }
+  // Read which analytics destinations the org's published pages send visitor data
+  // to — the check that stops "this audience is big enough to retarget" being
+  // concluded from traffic no pixel was ever tagging. Read-only: destinations are
+  // Erdo-provisioned, never caller-set.
+  getPageTracking() {
+    return this.request("GET", "/v1/page-tracking");
+  }
   listEvalSuites() {
     return this.request("GET", "/v1/evals/suites");
   }
@@ -655,6 +684,8 @@ var ErdoClient = class {
   listDatasets(params) {
     const q = new URLSearchParams();
     if (params?.class) q.set("class", params.class);
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.offset !== void 0) q.set("offset", String(params.offset));
     const qs = q.toString();
     return this.request("GET", `/v1/datasets${qs ? `?${qs}` : ""}`);
   }
@@ -859,6 +890,8 @@ var ErdoClient = class {
     if (opts.status) params.set("status", opts.status);
     if (opts.limit) params.set("limit", String(opts.limit));
     if (opts.workstream_slug) params.set("workstream_slug", opts.workstream_slug);
+    if (opts.subject_resource_type) params.set("subject_resource_type", opts.subject_resource_type);
+    if (opts.subject_resource_id) params.set("subject_resource_id", opts.subject_resource_id);
     const qs = params.toString();
     return this.request(
       "GET",
@@ -2372,45 +2405,89 @@ runsCmd.command("get <id>").description("Show an agent run (status, output, trac
   }
 });
 var approvalsCmd = program.command("approvals").description("List and decide approval requests (actions agents paused on)");
-approvalsCmd.command("list").description("List approval requests, optionally filtered by status").option("-s, --status <status>", "pending | approved | rejected | expired (default: all)").option("-l, --limit <n>", "max requests", (v) => parseInt(v, 10)).option("--workstream <slug>", "only approvals for this workstream").option("--json", "output raw JSON").action(async (opts) => {
-  try {
-    const res = await new ErdoClient().listApprovals({
-      status: opts.status,
-      limit: opts.limit,
-      workstream_slug: opts.workstream
-    });
-    if (opts.json) {
-      print(res);
-      return;
-    }
-    for (const r of res.requests) {
-      const occ = r.occurrence_count && r.occurrence_count > 1 ? `	\xD7${r.occurrence_count}` : "";
-      console.log(
-        `${r.id}	${r.status}	${r.action_key}	${r.action_display}	${r.created_at}${occ}`
-      );
+approvalsCmd.command("list").description("List approval requests, optionally filtered by status").option("-s, --status <status>", "pending | approved | rejected | expired (default: all)").option("-l, --limit <n>", "max requests", (v) => parseInt(v, 10)).option("--workstream <slug>", "only approvals for this workstream").option(
+  "--subject-type <type>",
+  "only approvals whose subject resource is of this type (e.g. paid_media_campaign)"
+).option("--subject-id <id>", "only approvals whose subject resource has this id").option("--json", "output raw JSON").action(
+  async (opts) => {
+    try {
+      const res = await new ErdoClient().listApprovals({
+        status: opts.status,
+        limit: opts.limit,
+        workstream_slug: opts.workstream,
+        subject_resource_type: opts.subjectType,
+        subject_resource_id: opts.subjectId
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      for (const r of res.requests) {
+        const occ = r.occurrence_count && r.occurrence_count > 1 ? `	\xD7${r.occurrence_count}` : "";
+        console.log(
+          `${r.id}	${r.status}	${r.action_key}	${r.action_display}	${r.created_at}${occ}`
+        );
+      }
+    } catch (e) {
+      fail(e);
     }
-  } catch (e) {
-    fail(e);
   }
-});
+);
 approvalsCmd.command("decide <id>").description("Approve or reject a pending approval request").option("--approve", "approve the request").option("--reject", "reject the request").option(
   "--scope <scope>",
   "once (default) | always_this_job | always_this_workstream | always_org | always_user",
   "once"
-).action(async (id, opts) => {
-  try {
-    if (opts.approve === opts.reject) {
-      throw new Error("specify exactly one of --approve or --reject");
+).option(
+  "--option <n>",
+  "for standing (non-once) approvals: use the request's Nth scope option (1-based) as the policy's parameter constraints \u2014 list them with `erdo approvals list --json`",
+  (v) => parseInt(v, 10)
+).option(
+  "--constraints <json>",
+  `explicit parameter constraints for the standing policy, e.g. '{"spreadsheet_id":{"values":["..."]}}'`
+).action(
+  async (id, opts) => {
+    try {
+      if (opts.approve === opts.reject) {
+        throw new Error("specify exactly one of --approve or --reject");
+      }
+      if (opts.option !== void 0 && opts.constraints !== void 0) {
+        throw new Error("specify at most one of --option or --constraints");
+      }
+      const client = new ErdoClient();
+      let constraints;
+      if (opts.constraints !== void 0) {
+        try {
+          constraints = JSON.parse(opts.constraints);
+        } catch {
+          throw new Error(
+            `--constraints must be JSON, e.g. '{"spreadsheet_id":{"values":["abc"]}}'`
+          );
+        }
+      } else if (opts.option !== void 0) {
+        const res2 = await client.listApprovals({ status: "pending" });
+        const req = res2.requests.find((r) => r.id === id);
+        if (!req) {
+          throw new Error(`pending approval ${id} not found`);
+        }
+        const options = req.scope_options ?? [];
+        if (opts.option < 1 || opts.option > options.length) {
+          const listing = options.length ? options.map((o, i) => `  ${i + 1}. ${o.label}`).join("\n") : "  (none \u2014 pass --constraints instead)";
+          throw new Error(`--option must be 1..${options.length}; available options:
+${listing}`);
+        }
+        constraints = options[opts.option - 1].constraints;
+      }
+      const res = await client.decideApproval(id, {
+        decision: opts.approve ? "approved" : "rejected",
+        scope: opts.scope,
+        parameter_constraints: constraints
+      });
+      console.log(res.message);
+    } catch (e) {
+      fail(e);
     }
-    const res = await new ErdoClient().decideApproval(id, {
-      decision: opts.approve ? "approved" : "rejected",
-      scope: opts.scope
-    });
-    console.log(res.message);
-  } catch (e) {
-    fail(e);
   }
-});
+);
 var attnCmd = program.command("attention").description("The attention feed \u2014 digests, choices, escalations awaiting a human");
 attnCmd.command("list").description("List attention items").option("--status <status...>", "open | answered | dismissed | expired").option("--open", "shorthand for --status open").option("--engine-actions", "only engine-generated items").option("-n, --limit <n>", "max items", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
   async (opts) => {
@@ -2910,15 +2987,76 @@ pagesCmd.command("review-result <id>").description("Read a page review by id \u2
     fail(e);
   }
 });
+var domainsCmd = pagesCmd.command("domains").description("Custom domains the org's published pages serve from");
+domainsCmd.command("list").description("List the org's custom domains with live lifecycle status").action(async () => {
+  try {
+    const { domains } = await new ErdoClient().listCustomDomains();
+    if (domains.length === 0) {
+      console.log("No custom domains. Register one with: erdo pages domains add <domain>");
+      return;
+    }
+    for (const d of domains) {
+      const checked = d.last_checked_at ? `checked ${d.last_checked_at}` : "never checked";
+      const reason = d.error_reason ? `	${d.error_reason}` : "";
+      console.log(`${d.domain}	${d.status}	${checked}${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) => {
+  try {
+    const d = await new ErdoClient().createCustomDomain(domain);
+    console.log(`${d.domain}: ${d.status}`);
+    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) {
+        console.log(`${r.type}	${r.name}	${r.value}`);
+      }
+    }
+  } 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);
+    console.log(`removed: ${res.domain}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+domainsCmd.command("transfer <domain> <targetOrg>").description("Move a domain to another org you administer, keeping its certificate (no serving downtime)").action(async (domain, targetOrg) => {
+  try {
+    const d = await new ErdoClient().transferCustomDomain(domain, targetOrg);
+    console.log(`${d.domain} now belongs to ${targetOrg} (status: ${d.status})`);
+  } catch (e) {
+    fail(e);
+  }
+});
 var datasetsCmd = program.command("datasets").description("Datasets");
 datasetsCmd.command("list").description("List datasets").option(
   "--class <class>",
   "filter by structural class: 'table' or 'scratch', or 'all' to include scratch analysis by-products (default hides scratch)"
-).action(async (opts) => {
+).option(
+  "-l, --limit <n>",
+  "max datasets to return (default 20, max 100)",
+  (v) => parseInt(v, 10)
+).option("--offset <n>", "skip the first n datasets (newest first)", (v) => parseInt(v, 10)).action(async (opts) => {
   try {
-    const { datasets } = await new ErdoClient().listDatasets({ class: opts.class });
+    const { datasets, total } = await new ErdoClient().listDatasets({
+      class: opts.class,
+      limit: opts.limit,
+      offset: opts.offset
+    });
     for (const d of datasets)
       console.log(`${d.slug}	${d.type}	${d.status}	${d.class ?? "-"}	${d.name}`);
+    const shown = (opts.offset ?? 0) + datasets.length;
+    if (total > shown) {
+      console.error(`(showing ${datasets.length} of ${total} \u2014 use --limit/--offset for more)`);
+    } else {
+      console.error(`(${total} dataset${total === 1 ? "" : "s"})`);
+    }
   } catch (e) {
     fail(e);
   }
@@ -3019,7 +3157,7 @@ function printAnalyticsTable(columns, rows) {
   console.log(widths.map((w) => "-".repeat(w)).join("  "));
   for (const r of rows) console.log(line(columns.map((_, i) => cell(r[i]))));
 }
-var analytics = program.command("analytics").description("Query page analytics (how published pages perform with real visitors)");
+var analytics = program.command("analytics").description("Page analytics \u2014 what is tracking your published pages, and how they perform with real visitors");
 analytics.command("query <hogql>").description("Run a read-only HogQL query against this org's page-analytics events").option("--json", "print the raw JSON result instead of a table").action(async (hogql, opts) => {
   try {
     const res = await new ErdoClient().queryPageAnalytics(hogql);
@@ -3038,6 +3176,44 @@ analytics.command("query <hogql>").description("Run a read-only HogQL query agai
     fail(e);
   }
 });
+var TRACKING_KINDS = [
+  { kind: "session_analytics", what: "heatmaps, session replay, and the events behind `erdo analytics query`" },
+  { kind: "google_analytics", what: "GA4 measurement" },
+  { kind: "meta_pixel", what: "cookies visitors so Meta retargeting audiences can be built" }
+];
+analytics.command("tracking").description("Show which analytics destinations this org's published pages send visitor data to").option("--json", "print the raw JSON result instead of a table").action(async (opts) => {
+  try {
+    const res = await new ErdoClient().getPageTracking();
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    const destinations = res.destinations ?? [];
+    const byKind = new Map(destinations.map((d) => [d.kind, d]));
+    const rows = TRACKING_KINDS.map(({ kind, what }) => {
+      const d = byKind.get(kind);
+      const status = d === void 0 ? "not configured" : d.enabled ? "on" : "configured, off";
+      return [kind, status, d?.public_id ?? "", d?.provider ?? "", what];
+    });
+    for (const d of destinations) {
+      if (!TRACKING_KINDS.some((k) => k.kind === d.kind)) {
+        rows.push([d.kind, d.enabled ? "on" : "configured, off", d.public_id ?? "", d.provider ?? "", ""]);
+      }
+    }
+    printAnalyticsTable(["kind", "status", "public id", "provider", "what it does"], rows);
+    console.log(`
+session replay input masking: ${res.mask_inputs ? "on" : "OFF \u2014 form values are recorded"}`);
+    console.log(`consent: ${res.consent}${res.consent === "required" ? " (recording waits on a consent banner, so thin volume may be the gate, not the traffic)" : ""}`);
+    if (!byKind.get("meta_pixel")?.enabled) {
+      console.log(`
+No Meta pixel is firing on these pages, so no retargeting audience is accumulating \u2014 page traffic alone does not mean those visitors can be served ads.`);
+    }
+    console.log(`
+Erdo's own page-events beacon is provisioned per page at render time and is not listed above \u2014 it records independently of every vendor here.`);
+  } catch (e) {
+    fail(e);
+  }
+});
 var OPERATORS = ["equals", "not_equals", "greater_than", "less_than", "contains", "not_contains", "between"];
 function parseCondition(s) {
   const m = s.trim().match(/^(\S+)\s+(\S+)\s+([\s\S]+)$/);
@@ -3075,7 +3251,7 @@ integrationsCmd.command("apps [query]").description("Search connectable apps (na
     fail(e);
   }
 });
-integrationsCmd.command("connect <app>").description("Connect an app \u2014 pass credentials with -c, or get a browser connect URL for OAuth apps").option("-c, --credential <key=value...>", "credential field (repeatable)", (v, acc) => acc.concat(v), []).option("-n, --name <name>", "display name for the connection").action(async (app, opts) => {
+integrationsCmd.command("connect <app>").description("Connect an app \u2014 pass its API key or other credentials with -c, or omit them to get a browser connect URL for OAuth apps").option("-c, --credential <key=value...>", "credential field, e.g. -c api_key=\u2026 (repeatable); rejected by OAuth apps, which have no credential to pass", (v, acc) => acc.concat(v), []).option("-n, --name <name>", "display name for the connection").action(async (app, opts) => {
   try {
     let credentials;
     if (opts.credential.length) {

package/package.json

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