Interface EmbedReceiptReader

Database-content-non-mutating authority check over an existing embedding database. Opening and closing do publish then remove private persistence coordination markers; the configured SQLite family remains read-only. Implementations are safe to keep open across awaited vault reads: each validation call starts a fresh read transaction, while every receipt in one batch shares that transaction's SQLite snapshot.

Example

const reader = await openEmbedReceiptReader(file, vault.root);
try {
  reader.currentSourceReceiptMask(receipts);
} finally {
  reader.close();
}

interface EmbedReceiptReader {
    close(): void;
    closeAndRelease(): Promise<void>;
    currentSourceReceiptMask(
        receipts: readonly EmbedSourceReceipt[],
    ): boolean[];
    isCurrentSourceReceipt(
        relPath: string,
        kind: EmbedChunkKind,
        indexedMtimeMs: number,
        indexedRevision: number,
    ): boolean;
}

Index

Methods

close closeAndRelease currentSourceReceiptMask isCurrentSourceReceipt

Methods

close

close(): void
Close the read-only SQLite handle and begin releasing its exact shared semantic-family lifetime. Idempotent. Release rejection is observed internally and retained by the persistence debt registry; callers that need teardown completion or an explicit retry use closeAndRelease.

Returns void
Nothing.
Example
```
reader.close();
```
- Defined in src/embed-db.ts:3506

closeAndRelease

closeAndRelease(): Promise<void>
Close SQLite and await exact shared-lifetime release. A failed release remains retryable through a later invocation against the same ownership handle.

Returns Promise<void>
After both the native handle and shared lease are released.
Example
```
await reader.closeAndRelease();
```
- Defined in src/embed-db.ts:3518

currentSourceReceiptMask

currentSourceReceiptMask(receipts: readonly EmbedSourceReceipt[]): boolean[]
Validate a batch in one synchronous SQLite read snapshot.
Parameters
- receipts: readonly EmbedSourceReceipt[]
  Persisted authority tuples to validate.
Returns boolean[]
A current/stale mask captured atomically, or all false after close.
Throws
If more than 512 receipts are supplied while open.
Example
```
const current = reader.currentSourceReceiptMask(receipts);
```
- Defined in src/embed-db.ts:3493

isCurrentSourceReceipt

isCurrentSourceReceipt(
    relPath: string,
    kind: EmbedChunkKind,
    indexedMtimeMs: number,
    indexedRevision: number,
): boolean
Confirm an exact, non-quarantined source receipt.
Parameters
- relPath: string
  Vault-relative source path.
- kind: EmbedChunkKind
  Content-source kind.
- indexedMtimeMs: number
  Source mtime selected with the persisted bytes.
- indexedRevision: number
  Source authority revision selected with the bytes.
Returns boolean
True only while that exact receipt remains current; false after close.
Example
```
const current = reader.isCurrentSourceReceipt(path, kind, mtimeMs, revision);
```
- Defined in src/embed-db.ts:3476

Interface EmbedReceiptReader

Example

Index

Methods

Methods

close

Returns void

Example

closeAndRelease

Returns Promise<void>

Example

currentSourceReceiptMask

Parameters

Returns boolean[]

Throws

Example

isCurrentSourceReceipt

Parameters

Returns boolean

Example

Settings

On This Page