@tolinax/ayoune-cli 2026.2.2 → 2026.2.4

package/lib/commands/createBatchCommand.js

@@ -0,0 +1,304 @@
+import chalk from "chalk";
+import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
+import { apiCallHandler } from "../api/apiCallHandler.js";
+import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleDeleteSingleOperation } from "../operations/handleDeleteSingleOperation.js";
+import { saveFile } from "../helpers/saveFile.js";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString("utf-8").trim();
+}
+function parseIds(input) {
+    return input
+        .split(/[,\n]/)
+        .map((id) => id.trim())
+        .filter(Boolean);
+}
+export function createBatchCommand(program) {
+    const batch = program
+        .command("batch")
+        .description("Run bulk operations on multiple entries (for scripts and AI agents)");
+    // ay batch get <collection> <ids>
+    batch
+        .command("get <collection> <ids>")
+        .description("Get multiple entries by comma-separated IDs")
+        .addHelpText("after", `
+Examples:
+  ay batch get contacts id1,id2,id3
+  echo "id1,id2,id3" | ay batch get contacts --stdin`)
+        .option("--stdin", "Read IDs from stdin")
+        .action(async (collection, ids, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            const module = getModuleFromCollection(collection);
+            let idList = parseIds(ids);
+            if (opts.stdin && !process.stdin.isTTY) {
+                const stdinIds = parseIds(await readStdin());
+                idList.push(...stdinIds);
+            }
+            if (idList.length === 0) {
+                spinner.error({ text: "No IDs provided" });
+                process.exit(EXIT_MISUSE);
+            }
+            spinner.start({ text: `Fetching ${idList.length} entries from ${collection}...`, color: "magenta" });
+            const results = [];
+            let errorCount = 0;
+            for (const id of idList) {
+                try {
+                    const res = await apiCallHandler(module.module, `${collection.toLowerCase()}/${id}`, "get", null, { responseFormat: "json" });
+                    if (res === null || res === void 0 ? void 0 : res.payload)
+                        results.push(res.payload);
+                }
+                catch (_a) {
+                    errorCount++;
+                }
+            }
+            const res = {
+                payload: results,
+                meta: { pageInfo: { totalEntries: results.length, page: 1, totalPages: 1 } },
+            };
+            handleResponseFormatOptions(opts, res);
+            spinner.success({ text: `Fetched ${results.length}/${idList.length} entries` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("batch-get", opts, res);
+        }
+        catch (e) {
+            spinner.error({ text: e.message || "Batch get failed" });
+            process.exit(EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay batch delete <collection> <ids>
+    batch
+        .command("delete <collection> <ids>")
+        .alias("rm")
+        .description("Delete multiple entries by comma-separated IDs")
+        .addHelpText("after", `
+Examples:
+  ay batch delete contacts id1,id2,id3 --force
+  echo "id1,id2" | ay batch delete contacts --stdin --force`)
+        .option("--stdin", "Read IDs from stdin")
+        .action(async (collection, ids, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            const module = getModuleFromCollection(collection);
+            let idList = parseIds(ids);
+            if (opts.stdin && !process.stdin.isTTY) {
+                const stdinIds = parseIds(await readStdin());
+                idList.push(...stdinIds);
+            }
+            if (idList.length === 0) {
+                spinner.error({ text: "No IDs provided" });
+                process.exit(EXIT_MISUSE);
+            }
+            // Confirmation
+            if (!opts.force && process.stdin.isTTY) {
+                const inquirer = (await import("inquirer")).default;
+                const { confirmed } = await inquirer.prompt([
+                    {
+                        type: "confirm",
+                        name: "confirmed",
+                        message: `Delete ${idList.length} entries from ${collection}?`,
+                        default: false,
+                    },
+                ]);
+                if (!confirmed) {
+                    console.error(chalk.yellow("  Aborted."));
+                    return;
+                }
+            }
+            spinner.start({ text: `Deleting ${idList.length} entries from ${collection}...`, color: "magenta" });
+            let successCount = 0;
+            let errorCount = 0;
+            for (const id of idList) {
+                try {
+                    await handleDeleteSingleOperation(module.module, collection, id, opts);
+                    successCount++;
+                }
+                catch (_a) {
+                    errorCount++;
+                }
+            }
+            spinner.success({ text: `Deleted ${successCount}/${idList.length} entries from ${collection}` });
+            spinner.stop();
+            if (errorCount > 0)
+                process.exit(EXIT_GENERAL_ERROR);
+        }
+        catch (e) {
+            spinner.error({ text: e.message || "Batch delete failed" });
+            process.exit(EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay batch update <collection> --body-file <file>
+    batch
+        .command("update <collection>")
+        .description("Update multiple entries from a JSON array")
+        .addHelpText("after", `
+Expects a JSON array where each object has an _id field.
+
+Examples:
+  ay batch update contacts --body '[{"_id":"id1","status":"active"},{"_id":"id2","status":"inactive"}]'
+  ay batch update contacts --body-file updates.json
+  cat updates.json | ay batch update contacts --body-stdin`)
+        .option("--body <json>", "JSON array of entries to update")
+        .option("--body-file <path>", "Read entries from file")
+        .option("--body-stdin", "Read entries from stdin")
+        .action(async (collection, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            const module = getModuleFromCollection(collection);
+            let entries = [];
+            if (opts.body) {
+                try {
+                    entries = JSON.parse(opts.body);
+                }
+                catch (_a) {
+                    spinner.error({ text: "Invalid JSON in --body" });
+                    process.exit(EXIT_MISUSE);
+                }
+            }
+            if (opts.bodyFile) {
+                const fs = await import("fs");
+                const content = fs.readFileSync(opts.bodyFile, "utf-8");
+                try {
+                    entries = JSON.parse(content);
+                }
+                catch (_b) {
+                    spinner.error({ text: `Invalid JSON in file: ${opts.bodyFile}` });
+                    process.exit(EXIT_MISUSE);
+                }
+            }
+            if (opts.bodyStdin && !process.stdin.isTTY) {
+                const stdinContent = await readStdin();
+                if (stdinContent) {
+                    try {
+                        entries = JSON.parse(stdinContent);
+                    }
+                    catch (_c) {
+                        spinner.error({ text: "Invalid JSON from stdin" });
+                        process.exit(EXIT_MISUSE);
+                    }
+                }
+            }
+            if (!Array.isArray(entries) || entries.length === 0) {
+                spinner.error({ text: "Provide a JSON array of entries with _id fields" });
+                process.exit(EXIT_MISUSE);
+            }
+            spinner.start({ text: `Updating ${entries.length} entries in ${collection}...`, color: "magenta" });
+            let successCount = 0;
+            let errorCount = 0;
+            for (const entry of entries) {
+                if (!entry._id) {
+                    errorCount++;
+                    continue;
+                }
+                try {
+                    await apiCallHandler(module.module, collection.toLowerCase(), "put", entry, { responseFormat: "json" });
+                    successCount++;
+                }
+                catch (_d) {
+                    errorCount++;
+                }
+            }
+            spinner.success({ text: `Updated ${successCount}/${entries.length} entries in ${collection}` });
+            spinner.stop();
+            if (errorCount > 0)
+                process.exit(EXIT_GENERAL_ERROR);
+        }
+        catch (e) {
+            spinner.error({ text: e.message || "Batch update failed" });
+            process.exit(EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay batch create <collection> --body-file <file>
+    batch
+        .command("create <collection>")
+        .description("Create multiple entries from a JSON array")
+        .addHelpText("after", `
+Expects a JSON array of objects to create.
+
+Examples:
+  ay batch create contacts --body '[{"firstName":"A"},{"firstName":"B"}]'
+  ay batch create contacts --body-file entries.json`)
+        .option("--body <json>", "JSON array of entries to create")
+        .option("--body-file <path>", "Read entries from file")
+        .option("--body-stdin", "Read entries from stdin")
+        .action(async (collection, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            const module = getModuleFromCollection(collection);
+            let entries = [];
+            if (opts.body) {
+                try {
+                    entries = JSON.parse(opts.body);
+                }
+                catch (_a) {
+                    spinner.error({ text: "Invalid JSON in --body" });
+                    process.exit(EXIT_MISUSE);
+                }
+            }
+            if (opts.bodyFile) {
+                const fs = await import("fs");
+                const content = fs.readFileSync(opts.bodyFile, "utf-8");
+                try {
+                    entries = JSON.parse(content);
+                }
+                catch (_b) {
+                    spinner.error({ text: `Invalid JSON in file: ${opts.bodyFile}` });
+                    process.exit(EXIT_MISUSE);
+                }
+            }
+            if (opts.bodyStdin && !process.stdin.isTTY) {
+                const stdinContent = await readStdin();
+                if (stdinContent) {
+                    try {
+                        entries = JSON.parse(stdinContent);
+                    }
+                    catch (_c) {
+                        spinner.error({ text: "Invalid JSON from stdin" });
+                        process.exit(EXIT_MISUSE);
+                    }
+                }
+            }
+            if (!Array.isArray(entries) || entries.length === 0) {
+                spinner.error({ text: "Provide a JSON array of entries to create" });
+                process.exit(EXIT_MISUSE);
+            }
+            spinner.start({ text: `Creating ${entries.length} entries in ${collection}...`, color: "magenta" });
+            let successCount = 0;
+            let errorCount = 0;
+            const created = [];
+            for (const entry of entries) {
+                try {
+                    const res = await apiCallHandler(module.module, collection.toLowerCase(), "post", entry, { responseFormat: "json" });
+                    if (res === null || res === void 0 ? void 0 : res.payload)
+                        created.push(res.payload);
+                    successCount++;
+                }
+                catch (_d) {
+                    errorCount++;
+                }
+            }
+            const res = {
+                payload: created,
+                meta: { pageInfo: { totalEntries: created.length, page: 1, totalPages: 1 } },
+            };
+            handleResponseFormatOptions(opts, res);
+            spinner.success({ text: `Created ${successCount}/${entries.length} entries in ${collection}` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("batch-create", opts, res);
+            if (errorCount > 0)
+                process.exit(EXIT_GENERAL_ERROR);
+        }
+        catch (e) {
+            spinner.error({ text: e.message || "Batch create failed" });
+            process.exit(EXIT_GENERAL_ERROR);
+        }
+    });
+}

package/lib/commands/createCompletionsCommand.js

@@ -3,7 +3,7 @@ _ay_completions() {
   local cur commands
   COMPREPLY=()
   cur="\${COMP_WORDS[COMP_CWORD]}"
-  commands="modules list get edit copy create describe audit stream events storage whoami login logout completions alias config actions exec ai services deploy monitor"
+  commands="modules list get edit copy create describe audit stream events storage whoami login logout completions alias config actions exec ai services deploy monitor delete update batch search webhooks jobs export users sync permissions templates"
 
   if [[ \${COMP_CWORD} -eq 1 ]]; then
     COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
@@ -38,6 +38,17 @@ _ay() {
     'services:Discover and manage platform services'
     'deploy:Manage deployments and pipelines'
     'monitor:Monitor platform activity, logs, and alerts'
+    'delete:Delete entries from a collection'
+    'update:Update an entry non-interactively'
+    'batch:Run bulk operations on multiple entries'
+    'search:Search entries with advanced filtering'
+    'webhooks:Manage webhooks and event subscriptions'
+    'jobs:Manage background jobs and automations'
+    'export:Export data from collections'
+    'users:Manage users, teams, and roles'
+    'sync:Synchronize platform data across systems'
+    'permissions:Manage permissions and access requests'
+    'templates:Manage platform templates'
   )
   _describe 'command' commands
 }
@@ -67,6 +78,17 @@ complete -c ay -n '__fish_use_subcommand' -a ai -d 'AI assistant commands'
 complete -c ay -n '__fish_use_subcommand' -a services -d 'Discover and manage platform services'
 complete -c ay -n '__fish_use_subcommand' -a deploy -d 'Manage deployments and pipelines'
 complete -c ay -n '__fish_use_subcommand' -a monitor -d 'Monitor platform activity, logs, and alerts'
+complete -c ay -n '__fish_use_subcommand' -a delete -d 'Delete entries from a collection'
+complete -c ay -n '__fish_use_subcommand' -a update -d 'Update an entry non-interactively'
+complete -c ay -n '__fish_use_subcommand' -a batch -d 'Run bulk operations on multiple entries'
+complete -c ay -n '__fish_use_subcommand' -a search -d 'Search entries with advanced filtering'
+complete -c ay -n '__fish_use_subcommand' -a webhooks -d 'Manage webhooks and event subscriptions'
+complete -c ay -n '__fish_use_subcommand' -a jobs -d 'Manage background jobs and automations'
+complete -c ay -n '__fish_use_subcommand' -a export -d 'Export data from collections'
+complete -c ay -n '__fish_use_subcommand' -a users -d 'Manage users, teams, and roles'
+complete -c ay -n '__fish_use_subcommand' -a sync -d 'Synchronize platform data across systems'
+complete -c ay -n '__fish_use_subcommand' -a permissions -d 'Manage permissions and access requests'
+complete -c ay -n '__fish_use_subcommand' -a templates -d 'Manage platform templates'
 ###-end-ay-completions-###`;
 const POWERSHELL_COMPLETION = `###-begin-ay-completions-###
 Register-ArgumentCompleter -CommandName ay -ScriptBlock {
@@ -95,6 +117,17 @@ Register-ArgumentCompleter -CommandName ay -ScriptBlock {
     @{ Name = 'services'; Description = 'Discover and manage platform services' }
     @{ Name = 'deploy'; Description = 'Manage deployments and pipelines' }
     @{ Name = 'monitor'; Description = 'Monitor platform activity, logs, and alerts' }
+    @{ Name = 'delete'; Description = 'Delete entries from a collection' }
+    @{ Name = 'update'; Description = 'Update an entry non-interactively' }
+    @{ Name = 'batch'; Description = 'Run bulk operations on multiple entries' }
+    @{ Name = 'search'; Description = 'Search entries with advanced filtering' }
+    @{ Name = 'webhooks'; Description = 'Manage webhooks and event subscriptions' }
+    @{ Name = 'jobs'; Description = 'Manage background jobs and automations' }
+    @{ Name = 'export'; Description = 'Export data from collections' }
+    @{ Name = 'users'; Description = 'Manage users, teams, and roles' }
+    @{ Name = 'sync'; Description = 'Synchronize platform data across systems' }
+    @{ Name = 'permissions'; Description = 'Manage permissions and access requests' }
+    @{ Name = 'templates'; Description = 'Manage platform templates' }
   )
   $commands | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
     [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, 'ParameterValue', $_.Description)

package/lib/commands/createDeleteCommand.js

@@ -0,0 +1,98 @@
+import { Argument } from "commander";
+import chalk from "chalk";
+import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
+import { handleDeleteSingleOperation } from "../operations/handleDeleteSingleOperation.js";
+import { localStorage } from "../helpers/localStorage.js";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+export function createDeleteCommand(program) {
+    program
+        .command("delete")
+        .alias("rm")
+        .description("Delete one or more entries from a collection")
+        .addHelpText("after", `
+Examples:
+  ay delete contacts 64a1b2c3d4e5                    Delete a single contact
+  ay rm contacts 64a1b2c3d4e5 --force                Skip confirmation
+  ay delete contacts id1,id2,id3                      Delete multiple entries
+  echo "id1,id2" | ay delete contacts --ids-stdin     Read IDs from stdin`)
+        .addArgument(new Argument("[collection]", "The collection to use").default(localStorage.getItem("lastCollection"), `The last used collection (${localStorage.getItem("lastCollection")})`))
+        .addArgument(new Argument("[ids]", "Comma-separated ID(s) to delete").default(localStorage.getItem("lastId"), `The last used id (${localStorage.getItem("lastId")})`))
+        .option("--ids-stdin", "Read IDs from stdin (one per line or comma-separated)")
+        .action(async (collection, ids, options) => {
+        try {
+            if (!collection) {
+                spinner.error({ text: "Missing required argument: collection. Run a list or get command first, or provide it explicitly." });
+                process.exit(EXIT_MISUSE);
+            }
+            const opts = { ...program.opts(), ...options };
+            const module = getModuleFromCollection(collection);
+            // Collect IDs from argument and/or stdin
+            let idList = [];
+            if (ids) {
+                idList = ids.split(",").map((id) => id.trim()).filter(Boolean);
+            }
+            if (opts.idsStdin && !process.stdin.isTTY) {
+                const chunks = [];
+                for await (const chunk of process.stdin) {
+                    chunks.push(chunk);
+                }
+                const stdinContent = Buffer.concat(chunks).toString("utf-8").trim();
+                if (stdinContent) {
+                    const stdinIds = stdinContent
+                        .split(/[,\n]/)
+                        .map((id) => id.trim())
+                        .filter(Boolean);
+                    idList.push(...stdinIds);
+                }
+            }
+            if (idList.length === 0) {
+                spinner.error({ text: "No IDs provided. Pass IDs as argument or via --ids-stdin." });
+                process.exit(EXIT_MISUSE);
+            }
+            // Confirmation prompt (unless --force)
+            if (!opts.force && process.stdin.isTTY) {
+                const inquirer = (await import("inquirer")).default;
+                const { confirmed } = await inquirer.prompt([
+                    {
+                        type: "confirm",
+                        name: "confirmed",
+                        message: `Delete ${idList.length} entry/entries from ${collection}?`,
+                        default: false,
+                    },
+                ]);
+                if (!confirmed) {
+                    spinner.stop();
+                    console.error(chalk.yellow("  Aborted."));
+                    return;
+                }
+            }
+            // Execute deletions
+            let successCount = 0;
+            let errorCount = 0;
+            for (const id of idList) {
+                try {
+                    await handleDeleteSingleOperation(module.module, collection, id, opts);
+                    successCount++;
+                }
+                catch (e) {
+                    errorCount++;
+                    spinner.error({ text: `Failed to delete ${id}: ${e.message}` });
+                }
+            }
+            if (idList.length > 1) {
+                spinner.success({ text: `Deleted ${successCount}/${idList.length} entries from ${collection}` });
+                spinner.stop();
+            }
+            localStorage.setItem("lastModule", module.module);
+            localStorage.setItem("lastCollection", collection);
+            if (errorCount > 0) {
+                process.exit(EXIT_GENERAL_ERROR);
+            }
+        }
+        catch (e) {
+            spinner.error({ text: e.message || "An unexpected error occurred" });
+            process.exit(EXIT_GENERAL_ERROR);
+        }
+    });
+}