@aigne/afs-index 1.12.0-beta.5

package/dist/backend/sqlite-backend.d.cts

@@ -0,0 +1,96 @@
+import { CursorRow, CursorScopeRegistration, IndexBackend, IndexedDocumentWrite, RemoveIndexOptions } from "./types.cjs";
+import { Anchor, AnchorData, AnchorQuery, AnchorResult, CombinedResult, EntryFilter, FTSResult, IndexedEntry, QueryOpts, StaleFilter, VectorResult } from "../types.cjs";
+import { KeyGeneratorRegistry } from "../keys/registry.cjs";
+
+//#region src/backend/sqlite-backend.d.ts
+declare class SQLiteIndexBackend implements IndexBackend {
+  private afs;
+  private sqliteProvider;
+  private readonly dbUrl;
+  private keyRegistry;
+  private readonly ftsTokenizer;
+  private readonly scope;
+  private embeddingDimension;
+  private initialized;
+  constructor(dbUrl?: string, keyRegistry?: KeyGeneratorRegistry, opts?: {
+    ftsTokenizer?: string;
+    scope?: string;
+  });
+  /** See `IndexBackend.setKeyRegistry` — wires an injected backend to the provider's shared registry. */
+  setKeyRegistry(registry: KeyGeneratorRegistry): void;
+  private get mountPath();
+  private tableAction;
+  /**
+   * Idempotent (design.md §4.4 addendum, owner decision 2026-07-05): a
+   * caller that needs the backend usable BEFORE any `AFSIndex` action runs
+   * (e.g. `initCursor` at follower-registration time — see daemon.ts /
+   * cf-session-view.ts) must call this explicitly; `AFSIndex.ensureInitialized()`
+   * ALSO calls it unconditionally on the first real action. Without the
+   * guard, that second call re-mounted a BRAND NEW `SQLiteAFS`/connection —
+   * for a `:memory:` db this silently discarded everything the first
+   * connection had written (caught by the Node/CF parity test's in-memory
+   * backend); for a file-backed db it "only" leaked an extra connection.
+   */
+  initialize(): Promise<void>;
+  private registerCustomActions;
+  readCursor(consumerId: string): Promise<CursorRow | null>;
+  writeCursor(consumerId: string, lastSeq: number, watermarks?: Record<string, number>): Promise<void>;
+  markCursorServed(consumerId: string): Promise<void>;
+  initCursor(consumerId: string, registration?: {
+    instanceDid?: string;
+    domainsJson?: string;
+  }): Promise<void>;
+  listCursorScopes(consumerId: string): Promise<CursorScopeRegistration[]>;
+  close(): Promise<void>;
+  writeEntry(entry: IndexedEntry): Promise<void>;
+  writeIndexedDocument(document: IndexedDocumentWrite): Promise<void>;
+  private entryToRow;
+  getEntry(path: string): Promise<IndexedEntry | null>;
+  removeEntry(path: string): Promise<void>;
+  removeIndexedDocument(path: string, opts?: RemoveIndexOptions): Promise<void>;
+  listEntries(filter: EntryFilter): Promise<IndexedEntry[]>;
+  markStale(filter: StaleFilter): Promise<number>;
+  countEntries(filter: EntryFilter): Promise<number>;
+  writeAnchors(path: string, anchors: Anchor[]): Promise<void>;
+  queryAnchors(query: AnchorQuery): Promise<AnchorResult[]>;
+  removeAnchors(path: string): Promise<void>;
+  getAnchorData(path: string): Promise<AnchorData[]>;
+  writeSummary(path: string, summary: string): Promise<void>;
+  getSummary(path: string): Promise<string | null>;
+  queryFTS(text: string, limit?: number, metaFilter?: Record<string, unknown>, opts?: {
+    domain?: string;
+    domains?: string[];
+    scope?: string;
+    pathPrefix?: string;
+  }): Promise<FTSResult[]>;
+  removeSummary(path: string): Promise<void>;
+  writeEmbedding(path: string, embedding: number[]): Promise<void>;
+  queryVector(embedding: number[], limit?: number, opts?: {
+    domain?: string;
+    domains?: string[];
+    scope?: string;
+    pathPrefix?: string;
+  }): Promise<VectorResult[]>;
+  removeEmbedding(path: string): Promise<void>;
+  embeddingCapability(): {
+    supported: boolean;
+    dimension: number;
+  };
+  writeEntriesBatch(entries: IndexedEntry[]): Promise<void>;
+  writeAnchorsBatch(items: {
+    path: string;
+    anchors: Anchor[];
+  }[]): Promise<void>;
+  writeSummariesBatch(items: {
+    path: string;
+    summary: string;
+  }[]): Promise<void>;
+  purgeEntries(paths: string[], opts?: RemoveIndexOptions): Promise<number>;
+  queryCombined(keys: {
+    type: string;
+    values: string[];
+  }[], text?: string, opts?: QueryOpts): Promise<CombinedResult[]>;
+}
+//#endregion
+export { SQLiteIndexBackend };
+//# sourceMappingURL=sqlite-backend.d.cts.map

