@typicalday/firegraph 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -1,25 +1,15 @@
-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 { 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';
-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';
+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.
  *
@@ -167,21 +157,6 @@ declare function discoverEntities(entitiesDir: string): DiscoverResult;
 declare function computeNodeDocId(uid: string): string;
 declare function computeEdgeDocId(aUid: string, axbType: string, bUid: string): string;
 
-/**
- * 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;
-
 /**
  * Firestore composite index generator.
  *
@@ -395,9 +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;
-
 /**
  * Sandbox module for compiling dynamic registry migration source strings
  * into executable functions.
@@ -562,4 +534,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-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 };
+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,25 +1,15 @@
-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 { 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';
-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';
+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.
  *
@@ -167,21 +157,6 @@ declare function discoverEntities(entitiesDir: string): DiscoverResult;
 declare function computeNodeDocId(uid: string): string;
 declare function computeEdgeDocId(aUid: string, axbType: string, bUid: string): string;
 
-/**
- * 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;
-
 /**
  * Firestore composite index generator.
  *
@@ -395,9 +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;
-
 /**
  * Sandbox module for compiling dynamic registry migration source strings
  * into executable functions.
@@ -562,4 +534,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-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 };
+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 };