@nicia-ai/typegraph 0.39.0 → 0.40.0

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

@@ -1,25 +1,25 @@
 import { compareStrings, compareCodePoints } from './chunk-DRACN6XG.js';
-import { createEdgeRowMapper, createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, POSTGRES_ROW_MAPPER_CONFIG } from './chunk-AOL64O4Z.js';
-import { rowToNode, executeNodeBulkFindByIndex, executeNodeBulkFindByConstraint, executeNodeFindByConstraint, executeNodeBulkGetOrCreateByConstraint, executeNodeGetOrCreateByConstraint, executeNodeHardDelete, executeNodeDelete, nodeUpsertDirtyCheck, executeNodeUpsertUpdate, executeNodeUpdate, executeNodeCreateNoReturnBatch, executeNodeCreateBatch, executeNodeCreate, rowToEdge, runInWriteTransaction, checkCardinalityConstraint, runHookedWriteOperation, rowToNodeMeta, rowToEdgeMeta } from './chunk-3SK4SVTW.js';
-import { isParameterRef, fieldRef, buildFieldBuilderForTypeInfo, stringField, createFulltextAccessor, storeRuntime, CURRENT_READ_INSTANT_PLACEHOLDER, DEFAULT_SQL_SCHEMA, requireSqlSchema, recordedReadSchemaFor, withPinnedReadInstant, STORE_RUNTIME, assertRevisionTrackableBackend, createSqlSchema, requireExternalRecordedReadSource, createRecordedReadBinding, createRecordedBackend, readRecordedClock, ensureRevisionOrigin, TRANSACTION_RUNTIME, withRecordedFlushObserver, recordedCaptureRequiresCallbackTransactionError, assertRecordedCaptureTransactionIsolation, createRecordedTransactionScope, lockRecordedGraphWrite, generateId, createGraphBackendProjection, vectorSlotKey, baseField, objectField, arrayField, dateField, numberField, computeFulltextContent, AUTO_REFRESH_STATISTICS_ROW_THRESHOLD, advanceRevisionClock, recordedReadSqlSchema, requireRecordedReadBinding, runInsertBatch, edgeInsertDispatch, runInsertBatchReturning, projectBackendMembers, sqlValueList, getEmbeddingFields, getNodeRowsByIds, getEdgeRowsByIds, compileKindFilter, currentReadInstant, compileTemporalFilter, validateEdgeEndpoints, buildPredicateIndex, compileFieldValue, recordedBindParamBudget, extractVectorSimilarityPredicates, extractFulltextMatchPredicates, currentReadInstantFor, extractTemporalOptions, compilePredicateExpression, getPredicatesForAlias, getFieldPointer, getNodeKindsForAlias, getHybridTargetAlias, closeRecordedHardDeletedKind, throwHistoryUnsafeSqlAccess, throwRevisionTrackingUnsafeSqlAccess, compilePredicateClauses, ALIAS_CTE_PREFIX, EMBEDDINGS_CTE_ALIAS, FULLTEXT_CTE_ALIAS, HYBRID_CANDIDATES_CTE_ALIAS } from './chunk-IFDXG2YJ.js';
+import { createEdgeRowMapper, createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, POSTGRES_ROW_MAPPER_CONFIG } from './chunk-L3DDZUZP.js';
+import { rowToNode, executeNodeBulkFindByIndex, executeNodeBulkFindByConstraint, executeNodeFindByConstraint, executeNodeBulkGetOrCreateByConstraint, executeNodeGetOrCreateByConstraint, executeNodeHardDelete, executeNodeDelete, nodeUpsertDirtyCheck, executeNodeUpsertUpdate, executeNodeUpdate, executeNodeCreateNoReturnBatch, executeNodeCreateBatch, executeNodeCreate, rowToEdge, runInWriteTransaction, checkCardinalityConstraint, runHookedWriteOperation, rowToNodeMeta, rowToEdgeMeta } from './chunk-53BSOG3O.js';
+import { isParameterRef, fieldRef, buildFieldBuilderForTypeInfo, stringField, createFulltextAccessor, storeRuntime, CURRENT_READ_INSTANT_PLACEHOLDER, withPinnedReadInstant, STORE_RUNTIME, assertRevisionTrackableBackend, createRecordedBackend, readRecordedClock, ensureRevisionOrigin, TRANSACTION_RUNTIME, withRecordedFlushObserver, recordedCaptureRequiresCallbackTransactionError, assertRecordedCaptureTransactionIsolation, createRecordedTransactionScope, lockRecordedGraphWrite, generateId, createGraphBackendProjection, assertCurrentRecordedSchema, baseField, objectField, arrayField, dateField, numberField, computeFulltextContent, AUTO_REFRESH_STATISTICS_ROW_THRESHOLD, advanceRevisionClock, runInsertBatch, edgeInsertDispatch, runInsertBatchReturning, projectBackendMembers, sqlValueList, getEmbeddingFields, getNodeRowsByIds, getEdgeRowsByIds, compileKindFilter, currentReadInstant, compileTemporalFilter, validateEdgeEndpoints, buildPredicateIndex, compileFieldValue, recordedBindParamBudget, extractVectorSimilarityPredicates, extractFulltextMatchPredicates, currentReadInstantFor, extractTemporalOptions, compilePredicateExpression, getPredicatesForAlias, getFieldPointer, getNodeKindsForAlias, getHybridTargetAlias, closeRecordedHardDeletedKind, throwHistoryUnsafeSqlAccess, throwRevisionTrackingUnsafeSqlAccess, compilePredicateClauses } from './chunk-JHK6NPFV.js';
 import { chunk } from './chunk-35S6P5ZU.js';
-import { runOptionallyInTransaction, createTransactionReadBackend, rowPropsToObject, createBackendOverlay, INTERNAL_TEMPORARY_WRITES } from './chunk-PZHC5GCD.js';
-import { resolveReadCoordinate, withRecordedCoordinate, describeCoordinate, coordinateContext, asRecordedInstant, assertValidRecordedInstant } from './chunk-J6IJARLG.js';
-import { loadAndMergeGraphExtensionDocument, ensureSchema, loadAndVerifyGraph, buildKindRegistry, mergeGraphExtension, commitNewSchemaVersion, applyDeprecatedKinds, loadActiveSchemaWithBootstrap, parseSerializedSchema, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, serializeIndexDeclaration } from './chunk-SU7VQOJ3.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 { getTypeName } from './chunk-76HE7DJP.js';
 import { validateEdgeProps } from './chunk-ZE6NVENI.js';
 import { canonicalEqual, sortedReplacer } from './chunk-UR7W5YQK.js';
 import { withRecordedRelationsPrecondition, isMissingTableError } from './chunk-UUIBACKJ.js';
 import { isKnownKind } from './chunk-PH4IJ3V5.js';
-import { nowIso, validateOptionalCanonicalIsoDate } from './chunk-I6FX7AAG.js';
-import { generateIndexDDL } from './chunk-U4JDJKPD.js';
-import { SYSTEM_INDEX_DECLARATIONS, resolveSystemIndexTableName, systemIndexName, resolveSystemIndexNames, generateSystemIndexDDL } from './chunk-BQITNFQJ.js';
-import { NODE_META_KEYS, EDGE_META_KEYS } from './chunk-VDYA2HMS.js';
+import { nowIso, validateOptionalCanonicalIsoDate } from './chunk-3SHAUJRB.js';
+import { generateIndexDDL } from './chunk-2I3DNNBU.js';
+import { SYSTEM_INDEX_DECLARATIONS, resolveSystemIndexTableName, systemIndexName, resolveSystemIndexNames, generateSystemIndexDDL } from './chunk-AQVDAKXH.js';
+import { NODE_META_KEYS, EDGE_META_KEYS } from './chunk-VWEFXG73.js';
 import { sha256Hex, fnv1aBase36 } from './chunk-K34OPSJK.js';
 import { DEFAULT_PAGINATION_LIMIT, DEFAULT_STREAM_BATCH_SIZE, SQLITE_PATH_DELIMITER, PG_ARRAY_START, PG_ARRAY_END, PG_PATH_ELEMENT_SEPARATOR, MAX_PG_IDENTIFIER_LENGTH } from './chunk-2EBMPJBO.js';
-import { getDialect } from './chunk-G3CSQLLT.js';
-import { assertVectorMinScore, vectorScoreExpression, vectorMinScoreCondition } from './chunk-Y7M44XEK.js';
-import { isSqlPlaceholder, bindSqlValue, markAnnIndexScan, asCompiledSelectSql, isRawExecutable, annIndexScanTypes, sql, asCompiledRowsSql, markForceCustomPlan, asCompiledTemporaryStatementSql, asCompiledStatementSql } from './chunk-6XDBRDZE.js';
+import { getDialect, assertVectorMinScore, vectorScoreExpression, vectorMinScoreCondition } from './chunk-Y5UC3IXF.js';
+import { isSqlPlaceholder, bindSqlValue, markAnnIndexScan, asCompiledSelectSql, isRawExecutable, annIndexScanTypes, sql, asCompiledRowsSql, markForceCustomPlan, asCompiledTemporaryStatementSql, asCompiledStatementSql } from './chunk-6N7QBIWN.js';
 import { createSchemaIntrospector } from './chunk-D7PG5D5K.js';
 import { requireDefined, isPresent } from './chunk-QMQLUA66.js';
 import { getSearchableFields, resolveEmbeddingFields, resolveGraphVectorSlots, resolveDeclaredFulltextLanguage } from './chunk-PC2UBAUB.js';
@@ -610,7 +610,7 @@ var RecordedStoreView = class extends CoordinatePinnedView {
       }
     });
   }
