dbcat 0.0.4 → 0.0.6

package/README.md

@@ -11,32 +11,33 @@ bunx dbcat ./data.db
 Connect to a database to browse all tables:
 
 ```sh
-# SQLite file
+# No argument - uses DATABASE_URL environment variable
+bunx dbcat
+
+# SQLite
 bunx dbcat ./database.sqlite
+bunx dbcat https://example.com/data.db
 
 # PostgreSQL
 bunx dbcat postgres://user:pass@localhost:5432/mydb
 
 # MySQL
 bunx dbcat mysql://user:pass@localhost:3306/mydb
-
-# No argument - uses DATABASE_URL environment variable
-bunx dbcat
 ```
 
 Run a query by piping SQL:
 
 ```sh
-echo "SELECT * FROM users WHERE active = true" | bunx dbcat ./data.db
+echo "SELECT * FROM users" | bunx dbcat ./data.db
 ```
 
 ### Options
 
-| Flag | Description |
-|------|-------------|
+| Flag           | Description                                       |
+|----------------|---------------------------------------------------|
 | `--full`, `-f` | Show all rows when browsing tables (default: 100) |
-| `--json` | Output as JSON (indented if TTY) |
-| `--json=color` | Output as normal object console.log |
+| `--json`       | Output as JSON (indented if TTY)                  |
+| `--json=color` | Output as normal object console.log               |
 
 Piped queries always return all rows.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcat",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A simple CLI to view database tables. Supports PostgreSQL, MySQL, and SQLite.",
   "author": "RiskyMH",
   "license": "MIT",
@@ -12,6 +12,10 @@
   "bugs": {
     "url": "https://github.com/RiskyMH/dbcat/issues"
   },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "sideEffects": false,
   "keywords": [
     "database",
     "cli",

package/src/index.ts

@@ -3,6 +3,11 @@
 if (typeof Bun !== "object") throw new Error("Please install & use bun!");
 
 import { printTable } from "./table.ts";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const SQLITE_EXTENSIONS = [".db", ".sqlite", ".sqlite3", ".db3", ".s3db"];
+const REMOTE_PROTOCOLS = ["http://", "https://", "s3://"];
 
 export function createConnection(input?: string): InstanceType<typeof Bun.SQL> {
   if (!input) {
@@ -11,9 +16,7 @@ export function createConnection(input?: string): InstanceType<typeof Bun.SQL> {
 
   if (
     !input.includes("://") &&
-    (input.endsWith(".db") ||
-      input.endsWith(".sqlite") ||
-      input.endsWith(".sqlite3"))
+    SQLITE_EXTENSIONS.some((ext) => input.endsWith(ext))
   ) {
     return new Bun.SQL(`sqlite://${input}`);
   }
@@ -21,6 +24,22 @@ export function createConnection(input?: string): InstanceType<typeof Bun.SQL> {
   return new Bun.SQL(input);
 }
 
+async function downloadToTmp(url: string): Promise<string> {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download: ${response.status} ${response.statusText}`
+    );
+  }
+
+  const urlPath = new URL(url).pathname;
+  const filename = urlPath.split("/").at(-1) || "downloaded.db";
+  const tmpPath = join(tmpdir(), `dbcat-${Bun.hash(url)}-${filename}`);
+  await Bun.write(tmpPath, response);
+
+  return tmpPath;
+}
+
 export async function getDatabaseName(
   sql: InstanceType<typeof Bun.SQL>
 ): Promise<string | null> {
@@ -164,6 +183,7 @@ function showUsageAndExit(): never {
   console.error("  dbcat ./data.db");
   console.error("  dbcat postgres://user:pass@localhost/mydb");
   console.error("  dbcat mysql://user:pass@localhost/mydb");
+  console.error("  dbcat https://example.com/data.db");
   console.error("");
   console.error("Or set DATABASE_URL environment variable.");
   process.exit(1);
@@ -185,21 +205,46 @@ async function main() {
     showUsageAndExit();
   }
 
+  const isTTY = process.stdout.isTTY;
+  const dim = Bun.enableANSIColors ? "\x1b[2m" : "";
+  const reset = Bun.enableANSIColors ? "\x1b[0m" : "";
+  const bold = Bun.enableANSIColors ? "\x1b[1m" : "";
+  const clearLine = Bun.enableANSIColors ? "\x1b[2K\r" : "";
+
+  // Handle remote URLs pointing to SQLite files
+  let connectionInput = input;
+  if (
+    input &&
+    REMOTE_PROTOCOLS.some((p) => input.startsWith(p)) &&
+    SQLITE_EXTENSIONS.some((ext) => input.endsWith(ext))
+  ) {
+    if (Bun.enableANSIColors && isTTY && !json) {
+      process.stdout.write(`${dim}Downloading SQLite database...${reset}`);
+    }
+    try {
+      connectionInput = `sqlite://${await downloadToTmp(input)}`;
+    } catch (error) {
+      if (Bun.enableANSIColors && isTTY && !json) {
+        process.stdout.write("\n");
+      }
+      console.error("Failed to download:");
+      console.error(error instanceof Error ? error.message : String(error));
+      process.exit(1);
+    }
+    if (Bun.enableANSIColors && isTTY && !json) {
+      process.stdout.write(clearLine);
+    }
+  }
+
   let sql: InstanceType<typeof Bun.SQL>;
   try {
-    sql = createConnection(input);
+    sql = createConnection(connectionInput);
   } catch (error) {
     console.error("Failed to connect:");
     console.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 
-  const isTTY = process.stdout.isTTY;
-  const dim = Bun.enableANSIColors ? "\x1b[2m" : "";
-  const reset = Bun.enableANSIColors ? "\x1b[0m" : "";
-  const bold = Bun.enableANSIColors ? "\x1b[1m" : "";
-  const clearLine = Bun.enableANSIColors ? "\x1b[2K\r" : "";
-
   try {
     const stdinQuery = await readStdin();
 
@@ -258,7 +303,7 @@ async function main() {
     }
   } catch (error) {
     if (Bun.enableANSIColors && isTTY && !json) {
-      process.stdout.write(clearLine);
+      process.stdout.write("\n");
     }
     const message = error instanceof Error ? error.message : String(error);