@nicia-ai/typegraph 0.36.0 → 0.37.0

package/dist/interchange/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/interchange/trusted-import.ts"],"names":["TrustedImportError","getSearchableFields","resolveGraphVectorSlots"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  InsertEdgeParams,\n  InsertNodeParams,\n  TrustedImportSession,\n} from \"../backend/types\";\nimport type { GraphDef } from \"../core/define-graph\";\nimport { resolveGraphVectorSlots } from \"../core/embedding\";\nimport { getSearchableFields } from \"../core/searchable\";\nimport { TrustedImportError } from \"../errors\";\nimport type { Store } from \"../store/store\";\nimport type {\n  GraphData,\n  GraphInterchangeChunk,\n  InterchangeEdge,\n  InterchangeNode,\n} from \"./types\";\n\n/** Counts committed by a trusted initial import. */\nexport type TrustedImportResult = Readonly<{\n  nodes: number;\n  edges: number;\n}>;\n\nfunction rejectUnsupportedStoreFeatures<G extends GraphDef>(\n  store: Store<G>,\n): void {\n  if (store.historyEnabled) {\n    throw new TrustedImportError(\n      \"Trusted import does not support recorded-time history capture.\",\n      \"history_unsupported\",\n      { graphId: store.graphId },\n    );\n  }\n  if (store.revisionTrackingEnabled) {\n    throw new TrustedImportError(\n      \"Trusted import does not support revision tracking.\",\n      \"revision_tracking_unsupported\",\n      { graphId: store.graphId },\n    );\n  }\n\n  const uniqueKinds = Object.values(store.graph.nodes)\n    .filter((registration) => (registration.unique?.length ?? 0) > 0)\n    .map((registration) => registration.type.kind);\n  if (uniqueKinds.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain node uniqueness sidecars.\",\n      \"uniqueness_unsupported\",\n      { graphId: store.graphId, nodeKinds: uniqueKinds },\n    );\n  }\n\n  const searchableKinds = Object.values(store.graph.nodes)\n    .filter(\n      (registration) =>\n        getSearchableFields(registration.type.schema).length > 0,\n    )\n    .map((registration) => registration.type.kind);\n  if (searchableKinds.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain fulltext sidecars.\",\n      \"fulltext_unsupported\",\n      { graphId: store.graphId, nodeKinds: searchableKinds },\n    );\n  }\n\n  const vectorSlots = resolveGraphVectorSlots(store.graph);\n  if (vectorSlots.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain vector sidecars.\",\n      \"vector_unsupported\",\n      {\n        graphId: store.graphId,\n        fields: vectorSlots.map((slot) => `${slot.nodeKind}.${slot.fieldPath}`),\n      },\n    );\n  }\n}\n\nfunction invalidStream(message: string): TrustedImportError {\n  return new TrustedImportError(message, \"invalid_stream\");\n}\n\nfunction nodeParams(graphId: string, node: InterchangeNode): InsertNodeParams {\n  return {\n    graphId,\n    kind: node.kind,\n    id: node.id,\n    props: node.properties,\n    ...(node.validFrom === undefined ? {} : { validFrom: node.validFrom }),\n    ...(node.validTo === undefined ? {} : { validTo: node.validTo }),\n  };\n}\n\nfunction edgeParams(graphId: string, edge: InterchangeEdge): InsertEdgeParams {\n  return {\n    graphId,\n    id: edge.id,\n    kind: edge.kind,\n    fromKind: edge.from.kind,\n    fromId: edge.from.id,\n    toKind: edge.to.kind,\n    toId: edge.to.id,\n    props: edge.properties,\n    ...(edge.validFrom === undefined ? {} : { validFrom: edge.validFrom }),\n    ...(edge.validTo === undefined ? {} : { validTo: edge.validTo }),\n  };\n}\n\nasync function consumeTrustedChunks<G extends GraphDef>(\n  store: Store<G>,\n  session: TrustedImportSession,\n  chunks:\n    AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>,\n): Promise<TrustedImportResult> {\n  const nodeKinds = new Set(\n    Object.values(store.graph.nodes).map(\n      (registration) => registration.type.kind,\n    ),\n  );\n  const edgeKinds = new Set(\n    Object.values(store.graph.edges).map(\n      (registration) => registration.type.kind,\n    ),\n  );\n  let receivedHeader = false;\n  let receivedEdges = false;\n  let nodeCount = 0;\n  let edgeCount = 0;\n\n  for await (const chunk of chunks) {\n    switch (chunk.type) {\n      case \"header\": {\n        if (receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream emitted more than one header.\",\n          );\n        }\n        receivedHeader = true;\n        break;\n      }\n      case \"nodes\": {\n        if (!receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream must start with a header.\",\n          );\n        }\n        if (receivedEdges) {\n          throw invalidStream(\n            \"Trusted graph interchange stream cannot emit nodes after edges.\",\n          );\n        }\n        const unknownKind = chunk.nodes.find(\n          (node) => !nodeKinds.has(node.kind),\n        )?.kind;\n        if (unknownKind !== undefined) {\n          throw invalidStream(\n            `Unknown node kind in trusted import: ${unknownKind}`,\n          );\n        }\n        await session.insertNodes(\n          chunk.nodes.map((node) => nodeParams(store.graphId, node)),\n        );\n        nodeCount += chunk.nodes.length;\n        break;\n      }\n      case \"edges\": {\n        if (!receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream must start with a header.\",\n          );\n        }\n        receivedEdges = true;\n        const invalidEdge = chunk.edges.find(\n          (edge) =>\n            !edgeKinds.has(edge.kind) ||\n            !nodeKinds.has(edge.from.kind) ||\n            !nodeKinds.has(edge.to.kind),\n        );\n        if (invalidEdge !== undefined) {\n          throw invalidStream(\n            `Unknown edge or endpoint kind in trusted import: ${invalidEdge.kind}`,\n          );\n        }\n        await session.insertEdges(\n          chunk.edges.map((edge) => edgeParams(store.graphId, edge)),\n        );\n        edgeCount += chunk.edges.length;\n        break;\n      }\n    }\n  }\n\n  if (!receivedHeader) {\n    throw invalidStream(\n      \"Trusted graph interchange stream ended before emitting a header.\",\n    );\n  }\n  return { nodes: nodeCount, edges: edgeCount };\n}\n\n/**\n * Atomically imports a header-first stream into a fresh, dedicated database.\n *\n * This is an intentionally trusted path. It checks stream ordering and kind\n * names, but it does not validate properties, references, cardinality, or\n * conflicts. The caller must guarantee those invariants. Use\n * {@link importGraphStream} for untrusted data.\n */\nexport async function trustedImportGraphStream<G extends GraphDef>(\n  store: Store<G>,\n  chunks:\n    AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>,\n): Promise<TrustedImportResult> {\n  rejectUnsupportedStoreFeatures(store);\n  const trustedImport = store.backend.trustedImport;\n  if (trustedImport === undefined) {\n    throw new TrustedImportError(\n      `The ${store.backend.dialect} backend does not support trusted import.`,\n      \"backend_unsupported\",\n      { dialect: store.backend.dialect },\n    );\n  }\n  return trustedImport((session) =>\n    consumeTrustedChunks(store, session, chunks),\n  );\n}\n\nfunction* graphDataChunks(data: GraphData): Iterable<GraphInterchangeChunk> {\n  const { nodes, edges, ...header } = data;\n  yield { type: \"header\", header };\n  yield { type: \"nodes\", nodes };\n  yield { type: \"edges\", edges };\n}\n\n/** In-memory convenience wrapper around {@link trustedImportGraphStream}. */\nexport function trustedImportGraph<G extends GraphDef>(\n  store: Store<G>,\n  data: GraphData,\n): Promise<TrustedImportResult> {\n  return trustedImportGraphStream(store, graphDataChunks(data));\n}\n"]}

package/dist/interchange/index.d.cts

@@ -1,12 +1,12 @@
 import { z } from 'zod';
-import { G as GraphDef } from '../manager-DwQi8eV0.cjs';
-import { S as Store } from '../store-view-9KDOpZzF.cjs';
-import '../extension-types-ixRpJVUp.cjs';
-import '../fulltext-strategy-CDkSSYhq.cjs';
+import { G as GraphDef } from '../manager-nU1vTJLy.cjs';
+import { S as Store } from '../store-view-X96Rd00T.cjs';
+import '../extension-types-BM2ACfYO.cjs';
+import '../fulltext-strategy-C27vXaeB.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../materialize-indexes-B4e9360H.cjs';
+import '../materialize-indexes-CuR3gAZb.cjs';
 
 /**
  * Graph interchange format types.
@@ -77,8 +77,8 @@ type InterchangeEdge = z.infer<typeof InterchangeEdgeSchema>;
  */
 declare const ConflictStrategySchema: z.ZodEnum<{
     error: "error";
-    update: "update";
     skip: "skip";
+    update: "update";
 }>;
 type ConflictStrategy = z.infer<typeof ConflictStrategySchema>;
 /**
@@ -100,8 +100,8 @@ type UnknownPropertyStrategy = z.infer<typeof UnknownPropertyStrategySchema>;
 declare const ImportOptionsSchema: z.ZodObject<{
     onConflict: z.ZodEnum<{
         error: "error";
-        update: "update";
         skip: "skip";
+        update: "update";
     }>;
     onUnknownProperty: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
@@ -391,4 +391,21 @@ declare function importGraph<G extends GraphDef>(store: Store<G>, data: GraphDat
  */
 declare function importGraphStream<G extends GraphDef>(store: Store<G>, chunks: AsyncIterable<GraphInterchangeChunk>, rawOptions: ImportOptions): Promise<ImportResult>;
 
-export { type ConflictStrategy, ConflictStrategySchema, type ExportOptions, type ExportOptionsInput, ExportOptionsSchema, type ExportStreamOptions, type ExportStreamOptionsInput, ExportStreamOptionsSchema, FORMAT_VERSION, type GraphData, type GraphDataHeader, GraphDataHeaderSchema, GraphDataSchema, type GraphDataSource, GraphDataSourceSchema, type GraphInterchangeChunk, GraphInterchangeChunkSchema, type ImportError, ImportErrorSchema, type ImportOptions, ImportOptionsSchema, type ImportResult, ImportResultSchema, type InterchangeEdge, InterchangeEdgeSchema, type InterchangeNode, InterchangeNodeSchema, type UnknownPropertyStrategy, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream };
+/** Counts committed by a trusted initial import. */
+type TrustedImportResult = Readonly<{
+    nodes: number;
+    edges: number;
+}>;
+/**
+ * Atomically imports a header-first stream into a fresh, dedicated database.
+ *
+ * This is an intentionally trusted path. It checks stream ordering and kind
+ * names, but it does not validate properties, references, cardinality, or
+ * conflicts. The caller must guarantee those invariants. Use
+ * {@link importGraphStream} for untrusted data.
+ */
+declare function trustedImportGraphStream<G extends GraphDef>(store: Store<G>, chunks: AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>): Promise<TrustedImportResult>;
+/** In-memory convenience wrapper around {@link trustedImportGraphStream}. */
+declare function trustedImportGraph<G extends GraphDef>(store: Store<G>, data: GraphData): Promise<TrustedImportResult>;
+
+export { type ConflictStrategy, ConflictStrategySchema, type ExportOptions, type ExportOptionsInput, ExportOptionsSchema, type ExportStreamOptions, type ExportStreamOptionsInput, ExportStreamOptionsSchema, FORMAT_VERSION, type GraphData, type GraphDataHeader, GraphDataHeaderSchema, GraphDataSchema, type GraphDataSource, GraphDataSourceSchema, type GraphInterchangeChunk, GraphInterchangeChunkSchema, type ImportError, ImportErrorSchema, type ImportOptions, ImportOptionsSchema, type ImportResult, ImportResultSchema, type InterchangeEdge, InterchangeEdgeSchema, type InterchangeNode, InterchangeNodeSchema, type TrustedImportResult, type UnknownPropertyStrategy, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream, trustedImportGraph, trustedImportGraphStream };

