@typicalday/firegraph 0.15.0 → 0.16.1

package/dist/index.d.cts

@@ -1,10 +1,10 @@
-export { c as createGraphClient, a as createGraphClientFromBackend } from './client-BGHwxwPg.cjs';
+export { c as createGraphClient, a as createGraphClientFromBackend } from './client-CaXH5D5C.cjs';
 export { CodegenOptions, generateTypes } from './codegen/index.cjs';
-import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, v as StoredGraphRecord, H as MigrationWriteBack, K as MigrationStep, p as GraphRegistry, F as FindEdgesParams, L as QueryPlan, N as FindNodesParams, Q as QueryFilter, M as MigrationExecutor, O as MigrationFn, P as StoredMigrationStep, o as GraphClient, q as GraphReader, V as TraversalBuilder } from './backend-BpYLdwCW.cjs';
-export { w as AggregateExtension, x as AggregateField, y as AggregateOp, z as AggregateResult, A as AggregateSpec, X as BulkBatchError, t as BulkOptions, Y as BulkProgress, u as BulkResult, b as BulkUpdatePatch, C as Capability, s as CascadeResult, Z as CoreGraphClient, _ as DefineTypeOptions, $ as DiscoveredEntity, a0 as DistanceMeasure, d as DmlExtension, n as DynamicGraphClient, a1 as DynamicGraphMethods, m as DynamicRegistryConfig, a2 as EdgeTopology, a3 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a4 as FindEdgesProjectedParams, a5 as FindNearestParams, a6 as FiregraphConfig, a7 as FullTextSearchExtension, a8 as GeoExtension, a9 as GraphBatch, G as GraphClientOptions, aa as GraphRecord, ab as GraphTransaction, ac as GraphWriter, ad as HopDefinition, ae as HopResult, af as IndexFieldSpec, J as JoinExtension, ag as NodeTypeData, ah as ProjectedRow, ai as QueryMode, r 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-BpYLdwCW.cjs';
+import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, v as StoredGraphRecord, H as MigrationWriteBack, K as MigrationStep, p as GraphRegistry, F as FindEdgesParams, L as QueryPlan, N as FindNodesParams, Q as QueryFilter, M as MigrationExecutor, O as MigrationFn, P as StoredMigrationStep, o as GraphClient, q as GraphReader, V as TraversalBuilder } from './backend-DNzv8KSR.cjs';
+export { w as AggregateExtension, x as AggregateField, y as AggregateOp, z as AggregateResult, A as AggregateSpec, X as BulkBatchError, t as BulkOptions, Y as BulkProgress, u as BulkResult, b as BulkUpdatePatch, C as Capability, s as CascadeResult, Z as CoreGraphClient, _ as DefineTypeOptions, $ as DiscoveredEntity, a0 as DistanceMeasure, d as DmlExtension, n as DynamicGraphClient, a1 as DynamicGraphMethods, m as DynamicRegistryConfig, a2 as EdgeTopology, a3 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a4 as FindEdgesProjectedParams, a5 as FindNearestParams, a6 as FiregraphConfig, a7 as FullTextSearchExtension, a8 as GeoExtension, a9 as GraphBatch, G as GraphClientOptions, aa as GraphRecord, ab as GraphTransaction, ac as GraphWriter, ad as HopDefinition, ae as HopResult, af as IndexFieldSpec, J as JoinExtension, ag as NodeTypeData, ah as ProjectedRow, ai as QueryMode, r 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-DNzv8KSR.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, d as createBootstrapRegistry, c as createMergedRegistry, b as createRegistry, e as createRegistryFromGraph, f as generateDeterministicUid, g as generateId } from './registry-BGh7Jqpb.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, d as createBootstrapRegistry, c as createMergedRegistry, b as createRegistry, e as createRegistryFromGraph, f as generateDeterministicUid, g as generateId } from './registry-CNToyEra.cjs';
 export { Q as QueryClient, f as QueryClientError, g as QueryClientErrorCode, h as QueryClientOptions } from './client-DoyEdJ5w.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';

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { c as createGraphClient, a as createGraphClientFromBackend } from './client-B5o39X79.js';
+export { c as createGraphClient, a as createGraphClientFromBackend } from './client-CNAwJayO.js';
 export { CodegenOptions, generateTypes } from './codegen/index.js';
