@danielsimonjr/memoryjs 1.0.0 → 1.2.0

package/dist/features/StreamingExporter.d.ts

@@ -1,128 +0,0 @@
-/**
- * Streaming Export Module
- *
- * Provides streaming export functionality for large knowledge graphs to avoid
- * loading entire graphs into memory. Supports JSONL and CSV formats with
- * incremental writing to disk.
- *
- * @module features/StreamingExporter
- */
-import type { ReadonlyKnowledgeGraph, LongRunningOperationOptions } from '../types/types.js';
-/**
- * Result summary from a streaming export operation.
- *
- * Provides statistics about the export including bytes written,
- * entity/relation counts, and duration.
- *
- * @example
- * ```typescript
- * const result: StreamResult = {
- *   bytesWritten: 125000,
- *   entitiesWritten: 150,
- *   relationsWritten: 320,
- *   durationMs: 1250
- * };
- * ```
- */
-export interface StreamResult {
-    /** Total bytes written to the output file */
-    bytesWritten: number;
-    /** Number of entities written */
-    entitiesWritten: number;
-    /** Number of relations written */
-    relationsWritten: number;
-    /** Duration of the export operation in milliseconds */
-    durationMs: number;
-}
-/**
- * Streaming exporter for knowledge graphs.
- *
- * Provides memory-efficient export by streaming data directly to files
- * instead of building large strings in memory. Supports JSONL and CSV formats.
- *
- * @example
- * ```typescript
- * const exporter = new StreamingExporter('/path/to/output.jsonl');
- * const result = await exporter.streamJSONL(graph);
- * console.log(`Wrote ${result.bytesWritten} bytes in ${result.durationMs}ms`);
- * ```
- */
-export declare class StreamingExporter {
-    private readonly validatedFilePath;
-    /**
-     * Create a new streaming exporter.
-     *
-     * @param filePath - Path to the output file
-     * @throws {FileOperationError} If path traversal is detected
-     */
-    constructor(filePath: string);
-    /**
-     * Get the validated file path.
-     */
-    get filePath(): string;
-    /**
-     * Stream a knowledge graph to JSONL format.
-     *
-     * Each entity and relation is written as a separate JSON line.
-     * Memory usage is constant regardless of graph size.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * @param graph - The knowledge graph to export
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Promise resolving to export statistics
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     *
-     * @example
-     * ```typescript
-     * const exporter = new StreamingExporter('export.jsonl');
-     * const result = await exporter.streamJSONL(graph);
-     * console.log(`Exported ${result.entitiesWritten} entities`);
-     *
-     * // With progress tracking (Phase 9B)
-     * const result = await exporter.streamJSONL(graph, {
-     *   onProgress: (p) => console.log(`${p.percentage}% complete`),
-     * });
-     * ```
-     */
-    streamJSONL(graph: ReadonlyKnowledgeGraph, options?: LongRunningOperationOptions): Promise<StreamResult>;
-    /**
-     * Stream a knowledge graph to CSV format.
-     *
-     * Exports entities as CSV rows with proper escaping for special characters.
-     * Header row includes: name, type, observations, tags, importance, createdAt, lastModified.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * @param graph - The knowledge graph to export
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Promise resolving to export statistics
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     *
-     * @example
-     * ```typescript
-     * const exporter = new StreamingExporter('export.csv');
-     * const result = await exporter.streamCSV(graph);
-     * console.log(`Exported ${result.entitiesWritten} entities as CSV`);
-     *
-     * // With progress tracking (Phase 9B)
-     * const result = await exporter.streamCSV(graph, {
-     *   onProgress: (p) => console.log(`${p.percentage}% complete`),
-     * });
-     * ```
-     */
-    streamCSV(graph: ReadonlyKnowledgeGraph, options?: LongRunningOperationOptions): Promise<StreamResult>;
-    /**
-     * Convert an entity to a CSV row with proper escaping.
-     *
-     * Escapes double quotes by doubling them and wraps fields in quotes.
-     * Arrays (observations, tags) are joined with semicolons.
-     *
-     * @param entity - The entity to convert
-     * @returns CSV row string (without trailing newline)
-     *
-     * @private
-     */
-    private entityToCSVRow;
-}
-//# sourceMappingURL=StreamingExporter.d.ts.map

package/dist/features/StreamingExporter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamingExporter.d.ts","sourceRoot":"","sources":["../../src/features/StreamingExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAU,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAGrG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAExB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C;;;;;OAKG;gBACS,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,WAAW,CACf,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,YAAY,CAAC;IA+DxB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CACb,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,YAAY,CAAC;IAuDxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;CAcvB"}

