@tolinax/ayoune-cli 2026.3.0 → 2026.4.0

package/lib/commands/createSearchCommand.js

@@ -1,101 +1,251 @@
+import { resolveCollectionArgs } from "../helpers/resolveCollectionArgs.js";
 import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
 import { apiCallHandler } from "../api/apiCallHandler.js";
+import { searchModel, searchOne, searchGlobal } from "../api/searchClient.js";
 import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
 import { saveFile } from "../helpers/saveFile.js";
 import { localStorage } from "../helpers/localStorage.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+import { sanitizeFields } from "../helpers/sanitizeFields.js";
+import { getContextFilterParams } from "../helpers/contextInjector.js";
 export function createSearchCommand(program) {
     program
-        .command("search <collection> [query]")
+        .command("search [collectionOrModule] [collectionOrQuery] [query]")
         .alias("find")
-        .description("Search entries in a collection with advanced filtering")
+        .description("Search entries via the aYOUne Search Service")
         .addHelpText("after", `
 Examples:
-  ay search contacts "John"                       Full-text search
+  ay search consumers "John"                       Search via search service
+  ay search crm consumers "John"                   Search with explicit module
+  ay search -g "John"                              Global search across all collections (SSE)
+  ay search consumers "John" --one                 Find first match
+  ay search consumers "John" --field name          Search specific field
   ay search contacts --filter "status=active"      Filter by field
-  ay search products --filter "price>100"          Comparison filter
   ay search orders --filter "status=paid" --sort "-createdAt"
-  ay search leads --filter "source=website,stage=qualified" --fields "name,email,stage"
+  ay search consumers "John" --legacy              Use legacy module API
   ay find invoices --filter "total>500" --count    Just count matches`)
+        .option("-g, --global <query>", "Global search across all collections (SSE streaming)")
+        .option("--field <name>", "Search in a specific field")
+        .option("--one", "Return only the first matching entry", false)
+        .option("--legacy", "Use legacy module API instead of search service", false)
         .option("--filter <filters>", "Comma-separated key=value filters (supports =, !=, >, <, >=, <=)")
         .option("--fields <fields>", "Comma-separated fields to return (projection)")
         .option("--sort <field>", "Sort by field (prefix with - for descending)", "-createdAt")
         .option("--count", "Only return count of matching entries", false)
         .option("-l, --limit <number>", "Limit results", parseInt, 25)
         .option("-p, --page <number>", "Page number", parseInt, 1)
-        .action(async (collection, query, options) => {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        .action(async (collectionOrModule, collectionOrQuery, query, options) => {
         try {
             const opts = { ...program.opts(), ...options };
-            const module = getModuleFromCollection(collection);
-            spinner.start({ text: `Searching ${collection}...`, color: "magenta" });
-            const params = {
-                page: opts.page,
-                limit: opts.limit,
-                sort: opts.sort,
-                responseFormat: opts.responseFormat,
-                verbosity: opts.verbosity,
-                hideMeta: opts.hideMeta,
-            };
-            if (query) {
-                params.q = query;
+            // Mode 1: Global SSE search
+            if (opts.global) {
+                return await handleGlobalSearch(opts);
             }
-            if (opts.fields) {
-                params.fields = opts.fields;
+            // For all other modes, we need a collection
+            if (!collectionOrModule) {
+                cliError("Collection name is required (or use --global for global search)", EXIT_GENERAL_ERROR);
+                return;
             }
-            // Parse filters into query params
-            if (opts.filter) {
-                const filters = opts.filter.split(",");
-                for (const f of filters) {
-                    const match = f.match(/^(\w+)(!=|>=|<=|>|<|=)(.+)$/);
-                    if (match) {
-                        const [, key, op, value] = match;
-                        if (op === "=") {
-                            params[key] = value;
-                        }
-                        else if (op === "!=") {
-                            params[`${key}[ne]`] = value;
-                        }
-                        else if (op === ">") {
-                            params[`${key}[gt]`] = value;
-                        }
-                        else if (op === "<") {
-                            params[`${key}[lt]`] = value;
-                        }
-                        else if (op === ">=") {
-                            params[`${key}[gte]`] = value;
-                        }
-                        else if (op === "<=") {
-                            params[`${key}[lte]`] = value;
-                        }
-                    }
-                }
+            // Detect if first arg is a module: ay search crm consumers "John"
+            let resolved;
+            let searchQuery = query;
+            const m = getModuleFromCollection(collectionOrModule.toLowerCase());
+            if (!m && collectionOrQuery) {
+                resolved = resolveCollectionArgs(collectionOrModule, collectionOrQuery);
             }
-            const res = await apiCallHandler(module.module, collection.toLowerCase(), "get", null, params);
-            if (opts.count) {
-                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: `${total} matching entries in ${collection}` });
-                spinner.stop();
-                console.log(total);
-                return;
+            else {
+                resolved = resolveCollectionArgs(collectionOrModule);
+                searchQuery = collectionOrQuery;
             }
-            handleResponseFormatOptions(opts, res);
-            const total = (_f = (_e = (_d = res.meta) === null || _d === void 0 ? void 0 : _d.pageInfo) === null || _e === void 0 ? void 0 : _e.totalEntries) !== null && _f !== void 0 ? _f : 0;
-            const page = (_j = (_h = (_g = res.meta) === null || _g === void 0 ? void 0 : _g.pageInfo) === null || _h === void 0 ? void 0 : _h.page) !== null && _j !== void 0 ? _j : 1;
-            const totalPages = (_m = (_l = (_k = res.meta) === null || _k === void 0 ? void 0 : _k.pageInfo) === null || _l === void 0 ? void 0 : _l.totalPages) !== null && _m !== void 0 ? _m : 1;
-            spinner.success({
-                text: `Found ${total} entries in ${collection} (page ${page}/${totalPages})`,
-            });
-            spinner.stop();
-            localStorage.setItem("lastModule", module.module);
-            localStorage.setItem("lastCollection", collection);
-            if (opts.save)
-                await saveFile("search", opts, res);
+            const collection = resolved.collection;
+            // Mode 4: Legacy module API search
+            if (opts.legacy) {
+                return await handleLegacySearch(resolved, searchQuery, opts);
+            }
+            // Mode 3: FindOne via search service
+            if (opts.one) {
+                return await handleFindOneSearch(resolved, searchQuery, opts);
+            }
+            // Mode 2: Single-model search via search service
+            return await handleModelSearch(resolved, searchQuery, opts);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Search failed" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Search failed", EXIT_GENERAL_ERROR);
         }
     });
 }
+async function handleGlobalSearch(opts) {
+    const query = opts.global;
+    spinner.start({ text: `Global search for "${query}"...`, color: "magenta" });
+    const results = await searchGlobal(query, opts.limit, {
+        onResult: (result) => {
+            spinner.update({
+                text: `Searching... found ${result.total} in ${result.collection}`,
+            });
+        },
+        onError: (error) => {
+            spinner.update({ text: `Search warning: ${error}` });
+        },
+    });
+    // Flatten results into a grouped response for handleResponseFormatOptions
+    const totalEntries = results.reduce((sum, r) => sum + r.total, 0);
+    const allEntries = results.flatMap((r) => r.entries.map((e) => ({ ...e, _collection: r.collection })));
+    const res = {
+        payload: allEntries,
+        meta: {
+            responseTime: 0,
+            pageInfo: { totalEntries: totalEntries, page: 1, totalPages: 1 },
+            collections: results.map((r) => ({ name: r.collection, count: r.total })),
+        },
+    };
+    if (opts.count) {
+        spinner.success({ text: `${totalEntries} matching entries across ${results.length} collections` });
+        spinner.stop();
+        console.log(totalEntries);
+        return;
+    }
+    handleResponseFormatOptions(opts, res);
+    spinner.success({
+        text: `Found ${totalEntries} entries across ${results.length} collections`,
+    });
+    spinner.stop();
+    if (opts.save)
+        await saveFile("search-global", opts, res);
+}
+async function handleModelSearch(resolved, searchQuery, opts) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const collection = resolved.collection;
+    spinner.start({ text: `Searching ${collection}...`, color: "magenta" });
+    const params = {
+        limit: opts.limit,
+        skip: (opts.page - 1) * opts.limit,
+    };
+    if (searchQuery)
+        params.q = searchQuery;
+    if (opts.field)
+        params.field = opts.field;
+    if (opts.fields)
+        params.fields = sanitizeFields(opts.fields).join(",");
+    if (opts.sort)
+        params.sort = opts.sort;
+    // Inject context params
+    const contextParams = getContextFilterParams(collection);
+    Object.assign(params, contextParams);
+    // Parse filters
+    applyFilters(params, opts.filter);
+    const res = await searchModel(collection, params);
+    if (opts.count) {
+        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: `${total} matching entries in ${collection}` });
+        spinner.stop();
+        console.log(total);
+        return;
+    }
+    handleResponseFormatOptions(opts, res);
+    const total = (_f = (_e = (_d = res.meta) === null || _d === void 0 ? void 0 : _d.pageInfo) === null || _e === void 0 ? void 0 : _e.totalEntries) !== null && _f !== void 0 ? _f : 0;
+    const page = (_j = (_h = (_g = res.meta) === null || _g === void 0 ? void 0 : _g.pageInfo) === null || _h === void 0 ? void 0 : _h.page) !== null && _j !== void 0 ? _j : 1;
+    const totalPages = (_m = (_l = (_k = res.meta) === null || _k === void 0 ? void 0 : _k.pageInfo) === null || _l === void 0 ? void 0 : _l.totalPages) !== null && _m !== void 0 ? _m : 1;
+    spinner.success({
+        text: `Found ${total} entries in ${collection} (page ${page}/${totalPages})`,
+    });
+    spinner.stop();
+    localStorage.setItem("lastModule", resolved.module);
+    localStorage.setItem("lastCollection", resolved.collection);
+    if (opts.save)
+        await saveFile("search", opts, res);
+}
+async function handleFindOneSearch(resolved, searchQuery, opts) {
+    const collection = resolved.collection;
+    spinner.start({ text: `Finding one in ${collection}...`, color: "magenta" });
+    const params = {};
+    if (searchQuery)
+        params.q = searchQuery;
+    if (opts.field)
+        params.field = opts.field;
+    if (opts.fields)
+        params.fields = sanitizeFields(opts.fields).join(",");
+    const contextParams = getContextFilterParams(collection);
+    Object.assign(params, contextParams);
+    applyFilters(params, opts.filter);
+    const res = await searchOne(collection, params);
+    handleResponseFormatOptions(opts, res);
+    spinner.success({
+        text: `Found match in ${collection}`,
+    });
+    spinner.stop();
+    localStorage.setItem("lastModule", resolved.module);
+    localStorage.setItem("lastCollection", resolved.collection);
+    if (opts.save)
+        await saveFile("search-one", opts, res);
+}
+async function handleLegacySearch(resolved, searchQuery, opts) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const collection = resolved.collection;
+    spinner.start({ text: `Searching ${collection} (legacy)...`, color: "magenta" });
+    const params = {
+        page: opts.page,
+        limit: opts.limit,
+        sort: opts.sort,
+        responseFormat: opts.responseFormat,
+        verbosity: opts.verbosity,
+        hideMeta: opts.hideMeta,
+    };
+    const contextParams = getContextFilterParams(collection);
+    Object.assign(params, contextParams);
+    if (searchQuery)
+        params.q = searchQuery;
+    if (opts.fields)
+        params.fields = sanitizeFields(opts.fields).join(",");
+    applyFilters(params, opts.filter);
+    const res = await apiCallHandler(resolved.module, collection, "get", null, params);
+    if (opts.count) {
+        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: `${total} matching entries in ${collection}` });
+        spinner.stop();
+        console.log(total);
+        return;
+    }
+    handleResponseFormatOptions(opts, res);
+    const total = (_f = (_e = (_d = res.meta) === null || _d === void 0 ? void 0 : _d.pageInfo) === null || _e === void 0 ? void 0 : _e.totalEntries) !== null && _f !== void 0 ? _f : 0;
+    const page = (_j = (_h = (_g = res.meta) === null || _g === void 0 ? void 0 : _g.pageInfo) === null || _h === void 0 ? void 0 : _h.page) !== null && _j !== void 0 ? _j : 1;
+    const totalPages = (_m = (_l = (_k = res.meta) === null || _k === void 0 ? void 0 : _k.pageInfo) === null || _l === void 0 ? void 0 : _l.totalPages) !== null && _m !== void 0 ? _m : 1;
+    spinner.success({
+        text: `Found ${total} entries in ${collection} (page ${page}/${totalPages})`,
+    });
+    spinner.stop();
+    localStorage.setItem("lastModule", resolved.module);
+    localStorage.setItem("lastCollection", resolved.collection);
+    if (opts.save)
+        await saveFile("search", opts, res);
+}
+function applyFilters(params, filter) {
+    if (!filter)
+        return;
+    const filters = filter.split(",");
+    for (const f of filters) {
+        const match = f.match(/^(\w+)(!=|>=|<=|>|<|=)(.+)$/);
+        if (match) {
+            const [, key, op, value] = match;
+            if (op === "=") {
+                params[key] = value;
+            }
+            else if (op === "!=") {
+                params[`${key}[ne]`] = value;
+            }
+            else if (op === ">") {
+                params[`${key}[gt]`] = value;
+            }
+            else if (op === "<") {
+                params[`${key}[lt]`] = value;
+            }
+            else if (op === ">=") {
+                params[`${key}[gte]`] = value;
+            }
+            else if (op === "<=") {
+                params[`${key}[lte]`] = value;
+            }
+        }
+    }
+}

