@youkno/edge-cli 1.20.2314

package/README.md

@@ -0,0 +1,44 @@
+# edge-cli
+
+Node/TypeScript replacement for `edge-api.sh`.
+
+## Local usage
+
+```bash
+cd edge-cli
+yarn install
+yarn build
+yarn node dist/index.js --help
+```
+
+## Implemented commands
+
+- `config`
+- `health-check`
+- `product:default <product>`
+- `login`
+- `login:list`
+- `login:use <email>`
+- `logout [email]`
+- `token [--refresh] [--header]`
+- `shell [--json] [--dry-run|--validate] [--continue-on-error] [--request-id <id>] [-v key=value] [<command>|<script.esh>]`
+- `upload-users [-q] [-l] [-p] <file>`
+
+## Global flags
+
+- `--product`
+- `--env` (`devlocal|devel|prod`)
+- `--base-url`
+- `--client`
+- `--auth`
+- `--config-path`
+
+`.edge-api` files are read from:
+
+1. `/etc/edge-api`
+2. `./.edge-api`
+3. `~/.edge-api`
+
+JWT session data is stored at `~/.edge-cli-auth/accounts.json`.
+
+If no product is provided (`--product` or `PRODUCT=` in `.edge-api`), `edge-cli` shows an interactive product selector when running in a TTY.

package/dist/commands/config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfig = registerConfig;
+const config_1 = require("../lib/config");
+function registerConfig(program) {
+    program
+        .command("config")
+        .description("Print effective configuration")
+        .option("--json", "Print as JSON")
+        .action(async function configAction(commandOptions) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const resolved = await (0, config_1.resolveEffectiveConfig)(opts);
+        if (commandOptions.json) {
+            process.stdout.write(`${JSON.stringify(resolved, null, 2)}\n`);
+            return;
+        }
+        process.stdout.write(`product=${resolved.product}\n`);
+        process.stdout.write(`env=${resolved.env}\n`);
+        process.stdout.write(`baseUrl=${resolved.baseUrl}\n`);
+        process.stdout.write(`clientId=${resolved.clientId ?? ""}\n`);
+        process.stdout.write(`auth=${resolved.auth ? "<configured>" : ""}\n`);
+        process.stdout.write(`configFiles=${resolved.configFiles.join(",") || "<none>"}\n`);
+    });
+}

package/dist/commands/healthCheck.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHealthCheck = registerHealthCheck;
+const config_1 = require("../lib/config");
+const http_1 = require("../lib/http");
+function registerHealthCheck(program) {
+    program
+        .command("health-check")
+        .description("Call /health_check on the selected API")
+        .option("--key <key>", "Health check key; can also come from HEALTH_CHECK_KEY")
+        .action(async function healthCheckAction(commandOptions) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const resolved = await (0, config_1.resolveEffectiveConfig)(opts);
+        const key = commandOptions.key ?? process.env.HEALTH_CHECK_KEY;
+        if (!key) {
+            throw new Error("Missing health check key. Pass --key or set HEALTH_CHECK_KEY.");
+        }
+        const stateHeader = `${resolved.product}.${resolved.env}`;
+        const url = `${resolved.baseUrl.replace(/\/$/, "")}/health_check`;
+        const { status, body } = await (0, http_1.getText)(url, {
+            "X-edge-state": stateHeader,
+            Authorization: (0, http_1.basicAuthHeader)("api_user", key)
+        });
+        if (status >= 400) {
+            throw new Error(`Health check failed (${status}) for ${url}: ${body}`);
+        }
+        process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
+    });
+}

