@typicalday/firegraph 0.11.2 → 0.13.0

package/dist/index.d.cts

@@ -1,23 +1,15 @@
-import { S as StorageBackend } from './backend-np4gEVhB.cjs';
-import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, I as IndexSpec, b as DiscoveryResult, R as RegistryEntry, c as GraphRegistry, d as GraphReader, M as MigrationExecutor, e as DynamicRegistryConfig, S as StoredGraphRecord, f as MigrationWriteBack, g as MigrationStep, F as FindEdgesParams, Q as QueryPlan, h as FindNodesParams, i as QueryFilter, j as GraphRecord, k as MigrationFn, l as StoredMigrationStep, T as TraversalBuilder } from './types-BGWxcpI_.cjs';
-export { B as BulkBatchError, m as BulkOptions, n as BulkProgress, o as BulkResult, C as CascadeResult, p as DefineTypeOptions, q as DiscoveredEntity, E as EdgeTopology, r as EdgeTypeData, s as FiregraphConfig, t as GraphBatch, u as GraphTransaction, v as GraphWriter, H as HopDefinition, w as HopResult, x as IndexFieldSpec, N as NodeTypeData, y as QueryMode, z as QueryOptions, A as ScanProtection, J as TraversalOptions, K as TraversalResult, V as ViewContext, L as ViewDefaultsConfig, O as ViewResolverConfig, W as WhereClause, P as defineConfig, U as resolveView } from './types-BGWxcpI_.cjs';
+export { c as createGraphClient, a as createGraphClientFromBackend } from './client-BrsaXtDV.cjs';
 export { CodegenOptions, generateTypes } from './codegen/index.cjs';
-import { F as FiregraphError } from './scope-path-B1G3YiA7.cjs';
-export { C as CrossBackendTransactionError, D as DynamicRegistryError, E as EdgeNotFoundError, I as InvalidQueryError, M as MigrationError, N as NodeNotFoundError, Q as QuerySafetyError, R as RegistryScopeError, b as RegistryViolationError, S as StorageScopeSegment, T as TraversalError, V as ValidationError, a as appendStorageScope, i as isAncestorScopeUid, p as parseStorageScope, r as resolveAncestorScope } from './scope-path-B1G3YiA7.cjs';
-import { Firestore } from '@google-cloud/firestore';
+import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, m as StoredGraphRecord, M as MigrationWriteBack, n as MigrationStep, G as GraphRegistry, F as FindEdgesParams, Q as QueryPlan, o as FindNodesParams, p as QueryFilter, q as MigrationExecutor, r as MigrationFn, s as StoredMigrationStep, t as GraphClient, u as GraphReader, v as TraversalBuilder } from './backend-DuvHGgK1.cjs';
+export { A as AggregateExtension, w as AggregateField, x as AggregateOp, y as AggregateResult, z as AggregateSpec, C as BulkBatchError, H as BulkOptions, K as BulkProgress, L as BulkResult, b as BulkUpdatePatch, N as Capability, O as CascadeResult, P as CoreGraphClient, V as DefineTypeOptions, X as DiscoveredEntity, Y as DistanceMeasure, d as DmlExtension, Z as DynamicGraphClient, _ as DynamicGraphMethods, $ as DynamicRegistryConfig, a0 as EdgeTopology, a1 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a2 as FindEdgesProjectedParams, a3 as FindNearestParams, a4 as FiregraphConfig, a5 as FullTextSearchExtension, a6 as GeoExtension, a7 as GraphBatch, a8 as GraphClientOptions, a9 as GraphRecord, aa as GraphTransaction, ab as GraphWriter, ac as HopDefinition, ad as HopResult, ae as IndexFieldSpec, J as JoinExtension, af as NodeTypeData, ag as ProjectedRow, ah as QueryMode, ai as QueryOptions, aj as RawFirestoreExtension, ak as RawSqlExtension, al as RealtimeListenExtension, am as ScanProtection, an as SelectExtension, ao as TraversalOptions, ap as TraversalResult, aq as VectorExtension, ar as ViewContext, as as ViewDefaultsConfig, at as ViewResolverConfig, au as WhereClause, av as defineConfig, h as deleteField, aw as resolveView } from './backend-DuvHGgK1.cjs';
+import { F as FiregraphError } from './errors-BRc3I_eH.cjs';
+export { C as CapabilityNotSupportedError, a as CrossBackendTransactionError, D as DynamicRegistryError, E as EdgeNotFoundError, I as InvalidQueryError, M as MigrationError, N as NodeNotFoundError, Q as QuerySafetyError, R as RegistryScopeError, b as RegistryViolationError, T as TraversalError, V as ValidationError } from './errors-BRc3I_eH.cjs';
+export { B as BOOTSTRAP_ENTRIES, E as EDGE_TYPE_SCHEMA, M as META_EDGE_TYPE, a as META_NODE_TYPE, N as NODE_TYPE_SCHEMA, c as createBootstrapRegistry, b as createMergedRegistry, d as createRegistry, e as createRegistryFromGraph, g as generateDeterministicUid, f as generateId } from './registry-Bc7h6WTM.cjs';
 export { Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions } from './client-Bk2Cm6xv.cjs';