package/dist/backend/sqlite-backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-backend.d.cts","names":[],"sources":["../../src/backend/sqlite-backend.ts"],"mappings":";;;;;cA0Ca,kBAAA,YAA8B,YAAA;EAAA,QACjC,GAAA;EAAA,QACA,cAAA;EAAA,iBACS,KAAA;EAAA,QACT,WAAA;EAAA,iBACS,YAAA;EAAA,iBAMA,KAAA;EAAA,QACT,kBAAA;EAAA,QACA,WAAA;cAGN,KAAA,WACA,WAAA,GAAc,oBAAA,EACd,IAAA;IAAQ,YAAA;IAAuB,KAAA;EAAA;EAq5B9B;EA54BH,cAAA,CAAe,QAAA,EAAU,oBAAA;EAAA,YAIb,SAAA,CAAA;EAAA,QAIJ,WAAA;EA85BgB;;;;;;;;;;;EA/4BlB,UAAA,CAAA,GAAc,OAAA;EAAA,QAmBZ,qBAAA;EAs0BF,UAAA,CAAW,UAAA,WAAqB,OAAA,CAAQ,SAAA;EAOxC,WAAA,CACJ,UAAA,UACA,OAAA,UACA,UAAA,GAAa,MAAA,mBACZ,OAAA;EAQG,gBAAA,CAAiB,UAAA,WAAqB,OAAA;EAMtC,UAAA,CACJ,UAAA,UACA,YAAA;IAAiB,WAAA;IAAsB,WAAA;EAAA,IACtC,OAAA;EAQG,gBAAA,CAAiB,UAAA,WAAqB,OAAA,CAAQ,uBAAA;EAW9C,KAAA,CAAA,GAAS,OAAA;EAOT,UAAA,CAAW,KAAA,EAAO,YAAA,GAAe,OAAA;EAOjC,oBAAA,CAAqB,QAAA,EAAU,oBAAA,GAAuB,OAAA;EAAA,QAwBpD,UAAA;EAiBF,QAAA,CAAS,IAAA,WAAe,OAAA,CAAQ,YAAA;EAWhC,WAAA,CAAY,IAAA,WAAe,OAAA;EAM3B,qBAAA,CAAsB,IAAA,UAAc,IAAA,GAAO,kBAAA,GAAqB,OAAA;EAIhE,WAAA,CAAY,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,YAAA;EAmB1C,SAAA,CAAU,MAAA,EAAQ,WAAA,GAAc,OAAA;EAuChC,YAAA,CAAa,MAAA,EAAQ,WAAA,GAAc,OAAA;EAcnC,YAAA,CAAa,IAAA,UAAc,OAAA,EAAS,MAAA,KAAW,OAAA;EAuB/C,YAAA,CAAa,KAAA,EAAO,WAAA,GAAc,OAAA,CAAQ,YAAA;EAkD1C,aAAA,CAAc,IAAA,WAAe,OAAA;EAS7B,aAAA,CAAc,IAAA,WAAe,OAAA,CAAQ,UAAA;EAgBrC,YAAA,CAAa,IAAA,UAAc,OAAA,WAAkB,OAAA;EAQ7C,UAAA,CAAW,IAAA,WAAe,OAAA;EAS1B,QAAA,CACJ,IAAA,UACA,KAAA,WACA,UAAA,GAAa,MAAA,mBACb,IAAA;IAAS,MAAA;IAAiB,OAAA;IAAoB,KAAA;IAAgB,UAAA;EAAA,IAC7D,OAAA,CAAQ,SAAA;EAiCL,aAAA,CAAc,IAAA,WAAe,OAAA;EAS7B,cAAA,CAAe,IAAA,UAAc,SAAA,aAAsB,OAAA;EAWnD,WAAA,CACJ,SAAA,YACA,KAAA,WACA,IAAA;IAAS,MAAA;IAAiB,OAAA;IAAoB,KAAA;IAAgB,UAAA;EAAA,IAC7D,OAAA,CAAQ,YAAA;EAsCL,eAAA,CAAgB,IAAA,WAAe,OAAA;EAOrC,mBAAA,CAAA;IAAyB,SAAA;IAAoB,SAAA;EAAA;EAMvC,iBAAA,CAAkB,OAAA,EAAS,YAAA,KAAiB,OAAA;EAO5C,iBAAA,CAAkB,KAAA;IAAS,IAAA;IAAc,OAAA,EAAS,MAAA;EAAA,MAAe,OAAA;EAyBjE,mBAAA,CAAoB,KAAA;IAAS,IAAA;IAAc,OAAA;EAAA,MAAsB,OAAA;EAQjE,YAAA,CAAa,KAAA,YAAiB,IAAA,GAAO,kBAAA,GAAqB,OAAA;EAa1D,aAAA,CACJ,IAAA;IAAQ,IAAA;IAAc,MAAA;EAAA,KACtB,IAAA,WACA,IAAA,GAAO,SAAA,GACN,OAAA,CAAQ,cAAA;AAAA"}