package/dist/features/StreamingExporter.js

@@ -1,212 +0,0 @@
-/**
- * Streaming Export Module
- *
- * Provides streaming export functionality for large knowledge graphs to avoid
- * loading entire graphs into memory. Supports JSONL and CSV formats with
- * incremental writing to disk.
- *
- * @module features/StreamingExporter
- */
-import { createWriteStream } from 'fs';
-import { checkCancellation, createProgressReporter, createProgress, validateFilePath } from '../utils/index.js';
-/**
- * Streaming exporter for knowledge graphs.
- *
- * Provides memory-efficient export by streaming data directly to files
- * instead of building large strings in memory. Supports JSONL and CSV formats.
- *
- * @example
- * ```typescript
- * const exporter = new StreamingExporter('/path/to/output.jsonl');
- * const result = await exporter.streamJSONL(graph);
- * console.log(`Wrote ${result.bytesWritten} bytes in ${result.durationMs}ms`);
- * ```
- */
-export class StreamingExporter {
-    validatedFilePath;
-    /**
-     * Create a new streaming exporter.
-     *
-     * @param filePath - Path to the output file
-     * @throws {FileOperationError} If path traversal is detected
-     */
-    constructor(filePath) {
-        // Validate path to prevent path traversal attacks
-        this.validatedFilePath = validateFilePath(filePath);
-    }
-    /**
-     * Get the validated file path.
-     */
-    get filePath() {
-        return this.validatedFilePath;
-    }
-    /**
-     * Stream a knowledge graph to JSONL format.
-     *
-     * Each entity and relation is written as a separate JSON line.
-     * Memory usage is constant regardless of graph size.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * @param graph - The knowledge graph to export
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Promise resolving to export statistics
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     *
-     * @example
-     * ```typescript
-     * const exporter = new StreamingExporter('export.jsonl');
-     * const result = await exporter.streamJSONL(graph);
-     * console.log(`Exported ${result.entitiesWritten} entities`);
-     *
-     * // With progress tracking (Phase 9B)
-     * const result = await exporter.streamJSONL(graph, {
-     *   onProgress: (p) => console.log(`${p.percentage}% complete`),
-     * });
-     * ```
-     */
-    async streamJSONL(graph, options) {
-        // Check for early cancellation
-        checkCancellation(options?.signal, 'streamJSONL');
-        // Setup progress reporter
-        const reportProgress = createProgressReporter(options?.onProgress);
-        const total = graph.entities.length + graph.relations.length;
-        let processed = 0;
-        reportProgress?.(createProgress(0, total, 'streamJSONL'));
-        const start = Date.now();
-        let bytesWritten = 0;
-        let entitiesWritten = 0;
-        let relationsWritten = 0;
-        const writeStream = createWriteStream(this.filePath);
-        // Write entities
-        for (const entity of graph.entities) {
-            // Check for cancellation periodically
-            checkCancellation(options?.signal, 'streamJSONL');
-            const line = JSON.stringify(entity) + '\n';
-            writeStream.write(line);
-            bytesWritten += Buffer.byteLength(line, 'utf-8');
-            entitiesWritten++;
-            processed++;
-            reportProgress?.(createProgress(processed, total, 'writing entities'));
-        }
-        // Write relations
-        for (const relation of graph.relations) {
-            // Check for cancellation periodically
-            checkCancellation(options?.signal, 'streamJSONL');
-            const line = JSON.stringify(relation) + '\n';
-            writeStream.write(line);
-            bytesWritten += Buffer.byteLength(line, 'utf-8');
-            relationsWritten++;
-            processed++;
-            reportProgress?.(createProgress(processed, total, 'writing relations'));
-        }
-        // Check for cancellation before finalizing
-        checkCancellation(options?.signal, 'streamJSONL');
-        // Wait for stream to finish
-        await new Promise((resolve, reject) => {
-            writeStream.end(() => resolve());
-            writeStream.on('error', reject);
-        });
-        // Report completion
-        reportProgress?.(createProgress(total, total, 'streamJSONL'));
-        return {
-            bytesWritten,
-            entitiesWritten,
-            relationsWritten,
-            durationMs: Date.now() - start,
-        };
-    }
-    /**
-     * Stream a knowledge graph to CSV format.
-     *
-     * Exports entities as CSV rows with proper escaping for special characters.
-     * Header row includes: name, type, observations, tags, importance, createdAt, lastModified.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * @param graph - The knowledge graph to export
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Promise resolving to export statistics
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     *
-     * @example
-     * ```typescript
-     * const exporter = new StreamingExporter('export.csv');
-     * const result = await exporter.streamCSV(graph);
-     * console.log(`Exported ${result.entitiesWritten} entities as CSV`);
-     *
-     * // With progress tracking (Phase 9B)
-     * const result = await exporter.streamCSV(graph, {
-     *   onProgress: (p) => console.log(`${p.percentage}% complete`),
-     * });
-     * ```
-     */
-    async streamCSV(graph, options) {
-        // Check for early cancellation
-        checkCancellation(options?.signal, 'streamCSV');
-        // Setup progress reporter
-        const reportProgress = createProgressReporter(options?.onProgress);
-        const total = graph.entities.length;
-        let processed = 0;
-        reportProgress?.(createProgress(0, total, 'streamCSV'));
-        const start = Date.now();
-        let bytesWritten = 0;
-        let entitiesWritten = 0;
-        const relationsWritten = 0; // CSV format doesn't export relations
-        const writeStream = createWriteStream(this.filePath);
-        // Write header
-        const header = 'name,type,observations,tags,importance,createdAt,lastModified\n';
-        writeStream.write(header);
-        bytesWritten += Buffer.byteLength(header, 'utf-8');
-        // Write entity rows
-        for (const entity of graph.entities) {
-            // Check for cancellation periodically
-            checkCancellation(options?.signal, 'streamCSV');
-            const row = this.entityToCSVRow(entity) + '\n';
-            writeStream.write(row);
-            bytesWritten += Buffer.byteLength(row, 'utf-8');
-            entitiesWritten++;
-            processed++;
-            reportProgress?.(createProgress(processed, total, 'writing entities'));
-        }
-        // Check for cancellation before finalizing
-        checkCancellation(options?.signal, 'streamCSV');
-        // Wait for stream to finish
-        await new Promise((resolve, reject) => {
-            writeStream.end(() => resolve());
-            writeStream.on('error', reject);
-        });
-        // Report completion
-        reportProgress?.(createProgress(total, total, 'streamCSV'));
-        return {
-            bytesWritten,
-            entitiesWritten,
-            relationsWritten,
-            durationMs: Date.now() - start,
-        };
-    }
-    /**
-     * Convert an entity to a CSV row with proper escaping.
-     *
-     * Escapes double quotes by doubling them and wraps fields in quotes.
-     * Arrays (observations, tags) are joined with semicolons.
-     *
-     * @param entity - The entity to convert
-     * @returns CSV row string (without trailing newline)
-     *
-     * @private
-     */
-    entityToCSVRow(entity) {
-        const escape = (s) => `"${s.replace(/"/g, '""')}"`;
-        return [
-            escape(entity.name),
-            escape(entity.entityType),
-            escape(entity.observations.join('; ')),
-            escape((entity.tags ?? []).join('; ')),
-            entity.importance?.toString() ?? '',
-            entity.createdAt ?? '',
-            entity.lastModified ?? '',
-        ].join(',');
-    }
-}
-//# sourceMappingURL=StreamingExporter.js.map

