@danielsimonjr/memory-mcp 12.2.3 → 12.5.2

package/dist/core/StorageFactory.d.ts

@@ -1,45 +0,0 @@
-/**
- * Storage Factory
- *
- * Factory for creating IGraphStorage implementations.
- * Supports different storage backends based on configuration.
- *
- * Supported storage types:
- * - 'jsonl': JSONL file-based storage (default) - simple, human-readable
- * - 'sqlite': SQLite database storage (better-sqlite3 native) - indexed, ACID transactions, FTS5
- *
- * @module core/StorageFactory
- */
-import type { IGraphStorage, StorageConfig } from '../types/index.js';
-/**
- * Create a storage instance based on configuration.
- *
- * Uses environment variable MEMORY_STORAGE_TYPE to override default.
- *
- * @param config - Storage configuration
- * @returns IGraphStorage implementation
- * @throws Error if storage type is not supported
- *
- * @example
- * ```typescript
- * // Create default JSONL storage
- * const storage = createStorage({ type: 'jsonl', path: './memory.jsonl' });
- *
- * // Create SQLite storage
- * const storage = createStorage({ type: 'sqlite', path: './memory.db' });
- *
- * // Or use path-only shorthand (uses MEMORY_STORAGE_TYPE env var or defaults to jsonl)
- * const storage = createStorageFromPath('./memory.jsonl');
- * ```
- */
-export declare function createStorage(config: StorageConfig): IGraphStorage;
-/**
- * Create a storage instance from a file path.
- *
- * Uses default storage type (jsonl) or MEMORY_STORAGE_TYPE env var.
- *
- * @param path - Path to storage file
- * @returns IGraphStorage implementation
- */
-export declare function createStorageFromPath(path: string): IGraphStorage;
-//# sourceMappingURL=StorageFactory.d.ts.map

package/dist/core/StorageFactory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StorageFactory.d.ts","sourceRoot":"","sources":["../../src/core/StorageFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAOtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAiBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAGjE"}

package/dist/core/StorageFactory.js

@@ -1,64 +0,0 @@
-/**
- * Storage Factory
- *
- * Factory for creating IGraphStorage implementations.
- * Supports different storage backends based on configuration.
- *
- * Supported storage types:
- * - 'jsonl': JSONL file-based storage (default) - simple, human-readable
- * - 'sqlite': SQLite database storage (better-sqlite3 native) - indexed, ACID transactions, FTS5
- *
- * @module core/StorageFactory
- */
-import { GraphStorage } from './GraphStorage.js';
-import { SQLiteStorage } from './SQLiteStorage.js';
-/**
- * Default storage type when not specified.
- */
-const DEFAULT_STORAGE_TYPE = 'jsonl';
-/**
- * Create a storage instance based on configuration.
- *
- * Uses environment variable MEMORY_STORAGE_TYPE to override default.
- *
- * @param config - Storage configuration
- * @returns IGraphStorage implementation
- * @throws Error if storage type is not supported
- *
- * @example
- * ```typescript
- * // Create default JSONL storage
- * const storage = createStorage({ type: 'jsonl', path: './memory.jsonl' });
- *
- * // Create SQLite storage
- * const storage = createStorage({ type: 'sqlite', path: './memory.db' });
- *
- * // Or use path-only shorthand (uses MEMORY_STORAGE_TYPE env var or defaults to jsonl)
- * const storage = createStorageFromPath('./memory.jsonl');
- * ```
- */
-export function createStorage(config) {
-    // Allow environment override
-    const storageType = process.env.MEMORY_STORAGE_TYPE || config.type || DEFAULT_STORAGE_TYPE;
-    switch (storageType) {
-        case 'jsonl':
-            return new GraphStorage(config.path);
-        case 'sqlite':
-            return new SQLiteStorage(config.path);
-        default:
-            throw new Error(`Unknown storage type: ${storageType}. ` +
-                `Supported types: jsonl, sqlite`);
-    }
-}
-/**
- * Create a storage instance from a file path.
- *
- * Uses default storage type (jsonl) or MEMORY_STORAGE_TYPE env var.
- *
- * @param path - Path to storage file
- * @returns IGraphStorage implementation
- */
-export function createStorageFromPath(path) {
-    const storageType = process.env.MEMORY_STORAGE_TYPE || DEFAULT_STORAGE_TYPE;
-    return createStorage({ type: storageType, path });
-}