package/dist/backend/sqlite-backend.d.mts

@@ -0,0 +1,96 @@
+import { CursorRow, CursorScopeRegistration, IndexBackend, IndexedDocumentWrite, RemoveIndexOptions } from "./types.mjs";
+import { Anchor, AnchorData, AnchorQuery, AnchorResult, CombinedResult, EntryFilter, FTSResult, IndexedEntry, QueryOpts, StaleFilter, VectorResult } from "../types.mjs";
+import { KeyGeneratorRegistry } from "../keys/registry.mjs";
+
+//#region src/backend/sqlite-backend.d.ts
+declare class SQLiteIndexBackend implements IndexBackend {
+  private afs;
+  private sqliteProvider;
+  private readonly dbUrl;
+  private keyRegistry;
+  private readonly ftsTokenizer;
+  private readonly scope;
+  private embeddingDimension;
+  private initialized;
+  constructor(dbUrl?: string, keyRegistry?: KeyGeneratorRegistry, opts?: {
+    ftsTokenizer?: string;
+    scope?: string;
+  });
+  /** See `IndexBackend.setKeyRegistry` — wires an injected backend to the provider's shared registry. */
+  setKeyRegistry(registry: KeyGeneratorRegistry): void;
+  private get mountPath();
+  private tableAction;
+  /**
+   * Idempotent (design.md §4.4 addendum, owner decision 2026-07-05): a
+   * caller that needs the backend usable BEFORE any `AFSIndex` action runs
+   * (e.g. `initCursor` at follower-registration time — see daemon.ts /
+   * cf-session-view.ts) must call this explicitly; `AFSIndex.ensureInitialized()`
+   * ALSO calls it unconditionally on the first real action. Without the
+   * guard, that second call re-mounted a BRAND NEW `SQLiteAFS`/connection —
+   * for a `:memory:` db this silently discarded everything the first
+   * connection had written (caught by the Node/CF parity test's in-memory
+   * backend); for a file-backed db it "only" leaked an extra connection.
+   */
+  initialize(): Promise<void>;
+  private registerCustomActions;
+  readCursor(consumerId: string): Promise<CursorRow | null>;
+  writeCursor(consumerId: string, lastSeq: number, watermarks?: Record<string, number>): Promise<void>;
+  markCursorServed(consumerId: string): Promise<void>;
+  initCursor(consumerId: string, registration?: {
+    instanceDid?: string;
+    domainsJson?: string;
+  }): Promise<void>;
+  listCursorScopes(consumerId: string): Promise<CursorScopeRegistration[]>;
+  close(): Promise<void>;
+  writeEntry(entry: IndexedEntry): Promise<void>;
+  writeIndexedDocument(document: IndexedDocumentWrite): Promise<void>;
+  private entryToRow;
+  getEntry(path: string): Promise<IndexedEntry | null>;
+  removeEntry(path: string): Promise<void>;
+  removeIndexedDocument(path: string, opts?: RemoveIndexOptions): Promise<void>;
+  listEntries(filter: EntryFilter): Promise<IndexedEntry[]>;
+  markStale(filter: StaleFilter): Promise<number>;
+  countEntries(filter: EntryFilter): Promise<number>;
+  writeAnchors(path: string, anchors: Anchor[]): Promise<void>;
+  queryAnchors(query: AnchorQuery): Promise<AnchorResult[]>;
+  removeAnchors(path: string): Promise<void>;
+  getAnchorData(path: string): Promise<AnchorData[]>;
+  writeSummary(path: string, summary: string): Promise<void>;
+  getSummary(path: string): Promise<string | null>;
+  queryFTS(text: string, limit?: number, metaFilter?: Record<string, unknown>, opts?: {
+    domain?: string;
+    domains?: string[];
+    scope?: string;
+    pathPrefix?: string;
+  }): Promise<FTSResult[]>;
+  removeSummary(path: string): Promise<void>;
+  writeEmbedding(path: string, embedding: number[]): Promise<void>;
+  queryVector(embedding: number[], limit?: number, opts?: {
+    domain?: string;
+    domains?: string[];
+    scope?: string;
+    pathPrefix?: string;
+  }): Promise<VectorResult[]>;
+  removeEmbedding(path: string): Promise<void>;
+  embeddingCapability(): {
+    supported: boolean;
+    dimension: number;
+  };
+  writeEntriesBatch(entries: IndexedEntry[]): Promise<void>;
+  writeAnchorsBatch(items: {
+    path: string;
+    anchors: Anchor[];
+  }[]): Promise<void>;
+  writeSummariesBatch(items: {
+    path: string;
+    summary: string;
+  }[]): Promise<void>;
+  purgeEntries(paths: string[], opts?: RemoveIndexOptions): Promise<number>;
+  queryCombined(keys: {
+    type: string;
+    values: string[];
+  }[], text?: string, opts?: QueryOpts): Promise<CombinedResult[]>;
+}
+//#endregion
+export { SQLiteIndexBackend };
+//# sourceMappingURL=sqlite-backend.d.mts.map

