@typicalday/firegraph 0.8.0 → 0.10.0

package/dist/index.d.cts

@@ -1,110 +1,20 @@
-import { S as StoredGraphRecord, Q as QueryFilter, c as QueryOptions, d as GraphReader, B as BulkOptions, C as CascadeResult, F as FindEdgesParams, e as BulkResult, G as GraphClientOptions, b as GraphClient, a as DynamicGraphClient, f as DiscoveryResult, R as RegistryEntry, g as GraphRegistry, M as MigrationExecutor, D as DynamicRegistryConfig, h as MigrationWriteBack, i as MigrationStep, j as QueryPlan, k as FindNodesParams, l as GraphRecord, m as MigrationFn, n as StoredMigrationStep, T as TraversalBuilder } from './types-BVtx9zLv.cjs';
-export { o as BulkBatchError, p as BulkProgress, q as DefineTypeOptions, r as DiscoveredEntity, E as EdgeTopology, s as EdgeTypeData, t as FiregraphConfig, u as GraphBatch, v as GraphTransaction, w as GraphWriter, H as HopDefinition, x as HopResult, N as NodeTypeData, y as QueryMode, z as ScanProtection, A as TraversalOptions, I as TraversalResult, V as ViewContext, J as ViewDefaultsConfig, K as ViewResolverConfig, W as WhereClause, L as defineConfig, O as resolveView } from './types-BVtx9zLv.cjs';
+import { S as StorageBackend } from './backend-73p5Blx7.cjs';
+import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, 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-DOemdlVA.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, N as NodeTypeData, x as QueryMode, y as QueryOptions, z as ScanProtection, A as TraversalOptions, I as TraversalResult, V as ViewContext, J as ViewDefaultsConfig, K as ViewResolverConfig, W as WhereClause, L as defineConfig, O as resolveView } from './types-DOemdlVA.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';
 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';
 
-/**
- * Backend abstraction for firegraph.
- *
- * `StorageBackend` is the single interface every storage driver implements.
- * The Firestore backend wraps `@google-cloud/firestore`; the SQLite backend
- * (shared by D1 and Durable Object SQLite) uses a parameterized SQL executor.
- *
- * `GraphClientImpl` and friends depend only on this interface — they have
- * no direct knowledge of Firestore or SQLite.
- */
-
-/**
- * Per-record write payload — backend-agnostic. Timestamps are not present;
- * the backend supplies them via `serverTimestamp()` placeholders that it
- * itself resolves at commit time.
- */
-interface WritableRecord {
-    aType: string;
-    aUid: string;
-    axbType: string;
-    bType: string;
-    bUid: string;
-    data: Record<string, unknown>;
-    /** Schema version (set by the writer when registry has migrations). */
-    v?: number;
-}
-/**
- * Patch shape for `updateDoc`. Captures the two patterns that exist today:
- *   - `dataFields`: shallow merge under `data` (used by `updateNode`)
- *   - `replaceData`: full data replacement (used by migration write-back)
- *   - `v`: optional schema-version stamp
- *
- * `updatedAt` is always set by the backend.
- */
-interface UpdatePayload {
-    dataFields?: Record<string, unknown>;
-    replaceData?: Record<string, unknown>;
-    v?: number;
-}
-/**
- * Read/write transaction adapter. Mirrors Firestore's transaction semantics:
- * reads are snapshot-consistent; writes are issued inside the transaction
- * and a rejection from any write aborts the surrounding `runTransaction`.
- *
- * Writes return `Promise<void>` so SQL drivers can surface row-level errors
- * (constraint violations, malformed JSON paths) rather than swallowing them.
- * Firestore implementations can resolve synchronously since the underlying
- * `Transaction.set/update/delete` calls are themselves synchronous buffers.
- */
-interface TransactionBackend {
-    getDoc(docId: string): Promise<StoredGraphRecord | null>;
-    query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]>;
-    setDoc(docId: string, record: WritableRecord): Promise<void>;
-    updateDoc(docId: string, update: UpdatePayload): Promise<void>;
-    deleteDoc(docId: string): Promise<void>;
-}
-/**
- * Atomic multi-write batch.
- */
-interface BatchBackend {
-    setDoc(docId: string, record: WritableRecord): void;
-    updateDoc(docId: string, update: UpdatePayload): void;
-    deleteDoc(docId: string): void;
-    commit(): Promise<void>;
-}
-/**
- * The single storage abstraction.
- *
- * Each backend instance is scoped to a "graph location" — for Firestore
- * that's a collection path; for SQLite it's a (table, scopePath) pair.
- * `subgraph()` returns a child backend bound to a nested location.
- */
-interface StorageBackend {
-    /** Backend-internal location identifier (collection path or table name). */
-    readonly collectionPath: string;
-    /** Subgraph scope (empty string for root). */
-    readonly scopePath: string;
-    getDoc(docId: string): Promise<StoredGraphRecord | null>;
-    query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]>;
-    setDoc(docId: string, record: WritableRecord): Promise<void>;
-    updateDoc(docId: string, update: UpdatePayload): Promise<void>;
-    deleteDoc(docId: string): Promise<void>;
-    runTransaction<T>(fn: (tx: TransactionBackend) => Promise<T>): Promise<T>;
-    createBatch(): BatchBackend;
-    subgraph(parentNodeUid: string, name: string): StorageBackend;
-    removeNodeCascade(uid: string, reader: GraphReader, options?: BulkOptions): Promise<CascadeResult>;
-    bulkRemoveEdges(params: FindEdgesParams, reader: GraphReader, options?: BulkOptions): Promise<BulkResult>;
-    /**
-     * Find edges across all subgraphs sharing a given collection name.
-     * Optional — backends that can't support this should throw a clear error.
-     */
-    findEdgesGlobal?(params: FindEdgesParams, collectionName?: string): Promise<StoredGraphRecord[]>;
-}
-
 /**
  * Create a `GraphClient` backed by an arbitrary `StorageBackend`.
  *
- * Used by backend-specific factories (D1, DO-SQLite, etc.) — most callers
- * should use the higher-level `createGraphClient(firestore, ...)` overload
- * below or import the equivalent from `firegraph/d1` / `firegraph/do-sqlite`.
+ * 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;
 
@@ -154,42 +64,6 @@ declare function resolveAncestorCollection(collectionPath: string, uid: string):
  */
 declare function isAncestorUid(collectionPath: string, uid: string): boolean;
 
