@nicia-ai/typegraph 0.55.0 → 0.56.0

package/dist/{chunk-VU65FXEG.js → chunk-LFXBFPI2.js}

@@ -1,17 +1,17 @@
-import { createEdgeRowMapper, createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, POSTGRES_ROW_MAPPER_CONFIG, normalizeRowTimestamp, normalizeRequiredRowTimestamp, buildHardDeleteEdgeClaimsByNodeKind, buildHardDeleteUniquesByConcreteKind, buildHardDeleteEdgeClaimsByEdgeKind } from './chunk-HW3IX2RF.js';
-import { rowToNode, executeNodeBulkFindByIndex, executeNodeBulkFindByConstraint, executeNodeFindByConstraint, executeNodeBulkGetOrCreateByConstraint, executeNodeGetOrCreateByConstraint, executeNodeHardDelete, executeNodeDeleteBatch, executeNodeDelete, nodeUpsertDirtyCheck, executeNodeReplacementBatch, prepareNodeReplacement, executeNodeResolvedMutationSet, executeNodeUpsertUpdateBatch, executeNodeSetUpdate, executeNodeUpdate, executeNodeCreateNoReturnBatch, executeNodeCreateBatch, executeNodeCreate, rowToEdge, normalizePersistedEdgeMatchProps, assertValidityEndMutation, assertClearValidToSupported, buildEdgeMatchKey, resolveAtomicEdgeConvergenceExecutor, resolveEdgeMatchIdentityStorage, runHookedWritePlan, edgeWritePlan, resolveAtomicEdgeDeleteBatchExecutor, runWritePlan, runAtomicProgramWithHooks, unsupportedResolvedMutationSet, resolveAtomicEdgeResolvedMutationSetExecutor, withAlreadyExistsTranslation, ResolvedMutationSetMoved, appliedResolvedMutationSet, edgeWriteNeedsConstraintFence, writeResultAlwaysChanges, resolveAtomicEdgeBatchExecutor, nestedManagedWriteTarget, runResolvedMutationSetConverging, canonicalPersistedJsonValue, assertAtomicDeleteSchemaFenceMatched, edgeMatchIdentityUpdateRefusal, resolveAtomicEdgeResolvedUpdateBatchExecutor, atomicResolvedUpdateAttemptBudget, createEdgeBatchValidationBackend, canFuseSchemaFenceInFirstWrite, isAutocommitSingleStatementWrite, runAutocommitSingleStatementWritePlan, classifyDurableEdgeBatchOutcomes, rowToNodeMeta, rowToEdgeMeta, checkCardinalityConstraint, validityEndAfterMutation, assertsStoredWindowState, unfencedTarget, AutocommitWriteRequiresTransaction } from './chunk-FCUSVSYX.js';
-import { storeRuntime, STORE_RUNTIME, applyResolvedNodeClaims, TRANSACTION_RUNTIME, AUTO_REFRESH_STATISTICS_ROW_THRESHOLD, getEmbeddingFields, computeFulltextContent } from './chunk-74FNI3PT.js';
-import { isBundledRootAutocommitEligible } from './chunk-45WPPI64.js';
-import { edgeCardinalityClaimTarget, edgeCardinalityClaimRefusal, edgeCardinalityClaim, edgeCardinalityClaimMode, claimEdgeCardinality } from './chunk-7EOJO6QB.js';
-import { AtomicEdgeBatchEndpointRefusalError, AtomicEdgeConvergenceTombstoneRefusalError, AtomicEdgeDeleteIdentityRefusalError, AtomicEdgeBatchCardinalityRefusalError } from './chunk-SLNH62T3.js';
-import { loadAndMergeGraphExtensionDocument, serializeSchema, buildKindRegistry, ensureIdentitySchemaStorage, loadAndVerifyGraph, identitySchemaCommitPreflight, getSchemaChanges, requiresMigration, mergeGraphExtension, commitNewSchemaVersion, commitNewSchemaVersionWithPreflight, parseSerializedSchema, planRemovals, stripGraphExtension, applyDeprecatedKinds, identityKindCascadeNeeded, ensureSchema, loadActiveSchemaWithBootstrap, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, commitNewSchemaVersionIfKindsEmpty, serializeIndexDeclaration } from './chunk-FFR3YUY2.js';
+import { createEdgeRowMapper, createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, POSTGRES_ROW_MAPPER_CONFIG, normalizeRowTimestamp, normalizeRequiredRowTimestamp, buildHardDeleteEdgeClaimsByNodeKind, buildHardDeleteUniquesByConcreteKind, buildHardDeleteEdgeClaimsByEdgeKind } from './chunk-EWRLWI7W.js';
+import { rowToNode, executeNodeBulkFindByIndex, executeNodeBulkFindByConstraint, executeNodeFindByConstraint, executeNodeBulkGetOrCreateByConstraint, executeNodeGetOrCreateByConstraint, executeNodeHardDelete, executeNodeDeleteBatch, executeNodeDelete, nodeUpsertDirtyCheck, executeNodeReplacementBatch, prepareNodeReplacement, executeNodeResolvedMutationSet, executeNodeUpsertUpdateBatch, executeNodeSetUpdate, executeNodeUpdate, executeNodeCreateNoReturnBatch, executeNodeCreateBatch, executeNodeCreate, rowToEdge, normalizePersistedEdgeMatchProps, assertValidityEndMutation, assertClearValidToSupported, buildEdgeMatchKey, resolveAtomicEdgeConvergenceExecutor, resolveEdgeMatchIdentityStorage, runHookedWritePlan, edgeWritePlan, resolveAtomicEdgeDeleteBatchExecutor, runWritePlan, runAtomicProgramWithHooks, unsupportedResolvedMutationSet, resolveAtomicEdgeResolvedMutationSetExecutor, withAlreadyExistsTranslation, ResolvedMutationSetMoved, appliedResolvedMutationSet, edgeWriteNeedsConstraintFence, writeResultAlwaysChanges, resolveAtomicEdgeBatchExecutor, nestedManagedWriteTarget, runResolvedMutationSetConverging, canonicalPersistedJsonValue, assertAtomicDeleteSchemaFenceMatched, edgeMatchIdentityUpdateRefusal, resolveAtomicEdgeResolvedUpdateBatchExecutor, atomicResolvedUpdateAttemptBudget, createEdgeBatchValidationBackend, canFuseSchemaFenceInFirstWrite, isAutocommitSingleStatementWrite, runAutocommitSingleStatementWritePlan, classifyDurableEdgeBatchOutcomes, rowToNodeMeta, rowToEdgeMeta, checkCardinalityConstraint, validityEndAfterMutation, assertsStoredWindowState, unfencedTarget, AutocommitWriteRequiresTransaction } from './chunk-MRGWM5LE.js';
+import { storeRuntime, STORE_RUNTIME, applyResolvedNodeClaims, TRANSACTION_RUNTIME, AUTO_REFRESH_STATISTICS_ROW_THRESHOLD, getEmbeddingFields, computeFulltextContent } from './chunk-C3TJU4KQ.js';
+import { isBundledRootAutocommitEligible } from './chunk-FMCPKMQI.js';
+import { edgeCardinalityClaimTarget, edgeCardinalityClaimRefusal, edgeCardinalityClaim, edgeCardinalityClaimMode, claimEdgeCardinality } from './chunk-7MHENVRG.js';
+import { AtomicEdgeBatchEndpointRefusalError, AtomicEdgeConvergenceTombstoneRefusalError, AtomicEdgeDeleteIdentityRefusalError, AtomicEdgeBatchCardinalityRefusalError } from './chunk-KQYUKOGX.js';
+import { loadAndMergeGraphExtensionDocument, serializeSchema, buildKindRegistry, ensureIdentitySchemaStorage, loadAndVerifyGraph, identitySchemaCommitPreflight, getSchemaChanges, requiresMigration, mergeGraphExtension, commitNewSchemaVersion, commitNewSchemaVersionWithPreflight, parseSerializedSchema, planRemovals, stripGraphExtension, applyDeprecatedKinds, identityKindCascadeNeeded, ensureSchema, loadActiveSchemaWithBootstrap, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, commitNewSchemaVersionIfKindsEmpty, serializeIndexDeclaration } from './chunk-E4QYEWVH.js';
 import { countSchemaKindRows } from './chunk-RFMSZ7CF.js';
 import { getTypeName } from './chunk-P5J256Q7.js';