+export { S as StorageScopeSegment, a as appendStorageScope, i as isAncestorScopeUid, p as parseStorageScope, r as resolveAncestorScope } from './scope-path-CROFZGr9.cjs';
+import { Firestore } from '@google-cloud/firestore';
 export { E as EntityViewConfig, a as EntityViewMeta, V as ViewComponentClass, b as ViewMeta, c as ViewRegistry, d as ViewRegistryInput, e as defineViews } from './views-DL60k0cf.cjs';
 
-/**
- * Create a `GraphClient` backed by an arbitrary `StorageBackend`.
- *
- * Used by backend-specific factories (e.g. `createDOClient` in
- * `firegraph/cloudflare`) — most callers should use the higher-level
- * `createGraphClient(firestore, ...)` overload below for Firestore, or the
- * Cloudflare factory for DO-backed graphs.
- */
-declare function createGraphClientFromBackend(backend: StorageBackend, options?: GraphClientOptions, metaBackend?: StorageBackend): GraphClient | DynamicGraphClient;
-
 /**
  * Cross-graph edge resolution utilities.
  *
@@ -165,53 +157,6 @@ declare function discoverEntities(entitiesDir: string): DiscoverResult;
 declare function computeNodeDocId(uid: string): string;
 declare function computeEdgeDocId(aUid: string, axbType: string, bUid: string): string;
 
-/** The aType used for node type definition meta-nodes. */
-declare const META_NODE_TYPE = "nodeType";
-/** The aType used for edge type definition meta-nodes. */
-declare const META_EDGE_TYPE = "edgeType";
-/** JSON Schema for the `data` payload of a `nodeType` meta-node. */
-declare const NODE_TYPE_SCHEMA: object;
-/** JSON Schema for the `data` payload of an `edgeType` meta-node. */
-declare const EDGE_TYPE_SCHEMA: object;
-/** Registry entries for the two meta-types (always present). */
-declare const BOOTSTRAP_ENTRIES: readonly RegistryEntry[];
-declare function createBootstrapRegistry(): GraphRegistry;
-/**
- * Generate a deterministic UID for a meta-type definition.
- * This ensures that defining the same type name always targets the same
- * Firestore document, enabling upsert semantics.
- *
- * Format: 21-char base64url substring of SHA-256(`metaType:name`).
- */
-declare function generateDeterministicUid(metaType: string, name: string): string;
-/**
- * Read meta-type nodes from the graph and compile them into a GraphRegistry.
- *
- * The returned registry includes both the dynamic entries AND the bootstrap
- * meta-type entries, so meta-type writes remain validateable after a reload.
- *
- * @param reader - A GraphReader pointed at the collection containing meta-nodes.
- * @param executor - Optional custom executor for compiling stored migration source strings.
- */
-declare function createRegistryFromGraph(reader: GraphReader, executor?: MigrationExecutor): Promise<GraphRegistry>;
-
-/**
- * Firestore-specific client factory.
- *
- * Kept in its own module so that bundlers don't pull
- * `@google-cloud/firestore` into non-Firestore entry points — most
- * importantly the Cloudflare DO backend (`firegraph/cloudflare`) and the
- * routing primitive (`firegraph/backend`), both of which must load cleanly
- * in a Workers environment where the Node Firestore SDK is unavailable.
- */
-
-declare function createGraphClient(db: Firestore, collectionPath: string, options: GraphClientOptions & {
-    registryMode: DynamicRegistryConfig;
-}): DynamicGraphClient;
-declare function createGraphClient(db: Firestore, collectionPath: string, options?: GraphClientOptions): GraphClient;
-
-declare function generateId(): string;
-
 /**
  * Firestore composite index generator.
  *
@@ -425,38 +370,6 @@ interface QuerySafetyResult {
  */
 declare function analyzeQuerySafety(filters: QueryFilter[]): QuerySafetyResult;
 
