@typicalday/firegraph 0.12.0 → 0.13.0

package/dist/firestore-standard/index.d.cts

@@ -0,0 +1,49 @@
+export { c as createGraphClient } from '../client-BrsaXtDV.cjs';
+export { M as META_EDGE_TYPE, a as META_NODE_TYPE, b as createMergedRegistry, d as createRegistry, f as generateId } from '../registry-Bc7h6WTM.cjs';
+import { Firestore } from '@google-cloud/firestore';
+import { S as StorageBackend } from '../backend-DuvHGgK1.cjs';
+
+/**
+ * Firestore Standard edition `StorageBackend`.
+ *
+ * The Standard edition only has the classic Query API — pipelines and
+ * Enterprise-only product features (full-text search, geo) are not
+ * available. This file deliberately does not import the pipeline adapter so
+ * a Standard-only deployment never pulls Pipeline code into its bundle.
+ *
+ * Capability declarations follow the conservative invariant established in
+ * Phase 1: only declare what the file actually implements at runtime.
+ * `query.aggregate` (Phase 6), `query.select` (Phase 7), `search.vector`
+ * (Phase 8), and `query.join` (Phase 13a — chunked classic-API fan-out)
+ * are wired; `realtime.listen` will be added in a later phase once the
+ * matching backend method exists. `query.dml` stays unwired because the
+ * classic Query API has no server-side DML statement; mass-delete /
+ * mass-update are still routed through the existing `bulkRemoveEdges`
+ * fetch-then-write loop.
+ */
+
+/**
+ * Capability union declared by the Firestore Standard backend.
+ *
+ * Conservative declaration: only capabilities backed by an actual runtime
+ * method are listed. `query.aggregate` (Phase 6) and `query.select`
+ * (Phase 7) are now wired; `search.vector` and `realtime.listen` will be
+ * layered in by their respective phases — this union and the matching
+ * cap-set literal are updated in lockstep.
+ */
+type FirestoreStandardCapability = 'core.read' | 'core.write' | 'core.transactions' | 'core.batch' | 'core.subgraph' | 'query.aggregate' | 'query.select' | 'query.join' | 'search.vector' | 'raw.firestore';
+interface FirestoreStandardOptions {
+    /** Internal: the logical scope path inherited from a parent subgraph. */
+    scopePath?: string;
+}
+/**
+ * Create a Firestore Standard-edition `StorageBackend`.
+ *
+ * Standard Firestore does not support pipelines or any Enterprise-only
+ * features. `data.*` filters require composite indexes; callers that mostly
+ * filter on built-in fields (`aUid`, `axbType`, `bUid`) avoid that
+ * requirement.
+ */
+declare function createFirestoreStandardBackend(db: Firestore, collectionPath: string, options?: FirestoreStandardOptions): StorageBackend<FirestoreStandardCapability>;
+
+export { type FirestoreStandardCapability, type FirestoreStandardOptions, createFirestoreStandardBackend };

package/dist/firestore-standard/index.d.ts

