@archildata/just-bash 0.1.1 → 0.1.3

package/README.md

@@ -78,7 +78,17 @@ const fs = new ArchilFs(client, {
 The package includes an interactive shell for testing:
 
 ```bash
-ARCHIL_REGION=aws-us-east-1 ARCHIL_DISK=myaccount/mydisk ARCHIL_TOKEN=xxx npx @archildata/just-bash
+# Positional arguments (recommended)
+npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+
+# With flags
+npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk
+
+# With token (use env var to keep out of shell history)
+ARCHIL_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+
+# With debug logging
+npx @archildata/just-bash aws-us-east-1 myaccount/mydisk --log-level debug
 ```
 
 Shell commands:
@@ -134,6 +144,8 @@ DEBUG=archil:* node myapp.js
 - **Chunked reads** - Large files read in 4 MiB chunks
 - **Native protocol** - Direct Archil protocol access, no FUSE overhead
 
+> **Note:** For best performance, run your application in the same region as your Archil disk (e.g., if your disk is in `aws-us-east-1`, deploy your app to AWS us-east-1).
+
 ## License
 
 MIT

package/dist/shell.js

@@ -2,28 +2,43 @@
 
 // bin/shell.ts
 import * as readline from "readline";
+import { Command } from "commander";
 import { ArchilClient } from "@archildata/client";
 import { Bash } from "just-bash";
 import { ArchilFs } from "@archildata/just-bash";
+var program = new Command();
+program.name("archil-shell").description("Interactive bash shell with Archil filesystem").version("0.1.0").argument("[region]", "Region identifier (e.g., aws-us-east-1)").argument("[disk]", "Disk name (e.g., myaccount/mydisk)").option("-r, --region <region>", "Region identifier (e.g., aws-us-east-1)").option("-d, --disk <disk>", "Disk name (e.g., myaccount/mydisk)").option("-t, --token <token>", "Auth token (defaults to IAM)").option("-l, --log-level <level>", "Log level: trace, debug, info, warn, error").addHelpText("after", `
+Environment variables:
+  ARCHIL_REGION     Fallback for --region
+  ARCHIL_DISK       Fallback for --disk
+  ARCHIL_TOKEN      Fallback for --token (recommended for secrets)
+  ARCHIL_LOG_LEVEL  Fallback for --log-level
+
+Examples:
+  $ npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+  $ npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk
+  $ ARCHIL_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+  $ npx @archildata/just-bash -r aws-us-east-1 -d myaccount/mydisk -l debug
+`);
+program.parse();
+var opts = program.opts();
+var args = program.args;
+var region = args[0] || opts.region || process.env.ARCHIL_REGION;
+var diskName = args[1] || opts.disk || process.env.ARCHIL_DISK;
+var authToken = opts.token || process.env.ARCHIL_TOKEN;
+var logLevel = opts.logLevel || process.env.ARCHIL_LOG_LEVEL;
+if (!region || !diskName) {
+  console.error("Error: region and disk are required\n");
+  console.error("Usage:");
+  console.error("  npx @archildata/just-bash <region> <disk>");
+  console.error("  npx @archildata/just-bash --region <region> --disk <disk>");
+  console.error("\nExamples:");
+  console.error("  npx @archildata/just-bash aws-us-east-1 myaccount/mydisk");
+  console.error("  ARCHIL_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk");
+  console.error("\nRun with --help for more options.");
+  process.exit(1);
+}
 async function main() {
-  const region = process.env.ARCHIL_REGION;
-  const diskName = process.env.ARCHIL_DISK;
-  const authToken = process.env.ARCHIL_TOKEN;
-  const logLevel = process.env.ARCHIL_LOG_LEVEL;
-  if (!region || !diskName) {
-    console.error("Missing required environment variables:");
-    console.error("  ARCHIL_REGION    - e.g., aws-us-east-1");
-    console.error("  ARCHIL_DISK      - e.g., myaccount/mydisk");
-    console.error("  ARCHIL_TOKEN     - (optional) auth token, defaults to IAM");
-    console.error("  ARCHIL_LOG_LEVEL - (optional) log level: trace, debug, info, warn, error");
-    console.error("");
-    console.error("Usage:");
-    console.error("  ARCHIL_REGION=aws-us-east-1 ARCHIL_DISK=myaccount/mydisk npx tsx bin/shell.ts");
-    console.error("");
-    console.error("For debug logging:");
-    console.error("  ARCHIL_LOG_LEVEL=debug ARCHIL_REGION=... ARCHIL_DISK=... npx tsx bin/shell.ts");
-    process.exit(1);
-  }
   console.log("Connecting to Archil...");
   console.log(`  Region: ${region}`);
   console.log(`  Disk: ${diskName}`);
@@ -105,9 +120,9 @@ Received ${signal}, cleaning up...`);
     const subcommand = parts[1];
     const targetPath = parts[2];
     if (subcommand === "checkout") {
-      const args = parts.slice(2);
-      const force = args.includes("--force") || args.includes("-f");
-      const pathArg = args.find((a) => !a.startsWith("-"));
+      const args2 = parts.slice(2);
+      const force = args2.includes("--force") || args2.includes("-f");
+      const pathArg = args2.find((a) => !a.startsWith("-"));
       if (!pathArg) {
         console.error("Usage: archil checkout [--force|-f] <path>");
         return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/just-bash",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Archil filesystem adapter for just-bash",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,8 @@
     "shell": "tsx bin/shell.ts"
   },
   "dependencies": {
-    "@archildata/client": "^0.1.0",
+    "@archildata/client": "^0.1.5",
+    "commander": "^14.0.3",
     "debug": "^4.3.4",
     "just-bash": "^2.7.0"
   },