Remove localstorage driver and references

Remove the @objectql/driver-localstorage package and associated docs/tests. Deleted package files (src, tests, README, CHANGELOG, package.json, tsconfig) under packages/drivers/localstorage and removed driver from docs metadata. Updated documentation and guides to reflect 6 drivers (removed LocalStorage references), adjusted performance guide and getting-started/index pages, and updated examples to use MemoryDriver only (index.html, package.json, vite.config.js). Work plan updated to mark the localstorage issue resolved and note persistence deferred to a future IndexedDB driver. Minor config/lockfile updates included.

Author: hotlong

content/docs/drivers/localstorage.mdx

@@ -5,7 +5,6 @@
     "sql",
     "mongodb",
     "memory",
-    "localstorage",
     "fs",
     "excel",
     "redis",

content/docs/drivers/meta.json

@@ -221,7 +221,6 @@ ObjectQL ships with 7 drivers. The default `starter` template uses SQLite, but s
 | **SQL** (PostgreSQL, MySQL, SQLite) | Production apps | `@objectql/driver-sql` |
 | **MongoDB** | Document-oriented data | `@objectql/driver-mongo` |
 | **Memory** | Testing, prototyping | `@objectql/driver-memory` |
-| **LocalStorage** | Browser/offline apps | `@objectql/driver-localstorage` |
 | **File System** | Embedded/config storage | `@objectql/driver-fs` |
 | **Excel** | Data import/export | `@objectql/driver-excel` |
 | **Redis** | Caching layer | `@objectql/driver-redis` |

content/docs/getting-started/index.mdx

@@ -56,7 +56,7 @@ From this single file, ObjectQL automatically generates:
 
 ### Production-Ready
 
-- **7 Database Drivers** — SQL (PostgreSQL, MySQL, SQLite), MongoDB, Memory, LocalStorage, File System, Excel, Redis
+- **6 Database Drivers** — SQL (PostgreSQL, MySQL, SQLite), MongoDB, Memory, File System, Excel, Redis
 - **4 API Protocols** — REST, GraphQL, OData V4, JSON-RPC — auto-generated from your schema
 - **Validation Engine** — Field-level, cross-field, and state machine validation
 - **Formula Engine** — Computed fields with JavaScript expressions and dependency tracking

content/docs/index.mdx

@@ -704,55 +704,6 @@ const app = new ObjectQL({
 });
 
 // Data persists in browser memory until page refresh
