@typicalday/firegraph 0.11.1 → 0.12.0

package/dist/index.d.cts

@@ -1,9 +1,11 @@
-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';
+import { S as StorageBackend } from './backend-Ct-fLlkG.cjs';
+export { d as deleteField } from './backend-Ct-fLlkG.cjs';
+import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, I as IndexSpec, b as DiscoveryResult, c as DynamicRegistryConfig, R as RegistryEntry, S as StoredGraphRecord, M as MigrationWriteBack, d as MigrationStep, e as GraphRegistry, F as FindEdgesParams, Q as QueryPlan, f as FindNodesParams, g as QueryFilter, h as GraphRecord, i as MigrationExecutor, j as MigrationFn, k as StoredMigrationStep, l as GraphReader, T as TraversalBuilder } from './types-DxYLy8Ol.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-DxYLy8Ol.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';
+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-B1qsVL0E.cjs';
 import { Firestore } from '@google-cloud/firestore';
 export { Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions } from './client-Bk2Cm6xv.cjs';
 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';
@@ -165,40 +167,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[];
-/**
- * Build the bootstrap registry that validates meta-type writes.
- * This is always available, even before any dynamic types are loaded.
- */
-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.
  *
@@ -214,8 +182,6 @@ declare function createGraphClient(db: Firestore, collectionPath: string, option
 }): DynamicGraphClient;
 declare function createGraphClient(db: Firestore, collectionPath: string, options?: GraphClientOptions): GraphClient;
 
-declare function generateId(): string;
-
 /**
  * Firestore composite index generator.
  *
@@ -296,9 +262,17 @@ declare const DEFAULT_QUERY_LIMIT = 500;
 /**
  * JSON Schema validation and introspection utilities.
  *
- * Standard JSON Schema validation and introspection
- * processing. Uses ajv for validation and a recursive walker for converting
- * JSON Schema properties into FieldMeta objects for editor form generation.
+ * Uses `@cfworker/json-schema` for validation — a runtime-interpreter
+ * JSON Schema validator that does not rely on `new Function()` and is
+ * therefore compatible with Cloudflare Workers (which run V8 with
+ * `--disallow-code-generation-from-strings`). Ajv was used here
+ * previously, but its `ajv.compile(schema)` generates a validator via
+ * the Function constructor and fails with "Code generation from strings
+ * disallowed for this context" whenever firegraph's dynamic-registry
+ * bootstrap or `reloadRegistry` runs inside a Worker.
+ *
+ * The introspection half (`jsonSchemaToFieldMeta`) is pure string/object
+ * manipulation with no validator dependency.
  */
 interface FieldMeta {
     name: string;
@@ -317,7 +291,33 @@ interface FieldMeta {
 }
 /**
  * Compile a JSON Schema into a validation function.
- * The returned function throws `ValidationError` if data is invalid.
+ *
+ * The returned function throws `ValidationError` if data is invalid. The
+ * error's `details` is the `OutputUnit[]` array produced by
+ * `@cfworker/json-schema` — consumers that previously inspected Ajv's
+ * `ErrorObject[]` need to map to the cfworker shape
+ * (`{ keyword, keywordLocation, instanceLocation, error }`).
+ *
+ * Draft 2020-12 is requested by default to match the library's richest
+ * feature set; schemas that omit `$schema` still validate under it
+ * since keyword semantics back-compat to draft-07 for the fields
+ * firegraph actually uses.
+ *
+ * `shortCircuit` is explicitly disabled so `result.errors` contains
+ * every violation, not just the first one — humans rely on the joined
+ * error message to debug bad writes from the editor / chat UI. The
+ * full array is preserved on `ValidationError.details`; only the
+ * rendered message is capped at `MAX_RENDERED_ERRORS` lines so
+ * pathological `oneOf`/`anyOf` schemas can't blow up log lines.
+ *
+ * Format keywords supported by `@cfworker/json-schema` (anything else
+ * is silently passed through — see node_modules/@cfworker/json-schema/
+ * src/format.ts):
+ *   `date`, `time`, `date-time`, `duration`,
+ *   `email`, `hostname`, `ipv4`, `ipv6`,
+ *   `uri`, `uri-reference`, `uri-template`, `url`,
+ *   `uuid`, `regex`,
+ *   `json-pointer`, `relative-json-pointer`, `json-pointer-uri-fragment`.
  */
 declare function compileSchema(schema: object, label?: string): (data: unknown) => void;
 /**
@@ -398,35 +398,6 @@ 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.
@@ -531,6 +502,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.
  *
@@ -544,10 +530,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.
@@ -580,4 +562,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, DynamicGraphClient, DynamicRegistryConfig, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, IndexSpec, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildEdgeRecord, buildNodeQueryPlan, buildNodeRecord, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createGraphClient, createGraphClientFromBackend, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-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';
+import { S as StorageBackend } from './backend-BsR0lnFL.js';
+export { d as deleteField } from './backend-BsR0lnFL.js';
+import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, I as IndexSpec, b as DiscoveryResult, c as DynamicRegistryConfig, R as RegistryEntry, S as StoredGraphRecord, M as MigrationWriteBack, d as MigrationStep, e as GraphRegistry, F as FindEdgesParams, Q as QueryPlan, f as FindNodesParams, g as QueryFilter, h as GraphRecord, i as MigrationExecutor, j as MigrationFn, k as StoredMigrationStep, l as GraphReader, T as TraversalBuilder } from './types-DxYLy8Ol.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-DxYLy8Ol.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';
+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-Fi074zVa.js';
 import { Firestore } from '@google-cloud/firestore';
 export { Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions } from './client-Bk2Cm6xv.js';
 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';
@@ -165,40 +167,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[];
-/**
- * Build the bootstrap registry that validates meta-type writes.
- * This is always available, even before any dynamic types are loaded.
- */
-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.
  *
@@ -214,8 +182,6 @@ declare function createGraphClient(db: Firestore, collectionPath: string, option
 }): DynamicGraphClient;
 declare function createGraphClient(db: Firestore, collectionPath: string, options?: GraphClientOptions): GraphClient;
 
