@nimbus-sh/cli 0.1.1 → 0.1.3

package/README.md

@@ -29,8 +29,9 @@ Scaffolds a Nimbus-powered Workers project. `.` uses the current directory.
 nimbus init my-nimbus
 cd my-nimbus
 npm install
-wrangler secret put JWT_SECRET
-wrangler deploy
+CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name my-nimbus
+npx wrangler secret put JWT_SECRET
+npx wrangler deploy
 ```
 
 ### `create-nimbus-app <name>`
@@ -41,8 +42,9 @@ Scaffolds a new Nimbus-powered Workers project.
 create-nimbus-app my-nimbus
 cd my-nimbus
 npm install
-wrangler secret put JWT_SECRET
-wrangler deploy
+CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name my-nimbus
+npx wrangler secret put JWT_SECRET
+npx wrangler deploy
 ```
 
 Flags:
@@ -53,6 +55,27 @@ Flags:
 | `--template <name>` | `worker-only` | Only `worker-only` ships in v0.1. |
 | `--force` | off | Overwrite existing directory. |
 
+### `nimbus setup cloudflare`
+
+Creates the R2 buckets referenced by the scaffolded `wrangler.jsonc` and
+uploads the Python, Ruby, and clang runtime catalog.
+
+```bash
+CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name my-nimbus
+```
+
+If Wrangler reports Cloudflare R2 error `10042`, enable R2 in the
+Cloudflare Dashboard once for the account, then rerun the setup command.
+
+Flags:
+
+| Flag | Default | What |
+|---|---|---|
+| `--name <worker-name>` | required | Worker name and default bucket prefix. |
+| `--bucket-prefix <prefix>` | `--name` | Prefix for npm cache buckets. |
+| `--runtime-bucket <bucket>` | `nimbus-runtime-cache-public` | Runtime catalog/blob bucket. |
+| `--skip-runtimes` | off | Create buckets only. |
+
 ### `nimbus token mint`
 
 ```bash

package/dist/bin.js

@@ -21,6 +21,7 @@
 import { mintToken, verifyTokenCmd } from './commands/token.js';
 import { syncRuntimes, listRuntimes } from './commands/runtime-sync.js';
 import { newSession } from './commands/session.js';
+import { setupCloudflare } from './commands/setup.js';
 import { CLI_VERSION } from './version.js';
 const verbs = {
     token: {
@@ -34,6 +35,9 @@ const verbs = {
     session: {
         new: newSession,
     },
+    setup: {
+        cloudflare: setupCloudflare,
+    },
 };
 async function main(argv) {
     if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
@@ -64,6 +68,7 @@ Usage:
   nimbus runtime sync [--bucket <name>] [runtime[@version]...]
   nimbus runtime list
   nimbus session new [--endpoint <url>]
+  nimbus setup cloudflare --name <worker-name>
   nimbus init [directory]
 
 For embedder scaffolding:

package/dist/commands/scaffold.d.ts

@@ -4,7 +4,7 @@
  * v0.1 ships a single template: `worker-only`. The scaffolder writes:
  *
  *   <project>/
- *   ├── package.json       — deps: @nimbus-sh/worker, @nimbus-sh/sdk
+ *   ├── package.json       — deps: @nimbus-sh/sdk, @nimbus-sh/worker
  *   ├── wrangler.jsonc     — the canonical 28-LOC embedder snippet
  *   ├── src/
  *   │   └── index.ts       — 6 LOC default-export

package/dist/commands/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiF9D"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsF9D"}

package/dist/commands/scaffold.js

@@ -4,7 +4,7 @@
  * v0.1 ships a single template: `worker-only`. The scaffolder writes:
  *
  *   <project>/
- *   ├── package.json       — deps: @nimbus-sh/worker, @nimbus-sh/sdk
+ *   ├── package.json       — deps: @nimbus-sh/sdk, @nimbus-sh/worker
  *   ├── wrangler.jsonc     — the canonical 28-LOC embedder snippet
  *   ├── src/
  *   │   └── index.ts       — 6 LOC default-export
@@ -79,6 +79,7 @@ Options:
         nextSteps: [
             `cd ${projectName}`,
             'npm install',
+            `CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name ${wranglerName}`,
             'npx wrangler secret put JWT_SECRET',
             'npx wrangler deploy',
         ],
@@ -89,11 +90,15 @@ Options:
 Next steps:
   cd ${projectName}
   npm install
+  CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name ${wranglerName}
   npx wrangler secret put JWT_SECRET       # paste a 32+ char hex secret
   npx wrangler deploy
 
-Deploy will provision the DO + R2 buckets on first run. Visit the
-returned URL and hit "Launch" to mint a session.
+If setup reports Cloudflare R2 error 10042, enable R2 in the Cloudflare
+Dashboard once for this account, then rerun the setup command.
+
+Deploy will provision the Durable Object on first run. Visit the returned
+URL and hit "Launch" to mint a session.
 
 Docs: https://github.com/AshishKumar4/Nimbus#readme
 `);
@@ -112,8 +117,8 @@ function renderPackageJson(name) {
             typecheck: 'tsc --noEmit',
         },
         dependencies: {
-            '@nimbus-sh/worker': '^0.1.0',
-            '@nimbus-sh/sdk': '^0.1.0',
+            '@nimbus-sh/worker': '^0.1.1',
+            '@nimbus-sh/sdk': '^0.1.1',
         },
         devDependencies: {
             '@cloudflare/workers-types': '^4.20250327.0',
@@ -185,7 +190,7 @@ function renderIndexTs() {
   NimbusDOStub,
   CirrusHmrRPC,
   createNimbusHandler,
-} from '@nimbus-sh/worker';
+} from '@nimbus-sh/sdk/worker';
 
 // Re-export the DO class + every RPC class so wrangler's
 // \`durable_objects.bindings[].class_name\` lookup + \`enable_ctx_exports\`
@@ -229,12 +234,16 @@ A Nimbus-powered Cloudflare Worker.
 
 \`\`\`bash
 npm install
+CLOUDFLARE_ACCOUNT_ID=<account-id> npx @nimbus-sh/cli setup cloudflare --name ${wranglerName}
 npx wrangler secret put JWT_SECRET      # paste a 32+ char hex secret
 npx wrangler deploy
 \`\`\`
 
 Then visit the URL wrangler prints. Click "Launch" to mint a session.
 
+If setup reports Cloudflare R2 error 10042, enable R2 in the Cloudflare
+Dashboard once for this account, then rerun the setup command.
+
 ## Custom auth
 
 By default tokens are enforced (\`JWT_SECRET\` set). To mint:
@@ -261,7 +270,7 @@ import { NimbusTerminal } from '@nimbus-sh/react';
 Edit \`src/index.ts\`:
 
 \`\`\`ts
-import { NimbusSession, createNimbusHandler } from '@nimbus-sh/worker';
+import { NimbusSession, createNimbusHandler } from '@nimbus-sh/sdk/worker';
 import { issueNimbusToken } from '@nimbus-sh/sdk/token';
 
 export { NimbusSession };

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function setupCloudflare(args: string[]): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAUA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDrE"}

package/dist/commands/setup.js

@@ -0,0 +1,119 @@
+import { spawn } from 'node:child_process';
+import { syncRuntimes } from './runtime-sync.js';
+export async function setupCloudflare(args) {
+    if (args[0] === '--help' || args[0] === '-h') {
+        printHelp();
+        return 0;
+    }
+    const opts = parseFlags(args);
+    if (!opts.name) {
+        process.stderr.write('nimbus setup cloudflare: --name <worker-name> required\n');
+        printHelp();
+        return 64;
+    }
+    if (!process.env.CLOUDFLARE_ACCOUNT_ID) {
+        process.stderr.write('nimbus setup cloudflare: CLOUDFLARE_ACCOUNT_ID env var required\n');
+        return 78;
+    }
+    const prefix = opts.bucketPrefix || opts.name;
+    const runtimeBucket = opts.runtimeBucket || 'nimbus-runtime-cache-public';
+    const buckets = [
+        `${prefix}-npm-cache`,
+        `${prefix}-npm-packument-cache`,
+        runtimeBucket,
+    ];
+    process.stderr.write(`nimbus: preparing Cloudflare account for ${opts.name}\n`);
+    for (const bucket of buckets) {
+        const code = await runWrangler(['r2', 'bucket', 'create', bucket], {
+            okOnAlreadyExists: true,
+        });
+        if (code !== 0) {
+            process.stderr.write('nimbus setup cloudflare: R2 bucket setup failed. If Wrangler printed code 10042, enable R2 in the Cloudflare Dashboard and rerun this command.\n');
+            return code;
+        }
+    }
+    if (!opts.skipRuntimes) {
+        const code = await syncRuntimes(['--bucket', runtimeBucket, 'clang', 'python', 'ruby']);
+        if (code !== 0)
+            return code;
+    }
+    process.stdout.write(JSON.stringify({
+        ok: true,
+        worker: opts.name,
+        buckets,
+        runtimeBucket,
+        runtimesSynced: !opts.skipRuntimes,
+    }) + '\n');
+    return 0;
+}
+function parseFlags(args) {
+    const out = { skipRuntimes: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--name') {
+            out.name = args[++i] || '';
+            continue;
+        }
+        if (a === '--bucket-prefix') {
+            out.bucketPrefix = args[++i] || '';
+            continue;
+        }
+        if (a === '--runtime-bucket') {
+            out.runtimeBucket = args[++i] || '';
+            continue;
+        }
+        if (a === '--skip-runtimes') {
+            out.skipRuntimes = true;
+            continue;
+        }
+    }
+    return out;
+}
+function runWrangler(args, opts = {}) {
+    return new Promise((resolveExit) => {
+        const child = spawn('npx', ['wrangler', ...args], {
+            env: process.env,
+            shell: process.platform === 'win32',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let combined = '';
+        child.stdout.on('data', (chunk) => {
+            const text = String(chunk);
+            combined += text;
+            process.stderr.write(text);
+        });
+        child.stderr.on('data', (chunk) => {
+            const text = String(chunk);
+            combined += text;
+            process.stderr.write(text);
+        });
+        child.on('exit', (code) => {
+            if (code === 0)
+                return resolveExit(0);
+            if (opts.okOnAlreadyExists && /already exists|bucket.*exists/i.test(combined)) {
+                return resolveExit(0);
+            }
+            return resolveExit(code ?? 1);
+        });
+        child.on('error', (e) => {
+            process.stderr.write(`nimbus setup cloudflare: failed to run wrangler: ${e.message}\n`);
+            resolveExit(70);
+        });
+    });
+}
+function printHelp() {
+    process.stdout.write(`nimbus setup cloudflare
+
+Usage:
+  nimbus setup cloudflare --name <worker-name>
+
+Options:
+  --name <worker-name>       Deployed Cloudflare Worker name. Required.
+  --bucket-prefix <prefix>   Prefix for npm cache buckets. Defaults to --name.
+  --runtime-bucket <bucket>  Runtime cache bucket. Defaults to nimbus-runtime-cache-public.
+  --skip-runtimes            Create buckets only; do not upload Python/Ruby/clang runtime blobs.
+
+Env:
+  CLOUDFLARE_ACCOUNT_ID      Cloudflare account to prepare. Required.
+`);
+}

package/dist/index.d.ts

@@ -11,5 +11,6 @@
  */
 export { mintToken } from './commands/token.js';
 export { syncRuntimes } from './commands/runtime-sync.js';
+export { setupCloudflare } from './commands/setup.js';
 export { scaffold } from './commands/scaffold.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -11,4 +11,5 @@
  */
 export { mintToken } from './commands/token.js';
 export { syncRuntimes } from './commands/runtime-sync.js';
+export { setupCloudflare } from './commands/setup.js';
 export { scaffold } from './commands/scaffold.js';

package/dist/version.d.ts

@@ -3,5 +3,5 @@
  * `require('./package.json')` because that breaks under bun's
  * single-file binary mode.
  */
-export declare const CLI_VERSION = "0.1.1";
+export declare const CLI_VERSION = "0.1.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -3,4 +3,4 @@
  * `require('./package.json')` because that breaks under bun's
  * single-file binary mode.
  */
-export const CLI_VERSION = '0.1.1';
+export const CLI_VERSION = '0.1.3';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Nimbus CLI — `create-nimbus-app` scaffolder + `token mint` + `runtime sync`.",
   "homepage": "https://github.com/AshishKumar4/Nimbus",
   "repository": {
@@ -36,8 +36,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@nimbus-sh/sdk": "^0.1.0",
-    "@nimbus-sh/worker": "^0.1.0"
+    "@nimbus-sh/sdk": "^0.1.1",
+    "@nimbus-sh/worker": "^0.1.1"
   },
   "engines": {
     "node": ">=20"