@atlasauth/cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,92 @@
-# Temporary Holding Version
+# @atlasauth/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`atlas` — manage an Atlas instance from the terminal, over the secret-key
+Backend API. The peer of `auth0-cli` and Clerk's `cli`, built directly on
+[`@atlasauth/backend`](../backend).
+
+## Install
+
+```sh
+npm i -g @atlasauth/cli
+# or run without installing:
+npx @atlasauth/cli --help
+```
+
+## Authentication
+
+The CLI is config-file + secret-key based, like `auth0-cli`'s token model — no
+dashboard OAuth app to register against.
+
+```sh
+atlas login                 # prompts for an API URL + an sk_ key, validates it
+atlas login --profile prod  # store a second, named credential
+atlas whoami                # show the active profile + instance (key masked)
+atlas logout                # forget a stored credential
+```
+
+`login` validates the key with one cheap Backend call before saving it to
+`~/.config/atlasauth/config.json` (mode `0600`). `--url` / `--secret-key` skip
+the prompts for CI.
+
+Env overrides (win over the stored profile, like most cloud CLIs):
+
+```sh
+ATLAS_SECRET_KEY=sk_live_... ATLAS_API_URL=https://api.atlasauth.net atlas users list
+```
+
+## Commands
+
+```
+atlas users    list | get <id> | create --email <e> | delete <id>
+atlas orgs     list | get <id> | members <id>
+atlas api-keys list | create --subject-type <t> --subject-id <id> | revoke <id>
+atlas webhooks list
+atlas sessions revoke <id>
+atlas config   export [--dir <path>] [--format json|yaml]
+atlas config   import [--dir <path>] [--format json|yaml] [--dry-run] [--prune]
+```
+
+Every command takes `--json` for raw JSON (otherwise a human table). Paginated
+lists (`users list`, `orgs list`) take `--limit <n>` and `--starting-after
+<cursor>`; the table footer prints the exact cursor flag for the next page.
+
+```sh
+atlas users list --limit 20
+atlas users list --json | jq '.data[].id'
+atlas api-keys create --subject-type user --subject-id user_123 --name ci
+```
+
+Run `atlas --help` or `atlas <command> --help` for details, `atlas --version`
+for the version.
+
+## Config-as-code (`atlas config`)
+
+The Auth0 `deploy-cli` equivalent: round-trip an instance's configuration to a
+deterministic directory tree you keep in Git. `export` writes one file per
+resource type with sorted keys and **secrets omitted**; `import` diffs the
+directory against the live instance and applies creates/updates idempotently.
+
+```sh
+atlas config export --dir ./atlas-config          # snapshot the instance
+atlas config import --dir ./atlas-config --dry-run # preview the plan
+atlas config import --dir ./atlas-config           # apply creates/updates
+atlas config import --dir ./atlas-config --prune   # also delete removed resources
+```
+
+Managed resource types (the same set the Terraform provider manages):
+`instance` (auth config + allowed origins), `oauth_clients`, `oauth_providers`,
+`sso_connections`, `resource_servers`, `jwt_templates`, `roles`,
+`webhook_endpoints`, `billing_plans`, `redirect_urls`, `org_settings_schema`,
+`notification_templates`, `email_templates`, `organization_policies`.
+
+Rules that make it safe and repeatable:
+
+- **Deterministic.** Keys are sorted, so re-exporting an unchanged instance is a
+  byte-for-byte no-op and a round-trip (`export` then `import`) is an empty diff.
+- **No secrets on disk.** The management API never returns a secret on a read,
+  so none is ever written. To (re)write a credential at import, put a
+  `${ENV_VAR}` placeholder in the file; it is resolved from the environment.
+- **Non-destructive.** `import` never deletes without `--prune`, and a resource
+  type with no file is left untouched (only committed types are managed).
+
+Ship it on push with the [`atlas-deploy` GitHub Action](../../actions/atlas-deploy).

