@utaba/deep-memory-storage-sqlserver 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,6 +1,7 @@
+import * as _utaba_deep_memory_types from '@utaba/deep-memory/types';
+import { StorageRepositoryConfig, StoredRepository, RepositoryFilter, PaginatedResult, StoredRepositorySummary, RepositoryUpdate, RepositoryStats, MemoryVocabulary, PaginationOptions, VocabularyChangeRecord, StoredEntity, StoredEntityUpdate, StorageFindQuery, StoredRelationship, RelationshipQueryOptions, StorageExploreOptions, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageTimelineOptions, StorageTimelineResult, ExportChunk, ImportChunk, BulkImportResult, SearchOptions, SearchHit } from '@utaba/deep-memory/types';
 import sql from 'mssql';
 import { StorageProvider, EnsureSchemaResult, SearchProvider, SearchableEntity } from '@utaba/deep-memory/providers';
-import { StorageRepositoryConfig, StoredRepository, RepositoryFilter, PaginatedResult, StoredRepositorySummary, RepositoryUpdate, RepositoryStats, MemoryVocabulary, PaginationOptions, VocabularyChangeRecord, StoredEntity, StoredEntityUpdate, StorageFindQuery, StoredRelationship, RelationshipQueryOptions, StorageExploreOptions, StorageNeighbourhood, StoragePathOptions, StoragePathResult, StorageTimelineOptions, StorageTimelineResult, ExportChunk, ImportChunk, BulkImportResult, SearchOptions, SearchHit } from '@utaba/deep-memory/types';
 
 /** Configuration for SqlServerStorageProvider */
 interface SqlServerStorageProviderConfig {
@@ -17,7 +18,7 @@ declare class SqlServerStorageProvider implements StorageProvider {
     constructor(config: SqlServerStorageProviderConfig);
     private t;
     private getPool;
-    initialise(): Promise<void>;
+    initialize(): Promise<void>;
     dispose(): Promise<void>;
     /**
      * Ensure the target database exists. If constructed with a sql.config and the
@@ -32,7 +33,11 @@ declare class SqlServerStorageProvider implements StorageProvider {
     getRepository(repositoryId: string): Promise<StoredRepository | null>;
     listRepositories(filter?: RepositoryFilter): Promise<PaginatedResult<StoredRepositorySummary>>;
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
-    deleteRepository(repositoryId: string): Promise<void>;
+    deleteRepository(repositoryId: string, _onProgress?: _utaba_deep_memory_types.DeleteProgressCallback): Promise<void>;
+    deleteAllContents(repositoryId: string, _onProgress?: _utaba_deep_memory_types.DeleteProgressCallback): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     getRepositoryStats(repositoryId: string): Promise<RepositoryStats>;
     getVocabulary(repositoryId: string): Promise<MemoryVocabulary>;
     saveVocabulary(repositoryId: string, vocabulary: MemoryVocabulary): Promise<void>;
@@ -60,11 +65,11 @@ declare class SqlServerStorageProvider implements StorageProvider {
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
-    exploreNeighbourhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighbourhood>;
+    exploreNeighborhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighborhood>;
     findPaths(repositoryId: string, sourceId: string, targetId: string, options: StoragePathOptions): Promise<StoragePathResult>;
     getTimeline(repositoryId: string, entityId: string, options: StorageTimelineOptions): Promise<StorageTimelineResult>;
     exportAll(repositoryId: string): AsyncIterable<ExportChunk>;
-    importBulk(repositoryId: string, data: ImportChunk[]): Promise<BulkImportResult>;
+    importBulk(repositoryId: string, data: ImportChunk[], _options?: _utaba_deep_memory_types.BulkImportOptions): Promise<BulkImportResult>;
     /** Creates a TVP table from an array of string IDs (eliminates plan cache bloat from IN clauses). */
     private createIdListTvp;
     /** Returns a StoredEntity without the embedding column (lighter I/O). */

package/dist/index.d.ts

@@ -1,6 +1,7 @@
+import * as _utaba_deep_memory_types from '@utaba/deep-memory/types';
+import { StorageRepositoryConfig, StoredRepository, RepositoryFilter, PaginatedResult, StoredRepositorySummary, RepositoryUpdate, RepositoryStats, MemoryVocabulary, PaginationOptions, VocabularyChangeRecord, StoredEntity, StoredEntityUpdate, StorageFindQuery, StoredRelationship, RelationshipQueryOptions, StorageExploreOptions, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageTimelineOptions, StorageTimelineResult, ExportChunk, ImportChunk, BulkImportResult, SearchOptions, SearchHit } from '@utaba/deep-memory/types';
 import sql from 'mssql';
 import { StorageProvider, EnsureSchemaResult, SearchProvider, SearchableEntity } from '@utaba/deep-memory/providers';
-import { StorageRepositoryConfig, StoredRepository, RepositoryFilter, PaginatedResult, StoredRepositorySummary, RepositoryUpdate, RepositoryStats, MemoryVocabulary, PaginationOptions, VocabularyChangeRecord, StoredEntity, StoredEntityUpdate, StorageFindQuery, StoredRelationship, RelationshipQueryOptions, StorageExploreOptions, StorageNeighbourhood, StoragePathOptions, StoragePathResult, StorageTimelineOptions, StorageTimelineResult, ExportChunk, ImportChunk, BulkImportResult, SearchOptions, SearchHit } from '@utaba/deep-memory/types';
 
 /** Configuration for SqlServerStorageProvider */
 interface SqlServerStorageProviderConfig {
@@ -17,7 +18,7 @@ declare class SqlServerStorageProvider implements StorageProvider {
     constructor(config: SqlServerStorageProviderConfig);
     private t;
     private getPool;
-    initialise(): Promise<void>;
+    initialize(): Promise<void>;
     dispose(): Promise<void>;
     /**
      * Ensure the target database exists. If constructed with a sql.config and the
@@ -32,7 +33,11 @@ declare class SqlServerStorageProvider implements StorageProvider {
     getRepository(repositoryId: string): Promise<StoredRepository | null>;
     listRepositories(filter?: RepositoryFilter): Promise<PaginatedResult<StoredRepositorySummary>>;
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
-    deleteRepository(repositoryId: string): Promise<void>;
+    deleteRepository(repositoryId: string, _onProgress?: _utaba_deep_memory_types.DeleteProgressCallback): Promise<void>;
+    deleteAllContents(repositoryId: string, _onProgress?: _utaba_deep_memory_types.DeleteProgressCallback): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     getRepositoryStats(repositoryId: string): Promise<RepositoryStats>;
     getVocabulary(repositoryId: string): Promise<MemoryVocabulary>;
     saveVocabulary(repositoryId: string, vocabulary: MemoryVocabulary): Promise<void>;
@@ -60,11 +65,11 @@ declare class SqlServerStorageProvider implements StorageProvider {
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
-    exploreNeighbourhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighbourhood>;
+    exploreNeighborhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighborhood>;
     findPaths(repositoryId: string, sourceId: string, targetId: string, options: StoragePathOptions): Promise<StoragePathResult>;
     getTimeline(repositoryId: string, entityId: string, options: StorageTimelineOptions): Promise<StorageTimelineResult>;
     exportAll(repositoryId: string): AsyncIterable<ExportChunk>;
-    importBulk(repositoryId: string, data: ImportChunk[]): Promise<BulkImportResult>;
+    importBulk(repositoryId: string, data: ImportChunk[], _options?: _utaba_deep_memory_types.BulkImportOptions): Promise<BulkImportResult>;
     /** Creates a TVP table from an array of string IDs (eliminates plan cache bloat from IN clauses). */
     private createIdListTvp;
     /** Returns a StoredEntity without the embedding column (lighter I/O). */

package/dist/index.js

@@ -406,13 +406,13 @@ var SqlServerStorageProvider = class {
   getPool() {
     if (!this.pool) {
       throw new ProviderError(
-        "SqlServerStorageProvider not initialised. Call initialise() first."
+        "SqlServerStorageProvider not initialized. Call initialize() first."
       );
     }
     return this.pool;
   }
   // ─── Lifecycle ────────────────────────────────────────────────────
-  async initialise() {
+  async initialize() {
     if (this.config.connection instanceof sql.ConnectionPool) {
       this.pool = this.config.connection;
       this.ownsPool = false;
@@ -667,13 +667,23 @@ var SqlServerStorageProvider = class {
     if (!updated) throw new RepositoryNotFoundError(repositoryId);
     return updated;
   }
-  async deleteRepository(repositoryId) {
+  async deleteRepository(repositoryId, _onProgress) {
     const pool = this.getPool();
     const result = await pool.request().input("id", sql.UniqueIdentifier, repositoryId).query(`DELETE FROM ${this.t("dm_repositories")} WHERE [repository_id] = @id`);
     if (result.rowsAffected[0] === 0) {
       throw new RepositoryNotFoundError(repositoryId);
     }
   }
+  async deleteAllContents(repositoryId, _onProgress) {
+    await this.assertRepository(repositoryId);
+    const pool = this.getPool();
+    const relResult = await pool.request().input("id", sql.UniqueIdentifier, repositoryId).query(`DELETE FROM ${this.t("dm_relationships")} WHERE [repository_id] = @id`);
+    const entityResult = await pool.request().input("id", sql.UniqueIdentifier, repositoryId).query(`DELETE FROM ${this.t("dm_entities")} WHERE [repository_id] = @id`);
+    return {
+      deletedEntities: entityResult.rowsAffected[0] ?? 0,
+      deletedRelationships: relResult.rowsAffected[0] ?? 0
+    };
+  }
   async getRepositoryStats(repositoryId) {
     await this.assertRepository(repositoryId);
     const pool = this.getPool();
@@ -1117,9 +1127,9 @@ var SqlServerStorageProvider = class {
     return { deletedRelationships: result.rowsAffected[0] ?? 0 };
   }
   // ─── Graph Traversal ────────────────────────────────────────────
-  async exploreNeighbourhood(repositoryId, entityId, options) {
-    const centre = await this.getEntityLight(repositoryId, entityId);
-    if (!centre) {
+  async exploreNeighborhood(repositoryId, entityId, options) {
+    const center = await this.getEntityLight(repositoryId, entityId);
+    if (!center) {
       throw new EntityNotFoundError(entityId);
     }
     const layers = [];
@@ -1181,7 +1191,7 @@ var SqlServerStorageProvider = class {
       currentFrontier = nextFrontier;
       if (nextFrontier.size === 0) break;
     }
-    return { centreId: entityId, layers };
+    return { centerId: entityId, layers };
   }
   async findPaths(repositoryId, sourceId, targetId, options) {
     const [source, target] = await Promise.all([
@@ -1363,7 +1373,7 @@ var SqlServerStorageProvider = class {
       }
     }
   }
-  async importBulk(repositoryId, data) {
+  async importBulk(repositoryId, data, _options) {
     await this.assertRepository(repositoryId);
     const pool = this.getPool();
     let entitiesImported = 0;
@@ -1563,7 +1573,7 @@ var SqlServerStorageProvider = class {
 // src/SqlServerSearchProvider.ts
 import sql2 from "mssql";
 import { ProviderError as ProviderError2 } from "@utaba/deep-memory";
-function normaliseRank(rank) {
+function normalizeRank(rank) {
   return Math.min(1, Math.max(0, rank / 1e3));
 }
 function buildHighlights(query, row) {
@@ -1663,7 +1673,7 @@ var SqlServerSearchProvider = class {
       const total = rows.length > 0 ? rows[0]["total_count"] : 0;
       const items = rows.map((row) => ({
         id: row["entity_id"],
-        score: normaliseRank(row["ft_rank"]),
+        score: normalizeRank(row["ft_rank"]),
         highlights: buildHighlights(query, row)
       }));
       return {