@mzhub/mem-ts 0.1.0

package/dist/adapters/index.d.mts

@@ -0,0 +1,259 @@
+import { B as BaseAdapter } from '../BaseAdapter-BoRh1T7O.mjs';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-G9qmfSeZ.mjs';
+
+/**
+ * In-memory storage adapter for development and testing.
+ * Data is lost when the process exits.
+ */
+declare class InMemoryAdapter extends BaseAdapter {
+    private users;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    private getUserData;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Clear all data for a user (useful for testing)
+     */
+    clearUser(userId: string): Promise<void>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Export all data for a user (for portability)
+     */
+    exportUser(userId: string): Promise<{
+        facts: MemoryFact[];
+        conversations: ConversationExchange[];
+        sessions: Session[];
+    }>;
+    /**
+     * Import data for a user
+     */
+    importUser(userId: string, data: {
+        facts: MemoryFact[];
+        conversations: ConversationExchange[];
+        sessions: Session[];
+    }): Promise<void>;
+}
+
+interface JSONUserData {
+    facts: MemoryFact[];
+    conversations: ConversationExchange[];
+    sessions: Session[];
+}
+interface JSONFileAdapterConfig {
+    /** Base path for storing JSON files (default: ./.mem-ts) */
+    path?: string;
+    /** Pretty print JSON files (default: true in dev, false in prod) */
+    prettyPrint?: boolean;
+}
+/**
+ * JSON file-based storage adapter for MVP/single-server deployments.
+ * Stores each user's data in separate JSON files for portability.
+ *
+ * Directory structure:
+ * .mem-ts/
+ * ├── users/
+ * │   ├── {userId}/
+ * │   │   ├── facts.json
+ * │   │   ├── conversations.json
+ * │   │   └── sessions.json
+ */
+declare class JSONFileAdapter extends BaseAdapter {
+    private basePath;
+    private prettyPrint;
+    constructor(config?: JSONFileAdapterConfig);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    private getUserPath;
+    private ensureUserDir;
+    private readFile;
+    private writeFile;
+    private dateReviver;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Export all data for a user (for portability)
+     */
+    exportUser(userId: string): Promise<JSONUserData>;
+    /**
+     * Import data for a user
+     */
+    importUser(userId: string, data: JSONUserData): Promise<void>;
+    /**
+     * Delete all data for a user
+     */
+    deleteUser(userId: string): Promise<void>;
+}
+
+/**
+ * Configuration for MongoDB adapter
+ */
+interface MongoDBAdapterConfig {
+    /** MongoDB connection URI */
+    uri: string;
+    /** Database name */
+    database?: string;
+    /** Collection prefix (default: 'memts_') */
+    collectionPrefix?: string;
+}
+/**
+ * MongoDB storage adapter for production deployments.
+ * Requires: npm install mongodb
+ *
+ * Collections created:
+ * - memts_facts: User facts (knowledge graph)
+ * - memts_conversations: Conversation history
+ * - memts_sessions: Session metadata
+ */
+declare class MongoDBAdapter extends BaseAdapter {
+    private config;
+    private client;
+    private db;
+    private collectionPrefix;
+    constructor(config: MongoDBAdapterConfig);
+    private getClient;
+    private getCollection;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    private docToFact;
+    private docToConversation;
+    private docToSession;
+}
+
+/**
+ * Configuration for PostgreSQL adapter
+ */
+interface PostgresAdapterConfig {
+    /** PostgreSQL connection string */
+    connectionString: string;
+    /** Schema name (default: 'memts') */
+    schema?: string;
+    /** Enable pgvector for semantic search (requires pgvector extension) */
+    enableVector?: boolean;
+}
+/**
+ * PostgreSQL storage adapter for production deployments.
+ * Requires: npm install pg
+ *
+ * Tables created:
+ * - memts.facts: User facts (knowledge graph)
+ * - memts.conversations: Conversation history
+ * - memts.sessions: Session metadata
+ */
+declare class PostgresAdapter extends BaseAdapter {
+    private config;
+    private pool;
+    private schema;
+    constructor(config: PostgresAdapterConfig);
+    private getPool;
+    private query;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    private camelToSnake;
+    private rowToFact;
+    private rowToConversation;
+    private rowToSession;
+}
+
+/**
+ * Configuration for Upstash Redis adapter
+ */
+interface UpstashRedisAdapterConfig {
+    /** Upstash Redis REST URL */
+    url: string;
+    /** Upstash Redis REST Token */
+    token: string;
+    /** Key prefix (default: 'memts:') */
+    prefix?: string;
+    /** TTL for hot cache entries in seconds (default: 3600) */
+    cacheTtl?: number;
+}
+/**
+ * Upstash Redis adapter for serverless hot cache layer.
+ * Uses the Upstash REST API - no Redis connection needed.
+ *
+ * Key structure:
+ * - memts:{userId}:facts - Hash of facts
+ * - memts:{userId}:conversations - List of conversations
+ * - memts:{userId}:sessions - Hash of sessions
+ */
+declare class UpstashRedisAdapter extends BaseAdapter {
+    private config;
+    private prefix;
+    private defaultTtl;
+    constructor(config: UpstashRedisAdapterConfig);
+    private redis;
+    private key;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Set TTL on a user's data (useful for expiring cache)
+     * If no TTL is provided, uses the configured default TTL.
+     */
+    setUserTtl(userId: string, ttlSeconds?: number): Promise<void>;
+    /**
+     * Clear all data for a user
+     */
+    clearUser(userId: string): Promise<void>;
+}
+
+export { BaseAdapter, InMemoryAdapter, JSONFileAdapter, type JSONFileAdapterConfig, MongoDBAdapter, type MongoDBAdapterConfig, PostgresAdapter, type PostgresAdapterConfig, UpstashRedisAdapter, type UpstashRedisAdapterConfig };

