@typicalday/firegraph 0.11.2 → 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,36 +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[];
-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.
  *
@@ -210,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.
  *
@@ -428,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.
@@ -561,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.
  *
@@ -574,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.
@@ -610,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,36 +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[];
-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.
  *
@@ -210,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.
  *
@@ -428,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.
@@ -561,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.
  *
@@ -574,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.
@@ -610,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-NJSOD64C.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,