@elaraai/e3-cloud-cli 0.0.0-stage → 1.0.89-alpha.0

package/dist/src/commands/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../../src/commands/secrets.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/staging.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Staging:
+ *
+ * - `e3-cloud staging add <repo-url> <live> <name> [--as-is] [--replace] [--plan]`
+ * - `e3-cloud staging stop <repo-url> <live>` (admins)
+ * - `e3-cloud staging list <repo-url>`
+ *
+ * A workspace's staging is where changes are tried before they go live; the
+ * workspace it releases to is then protected, as a protected branch is: its
+ * package and apps change only by a release from its staging (`e3-cloud
+ * release`), or a rollback. `add` prints its plan first, always; `--plan`
+ * stops there. A staging starts as a copy of the live workspace, and a copy
+ * replaces a workspace of its name whole, so one there is replaced only with
+ * `--replace`; `--as-is` makes the workspace of the name the staging as it
+ * stands. Only an admin stops a staging, which deletes nothing.
+ */
+import { type StagingPlan } from '@elaraai/e3-cloud-client';
+/** What adding a staging does, a line for each part. */
+export declare function stagingPlanLines(plan: StagingPlan): string[];
+export declare const stagingCommand: {
+    /** e3-cloud staging add <repoUrl> <live> <name> [--as-is] [--replace] [--plan] */
+    add(url: string, live: string, name: string, options: {
+        asIs?: boolean;
+        replace?: boolean;
+        plan?: boolean;
+    }): Promise<void>;
+    /** e3-cloud staging stop <repoUrl> <live> */
+    stop(url: string, live: string): Promise<void>;
+    /** e3-cloud staging list <repoUrl> */
+    list(url: string): Promise<void>;
+};
+//# sourceMappingURL=staging.d.ts.map

package/dist/src/commands/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../../../src/commands/staging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,0BAA0B,CAAC;AAYlC,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAW5D;AAED,eAAO,MAAM,cAAc;IACzB,kFAAkF;aACnE,MAAM,QAAQ,MAAM,QAAQ,MAAM,WAAW;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjI,6CAA6C;cAC7B,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD,sCAAsC;cACtB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAcvC,CAAC"}

