@framers/agentos 0.1.0

package/dist/core/storage/InMemoryStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/core/storage/InMemoryStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,QAAQ,CAAgD;IAChE,OAAO,CAAC,sBAAsB,CAAoC;IAClE,OAAO,CAAC,WAAW,CAAkB;IAErC;;;;;;;;;OASG;;IAKH;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;;;OAMG;IACG,kBAAkB,CAAC,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAe7E;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAO5E;;;;;;;OAOG;IACG,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBlE;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,aAAa,EAAE,CAAC;IAsB3B;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuBhF;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAOzE;;;;;;OAMG;IACG,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAgClC;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBxD;;;;;OAKG;IACG,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB5E;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9D;;;;;OAKG;IACG,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2B7E;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/core/storage/InMemoryStorageAdapter.js

@@ -0,0 +1,343 @@
+/**
+ * @file InMemoryStorageAdapter.ts
+ * @description In-memory storage adapter for AgentOS (testing and non-persistent scenarios).
+ *
+ * This implementation stores all data in memory using JavaScript Maps and Arrays.
+ * Perfect for:
+ * - Unit testing without database setup
+ * - Ephemeral sessions that don't need persistence
+ * - Development and prototyping
+ * - CI/CD pipelines
+ *
+ * **Warning:** All data is lost when the process terminates or adapter is closed.
+ *
+ * @version 1.0.0
+ * @author AgentOS Team
+ * @license MIT
+ */
+/**
+ * In-memory storage adapter for AgentOS.
+ *
+ * Provides a complete implementation of IStorageAdapter without any persistence.
+ * All data is stored in JavaScript Map and Array structures.
+ *
+ * **Use Cases:**
+ * - Unit and integration testing
+ * - Development environments
+ * - Stateless sessions
+ * - CI/CD pipelines
+ * - Prototyping and demos
+ *
+ * **Characteristics:**
+ * - Zero setup (no database required)
+ * - Extremely fast (no I/O)
+ * - Non-persistent (data lost on process exit)
+ * - Thread-safe in single-threaded environments
+ *
+ * @class InMemoryStorageAdapter
+ * @implements {IStorageAdapter}
+ *
+ * @example
+ * ```typescript
+ * // Perfect for testing
+ * const storage = new InMemoryStorageAdapter();
+ * await storage.initialize();
+ *
+ * const conversation = await storage.createConversation({
+ *   id: 'test-conv',
+ *   userId: 'test-user',
+ *   createdAt: Date.now(),
+ *   lastActivity: Date.now()
+ * });
+ *
+ * // No cleanup needed for tests
+ * await storage.close();
+ * ```
+ */
+export class InMemoryStorageAdapter {
+    /**
+     * Creates a new in-memory storage adapter.
+     *
+     * No configuration needed since everything is in memory.
+     *
+     * @example
+     * ```typescript
+     * const storage = new InMemoryStorageAdapter();
+     * ```
+     */
+    constructor() {
+        this.conversations = new Map();
+        this.messages = new Map();
+        this.messagesByConversation = new Map();
+        this.initialized = false;
+        // No config needed for in-memory
+    }
+    /**
+     * Initializes the storage adapter.
+     *
+     * For in-memory adapter, this just sets the initialized flag.
+     *
+     * @returns {Promise<void>}
+     */
+    async initialize() {
+        this.initialized = true;
+    }
+    /**
+     * Closes the storage adapter and clears all data.
+     *
+     * **Warning:** This deletes all conversations and messages from memory.
+     *
+     * @returns {Promise<void>}
+     */
+    async close() {
+        this.conversations.clear();
+        this.messages.clear();
+        this.messagesByConversation.clear();
+        this.initialized = false;
+    }
+    // ==================== Conversation Operations ====================
+    /**
+     * Creates a new conversation.
+     *
+     * @param {IConversation} conversation - Conversation to create
+     * @returns {Promise<IConversation>} The created conversation
+     * @throws {Error} If conversation with same ID already exists
+     */
+    async createConversation(conversation) {
+        this.ensureInitialized();
+        if (this.conversations.has(conversation.id)) {
+            throw new Error(`Conversation already exists: ${conversation.id}`);
+        }
+        // Deep clone to prevent external mutations
+        const stored = { ...conversation };
+        this.conversations.set(conversation.id, stored);
+        this.messagesByConversation.set(conversation.id, []);
+        return { ...stored };
+    }
+    /**
+     * Retrieves a conversation by ID.
+     *
+     * @param {string} conversationId - Conversation ID
+     * @returns {Promise<IConversation | null>} The conversation or null
+     */
+    async getConversation(conversationId) {
+        this.ensureInitialized();
+        const conversation = this.conversations.get(conversationId);
+        return conversation ? { ...conversation } : null;
+    }
+    /**
+     * Updates a conversation.
+     *
+     * @param {string} conversationId - Conversation to update
+     * @param {Partial<IConversation>} updates - Fields to update
+     * @returns {Promise<IConversation>} Updated conversation
+     * @throws {Error} If conversation doesn't exist
+     */
+    async updateConversation(conversationId, updates) {
+        this.ensureInitialized();
+        const existing = this.conversations.get(conversationId);
+        if (!existing) {
+            throw new Error(`Conversation not found: ${conversationId}`);
+        }
+        const updated = { ...existing, ...updates };
+        this.conversations.set(conversationId, updated);
+        return { ...updated };
+    }
+    /**
+     * Deletes a conversation and all its messages.
+     *
+     * @param {string} conversationId - Conversation to delete
+     * @returns {Promise<boolean>} True if deleted, false if not found
+     */
+    async deleteConversation(conversationId) {
+        this.ensureInitialized();
+        const existed = this.conversations.has(conversationId);
+        if (existed) {
+            // Delete conversation
+            this.conversations.delete(conversationId);
+            // Delete all messages
+            const messageIds = this.messagesByConversation.get(conversationId) || [];
+            for (const messageId of messageIds) {
+                this.messages.delete(messageId);
+            }
+            this.messagesByConversation.delete(conversationId);
+        }
+        return existed;
+    }
+    /**
+     * Lists conversations for a user.
+     *
+     * @param {string} userId - User whose conversations to list
+     * @param {Object} [options] - Query options
+     * @returns {Promise<IConversation[]>} Array of conversations
+     */
+    async listConversations(userId, options) {
+        this.ensureInitialized();
+        let conversations = Array.from(this.conversations.values()).filter((conv) => conv.userId === userId);
+        if (options?.agentId) {
+            conversations = conversations.filter((conv) => conv.agentId === options.agentId);
+        }
+        // Sort by lastActivity descending
+        conversations.sort((a, b) => b.lastActivity - a.lastActivity);
+        const offset = options?.offset || 0;
+        const limit = options?.limit || conversations.length;
+        return conversations.slice(offset, offset + limit).map((conv) => ({ ...conv }));
+    }
+    // ==================== Message Operations ====================
+    /**
+     * Stores a message.
+     *
+     * @param {IConversationMessage} message - Message to store
+     * @returns {Promise<IConversationMessage>} The stored message
+     * @throws {Error} If conversation doesn't exist
+     */
+    async storeMessage(message) {
+        this.ensureInitialized();
+        const conversation = this.conversations.get(message.conversationId);
+        if (!conversation) {
+            throw new Error(`Conversation not found: ${message.conversationId}`);
+        }
+        // Store message
+        const stored = { ...message };
+        this.messages.set(message.id, stored);
+        // Add to conversation's message list
+        const messageIds = this.messagesByConversation.get(message.conversationId) || [];
+        messageIds.push(message.id);
+        this.messagesByConversation.set(message.conversationId, messageIds);
+        // Update conversation lastActivity
+        conversation.lastActivity = message.timestamp;
+        return { ...stored };
+    }
+    /**
+     * Retrieves a message by ID.
+     *
+     * @param {string} messageId - Message ID
+     * @returns {Promise<IConversationMessage | null>} The message or null
+     */
+    async getMessage(messageId) {
+        this.ensureInitialized();
+        const message = this.messages.get(messageId);
+        return message ? { ...message } : null;
+    }
+    /**
+     * Retrieves messages for a conversation with filtering.
+     *
+     * @param {string} conversationId - Conversation ID
+     * @param {IMessageQueryOptions} [options] - Query options
+     * @returns {Promise<IConversationMessage[]>} Array of messages
+     */
+    async getMessages(conversationId, options) {
+        this.ensureInitialized();
+        const messageIds = this.messagesByConversation.get(conversationId) || [];
+        let messages = messageIds
+            .map((id) => this.messages.get(id))
+            .filter((msg) => msg !== undefined);
+        // Apply filters
+        if (options?.since) {
+            messages = messages.filter((msg) => msg.timestamp >= options.since);
+        }
+        if (options?.until) {
+            messages = messages.filter((msg) => msg.timestamp <= options.until);
+        }
+        if (options?.roles && options.roles.length > 0) {
+            messages = messages.filter((msg) => options.roles.includes(msg.role));
+        }
+        // Sort
+        const order = options?.order === 'desc' ? -1 : 1;
+        messages.sort((a, b) => order * (a.timestamp - b.timestamp));
+        // Pagination
+        const offset = options?.offset || 0;
+        const limit = options?.limit || messages.length;
+        return messages.slice(offset, offset + limit).map((msg) => ({ ...msg }));
+    }
+    /**
+     * Deletes a message.
+     *
+     * @param {string} messageId - Message to delete
+     * @returns {Promise<boolean>} True if deleted
+     */
+    async deleteMessage(messageId) {
+        this.ensureInitialized();
+        const message = this.messages.get(messageId);
+        if (!message) {
+            return false;
+        }
+        // Remove from messages map
+        this.messages.delete(messageId);
+        // Remove from conversation's message list
+        const messageIds = this.messagesByConversation.get(message.conversationId) || [];
+        const index = messageIds.indexOf(messageId);
+        if (index > -1) {
+            messageIds.splice(index, 1);
+            this.messagesByConversation.set(message.conversationId, messageIds);
+        }
+        return true;
+    }
+    /**
+     * Deletes all messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation whose messages to delete
+     * @returns {Promise<number>} Number of messages deleted
+     */
+    async deleteMessagesForConversation(conversationId) {
+        this.ensureInitialized();
+        const messageIds = this.messagesByConversation.get(conversationId) || [];
+        const count = messageIds.length;
+        for (const messageId of messageIds) {
+            this.messages.delete(messageId);
+        }
+        this.messagesByConversation.set(conversationId, []);
+        return count;
+    }
+    // ==================== Analytics & Utilities ====================
+    /**
+     * Counts messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation to count
+     * @returns {Promise<number>} Message count
+     */
+    async getMessageCount(conversationId) {
+        this.ensureInitialized();
+        const messageIds = this.messagesByConversation.get(conversationId) || [];
+        return messageIds.length;
+    }
+    /**
+     * Calculates total token usage for a conversation.
+     *
+     * @param {string} conversationId - Conversation to analyze
+     * @returns {Promise<ITokenUsage>} Aggregated token usage
+     */
+    async getConversationTokenUsage(conversationId) {
+        this.ensureInitialized();
+        const messageIds = this.messagesByConversation.get(conversationId) || [];
+        const messages = messageIds
+            .map((id) => this.messages.get(id))
+            .filter((msg) => msg !== undefined);
+        const usage = {
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+        };
+        for (const message of messages) {
+            if (message.usage) {
+                usage.promptTokens += message.usage.promptTokens || 0;
+                usage.completionTokens += message.usage.completionTokens || 0;
+                usage.totalTokens += message.usage.totalTokens || 0;
+            }
+        }
+        return usage;
+    }
+    // ==================== Private Helper Methods ====================
+    /**
+     * Ensures the adapter has been initialized.
+     *
+     * @private
+     * @throws {Error} If not initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('InMemoryStorageAdapter not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=InMemoryStorageAdapter.js.map

package/dist/core/storage/InMemoryStorageAdapter.js.map

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

package/dist/core/storage/SqlStorageAdapter.d.ts

@@ -0,0 +1,262 @@
+/**
+ * @file SqlStorageAdapter.ts
+ * @description SQL-based storage adapter for AgentOS using @framers/sql-storage-adapter.
+ *
+ * This implementation provides a complete persistence layer for conversations and messages
+ * using the cross-platform SQL storage adapter. It automatically handles:
+ * - Schema creation and migration
+ * - CRUD operations for conversations and messages
+ * - Transaction support for atomic operations
+ * - Cross-platform compatibility (SQLite, PostgreSQL, SQL.js, etc.)
+ *
+ * **Architecture:**
+ * ```
+ * AgentOS ConversationManager
+ *          ↓
+ *   SqlStorageAdapter (this file)
+ *          ↓
+ *   @framers/sql-storage-adapter
+ *          ↓
+ *   Database (SQLite/PostgreSQL/etc.)
+ * ```
+ *
+ * @version 1.0.0
+ * @author AgentOS Team
+ * @license MIT
+ */
+import { type StorageResolutionOptions } from '@framers/sql-storage-adapter';
+import type { IStorageAdapter, IConversation, IConversationMessage, IMessageQueryOptions, ITokenUsage } from './IStorageAdapter.js';
+/**
+ * Configuration options for the AgentOS SQL storage adapter.
+ *
+ * Extends the base storage resolution options with AgentOS-specific settings.
+ *
+ * @interface AgentOsSqlStorageConfig
+ * @extends {StorageResolutionOptions}
+ * @property {boolean} [enableAutoMigration] - Automatically run schema migrations on init
+ * @property {number} [messageRetentionDays] - Auto-delete messages older than X days (0 = disabled)
+ *
+ * @example
+ * ```typescript
+ * const config: AgentOsSqlStorageConfig = {
+ *   filePath: './agentos.db',
+ *   priority: ['better-sqlite3', 'sqljs'],
+ *   enableAutoMigration: true,
+ *   messageRetentionDays: 90 // Keep 3 months of history
+ * };
+ * ```
+ */
+export interface AgentOsSqlStorageConfig extends StorageResolutionOptions {
+    enableAutoMigration?: boolean;
+    messageRetentionDays?: number;
+}
+/**
+ * SQL storage adapter implementation for AgentOS.
+ *
+ * Provides full persistence for conversations and messages using a SQL database.
+ * Wraps @framers/sql-storage-adapter to provide AgentOS-specific schema and operations.
+ *
+ * **Features:**
+ * - Cross-platform SQL support (SQLite, PostgreSQL, SQL.js, Capacitor)
+ * - Automatic schema creation and migration
+ * - Efficient querying with indexes
+ * - Transaction support for atomic operations
+ * - Type-safe API with full TypeScript support
+ *
+ * **Database Schema:**
+ * - `conversations` table: Stores conversation metadata
+ * - `messages` table: Stores individual messages with foreign key to conversations
+ * - Indexes on frequently queried columns for performance
+ *
+ * @class SqlStorageAdapter
+ * @implements {IStorageAdapter}
+ *
+ * @example
+ * ```typescript
+ * // Node.js with SQLite
+ * const storage = new SqlStorageAdapter({
+ *   type: 'better-sqlite3',
+ *   database: './data/agentos.db',
+ *   enableWAL: true
+ * });
+ *
+ * await storage.initialize();
+ *
+ * // Browser with SQL.js
+ * const browserStorage = new SqlStorageAdapter({
+ *   type: 'sql.js',
+ *   database: 'agentos.db',
+ *   enableAutoMigration: true
+ * });
+ *
+ * await browserStorage.initialize();
+ * ```
+ */
+export declare class SqlStorageAdapter implements IStorageAdapter {
+    private adapter;
+    private config;
+    private initialized;
+    /**
+     * Creates a new SQL storage adapter instance.
+     *
+     * @param {AgentOsSqlStorageConfig} config - Storage configuration
+     *
+     * @example
+     * ```typescript
+     * const storage = new SqlStorageAdapter({
+     *   filePath: './agentos.db',
+     *   priority: ['better-sqlite3']
+     * });
+     * ```
+     */
+    constructor(config?: AgentOsSqlStorageConfig);
+    /**
+     * Initializes the storage adapter and creates the database schema.
+     *
+     * **Schema created:**
+     * - `conversations` table with indexes on userId and agentId
+     * - `messages` table with indexes on conversationId and timestamp
+     * - Foreign key constraints for referential integrity
+     *
+     * **Must be called before any other operations.**
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If database connection or schema creation fails
+     *
+     * @example
+     * ```typescript
+     * await storage.initialize();
+     * console.log('Storage ready!');
+     * ```
+     */
+    initialize(): Promise<void>;
+    /**
+     * Closes the database connection and releases resources.
+     *
+     * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * await storage.close();
+     * ```
+     */
+    close(): Promise<void>;
+    /**
+     * Creates a new conversation record.
+     *
+     * @param {IConversation} conversation - Conversation to create
+     * @returns {Promise<IConversation>} The created conversation
+     * @throws {Error} If conversation with same ID exists or validation fails
+     */
+    createConversation(conversation: IConversation): Promise<IConversation>;
+    /**
+     * Retrieves a conversation by ID.
+     *
+     * @param {string} conversationId - The conversation ID
+     * @returns {Promise<IConversation | null>} The conversation or null if not found
+     */
+    getConversation(conversationId: string): Promise<IConversation | null>;
+    /**
+     * Updates a conversation's fields.
+     *
+     * @param {string} conversationId - Conversation to update
+     * @param {Partial<IConversation>} updates - Fields to update
+     * @returns {Promise<IConversation>} Updated conversation
+     * @throws {Error} If conversation doesn't exist
+     */
+    updateConversation(conversationId: string, updates: Partial<IConversation>): Promise<IConversation>;
+    /**
+     * Deletes a conversation and all its messages.
+     *
+     * @param {string} conversationId - Conversation to delete
+     * @returns {Promise<boolean>} True if deleted, false if not found
+     */
+    deleteConversation(conversationId: string): Promise<boolean>;
+    /**
+     * Lists conversations for a user with optional filtering.
+     *
+     * @param {string} userId - User whose conversations to list
+     * @param {Object} [options] - Query options
+     * @returns {Promise<IConversation[]>} Array of conversations
+     */
+    listConversations(userId: string, options?: {
+        limit?: number;
+        offset?: number;
+        agentId?: string;
+    }): Promise<IConversation[]>;
+    /**
+     * Stores a message and updates conversation's lastActivity.
+     *
+     * @param {IConversationMessage} message - Message to store
+     * @returns {Promise<IConversationMessage>} The stored message
+     * @throws {Error} If conversation doesn't exist
+     */
+    storeMessage(message: IConversationMessage): Promise<IConversationMessage>;
+    /**
+     * Retrieves a message by ID.
+     *
+     * @param {string} messageId - Message ID
+     * @returns {Promise<IConversationMessage | null>} The message or null
+     */
+    getMessage(messageId: string): Promise<IConversationMessage | null>;
+    /**
+     * Retrieves messages for a conversation with filtering.
+     *
+     * @param {string} conversationId - Conversation ID
+     * @param {IMessageQueryOptions} [options] - Query options
+     * @returns {Promise<IConversationMessage[]>} Array of messages
+     */
+    getMessages(conversationId: string, options?: IMessageQueryOptions): Promise<IConversationMessage[]>;
+    /**
+     * Deletes a specific message.
+     *
+     * @param {string} messageId - Message to delete
+     * @returns {Promise<boolean>} True if deleted
+     */
+    deleteMessage(messageId: string): Promise<boolean>;
+    /**
+     * Deletes all messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation whose messages to delete
+     * @returns {Promise<number>} Number of messages deleted
+     */
+    deleteMessagesForConversation(conversationId: string): Promise<number>;
+    /**
+     * Counts messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation to count
+     * @returns {Promise<number>} Message count
+     */
+    getMessageCount(conversationId: string): Promise<number>;
+    /**
+     * Calculates total token usage for a conversation.
+     *
+     * @param {string} conversationId - Conversation to analyze
+     * @returns {Promise<ITokenUsage>} Aggregated token usage
+     */
+    getConversationTokenUsage(conversationId: string): Promise<ITokenUsage>;
+    /**
+     * Ensures the adapter has been initialized.
+     *
+     * @private
+     * @throws {Error} If not initialized
+     */
+    private ensureInitialized;
+    /**
+     * Converts a database row to an IConversation object.
+     *
+     * @private
+     * @param {any} row - Database row
+     * @returns {IConversation} Conversation object
+     */
+    private rowToConversation;
+    /**
+     * Converts a database row to an IConversationMessage object.
+     *
+     * @private
+     * @param {any} row - Database row
+     * @returns {IConversationMessage} Message object
+     */
+    private rowToMessage;
+}
+//# sourceMappingURL=SqlStorageAdapter.d.ts.map

package/dist/core/storage/SqlStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/core/storage/SqlStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAAkB;IAErC;;;;;;;;;;;;OAYG;gBACS,MAAM,GAAE,uBAA4B;IAQhD;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDjC;;;;;;;;;OASG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;;;OAMG;IACG,kBAAkB,CAAC,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB7E;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAe5E;;;;;;;OAOG;IACG,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IA6BzB;;;;;OAKG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlE;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,aAAa,EAAE,CAAC;IA6B3B;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2ChF;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAYzE;;;;;;OAMG;IACG,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAuClC;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxD;;;;;OAKG;IACG,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5E;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;;;;OAKG;IACG,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsB7E;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAwBrB"}