package/dist/backend/sqlite-backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-backend.d.mts","names":[],"sources":["../../src/backend/sqlite-backend.ts"],"mappings":";;;;;cA0Ca,kBAAA,YAA8B,YAAA;EAAA,QACjC,GAAA;EAAA,QACA,cAAA;EAAA,iBACS,KAAA;EAAA,QACT,WAAA;EAAA,iBACS,YAAA;EAAA,iBAMA,KAAA;EAAA,QACT,kBAAA;EAAA,QACA,WAAA;cAGN,KAAA,WACA,WAAA,GAAc,oBAAA,EACd,IAAA;IAAQ,YAAA;IAAuB,KAAA;EAAA;EAq5B9B;EA54BH,cAAA,CAAe,QAAA,EAAU,oBAAA;EAAA,YAIb,SAAA,CAAA;EAAA,QAIJ,WAAA;EA85BgB;;;;;;;;;;;EA/4BlB,UAAA,CAAA,GAAc,OAAA;EAAA,QAmBZ,qBAAA;EAs0BF,UAAA,CAAW,UAAA,WAAqB,OAAA,CAAQ,SAAA;EAOxC,WAAA,CACJ,UAAA,UACA,OAAA,UACA,UAAA,GAAa,MAAA,mBACZ,OAAA;EAQG,gBAAA,CAAiB,UAAA,WAAqB,OAAA;EAMtC,UAAA,CACJ,UAAA,UACA,YAAA;IAAiB,WAAA;IAAsB,WAAA;EAAA,IACtC,OAAA;EAQG,gBAAA,CAAiB,UAAA,WAAqB,OAAA,CAAQ,uBAAA;EAW9C,KAAA,CAAA,GAAS,OAAA;EAOT,UAAA,CAAW,KAAA,EAAO,YAAA,GAAe,OAAA;EAOjC,oBAAA,CAAqB,QAAA,EAAU,oBAAA,GAAuB,OAAA;EAAA,QAwBpD,UAAA;EAiBF,QAAA,CAAS,IAAA,WAAe,OAAA,CAAQ,YAAA;EAWhC,WAAA,CAAY,IAAA,WAAe,OAAA;EAM3B,qBAAA,CAAsB,IAAA,UAAc,IAAA,GAAO,kBAAA,GAAqB,OAAA;EAIhE,WAAA,CAAY,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,YAAA;EAmB1C,SAAA,CAAU,MAAA,EAAQ,WAAA,GAAc,OAAA;EAuChC,YAAA,CAAa,MAAA,EAAQ,WAAA,GAAc,OAAA;EAcnC,YAAA,CAAa,IAAA,UAAc,OAAA,EAAS,MAAA,KAAW,OAAA;EAuB/C,YAAA,CAAa,KAAA,EAAO,WAAA,GAAc,OAAA,CAAQ,YAAA;EAkD1C,aAAA,CAAc,IAAA,WAAe,OAAA;EAS7B,aAAA,CAAc,IAAA,WAAe,OAAA,CAAQ,UAAA;EAgBrC,YAAA,CAAa,IAAA,UAAc,OAAA,WAAkB,OAAA;EAQ7C,UAAA,CAAW,IAAA,WAAe,OAAA;EAS1B,QAAA,CACJ,IAAA,UACA,KAAA,WACA,UAAA,GAAa,MAAA,mBACb,IAAA;IAAS,MAAA;IAAiB,OAAA;IAAoB,KAAA;IAAgB,UAAA;EAAA,IAC7D,OAAA,CAAQ,SAAA;EAiCL,aAAA,CAAc,IAAA,WAAe,OAAA;EAS7B,cAAA,CAAe,IAAA,UAAc,SAAA,aAAsB,OAAA;EAWnD,WAAA,CACJ,SAAA,YACA,KAAA,WACA,IAAA;IAAS,MAAA;IAAiB,OAAA;IAAoB,KAAA;IAAgB,UAAA;EAAA,IAC7D,OAAA,CAAQ,YAAA;EAsCL,eAAA,CAAgB,IAAA,WAAe,OAAA;EAOrC,mBAAA,CAAA;IAAyB,SAAA;IAAoB,SAAA;EAAA;EAMvC,iBAAA,CAAkB,OAAA,EAAS,YAAA,KAAiB,OAAA;EAO5C,iBAAA,CAAkB,KAAA;IAAS,IAAA;IAAc,OAAA,EAAS,MAAA;EAAA,MAAe,OAAA;EAyBjE,mBAAA,CAAoB,KAAA;IAAS,IAAA;IAAc,OAAA;EAAA,MAAsB,OAAA;EAQjE,YAAA,CAAa,KAAA,YAAiB,IAAA,GAAO,kBAAA,GAAqB,OAAA;EAa1D,aAAA,CACJ,IAAA;IAAQ,IAAA;IAAc,MAAA;EAAA,KACtB,IAAA,WACA,IAAA,GAAO,SAAA,GACN,OAAA,CAAQ,cAAA;AAAA"}