package/dist/args.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The single option schema for the whole CLI. parseArgs in `strict` mode rejects
+ * an unknown flag for us (turned into a clean {@link CliError} below), so every
+ * flag any command accepts must appear here once. Per-command validation of
+ * which flags actually apply happens in the handler.
+ */
+declare const OPTIONS: {
+    readonly json: {
+        readonly type: "boolean";
+    };
+    readonly profile: {
+        readonly type: "string";
+    };
+    readonly limit: {
+        readonly type: "string";
+    };
+    readonly 'starting-after': {
+        readonly type: "string";
+    };
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+    };
+    readonly version: {
+        readonly type: "boolean";
+        readonly short: "v";
+    };
+    readonly url: {
+        readonly type: "string";
+    };
+    readonly 'secret-key': {
+        readonly type: "string";
+    };
+    readonly email: {
+        readonly type: "string";
+    };
+    readonly 'first-name': {
+        readonly type: "string";
+    };
+    readonly 'last-name': {
+        readonly type: "string";
+    };
+    readonly password: {
+        readonly type: "string";
+    };
+    readonly 'subject-type': {
+        readonly type: "string";
+    };
+    readonly 'subject-id': {
+        readonly type: "string";
+    };
+    readonly name: {
+        readonly type: "string";
+    };
+    readonly dir: {
+        readonly type: "string";
+    };
+    readonly format: {
+        readonly type: "string";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+    };
+    readonly prune: {
+        readonly type: "boolean";
+    };
+    readonly trigger: {
+        readonly type: "string";
+    };
+};
+export type Values = {
+    [K in keyof typeof OPTIONS]?: (typeof OPTIONS)[K]['type'] extends 'boolean' ? boolean : string;
+};
+export interface ParsedArgs {
+    positionals: string[];
+    values: Values;
+}
+/** Parse argv, turning parseArgs' own errors (unknown/invalid flag) into clean CliErrors. */
+export declare function parse(argv: string[]): ParsedArgs;
+/** A string flag's value, or undefined. */
+export declare function str(values: Values, key: keyof Values): string | undefined;
+/** `--limit` as a positive integer, or undefined. Rejects garbage with a clean error. */
+export declare function limit(values: Values): number | undefined;
+export {};

