@tolinax/ayoune-cli 2026.3.1 → 2026.4.0

package/lib/commands/createJobsCommand.js

@@ -0,0 +1,163 @@
+import { apiCallHandler } from "../api/apiCallHandler.js";
+import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { saveFile } from "../helpers/saveFile.js";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+export function createJobsCommand(program) {
+    const jobs = program
+        .command("jobs")
+        .alias("j")
+        .description("Manage background jobs, automations, and triggers");
+    // ay jobs list
+    jobs
+        .command("list")
+        .alias("ls")
+        .description("List scheduled/queued jobs")
+        .option("--status <status>", "Filter: active, waiting, completed, failed, delayed")
+        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .action(async (options) => {
+        var _a, _b, _c;
+        try {
+            const opts = { ...program.opts(), ...options };
+            spinner.start({ text: "Fetching jobs...", color: "magenta" });
+            const params = {
+                page: opts.page,
+                limit: opts.limit,
+                responseFormat: opts.responseFormat,
+                verbosity: opts.verbosity,
+            };
+            if (opts.status)
+                params.status = opts.status;
+            const res = await apiCallHandler("general", "agendajobs", "get", null, params);
+            handleResponseFormatOptions(opts, res);
+            const total = (_c = (_b = (_a = res.meta) === null || _a === void 0 ? void 0 : _a.pageInfo) === null || _b === void 0 ? void 0 : _b.totalEntries) !== null && _c !== void 0 ? _c : 0;
+            spinner.success({ text: `Found ${total} jobs` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("jobs-list", opts, res);
+        }
+        catch (e) {
+            cliError(e.message || "Failed to list jobs", EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay jobs triggers
+    jobs
+        .command("triggers")
+        .description("List automation triggers")
+        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .action(async (options) => {
+        var _a, _b, _c;
+        try {
+            const opts = { ...program.opts(), ...options };
+            spinner.start({ text: "Fetching triggers...", color: "magenta" });
+            const res = await apiCallHandler("automation", "triggers", "get", null, {
+                page: opts.page,
+                limit: opts.limit,
+                responseFormat: opts.responseFormat,
+                verbosity: opts.verbosity,
+            });
+            handleResponseFormatOptions(opts, res);
+            const total = (_c = (_b = (_a = res.meta) === null || _a === void 0 ? void 0 : _a.pageInfo) === null || _b === void 0 ? void 0 : _b.totalEntries) !== null && _c !== void 0 ? _c : 0;
+            spinner.success({ text: `Found ${total} triggers` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("jobs-triggers", opts, res);
+        }
+        catch (e) {
+            cliError(e.message || "Failed to list triggers", EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay jobs automations
+    jobs
+        .command("automations")
+        .alias("auto")
+        .description("List automations")
+        .option("--active", "Show only active automations")
+        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .action(async (options) => {
+        var _a, _b, _c;
+        try {
+            const opts = { ...program.opts(), ...options };
+            spinner.start({ text: "Fetching automations...", color: "magenta" });
+            const params = {
+                page: opts.page,
+                limit: opts.limit,
+                responseFormat: opts.responseFormat,
+                verbosity: opts.verbosity,
+            };
+            if (opts.active)
+                params.active = "true";
+            const res = await apiCallHandler("automation", "automations", "get", null, params);
+            handleResponseFormatOptions(opts, res);
+            const total = (_c = (_b = (_a = res.meta) === null || _a === void 0 ? void 0 : _a.pageInfo) === null || _b === void 0 ? void 0 : _b.totalEntries) !== null && _c !== void 0 ? _c : 0;
+            spinner.success({ text: `Found ${total} automations` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("jobs-automations", opts, res);
+        }
+        catch (e) {
+            cliError(e.message || "Failed to list automations", EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay jobs execute <automationId>
+    jobs
+        .command("execute <automationId>")
+        .alias("run")
+        .description("Execute an automation immediately")
+        .option("--body <json>", "Optional payload as JSON")
+        .action(async (automationId, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            spinner.start({ text: `Executing automation ${automationId}...`, color: "magenta" });
+            let body = null;
+            if (opts.body) {
+                try {
+                    body = JSON.parse(opts.body);
+                }
+                catch (_a) {
+                    cliError("Invalid JSON in --body", EXIT_GENERAL_ERROR);
+                }
+            }
+            const res = await apiCallHandler("automation", `automations/${automationId}/execute`, "post", body, { responseFormat: opts.responseFormat });
+            handleResponseFormatOptions(opts, res);
+            spinner.success({ text: `Automation ${automationId} executed` });
+            spinner.stop();
+        }
+        catch (e) {
+            cliError(e.message || "Failed to execute automation", EXIT_GENERAL_ERROR);
+        }
+    });
+    // ay jobs notifications
+    jobs
+        .command("notifications")
+        .alias("notify")
+        .description("List recent notifications")
+        .option("-l, --limit <number>", "Limit results", parseInt, 25)
+        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .action(async (options) => {
+        var _a, _b, _c;
+        try {
+            const opts = { ...program.opts(), ...options };
+            spinner.start({ text: "Fetching notifications...", color: "magenta" });
+            const res = await apiCallHandler("crm", "notifications", "get", null, {
+                page: opts.page,
+                limit: opts.limit,
+                responseFormat: opts.responseFormat,
+                verbosity: opts.verbosity,
+            });
+            handleResponseFormatOptions(opts, res);
+            const total = (_c = (_b = (_a = res.meta) === null || _a === void 0 ? void 0 : _a.pageInfo) === null || _b === void 0 ? void 0 : _b.totalEntries) !== null && _c !== void 0 ? _c : 0;
+            spinner.success({ text: `Found ${total} notifications` });
+            spinner.stop();
+            if (opts.save)
+                await saveFile("jobs-notifications", opts, res);
+        }
+        catch (e) {
+            cliError(e.message || "Failed to list notifications", EXIT_GENERAL_ERROR);
+        }
+    });
+}

package/lib/commands/createListCommand.js

@@ -0,0 +1,48 @@
+import { parseInteger } from "../helpers/parseInt.js";
+import { promptCollectionWithModule } from "../prompts/promptCollectionWithModule.js";
+import { resolveCollectionArgs } from "../helpers/resolveCollectionArgs.js";
+import { handleListOperation } from "../operations/handleListOperation.js";
+import { saveFile } from "../helpers/saveFile.js";
+import { localStorage } from "../helpers/localStorage.js";
+import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+export function createListCommand(program) {
+    program
+        .command("list [collectionOrModule] [collection]")
+        .alias("l")
+        .description("List entries in a collection with pagination support")
+        .addHelpText("after", `
+Examples:
+  ay list contacts                  List contacts (page 1, limit 20)
+  ay list crm consumers             List consumers (explicit module)
+  ay list products -p 2 -l 50      List products page 2, 50 per page
+  ay list orders -r yaml -s        List orders as YAML and save to file
+  ay list contacts --all            Fetch all pages
+  ay list contacts --jq '[].name'   Extract just names using JMESPath`)
+        .option("-p, --page <number>", "Page", parseInteger, 1)
+        .option("-l, --limit <number>", "Limit", parseInteger, 20)
+        .option("-f, --from <date>", "From date")
+        .option("-a, --all", "Fetch all pages automatically")
+        .action(async (collectionOrModule, collection, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            if (!collectionOrModule) {
+                if (!process.stdin.isTTY) {
+                    cliError("Missing required argument: collection", EXIT_MISUSE);
+                }
+                collectionOrModule = await promptCollectionWithModule();
+            }
+            const resolved = resolveCollectionArgs(collectionOrModule, collection);
+            localStorage.setItem("lastModule", resolved.module);
+            localStorage.setItem("lastCollection", resolved.collection);
+            let result = {};
+            result = await handleListOperation(resolved.module, resolved.collection, opts);
+            if (opts.save) {
+                await saveFile("list", opts, result);
+            }
+        }
+        catch (e) {
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
+        }
+    });
+}

package/lib/commands/createLoginCommand.js

@@ -0,0 +1,30 @@
+import { login } from "../api/login.js";
+import { spinner } from "../../index.js";
+import { EXIT_AUTH_REQUIRED } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+import { decodeToken } from "../api/decodeToken.js";
+import chalk from "chalk";
+export function createLoginCommand(program) {
+    program
+        .command("login")
+        .alias("auth")
+        .description("Authenticate with your aYOUne account via browser or JWT token")
+        .action(async (_options, cmd) => {
+        var _a, _b, _c, _d;
+        try {
+            // --token is a global option, check it from the parent program
+            const globalToken = (_b = (_a = cmd.parent) === null || _a === void 0 ? void 0 : _a.opts()) === null || _b === void 0 ? void 0 : _b.token;
+            if (globalToken) {
+                // Token was already stored by preAction hook, just confirm
+                const decoded = decodeToken(globalToken);
+                const username = ((_c = decoded === null || decoded === void 0 ? void 0 : decoded.payload) === null || _c === void 0 ? void 0 : _c.username) || ((_d = decoded === null || decoded === void 0 ? void 0 : decoded.payload) === null || _d === void 0 ? void 0 : _d._id) || "unknown";
+                spinner.success({ text: `Authenticated as ${chalk.cyan(username)} via token` });
+                return;
+            }
+            await login();
+        }
+        catch (e) {
+            cliError(e.message || "An unexpected error occurred", EXIT_AUTH_REQUIRED);
+        }
+    });
+}

package/lib/commands/createLogoutCommand.js

@@ -0,0 +1,21 @@
+import { localStorage } from "../helpers/localStorage.js";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+export function createLogoutCommand(program) {
+    program
+        .command("logout")
+        .alias("signout")
+        .description("Clear stored credentials and log out")
+        .action(async (options) => {
+        try {
+            spinner.start({ text: "Clearing credentials" });
+            localStorage.removeItem("token");
+            localStorage.removeItem("refreshToken");
+            spinner.success({ text: "Credentials cleared" });
+        }
+        catch (e) {
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
+        }
+    });
+}

package/lib/commands/createModulesCommand.js

@@ -0,0 +1,147 @@
+import { promptModule } from "../prompts/promptModule.js";
+import { promptCollectionInModule } from "../prompts/promptCollectionInModule.js";
+import { promptOperation } from "../prompts/promptOperation.js";
+import { handleListOperation } from "../operations/handleListOperation.js";
+import { promptEntry } from "../prompts/promptEntry.js";
+import { handleCollectionOperation } from "../operations/handleCollectionOperation.js";
+import { localStorage } from "../helpers/localStorage.js";
+import { parseInteger } from "../helpers/parseInt.js";
+import { handleGetOperation } from "../operations/handleGetOperation.js";
+import { handleCreateSingleOperation } from "../operations/handleCreateSingleOperation.js";
+import { handleDeleteSingleOperation } from "../operations/handleDeleteSingleOperation.js";
+import { aYOUneModules } from "../../data/modules.js";
+import { getModelsInModules } from "../models/getModelsInModules.js";
+import { apiCallHandler } from "../api/apiCallHandler.js";
+import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { isSuperUser } from "../helpers/tokenPayload.js";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+const DIRECT_OPERATIONS = ["list", "get", "create", "delete"];
+function resolveModule(input) {
+    const lower = input.toLowerCase();
+    const match = aYOUneModules.find((m) => m.module === lower || m.label.toLowerCase() === lower);
+    if (!match)
+        return null;
+    if (match.superuserOnly && !isSuperUser())
+        return null;
+    return match.module;
+}
+function resolveCollection(module, input) {
+    const lower = input.toLowerCase();
+    const collections = getModelsInModules(module);
+    const match = collections.find((c) => c.value === lower || c.name.toLowerCase() === lower);
+    return match ? match.value : null;
+}
+export function createModulesCommand(program) {
+    program
+        .command("modules [module] [collection] [operation] [subject]")
+        .alias("m")
+        .description("Browse modules, collections, and entries interactively")
+        .addHelpText("after", `
+Examples:
+  ay modules                            Start interactive module browser
+  ay m                                  Same using alias
+  ay m crm                              Jump straight to the CRM module
+  ay m crm consumers                    Jump to CRM consumers collection
+  ay m pm projects list                 List all projects
+  ay m pm projects create "Migration"   Create a new project
+  ay m pm projects get <id>             Get a project by ID
+  ay m pm projects delete <id>          Delete a project by ID`)
+        .option("-p, --page <number>", "Page", parseInteger, 1)
+        .option("-l, --limit <number>", "Limit", parseInteger, 20)
+        .option("-f, --from <date>", "From date")
+        .option("-a, --all", "Fetch all pages (list only)")
+        .option("-q, --search <term>", "Search term")
+        .action(async (moduleArg, collectionArg, operationArg, subjectArg, options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            // ─── Resolve module ──────────────────────────────────
+            let module;
+            if (moduleArg) {
+                const resolved = resolveModule(moduleArg);
+                if (!resolved) {
+                    cliError(`Unknown module: ${moduleArg}`, EXIT_MISUSE);
+                }
+                module = resolved;
+            }
+            else {
+                if (!process.stdin.isTTY) {
+                    cliError("The modules command requires an interactive terminal", EXIT_MISUSE);
+                }
+                module = await promptModule();
+            }
+            // ─── Resolve collection ──────────────────────────────
+            let collection;
+            if (collectionArg) {
+                const resolved = resolveCollection(module, collectionArg);
+                if (!resolved) {
+                    cliError(`Unknown collection: ${collectionArg} in module ${module}`, EXIT_MISUSE);
+                }
+                collection = resolved;
+            }
+            else {
+                if (!process.stdin.isTTY) {
+                    cliError("Missing required argument: collection", EXIT_MISUSE);
+                }
+                collection = await promptCollectionInModule(module);
+            }
+            localStorage.setItem("lastModule", module);
+            localStorage.setItem("lastCollection", collection);
+            // ─── Direct operation mode ───────────────────────────
+            if (operationArg && DIRECT_OPERATIONS.includes(operationArg.toLowerCase())) {
+                const op = operationArg.toLowerCase();
+                if (op === "list") {
+                    const { result } = await handleListOperation(module, collection, opts);
+                    return;
+                }
+                if (op === "get") {
+                    if (!subjectArg) {
+                        cliError("Missing required argument: id", EXIT_MISUSE);
+                    }
+                    spinner.start({ text: `Getting ${collection} ${subjectArg}...`, color: "magenta" });
+                    const res = await apiCallHandler(module, `${collection.toLowerCase()}/${subjectArg}`, "get", null, {
+                        responseFormat: opts.responseFormat,
+                        verbosity: opts.verbosity,
+                    });
+                    handleResponseFormatOptions(opts, res);
+                    spinner.success({ text: `Got ${collection} [${subjectArg}]` });
+                    spinner.stop();
+                    return;
+                }
+                if (op === "create") {
+                    if (!subjectArg) {
+                        cliError("Missing required argument: name/subject", EXIT_MISUSE);
+                    }
+                    await handleCreateSingleOperation(module, collection, subjectArg, opts);
+                    return;
+                }
+                if (op === "delete") {
+                    if (!subjectArg) {
+                        cliError("Missing required argument: id", EXIT_MISUSE);
+                    }
+                    await handleDeleteSingleOperation(module, collection, subjectArg, opts);
+                    return;
+                }
+            }
+            // ─── Interactive mode (no operation provided) ────────
+            if (!process.stdin.isTTY) {
+                cliError("Interactive mode requires a terminal. Use: ay m <module> <collection> <operation> [subject]", EXIT_MISUSE);
+            }
+            const operation = await promptOperation();
+            let entry = "";
+            if (operation === "list") {
+                const { result } = await handleListOperation(module, collection, opts);
+                entry = await promptEntry(result);
+            }
+            if (operation === "get") {
+                const { result } = await handleGetOperation(module, collection, opts);
+                entry = await promptEntry(result);
+            }
+            await handleCollectionOperation(module, collection, entry, opts);
+        }
+        catch (e) {
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
+        }
+    });
+}