@norbix.ai/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UAB Isidos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# Norbix CLI
+
+Manage your Norbix projects from the terminal. Built on top of the official
+[`@norbix.ai/ts`](https://www.npmjs.com/package/@norbix.ai/ts) SDK, so every
+command talks to the same API the SDK does.
+
+Works on **macOS**, **Linux** and **Windows** (Node.js 18+).
+
+## Install
+
+```sh
+npm install -g @norbix.ai/cli
+
+# or run without installing:
+npx @norbix.ai/cli --help
+```
+
+## Quick start
+
+```sh
+# 1. Log in (stores a token in your user config folder)
+norbix login
+# or with an API key:
+norbix login --api-key nbk_... --project <projectId>
+
+# 2. Check everything is wired up
+norbix whoami
+
+# 3. Use it
+norbix db find orders --filter '{"status":"paid"}' --page-size 20
+norbix logs list --level Error
+norbix scheduler list
+```
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `norbix login` / `logout` / `whoami` | Authenticate and inspect the current context |
+| `norbix config list/get/set/unset` | Manage the local config file |
+| `norbix db find/get/count/insert/update/delete/aggregate` | Work with database collections |
+| `norbix files list/info/upload/download/sign/delete` | Upload, download and manage files |
+| `norbix users list/get/invite/block/unblock/delete` | Manage project users (membership) |
+| `norbix env list/use/delete` | Manage project environments |
+| `norbix logs list/trail` | Read project logs, follow one correlation ID |
+| `norbix scheduler list/get/enable/disable/delete` | Manage scheduler tasks |
+| `norbix apikeys list/regenerate` | Show or regenerate project API keys |
+| `norbix webhooks show/secret/enable/disable/remove` | Inspect the webhook integration |
+| `norbix email templates/template/clone/archive/unarchive/delete/campaigns/campaign/stop` | Email templates and campaigns |
+| `norbix push ...` / `norbix sms ...` | Push and SMS — same commands as email |
+| `norbix account profile/status/usage/projects/team/regions/billing-portal` | Account-level info |
+| `norbix payments integrations/triggers/trigger/enable/disable` | Payment integrations and triggers |
+| `norbix integrations <module>` | List integrations of any module |
+| `norbix module enable/disable <name>` | Turn a whole project module on or off |
+| `norbix api <path>` | Call ANY endpoint directly (like `gh api`) — full API coverage |
+| `norbix autocomplete` | Set up shell tab-completion (bash/zsh) |
+
+Run `norbix <topic> --help` for flags and examples.
+
+## Configuration
+
+Every setting is resolved in this order (most specific wins):
+
+1. **Flag** — `--project`, `--env`, `--region`, `--api-key`
+2. **Environment variable** — `NORBIX_PROJECT_ID`, `NORBIX_ENV`, `NORBIX_REGION`,
+   `NORBIX_API_KEY`, `NORBIX_API_URL`, `NORBIX_HUB_URL`
+3. **Config file** — written by `norbix login` and `norbix config set`
+
+The config file lives in your user config folder (`~/.config/norbix/config.json`
+on macOS/Linux, `%LOCALAPPDATA%\norbix\config.json` on Windows) and is created
+with owner-only permissions (0600).
+
+For CI/CD, skip `login` and use environment variables only:
+
+```sh
+export NORBIX_API_KEY=nbk_...
+export NORBIX_PROJECT_ID=...
+norbix db count orders
+```
+
+## JSON output
+
+Every command supports `--json` and prints clean JSON on stdout, so you can
+pipe into `jq`:
+
+```sh
+norbix db find orders --json | jq '.list.items[] | ._id'
+```
+
+## Development
+
+```sh
+npm install
+npm run build          # compile TypeScript to dist/
+./bin/run.js --help    # run the local build
+```
+
+Commands live in `src/commands/<topic>/<name>.ts` — one file per command
+(oclif convention). Shared logic (auth resolution, config store, output) is in
+`src/base.ts` and `src/lib/`.
+
+## Files: pick your integration once
+
+File commands need a files integration ID. Set it once:
+
+```sh
+norbix config set filesIntegrationId <id>
+norbix files upload ./invoice.pdf invoices/2026/invoice.pdf
+norbix files download invoices/2026/invoice.pdf
+```
+
+Or pass `--integration <id>` (env var: `NORBIX_FILES_INTEGRATION_ID`).
+
+## Roadmap
+
+- Standalone binaries (no Node needed): Homebrew, curl installer, Scoop/winget
+- Device-code login (no password typed into the terminal)
+- OS keychain storage for tokens
+- `norbix logs list --follow` (live tail via SSE)
+
+See `RESEARCH.md` for the full background on these choices.

package/bin/run.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/base.js

@@ -0,0 +1,100 @@
+import { Norbix, NorbixError } from '@norbix.ai/ts';
+import { Command, Flags } from '@oclif/core';
+import { readStore } from './lib/store.js';
+/**
+ * Base class for every Norbix CLI command.
+ *
+ * Resolution order for every setting (most specific wins):
+ *   1. command-line flag        (--project, --env, --region, --api-key)
+ *   2. environment variable     (NORBIX_PROJECT_ID, NORBIX_ENV, ...)
+ *   3. local config file        (written by `norbix login` / `norbix config set`)
+ *
+ * Flags declare `env:` so oclif applies (1) and (2); (3) happens here.
+ */
+export class BaseCommand extends Command {
+    static enableJsonFlag = true;
+    static baseFlags = {
+        project: Flags.string({
+            description: 'Project ID',
+            env: 'NORBIX_PROJECT_ID',
+            helpGroup: 'GLOBAL',
+        }),
+        env: Flags.string({
+            description: 'Project environment (e.g. PROD, TEST)',
+            env: 'NORBIX_ENV',
+            helpGroup: 'GLOBAL',
+        }),
+        region: Flags.string({
+            description: 'Region code (e.g. nb-eu-germany)',
+            env: 'NORBIX_REGION',
+            helpGroup: 'GLOBAL',
+        }),
+        'api-key': Flags.string({
+            description: 'API key (overrides a stored login token)',
+            env: 'NORBIX_API_KEY',
+            helpGroup: 'GLOBAL',
+        }),
+        account: Flags.string({
+            description: 'Account ID (needed for account-scoped hub endpoints)',
+            env: 'NORBIX_ACCOUNT_ID',
+            helpGroup: 'GLOBAL',
+        }),
+    };
+    readStore() {
+        return readStore(this.config.configDir);
+    }
+    resolveContext(flags) {
+        const stored = this.readStore();
+        const apiKeyOverride = flags['api-key'];
+        return {
+            stored,
+            projectId: flags.project ?? stored.projectId,
+            accountId: flags.account ?? stored.accountId,
+            env: flags.env ?? stored.env,
+            region: flags.region ?? stored.region,
+            apiKey: apiKeyOverride ?? (stored.bearerToken ? undefined : stored.apiKey),
+            // An explicit --api-key / NORBIX_API_KEY wins over a stored login token.
+            bearerToken: apiKeyOverride ? undefined : stored.bearerToken,
+            apiUrl: stored.apiUrl ?? process.env.NORBIX_API_URL,
+            hubUrl: stored.hubUrl ?? process.env.NORBIX_HUB_URL,
+        };
+    }
+    /** Build an SDK client from flags + env + config file. Errors politely when auth is missing. */
+    client(flags, opts = {}) {
+        const ctx = this.resolveContext(flags);
+        if (!ctx.projectId) {
+            this.error('No project ID configured.\nRun `norbix login`, or `norbix config set projectId <id>`, or pass --project.');
+        }
+        if (opts.requireAuth !== false && !ctx.apiKey && !ctx.bearerToken) {
+            this.error('Not authenticated. Run `norbix login` or pass --api-key.');
+        }
+        return new Norbix({
+            projectId: ctx.projectId,
+            accountId: ctx.accountId,
+            apiKey: ctx.apiKey,
+            bearerToken: ctx.bearerToken,
+            env: ctx.env,
+            region: ctx.region,
+            baseUrl: { api: ctx.apiUrl, hub: ctx.hubUrl },
+        }, 
+        // The CLI already resolved env vars itself — don't let the SDK re-read them.
+        { envSource: {} });
+    }
+    /** Pretty-print a result unless --json is active (oclif prints the return value then). */
+    print(data) {
+        if (!this.jsonEnabled()) {
+            this.log(typeof data === 'string' ? data : JSON.stringify(data, null, 2));
+        }
+    }
+    async catch(error) {
+        if (error instanceof NorbixError) {
+            const status = error.status;
+            const suffix = status ? ` (HTTP ${status})` : '';
+            const hint = status === 401
+                ? '\nYour session may have expired. Run `norbix login` again.'
+                : '';
+            return this.error(`${error.message}${suffix}${hint}`);
+        }
+        return super.catch(error);
+    }
+}

package/dist/commands/account/billing-portal.js

@@ -0,0 +1,21 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+export default class AccountBillingPortal extends BaseCommand {
+    static description = 'Get a Stripe billing portal URL for the account';
+    static examples = ['<%= config.bin %> account billing-portal'];
+    static flags = {
+        type: Flags.string({ description: 'Subscription type (backend enum, optional)' }),
+        'return-url': Flags.string({ description: 'Where Stripe sends the user back to' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AccountBillingPortal);
+        const client = this.client(flags);
+        const res = await client.hub.account.getStripeBillingPortalUrl({
+            // Backend enum — passed through as-is when provided.
+            ...(flags.type ? { subscriptionType: flags.type } : {}),
+            returnUrl: flags['return-url'],
+        });
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/profile.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountProfile extends BaseCommand {
+    static description = 'Show the account profile';
+    static examples = ['<%= config.bin %> account profile'];
+    async run() {
+        const { flags } = await this.parse(AccountProfile);
+        const client = this.client(flags);
+        const res = await client.hub.account.getAccountProfile({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/projects.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountProjects extends BaseCommand {
+    static description = 'List all projects in the account';
+    static examples = ['<%= config.bin %> account projects'];
+    async run() {
+        const { flags } = await this.parse(AccountProjects);
+        const client = this.client(flags);
+        const res = await client.hub.account.getProjects({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/regions.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountRegions extends BaseCommand {
+    static description = 'List regions available to the account';
+    static examples = ['<%= config.bin %> account regions'];
+    async run() {
+        const { flags } = await this.parse(AccountRegions);
+        const client = this.client(flags);
+        const res = await client.hub.account.getAccountRegions({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/status.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountStatus extends BaseCommand {
+    static description = 'Show the account status (plan, verification, limits)';
+    static examples = ['<%= config.bin %> account status'];
+    async run() {
+        const { flags } = await this.parse(AccountStatus);
+        const client = this.client(flags);
+        const res = await client.hub.account.getAccountStatus({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/team.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountTeam extends BaseCommand {
+    static description = 'List account collaborators (team members)';
+    static examples = ['<%= config.bin %> account team'];
+    async run() {
+        const { flags } = await this.parse(AccountTeam);
+        const client = this.client(flags);
+        const res = await client.hub.account.getAccountCollaborators({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/account/usage.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class AccountUsage extends BaseCommand {
+    static description = 'Show usage-based billing for the account';
+    static examples = ['<%= config.bin %> account usage'];
+    async run() {
+        const { flags } = await this.parse(AccountUsage);
+        const client = this.client(flags);
+        const res = await client.hub.account.getAccountUsageBilling({});
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/api.js

@@ -0,0 +1,87 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../base.js';
+import { readJsonInput } from '../lib/json.js';
+const DEFAULT_API = 'https://api.norbix.dev';
+const DEFAULT_HUB = 'https://hub.norbix.dev';
+/**
+ * Raw escape hatch (like `gh api`): call ANY Norbix endpoint, including the
+ * ones this CLI has no dedicated command for yet. Sends the same auth and
+ * scope headers the SDK transport sends.
+ */
+export default class Api extends BaseCommand {
+    static description = `Call any Norbix endpoint directly (escape hatch, like \`gh api\`).
+
+Sends your auth token plus project/account/env/region headers automatically.
+Use {version} in the path and it becomes v2.`;
+    static examples = [
+        '<%= config.bin %> api /v2/logs/settings --hub',
+        `<%= config.bin %> api '/{version}/database/collections/orders/count' --query filter='{"status":"paid"}'`,
+        `<%= config.bin %> api /v2/scheduler/tasks --hub --method POST --body '{"name":"nightly",...}'`,
+    ];
+    static args = {
+        path: Args.string({ required: true, description: 'Endpoint path, e.g. /v2/logs or /{version}/logs' }),
+    };
+    static flags = {
+        hub: Flags.boolean({ description: 'Call the Hub service instead of the API service', default: false }),
+        method: Flags.string({ char: 'X', description: 'HTTP method', default: 'GET', options: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'] }),
+        body: Flags.string({ char: 'b', description: 'JSON request body (or `-` for stdin)' }),
+        query: Flags.string({ char: 'q', description: 'Query parameter key=value (repeatable)', multiple: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Api);
+        const ctx = this.resolveContext(flags);
+        if (!ctx.projectId)
+            this.error('No project ID configured. Run `norbix login` or pass --project.');
+        const token = ctx.bearerToken ?? ctx.apiKey;
+        if (!token)
+            this.error('Not authenticated. Run `norbix login` or pass --api-key.');
+        // Base URL: custom > default (+ region subdomain, same rule as the SDK).
+        let base = flags.hub ? (ctx.hubUrl ?? DEFAULT_HUB) : (ctx.apiUrl ?? DEFAULT_API);
+        const usesDefault = flags.hub ? !ctx.hubUrl : !ctx.apiUrl;
+        if (usesDefault && ctx.region)
+            base = base.replace('://', `://${ctx.region}.`);
+        const path = args.path.replace('{version}', 'v2');
+        const url = new URL(base.replace(/\/$/, '') + (path.startsWith('/') ? path : `/${path}`));
+        for (const pair of flags.query ?? []) {
+            const eq = pair.indexOf('=');
+            if (eq < 1)
+                this.error(`--query must be key=value, got "${pair}"`);
+            url.searchParams.append(pair.slice(0, eq), pair.slice(eq + 1));
+        }
+        const headers = {
+            Accept: 'application/json',
+            Authorization: `Bearer ${token}`,
+            'norbix-project-id': ctx.projectId,
+            'X-CM-ProjectId': ctx.projectId,
+        };
+        if (ctx.accountId) {
+            headers['norbix-account-id'] = ctx.accountId;
+            headers['X-CM-AccountId'] = ctx.accountId;
+        }
+        if (ctx.env && ctx.env !== 'PROD')
+            headers['norbix-env'] = ctx.env;
+        if (ctx.region)
+            headers['nb-region'] = ctx.region;
+        let body;
+        if (flags.body) {
+            body = await readJsonInput(flags.body, 'body');
+            headers['Content-Type'] = 'application/json';
+        }
+        const res = await fetch(url, { method: flags.method, headers, body });
+        const text = await res.text();
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = text;
+        }
+        if (!res.ok) {
+            this.warn(`HTTP ${res.status} ${res.statusText}`);
+            this.print(data);
+            this.exit(1);
+        }
+        this.print(data);
+        return data;
+    }
+}

package/dist/commands/apikeys/list.js

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base.js';
+export default class ApikeysList extends BaseCommand {
+    static description = "Show the project's API keys for the current environment";
+    static examples = ['<%= config.bin %> apikeys list', '<%= config.bin %> apikeys list --env TEST'];
+    async run() {
+        const { flags } = await this.parse(ApikeysList);
+        const client = this.client(flags);
+        const res = await client.api.apikeys.getApiKeys({ environment: flags.env });
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/apikeys/regenerate.js

@@ -0,0 +1,25 @@
+import { confirm } from '@inquirer/prompts';
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+export default class ApikeysRegenerate extends BaseCommand {
+    static description = 'Regenerate the API keys for the current environment (old keys stop working!)';
+    static examples = ['<%= config.bin %> apikeys regenerate --yes'];
+    static flags = {
+        yes: Flags.boolean({ char: 'y', description: 'Skip the confirmation prompt', default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(ApikeysRegenerate);
+        const client = this.client(flags);
+        if (!flags.yes && process.stdout.isTTY) {
+            const ok = await confirm({
+                message: 'Regenerate API keys? Every service using the old keys will lose access.',
+                default: false,
+            });
+            if (!ok)
+                return this.print('Cancelled.');
+        }
+        const res = await client.api.apikeys.regenerateApiKeys({ environment: flags.env });
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/config/get.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { SETTABLE_KEYS, isSettableKey, redact } from '../../lib/store.js';
+export default class ConfigGet extends BaseCommand {
+    static description = 'Print one configuration value';
+    static examples = ['<%= config.bin %> config get projectId'];
+    static args = {
+        key: Args.string({ required: true, description: `One of: ${SETTABLE_KEYS.join(', ')}` }),
+    };
+    async run() {
+        const { args } = await this.parse(ConfigGet);
+        if (!isSettableKey(args.key)) {
+            this.error(`Unknown key "${args.key}". Valid keys: ${SETTABLE_KEYS.join(', ')}`);
+        }
+        const stored = this.readStore();
+        const value = args.key === 'apiKey' ? redact(stored.apiKey) : stored[args.key];
+        this.print(value ?? '(not set)');
+        return { key: args.key, value };
+    }
+}

package/dist/commands/config/list.js

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base.js';
+import { configFilePath, redact } from '../../lib/store.js';
+export default class ConfigList extends BaseCommand {
+    static description = 'Show the local CLI configuration (secrets redacted)';
+    static examples = ['<%= config.bin %> config list'];
+    async run() {
+        await this.parse(ConfigList);
+        const stored = this.readStore();
+        const display = {
+            ...stored,
+            apiKey: redact(stored.apiKey),
+            bearerToken: redact(stored.bearerToken),
+            refreshToken: redact(stored.refreshToken),
+        };
+        this.print({ file: configFilePath(this.config.configDir), ...display });
+        return display;
+    }
+}

package/dist/commands/config/set.js

@@ -0,0 +1,25 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { SETTABLE_KEYS, isSettableKey, writeStore } from '../../lib/store.js';
+export default class ConfigSet extends BaseCommand {
+    static description = 'Set one configuration value';
+    static examples = [
+        '<%= config.bin %> config set projectId 5f1a9f7e...',
+        '<%= config.bin %> config set region nb-eu-germany',
+        '<%= config.bin %> config set env TEST',
+    ];
+    static args = {
+        key: Args.string({ required: true, description: `One of: ${SETTABLE_KEYS.join(', ')}` }),
+        value: Args.string({ required: true, description: 'New value' }),
+    };
+    async run() {
+        const { args } = await this.parse(ConfigSet);
+        if (!isSettableKey(args.key)) {
+            this.error(`Unknown key "${args.key}". Valid keys: ${SETTABLE_KEYS.join(', ')}`);
+        }
+        const stored = this.readStore();
+        writeStore(this.config.configDir, { ...stored, [args.key]: args.value });
+        this.print(`${args.key} = ${args.key === 'apiKey' ? '(saved)' : args.value}`);
+        return { key: args.key, saved: true };
+    }
+}

package/dist/commands/config/unset.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { SETTABLE_KEYS, isSettableKey, writeStore } from '../../lib/store.js';
+export default class ConfigUnset extends BaseCommand {
+    static description = 'Remove one configuration value';
+    static examples = ['<%= config.bin %> config unset region'];
+    static args = {
+        key: Args.string({ required: true, description: `One of: ${SETTABLE_KEYS.join(', ')}` }),
+    };
+    async run() {
+        const { args } = await this.parse(ConfigUnset);
+        if (!isSettableKey(args.key)) {
+            this.error(`Unknown key "${args.key}". Valid keys: ${SETTABLE_KEYS.join(', ')}`);
+        }
+        const stored = this.readStore();
+        writeStore(this.config.configDir, { ...stored, [args.key]: undefined });
+        this.print(`${args.key} removed.`);
+        return { key: args.key, removed: true };
+    }
+}

package/dist/commands/db/aggregate.js

@@ -0,0 +1,42 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { readJsonInput } from '../../lib/json.js';
+export default class DbAggregate extends BaseCommand {
+    static description = 'Run an aggregation: an inline pipeline, or a saved aggregate by ID';
+    static examples = [
+        `<%= config.bin %> db aggregate orders --pipeline '[{"$group":{"_id":"$status","n":{"$sum":1}}}]'`,
+        '<%= config.bin %> db aggregate orders --id 66b2f0a1...',
+    ];
+    static args = {
+        collection: Args.string({ required: true, description: 'Collection name' }),
+    };
+    static flags = {
+        pipeline: Flags.string({ description: 'JSON aggregation pipeline (or `-` for stdin)', exclusive: ['id'] }),
+        id: Flags.string({ description: 'Saved aggregate ID (runs executeAggregate)' }),
+        tokens: Flags.string({ description: 'JSON object of tokens for a saved aggregate', dependsOn: ['id'] }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DbAggregate);
+        const client = this.client(flags);
+        if (flags.id) {
+            const tokens = flags.tokens
+                ? JSON.parse(await readJsonInput(flags.tokens, 'tokens'))
+                : undefined;
+            const res = await client.api.database.executeAggregate({
+                collectionName: args.collection,
+                aggregateId: flags.id,
+                tokens,
+            });
+            this.print(res);
+            return res;
+        }
+        if (!flags.pipeline)
+            this.error('Pass --pipeline with inline JSON, or --id for a saved aggregate.');
+        const res = await client.api.database.aggregate({
+            collectionName: args.collection,
+            pipeline: await readJsonInput(flags.pipeline, 'pipeline'),
+        });
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/db/aggregates.js

@@ -0,0 +1,16 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+export default class DbAggregates extends BaseCommand {
+    static description = 'List saved database aggregates';
+    static examples = ['<%= config.bin %> db aggregates', '<%= config.bin %> db aggregates --schema 66b2...'];
+    static flags = {
+        schema: Flags.string({ description: 'Only aggregates of this schema ID' }),
+    };
+    async run() {
+        const { flags } = await this.parse(DbAggregates);
+        const client = this.client(flags);
+        const res = await client.hub.database.getDatabaseAggregates({ schemaId: flags.schema });
+        this.print(res);
+        return res;
+    }
+}

package/dist/commands/db/count.js

@@ -0,0 +1,26 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { readJsonInput } from '../../lib/json.js';
+export default class DbCount extends BaseCommand {
+    static description = 'Count records in a collection';
+    static examples = [
+        '<%= config.bin %> db count orders',
+        `<%= config.bin %> db count orders --filter '{"status":"paid"}'`,
+    ];
+    static args = {
+        collection: Args.string({ required: true, description: 'Collection name' }),
+    };
+    static flags = {
+        filter: Flags.string({ char: 'f', description: 'JSON filter (or `-` for stdin)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DbCount);
+        const client = this.client(flags);
+        const res = await client.api.database.count({
+            collectionName: args.collection,
+            filter: flags.filter ? await readJsonInput(flags.filter, 'filter') : undefined,
+        });
+        this.print(res);
+        return res;
+    }
+}