@nahisaho/yata-local 1.6.6

package/dist/database.d.ts

@@ -0,0 +1,229 @@
+/**
+ * YATA Local - SQLite Database Layer
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/database
+ *
+ * @see REQ-YL-STORE-001
+ * @see REQ-YL-STORE-002
+ * @see REQ-WSL-003
+ * @see REQ-NFR-001
+ */
+import type Database from 'better-sqlite3';
+import type { DatabaseConfig, Entity, EntityType, Relationship, GraphStats, LearnedPattern, PatternQueryOptions, LearningCycle, LearningCycleInput, LearningStats, LocalKGPR, LocalKGPRInput, LocalKGPRReview, LocalKGPRReviewInput, KGPRStatusLocal } from './types.js';
+/**
+ * Database layer for YATA Local
+ */
+export declare class YataDatabase {
+    private db;
+    private config;
+    constructor(config?: Partial<DatabaseConfig>);
+    /**
+     * Open database connection
+     * @see REQ-YL-STORE-001
+     */
+    open(): Promise<void>;
+    /**
+     * Close database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Check if database is open
+     */
+    isOpen(): boolean;
+    /**
+     * Get database instance (throws if not open)
+     * Made public for advanced query use cases
+     */
+    getDb(): Database.Database;
+    /**
+     * Insert entity
+     * @see REQ-YL-STORE-003
+     */
+    insertEntity(entity: Entity): void;
+    /**
+     * Insert multiple entities in transaction
+     * @see REQ-YL-STORE-005
+     */
+    insertEntities(entities: Entity[]): void;
+    /**
+     * Get entity by ID
+     */
+    getEntity(id: string): Entity | null;
+    /**
+     * Update entity
+     * @see REQ-YL-UPDATE-002
+     */
+    updateEntity(id: string, updates: Partial<Entity>): void;
+    /**
+     * Delete entity
+     * @see REQ-YL-UPDATE-003
+     */
+    deleteEntity(id: string): void;
+    /**
+     * Delete entities by file path
+     */
+    deleteEntitiesByFile(filePath: string): number;
+    /**
+     * Insert relationship
+     * @see REQ-YL-STORE-004
+     */
+    insertRelationship(rel: Relationship): void;
+    /**
+     * Get relationships for entity
+     */
+    getRelationships(entityId: string, direction?: 'in' | 'out' | 'both'): Relationship[];
+    /**
+     * Delete relationship
+     */
+    deleteRelationship(id: string): void;
+    /**
+     * Query entities with filters
+     * @see REQ-YL-QUERY-001
+     */
+    queryEntities(filters: {
+        type?: EntityType | EntityType[];
+        name?: string;
+        namePattern?: string;
+        namespace?: string;
+    }, limit?: number, offset?: number): {
+        entities: Entity[];
+        totalCount: number;
+    };
+    /**
+     * Full-text search
+     * @see REQ-YL-QUERY-005
+     */
+    searchEntities(text: string, limit?: number): Entity[];
+    /**
+     * Get changes since timestamp
+     * @see REQ-YL-UPDATE-005
+     */
+    getChangesSince(since: Date): {
+        entities: {
+            added: Entity[];
+            updated: Entity[];
+            deleted: string[];
+        };
+        relationships: {
+            added: Relationship[];
+            deleted: string[];
+        };
+    };
+    /**
+     * Get graph statistics
+     */
+    getStats(): GraphStats;
+    /**
+     * Insert a learned pattern
+     * @see REQ-WSL-001
+     */
+    insertPattern(pattern: LearnedPattern): void;
+    /**
+     * Get a pattern by ID
+     */
+    getPattern(id: string): LearnedPattern | null;
+    /**
+     * Update a pattern
+     */
+    updatePattern(pattern: LearnedPattern): void;
+    /**
+     * Upsert a pattern (insert or update)
+     * @see REQ-WSL-002
+     */
+    upsertPattern(pattern: LearnedPattern): void;
+    /**
+     * Delete a pattern
+     */
+    deletePattern(id: string): boolean;
+    /**
+     * Query patterns with options
+     * @see REQ-WSL-003
+     */
+    queryPatterns(options?: PatternQueryOptions): LearnedPattern[];
+    /**
+     * Get patterns that haven't been used recently
+     * @see REQ-WSL-003
+     */
+    getUnusedPatterns(monthsThreshold?: number): LearnedPattern[];
+    /**
+     * Get low confidence patterns
+     * @see REQ-WSL-003
+     */
+    getLowConfidencePatterns(threshold?: number): LearnedPattern[];
+    /**
+     * Mark pattern as used (update lastUsedAt)
+     * @see REQ-WSL-003
+     */
+    markPatternUsed(id: string): void;
+    /**
+     * Decay pattern confidence
+     * @see REQ-WSL-003
+     */
+    decayPatternConfidence(id: string, factor: number): void;
+    /**
+     * Get pattern count
+     */
+    getPatternCount(): number;
+    /**
+     * Log a learning cycle
+     * @see REQ-WSL-005
+     */
+    logLearningCycle(cycle: LearningCycleInput): LearningCycle;
+    /**
+     * Get recent learning cycles
+     * @see REQ-WSL-005
+     */
+    getRecentLearningCycles(limit?: number): LearningCycle[];
+    /**
+     * Get learning statistics
+     * @see REQ-WSL-005
+     */
+    getLearningStats(): LearningStats;
+    /**
+     * Insert a local KGPR record
+     */
+    insertKGPR(kgpr: LocalKGPRInput): void;
+    /**
+     * Get a KGPR by ID
+     */
+    getKGPR(id: string): LocalKGPR | null;
+    /**
+     * Update KGPR status
+     */
+    updateKGPRStatus(id: string, status: KGPRStatusLocal, timestamp?: Date): void;
+    /**
+     * List KGPRs with optional filters
+     */
+    listKGPRs(options?: {
+        status?: KGPRStatusLocal;
+        namespace?: string;
+        limit?: number;
+        offset?: number;
+    }): LocalKGPR[];
+    /**
+     * Insert a KGPR review
+     */
+    insertKGPRReview(review: LocalKGPRReviewInput): void;
+    /**
+     * Get reviews for a KGPR
+     */
+    getKGPRReviews(kgprId: string): LocalKGPRReview[];
+    /**
+     * Execute operations within a transaction
+     * @see REQ-NFR-002
+     */
+    withTransaction<T>(fn: () => T): T;
+    /**
+     * Execute async operations within a transaction
+     * @see REQ-NFR-002
+     */
+    withTransactionAsync<T>(fn: () => Promise<T>): Promise<T>;
+    private rowToEntity;
+    private rowToRelationship;
+    private logChange;
+    private rowToPattern;
+    private rowToLearningCycle;
+    private rowToKGPR;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

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