-declare function buildNodeRecord(aType: string, uid: string, data: Record<string, unknown>): GraphRecord;
-declare function buildEdgeRecord(aType: string, aUid: string, axbType: string, bType: string, bUid: string, data: Record<string, unknown>): GraphRecord;
-
-/**
- * Build a registry from either explicit entries or a DiscoveryResult.
- *
- * @example
- * ```ts
- * // From explicit entries (programmatic)
- * const registry = createRegistry([
- *   { aType: 'user', axbType: 'is', bType: 'user', jsonSchema: userSchema },
- *   { aType: 'user', axbType: 'follows', bType: 'user', jsonSchema: followsSchema },
- * ]);
- *
- * // From discovery result (folder convention)
- * const discovered = await discoverEntities('./entities');
- * const registry = createRegistry(discovered);
- * ```
- */
-declare function createRegistry(input: RegistryEntry[] | DiscoveryResult): GraphRegistry;
-/**
- * Create a merged registry where `base` entries take priority and `extension`
- * entries fill in gaps. Lookups and validation check `base` first; only if the
- * triple is not found there does the merged registry fall through to
- * `extension`.
- *
- * The `entries()` method returns a deduplicated list (base wins on collision).
- * The `lookupByAxbType()` method merges results from both registries,
- * deduplicating by triple key with base entries winning.
- */
-declare function createMergedRegistry(base: GraphRegistry, extension: GraphRegistry): GraphRegistry;
-
 /**
  * Sandbox module for compiling dynamic registry migration source strings
  * into executable functions.
@@ -561,6 +474,21 @@ declare function matchScope(scopePath: string, pattern: string): boolean;
  */
 declare function matchScopeAny(scopePath: string, patterns: string[]): boolean;
 
+/**
+ * Firegraph serialization tag — split from `src/serialization.ts` so it can
+ * be imported from Workers-facing code without dragging in
+ * `@google-cloud/firestore`.
+ *
+ * The full serialization module (with Timestamp/GeoPoint round-tripping)
+ * lives one folder up because the sandbox migration pipeline needs it; the
+ * write-plan helper only needs to recognise tagged objects to keep them
+ * terminal during patch flattening, so it imports just the tag from here.
+ */
+/** Sentinel key used to tag serialized Firestore types. */
+declare const SERIALIZATION_TAG: "__firegraph_ser__";
+/** Check if a value is a tagged serialized Firestore type. */
+declare function isTaggedValue(value: unknown): boolean;
+
 /**
  * Firestore-aware serialization for the sandbox migration pipeline.
  *
@@ -574,10 +502,6 @@ declare function matchScopeAny(scopePath: string, patterns: string[]): boolean;
  * (in-memory functions) receive raw Firestore objects directly.
  */
 