package/dist/interchange/index.d.ts

@@ -1,12 +1,12 @@
 import { z } from 'zod';
-import { G as GraphDef } from '../manager-ejUCB52T.js';
-import { S as Store } from '../store-view-DplHC3Nt.js';
-import '../extension-types-ixRpJVUp.js';
-import '../fulltext-strategy-B57yvC5Q.js';
+import { G as GraphDef } from '../manager-D00_NXvT.js';
+import { S as Store } from '../store-view-ANL6mTph.js';
+import '../extension-types-BM2ACfYO.js';
+import '../fulltext-strategy-DebsMrqg.js';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../materialize-indexes-te9TPMMJ.js';
+import '../materialize-indexes-zK2J_flP.js';
 
 /**
  * Graph interchange format types.
@@ -77,8 +77,8 @@ type InterchangeEdge = z.infer<typeof InterchangeEdgeSchema>;
  */
 declare const ConflictStrategySchema: z.ZodEnum<{
     error: "error";
-    update: "update";
     skip: "skip";
+    update: "update";
 }>;
 type ConflictStrategy = z.infer<typeof ConflictStrategySchema>;
 /**
@@ -100,8 +100,8 @@ type UnknownPropertyStrategy = z.infer<typeof UnknownPropertyStrategySchema>;
 declare const ImportOptionsSchema: z.ZodObject<{
     onConflict: z.ZodEnum<{
         error: "error";
-        update: "update";
         skip: "skip";
+        update: "update";
     }>;
     onUnknownProperty: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
@@ -391,4 +391,21 @@ declare function importGraph<G extends GraphDef>(store: Store<G>, data: GraphDat
  */
 declare function importGraphStream<G extends GraphDef>(store: Store<G>, chunks: AsyncIterable<GraphInterchangeChunk>, rawOptions: ImportOptions): Promise<ImportResult>;
 
-export { type ConflictStrategy, ConflictStrategySchema, type ExportOptions, type ExportOptionsInput, ExportOptionsSchema, type ExportStreamOptions, type ExportStreamOptionsInput, ExportStreamOptionsSchema, FORMAT_VERSION, type GraphData, type GraphDataHeader, GraphDataHeaderSchema, GraphDataSchema, type GraphDataSource, GraphDataSourceSchema, type GraphInterchangeChunk, GraphInterchangeChunkSchema, type ImportError, ImportErrorSchema, type ImportOptions, ImportOptionsSchema, type ImportResult, ImportResultSchema, type InterchangeEdge, InterchangeEdgeSchema, type InterchangeNode, InterchangeNodeSchema, type UnknownPropertyStrategy, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream };
+/** Counts committed by a trusted initial import. */
+type TrustedImportResult = Readonly<{
+    nodes: number;
+    edges: number;
+}>;
+/**
+ * Atomically imports a header-first stream into a fresh, dedicated database.
+ *
+ * This is an intentionally trusted path. It checks stream ordering and kind
+ * names, but it does not validate properties, references, cardinality, or
+ * conflicts. The caller must guarantee those invariants. Use
+ * {@link importGraphStream} for untrusted data.
+ */
+declare function trustedImportGraphStream<G extends GraphDef>(store: Store<G>, chunks: AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>): Promise<TrustedImportResult>;
+/** In-memory convenience wrapper around {@link trustedImportGraphStream}. */
+declare function trustedImportGraph<G extends GraphDef>(store: Store<G>, data: GraphData): Promise<TrustedImportResult>;
+
+export { type ConflictStrategy, ConflictStrategySchema, type ExportOptions, type ExportOptionsInput, ExportOptionsSchema, type ExportStreamOptions, type ExportStreamOptionsInput, ExportStreamOptionsSchema, FORMAT_VERSION, type GraphData, type GraphDataHeader, GraphDataHeaderSchema, GraphDataSchema, type GraphDataSource, GraphDataSourceSchema, type GraphInterchangeChunk, GraphInterchangeChunkSchema, type ImportError, ImportErrorSchema, type ImportOptions, ImportOptionsSchema, type ImportResult, ImportResultSchema, type InterchangeEdge, InterchangeEdgeSchema, type InterchangeNode, InterchangeNodeSchema, type TrustedImportResult, type UnknownPropertyStrategy, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream, trustedImportGraph, trustedImportGraphStream };

package/dist/interchange/index.js