-  /** The recorded/system-time timestamp this view reconstructs. */
+  /** The recorded/system-time anchor this view reconstructs. */
   get asOfRecorded() {
     const recorded = this.coordinate.recorded;
     if (recorded === void 0) {
@@ -17476,22 +17476,24 @@ var StoreImplementation = class _StoreImplementation {
    * Returns a narrow read-only view pinned to a recorded/system-time instant.
    *
    * Direct `store.asOfRecorded(T)` is diagonal bitemporal sugar: it reads the
-   * recorded-time relation as of `T` and uses the same `T` for the valid-time
-   * axis. Use `store.asOf(validT).asOfRecorded(recordedT)` when the valid and
-   * recorded axes should differ.
+   * recorded-time relation at the anchor's logical revision and uses the
+   * anchor's wall-time component for the valid-time axis. Use
+   * `store.asOf(validT).asOfRecorded(recordedT)` when the valid and recorded
+   * axes should differ.
    *
    * The returned view exposes only reconstructing-safe reads: query,
    * subgraph, graph algorithms, and collection point reads.
    *
-   * Prefer `await store.recordedNow()` as the anchor over a wall-clock
-   * timestamp: recorded instants are monotonic and can run briefly ahead of the
-   * wall clock under bursty writes, so a `new Date().toISOString()` passed here
-   * may sort before the most recent commits and silently omit them.
+   * Prefer `await store.recordedNow()` over a wall-clock timestamp. The anchor
+   * carries both the graph's strict logical revision and a non-decreasing
+   * physical wall-time high-water mark, so several commits in one millisecond
+   * remain independently addressable without manufacturing timestamp
+   * increments.
    */
   asOfRecorded(recordedAsOf) {
     const validCoordinate = resolveReadCoordinate(
       "asOf",
-      recordedAsOf,
+      recordedInstantWallTime(recordedAsOf),
       "Use await store.recordedNow() as the anchor, or asRecordedInstant(value) only for an instant previously read from recordedNow()."
     );
     return new RecordedStoreView(
@@ -17503,9 +17505,10 @@ var StoreImplementation = class _StoreImplementation {
    * Returns the latest recorded-time instant captured for this graph — the
    * recorded high-water mark. After guarding the `undefined` case,
    * `store.asOfRecorded(checkpoint)` reconstructs everything committed so far, a
-   * deterministic anchor that avoids guessing with the wall clock (recorded
-   * instants are monotonic and can run briefly ahead of wall-clock time under
-   * bursty writes). Capture each anchor right after the writes it should cover.
+   * deterministic anchor that avoids guessing with the wall clock. Its logical
+   * revision is strictly monotonic per graph while its timestamp is a
+   * non-decreasing physical wall-time high-water mark. Capture each anchor right
+   * after the writes it should cover.
    *
    * Returns `undefined` until the first write has been captured, so on a
    * brand-new graph guard the composition — `asOfRecorded(undefined)` rejects
@@ -19096,6 +19099,11 @@ async function createStoreWithSchema(graph, backend, options) {
     prepared.result
   ];
 }
+async function assertHistorySchemaOnOpen(backend, options) {
+  if (options?.history !== true) return;
+  const schema = options.schema === void 0 ? createSqlSchema(backend.tableNames) : requireSqlSchema(options.schema, "store schema");
+  await assertCurrentRecordedSchema(backend, schema);
+}
 async function prepareStoreWithSchema(graph, backend, options) {
   const {
     graph: merged,
@@ -19106,6 +19114,7 @@ async function prepareStoreWithSchema(graph, backend, options) {
     ...options,
     preloaded: { activeRow, storedSchema }
   });
+  await assertHistorySchemaOnOpen(backend, options);
   await materializeRuntimeContributions(backend, merged.id);
   await materializeVectorContributions(backend, merged);
   if (options?.systemIndexes !== "skip") {
@@ -19156,7 +19165,7 @@ async function materializeSystemIndexesOnBoot(backend, graphId, result) {
   }
 }
 async function createVerifiedStore(graph, backend, options) {
-  const prepared = await prepareVerifiedStore(graph, backend);
+  const prepared = await prepareVerifiedStore(graph, backend, options);
   return [
     new StoreImplementation(
       prepared.graph,
@@ -19167,12 +19176,13 @@ async function createVerifiedStore(graph, backend, options) {
     prepared.result
   ];
 }
-async function prepareVerifiedStore(graph, backend) {
+async function prepareVerifiedStore(graph, backend, options) {
   const {
     graph: merged,
     activeRow,
     result
   } = await loadAndVerifyGraph(backend, graph);
+  await assertHistorySchemaOnOpen(backend, options);
   return {
     graph: merged,
     result,
@@ -19180,7 +19190,7 @@ async function prepareVerifiedStore(graph, backend) {
   };
 }
 async function createVerifiedAdapterStore(graph, backend, options) {
-  const prepared = await prepareVerifiedStore(graph, backend);
+  const prepared = await prepareVerifiedStore(graph, backend, options);
   return [
     asAdapterStoreSurface(
       new AdapterStoreImplementation(
@@ -19195,5 +19205,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-CBK2IVI2.js.map
-//# sourceMappingURL=chunk-CBK2IVI2.js.map
+//# sourceMappingURL=chunk-3BL3JFHL.js.map
+//# sourceMappingURL=chunk-3BL3JFHL.js.map