-/** Sentinel key used to tag serialized Firestore types. */
-declare const SERIALIZATION_TAG: "__firegraph_ser__";
-/** Check if a value is a tagged serialized Firestore type. */
-declare function isTaggedValue(value: unknown): boolean;
 /**
  * Recursively walk a data object and replace Firestore types with tagged
  * plain objects suitable for JSON serialization.
@@ -610,4 +534,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-export { BOOTSTRAP_ENTRIES, DEFAULT_CORE_INDEXES, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, DynamicGraphClient, DynamicRegistryConfig, EDGE_TYPE_SCHEMA, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, IndexSpec, META_EDGE_TYPE, META_NODE_TYPE, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, NODE_TYPE_SCHEMA, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildEdgeRecord, buildNodeQueryPlan, buildNodeRecord, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createBootstrapRegistry, createGraphClient, createGraphClientFromBackend, createMergedRegistry, createRegistry, createRegistryFromGraph, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateDeterministicUid, generateId, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };
+export { DEFAULT_CORE_INDEXES, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphReader, GraphRegistry, IndexSpec, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildNodeQueryPlan, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };

package/dist/index.d.ts

@@ -1,23 +1,15 @@
-import { S as StorageBackend } from './backend-U-MLShlg.js';
-import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, I as IndexSpec, b as DiscoveryResult, R as RegistryEntry, c as GraphRegistry, d as GraphReader, M as MigrationExecutor, e as DynamicRegistryConfig, S as StoredGraphRecord, f as MigrationWriteBack, g as MigrationStep, F as FindEdgesParams, Q as QueryPlan, h as FindNodesParams, i as QueryFilter, j as GraphRecord, k as MigrationFn, l as StoredMigrationStep, T as TraversalBuilder } from './types-BGWxcpI_.js';
-export { B as BulkBatchError, m as BulkOptions, n as BulkProgress, o as BulkResult, C as CascadeResult, p as DefineTypeOptions, q as DiscoveredEntity, E as EdgeTopology, r as EdgeTypeData, s as FiregraphConfig, t as GraphBatch, u as GraphTransaction, v as GraphWriter, H as HopDefinition, w as HopResult, x as IndexFieldSpec, N as NodeTypeData, y as QueryMode, z as QueryOptions, A as ScanProtection, J as TraversalOptions, K as TraversalResult, V as ViewContext, L as ViewDefaultsConfig, O as ViewResolverConfig, W as WhereClause, P as defineConfig, U as resolveView } from './types-BGWxcpI_.js';
+export { c as createGraphClient, a as createGraphClientFromBackend } from './client-BKi3vk0Q.js';
 export { CodegenOptions, generateTypes } from './codegen/index.js';
-import { F as FiregraphError } from './scope-path-B1G3YiA7.js';
-export { C as CrossBackendTransactionError, D as DynamicRegistryError, E as EdgeNotFoundError, I as InvalidQueryError, M as MigrationError, N as NodeNotFoundError, Q as QuerySafetyError, R as RegistryScopeError, b as RegistryViolationError, S as StorageScopeSegment, T as TraversalError, V as ValidationError, a as appendStorageScope, i as isAncestorScopeUid, p as parseStorageScope, r as resolveAncestorScope } from './scope-path-B1G3YiA7.js';
-import { Firestore } from '@google-cloud/firestore';
+import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, m as StoredGraphRecord, M as MigrationWriteBack, n as MigrationStep, G as GraphRegistry, F as FindEdgesParams, Q as QueryPlan, o as FindNodesParams, p as QueryFilter, q as MigrationExecutor, r as MigrationFn, s as StoredMigrationStep, t as GraphClient, u as GraphReader, v as TraversalBuilder } from './backend-DuvHGgK1.js';
+export { A as AggregateExtension, w as AggregateField, x as AggregateOp, y as AggregateResult, z as AggregateSpec, C as BulkBatchError, H as BulkOptions, K as BulkProgress, L as BulkResult, b as BulkUpdatePatch, N as Capability, O as CascadeResult, P as CoreGraphClient, V as DefineTypeOptions, X as DiscoveredEntity, Y as DistanceMeasure, d as DmlExtension, Z as DynamicGraphClient, _ as DynamicGraphMethods, $ as DynamicRegistryConfig, a0 as EdgeTopology, a1 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a2 as FindEdgesProjectedParams, a3 as FindNearestParams, a4 as FiregraphConfig, a5 as FullTextSearchExtension, a6 as GeoExtension, a7 as GraphBatch, a8 as GraphClientOptions, a9 as GraphRecord, aa as GraphTransaction, ab as GraphWriter, ac as HopDefinition, ad as HopResult, ae as IndexFieldSpec, J as JoinExtension, af as NodeTypeData, ag as ProjectedRow, ah as QueryMode, ai as QueryOptions, aj as RawFirestoreExtension, ak as RawSqlExtension, al as RealtimeListenExtension, am as ScanProtection, an as SelectExtension, ao as TraversalOptions, ap as TraversalResult, aq as VectorExtension, ar as ViewContext, as as ViewDefaultsConfig, at as ViewResolverConfig, au as WhereClause, av as defineConfig, h as deleteField, aw as resolveView } from './backend-DuvHGgK1.js';
+import { F as FiregraphError } from './errors-BRc3I_eH.js';
+export { C as CapabilityNotSupportedError, a as CrossBackendTransactionError, D as DynamicRegistryError, E as EdgeNotFoundError, I as InvalidQueryError, M as MigrationError, N as NodeNotFoundError, Q as QuerySafetyError, R as RegistryScopeError, b as RegistryViolationError, T as TraversalError, V as ValidationError } from './errors-BRc3I_eH.js';
+export { B as BOOTSTRAP_ENTRIES, E as EDGE_TYPE_SCHEMA, M as META_EDGE_TYPE, a as META_NODE_TYPE, N as NODE_TYPE_SCHEMA, c as createBootstrapRegistry, b as createMergedRegistry, d as createRegistry, e as createRegistryFromGraph, g as generateDeterministicUid, f as generateId } from './registry-C2KUPVZj.js';
 export { Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions } from './client-Bk2Cm6xv.js';
+export { S as StorageScopeSegment, a as appendStorageScope, i as isAncestorScopeUid, p as parseStorageScope, r as resolveAncestorScope } from './scope-path-CROFZGr9.js';
+import { Firestore } from '@google-cloud/firestore';
 export { E as EntityViewConfig, a as EntityViewMeta, V as ViewComponentClass, b as ViewMeta, c as ViewRegistry, d as ViewRegistryInput, e as defineViews } from './views-DL60k0cf.js';
 
-/**
- * Create a `GraphClient` backed by an arbitrary `StorageBackend`.
- *
- * Used by backend-specific factories (e.g. `createDOClient` in
- * `firegraph/cloudflare`) — most callers should use the higher-level
- * `createGraphClient(firestore, ...)` overload below for Firestore, or the
- * Cloudflare factory for DO-backed graphs.
- */
-declare function createGraphClientFromBackend(backend: StorageBackend, options?: GraphClientOptions, metaBackend?: StorageBackend): GraphClient | DynamicGraphClient;
-
 /**
  * Cross-graph edge resolution utilities.
  *
@@ -165,53 +157,6 @@ declare function discoverEntities(entitiesDir: string): DiscoverResult;
 declare function computeNodeDocId(uid: string): string;
 declare function computeEdgeDocId(aUid: string, axbType: string, bUid: string): string;
 
-/** The aType used for node type definition meta-nodes. */
-declare const META_NODE_TYPE = "nodeType";
-/** The aType used for edge type definition meta-nodes. */
-declare const META_EDGE_TYPE = "edgeType";
-/** JSON Schema for the `data` payload of a `nodeType` meta-node. */
-declare const NODE_TYPE_SCHEMA: object;
-/** JSON Schema for the `data` payload of an `edgeType` meta-node. */
-declare const EDGE_TYPE_SCHEMA: object;
-/** Registry entries for the two meta-types (always present). */
-declare const BOOTSTRAP_ENTRIES: readonly RegistryEntry[];
-declare function createBootstrapRegistry(): GraphRegistry;
-/**
- * Generate a deterministic UID for a meta-type definition.
- * This ensures that defining the same type name always targets the same
- * Firestore document, enabling upsert semantics.
- *
- * Format: 21-char base64url substring of SHA-256(`metaType:name`).
- */
-declare function generateDeterministicUid(metaType: string, name: string): string;
-/**
- * Read meta-type nodes from the graph and compile them into a GraphRegistry.
- *
- * The returned registry includes both the dynamic entries AND the bootstrap
- * meta-type entries, so meta-type writes remain validateable after a reload.
- *
- * @param reader - A GraphReader pointed at the collection containing meta-nodes.
- * @param executor - Optional custom executor for compiling stored migration source strings.
- */
-declare function createRegistryFromGraph(reader: GraphReader, executor?: MigrationExecutor): Promise<GraphRegistry>;
-
-/**
- * Firestore-specific client factory.
- *
- * Kept in its own module so that bundlers don't pull
- * `@google-cloud/firestore` into non-Firestore entry points — most
- * importantly the Cloudflare DO backend (`firegraph/cloudflare`) and the
- * routing primitive (`firegraph/backend`), both of which must load cleanly
- * in a Workers environment where the Node Firestore SDK is unavailable.
- */
-
-declare function createGraphClient(db: Firestore, collectionPath: string, options: GraphClientOptions & {
-    registryMode: DynamicRegistryConfig;
-}): DynamicGraphClient;
-declare function createGraphClient(db: Firestore, collectionPath: string, options?: GraphClientOptions): GraphClient;
-
-declare function generateId(): string;
-
 /**
  * Firestore composite index generator.
  *
@@ -425,38 +370,6 @@ interface QuerySafetyResult {
  */
 declare function analyzeQuerySafety(filters: QueryFilter[]): QuerySafetyResult;
 