package/dist/core/TransactionManager.d.ts

@@ -1,259 +0,0 @@
-/**
- * Transaction Manager
- *
- * Provides atomic transaction support for knowledge graph operations.
- * Ensures data consistency by allowing multiple operations to be
- * grouped together and committed atomically, with automatic rollback on failure.
- *
- * @module core/TransactionManager
- */
-import type { Entity, Relation } from '../types/index.js';
-import type { GraphStorage } from './GraphStorage.js';
-/**
- * Types of operations that can be performed in a transaction.
- */
-export declare enum OperationType {
-    CREATE_ENTITY = "CREATE_ENTITY",
-    UPDATE_ENTITY = "UPDATE_ENTITY",
-    DELETE_ENTITY = "DELETE_ENTITY",
-    CREATE_RELATION = "CREATE_RELATION",
-    DELETE_RELATION = "DELETE_RELATION"
-}
-/**
- * Represents a single operation in a transaction using discriminated union.
- */
-export type TransactionOperation = {
-    type: OperationType.CREATE_ENTITY;
-    data: Omit<Entity, 'createdAt' | 'lastModified'>;
-} | {
-    type: OperationType.UPDATE_ENTITY;
-    data: {
-        name: string;
-        updates: Partial<Entity>;
-    };
-} | {
-    type: OperationType.DELETE_ENTITY;
-    data: {
-        name: string;
-    };
-} | {
-    type: OperationType.CREATE_RELATION;
-    data: Omit<Relation, 'createdAt' | 'lastModified'>;
-} | {
-    type: OperationType.DELETE_RELATION;
-    data: {
-        from: string;
-        to: string;
-        relationType: string;
-    };
-};
-/**
- * Transaction execution result.
- */
-export interface TransactionResult {
-    /** Whether the transaction was successful */
-    success: boolean;
-    /** Number of operations executed */
-    operationsExecuted: number;
-    /** Error message if transaction failed */
-    error?: string;
-    /** Path to rollback backup if created */
-    rollbackBackup?: string;
-}
-/**
- * Manages atomic transactions for knowledge graph operations.
- *
- * Provides ACID-like guarantees:
- * - Atomicity: All operations succeed or all fail
- * - Consistency: Graph is always in a valid state
- * - Isolation: Each transaction operates on a snapshot
- * - Durability: Changes are persisted to disk
- *
- * @example
- * ```typescript
- * const storage = new GraphStorage('/data/memory.jsonl');
- * const txManager = new TransactionManager(storage);
- *
- * // Begin transaction
- * txManager.begin();
- *
- * // Stage operations
- * txManager.createEntity({ name: 'Alice', entityType: 'person', observations: [] });
- * txManager.createRelation({ from: 'Alice', to: 'Bob', relationType: 'knows' });
- *
- * // Commit atomically (or rollback on error)
- * const result = await txManager.commit();
- * if (result.success) {
- *   console.log(`Transaction completed: ${result.operationsExecuted} operations`);
- * }
- * ```
- */
-export declare class TransactionManager {
-    private storage;
-    private operations;
-    private inTransaction;
-    private ioManager;
-    private transactionBackup?;
-    constructor(storage: GraphStorage);
-    /**
-     * Begin a new transaction.
-     *
-     * Creates a backup of the current state for rollback purposes.
-     * Only one transaction can be active at a time.
-     *
-     * @throws {KnowledgeGraphError} If a transaction is already in progress
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * // ... stage operations ...
-     * await txManager.commit();
-     * ```
-     */
-    begin(): void;
-    /**
-     * Stage a create entity operation.
-     *
-     * @param entity - Entity to create (without timestamps)
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.createEntity({
-     *   name: 'Alice',
-     *   entityType: 'person',
-     *   observations: ['Software engineer'],
-     *   importance: 8
-     * });
-     * ```
-     */
-    createEntity(entity: Omit<Entity, 'createdAt' | 'lastModified'>): void;
-    /**
-     * Stage an update entity operation.
-     *
-     * @param name - Name of entity to update
-     * @param updates - Partial entity updates
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.updateEntity('Alice', {
-     *   importance: 9,
-     *   observations: ['Lead software engineer']
-     * });
-     * ```
-     */
-    updateEntity(name: string, updates: Partial<Entity>): void;
-    /**
-     * Stage a delete entity operation.
-     *
-     * @param name - Name of entity to delete
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.deleteEntity('OldEntity');
-     * ```
-     */
-    deleteEntity(name: string): void;
-    /**
-     * Stage a create relation operation.
-     *
-     * @param relation - Relation to create (without timestamps)
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.createRelation({
-     *   from: 'Alice',
-     *   to: 'Bob',
-     *   relationType: 'mentors'
-     * });
-     * ```
-     */
-    createRelation(relation: Omit<Relation, 'createdAt' | 'lastModified'>): void;
-    /**
-     * Stage a delete relation operation.
-     *
-     * @param from - Source entity name
-     * @param to - Target entity name
-     * @param relationType - Type of relation
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.deleteRelation('Alice', 'Bob', 'mentors');
-     * ```
-     */
-    deleteRelation(from: string, to: string, relationType: string): void;
-    /**
-     * Commit the transaction, applying all staged operations atomically.
-     *
-     * Creates a backup before applying changes. If any operation fails,
-     * automatically rolls back to the pre-transaction state.
-     *
-     * @returns Promise resolving to transaction result
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.createEntity({ name: 'Alice', entityType: 'person', observations: [] });
-     * txManager.createRelation({ from: 'Alice', to: 'Bob', relationType: 'knows' });
-     *
-     * const result = await txManager.commit();
-     * if (result.success) {
-     *   console.log(`Committed ${result.operationsExecuted} operations`);
-     * } else {
-     *   console.error(`Transaction failed: ${result.error}`);
-     * }
-     * ```
-     */
-    commit(): Promise<TransactionResult>;
-    /**
-     * Rollback the current transaction.
-     *
-     * Restores the graph to the pre-transaction state using the backup.
-     * Automatically called by commit() on failure.
-     *
-     * @returns Promise resolving to rollback result
-     *
-     * @example
-     * ```typescript
-     * txManager.begin();
-     * txManager.createEntity({ name: 'Test', entityType: 'temp', observations: [] });
-     *
-     * // Explicit rollback (e.g., user cancellation)
-     * const result = await txManager.rollback();
-     * console.log(`Rolled back, restored from: ${result.backupUsed}`);
-     * ```
-     */
-    rollback(): Promise<{
-        success: boolean;
-        backupUsed?: string;
-    }>;
-    /**
-     * Check if a transaction is currently in progress.
-     *
-     * @returns True if transaction is active
-     */
-    isInTransaction(): boolean;
-    /**
-     * Get the number of staged operations in the current transaction.
-     *
-     * @returns Number of operations staged
-     */
-    getOperationCount(): number;
-    /**
-     * Ensure a transaction is in progress, or throw an error.
-     *
-     * @private
-     */
-    private ensureInTransaction;
-    /**
-     * Apply a single operation to the graph.
-     *
-     * @private
-     */
-    private applyOperation;
-}
-//# sourceMappingURL=TransactionManager.d.ts.map

package/dist/core/TransactionManager.d.ts.map

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