package/dist/src/commands/staging.js

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Staging:
+ *
+ * - `e3-cloud staging add <repo-url> <live> <name> [--as-is] [--replace] [--plan]`
+ * - `e3-cloud staging stop <repo-url> <live>` (admins)
+ * - `e3-cloud staging list <repo-url>`
+ *
+ * A workspace's staging is where changes are tried before they go live; the
+ * workspace it releases to is then protected, as a protected branch is: its
+ * package and apps change only by a release from its staging (`e3-cloud
+ * release`), or a rollback. `add` prints its plan first, always; `--plan`
+ * stops there. A staging starts as a copy of the live workspace, and a copy
+ * replaces a workspace of its name whole, so one there is replaced only with
+ * `--replace`; `--as-is` makes the workspace of the name the staging as it
+ * stands. Only an admin stops a staging, which deletes nothing.
+ */
+import { addStaging, getRepositoryReleaseSettings, stopStaging, } from '@elaraai/e3-cloud-client';
+import { variant } from '@elaraai/east';
+import { getValidToken } from '../credentials.js';
+import { exitError, formatError, parseRepoUrl } from '../utils.js';
+/** What a workspace runs, in words: `acme@1.5.0 · ops v3, exec v1`. */
+function runsWords(runs) {
+    const pkg = runs.package.type === 'some' ? `${runs.package.value.name}@${runs.package.value.version}` : 'no package';
+    const apps = runs.apps.map((app) => `${app.name} v${app.number}`).join(', ');
+    return apps === '' ? pkg : `${pkg} · ${apps}`;
+}
+/** What adding a staging does, a line for each part. */
+export function stagingPlanLines(plan) {
+    const lines = [`Add ${plan.staging} as ${plan.live}'s staging`];
+    const row = (label, words) => lines.push(`  ${label.padEnd(10)} ${words}`);
+    if (plan.start.type === 'copy') {
+        row('Starts as', `a copy of ${plan.live} as it is now: ${runsWords(plan.runs)}, and its data`);
+        if (plan.replaces.type === 'some')
+            row('Replaces', `${plan.staging} as it is: ${runsWords(plan.replaces.value)}, and its data`);
+    }
+    else {
+        row('Starts as', `${plan.staging} as it stands: ${runsWords(plan.runs)}`);
+    }
+    row('Protects', `${plan.live}: from then on it changes only by a release from ${plan.staging}, or a rollback`);
+    return lines;
+}
+export const stagingCommand = {
+    /** e3-cloud staging add <repoUrl> <live> <name> [--as-is] [--replace] [--plan] */
+    async add(url, live, name, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const start = options.asIs === true ? variant('as_is', null) : variant('copy', null);
+            const planned = await addStaging(baseUrl, repo, live, { name, start, plan: true }, { token });
+            console.log(stagingPlanLines(planned.value).join('\n'));
+            if (options.plan === true)
+                return;
+            // A copy replaces a workspace of the name whole: never unasked
+            if (planned.value.replaces.type === 'some' && options.replace !== true) {
+                exitError(`${name} is there already: --replace replaces it with a copy of ${live}, its data included, or --as-is makes it ${live}'s staging as it stands`);
+            }
+            const added = await addStaging(baseUrl, repo, live, { name, start, plan: false }, { token });
+            console.log(`Done: ${added.value.staging} is ${live}'s staging, and ${live} is protected. Deploy to ${added.value.staging}, then release it with e3-cloud release`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud staging stop <repoUrl> <live> */
+    async stop(url, live) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const link = await stopStaging(baseUrl, repo, live, { token });
+            console.log(`Done: ${link.staging} is no longer ${live}'s staging, and ${live} is no longer protected. Nothing was deleted; ${live}'s history records who stopped it`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud staging list <repoUrl> */
+    async list(url) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const { releasesTo } = await getRepositoryReleaseSettings(baseUrl, repo, { token });
+            if (releasesTo.size === 0) {
+                console.log(`${repo} has no staging: no workspace is protected`);
+                return;
+            }
+            for (const [staging, live] of releasesTo)
+                console.log(`${staging} → ${live}  (${live} is protected: it changes only by a release from ${staging})`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=staging.js.map

package/dist/src/commands/staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../../../src/commands/staging.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/timeout.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export declare const timeoutCommand: {
+    set(url: string, taskNameOrPattern: string, options: {
+        timeout: string;
+        regex?: boolean;
+    }): Promise<void>;
+    get(url: string, taskName: string): Promise<void>;
+    list(url: string): Promise<void>;
+    remove(url: string, taskNameOrPattern: string, options: {
+        regex?: boolean;
+    }): Promise<void>;
+};
+//# sourceMappingURL=timeout.d.ts.map

package/dist/src/commands/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../src/commands/timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwCH,eAAO,MAAM,cAAc;aAElB,MAAM,qBACQ,MAAM,WAChB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5C,OAAO,CAAC,IAAI,CAAC;aA6BD,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAYvC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAuB/B,MAAM,qBACQ,MAAM,WAChB;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;CAyBjB,CAAC"}

package/dist/src/commands/timeout.js

@@ -0,0 +1,124 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Task timeout management commands — set, get, list, remove.
+ */
+import { TIMEOUT_MIN_MINUTES, TIMEOUT_MAX_MINUTES } from '@elaraai/e3-cloud-types';
+import { listTimeout, getTimeout, setTimeout, setTimeoutBatch, removeTimeout, removeTimeoutBatch, } from '@elaraai/e3-cloud-client';
+import { taskList } from '@elaraai/e3-api-client';
+import { getValidToken } from '../credentials.js';
+import { parseWorkspaceUrl, formatError, exitError, confirm } from '../utils.js';
+function parseTimeout(s) {
+    const match = s.match(/^(\d+)(m|h|d)?$/);
+    if (!match) {
+        exitError(`Invalid timeout: ${s}. Use minutes (e.g., 120), hours (e.g., 2h), or days (e.g., 1d)`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2] ?? 'm';
+    const minutes = unit === 'h' ? value * 60 : unit === 'd' ? value * 1440 : value;
+    if (minutes < TIMEOUT_MIN_MINUTES || minutes > TIMEOUT_MAX_MINUTES) {
+        exitError(`Timeout must be between ${TIMEOUT_MIN_MINUTES} minute and ${TIMEOUT_MAX_MINUTES} minutes, got ${minutes} minutes`);
+    }
+    return BigInt(minutes);
+}
+function formatMinutes(minutes) {
+    const m = Number(minutes);
+    if (m >= 1440 && m % 1440 === 0)
+        return `${m / 1440}d`;
+    if (m >= 60 && m % 60 === 0)
+        return `${m / 60}h`;
+    return `${m}m`;
+}
+export const timeoutCommand = {
+    async set(url, taskNameOrPattern, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const minutes = parseTimeout(options.timeout);
+            const timeout = { minutes };
+            if (options.regex) {
+                const tasks = await taskList(baseUrl, repo, workspace, { token });
+                const regex = new RegExp(taskNameOrPattern);
+                const matched = tasks.filter(t => regex.test(t.name)).map(t => t.name);
+                if (matched.length === 0) {
+                    exitError(`No tasks matched pattern: ${taskNameOrPattern}`);
+                }
+                console.log(`Matched ${matched.length} tasks: ${matched.join(', ')}`);
+                if (!await confirm(`Set timeout ${formatMinutes(minutes)} for ${matched.length} tasks?`))
+                    return;
+                const configs = new Map();
+                for (const name of matched)
+                    configs.set(name, timeout);
+                await setTimeoutBatch(baseUrl, repo, workspace, configs, { token });
+                console.log(`Timeout ${formatMinutes(minutes)} set for ${matched.length} tasks`);
+            }
+            else {
+                await setTimeout(baseUrl, repo, workspace, taskNameOrPattern, timeout, { token });
+                console.log(`Timeout ${formatMinutes(minutes)} set for task '${taskNameOrPattern}'`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async get(url, taskName) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const timeout = await getTimeout(baseUrl, repo, workspace, taskName, { token });
+            console.log(`Timeout for '${taskName}': ${formatMinutes(timeout.minutes)}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async list(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const configs = await listTimeout(baseUrl, repo, workspace, { token });
+            const entries = [...configs.entries()];
+            if (entries.length === 0) {
+                console.log(`No timeout configs for ${repo}/${workspace} (all tasks use defaults)`);
+                return;
+            }
+            console.log(`Timeout configs for ${repo}/${workspace}:`);
+            for (const [taskName, timeout] of entries) {
+                console.log(`  ${taskName.padEnd(32)} ${formatMinutes(timeout.minutes)}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async remove(url, taskNameOrPattern, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            if (options.regex) {
+                const tasks = await taskList(baseUrl, repo, workspace, { token });
+                const regex = new RegExp(taskNameOrPattern);
+                const matched = tasks.filter(t => regex.test(t.name)).map(t => t.name);
+                if (matched.length === 0) {
+                    exitError(`No tasks matched pattern: ${taskNameOrPattern}`);
+                }
+                console.log(`Matched ${matched.length} tasks: ${matched.join(', ')}`);
+                if (!await confirm(`Remove timeout config for ${matched.length} tasks?`))
+                    return;
+                // One request for them all
+                await removeTimeoutBatch(baseUrl, repo, workspace, matched, { token });
+                console.log(`Timeout config removed for ${matched.length} tasks`);
+            }
+            else {
+                await removeTimeout(baseUrl, repo, workspace, taskNameOrPattern, { token });
+                console.log(`Timeout config removed for task '${taskNameOrPattern}'`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=timeout.js.map

package/dist/src/commands/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../src/commands/timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAoB,MAAM,yBAAyB,CAAC;AACrG,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjF,SAAS,YAAY,CAAC,CAAS;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,SAAS,CAAC,oBAAoB,CAAC,iEAAiE,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,KAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAChF,IAAI,OAAO,GAAG,mBAAmB,IAAI,OAAO,GAAG,mBAAmB,EAAE,CAAC;QACnE,SAAS,CAAC,2BAA2B,mBAAmB,eAAe,mBAAmB,iBAAiB,OAAO,UAAU,CAAC,CAAC;IAChI,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IACjD,OAAO,GAAG,CAAC,GAAG,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,GAAG,CACP,GAAW,EACX,iBAAyB,EACzB,OAA6C;QAE7C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAgB,EAAE,OAAO,EAAE,CAAC;YAEzC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,SAAS,CAAC,6BAA6B,iBAAiB,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtE,IAAI,CAAC,MAAM,OAAO,CAAC,eAAe,aAAa,CAAC,OAAO,CAAC,QAAQ,OAAO,CAAC,MAAM,SAAS,CAAC;oBAAE,OAAO;gBACjG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;gBAC/C,KAAK,MAAM,IAAI,IAAI,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACvD,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpE,OAAO,CAAC,GAAG,CAAC,WAAW,aAAa,CAAC,OAAO,CAAC,YAAY,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;YACnF,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClF,OAAO,CAAC,GAAG,CAAC,WAAW,aAAa,CAAC,OAAO,CAAC,kBAAkB,iBAAiB,GAAG,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,QAAgB;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,MAAM,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,IAAI,SAAS,2BAA2B,CAAC,CAAC;gBACpF,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,SAAS,GAAG,CAAC,CAAC;YACzD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAW,EACX,iBAAyB,EACzB,OAA4B;QAE5B,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YAE3C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,SAAS,CAAC,6BAA6B,iBAAiB,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtE,IAAI,CAAC,MAAM,OAAO,CAAC,6BAA6B,OAAO,CAAC,MAAM,SAAS,CAAC;oBAAE,OAAO;gBACjF,2BAA2B;gBAC3B,MAAM,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvE,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC5E,OAAO,CAAC,GAAG,CAAC,oCAAoC,iBAAiB,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/commands/user-settings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export declare const settingsCommand: {
+    get(url: string, options: {
+        output?: string;
+    }): Promise<void>;
+    set(url: string, options: {
+        input?: string;
+        data?: string;
+    }): Promise<void>;
+    remove(url: string): Promise<void>;
+};
+//# sourceMappingURL=user-settings.d.ts.map

package/dist/src/commands/user-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-settings.d.ts","sourceRoot":"","sources":["../../../src/commands/user-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,eAAO,MAAM,eAAe;aACX,MAAM,WAAW;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;aAwBpD,MAAM,WAAW;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;gBA4B/D,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWzC,CAAC"}

package/dist/src/commands/user-settings.js

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * User settings management commands — get, set, remove.
+ */
+import { getUserSettings, putUserSettings, deleteUserSettings, } from '@elaraai/e3-cloud-client';
+import { getValidToken } from '../credentials.js';
+import { parseWorkspaceUrl, formatError, exitError } from '../utils.js';
+export const settingsCommand = {
+    async get(url, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const data = await getUserSettings(baseUrl, repo, workspace, { token });
+            if (!data) {
+                console.log('No settings stored.');
+                return;
+            }
+            if (options.output) {
+                const fs = await import('node:fs');
+                fs.writeFileSync(options.output, data);
+                console.log(`Settings written to ${options.output} (${data.byteLength} bytes)`);
+            }
+            else {
+                // Write raw bytes to stdout
+                process.stdout.write(data);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async set(url, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            let payload;
+            if (options.input) {
+                const fs = await import('node:fs');
+                payload = fs.readFileSync(options.input);
+            }
+            else if (options.data) {
+                payload = new TextEncoder().encode(options.data);
+            }
+            else {
+                // Read from stdin
+                const chunks = [];
+                for await (const chunk of process.stdin) {
+                    chunks.push(chunk);
+                }
+                payload = new Uint8Array(Buffer.concat(chunks));
+            }
+            await putUserSettings(baseUrl, repo, workspace, payload, { token });
+            console.log(`Settings saved (${payload.byteLength} bytes)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async remove(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            await deleteUserSettings(baseUrl, repo, workspace, { token });
+            console.log('Settings removed.');
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=user-settings.js.map

package/dist/src/commands/user-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-settings.js","sourceRoot":"","sources":["../../../src/commands/user-settings.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/user.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { RepoRole } from '@elaraai/e3-cloud-types';
+/** A role in words: owner; or user and its business roles. */
+export declare function roleWords(role: RepoRole): string;
+export declare const userCommand: {
+    /** e3-cloud user list-all <serverUrl> — merged deployment user listing (admin) */
+    listAll(serverUrl: string): Promise<void>;
+    /** e3-cloud user disable <serverUrl> <emailOrSub> — block platform sign-in (admin) */
+    disable(serverUrl: string, emailOrSub: string): Promise<void>;
+    /** e3-cloud user enable <serverUrl> <emailOrSub> — restore platform sign-in (admin) */
+    enable(serverUrl: string, emailOrSub: string): Promise<void>;
+    /** e3-cloud user invitations <serverUrl> — list invitations (admin) */
+    invitations(serverUrl: string): Promise<void>;
+    /** e3-cloud user uninvite <serverUrl> <email> — revoke a pending invitation (admin) */
+    uninvite(serverUrl: string, email: string): Promise<void>;
+    list(url: string): Promise<void>;
+    add(url: string, email: string, options: {
+        role: string;
+        roles?: string;
+    }): Promise<void>;
+    remove(url: string, email: string): Promise<void>;
+};
+//# sourceMappingURL=user.d.ts.map

package/dist/src/commands/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/commands/user.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmBxD,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEhD;AAED,eAAO,MAAM,WAAW;IACtB,kFAAkF;uBACzD,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B/C,sFAAsF;uBAC7D,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnE,uFAAuF;sBAC/D,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,uEAAuE;2BAC1C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD,uFAAuF;wBAC7D,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAU/C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;aAmCvB,MAAM,SAAS,MAAM,WAAW;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;gBA+B7E,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BxD,CAAC"}

package/dist/src/commands/user.js

@@ -0,0 +1,206 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * User management commands - list, add, remove users from repositories.
+ */
+import { repoUsers, addUser, removeUser, repoInvitations, revokeRepoInvitation } from '@elaraai/e3-cloud-client';
+import { listInvitations, revokeInvitation, isInvitedSentinel } from '@elaraai/e3-cloud-client';
+import { listAdminUsers, lookupPeople, disableUser, enableUser } from '@elaraai/e3-cloud-client';
+import { variant } from '@elaraai/east';
+import { getValidToken } from '../credentials.js';
+import { parseRepoUrl, formatError, exitError } from '../utils.js';
+/**
+ * The directory account an email-or-sub argument names: a lookup of the one
+ * person, never the directory listed.
+ */
+async function resolvePerson(serverUrl, emailOrSub, token) {
+    const byEmail = emailOrSub.includes('@');
+    const found = await lookupPeople(serverUrl, byEmail ? { emails: [emailOrSub] } : { subs: [emailOrSub] }, { token });
+    const matches = found.filter((p) => (byEmail ? p.email.toLowerCase() === emailOrSub.toLowerCase() : p.sub === emailOrSub));
+    if (matches.length === 0) {
+        exitError(`No directory account matches '${emailOrSub}'${byEmail ? ` (someone invited who has not signed in yet has none: 'user uninvite' revokes an invitation)` : ''}`);
+    }
+    if (matches.length > 1)
+        exitError(`Several accounts hold ${emailOrSub}: name one by its sub (${matches.map((p) => p.sub).join(', ')})`);
+    return matches[0];
+}
+/** A role in words: owner; or user and its business roles. */
+export function roleWords(role) {
+    return role.type === 'owner' ? 'owner' : role.value.roles.length === 0 ? 'user (no roles)' : `user: ${role.value.roles.join(', ')}`;
+}
+export const userCommand = {
+    /** e3-cloud user list-all <serverUrl> — merged deployment user listing (admin) */
+    async listAll(serverUrl) {
+        try {
+            const token = await getValidToken(serverUrl);
+            const users = await listAdminUsers(serverUrl, { token });
+            if (users.length === 0) {
+                console.log('No users.');
+                return;
+            }
+            console.log('STATUS'.padEnd(10) + 'EMAIL'.padEnd(36) + 'REPOS'.padEnd(30) + 'LAST SEEN'.padEnd(21) + 'ONBOARDING');
+            for (const user of users) {
+                const repos = user.memberships.map((m) => `${m.repo}:${roleWords(m.role)}`).join(', ');
+                const lastSeen = user.lastSeenAt.type === 'some' ? user.lastSeenAt.value.substring(0, 19) : '-';
+                const entra = user.invitation.type === 'some' && user.invitation.value.entra.type === 'some'
+                    ? user.invitation.value.entra.value.status.type
+                    : '';
+                console.log(user.status.type.padEnd(10)
+                    + user.email.padEnd(36)
+                    + (repos || '-').padEnd(30)
+                    + lastSeen.padEnd(21)
+                    + entra);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud user disable <serverUrl> <emailOrSub> — block platform sign-in (admin) */
+    async disable(serverUrl, emailOrSub) {
+        try {
+            const token = await getValidToken(serverUrl);
+            const person = await resolvePerson(serverUrl, emailOrSub, token);
+            await disableUser(serverUrl, person.sub, { token });
+            console.log(`Disabled ${person.email} — platform sign-in blocked (their identity-provider account is unaffected)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud user enable <serverUrl> <emailOrSub> — restore platform sign-in (admin) */
+    async enable(serverUrl, emailOrSub) {
+        try {
+            const token = await getValidToken(serverUrl);
+            const person = await resolvePerson(serverUrl, emailOrSub, token);
+            await enableUser(serverUrl, person.sub, { token });
+            console.log(`Enabled ${person.email}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud user invitations <serverUrl> — list invitations (admin) */
+    async invitations(serverUrl) {
+        try {
+            const token = await getValidToken(serverUrl);
+            const invitations = await listInvitations(serverUrl, { token });
+            if (invitations.length === 0) {
+                console.log('No invitations.');
+                return;
+            }
+            for (const inv of invitations) {
+                const grants = inv.grants.map((g) => `${g.repo}:${roleWords(g.role)}`).join(', ');
+                const entra = inv.entra.type === 'some'
+                    ? `  onboarding=${inv.entra.value.status.type}${inv.entra.value.detail.type === 'some' ? ` (${inv.entra.value.detail.value})` : ''}`
+                    : '';
+                console.log(`${inv.status.type.padEnd(8)} ${inv.email}  [${grants}]  invited ${inv.invitedAt} expires ${inv.expiresAt}${entra}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud user uninvite <serverUrl> <email> — revoke a pending invitation (admin) */
+    async uninvite(serverUrl, email) {
+        try {
+            const token = await getValidToken(serverUrl);
+            await revokeInvitation(serverUrl, email, { token });
+            console.log(`Revoked invitation for ${email}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async list(url) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            // The people, and those added who have not signed in yet
+            const [users, invited] = await Promise.all([repoUsers(baseUrl, repo, { token }), repoInvitations(baseUrl, repo, { token })]);
+            // Table header
+            console.log('USER ID'.padEnd(20) + 'EMAIL'.padEnd(30) + 'ROLE'.padEnd(32) + 'ADDED');
+            // User rows
+            for (const user of users) {
+                const row = [
+                    user.userId.substring(0, 18).padEnd(20),
+                    user.email.padEnd(30),
+                    roleWords(user.role).padEnd(32),
+                    user.addedAt.substring(0, 19),
+                ].join('');
+                console.log(row);
+            }
+            for (const invitation of invited) {
+                const row = [
+                    '(not signed in)'.padEnd(20),
+                    invitation.email.padEnd(30),
+                    roleWords(invitation.role).padEnd(32),
+                    invitation.invitedAt.substring(0, 19),
+                ].join('');
+                console.log(row);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async add(url, email, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            // An owner, or a user holding business roles by name: --roles
+            // 'Rostering,Finance', the built-in 'All apps' among them; none for a
+            // user given roles later
+            let role;
+            if (options.role === 'owner') {
+                if (options.roles !== undefined)
+                    exitError('An owner holds no business roles: --roles is for --role user.');
+                role = variant('owner', null);
+            }
+            else if (options.role === 'user') {
+                const roles = (options.roles ?? '').split(',').map((name) => name.trim()).filter((name) => name !== '');
+                role = variant('user', { roles });
+            }
+            else {
+                exitError(`Invalid role: ${options.role}. Use 'owner', or 'user' with --roles.`);
+            }
+            const user = await addUser(baseUrl, repo, { email, role }, { token });
+            if (isInvitedSentinel(user.userId)) {
+                console.log(`Invited ${user.email} as ${roleWords(user.role)} — access activates automatically on their first login`);
+            }
+            else {
+                console.log(`Added ${user.email} as ${roleWords(user.role)}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async remove(url, email) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            // First, find the user by email
+            const users = await repoUsers(baseUrl, repo, { token });
+            const user = users.find((u) => u.email.toLowerCase() === email.toLowerCase());
+            if (!user) {
+                // Someone added who has not signed in yet: their invitation's grant goes
+                const invited = (await repoInvitations(baseUrl, repo, { token })).find((i) => i.email === email.toLowerCase());
+                if (invited === undefined)
+                    exitError(`User ${email} not found in repository`);
+                await revokeRepoInvitation(baseUrl, repo, email, { token });
+                console.log(`Revoked ${email}'s invitation: no access at their first sign-in`);
+                return;
+            }
+            // Remove by userId
+            await removeUser(baseUrl, repo, user.userId, { token });
+            console.log(`Removed ${email}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=user.js.map