@@ -1,17 +1,196 @@
-export { ConflictStrategySchema, ExportOptionsSchema, ExportStreamOptionsSchema, FORMAT_VERSION, GraphDataHeaderSchema, GraphDataSchema, GraphDataSourceSchema, GraphInterchangeChunkSchema, ImportErrorSchema, ImportOptionsSchema, ImportResultSchema, InterchangeEdgeSchema, InterchangeNodeSchema, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream } from '../chunk-PZKNKG5M.js';
-import '../chunk-DN5VP4JC.js';
-import '../chunk-SKCOUWAX.js';
+export { ConflictStrategySchema, ExportOptionsSchema, ExportStreamOptionsSchema, FORMAT_VERSION, GraphDataHeaderSchema, GraphDataSchema, GraphDataSourceSchema, GraphInterchangeChunkSchema, ImportErrorSchema, ImportOptionsSchema, ImportResultSchema, InterchangeEdgeSchema, InterchangeNodeSchema, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream } from '../chunk-TKT2XHED.js';
+import '../chunk-RCVLFTCT.js';
+import '../chunk-3SLPDKHQ.js';
 import '../chunk-UR7W5YQK.js';
-import '../chunk-FPIZFYHE.js';
-import '../chunk-S5F7ZLP2.js';
-import '../chunk-5VTR2F2K.js';
-import '../chunk-UT3S4SEN.js';
-import '../chunk-IU46OHVW.js';
-import '../chunk-JFUPDJXD.js';
+import '../chunk-EXU3RASM.js';
+import '../chunk-TPF25IG6.js';
+import '../chunk-VKGKDOKR.js';
+import '../chunk-44TA22QT.js';
+import '../chunk-XGPUQ56G.js';
 import '../chunk-OHMP6N2J.js';
-import '../chunk-KBGQIPRQ.js';
+import { getSearchableFields, resolveGraphVectorSlots } from '../chunk-PC2UBAUB.js';
 import '../chunk-SNXVDZAJ.js';
-import '../chunk-WI7ISNQF.js';
+import { TrustedImportError } from '../chunk-5PNMDJ7J.js';
 import '../chunk-G6Q5UM7U.js';
