dbcat 0.0.3 → 0.0.5

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.3",
+  "version": "0.0.5",
   "description": "A simple CLI to view database tables. Supports PostgreSQL, MySQL, and SQLite.",
   "author": "RiskyMH",
   "license": "MIT",

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> {
@@ -53,11 +72,14 @@ export function getAllTables(sql: InstanceType<typeof Bun.SQL>) {
   switch (adapter) {
     case "postgres":
       return sql`
-        SELECT table_name as name 
+        SELECT CASE 
+          WHEN table_schema = 'public' THEN table_name 
+          ELSE table_schema || '.' || table_name 
+        END as name
         FROM information_schema.tables 
-        WHERE table_schema = 'public' 
+        WHERE table_schema NOT IN ('pg_catalog', 'information_schema')
         AND table_type = 'BASE TABLE'
-        ORDER BY table_name
+        ORDER BY table_schema, table_name
       ` as Promise<{ name: string }[]>;
     case "mysql":
     case "mariadb":
@@ -161,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);
@@ -182,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();
 
@@ -255,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);