@@ -0,0 +1,49 @@
+export { c as createGraphClient } from '../client-BKi3vk0Q.js';
+export { M as META_EDGE_TYPE, a as META_NODE_TYPE, b as createMergedRegistry, d as createRegistry, f as generateId } from '../registry-C2KUPVZj.js';
+import { Firestore } from '@google-cloud/firestore';
+import { S as StorageBackend } from '../backend-DuvHGgK1.js';
+
+/**
+ * Firestore Standard edition `StorageBackend`.
+ *
+ * The Standard edition only has the classic Query API — pipelines and
+ * Enterprise-only product features (full-text search, geo) are not
+ * available. This file deliberately does not import the pipeline adapter so
+ * a Standard-only deployment never pulls Pipeline code into its bundle.
+ *
+ * Capability declarations follow the conservative invariant established in
+ * Phase 1: only declare what the file actually implements at runtime.
+ * `query.aggregate` (Phase 6), `query.select` (Phase 7), `search.vector`
+ * (Phase 8), and `query.join` (Phase 13a — chunked classic-API fan-out)
+ * are wired; `realtime.listen` will be added in a later phase once the
+ * matching backend method exists. `query.dml` stays unwired because the
+ * classic Query API has no server-side DML statement; mass-delete /
+ * mass-update are still routed through the existing `bulkRemoveEdges`
+ * fetch-then-write loop.
+ */
+
+/**
+ * Capability union declared by the Firestore Standard backend.
+ *
+ * Conservative declaration: only capabilities backed by an actual runtime
+ * method are listed. `query.aggregate` (Phase 6) and `query.select`
+ * (Phase 7) are now wired; `search.vector` and `realtime.listen` will be
+ * layered in by their respective phases — this union and the matching
+ * cap-set literal are updated in lockstep.
+ */
+type FirestoreStandardCapability = 'core.read' | 'core.write' | 'core.transactions' | 'core.batch' | 'core.subgraph' | 'query.aggregate' | 'query.select' | 'query.join' | 'search.vector' | 'raw.firestore';
+interface FirestoreStandardOptions {
+    /** Internal: the logical scope path inherited from a parent subgraph. */
+    scopePath?: string;
+}
+/**
+ * Create a Firestore Standard-edition `StorageBackend`.
+ *
+ * Standard Firestore does not support pipelines or any Enterprise-only
+ * features. `data.*` filters require composite indexes; callers that mostly
+ * filter on built-in fields (`aUid`, `axbType`, `bUid`) avoid that
+ * requirement.
+ */
+declare function createFirestoreStandardBackend(db: Firestore, collectionPath: string, options?: FirestoreStandardOptions): StorageBackend<FirestoreStandardCapability>;
+
+export { type FirestoreStandardCapability, type FirestoreStandardOptions, createFirestoreStandardBackend };

package/dist/firestore-standard/index.js

