@nicia-ai/typegraph 0.40.0 → 0.41.0

package/dist/{chunk-3BL3JFHL.js → chunk-MQBF3XGY.js}

@@ -6,7 +6,7 @@ import { chunk } from './chunk-35S6P5ZU.js';
 import { DEFAULT_SQL_SCHEMA, requireSqlSchema, recordedReadSchemaFor, createSqlSchema, requireExternalRecordedReadSource, createRecordedReadBinding, vectorSlotKey, recordedReadSqlSchema, requireRecordedReadBinding, ALIAS_CTE_PREFIX, EMBEDDINGS_CTE_ALIAS, FULLTEXT_CTE_ALIAS, HYBRID_CANDIDATES_CTE_ALIAS } from './chunk-YYLMXERH.js';
 import { runOptionallyInTransaction, createTransactionReadBackend, rowPropsToObject, createBackendOverlay, INTERNAL_TEMPORARY_WRITES } from './chunk-L5ET7FYQ.js';
 import { resolveReadCoordinate, withRecordedCoordinate, describeCoordinate, coordinateContext, recordedInstantWallTime, asRecordedInstant, assertValidRecordedInstant } from './chunk-QOHTVDHU.js';
-import { loadAndMergeGraphExtensionDocument, ensureSchema, loadAndVerifyGraph, buildKindRegistry, mergeGraphExtension, commitNewSchemaVersion, applyDeprecatedKinds, loadActiveSchemaWithBootstrap, parseSerializedSchema, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, serializeIndexDeclaration } from './chunk-CU3LPYNB.js';
+import { loadAndMergeGraphExtensionDocument, ensureSchema, loadAndVerifyGraph, buildKindRegistry, mergeGraphExtension, commitNewSchemaVersion, applyDeprecatedKinds, loadActiveSchemaWithBootstrap, parseSerializedSchema, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, serializeIndexDeclaration } from './chunk-V3S74J44.js';
 import { getTypeName } from './chunk-76HE7DJP.js';
 import { validateEdgeProps } from './chunk-ZE6NVENI.js';
 import { canonicalEqual, sortedReplacer } from './chunk-UR7W5YQK.js';