-declare function buildNodeRecord(aType: string, uid: string, data: Record<string, unknown>): GraphRecord;
-declare function buildEdgeRecord(aType: string, aUid: string, axbType: string, bType: string, bUid: string, data: Record<string, unknown>): GraphRecord;
-
-/**
- * Build a registry from either explicit entries or a DiscoveryResult.
- *
- * @example
- * ```ts
- * // From explicit entries (programmatic)
- * const registry = createRegistry([
- *   { aType: 'user', axbType: 'is', bType: 'user', jsonSchema: userSchema },
- *   { aType: 'user', axbType: 'follows', bType: 'user', jsonSchema: followsSchema },
- * ]);
- *
- * // From discovery result (folder convention)
- * const discovered = await discoverEntities('./entities');
- * const registry = createRegistry(discovered);
- * ```
- */
-declare function createRegistry(input: RegistryEntry[] | DiscoveryResult): GraphRegistry;
-/**
- * Create a merged registry where `base` entries take priority and `extension`
- * entries fill in gaps. Lookups and validation check `base` first; only if the
- * triple is not found there does the merged registry fall through to
- * `extension`.
- *
- * The `entries()` method returns a deduplicated list (base wins on collision).
- * The `lookupByAxbType()` method merges results from both registries,
- * deduplicating by triple key with base entries winning.
- */
-declare function createMergedRegistry(base: GraphRegistry, extension: GraphRegistry): GraphRegistry;
-
 /**
  * Sandbox module for compiling dynamic registry migration source strings
  * into executable functions.
@@ -561,6 +474,21 @@ declare function matchScope(scopePath: string, pattern: string): boolean;
  */
 declare function matchScopeAny(scopePath: string, patterns: string[]): boolean;
 