@@ -0,0 +1,283 @@
+import {
+  bulkRemoveEdges,
+  createBatchAdapter,
+  createFirestoreAdapter,
+  createTransactionAdapter,
+  removeNodeCascade,
+  runFirestoreAggregate,
+  runFirestoreClassicExpand,
+  runFirestoreFindEdgesProjected,
+  runFirestoreFindNearest
+} from "../chunk-PAD7WFFU.js";
+import {
+  deserializeFirestoreTypes
+} from "../chunk-C2QMD7RY.js";
+import {
+  createCapabilities
+} from "../chunk-N5HFDWQX.js";
+import {
+  META_EDGE_TYPE,
+  META_NODE_TYPE,
+  buildEdgeQueryPlan,
+  createGraphClient,
+  createMergedRegistry,
+  createRegistry,
+  generateId
+} from "../chunk-WRTFC5NG.js";
+import {
+  FiregraphError,
+  assertSafePath,
+  assertUpdatePayloadExclusive
+} from "../chunk-TK64DNVK.js";
+import "../chunk-EQJUUVFG.js";
+
+// src/firestore-standard/backend.ts
+import { FieldValue } from "@google-cloud/firestore";
+var STANDARD_CAPS = /* @__PURE__ */ new Set([
+  "core.read",
+  "core.write",
+  "core.transactions",
+  "core.batch",
+  "core.subgraph",
+  "query.aggregate",
+  "query.select",
+  "query.join",
+  "search.vector",
+  "raw.firestore"
+]);
+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);
+  } 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) {
+    out.v = update.v;
+  }
+  return out;
+}
+function stampWritableRecord(record) {
+  const now = FieldValue.serverTimestamp();
+  const out = {
+    aType: record.aType,
+    aUid: record.aUid,
+    axbType: record.axbType,
+    bType: record.bType,
+    bUid: record.bUid,
+    data: record.data,
+    createdAt: now,
+    updatedAt: now
+  };
+  if (record.v !== void 0) out.v = record.v;
+  return out;
+}
+var FirestoreStandardTransactionBackend = class {
+  constructor(adapter, db) {
+    this.adapter = adapter;
+    this.db = db;
+  }
+  getDoc(docId) {
+    return this.adapter.getDoc(docId);
+  }
+  query(filters, options) {
+    return this.adapter.query(filters, options);
+  }
+  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));
+  }
+  async deleteDoc(docId) {
+    this.adapter.deleteDoc(docId);
+  }
+};
+var FirestoreStandardBatchBackend = class {
+  constructor(adapter, db) {
+    this.adapter = adapter;
+    this.db = db;
+  }
+  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));
+  }
+  deleteDoc(docId) {
+    this.adapter.deleteDoc(docId);
+  }
+  commit() {
+    return this.adapter.commit();
+  }
+};
+var FirestoreStandardBackendImpl = class _FirestoreStandardBackendImpl {
+  constructor(db, collectionPath, scopePath) {
+    this.db = db;
+    this.collectionPath = collectionPath;
+    this.scopePath = scopePath;
+    this.adapter = createFirestoreAdapter(db, collectionPath);
+  }
+  capabilities = createCapabilities(STANDARD_CAPS);
+  collectionPath;
+  scopePath;
+  adapter;
+  // --- Reads ---
+  getDoc(docId) {
+    return this.adapter.getDoc(docId);
+  }
+  query(filters, options) {
+    return this.adapter.query(filters, options);
+  }
+  // --- Writes ---
+  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));
+  }
+  deleteDoc(docId) {
+    return this.adapter.deleteDoc(docId);
+  }
+  // --- Transactions / Batches ---
+  runTransaction(fn) {
+    return this.db.runTransaction(async (firestoreTx) => {
+      const txAdapter = createTransactionAdapter(this.db, this.collectionPath, firestoreTx);
+      return fn(new FirestoreStandardTransactionBackend(txAdapter, this.db));
+    });
+  }
+  createBatch() {
+    const batchAdapter = createBatchAdapter(this.db, this.collectionPath);
+    return new FirestoreStandardBatchBackend(batchAdapter, this.db);
+  }
+  // --- Subgraphs ---
+  subgraph(parentNodeUid, name) {
+    const subPath = `${this.collectionPath}/${parentNodeUid}/${name}`;
+    const newScope = this.scopePath ? `${this.scopePath}/${name}` : name;
+    return new _FirestoreStandardBackendImpl(this.db, subPath, newScope);
+  }
+  // --- Cascade & bulk ---
+  removeNodeCascade(uid, reader, options) {
+    return removeNodeCascade(this.db, this.collectionPath, reader, uid, options);
+  }
+  bulkRemoveEdges(params, reader, options) {
+    return bulkRemoveEdges(this.db, this.collectionPath, reader, params, options);
+  }
+  // --- Cross-collection ---
+  async findEdgesGlobal(params, collectionName) {
+    const name = collectionName ?? this.collectionPath.split("/").pop();
+    const plan = buildEdgeQueryPlan(params);
+    if (plan.strategy === "get") {
+      throw new FiregraphError(
+        "findEdgesGlobal() requires a query, not a direct document lookup. Omit one of aUid/axbType/bUid to force a query strategy.",
+        "INVALID_QUERY"
+      );
+    }
+    const collectionGroupRef = this.db.collectionGroup(name);
+    let q = collectionGroupRef;
+    for (const f of plan.filters) {
+      q = q.where(f.field, f.op, f.value);
+    }
+    if (plan.options?.orderBy) {
+      q = q.orderBy(plan.options.orderBy.field, plan.options.orderBy.direction ?? "asc");
+    }
+    if (plan.options?.limit !== void 0) {
+      q = q.limit(plan.options.limit);
+    }
+    const snap = await q.get();
+    return snap.docs.map((doc) => doc.data());
+  }
+  // --- Aggregate ---
+  aggregate(spec, filters) {
+    return runFirestoreAggregate(this.db.collection(this.collectionPath), spec, filters, {
+      edition: "standard"
+    });
+  }
+  // --- Server-side projection (capability: query.select) ---
+  /**
+   * Run a projecting query via the shared classic-API helper. Both Firestore
+   * editions delegate to one implementation so the projection contract
+   * (bare-name normalization, builtin / `data.*` resolution, dedup,
+   * original-key preservation) stays consistent across editions. See
+   * `runFirestoreFindEdgesProjected` for the resolution rules.
+   */
+  findEdgesProjected(select, filters, options) {
+    return runFirestoreFindEdgesProjected(
+      this.db.collection(this.collectionPath),
+      select,
+      filters,
+      options
+    );
+  }
+  // --- Native vector / nearest-neighbour search (capability: search.vector) ---
+  /**
+   * Run a vector / nearest-neighbour query via the shared classic-API
+   * helper. Both Firestore editions delegate to one implementation so the
+   * field-path normalisation and result shape stay consistent across
+   * editions. See `runFirestoreFindNearest` for the resolution rules and
+   * the validation surface.
+   *
+   * Standard-edition note: vector search requires a single-field vector
+   * index on the indexed `vectorField`, plus a composite index whenever
+   * additional `where` filters narrow the candidate set before the ANN
+   * walk. Both indexes are configured per project in the Firestore
+   * console — firegraph does not auto-provision them.
+   */
+  findNearest(params) {
+    return runFirestoreFindNearest(this.db.collection(this.collectionPath), params);
+  }
+  // --- Server-side multi-source fan-out (capability: query.join) ---
+  /**
+   * Fan out from `params.sources` over a single edge type via the chunked
+   * classic-API helper. The classic `'in'` operator caps at 30 elements
+   * per call, so the helper splits sources into 30-element chunks and
+   * dispatches them in parallel via `Promise.all`. With 100 sources this
+   * is `ceil(100/30) = 4` round trips; the per-source `findEdges` loop in
+   * `traverse.ts` would have been 100. Enterprise can collapse this
+   * further to a single Pipelines `equalAny(...)` call — Standard cannot,
+   * so chunked classic is the best Standard can do.
+   *
+   * The helper applies a cross-chunk re-sort + total-limit slice so the
+   * observable contract matches the SQL backends'
+   * `WHERE … IN (?,?,…) ORDER BY … LIMIT N` semantics.
+   */
+  expand(params) {
+    return runFirestoreClassicExpand(this.adapter, params);
+  }
+};
+function createFirestoreStandardBackend(db, collectionPath, options = {}) {
+  const scopePath = options.scopePath ?? "";
+  return new FirestoreStandardBackendImpl(db, collectionPath, scopePath);
+}
+export {
+  META_EDGE_TYPE,
+  META_NODE_TYPE,
+  createFirestoreStandardBackend,
+  createGraphClient,
+  createMergedRegistry,
+  createRegistry,
+  generateId
+};
+//# sourceMappingURL=index.js.map