package/dist/commands/login.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogin = registerLogin;
+const auth_1 = require("../lib/auth");
+const config_1 = require("../lib/config");
+function registerLogin(program) {
+    program
+        .command("login")
+        .description("Authenticate via browser and store JWT tokens")
+        .action(async function loginAction() {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        const email = await (0, auth_1.login)(cfg);
+        process.stdout.write(`Successfully authenticated as ${email}\n`);
+    });
+    program
+        .command("login:list")
+        .description("List saved accounts for current product/environment")
+        .action(async function listAction() {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        const accounts = (0, auth_1.listLogins)(cfg);
+        if (accounts.length === 0) {
+            process.stdout.write(`No saved JWT session for ${cfg.product}/${cfg.env}.\n`);
+            return;
+        }
+        for (const account of accounts) {
+            process.stdout.write(`${account.isDefault ? "*" : " "} ${account.email}\n`);
+        }
+    });
+    program
+        .command("login:use")
+        .description("Set default account for current product/environment")
+        .argument("<email>")
+        .action(async function useAction(email) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        (0, auth_1.setDefaultLogin)(cfg, email);
+        process.stdout.write(`Default account: ${email}\n`);
+    });
+    program
+        .command("logout")
+        .description("Logout account (default if not provided)")
+        .argument("[email]")
+        .action(async function logoutAction(email) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        const removed = await (0, auth_1.logout)(cfg, email);
+        process.stdout.write(`Logged out: ${removed}\n`);
+    });
+}

package/dist/commands/product.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProduct = registerProduct;
+const config_1 = require("../lib/config");
+function registerProduct(program) {
+    program
+        .command("product:default")
+        .description("Set or clear default PRODUCT in .edge-api")
+        .argument("[product]", "Product key (e.g. belong, stash, alleaves)")
+        .option("--file <path>", "Target edge-api config file (default: ~/.edge-api)")
+        .option("--clear", "Remove PRODUCT from target .edge-api file")
+        .action(function productDefaultAction(product, options) {
+        if (!options.clear && !product) {
+            throw new Error("Missing product. Pass <product> or use --clear.");
+        }
+        const target = (0, config_1.setDefaultProduct)(options.clear ? undefined : product, options.file);
+        if (options.clear) {
+            process.stdout.write(`Cleared PRODUCT in ${target}\n`);
+        }
+        else {
+            process.stdout.write(`Set PRODUCT=${(product ?? "").toLowerCase()} in ${target}\n`);
+        }
+    });
+}

