@mariozechner/pi-web-ui 0.5.44 → 0.5.46

package/dist/prompts/prompts.js

@@ -0,0 +1,272 @@
+/**
+ * Centralized tool prompts/descriptions.
+ * Each prompt is either a string constant or a template function.
+ */
+// ============================================================================
+// JavaScript REPL Tool
+// ============================================================================
+export const JAVASCRIPT_REPL_TOOL_DESCRIPTION = (runtimeProviderDescriptions) => `# JavaScript REPL
+
+## Purpose
+Execute JavaScript code in a sandboxed browser environment with full Web APIs.
+
+## When to Use
+- Quick calculations or data transformations
+- Testing JavaScript code snippets in isolation
+- Processing data with libraries (XLSX, CSV, etc.)
+- Creating artifacts from data
+
+## Environment
+- ES2023+ JavaScript (async/await, optional chaining, nullish coalescing, etc.)
+- All browser APIs: DOM, Canvas, WebGL, Fetch, Web Workers, WebSockets, Crypto, etc.
+- Import any npm package: await import('https://esm.run/package-name')
+
+## Common Libraries
+- XLSX: const XLSX = await import('https://esm.run/xlsx');
+- CSV: const Papa = (await import('https://esm.run/papaparse')).default;
+- Chart.js: const Chart = (await import('https://esm.run/chart.js/auto')).default;
+- Three.js: const THREE = await import('https://esm.run/three');
+
+## Persistence between tool calls
+- Objects stored on global scope do not persist between calls.
+- Use artifacts as a key-value JSON object store:
+  - Use createOrUpdateArtifact(filename, content) to persist data between calls. JSON objects are auto-stringified.
+  - Use listArtifacts() and getArtifact(filename) to read persisted data. JSON files are auto-parsed to objects.
+  - Prefer to use a single artifact throughout the session to store intermediate data (e.g. 'data.json').
+
+## Input
+- You have access to the user's attachments via listAttachments(), readTextAttachment(id), and readBinaryAttachment(id)
+- You have access to previously created artifacts via listArtifacts() and getArtifact(filename)
+
+## Output
+- All console.log() calls are captured for you to inspect. The user does not see these logs.
+- Create artifacts for file results (images, JSON, CSV, etc.) which persiste throughout the
+  session and are accessible to you and the user.
+
+## Example
+const data = [10, 20, 15, 25];
+const sum = data.reduce((a, b) => a + b, 0);
+const avg = sum / data.length;
+console.log('Sum:', sum, 'Average:', avg);
+
+## Important Notes
+- Graphics: Use fixed dimensions (800x600), NOT window.innerWidth/Height
+- Chart.js: Set options: { responsive: false, animation: false }
+- Three.js: renderer.setSize(800, 600) with matching aspect ratio
+
+## Helper Functions (Automatically Available)
+
+These functions are injected into the execution environment and available globally:
+
+${runtimeProviderDescriptions.join("\n\n")}
+`;
+// ============================================================================
+// Artifacts Tool
+// ============================================================================
+export const ARTIFACTS_TOOL_DESCRIPTION = (runtimeProviderDescriptions) => `# Artifacts
+
+Create and manage persistent files that live alongside the conversation.
+
+## When to Use - Artifacts Tool vs REPL
+
+**Use artifacts tool when YOU are the author:**
+- Writing research summaries, analysis, ideas, documentation
+- Creating markdown notes for user to read
+- Building HTML applications/visualizations that present data
+- Creating HTML artifacts that render charts from programmatically generated data
+
+**Use repl + artifact storage functions when CODE processes data:**
+- Scraping workflows that extract and store data
+- Processing CSV/Excel files programmatically
+- Data transformation pipelines
+- Binary file generation requiring libraries (PDF, DOCX)
+
+**Pattern: REPL generates data → Artifacts tool creates HTML that visualizes it**
+Example: repl scrapes products → stores products.json → you author dashboard.html that reads products.json and renders Chart.js visualizations
+
+## Input
+- { action: "create", filename: "notes.md", content: "..." } - Create new file
+- { action: "update", filename: "notes.md", old_str: "...", new_str: "..." } - Update part of file (PREFERRED)
+- { action: "rewrite", filename: "notes.md", content: "..." } - Replace entire file (LAST RESORT)
+- { action: "get", filename: "data.json" } - Retrieve file content
+- { action: "delete", filename: "old.csv" } - Delete file
+- { action: "htmlArtifactLogs", filename: "app.html" } - Get console logs from HTML artifact
+
+## Returns
+Depends on action:
+- create/update/rewrite/delete: Success status or error
+- get: File content
+- htmlArtifactLogs: Console logs and errors
+
+## Supported File Types
+✅ Text-based files you author: .md, .txt, .html, .js, .css, .json, .csv, .svg
+❌ Binary files requiring libraries (use repl): .pdf, .docx
+
+## Critical - Prefer Update Over Rewrite
+❌ NEVER: get entire file + rewrite to change small sections
+✅ ALWAYS: update for targeted edits (token efficient)
+✅ Ask: Can I describe the change as old_str → new_str? Use update.
+
+---
+
+## HTML Artifacts
+
+Interactive HTML applications that can visualize data from other artifacts.
+
+### Data Access
+- Can read artifacts created by repl and user attachments
+- Use to build dashboards, visualizations, interactive tools
+- See Helper Functions section below for available functions
+
+### Requirements
+- Self-contained single file
+- Import ES modules from esm.sh: <script type="module">import X from 'https://esm.sh/pkg';</script>
+- Use Tailwind CDN: <script src="https://cdn.tailwindcss.com"></script>
+- Can embed images from any domain: <img src="https://example.com/image.jpg">
+- MUST set background color explicitly (avoid transparent)
+- Inline CSS or Tailwind utility classes
+- No localStorage/sessionStorage
+
+### Styling
+- Use Tailwind utility classes for clean, functional designs
+- Ensure responsive layout (iframe may be resized)
+- Avoid purple gradients, AI aesthetic clichés, and emojis
+
+### Helper Functions (Automatically Available)
+
+These functions are injected into HTML artifact sandbox:
+
+${runtimeProviderDescriptions.join("\n\n")}
+`;
+// ============================================================================
+// Artifacts Runtime Provider
+// ============================================================================
+export const ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RW = `
+### Artifacts Storage
+
+Create, read, update, and delete files in artifacts storage.
+
+#### When to Use
+- Store intermediate results between tool calls
+- Save generated files (images, CSVs, processed data) for user to view and download
+
+#### Do NOT Use For
+- Content you author directly, like summaries of content you read (use artifacts tool instead)
+
+#### Functions
+- listArtifacts() - List all artifact filenames, returns Promise<string[]>
+- getArtifact(filename) - Read artifact content, returns Promise<string | object>. JSON files auto-parse to objects, binary files return base64 string
+- createOrUpdateArtifact(filename, content, mimeType?) - Create or update artifact, returns Promise<void>. JSON files auto-stringify objects, binary requires base64 string with mimeType
+- deleteArtifact(filename) - Delete artifact, returns Promise<void>
+
+#### Example
+JSON workflow:
+\`\`\`javascript
+// Fetch and save
+const response = await fetch('https://api.example.com/products');
+const products = await response.json();
+await createOrUpdateArtifact('products.json', products);
+
+// Later: read and filter
+const all = await getArtifact('products.json');
+const cheap = all.filter(p => p.price < 100);
+await createOrUpdateArtifact('cheap.json', cheap);
+\`\`\`
+
+Binary file (image):
+\`\`\`javascript
+const canvas = document.createElement('canvas');
+canvas.width = 800; canvas.height = 600;
+const ctx = canvas.getContext('2d');
+ctx.fillStyle = 'blue';
+ctx.fillRect(0, 0, 800, 600);
+// Remove data:image/png;base64, prefix
+const base64 = canvas.toDataURL().split(',')[1];
+await createOrUpdateArtifact('chart.png', base64, 'image/png');
+\`\`\`
+`;
+export const ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RO = `
+### Artifacts Storage
+
+Read files from artifacts storage.
+
+#### When to Use
+- Read artifacts created by REPL or artifacts tool
+- Access data from other HTML artifacts
+- Load configuration or data files
+
+#### Do NOT Use For
+- Creating new artifacts (not available in HTML artifacts)
+- Modifying artifacts (read-only access)
+
+#### Functions
+- listArtifacts() - List all artifact filenames, returns Promise<string[]>
+- getArtifact(filename) - Read artifact content, returns Promise<string | object>. JSON files auto-parse to objects, binary files return base64 string
+
+#### Example
+JSON data:
+\`\`\`javascript
+const products = await getArtifact('products.json');
+const html = products.map(p => \`<div>\${p.name}: $\${p.price}</div>\`).join('');
+document.body.innerHTML = html;
+\`\`\`
+
+Binary image:
+\`\`\`javascript
+const base64 = await getArtifact('chart.png');
+const img = document.createElement('img');
+img.src = 'data:image/png;base64,' + base64;
+document.body.appendChild(img);
+\`\`\`
+`;
+// ============================================================================
+// Attachments Runtime Provider
+// ============================================================================
+export const ATTACHMENTS_RUNTIME_DESCRIPTION = `
+### User Attachments
+
+Read files the user uploaded to the conversation.
+
+#### When to Use
+- Process user-uploaded files (CSV, JSON, Excel, images, PDFs)
+
+#### Functions
+- listAttachments() - List all attachments, returns array of {id, fileName, mimeType, size}
+- readTextAttachment(id) - Read attachment as text, returns string
+- readBinaryAttachment(id) - Read attachment as binary data, returns Uint8Array
+
+#### Example
+CSV file:
+\`\`\`javascript
+const files = listAttachments();
+const csvFile = files.find(f => f.fileName.endsWith('.csv'));
+const csvData = readTextAttachment(csvFile.id);
+const rows = csvData.split('\\n').map(row => row.split(','));
+\`\`\`
+
+Excel file:
+\`\`\`javascript
+const XLSX = await import('https://esm.run/xlsx');
+const files = listAttachments();
+const xlsxFile = files.find(f => f.fileName.endsWith('.xlsx'));
+const bytes = readBinaryAttachment(xlsxFile.id);
+const workbook = XLSX.read(bytes);
+const data = XLSX.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]]);
+\`\`\`
+`;
+// ============================================================================
+// Extract Document Tool
+// ============================================================================
+export const EXTRACT_DOCUMENT_DESCRIPTION = `# Extract Document
+
+Extract plain text from documents on the web (PDF, DOCX, XLSX, PPTX).
+
+## When to Use
+User wants you to read a document at a URL.
+
+## Input
+- { url: "https://example.com/document.pdf" } - URL to PDF, DOCX, XLSX, or PPTX
+
+## Returns
+Structured plain text with page/sheet/slide delimiters.`;
+//# sourceMappingURL=prompts.js.map

