feat: default persistence to 'auto' with 'false' opt-out

Persistence now defaults to 'auto' (auto-detect environment) instead of
undefined (no persistence). Users can opt out with `persistence: false`.

Default adapter values:
- Node.js file path: .objectstack/data/memory-driver.json
- Browser localStorage key: objectstack:memory-db

Changes:
- schema: persistence defaults to 'auto', added false to disable
- driver: initPersistence() defaults to 'auto' when undefined
- tests: updated to reflect new default, use persistence: false for pure memory

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/plugins/driver-memory/src/memory-driver.test.ts

@@ -6,7 +6,7 @@ describe('InMemoryDriver', () => {
   const testTable = 'test_table';
 
   beforeEach(async () => {
-    driver = new InMemoryDriver();
+    driver = new InMemoryDriver({ persistence: false });
     await driver.connect();
   });
 

packages/plugins/driver-memory/src/memory-driver.ts

@@ -32,16 +32,17 @@ export interface InMemoryDriverConfig {
   /** Optional: Logger instance */
   logger?: Logger;
   /**
-   * Optional persistence configuration.
+   * Persistence configuration. Defaults to `'auto'`.
+   * - `'auto'` (default) — Auto-detect environment (browser → localStorage, Node.js → file)
    * - `'file'` — File-system persistence with defaults (Node.js only)
    * - `'local'` — localStorage persistence with defaults (Browser only)
-   * - `'auto'` — Auto-detect environment (browser → localStorage, Node.js → file)
    * - `{ type: 'file', path?: string, autoSaveInterval?: number }` — File-system with options
    * - `{ type: 'local', key?: string }` — localStorage with options
    * - `{ type: 'auto', path?: string, key?: string, autoSaveInterval?: number }` — Auto-detect with options
    * - `{ adapter: PersistenceAdapterInterface }` — Custom adapter
+   * - `false` — Disable persistence (pure in-memory)
    */
-  persistence?: string | {
+  persistence?: string | false | {
     type?: 'file' | 'local' | 'auto';
     path?: string;
     key?: string;
@@ -933,10 +934,12 @@ export class InMemoryDriver implements DriverInterface {
 
   /**
    * Initialize the persistence adapter based on configuration.
+   * Defaults to 'auto' when persistence is not specified.
+   * Use `persistence: false` to explicitly disable persistence.
    */
   private async initPersistence(): Promise<void> {
-    const persistence = this.config.persistence;
-    if (!persistence) return;
+    const persistence = this.config.persistence === undefined ? 'auto' : this.config.persistence;
+    if (persistence === false) return;
 
     if (typeof persistence === 'string') {
       if (persistence === 'auto') {

packages/plugins/driver-memory/src/persistence/persistence.test.ts

@@ -139,8 +139,8 @@ describe('InMemoryDriver Persistence', () => {
   });
 
   describe('Pure Memory (No Persistence)', () => {
-    it('should work without persistence (default behavior)', async () => {
-      const driver = new InMemoryDriver();
+    it('should work without persistence when explicitly disabled', async () => {
+      const driver = new InMemoryDriver({ persistence: false });
       await driver.connect();
 
       await driver.create('items', { id: '1', name: 'Widget' });

packages/spec/src/data/driver/memory.test.ts

@@ -12,16 +12,24 @@ import {
 } from './memory.zod';
 
 describe('MemoryConfigSchema', () => {
-  it('should accept empty config (all optional)', () => {
+  it('should default persistence to "auto" when empty config', () => {
     const config = MemoryConfigSchema.parse({});
 
     expect(config.strictMode).toBe(false);
     expect(config.initialData).toBeUndefined();
-    expect(config.persistence).toBeUndefined();
+    expect(config.persistence).toBe('auto');
     expect(config.indexes).toBeUndefined();
     expect(config.maxRecordsPerObject).toBeUndefined();
   });
 
+  it('should accept persistence: false to disable persistence', () => {
+    const config = MemoryConfigSchema.parse({
+      persistence: false,
+    });
+
+    expect(config.persistence).toBe(false);
+  });
+
   it('should accept config with initial data', () => {
     const config = MemoryConfigSchema.parse({
       initialData: {

packages/spec/src/data/driver/memory.zod.ts

@@ -178,28 +178,30 @@ export const MemoryConfigSchema = z.object({
   strictMode: z.boolean().default(false).describe('Throw on missing records instead of returning null'),
 
   /**
-   * Optional persistence configuration.
-   * When configured, the memory store automatically saves and restores data.
+   * Persistence configuration.
+   * Defaults to `'auto'` — the memory store automatically detects the environment
+   * and saves/restores data using the best available strategy.
    *
-   * - `'auto'`: Auto-detect environment (browser → localStorage, Node.js → file)
+   * - `'auto'` (default): Auto-detect environment (browser → localStorage, Node.js → file)
    * - `'file'`: Persist to disk file (Node.js only, default path: `.objectstack/data/memory-driver.json`)
    * - `'local'`: Persist to localStorage (Browser only, default key: `objectstack:memory-db`)
    * - `{ type: 'auto', path?: string, key?: string }`: Auto-detect with overrides
    * - `{ type: 'file', path?: string }`: File-system with custom path
    * - `{ type: 'local', key?: string }`: localStorage with custom key
    * - `{ adapter: PersistenceAdapter }`: Custom persistence adapter
+   * - `false`: Disable persistence (pure in-memory, data lost on disconnect)
    *
    * @example
-   * // Auto-detect environment
-   * new InMemoryDriver({ persistence: 'auto' })
+   * // Auto-detect environment (default)
+   * new InMemoryDriver()
    * // Node.js
    * new InMemoryDriver({ persistence: 'file' })
    * // Browser
    * new InMemoryDriver({ persistence: 'local' })
-   * // Pure memory (default)
-   * new InMemoryDriver()
+   * // Pure memory (no persistence)
+   * new InMemoryDriver({ persistence: false })
    */
-  persistence: MemoryPersistenceConfigSchema.optional().describe('Persistence configuration'),
+  persistence: MemoryPersistenceConfigSchema.or(z.literal(false)).default('auto').describe('Persistence configuration (defaults to auto-detect)'),
 
   /**
    * Fields to index for faster lookups.