@framers/sql-storage-adapter 0.3.2 → 0.3.3

package/dist/core/resolver.js

@@ -1,4 +1,41 @@
-import path from 'path';
+// Browser-safe path utilities - avoid importing Node.js 'path' module in browser builds
+const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+const isNode = typeof process !== 'undefined' && !!process.versions?.node;
+// Browser-safe path join (only used in Node.js environments)
+const joinPath = async (parts) => {
+    if (isBrowser) {
+        // In browser, just join with '/' (not used anyway since filePath is provided)
+        return parts.join('/');
+    }
+    // In Node.js, use path.join dynamically
+    if (isNode) {
+        try {
+            // Dynamic import to avoid bundling 'path' in browser builds
+            const path = await import('path');
+            return path.join(...parts);
+        }
+        catch {
+            // Fallback if import fails
+            return parts.join('/');
+        }
+    }
+    return parts.join('/');
+};
+// Browser-safe process.env access
+const getEnv = (key) => {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key];
+    }
+    return undefined;
+};
+// Browser-safe process.cwd()
+const getCwd = () => {
+    if (isNode && typeof process !== 'undefined' && process.cwd) {
+        return process.cwd();
+    }
+    // Browser fallback (not used in browser anyway)
+    return '/';
+};
 import { StorageResolutionError } from './contracts';
 import { createBetterSqliteAdapter } from '../adapters/betterSqliteAdapter';
 import { createSqlJsAdapter } from '../adapters/sqlJsAdapter';
