@bounc.ing/cli 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,10 @@
+interface Config {
+    apiKey?: string;
+}
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Config): void;
+export declare function api(path: string, options?: {
+    method?: string;
+    body?: unknown;
+}): Promise<unknown>;
+export {};

package/dist/api.js

@@ -0,0 +1,48 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_DIR = join(homedir(), '.bouncing');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const BASE_URL = 'https://dev.bounc.ing';
+export function loadConfig() {
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(config) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+function getApiKey() {
+    const envKey = process.env.BOUNCING_API_KEY;
+    if (envKey)
+        return envKey;
+    const config = loadConfig();
+    if (config.apiKey)
+        return config.apiKey;
+    console.error('No API key found. Set BOUNCING_API_KEY or run: bouncing login');
+    process.exit(1);
+}
+export async function api(path, options) {
+    const apiKey = getApiKey();
+    const headers = {
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Type': 'application/json',
+    };
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: options?.method ?? 'GET',
+        headers,
+        body: options?.body ? JSON.stringify(options.body) : undefined,
+    });
+    const json = await res.json();
+    if (!res.ok) {
+        const msg = json.error?.message ?? `API error ${res.status}`;
+        console.error(`Error: ${msg}`);
+        process.exit(1);
+    }
+    return json.data;
+}

package/dist/commands/apps.d.ts

@@ -0,0 +1,4 @@
+export declare function list(): Promise<void>;
+export declare function create(slug: string, name?: string): Promise<void>;
+export declare function get(slug: string): Promise<void>;
+export declare function del(slug: string): Promise<void>;

package/dist/commands/apps.js

@@ -0,0 +1,25 @@
+import { api } from '../api.js';
+export async function list() {
+    const apps = await api('/api/apps');
+    if (apps.length === 0) {
+        console.log('No apps.');
+        return;
+    }
+    console.log('Slug                Display Name                    Status    MAU Cap');
+    console.log('──────────────────  ──────────────────────────────  ────────  ───────');
+    for (const a of apps) {
+        console.log(`${a.slug.padEnd(20)}${a.display_name.padEnd(32)}${a.status.padEnd(10)}${a.mau_cap ?? 'none'}`);
+    }
+}
+export async function create(slug, name) {
+    const app = await api('/api/apps', { method: 'POST', body: { slug, display_name: name ?? slug } });
+    console.log(JSON.stringify(app, null, 2));
+}
+export async function get(slug) {
+    const app = await api(`/api/apps/${slug}`);
+    console.log(JSON.stringify(app, null, 2));
+}
+export async function del(slug) {
+    await api(`/api/apps/${slug}`, { method: 'DELETE' });
+    console.log(`Deleted ${slug}`);
+}

package/dist/commands/billing.d.ts

@@ -0,0 +1,2 @@
+export declare function show(): Promise<void>;
+export declare function setCap(slug: string, cap: string): Promise<void>;

package/dist/commands/billing.js

@@ -0,0 +1,12 @@
+import { api } from '../api.js';
+export async function show() {
+    const data = await api('/api/billing');
+    console.log(`MAU:    ${data.mau}`);
+    console.log(`Tier:   ${data.tier.label}`);
+    console.log(`Status: ${data.subscription.status}`);
+}
+export async function setCap(slug, cap) {
+    const capValue = cap === 'none' ? null : parseInt(cap, 10);
+    await api(`/api/apps/${slug}/mau-cap`, { method: 'PUT', body: { cap: capValue } });
+    console.log(`MAU cap for ${slug}: ${capValue ?? 'none'}`);
+}

package/dist/commands/domains.d.ts

@@ -0,0 +1,3 @@
+export declare function set(slug: string, domain: string): Promise<void>;
+export declare function verify(slug: string): Promise<void>;
+export declare function del(slug: string): Promise<void>;

package/dist/commands/domains.js

@@ -0,0 +1,17 @@
+import { api } from '../api.js';
+export async function set(slug, domain) {
+    const result = await api(`/api/apps/${slug}/domain`, { method: 'POST', body: { domain } });
+    console.log(`Custom domain requested: ${result.domain}`);
+    console.log(`\nTo verify, add this DNS TXT record:\n`);
+    console.log(`  Name:  _bouncing-verify.${result.domain}`);
+    console.log(`  Value: ${result.verification_token}\n`);
+    console.log(`Then run: bouncing domains verify ${slug}`);
+}
+export async function verify(slug) {
+    const result = await api(`/api/apps/${slug}/domain/verify`, { method: 'POST' });
+    console.log(result.message);
+}
+export async function del(slug) {
+    await api(`/api/apps/${slug}/domain`, { method: 'DELETE' });
+    console.log('Custom domain removed.');
+}

package/dist/commands/keys.d.ts

@@ -0,0 +1,3 @@
+export declare function list(): Promise<void>;
+export declare function create(name: string): Promise<void>;
+export declare function del(id: string): Promise<void>;

package/dist/commands/keys.js