package/dist/features/StreamingExporter.js.map

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

package/dist/features/TagManager.d.ts

@@ -1,147 +0,0 @@
-/**
- * Tag Manager
- *
- * Manages tag aliases and canonical tag resolution.
- *
- * @module features/TagManager
- */
-import type { TagAlias } from '../types/index.js';
-/**
- * Manages tag alias system for synonym mapping.
- */
-export declare class TagManager {
-    private tagAliasesFilePath;
-    constructor(tagAliasesFilePath: string);
-    /**
-     * Load all tag aliases from JSONL file.
-     *
-     * @returns Array of tag aliases
-     */
-    private loadTagAliases;
-    /**
-     * Save tag aliases to JSONL file.
-     *
-     * @param aliases - Array of tag aliases
-     */
-    private saveTagAliases;
-    /**
-     * Resolve a tag through aliases to get its canonical form.
-     *
-     * This method follows the alias chain to find the canonical (main) tag name.
-     * All tags are normalized to lowercase for consistency.
-     * If the tag has no alias, it returns the tag itself as canonical.
-     *
-     * @param tag - Tag to resolve (can be alias or canonical)
-     * @returns Canonical tag name (lowercase)
-     *
-     * @example
-     * ```typescript
-     * const manager = new TagManager(tagAliasesPath);
-     *
-     * // Set up: assume "js" is aliased to "javascript"
-     * await manager.addTagAlias('js', 'javascript');
-     *
-     * // Resolve alias to canonical
-     * const canonical = await manager.resolveTag('js');
-     * console.log(canonical); // "javascript"
-     *
-     * // Resolve canonical tag (returns as-is)
-     * const unchanged = await manager.resolveTag('javascript');
-     * console.log(unchanged); // "javascript"
-     *
-     * // Resolve unknown tag (returns normalized)
-     * const unknown = await manager.resolveTag('PYTHON');
-     * console.log(unknown); // "python"
-     * ```
-     */
-    resolveTag(tag: string): Promise<string>;
-    /**
-     * Add a tag alias (synonym mapping).
-     *
-     * Creates a mapping from an alias (synonym) to a canonical (main) tag.
-     * This enables flexible tagging where users can use different terms
-     * that all resolve to the same canonical tag.
-     *
-     * Validation rules:
-     * - Prevents duplicate aliases (same alias can't map to different canonicals)
-     * - Prevents chained aliases (alias must point to canonical, not another alias)
-     * - All tags are normalized to lowercase
-     *
-     * @param alias - The alias/synonym (will be normalized to lowercase)
-     * @param canonical - The canonical (main) tag name (will be normalized to lowercase)
-     * @param description - Optional description explaining the alias relationship
-     * @returns Newly created TagAlias object with metadata
-     * @throws {Error} If alias already exists or would create chained aliases
-     *
-     * @example
-     * ```typescript
-     * const manager = new TagManager(tagAliasesPath);
-     *
-     * // Create simple alias
-     * await manager.addTagAlias('js', 'javascript', 'Common abbreviation');
-     *
-     * // Create multiple aliases for same canonical
-     * await manager.addTagAlias('py', 'python');
-     * await manager.addTagAlias('py3', 'python', 'Python 3.x');
-     *
-     * // Error: duplicate alias
-     * try {
-     *   await manager.addTagAlias('js', 'ecmascript'); // Fails - 'js' already aliased
-     * } catch (error) {
-     *   console.error('Alias already exists');
-     * }
-     *
-     * // Error: chained alias
-     * await manager.addTagAlias('js', 'javascript');
-     * try {
-     *   await manager.addTagAlias('javascript', 'ecmascript'); // Fails - can't alias canonical
-     * } catch (error) {
-     *   console.error('Cannot create chained aliases');
-     * }
-     * ```
-     */
-    addTagAlias(alias: string, canonical: string, description?: string): Promise<TagAlias>;
-    /**
-     * List all tag aliases.
-     *
-     * @returns Array of all tag aliases
-     */
-    listTagAliases(): Promise<TagAlias[]>;
-    /**
-     * Remove a tag alias.
-     *
-     * @param alias - Alias to remove
-     * @returns True if removed, false if not found
-     */
-    removeTagAlias(alias: string): Promise<boolean>;
-    /**
-     * Get all aliases (synonyms) for a canonical tag.
-     *
-     * Returns all alias names that resolve to the specified canonical tag.
-     * Useful for discovering alternative names users might use for a tag.
-     * The canonical tag name is normalized to lowercase.
-     *
-     * @param canonicalTag - Canonical tag name (will be normalized to lowercase)
-     * @returns Array of alias names (all lowercase)
-     *
-     * @example
-     * ```typescript
-     * const manager = new TagManager(tagAliasesPath);
-     *
-     * // Set up some aliases
-     * await manager.addTagAlias('js', 'javascript');
-     * await manager.addTagAlias('ecmascript', 'javascript');
-     * await manager.addTagAlias('es6', 'javascript');
-     *
-     * // Get all aliases for canonical tag
-     * const aliases = await manager.getAliasesForTag('javascript');
-     * console.log(aliases); // ['js', 'ecmascript', 'es6']
-     *
-     * // Empty array if no aliases
-     * const noAliases = await manager.getAliasesForTag('python');
-     * console.log(noAliases); // []
-     * ```
-     */
-    getAliasesForTag(canonicalTag: string): Promise<string[]>;
-}
-//# sourceMappingURL=TagManager.d.ts.map

package/dist/features/TagManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TagManager.d.ts","sourceRoot":"","sources":["../../src/features/TagManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,MAAM;IAE9C;;;;OAIG;YACW,cAAc;IAa5B;;;;OAIG;YACW,cAAc;IAK5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8B5F;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3C;;;;;OAKG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAKhE"}