package/dist/adapters/index.d.ts

@@ -0,0 +1,259 @@
+import { B as BaseAdapter } from '../BaseAdapter-CQVX-gcA.js';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-G9qmfSeZ.js';
+
+/**
+ * In-memory storage adapter for development and testing.
+ * Data is lost when the process exits.
+ */
+declare class InMemoryAdapter extends BaseAdapter {
+    private users;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    private getUserData;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Clear all data for a user (useful for testing)
+     */
+    clearUser(userId: string): Promise<void>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Export all data for a user (for portability)
+     */
+    exportUser(userId: string): Promise<{
+        facts: MemoryFact[];
+        conversations: ConversationExchange[];
+        sessions: Session[];
+    }>;
+    /**
+     * Import data for a user
+     */
+    importUser(userId: string, data: {
+        facts: MemoryFact[];
+        conversations: ConversationExchange[];
+        sessions: Session[];
+    }): Promise<void>;
+}
+
+interface JSONUserData {
+    facts: MemoryFact[];
+    conversations: ConversationExchange[];
+    sessions: Session[];
+}
+interface JSONFileAdapterConfig {
+    /** Base path for storing JSON files (default: ./.mem-ts) */
+    path?: string;
+    /** Pretty print JSON files (default: true in dev, false in prod) */
+    prettyPrint?: boolean;
+}
+/**
+ * JSON file-based storage adapter for MVP/single-server deployments.
+ * Stores each user's data in separate JSON files for portability.
+ *
+ * Directory structure:
+ * .mem-ts/
+ * ├── users/
+ * │   ├── {userId}/
+ * │   │   ├── facts.json
+ * │   │   ├── conversations.json
+ * │   │   └── sessions.json
+ */
+declare class JSONFileAdapter extends BaseAdapter {
+    private basePath;
+    private prettyPrint;
+    constructor(config?: JSONFileAdapterConfig);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    private getUserPath;
+    private ensureUserDir;
+    private readFile;
+    private writeFile;
+    private dateReviver;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Export all data for a user (for portability)
+     */
+    exportUser(userId: string): Promise<JSONUserData>;
+    /**
+     * Import data for a user
+     */
+    importUser(userId: string, data: JSONUserData): Promise<void>;
+    /**
+     * Delete all data for a user
+     */
+    deleteUser(userId: string): Promise<void>;
+}
+
+/**
+ * Configuration for MongoDB adapter
+ */
+interface MongoDBAdapterConfig {
+    /** MongoDB connection URI */
+    uri: string;
+    /** Database name */
+    database?: string;
+    /** Collection prefix (default: 'memts_') */
+    collectionPrefix?: string;
+}
+/**
+ * MongoDB storage adapter for production deployments.
+ * Requires: npm install mongodb
+ *
+ * Collections created:
+ * - memts_facts: User facts (knowledge graph)
+ * - memts_conversations: Conversation history
+ * - memts_sessions: Session metadata
+ */
+declare class MongoDBAdapter extends BaseAdapter {
+    private config;
+    private client;
+    private db;
+    private collectionPrefix;
+    constructor(config: MongoDBAdapterConfig);
+    private getClient;
+    private getCollection;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    private docToFact;
+    private docToConversation;
+    private docToSession;
+}
+
+/**
+ * Configuration for PostgreSQL adapter
+ */
+interface PostgresAdapterConfig {
+    /** PostgreSQL connection string */
+    connectionString: string;
+    /** Schema name (default: 'memts') */
+    schema?: string;
+    /** Enable pgvector for semantic search (requires pgvector extension) */
+    enableVector?: boolean;
+}
+/**
+ * PostgreSQL storage adapter for production deployments.
+ * Requires: npm install pg
+ *
+ * Tables created:
+ * - memts.facts: User facts (knowledge graph)
+ * - memts.conversations: Conversation history
+ * - memts.sessions: Session metadata
+ */
+declare class PostgresAdapter extends BaseAdapter {
+    private config;
+    private pool;
+    private schema;
+    constructor(config: PostgresAdapterConfig);
+    private getPool;
+    private query;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    private camelToSnake;
+    private rowToFact;
+    private rowToConversation;
+    private rowToSession;
+}
+
+/**
+ * Configuration for Upstash Redis adapter
+ */
+interface UpstashRedisAdapterConfig {
+    /** Upstash Redis REST URL */
+    url: string;
+    /** Upstash Redis REST Token */
+    token: string;
+    /** Key prefix (default: 'memts:') */
+    prefix?: string;
+    /** TTL for hot cache entries in seconds (default: 3600) */
+    cacheTtl?: number;
+}
+/**
+ * Upstash Redis adapter for serverless hot cache layer.
+ * Uses the Upstash REST API - no Redis connection needed.
+ *
+ * Key structure:
+ * - memts:{userId}:facts - Hash of facts
+ * - memts:{userId}:conversations - List of conversations
+ * - memts:{userId}:sessions - Hash of sessions
+ */
+declare class UpstashRedisAdapter extends BaseAdapter {
+    private config;
+    private prefix;
+    private defaultTtl;
+    constructor(config: UpstashRedisAdapterConfig);
+    private redis;
+    private key;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getFacts(userId: string, filter?: FactFilter): Promise<MemoryFact[]>;
+    getFactById(userId: string, factId: string): Promise<MemoryFact | null>;
+    upsertFact(userId: string, fact: Omit<MemoryFact, "id" | "createdAt" | "updatedAt">): Promise<MemoryFact>;
+    updateFact(userId: string, factId: string, updates: Partial<MemoryFact>): Promise<MemoryFact>;
+    deleteFact(userId: string, factId: string, _reason?: string): Promise<void>;
+    hardDeleteFact(userId: string, factId: string): Promise<void>;
+    getConversationHistory(userId: string, limit?: number, sessionId?: string): Promise<ConversationExchange[]>;
+    saveConversation(userId: string, exchange: Omit<ConversationExchange, "id">): Promise<ConversationExchange>;
+    getSessions(userId: string, limit?: number): Promise<Session[]>;
+    getSession(userId: string, sessionId: string): Promise<Session | null>;
+    createSession(userId: string): Promise<Session>;
+    endSession(userId: string, sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Set TTL on a user's data (useful for expiring cache)
+     * If no TTL is provided, uses the configured default TTL.
+     */
+    setUserTtl(userId: string, ttlSeconds?: number): Promise<void>;
+    /**
+     * Clear all data for a user
+     */
+    clearUser(userId: string): Promise<void>;
+}
+
+export { BaseAdapter, InMemoryAdapter, JSONFileAdapter, type JSONFileAdapterConfig, MongoDBAdapter, type MongoDBAdapterConfig, PostgresAdapter, type PostgresAdapterConfig, UpstashRedisAdapter, type UpstashRedisAdapterConfig };