@@ -16971,6 +16971,37 @@ var StoreImplementation = class _StoreImplementation {
   get registry() {
     return this.#registry;
   }
+  /**
+   * An opaque, in-memory snapshot of this store's reconciled schema — the
+   * merged compile-time + runtime-committed graph plus the committed version
+   * it reflects. Cache it after a verified open and hand it to
+   * {@link createAdapterStore} via `{ reconciled }` (or call
+   * {@link AdapterStoreImplementation.withBackend}) to build request-scoped
+   * stores against fresh connections with zero database round-trips. Refresh
+   * it when {@link getCommittedSchemaVersion} reports a moved version.
+   */
+  get reconciledSchema() {
+    return Object.freeze({
+      graph: this.#graph,
+      version: this.#schemaMetadata.schemaVersion,
+      hash: this.#schemaMetadata.schemaHash
+    });
+  }
+  /**
+   * Reconstruction inputs for a connection rebind: the merged graph, the
+   * verbatim construction options, and the reconciled schema metadata. Lets an
+   * adapter subclass rebuild an equivalent store against a fresh backend
+   * without a verify round-trip.
+   *
+   * @internal
+   */
+  reconstructionState() {
+    return {
+      graph: this.#graph,
+      options: this.#options,
+      schemaMetadata: this.#schemaMetadata
+    };
+  }
   /**
    * Whether recorded-time capture is enabled for this store.
    *
@@ -18950,7 +18981,7 @@ var StoreImplementation = class _StoreImplementation {
     );
   }
 };
-var AdapterStoreImplementation = class extends StoreImplementation {
+var AdapterStoreImplementation = class _AdapterStoreImplementation extends StoreImplementation {
   backend;
   constructor(graph, backend, options, schemaMetadata) {
     super(graph, backend, options, schemaMetadata, backend);
@@ -18958,6 +18989,23 @@ var AdapterStoreImplementation = class extends StoreImplementation {
       createGraphBackendProjection(this[STORE_RUNTIME].backend)
     );
   }
+  /**
+   * Rebind this store's already-reconciled schema onto a fresh backend/
+   * connection, returning a new equivalent store with **no** verify round-trip.
+   * The connection is captured at construction and never mutated, so this
+   * returns a new instance rather than rebinding in place — the serverless
+   * per-request primitive: verify once per isolate, then `withBackend` the
+   * per-request connection.
+   */
+  withBackend(backend) {
+    const state = this.reconstructionState();
+    return new _AdapterStoreImplementation(
+      state.graph,
+      backend,
+      state.options,
+      state.schemaMetadata
+    );
+  }
   async evolve(extension, options) {
     return this.#withAdapterReplacement(
       options?.ref,
@@ -19041,8 +19089,26 @@ function createStore(graph, backend, options) {
   return new StoreImplementation(graph, backend, options);
 }
 function createAdapterStore(graph, backend, options) {
+  const reconciled = options?.reconciled;
+  if (reconciled !== void 0 && reconciled.graph.id !== graph.id) {
+    throw new ConfigurationError(
+      `Reconciled snapshot is for graph "${reconciled.graph.id}", not "${graph.id}".`,
+      { code: "RECONCILED_GRAPH_MISMATCH" },
+      {
+        suggestion: "Pass the ReconciledSchema produced from the same graph you are building the store with; snapshots are not interchangeable across graphs."
+      }
+    );
+  }
+  const storeOptions = stripReconciledOption(options);
+  const resolvedGraph = reconciled?.graph ?? graph;
+  const schemaMetadata = reconciled === void 0 ? void 0 : reconciledSchemaMetadata(reconciled);
   return asAdapterStoreSurface(
-    new AdapterStoreImplementation(graph, backend, options)
+    new AdapterStoreImplementation(
+      resolvedGraph,
+      backend,
+      storeOptions,
+      schemaMetadata
+    )
   );
 }
 function isKnownEdgeKind(graph, name) {
@@ -19060,6 +19126,17 @@ function schemaMetadataFromRow(row) {
     schemaHash: row.schema_hash
   });
 }
+function reconciledSchemaMetadata(reconciled) {
+  return Object.freeze({
+    schemaVersion: reconciled.version,
+    schemaHash: reconciled.hash
+  });
+}
+function stripReconciledOption(options) {
+  if (options === void 0 || !("reconciled" in options)) return options;
+  const { reconciled: _reconciled, ...rest } = options;
+  return rest;
+}
 function schemaMetadataForResult(activeRow, result) {
   if (result.status === "initialized" || result.status === "migrated") {
     return schemaMetadataFromRow(result.committedRow);
@@ -19205,5 +19282,5 @@ async function createVerifiedAdapterStore(graph, backend, options) {
 }
 
 export { ExecutableAggregateQuery, ExecutableQuery, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, PreparedQuery, QueryBuilder, RecordedStoreView, StoreSearch, StoreView, UnionableQuery, avg, composeFragments, count, countDistinct, countDistinctEdges, countEdges, createAdapterStore, createAdapterStoreWithSchema, createFragment, createQueryBuilder, createStore, createStoreWithSchema, createVerifiedAdapterStore, createVerifiedStore, defineSubgraphProject, field, having, havingEq, havingGt, havingGte, havingLt, havingLte, limitFragment, max, min, offsetFragment, orderByFragment, sum };
-//# sourceMappingURL=chunk-3BL3JFHL.js.map
-//# sourceMappingURL=chunk-3BL3JFHL.js.map
+//# sourceMappingURL=chunk-MQBF3XGY.js.map
+//# sourceMappingURL=chunk-MQBF3XGY.js.map