@utaba/deep-memory 0.1.0

package/dist/testing/conformance.js

@@ -0,0 +1,332 @@
+// src/providers-builtin/conformance.ts
+import { describe, it, expect, beforeEach } from "vitest";
+function makeProvenance() {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    createdBy: "conformance-test",
+    createdByType: "agent",
+    createdAt: now,
+    modifiedBy: "conformance-test",
+    modifiedByType: "agent",
+    modifiedAt: now
+  };
+}
+function makeEntity(id, type = "test-type", label) {
+  return {
+    id,
+    slug: `${type}:${(label ?? id).toLowerCase().replace(/[^a-z0-9]+/g, "-")}`,
+    entityType: type,
+    label: label ?? id,
+    summary: `Summary for ${id}`,
+    properties: { key: "value" },
+    provenance: makeProvenance()
+  };
+}
+function makeRelationship(id, type, sourceId, targetId, bidirectional = false) {
+  return {
+    id,
+    relationshipType: type,
+    sourceEntityId: sourceId,
+    targetEntityId: targetId,
+    properties: {},
+    bidirectional,
+    provenance: makeProvenance()
+  };
+}
+function runStorageProviderConformanceTests(factory) {
+  const repoId = "40000000-0000-4000-a000-000000000001";
+  let provider;
+  async function setup() {
+    provider = await factory();
+    if (provider.initialise) await provider.initialise();
+    await provider.createRepository({
+      repositoryId: repoId,
+      label: "Conformance Test",
+      governanceConfig: { mode: "open" },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      createdBy: "conformance-test"
+    });
+  }
+  describe("StorageProvider Conformance Tests", () => {
+    beforeEach(async () => {
+      await setup();
+    });
+    describe("repository operations", () => {
+      it("creates a repository", async () => {
+        const repo = await provider.getRepository(repoId);
+        expect(repo).not.toBeNull();
+        expect(repo.repositoryId).toBe(repoId);
+        expect(repo.label).toBe("Conformance Test");
+      });
+      it("returns null for non-existent repository", async () => {
+        const repo = await provider.getRepository("ffffffff-ffff-4fff-afff-ffffffffffff");
+        expect(repo).toBeNull();
+      });
+      it("lists repositories", async () => {
+        const list = await provider.listRepositories();
+        expect(list.items.length).toBeGreaterThanOrEqual(1);
+        expect(list.items.some((r) => r.repositoryId === repoId)).toBe(true);
+      });
+      it("updates a repository", async () => {
+        const updated = await provider.updateRepository(repoId, {
+          label: "Updated Label",
+          description: "Updated description",
+          governanceConfig: { mode: "open", defaultSimilarityThreshold: 0.4 }
+        });
+        expect(updated.label).toBe("Updated Label");
+        expect(updated.description).toBe("Updated description");
+        expect(updated.governanceConfig.defaultSimilarityThreshold).toBe(0.4);
+        const fetched = await provider.getRepository(repoId);
+        expect(fetched.label).toBe("Updated Label");
+        expect(fetched.governanceConfig.defaultSimilarityThreshold).toBe(0.4);
+      });
+      it("deletes a repository", async () => {
+        await provider.deleteRepository(repoId);
+        expect(await provider.getRepository(repoId)).toBeNull();
+      });
+      it("returns repository stats", async () => {
+        const stats = await provider.getRepositoryStats(repoId);
+        expect(stats.entityCount).toBe(0);
+        expect(stats.relationshipCount).toBe(0);
+        expect(typeof stats.vocabularyVersion).toBe("string");
+      });
+    });
+    describe("vocabulary operations", () => {
+      it("gets and saves vocabulary", async () => {
+        const vocab = await provider.getVocabulary(repoId);
+        expect(vocab).toBeDefined();
+        expect(typeof vocab.version).toBe("string");
+        const updated = { ...vocab, version: "1.0.0" };
+        await provider.saveVocabulary(repoId, updated);
+        const fetched = await provider.getVocabulary(repoId);
+        expect(fetched.version).toBe("1.0.0");
+      });
+      it("returns vocabulary change log", async () => {
+        const log = await provider.getVocabularyChangeLog(repoId);
+        expect(Array.isArray(log.items)).toBe(true);
+      });
+    });
+    describe("entity operations", () => {
+      it("creates and retrieves an entity", async () => {
+        const entity = makeEntity("e1");
+        await provider.createEntity(repoId, entity);
+        const retrieved = await provider.getEntity(repoId, "e1");
+        expect(retrieved).not.toBeNull();
+        expect(retrieved.id).toBe("e1");
+        expect(retrieved.label).toBe("e1");
+      });
+      it("retrieves an entity by slug", async () => {
+        const entity = makeEntity("e1", "test-type", "Alpha");
+        await provider.createEntity(repoId, entity);
+        const retrieved = await provider.getEntityBySlug(repoId, entity.slug);
+        expect(retrieved).not.toBeNull();
+        expect(retrieved.id).toBe("e1");
+        expect(retrieved.slug).toBe(entity.slug);
+      });
+      it("returns null for non-existent entity", async () => {
+        const result = await provider.getEntity(repoId, "nonexistent");
+        expect(result).toBeNull();
+      });
+      it("returns null for non-existent slug", async () => {
+        const result = await provider.getEntityBySlug(repoId, "nonexistent:slug");
+        expect(result).toBeNull();
+      });
+      it("batch retrieves entities", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        await provider.createEntity(repoId, makeEntity("e2"));
+        const map = await provider.getEntities(repoId, ["e1", "e2", "missing"]);
+        expect(map.size).toBe(2);
+        expect(map.has("e1")).toBe(true);
+        expect(map.has("e2")).toBe(true);
+        expect(map.has("missing")).toBe(false);
+      });
+      it("updates an entity", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        const updated = await provider.updateEntity(repoId, "e1", {
+          label: "Updated Label",
+          provenance: makeProvenance()
+        });
+        expect(updated.label).toBe("Updated Label");
+        const fetched = await provider.getEntity(repoId, "e1");
+        expect(fetched.label).toBe("Updated Label");
+      });
+      it("deletes an entity", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        await provider.deleteEntity(repoId, "e1");
+        expect(await provider.getEntity(repoId, "e1")).toBeNull();
+      });
+      it("finds entities by search term", async () => {
+        await provider.createEntity(repoId, makeEntity("e1", "test-type", "Alpha"));
+        await provider.createEntity(repoId, makeEntity("e2", "test-type", "Beta"));
+        const result = await provider.findEntities(repoId, {
+          searchTerm: "alpha",
+          limit: 10,
+          offset: 0
+        });
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].label).toBe("Alpha");
+      });
+      it("finds entities by type filter", async () => {
+        await provider.createEntity(repoId, makeEntity("e1", "type-a", "A"));
+        await provider.createEntity(repoId, makeEntity("e2", "type-b", "B"));
+        const result = await provider.findEntities(repoId, {
+          entityTypes: ["type-a"],
+          limit: 10,
+          offset: 0
+        });
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].entityType).toBe("type-a");
+      });
+      it("paginates find results", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        await provider.createEntity(repoId, makeEntity("e2"));
+        await provider.createEntity(repoId, makeEntity("e3"));
+        const page1 = await provider.findEntities(repoId, { limit: 2, offset: 0 });
+        expect(page1.items).toHaveLength(2);
+        expect(page1.hasMore).toBe(true);
+        const page2 = await provider.findEntities(repoId, { limit: 2, offset: 2 });
+        expect(page2.items).toHaveLength(1);
+        expect(page2.hasMore).toBe(false);
+      });
+    });
+    describe("relationship operations", () => {
+      beforeEach(async () => {
+        await provider.createEntity(repoId, makeEntity("a"));
+        await provider.createEntity(repoId, makeEntity("b"));
+        await provider.createEntity(repoId, makeEntity("c"));
+      });
+      it("creates and retrieves a relationship", async () => {
+        const rel = makeRelationship("r1", "connects", "a", "b");
+        await provider.createRelationship(repoId, rel);
+        const retrieved = await provider.getRelationship(repoId, "r1");
+        expect(retrieved).not.toBeNull();
+        expect(retrieved.sourceEntityId).toBe("a");
+        expect(retrieved.targetEntityId).toBe("b");
+      });
+      it("returns null for non-existent relationship", async () => {
+        expect(await provider.getRelationship(repoId, "nonexistent")).toBeNull();
+      });
+      it("gets entity relationships", async () => {
+        await provider.createRelationship(repoId, makeRelationship("r1", "connects", "a", "b"));
+        await provider.createRelationship(repoId, makeRelationship("r2", "connects", "c", "a"));
+        const result = await provider.getEntityRelationships(repoId, "a");
+        expect(result.items).toHaveLength(2);
+      });
+      it("filters relationships by direction", async () => {
+        await provider.createRelationship(repoId, makeRelationship("r1", "connects", "a", "b"));
+        await provider.createRelationship(repoId, makeRelationship("r2", "connects", "c", "a"));
+        const outbound = await provider.getEntityRelationships(repoId, "a", { direction: "outbound" });
+        expect(outbound.items).toHaveLength(1);
+        expect(outbound.items[0].targetEntityId).toBe("b");
+        const inbound = await provider.getEntityRelationships(repoId, "a", { direction: "inbound" });
+        expect(inbound.items).toHaveLength(1);
+        expect(inbound.items[0].sourceEntityId).toBe("c");
+      });
+      it("deletes a relationship", async () => {
+        await provider.createRelationship(repoId, makeRelationship("r1", "connects", "a", "b"));
+        await provider.deleteRelationship(repoId, "r1");
+        expect(await provider.getRelationship(repoId, "r1")).toBeNull();
+      });
+    });
+    describe("graph traversal", () => {
+      beforeEach(async () => {
+        await provider.createEntity(repoId, makeEntity("a", "node", "A"));
+        await provider.createEntity(repoId, makeEntity("b", "node", "B"));
+        await provider.createEntity(repoId, makeEntity("c", "node", "C"));
+        await provider.createRelationship(repoId, makeRelationship("r1", "links", "a", "b"));
+        await provider.createRelationship(repoId, makeRelationship("r2", "links", "b", "c"));
+      });
+      it("explores neighbourhood at depth 1", async () => {
+        const result = await provider.exploreNeighbourhood(repoId, "a", {
+          depth: 1,
+          direction: "both",
+          limitPerType: 10,
+          offsetPerType: 0
+        });
+        expect(result.centreId).toBe("a");
+        expect(result.layers).toHaveLength(1);
+      });
+      it("finds paths between connected entities", async () => {
+        const result = await provider.findPaths(repoId, "a", "c", {
+          maxDepth: 3,
+          limit: 5,
+          offset: 0
+        });
+        expect(result.paths.length).toBeGreaterThanOrEqual(1);
+        const firstPath = result.paths[0];
+        expect(firstPath.entityIds[0]).toBe("a");
+        expect(firstPath.entityIds[firstPath.entityIds.length - 1]).toBe("c");
+      });
+      it("returns empty paths when no connection", async () => {
+        await provider.createEntity(repoId, makeEntity("isolated", "node", "Isolated"));
+        const result = await provider.findPaths(repoId, "a", "isolated", {
+          maxDepth: 3,
+          limit: 5,
+          offset: 0
+        });
+        expect(result.paths).toHaveLength(0);
+      });
+      it("finds paths through non-bidirectional inbound edges", async () => {
+        await provider.createEntity(repoId, makeEntity("d", "node", "D"));
+        await provider.createRelationship(repoId, makeRelationship("r3", "links", "d", "b"));
+        const result = await provider.findPaths(repoId, "a", "d", {
+          maxDepth: 3,
+          limit: 5,
+          offset: 0
+        });
+        expect(result.paths.length).toBeGreaterThanOrEqual(1);
+        const firstPath = result.paths[0];
+        expect(firstPath.entityIds[0]).toBe("a");
+        expect(firstPath.entityIds[firstPath.entityIds.length - 1]).toBe("d");
+      });
+    });
+    describe("timeline", () => {
+      it("returns timeline events", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        const result = await provider.getTimeline(repoId, "e1", {
+          limit: 10,
+          offset: 0
+        });
+        expect(result.events.length).toBeGreaterThanOrEqual(1);
+      });
+    });
+    describe("bulk operations", () => {
+      it("exports data", async () => {
+        await provider.createEntity(repoId, makeEntity("e1"));
+        const chunks = [];
+        for await (const chunk of provider.exportAll(repoId)) {
+          chunks.push(chunk);
+        }
+        expect(chunks.length).toBeGreaterThanOrEqual(1);
+      });
+      it("imports data", async () => {
+        const result = await provider.importBulk(repoId, [
+          { entities: [makeEntity("imported-1"), makeEntity("imported-2")] },
+          { relationships: [makeRelationship("ir1", "links", "imported-1", "imported-2")] }
+        ]);
+        expect(result.entitiesImported).toBe(2);
+        expect(result.relationshipsImported).toBe(1);
+        const e = await provider.getEntity(repoId, "imported-1");
+        expect(e).not.toBeNull();
+      });
+    });
+    describe("stats reflect data", () => {
+      it("counts entities and relationships", async () => {
+        await provider.createEntity(repoId, makeEntity("e1", "alpha"));
+        await provider.createEntity(repoId, makeEntity("e2", "alpha"));
+        await provider.createEntity(repoId, makeEntity("e3", "beta"));
+        await provider.createRelationship(repoId, makeRelationship("r1", "links", "e1", "e2"));
+        const stats = await provider.getRepositoryStats(repoId);
+        expect(stats.entityCount).toBe(3);
+        expect(stats.relationshipCount).toBe(1);
+        expect(stats.entityTypeBreakdown["alpha"]).toBe(2);
+        expect(stats.entityTypeBreakdown["beta"]).toBe(1);
+        expect(stats.relationshipTypeBreakdown["links"]).toBe(1);
+      });
+    });
+  });
+}
+export {
+  runStorageProviderConformanceTests
+};
+//# sourceMappingURL=conformance.js.map