-// For persistent storage, use LocalStorage driver
-```
-
----
-
-## LocalStorage Driver
-
-Browser-based persistent storage using localStorage API.
-
-### Configuration
-
-```typescript
-import { LocalStorageDriver } from '@objectql/driver-localstorage';
-
-const driver = new LocalStorageDriver({
-  prefix: 'myapp_',  // Key prefix in localStorage
-  compress: true,    // Compress data (saves space)
-  encrypt: false     // Optional encryption
-});
-```
-
-### Storage Limits
-
-| Browser | Limit |
-|---------|-------|
-| Chrome | 10MB |
-| Firefox | 10MB |
-| Safari | 5MB |
-| Edge | 10MB |
-
-**Check available space**:
-
-```typescript
-const quota = await navigator.storage.estimate();
-console.log(`Used: ${quota.usage}, Available: ${quota.quota}`);
-```
-
-### Performance Tips
-
-1. **Minimize data stored**: Only store essential fields
-2. **Use compression**: Enable `compress: true`
-3. **Batch updates**: Group multiple operations
-4. **Clear old data**: Remove stale records periodically
-
-```typescript
-// Clear old sessions
-await driver.deleteMany('sessions', [
-  ['expires_at', '<', new Date()]
-]);
 ```
 
 ---
@@ -902,7 +853,7 @@ Choose the right driver for your use case:
 | Real-time apps | Redis | In-memory speed, pub/sub |
 | Unit tests | Memory | Fast, no setup, clean slate |
 | Serverless/Edge | Memory | No external dependencies |
-| Browser apps | LocalStorage | Persistent client-side storage |
+| Browser apps | Memory | Client-side storage, no persistence |
 | Mobile apps | SQLite (SQL Driver) | Embedded, reliable |
 | Analytics | PostgreSQL | Advanced aggregations, window functions |
 | Session store | Redis | TTL, fast access |

content/docs/performance/driver-optimization.mdx

@@ -216,7 +216,7 @@ Package removed in B3.
 | ISS-008 | ✅ Resolved | `plugin-security` | Test coverage expanded (1→6 files, 13→136 tests) |
 | ISS-009 | ✅ Resolved | `plugin-validator` | TODO stubs implemented with tests |
 | ISS-010 | ✅ Resolved | `cli` | Version sourced from package.json; CLI scope delegated to @objectstack/cli |
-| ISS-011 | 🟡 Medium | `localstorage` | Compression feature flagged but unimplemented |
+| ISS-011 | ✅ Resolved | `localstorage` | Package removed — `driver-memory` sufficient for demos; browser persistence deferred to future `driver-indexeddb` |
 | ISS-012 | ✅ Resolved | `protocol-rest` | Ghost project reference in root `tsconfig.json` caused Vite to fail when parsing projects — removed reference |
 | ISS-013 | ✅ Resolved | `platform-node` | Cross-layer tsconfig references removed |
 | ISS-014 | ✅ Resolved | All packages | `exports` field added to 17 packages |

docs/WORK_PLAN_2026_Q1.md

@@ -199,48 +199,26 @@ <h2>📝 Your Notes</h2>
 
         <div class="demo-card">
             <h2>🖥️ Console Output</h2>
-            <div id="output">Initializing ObjectQL with LocalStorage...
+            <div id="output">Initializing ObjectQL with Memory Driver...
 </div>
         </div>
     </div>
 
     <script type="module">
         import { ObjectQL } from '@objectql/core';
-        import { LocalStorageDriver } from '@objectql/driver-localstorage';
         import { MemoryDriver } from '@objectql/driver-memory';
 
         // Global variables
         window.app = null;
         window.driver = null;
         window.noteRepo = null;
-        window.currentDriverType = 'localstorage'; // Default
-
-        window.switchDriver = async function(type) {
-             if (type === window.currentDriverType) return;
-             if (!confirm('Switching drivers will reload the app. Continue?')) {
-                 document.getElementById('driverSelect').value = window.currentDriverType;
-                 return;
-             }
-             window.currentDriverType = type;
-             document.getElementById('noteList').innerHTML = '';
-             document.getElementById('output').textContent = '';
-             await initObjectQL();
-        }
 
         async function initObjectQL() {
             try {
-                if (window.currentDriverType === 'localstorage') {
-                    log('💾 Creating LocalStorage Driver...');
-                    window.driver = new LocalStorageDriver({
-                        namespace: 'objectql-notes-demo',
-                        strictMode: true
-                    });
-                } else {
-                    log('🧠 Creating Memory Driver...');
-                     window.driver = new MemoryDriver();
-                }
+                log('🧠 Creating Memory Driver...');
+                window.driver = new MemoryDriver();
 
-                log(`🚀 Initializing ObjectQL with ${window.currentDriverType}...`);
+                log('🚀 Initializing ObjectQL with Memory Driver...');
 
                 window.app = new ObjectQL({
                     datasources: { default: window.driver }
@@ -262,16 +240,16 @@ <h2>🖥️ Console Output</h2>
                 });
 
                 await window.app.init();
-                log('✅ ObjectQL initialized with LocalStorage!');
+                log('✅ ObjectQL initialized with Memory Driver!');
 
                 const ctx = window.app.createContext({ isSystem: true });
                 window.noteRepo = ctx.object('notes');
 
-                // Load existing notes from LocalStorage
+                // Load existing notes
                 await loadNotes();
                 updateStorageCount();
 
-                log('🎉 Ready! Your data persists across page refreshes.');
+                log('🎉 Ready! Add notes using the form above.');
 
             } catch (error) {
                 log('❌ Error:', error);
@@ -291,7 +269,7 @@ <h2>🖥️ Console Output</h2>
                 log(`➕ Creating note: "${content}"`);
                 const note = await window.noteRepo.create({ content });
 
-                log('✅ Note created and saved to LocalStorage');
+                log('✅ Note created');
                 document.getElementById('noteContent').value = '';
 
                 await loadNotes();
@@ -306,7 +284,7 @@ <h2>🖥️ Console Output</h2>
         window.loadNotes = async function() {
             try {
                 const notes = await window.noteRepo.find({});
-                log(`📋 Loaded ${notes.length} notes from LocalStorage`);
+                log(`📋 Loaded ${notes.length} notes`);
 
                 displayNotes(notes);
                 updateStorageCount();
@@ -345,7 +323,7 @@ <h2>🖥️ Console Output</h2>
             try {
                 log(`🗑 Deleting note ${id}...`);
                 await window.noteRepo.delete(id);
-                log('✅ Note deleted from LocalStorage');
+                log('✅ Note deleted');
 
                 await loadNotes();
                 updateStorageCount();
@@ -361,7 +339,7 @@ <h2>🖥️ Console Output</h2>
             }
 
             try {
-                log('🗑 Clearing all data from LocalStorage...');
+                log('🗑 Clearing all data...');
                 await window.driver.clear();
                 log('✅ All data cleared');
 

examples/integrations/browser/index.html

@@ -2,7 +2,7 @@
   "name": "@objectql/example-browser",
   "version": "4.1.0",
   "private": true,
-  "description": "Browser demo for ObjectQL showing Memory and LocalStorage drivers",
+  "description": "Browser demo for ObjectQL showing Memory driver",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -11,7 +11,6 @@
   },
   "dependencies": {
     "@objectql/core": "workspace:*",
-    "@objectql/driver-localstorage": "workspace:*",
     "@objectql/driver-memory": "workspace:*",
     "@objectql/types": "workspace:*"
   },

examples/integrations/browser/package.json

@@ -14,7 +14,6 @@ export default defineConfig({
   resolve: {
     alias: {
       // '@objectql/core': resolve(__dirname, '../../../packages/foundation/core/src/index.ts'),
-      // '@objectql/driver-localstorage': resolve(__dirname, '../../../packages/drivers/localstorage/src/index.ts'),
       // '@objectql/driver-memory': resolve(__dirname, '../../../packages/drivers/memory/src/index.ts'),
       // '@objectql/types': resolve(__dirname, '../../../packages/foundation/types/src/index.ts'),
       // '@objectstack/runtime': resolve(__dirname, '../../../packages/objectstack/runtime/src/index.ts'),
@@ -25,7 +24,6 @@ export default defineConfig({
     include: [
       '@objectql/types',
       '@objectql/core',
-      '@objectql/driver-localstorage',
       '@objectql/driver-memory'
     ]
   },