+
+// src/interchange/trusted-import.ts
+function rejectUnsupportedStoreFeatures(store) {
+  if (store.historyEnabled) {
+    throw new TrustedImportError(
+      "Trusted import does not support recorded-time history capture.",
+      "history_unsupported",
+      { graphId: store.graphId }
+    );
+  }
+  if (store.revisionTrackingEnabled) {
+    throw new TrustedImportError(
+      "Trusted import does not support revision tracking.",
+      "revision_tracking_unsupported",
+      { graphId: store.graphId }
+    );
+  }
+  const uniqueKinds = Object.values(store.graph.nodes).filter((registration) => (registration.unique?.length ?? 0) > 0).map((registration) => registration.type.kind);
+  if (uniqueKinds.length > 0) {
+    throw new TrustedImportError(
+      "Trusted import does not maintain node uniqueness sidecars.",
+      "uniqueness_unsupported",
+      { graphId: store.graphId, nodeKinds: uniqueKinds }
+    );
+  }
+  const searchableKinds = Object.values(store.graph.nodes).filter(
+    (registration) => getSearchableFields(registration.type.schema).length > 0
+  ).map((registration) => registration.type.kind);
+  if (searchableKinds.length > 0) {
+    throw new TrustedImportError(
+      "Trusted import does not maintain fulltext sidecars.",
+      "fulltext_unsupported",
+      { graphId: store.graphId, nodeKinds: searchableKinds }
+    );
+  }
+  const vectorSlots = resolveGraphVectorSlots(store.graph);
+  if (vectorSlots.length > 0) {
+    throw new TrustedImportError(
+      "Trusted import does not maintain vector sidecars.",
+      "vector_unsupported",
+      {
+        graphId: store.graphId,
+        fields: vectorSlots.map((slot) => `${slot.nodeKind}.${slot.fieldPath}`)
+      }
+    );
+  }
+}
+function invalidStream(message) {
+  return new TrustedImportError(message, "invalid_stream");
+}
+function nodeParams(graphId, node) {
+  return {
+    graphId,
+    kind: node.kind,
+    id: node.id,
+    props: node.properties,
+    ...node.validFrom === void 0 ? {} : { validFrom: node.validFrom },
+    ...node.validTo === void 0 ? {} : { validTo: node.validTo }
+  };
+}
+function edgeParams(graphId, edge) {
+  return {
+    graphId,
+    id: edge.id,
+    kind: edge.kind,
+    fromKind: edge.from.kind,
+    fromId: edge.from.id,
+    toKind: edge.to.kind,
+    toId: edge.to.id,
+    props: edge.properties,
+    ...edge.validFrom === void 0 ? {} : { validFrom: edge.validFrom },
+    ...edge.validTo === void 0 ? {} : { validTo: edge.validTo }
+  };
+}
+async function consumeTrustedChunks(store, session, chunks) {
+  const nodeKinds = new Set(
+    Object.values(store.graph.nodes).map(
+      (registration) => registration.type.kind
+    )
+  );
+  const edgeKinds = new Set(
+    Object.values(store.graph.edges).map(
+      (registration) => registration.type.kind
+    )
+  );
+  let receivedHeader = false;
+  let receivedEdges = false;
+  let nodeCount = 0;
+  let edgeCount = 0;
+  for await (const chunk of chunks) {
+    switch (chunk.type) {
+      case "header": {
+        if (receivedHeader) {
+          throw invalidStream(
+            "Trusted graph interchange stream emitted more than one header."
+          );
+        }
+        receivedHeader = true;
+        break;
+      }
+      case "nodes": {
+        if (!receivedHeader) {
+          throw invalidStream(
+            "Trusted graph interchange stream must start with a header."
+          );
+        }
+        if (receivedEdges) {
+          throw invalidStream(
+            "Trusted graph interchange stream cannot emit nodes after edges."
+          );
+        }
+        const unknownKind = chunk.nodes.find(
+          (node) => !nodeKinds.has(node.kind)
+        )?.kind;
+        if (unknownKind !== void 0) {
+          throw invalidStream(
+            `Unknown node kind in trusted import: ${unknownKind}`
+          );
+        }
+        await session.insertNodes(
+          chunk.nodes.map((node) => nodeParams(store.graphId, node))
+        );
+        nodeCount += chunk.nodes.length;
+        break;
+      }
+      case "edges": {
+        if (!receivedHeader) {
+          throw invalidStream(
+            "Trusted graph interchange stream must start with a header."
+          );
+        }
+        receivedEdges = true;
+        const invalidEdge = chunk.edges.find(
+          (edge) => !edgeKinds.has(edge.kind) || !nodeKinds.has(edge.from.kind) || !nodeKinds.has(edge.to.kind)
+        );
+        if (invalidEdge !== void 0) {
+          throw invalidStream(
+            `Unknown edge or endpoint kind in trusted import: ${invalidEdge.kind}`
+          );
+        }
+        await session.insertEdges(
+          chunk.edges.map((edge) => edgeParams(store.graphId, edge))
+        );
+        edgeCount += chunk.edges.length;
+        break;
+      }
+    }
+  }
+  if (!receivedHeader) {
+    throw invalidStream(
+      "Trusted graph interchange stream ended before emitting a header."
+    );
+  }
+  return { nodes: nodeCount, edges: edgeCount };
+}
+async function trustedImportGraphStream(store, chunks) {
+  rejectUnsupportedStoreFeatures(store);
+  const trustedImport = store.backend.trustedImport;
+  if (trustedImport === void 0) {
+    throw new TrustedImportError(
+      `The ${store.backend.dialect} backend does not support trusted import.`,
+      "backend_unsupported",
+      { dialect: store.backend.dialect }
+    );
+  }
+  return trustedImport(
+    (session) => consumeTrustedChunks(store, session, chunks)
+  );
+}
+function* graphDataChunks(data) {
+  const { nodes, edges, ...header } = data;
+  yield { type: "header", header };
+  yield { type: "nodes", nodes };
+  yield { type: "edges", edges };
+}
+function trustedImportGraph(store, data) {
+  return trustedImportGraphStream(store, graphDataChunks(data));
+}
+
+export { trustedImportGraph, trustedImportGraphStream };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/interchange/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/interchange/trusted-import.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  InsertEdgeParams,\n  InsertNodeParams,\n  TrustedImportSession,\n} from \"../backend/types\";\nimport type { GraphDef } from \"../core/define-graph\";\nimport { resolveGraphVectorSlots } from \"../core/embedding\";\nimport { getSearchableFields } from \"../core/searchable\";\nimport { TrustedImportError } from \"../errors\";\nimport type { Store } from \"../store/store\";\nimport type {\n  GraphData,\n  GraphInterchangeChunk,\n  InterchangeEdge,\n  InterchangeNode,\n} from \"./types\";\n\n/** Counts committed by a trusted initial import. */\nexport type TrustedImportResult = Readonly<{\n  nodes: number;\n  edges: number;\n}>;\n\nfunction rejectUnsupportedStoreFeatures<G extends GraphDef>(\n  store: Store<G>,\n): void {\n  if (store.historyEnabled) {\n    throw new TrustedImportError(\n      \"Trusted import does not support recorded-time history capture.\",\n      \"history_unsupported\",\n      { graphId: store.graphId },\n    );\n  }\n  if (store.revisionTrackingEnabled) {\n    throw new TrustedImportError(\n      \"Trusted import does not support revision tracking.\",\n      \"revision_tracking_unsupported\",\n      { graphId: store.graphId },\n    );\n  }\n\n  const uniqueKinds = Object.values(store.graph.nodes)\n    .filter((registration) => (registration.unique?.length ?? 0) > 0)\n    .map((registration) => registration.type.kind);\n  if (uniqueKinds.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain node uniqueness sidecars.\",\n      \"uniqueness_unsupported\",\n      { graphId: store.graphId, nodeKinds: uniqueKinds },\n    );\n  }\n\n  const searchableKinds = Object.values(store.graph.nodes)\n    .filter(\n      (registration) =>\n        getSearchableFields(registration.type.schema).length > 0,\n    )\n    .map((registration) => registration.type.kind);\n  if (searchableKinds.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain fulltext sidecars.\",\n      \"fulltext_unsupported\",\n      { graphId: store.graphId, nodeKinds: searchableKinds },\n    );\n  }\n\n  const vectorSlots = resolveGraphVectorSlots(store.graph);\n  if (vectorSlots.length > 0) {\n    throw new TrustedImportError(\n      \"Trusted import does not maintain vector sidecars.\",\n      \"vector_unsupported\",\n      {\n        graphId: store.graphId,\n        fields: vectorSlots.map((slot) => `${slot.nodeKind}.${slot.fieldPath}`),\n      },\n    );\n  }\n}\n\nfunction invalidStream(message: string): TrustedImportError {\n  return new TrustedImportError(message, \"invalid_stream\");\n}\n\nfunction nodeParams(graphId: string, node: InterchangeNode): InsertNodeParams {\n  return {\n    graphId,\n    kind: node.kind,\n    id: node.id,\n    props: node.properties,\n    ...(node.validFrom === undefined ? {} : { validFrom: node.validFrom }),\n    ...(node.validTo === undefined ? {} : { validTo: node.validTo }),\n  };\n}\n\nfunction edgeParams(graphId: string, edge: InterchangeEdge): InsertEdgeParams {\n  return {\n    graphId,\n    id: edge.id,\n    kind: edge.kind,\n    fromKind: edge.from.kind,\n    fromId: edge.from.id,\n    toKind: edge.to.kind,\n    toId: edge.to.id,\n    props: edge.properties,\n    ...(edge.validFrom === undefined ? {} : { validFrom: edge.validFrom }),\n    ...(edge.validTo === undefined ? {} : { validTo: edge.validTo }),\n  };\n}\n\nasync function consumeTrustedChunks<G extends GraphDef>(\n  store: Store<G>,\n  session: TrustedImportSession,\n  chunks:\n    AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>,\n): Promise<TrustedImportResult> {\n  const nodeKinds = new Set(\n    Object.values(store.graph.nodes).map(\n      (registration) => registration.type.kind,\n    ),\n  );\n  const edgeKinds = new Set(\n    Object.values(store.graph.edges).map(\n      (registration) => registration.type.kind,\n    ),\n  );\n  let receivedHeader = false;\n  let receivedEdges = false;\n  let nodeCount = 0;\n  let edgeCount = 0;\n\n  for await (const chunk of chunks) {\n    switch (chunk.type) {\n      case \"header\": {\n        if (receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream emitted more than one header.\",\n          );\n        }\n        receivedHeader = true;\n        break;\n      }\n      case \"nodes\": {\n        if (!receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream must start with a header.\",\n          );\n        }\n        if (receivedEdges) {\n          throw invalidStream(\n            \"Trusted graph interchange stream cannot emit nodes after edges.\",\n          );\n        }\n        const unknownKind = chunk.nodes.find(\n          (node) => !nodeKinds.has(node.kind),\n        )?.kind;\n        if (unknownKind !== undefined) {\n          throw invalidStream(\n            `Unknown node kind in trusted import: ${unknownKind}`,\n          );\n        }\n        await session.insertNodes(\n          chunk.nodes.map((node) => nodeParams(store.graphId, node)),\n        );\n        nodeCount += chunk.nodes.length;\n        break;\n      }\n      case \"edges\": {\n        if (!receivedHeader) {\n          throw invalidStream(\n            \"Trusted graph interchange stream must start with a header.\",\n          );\n        }\n        receivedEdges = true;\n        const invalidEdge = chunk.edges.find(\n          (edge) =>\n            !edgeKinds.has(edge.kind) ||\n            !nodeKinds.has(edge.from.kind) ||\n            !nodeKinds.has(edge.to.kind),\n        );\n        if (invalidEdge !== undefined) {\n          throw invalidStream(\n            `Unknown edge or endpoint kind in trusted import: ${invalidEdge.kind}`,\n          );\n        }\n        await session.insertEdges(\n          chunk.edges.map((edge) => edgeParams(store.graphId, edge)),\n        );\n        edgeCount += chunk.edges.length;\n        break;\n      }\n    }\n  }\n\n  if (!receivedHeader) {\n    throw invalidStream(\n      \"Trusted graph interchange stream ended before emitting a header.\",\n    );\n  }\n  return { nodes: nodeCount, edges: edgeCount };\n}\n\n/**\n * Atomically imports a header-first stream into a fresh, dedicated database.\n *\n * This is an intentionally trusted path. It checks stream ordering and kind\n * names, but it does not validate properties, references, cardinality, or\n * conflicts. The caller must guarantee those invariants. Use\n * {@link importGraphStream} for untrusted data.\n */\nexport async function trustedImportGraphStream<G extends GraphDef>(\n  store: Store<G>,\n  chunks:\n    AsyncIterable<GraphInterchangeChunk> | Iterable<GraphInterchangeChunk>,\n): Promise<TrustedImportResult> {\n  rejectUnsupportedStoreFeatures(store);\n  const trustedImport = store.backend.trustedImport;\n  if (trustedImport === undefined) {\n    throw new TrustedImportError(\n      `The ${store.backend.dialect} backend does not support trusted import.`,\n      \"backend_unsupported\",\n      { dialect: store.backend.dialect },\n    );\n  }\n  return trustedImport((session) =>\n    consumeTrustedChunks(store, session, chunks),\n  );\n}\n\nfunction* graphDataChunks(data: GraphData): Iterable<GraphInterchangeChunk> {\n  const { nodes, edges, ...header } = data;\n  yield { type: \"header\", header };\n  yield { type: \"nodes\", nodes };\n  yield { type: \"edges\", edges };\n}\n\n/** In-memory convenience wrapper around {@link trustedImportGraphStream}. */\nexport function trustedImportGraph<G extends GraphDef>(\n  store: Store<G>,\n  data: GraphData,\n): Promise<TrustedImportResult> {\n  return trustedImportGraphStream(store, graphDataChunks(data));\n}\n"]}