package/dist/args.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+exports.str = str;
+exports.limit = limit;
+const node_util_1 = require("node:util");
+const errors_1 = require("./errors");
+/**
+ * The single option schema for the whole CLI. parseArgs in `strict` mode rejects
+ * an unknown flag for us (turned into a clean {@link CliError} below), so every
+ * flag any command accepts must appear here once. Per-command validation of
+ * which flags actually apply happens in the handler.
+ */
+const OPTIONS = {
+    // Global.
+    json: { type: 'boolean' },
+    profile: { type: 'string' },
+    limit: { type: 'string' },
+    'starting-after': { type: 'string' },
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    // login (non-interactive overrides for the prompts).
+    url: { type: 'string' },
+    'secret-key': { type: 'string' },
+    // users create.
+    email: { type: 'string' },
+    'first-name': { type: 'string' },
+    'last-name': { type: 'string' },
+    password: { type: 'string' },
+    // api-keys.
+    'subject-type': { type: 'string' },
+    'subject-id': { type: 'string' },
+    name: { type: 'string' },
+    // config export / import.
+    dir: { type: 'string' },
+    format: { type: 'string' },
+    'dry-run': { type: 'boolean' },
+    prune: { type: 'boolean' },
+    // actions.
+    trigger: { type: 'string' },
+};
+/** Parse argv, turning parseArgs' own errors (unknown/invalid flag) into clean CliErrors. */
+function parse(argv) {
+    try {
+        const { values, positionals } = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: OPTIONS,
+            allowPositionals: true,
+            strict: true,
+        });
+        return { values: values, positionals };
+    }
+    catch (err) {
+        // parseArgs throws a TypeError with an ERR_PARSE_ARGS_* code; surface its
+        // message (e.g. "Unknown option '--frob'") without the stack.
+        const message = err instanceof Error ? err.message : String(err);
+        throw new errors_1.CliError(message);
+    }
+}
+/** A string flag's value, or undefined. */
+function str(values, key) {
+    const v = values[key];
+    return typeof v === 'string' ? v : undefined;
+}
+/** `--limit` as a positive integer, or undefined. Rejects garbage with a clean error. */
+function limit(values) {
+    const raw = str(values, 'limit');
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new errors_1.CliError(`--limit must be a positive integer, got '${raw}'.`);
+    }
+    return n;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const context_1 = require("./context");
+const run_1 = require("./run");
+/**
+ * The bin entry — the ONLY place that touches `process` for lifecycle. It wires
+ * the production context, runs, and exits with the returned code. `run` is
+ * designed to catch its own errors, so the `.catch` here is a last-resort guard
+ * against a genuine bug; even then it prints a line, never a raw stack.
+ */
+(0, run_1.run)(process.argv.slice(2), (0, context_1.defaultContext)())
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`atlas: unexpected error: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,uCAA2C;AAC3C,+BAA4B;AAE5B;;;;;GAKG;AACH,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAA,wBAAc,GAAE,CAAC;KACzC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/actions.d.ts

@@ -0,0 +1,11 @@
+import { type ParsedArgs } from '../args';
+import type { RunContext } from '../context';
+/**
+ * `atlas actions` — manage tenant Actions (code run in the auth pipeline).
+ *
+ *   list                        the instance's actions
+ *   deploy <file> --trigger <t> upload a file's code as a new action
+ *   test <file> [--trigger <t>] dry-run the file OFFLINE through @atlasauth/actions
+ *   logs <id>                   where to find an action's execution history
+ */
+export declare function actions(ctx: RunContext, args: ParsedArgs): Promise<number>;

package/dist/commands/actions.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actions = actions;
+const node_path_1 = require("node:path");
+const actions_1 = require("@atlasauth/actions");
+const args_1 = require("../args");
+const errors_1 = require("../errors");
+const output_1 = require("../output");
+const shared_1 = require("./shared");
+const COLUMNS = [
+    { header: 'ID', get: (a) => a.id },
+    { header: 'NAME', get: (a) => a.name },
+    { header: 'TRIGGER', get: (a) => a.trigger },
+    { header: 'ENABLED', get: (a) => a.enabled },
+    { header: 'SECRETS', get: (a) => a.secret_names },
+    { header: 'UPDATED', get: (a) => (0, output_1.fmtTime)(a.updated_at) },
+];
+/** Validate a `--trigger` value against the known set, with a clean error. */
+function parseTrigger(raw) {
+    if (!raw) {
+        throw new errors_1.CliError(`--trigger is required (one of: ${actions_1.ACTION_TRIGGERS.join(', ')}).`);
+    }
+    if (!actions_1.ACTION_TRIGGERS.includes(raw)) {
+        throw new errors_1.CliError(`Unknown trigger '${raw}'. Expected one of: ${actions_1.ACTION_TRIGGERS.join(', ')}.`);
+    }
+    return raw;
+}
+/**
+ * `atlas actions` — manage tenant Actions (code run in the auth pipeline).
+ *
+ *   list                        the instance's actions
+ *   deploy <file> --trigger <t> upload a file's code as a new action
+ *   test <file> [--trigger <t>] dry-run the file OFFLINE through @atlasauth/actions
+ *   logs <id>                   where to find an action's execution history
+ */
+async function actions(ctx, args) {
+    const sub = args.positionals[1];
+    const json = (0, shared_1.wantsJson)(args.values);
+    switch (sub) {
+        case 'list': {
+            const { client } = (0, shared_1.requireClient)(ctx, args.values);
+            const page = await client.actions.list();
+            if (json)
+                (0, output_1.printJson)(ctx.io, page);
+            else
+                ctx.io.out((0, output_1.renderTable)(COLUMNS, page.data));
+            return 0;
+        }
+        case 'deploy': {
+            const file = (0, shared_1.requireArg)(args.positionals, 2, 'file');
+            const trigger = parseTrigger((0, args_1.str)(args.values, 'trigger'));
+            const code = ctx.readFile(file);
+            if (!code.trim())
+                throw new errors_1.CliError(`'${file}' is empty — nothing to deploy.`);
+            const name = (0, args_1.str)(args.values, 'name') || (0, node_path_1.basename)(file).replace(/\.[^.]+$/, '');
+            const { client } = (0, shared_1.requireClient)(ctx, args.values);
+            const action = await client.actions.create({ name, trigger, code });
+            if (json)
+                (0, output_1.printJson)(ctx.io, action);
+            else {
+                ctx.io.out(`Deployed action ${action.id} (${action.name}) for ${action.trigger}.`);
+                ctx.io.err(`It is created but NOT yet bound to the ${action.trigger} flow — bind it to run it.`);
+            }
+            return 0;
+        }
+        case 'test': {
+            const file = (0, shared_1.requireArg)(args.positionals, 2, 'file');
+            // Default to post_login's sample event; --trigger picks another shape.
+            const trigger = (0, args_1.str)(args.values, 'trigger')
+                ? parseTrigger((0, args_1.str)(args.values, 'trigger'))
+                : 'post_login';
+            const code = ctx.readFile(file);
+            if (!code.trim())
+                throw new errors_1.CliError(`'${file}' is empty — nothing to test.`);
+            // OFFLINE: no network, no client — the local harness mirrors the isolate.
+            const result = await (0, actions_1.runScript)(code, (0, actions_1.createTestEvent)(trigger));
+            if (json) {
+                (0, output_1.printJson)(ctx.io, result);
+            }
+            else {
+                ctx.io.out(`Trigger:   ${trigger}`);
+                ctx.io.out(`Denied:    ${result.denied}${result.denyReason ? ` (${result.denyReason})` : ''}`);
+                ctx.io.out(`ID claims: ${JSON.stringify(result.idTokenClaims)}`);
+                ctx.io.out(`AT claims: ${JSON.stringify(result.accessTokenClaims)}`);
+                ctx.io.out(`Metadata:  ${JSON.stringify(result.appMetadata)}`);
+                if (result.logs.length)
+                    ctx.io.out(`Logs:\n  ${result.logs.join('\n  ')}`);
+                if (result.error)
+                    ctx.io.err(`Error:     ${result.error}`);
+            }
+            // A thrown error in the action is a failed dry-run → non-zero so CI catches it.
+            return result.error ? 1 : 0;
+        }
+        case 'logs': {
+            const id = (0, shared_1.requireArg)(args.positionals, 2, 'action-id');
+            // The Backend API does not expose a per-action execution-log endpoint:
+            // each run is written as an audit event (`action.<trigger>`) carrying the
+            // outcome, duration and captured logs. Point the user at where to read it
+            // rather than pretend an endpoint exists.
+            const lines = [
+                `Atlas does not expose a live log stream for action ${id}.`,
+                'Each execution is recorded as an audit event named `action.<trigger>`',
+                '(outcome, duration, deny reason / error, and the action\'s console logs).',
+                'Read them in the dashboard audit log, or stream them via a configured',
+                'log stream. To see what an action WOULD do right now, dry-run it:',
+                `  atlas actions test <file> --trigger <trigger>`,
+            ];
+            if (json)
+                (0, output_1.printJson)(ctx.io, { object: 'action_logs_info', action_id: id, message: lines.join(' ') });
+            else
+                ctx.io.out(lines.join('\n'));
+            return 0;
+        }
+        default:
+            throw new errors_1.CliError(sub
+                ? `Unknown subcommand 'actions ${sub}'. Try: list, deploy, test, logs.`
+                : 'actions needs a subcommand: list, deploy, test, logs.');
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/commands/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":";;AAqCA,0BAoFC;AAzHD,yCAAqC;AAErC,gDAAiF;AACjF,kCAA+C;AAE/C,sCAAqC;AACrC,sCAAyE;AACzE,qCAAgE;AAEhE,MAAM,OAAO,GAAqB;IAChC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;IAClC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;IACtC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;IAC5C,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;IAC5C,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE;IACjD,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,gBAAO,EAAC,CAAC,CAAC,UAAU,CAAC,EAAE;CACzD,CAAC;AAEF,8EAA8E;AAC9E,SAAS,YAAY,CAAC,GAAuB;IAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,iBAAQ,CAAC,kCAAkC,yBAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,yBAAe,CAAC,QAAQ,CAAC,GAAoB,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,iBAAQ,CAAC,oBAAoB,GAAG,uBAAuB,yBAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,GAAoB,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,IAAgB;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAA,kBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,sBAAa,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,IAAI;gBAAE,IAAA,kBAAS,EAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;;gBAC7B,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,oBAAW,EAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAA,UAAG,EAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,MAAM,IAAI,iBAAQ,CAAC,IAAI,IAAI,iCAAiC,CAAC,CAAC;YAChF,MAAM,IAAI,GAAG,IAAA,UAAG,EAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAEhF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,sBAAa,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,IAAI;gBAAE,IAAA,kBAAS,EAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;iBAC/B,CAAC;gBACJ,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;gBACnF,GAAG,CAAC,EAAE,CAAC,GAAG,CACR,0CAA0C,MAAM,CAAC,OAAO,4BAA4B,CACrF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACrD,uEAAuE;YACvE,MAAM,OAAO,GAAG,IAAA,UAAG,EAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;gBACzC,CAAC,CAAC,YAAY,CAAC,IAAA,UAAG,EAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC3C,CAAC,CAAC,YAAY,CAAC;YACjB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,MAAM,IAAI,iBAAQ,CAAC,IAAI,IAAI,+BAA+B,CAAC,CAAC;YAE9E,0EAA0E;YAC1E,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAS,EAAC,IAAI,EAAE,IAAA,yBAAe,EAAC,OAAO,CAAC,CAAC,CAAC;YAC/D,IAAI,IAAI,EAAE,CAAC;gBACT,IAAA,kBAAS,EAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;gBACpC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/F,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;gBACjE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;gBACrE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;oBAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC3E,IAAI,MAAM,CAAC,KAAK;oBAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,gFAAgF;YAChF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;YACxD,uEAAuE;YACvE,0EAA0E;YAC1E,0EAA0E;YAC1E,0CAA0C;YAC1C,MAAM,KAAK,GAAG;gBACZ,sDAAsD,EAAE,GAAG;gBAC3D,uEAAuE;gBACvE,2EAA2E;gBAC3E,uEAAuE;gBACvE,mEAAmE;gBACnE,iDAAiD;aAClD,CAAC;YACF,IAAI,IAAI;gBAAE,IAAA,kBAAS,EAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;;gBAChG,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC;QACX,CAAC;QAED;YACE,MAAM,IAAI,iBAAQ,CAChB,GAAG;gBACD,CAAC,CAAC,+BAA+B,GAAG,mCAAmC;gBACvE,CAAC,CAAC,uDAAuD,CAC5D,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/commands/api-keys.d.ts

@@ -0,0 +1,4 @@
+import { type ParsedArgs } from '../args';
+import type { RunContext } from '../context';
+/** `atlas api-keys <list|create|revoke>` — maps onto `client.apiKeys.*`. */
+export declare function apiKeys(ctx: RunContext, args: ParsedArgs): Promise<number>;

package/dist/commands/api-keys.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiKeys = apiKeys;
+const args_1 = require("../args");
+const errors_1 = require("../errors");
+const output_1 = require("../output");
+const shared_1 = require("./shared");
+const COLUMNS = [
+    { header: 'ID', get: (k) => k.id },
+    { header: 'SUBJECT_TYPE', get: (k) => k.subject_type },
+    { header: 'SUBJECT_ID', get: (k) => k.subject_id },
+    { header: 'NAME', get: (k) => k.name },
+    { header: 'PREFIX', get: (k) => k.prefix },
+    { header: 'CREATED', get: (k) => (0, output_1.fmtTime)(k.created_at) },
+];
+const SUBJECT_TYPES = ['user', 'organization'];
+function parseSubjectType(value, flag) {
+    if (!value)
+        throw new errors_1.CliError(`api-keys create requires ${flag} <user|organization>.`);
+    if (!SUBJECT_TYPES.includes(value)) {
+        throw new errors_1.CliError(`${flag} must be one of: ${SUBJECT_TYPES.join(', ')} (got '${value}').`);
+    }
+    return value;
+}
+/** `atlas api-keys <list|create|revoke>` — maps onto `client.apiKeys.*`. */
+async function apiKeys(ctx, args) {
+    const sub = args.positionals[1];
+    const json = (0, shared_1.wantsJson)(args.values);
+    switch (sub) {
+        case 'list': {
+            const { client } = (0, shared_1.requireClient)(ctx, args.values);
+            // Optional narrowing to one subject; the route itself is not cursor-paged.
+            const subjectType = (0, args_1.str)(args.values, 'subject-type');
+            const page = await client.apiKeys.list({
+                subject_type: subjectType ? parseSubjectType(subjectType, '--subject-type') : undefined,
+                subject_id: (0, args_1.str)(args.values, 'subject-id'),
+            });
+            if (json)
+                (0, output_1.printJson)(ctx.io, page);
+            else
+                ctx.io.out((0, output_1.renderTable)(COLUMNS, page.data));
+            return 0;
+        }
+        case 'create': {
+            const subjectType = parseSubjectType((0, args_1.str)(args.values, 'subject-type'), '--subject-type');
+            const subjectId = (0, args_1.str)(args.values, 'subject-id');
+            if (!subjectId)
+                throw new errors_1.CliError('api-keys create requires --subject-id <id>.');
+            const { client } = (0, shared_1.requireClient)(ctx, args.values);
+            const key = await client.apiKeys.create({
+                subject_type: subjectType,
+                subject_id: subjectId,
+                name: (0, args_1.str)(args.values, 'name'),
+            });
+            if (json) {
+                (0, output_1.printJson)(ctx.io, key);
+            }
+            else {
+                // The secret is revealed exactly once — make that unmissable.
+                ctx.io.out(`Created API key ${key.id}.`);
+                ctx.io.out(`Secret (shown once): ${key.secret}`);
+            }
+            return 0;
+        }
+        case 'revoke': {
+            const id = (0, shared_1.requireArg)(args.positionals, 2, 'api-key-id');
+            const { client } = (0, shared_1.requireClient)(ctx, args.values);
+            const result = await client.apiKeys.delete(id);
+            if (json)
+                (0, output_1.printJson)(ctx.io, result);
+            else
+                ctx.io.out(`Revoked API key ${result.id}.`);
+            return 0;
+        }
+        default:
+            throw new errors_1.CliError(sub
+                ? `Unknown subcommand 'api-keys ${sub}'. Try: list, create, revoke.`
+                : 'api-keys needs a subcommand: list, create, revoke.');
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/commands/api-keys.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,25 @@
+import { type ParsedArgs } from '../args';
+import type { RunContext } from '../context';
+/**
+ * `atlas login` — prompt for an API URL + a secret key, PROVE the key works
+ * with one cheap Backend call, then store it under a named profile (0600).
+ *
+ * Validating before saving is the point: a login that silently stored a typo'd
+ * key would surface only later as a baffling 401 on an unrelated command. We
+ * spend one `users.list({ limit: 1 })` round-trip here so every later command
+ * can trust the stored credential. `--url` / `--secret-key` skip the prompts
+ * for non-interactive setup (CI), mirroring the `ATLAS_*` env overrides.
+ */
+export declare function login(ctx: RunContext, args: ParsedArgs): Promise<number>;
+/**
+ * `atlas logout` — forget one profile's stored credential. If it was the active
+ * profile, the active pointer falls back to any remaining profile so the CLI
+ * isn't left pointing at nothing.
+ */
+export declare function logout(ctx: RunContext, args: ParsedArgs): Promise<number>;
+/**
+ * `atlas whoami` — report the active profile and instance without any network
+ * call. The secret is always masked; the per-field source tells a user whether
+ * an `ATLAS_*` env var is shadowing the stored profile.
+ */
+export declare function whoami(ctx: RunContext, args: ParsedArgs): Promise<number>;

package/dist/commands/auth.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = login;
+exports.logout = logout;
+exports.whoami = whoami;
+const backend_1 = require("@atlasauth/backend");
+const args_1 = require("../args");
+const errors_1 = require("../errors");
+const output_1 = require("../output");
+const shared_1 = require("./shared");
+/**
+ * `atlas login` — prompt for an API URL + a secret key, PROVE the key works
+ * with one cheap Backend call, then store it under a named profile (0600).
+ *
+ * Validating before saving is the point: a login that silently stored a typo'd
+ * key would surface only later as a baffling 401 on an unrelated command. We
+ * spend one `users.list({ limit: 1 })` round-trip here so every later command
+ * can trust the stored credential. `--url` / `--secret-key` skip the prompts
+ * for non-interactive setup (CI), mirroring the `ATLAS_*` env overrides.
+ */
+async function login(ctx, args) {
+    const { values } = args;
+    const profile = (0, args_1.str)(values, 'profile') || 'default';
+    const apiUrl = (0, args_1.str)(values, 'url') ||
+        (await ctx.prompt.text('Atlas API URL', { default: backend_1.DEFAULT_API_URL })) ||
+        backend_1.DEFAULT_API_URL;
+    const secretKey = (0, args_1.str)(values, 'secret-key') || (await ctx.prompt.secret('Atlas secret key (sk_...)'));
+    if (!secretKey)
+        throw new errors_1.CliError('A secret key is required to log in.');
+    // Prove the credential before persisting it.
+    const client = ctx.makeClient({ secretKey, apiUrl });
+    try {
+        await client.users.list({ limit: 1 });
+    }
+    catch (err) {
+        if (err instanceof backend_1.AtlasApiError) {
+            throw new errors_1.CliError(`Secret key rejected by ${apiUrl} (HTTP ${err.status}${err.code ? `, ${err.code}` : ''}). Nothing was saved.`);
+        }
+        // A network/DNS failure, not a bad key — say so distinctly.
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new errors_1.CliError(`Could not reach ${apiUrl}: ${detail}. Nothing was saved.`);
+    }
+    const file = ctx.config.load();
+    file.profiles[profile] = { api_url: apiUrl, secret_key: secretKey };
+    file.active_profile = profile;
+    ctx.config.save(file);
+    ctx.io.out(`Logged in to ${apiUrl} as profile '${profile}'.`);
+    ctx.io.out(`Credential stored at ${ctx.config.path} (mode 0600).`);
+    return 0;
+}
+/**
+ * `atlas logout` — forget one profile's stored credential. If it was the active
+ * profile, the active pointer falls back to any remaining profile so the CLI
+ * isn't left pointing at nothing.
+ */
+async function logout(ctx, args) {
+    const { values } = args;
+    const file = ctx.config.load();
+    const profile = (0, args_1.str)(values, 'profile') || file.active_profile || 'default';
+    if (!file.profiles[profile]) {
+        ctx.io.out(`No stored credential for profile '${profile}'.`);
+        return 0;
+    }
+    delete file.profiles[profile];
+    if (file.active_profile === profile) {
+        file.active_profile = Object.keys(file.profiles)[0];
+    }
+    ctx.config.save(file);
+    ctx.io.out(`Logged out of profile '${profile}'.`);
+    return 0;
+}
+/**
+ * `atlas whoami` — report the active profile and instance without any network
+ * call. The secret is always masked; the per-field source tells a user whether
+ * an `ATLAS_*` env var is shadowing the stored profile.
+ */
+async function whoami(ctx, args) {
+    const auth = (0, shared_1.resolveAuth)(ctx, args.values);
+    if ((0, shared_1.wantsJson)(args.values)) {
+        (0, output_1.printJson)(ctx.io, {
+            profile: auth.profile,
+            api_url: auth.apiUrl,
+            secret_key: (0, shared_1.maskSecret)(auth.secretKey),
+            key_source: auth.keySource,
+            url_source: auth.urlSource,
+        });
+        return 0;
+    }
+    ctx.io.out(`Profile:    ${auth.profile}`);
+    ctx.io.out(`API URL:    ${auth.apiUrl} (${auth.urlSource})`);
+    ctx.io.out(`Secret key: ${(0, shared_1.maskSecret)(auth.secretKey)} (${auth.keySource})`);
+    return 0;
+}
+//# sourceMappingURL=auth.js.map