@bussolabs/closeyourit-cli 0.0.2

package/README.md

@@ -0,0 +1,99 @@
+# closeyourit-cli
+
+`closeyourit` (alias `cyi`) is the command-line interface for [CloseYourIt](https://www.closeyour.it).
+Authenticate with your user token and manage projects, error monitoring, ingest tokens, tickets and
+performance metrics straight from your terminal — handy for CI pipelines and SDK setup.
+
+## Install
+
+```bash
+npm install -g @bussolabs/closeyourit-cli
+# or run without installing
+npx @bussolabs/closeyourit-cli --help
+```
+
+## Getting started
+
+```bash
+closeyourit login        # device flow: opens your browser, enter the shown code
+closeyourit whoami       # confirm who you are and which org/token is active
+closeyourit projects list
+```
+
+`login` uses the OAuth 2.0 device authorization grant: it prints a short user code and a verification
+URL (and opens it in your browser), then polls until you approve. The resulting token, account and
+organization are stored locally.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `login [--api-url <url>]` | Authenticate via device flow, store the token. |
+| `logout` | Clear the locally stored token and identity. |
+| `whoami` | Show account, organization, token prefix and permissions. |
+| `projects list [--page]` | List visible projects. |
+| `projects show <id\|key>` | Show one project. |
+| `projects create <name> [--group <id\|name>] [--key] [--color] [--description]` | Create a project (key derived from the name if omitted). |
+| `groups list [--page]` | List groups (macro-projects) in your org. |
+| `groups create <name> [--color]` | Create a group (container of related projects, e.g. "DriverOne"). |
+| `roles list\|show <id\|name>` | List roles / show a role with its permission keys. |
+| `roles create <name> [--permission <key>…] [--color]` | Create an RBAC role (bundle of permission keys). |
+| `roles update <id\|name> [--name] [--permission <key>…] [--color]` | Update a role (permissions REPLACE the set). |
+| `roles delete <id\|name>` | Delete a role. |
+| `teams list\|show <id\|name>` | List teams / show a team (roles, scope, members). |
+| `teams create <name> [--role <id\|name>…] [--group <id\|name>…] [--project <id\|key>…] [--member <email\|id>…] [--color]` | Create a team with roles + group/project scope + members. |
+| `teams update <id\|name> [--name] [--role…] [--group…] [--project…] [--member…]` | Update a team (each dimension REPLACES its set). |
+| `teams add-member\|remove-member <team> <email\|id>` | Add/remove one person, keeping the others. |
+| `teams delete <id\|name>` | Delete a team. |
+| `members list [--page]` | List org members (resolve email → account id). |
+| `invitations create <email> [--role customer\|member\|admin]` | Invite a person; prints the acceptance link (once). |
+| `invitations list [--page]` | List invitations. |
+| `invitations revoke <id>` | Revoke a pending invitation. |
+| `errors list --project <id\|key> [--status] [--page]` | List error groups. |
+| `errors show <id> --project <id\|key>` | Show one error group. |
+| `errors resolve\|reopen\|mute\|unmute <id> --project <id\|key>` | Triage an error group. |
+| `tokens list --project <id\|key>` | List ingest tokens. |
+| `tokens create --project <id\|key> --name <name> --environment-id <id>` | Create a token (secret shown once). |
+| `tokens rotate <id> --project <id\|key>` | Rotate a token (new secret shown once). |
+| `tokens revoke <id> --project <id\|key>` | Revoke a token. |
+| `tickets list --project <id\|key> [--page]` | List tickets. |
+| `tickets show <id> --project <id\|key>` | Show one ticket. |
+| `tickets create --project <id\|key> --title <t> [--kind] [--step-*] [--description] [--status-id] [--priority-id]` | Create a ticket. |
+| `metrics list --project <id\|key> [--kind] [--page]` | List metric groups. |
+| `metrics show <id> --project <id\|key>` | Show one metric group. |
+
+Every command accepts `--json` for machine-readable output and `--help` for usage details.
+`--project` accepts either a project UUID or its key (matched case-insensitively).
+
+## Configuration
+
+The CLI stores its state in:
+
+```
+~/.config/closeyourit/config.json   (mode 0600)
+```
+
+It holds the backend URL, your token and a cached copy of your account/organization. Use `logout`
+to clear it locally; revoke the token on the server at `/account/cli/tokens`.
+
+## Environment variables
+
+| Variable | Purpose | Default |
+| --- | --- | --- |
+| `CLOSEYOURIT_API_URL` | Default backend base URL (overridden by a persisted `--api-url`). | `https://www.closeyour.it` |
+| `CLOSEYOURIT_CONFIG_DIR` | Directory holding `config.json`. | `~/.config/closeyourit` |
+
+## Development
+
+Toolchain is pinned with [mise](https://mise.jdx.dev) (`mise.toml`): Node 24 + pnpm.
+
+```bash
+mise install
+mise exec -- pnpm install
+mise exec -- pnpm build      # tsc -> dist/
+mise exec -- pnpm test       # vitest (fetch mocked)
+./bin/run.js --help          # run the built CLI
+```
+
+The machine-readable command surface lives in [`opencli.json`](./opencli.json)
+([OpenCLI](https://opencli.org)).

package/bin/run.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('@oclif/core').execute({dir: __dirname})

package/dist/base.d.ts

@@ -0,0 +1,34 @@
+import { Command, type Interfaces } from '@oclif/core';
+import { type CliConfig } from './lib/config';
+import { CliApi } from './lib/api';
+export declare const UUID_RE: RegExp;
+/** Shared `--project <id|key>` flag (required). */
+export declare const projectFlag: {
+    project: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+};
+/** Shared `--page` flag. */
+export declare const pageFlag: {
+    page: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
+};
+export declare abstract class BaseCommand extends Command {
+    static enableJsonFlag: boolean;
+    protected cfg: CliConfig;
+    protected api: CliApi;
+    init(): Promise<void>;
+    /** Resolve a project reference (UUID passes through; otherwise matched by key). */
+    protected resolveProjectId(value: string): Promise<string>;
+    /** Resolve a role reference (UUID passes through; otherwise matched by name, case-insensitive). */
+    protected resolveRoleId(value: string): Promise<string>;
+    /** Resolve a group reference (UUID passes through; otherwise matched by name). */
+    protected resolveGroupId(value: string): Promise<string>;
+    /** Resolve a team reference (UUID passes through; otherwise matched by name). */
+    protected resolveTeamId(value: string): Promise<string>;
+    /** Resolve a member reference (UUID account id passes through; otherwise matched by email). */
+    protected resolveMemberId(value: string): Promise<string>;
+    /** Resolve each value of a list to an id, preserving order. */
+    protected resolveAll(values: string[], resolve: (value: string) => Promise<string>): Promise<string[]>;
+    /** Resolve an `{id, name}` reference by name (UUID passes through). */
+    private resolveByName;
+    /** Print `code: message` for API errors, then exit non-zero. */
+    protected catch(error: Interfaces.CommandError): Promise<unknown>;
+}

package/dist/base.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCommand = exports.pageFlag = exports.projectFlag = exports.UUID_RE = void 0;
+const core_1 = require("@oclif/core");
+const config_1 = require("./lib/config");
+const api_1 = require("./lib/api");
+const error_codes_1 = require("./errors/error-codes");
+exports.UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Shared `--project <id|key>` flag (required). */
+exports.projectFlag = {
+    project: core_1.Flags.string({ char: 'p', description: 'Project id (UUID) or key', required: true }),
+};
+/** Shared `--page` flag. */
+exports.pageFlag = {
+    page: core_1.Flags.integer({ description: 'Page number', default: 1 }),
+};
+class BaseCommand extends core_1.Command {
+    static enableJsonFlag = true;
+    cfg;
+    api;
+    async init() {
+        await super.init();
+        this.cfg = (0, config_1.loadConfig)();
+        this.api = new api_1.CliApi(this.cfg);
+    }
+    /** Resolve a project reference (UUID passes through; otherwise matched by key). */
+    async resolveProjectId(value) {
+        if (exports.UUID_RE.test(value))
+            return value;
+        const res = await this.api.get('/cli/v1/projects');
+        const projects = res.data ?? [];
+        const match = projects.find((project) => (project.key ?? '').toLowerCase() === value.toLowerCase());
+        if (!match) {
+            throw new api_1.ApiRequestError(404, error_codes_1.ErrorCodes.Project.notFound, `Project not found: ${value}`);
+        }
+        return match.id;
+    }
+    /** Resolve a role reference (UUID passes through; otherwise matched by name, case-insensitive). */
+    resolveRoleId(value) {
+        return this.resolveByName('/cli/v1/roles', value, error_codes_1.ErrorCodes.Role.notFound, 'Role');
+    }
+    /** Resolve a group reference (UUID passes through; otherwise matched by name). */
+    resolveGroupId(value) {
+        return this.resolveByName('/cli/v1/groups', value, error_codes_1.ErrorCodes.Group.notFound, 'Group');
+    }
+    /** Resolve a team reference (UUID passes through; otherwise matched by name). */
+    resolveTeamId(value) {
+        return this.resolveByName('/cli/v1/teams', value, error_codes_1.ErrorCodes.Team.notFound, 'Team');
+    }
+    /** Resolve a member reference (UUID account id passes through; otherwise matched by email). */
+    async resolveMemberId(value) {
+        if (exports.UUID_RE.test(value))
+            return value;
+        const res = await this.api.get('/cli/v1/members');
+        const match = (res.data ?? []).find((m) => (m.email ?? '').toLowerCase() === value.toLowerCase());
+        if (!match) {
+            throw new api_1.ApiRequestError(404, error_codes_1.ErrorCodes.Member.notFound, `Member not found: ${value}`);
+        }
+        return match.account_id;
+    }
+    /** Resolve each value of a list to an id, preserving order. */
+    resolveAll(values, resolve) {
+        return Promise.all(values.map((value) => resolve(value)));
+    }
+    /** Resolve an `{id, name}` reference by name (UUID passes through). */
+    async resolveByName(path, value, code, label) {
+        if (exports.UUID_RE.test(value))
+            return value;
+        const res = await this.api.get(path);
+        const match = (res.data ?? []).find((row) => (row.name ?? '').toLowerCase() === value.toLowerCase());
+        if (!match) {
+            throw new api_1.ApiRequestError(404, code, `${label} not found: ${value}`);
+        }
+        return match.id;
+    }
+    /** Print `code: message` for API errors, then exit non-zero. */
+    async catch(error) {
+        if (error instanceof api_1.ApiRequestError) {
+            this.logToStderr(`${error.code}: ${error.message}`);
+            return this.exit(1);
+        }
+        return super.catch(error);
+    }
+}
+exports.BaseCommand = BaseCommand;

package/dist/commands/errors/list.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/list.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class ErrorsList extends base_1.BaseCommand {
+    static description = 'List error groups for a project';
+    static examples = [
+        '<%= config.bin %> errors list --project acme-api',
+        '<%= config.bin %> errors list -p acme-api --status unresolved --json',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        ...base_1.pageFlag,
+        status: core_1.Flags.string({ description: 'Filter by status (e.g. unresolved, resolved, muted)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ErrorsList);
+        const projectId = await this.resolveProjectId(flags.project);
+        const query = new URLSearchParams({ page: String(flags.page) });
+        if (flags.status)
+            query.set('status', flags.status);
+        const res = await this.api.get(`/cli/v1/projects/${projectId}/error_groups?${query.toString()}`);
+        const groups = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['ID', 'TITLE', 'STATUS', 'EVENTS'], groups.map((group) => [
+                String(group.id ?? ''),
+                String(group.title ?? ''),
+                String(group.status ?? ''),
+                String(group.events_count ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = ErrorsList;

package/dist/commands/errors/mute.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsMute extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/mute.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class ErrorsMute extends base_1.BaseCommand {
+    static description = 'Mute an error group';
+    static examples = ['<%= config.bin %> errors mute <group-id> --project acme-api'];
+    static args = {
+        id: core_1.Args.string({ description: 'Error group id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(ErrorsMute);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/error_groups/${args.id}/mute`);
+        if (!this.jsonEnabled()) {
+            this.log(`Error group ${args.id} muted.`);
+        }
+        return res;
+    }
+}
+exports.default = ErrorsMute;

package/dist/commands/errors/reopen.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsReopen extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/reopen.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class ErrorsReopen extends base_1.BaseCommand {
+    static description = 'Reopen a resolved error group';
+    static examples = ['<%= config.bin %> errors reopen <group-id> --project acme-api'];
+    static args = {
+        id: core_1.Args.string({ description: 'Error group id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(ErrorsReopen);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.delete(`/cli/v1/projects/${projectId}/error_groups/${args.id}/resolution`);
+        if (!this.jsonEnabled()) {
+            this.log(`Error group ${args.id} reopened.`);
+        }
+        return res;
+    }
+}
+exports.default = ErrorsReopen;

package/dist/commands/errors/resolve.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsResolve extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/resolve.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class ErrorsResolve extends base_1.BaseCommand {
+    static description = 'Mark an error group as resolved';
+    static examples = ['<%= config.bin %> errors resolve <group-id> --project acme-api'];
+    static args = {
+        id: core_1.Args.string({ description: 'Error group id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(ErrorsResolve);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/error_groups/${args.id}/resolution`);
+        if (!this.jsonEnabled()) {
+            this.log(`Error group ${args.id} marked as resolved.`);
+        }
+        return res;
+    }
+}
+exports.default = ErrorsResolve;

package/dist/commands/errors/show.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/show.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class ErrorsShow extends base_1.BaseCommand {
+    static description = 'Show a single error group';
+    static examples = ['<%= config.bin %> errors show <group-id> --project acme-api'];
+    static args = {
+        id: core_1.Args.string({ description: 'Error group id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(ErrorsShow);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.get(`/cli/v1/projects/${projectId}/error_groups/${args.id}`);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = ErrorsShow;

package/dist/commands/errors/unmute.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class ErrorsUnmute extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/errors/unmute.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class ErrorsUnmute extends base_1.BaseCommand {
+    static description = 'Unmute an error group';
+    static examples = ['<%= config.bin %> errors unmute <group-id> --project acme-api'];
+    static args = {
+        id: core_1.Args.string({ description: 'Error group id', required: true }),
+    };
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(ErrorsUnmute);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.delete(`/cli/v1/projects/${projectId}/error_groups/${args.id}/mute`);
+        if (!this.jsonEnabled()) {
+            this.log(`Error group ${args.id} unmuted.`);
+        }
+        return res;
+    }
+}
+exports.default = ErrorsUnmute;

package/dist/commands/groups/create.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class GroupsCreate extends BaseCommand {
+    static args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        color: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/groups/create.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class GroupsCreate extends base_1.BaseCommand {
+    static args = {
+        name: core_1.Args.string({ description: 'Group name', required: true }),
+    };
+    static description = 'Create a group (a container of related projects, e.g. "DriverOne")';
+    static examples = [
+        '<%= config.bin %> groups create DriverOne',
+        '<%= config.bin %> groups create DriverOne --color indigo',
+    ];
+    static flags = {
+        color: core_1.Flags.string({ description: 'Color label' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(GroupsCreate);
+        const body = { name: args.name };
+        if (flags.color !== undefined)
+            body.color = flags.color;
+        const res = await this.api.post('/cli/v1/groups', body);
+        if (!this.jsonEnabled()) {
+            this.log('Group created:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = GroupsCreate;

package/dist/commands/groups/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class GroupsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/groups/list.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class GroupsList extends base_1.BaseCommand {
+    static description = 'List the groups (macro-projects) in your organization';
+    static examples = ['<%= config.bin %> groups list', '<%= config.bin %> groups list --page 2 --json'];
+    static flags = { ...base_1.pageFlag };
+    async run() {
+        const { flags } = await this.parse(GroupsList);
+        const res = await this.api.get(`/cli/v1/groups?page=${flags.page}`);
+        const groups = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['NAME', 'COLOR', 'ID'], groups.map((group) => [String(group.name ?? ''), String(group.color ?? ''), String(group.id ?? '')])));
+        }
+        return res;
+    }
+}
+exports.default = GroupsList;

package/dist/commands/invitations/create.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class InvitationsCreate extends BaseCommand {
+    static args: {
+        email: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        role: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/invitations/create.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class InvitationsCreate extends base_1.BaseCommand {
+    static args = {
+        email: core_1.Args.string({ description: 'Email address to invite', required: true }),
+    };
+    static description = 'Invite a person to the organization. Prints the acceptance link (shown only once).';
+    static examples = [
+        '<%= config.bin %> invitations create client@acme.com',
+        '<%= config.bin %> invitations create teammate@acme.com --role member',
+    ];
+    static flags = {
+        role: core_1.Flags.string({
+            default: 'customer',
+            description: 'Membership role',
+            options: ['customer', 'member', 'admin'],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(InvitationsCreate);
+        const res = await this.api.post('/cli/v1/invitations', {
+            email: args.email,
+            role: flags.role,
+        });
+        const invitation = res.data ?? {};
+        if (!this.jsonEnabled()) {
+            this.log(`Invitation created for ${invitation.email ?? args.email} (role: ${invitation.role ?? flags.role}).`);
+            this.log('');
+            this.log(`  accept link: ${invitation.accept_url ?? '-'}`);
+            this.log('');
+            this.warn('Email delivery is not wired in production — send this link to the invitee manually.');
+        }
+        return res;
+    }
+}
+exports.default = InvitationsCreate;

package/dist/commands/invitations/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class InvitationsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/invitations/list.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class InvitationsList extends base_1.BaseCommand {
+    static description = 'List the pending/accepted invitations of your organization';
+    static examples = ['<%= config.bin %> invitations list', '<%= config.bin %> invitations list --json'];
+    static flags = { ...base_1.pageFlag };
+    async run() {
+        const { flags } = await this.parse(InvitationsList);
+        const res = await this.api.get(`/cli/v1/invitations?page=${flags.page}`);
+        const invitations = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['EMAIL', 'ROLE', 'ACCEPTED', 'ID'], invitations.map((invitation) => [
+                String(invitation.email ?? ''),
+                String(invitation.role ?? ''),
+                invitation.accepted_at ? 'yes' : 'no',
+                String(invitation.id ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = InvitationsList;

package/dist/commands/invitations/revoke.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class InvitationsRevoke extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<unknown>;
+}