@fadhilp/stateql 0.1.1

package/dist/src/store.d.ts

@@ -0,0 +1,245 @@
+import { DatabaseSync } from "node:sqlite";
+import type { Column, Driver, Row, SqlParameters, StateConfidence } from "./types.js";
+export interface SessionRecord {
+    id: string;
+    name: string;
+    status: string;
+    active_connection_id: string | null;
+    active_transaction_id: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface ConnectionRecord {
+    id: string;
+    session_id: string;
+    name: string;
+    driver: Driver;
+    database_name: string;
+    source: string;
+    secret_env: string | null;
+    read_only: number;
+    version: number;
+    created_at: string;
+}
+export interface ProfileRecord {
+    name: string;
+    target: string | null;
+    secret_env: string | null;
+    read_only: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface ResultRecord {
+    id: string;
+    session_id: string;
+    connection_id: string;
+    fingerprint: string;
+    sql: string;
+    parameters: string;
+    rows_json: string;
+    columns_json: string;
+    row_count: number;
+    state_version: string;
+    state_signature: string;
+    state_confidence: StateConfidence;
+    expires_at: string;
+    created_at: string;
+}
+export interface OperationRecord {
+    id: string;
+    session_id: string;
+    connection_id: string;
+    fingerprint: string;
+    sql: string;
+    parameters: string;
+    statement_type: string;
+    affected_rows: number | null;
+    status: string;
+    transaction_id: string | null;
+    replay_of: string | null;
+    idempotency_key: string | null;
+    state_version_before: string;
+    state_version_after: string | null;
+    created_at: string;
+}
+export interface TransactionRecord {
+    id: string;
+    session_id: string;
+    connection_id: string;
+    state: string;
+    isolation_level: string;
+    start_version: string;
+    created_at: string;
+    ended_at: string | null;
+}
+export interface PlanRecord {
+    id: string;
+    session_id: string;
+    connection_id: string;
+    sql: string;
+    parameters: string;
+    statement_type: string;
+    state_version: string;
+    state_signature: string;
+    destructive: number;
+    allow_unbounded: number;
+    allow_destructive: number;
+    expires_at: string;
+    applied_operation_id: string | null;
+    created_at: string;
+}
+export interface HistoryRecord {
+    id: string;
+    timestamp: string;
+    session_id: string;
+    command: string;
+    handle: string | null;
+    executed: number;
+    cached: number;
+    success: number;
+    error_code: string | null;
+}
+export declare class StateStore {
+    private readonly now;
+    readonly db: DatabaseSync;
+    constructor(home: string, now: () => Date);
+    close(): void;
+    nextId(prefix: string): string;
+    ensureSession(name?: string): SessionRecord;
+    createSession(name: string): SessionRecord;
+    getSession(idOrName: string): SessionRecord | undefined;
+    listSessions(): SessionRecord[];
+    closeSession(sessionId: string): void;
+    addProfile(input: {
+        name: string;
+        target?: string;
+        secretEnv?: string;
+        readOnly: boolean;
+    }): ProfileRecord;
+    getProfile(name: string): ProfileRecord | undefined;
+    listProfiles(): ProfileRecord[];
+    removeProfile(name: string): boolean;
+    addConnection(input: {
+        sessionId: string;
+        name: string;
+        driver: Driver;
+        databaseName: string;
+        source: string;
+        secretEnv?: string;
+        readOnly: boolean;
+    }): ConnectionRecord;
+    getConnection(id: string): ConnectionRecord | undefined;
+    activeConnection(session: SessionRecord): ConnectionRecord | undefined;
+    disconnect(sessionId: string): void;
+    bumpVersion(connectionId: string): string;
+    saveResult(input: {
+        sessionId: string;
+        connectionId: string;
+        fingerprint: string;
+        sql: string;
+        parameters: SqlParameters;
+        rows: Row[];
+        columns: Column[];
+        stateVersion: string;
+        stateSignature: string;
+        stateConfidence: StateConfidence;
+        expiresAt: string;
+    }): ResultRecord;
+    findResult(fingerprint: string): ResultRecord | undefined;
+    getResult(idOrAlias: string, sessionId?: string): ResultRecord | undefined;
+    resultRows(result: ResultRecord): Row[];
+    resultColumns(result: ResultRecord): Column[];
+    setAlias(sessionId: string, name: string, resultId: string): void;
+    saveOperation(input: {
+        sessionId: string;
+        connectionId: string;
+        fingerprint: string;
+        sql: string;
+        parameters: SqlParameters;
+        statementType: string;
+        affectedRows?: number;
+        status: string;
+        transactionId?: string;
+        replayOf?: string;
+        idempotencyKey?: string;
+        stateVersionBefore: string;
+        stateVersionAfter?: string;
+    }): OperationRecord;
+    getOperation(id: string): OperationRecord | undefined;
+    findDuplicateOperation(input: {
+        connectionId: string;
+        fingerprint: string;
+        idempotencyKey?: string;
+    }): OperationRecord | undefined;
+    reserveOperation(input: {
+        sessionId: string;
+        connectionId: string;
+        fingerprint: string;
+        sql: string;
+        parameters: SqlParameters;
+        statementType: string;
+        status: "executing" | "pending";
+        transactionId?: string;
+        replay: boolean;
+        idempotencyKey?: string;
+        stateVersionBefore: string;
+    }): {
+        operation?: OperationRecord;
+        previous?: OperationRecord;
+    };
+    finishOperation(operationId: string, affectedRows: number, stateVersion: string): OperationRecord;
+    failOperation(operationId: string): void;
+    markOperationOutcomeUnknown(operationId: string): void;
+    createTransaction(input: {
+        sessionId: string;
+        connectionId: string;
+        isolation: string;
+        startVersion: string;
+    }): TransactionRecord;
+    getTransaction(id: string): TransactionRecord | undefined;
+    transactionOperations(transactionId: string): OperationRecord[];
+    markTransactionCommitting(transactionId: string): boolean;
+    markTransactionOutcomeUnknown(transactionId: string, sessionId: string): void;
+    finishTransaction(transactionId: string, sessionId: string, state: "committed" | "rolled_back" | "failed"): void;
+    commitTransactionMetadata(input: {
+        transactionId: string;
+        sessionId: string;
+        connectionId: string;
+        operations: Array<{
+            id: string;
+            affectedRows: number;
+        }>;
+    }): string;
+    savePlan(input: {
+        sessionId: string;
+        connectionId: string;
+        sql: string;
+        parameters: SqlParameters;
+        statementType: string;
+        stateVersion: string;
+        stateSignature: string;
+        destructive: boolean;
+        allowUnbounded: boolean;
+        allowDestructive: boolean;
+        expiresAt: string;
+    }): PlanRecord;
+    getPlan(id: string): PlanRecord | undefined;
+    markPlanApplied(planId: string, operationId: string): void;
+    addHistory(input: {
+        sessionId: string;
+        command: string;
+        handle?: string;
+        executed: boolean;
+        cached: boolean;
+        success: boolean;
+        errorCode?: string;
+        id?: string;
+    }): HistoryRecord;
+    history(sessionId: string, limit: number): HistoryRecord[];
+    recentOperations(sessionId: string, limit: number): OperationRecord[];
+    knownResults(sessionId: string, limit: number): Array<ResultRecord & {
+        alias: string | null;
+    }>;
+    private recoverStaleCommittingTransactions;
+    private migrate;
+}