-import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, v as StoredGraphRecord, H as MigrationWriteBack, K as MigrationStep, p as GraphRegistry, F as FindEdgesParams, L as QueryPlan, N as FindNodesParams, Q as QueryFilter, M as MigrationExecutor, O as MigrationFn, P as StoredMigrationStep, o as GraphClient, q as GraphReader, V as TraversalBuilder } from './backend-BpYLdwCW.js';
-export { w as AggregateExtension, x as AggregateField, y as AggregateOp, z as AggregateResult, A as AggregateSpec, X as BulkBatchError, t as BulkOptions, Y as BulkProgress, u as BulkResult, b as BulkUpdatePatch, C as Capability, s as CascadeResult, Z as CoreGraphClient, _ as DefineTypeOptions, $ as DiscoveredEntity, a0 as DistanceMeasure, d as DmlExtension, n as DynamicGraphClient, a1 as DynamicGraphMethods, m as DynamicRegistryConfig, a2 as EdgeTopology, a3 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a4 as FindEdgesProjectedParams, a5 as FindNearestParams, a6 as FiregraphConfig, a7 as FullTextSearchExtension, a8 as GeoExtension, a9 as GraphBatch, G as GraphClientOptions, aa as GraphRecord, ab as GraphTransaction, ac as GraphWriter, ad as HopDefinition, ae as HopResult, af as IndexFieldSpec, J as JoinExtension, ag as NodeTypeData, ah as ProjectedRow, ai as QueryMode, r 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-BpYLdwCW.js';
+import { I as IndexSpec, l as DiscoveryResult, R as RegistryEntry, v as StoredGraphRecord, H as MigrationWriteBack, K as MigrationStep, p as GraphRegistry, F as FindEdgesParams, L as QueryPlan, N as FindNodesParams, Q as QueryFilter, M as MigrationExecutor, O as MigrationFn, P as StoredMigrationStep, o as GraphClient, q as GraphReader, V as TraversalBuilder } from './backend-DNzv8KSR.js';
+export { w as AggregateExtension, x as AggregateField, y as AggregateOp, z as AggregateResult, A as AggregateSpec, X as BulkBatchError, t as BulkOptions, Y as BulkProgress, u as BulkResult, b as BulkUpdatePatch, C as Capability, s as CascadeResult, Z as CoreGraphClient, _ as DefineTypeOptions, $ as DiscoveredEntity, a0 as DistanceMeasure, d as DmlExtension, n as DynamicGraphClient, a1 as DynamicGraphMethods, m as DynamicRegistryConfig, a2 as EdgeTopology, a3 as EdgeTypeData, E as ExpandParams, e as ExpandResult, a4 as FindEdgesProjectedParams, a5 as FindNearestParams, a6 as FiregraphConfig, a7 as FullTextSearchExtension, a8 as GeoExtension, a9 as GraphBatch, G as GraphClientOptions, aa as GraphRecord, ab as GraphTransaction, ac as GraphWriter, ad as HopDefinition, ae as HopResult, af as IndexFieldSpec, J as JoinExtension, ag as NodeTypeData, ah as ProjectedRow, ai as QueryMode, r 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-DNzv8KSR.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, d as createBootstrapRegistry, c as createMergedRegistry, b as createRegistry, e as createRegistryFromGraph, f as generateDeterministicUid, g as generateId } from './registry-tKTb5Kx1.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, d as createBootstrapRegistry, c as createMergedRegistry, b as createRegistry, e as createRegistryFromGraph, f as generateDeterministicUid, g as generateId } from './registry-By1i-zge.js';
 export { Q as QueryClient, f as QueryClientError, g as QueryClientErrorCode, h as QueryClientOptions } from './client-DoyEdJ5w.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';

package/dist/index.js

@@ -51,7 +51,7 @@ import {
   migrateRecords,
   precompileSource,
   validateMigrationChain
-} from "./chunk-5HIRYV2S.js";
+} from "./chunk-6IO74NKD.js";
 import {
   DEFAULT_QUERY_LIMIT,
   computeEdgeDocId,

package/dist/{registry-tKTb5Kx1.d.ts → registry-By1i-zge.d.ts}

@@ -1,4 +1,4 @@
-import { R as RegistryEntry, p as GraphRegistry, q as GraphReader, M as MigrationExecutor, l as DiscoveryResult } from './backend-BpYLdwCW.js';
+import { R as RegistryEntry, p as GraphRegistry, q as GraphReader, M as MigrationExecutor, l as DiscoveryResult } from './backend-DNzv8KSR.js';
 
 /** The aType used for node type definition meta-nodes. */
 declare const META_NODE_TYPE = "nodeType";

package/dist/{registry-BGh7Jqpb.d.cts → registry-CNToyEra.d.cts}

@@ -1,4 +1,4 @@
-import { R as RegistryEntry, p as GraphRegistry, q as GraphReader, M as MigrationExecutor, l as DiscoveryResult } from './backend-BpYLdwCW.cjs';
+import { R as RegistryEntry, p as GraphRegistry, q as GraphReader, M as MigrationExecutor, l as DiscoveryResult } from './backend-DNzv8KSR.cjs';
 
 /** The aType used for node type definition meta-nodes. */
 declare const META_NODE_TYPE = "nodeType";

package/dist/sqlite/index.cjs

@@ -2048,7 +2048,7 @@ var GraphClientImpl = class _GraphClientImpl {
   async findNearest(params) {
     if (!this.backend.findNearest) {
       throw new FiregraphError(
-        "findNearest() is not supported by the current storage backend. Vector search requires a backend that declares `search.vector` (currently Firestore Standard and Enterprise). There is no client-side fallback because emulating ANN on top of the generic backend surface does not scale beyond toy datasets.",
+        "findNearest() is not supported by the current storage backend. Vector search requires a backend that declares `search.vector` (currently Firestore Standard, Firestore Enterprise, and the local better-sqlite3 backend). There is no client-side fallback because emulating ANN on top of the generic backend surface does not scale beyond toy datasets.",
         "UNSUPPORTED_OPERATION"
       );
     }
@@ -2064,13 +2064,15 @@ var GraphClientImpl = class _GraphClientImpl {
    * Native full-text search (capability `search.fullText`).
    *
    * Returns the top-N records by relevance, ordered by the search
-   * index's score. Only Firestore Enterprise declares this capability
-   * today — the underlying Pipelines `search({ query: documentMatches(...) })`
-   * stage requires Enterprise's FTS index. Standard does not declare
-   * the cap (FTS is an Enterprise-only product feature, not a
-   * typed-API gap), and the SQLite-shaped backends have no native
-   * FTS index. Backends without `search.fullText` throw
-   * `UNSUPPORTED_OPERATION` from this wrapper.
+   * index's score. Firestore Enterprise declares this capability (via
+   * the Pipelines `search({ query: documentMatches(...) })` stage over
+   * Enterprise's FTS index), as does the local better-sqlite3 backend
+   * (`firegraph/sqlite-local`, via a trigger-synced FTS5 index ranked
+   * by `bm25()`). Standard does not declare the cap (FTS is an
+   * Enterprise-only product feature, not a typed-API gap); D1 and the
+   * Cloudflare DO edition have no FTS trigger infrastructure. Backends
+   * without `search.fullText` throw `UNSUPPORTED_OPERATION` from this
+   * wrapper.
    *
    * Scan-protection mirrors `findNearest`: a search with no
    * identifying filters (`aType` / `axbType` / `bType`) walks every
@@ -2086,7 +2088,7 @@ var GraphClientImpl = class _GraphClientImpl {
   async fullTextSearch(params) {
     if (!this.backend.fullTextSearch) {
       throw new FiregraphError(
-        "fullTextSearch() is not supported by the current storage backend. Full-text search requires a backend that declares `search.fullText` (currently Firestore Enterprise only \u2014 FTS is an Enterprise product feature). There is no client-side fallback because emulating FTS over the generic backend surface would not scale beyond toy datasets.",
+        "fullTextSearch() is not supported by the current storage backend. Full-text search requires a backend that declares `search.fullText` (currently Firestore Enterprise and the local better-sqlite3 backend). There is no client-side fallback because emulating FTS over the generic backend surface would not scale beyond toy datasets.",
         "UNSUPPORTED_OPERATION"
       );
     }
@@ -3299,7 +3301,7 @@ var SQLITE_CORE_CAPS = [
   "raw.sql"
 ];
 var SqliteBackendImpl = class _SqliteBackendImpl {
-  constructor(executor, rootTable, storageScope, scopePath, registry, coreIndexes) {
+  constructor(executor, rootTable, storageScope, scopePath, registry, coreIndexes, extraTableDDL) {
     this.executor = executor;
     validateTableName(rootTable);
     this.rootTable = rootTable;
@@ -3308,6 +3310,7 @@ var SqliteBackendImpl = class _SqliteBackendImpl {
     this.scopePath = scopePath;
     this.registry = registry;
     this.coreIndexes = coreIndexes;
+    this.extraTableDDL = extraTableDDL;
     const caps = new Set(SQLITE_CORE_CAPS);
     if (typeof executor.transaction === "function") {
       caps.add("core.transactions");
@@ -3324,6 +3327,7 @@ var SqliteBackendImpl = class _SqliteBackendImpl {
   rootTable;
   registry;
   coreIndexes;
+  extraTableDDL;
   ensured = null;
   /**
    * Lazily create this graph's table + indexes + the catalog, and register
@@ -3340,12 +3344,18 @@ var SqliteBackendImpl = class _SqliteBackendImpl {
     }
     return this.ensured;
   }
+  /** @internal See `SqliteStorageBackend.ensureReady`. */
+  async ensureReady(force = false) {
+    if (force) this.ensured = null;
+    await this.ensureSchema();
+  }
   async doEnsureSchema() {
     const ddl = [
       ...buildSchemaStatements(this.collectionPath, {
         coreIndexes: this.coreIndexes,
         registry: this.registry
       }),
+      ...this.extraTableDDL ? this.extraTableDDL(this.collectionPath) : [],
       buildCatalogDDL(this.rootTable)
     ];
     const statements = ddl.map((sql) => ({ sql, params: [] }));
@@ -3476,7 +3486,8 @@ var SqliteBackendImpl = class _SqliteBackendImpl {
       newStorageScope,
       newScope,
       this.registry,
-      this.coreIndexes
+      this.coreIndexes,
+      this.extraTableDDL
     );
   }
   // --- Cascade & bulk ---
@@ -3822,7 +3833,8 @@ function createSqliteBackend(executor, tableName, options = {}) {
     storageScope,
     scopePath,
     options.registry,
-    options.coreIndexes
+    options.coreIndexes,
+    options.extraTableDDL
   );
 }
 // Annotate the CommonJS export names for ESM import in node: