@fadhilp/stateql 0.10.0 → 0.11.0

package/dist/src/store.js

@@ -36,6 +36,7 @@ export class StateStore {
             this.db.exec("PRAGMA busy_timeout = 5000");
             this.db.exec("PRAGMA foreign_keys = ON");
             runMigrations(this.db, this.now);
+            this.backfillConnectionAliases();
             this.backfillGeneratedAliases();
             this.recoverStaleCommittingTransactions();
             this.deleteExpiredData();
@@ -52,14 +53,22 @@ export class StateStore {
         this.closed = true;
         this.db.close();
     }
-    nextId(prefix) {
-        this.db
-            .prepare("INSERT OR IGNORE INTO counters(prefix, value) VALUES (?, 0)")
-            .run(prefix);
-        const row = this.db
-            .prepare("UPDATE counters SET value = value + 1 WHERE prefix = ? RETURNING value")
-            .get(prefix);
-        return `${prefix}_${row.value}`;
+    randomId(prefix) {
+        return `${prefix}_${randomBase32Id()}`;
+    }
+    insertWithRandomId(prefix, table, insert) {
+        for (let attempt = 0; attempt < 64; attempt++) {
+            const id = this.randomId(prefix);
+            try {
+                insert(id);
+                return id;
+            }
+            catch (error) {
+                if (!isIdCollision(error, table))
+                    throw error;
+            }
+        }
+        throw new Error(`Could not allocate a unique ${prefix} ID.`);
     }
     ensureSession(name = "default") {
         const existing = this.getSessionByName(name);
@@ -86,12 +95,13 @@ export class StateStore {
                 .get(name);
             const created = !row;
             if (!row) {
-                const id = this.nextId("s");
-                this.db
-                    .prepare(`INSERT INTO sessions
-              (id, name, status, created_at, updated_at)
-             VALUES (?, ?, 'active', ?, ?)`)
-                    .run(id, name, timestamp, timestamp);
+                const id = this.insertWithRandomId("s", "sessions", (candidate) => {
+                    this.db
+                        .prepare(`INSERT INTO sessions
+                (id, name, status, created_at, updated_at)
+               VALUES (?, ?, 'active', ?, ?)`)
+                        .run(candidate, name, timestamp, timestamp);
+                });
                 row = { id, status: "active" };
             }
             else if (row.status !== "active") {
@@ -237,15 +247,15 @@ export class StateStore {
         const timestamp = this.now().toISOString();
         this.db
             .prepare(`INSERT INTO profiles
-          (name, target, secret_env, credential_ref, read_only, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?)`)
-            .run(input.name, input.target ?? null, input.secretEnv ?? null, input.credentialRef ?? null, input.readOnly ? 1 : 0, timestamp, timestamp);
+          (name, target, secret_env, credential_ref, password_ref, read_only, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.name, input.target ?? null, input.secretEnv ?? null, input.credentialRef ?? null, input.passwordRef ?? null, input.readOnly ? 1 : 0, timestamp, timestamp);
         return this.getProfile(input.name);
     }
     updateProfile(input) {
         const result = this.db.prepare(`UPDATE profiles
-       SET target = ?, secret_env = ?, credential_ref = ?, read_only = ?, updated_at = ?
-       WHERE name = ?`).run(input.target, input.secretEnv, input.credentialRef, input.readOnly ? 1 : 0, this.now().toISOString(), input.name);
+       SET target = ?, secret_env = ?, credential_ref = ?, password_ref = ?, read_only = ?, updated_at = ?
+       WHERE name = ?`).run(input.target, input.secretEnv, input.credentialRef, input.passwordRef, input.readOnly ? 1 : 0, this.now().toISOString(), input.name);
         return Number(result.changes) === 1 ? this.getProfile(input.name) : undefined;
     }
     getProfile(name) {
@@ -277,14 +287,16 @@ export class StateStore {
                 this.db.exec("COMMIT");
                 return undefined;
             }
-            const id = this.nextId("conn");
             const timestamp = this.now().toISOString();
-            this.db
-                .prepare(`INSERT INTO connections
-            (id, session_id, name, driver, database_name, source, secret_env,
-             credential_ref, read_only, version, created_at)
-           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?)`)
-                .run(id, input.sessionId, input.name, input.driver, input.databaseName, input.source, input.secretEnv ?? null, input.credentialRef ?? null, input.readOnly ? 1 : 0, timestamp);
+            const id = this.insertWithRandomId("conn", "connections", (candidate) => {
+                this.db
+                    .prepare(`INSERT INTO connections
+              (id, session_id, name, driver, database_name, source, secret_env,
+               credential_ref, password_ref, read_only, version, created_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?)`)
+                    .run(candidate, input.sessionId, input.name, input.driver, input.databaseName, input.source, input.secretEnv ?? null, input.credentialRef ?? null, input.passwordRef ?? null, input.readOnly ? 1 : 0, timestamp);
+            });
+            this.allocateConnectionAlias(id);
             this.db
                 .prepare(`UPDATE sessions
            SET active_connection_id = ?, updated_at = ?
@@ -298,6 +310,28 @@ export class StateStore {
             throw error;
         }
     }
+    allocateConnectionAlias(connectionId) {
+        for (let attempt = 0; attempt < 64; attempt++) {
+            this.db.prepare("UPDATE OR IGNORE connections SET alias = ? WHERE id = ? AND alias IS NULL").run(randomBase32Alias(), connectionId);
+            const connection = this.getConnection(connectionId);
+            if (connection?.alias)
+                return connection.alias;
+        }
+        throw new Error("Could not allocate a unique connection alias.");
+    }
+    backfillConnectionAliases() {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const connections = this.db.prepare("SELECT id FROM connections WHERE alias IS NULL").all();
+            for (const connection of connections)
+                this.allocateConnectionAlias(connection.id);
+            this.db.exec("COMMIT");
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
     getConnection(id) {
         return this.db
             .prepare("SELECT * FROM connections WHERE id = ?")
@@ -338,16 +372,17 @@ export class StateStore {
         return `sv_${row.version}`;
     }
     saveResult(input) {
-        const id = this.nextId("q");
         this.db.exec("BEGIN IMMEDIATE");
         try {
-            this.db
-                .prepare(`INSERT INTO results
-            (id, session_id, connection_id, fingerprint, sql, parameters,
-             rows_json, columns_json, row_count, state_version, state_signature,
-             state_confidence, expires_at, created_at)
-           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                .run(id, input.sessionId, input.connectionId, input.fingerprint, input.sql, JSON.stringify(toJsonSafe(input.parameters)), JSON.stringify(toJsonSafe(input.rows)), JSON.stringify(input.columns), input.rows.length, input.stateVersion, input.stateSignature, input.stateConfidence, input.expiresAt, this.now().toISOString());
+            const id = this.insertWithRandomId("q", "results", (candidate) => {
+                this.db
+                    .prepare(`INSERT INTO results
+              (id, session_id, connection_id, fingerprint, sql, parameters,
+               rows_json, columns_json, row_count, state_version, state_signature,
+               state_confidence, expires_at, created_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                    .run(candidate, input.sessionId, input.connectionId, input.fingerprint, input.sql, JSON.stringify(toJsonSafe(input.parameters)), JSON.stringify(toJsonSafe(input.rows)), JSON.stringify(input.columns), input.rows.length, input.stateVersion, input.stateSignature, input.stateConfidence, input.expiresAt, this.now().toISOString());
+            });
             this.enforceResultQuota(id);
             this.allocateGeneratedAlias(input.sessionId, id);
             const result = this.getResult(id);
@@ -442,14 +477,15 @@ export class StateStore {
         }
     }
     saveOperation(input) {
-        const id = this.nextId("op");
-        this.db
-            .prepare(`INSERT INTO operations
-          (id, session_id, actor_id, connection_id, fingerprint, sql, parameters,
-           statement_type, affected_rows, status, transaction_id, replay_of,
-           idempotency_key, state_version_before, state_version_after, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-            .run(id, input.sessionId, input.actorId, input.connectionId, input.fingerprint, input.sql, JSON.stringify(toJsonSafe(input.parameters)), input.statementType, input.affectedRows ?? null, input.status, input.transactionId ?? null, input.replayOf ?? null, input.idempotencyKey ?? null, input.stateVersionBefore, input.stateVersionAfter ?? null, this.now().toISOString());
+        const id = this.insertWithRandomId("op", "operations", (candidate) => {
+            this.db
+                .prepare(`INSERT INTO operations
+            (id, session_id, actor_id, connection_id, fingerprint, sql, parameters,
+             statement_type, affected_rows, status, transaction_id, replay_of,
+             idempotency_key, state_version_before, state_version_after, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(candidate, input.sessionId, input.actorId, input.connectionId, input.fingerprint, input.sql, JSON.stringify(toJsonSafe(input.parameters)), input.statementType, input.affectedRows ?? null, input.status, input.transactionId ?? null, input.replayOf ?? null, input.idempotencyKey ?? null, input.stateVersionBefore, input.stateVersionAfter ?? null, this.now().toISOString());
+        });
         return this.getOperation(id);
     }
     getOperation(id) {
@@ -560,7 +596,6 @@ export class StateStore {
             .run(operationId);
     }
     createTransaction(input) {
-        const id = this.nextId("tx");
         const timestamp = this.now().toISOString();
         this.db.exec("BEGIN IMMEDIATE");
         try {
@@ -580,12 +615,14 @@ export class StateStore {
                 this.db.exec("COMMIT");
                 return undefined;
             }
-            this.db
-                .prepare(`INSERT INTO transactions
-            (id, session_id, owner_actor_id, connection_id, state,
-             isolation_level, start_version, created_at)
-           VALUES (?, ?, ?, ?, 'active', ?, ?, ?)`)
-                .run(id, input.sessionId, input.actorId, input.connectionId, input.isolation, `sv_${eligible.version}`, timestamp);
+            const id = this.insertWithRandomId("tx", "transactions", (candidate) => {
+                this.db
+                    .prepare(`INSERT INTO transactions
+              (id, session_id, owner_actor_id, connection_id, state,
+               isolation_level, start_version, created_at)
+             VALUES (?, ?, ?, ?, 'active', ?, ?, ?)`)
+                    .run(candidate, input.sessionId, input.actorId, input.connectionId, input.isolation, `sv_${eligible.version}`, timestamp);
+            });
             this.db
                 .prepare(`UPDATE sessions
            SET active_transaction_id = ?, updated_at = ?
@@ -606,7 +643,7 @@ export class StateStore {
     }
     transactionOperations(transactionId) {
         return this.db
-            .prepare("SELECT * FROM operations WHERE transaction_id = ? ORDER BY created_at")
+            .prepare("SELECT * FROM operations WHERE transaction_id = ? ORDER BY created_at, rowid")
             .all(transactionId);
     }
     validatedTransactionOperations(transactionId) {
@@ -780,14 +817,15 @@ export class StateStore {
         }
     }
     savePlan(input) {
-        const id = this.nextId("p");
-        this.db
-            .prepare(`INSERT INTO plans
-          (id, session_id, owner_actor_id, connection_id, sql, parameters,
-           statement_type, state_version, state_signature, destructive,
-           allow_unbounded, allow_destructive, expires_at, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-            .run(id, input.sessionId, input.ownerActorId, input.connectionId, input.sql, JSON.stringify(toJsonSafe(input.parameters)), input.statementType, input.stateVersion, input.stateSignature, input.destructive ? 1 : 0, input.allowUnbounded ? 1 : 0, input.allowDestructive ? 1 : 0, input.expiresAt, this.now().toISOString());
+        const id = this.insertWithRandomId("p", "plans", (candidate) => {
+            this.db
+                .prepare(`INSERT INTO plans
+            (id, session_id, owner_actor_id, connection_id, sql, parameters,
+             statement_type, state_version, state_signature, destructive,
+             allow_unbounded, allow_destructive, expires_at, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(candidate, input.sessionId, input.ownerActorId, input.connectionId, input.sql, JSON.stringify(toJsonSafe(input.parameters)), input.statementType, input.stateVersion, input.stateSignature, input.destructive ? 1 : 0, input.allowUnbounded ? 1 : 0, input.allowDestructive ? 1 : 0, input.expiresAt, this.now().toISOString());
+        });
         return this.getPlan(id);
     }
     getPlan(id) {
@@ -852,13 +890,17 @@ export class StateStore {
         }
     }
     addHistory(input) {
-        const id = input.id ?? this.nextId("cmd");
-        this.db
-            .prepare(`INSERT INTO history
-          (id, timestamp, session_id, actor_id, origin, category, internal, command, sql, target, handle,
-           executed, cached, success, error_code)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-            .run(id, this.now().toISOString(), input.sessionId, input.actorId, input.origin ?? "legacy", input.category ?? "management", input.internal ? 1 : 0, input.command, boundedHistorySql(input.sql), input.target?.slice(0, 1024) ?? null, input.handle ?? null, input.executed ? 1 : 0, input.cached ? 1 : 0, input.success ? 1 : 0, input.errorCode ?? null);
+        const insert = (id) => {
+            this.db
+                .prepare(`INSERT INTO history
+            (id, timestamp, session_id, actor_id, origin, category, internal, command, sql, target, handle,
+             executed, cached, success, error_code)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(id, this.now().toISOString(), input.sessionId, input.actorId, input.origin ?? "legacy", input.category ?? "management", input.internal ? 1 : 0, input.command, boundedHistorySql(input.sql), input.target?.slice(0, 1024) ?? null, input.handle ?? null, input.executed ? 1 : 0, input.cached ? 1 : 0, input.success ? 1 : 0, input.errorCode ?? null);
+        };
+        const id = input.id ?? this.insertWithRandomId("cmd", "history", insert);
+        if (input.id !== undefined)
+            insert(id);
         this.db
             .prepare(`DELETE FROM history
          WHERE rowid IN (
@@ -1096,8 +1138,18 @@ function outcomeJson(outcome) {
     return outcome === undefined ? null : JSON.stringify(toJsonSafe(outcome));
 }
 function randomBase32Alias() {
+    return randomBase32(10);
+}
+function randomBase32Id() {
+    return randomBase32(26);
+}
+function randomBase32(length) {
     const alphabet = "abcdefghijklmnopqrstuvwxyz234567";
-    return [...randomBytes(10)].map((value) => alphabet[value & 31]).join("");
+    return [...randomBytes(length)].map((value) => alphabet[value & 31]).join("");
+}
+function isIdCollision(error, table) {
+    return error instanceof Error &&
+        error.message.includes(`UNIQUE constraint failed: ${table}.id`);
 }
 function boundedHistorySql(sql) {
     if (sql === undefined)

package/dist/src/types.d.ts

@@ -11,7 +11,7 @@ export interface CommandExecutionContext {
 }
 export type CredentialAccess = "read" | "write";
 export type CredentialOperation = "connect" | "query" | "inspect" | "plan" | "exec" | "apply" | "transaction.commit";
-export type CredentialSource = "secret_env" | "credential_ref";
+export type CredentialSource = "secret_env" | "credential_ref" | "password_ref";
 interface CredentialRequestBase {
     reference: string;
     actorId: string;
@@ -39,6 +39,9 @@ export type CredentialRequest = CredentialRequestBase & ({
     source?: "secret_env";
 } | {
     source: "credential_ref";
+} | {
+    source: "password_ref";
+    target: string;
 });
 export type CredentialResolver = (request: CredentialRequest) => string | undefined | Promise<string | undefined>;
 export type StateConfidence = "authoritative" | "transaction_snapshot" | "database_reported" | "local" | "ttl_based" | "unknown";
@@ -106,6 +109,9 @@ export interface StateQLSnapshot {
     actor_id: string;
     connection: {
         connection_id: string;
+        /** Generated display identity; optional for older snapshot producers. */
+        alias?: string;
+        display_alias?: string;
         name: string;
         status: "connected";
         driver: Driver;
@@ -297,16 +303,19 @@ export interface ConnectOptions extends ExecutionOptions {
     secretEnv?: string;
     profile?: string;
     credentialRef?: string;
+    passwordRef?: string;
 }
 export interface ProfileOptions {
     readOnly?: boolean;
     secretEnv?: string;
     credentialRef?: string;
+    passwordRef?: string;
 }
 export interface ProfileUpdateOptions {
     target?: string | null;
     secretEnv?: string | null;
     credentialRef?: string | null;
+    passwordRef?: string | null;
     readOnly?: boolean;
 }
 export interface RedisQueryOptions extends ExecutionOptions {
@@ -350,6 +359,7 @@ export interface BatchCommand {
     read_only?: boolean;
     secret_env?: string;
     credential_ref?: string;
+    password_ref?: string | null;
     profile?: string;
     replay?: boolean;
     idempotency_key?: string;
@@ -379,6 +389,9 @@ export type Row = Record<string, unknown>;
 /** Data returned by the stable, non-dynamic StateQL public methods. */
 export interface ConnectionData {
     connection_id: string;
+    /** Persistent generated display identity; connection_id remains canonical. */
+    alias: string;
+    display_alias: string;
     driver: Driver;
     database: string;
     name: string;
@@ -392,6 +405,7 @@ export interface ProfileData {
     target: string | null;
     secret_env: string | null;
     credential_ref: string | null;
+    password_ref: string | null;
     read_only: boolean;
 }
 export interface ProfilesData {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fadhilp/stateql",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Stateful, agent-oriented database CLI for safe result reuse",
   "repository": {
     "type": "git",