-declare function generateId(): string;
-
 /**
  * Firestore composite index generator.
  *
@@ -296,9 +262,17 @@ declare const DEFAULT_QUERY_LIMIT = 500;
 /**
  * JSON Schema validation and introspection utilities.
  *
- * Standard JSON Schema validation and introspection
- * processing. Uses ajv for validation and a recursive walker for converting
- * JSON Schema properties into FieldMeta objects for editor form generation.
+ * Uses `@cfworker/json-schema` for validation — a runtime-interpreter
+ * JSON Schema validator that does not rely on `new Function()` and is
+ * therefore compatible with Cloudflare Workers (which run V8 with
+ * `--disallow-code-generation-from-strings`). Ajv was used here
+ * previously, but its `ajv.compile(schema)` generates a validator via
+ * the Function constructor and fails with "Code generation from strings
+ * disallowed for this context" whenever firegraph's dynamic-registry
+ * bootstrap or `reloadRegistry` runs inside a Worker.
+ *
+ * The introspection half (`jsonSchemaToFieldMeta`) is pure string/object
+ * manipulation with no validator dependency.
  */
 interface FieldMeta {
     name: string;
@@ -317,7 +291,33 @@ interface FieldMeta {
 }
 /**
  * Compile a JSON Schema into a validation function.
- * The returned function throws `ValidationError` if data is invalid.
+ *
+ * The returned function throws `ValidationError` if data is invalid. The
+ * error's `details` is the `OutputUnit[]` array produced by
+ * `@cfworker/json-schema` — consumers that previously inspected Ajv's
+ * `ErrorObject[]` need to map to the cfworker shape
+ * (`{ keyword, keywordLocation, instanceLocation, error }`).
+ *
+ * Draft 2020-12 is requested by default to match the library's richest
+ * feature set; schemas that omit `$schema` still validate under it
+ * since keyword semantics back-compat to draft-07 for the fields
+ * firegraph actually uses.
+ *
+ * `shortCircuit` is explicitly disabled so `result.errors` contains
+ * every violation, not just the first one — humans rely on the joined
+ * error message to debug bad writes from the editor / chat UI. The
+ * full array is preserved on `ValidationError.details`; only the
+ * rendered message is capped at `MAX_RENDERED_ERRORS` lines so
+ * pathological `oneOf`/`anyOf` schemas can't blow up log lines.
+ *
+ * Format keywords supported by `@cfworker/json-schema` (anything else
+ * is silently passed through — see node_modules/@cfworker/json-schema/
+ * src/format.ts):
+ *   `date`, `time`, `date-time`, `duration`,
+ *   `email`, `hostname`, `ipv4`, `ipv6`,
+ *   `uri`, `uri-reference`, `uri-template`, `url`,
+ *   `uuid`, `regex`,
+ *   `json-pointer`, `relative-json-pointer`, `json-pointer-uri-fragment`.
  */
 declare function compileSchema(schema: object, label?: string): (data: unknown) => void;
 /**
@@ -398,35 +398,6 @@ 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.
@@ -531,6 +502,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.
  *
@@ -544,10 +530,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.
@@ -580,4 +562,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, DynamicGraphClient, DynamicRegistryConfig, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, type GenerateIndexOptions, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, IndexSpec, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, QueryFilter, QueryPlan, type QuerySafetyResult, RegistryEntry, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, analyzeQuerySafety, applyMigrationChain, buildEdgeQueryPlan, buildEdgeRecord, buildNodeQueryPlan, buildNodeRecord, compileMigrationFn, compileMigrations, compileSchema, computeEdgeDocId, computeNodeDocId, createGraphClient, createGraphClientFromBackend, createTraversal, defaultExecutor, deserializeFirestoreTypes, destroySandboxWorker, discoverEntities, generateIndexConfig, isAncestorUid, isTaggedValue, jsonSchemaToFieldMeta, matchScope, matchScopeAny, migrateRecord, migrateRecords, precompileSource, resolveAncestorCollection, serializeFirestoreTypes, validateMigrationChain };

package/dist/index.js

@@ -31,6 +31,7 @@ import {
   defaultExecutor,
   destroySandboxWorker,
   generateDeterministicUid,
+  generateId,
   jsonSchemaToFieldMeta,
   matchScope,
   matchScopeAny,
@@ -38,7 +39,7 @@ import {
   migrateRecords,
   precompileSource,
   validateMigrationChain
-} from "./chunk-6SB34IPQ.js";
+} from "./chunk-HONQY4HF.js";
 import {
   CrossBackendTransactionError,
   DynamicRegistryError,
@@ -51,8 +52,11 @@ import {
   RegistryScopeError,
   RegistryViolationError,
   TraversalError,
-  ValidationError
-} from "./chunk-R7CRGYY4.js";
+  ValidationError,
+  assertSafePath,
+  assertUpdatePayloadExclusive,
+  deleteField
+} from "./chunk-AWW4MUJ5.js";
 import {
   generateTypes
 } from "./chunk-GJVVRTQT.js";
@@ -61,11 +65,13 @@ import {
   QueryClientError
 } from "./chunk-EEKWRX5E.js";
 import {
-  SERIALIZATION_TAG,
   deserializeFirestoreTypes,
-  isTaggedValue,
   serializeFirestoreTypes
-} from "./chunk-5753Y42M.js";
+} from "./chunk-C2QMD7RY.js";
+import {
+  SERIALIZATION_TAG,
+  isTaggedValue
+} from "./chunk-EQJUUVFG.js";
 
 // src/config.ts
 function defineConfig(config) {
@@ -457,8 +463,12 @@ function createFirestoreAdapter(db, collectionPath) {
       if (!snap.exists) return null;
       return snap.data();
     },
-    async setDoc(docId, data) {
-      await collectionRef.doc(docId).set(data);
+    async setDoc(docId, data, options) {
+      if (options?.merge) {
+        await collectionRef.doc(docId).set(data, { merge: true });
+      } else {
+        await collectionRef.doc(docId).set(data);
+      }
     },
     async updateDoc(docId, data) {
       await collectionRef.doc(docId).update(data);
@@ -490,8 +500,12 @@ function createTransactionAdapter(db, collectionPath, tx) {
       if (!snap.exists) return null;
       return snap.data();
     },
-    setDoc(docId, data) {
-      tx.set(collectionRef.doc(docId), data);
+    setDoc(docId, data, options) {
+      if (options?.merge) {
+        tx.set(collectionRef.doc(docId), data, { merge: true });
+      } else {
+        tx.set(collectionRef.doc(docId), data);
+      }
     },
     updateDoc(docId, data) {
       tx.update(collectionRef.doc(docId), data);
@@ -519,8 +533,12 @@ function createBatchAdapter(db, collectionPath) {
   const collectionRef = db.collection(collectionPath);
   const batch = db.batch();
   return {
-    setDoc(docId, data) {
-      batch.set(collectionRef.doc(docId), data);
+    setDoc(docId, data, options) {
+      if (options?.merge) {
+        batch.set(collectionRef.doc(docId), data, { merge: true });
+      } else {
+        batch.set(collectionRef.doc(docId), data);
+      }
     },
     updateDoc(docId, data) {
       batch.update(collectionRef.doc(docId), data);
@@ -596,16 +614,21 @@ function createPipelineQueryAdapter(db, collectionPath) {
 }
 
 // src/internal/firestore-backend.ts
+function dottedDataPath(op) {
+  assertSafePath(op.path);
+  return `data.${op.path.join(".")}`;
+}
 function buildFirestoreUpdate(update, db) {
+  assertUpdatePayloadExclusive(update);
   const out = {
     updatedAt: FieldValue.serverTimestamp()
   };
   if (update.replaceData) {
     out.data = deserializeFirestoreTypes(update.replaceData, db);
-  }
-  if (update.dataFields) {
-    for (const [k, v] of Object.entries(update.dataFields)) {
-      out[`data.${k}`] = v;
+  } else if (update.dataOps) {
+    for (const op of update.dataOps) {
+      const key = dottedDataPath(op);
+      out[key] = op.delete ? FieldValue.delete() : op.value;
     }
   }
   if (update.v !== void 0) {
@@ -639,8 +662,12 @@ var FirestoreTransactionBackend = class {
   query(filters, options) {
     return this.adapter.query(filters, options);
   }
-  async setDoc(docId, record) {
-    this.adapter.setDoc(docId, stampWritableRecord(record));
+  async setDoc(docId, record, mode) {
+    this.adapter.setDoc(
+      docId,
+      stampWritableRecord(record),
+      mode === "merge" ? { merge: true } : void 0
+    );
   }
   async updateDoc(docId, update) {
     this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));
@@ -654,8 +681,12 @@ var FirestoreBatchBackend = class {
     this.adapter = adapter;
     this.db = db;
   }
-  setDoc(docId, record) {
-    this.adapter.setDoc(docId, stampWritableRecord(record));
+  setDoc(docId, record, mode) {
+    this.adapter.setDoc(
+      docId,
+      stampWritableRecord(record),
+      mode === "merge" ? { merge: true } : void 0
+    );
   }
   updateDoc(docId, update) {
     this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));
@@ -693,8 +724,12 @@ var FirestoreBackendImpl = class _FirestoreBackendImpl {
     return this.adapter.query(filters, options);
   }
   // --- Writes ---
-  setDoc(docId, record) {
-    return this.adapter.setDoc(docId, stampWritableRecord(record));
+  setDoc(docId, record, mode) {
+    return this.adapter.setDoc(
+      docId,
+      stampWritableRecord(record),
+      mode === "merge" ? { merge: true } : void 0
+    );
   }
   updateDoc(docId, update) {
     return this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));
@@ -779,12 +814,6 @@ function createGraphClient(db, collectionPath, options) {
   return new GraphClientImpl(backend, options, metaBackend);
 }
 
-// src/id.ts
-import { nanoid } from "nanoid";
-function generateId() {
-  return nanoid();
-}
-
 // src/indexes.ts
 function normalizeField(f) {
   return typeof f === "string" ? { path: f, desc: false } : { path: f.path, desc: !!f.desc };
@@ -1222,6 +1251,7 @@ export {
   defaultExecutor,
   defineConfig,
   defineViews,
+  deleteField,
   deserializeFirestoreTypes,
   destroySandboxWorker,
   discoverEntities,