+/**
+ * Firegraph serialization tag — split from `src/serialization.ts` so it can
+ * be imported from Workers-facing code without dragging in
+ * `@google-cloud/firestore`.
+ *
+ * The full serialization module (with Timestamp/GeoPoint round-tripping)
+ * lives one folder up because the sandbox migration pipeline needs it; the
+ * write-plan helper only needs to recognise tagged objects to keep them
+ * terminal during patch flattening, so it imports just the tag from here.
+ */
+/** Sentinel key used to tag serialized Firestore types. */
+declare const SERIALIZATION_TAG: "__firegraph_ser__";
+/** Check if a value is a tagged serialized Firestore type. */
+declare function isTaggedValue(value: unknown): boolean;
+
 /**
  * Firestore-aware serialization for the sandbox migration pipeline.
  *
@@ -574,10 +502,6 @@ declare function matchScopeAny(scopePath: string, patterns: string[]): boolean;
  * (in-memory functions) receive raw Firestore objects directly.
  */
 
-/** Sentinel key used to tag serialized Firestore types. */
-declare const SERIALIZATION_TAG: "__firegraph_ser__";
-/** Check if a value is a tagged serialized Firestore type. */
-declare function isTaggedValue(value: unknown): boolean;
 /**
  * Recursively walk a data object and replace Firestore types with tagged
  * plain objects suitable for JSON serialization.
@@ -610,4 +534,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-export { BOOTSTRAP_ENTRIES, DEFAULT_CORE_INDEXES, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, DynamicGraphClient, DynamicRegistryConfig, EDGE_TYPE_SCHEMA, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, IndexSpec, META_EDGE_TYPE, META_NODE_TYPE, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, NODE_TYPE_SCHEMA, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildEdgeRecord, buildNodeQueryPlan, buildNodeRecord, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createBootstrapRegistry, createGraphClient, createGraphClientFromBackend, createMergedRegistry, createRegistry, createRegistryFromGraph, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateDeterministicUid, generateId, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };
+export { DEFAULT_CORE_INDEXES, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphReader, GraphRegistry, IndexSpec, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildNodeQueryPlan, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };