@minnowdb/core 0.8.0 → 0.9.1

package/dist/storage/opfs/leader.d.ts

@@ -1,460 +0,0 @@
-import { type BeginTransactionInput, type BeginTransactionResult, type CloseSnapshotExportInput, type CancelSnapshotImportInput, type InterruptedSnapshotImportAbortResult, type AbortTransactionIfExpiredInput, type AdoptAbortedSegmentInput, type RenewTransactionInput, type CommitTransactionInput, type CompactionJobRecord, type CompactionJobRecordUpdate, type CreateGarbageCollectionJobInput, type UpdateGarbageCollectionPlanningInput, type DropTableColumnInput, type DropTableInput, type FtsCandidates, type FtsPostingQuery, type FtsPosting, type GarbageCollectionJobRecord, type GarbageCollectionStepResult, type LeaseRecord, type MoveLeaseInput, type ManifestSummary, type ManifestBlockPage, type ListManifestBlockPageInput, type ListRetiredManifestBlockPageInput, type RollbackTransactionArtifactsInput, type RenewLeaseInput, type RenewTempOwnerInput, type RunGarbageCollectionStepInput, type SegmentRecord, type StageTransactionArtifactsInput, type StoragePage, type StorageIntegrityMode, type StorageIntegrityReport, type StorageStats, type CatalogMutationOptions, type TableRecord, type TableRecordUpdate, type TempOwnerRecord, type TempRunPage, type TransactionRecord, type TransactionRecordUpdate, type WriteTransactionInput, type BeginUniqueKeyBuildInput, type RenewUniqueKeyBuildInput, type AppendUniqueKeyBuildChunkInput, type FinishUniqueKeyBuildInput, type AbortUniqueKeyBuildInput, type BeginPostingBuildInput, type RenewPostingBuildInput, type AppendPostingBuildChunkInput, type FinishPostingBuildInput, type AbortPostingBuildInput, type BeginSnapshotFrameExportInput, type BeginSnapshotFrameImportInput, type ReadSnapshotExportFrameInput, type RenewSnapshotFrameImportInput, type AppendSnapshotImportFramesInput, type FinishSnapshotFrameImportInput, type SnapshotFrame, type SnapshotFrameExportSession, type SnapshotFrameImportSession, type SnapshotFrameKind, type SnapshotFrameStreamHeader } from "../types.js";
-import { OpfsTree } from "./files.js";
-import { type Placement } from "../toolkit/extents.js";
-/** A failed checkpoint may defer compaction, but the recovery log itself stays bounded. */
-export declare const MAX_OPFS_WAL_BYTES: number;
-export declare const MAX_OPFS_CHECKPOINT_BYTES: number;
-interface IdPlacement {
-    id: string;
-    placement: Placement;
-}
-interface BlockRelocation {
-    id: string;
-    from: Placement;
-    placement: Placement;
-}
-interface FtsChunkRelocation {
-    key: string;
-    ordinal: number;
-    from: Placement;
-    placement: Placement;
-}
-interface FtsBuildChunkRelocation extends FtsChunkRelocation {
-    buildId: string;
-}
-interface FtsBasePointer {
-    coversVersion: number;
-    totalTokens: number;
-    chunks: Placement[];
-    chunkBounds: Array<{
-        first: string;
-        last: string;
-    }>;
-}
-interface TempPageLedgerRecord {
-    ownerId: string;
-    runId: string;
-    pageIndex: number;
-    length: number;
-}
-interface SnapshotFrameExportState {
-    sessionId: string;
-    ownerId: string;
-    createdAt: string;
-    expiresAt: string;
-    leaseRevision: number;
-    manifestVersion: number;
-    header: SnapshotFrameStreamHeader;
-    ledgerId: string;
-    ledgerLength: number;
-    metadataFrameCount: number;
-    nextSequence: number;
-    metadataOffset: number;
-    blockCursor: string | null;
-    lastSequence: number | null;
-    lastMetadataOffset: number | null;
-    lastBlockId: string | null;
-}
-interface SnapshotFrameObservedState {
-    frameCount: number;
-    itemCount: number;
-    storedBytes: number;
-}
-interface SnapshotFrameImportState {
-    identity: string;
-    ownerId: string;
-    version: number;
-    createdAt: string;
-    expiresAt: string;
-    header: SnapshotFrameStreamHeader;
-    ledgerId: string;
-    ledgerLength: number;
-    nextSequence: number;
-    stagedBytes: number;
-    blockCount: number;
-    blockBytes: number;
-    checksum: number;
-    currentKindIndex: number;
-    observed: Record<SnapshotFrameKind, SnapshotFrameObservedState>;
-    lastBatchStartSequence: number | null;
-    lastBatchOffset: number | null;
-    lastBatchFrameCount: number;
-    completedReplay: boolean;
-}
-type WalEntryBody = {
-    op: "relocatePayloads";
-    blocks: BlockRelocation[];
-    ftsChunks: FtsChunkRelocation[];
-    ftsBuildChunks: FtsBuildChunkRelocation[];
-} | {
-    op: "addTable";
-    record: TableRecord;
-    expectedCatalogEpoch: number | null;
-} | {
-    op: "updateTable";
-    id: string;
-    expectedRevision: number;
-    update: TableRecordUpdate;
-} | {
-    op: "removeTable";
-    id: string;
-    expectedRevision: number;
-    expectedCatalogEpoch: number | null;
-} | {
-    op: "dropTable";
-    input: DropTableInput;
-} | {
-    op: "dropTableColumn";
-    input: DropTableColumnInput;
-} | {
-    op: "removeFtsColumn";
-    tableId: string;
-    columnId: string;
-} | {
-    op: "removeAbortedSegment";
-    id: string;
-    expectedTransactionId: string;
-} | {
-    op: "adoptAbortedSegment";
-    input: AdoptAbortedSegmentInput;
-} | {
-    op: "reserveRowIds";
-    tableId: string;
-    count: number;
-} | {
-    op: "beginUniqueKeyBuild";
-    input: BeginUniqueKeyBuildInput;
-} | {
-    op: "renewUniqueKeyBuild";
-    input: RenewUniqueKeyBuildInput;
-} | {
-    op: "appendUniqueKeyBuildChunk";
-    input: AppendUniqueKeyBuildChunkInput;
-} | {
-    op: "finishUniqueKeyBuild";
-    input: FinishUniqueKeyBuildInput;
-} | {
-    op: "abortUniqueKeyBuild";
-    input: AbortUniqueKeyBuildInput;
-} | {
-    op: "reserveAutoIncrement";
-    tableId: string;
-    columnId: string;
-    count: number;
-    atLeast?: bigint;
-} | {
-    op: "beginTransaction";
-    input: BeginTransactionInput;
-} | {
-    op: "createTransaction";
-    record: TransactionRecord;
-} | {
-    op: "renewTransaction";
-    input: RenewTransactionInput;
-} | {
-    op: "abortTransactionIfExpired";
-    input: AbortTransactionIfExpiredInput;
-} | {
-    op: "updateTransaction";
-    id: string;
-    expectedRevision: number;
-    update: TransactionRecordUpdate;
-} | {
-    op: "stageTransactionArtifacts";
-    transactionId: string;
-    expectedRevision: number;
-    blocks: IdPlacement[];
-    segments: SegmentRecord[];
-    updatedAt: string;
-} | {
-    op: "rollbackTransactionArtifacts";
-    input: RollbackTransactionArtifactsInput;
-} | {
-    op: "commitTransaction";
-    input: CommitTransactionInput;
-} | {
-    op: "writeTransaction";
-    input: Omit<WriteTransactionInput, "blocks">;
-    blocks: IdPlacement[];
-} | {
-    op: "createLease";
-    record: LeaseRecord;
-} | {
-    op: "renewLease";
-    input: RenewLeaseInput;
-} | {
-    op: "moveLease";
-    input: MoveLeaseInput;
-} | {
-    op: "removeLeaseIfExpired";
-    id: string;
-    expectedRevision: number;
-    expiresAtCutoff: string;
-} | {
-    op: "removeLease";
-    input: {
-        id: string;
-        ownerId: string;
-    };
-} | {
-    op: "createCompactionJob";
-    record: CompactionJobRecord;
-} | {
-    op: "updateCompactionJob";
-    id: string;
-    expectedRevision: number;
-    update: CompactionJobRecordUpdate;
-} | {
-    op: "cancelCompactionJob";
-    id: string;
-    expectedRevision: number;
-    cancelledAt: string;
-} | {
-    op: "removeCompactionJob";
-    id: string;
-} | {
-    op: "createGarbageCollectionJob";
-    input: CreateGarbageCollectionJobInput;
-} | {
-    op: "updateGarbageCollectionPlanning";
-    input: UpdateGarbageCollectionPlanningInput;
-} | {
-    op: "garbageCollectionStep";
-    effect: {
-        job: GarbageCollectionJobRecord;
-        prunedManifestVersions: number[];
-        reclaimedSegmentIds: string[];
-        reclaimedBlockIds: string[];
-        reclaimedTransactionIds: string[];
-        updatedAt: string;
-    };
-} | {
-    op: "removeGarbageCollectionJob";
-    id: string;
-} | {
-    op: "removePrunedManifestRecords";
-    maxItems: number;
-} | {
-    op: "createTempOwner";
-    record: TempOwnerRecord;
-} | {
-    op: "renewTempOwner";
-    input: RenewTempOwnerInput;
-} | {
-    op: "removeTempOwnerIfExpired";
-    ownerId: string;
-    expiresAtCutoff: string;
-} | {
-    op: "removeTempOwner";
-    ownerId: string;
-} | {
-    op: "reserveTempRunPages";
-    pages: TempPageLedgerRecord[];
-} | {
-    op: "restoreTempRunPages";
-    pages: Array<Omit<TempPageLedgerRecord, "length"> & {
-        length: number | null;
-    }>;
-} | {
-    op: "removeTempRun";
-    ownerId: string;
-    runId: string;
-} | {
-    op: "writeFtsBase";
-    tableId: string;
-    columnId: string;
-    pointer: FtsBasePointer;
-} | {
-    op: "beginFtsBaseBuild";
-    input: BeginPostingBuildInput;
-} | {
-    op: "renewFtsBaseBuild";
-    input: RenewPostingBuildInput;
-} | {
-    op: "writeFtsBaseBuildChunk";
-    input: Omit<AppendPostingBuildChunkInput, "chunk">;
-    placement: Placement;
-    bounds: {
-        first: string;
-        last: string;
-    };
-    totalTokens: number;
-    retainedEntries: number;
-} | {
-    op: "finishFtsBaseBuild";
-    input: FinishPostingBuildInput;
-} | {
-    op: "abortFtsBaseBuild";
-    input: AbortPostingBuildInput;
-} | {
-    op: "beginSnapshotFrameExport";
-    state: SnapshotFrameExportState;
-} | {
-    op: "advanceSnapshotFrameExport";
-    input: ReadSnapshotExportFrameInput;
-    expectedLeaseRevision: number;
-    next: Pick<SnapshotFrameExportState, "nextSequence" | "metadataOffset" | "blockCursor" | "lastSequence" | "lastMetadataOffset" | "lastBlockId">;
-} | {
-    op: "closeSnapshotFrameExport";
-    input: CloseSnapshotExportInput;
-} | {
-    op: "beginSnapshotFrameImport";
-    state: SnapshotFrameImportState;
-} | {
-    op: "renewSnapshotFrameImport";
-    input: RenewSnapshotFrameImportInput;
-} | {
-    op: "appendSnapshotImportFrames";
-    input: RenewSnapshotFrameImportInput;
-    state: Omit<SnapshotFrameImportState, "header">;
-    blockPlacements: IdPlacement[];
-    replay: boolean;
-} | {
-    op: "finishSnapshotFrameImport";
-    input: FinishSnapshotFrameImportInput;
-} | {
-    op: "cancelSnapshotFrameImport";
-    input: CancelSnapshotImportInput;
-};
-declare const CORE_READ_METHODS: readonly ["getTempOwner", "getTable", "getTableByName", "listTables", "getSegment", "listSegmentPage", "listTableSegmentPage", "getExistingUniqueKeys", "getUniqueKeyBuild", "getCurrentManifestVersion", "getCatalogProbe", "getCurrentManifest", "getManifest", "listManifestPage", "listManifestBlockPage", "listRetiredManifestBlockPage", "getTransaction", "getTransactions", "listTransactionPage", "getLease", "listLeases", "listExpiredLeasePage", "getCompactionJob", "listCompactionJobs", "listCompactionJobPage", "getGarbageCollectionJob", "listGarbageCollectionJobs", "listGarbageCollectionJobPage"];
-type CoreReadMethod = (typeof CORE_READ_METHODS)[number];
-declare const LOGGED_BODY_BUILDERS: {
-    readonly createTempOwner: ([record]: unknown[]) => WalEntryBody;
-    readonly renewTempOwner: ([input]: unknown[]) => WalEntryBody;
-    readonly removeAbortedSegment: ([id, expectedTransactionId]: unknown[]) => WalEntryBody;
-    readonly adoptAbortedSegment: ([input]: unknown[]) => WalEntryBody;
-    readonly reserveRowIds: ([tableId, count]: unknown[]) => WalEntryBody;
-    readonly beginUniqueKeyBuild: ([input]: unknown[]) => WalEntryBody;
-    readonly renewUniqueKeyBuild: ([input]: unknown[]) => WalEntryBody;
-    readonly appendUniqueKeyBuildChunk: ([input]: unknown[]) => WalEntryBody;
-    readonly finishUniqueKeyBuild: ([input]: unknown[]) => WalEntryBody;
-    readonly abortUniqueKeyBuild: ([input]: unknown[]) => WalEntryBody;
-    readonly reserveAutoIncrement: ([tableId, columnId, count, atLeast]: unknown[]) => WalEntryBody;
-    readonly createTransaction: ([record]: unknown[]) => WalEntryBody;
-    readonly renewTransaction: ([input]: unknown[]) => WalEntryBody;
-    readonly abortTransactionIfExpired: ([input]: unknown[]) => WalEntryBody;
-    readonly updateTransaction: ([id, expectedRevision, update]: unknown[]) => WalEntryBody;
-    readonly commitTransaction: ([input]: unknown[]) => WalEntryBody;
-    readonly createLease: ([record]: unknown[]) => WalEntryBody;
-    readonly renewLease: ([input]: unknown[]) => WalEntryBody;
-    readonly moveLease: ([input]: unknown[]) => WalEntryBody;
-    readonly removeLeaseIfExpired: ([id, expectedRevision, expiresAtCutoff]: unknown[]) => WalEntryBody;
-    readonly removeLease: ([input]: unknown[]) => WalEntryBody;
-    readonly createCompactionJob: ([record]: unknown[]) => WalEntryBody;
-    readonly updateCompactionJob: ([id, expectedRevision, update]: unknown[]) => WalEntryBody;
-    readonly cancelCompactionJob: ([id, expectedRevision, cancelledAt]: unknown[]) => WalEntryBody;
-    readonly createGarbageCollectionJob: ([input]: unknown[]) => WalEntryBody;
-    readonly updateGarbageCollectionPlanning: ([input]: unknown[]) => WalEntryBody;
-    readonly removeGarbageCollectionJob: ([id]: unknown[]) => WalEntryBody;
-    readonly removePrunedManifestRecords: ([maxItems]: unknown[]) => WalEntryBody;
-};
-type LoggedMethod = keyof typeof LOGGED_BODY_BUILDERS;
-/**
- * The leader: the one instance holding the database's write-ahead log handle, and with it
- * every other handle — checkpoint slots, the tail extent, a small cache of sealed extents.
- *
- * Because the handles are held, every operation's storage cost is a synchronous write or read
- * measured in microseconds, and because leadership is exclusive by the browser's own file
- * lock, the leader's in-memory `RecordCore` is always provably current — there are no
- * freshness probes anywhere. An operation is: validate and mutate the core (synchronously),
- * append one checksummed WAL frame (synchronously), acknowledge. The only awaits sit before
- * that critical section (extent appends that may seal, temp-file IO), so no observer ever
- * sees state mid-mutation.
- *
- * Checkpointing is also synchronous — dump, write to the older of two fixed slots, flush,
- * reset the WAL — which is what makes a single WAL file safe: the flush precedes the reset,
- * and a crash mid-checkpoint corrupts only the slot being written while the other slot plus
- * the un-reset WAL still reconstruct everything.
- */
-export declare class OpfsLeader {
-    #private;
-    private constructor();
-    /** Builds a leader from held handles: newest valid checkpoint slot plus the WAL tail. */
-    static recover(tree: OpfsTree, strict: boolean, handles: {
-        wal: FileSystemSyncAccessHandle;
-        slotA: FileSystemSyncAccessHandle;
-        slotB: FileSystemSyncAccessHandle;
-    }, checkpointEntries?: number, cleanupLimitBytes?: number): Promise<OpfsLeader>;
-    /**
-     * Fully synchronous: publish the same generation to both slots, flush each, then reset.
-     * Therefore corruption of either post-success copy cannot expose an older database.
-     */
-    checkpointNow(): void;
-    getBlock(id: string): Promise<Uint8Array | undefined>;
-    getBlocks(ids: readonly string[]): Promise<Array<Uint8Array | undefined>>;
-    readManifestBlock(version: number | null, id: string): Promise<Uint8Array | undefined>;
-    hasManifestBlocks(version: number | null, ids: readonly string[]): Promise<boolean[]>;
-    listManifestBlockPage(input: ListManifestBlockPageInput): Promise<ManifestBlockPage>;
-    listRetiredManifestBlockPage(input: ListRetiredManifestBlockPageInput): Promise<ManifestBlockPage>;
-    putTempRunPage(page: TempRunPage): Promise<void>;
-    putTempRunPages(pages: readonly TempRunPage[]): Promise<void>;
-    getTempRunPage(ownerId: string, runId: string, pageIndex: number): Promise<Uint8Array | undefined>;
-    removeTempRun(ownerId: string, runId: string): Promise<void>;
-    removeTempOwner(ownerId: string): Promise<void>;
-    removeCompactionJob(id: string): Promise<boolean>;
-    /** @internal Shared implementation installed for direct RecordCore reads below. */
-    _readCoreGenerated(method: CoreReadMethod, args: unknown[]): Promise<unknown>;
-    /** @internal Shared implementation installed for ordinary one-frame mutations below. */
-    _loggedGenerated(method: LoggedMethod, args: unknown[]): Promise<unknown>;
-    removeTempOwnerIfExpired(ownerId: string, expiresAtCutoff: string): Promise<boolean>;
-    listTempOwnerIdsPage(afterOwnerId: string | null, limit: number): Promise<StoragePage<string, string>>;
-    listExpiredTempOwnerPage(expiresAtCutoff: string, afterCursor: string | null, limit: number): Promise<StoragePage<string, string>>;
-    addTable(record: TableRecord, options?: CatalogMutationOptions): Promise<void>;
-    updateTable(id: string, expectedRevision: number, update: TableRecordUpdate): Promise<TableRecord>;
-    removeTable(id: string, expectedRevision: number, options?: CatalogMutationOptions): Promise<void>;
-    dropTable(input: DropTableInput): Promise<ManifestSummary>;
-    dropTableColumn(input: DropTableColumnInput): Promise<ManifestSummary>;
-    removeFtsColumn(tableId: string, columnId: string): Promise<void>;
-    beginTransaction(input: BeginTransactionInput): Promise<BeginTransactionResult>;
-    stageTransactionArtifacts(input: StageTransactionArtifactsInput): Promise<TransactionRecord>;
-    rollbackTransactionArtifacts(input: RollbackTransactionArtifactsInput): Promise<TransactionRecord>;
-    writeTransaction(input: WriteTransactionInput): Promise<ManifestSummary>;
-    runGarbageCollectionStep(input: RunGarbageCollectionStepInput): Promise<GarbageCollectionStepResult>;
-    writeFtsBase(tableId: string, columnId: string, input: {
-        coversVersion: number;
-        chunks: FtsPosting[][];
-        totalTokens: number;
-    }): Promise<void>;
-    beginFtsBaseBuild(input: BeginPostingBuildInput): Promise<void>;
-    renewFtsBaseBuild(input: RenewPostingBuildInput): Promise<void>;
-    writeFtsBaseBuildChunk(input: AppendPostingBuildChunkInput): Promise<void>;
-    finishFtsBaseBuild(input: FinishPostingBuildInput): Promise<void>;
-    abortFtsBaseBuild(input: AbortPostingBuildInput): Promise<void>;
-    readFtsCandidates(tableId: string, columnId: string, terms: readonly FtsPostingQuery[], upToVersion: number, maxRowIds?: number): Promise<FtsCandidates & {
-        deltaChunkCount: number;
-        totalTokens: number;
-        coversVersion: number;
-        hasBase: boolean;
-    }>;
-    readFtsPostings(tableId: string, columnId: string, upToVersion: number, maxRowIds?: number, maxRetainedBytes?: number): Promise<{
-        deltaChunkCount: number;
-        coversVersion: number;
-        hasBase: boolean;
-        postings: FtsPosting[];
-        overflow: boolean;
-    }>;
-    beginSnapshotFrameExport(input: BeginSnapshotFrameExportInput): Promise<SnapshotFrameExportSession>;
-    readSnapshotExportFrame(input: ReadSnapshotExportFrameInput): Promise<SnapshotFrame | undefined>;
-    closeSnapshotFrameExport(input: CloseSnapshotExportInput): Promise<boolean>;
-    beginSnapshotFrameImport(input: BeginSnapshotFrameImportInput): Promise<SnapshotFrameImportSession>;
-    renewSnapshotFrameImport(input: RenewSnapshotFrameImportInput): Promise<SnapshotFrameImportSession>;
-    appendSnapshotImportFrames(input: AppendSnapshotImportFramesInput): Promise<SnapshotFrameImportSession>;
-    finishSnapshotFrameImport(input: FinishSnapshotFrameImportInput): Promise<void>;
-    cancelSnapshotFrameImport(input: CancelSnapshotImportInput): Promise<InterruptedSnapshotImportAbortResult>;
-    /** Live payload bytes plus the control files — what this database logically occupies. */
-    getLogicalStorageBytes(): Promise<number>;
-    getStorageStats(): Promise<StorageStats>;
-    checkIntegrity(options?: {
-        mode?: StorageIntegrityMode;
-        maxIssues?: number;
-    }): Promise<StorageIntegrityReport>;
-    /** Graceful: flush, checkpoint (so the next leader's takeover is instant), release. */
-    shutdown(): Promise<void>;
-    /** Test-only: what tab death does — locks release, nothing is flushed or checkpointed. */
-    crash(): void;
-}
-/** @internal Exact pre-read aggregate limit, exported only for the no-allocation regression. */
-export declare function assertBlockReadBatchByteLimit(placements: ReadonlyArray<{
-    length: number;
-} | undefined>): void;
-export {};