package/dist/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers-builtin/conformance.ts"],"sourcesContent":["// Provider Conformance Test Suite\n// Any StorageProvider implementer can import and run these tests to verify conformance.\n//\n// Usage:\n//   import { runStorageProviderConformanceTests } from '@utaba/deep-memory';\n//   runStorageProviderConformanceTests(() => new MyStorageProvider());\n\nimport { describe, it, expect, beforeEach } from 'vitest';\nimport type { StorageProvider } from '../providers/StorageProvider.js';\nimport type { StoredEntity } from '../types/entities.js';\nimport type { StoredRelationship } from '../types/relationships.js';\nimport type { Provenance } from '../types/provenance.js';\n\nfunction makeProvenance(): Provenance {\n  const now = new Date().toISOString();\n  return {\n    createdBy: 'conformance-test',\n    createdByType: 'agent',\n    createdAt: now,\n    modifiedBy: 'conformance-test',\n    modifiedByType: 'agent',\n    modifiedAt: now,\n  };\n}\n\nfunction makeEntity(id: string, type = 'test-type', label?: string): StoredEntity {\n  return {\n    id,\n    slug: `${type}:${(label ?? id).toLowerCase().replace(/[^a-z0-9]+/g, '-')}`,\n    entityType: type,\n    label: label ?? id,\n    summary: `Summary for ${id}`,\n    properties: { key: 'value' },\n    provenance: makeProvenance(),\n  };\n}\n\nfunction makeRelationship(\n  id: string,\n  type: string,\n  sourceId: string,\n  targetId: string,\n  bidirectional = false,\n): StoredRelationship {\n  return {\n    id,\n    relationshipType: type,\n    sourceEntityId: sourceId,\n    targetEntityId: targetId,\n    properties: {},\n    bidirectional,\n    provenance: makeProvenance(),\n  };\n}\n\n/**\n * Run the full StorageProvider conformance test suite.\n *\n * @param factory - A function that creates a fresh, empty StorageProvider instance.\n *                  Called before each test to ensure isolation.\n */\nexport function runStorageProviderConformanceTests(\n  factory: () => StorageProvider | Promise<StorageProvider>,\n): void {\n  // Use a stable GUID so external cleanup scripts can target it\n  const repoId = '40000000-0000-4000-a000-000000000001';\n\n  let provider: StorageProvider;\n\n  async function setup(): Promise<void> {\n    provider = await factory();\n    if (provider.initialise) await provider.initialise();\n\n    await provider.createRepository({\n      repositoryId: repoId,\n      label: 'Conformance Test',\n      governanceConfig: { mode: 'open' },\n      createdAt: new Date().toISOString(),\n      createdBy: 'conformance-test',\n    });\n  }\n\n  describe('StorageProvider Conformance Tests', () => {\n    beforeEach(async () => {\n      await setup();\n    });\n\n    // ─── Repository ─────────────────────────────────────────\n\n    describe('repository operations', () => {\n      it('creates a repository', async () => {\n        const repo = await provider.getRepository(repoId);\n        expect(repo).not.toBeNull();\n        expect(repo!.repositoryId).toBe(repoId);\n        expect(repo!.label).toBe('Conformance Test');\n      });\n\n      it('returns null for non-existent repository', async () => {\n        const repo = await provider.getRepository('ffffffff-ffff-4fff-afff-ffffffffffff');\n        expect(repo).toBeNull();\n      });\n\n      it('lists repositories', async () => {\n        const list = await provider.listRepositories();\n        expect(list.items.length).toBeGreaterThanOrEqual(1);\n        expect(list.items.some((r) => r.repositoryId === repoId)).toBe(true);\n      });\n\n      it('updates a repository', async () => {\n        const updated = await provider.updateRepository(repoId, {\n          label: 'Updated Label',\n          description: 'Updated description',\n          governanceConfig: { mode: 'open', defaultSimilarityThreshold: 0.4 },\n        });\n        expect(updated.label).toBe('Updated Label');\n        expect(updated.description).toBe('Updated description');\n        expect(updated.governanceConfig.defaultSimilarityThreshold).toBe(0.4);\n\n        // Verify persistence\n        const fetched = await provider.getRepository(repoId);\n        expect(fetched!.label).toBe('Updated Label');\n        expect(fetched!.governanceConfig.defaultSimilarityThreshold).toBe(0.4);\n      });\n\n      it('deletes a repository', async () => {\n        await provider.deleteRepository(repoId);\n        expect(await provider.getRepository(repoId)).toBeNull();\n      });\n\n      it('returns repository stats', async () => {\n        const stats = await provider.getRepositoryStats(repoId);\n        expect(stats.entityCount).toBe(0);\n        expect(stats.relationshipCount).toBe(0);\n        expect(typeof stats.vocabularyVersion).toBe('string');\n      });\n    });\n\n    // ─── Vocabulary ─────────────────────────────────────────\n\n    describe('vocabulary operations', () => {\n      it('gets and saves vocabulary', async () => {\n        const vocab = await provider.getVocabulary(repoId);\n        expect(vocab).toBeDefined();\n        expect(typeof vocab.version).toBe('string');\n\n        const updated = { ...vocab, version: '1.0.0' };\n        await provider.saveVocabulary(repoId, updated);\n\n        const fetched = await provider.getVocabulary(repoId);\n        expect(fetched.version).toBe('1.0.0');\n      });\n\n      it('returns vocabulary change log', async () => {\n        const log = await provider.getVocabularyChangeLog(repoId);\n        expect(Array.isArray(log.items)).toBe(true);\n      });\n    });\n\n    // ─── Entities ───────────────────────────────────────────\n\n    describe('entity operations', () => {\n      it('creates and retrieves an entity', async () => {\n        const entity = makeEntity('e1');\n        await provider.createEntity(repoId, entity);\n\n        const retrieved = await provider.getEntity(repoId, 'e1');\n        expect(retrieved).not.toBeNull();\n        expect(retrieved!.id).toBe('e1');\n        expect(retrieved!.label).toBe('e1');\n      });\n\n      it('retrieves an entity by slug', async () => {\n        const entity = makeEntity('e1', 'test-type', 'Alpha');\n        await provider.createEntity(repoId, entity);\n\n        const retrieved = await provider.getEntityBySlug(repoId, entity.slug);\n        expect(retrieved).not.toBeNull();\n        expect(retrieved!.id).toBe('e1');\n        expect(retrieved!.slug).toBe(entity.slug);\n      });\n\n      it('returns null for non-existent entity', async () => {\n        const result = await provider.getEntity(repoId, 'nonexistent');\n        expect(result).toBeNull();\n      });\n\n      it('returns null for non-existent slug', async () => {\n        const result = await provider.getEntityBySlug(repoId, 'nonexistent:slug');\n        expect(result).toBeNull();\n      });\n\n      it('batch retrieves entities', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n        await provider.createEntity(repoId, makeEntity('e2'));\n\n        const map = await provider.getEntities(repoId, ['e1', 'e2', 'missing']);\n        expect(map.size).toBe(2);\n        expect(map.has('e1')).toBe(true);\n        expect(map.has('e2')).toBe(true);\n        expect(map.has('missing')).toBe(false);\n      });\n\n      it('updates an entity', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n        const updated = await provider.updateEntity(repoId, 'e1', {\n          label: 'Updated Label',\n          provenance: makeProvenance(),\n        });\n        expect(updated.label).toBe('Updated Label');\n\n        const fetched = await provider.getEntity(repoId, 'e1');\n        expect(fetched!.label).toBe('Updated Label');\n      });\n\n      it('deletes an entity', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n        await provider.deleteEntity(repoId, 'e1');\n        expect(await provider.getEntity(repoId, 'e1')).toBeNull();\n      });\n\n      it('finds entities by search term', async () => {\n        await provider.createEntity(repoId, makeEntity('e1', 'test-type', 'Alpha'));\n        await provider.createEntity(repoId, makeEntity('e2', 'test-type', 'Beta'));\n\n        const result = await provider.findEntities(repoId, {\n          searchTerm: 'alpha',\n          limit: 10,\n          offset: 0,\n        });\n        expect(result.items).toHaveLength(1);\n        expect(result.items[0]!.label).toBe('Alpha');\n      });\n\n      it('finds entities by type filter', async () => {\n        await provider.createEntity(repoId, makeEntity('e1', 'type-a', 'A'));\n        await provider.createEntity(repoId, makeEntity('e2', 'type-b', 'B'));\n\n        const result = await provider.findEntities(repoId, {\n          entityTypes: ['type-a'],\n          limit: 10,\n          offset: 0,\n        });\n        expect(result.items).toHaveLength(1);\n        expect(result.items[0]!.entityType).toBe('type-a');\n      });\n\n      it('paginates find results', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n        await provider.createEntity(repoId, makeEntity('e2'));\n        await provider.createEntity(repoId, makeEntity('e3'));\n\n        const page1 = await provider.findEntities(repoId, { limit: 2, offset: 0 });\n        expect(page1.items).toHaveLength(2);\n        expect(page1.hasMore).toBe(true);\n\n        const page2 = await provider.findEntities(repoId, { limit: 2, offset: 2 });\n        expect(page2.items).toHaveLength(1);\n        expect(page2.hasMore).toBe(false);\n      });\n    });\n\n    // ─── Relationships ──────────────────────────────────────\n\n    describe('relationship operations', () => {\n      beforeEach(async () => {\n        await provider.createEntity(repoId, makeEntity('a'));\n        await provider.createEntity(repoId, makeEntity('b'));\n        await provider.createEntity(repoId, makeEntity('c'));\n      });\n\n      it('creates and retrieves a relationship', async () => {\n        const rel = makeRelationship('r1', 'connects', 'a', 'b');\n        await provider.createRelationship(repoId, rel);\n\n        const retrieved = await provider.getRelationship(repoId, 'r1');\n        expect(retrieved).not.toBeNull();\n        expect(retrieved!.sourceEntityId).toBe('a');\n        expect(retrieved!.targetEntityId).toBe('b');\n      });\n\n      it('returns null for non-existent relationship', async () => {\n        expect(await provider.getRelationship(repoId, 'nonexistent')).toBeNull();\n      });\n\n      it('gets entity relationships', async () => {\n        await provider.createRelationship(repoId, makeRelationship('r1', 'connects', 'a', 'b'));\n        await provider.createRelationship(repoId, makeRelationship('r2', 'connects', 'c', 'a'));\n\n        const result = await provider.getEntityRelationships(repoId, 'a');\n        expect(result.items).toHaveLength(2);\n      });\n\n      it('filters relationships by direction', async () => {\n        await provider.createRelationship(repoId, makeRelationship('r1', 'connects', 'a', 'b'));\n        await provider.createRelationship(repoId, makeRelationship('r2', 'connects', 'c', 'a'));\n\n        const outbound = await provider.getEntityRelationships(repoId, 'a', { direction: 'outbound' });\n        expect(outbound.items).toHaveLength(1);\n        expect(outbound.items[0]!.targetEntityId).toBe('b');\n\n        const inbound = await provider.getEntityRelationships(repoId, 'a', { direction: 'inbound' });\n        expect(inbound.items).toHaveLength(1);\n        expect(inbound.items[0]!.sourceEntityId).toBe('c');\n      });\n\n      it('deletes a relationship', async () => {\n        await provider.createRelationship(repoId, makeRelationship('r1', 'connects', 'a', 'b'));\n        await provider.deleteRelationship(repoId, 'r1');\n        expect(await provider.getRelationship(repoId, 'r1')).toBeNull();\n      });\n    });\n\n    // ─── Graph Traversal ────────────────────────────────────\n\n    describe('graph traversal', () => {\n      beforeEach(async () => {\n        await provider.createEntity(repoId, makeEntity('a', 'node', 'A'));\n        await provider.createEntity(repoId, makeEntity('b', 'node', 'B'));\n        await provider.createEntity(repoId, makeEntity('c', 'node', 'C'));\n        await provider.createRelationship(repoId, makeRelationship('r1', 'links', 'a', 'b'));\n        await provider.createRelationship(repoId, makeRelationship('r2', 'links', 'b', 'c'));\n      });\n\n      it('explores neighbourhood at depth 1', async () => {\n        const result = await provider.exploreNeighbourhood(repoId, 'a', {\n          depth: 1,\n          direction: 'both',\n          limitPerType: 10,\n          offsetPerType: 0,\n        });\n        expect(result.centreId).toBe('a');\n        expect(result.layers).toHaveLength(1);\n      });\n\n      it('finds paths between connected entities', async () => {\n        const result = await provider.findPaths(repoId, 'a', 'c', {\n          maxDepth: 3,\n          limit: 5,\n          offset: 0,\n        });\n        expect(result.paths.length).toBeGreaterThanOrEqual(1);\n        const firstPath = result.paths[0]!;\n        expect(firstPath.entityIds[0]).toBe('a');\n        expect(firstPath.entityIds[firstPath.entityIds.length - 1]).toBe('c');\n      });\n\n      it('returns empty paths when no connection', async () => {\n        await provider.createEntity(repoId, makeEntity('isolated', 'node', 'Isolated'));\n        const result = await provider.findPaths(repoId, 'a', 'isolated', {\n          maxDepth: 3,\n          limit: 5,\n          offset: 0,\n        });\n        expect(result.paths).toHaveLength(0);\n      });\n\n      it('finds paths through non-bidirectional inbound edges', async () => {\n        // Graph: a → b ← d (both edges are non-bidirectional)\n        // Path from a to d should traverse: a →(outbound) b ←(inbound) d\n        await provider.createEntity(repoId, makeEntity('d', 'node', 'D'));\n        await provider.createRelationship(repoId, makeRelationship('r3', 'links', 'd', 'b'));\n        const result = await provider.findPaths(repoId, 'a', 'd', {\n          maxDepth: 3,\n          limit: 5,\n          offset: 0,\n        });\n        expect(result.paths.length).toBeGreaterThanOrEqual(1);\n        const firstPath = result.paths[0]!;\n        expect(firstPath.entityIds[0]).toBe('a');\n        expect(firstPath.entityIds[firstPath.entityIds.length - 1]).toBe('d');\n      });\n    });\n\n    // ─── Timeline ───────────────────────────────────────────\n\n    describe('timeline', () => {\n      it('returns timeline events', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n        const result = await provider.getTimeline(repoId, 'e1', {\n          limit: 10,\n          offset: 0,\n        });\n        expect(result.events.length).toBeGreaterThanOrEqual(1);\n      });\n    });\n\n    // ─── Bulk Operations ────────────────────────────────────\n\n    describe('bulk operations', () => {\n      it('exports data', async () => {\n        await provider.createEntity(repoId, makeEntity('e1'));\n\n        const chunks = [];\n        for await (const chunk of provider.exportAll(repoId)) {\n          chunks.push(chunk);\n        }\n        expect(chunks.length).toBeGreaterThanOrEqual(1);\n      });\n\n      it('imports data', async () => {\n        const result = await provider.importBulk(repoId, [\n          { entities: [makeEntity('imported-1'), makeEntity('imported-2')] },\n          { relationships: [makeRelationship('ir1', 'links', 'imported-1', 'imported-2')] },\n        ]);\n        expect(result.entitiesImported).toBe(2);\n        expect(result.relationshipsImported).toBe(1);\n\n        // Verify imported data is accessible\n        const e = await provider.getEntity(repoId, 'imported-1');\n        expect(e).not.toBeNull();\n      });\n    });\n\n    // ─── Stats after data ───────────────────────────────────\n\n    describe('stats reflect data', () => {\n      it('counts entities and relationships', async () => {\n        await provider.createEntity(repoId, makeEntity('e1', 'alpha'));\n        await provider.createEntity(repoId, makeEntity('e2', 'alpha'));\n        await provider.createEntity(repoId, makeEntity('e3', 'beta'));\n        await provider.createRelationship(repoId, makeRelationship('r1', 'links', 'e1', 'e2'));\n\n        const stats = await provider.getRepositoryStats(repoId);\n        expect(stats.entityCount).toBe(3);\n        expect(stats.relationshipCount).toBe(1);\n        expect(stats.entityTypeBreakdown['alpha']).toBe(2);\n        expect(stats.entityTypeBreakdown['beta']).toBe(1);\n        expect(stats.relationshipTypeBreakdown['links']).toBe(1);\n      });\n    });\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/types/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Type re-exports — @utaba/deep-memory/types\n\nexport type {\n  ProvenanceContext,\n  Provenance,\n} from './provenance.js';\n\nexport type {\n  PropertyType,\n  PropertySchema,\n  EntityTypeDefinition,\n  RelationshipTypeDefinition,\n  MemoryVocabulary,\n  GovernanceMode,\n  GovernanceConfig,\n  VocabularyProposal,\n  VocabularyProposalResult,\n  VocabularyChangeRecord,\n  ResolvedVocabulary,\n  EntityTypeInput,\n  RelationshipTypeInput,\n  VocabularyInput,\n} from './vocabulary.js';\n\nexport type {\n  DetailLevel,\n  Entity,\n  EntitySummary,\n  EntityBrief,\n  CreateEntityInput,\n  UpdateEntityInput,\n  StoredEntity,\n  StoredEntityUpdate,\n  GetEntityOptions,\n  GetEntitiesOptions,\n} from './entities.js';\n\nexport type {\n  RelationshipDirection,\n  Relationship,\n  EnrichedRelationship,\n  CreateRelationshipInput,\n  StoredRelationship,\n  RelationshipQueryOptions,\n  RelationshipSummary,\n} from './relationships.js';\n\nexport type {\n  RepositoryConfig,\n  RepositoryMetadata,\n  RepositoryUpdate,\n  RepositorySummary,\n  RepositoryStats,\n  StoredRepository,\n  StoredRepositorySummary,\n  RepositoryFilter,\n  StorageRepositoryConfig,\n} from './repositories.js';\n\nexport type {\n  PaginationOptions,\n  FindEntitiesQuery,\n  ExploreOptions,\n  PathOptions,\n  ConceptSearchOptions,\n  TimelineOptions,\n  StorageFindQuery,\n  StorageExploreOptions,\n  StoragePathOptions,\n  StorageTimelineOptions,\n  SearchOptions,\n  PropertyFilter,\n  ProvenanceFilter,\n} from './queries.js';\n\nexport type {\n  PaginatedResult,\n  NeighbourhoodCentre,\n  NeighbourhoodGroup,\n  NeighbourhoodLayer,\n  Neighbourhood,\n  Path,\n  PathResult,\n  ScoredEntity,\n  TimelineEntityRef,\n  TimelineRelationshipDetail,\n  TimelineEvent,\n  TimelineResult,\n  GraphResult,\n  EntityMap,\n  StorageNeighbourhoodGroup,\n  StorageNeighbourhoodLayer,\n  StorageNeighbourhood,\n  StoragePath,\n  StoragePathResult,\n  StorageTimelineEvent,\n  StorageTimelineResult,\n  SearchHit,\n  BulkImportResult,\n  ReembedResult,\n} from './results.js';\n\nexport type {\n  DeepMemoryEventType,\n  EventPayload,\n  DeepMemoryEvent,\n  EventHandler,\n  Unsubscribe,\n  HookResult,\n} from './events.js';\n\nexport type {\n  ExportManifest,\n  ExportArchive,\n  ExportChunk,\n  ExportStreamItem,\n  ImportOptions,\n  ImportChunk,\n  ImportStreamHeader,\n  ImportWarning,\n  ImportResult,\n} from './portability.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/index.d.cts

