ramosedb 0.0.1 → 0.4.0

package/dist/internal/transactor/transactor.d.ts

@@ -0,0 +1,209 @@
+import { Connection, type LogEntry, type RootRecord, type Roots, type TxData, Histogram, type WireDatom, RateMeter } from "../core/index.ts";
+import type { CompositionIndex } from "../core/composition.ts";
+import type { Principal } from "../../worker/auth.ts";
+import { R2NodeStore } from "../storage/index.ts";
+import { TransactorDeadError } from "./errors.ts";
+import { type SocketLike, type TransactorHost } from "./host.ts";
+import { TxMetrics } from "./observability.ts";
+import { type RuntimeBoundaries } from "../runtime-boundaries.ts";
+import { type AuthoritativeInvocationResult, type AuthoritativeOperationInvocation, type InstalledCatalogDefinition, type OperationRuntime } from "../authorization/index.ts";
+export { TransactorDeadError };
+export interface TxAck {
+    t: number;
+    txEid: number;
+    tempids: Record<string, number>;
+    datoms: WireDatom[];
+    clientTxId?: string;
+}
+export type OperationAck = AuthoritativeInvocationResult;
+export interface TransactorStats {
+    txs: number;
+    batches: number;
+    maxBatch: number;
+    rejected: number;
+    indexRuns: number;
+    broadcasts: number;
+    commitMs: number;
+    resolveMs: number;
+    loopMs: number;
+    fenceMs: number;
+}
+export declare function clientTxReplayKey(principal: Principal | undefined, id: string): string;
+export declare class Transactor {
+    readonly host: TransactorHost;
+    private readonly operationRuntime?;
+    private readonly boundaries;
+    private ready;
+    private conn;
+    private store;
+    private rootRecord;
+    private logWatermark;
+    private queue;
+    private committing;
+    private indexer;
+    private txSinceIndex;
+    private dead;
+    private readonly recentAcks;
+    readonly stats: TransactorStats;
+    readonly txRate: RateMeter;
+    readonly batchSizes: Histogram;
+    readonly commitLatency: Histogram;
+    readonly resolveLatency: Histogram;
+    readonly loopLatency: Histogram;
+    readonly fenceLatency: Histogram;
+    readonly metrics: TxMetrics;
+    private readonly log;
+    private deployedComposition;
+    constructor(host: TransactorHost, operationRuntime?: OperationRuntime | undefined, boundaries?: RuntimeBoundaries);
+    bindComposition(unitHash: string, index: CompositionIndex): void;
+    init(): Promise<void>;
+    private boot;
+    private getMeta;
+    private setMeta;
+    private appendLogRow;
+    private readInvocationReceipt;
+    private insertInvocationReceipt;
+    private replaceInvocationReceipt;
+    private claimInvocationReceipt;
+    private inspectInvocationReceipt;
+    private recoverInvocationReceipt;
+    private assertClaimIdentity;
+    private finishInvocationReceipt;
+    readLogEntries(from: number, to?: number, limit?: number): LogEntry[];
+    private readLogDatoms;
+    earliestLogT(): number;
+    pruneLog(throughT: number): number;
+    get connection(): Connection;
+    get nodeStore(): R2NodeStore;
+    get bucket(): import("../storage/index.ts").R2Like;
+    get currentRootRecord(): RootRecord;
+    get watermark(): number;
+    get t(): number;
+    get txsSinceIndex(): number;
+    get isDead(): boolean;
+    adoptRoot(rec: RootRecord): void;
+    transact(tx: TxData, principal?: Principal, clientTxId?: string, extras?: {
+        readonly system?: boolean;
+    }): Promise<TxAck>;
+    private replayableMappings;
+    private decideInvocationEpoch;
+    private usesOpaqueHandles;
+    private needsSealingKey;
+    private resolveInvocationTarget;
+    private resolveInvocationInput;
+    invoke(invocation: AuthoritativeOperationInvocation): Promise<OperationAck>;
+    private serialized;
+    private proposalHandler;
+    private get proposalService();
+    private resolveChangesetOperations;
+    retainedRevisionRoots(): Roots[];
+    private changeset;
+    provisionCatalog(definition: InstalledCatalogDefinition): Promise<number>;
+    provision(principal?: Principal): Promise<{
+        eid: number | null;
+        class: string;
+    }>;
+    private rememberAck;
+    private invocationFailureEvent;
+    private takeBatch;
+    private commitLoop;
+    private applyProvision;
+    private authorize;
+    private ackDatoms;
+    private scrub;
+    private die;
+    private broadcast;
+    onSubscribe(ws: SocketLike, from: number): void;
+    onSocketMessage(ws: SocketLike, message: string | ArrayBuffer): void;
+    private sendCatchUp;
+    private alarmQueue;
+    scheduleAlarm(deadline: number): Promise<void>;
+    onAlarm(): Promise<void>;
+    info(): {
+        t: number;
+        root: RootRecord;
+        novelty: number;
+        txsSinceIndex: number;
+        logWatermark: number;
+        earliestLogT: number;
+        nextEid: number;
+        subscribers: number;
+        opts: {
+            timingYields: boolean;
+            maxBatch: number;
+        };
+        stats: TransactorStats;
+        metrics: {
+            enabled: boolean;
+            colo: string;
+            aeWrites: number;
+            aeErrors: number;
+            txPerSec: number;
+            batchSize: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            commitMs: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            avgBatch: number;
+            resolveMs: number;
+            loopMs: number;
+            batchResolveMs: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            batchCommitMs: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            batchLoopMs: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            fenceMs: {
+                count: number;
+                mean: number;
+                p50: number;
+                p95: number;
+                p99: number;
+                max: number;
+            };
+            noveltyDatoms: number;
+            queueDepth: number;
+        };
+        store: import("../storage/index.ts").R2StoreStats;
+        indexer: {
+            running: boolean;
+            runs: number;
+            lastRun: import("./indexer.ts").IndexRunResult | undefined;
+            lastGc: unknown;
+            opts: import("./indexer.ts").IndexerOptions;
+        };
+    };
+    operationReceiptCount(): number;
+    handleRequest(request: Request): Promise<Response>;
+    private route;
+}
+//# sourceMappingURL=transactor.d.ts.map

package/dist/internal/transactor/transactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactor.d.ts","sourceRoot":"","sources":["../../../src/internal/transactor/transactor.ts"],"names":[],"mappings":"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"}