package/dist/{manager-DwQi8eV0.d.cts → manager-D00_NXvT.d.ts}

@@ -1,5 +1,5 @@
-import { b as NodeRegistration, E as EdgeRegistration, D as DeleteBehavior, T as TemporalMode, G as GraphExtension, N as NodeType, A as AnyEdgeType, c as GraphDefaults, I as IndexEntity } from './extension-types-ixRpJVUp.cjs';
-import { O as OntologyRelation, I as IndexDeclaration, u as SerializedNodeDef, v as SerializedEdgeDef, s as SerializedSchema, H as SchemaVersionRow, G as GraphBackend } from './fulltext-strategy-CDkSSYhq.cjs';
+import { b as NodeRegistration, E as EdgeRegistration, D as DeleteBehavior, T as TemporalMode, G as GraphExtension, N as NodeType, A as AnyEdgeType, c as GraphDefaults, I as IndexEntity } from './extension-types-BM2ACfYO.js';
+import { O as OntologyRelation, I as IndexDeclaration, u as SerializedNodeDef, v as SerializedEdgeDef, s as SerializedSchema, H as SchemaVersionRow, G as GraphBackend } from './fulltext-strategy-DebsMrqg.js';
 
 /** Brand key for GraphDef */
 declare const GRAPH_DEF_BRAND: "__graphDef";