-declare class FiregraphError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-declare class NodeNotFoundError extends FiregraphError {
-    constructor(uid: string);
-}
-declare class EdgeNotFoundError extends FiregraphError {
-    constructor(aUid: string, axbType: string, bUid: string);
-}
-declare class ValidationError extends FiregraphError {
-    readonly details?: unknown | undefined;
-    constructor(message: string, details?: unknown | undefined);
-}
-declare class RegistryViolationError extends FiregraphError {
-    constructor(aType: string, axbType: string, bType: string);
-}
-declare class InvalidQueryError extends FiregraphError {
-    constructor(message: string);
-}
-declare class TraversalError extends FiregraphError {
-    constructor(message: string);
-}
-declare class DynamicRegistryError extends FiregraphError {
-    constructor(message: string);
-}
-declare class QuerySafetyError extends FiregraphError {
-    constructor(message: string);
-}
-declare class RegistryScopeError extends FiregraphError {
-    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
-}
-declare class MigrationError extends FiregraphError {
-    constructor(message: string);
-}
-
 /**
  * Entity Discovery — convention-based auto-discovery of entities from
  * a per-entity folder structure.
@@ -281,8 +155,10 @@ declare function createRegistryFromGraph(reader: GraphReader, executor?: Migrati
  * Firestore-specific client factory.
  *
  * Kept in its own module so that bundlers don't pull
- * `@google-cloud/firestore` into SQLite-only entry points
- * (`firegraph/d1`, `firegraph/do-sqlite`).
+ * `@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 & {
@@ -619,4 +495,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-export { BOOTSTRAP_ENTRIES, BulkOptions, BulkResult, CascadeResult, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, DynamicGraphClient, DynamicRegistryConfig, DynamicRegistryError, EDGE_TYPE_SCHEMA, EdgeNotFoundError, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, InvalidQueryError, META_EDGE_TYPE, META_NODE_TYPE, MigrationError, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, NODE_TYPE_SCHEMA, NodeNotFoundError, QueryFilter, QueryOptions, QueryPlan, QuerySafetyError, type QuerySafetyResult, RegistryEntry, RegistryScopeError, RegistryViolationError, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, TraversalError, ValidationError, 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 { BOOTSTRAP_ENTRIES, 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, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, 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 };

package/dist/index.d.ts

@@ -1,110 +1,20 @@
-import { S as StoredGraphRecord, Q as QueryFilter, c as QueryOptions, d as GraphReader, B as BulkOptions, C as CascadeResult, F as FindEdgesParams, e as BulkResult, G as GraphClientOptions, b as GraphClient, a as DynamicGraphClient, f as DiscoveryResult, R as RegistryEntry, g as GraphRegistry, M as MigrationExecutor, D as DynamicRegistryConfig, h as MigrationWriteBack, i as MigrationStep, j as QueryPlan, k as FindNodesParams, l as GraphRecord, m as MigrationFn, n as StoredMigrationStep, T as TraversalBuilder } from './types-BVtx9zLv.js';
-export { o as BulkBatchError, p as BulkProgress, q as DefineTypeOptions, r as DiscoveredEntity, E as EdgeTopology, s as EdgeTypeData, t as FiregraphConfig, u as GraphBatch, v as GraphTransaction, w as GraphWriter, H as HopDefinition, x as HopResult, N as NodeTypeData, y as QueryMode, z as ScanProtection, A as TraversalOptions, I as TraversalResult, V as ViewContext, J as ViewDefaultsConfig, K as ViewResolverConfig, W as WhereClause, L as defineConfig, O as resolveView } from './types-BVtx9zLv.js';
+import { S as StorageBackend } from './backend-BrqFkbid.js';
+import { G as GraphClientOptions, a as GraphClient, D as DynamicGraphClient, 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-DOemdlVA.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, N as NodeTypeData, x as QueryMode, y as QueryOptions, z as ScanProtection, A as TraversalOptions, I as TraversalResult, V as ViewContext, J as ViewDefaultsConfig, K as ViewResolverConfig, W as WhereClause, L as defineConfig, O as resolveView } from './types-DOemdlVA.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';
 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';
 
-/**
- * Backend abstraction for firegraph.
- *
- * `StorageBackend` is the single interface every storage driver implements.
- * The Firestore backend wraps `@google-cloud/firestore`; the SQLite backend
- * (shared by D1 and Durable Object SQLite) uses a parameterized SQL executor.
- *
- * `GraphClientImpl` and friends depend only on this interface — they have
- * no direct knowledge of Firestore or SQLite.
- */
-
-/**
- * Per-record write payload — backend-agnostic. Timestamps are not present;
- * the backend supplies them via `serverTimestamp()` placeholders that it
- * itself resolves at commit time.
- */
-interface WritableRecord {
-    aType: string;
-    aUid: string;
-    axbType: string;
-    bType: string;
-    bUid: string;
-    data: Record<string, unknown>;
-    /** Schema version (set by the writer when registry has migrations). */
-    v?: number;
-}
-/**
- * Patch shape for `updateDoc`. Captures the two patterns that exist today:
- *   - `dataFields`: shallow merge under `data` (used by `updateNode`)
- *   - `replaceData`: full data replacement (used by migration write-back)
- *   - `v`: optional schema-version stamp
- *
- * `updatedAt` is always set by the backend.
- */
-interface UpdatePayload {
-    dataFields?: Record<string, unknown>;
-    replaceData?: Record<string, unknown>;
-    v?: number;
-}
-/**
- * Read/write transaction adapter. Mirrors Firestore's transaction semantics:
- * reads are snapshot-consistent; writes are issued inside the transaction
- * and a rejection from any write aborts the surrounding `runTransaction`.
- *
- * Writes return `Promise<void>` so SQL drivers can surface row-level errors
- * (constraint violations, malformed JSON paths) rather than swallowing them.
- * Firestore implementations can resolve synchronously since the underlying
- * `Transaction.set/update/delete` calls are themselves synchronous buffers.
- */
-interface TransactionBackend {
-    getDoc(docId: string): Promise<StoredGraphRecord | null>;
-    query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]>;
-    setDoc(docId: string, record: WritableRecord): Promise<void>;
-    updateDoc(docId: string, update: UpdatePayload): Promise<void>;
-    deleteDoc(docId: string): Promise<void>;
-}
-/**
- * Atomic multi-write batch.
- */
-interface BatchBackend {
-    setDoc(docId: string, record: WritableRecord): void;
-    updateDoc(docId: string, update: UpdatePayload): void;
-    deleteDoc(docId: string): void;
-    commit(): Promise<void>;
-}
-/**
- * The single storage abstraction.
- *
- * Each backend instance is scoped to a "graph location" — for Firestore
- * that's a collection path; for SQLite it's a (table, scopePath) pair.
- * `subgraph()` returns a child backend bound to a nested location.
- */
-interface StorageBackend {
-    /** Backend-internal location identifier (collection path or table name). */
-    readonly collectionPath: string;
-    /** Subgraph scope (empty string for root). */
-    readonly scopePath: string;
-    getDoc(docId: string): Promise<StoredGraphRecord | null>;
-    query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]>;
-    setDoc(docId: string, record: WritableRecord): Promise<void>;
-    updateDoc(docId: string, update: UpdatePayload): Promise<void>;
-    deleteDoc(docId: string): Promise<void>;
-    runTransaction<T>(fn: (tx: TransactionBackend) => Promise<T>): Promise<T>;
-    createBatch(): BatchBackend;
-    subgraph(parentNodeUid: string, name: string): StorageBackend;
-    removeNodeCascade(uid: string, reader: GraphReader, options?: BulkOptions): Promise<CascadeResult>;
-    bulkRemoveEdges(params: FindEdgesParams, reader: GraphReader, options?: BulkOptions): Promise<BulkResult>;
-    /**
-     * Find edges across all subgraphs sharing a given collection name.
-     * Optional — backends that can't support this should throw a clear error.
-     */
-    findEdgesGlobal?(params: FindEdgesParams, collectionName?: string): Promise<StoredGraphRecord[]>;
-}
-
 /**
  * Create a `GraphClient` backed by an arbitrary `StorageBackend`.
  *
- * Used by backend-specific factories (D1, DO-SQLite, etc.) — most callers
- * should use the higher-level `createGraphClient(firestore, ...)` overload
- * below or import the equivalent from `firegraph/d1` / `firegraph/do-sqlite`.
+ * 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;
 
@@ -154,42 +64,6 @@ declare function resolveAncestorCollection(collectionPath: string, uid: string):
  */
 declare function isAncestorUid(collectionPath: string, uid: string): boolean;
 