@@ -0,0 +1,121 @@
+import { v as ProvenanceContext, C as CreateEntityInput, x as Entity, U as UpdateEntityInput, r as CreateRelationshipInput, H as Relationship, V as VocabularyChangeRecord } from '../portability-DdlNYXGX.cjs';
+export { B as BulkImportResult, W as ConceptSearchOptions, D as DetailLevel, a7 as EnrichedRelationship, z as EntityBrief, a8 as EntityMap, y as EntitySummary, s as EntityTypeDefinition, a9 as EntityTypeInput, N as ExploreOptions, a0 as ExportArchive, E as ExportChunk, aa as ExportManifest, a3 as ExportStreamItem, F as FindEntitiesQuery, ab as GetEntitiesOptions, ac as GetEntityOptions, G as GovernanceConfig, ad as GovernanceMode, L as GraphResult, I as ImportChunk, a1 as ImportOptions, a2 as ImportResult, a4 as ImportStreamHeader, ae as ImportWarning, M as MemoryVocabulary, O as Neighbourhood, af as NeighbourhoodCentre, ag as NeighbourhoodGroup, ah as NeighbourhoodLayer, P as PaginatedResult, e as PaginationOptions, ai as Path, Q as PathOptions, T as PathResult, J as PropertyFilter, aj as PropertySchema, ak as PropertyType, w as Provenance, al as ProvenanceFilter, A as ReembedResult, am as RelationshipDirection, j as RelationshipQueryOptions, K as RelationshipSummary, an as RelationshipTypeDefinition, ao as RelationshipTypeInput, _ as RepositoryConfig, R as RepositoryFilter, ap as RepositoryMetadata, d as RepositoryStats, $ as RepositorySummary, c as RepositoryUpdate, q as ResolvedVocabulary, X as ScoredEntity, a6 as SearchHit, a5 as SearchOptions, k as StorageExploreOptions, h as StorageFindQuery, l as StorageNeighbourhood, aq as StorageNeighbourhoodGroup, ar as StorageNeighbourhoodLayer, as as StoragePath, m as StoragePathOptions, n as StoragePathResult, S as StorageRepositoryConfig, at as StorageTimelineEvent, o as StorageTimelineOptions, p as StorageTimelineResult, f as StoredEntity, g as StoredEntityUpdate, i as StoredRelationship, a as StoredRepository, b as StoredRepositorySummary, au as TimelineEntityRef, av as TimelineEvent, Y as TimelineOptions, aw as TimelineRelationshipDetail, Z as TimelineResult, ax as VocabularyInput, t as VocabularyProposal, u as VocabularyProposalResult } from '../portability-DdlNYXGX.cjs';
+
+/** All event types emitted by the Deep Memory engine */
+type DeepMemoryEventType = 'repository:created' | 'repository:opened' | 'repository:updated' | 'repository:deleted' | 'entity:creating' | 'entity:created' | 'entity:updating' | 'entity:updated' | 'entity:deleting' | 'entity:deleted' | 'relationship:creating' | 'relationship:created' | 'relationship:removing' | 'relationship:removed' | 'vocabulary:proposal' | 'vocabulary:approved' | 'vocabulary:rejected' | 'vocabulary:pending' | 'vocabulary:changed' | 'validation:failed' | 'search:executed' | 'reembed:started' | 'reembed:progress' | 'reembed:completed' | 'reembed:failed' | 'export:started' | 'export:progress' | 'export:completed' | 'import:started' | 'import:progress' | 'import:completed' | 'import:failed';
+/** Type-safe event payload mapping */
+type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created' ? {
+    repositoryId: string;
+    label: string;
+} : T extends 'repository:opened' ? {
+    repositoryId: string;
+} : T extends 'repository:updated' ? {
+    repositoryId: string;
+} : T extends 'repository:deleted' ? {
+    repositoryId: string;
+} : T extends 'entity:creating' ? {
+    input: CreateEntityInput;
+} : T extends 'entity:created' ? {
+    entity: Entity;
+} : T extends 'entity:updating' ? {
+    id: string;
+    updates: UpdateEntityInput;
+} : T extends 'entity:updated' ? {
+    entity: Entity;
+} : T extends 'entity:deleting' ? {
+    id: string;
+} : T extends 'entity:deleted' ? {
+    id: string;
+} : T extends 'relationship:creating' ? {
+    input: CreateRelationshipInput;
+} : T extends 'relationship:created' ? {
+    relationship: Relationship;
+} : T extends 'relationship:removing' ? {
+    id: string;
+} : T extends 'relationship:removed' ? {
+    id: string;
+} : T extends 'vocabulary:proposal' ? {
+    proposal: VocabularyChangeRecord;
+} : T extends 'vocabulary:approved' ? {
+    change: VocabularyChangeRecord;
+} : T extends 'vocabulary:rejected' ? {
+    reason: string;
+    duplicates?: Array<{
+        type: string;
+        similarity: number;
+    }>;
+} : T extends 'vocabulary:pending' ? {
+    proposalId: string;
+} : T extends 'vocabulary:changed' ? {
+    previousVersion: string;
+    newVersion: string;
+    change: VocabularyChangeRecord;
+} : T extends 'validation:failed' ? {
+    operation: string;
+    error: string;
+    suggestions?: string[];
+} : T extends 'search:executed' ? {
+    query: string;
+    resultCount: number;
+} : T extends 'reembed:started' ? {
+    repositoryId: string;
+    totalEntities: number;
+} : T extends 'reembed:progress' ? {
+    repositoryId: string;
+    processed: number;
+    totalEntities: number;
+    failed: number;
+} : T extends 'reembed:completed' ? {
+    repositoryId: string;
+    processed: number;
+    failed: number;
+    modelId: string;
+} : T extends 'reembed:failed' ? {
+    repositoryId: string;
+    error: string;
+} : T extends 'export:started' ? {
+    repositoryId: string;
+} : T extends 'export:progress' ? {
+    repositoryId: string;
+    entitiesExported: number;
+    totalEntities: number;
+} : T extends 'export:completed' ? {
+    repositoryId: string;
+    entityCount: number;
+    relationshipCount: number;
+} : T extends 'import:started' ? {
+    repositoryId: string;
+} : T extends 'import:progress' ? {
+    repositoryId: string;
+    entitiesImported: number;
+    totalEntities: number;
+} : T extends 'import:completed' ? {
+    repositoryId: string;
+    entitiesImported: number;
+    relationshipsImported: number;
+} : T extends 'import:failed' ? {
+    repositoryId: string;
+    error: string;
+} : Record<string, unknown>;
+/** A typed event emitted by the engine */
+interface DeepMemoryEvent<T extends DeepMemoryEventType> {
+    type: T;
+    timestamp: string;
+    repositoryId?: string;
+    provenance: ProvenanceContext;
+    payload: EventPayload<T>;
+}
+/** Event handler function */
+type EventHandler<T extends DeepMemoryEventType> = (event: DeepMemoryEvent<T>) => void | Promise<void>;
+/** Unsubscribe function returned by on() */
+type Unsubscribe = () => void;
+/**
+ * Result from a pre-mutation hook handler.
+ * Return `{ cancel: true, reason }` to abort the operation.
+ */
+interface HookResult {
+    cancel?: boolean;
+    reason?: string;
+}
+
+export { CreateEntityInput, CreateRelationshipInput, type DeepMemoryEvent, type DeepMemoryEventType, Entity, type EventHandler, type EventPayload, type HookResult, ProvenanceContext, Relationship, type Unsubscribe, UpdateEntityInput, VocabularyChangeRecord };