@@ -589,6 +589,15 @@ type SchemaManagerOptions = Readonly<{
     autoMigrate?: boolean;
     /** If true, throw on breaking changes. Default: true */
     throwOnBreaking?: boolean;
+    /**
+     * Whether `createStoreWithSchema` brings the base-relation system
+     * indexes up to the running library version at boot. Default:
+     * `"materialize"`. Pass `"skip"` when a boot must not run potentially
+     * long index builds inline (e.g. a large PostgreSQL deployment behind a
+     * readiness probe) — then run `store.materializeSystemIndexes()`
+     * out-of-band after upgrading.
+     */
+    systemIndexes?: "materialize" | "skip";
     /** Called before a safe auto-migration is applied. For observability only. */
     onBeforeMigrate?: (context: MigrationHookContext) => void | Promise<void>;
     /** Called after a safe auto-migration is applied. For observability only. */

package/dist/{manager-ejUCB52T.d.ts → manager-nU1vTJLy.d.cts}

@@ -1,5 +1,5 @@
-import { b as NodeRegistration, E as EdgeRegistration, D as DeleteBehavior, T as TemporalMode, G as GraphExtension, N as NodeType, A as AnyEdgeType, c as GraphDefaults, I as IndexEntity } from './extension-types-ixRpJVUp.js';
-import { O as OntologyRelation, I as IndexDeclaration, u as SerializedNodeDef, v as SerializedEdgeDef, s as SerializedSchema, H as SchemaVersionRow, G as GraphBackend } from './fulltext-strategy-B57yvC5Q.js';
+import { b as NodeRegistration, E as EdgeRegistration, D as DeleteBehavior, T as TemporalMode, G as GraphExtension, N as NodeType, A as AnyEdgeType, c as GraphDefaults, I as IndexEntity } from './extension-types-BM2ACfYO.cjs';
+import { O as OntologyRelation, I as IndexDeclaration, u as SerializedNodeDef, v as SerializedEdgeDef, s as SerializedSchema, H as SchemaVersionRow, G as GraphBackend } from './fulltext-strategy-C27vXaeB.cjs';
 
 /** Brand key for GraphDef */
 declare const GRAPH_DEF_BRAND: "__graphDef";
@@ -589,6 +589,15 @@ type SchemaManagerOptions = Readonly<{
     autoMigrate?: boolean;
     /** If true, throw on breaking changes. Default: true */
     throwOnBreaking?: boolean;
+    /**
+     * Whether `createStoreWithSchema` brings the base-relation system
+     * indexes up to the running library version at boot. Default:
+     * `"materialize"`. Pass `"skip"` when a boot must not run potentially
+     * long index builds inline (e.g. a large PostgreSQL deployment behind a
+     * readiness probe) — then run `store.materializeSystemIndexes()`
+     * out-of-band after upgrading.
+     */
+    systemIndexes?: "materialize" | "skip";
     /** Called before a safe auto-migration is applied. For observability only. */
     onBeforeMigrate?: (context: MigrationHookContext) => void | Promise<void>;
     /** Called after a safe auto-migration is applied. For observability only. */

package/dist/{materialize-indexes-B4e9360H.d.cts → materialize-indexes-CuR3gAZb.d.cts}

@@ -1,4 +1,4 @@
-import { I as IndexEntity } from './extension-types-ixRpJVUp.cjs';
+import { I as IndexEntity } from './extension-types-BM2ACfYO.cjs';
 
 /**
  * Index materialization — runs declared index DDL against the live
@@ -80,5 +80,11 @@ type MaterializeIndexesEntry = Readonly<{
 type MaterializeIndexesResult = Readonly<{
     results: readonly MaterializeIndexesEntry[];
 }>;
+type MaterializeSystemIndexesOptions = Readonly<{
+    /** Stop on the first failure. Default: false (best-effort). */
+    stopOnError?: boolean;
+    /** Refresh planner statistics after a creation. Default: true. */
+    refreshStatistics?: boolean;
+}>;
 
-export type { MaterializeIndexesResult as M, MaterializeIndexesEntry as a, MaterializeIndexesOptions as b };
+export type { MaterializeIndexesResult as M, MaterializeIndexesEntry as a, MaterializeIndexesOptions as b, MaterializeSystemIndexesOptions as c };

package/dist/{materialize-indexes-te9TPMMJ.d.ts → materialize-indexes-zK2J_flP.d.ts}

@@ -1,4 +1,4 @@
-import { I as IndexEntity } from './extension-types-ixRpJVUp.js';
+import { I as IndexEntity } from './extension-types-BM2ACfYO.js';
 
 /**
  * Index materialization — runs declared index DDL against the live
@@ -80,5 +80,11 @@ type MaterializeIndexesEntry = Readonly<{
 type MaterializeIndexesResult = Readonly<{
     results: readonly MaterializeIndexesEntry[];
 }>;
+type MaterializeSystemIndexesOptions = Readonly<{
+    /** Stop on the first failure. Default: false (best-effort). */
+    stopOnError?: boolean;
+    /** Refresh planner statistics after a creation. Default: true. */
+    refreshStatistics?: boolean;
+}>;
 
