@utaba/deep-memory 0.18.0 → 0.20.0

package/dist/{StorageProvider-B2p_XThQ.d.ts → StorageProvider-CgWRfvIZ.d.ts}

@@ -1,4 +1,4 @@
-import { au as StorageRepositoryConfig, aB as StoredRepository, ad as RepositoryFilter, T as PaginatedResult, aC as StoredRepositorySummary, ah as RepositoryUpdate, g as DeleteProgressCallback, af as RepositoryStats, O as MemoryVocabulary, U as PaginationOptions, aM as VocabularyChangeRecord, ay as StoredEntity, az as StoredEntityUpdate, an as StorageFindQuery, aA as StoredRelationship, a5 as RelationshipQueryOptions, am as StorageExploreOptions, ao as StorageNeighborhood, as as StoragePathOptions, at as StoragePathResult, aw as StorageTimelineOptions, ax as StorageTimelineResult, s as ExportChunk, J as ImportChunk, B as BulkImportOptions, d as BulkImportResult } from './portability-CAeyzSCx.js';
+import { au as StorageRepositoryConfig, aB as StoredRepository, ad as RepositoryFilter, T as PaginatedResult, aC as StoredRepositorySummary, ah as RepositoryUpdate, g as DeleteProgressCallback, af as RepositoryStats, O as MemoryVocabulary, U as PaginationOptions, aM as VocabularyChangeRecord, ay as StoredEntity, az as StoredEntityUpdate, an as StorageFindQuery, aA as StoredRelationship, a5 as RelationshipQueryOptions, am as StorageExploreOptions, ao as StorageNeighborhood, as as StoragePathOptions, at as StoragePathResult, aw as StorageTimelineOptions, ax as StorageTimelineResult, s as ExportChunk, J as ImportChunk, B as BulkImportOptions, d as BulkImportResult } from './portability-BHyXmv5-.js';
 
 /** Result returned by ensureSchema describing what actions were taken. */
 interface EnsureSchemaResult {

package/dist/{StorageProvider-CadKZ85j.d.cts → StorageProvider-RPhT7vtH.d.cts}

@@ -1,4 +1,4 @@
-import { au as StorageRepositoryConfig, aB as StoredRepository, ad as RepositoryFilter, T as PaginatedResult, aC as StoredRepositorySummary, ah as RepositoryUpdate, g as DeleteProgressCallback, af as RepositoryStats, O as MemoryVocabulary, U as PaginationOptions, aM as VocabularyChangeRecord, ay as StoredEntity, az as StoredEntityUpdate, an as StorageFindQuery, aA as StoredRelationship, a5 as RelationshipQueryOptions, am as StorageExploreOptions, ao as StorageNeighborhood, as as StoragePathOptions, at as StoragePathResult, aw as StorageTimelineOptions, ax as StorageTimelineResult, s as ExportChunk, J as ImportChunk, B as BulkImportOptions, d as BulkImportResult } from './portability-CAeyzSCx.cjs';
+import { au as StorageRepositoryConfig, aB as StoredRepository, ad as RepositoryFilter, T as PaginatedResult, aC as StoredRepositorySummary, ah as RepositoryUpdate, g as DeleteProgressCallback, af as RepositoryStats, O as MemoryVocabulary, U as PaginationOptions, aM as VocabularyChangeRecord, ay as StoredEntity, az as StoredEntityUpdate, an as StorageFindQuery, aA as StoredRelationship, a5 as RelationshipQueryOptions, am as StorageExploreOptions, ao as StorageNeighborhood, as as StoragePathOptions, at as StoragePathResult, aw as StorageTimelineOptions, ax as StorageTimelineResult, s as ExportChunk, J as ImportChunk, B as BulkImportOptions, d as BulkImportResult } from './portability-BHyXmv5-.cjs';
 
 /** Result returned by ensureSchema describing what actions were taken. */
 interface EnsureSchemaResult {

package/dist/index.cjs

@@ -3657,7 +3657,7 @@ var EventBus = class {
 };
 
 // src/portability/RepositoryExporter.ts
-var LIBRARY_VERSION = true ? "0.18.0" : "0.1.0";
+var LIBRARY_VERSION = true ? "0.20.0" : "0.1.0";
 var RepositoryExporter = class {
   storage;
   provenance;
@@ -3689,6 +3689,9 @@ var RepositoryExporter = class {
         type: repo.type,
         label: repo.label,
         description: repo.description,
+        legal: repo.legal,
+        owner: repo.owner,
+        metadata: repo.metadata,
         vocabularyVersion: vocabulary.version,
         governanceMode: repo.governanceConfig.mode
       },
@@ -4086,7 +4089,10 @@ var RepositoryImporter = class {
         type: target.config.type,
         label: target.config.label,
         description: target.config.description,
+        legal: target.config.legal,
+        owner: target.config.owner,
         governanceConfig: target.config.governance ?? { mode: "open" },
+        metadata: target.config.metadata,
         createdAt: now,
         createdBy: this.actorId
       });
@@ -4601,6 +4607,7 @@ var DeepMemory = class {
   /** Import a repository from a portable archive */
   async importRepository(archive, options) {
     await this.ensureInitialized();
+    this.validateRepositoryId(options.target.repositoryId);
     await this.globalEventBus.emit("import:started", { repositoryId: options.target.repositoryId });
     const importer = new RepositoryImporter({
       storage: this.storage,
@@ -4701,6 +4708,7 @@ var DeepMemory = class {
    */
   async importRepositoryStream(header, chunks, options) {
     await this.ensureInitialized();
+    this.validateRepositoryId(options.target.repositoryId);
     const importer = new RepositoryImporter({
       storage: this.storage,
       actorId: this.provenance.getContext().actorId,
@@ -4972,12 +4980,16 @@ var GremlinCompiler = class {
           }
         }
       }
-      if (returnMode === "terminal" && spec.dedup !== false) {
+      const emitProjection = spec.projection !== void 0 && returnMode === "terminal";
+      if (returnMode === "terminal" && !emitProjection && spec.dedup !== false) {
         parts.push(".dedup()");
       }
       if (returnMode === "path") {
         parts.push(".simplePath()");
       }
+      if (emitProjection) {
+        parts.push(emitProjectionTerminal(spec.projection));
+      }
       const limit = spec.limit ?? 50;
       const offset = spec.offset ?? 0;
       const pOffset = nextParam(offset);
@@ -4985,7 +4997,8 @@ var GremlinCompiler = class {
       parts.push(`.range(${pOffset}, ${pEnd})`);
       params["_limit"] = limit;
       params["_offset"] = offset;
-      if (returnMode === "terminal") {
+      if (emitProjection) {
+      } else if (returnMode === "terminal") {
         parts.push(`.${VERTEX_PROJECT_EXPR}`);
       } else {
         parts.push(`.path().by(${VERTEX_PROJECT_EXPR}).by(${EDGE_PROJECT_EXPR})`);
@@ -5081,6 +5094,31 @@ function compileRepeatStep(step, nextParam, useEdgeEmission) {
   }
   return parts.join("");
 }
+var SAFE_PROJECTION_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertSafeProjectionKey(key) {
+  if (!SAFE_PROJECTION_KEY_RE.test(key)) {
+    throw new Error(
+      `Unsafe projection property name: "${key}". Property names must match ${SAFE_PROJECTION_KEY_RE.source}.`
+    );
+  }
+}
+function emitProjectionTerminal(projection) {
+  const properties = projection.properties;
+  const mode = projection.mode ?? "values";
+  const distinct = projection.distinct ?? false;
+  for (const prop of properties) {
+    assertSafeProjectionKey(prop);
+  }
+  const singleProperty = properties.length === 1;
+  const keyExpr = singleProperty ? `values('${properties[0]}')` : `project(${properties.map((p) => `'${p}'`).join(",")})${properties.map((p) => `.by(values('${p}'))`).join("")}`;
+  if (mode === "count") {
+    return `.group().by(${keyExpr}).by(count()).unfold()`;
+  }
+  if (distinct) {
+    return `.${keyExpr}.dedup()`;
+  }
+  return `.${keyExpr}`;
+}
 function compilePropertyFilter(filter, nextParam) {
   const key = nextParam(filter.key);
   switch (filter.operator) {
@@ -5190,17 +5228,35 @@ var CypherCompiler = class {
       }
       lastNode = targetNode;
     }
-    const matchClause = `MATCH ${matchParts[0]}${matchParts.slice(1).join("")}`;
+    const bindPath = spec.returnMode === "path";
+    const pathBinding = bindPath ? "p = " : "";
+    const matchClause = `MATCH ${pathBinding}${matchParts[0]}${matchParts.slice(1).join("")}`;
     const whereClause = whereClauses.length > 0 ? `
 WHERE ${whereClauses.join(" AND ")}` : "";
     let returnClause;
-    if (spec.returnMode === "path") {
-      const allNodes = Array.from({ length: nodeIndex }, (_, i) => `n${i}`);
-      const allRels = steps.map((_, i) => `r${i}`);
-      returnClause = `RETURN ${[...allNodes, ...allRels].join(", ")}`;
+    const emitProjection = spec.projection !== void 0 && spec.returnMode !== "path" && spec.returnMode !== "all";
+    if (emitProjection) {
+      const projection = spec.projection;
+      const mode = projection.mode ?? "values";
+      const distinct = projection.distinct ?? false;
+      const projectionColumns = projection.properties.map((prop) => {
+        assertSafeProjectionKey2(prop);
+        return `${lastNode}.${prop} AS ${prop}`;
+      });
+      if (mode === "count") {
+        returnClause = `RETURN ${projectionColumns.join(", ")}, count(*) AS count`;
+      } else if (distinct) {
+        returnClause = `RETURN DISTINCT ${projectionColumns.join(", ")}`;
+      } else {
+        returnClause = `RETURN ${projectionColumns.join(", ")}`;
+      }
+    } else if (spec.returnMode === "path") {
+      returnClause = "RETURN nodes(p) AS pathNodes, relationships(p) AS pathRels, length(p) AS pathLength";
     } else if (spec.returnMode === "all") {
       const allNodes = Array.from({ length: nodeIndex }, (_, i) => `n${i}`);
-      returnClause = spec.dedup !== false ? `RETURN DISTINCT ${allNodes.join(", ")}` : `RETURN ${allNodes.join(", ")}`;
+      const allRels = steps.map((_, i) => `r${i}`);
+      const projection = [...allNodes, ...allRels].join(", ");
+      returnClause = spec.dedup !== false ? `RETURN DISTINCT ${projection}` : `RETURN ${projection}`;
     } else {
       returnClause = spec.dedup !== false ? `RETURN DISTINCT ${lastNode}` : `RETURN ${lastNode}`;
     }
@@ -5221,6 +5277,14 @@ ${returnClause}${skipClause}${limitClause}`;
     };
   }
 };
+var SAFE_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertSafeProjectionKey2(key) {
+  if (!SAFE_KEY_RE.test(key)) {
+    throw new Error(
+      `Unsafe projection property name: "${key}". Property names must match ${SAFE_KEY_RE.source}.`
+    );
+  }
+}
 function compilePropertyFilterCypher(nodeAlias, filter, nextParam) {
   const prop = `${nodeAlias}.${filter.key}`;
   switch (filter.operator) {
@@ -5625,6 +5689,7 @@ var InMemoryStorageProvider = class {
     for (let depth = 0; depth < options.depth; depth++) {
       const layer = {};
       const nextFrontier = /* @__PURE__ */ new Set();
+      const layerBucketSeen = /* @__PURE__ */ new Map();
       for (const frontierEntityId of currentFrontier) {
         for (const rel of store.relationships.values()) {
           const isSource = rel.sourceEntityId === frontierEntityId;
@@ -5662,6 +5727,13 @@ var InMemoryStorageProvider = class {
             continue;
           }
           const relType = rel.relationshipType;
+          let bucketSeen = layerBucketSeen.get(relType);
+          if (!bucketSeen) {
+            bucketSeen = /* @__PURE__ */ new Set();
+            layerBucketSeen.set(relType, bucketSeen);
+          }
+          if (bucketSeen.has(connectedEntityId)) continue;
+          bucketSeen.add(connectedEntityId);
           if (!layer[relType]) {
             layer[relType] = { total: 0, entities: [], relationships: [] };
           }