@stndrds/cli 1.0.0-alpha.226 → 1.0.0-alpha.228

package/dist/bin.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/program.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import { Command } from "commander";
 
 // src/client.ts
@@ -32,16 +32,10 @@ function createClient(config) {
     "Content-Type": "application/json",
     ...tenantId ? { "X-Tenant-ID": tenantId } : {}
   };
-  async function request(method, path, options) {
-    const url = buildUrl(apiUrl, path, options?.params);
+  async function sendRequest(url, init) {
     let response;
     try {
-      response = await fetch(url, {
-        method,
-        headers,
-        body: options?.body ? JSON.stringify(options.body) : void 0,
-        signal: AbortSignal.timeout(3e4)
-      });
+      response = await fetch(url, { ...init, signal: AbortSignal.timeout(3e4) });
     } catch (error) {
       if (error instanceof TypeError || error instanceof DOMException && error.name === "TimeoutError") {
         throw new ApiClientError(0, `Could not connect to ${apiUrl}. Is the server running?`);
@@ -58,6 +52,19 @@ function createClient(config) {
     }
     return data;
   }
+  function request(method, path, options) {
+    const url = buildUrl(apiUrl, path, options?.params);
+    return sendRequest(url, {
+      method,
+      headers,
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+  }
+  function postMultipart(path, form) {
+    const url = buildUrl(apiUrl, path);
+    const { "Content-Type": _ct, ...multipartHeaders } = headers;
+    return sendRequest(url, { method: "POST", headers: multipartHeaders, body: form });
+  }
   return {
     get(path, params) {
       return request("GET", path, { params });
@@ -73,7 +80,8 @@ function createClient(config) {
     },
     delete(path) {
       return request("DELETE", path);
-    }
+    },
+    postMultipart
   };
 }
 
@@ -200,6 +208,43 @@ function registerAutofillCommand(program) {
   );
 }
 
+// src/commands/connectors.ts
+import chalk3 from "chalk";
+var PROVIDERS = ["gmail", "outlook"];
+function resolveScope(scope) {
+  return scope === "actor" ? "actor" : "tenant";
+}
+function registerConnectorsCommand(program) {
+  const connectors = program.command("connectors").description("Manage email connectors (Gmail / Outlook OAuth connections)");
+  connectors.command("list").description("List connector connections").option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/connectors/connections", {
+      scope: resolveScope(opts.scope)
+    });
+    formatOutput(result, getFormat(cmd));
+  });
+  connectors.command("connect").description("Start an OAuth flow and return the authorization URL to open").requiredOption("--provider <provider>", "connector provider (gmail or outlook)").option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
+    if (!PROVIDERS.includes(opts.provider)) {
+      throw new Error(`--provider must be one of: ${PROVIDERS.join(", ")}`);
+    }
+    const client = getClientFromCommand(cmd);
+    const result = await client.post("/connectors/auth/start", {
+      provider: opts.provider,
+      scope: resolveScope(opts.scope)
+    });
+    formatOutput(result, getFormat(cmd));
+  });
+  connectors.command("disconnect").description("Disconnect (delete) a connector connection").argument("<id>", "connection ID").option("--yes", "disconnect without confirmation").action(async (id, opts, cmd) => {
+    if (!opts.yes) {
+      throw new Error('Disconnecting a connector is explicit. Re-run with "--yes" to confirm.');
+    }
+    const client = getClientFromCommand(cmd);
+    await client.delete(`/connectors/connections/${id}`);
+    process.stdout.write(`${chalk3.green("\u2713")} Connector connection ${id} disconnected.
+`);
+  });
+}
+
 // src/commands/documents.ts
 function registerDocumentsCommand(program) {
   const documents = program.command("documents").description("Manage documents");
@@ -263,8 +308,40 @@ function registerDocumentsCommand(program) {
   });
 }
 
