@nicia-ai/typegraph 0.26.0 → 0.27.0

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkHTGDWIDE_cjs = require('./chunk-HTGDWIDE.cjs');
-var chunk4TJI44WP_cjs = require('./chunk-4TJI44WP.cjs');
+var chunkZGEMI7MJ_cjs = require('./chunk-ZGEMI7MJ.cjs');
 var chunkWFUN6DCM_cjs = require('./chunk-WFUN6DCM.cjs');
 var chunk4FJVSF3K_cjs = require('./chunk-4FJVSF3K.cjs');
 var chunkPYJOBZR3_cjs = require('./chunk-PYJOBZR3.cjs');
@@ -28,7 +28,7 @@ function metaEdge(name, options = {}) {
     description: options.description
   };
   return Object.freeze({
-    [chunk4TJI44WP_cjs.META_EDGE_BRAND]: true,
+    [chunkZGEMI7MJ_cjs.META_EDGE_BRAND]: true,
     name,
     properties
   });
@@ -4298,7 +4298,7 @@ function planRemovals(graph, names) {
   if (namesSet.size === 0) {
     return { document, removedNodeKinds: [], removedEdgeKinds: [] };
   }
-  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunk4TJI44WP_cjs.extensionKindNames(document);
+  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunkZGEMI7MJ_cjs.extensionKindNames(document);
   const compileTimeNodeNames = new Set(
     Object.keys(graph.nodes).filter((name) => !runtimeNodeNames.has(name))
   );
@@ -4398,8 +4398,8 @@ function planRemovals(graph, names) {
 function stripGraphExtension(graph) {
   const document = graph.extension;
   if (document === void 0) return graph;
-  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunk4TJI44WP_cjs.extensionKindNames(document);
-  const runtimeOntologyKeys = chunk4TJI44WP_cjs.buildGraphExtensionOntologyKeySet(document);
+  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunkZGEMI7MJ_cjs.extensionKindNames(document);
+  const runtimeOntologyKeys = chunkZGEMI7MJ_cjs.buildGraphExtensionOntologyKeySet(document);
   const compileNodes = {};
   for (const [name, registration] of Object.entries(graph.nodes)) {
     if (runtimeNodeNames.has(name)) continue;
@@ -4411,7 +4411,7 @@ function stripGraphExtension(graph) {
     compileEdges[name] = registration;
   }
   const compileOntology = graph.ontology.filter(
-    (relation) => !runtimeOntologyKeys.has(chunk4TJI44WP_cjs.compileTimeOntologyKey(relation))
+    (relation) => !runtimeOntologyKeys.has(chunkZGEMI7MJ_cjs.compileTimeOntologyKey(relation))
   );
   const compileIndexes = (graph.indexes ?? []).filter(
     (index) => index.origin !== "runtime"
@@ -4451,13 +4451,13 @@ function buildCompileTimeReferentIndex(graph, runtimeEdgeNames) {
       append(endpoint.kind, referent);
     }
   }
-  const runtimeOntologyKeys = chunk4TJI44WP_cjs.buildGraphExtensionOntologyKeySet(
+  const runtimeOntologyKeys = chunkZGEMI7MJ_cjs.buildGraphExtensionOntologyKeySet(
     graph.extension
   );
   for (const relation of graph.ontology) {
-    if (runtimeOntologyKeys.has(chunk4TJI44WP_cjs.compileTimeOntologyKey(relation))) continue;
-    const fromName = chunk4TJI44WP_cjs.getTypeName(relation.from);
-    const toName = chunk4TJI44WP_cjs.getTypeName(relation.to);
+    if (runtimeOntologyKeys.has(chunkZGEMI7MJ_cjs.compileTimeOntologyKey(relation))) continue;
+    const fromName = chunkZGEMI7MJ_cjs.getTypeName(relation.from);
+    const toName = chunkZGEMI7MJ_cjs.getTypeName(relation.to);
     const referent = {
       type: "compile-time-ontology",
       name: `${relation.metaEdge.name}(${fromName}, ${toName})`
@@ -9996,8 +9996,8 @@ function createQueryBuilder(graphId, registry, options) {
 function buildKindRegistry(graph) {
   const nodeTypes = extractNodeTypes(graph);
   const edgeTypes = extractEdgeTypes(graph);
-  const closures = graph.ontology.length > 0 ? chunk4TJI44WP_cjs.computeClosuresFromOntology(graph.ontology) : chunk4TJI44WP_cjs.createEmptyClosures();
-  return new chunk4TJI44WP_cjs.KindRegistry(nodeTypes, edgeTypes, closures);
+  const closures = graph.ontology.length > 0 ? chunkZGEMI7MJ_cjs.computeClosuresFromOntology(graph.ontology) : chunkZGEMI7MJ_cjs.createEmptyClosures();
+  return new chunkZGEMI7MJ_cjs.KindRegistry(nodeTypes, edgeTypes, closures);
 }
 function extractNodeTypes(graph) {
   const result = /* @__PURE__ */ new Map();
@@ -10992,7 +10992,7 @@ function createEdgeCollectionsProxy(graph, graphId, registry, backend, operation
 // src/store/introspect.ts
 function introspectSchema(graph, context) {
   const extension = graph.extension;
-  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunk4TJI44WP_cjs.extensionKindNames(extension);
+  const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = chunkZGEMI7MJ_cjs.extensionKindNames(extension);
   const deprecated = graph.deprecatedKinds;
   const kinds = [];
   for (const [name, registration] of Object.entries(graph.nodes)) {
@@ -11003,7 +11003,7 @@ function introspectSchema(graph, context) {
       description: reg.type.description,
       annotations: reg.type.annotations,
       deprecated: deprecated.has(name),
-      properties: chunk4TJI44WP_cjs.serializeSchemaProperties(reg.type.schema),
+      properties: chunkZGEMI7MJ_cjs.serializeSchemaProperties(reg.type.schema),
       unique: (reg.unique ?? []).map((constraint) => ({
         name: constraint.name,
         fields: [...constraint.fields],
@@ -11024,17 +11024,17 @@ function introspectSchema(graph, context) {
       to: reg.to.map((entry2) => entry2.kind),
       cardinality: reg.cardinality ?? "many",
       endpointExistence: reg.endpointExistence ?? "notDeleted",
-      properties: chunk4TJI44WP_cjs.serializeSchemaProperties(edgeType.schema),
+      properties: chunkZGEMI7MJ_cjs.serializeSchemaProperties(edgeType.schema),
       annotations: edgeType.annotations,
       deprecated: deprecated.has(name)
     });
   }
-  const runtimeOntologyKeys = chunk4TJI44WP_cjs.buildGraphExtensionOntologyKeySet(extension);
+  const runtimeOntologyKeys = chunkZGEMI7MJ_cjs.buildGraphExtensionOntologyKeySet(extension);
   const ontology = graph.ontology.map((relation) => ({
     metaEdge: relation.metaEdge.name,
-    from: chunk4TJI44WP_cjs.getTypeName(relation.from),
-    to: chunk4TJI44WP_cjs.getTypeName(relation.to),
-    origin: runtimeOntologyKeys.has(chunk4TJI44WP_cjs.compileTimeOntologyKey(relation)) ? "runtime" : "compile-time"
+    from: chunkZGEMI7MJ_cjs.getTypeName(relation.from),
+    to: chunkZGEMI7MJ_cjs.getTypeName(relation.to),
+    origin: runtimeOntologyKeys.has(chunkZGEMI7MJ_cjs.compileTimeOntologyKey(relation)) ? "runtime" : "compile-time"
   }));
   return {
     graphId: context.graphId,
@@ -11429,14 +11429,14 @@ async function reconcilePendingRemovals(context) {
   const reconciliations = [];
   const stopAtVersion = marker ?? 1;
   let currentRow = activeRow;
-  let currentSchema = chunk4TJI44WP_cjs.parseSerializedSchema(activeRow.schema_doc);
+  let currentSchema = chunkZGEMI7MJ_cjs.parseSerializedSchema(activeRow.schema_doc);
   while (currentRow.version > stopAtVersion) {
     const priorRow = await backend.getSchemaVersion(
       graphId,
       currentRow.version - 1
     );
     if (priorRow === void 0) break;
-    const priorSchema = chunk4TJI44WP_cjs.parseSerializedSchema(priorRow.schema_doc);
+    const priorSchema = chunkZGEMI7MJ_cjs.parseSerializedSchema(priorRow.schema_doc);
     for (const entity of ENTITY_KINDS) {
       const priorEntries = priorSchema[entity === "node" ? "nodes" : "edges"];
       const currentEntries = currentSchema[entity === "node" ? "nodes" : "edges"];
@@ -11952,7 +11952,7 @@ async function validateAndPrepareEdgeCreate(ctx, input, id, backend) {
       nodeId: input.toId
     });
   }
-  const validatedProps = chunk4TJI44WP_cjs.validateEdgeProps(edgeKind.schema, input.props, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateEdgeProps(edgeKind.schema, input.props, {
     kind,
     operation: "create"
   });
@@ -12102,7 +12102,7 @@ async function executeEdgeUpdate(ctx, input, backend) {
     const edgeKind = registration.type;
     const existingProps = JSON.parse(existing.props);
     const mergedProps = { ...existingProps, ...input.props };
-    const validatedProps = chunk4TJI44WP_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
+    const validatedProps = chunkZGEMI7MJ_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
       kind: existing.kind,
       operation: "update",
       id
@@ -12128,7 +12128,7 @@ async function executeEdgeUpsertUpdate(ctx, input, backend, options) {
   const edgeKind = registration.type;
   const existingProps = JSON.parse(existing.props);
   const mergedProps = { ...existingProps, ...input.props };
-  const validatedProps = chunk4TJI44WP_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
     kind: existing.kind,
     operation: "update",
     id
@@ -12285,7 +12285,7 @@ async function executeEdgeGetOrCreateByEndpoints(ctx, kind, fromKind, fromId, to
   const matchOn = options?.matchOn ?? [];
   const registration = getEdgeRegistration(ctx.graph, kind);
   const edgeKind = registration.type;
-  const validatedProps = chunk4TJI44WP_cjs.validateEdgeProps(edgeKind.schema, props, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateEdgeProps(edgeKind.schema, props, {
     kind,
     operation: "create"
   });
@@ -12367,7 +12367,7 @@ async function executeEdgeBulkGetOrCreateByEndpoints(ctx, kind, items, backend,
   validateMatchOnFields(edgeKind.schema, matchOn, kind);
   const validated = [];
   for (const item of items) {
-    const validatedProps = chunk4TJI44WP_cjs.validateEdgeProps(edgeKind.schema, item.props, {
+    const validatedProps = chunkZGEMI7MJ_cjs.validateEdgeProps(edgeKind.schema, item.props, {
       kind,
       operation: "create"
     });
@@ -13014,7 +13014,7 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend) {
   const kind = input.kind;
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunk4TJI44WP_cjs.validateNodeProps(nodeKind.schema, input.props, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateNodeProps(nodeKind.schema, input.props, {
     kind,
     operation: "create"
   });
@@ -13088,7 +13088,7 @@ async function performNodeUpdate(ctx, input, backend, options) {
   const existingProps = JSON.parse(existing.props);
   const mergedProps = { ...existingProps, ...input.props };
   const nodeKind = registration.type;
-  const validatedProps = chunk4TJI44WP_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
     kind,
     operation: "update",
     id
@@ -13361,7 +13361,7 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   const ifExists = options?.ifExists ?? "return";
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunk4TJI44WP_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
@@ -13433,7 +13433,7 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
 async function executeNodeFindByConstraint(ctx, kind, constraintName, props, backend) {
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunk4TJI44WP_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkZGEMI7MJ_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
@@ -13470,7 +13470,7 @@ async function executeNodeFindByConstraint(ctx, kind, constraintName, props, bac
 function validateAndComputeKeys(nodeKind, kind, constraint, items) {
   const validated = [];
   for (const item of items) {
-    const validatedProps = chunk4TJI44WP_cjs.validateNodeProps(nodeKind.schema, item.props, {
+    const validatedProps = chunkZGEMI7MJ_cjs.validateNodeProps(nodeKind.schema, item.props, {
       kind,
       operation: "create"
     });
@@ -14982,7 +14982,7 @@ var Store = class _Store {
    */
   async evolve(extension, options) {
     const { activeRow, baseline } = await this.#loadCaughtUp("evolve");
-    const merged = chunk4TJI44WP_cjs.mergeGraphExtension(baseline, extension);
+    const merged = chunkZGEMI7MJ_cjs.mergeGraphExtension(baseline, extension);
     if (merged === baseline) {
       if (baseline === this.#graph) {
         if (options?.ref !== void 0) options.ref.current = this;
@@ -15018,7 +15018,7 @@ var Store = class _Store {
       );
       if (error !== void 0) throw error;
     }
-    const committed = await chunk4TJI44WP_cjs.commitNewSchemaVersion(
+    const committed = await chunkZGEMI7MJ_cjs.commitNewSchemaVersion(
       this.#backend,
       merged,
       activeRow.version
@@ -15170,9 +15170,9 @@ var Store = class _Store {
       );
     }
     const compileTimeGraph = stripGraphExtension(this.#graph);
-    const merged = plan.document === void 0 ? compileTimeGraph : chunk4TJI44WP_cjs.mergeGraphExtension(compileTimeGraph, plan.document);
-    const finalGraph = chunk4TJI44WP_cjs.applyDeprecatedKinds(merged, baseline.deprecatedKinds);
-    const committedRow = await chunk4TJI44WP_cjs.commitNewSchemaVersion(
+    const merged = plan.document === void 0 ? compileTimeGraph : chunkZGEMI7MJ_cjs.mergeGraphExtension(compileTimeGraph, plan.document);
+    const finalGraph = chunkZGEMI7MJ_cjs.applyDeprecatedKinds(merged, baseline.deprecatedKinds);
+    const committedRow = await chunkZGEMI7MJ_cjs.commitNewSchemaVersion(
       this.#backend,
       finalGraph,
       activeRow.version
@@ -15255,8 +15255,8 @@ var Store = class _Store {
         schemaMetadataFromRow(activeRow)
       );
     }
-    const merged = chunk4TJI44WP_cjs.applyDeprecatedKinds(baseline, nextSet);
-    const result = await chunk4TJI44WP_cjs.ensureSchema(this.#backend, merged, {
+    const merged = chunkZGEMI7MJ_cjs.applyDeprecatedKinds(baseline, nextSet);
+    const result = await chunkZGEMI7MJ_cjs.ensureSchema(this.#backend, merged, {
       preloaded: { activeRow, storedSchema },
       autoMigrate: true
     });
@@ -15265,8 +15265,8 @@ var Store = class _Store {
   }
   #catchUpToStored(storedSchema) {
     const compileTimeGraph = stripGraphExtension(this.#graph);
-    const withGraphExtension = storedSchema.extension === void 0 ? compileTimeGraph : chunk4TJI44WP_cjs.mergeGraphExtension(compileTimeGraph, storedSchema.extension);
-    return chunk4TJI44WP_cjs.applyDeprecatedKinds(
+    const withGraphExtension = storedSchema.extension === void 0 ? compileTimeGraph : chunkZGEMI7MJ_cjs.mergeGraphExtension(compileTimeGraph, storedSchema.extension);
+    return chunkZGEMI7MJ_cjs.applyDeprecatedKinds(
       withGraphExtension,
       storedSchema.deprecatedKinds
     );
@@ -15284,7 +15284,7 @@ var Store = class _Store {
    * serializes the actual commit.
    */
   async #loadCaughtUp(verb) {
-    const activeRow = await chunk4TJI44WP_cjs.loadActiveSchemaWithBootstrap(
+    const activeRow = await chunkZGEMI7MJ_cjs.loadActiveSchemaWithBootstrap(
       this.#backend,
       this.graphId
     );
@@ -15295,7 +15295,7 @@ var Store = class _Store {
         { code }
       );
     }
-    const storedSchema = chunk4TJI44WP_cjs.parseSerializedSchema(activeRow.schema_doc);
+    const storedSchema = chunkZGEMI7MJ_cjs.parseSerializedSchema(activeRow.schema_doc);
     const baseline = this.#catchUpToStored(storedSchema);
     return { activeRow, storedSchema, baseline };
   }
@@ -15461,17 +15461,24 @@ function schemaMetadataForResult(activeRow, result) {
   }
   return schemaMetadataFromRow(activeRow);
 }
+async function materializeRuntimeContributions(backend, graphId) {
+  if (backend.ensureRuntimeContributions) {
+    await backend.ensureRuntimeContributions(graphId);
+    return;
+  }
+  await backend.ensureFulltextTable?.(graphId);
+}
 async function createStoreWithSchema(graph, backend, options) {
   const {
     graph: merged,
     activeRow,
     storedSchema
-  } = await chunk4TJI44WP_cjs.loadAndMergeGraphExtensionDocument(backend, graph);
-  const result = await chunk4TJI44WP_cjs.ensureSchema(backend, merged, {
+  } = await chunkZGEMI7MJ_cjs.loadAndMergeGraphExtensionDocument(backend, graph);
+  const result = await chunkZGEMI7MJ_cjs.ensureSchema(backend, merged, {
     ...options,
     preloaded: { activeRow, storedSchema }
   });
-  await backend.ensureRuntimeContributions?.(merged.id);
+  await materializeRuntimeContributions(backend, merged.id);
   const store = new Store(
     merged,
     backend,
@@ -15480,70 +15487,84 @@ async function createStoreWithSchema(graph, backend, options) {
   );
   return [store, result];
 }
+async function createVerifiedStore(graph, backend, options) {
+  const {
+    graph: merged,
+    activeRow,
+    result
+  } = await chunkZGEMI7MJ_cjs.loadAndVerifyGraph(backend, graph);
+  const store = new Store(
+    merged,
+    backend,
+    options,
+    schemaMetadataFromRow(activeRow)
+  );
+  return [store, result];
+}
 
 Object.defineProperty(exports, "broader", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.broader; }
+  get: function () { return chunkZGEMI7MJ_cjs.broader; }
 });
 Object.defineProperty(exports, "core", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.core; }
+  get: function () { return chunkZGEMI7MJ_cjs.core; }
 });
 Object.defineProperty(exports, "defineEdge", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.defineEdge; }
+  get: function () { return chunkZGEMI7MJ_cjs.defineEdge; }
 });
 Object.defineProperty(exports, "defineNode", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.defineNode; }
+  get: function () { return chunkZGEMI7MJ_cjs.defineNode; }
 });
 Object.defineProperty(exports, "differentFrom", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.differentFrom; }
+  get: function () { return chunkZGEMI7MJ_cjs.differentFrom; }
 });
 Object.defineProperty(exports, "disjointWith", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.disjointWith; }
+  get: function () { return chunkZGEMI7MJ_cjs.disjointWith; }
 });
 Object.defineProperty(exports, "equivalentTo", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.equivalentTo; }
+  get: function () { return chunkZGEMI7MJ_cjs.equivalentTo; }
 });
 Object.defineProperty(exports, "hasPart", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.hasPart; }
+  get: function () { return chunkZGEMI7MJ_cjs.hasPart; }
 });
 Object.defineProperty(exports, "implies", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.implies; }
+  get: function () { return chunkZGEMI7MJ_cjs.implies; }
 });
 Object.defineProperty(exports, "inverseOf", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.inverseOf; }
+  get: function () { return chunkZGEMI7MJ_cjs.inverseOf; }
 });
 Object.defineProperty(exports, "isMetaEdge", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.isMetaEdge; }
+  get: function () { return chunkZGEMI7MJ_cjs.isMetaEdge; }
 });
 Object.defineProperty(exports, "narrower", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.narrower; }
+  get: function () { return chunkZGEMI7MJ_cjs.narrower; }
 });
 Object.defineProperty(exports, "partOf", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.partOf; }
+  get: function () { return chunkZGEMI7MJ_cjs.partOf; }
 });
 Object.defineProperty(exports, "relatedTo", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.relatedTo; }
+  get: function () { return chunkZGEMI7MJ_cjs.relatedTo; }
 });
 Object.defineProperty(exports, "sameAs", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.sameAs; }
+  get: function () { return chunkZGEMI7MJ_cjs.sameAs; }
 });
 Object.defineProperty(exports, "subClassOf", {
   enumerable: true,
-  get: function () { return chunk4TJI44WP_cjs.subClassOf; }
+  get: function () { return chunkZGEMI7MJ_cjs.subClassOf; }
 });
 Object.defineProperty(exports, "defineGraph", {
   enumerable: true,
@@ -15834,6 +15855,7 @@ exports.createQueryBuilder = createQueryBuilder;
 exports.createSqlSchema = createSqlSchema;
 exports.createStore = createStore;
 exports.createStoreWithSchema = createStoreWithSchema;
+exports.createVerifiedStore = createVerifiedStore;
 exports.defineSubgraphProject = defineSubgraphProject;
 exports.exists = exists;
 exports.externalRef = externalRef;