package/dist/storage/opfs/rpc.d.ts

@@ -1,82 +0,0 @@
-/**
- * The follower↔leader message vocabulary. Leadership traffic (`leader`, `ping`, `bid`, `yield`,
- * `released`) travels a `BroadcastChannel` named for the database, which every connection
- * hears. Request traffic is addressed: an `op` is posted into the leader's own channel (named
- * for the database plus the leader's instance id) and its `result` or `busy` into the
- * requester's, so block bytes are cloned once, into the tab that asked, rather than into every
- * tab. Correctness never rides on delivery: an operation is acknowledged only after the
- * leader's write-ahead log holds it. Reads retry after failover; mutations surface an uncertain
- * outcome instead of being executed twice. Leadership is arbitrated by the storage lock, not
- * by these messages.
- */
-export type StoreRpcMessage = 
-/**
- * A follower's operation request. `requestId` doubles as the retry-dedupe key; `from` is the
- * requester's instance id, naming the channel its answer goes to.
- */
-{
-    kind: "op";
-    requestId: string;
-    from: string;
-    method: string;
-    args: unknown[];
-} | {
-    kind: "result";
-    requestId: string;
-    ok: true;
-    value: unknown;
-} | {
-    kind: "result";
-    requestId: string;
-    ok: false;
-    error: SerializedStoreError;
-}
-/** The leader is still executing this request — reset the caller's patience. */
- | {
-    kind: "busy";
-    requestId: string;
-}
-/** The leader exists (sent on takeover and in answer to pings). */
- | {
-    kind: "leader";
-    leaderId: string;
-} | {
-    kind: "ping";
-}
-/** A foreground follower asks the (background) leader to hand over. */
- | {
-    kind: "bid";
-    bidderId: string;
-    foreground: boolean;
-}
-/** The leader has drained and released its handles for this bidder. */
- | {
-    kind: "yield";
-    to: string;
-}
-/** The leader closed or demoted; followers may race for the lock. */
- | {
-    kind: "released";
-    leaderId: string;
-};
-export interface SerializedStoreError {
-    name: string;
-    message: string;
-    /** True for platform exceptions (quota!), whose `instanceof DOMException` must survive. */
-    domException?: boolean;
-    props?: Record<string, unknown>;
-}
-/** One legal maximum payload plus bounded envelope/catalog metadata. */
-export declare const MAX_OPFS_RPC_MESSAGE_BYTES: number;
-export declare const MAX_OPFS_RPC_IDENTIFIER_CHARACTERS = 1024;
-/** Conservative retained/transfer-byte estimate with total depth/cardinality refusal. */
-export declare function estimateRpcValueBytes(value: unknown): number;
-/** Total non-throwing parser for same-origin-but-untrusted BroadcastChannel traffic. */
-export declare function parseStoreRpcMessage(value: unknown, knownMethods: ReadonlySet<string>): StoreRpcMessage | undefined;
-/** Collision-resistant bounded identity; large byte leaves become SHA-256 descriptors. */
-export declare function fingerprintStoreRequest(method: string, args: unknown[]): Promise<{
-    signature: string;
-    retainedBytes: number;
-}>;
-export declare function serializeStoreError(error: unknown): SerializedStoreError;
-export declare function rehydrateStoreError(serialized: SerializedStoreError): Error;