package/dist/commands/shell.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerShell = registerShell;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_readline_1 = __importDefault(require("node:readline"));
+const auth_1 = require("../lib/auth");
+const config_1 = require("../lib/config");
+const request_1 = require("../lib/request");
+function resolveInlineScript(script, vars) {
+    const header = (vars ?? []).join("\n");
+    return header ? `${header}\n${script}\n` : `${script}\n`;
+}
+function renderEsh(filePath, stack = []) {
+    const absolutePath = node_path_1.default.resolve(filePath);
+    if (stack.includes(absolutePath)) {
+        throw new Error(`Circular include detected: ${absolutePath}`);
+    }
+    if (!node_fs_1.default.existsSync(absolutePath)) {
+        throw new Error(`Script file not found: ${absolutePath}`);
+    }
+    const lines = node_fs_1.default.readFileSync(absolutePath, "utf8").split(/\r?\n/);
+    const out = [];
+    const nextStack = [...stack, absolutePath];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (trimmed.startsWith("include ")) {
+            let includePath = trimmed.replace(/^include\s+/, "").trim();
+            if ((includePath.startsWith('"') && includePath.endsWith('"')) || (includePath.startsWith("'") && includePath.endsWith("'"))) {
+                includePath = includePath.slice(1, -1);
+            }
+            if (!includePath) {
+                throw new Error(`Missing include path in ${absolutePath}:${i + 1}`);
+            }
+            const includeFile = node_path_1.default.isAbsolute(includePath)
+                ? includePath
+                : node_path_1.default.resolve(node_path_1.default.dirname(absolutePath), includePath);
+            out.push(renderEsh(includeFile, nextStack));
+            continue;
+        }
+        out.push(line);
+    }
+    return out.join("\n");
+}
+async function shellCmd(cfg, authHeader, cmd, wantJson) {
+    const url = new URL(`${cfg.baseUrl.replace(/\/$/, "")}/shell`);
+    url.searchParams.set("cmd", cmd);
+    const headers = (0, request_1.baseHeaders)(cfg, authHeader);
+    if (wantJson) {
+        headers.Accept = "application/json";
+    }
+    const response = await fetch(url, {
+        method: "GET",
+        headers
+    });
+    const body = await (0, request_1.checkedText)(response, "shell");
+    if (wantJson) {
+        try {
+            const parsed = JSON.parse(body);
+            process.stdout.write(`${JSON.stringify(parsed, null, 2)}\n`);
+            return;
+        }
+        catch {
+            // fall through
+        }
+    }
+    process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
+}
+async function shellScript(cfg, authHeader, scriptText, options, scriptName = "inline.esh") {
+    const url = new URL(`${cfg.baseUrl.replace(/\/$/, "")}/shell/script`);
+    url.searchParams.set("scriptName", scriptName);
+    url.searchParams.set("dryRun", String(Boolean(options.dryRun || options.validate)));
+    url.searchParams.set("continueOnError", String(Boolean(options.continueOnError)));
+    if (options.requestId) {
+        url.searchParams.set("requestId", options.requestId);
+    }
+    const headers = (0, request_1.baseHeaders)(cfg, authHeader);
+    headers["Content-Type"] = "text/plain";
+    if (options.json) {
+        headers.Accept = "application/json";
+    }
+    const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: scriptText
+    });
+    const body = await (0, request_1.checkedText)(response, "shell script");
+    if (options.json) {
+        try {
+            const parsed = JSON.parse(body);
+            process.stdout.write(`${JSON.stringify(parsed, null, 2)}\n`);
+            return;
+        }
+        catch {
+            // fall through
+        }
+    }
+    process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
+}
+async function repl(cfg, authHeader, options) {
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true
+    });
+    process.stdout.write("Type Ctrl-D to exit, 'help' for help\n");
+    rl.setPrompt(`${cfg.env}> `);
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const cmd = line.trim();
+        if (!cmd) {
+            rl.prompt();
+            return;
+        }
+        try {
+            await shellCmd(cfg, authHeader, cmd, Boolean(options.json));
+        }
+        catch (err) {
+            process.stderr.write(`ERROR: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        rl.prompt();
+    });
+    await new Promise((resolve) => {
+        rl.on("close", () => {
+            process.stdout.write("\n");
+            resolve();
+        });
+    });
+}
+function registerShell(program) {
+    program
+        .command("shell")
+        .description("Run shell command/script against Edge API")
+        .option("--json", "request JSON output when available")
+        .option("--dry-run", "run script in dry-run mode")
+        .option("--validate", "alias for --dry-run")
+        .option("--continue-on-error", "continue script execution on errors")
+        .option("--request-id <id>", "request ID")
+        .option("-v, --var <key=value>", "script variable", (value, prev = []) => {
+        if (!value.includes("=")) {
+            throw new Error(`Invalid variable assignment: ${value} (expected key=value)`);
+        }
+        prev.push(value);
+        return prev;
+    })
+        .argument("[target]", "Command or .esh file")
+        .argument("[inlineScript...]", "Inline script chunks when using --")
+        .action(async function shellAction(target, inlineScript) {
+        const parent = this.parent;
+        const rootOpts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(rootOpts);
+        const options = this.opts();
+        const authHeader = await (0, auth_1.resolveAuthHeader)(cfg);
+        if (!target && (!inlineScript || inlineScript.length === 0)) {
+            await repl(cfg, authHeader, options);
+            return;
+        }
+        if (target?.endsWith(".esh")) {
+            const rendered = renderEsh(target);
+            const payload = resolveInlineScript(rendered, options.vars);
+            await shellScript(cfg, authHeader, payload, options, node_path_1.default.basename(target));
+            return;
+        }
+        if (inlineScript && inlineScript.length > 0) {
+            const payload = resolveInlineScript(inlineScript.join(" "), options.vars);
+            await shellScript(cfg, authHeader, payload, options, "inline.esh");
+            return;
+        }
+        if (options.dryRun || options.validate || options.continueOnError || options.requestId || (options.vars?.length ?? 0) > 0) {
+            const payload = resolveInlineScript(target ?? "", options.vars);
+            await shellScript(cfg, authHeader, payload, options, "inline.esh");
+            return;
+        }
+        await shellCmd(cfg, authHeader, target ?? "", Boolean(options.json));
+    });
+}

package/dist/commands/token.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerToken = registerToken;
+const auth_1 = require("../lib/auth");
+const config_1 = require("../lib/config");
+function registerToken(program) {
+    program
+        .command("token")
+        .description("Print a JWT access token for API calls (e.g. Postman)")
+        .option("--refresh", "Force refresh using refresh token when available")
+        .option("--header", "Print as Authorization header line")
+        .action(async function tokenAction(commandOptions) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        const token = await (0, auth_1.resolveAccessToken)(cfg, Boolean(commandOptions.refresh));
+        if (commandOptions.header) {
+            process.stdout.write(`Authorization: Bearer ${token}\n`);
+            return;
+        }
+        process.stdout.write(`${token}\n`);
+    });
+}

package/dist/commands/uploadUsers.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUploadUsers = registerUploadUsers;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const auth_1 = require("../lib/auth");
+const config_1 = require("../lib/config");
+const request_1 = require("../lib/request");
+function registerUploadUsers(program) {
+    program
+        .command("upload-users")
+        .description("Upload users CSV for a client")
+        .option("-q, --quiet", "quiet mode")
+        .option("-l, --lenient", "lenient parser mode")
+        .option("-p, --partial", "partial mode")
+        .argument("<file>", "CSV file")
+        .action(async function uploadUsersAction(file, commandOptions) {
+        const parent = this.parent;
+        const opts = (parent?.opts() ?? {});
+        const cfg = await (0, config_1.resolveEffectiveConfig)(opts);
+        if (!cfg.clientId) {
+            throw new Error("No client ID specified. Pass --client or set CLIENT_ID in .edge-api.");
+        }
+        const absoluteFile = node_path_1.default.resolve(process.cwd(), file);
+        if (!node_fs_1.default.existsSync(absoluteFile)) {
+            throw new Error(`File not found: ${absoluteFile}`);
+        }
+        const authHeader = await (0, auth_1.resolveAuthHeader)(cfg);
+        const url = new URL(`${cfg.baseUrl.replace(/\/$/, "")}/api/v1/clients/${cfg.clientId}/users`);
+        url.searchParams.set("dummy", "true");
+        if (commandOptions.partial) {
+            url.searchParams.set("partial", "true");
+        }
+        if (commandOptions.lenient) {
+            url.searchParams.set("lenient", "true");
+        }
+        if (commandOptions.quiet) {
+            url.searchParams.set("quiet", "true");
+        }
+        const data = node_fs_1.default.readFileSync(absoluteFile);
+        const form = new FormData();
+        form.append("file", new Blob([data], { type: "text/csv" }), node_path_1.default.basename(absoluteFile));
+        const response = await fetch(url, {
+            method: "POST",
+            headers: (0, request_1.baseHeaders)(cfg, authHeader),
+            body: form
+        });
+        const body = await (0, request_1.checkedText)(response, "upload-users");
+        process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
+    });
+}

package/dist/default-edge-api-config.json

@@ -0,0 +1,61 @@
+{
+    "api": {
+        "defaultBaseUrl": "https://api.youkno.ai",
+        "products": {
+            "youkno": {
+                "baseUrl": "https://api.youkno.ai",
+                "active": false,
+                "aliases": ["belong"],
+                "consoleBaseProd": "https://belong-prod.web.app",
+                "consoleBaseTest": "https://belong-prod--testapp-q8kk4dm6.web.app"
+            },
+            "stash": {
+                "baseUrl": "https://api.mystash.co",
+                "active": false,
+                "aliases": [],
+                "consoleBaseProd": "https://stash-prod.web.app",
+                "consoleBaseTest": "https://stash-prod--testapp-ef23abcf.web.app"
+            },
+            "alleaves": {
+                "baseUrl": "https://api.alleaves.shop",
+                "active": true,
+                "aliases": [],
+                "consoleBaseProd": "https://console.alleaves.shop",
+                "consoleBaseTest": "https://alleaves-prod--testapp-vn1b2q7v.web.app"
+            },
+            "vera": {
+                "baseUrl": "https://edge-server-dfkcix6pxa-uc.a.run.app",
+                "active": false,
+                "aliases": [],
+                "consoleBaseProd": "https://vera-af0c2.web.app",
+                "consoleBaseTest": "https://vera-af0c2--testapp-23e7fe3c.web.app"
+            },
+            "vip": {
+                "baseUrl": "https://edge-server-a465iqwona-uc.a.run.app",
+                "active": false,
+                "aliases": [],
+                "consoleBaseProd": "https://vip-app-6a3d4.web.app",
+                "consoleBaseTest": "https://vip-app-6a3d4--testapp-h34bc19a.web.app"
+            },
+            "dinamo1948": {
+                "baseUrl": "https://api.dinamo1948.ro",
+                "active": true,
+                "aliases": [],
+                "consoleBaseProd": "https://console.dinamo1948.ro",
+                "consoleBaseTest": "https://dinamo1948-prod--testapp-f48fznbf.web.app"
+            },
+            "propatrimonio": {
+                "baseUrl": "https://api.propatrimonio.org",
+                "active": true,
+                "aliases": []
+            },
+            "campaigns": {
+                "baseUrl": "https://api.getcampaigns.com",
+                "active": true,
+                "aliases": [],
+                "consoleBaseProd": "https://console.getcampaigns.com",
+                "consoleBaseTest": "https://campaigns-abd4a--testapp-ht9twxoz.web.app"
+            }
+        }
+    }
+}

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const config_1 = require("./commands/config");
+const healthCheck_1 = require("./commands/healthCheck");
+const login_1 = require("./commands/login");
+const product_1 = require("./commands/product");
+const shell_1 = require("./commands/shell");
+const token_1 = require("./commands/token");
+const uploadUsers_1 = require("./commands/uploadUsers");
+const program = new commander_1.Command();
+program
+    .name("edge-cli")
+    .description("Edge API command line client")
+    .version("0.2.0")
+    .option("-p, --product <product>", "Product key (youkno, stash, alleaves, ...)")
+    .option("--env <env>", "Environment (devlocal|devel|prod)", "prod")
+    .option("--base-url <url>", "Override API base URL")
+    .option("--client <clientId>", "Client ID")
+    .option("--auth <token:secret>", "Client auth token")
+    .option("--config-path <path>", "Additional edge-api style config file")
+    .hook("preAction", (command) => {
+    const env = command.opts().env;
+    const validEnvs = ["devlocal", "devel", "prod"];
+    if (!validEnvs.includes(env)) {
+        throw new Error(`Invalid --env '${env}'. Expected one of: ${validEnvs.join(", ")}`);
+    }
+});
+(0, config_1.registerConfig)(program);
+(0, healthCheck_1.registerHealthCheck)(program);
+(0, product_1.registerProduct)(program);
+(0, login_1.registerLogin)(program);
+(0, token_1.registerToken)(program);
+(0, shell_1.registerShell)(program);
+(0, uploadUsers_1.registerUploadUsers)(program);
+program.parseAsync(process.argv).catch((error) => {
+    process.stderr.write(`ERROR: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});