-declare class FiregraphError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-declare class NodeNotFoundError extends FiregraphError {
-    constructor(uid: string);
-}
-declare class EdgeNotFoundError extends FiregraphError {
-    constructor(aUid: string, axbType: string, bUid: string);
-}
-declare class ValidationError extends FiregraphError {
-    readonly details?: unknown | undefined;
-    constructor(message: string, details?: unknown | undefined);
-}
-declare class RegistryViolationError extends FiregraphError {
-    constructor(aType: string, axbType: string, bType: string);
-}
-declare class InvalidQueryError extends FiregraphError {
-    constructor(message: string);
-}
-declare class TraversalError extends FiregraphError {
-    constructor(message: string);
-}
-declare class DynamicRegistryError extends FiregraphError {
-    constructor(message: string);
-}
-declare class QuerySafetyError extends FiregraphError {
-    constructor(message: string);
-}
-declare class RegistryScopeError extends FiregraphError {
-    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
-}
-declare class MigrationError extends FiregraphError {
-    constructor(message: string);
-}
-
 /**
  * Entity Discovery — convention-based auto-discovery of entities from
  * a per-entity folder structure.
@@ -281,8 +155,10 @@ declare function createRegistryFromGraph(reader: GraphReader, executor?: Migrati
  * Firestore-specific client factory.
  *
  * Kept in its own module so that bundlers don't pull
- * `@google-cloud/firestore` into SQLite-only entry points
- * (`firegraph/d1`, `firegraph/do-sqlite`).
+ * `@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 & {
@@ -619,4 +495,4 @@ declare function deserializeFirestoreTypes(data: Record<string, unknown>, db?: F
  */
 declare function createTraversal(reader: GraphClient | GraphReader, startUid: string, registry?: GraphRegistry): TraversalBuilder;
 
