@erdoai/cli 0.27.0 → 0.29.0

package/dist/index.js

@@ -209,6 +209,12 @@ var ErdoClient = class {
   setAutonomyMode(mode) {
     return this.request("PUT", "/v1/autonomy-mode", { mode });
   }
+  // 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 });
+  }
   listEvalSuites() {
     return this.request("GET", "/v1/evals/suites");
   }
@@ -524,6 +530,21 @@ var ErdoClient = class {
       timezone
     });
   }
+  // Fetch rows from a dataset, optionally shaped by a SQL query and/or opting into
+  // named saved filters. filter_names are additive on top of the dataset's default
+  // filters — they narrow the result, never bypass a default. An unknown name is
+  // rejected server-side with the available names.
+  fetchDatasetContents(slug, opts) {
+    return this.request(
+      "POST",
+      `/v1/datasets/${encodeURIComponent(slug)}/fetch`,
+      {
+        sql_query: opts.sql_query,
+        limit: opts.limit,
+        filter_names: opts.filter_names
+      }
+    );
+  }
   uploadDatasetFile(body) {
     return this.request("POST", "/v1/datasets-upload", body);
   }
@@ -2236,6 +2257,24 @@ datasetsCmd.command("query <slug> <question>").description("Ask a natural-langua
     fail(e);
   }
 });
+datasetsCmd.command("fetch <slug>").description("Fetch rows from a dataset, optionally shaped by SQL and named filters").option("-q, --sql <query>", "SQL query to filter/transform the rows").option("-l, --limit <n>", "max rows to return", (v) => parseInt(v, 10)).option(
+  "-f, --filter <name>",
+  "opt into a saved filter by name (repeatable); additive on top of the dataset's default filters (see: erdo datasets filter list <slug>)",
+  (v, acc) => acc.concat(v),
+  []
+).action(async (slug, opts) => {
+  try {
+    print(
+      await new ErdoClient().fetchDatasetContents(slug, {
+        sql_query: opts.sql,
+        limit: opts.limit,
+        filter_names: opts.filter.length ? opts.filter : void 0
+      })
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
 var MAX_UPLOAD_BYTES = 20 * 1024 * 1024;
 datasetsCmd.command("upload <file>").description("Upload a file (CSV, Excel, JSON, ...) and create a dataset from it").option("-n, --name <name>", "display name for the dataset (defaults to the filename)").option("-d, --description <text>", "description shown to agents analyzing the dataset").action(async (file, opts) => {
   try {
@@ -2278,6 +2317,33 @@ datasetsCmd.command("from-integration <app>").description("Create a dataset back
     fail(e);
   }
 });
+function printAnalyticsTable(columns, rows) {
+  const cell = (v) => v === null || v === void 0 ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+  const widths = columns.map((c, i) => Math.max(c.length, ...rows.map((r) => cell(r[i]).length), 0));
+  const line = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+  console.log(line(columns));
+  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)");
+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);
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    if (!res.enabled) {
+      console.log("Page analytics is not enabled for this organization \u2014 turn it on in the Erdo app, then query real traffic here.");
+      return;
+    }
+    printAnalyticsTable(res.columns, res.rows);
+    if (res.truncated) console.log(`
+(rows truncated at the cap \u2014 aggregate further or add a tighter filter/LIMIT)`);
+  } catch (e) {
+    fail(e);
+  }
+});
 var OPERATORS = ["equals", "not_equals", "greater_than", "less_than", "contains", "between"];
 function parseCondition(s) {
   const m = s.trim().match(/^(\S+)\s+(\S+)\s+([\s\S]+)$/);
@@ -2375,15 +2441,24 @@ pipelinesCmd.command("get <slug>").description("Show one event pipeline \u2014 s
     fail(e);
   }
 });
-filterCmd.command("add <slug>").description("Add a default filter to a dataset").requiredOption(
+filterCmd.command("add <slug>").description("Add a filter to a dataset (default-on unless --no-default)").requiredOption(
   "--where <condition>",
   "a '<column> <operator> <value>' condition (repeatable, AND-combined), e.g. --where 'email contains @example.com'. Operators: " + OPERATORS.join(", ") + " (for 'between' use 'col between 10,100')",
   collect,
   []
-).option("--name <name>", "optional human-readable label, e.g. 'Exclude test submissions'").action(async (slug, opts) => {
+).option("--name <name>", "optional human-readable label, e.g. 'Exclude test submissions'").option(
+  "--no-default",
+  "save as a named view that reads opt into with 'datasets fetch --filter <name>', instead of applying to every read"
+).action(async (slug, opts) => {
   try {
     const conditions = opts.where.map(parseCondition);
-    print(await new ErdoClient().createDatasetFilter(slug, { name: opts.name, conditions }));
+    print(
+      await new ErdoClient().createDatasetFilter(slug, {
+        name: opts.name,
+        conditions,
+        is_default: opts.default === false ? false : void 0
+      })
+    );
   } catch (e) {
     fail(e);
   }

package/package.json

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