package/dist/firestore-standard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/firestore-standard/backend.ts"],"sourcesContent":["/**\n * Firestore Standard edition `StorageBackend`.\n *\n * The Standard edition only has the classic Query API — pipelines and\n * Enterprise-only product features (full-text search, geo) are not\n * available. This file deliberately does not import the pipeline adapter so\n * a Standard-only deployment never pulls Pipeline code into its bundle.\n *\n * Capability declarations follow the conservative invariant established in\n * Phase 1: only declare what the file actually implements at runtime.\n * `query.aggregate` (Phase 6), `query.select` (Phase 7), `search.vector`\n * (Phase 8), and `query.join` (Phase 13a — chunked classic-API fan-out)\n * are wired; `realtime.listen` will be added in a later phase once the\n * matching backend method exists. `query.dml` stays unwired because the\n * classic Query API has no server-side DML statement; mass-delete /\n * mass-update are still routed through the existing `bulkRemoveEdges`\n * fetch-then-write loop.\n */\n\nimport type { Firestore, Query, Transaction } from '@google-cloud/firestore';\nimport { FieldValue } from '@google-cloud/firestore';\n\nimport {\n  bulkRemoveEdges as bulkRemoveEdgesImpl,\n  removeNodeCascade as removeNodeCascadeImpl,\n} from '../bulk.js';\nimport { FiregraphError } from '../errors.js';\nimport type {\n  BackendCapabilities,\n  BatchBackend,\n  StorageBackend,\n  TransactionBackend,\n  UpdatePayload,\n  WritableRecord,\n  WriteMode,\n} from '../internal/backend.js';\nimport { createCapabilities } from '../internal/backend.js';\nimport { runFirestoreAggregate } from '../internal/firestore-aggregate.js';\nimport type {\n  BatchAdapter,\n  FirestoreAdapter,\n  TransactionAdapter,\n} from '../internal/firestore-classic-adapter.js';\nimport {\n  createBatchAdapter,\n  createFirestoreAdapter,\n  createTransactionAdapter,\n} from '../internal/firestore-classic-adapter.js';\nimport { runFirestoreClassicExpand } from '../internal/firestore-classic-expand.js';\nimport { runFirestoreFindEdgesProjected } from '../internal/firestore-projection.js';\nimport { runFirestoreFindNearest } from '../internal/firestore-vector.js';\nimport type { DataPathOp } from '../internal/write-plan.js';\nimport { assertSafePath, assertUpdatePayloadExclusive } from '../internal/write-plan.js';\nimport { buildEdgeQueryPlan } from '../query.js';\nimport { deserializeFirestoreTypes } from '../serialization.js';\nimport type {\n  AggregateSpec,\n  BulkOptions,\n  BulkResult,\n  CascadeResult,\n  ExpandParams,\n  ExpandResult,\n  FindEdgesParams,\n  FindNearestParams,\n  GraphReader,\n  QueryFilter,\n  QueryOptions,\n  StoredGraphRecord,\n} from '../types.js';\n\n/**\n * Capability union declared by the Firestore Standard backend.\n *\n * Conservative declaration: only capabilities backed by an actual runtime\n * method are listed. `query.aggregate` (Phase 6) and `query.select`\n * (Phase 7) are now wired; `search.vector` and `realtime.listen` will be\n * layered in by their respective phases — this union and the matching\n * cap-set literal are updated in lockstep.\n */\nexport type FirestoreStandardCapability =\n  | 'core.read'\n  | 'core.write'\n  | 'core.transactions'\n  | 'core.batch'\n  | 'core.subgraph'\n  | 'query.aggregate'\n  | 'query.select'\n  | 'query.join'\n  | 'search.vector'\n  | 'raw.firestore';\n\nconst STANDARD_CAPS: ReadonlySet<FirestoreStandardCapability> =\n  new Set<FirestoreStandardCapability>([\n    'core.read',\n    'core.write',\n    'core.transactions',\n    'core.batch',\n    'core.subgraph',\n    'query.aggregate',\n    'query.select',\n    'query.join',\n    'search.vector',\n    'raw.firestore',\n  ]);\n\nexport interface FirestoreStandardOptions {\n  /** Internal: the logical scope path inherited from a parent subgraph. */\n  scopePath?: string;\n}\n\n/** Build a `data.a.b.c` dotted path for Firestore's `update()` API. */\nfunction dottedDataPath(op: DataPathOp): string {\n  assertSafePath(op.path);\n  return `data.${op.path.join('.')}`;\n}\n\nfunction buildFirestoreUpdate(update: UpdatePayload, db: Firestore): Record<string, unknown> {\n  assertUpdatePayloadExclusive(update);\n  const out: Record<string, unknown> = {\n    updatedAt: FieldValue.serverTimestamp(),\n  };\n  if (update.replaceData) {\n    out.data = deserializeFirestoreTypes(update.replaceData, db);\n  } else if (update.dataOps) {\n    for (const op of update.dataOps) {\n      const key = dottedDataPath(op);\n      out[key] = op.delete ? FieldValue.delete() : op.value;\n    }\n  }\n  if (update.v !== undefined) {\n    out.v = update.v;\n  }\n  return out;\n}\n\nfunction stampWritableRecord(record: WritableRecord): Record<string, unknown> {\n  const now = FieldValue.serverTimestamp();\n  const out: Record<string, unknown> = {\n    aType: record.aType,\n    aUid: record.aUid,\n    axbType: record.axbType,\n    bType: record.bType,\n    bUid: record.bUid,\n    data: record.data,\n    createdAt: now,\n    updatedAt: now,\n  };\n  if (record.v !== undefined) out.v = record.v;\n  return out;\n}\n\nclass FirestoreStandardTransactionBackend implements TransactionBackend {\n  constructor(\n    private readonly adapter: TransactionAdapter,\n    private readonly db: Firestore,\n  ) {}\n\n  getDoc(docId: string): Promise<StoredGraphRecord | null> {\n    return this.adapter.getDoc(docId);\n  }\n\n  query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]> {\n    return this.adapter.query(filters, options);\n  }\n\n  async setDoc(docId: string, record: WritableRecord, mode: WriteMode): Promise<void> {\n    this.adapter.setDoc(\n      docId,\n      stampWritableRecord(record),\n      mode === 'merge' ? { merge: true } : undefined,\n    );\n  }\n\n  async updateDoc(docId: string, update: UpdatePayload): Promise<void> {\n    this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));\n  }\n\n  async deleteDoc(docId: string): Promise<void> {\n    this.adapter.deleteDoc(docId);\n  }\n}\n\nclass FirestoreStandardBatchBackend implements BatchBackend {\n  constructor(\n    private readonly adapter: BatchAdapter,\n    private readonly db: Firestore,\n  ) {}\n\n  setDoc(docId: string, record: WritableRecord, mode: WriteMode): void {\n    this.adapter.setDoc(\n      docId,\n      stampWritableRecord(record),\n      mode === 'merge' ? { merge: true } : undefined,\n    );\n  }\n\n  updateDoc(docId: string, update: UpdatePayload): void {\n    this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));\n  }\n\n  deleteDoc(docId: string): void {\n    this.adapter.deleteDoc(docId);\n  }\n\n  commit(): Promise<void> {\n    return this.adapter.commit();\n  }\n}\n\nclass FirestoreStandardBackendImpl implements StorageBackend<FirestoreStandardCapability> {\n  readonly capabilities: BackendCapabilities<FirestoreStandardCapability> =\n    createCapabilities(STANDARD_CAPS);\n  readonly collectionPath: string;\n  readonly scopePath: string;\n  private readonly adapter: FirestoreAdapter;\n\n  constructor(\n    private readonly db: Firestore,\n    collectionPath: string,\n    scopePath: string,\n  ) {\n    this.collectionPath = collectionPath;\n    this.scopePath = scopePath;\n    this.adapter = createFirestoreAdapter(db, collectionPath);\n  }\n\n  // --- Reads ---\n\n  getDoc(docId: string): Promise<StoredGraphRecord | null> {\n    return this.adapter.getDoc(docId);\n  }\n\n  query(filters: QueryFilter[], options?: QueryOptions): Promise<StoredGraphRecord[]> {\n    return this.adapter.query(filters, options);\n  }\n\n  // --- Writes ---\n\n  setDoc(docId: string, record: WritableRecord, mode: WriteMode): Promise<void> {\n    return this.adapter.setDoc(\n      docId,\n      stampWritableRecord(record),\n      mode === 'merge' ? { merge: true } : undefined,\n    );\n  }\n\n  updateDoc(docId: string, update: UpdatePayload): Promise<void> {\n    return this.adapter.updateDoc(docId, buildFirestoreUpdate(update, this.db));\n  }\n\n  deleteDoc(docId: string): Promise<void> {\n    return this.adapter.deleteDoc(docId);\n  }\n\n  // --- Transactions / Batches ---\n\n  runTransaction<T>(fn: (tx: TransactionBackend) => Promise<T>): Promise<T> {\n    return this.db.runTransaction(async (firestoreTx: Transaction) => {\n      const txAdapter = createTransactionAdapter(this.db, this.collectionPath, firestoreTx);\n      return fn(new FirestoreStandardTransactionBackend(txAdapter, this.db));\n    });\n  }\n\n  createBatch(): BatchBackend {\n    const batchAdapter = createBatchAdapter(this.db, this.collectionPath);\n    return new FirestoreStandardBatchBackend(batchAdapter, this.db);\n  }\n\n  // --- Subgraphs ---\n\n  subgraph(parentNodeUid: string, name: string): StorageBackend {\n    const subPath = `${this.collectionPath}/${parentNodeUid}/${name}`;\n    const newScope = this.scopePath ? `${this.scopePath}/${name}` : name;\n    return new FirestoreStandardBackendImpl(this.db, subPath, newScope);\n  }\n\n  // --- Cascade & bulk ---\n\n  removeNodeCascade(\n    uid: string,\n    reader: GraphReader,\n    options?: BulkOptions,\n  ): Promise<CascadeResult> {\n    return removeNodeCascadeImpl(this.db, this.collectionPath, reader, uid, options);\n  }\n\n  bulkRemoveEdges(\n    params: FindEdgesParams,\n    reader: GraphReader,\n    options?: BulkOptions,\n  ): Promise<BulkResult> {\n    return bulkRemoveEdgesImpl(this.db, this.collectionPath, reader, params, options);\n  }\n\n  // --- Cross-collection ---\n\n  async findEdgesGlobal(\n    params: FindEdgesParams,\n    collectionName?: string,\n  ): Promise<StoredGraphRecord[]> {\n    const name = collectionName ?? this.collectionPath.split('/').pop()!;\n    const plan = buildEdgeQueryPlan(params);\n\n    if (plan.strategy === 'get') {\n      throw new FiregraphError(\n        'findEdgesGlobal() requires a query, not a direct document lookup. ' +\n          'Omit one of aUid/axbType/bUid to force a query strategy.',\n        'INVALID_QUERY',\n      );\n    }\n\n    const collectionGroupRef = this.db.collectionGroup(name);\n    let q: Query = collectionGroupRef;\n    for (const f of plan.filters) {\n      q = q.where(f.field, f.op, f.value);\n    }\n    if (plan.options?.orderBy) {\n      q = q.orderBy(plan.options.orderBy.field, plan.options.orderBy.direction ?? 'asc');\n    }\n    if (plan.options?.limit !== undefined) {\n      q = q.limit(plan.options.limit);\n    }\n    const snap = await q.get();\n    return snap.docs.map((doc) => doc.data() as StoredGraphRecord);\n  }\n\n  // --- Aggregate ---\n\n  aggregate(spec: AggregateSpec, filters: QueryFilter[]): Promise<Record<string, number>> {\n    return runFirestoreAggregate(this.db.collection(this.collectionPath), spec, filters, {\n      edition: 'standard',\n    });\n  }\n\n  // --- Server-side projection (capability: query.select) ---\n\n  /**\n   * Run a projecting query via the shared classic-API helper. Both Firestore\n   * editions delegate to one implementation so the projection contract\n   * (bare-name normalization, builtin / `data.*` resolution, dedup,\n   * original-key preservation) stays consistent across editions. See\n   * `runFirestoreFindEdgesProjected` for the resolution rules.\n   */\n  findEdgesProjected(\n    select: ReadonlyArray<string>,\n    filters: QueryFilter[],\n    options?: QueryOptions,\n  ): Promise<Array<Record<string, unknown>>> {\n    return runFirestoreFindEdgesProjected(\n      this.db.collection(this.collectionPath),\n      select,\n      filters,\n      options,\n    );\n  }\n\n  // --- Native vector / nearest-neighbour search (capability: search.vector) ---\n\n  /**\n   * Run a vector / nearest-neighbour query via the shared classic-API\n   * helper. Both Firestore editions delegate to one implementation so the\n   * field-path normalisation and result shape stay consistent across\n   * editions. See `runFirestoreFindNearest` for the resolution rules and\n   * the validation surface.\n   *\n   * Standard-edition note: vector search requires a single-field vector\n   * index on the indexed `vectorField`, plus a composite index whenever\n   * additional `where` filters narrow the candidate set before the ANN\n   * walk. Both indexes are configured per project in the Firestore\n   * console — firegraph does not auto-provision them.\n   */\n  findNearest(params: FindNearestParams): Promise<StoredGraphRecord[]> {\n    return runFirestoreFindNearest(this.db.collection(this.collectionPath), params);\n  }\n\n  // --- Server-side multi-source fan-out (capability: query.join) ---\n\n  /**\n   * Fan out from `params.sources` over a single edge type via the chunked\n   * classic-API helper. The classic `'in'` operator caps at 30 elements\n   * per call, so the helper splits sources into 30-element chunks and\n   * dispatches them in parallel via `Promise.all`. With 100 sources this\n   * is `ceil(100/30) = 4` round trips; the per-source `findEdges` loop in\n   * `traverse.ts` would have been 100. Enterprise can collapse this\n   * further to a single Pipelines `equalAny(...)` call — Standard cannot,\n   * so chunked classic is the best Standard can do.\n   *\n   * The helper applies a cross-chunk re-sort + total-limit slice so the\n   * observable contract matches the SQL backends'\n   * `WHERE … IN (?,?,…) ORDER BY … LIMIT N` semantics.\n   */\n  expand(params: ExpandParams): Promise<ExpandResult> {\n    return runFirestoreClassicExpand(this.adapter, params);\n  }\n}\n\n/**\n * Create a Firestore Standard-edition `StorageBackend`.\n *\n * Standard Firestore does not support pipelines or any Enterprise-only\n * features. `data.*` filters require composite indexes; callers that mostly\n * filter on built-in fields (`aUid`, `axbType`, `bUid`) avoid that\n * requirement.\n */\nexport function createFirestoreStandardBackend(\n  db: Firestore,\n  collectionPath: string,\n  options: FirestoreStandardOptions = {},\n): StorageBackend<FirestoreStandardCapability> {\n  const scopePath = options.scopePath ?? '';\n  return new FirestoreStandardBackendImpl(db, collectionPath, scopePath);\n}\n"],"mappings":"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","names":[]}