@nicia-ai/typegraph 0.26.0 → 0.27.0

package/dist/{chunk-3W6AIFT2.js → chunk-X53YKGHR.js}

@@ -2360,10 +2360,7 @@ function parseSerializedSchema(json) {
 }
 async function loadActiveSchemaWithBootstrap(backend, graphId) {
   try {
-    const row = await backend.getActiveSchema(graphId);
-    const ensureRuntime = backend.ensureRuntimeContributions ? backend.ensureRuntimeContributions(graphId) : backend.ensureFulltextTable?.(graphId);
-    await ensureRuntime;
-    return row;
+    return await backend.getActiveSchema(graphId);
   } catch (error) {
     if (backend.bootstrapTables && isMissingTableError(error)) {
       await backend.bootstrapTables();
@@ -2377,11 +2374,17 @@ async function loadAndMergeGraphExtensionDocument(backend, graph) {
   if (activeRow === void 0) {
     return { graph, activeRow: void 0, storedSchema: void 0 };
   }
+  const { graph: merged, storedSchema } = mergeStoredGraphExtension(
+    graph,
+    activeRow
+  );
+  return { graph: merged, activeRow, storedSchema };
+}
+function mergeStoredGraphExtension(graph, activeRow) {
   const storedSchema = parseSerializedSchema(activeRow.schema_doc);
   const merged = storedSchema.extension === void 0 ? graph : mergeGraphExtension(graph, storedSchema.extension);
   return {
     graph: applyDeprecatedKinds(merged, storedSchema.deprecatedKinds),
-    activeRow,
     storedSchema
   };
 }
@@ -2464,6 +2467,69 @@ async function ensureSchema(backend, graph, options) {
   }
   return { status: "breaking", diff, actions };
 }
+async function loadAndVerifyGraph(backend, graph) {
+  const activeRow = await readActiveSchemaPure(backend, graph.id);
+  const { graph: merged, storedSchema } = mergeStoredGraphExtension(
+    graph,
+    activeRow
+  );
+  const storedHash = activeRow.schema_hash;
+  const currentHash = await getSchemaHash(merged, activeRow.version + 1);
+  if (storedHash !== currentHash) {
+    const currentSchema = serializeSchema(merged, activeRow.version + 1);
+    const diff = computeSchemaDiff(storedSchema, currentSchema);
+    if (diff.hasChanges) {
+      throw schemaBehindError(merged.id, activeRow.version, diff);
+    }
+  }
+  await backend.assertRuntimeContributionsInitialized?.(merged.id);
+  return {
+    graph: merged,
+    activeRow,
+    result: { status: "unchanged", version: activeRow.version }
+  };
+}
+function schemaBehindError(graphId, fromVersion, diff) {
+  const actions = getMigrationActions(diff);
+  const qualifier = isBackwardsCompatible(diff) ? "safe auto-migration" : "breaking change";
+  return new MigrationError(
+    `Schema verification failed for graph "${graphId}": ${diff.summary} (${qualifier}). ${actions.length} migration action(s) needed. The least-privilege runtime cannot migrate \u2014 run createStoreWithSchema(graph, adminBackend) under a privileged role (after any generated migration SQL, if you manage DDL externally) before attaching with createStore() / createVerifiedStore().`,
+    {
+      graphId,
+      fromVersion,
+      toVersion: fromVersion + 1
+    }
+  );
+}
+async function assertSchemaCurrent(backend, graph) {
+  const { result } = await loadAndVerifyGraph(backend, graph);
+  return result;
+}
+async function readActiveSchemaPure(backend, graphId) {
+  let activeRow;
+  try {
+    activeRow = await backend.getActiveSchema(graphId);
+  } catch (error) {
+    if (isMissingTableError(error)) {
+      throw schemaNotInitializedError(graphId, error);
+    }
+    throw error;
+  }
+  if (activeRow === void 0) {
+    throw schemaNotInitializedError(graphId);
+  }
+  return activeRow;
+}
+function schemaNotInitializedError(graphId, cause) {
+  return new ConfigurationError(
+    `Cannot verify graph "${graphId}": no schema has been initialized. Run createStoreWithSchema(graph, adminBackend) once under a privileged role (which commits the schema_versions row and materializes contribution markers) before attaching with createStore() / createVerifiedStore(). Generated migration SQL creates the tables but does not initialize the schema row.`,
+    { graphId },
+    {
+      cause,
+      suggestion: "Run createStoreWithSchema(graph, adminBackend) once under a privileged role. If you manage DDL externally with drizzle-kit / generatePostgresMigrationSQL / generateSqliteMigrationSQL, apply that first, then still run createStoreWithSchema to commit the schema row and contribution markers."
+    }
+  );
+}
 async function initializeSchema(backend, graph) {
   const schema = serializeSchema(graph, 1);
   const hash = await computeSchemaHash(schema);
@@ -2598,6 +2664,6 @@ function createValidationError(message, issues, context) {
   });
 }
 
-export { KindRegistry, META_EDGE_BRAND, applyDeprecatedKinds, broader, buildGraphExtensionOntologyKeySet, commitNewSchemaVersion, compileTimeOntologyKey, computeClosuresFromOntology, computeSchemaDiff, computeSchemaHash, core, createEmptyClosures, createValidationError, defineEdge, defineNode, deserializeWherePredicate, differentFrom, disjointWith, ensureSchema, equivalentTo, extensionKindNames, getActiveSchema, getMigrationActions, getSchemaChanges, getTypeName, hasPart, implies, initializeSchema, inverseOf, isBackwardsCompatible, isMetaEdge, isSchemaInitialized, loadActiveSchemaWithBootstrap, loadAndMergeGraphExtensionDocument, mergeGraphExtension, migrateSchema, narrower, parseSerializedSchema, partOf, relatedTo, rollbackSchema, sameAs, serializeSchema, serializeSchemaProperties, subClassOf, validateEdgeProps, validateNodeProps, validateProps, wrapZodError };
-//# sourceMappingURL=chunk-3W6AIFT2.js.map
-//# sourceMappingURL=chunk-3W6AIFT2.js.map
+export { KindRegistry, META_EDGE_BRAND, applyDeprecatedKinds, assertSchemaCurrent, broader, buildGraphExtensionOntologyKeySet, commitNewSchemaVersion, compileTimeOntologyKey, computeClosuresFromOntology, computeSchemaDiff, computeSchemaHash, core, createEmptyClosures, createValidationError, defineEdge, defineNode, deserializeWherePredicate, differentFrom, disjointWith, ensureSchema, equivalentTo, extensionKindNames, getActiveSchema, getMigrationActions, getSchemaChanges, getTypeName, hasPart, implies, initializeSchema, inverseOf, isBackwardsCompatible, isMetaEdge, isSchemaInitialized, loadActiveSchemaWithBootstrap, loadAndMergeGraphExtensionDocument, loadAndVerifyGraph, mergeGraphExtension, migrateSchema, narrower, parseSerializedSchema, partOf, relatedTo, rollbackSchema, sameAs, serializeSchema, serializeSchemaProperties, subClassOf, validateEdgeProps, validateNodeProps, validateProps, wrapZodError };
+//# sourceMappingURL=chunk-X53YKGHR.js.map
+//# sourceMappingURL=chunk-X53YKGHR.js.map