@@ -17,9 +54,10 @@ const isCapacitorRuntime = () => {
  * Tries candidates in the supplied priority order and falls back when one fails.
  */
 export const resolveStorageAdapter = async (options = {}) => {
-    const envOverride = process.env.STORAGE_ADAPTER;
-    const postgresConnection = options.postgres?.connectionString ?? process.env.DATABASE_URL ?? undefined;
-    const filePath = options.filePath ?? path.join(process.cwd(), 'db_data', 'app.sqlite3');
+    const envOverride = getEnv('STORAGE_ADAPTER');
+    const postgresConnection = options.postgres?.connectionString ?? getEnv('DATABASE_URL') ?? undefined;
+    const defaultFilePath = isBrowser ? 'db_data/app.sqlite3' : await joinPath([getCwd(), 'db_data', 'app.sqlite3']);
+    const filePath = options.filePath ?? defaultFilePath;
     const defaultPriority = (() => {
         if (options.priority && options.priority.length > 0) {
             return options.priority;
@@ -70,7 +108,7 @@ export const resolveStorageAdapter = async (options = {}) => {
                     factory: async () => {
                         const adapterOptions = options.openOptions?.adapterOptions;
                         return new IndexedDbAdapter({
-                            dbName: adapterOptions?.dbName || 'agentos-db',
+                            dbName: adapterOptions?.dbName || 'app-db',
                             autoSave: true,
                         });
                     }

package/dist/core/resolver.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/sql-storage-adapter",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Robust cross-platform SQL storage abstraction with automatic fallbacks and runtime detection",
   "type": "module",
   "main": "dist/index.js",

package/dist/agentos/AgentOSStorageAdapter.d.ts

@@ -1,320 +0,0 @@
-/**
- * @fileoverview AgentOS-First Storage Adapter
- * @description Opinionated storage layer designed specifically for AgentOS with auto-schema,
- * typed queries, and cross-platform persistence. This is the recommended way to use
- * sql-storage-adapter with AgentOS.
- *
- * **Features:**
- * - Auto-detects best adapter for platform (web, electron, capacitor, node, cloud)
- * - Pre-configured schema for conversations, sessions, personas, telemetry
- * - Typed query builders for common AgentOS operations
- * - Optional cloud sync for hybrid local+remote architectures
- * - Export/import for data portability
- *
- * @example Basic Usage
- * ```typescript
- * import { createAgentOSStorage } from '../agentos';
- * import { AgentOS } from '@agentos/core';
- *
- * const storage = await createAgentOSStorage({
- *   platform: 'auto',  // Detects: web, electron, capacitor, node, cloud
- *   persistence: true,
- * });
- *
- * const agentos = new AgentOS();
- * await agentos.initialize({
- *   storageAdapter: storage,
- *   // ... other config
- * });
- * ```
- *
- * @example Multi-Platform
- * ```typescript
- * // Web (browser): Uses IndexedDB
- * const webStorage = await createAgentOSStorage({ platform: 'web' });
- *
- * // Desktop (Electron): Uses better-sqlite3
- * const desktopStorage = await createAgentOSStorage({ platform: 'electron' });
- *
- * // Mobile (Capacitor): Uses native SQLite
- * const mobileStorage = await createAgentOSStorage({ platform: 'capacitor' });
- *
- * // Cloud (Node): Uses PostgreSQL
- * const cloudStorage = await createAgentOSStorage({
- *   platform: 'cloud',
- *   postgres: { connectionString: process.env.DATABASE_URL }
- * });
- * ```
- *
- * @example Hybrid Sync
- * ```typescript
- * const storage = await createAgentOSStorage({
- *   local: { adapter: 'indexeddb' },
- *   remote: { adapter: 'postgres', connectionString: CLOUD_URL },
- *   syncStrategy: 'optimistic',  // Local-first, background sync
- *   syncIntervalMs: 30000,
- * });
- * ```
- */
-import type { StorageAdapter } from '../core/contracts';
-import type { AdapterKind } from '../core/contracts/context';
-/**
- * Platform types for AgentOS deployment
- */
-export type AgentOSPlatform = 'web' | 'electron' | 'capacitor' | 'node' | 'cloud' | 'auto';
-/**
- * Sync strategy for hybrid local+remote storage
- */
-export type SyncStrategy = 'local-only' | 'remote-only' | 'optimistic' | 'pessimistic';
-/**
- * Configuration for AgentOS-optimized storage
- */
-export interface AgentOSStorageConfig {
-    /**
-     * Target platform. 'auto' detects runtime automatically.
-     * @default 'auto'
-     */
-    platform?: AgentOSPlatform;
-    /**
-     * Enable persistence (vs in-memory only).
-     * @default true
-     */
-    persistence?: boolean;
-    /**
-     * Database name (for IndexedDB, SQLite file, etc.)
-     * @default 'agentos-db'
-     */
-    dbName?: string;
-    /**
-     * File path for SQLite adapters
-     */
-    filePath?: string;
-    /**
-     * PostgreSQL connection config
-     */
-    postgres?: {
-        connectionString?: string;
-    };
-    /**
-     * Capacitor-specific options
-     */
-    capacitor?: {
-        database?: string;
-        encrypted?: boolean;
-    };
-    /**
-     * Features to enable (auto-creates tables)
-     * @default all enabled
-     */
-    features?: {
-        conversations?: boolean;
-        sessions?: boolean;
-        personas?: boolean;
-        telemetry?: boolean;
-        workflows?: boolean;
-    };
-    /**
-     * Optional cloud sync for hybrid architectures
-     */
-    cloudSync?: {
-        enabled?: boolean;
-        provider?: 'supabase' | 'postgres' | 'custom';
-        connectionString?: string;
-        syncStrategy?: SyncStrategy;
-        syncIntervalMs?: number;
-    };
-    /**
-     * Advanced: manual adapter priority override
-     */
-    adapterPriority?: AdapterKind[];
-}
-/**
- * AgentOS-optimized storage adapter with auto-schema and typed queries.
- *
- * This class wraps a generic StorageAdapter and adds AgentOS-specific
- * functionality like auto-schema creation, typed query builders, and
- * optional cloud sync.
- */
-export declare class AgentOSStorageAdapter {
-    private adapter;
-    private config;
-    constructor(adapter: StorageAdapter, config: AgentOSStorageConfig);
-    /**
-     * Initializes the storage adapter and creates AgentOS schema.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Gets the underlying storage adapter for custom queries.
-     */
-    getAdapter(): StorageAdapter;
-    /**
-     * Closes the storage adapter.
-     */
-    close(): Promise<void>;
-    /**
-     * Conversations API with typed query builders.
-     *
-     * @example
-     * ```typescript
-     * await storage.conversations.save('conv-1', 'user-1', 'v_researcher', [
-     *   { type: 'user', content: 'Hello', timestamp: Date.now() },
-     *   { type: 'assistant', content: 'Hi!', timestamp: Date.now() },
-     * ]);
-     *
-     * const conversation = await storage.conversations.get('conv-1');
-     * const allConversations = await storage.conversations.list('user-1', { limit: 50 });
-     * ```
-     */
-    get conversations(): {
-        /**
-         * Saves a conversation with its events.
-         * Creates the conversation if it doesn't exist, updates if it does.
-         */
-        save: (id: string, userId: string, personaId: string, events: any[]) => Promise<void>;
-        /**
-         * Gets a conversation by ID with all its events.
-         * Returns null if not found.
-         */
-        get: (id: string) => Promise<{
-            events: any[];
-            id: string;
-            user_id: string;
-            persona_id: string;
-            created_at: number;
-            updated_at: number;
-            metadata: string;
-        } | null>;
-        /**
-         * Lists conversations for a user, ordered by most recent first.
-         */
-        list: (userId: string, options?: {
-            limit?: number;
-            offset?: number;
-        }) => Promise<{
-            id: string;
-            user_id: string;
-            persona_id: string;
-            created_at: number;
-            updated_at: number;
-            metadata: string;
-        }[]>;
-        /**
-         * Deletes a conversation and all its events.
-         */
-        delete: (id: string) => Promise<void>;
-    };
-    /**
-     * Sessions API with typed query builders.
-     *
-     * @example
-     * ```typescript
-     * await storage.sessions.save('session-1', 'user-1', 'V Session', 'persona', 'v_researcher');
-     * const session = await storage.sessions.get('session-1');
-     * const allSessions = await storage.sessions.list('user-1', { limit: 25 });
-     * ```
-     */
-    get sessions(): {
-        /**
-         * Saves a session (creates or updates).
-         */
-        save: (id: string, userId: string, displayName: string, targetType: "persona" | "agency", targetId: string, metadata?: Record<string, any>) => Promise<void>;
-        /**
-         * Gets a session by ID.
-         */
-        get: (id: string) => Promise<{
-            id: string;
-            user_id: string;
-            display_name: string;
-            target_type: "persona" | "agency";
-            target_id: string;
-            created_at: number;
-            updated_at: number;
-            metadata: string;
-        } | null>;
-        /**
-         * Lists sessions for a user, ordered by most recent first.
-         */
-        list: (userId: string, options?: {
-            limit?: number;
-            offset?: number;
-            targetType?: "persona" | "agency";
-        }) => Promise<{
-            id: string;
-            user_id: string;
-            display_name: string;
-            target_type: "persona" | "agency";
-            target_id: string;
-            created_at: number;
-            updated_at: number;
-            metadata: string;
-        }[]>;
-        /**
-         * Deletes a session.
-         */
-        delete: (id: string) => Promise<void>;
-    };
-    /**
-     * Personas API with typed query builders.
-     *
-     * @example
-     * ```typescript
-     * await storage.personas.cache('v_researcher', 'V', personaDefinition);
-     * const persona = await storage.personas.get('v_researcher');
-     * const allPersonas = await storage.personas.list();
-     * ```
-     */
-    get personas(): {
-        /**
-         * Caches a persona definition (creates or updates).
-         */
-        cache: (id: string, displayName: string, definition: any) => Promise<void>;
-        /**
-         * Gets a persona by ID.
-         */
-        get: (id: string) => Promise<{
-            definition: any;
-            id: string;
-            display_name: string;
-            description: string;
-            created_at: number;
-            updated_at: number;
-        } | null>;
-        /**
-         * Lists all personas, ordered by display name.
-         */
-        list: () => Promise<{
-            definition: any;
-            id: string;
-            display_name: string;
-            description: string;
-            created_at: number;
-            updated_at: number;
-        }[]>;
-        /**
-         * Deletes a persona.
-         */
-        delete: (id: string) => Promise<void>;
-    };
-}
-/**
- * Creates an AgentOS-optimized storage adapter with auto-detection and schema setup.
- *
- * This is the recommended way to use sql-storage-adapter with AgentOS.
- * It automatically:
- * 1. Detects the best storage adapter for the current platform
- * 2. Creates AgentOS-specific tables (conversations, sessions, personas, etc.)
- * 3. Provides typed query builders for common operations
- * 4. Handles graceful degradation (e.g., IndexedDB → sql.js)
- *
- * @param config Configuration for platform, persistence, and features
- * @returns Initialized AgentOSStorageAdapter
- *
- * @example
- * ```typescript
- * const storage = await createAgentOSStorage({ platform: 'auto' });
- * const agentos = new AgentOS();
- * await agentos.initialize({ storageAdapter: storage.getAdapter() });
- * ```
- */
-export declare function createAgentOSStorage(config?: AgentOSStorageConfig): Promise<AgentOSStorageAdapter>;
-//# sourceMappingURL=AgentOSStorageAdapter.d.ts.map

package/dist/agentos/AgentOSStorageAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentOSStorageAdapter.d.ts","sourceRoot":"","sources":["../../src/agentos/AgentOSStorageAdapter.ts"],"names":[],"mappings":"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"}