-export type { MaterializeIndexesResult as M, MaterializeIndexesEntry as a, MaterializeIndexesOptions as b };
+export type { MaterializeIndexesResult as M, MaterializeIndexesEntry as a, MaterializeIndexesOptions as b, MaterializeSystemIndexesOptions as c };

package/dist/{postgres-CfEqsRMp.d.cts → postgres-IaBA4RgE.d.ts}

@@ -1,5 +1,5 @@
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-import { I as IndexDeclaration } from './fulltext-strategy-CDkSSYhq.cjs';
+import { I as IndexDeclaration } from './fulltext-strategy-DebsMrqg.js';
 
 /**
  * Table name configuration.

package/dist/{postgres-DQ5R6rzV.d.ts → postgres-YrYmPlaU.d.cts}

@@ -1,5 +1,5 @@
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-import { I as IndexDeclaration } from './fulltext-strategy-B57yvC5Q.js';
+import { I as IndexDeclaration } from './fulltext-strategy-C27vXaeB.cjs';
 
 /**
  * Table name configuration.

package/dist/profiler/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkUMDVATGY_cjs = require('../chunk-UMDVATGY.cjs');
-require('../chunk-H7YNSMA7.cjs');
+var chunkWWFHO375_cjs = require('../chunk-WWFHO375.cjs');
+require('../chunk-HAHNRASW.cjs');
 var chunkSJDMVITW_cjs = require('../chunk-SJDMVITW.cjs');
 var chunkTDXIBCGY_cjs = require('../chunk-TDXIBCGY.cjs');
 
@@ -519,7 +519,7 @@ var QueryProfiler = class {
       );
     }
     this.#attached = true;
-    this.#schemaIntrospector = chunkUMDVATGY_cjs.createSchemaIntrospector(
+    this.#schemaIntrospector = chunkWWFHO375_cjs.createSchemaIntrospector(
       buildNodeSchemaMap(store.graph),
       buildEdgeSchemaMap(store.graph)
     );

package/dist/profiler/index.d.cts

@@ -1,14 +1,14 @@
-import { G as GraphDef } from '../manager-DwQi8eV0.cjs';
-import { Q as QueryAst } from '../fulltext-strategy-CDkSSYhq.cjs';
-import { S as Store } from '../store-view-9KDOpZzF.cjs';
-import { P as ProfilerOptions, a as ProfileReport } from '../types-Bv9DcS_E.cjs';
-export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-Bv9DcS_E.cjs';
-import '../extension-types-ixRpJVUp.cjs';
+import { G as GraphDef } from '../manager-nU1vTJLy.cjs';
+import { Q as QueryAst } from '../fulltext-strategy-C27vXaeB.cjs';
+import { S as Store } from '../store-view-X96Rd00T.cjs';
+import { P as ProfilerOptions, a as ProfileReport } from '../types-r-Zyq2Hz.cjs';
+export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-r-Zyq2Hz.cjs';
+import '../extension-types-BM2ACfYO.cjs';
 import 'zod';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../materialize-indexes-B4e9360H.cjs';
+import '../materialize-indexes-CuR3gAZb.cjs';
 
 /**
  * QueryProfiler - Main profiler class.

package/dist/profiler/index.d.ts

@@ -1,14 +1,14 @@
-import { G as GraphDef } from '../manager-ejUCB52T.js';
-import { Q as QueryAst } from '../fulltext-strategy-B57yvC5Q.js';
-import { S as Store } from '../store-view-DplHC3Nt.js';
-import { P as ProfilerOptions, a as ProfileReport } from '../types-CoxuV7EJ.js';
-export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-CoxuV7EJ.js';
-import '../extension-types-ixRpJVUp.js';
+import { G as GraphDef } from '../manager-D00_NXvT.js';
+import { Q as QueryAst } from '../fulltext-strategy-DebsMrqg.js';
+import { S as Store } from '../store-view-ANL6mTph.js';
+import { P as ProfilerOptions, a as ProfileReport } from '../types-wsvuBgPK.js';
+export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-wsvuBgPK.js';
+import '../extension-types-BM2ACfYO.js';
 import 'zod';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm/sqlite-core';
-import '../materialize-indexes-te9TPMMJ.js';
+import '../materialize-indexes-zK2J_flP.js';
 
 /**
  * QueryProfiler - Main profiler class.

package/dist/profiler/index.js

@@ -1,5 +1,5 @@
-import { createSchemaIntrospector } from '../chunk-5SEGFTZX.js';
-import '../chunk-KBGQIPRQ.js';
+import { createSchemaIntrospector } from '../chunk-UGZUAYAR.js';
+import '../chunk-PC2UBAUB.js';
 import { resolveFieldTypeInfoAtJsonPointer } from '../chunk-SNXVDZAJ.js';
 import { parseJsonPointer, jsonPointer, normalizeJsonPointer } from '../chunk-G6Q5UM7U.js';