package/dist/prompts/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/prompts/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,2BAAqC,EAAE,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDzF,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC;CACzC,CAAC;AAEF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,2BAAqC,EAAE,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyEnF,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC;CACzC,CAAC;AAEF,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,yCAAyC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CxD,CAAC;AAEF,MAAM,CAAC,MAAM,yCAAyC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCxD,CAAC;AAEF,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B9C,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;wDAWY,CAAC"}

package/dist/storage/app-storage.d.ts

@@ -1,14 +1,23 @@
-import { ProviderKeysRepository } from "./repositories/provider-keys-repository.js";
-import { SettingsRepository } from "./repositories/settings-repository.js";
-import type { AppStorageConfig } from "./types.js";
+import type { ProviderKeysStore } from "./stores/provider-keys-store.js";
+import type { SessionsStore } from "./stores/sessions-store.js";
+import type { SettingsStore } from "./stores/settings-store.js";
+import type { StorageBackend } from "./types.js";
 /**
- * High-level storage API aggregating all repositories.
- * Apps configure backends and use repositories through this interface.
+ * High-level storage API providing access to all storage operations.
+ * Subclasses can extend this to add domain-specific stores.
  */
 export declare class AppStorage {
-    readonly settings: SettingsRepository;
-    readonly providerKeys: ProviderKeysRepository;
-    constructor(config?: AppStorageConfig);
+    readonly backend: StorageBackend;
+    readonly settings: SettingsStore;
+    readonly providerKeys: ProviderKeysStore;
+    readonly sessions: SessionsStore;
+    constructor(settings: SettingsStore, providerKeys: ProviderKeysStore, sessions: SessionsStore, backend: StorageBackend);
+    getQuotaInfo(): Promise<{
+        usage: number;
+        quota: number;
+        percent: number;
+    }>;
+    requestPersistence(): Promise<boolean>;
 }
 /**
  * Get the global AppStorage instance.
@@ -19,8 +28,4 @@ export declare function getAppStorage(): AppStorage;
  * Set the global AppStorage instance.
  */
 export declare function setAppStorage(storage: AppStorage): void;
-/**
- * Initialize AppStorage with default configuration if not already set.
- */
-export declare function initAppStorage(config?: AppStorageConfig): AppStorage;
 //# sourceMappingURL=app-storage.d.ts.map

package/dist/storage/app-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-storage.d.ts","sourceRoot":"","sources":["../../src/storage/app-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,qBAAa,UAAU;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;gBAElC,MAAM,GAAE,gBAAqB;CAQzC;AAKD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CAKxE"}
+{"version":3,"file":"app-storage.d.ts","sourceRoot":"","sources":["../../src/storage/app-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,qBAAa,UAAU;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBAGhC,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,cAAc;IAQlB,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1E,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5C;AAKD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEvD"}

package/dist/storage/app-storage.js

@@ -1,17 +1,19 @@
-import { LocalStorageBackend } from "./backends/local-storage-backend.js";
-import { ProviderKeysRepository } from "./repositories/provider-keys-repository.js";
-import { SettingsRepository } from "./repositories/settings-repository.js";
 /**
- * High-level storage API aggregating all repositories.
- * Apps configure backends and use repositories through this interface.
+ * High-level storage API providing access to all storage operations.
+ * Subclasses can extend this to add domain-specific stores.
  */
 export class AppStorage {
-    constructor(config = {}) {
-        // Use LocalStorage with prefixes as defaults
-        const settingsBackend = config.settings ?? new LocalStorageBackend("settings");
-        const providerKeysBackend = config.providerKeys ?? new LocalStorageBackend("providerKeys");
-        this.settings = new SettingsRepository(settingsBackend);
-        this.providerKeys = new ProviderKeysRepository(providerKeysBackend);
+    constructor(settings, providerKeys, sessions, backend) {
+        this.settings = settings;
+        this.providerKeys = providerKeys;
+        this.sessions = sessions;
+        this.backend = backend;
+    }
+    async getQuotaInfo() {
+        return this.backend.getQuotaInfo();
+    }
+    async requestPersistence() {
+        return this.backend.requestPersistence();
     }
 }
 // Global instance management
@@ -32,13 +34,4 @@ export function getAppStorage() {
 export function setAppStorage(storage) {
     globalAppStorage = storage;
 }
-/**
- * Initialize AppStorage with default configuration if not already set.
- */
-export function initAppStorage(config = {}) {
-    if (!globalAppStorage) {
-        globalAppStorage = new AppStorage(config);
-    }
-    return globalAppStorage;
-}
 //# sourceMappingURL=app-storage.js.map

package/dist/storage/app-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-storage.js","sourceRoot":"","sources":["../../src/storage/app-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E;;;GAGG;AACH,MAAM,OAAO,UAAU;IAItB,YAAY,SAA2B,EAAE;QACxC,6CAA6C;QAC7C,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC/E,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAE3F,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IACrE,CAAC;CACD;AAED,6BAA6B;AAC7B,IAAI,gBAAgB,GAAsB,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAChD,gBAAgB,GAAG,OAAO,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAA2B,EAAE;IAC3D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,gBAAgB,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC"}
+{"version":3,"file":"app-storage.js","sourceRoot":"","sources":["../../src/storage/app-storage.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,UAAU;IAMtB,YACC,QAAuB,EACvB,YAA+B,EAC/B,QAAuB,EACvB,OAAuB;QAEvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,YAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,kBAAkB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAC1C,CAAC;CACD;AAED,6BAA6B;AAC7B,IAAI,gBAAgB,GAAsB,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAChD,gBAAgB,GAAG,OAAO,CAAC;AAC5B,CAAC"}

package/dist/storage/backends/indexeddb-storage-backend.d.ts

@@ -0,0 +1,27 @@
+import type { IndexedDBConfig, StorageBackend, StorageTransaction } from "../types.js";
+/**
+ * IndexedDB implementation of StorageBackend.
+ * Provides multi-store key-value storage with transactions and quota management.
+ */
+export declare class IndexedDBStorageBackend implements StorageBackend {
+    private config;
+    private dbPromise;
+    constructor(config: IndexedDBConfig);
+    private getDB;
+    private promisifyRequest;
+    get<T = unknown>(storeName: string, key: string): Promise<T | null>;
+    set<T = unknown>(storeName: string, key: string, value: T): Promise<void>;
+    delete(storeName: string, key: string): Promise<void>;
+    keys(storeName: string, prefix?: string): Promise<string[]>;
+    getAllFromIndex<T = unknown>(storeName: string, indexName: string, direction?: "asc" | "desc"): Promise<T[]>;
+    clear(storeName: string): Promise<void>;
+    has(storeName: string, key: string): Promise<boolean>;
+    transaction<T>(storeNames: string[], mode: "readonly" | "readwrite", operation: (tx: StorageTransaction) => Promise<T>): Promise<T>;
+    getQuotaInfo(): Promise<{
+        usage: number;
+        quota: number;
+        percent: number;
+    }>;
+    requestPersistence(): Promise<boolean>;
+}
+//# sourceMappingURL=indexeddb-storage-backend.d.ts.map

package/dist/storage/backends/indexeddb-storage-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-storage-backend.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/indexeddb-storage-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEvF;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAGjD,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,SAAS,CAAqC;gBAElC,MAAM,EAAE,eAAe;YAE7B,KAAK;IAoCnB,OAAO,CAAC,gBAAgB;IAOlB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAQnE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAazE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgB3D,eAAe,CAAC,CAAC,GAAG,OAAO,EAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,KAAK,GAAG,MAAc,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;IAwBT,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD,WAAW,CAAC,CAAC,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,UAAU,GAAG,WAAW,EAC9B,SAAS,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC;IA6BP,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAY1E,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;CAM5C"}

package/dist/storage/backends/indexeddb-storage-backend.js

@@ -0,0 +1,166 @@
+/**
+ * IndexedDB implementation of StorageBackend.
+ * Provides multi-store key-value storage with transactions and quota management.
+ */
+export class IndexedDBStorageBackend {
+    constructor(config) {
+        this.config = config;
+        this.dbPromise = null;
+    }
+    async getDB() {
+        if (!this.dbPromise) {
+            this.dbPromise = new Promise((resolve, reject) => {
+                const request = indexedDB.open(this.config.dbName, this.config.version);
+                request.onerror = () => reject(request.error);
+                request.onsuccess = () => resolve(request.result);
+                request.onupgradeneeded = (_event) => {
+                    const db = request.result;
+                    // Create object stores from config
+                    for (const storeConfig of this.config.stores) {
+                        if (!db.objectStoreNames.contains(storeConfig.name)) {
+                            const store = db.createObjectStore(storeConfig.name, {
+                                keyPath: storeConfig.keyPath,
+                                autoIncrement: storeConfig.autoIncrement,
+                            });
+                            // Create indices
+                            if (storeConfig.indices) {
+                                for (const indexConfig of storeConfig.indices) {
+                                    store.createIndex(indexConfig.name, indexConfig.keyPath, {
+                                        unique: indexConfig.unique,
+                                    });
+                                }
+                            }
+                        }
+                    }
+                };
+            });
+        }
+        return this.dbPromise;
+    }
+    promisifyRequest(request) {
+        return new Promise((resolve, reject) => {
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    async get(storeName, key) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readonly");
+        const store = tx.objectStore(storeName);
+        const result = await this.promisifyRequest(store.get(key));
+        return result ?? null;
+    }
+    async set(storeName, key, value) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readwrite");
+        const store = tx.objectStore(storeName);
+        // If store has keyPath, only pass value (in-line key)
+        // Otherwise pass both value and key (out-of-line key)
+        if (store.keyPath) {
+            await this.promisifyRequest(store.put(value));
+        }
+        else {
+            await this.promisifyRequest(store.put(value, key));
+        }
+    }
+    async delete(storeName, key) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readwrite");
+        const store = tx.objectStore(storeName);
+        await this.promisifyRequest(store.delete(key));
+    }
+    async keys(storeName, prefix) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readonly");
+        const store = tx.objectStore(storeName);
+        if (prefix) {
+            // Use IDBKeyRange for efficient prefix filtering
+            const range = IDBKeyRange.bound(prefix, prefix + "\uffff", false, false);
+            const keys = await this.promisifyRequest(store.getAllKeys(range));
+            return keys.map((k) => String(k));
+        }
+        else {
+            const keys = await this.promisifyRequest(store.getAllKeys());
+            return keys.map((k) => String(k));
+        }
+    }
+    async getAllFromIndex(storeName, indexName, direction = "asc") {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readonly");
+        const store = tx.objectStore(storeName);
+        const index = store.index(indexName);
+        return new Promise((resolve, reject) => {
+            const results = [];
+            const request = index.openCursor(null, direction === "desc" ? "prev" : "next");
+            request.onsuccess = () => {
+                const cursor = request.result;
+                if (cursor) {
+                    results.push(cursor.value);
+                    cursor.continue();
+                }
+                else {
+                    resolve(results);
+                }
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    async clear(storeName) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readwrite");
+        const store = tx.objectStore(storeName);
+        await this.promisifyRequest(store.clear());
+    }
+    async has(storeName, key) {
+        const db = await this.getDB();
+        const tx = db.transaction(storeName, "readonly");
+        const store = tx.objectStore(storeName);
+        const result = await this.promisifyRequest(store.getKey(key));
+        return result !== undefined;
+    }
+    async transaction(storeNames, mode, operation) {
+        const db = await this.getDB();
+        const idbTx = db.transaction(storeNames, mode);
+        const storageTx = {
+            get: async (storeName, key) => {
+                const store = idbTx.objectStore(storeName);
+                const result = await this.promisifyRequest(store.get(key));
+                return (result ?? null);
+            },
+            set: async (storeName, key, value) => {
+                const store = idbTx.objectStore(storeName);
+                // If store has keyPath, only pass value (in-line key)
+                // Otherwise pass both value and key (out-of-line key)
+                if (store.keyPath) {
+                    await this.promisifyRequest(store.put(value));
+                }
+                else {
+                    await this.promisifyRequest(store.put(value, key));
+                }
+            },
+            delete: async (storeName, key) => {
+                const store = idbTx.objectStore(storeName);
+                await this.promisifyRequest(store.delete(key));
+            },
+        };
+        return operation(storageTx);
+    }
+    async getQuotaInfo() {
+        if (navigator.storage?.estimate) {
+            const estimate = await navigator.storage.estimate();
+            return {
+                usage: estimate.usage || 0,
+                quota: estimate.quota || 0,
+                percent: estimate.quota ? ((estimate.usage || 0) / estimate.quota) * 100 : 0,
+            };
+        }
+        return { usage: 0, quota: 0, percent: 0 };
+    }
+    async requestPersistence() {
+        if (navigator.storage?.persist) {
+            return await navigator.storage.persist();
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=indexeddb-storage-backend.js.map

package/dist/storage/backends/indexeddb-storage-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-storage-backend.js","sourceRoot":"","sources":["../../../src/storage/backends/indexeddb-storage-backend.ts"],"names":[],"mappings":"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"}

package/dist/storage/store.d.ts

@@ -0,0 +1,23 @@
+import type { StorageBackend, StoreConfig } from "./types.js";
+/**
+ * Base class for all storage stores.
+ * Each store defines its IndexedDB schema and provides domain-specific methods.
+ */
+export declare abstract class Store {
+    private backend;
+    /**
+     * Returns the IndexedDB configuration for this store.
+     * Defines store name, key path, and indices.
+     */
+    abstract getConfig(): StoreConfig;
+    /**
+     * Sets the storage backend. Called by AppStorage after backend creation.
+     */
+    setBackend(backend: StorageBackend): void;
+    /**
+     * Gets the storage backend. Throws if backend not set.
+     * Concrete stores must use this to access the backend.
+     */
+    protected getBackend(): StorageBackend;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/storage/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/storage/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,8BAAsB,KAAK;IAC1B,OAAO,CAAC,OAAO,CAA+B;IAE9C;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,WAAW;IAEjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC;;;OAGG;IACH,SAAS,CAAC,UAAU,IAAI,cAAc;CAMtC"}

package/dist/storage/store.js

@@ -0,0 +1,26 @@
+/**
+ * Base class for all storage stores.
+ * Each store defines its IndexedDB schema and provides domain-specific methods.
+ */
+export class Store {
+    constructor() {
+        this.backend = null;
+    }
+    /**
+     * Sets the storage backend. Called by AppStorage after backend creation.
+     */
+    setBackend(backend) {
+        this.backend = backend;
+    }
+    /**
+     * Gets the storage backend. Throws if backend not set.
+     * Concrete stores must use this to access the backend.
+     */
+    getBackend() {
+        if (!this.backend) {
+            throw new Error(`Backend not set on ${this.constructor.name}`);
+        }
+        return this.backend;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/storage/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/storage/store.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAgB,KAAK;IAA3B;QACS,YAAO,GAA0B,IAAI,CAAC;IAyB/C,CAAC;IAjBA;;OAEG;IACH,UAAU,CAAC,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED;;;OAGG;IACO,UAAU;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;CACD"}