spiracha 2.1.0 → 2.2.0

package/apps/ui/vite.config.ts

@@ -1,12 +1,17 @@
 import { createReadStream } from 'node:fs';
-import { access, constants } from 'node:fs/promises';
 import path from 'node:path';
 import tailwindcss from '@tailwindcss/vite';
 import { devtools } from '@tanstack/devtools-vite';
 import { tanstackStart } from '@tanstack/react-start/plugin/vite';
 import viteReact from '@vitejs/plugin-react';
 import { defineConfig, type Plugin } from 'vite';
-import { buildUiExportContentDisposition, resolveUiExportFilePathFromRequestPath } from '../../src/lib/ui-export-files';
+import {
+    buildUiExportContentDisposition,
+    resolveReadableUiExportFileFromRequestPath,
+    UI_EXPORT_URL_PREFIX,
+} from '../../src/lib/ui-export-files';
+
+const uiRoot = __dirname;
 
 const getExportContentType = (filePath: string) => {
     if (filePath.endsWith('.zip')) {
@@ -33,17 +38,14 @@ const spirachaExportFiles = (): Plugin => {
                     return;
                 }
 
-                const exportFilePath = resolveUiExportFilePathFromRequestPath(
-                    new URL(req.url, 'http://spiracha.local').pathname,
-                );
-                if (!exportFilePath) {
+                const pathname = new URL(req.url, 'http://spiracha.local').pathname;
+                if (!pathname.startsWith(UI_EXPORT_URL_PREFIX)) {
                     next();
                     return;
                 }
 
-                try {
-                    await access(exportFilePath, constants.R_OK);
-                } catch {
+                const exportFilePath = await resolveReadableUiExportFileFromRequestPath(pathname);
+                if (!exportFilePath) {
                     res.statusCode = 404;
                     res.end('Not Found');
                     return;
@@ -59,7 +61,14 @@ const spirachaExportFiles = (): Plugin => {
                     return;
                 }
 
-                createReadStream(exportFilePath).pipe(res);
+                const stream = createReadStream(exportFilePath);
+                stream.once('error', () => {
+                    if (!res.headersSent) {
+                        res.statusCode = 500;
+                    }
+                    res.end('Internal Server Error');
+                });
+                stream.pipe(res);
             });
         },
         name: 'spiracha-export-files',
@@ -70,13 +79,14 @@ const config = defineConfig({
     plugins: [spirachaExportFiles(), devtools(), tailwindcss(), tanstackStart(), viteReact()],
     resolve: {
         alias: {
-            '@spiracha': path.resolve(__dirname, '..', '..', 'src'),
+            '@spiracha': path.resolve(uiRoot, '..', '..', 'src'),
         },
         tsconfigPaths: true,
     },
+    root: uiRoot,
     server: {
         fs: {
-            allow: [path.resolve(__dirname, '..', '..')],
+            allow: [path.resolve(uiRoot, '..', '..')],
         },
     },
 });

package/bin/spiracha.ts

@@ -14,6 +14,33 @@ export const buildSpirachaDevServerCommand = (packageRoot = resolveSpirachaPacka
     cwd: path.join(packageRoot, 'apps', 'ui'),
 });
 
+type SpirachaChildProcess = {
+    exited: Promise<number>;
+    kill: (signal?: NodeJS.Signals | number) => void;
+};
+
+type SpirachaSignalEmitter = {
+    off: (event: NodeJS.Signals, listener: () => void) => unknown;
+    on: (event: NodeJS.Signals, listener: () => void) => unknown;
+};
+
+export const waitForSpirachaDevServer = async (
+    child: SpirachaChildProcess,
+    signalEmitter: SpirachaSignalEmitter = process,
+): Promise<number> => {
+    const forwardSigint = () => child.kill('SIGINT');
+    const forwardSigterm = () => child.kill('SIGTERM');
+    signalEmitter.on('SIGINT', forwardSigint);
+    signalEmitter.on('SIGTERM', forwardSigterm);
+
+    try {
+        return await child.exited;
+    } finally {
+        signalEmitter.off('SIGINT', forwardSigint);
+        signalEmitter.off('SIGTERM', forwardSigterm);
+    }
+};
+
 export const runSpirachaDevServer = async (): Promise<number> => {
     const command = buildSpirachaDevServerCommand();
     const proc = Bun.spawn([process.execPath, ...command.args], {
@@ -24,7 +51,7 @@ export const runSpirachaDevServer = async (): Promise<number> => {
         stdout: 'inherit',
     });
 
-    return proc.exited;
+    return waitForSpirachaDevServer(proc);
 };
 
 if (import.meta.main) {

package/package.json

@@ -11,7 +11,7 @@
     },
     "dependencies": {
         "@tailwindcss/typography": "0.5.20",
-        "@tailwindcss/vite": "4.3.2",
+        "@tailwindcss/vite": "4.3.3",
         "@tanstack/devtools-vite": "0.8.1",
         "@tanstack/match-sorter-utils": "8.19.4",
         "@tanstack/react-devtools": "0.10.8",
@@ -20,28 +20,37 @@
         "@tanstack/react-router": "1.170.18",
         "@tanstack/react-router-devtools": "1.167.0",
         "@tanstack/react-router-ssr-query": "1.167.1",
-        "@tanstack/react-start": "1.168.28",
+        "@tanstack/react-start": "1.168.30",
         "@tanstack/react-table": "8.21.3",
         "@tanstack/react-virtual": "3.14.6",
-        "@tanstack/router-plugin": "1.168.20",
+        "@tanstack/router-plugin": "1.168.22",
         "@vitejs/plugin-react": "6.0.3",
         "class-variance-authority": "0.7.1",
         "clsx": "2.1.1",
-        "lucide-react": "1.24.0",
+        "fflate": "0.8.3",
+        "lucide-react": "1.25.0",
         "radix-ui": "1.6.2",
         "react": "19.2.7",
         "react-dom": "19.2.7",
         "tailwind-merge": "3.6.0",
-        "tailwindcss": "4.3.2",
+        "tailwindcss": "4.3.3",
         "tw-animate-css": "1.4.0",
-        "vite": "8.1.4",
+        "vite": "8.1.5",
         "zod": "4.4.3"
     },
     "description": "Browse and expose local Codex, Claude Code, Grok, Kiro, Qoder, Cursor, Antigravity, and OpenCode conversation history through a local UI and stable data API.",
     "devDependencies": {
+        "@biomejs/biome": "2.5.4",
+        "@testing-library/dom": "10.4.1",
+        "@testing-library/react": "16.3.2",
         "@types/bun": "^1.3.14",
         "@types/node": "^26.1.1",
-        "typescript": "^7.0.2"
+        "@types/react": "19.2.17",
+        "@types/react-dom": "19.2.3",
+        "@vitest/coverage-v8": "4.1.10",
+        "jsdom": "29.1.1",
+        "typescript": "^7.0.2",
+        "vitest": "4.1.10"
     },
     "engines": {
         "bun": ">=1.3.14"
@@ -63,7 +72,6 @@
     "files": [
         "bin/spiracha.ts",
         "apps/ui/components.json",
-        "apps/ui/package.json",
         "apps/ui/public/**/*",
         "apps/ui/src/**/*",
         "!apps/ui/src/**/*.vitest.ts",
@@ -78,6 +86,9 @@
         "AGENTS.md"
     ],
     "homepage": "https://github.com/ragaeeb/spiracha",
+    "imports": {
+        "#/*": "./apps/ui/src/*"
+    },
     "keywords": [
         "codex",
         "claude",
@@ -100,21 +111,19 @@
         "url": "git+https://github.com/ragaeeb/spiracha.git"
     },
     "scripts": {
-        "build": "bun run typecheck && bun run --cwd apps/ui build",
+        "build": "bun run typecheck && bun --cwd apps/ui --bun vite build",
         "coverage": "bun run coverage:root && bun run coverage:ui",
         "coverage:root": "bun test --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run ./src/coverage-check.ts root",
-        "coverage:ui": "bun run --cwd apps/ui coverage && bun run ./src/coverage-check.ts ui",
+        "coverage:ui": "vitest run --coverage --config apps/ui/vitest.config.ts && bun run ./src/coverage-check.ts ui",
         "format": "biome check . --write && biome lint . --write",
         "lint": "biome check .",
-        "start": "bun run --cwd apps/ui dev",
+        "start": "bun --cwd apps/ui --bun vite dev --host 127.0.0.1 --port 3000",
+        "test:ui": "vitest run --config apps/ui/vitest.config.ts",
         "typecheck": "bun run typecheck:root && bun run typecheck:ui",
         "typecheck:root": "bunx tsc --noEmit",
-        "typecheck:ui": "bun run --cwd apps/ui typecheck",
-        "ui:preview": "bun run --cwd apps/ui preview"
+        "typecheck:ui": "bunx tsc --noEmit -p apps/ui/tsconfig.json",
+        "ui:preview": "bun --cwd apps/ui --bun vite preview"
     },
     "type": "module",
-    "version": "2.1.0",
-    "workspaces": [
-        "apps/*"
-    ]
+    "version": "2.2.0"
 }

package/src/client.ts

@@ -1,3 +1,4 @@
+import { mapWithConcurrency } from './lib/concurrency';
 import {
     deleteConversation as deleteLocalConversation,
     deleteConversations as deleteLocalConversations,
@@ -51,9 +52,11 @@ export type {
 type HttpEnvelope<T> = {
     data?: T;
     error?: {
+        code?: string | null;
         message?: string | null;
     } | null;
     meta?: {
+        has_next?: boolean | null;
         hasNext?: boolean | null;
         nextCursor?: string | null;
         next_cursor?: string | null;
@@ -196,9 +199,22 @@ const fetchJson = async <T>(url: URL, init?: RequestInit): Promise<HttpEnvelope<
     return readJsonEnvelope(response);
 };
 
+const isMissingConversationResponse = async (response: Response): Promise<boolean> => {
+    if (response.status !== 404) {
+        return false;
+    }
+
+    try {
+        const envelope = (await response.clone().json()) as HttpEnvelope<unknown>;
+        return envelope.error?.code === 'conversation_not_found';
+    } catch {
+        return false;
+    }
+};
+
 const fetchJsonOrNull = async <T>(url: URL, init?: RequestInit): Promise<HttpEnvelope<T> | null> => {
     const response = await fetchResponse(url, init);
-    if (response.status === 404) {
+    if (await isMissingConversationResponse(response)) {
         return null;
     }
 
@@ -206,9 +222,30 @@ const fetchJsonOrNull = async <T>(url: URL, init?: RequestInit): Promise<HttpEnv
     return readJsonEnvelope(response);
 };
 
+const fetchDeleteJsonOrNull = async <T>(url: URL, init?: RequestInit): Promise<HttpEnvelope<T> | null> => {
+    const response = await fetchResponse(url, init);
+    if (await isMissingConversationResponse(response)) {
+        return null;
+    }
+
+    if (response.status === 405) {
+        try {
+            const envelope = (await response.clone().json()) as HttpEnvelope<T>;
+            if (envelope.error?.code === 'unsupported_operation') {
+                return null;
+            }
+        } catch {
+            // Let the normal error path report malformed error responses.
+        }
+    }
+
+    await assertOkResponse(response);
+    return readJsonEnvelope(response);
+};
+
 const fetchTextOrNull = async (url: URL, init?: RequestInit): Promise<string | null> => {
     const response = await fetchResponse(url, init);
-    if (response.status === 404) {
+    if (await isMissingConversationResponse(response)) {
         return null;
     }
 
@@ -232,7 +269,7 @@ const fileNameFromContentDisposition = (contentDisposition: string | null, fallb
 
 const fetchZipOrNull = async (url: URL, init?: RequestInit): Promise<ConversationZipDownload | null> => {
     const response = await fetchResponse(url, init);
-    if (response.status === 404) {
+    if (await isMissingConversationResponse(response)) {
         return null;
     }
 
@@ -261,13 +298,20 @@ const normalizePage = (envelope: HttpEnvelope<ConversationDetail[]>): Conversati
     return {
         data,
         meta: {
-            hasNext: envelope.meta?.hasNext === true,
+            hasNext: envelope.meta?.has_next === true || envelope.meta?.hasNext === true,
             nextCursor: envelope.meta?.nextCursor ?? envelope.meta?.next_cursor ?? null,
         },
     };
 };
 
-const makeHttpUrl = (baseUrl: URL, pathname: string): URL => new URL(pathname, baseUrl);
+const makeHttpUrl = (baseUrl: URL, pathname: string): URL => {
+    const url = new URL(baseUrl);
+    const basePath = url.pathname.replace(/\/+$/u, '');
+    url.pathname = `${basePath}/${pathname.replace(/^\/+/, '')}`;
+    url.search = '';
+    url.hash = '';
+    return url;
+};
 
 const rejectHttpLocations = (locations: ConversationDataLocations | undefined): void => {
     if (locations) {
@@ -287,15 +331,16 @@ const exportLocalConversationsZip = async (
     locations: ConversationDataLocations | undefined,
 ) => {
     const options = withDefaultLocations(exportOptions, locations);
-    const conversations = await Promise.all(
-        options.ids.map((id) =>
-            getLocalConversation({
-                id,
-                locations: options.locations,
-                messageSelector: options.messageSelector ?? 'all',
-                source: options.source,
-            }),
-        ),
+    if (options.ids.length > 200) {
+        throw new SpirachaClientError('At most 200 conversation ids may be exported at once.');
+    }
+    const conversations = await mapWithConcurrency(options.ids, 4, (id) =>
+        getLocalConversation({
+            id,
+            locations: options.locations,
+            messageSelector: options.messageSelector ?? 'all',
+            source: options.source,
+        }),
     );
 
     if (conversations.some((conversation) => conversation === null)) {
@@ -346,7 +391,7 @@ const makeHttpClient = (options: HttpConversationClientOptions): ConversationCli
             rejectHttpLocations(deleteOptions.locations);
             const { id, source } = deleteOptions;
             const url = makeHttpUrl(baseUrl, `/api/v1/conversations/${source}/${encodeURIComponent(id)}`);
-            const envelope = await fetchJsonOrNull<DeleteConversationResult>(url, { method: 'DELETE' });
+            const envelope = await fetchDeleteJsonOrNull<DeleteConversationResult>(url, { method: 'DELETE' });
             if (!envelope) {
                 return null;
             }
@@ -354,7 +399,7 @@ const makeHttpClient = (options: HttpConversationClientOptions): ConversationCli
         },
         deleteConversations: async (deleteOptions) => {
             rejectHttpLocations(deleteOptions.locations);
-            const envelope = await fetchJsonOrNull<DeleteConversationsResult>(
+            const envelope = await fetchDeleteJsonOrNull<DeleteConversationsResult>(
                 makeHttpUrl(baseUrl, '/api/v1/conversations/delete'),
                 {
                     body: JSON.stringify({