package/dist/storage/opfs/snapshot-ledger.d.ts

@@ -1,41 +0,0 @@
-import { type SnapshotFrame, type SnapshotFrameKind } from "../types.js";
-import { type Placement } from "../toolkit/extents.js";
-import { OpfsTree } from "./files.js";
-type SnapshotLedgerKind = "export" | "import" | "completed";
-interface SnapshotLedgerRecord {
-    readonly sequence: number;
-    readonly kind: SnapshotFrameKind;
-    readonly itemCount: number;
-    readonly key: string | null;
-    readonly payloadLength: number;
-    readonly checksum: number;
-    /** Metadata payloads are inline. Block payloads live once in an extent placement. */
-    readonly payload?: Uint8Array;
-    readonly placement?: Placement;
-}
-export interface SnapshotLedgerRead {
-    readonly record: SnapshotLedgerRecord;
-    readonly offset: number;
-    readonly nextOffset: number;
-}
-export declare function snapshotLedgerPath(kind: SnapshotLedgerKind, id: string): string[];
-/**
- * Checksummed append-only control file for one snapshot session. A checkpoint stores only the
- * committed prefix length. Bytes beyond it are unpublished and truncated on recovery, so a
- * large import/export never creates a database-sized WAL/checkpoint collection.
- */
-export declare class SnapshotFrameLedger {
-    #private;
-    private constructor();
-    static open(tree: OpfsTree, kind: SnapshotLedgerKind, id: string, committedLength: number, create: boolean): Promise<SnapshotFrameLedger>;
-    get byteLength(): number;
-    append(frame: SnapshotFrame, placement?: Placement): SnapshotLedgerRead;
-    read(offset: number, committedLength?: number): SnapshotLedgerRead;
-    records(committedLength?: number): IterableIterator<SnapshotLedgerRead>;
-    flush(): void;
-    truncate(length: number): void;
-    /** Recovery adopts the next WAL-published prefix without copying or re-appending its bytes. */
-    adoptLength(length: number): void;
-    close(): void;
-}
-export {};