@ultipa-graph/ultipa-driver 6.0.14 → 6.0.15

package/dist/client.d.ts

@@ -6,7 +6,7 @@ import { GqldbConfig } from './config';
 import { Response, InsertNodesResult, InsertEdgesResult, DeleteResult, ExportNodesResult, ExportEdgesResult, ExportConfig, ExportChunk } from './response';
 import { Session } from './session';
 import { Transaction } from './transaction';
-import { GraphInfo, GraphType, HealthStatus, CacheStats, CacheType, Statistics, CompactResult, ComputeTopologyResult, SystemMetrics, NodeData, EdgeData, BulkCreateNodesOptions, BulkCreateEdgesOptions, BulkImportOptions, BulkImportSession, CheckpointResult, EndBulkImportResult, AbortBulkImportResult, BulkImportStatus, TransactionInfo, DBType, InsertType, LabelInfo, NodeTypeInfo, EdgeTypeInfo, ConvPropertyDef, IndexProperty, IndexInfo, FulltextInfo, TaskInfo, ProcessInfo, GraphStats, AlgoInfo, AiReadResult } from './types';
+import { GraphInfo, GraphType, HealthStatus, CacheStats, CacheType, Statistics, CompactResult, ComputeTopologyResult, SystemMetrics, NodeData, EdgeData, BulkCreateNodesOptions, BulkCreateEdgesOptions, BulkImportOptions, BulkImportSession, CheckpointResult, EndBulkImportResult, AbortBulkImportResult, BulkImportStatus, TransactionInfo, TransactionRow, DBType, InsertType, LabelInfo, NodeTypeInfo, EdgeTypeInfo, ConvPropertyDef, IndexProperty, IndexInfo, FulltextInfo, TaskInfo, ProcessInfo, GraphStats, AlgoInfo, AiReadResult } from './types';
 /** Configuration for a query */
 export interface QueryConfig {
     graphName?: string;
@@ -63,6 +63,13 @@ export declare class GqldbClient {
     private bulkImportService;
     /** Get session metadata for authenticated requests */
     private getSessionMetadata;
+    /**
+     * Stable per-client logical session id surfaced under the
+     * transaction-branch model. See TRANSACTIONS_DRIVER_GUIDE.md §2.0–2.1.
+     * Falls back to a UUID v4 hex generated at construction when
+     * `config.sessionId` is not set.
+     */
+    readonly clientSessionId: string;
     constructor(config: GqldbConfig);
     /** Close the client and all connections */
     close(): Promise<void>;
@@ -106,6 +113,28 @@ export declare class GqldbClient {
     listTransactions(): Promise<TransactionInfo[]>;
     /** Execute a function within a transaction */
     withTransaction<T>(graphName: string, fn: (txId: number) => Promise<T>, readOnly?: boolean): Promise<T>;
+    /**
+     * Return active transactions via the GQL admin DDL `SHOW TRANSACTIONS`.
+     * Each row mirrors the 5-column server-side schema:
+     * `transactionId / status / readOnly / startTime / sessionId`.
+     * `sessionId` is `''` unless the server has auto-derived one from peer
+     * info or the driver explicitly surfaces `x-ultipa-session-id` metadata.
+     *
+     * Distinct from `listTransactions()` which uses the legacy gRPC.
+     */
+    showTransactions(): Promise<TransactionRow[]>;
+    /**
+     * Roll back a single transaction by id via `KILL TRANSACTION '<id>'`.
+     * `transactionId` here is the **string** id surfaced by
+     * `showTransactions()` (e.g. `'tx_a396c531-...'`), distinct from the
+     * `number` id returned by `begin()`.
+     */
+    killTransaction(transactionId: string): Promise<Response>;
+    /**
+     * Roll back every active transaction via `RESET TRANSACTIONS`. Admin-only.
+     * Intended as an escape hatch when an orphan tx blocks new BEGINs.
+     */
+    resetTransactions(): Promise<Response>;
     /** Insert multiple nodes into a graph using gRPC bulk insert */
     insertNodesBatchAuto(graphName: string, nodes: NodeData[], config?: InsertNodesConfig): Promise<InsertNodesResult>;
     /** Insert multiple edges into a graph using gRPC bulk insert */