@fadhilp/stateql 0.1.2 → 0.2.2

package/dist/src/store.d.ts

@@ -108,6 +108,7 @@ export declare class StateStore {
     ensureSession(name?: string): SessionRecord;
     createSession(name: string): SessionRecord;
     getSession(idOrName: string): SessionRecord | undefined;
+    getSessionByName(name: string): SessionRecord | undefined;
     listSessions(): SessionRecord[];
     closeSession(sessionId: string): void;
     addProfile(input: {
@@ -240,6 +241,7 @@ export declare class StateStore {
     knownResults(sessionId: string, limit: number): Array<ResultRecord & {
         alias: string | null;
     }>;
+    private deleteExpiredData;
     private recoverStaleCommittingTransactions;
     private migrate;
 }

package/dist/src/store.js

@@ -16,6 +16,7 @@ export class StateStore {
         this.db.exec("PRAGMA foreign_keys = ON");
         this.migrate();
         this.recoverStaleCommittingTransactions();
+        this.deleteExpiredData();
     }
     close() {
         this.db.close();
@@ -30,10 +31,20 @@ export class StateStore {
         return `${prefix}_${row.value}`;
     }
     ensureSession(name = "default") {
-        const existing = this.getSession(name);
+        const existing = this.getSessionByName(name);
         if (existing)
             return existing;
-        return this.createSession(name);
+        const closed = this.db
+            .prepare("SELECT id FROM sessions WHERE name = ? LIMIT 1")
+            .get(name);
+        if (!closed)
+            return this.createSession(name);
+        this.db
+            .prepare(`UPDATE sessions
+         SET status = 'active', active_transaction_id = NULL, updated_at = ?
+         WHERE id = ?`)
+            .run(this.now().toISOString(), closed.id);
+        return this.getSessionByName(name);
     }
     createSession(name) {
         const timestamp = this.now().toISOString();
@@ -52,6 +63,11 @@ export class StateStore {
          LIMIT 1`)
             .get(idOrName, idOrName);
     }
+    getSessionByName(name) {
+        return this.db
+            .prepare("SELECT * FROM sessions WHERE name = ? AND status = 'active' LIMIT 1")
+            .get(name);
+    }
     listSessions() {
         return this.db
             .prepare("SELECT * FROM sessions ORDER BY created_at")
@@ -462,6 +478,25 @@ export class StateStore {
          LIMIT ?`)
             .all(sessionId, limit);
     }
+    deleteExpiredData() {
+        const timestamp = this.now().toISOString();
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            this.db
+                .prepare(`DELETE FROM aliases
+           WHERE result_id IN (
+             SELECT id FROM results WHERE expires_at <= ?
+           )`)
+                .run(timestamp);
+            this.db.prepare("DELETE FROM results WHERE expires_at <= ?").run(timestamp);
+            this.db.prepare("DELETE FROM plans WHERE expires_at <= ?").run(timestamp);
+            this.db.exec("COMMIT");
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
     recoverStaleCommittingTransactions() {
         const timestamp = this.now().toISOString();
         const cutoff = new Date(this.now().getTime() - 5 * 60_000).toISOString();

package/dist/src/types.d.ts

@@ -1,4 +1,4 @@
-export type Driver = "sqlite" | "postgres";
+export type Driver = "sqlite" | "postgres" | "mysql";
 export type StateConfidence = "authoritative" | "transaction_snapshot" | "database_reported" | "local" | "ttl_based" | "unknown";
 export interface Warning {
     code: string;
@@ -33,8 +33,56 @@ export interface Failure {
     meta: ResponseMeta;
 }
 export type Response<T> = Success<T> | Failure;
+export interface HistoryEntry {
+    command_id: string;
+    timestamp: string;
+    session_id: string;
+    command: string;
+    handle: string | null;
+    executed: boolean;
+    cached: boolean;
+    success: boolean;
+    error_code: string | null;
+}
+export interface StateQLSnapshot {
+    session: {
+        session_id: string;
+        name: string;
+        status: string;
+    };
+    connection: {
+        connection_id: string;
+        name: string;
+        status: "connected";
+        driver: Driver;
+        database: string;
+        read_only: boolean;
+    } | null;
+    transaction: {
+        transaction_id: string;
+        state: string;
+    } | null;
+    state_version: string | null;
+    state_confidence: StateConfidence | null;
+    recent_results: Array<{
+        alias: string | null;
+        handle: string;
+        rows: number;
+    }>;
+    recent_operations: Array<{
+        handle: string;
+        type: string;
+        affected_rows: number | null;
+        status: string;
+    }>;
+    history: HistoryEntry[];
+}
 export type SqlParameters = unknown[] | Record<string, unknown>;
-export interface StateQLOptions {
+export interface ExecutionOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface StateQLOptions extends ExecutionOptions {
     home?: string;
     session?: string;
     previewRows?: number;
@@ -42,23 +90,24 @@ export interface StateQLOptions {
     resultTtlSeconds?: number;
     maxCellCharacters?: number;
     maxResultRows?: number;
+    maxResultBytes?: number;
     now?: () => Date;
 }
-export interface QueryOptions {
+export interface QueryOptions extends ExecutionOptions {
     params?: SqlParameters;
     cache?: "auto" | "bypass" | "require";
 }
 export interface FilterOptions {
     params?: SqlParameters;
 }
-export interface ExecOptions {
+export interface ExecOptions extends ExecutionOptions {
     params?: SqlParameters;
     replay?: boolean;
     idempotencyKey?: string;
     allowUnbounded?: boolean;
     allowDestructive?: boolean;
 }
-export interface ConnectOptions {
+export interface ConnectOptions extends ExecutionOptions {
     name?: string;
     readOnly?: boolean;
     secretEnv?: string;
@@ -72,7 +121,7 @@ export interface RowsOptions {
     offset?: number;
     limit?: number;
 }
-export interface PlanOptions {
+export interface PlanOptions extends ExecutionOptions {
     params?: SqlParameters;
     allowUnbounded?: boolean;
     allowDestructive?: boolean;
@@ -100,6 +149,7 @@ export interface BatchCommand {
     offset?: number;
     limit?: number;
     isolation?: string;
+    timeout_ms?: number;
 }
 export interface BatchOptions {
     continueOnError?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fadhilp/stateql",
-  "version": "0.1.2",
+  "version": "0.2.2",
   "description": "Stateful, agent-oriented database CLI for safe result reuse",
   "repository": {
     "type": "git",
@@ -25,11 +25,12 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "npm run build && node --test dist/test/stateql.test.js",
+    "test": "npm run build && node --test dist/test/cli.test.js dist/test/mysql.test.js dist/test/postgres.test.js dist/test/query.test.js dist/test/sqlite.test.js dist/test/store.test.js dist/test/terminal.test.js dist/test/transaction.test.js dist/test/write.test.js",
     "prepack": "npm test"
   },
   "keywords": [
     "database",
+    "mysql",
     "sqlite",
     "postgresql",
     "cli",
@@ -41,12 +42,14 @@
     "node": ">=22.5"
   },
   "dependencies": {
+    "mysql2": "^3.23.1",
     "node-sql-parser": "^5.4.0",
     "pg": "^8.16.3"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
     "@types/pg": "^8.15.5",
+    "node-pty": "^1.1.0",
     "typescript": "^7.0.0"
   }
 }