+// src/commands/folders.ts
+import { readFile } from "fs/promises";
+function registerFoldersCommand(program) {
+  const folders = program.command("folders").description("Manage record drive folders");
+  folders.command("reconcile-paths").description("Create a folder tree on a record drive from paths").argument("<object>", "object name (e.g. contacts)").argument("<recordId>", "record ID owning the drive").option(
+    "--path <path>",
+    "folder path to create (repeatable)",
+    (val, acc) => {
+      acc.push(val);
+      return acc;
+    },
+    []
+  ).option("--paths-file <file>", "file containing one path per line").option("--mode <mode>", "reconcile mode: repair or dryRun", "repair").action(async (objectName, recordId, opts, cmd) => {
+    const paths = [...opts.path];
+    if (opts.pathsFile) {
+      const content = await readFile(opts.pathsFile, "utf-8");
+      const filePaths = content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+      paths.push(...filePaths);
+    }
+    if (paths.length === 0) {
+      throw new Error("No paths provided. Pass at least one --path or a non-empty --paths-file.");
+    }
+    const client = getClientFromCommand(cmd);
+    const result = await client.post(`/folders/record-drive/${recordId}/reconcile-paths`, {
+      objectName,
+      paths,
+      mode: opts.mode
+    });
+    formatOutput(result, getFormat(cmd));
+  });
+}
+
 // src/commands/keys.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 function registerKeysCommand(program) {
   const keys = program.command("keys").description("Manage Standards API keys");
   keys.command("list").description("List API keys").action(async (_opts, cmd) => {
@@ -291,12 +368,14 @@ function registerKeysCommand(program) {
     }
     const client = getClientFromCommand(cmd);
     await client.delete(`/api-keys/${id}`);
-    process.stdout.write(`${chalk3.green("\u2713")} API key ${id} revoked.
+    process.stdout.write(`${chalk4.green("\u2713")} API key ${id} revoked.
 `);
   });
 }
 
 // src/commands/records.ts
+import { readFile as readFile2 } from "fs/promises";
+import { basename } from "path";
 function parseSortFlag(sort) {
   const [attribute, direction = "asc"] = sort.split(":");
   return [{ attribute, direction }];
@@ -353,15 +432,31 @@ function registerRecordsCommand(program) {
     const result = await client.post(`/records/${objectName}/search`, body);
     formatOutput(result, getFormat(cmd));
   });
+  records.command("attach-document").description("Upload and attach a local file to a record").argument("<object>", "object name (e.g. contacts)").argument("<recordId>", "record ID").requiredOption("--file <path>", "local file path to upload").option("--attribute <attr>", "attribute name to attach the document to").option("--parent-id <folderId>", "parent folder ID").option("--title <title>", "document title (defaults to filename)").action(async (objectName, recordId, opts, cmd) => {
+    const fileContent = await readFile2(opts.file);
+    const fileName = basename(opts.file);
+    const title = opts.title ?? fileName;
+    const form = new FormData();
+    form.append("files", new Blob([fileContent]), fileName);
+    form.append("title", title);
+    if (opts.attribute) form.append("attributeName", opts.attribute);
+    if (opts.parentId) form.append("parentId", opts.parentId);
+    const client = getClientFromCommand(cmd);
+    const result = await client.postMultipart(
+      `/records/${objectName}/${recordId}/documents/attach`,
+      form
+    );
+    formatOutput(result, getFormat(cmd));
+  });
 }
 
 // src/commands/root.ts
 import { stdin as input, stdout as output } from "process";
 import { createInterface } from "readline/promises";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 
 // src/config.ts
-import { mkdir, readFile, rm, writeFile } from "fs/promises";
+import { mkdir, readFile as readFile3, rm, writeFile } from "fs/promises";
 import { homedir } from "os";
 import { dirname, join } from "path";
 var DEFAULT_API_URL = "http://localhost:4100/v1";
@@ -375,7 +470,7 @@ function getConfigPath() {
 }
 async function readConfig() {
   try {
-    const raw = await readFile(getConfigPath(), "utf8");
+    const raw = await readFile3(getConfigPath(), "utf8");
     const parsed = JSON.parse(raw);
     return {
       currentProfile: parsed.currentProfile,
@@ -498,7 +593,7 @@ function registerRootCommands(program) {
     await client.get("/api-keys");
     await upsertProfile({ name: opts.name, apiUrl: opts.url, apiKey });
     process.stdout.write(
-      `${chalk4.green("\u2713")} Standards instance "${opts.name}" saved and selected.
+      `${chalk5.green("\u2713")} Standards instance "${opts.name}" saved and selected.
 `
     );
     process.stdout.write(`  API URL: ${opts.url}
@@ -510,7 +605,7 @@ function registerRootCommands(program) {
   });
   program.command("use").description("Select the active Standards instance").argument("<name>", "instance name").action(async (name) => {
     await setCurrentProfile(name);
-    process.stdout.write(`${chalk4.green("\u2713")} Standards instance "${name}" selected.
+    process.stdout.write(`${chalk5.green("\u2713")} Standards instance "${name}" selected.
 `);
   });
   program.command("instances").description("List configured Standards instances").action(async (_opts, cmd) => {
@@ -529,7 +624,7 @@ function registerRootCommands(program) {
   });
   program.command("logout").description("Remove a Standards instance from local CLI config").argument("[name]", "instance name, defaults to current").action(async (name) => {
     await removeProfile(name);
-    process.stdout.write(`${chalk4.green("\u2713")} Standards instance removed.
+    process.stdout.write(`${chalk5.green("\u2713")} Standards instance removed.
 `);
   });
 }
@@ -539,7 +634,7 @@ import { createHash } from "crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join as join2 } from "path";
 import { fileURLToPath } from "url";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 function registerSchemaCommand(program) {
   const schema = program.command("schema").description("Inspect schema objects and attributes");
   schema.command("list").description("List all schema objects").action(async (_opts, cmd) => {
@@ -566,7 +661,7 @@ function registerSchemaCommand(program) {
     const result = await fetchDrift(getClientFromCommand(cmd), opts.object);
     const totalDrift = result.summary.totalCustomObjects + result.summary.totalCustomAttributes;
     if (totalDrift === 0) {
-      console.info(chalk5.green("\u2713 No drift detected \u2014 nothing to pull."));
+      console.info(chalk6.green("\u2713 No drift detected \u2014 nothing to pull."));
       process.exit(0);
     }
     const globalOpts = cmd.optsWithGlobals();
@@ -574,7 +669,7 @@ function registerSchemaCommand(program) {
     const shouldSave = opts.save !== false;
     if (opts.output) {
       writeFileSync(opts.output, prompt, "utf-8");
-      console.info(chalk5.green(`\u2713 Prompt written to ${opts.output}`));
+      console.info(chalk6.green(`\u2713 Prompt written to ${opts.output}`));
       return;
     }
     if (shouldSave) {
@@ -588,8 +683,8 @@ function registerSchemaCommand(program) {
       const filename = join2(pullsDir, `${date}-${hash}.md`);
       writeFileSync(filename, prompt, "utf-8");
       writeFileSync(join2(diffDir, "latest.json"), JSON.stringify(result, null, 2), "utf-8");
-      console.info(chalk5.green(`\u2713 Pull prompt written to ${filename}`));
-      console.info(chalk5.dim("  Copy-paste its contents into your LLM to resolve the drift."));
+      console.info(chalk6.green(`\u2713 Pull prompt written to ${filename}`));
+      console.info(chalk6.dim("  Copy-paste its contents into your LLM to resolve the drift."));
     } else {
       process.stdout.write(prompt);
     }
@@ -604,46 +699,46 @@ var attrInline = (attr) => {
 function printDiffOutput(result) {
   const lines = [];
   for (const obj of result.customObjects) {
-    lines.push(chalk5.yellow(`\u26A0  ${obj.name} (${obj.label}) \u2014 custom object, not in code`));
-    lines.push(chalk5.dim('   \u2192 Run "standards pull" to promote or leave.'));
+    lines.push(chalk6.yellow(`\u26A0  ${obj.name} (${obj.label}) \u2014 custom object, not in code`));
+    lines.push(chalk6.dim('   \u2192 Run "standards pull" to promote or leave.'));
   }
   for (const entry of result.systemObjectDrift) {
     const unexpected = entry.sealed ? entry.customAttributes.filter((a) => !a.tolerated) : [];
     const tolerated = entry.customAttributes.filter((a) => a.tolerated);
     if (entry.sealed && unexpected.length > 0) {
       lines.push(
-        chalk5.red(
+        chalk6.red(
           `\u2717  ${entry.objectName} \u2014 ${unexpected.length} unexpected custom attribute(s) (sealed object)`
         )
       );
-      for (const attr of unexpected) lines.push(chalk5.red(attrInline(attr)));
-      lines.push(chalk5.dim('   \u2192 Run "standards pull" to promote or tolerate these attributes.'));
+      for (const attr of unexpected) lines.push(chalk6.red(attrInline(attr)));
+      lines.push(chalk6.dim('   \u2192 Run "standards pull" to promote or tolerate these attributes.'));
       if (tolerated.length > 0) {
-        lines.push(chalk5.dim(`   Also tolerated: ${tolerated.length} attribute(s)`));
-        for (const attr of tolerated) lines.push(chalk5.dim(attrInline(attr)));
+        lines.push(chalk6.dim(`   Also tolerated: ${tolerated.length} attribute(s)`));
+        for (const attr of tolerated) lines.push(chalk6.dim(attrInline(attr)));
       }
       continue;
     }
     const okAttrs = entry.sealed ? tolerated : entry.customAttributes;
     if (okAttrs.length === 0) continue;
     const okSuffix = entry.sealed ? "tolerated custom attribute(s) (sealed)" : "custom attribute(s) (extensible)";
-    lines.push(chalk5.green(`\u2713  ${entry.objectName} \u2014 ${okAttrs.length} ${okSuffix}`));
-    for (const attr of okAttrs) lines.push(chalk5.dim(attrInline(attr)));
+    lines.push(chalk6.green(`\u2713  ${entry.objectName} \u2014 ${okAttrs.length} ${okSuffix}`));
+    for (const attr of okAttrs) lines.push(chalk6.dim(attrInline(attr)));
   }
   if (lines.length === 0) {
-    console.info(chalk5.green("\u2713 No drift detected."));
+    console.info(chalk6.green("\u2713 No drift detected."));
     return;
   }
   console.info(lines.join("\n"));
   if (result.hasUnexpectedDrift) {
     console.info(
-      chalk5.red(
+      chalk6.red(
         `
 \u2717 Unexpected drift: ${result.summary.totalUnexpected} attribute(s) on sealed object(s).`
       )
     );
   } else {
-    console.info(chalk5.green("\n\u2713 No unexpected drift."));
+    console.info(chalk6.green("\n\u2713 No unexpected drift."));
   }
 }
 function resolveStandardsDir() {
@@ -758,9 +853,11 @@ function createProgram() {
   registerRecordsCommand(program);
   registerSchemaCommand(program);
   registerDocumentsCommand(program);
+  registerFoldersCommand(program);
   registerKeysCommand(program);
   registerAuthCommand(program);
   registerAutofillCommand(program);
+  registerConnectorsCommand(program);
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const raw = program.opts();
     const resolved = await resolveCliConfig({
@@ -774,7 +871,7 @@ function createProgram() {
     program.setOptionValue("tenant", raw.tenant);
     if (!(resolved.apiKey || isPublicCommand(actionCommand))) {
       console.error(
-        chalk6.red(
+        chalk7.red(
           `\u2717 Error: No Standards instance configured. Run "standards login" or pass --api-key.`
         )
       );
@@ -788,12 +885,12 @@ async function runProgram(argv = process.argv) {
   await program.parseAsync(argv).catch((error) => {
     if (error instanceof ApiClientError) {
       if (error.statusCode > 0) {
-        console.error(chalk6.red(`\u2717 Error (${error.statusCode}): ${error.message}`));
+        console.error(chalk7.red(`\u2717 Error (${error.statusCode}): ${error.message}`));
       } else {
-        console.error(chalk6.red(`\u2717 Error: ${error.message}`));
+        console.error(chalk7.red(`\u2717 Error: ${error.message}`));
       }
     } else if (error instanceof Error) {
-      console.error(chalk6.red(`\u2717 Error: ${error.message}`));
+      console.error(chalk7.red(`\u2717 Error: ${error.message}`));
     }
     process.exit(1);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/cli",
-  "version": "1.0.0-alpha.226",
+  "version": "1.0.0-alpha.228",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {