@erdoai/cli 0.109.1 → 0.110.0

package/dist/index.js

@@ -1141,6 +1141,11 @@ var ErdoClient = class {
     const qs = q.toString();
     return this.request("GET", `/v1/datasets-purposes${qs ? `?${qs}` : ""}`);
   }
+  // Create an empty dataset with its declared columns. The server refuses a
+  // create without a schema unless the purpose's columns are platform-defined.
+  createDataset(input) {
+    return this.request("POST", "/v1/datasets-create", input);
+  }
   ensureDataset(input) {
     return this.request("POST", "/v1/datasets-ensure", input);
   }
@@ -6502,15 +6507,37 @@ datasetsCmd.command("purposes").description(
     fail(e);
   }
 });
+function readSchemaFile(path) {
+  const parsed = JSON.parse(readFileSync4(path, "utf8"));
+  const schema = Array.isArray(parsed) ? { columns: parsed } : parsed;
+  if (!schema || !Array.isArray(schema.columns)) {
+    throw new Error('--schema must contain a JSON columns array or {"columns": [...]} object');
+  }
+  return schema;
+}
+datasetsCmd.command("create <name>").description(
+  "Create an empty dataset with its columns declared up front. Every write is checked against the schema, which is set now rather than taken from the first rows. --schema is required unless the purpose is one whose columns Erdo defines (page events, widget events, widget leads)."
+).option("--schema <file>", "JSON file containing { columns: [...] } or a columns array").option("--purpose <purpose>", "the dataset's role in the org vocabulary, e.g. leads (see `erdo datasets purposes`)").option("--purpose-description <text>", "what writes and reads this purpose").option("--description <text>", "what the dataset holds").option("--separate", "deliberately create a second dataset for a purpose the org already has").action(async (name, opts) => {
+  try {
+    const result = await new ErdoClient().createDataset({
+      name,
+      ...opts.schema ? { schema: readSchemaFile(opts.schema) } : {},
+      ...opts.purpose ? { purpose: opts.purpose } : {},
+      ...opts.purposeDescription ? { purpose_description: opts.purposeDescription } : {},
+      ...opts.description ? { description: opts.description } : {},
+      ...opts.separate ? { separate_dataset: true } : {}
+    });
+    console.log(`${result.slug}	created${result.purpose ? `	${result.purpose}` : ""}`);
+    for (const warning of result.warnings ?? []) console.error(`warning: ${warning}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 datasetsCmd.command("ensure <purpose>").description(
   "Create or reuse the one dataset for a purpose and verify its declared producer contract. Refuses legacy splits and incompatible populated datasets instead of choosing silently."
 ).requiredOption("--schema <file>", "JSON file containing { columns: [...] } or a columns array").option("--name <name>", "dataset name when creation is required").option("--description <text>", "dataset description when creation is required").option("--purpose-description <text>", "what writes and reads this purpose").option("--preferred-dataset <slug>", "existing bound dataset slug or id to adopt").option("--email-column <name>", "for a leads purpose: which declared column holds the email (default email)").option("--phone-column <name>", "for a leads purpose: which declared column holds the phone (default phone)").action(async (purpose, opts) => {
   try {
-    const parsed = JSON.parse(readFileSync4(opts.schema, "utf8"));
-    const declaredSchema = Array.isArray(parsed) ? { columns: parsed } : parsed;
-    if (!declaredSchema || !Array.isArray(declaredSchema.columns)) {
-      throw new Error('--schema must contain a JSON columns array or {"columns": [...]} object');
-    }
+    const declaredSchema = readSchemaFile(opts.schema);
     const result = await new ErdoClient().ensureDataset({
       purpose,
       ...opts.name ? { name: opts.name } : {},

package/package.json

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