-import { loadCurrentStructuralClasses, loadAssertionsByIds, toTransferAssertion, liveNodeKindsSharingIds, createIdentityFacade, createIdentityReadFacade, validateIdentityForContext, removeIdentityKindsForContext, readIdentityAssertionsForInterchange, readIdentityAssertionPageAtTarget, lockIdentityGraph, foldIdentityForCreatedNodes, importIdentityAssertionsIntoTarget, assertAffectedIdentityClassesConsistent, applyIdentityChangesForContext, refKey, requireNodeValidityEndCompatible, detachIdentityForNode, rebuildIdentityClosureForContext, assertEdgeMatchIdentityBackendSupport } from './chunk-MJXEO7YA.js';
-import { isParameterRef, resolveParameterValueType, fieldRef, buildFieldBuilderForTypeInfo, stringField, createFulltextAccessor, CURRENT_READ_INSTANT_PLACEHOLDER, withPinnedReadInstant, assertRevisionTrackableBackend, createRecordedBackend, lockRecordedGraphWrite, createRecordedTransactionScope, readRecordedClock, ensureRevisionOrigin, withRecordedFlushObserver, withTransactionSchemaFenceLease, withWriteTransactionSession, recordedCaptureRequiresCallbackTransactionError, assertRecordedCaptureTransactionIsolation, lockSchemaVersionForStoreWrite, generateId, runInWriteTransaction, assertCurrentRecordedSchema, assertRecursiveTraversalSupported, baseField, objectField, arrayField, dateField, numberField, advanceRevisionClock, validateEdgeProps, diagnoseFusedSchemaFenceNoRow, getEdgeRowsByIds, memoizeLeasedSchemaFence, sqlValueList, getNodeRowsByIds, compileKindFilter, compileTemporalFilter, currentReadInstant, hasLeasedSchemaFence, closeRecordedHardDeletedKind, buildPredicateIndex, requireRecursiveTraversalVerdict, historicalIdentityPeerClassQuery, IDENTITY_PEER_CLASS_COLUMNS, compileFieldValue, recordedBindParamBudget, extractVectorSimilarityPredicates, extractFulltextMatchPredicates, currentReadInstantFor, extractTemporalOptions, compilePredicateExpression, getPredicatesForAlias, getFieldPointer, getNodeKindsForAlias, getHybridTargetAlias, throwHistoryUnsafeSqlAccess, throwRevisionTrackingUnsafeSqlAccess, compilePredicateClauses } from './chunk-SIQ4BFL5.js';
+import { loadCurrentStructuralClasses, loadAssertionsByIds, toTransferAssertion, liveNodeKindsSharingIds, createIdentityFacade, createIdentityReadFacade, validateIdentityForContext, removeIdentityKindsForContext, readIdentityAssertionsForInterchange, readIdentityAssertionPageAtTarget, lockIdentityGraph, foldIdentityForCreatedNodes, importIdentityAssertionsIntoTarget, assertAffectedIdentityClassesConsistent, applyIdentityChangesForContext, refKey, requireNodeValidityEndCompatible, detachIdentityForNode, rebuildIdentityClosureForContext, assertEdgeMatchIdentityBackendSupport } from './chunk-762VPGHN.js';
+import { isParameterRef, resolveParameterValueType, fieldRef, buildFieldBuilderForTypeInfo, stringField, createFulltextAccessor, CURRENT_READ_INSTANT_PLACEHOLDER, withPinnedReadInstant, assertRevisionTrackableBackend, createRecordedBackend, lockRecordedGraphWrite, createRecordedTransactionScope, readRecordedClock, ensureRevisionOrigin, withRecordedFlushObserver, withTransactionSchemaFenceLease, withWriteTransactionSession, recordedCaptureRequiresCallbackTransactionError, assertRecordedCaptureTransactionIsolation, lockSchemaVersionForStoreWrite, generateId, runInWriteTransaction, assertCurrentRecordedSchema, assertRecursiveTraversalSupported, baseField, objectField, arrayField, dateField, numberField, advanceRevisionClock, validateEdgeProps, diagnoseFusedSchemaFenceNoRow, getEdgeRowsByIds, memoizeLeasedSchemaFence, sqlValueList, getNodeRowsByIds, compileKindFilter, compileTemporalFilter, currentReadInstant, hasLeasedSchemaFence, closeRecordedHardDeletedKind, buildPredicateIndex, requireRecursiveTraversalVerdict, historicalIdentityPeerClassQuery, IDENTITY_PEER_CLASS_COLUMNS, compileFieldValue, recordedBindParamBudget, extractVectorSimilarityPredicates, extractFulltextMatchPredicates, currentReadInstantFor, extractTemporalOptions, compilePredicateExpression, getPredicatesForAlias, getFieldPointer, getNodeKindsForAlias, getHybridTargetAlias, throwHistoryUnsafeSqlAccess, throwRevisionTrackingUnsafeSqlAccess, compilePredicateClauses } from './chunk-AZP5CCHL.js';
 import { withRecordedRelationsPrecondition, canonicalEqual, sortedReplacer, chunk, postgresReadWriteRefusedSqlState, isMissingTableError, groupBy, postgresTemporaryTableUnavailableSqlState, isPostgresConcurrentDdlRaceError } from './chunk-U4SGJQKQ.js';
-import { assumeRecursiveTraversalSupported, batchPointReadVerdict, resolveRecursiveTraversal, statementExecutionVerdict, createClaimsVerdictThunk, uniqueSidecarBatchVerdict, contributionHealthVerdict, recordedRevisionOriginsVerdict, requireExtras, assertRecursiveTraversal } from './chunk-IDQZI6GL.js';
-import { createSqlSchema, requireSqlSchema, DEFAULT_SQL_SCHEMA, recordedReadSchemaFor, resolveWriteFencePlan, refuseUnfencedOperationalIdentity, refuseUnfencedClockAllocation, requireExternalRecordedReadSource, createRecordedReadBinding, runOptionallyInTransaction, createTransactionReadBackend, bindExtraIfReachable, BATCH_POINT_READ, CONTRIBUTION_HEALTH, bindExtra, projectGraphBackend, deriveBackend, vectorSlotKey, recordedReadSqlSchema, requireRecordedReadBinding, projectBackend, rowPropsToObject, INTERNAL_TEMPORARY_WRITES, assertGraphCommandConvergenceIsolation, isSchemaFencedInsertEligible, executeAuthoritativeGraphCommand, ALIAS_CTE_PREFIX, EMBEDDINGS_CTE_ALIAS, FULLTEXT_CTE_ALIAS, HYBRID_CANDIDATES_CTE_ALIAS } from './chunk-YVKPUSHS.js';
+import { assumeRecursiveTraversalSupported, batchPointReadVerdict, resolveRecursiveTraversal, statementExecutionVerdict, createClaimsVerdictThunk, uniqueSidecarBatchVerdict, contributionHealthVerdict, recordedRevisionOriginsVerdict, requireExtras, assertRecursiveTraversal } from './chunk-XH75W3O5.js';
+import { createSqlSchema, requireSqlSchema, DEFAULT_SQL_SCHEMA, recordedReadSchemaFor, resolveWriteFencePlan, refuseUnfencedOperationalIdentity, refuseUnfencedClockAllocation, requireExternalRecordedReadSource, createRecordedReadBinding, runOptionallyInTransaction, createTransactionReadBackend, bindExtraIfReachable, BATCH_POINT_READ, CONTRIBUTION_HEALTH, bindExtra, projectGraphBackend, deriveBackend, vectorSlotKey, recordedReadSqlSchema, requireRecordedReadBinding, projectBackend, rowPropsToObject, INTERNAL_TEMPORARY_WRITES, assertGraphCommandConvergenceIsolation, isSchemaFencedInsertEligible, executeAuthoritativeGraphCommand, ALIAS_CTE_PREFIX, EMBEDDINGS_CTE_ALIAS, FULLTEXT_CTE_ALIAS, HYBRID_CANDIDATES_CTE_ALIAS } from './chunk-75KH6Y2W.js';
 import { isKnownKind } from './chunk-4PNRH5BO.js';
 import { isEdgeTargetMap, projectTargetKinds, validateEdgeEndpoints, compareClaimTargets, encodeTupleKey, uniquenessClaimTarget, subClassComponent, isSameClaimOwner, DISJOINT_CONSTRAINT_NAME, disjointnessClaimAxis } from './chunk-HFZWYHYC.js';
 import { resolveReadCoordinate, withRecordedCoordinate, describeCoordinate, coordinateContext, recordedInstantWallTime, asRecordedInstant, assertValidRecordedInstant, optionalRecordedInstantParts } from './chunk-EMORF4PV.js';
@@ -35,6 +35,12 @@ import { parseJsonPointer, jsonPointer, resolveJsonPointer, encodeJsonPointerSeg
 import { readOwnProperty, requireDefined, createDataKeyedBag, isInteropProbeKey, hasOwnKey, isPresent } from './chunk-QD2JFTSL.js';
 
 // src/store/collection-surface.ts
+var NODE_TEMPORAL_READ_NAMES = [
+  "getById",
+  "getByIds",
+  "find",
+  "count"
+];
 var CURRENT_ONLY_READ_NAMES = [
   "findByConstraint",
   "bulkFindByConstraint",
@@ -58,6 +64,17 @@ var NODE_WRITE_NAMES = [
   "getOrCreateByConstraint",
   "bulkGetOrCreateByConstraint"
 ];
+var EDGE_TEMPORAL_READ_NAMES = [
+  "getById",
+  "getByIds",
+  "find",
+  "count",
+  "findFrom",
+  "findTo",
+  "bulkFindFrom",
+  "bulkFindTo",
+  "findByEndpoints"
+];
 var EDGE_BATCH_READ_NAMES = [
   "batchFindFrom",
   "batchFindTo",
@@ -75,6 +92,14 @@ var EDGE_WRITE_NAMES = [
   "getOrCreateByEndpoints",
   "bulkGetOrCreateByEndpoints"
 ];
+var IDENTITY_READ_NAMES = [
+  "representativeOf",
+  "membersOf",
+  "nodesOf",
+  "areSame",
+  "areDifferent",
+  "assertionsOf"
+];
 
 // src/store/recorded-coordinate-guard.ts
 function hasOwnRecordedAsOf(options) {
@@ -558,6 +583,10 @@ var StoreViewImplementation = class extends CoordinatePinnedView {
       )
     );
   }
+  getEdgeCollection(kind) {
+    if (this.store.getEdgeCollection(kind) === void 0) return void 0;
+    return this.edges[kind];
+  }
   /** Adds a recorded-time pin, returning the narrow reconstructing view. */
   asOfRecorded(recordedAsOf) {
     return new RecordedStoreView(
@@ -21388,27 +21417,33 @@ var StoreImplementation = class _StoreImplementation {
     }
     return collection;
   }
-  /**
-   * Returns the edge collection for the given kind, or undefined if the kind
-   * is not registered in this graph.
-   *
-   * Use this for runtime string-keyed access when the kind is not known at
-   * compile time. For post-evolve access, prefer `getEdgeCollectionOrThrow`.
-   */
   getEdgeCollection(kind) {
-    if (!Object.hasOwn(this.#graph.edges, kind)) return void 0;
-    return this.edges[kind];
+    return this.#resolveDynamicEdgeCollection(this.edges, kind);
   }
   getEdgeCollectionOrThrow(kindOrToken) {
+    return this.#requireDynamicEdgeCollection(this.edges, kindOrToken);
+  }
+  #requireDynamicEdgeCollection(collections, kindOrToken) {
     const kind = this.#resolveRuntimeKind(kindOrToken, "edge");
-    const collection = this.getEdgeCollection(kind);
+    const collection = this.#resolveDynamicEdgeCollection(collections, kind);
     if (collection === void 0) {
-      throw new KindNotFoundError(kind, "edge", {
-        graphId: this.graphId
-      });
+      throw new KindNotFoundError(kind, "edge", { graphId: this.graphId });
     }
     return collection;
   }
+  #resolveDynamicEdgeCollection(collections, kind) {
+    if (!Object.hasOwn(this.#graph.edges, kind)) return void 0;
+    return collections[kind];
+  }
+  /** Resolve through the supplied context's wrappers, preserving transaction and receipt ownership. */
+  #edgeCollectionAccess(collections) {
+    const getEdgeCollection = (kind) => this.#resolveDynamicEdgeCollection(collections, kind);
+    const getEdgeCollectionOrThrow = (kindOrToken) => this.#requireDynamicEdgeCollection(collections, kindOrToken);
+    return {
+      getEdgeCollection,
+      getEdgeCollectionOrThrow
+    };
+  }
   // === Dynamic Props Schema Access ===
   /**
    * Returns the Zod props schema for the given node kind, or `undefined`
@@ -22501,7 +22536,7 @@ var StoreImplementation = class _StoreImplementation {
    * `context` never reaches the scope recorder. This makes overlapping/concurrent
    * measures safe by construction (each holds its own scope recorder) and lets
    * scopes nest: the scoped context is itself decorated, so `scoped.measure(...)`
-   * chains one more wrapper. The scoped context's `getNodeCollection` resolves
+   * chains one more wrapper. The scoped context's dynamic collection lookups resolve
    * against the scope-wrapped map too, so dynamic-kind writes are attributed like
    * `scoped.nodes.<Kind>`. The scope receipt's `recorded` is always undefined —
    * the recorded instant is a whole-transaction flush concern.
@@ -22523,6 +22558,7 @@ var StoreImplementation = class _StoreImplementation {
           nodes,
           edges,
           ...identity === void 0 ? {} : { identity },
+          ...this.#edgeCollectionAccess(edges),
           getNodeCollection: (kind) => this.#resolveDynamicNodeCollection(nodes, kind)
         })
       );
@@ -22587,7 +22623,8 @@ var StoreImplementation = class _StoreImplementation {
       ...receiptIdentity === void 0 ? {} : { identity: receiptIdentity },
       backend: createTransactionReadBackend(txBackend),
       [TRANSACTION_RUNTIME]: { backend: txBackend, runNodeOperationHooks },
-      getNodeCollection
+      getNodeCollection,
+      ...this.#edgeCollectionAccess(edges)
     };
     let withSql;
     if (this.#captureEnabled) {
@@ -24504,6 +24541,6 @@ async function createVerifiedAdapterStore(graph, backend, options) {
   return [asAdapterStoreSurface(store), prepared.result];
 }
 
-export { ExecutableAggregateQuery, ExecutableQuery, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, PreparedQuery, QueryBuilder, RecordedStoreView, StoreAnalysisCursorStaleError, 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-VU65FXEG.js.map
-//# sourceMappingURL=chunk-VU65FXEG.js.map
+export { CURRENT_ONLY_READ_NAMES, EDGE_TEMPORAL_READ_NAMES, ExecutableAggregateQuery, ExecutableQuery, IDENTITY_READ_NAMES, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, NODE_TEMPORAL_READ_NAMES, PreparedQuery, QueryBuilder, RecordedStoreView, StoreAnalysisCursorStaleError, 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-LFXBFPI2.js.map
+//# sourceMappingURL=chunk-LFXBFPI2.js.map