package/lib/commands/createSelfHostUpdateCommand.js

@@ -0,0 +1,166 @@
+import chalk from "chalk";
+import { spinner } from "../../index.js";
+import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+import { execSync } from "child_process";
+function runCommand(cmd) {
+    try {
+        return execSync(cmd, { encoding: "utf-8", timeout: 30000 }).trim();
+    }
+    catch (_a) {
+        return "";
+    }
+}
+function detectRuntime() {
+    // Check for docker compose
+    const composeResult = runCommand("docker compose version 2>&1");
+    if (composeResult.includes("Docker Compose"))
+        return "compose";
+    // Check for kubectl
+    const kubectlResult = runCommand("kubectl version --client 2>&1");
+    if (kubectlResult.includes("Client Version"))
+        return "kubernetes";
+    return "unknown";
+}
+function getRunningComposeServices() {
+    const output = runCommand('docker compose ps --format "{{.Name}}" 2>&1');
+    if (!output)
+        return [];
+    return output.split("\n").filter(Boolean);
+}
+function getComposeImageVersions() {
+    const versions = new Map();
+    const output = runCommand('docker compose ps --format "{{.Name}}|{{.Image}}" 2>&1');
+    if (!output)
+        return versions;
+    for (const line of output.split("\n")) {
+        const [name, image] = line.split("|");
+        if (name && image) {
+            const tag = image.split(":").pop() || "unknown";
+            versions.set(name, tag);
+        }
+    }
+    return versions;
+}
+export function createSelfHostUpdateCommand(program) {
+    program
+        .command("self-host-update")
+        .alias("shu")
+        .description("Check for and apply updates to a self-hosted aYOUne deployment")
+        .addHelpText("after", `
+Examples:
+  ay self-host-update                Check for available updates
+  ay self-host-update --apply        Pull new images and restart services
+  ay self-host-update --service crm   Check updates for a specific service`)
+        .option("--apply", "Apply available updates (pull new images, restart services)")
+        .option("--service <name>", "Update only a specific service")
+        .action(async (options) => {
+        try {
+            const opts = { ...program.opts(), ...options };
+            const runtime = detectRuntime();
+            if (runtime === "unknown") {
+                cliError("Could not detect Docker Compose or Kubernetes. Ensure docker or kubectl is installed and accessible.", EXIT_GENERAL_ERROR);
+            }
+            console.log(chalk.cyan.bold("\n  aYOUne Self-Hosted Update\n"));
+            console.log(chalk.dim(`  Runtime: ${runtime === "compose" ? "Docker Compose" : "Kubernetes"}\n`));
+            if (runtime === "compose") {
+                await handleComposeUpdate(opts);
+            }
+            else {
+                await handleKubernetesUpdate(opts);
+            }
+        }
+        catch (e) {
+            cliError(e.message || "Update check failed", EXIT_GENERAL_ERROR);
+        }
+    });
+}
+async function handleComposeUpdate(opts) {
+    const services = getRunningComposeServices();
+    if (services.length === 0) {
+        console.log(chalk.yellow("  No running aYOUne services found."));
+        console.log(chalk.dim("  Start services first: docker compose --profile core up -d\n"));
+        return;
+    }
+    const versions = getComposeImageVersions();
+    console.log(chalk.white(`  Running services: ${services.length}\n`));
+    for (const [name, version] of versions) {
+        if (opts.service && !name.includes(opts.service))
+            continue;
+        console.log(`  ${chalk.dim("●")} ${name} ${chalk.dim(`(${version})`)}`);
+    }
+    console.log("");
+    if (opts.apply) {
+        spinner.start({ text: "Pulling latest images...", color: "cyan" });
+        const pullTarget = opts.service ? opts.service : "";
+        const pullResult = runCommand(`docker compose pull ${pullTarget} 2>&1`);
+        if (!pullResult) {
+            spinner.error({ text: "Failed to pull images" });
+            return;
+        }
+        spinner.success({ text: "Images pulled successfully" });
+        spinner.start({ text: "Restarting services...", color: "cyan" });
+        const upTarget = opts.service ? opts.service : "";
+        runCommand(`docker compose up -d ${upTarget} 2>&1`);
+        spinner.success({ text: "Services restarted" });
+        spinner.stop();
+        console.log(chalk.green("\n  Update complete!"));
+        console.log(chalk.dim("  Run 'ay status' to verify all services are healthy.\n"));
+    }
+    else {
+        spinner.start({ text: "Checking for new images...", color: "cyan" });
+        const pullTarget = opts.service ? opts.service : "";
+        const dryRunResult = runCommand(`docker compose pull --dry-run ${pullTarget} 2>&1`);
+        spinner.stop();
+        if (dryRunResult) {
+            console.log(chalk.dim("  Image check output:"));
+            for (const line of dryRunResult.split("\n")) {
+                console.log(chalk.dim(`    ${line}`));
+            }
+        }
+        console.log(chalk.cyan("\n  To apply updates, run:"));
+        console.log(chalk.dim("    ay self-host-update --apply\n"));
+    }
+}
+async function handleKubernetesUpdate(opts) {
+    // Check for Helm releases
+    const helmList = runCommand("helm list -n ayoune --output json 2>&1");
+    if (!helmList || helmList.startsWith("[")) {
+        try {
+            const releases = JSON.parse(helmList || "[]");
+            if (releases.length === 0) {
+                console.log(chalk.yellow("  No Helm releases found in 'ayoune' namespace."));
+                console.log(chalk.dim("  Install: helm install ayoune tolinax/ayoune -f values.yaml\n"));
+                return;
+            }
+            for (const release of releases) {
+                console.log(`  ${chalk.white(release.name)} ${chalk.dim(`v${release.app_version} (chart: ${release.chart})`)}`);
+                console.log(`  ${chalk.dim(`Status: ${release.status} | Updated: ${release.updated}`)}`);
+            }
+        }
+        catch (_a) {
+            console.log(chalk.yellow("  Could not parse Helm releases."));
+        }
+    }
+    console.log("");
+    if (opts.apply) {
+        spinner.start({ text: "Updating Helm repo...", color: "cyan" });
+        runCommand("helm repo update 2>&1");
+        spinner.success({ text: "Helm repo updated" });
+        spinner.start({ text: "Upgrading release...", color: "cyan" });
+        const upgradeResult = runCommand("helm upgrade ayoune tolinax/ayoune -n ayoune --reuse-values 2>&1");
+        if (upgradeResult.includes("Error")) {
+            spinner.error({ text: `Helm upgrade failed: ${upgradeResult}` });
+            return;
+        }
+        spinner.success({ text: "Helm release upgraded" });
+        spinner.stop();
+        console.log(chalk.green("\n  Update complete!"));
+        console.log(chalk.dim("  Run 'ay status' to verify all services are healthy.\n"));
+    }
+    else {
+        console.log(chalk.cyan("  To apply updates, run:"));
+        console.log(chalk.dim("    ay self-host-update --apply"));
+        console.log(chalk.dim("    # or manually: helm upgrade ayoune tolinax/ayoune -n ayoune --reuse-values\n"));
+    }
+}

package/lib/commands/createServicesCommand.js

@@ -3,6 +3,7 @@ import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOpti
 import { saveFile } from "../helpers/saveFile.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 import { aYOUneModules } from "../../data/modules.js";
 import { aYOUneServices } from "../../data/services.js";
 function buildServiceRegistry() {
@@ -61,8 +62,7 @@ export function createServicesCommand(program) {
                 await saveFile("services-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list services" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list services", EXIT_GENERAL_ERROR);
         }
     });
     // ay services endpoints <host>
@@ -110,8 +110,7 @@ Examples:
                 await saveFile("service-endpoints", opts, formattedRes);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to fetch endpoints" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to fetch endpoints", EXIT_GENERAL_ERROR);
         }
     });
     // ay services health [host]
@@ -174,8 +173,7 @@ Examples:
                 await saveFile("services-health", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Health check failed" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Health check failed", EXIT_GENERAL_ERROR);
         }
     });
     // ay services describe <module>
@@ -221,8 +219,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to describe service" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to describe service", EXIT_GENERAL_ERROR);
         }
     });
 }