@@ -0,0 +1,22 @@
+import { api } from '../api.js';
+export async function list() {
+    const keys = await api('/api/keys');
+    if (keys.length === 0) {
+        console.log('No API keys.');
+        return;
+    }
+    console.log('ID                                Name                  Prefix            Last Used');
+    console.log('────────────────────────────────  ────────────────────  ────────────────  ─────────');
+    for (const k of keys) {
+        const used = k.last_used_at ? new Date(k.last_used_at * 1000).toISOString().slice(0, 10) : 'Never';
+        console.log(`${k.id.padEnd(34)}${k.name.padEnd(22)}${k.key_prefix.padEnd(18)}${used}`);
+    }
+}
+export async function create(name) {
+    const key = await api('/api/keys', { method: 'POST', body: { name } });
+    console.log(`Key created. Save this — you won't see it again:\n\n  ${key.key}\n`);
+}
+export async function del(id) {
+    await api(`/api/keys/${id}`, { method: 'DELETE' });
+    console.log(`Deleted key ${id}`);
+}

package/dist/commands/users.d.ts

@@ -0,0 +1,2 @@
+export declare function list(slug: string): Promise<void>;
+export declare function del(slug: string, userId: string): Promise<void>;

package/dist/commands/users.js

@@ -0,0 +1,17 @@
+import { api } from '../api.js';
+export async function list(slug) {
+    const users = await api(`/api/apps/${slug}/users`);
+    if (users.length === 0) {
+        console.log('No users.');
+        return;
+    }
+    console.log('ID                                Email                           Name');
+    console.log('────────────────────────────────  ──────────────────────────────  ────────────────');
+    for (const u of users) {
+        console.log(`${u.id.padEnd(34)}${u.email.padEnd(32)}${u.name ?? ''}`);
+    }
+}
+export async function del(slug, userId) {
+    await api(`/api/apps/${slug}/users/${userId}`, { method: 'DELETE' });
+    console.log(`Deleted user ${userId}`);
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { saveConfig } from './api.js';
+import * as apps from './commands/apps.js';
+import * as users from './commands/users.js';
+import * as billing from './commands/billing.js';
+import * as keys from './commands/keys.js';
+import * as domains from './commands/domains.js';
+const args = process.argv.slice(2);
+const cmd = args[0];
+const sub = args[1];
+const arg1 = args[2];
+const arg2 = args[3];
+function usage() {
+    console.log(`Usage: bouncing <command> [subcommand] [args]
+
+Commands:
+  login                         Save API key
+  apps list                     List your apps
+  apps create <slug> [name]     Create an app
+  apps get <slug>               Get app details
+  apps delete <slug>            Delete an app
+  users list <slug>             List app users
+  users delete <slug> <id>      Delete a user
+  billing                       Show MAU and tier
+  billing set-cap <slug> <cap>  Set per-app MAU cap (or "none")
+  keys list                     List API keys
+  keys create <name>            Create an API key
+  keys delete <id>              Delete an API key
+  domains set <slug> <domain>   Request custom domain
+  domains verify <slug>         Verify domain DNS
+  domains delete <slug>         Remove custom domain
+`);
+    process.exit(1);
+}
+async function main() {
+    if (!cmd)
+        usage();
+    if (cmd === 'login') {
+        const readline = await import('node:readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const key = await new Promise((resolve) => rl.question('API key: ', resolve));
+        rl.close();
+        saveConfig({ apiKey: key.trim() });
+        console.log('Saved to ~/.bouncing/config.json');
+        return;
+    }
+    if (cmd === 'apps') {
+        if (sub === 'list')
+            return apps.list();
+        if (sub === 'create' && arg1)
+            return apps.create(arg1, arg2);
+        if (sub === 'get' && arg1)
+            return apps.get(arg1);
+        if (sub === 'delete' && arg1)
+            return apps.del(arg1);
+        usage();
+    }
+    if (cmd === 'users') {
+        if (sub === 'list' && arg1)
+            return users.list(arg1);
+        if (sub === 'delete' && arg1 && arg2)
+            return users.del(arg1, arg2);
+        usage();
+    }
+    if (cmd === 'billing') {
+        if (!sub)
+            return billing.show();
+        if (sub === 'set-cap' && arg1 && arg2)
+            return billing.setCap(arg1, arg2);
+        usage();
+    }
+    if (cmd === 'keys') {
+        if (sub === 'list')
+            return keys.list();
+        if (sub === 'create' && arg1)
+            return keys.create(arg1);
+        if (sub === 'delete' && arg1)
+            return keys.del(arg1);
+        usage();
+    }
+    if (cmd === 'domains') {
+        if (sub === 'set' && arg1 && arg2)
+            return domains.set(arg1, arg2);
+        if (sub === 'verify' && arg1)
+            return domains.verify(arg1);
+        if (sub === 'delete' && arg1)
+            return domains.del(arg1);
+        usage();
+    }
+    usage();
+}
+main().catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@bounc.ing/cli",
+  "version": "0.1.0",
+  "description": "CLI for managing bounc.ing apps",
+  "type": "module",
+  "bin": {
+    "bouncing": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scttfrdmn/bouncing-managed",
+    "directory": "sdk/cli"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2"
+  }
+}