fix(sqlite): serialize BigInt and BLOBs safely in JSON/CSV export and cell inspector

Author: gerteck

src/tools/SqliteViewer.svelte

@@ -1161,10 +1161,12 @@
                             >
                               {#if cell === null || cell === undefined}
                                 <span class="text-outline/60 italic text-[11px]">NULL</span>
-                              {:else if typeof cell === 'number'}
+                              {:else if typeof cell === 'number' || typeof cell === 'bigint'}
                                 <span class="text-emerald-600 dark:text-emerald-400">{cell}</span>
                               {:else if typeof cell === 'boolean'}
                                 <span class="text-amber-600 dark:text-amber-400">{cell ? 'true' : 'false'}</span>
+                              {:else if cell instanceof Uint8Array}
+                                <span class="text-outline italic text-[11px]">&lt;BLOB {cell.length}B&gt;</span>
                               {:else}
                                 <span class="text-on-surface">{cell}</span>
                               {/if}
@@ -1375,6 +1377,12 @@
                                 >
                                   {#if cell === null || cell === undefined}
                                     <span class="text-outline/60 italic text-[11px]">NULL</span>
+                                  {:else if typeof cell === 'number' || typeof cell === 'bigint'}
+                                    <span class="text-emerald-600 dark:text-emerald-400">{cell}</span>
+                                  {:else if typeof cell === 'boolean'}
+                                    <span class="text-amber-600 dark:text-amber-400">{cell ? 'true' : 'false'}</span>
+                                  {:else if cell instanceof Uint8Array}
+                                    <span class="text-outline italic text-[11px]">&lt;BLOB {cell.length}B&gt;</span>
                                   {:else}
                                     <span>{cell}</span>
                                   {/if}
@@ -1822,7 +1830,13 @@
           </div>
           <div class="flex items-center gap-2">
             <button
-              onclick={() => copyText(String(cellModalContent?.val))}
+              onclick={() => {
+                if (cellModalContent?.val instanceof Uint8Array) {
+                  copyText(Array.from(cellModalContent.val).map((b) => b.toString(16).padStart(2, '0')).join(''));
+                } else {
+                  copyText(String(cellModalContent?.val ?? ''));
+                }
+              }}
               class="flex items-center gap-1 px-2 py-0.5 rounded border border-outline-variant hover:bg-surface-container text-on-surface-variant cursor-pointer text-[11px]"
             >
               {#if copied}
@@ -1842,7 +1856,18 @@
           </div>
         </div>
         <div class="p-4 max-h-[60vh] overflow-y-auto text-xs whitespace-pre-wrap select-text leading-relaxed">
-          {cellModalContent.val === null ? 'NULL' : cellModalContent.val}
+          {#if cellModalContent.val === null || cellModalContent.val === undefined}
+            <span class="text-outline/60 italic">NULL</span>
+          {:else if cellModalContent.val instanceof Uint8Array}
+            <div class="space-y-2">
+              <div class="text-[11px] text-outline font-semibold">BLOB ({cellModalContent.val.length} bytes) — Hex dump:</div>
+              <div class="p-2.5 bg-surface-container rounded border border-outline-variant break-all font-mono">
+                {Array.from(cellModalContent.val).map((b) => b.toString(16).padStart(2, '0')).join(' ')}
+              </div>
+            </div>
+          {:else}
+            {cellModalContent.val}
+          {/if}
         </div>
       </div>
     </div>

src/utils/sqliteEngine.ts

@@ -1,5 +1,13 @@
 import sqlite3InitModule from '@sqlite.org/sqlite-wasm';
 
+// Ensure BigInt values serialize properly in JSON.stringify without throwing TypeError
+if (typeof BigInt !== 'undefined' && !(BigInt.prototype as any).toJSON) {
+  (BigInt.prototype as any).toJSON = function () {
+    const n = Number(this);
+    return Number.isSafeInteger(n) ? n : this.toString();
+  };
+}
+
 export interface TableColumnInfo {
   cid: number;
   name: string;
@@ -720,8 +728,14 @@ export class SqliteEngine {
   static toCsv(columns: string[], rows: any[][]): string {
     const escapeCell = (val: any) => {
       if (val === null || val === undefined) return '';
+      if (typeof val === 'bigint') return val.toString();
+      if (val instanceof Uint8Array) {
+        return Array.from(val)
+          .map((b) => b.toString(16).padStart(2, '0'))
+          .join('');
+      }
       const str = String(val);
-      if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+      if (str.includes(',') || str.includes('"') || str.includes('\n') || str.includes('\r')) {
         return `"${str.replace(/"/g, '""')}"`;
       }
       return str;
@@ -743,7 +757,25 @@ export class SqliteEngine {
       });
       return obj;
     });
-    return JSON.stringify(objects, null, 2);
+    return JSON.stringify(
+      objects,
+      (_key, value) => {
+        if (typeof value === 'bigint') {
+          // If within JS safe integer range, serialize as number so JSON parsers read it as number
+          if (value <= BigInt(Number.MAX_SAFE_INTEGER) && value >= BigInt(Number.MIN_SAFE_INTEGER)) {
+            return Number(value);
+          }
+          return value.toString();
+        }
+        if (value instanceof Uint8Array) {
+          return Array.from(value)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+        }
+        return value;
+      },
+      2
+    );
   }
 
   /**
@@ -756,8 +788,11 @@ export class SqliteEngine {
     const lines = rows.map((row) => {
       const vals = row.map((v) => {
         if (v === null || v === undefined) return 'NULL';
-        if (typeof v === 'number') return v;
+        if (typeof v === 'number' || typeof v === 'bigint') return v.toString();
         if (typeof v === 'boolean') return v ? 1 : 0;
+        if (v instanceof Uint8Array) {
+          return `X'${Array.from(v).map((b) => b.toString(16).padStart(2, '0')).join('')}'`;
+        }
         return `'${String(v).replace(/'/g, "''")}'`;
       });
       return `INSERT INTO "${tableName}" (${colList}) VALUES (${vals.join(', ')});`;