-export { BOOTSTRAP_ENTRIES, BulkOptions, BulkResult, CascadeResult, DEFAULT_QUERY_LIMIT, type DiscoverResult, DiscoveryError, DiscoveryResult, type DiscoveryWarning, DynamicGraphClient, DynamicRegistryConfig, DynamicRegistryError, EDGE_TYPE_SCHEMA, EdgeNotFoundError, type FieldMeta, FindEdgesParams, FindNodesParams, FiregraphError, type FirestoreIndex, type FirestoreIndexConfig, type FirestoreIndexField, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, InvalidQueryError, META_EDGE_TYPE, META_NODE_TYPE, MigrationError, MigrationExecutor, MigrationFn, type MigrationResult, MigrationStep, MigrationWriteBack, NODE_TYPE_SCHEMA, NodeNotFoundError, QueryFilter, QueryOptions, QueryPlan, QuerySafetyError, type QuerySafetyResult, RegistryEntry, RegistryScopeError, RegistryViolationError, SERIALIZATION_TAG, StoredGraphRecord, StoredMigrationStep, TraversalBuilder, TraversalError, ValidationError, 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 { BOOTSTRAP_ENTRIES, 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, GraphClient, GraphClientOptions, GraphReader, GraphRecord, GraphRegistry, 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 };

package/dist/index.js

@@ -1,23 +1,18 @@
+import {
+  appendStorageScope,
+  isAncestorScopeUid,
+  parseStorageScope,
+  resolveAncestorScope
+} from "./chunk-TYYPRVIE.js";
 import {
   BOOTSTRAP_ENTRIES,
   DEFAULT_QUERY_LIMIT,
-  DynamicRegistryError,
   EDGE_TYPE_SCHEMA,
-  EdgeNotFoundError,
-  FiregraphError,
   GraphClientImpl,
-  InvalidQueryError,
   META_EDGE_TYPE,
   META_NODE_TYPE,
-  MigrationError,
   NODE_RELATION,
   NODE_TYPE_SCHEMA,
-  NodeNotFoundError,
-  QuerySafetyError,
-  RegistryScopeError,
-  RegistryViolationError,
-  TraversalError,
-  ValidationError,
   analyzeQuerySafety,
   applyMigrationChain,
   buildEdgeQueryPlan,
@@ -42,20 +37,34 @@ import {
   migrateRecords,
   precompileSource,
   validateMigrationChain
-} from "./chunk-YUXOALMR.js";
+} from "./chunk-LZOIQHYN.js";
+import {
+  CrossBackendTransactionError,
+  DynamicRegistryError,
+  EdgeNotFoundError,
+  FiregraphError,
+  InvalidQueryError,
+  MigrationError,
+  NodeNotFoundError,
+  QuerySafetyError,
+  RegistryScopeError,
+  RegistryViolationError,
+  TraversalError,
+  ValidationError
+} from "./chunk-R7CRGYY4.js";
 import {
   generateTypes
 } from "./chunk-YLGXLEUE.js";
 import {
   QueryClient,
   QueryClientError
-} from "./chunk-KFA7G37W.js";
+} from "./chunk-SU4FNLC3.js";
 import {
   SERIALIZATION_TAG,
   deserializeFirestoreTypes,
   isTaggedValue,
   serializeFirestoreTypes
-} from "./chunk-6OQW5OKO.js";
+} from "./chunk-5753Y42M.js";
 
 // src/config.ts
 function defineConfig(config) {
@@ -91,7 +100,7 @@ function isAncestorUid(collectionPath, uid) {
 }
 
 // src/discover.ts
-import { readFileSync, readdirSync, existsSync, statSync } from "fs";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
 import { createRequire } from "module";
 import { join, resolve } from "path";
 var DiscoveryError = class extends FiregraphError {
@@ -223,14 +232,10 @@ function loadEdgeEntity(dir, name) {
   }
   const topology = readJson(edgePath);
   if (!topology.from) {
-    throw new DiscoveryError(
-      `edge.json for "${name}" is missing required "from" field`
-    );
+    throw new DiscoveryError(`edge.json for "${name}" is missing required "from" field`);
   }
   if (!topology.to) {
-    throw new DiscoveryError(
-      `edge.json for "${name}" is missing required "to" field`
-    );
+    throw new DiscoveryError(`edge.json for "${name}" is missing required "to" field`);
   }
   const meta = readJsonIfExists(join(dir, "meta.json"));
   const sampleData = readJsonIfExists(join(dir, "sample.json"));
@@ -1134,7 +1139,6 @@ function getCustomElements() {
 function resilientView(ViewClass, tagName) {
   const g = globalThis;
   if (!g.HTMLElement) return ViewClass;
-  const Base = g.HTMLElement;
   const Wrapped = class extends ViewClass {
     connectedCallback() {
       try {
@@ -1221,6 +1225,7 @@ function defineViews(input) {
 }
 export {
   BOOTSTRAP_ENTRIES,
+  CrossBackendTransactionError,
   DEFAULT_QUERY_LIMIT,
   DiscoveryError,
   DynamicRegistryError,
@@ -1242,6 +1247,7 @@ export {
   TraversalError,
   ValidationError,
   analyzeQuerySafety,
+  appendStorageScope,
   applyMigrationChain,
   buildEdgeQueryPlan,
   buildEdgeRecord,
@@ -1269,6 +1275,7 @@ export {
   generateId,
   generateIndexConfig,
   generateTypes,
+  isAncestorScopeUid,
   isAncestorUid,
   isTaggedValue,
   jsonSchemaToFieldMeta,
@@ -1276,8 +1283,10 @@ export {
   matchScopeAny,
   migrateRecord,
   migrateRecords,
+  parseStorageScope,
   precompileSource,
   resolveAncestorCollection,
+  resolveAncestorScope,
   resolveView,
   serializeFirestoreTypes,
   validateMigrationChain