js-redis-server 0.0.2 → 0.0.3

package/dist/core/client-session.d.ts

@@ -4,56 +4,168 @@ import { type ClientSessionMode, type ParkHandler, type RedisClientSession, type
 import { RedisResult } from './redis-result';
 import type { RespVersion } from './resp-encoder';
 import { type RedisTurnHandle, type RedisTurnQueue } from './turn-queue';
-import type { RedisDatabase, RedisServerState } from '../state';
+import type { RedisClusterNodeRole, RedisDatabase, RedisServerState } from '../state';
 export type ClientSessionOptions = {
     id?: string;
     server: RedisServerState;
     executor: CommandExecutor;
     database?: number;
+    nodeRole?: RedisClusterNodeRole;
     signal?: AbortSignal;
     park?: ParkHandler;
     turnQueue?: RedisTurnQueue;
 };
+/**
+ * Mutable view of the turn currently held by an in-flight command. A blocking
+ * command suspends its turn while parked and is later resumed on a *new* handle,
+ * so the holder must be able to both read the current turn and swap it.
+ */
 type TurnAccess = {
     get(): RedisTurnHandle | undefined;
     set(turn: RedisTurnHandle | undefined): void;
 };
+/**
+ * Per-connection server state and the concrete {@link RedisClientSession}.
+ *
+ * One instance exists per connected client and owns everything that is scoped
+ * to that connection rather than to the shared server:
+ *  - the selected database index and the resolved {@link RedisDatabase};
+ *  - the session {@link ClientSessionMode} (normal / transaction / subscribed);
+ *  - the negotiated RESP protocol version (HELLO);
+ *  - the cluster READONLY flag (replica reads via READONLY/READWRITE);
+ *  - the MULTI command queue and its dirty bit;
+ *  - WATCH key registrations for optimistic locking.
+ *
+ * Commands are serialized through a per-database turn queue so that, even though
+ * execution is async, only one command mutates a given database at a time. This
+ * is also what makes blocking commands (BLPOP, ...) cooperate instead of
+ * deadlock — see {@link createTurnAwareParkHandler}.
+ */
 export declare class ClientSession implements RedisClientSession {
     private static nextId;
     readonly id: string;
     readonly server: RedisServerState;
+    /** Aborted when the connection closes; threaded into every command's ctx. */
     readonly signal: AbortSignal;
     private readonly executor;
     private readonly signalSource?;
+    private readonly nodeRole?;
     private readonly parkHandler;
     private readonly turnQueueOverride?;
+    /**
+     * The turn handle of the command currently executing on this session,
+     * exposed so {@link executeTransaction} can hand the turn off to another
+     * database's queue when a queued SELECT switches databases mid-EXEC.
+     */
+    private activeTurnAccess?;
     private selectedDatabaseId;
     private sessionMode;
     private respVersion;
+    private authenticated;
+    /** Set by READONLY, cleared by READWRITE/RESET; lets a replica serve reads. */
+    private clusterReadOnlyMode;
+    /** Commands buffered between MULTI and EXEC, in submission order. */
     private transactionPlans;
+    /** True once a queued command errored — forces EXEC to abort with EXECABORT. */
     private transactionDirty;
+    /** Active WATCH registrations, keyed by `db:keyHex`. */
     private readonly watches;
+    /** Subset of watched keys mutated since WATCH — non-empty fails the next EXEC. */
     private readonly dirtyWatches;
     constructor(options: ClientSessionOptions);
     get selectedDatabase(): number;
     get mode(): ClientSessionMode;
     get protocolVersion(): RespVersion;
+    get clusterReadOnly(): boolean;
+    get isAuthenticated(): boolean;
+    setAuthenticated(value: boolean): void;
+    /** The live database object for the currently selected index. */
     get db(): RedisDatabase;
     setProtocolVersion(version: RespVersion): void;
+    /** Toggle replica read mode for this connection (READONLY / READWRITE). */
+    setClusterReadOnly(value: boolean): void;
     selectDatabase(database: number): void;
+    /** MULTI: enter transaction mode. Redis forbids nesting. */
     beginTransaction(): void;
+    /** Buffer one command while in MULTI; replies "+QUEUED" to the client. */
     queueTransaction(plan: CommandPlan): void;
+    /**
+     * EXEC step 1: hand back the queued plans and atomically reset the session to
+     * normal mode (clearing the queue, dirty bit, and WATCHes). The caller is
+     * responsible for actually running the returned plans via
+     * {@link executeTransaction}. Returns an empty list if not in MULTI.
+     */
     drainTransaction(): CommandPlan[];
+    /** DISCARD: drop the queued commands and leave transaction mode. */
     discardTransaction(): void;
+    /** Flag the transaction as poisoned (a queued command failed). No-op outside MULTI. */
     markTransactionDirty(): void;
     isTransactionDirty(): boolean;
+    /**
+     * EXEC step 2: run the drained plans in order and collect their replies into a
+     * single array reply. Each command runs in its own fresh execution context.
+     * Streaming commands (SUBSCRIBE/MONITOR) are not permitted inside a
+     * transaction: the stream is closed immediately and replaced with an error
+     * entry so the array stays positionally aligned with the queued commands.
+     */
     executeTransaction(plans: readonly CommandPlan[]): Promise<RedisResult>;
+    /**
+     * Release the currently held serialization turn and acquire a fresh one on
+     * the selected database's queue. Called when a queued SELECT switches
+     * databases mid-EXEC so subsequent commands run under the correct
+     * per-database turn (see {@link executeTransaction}).
+     *
+     * No-op when a fixed turn-queue override is in force (a single queue already
+     * serializes every database) or when no managed turn is active.
+     */
+    private handoffTurnToSelectedDb;
+    /**
+     * WATCH the given keys for optimistic locking. Each key is subscribed in the
+     * keyspace; any mutation flips its entry into {@link dirtyWatches}, which a
+     * subsequent EXEC checks via {@link isWatchDirty}. Already-watched keys are
+     * skipped so re-WATCHing is idempotent.
+     */
     watch(keys: readonly Buffer[]): void;
+    /** UNWATCH / cleanup: drop every keyspace subscription and clear dirty state. */
     unwatch(): void;
+    /** True if any watched key was mutated since WATCH — EXEC must return nil. */
     isWatchDirty(): boolean;
+    /**
+     * Public entry point for executing one client command.
+     *
+     * Acquires a turn on the database's turn queue before running, guaranteeing
+     * serialized access to the keyspace, and always releases it afterward. The
+     * acquired turn is exposed to the command via a turn-aware park handler so a
+     * blocking command can yield the turn while parked (see
+     * {@link createTurnAwareParkHandler}); `turn` is reassigned through the
+     * {@link TurnAccess} closure because suspending returns a *new* handle.
+     */
     execute(rawCommand: Buffer | string, rawArgs: readonly Buffer[]): Promise<ExecutorResult>;
-    createExecutionContext(turnAccess?: TurnAccess): RedisExecutionContext;
+    /**
+     * Build the {@link RedisExecutionContext} passed to a command's `execute`.
+     * When a turn is supplied (the normal client path) the context gets a
+     * turn-aware park handler so blocking commands release their turn while
+     * waiting; without one (e.g. nested transaction execution) the plain park
+     * handler is used.
+     */
+    createExecutionContext(turnAccess?: TurnAccess, parkOverride?: ParkHandler): RedisExecutionContext;
+    /** Tear down the session: abort in-flight work and reset all per-connection state. */
     close(): void;
+    /**
+     * Wrap the base park handler so that parking also yields the command's turn.
+     *
+     * Blocking commands (BLPOP, BRPOP, ...) must not hold the database turn while
+     * they wait, or no other client could ever produce the value that unblocks
+     * them — a deadlock. The flow:
+     *  1. Start the underlying park, capturing its eventual value.
+     *  2. Clear the local turn and call `turn.suspend(parked)`, which releases the
+     *     turn back to the queue and resolves with a fresh turn once the park
+     *     settles and this session is scheduled again.
+     *  3. Store the new turn (so `finally`/subsequent parks see it) and return the
+     *     parked value.
+     *
+     * If there is no current turn, fall back to plain parking.
+     */
     private createTurnAwareParkHandler;
 }
 export {};

package/dist/core/client-session.d.ts.map

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

package/dist/core/client-session.js

@@ -5,27 +5,60 @@ const redis_context_1 = require("./redis-context");
 const redis_error_1 = require("./redis-error");
 const redis_result_1 = require("./redis-result");
 const redis_value_1 = require("./redis-value");
+/**
+ * Per-connection server state and the concrete {@link RedisClientSession}.
+ *
+ * One instance exists per connected client and owns everything that is scoped
+ * to that connection rather than to the shared server:
+ *  - the selected database index and the resolved {@link RedisDatabase};
+ *  - the session {@link ClientSessionMode} (normal / transaction / subscribed);
+ *  - the negotiated RESP protocol version (HELLO);
+ *  - the cluster READONLY flag (replica reads via READONLY/READWRITE);
+ *  - the MULTI command queue and its dirty bit;
+ *  - WATCH key registrations for optimistic locking.
+ *
+ * Commands are serialized through a per-database turn queue so that, even though
+ * execution is async, only one command mutates a given database at a time. This
+ * is also what makes blocking commands (BLPOP, ...) cooperate instead of
+ * deadlock — see {@link createTurnAwareParkHandler}.
+ */
 class ClientSession {
     static nextId = 0;
     id;
     server;
+    /** Aborted when the connection closes; threaded into every command's ctx. */
     signal;
     executor;
     signalSource;
+    nodeRole;
     parkHandler;
     turnQueueOverride;
+    /**
+     * The turn handle of the command currently executing on this session,
+     * exposed so {@link executeTransaction} can hand the turn off to another
+     * database's queue when a queued SELECT switches databases mid-EXEC.
+     */
+    activeTurnAccess;
     selectedDatabaseId;
     sessionMode = 'normal';
     respVersion = 2;
+    authenticated = false;
+    /** Set by READONLY, cleared by READWRITE/RESET; lets a replica serve reads. */
+    clusterReadOnlyMode = false;
+    /** Commands buffered between MULTI and EXEC, in submission order. */
     transactionPlans = [];
+    /** True once a queued command errored — forces EXEC to abort with EXECABORT. */
     transactionDirty = false;
+    /** Active WATCH registrations, keyed by `db:keyHex`. */
     watches = new Map();
+    /** Subset of watched keys mutated since WATCH — non-empty fails the next EXEC. */
     dirtyWatches = new Set();
     constructor(options) {
         this.id = options.id ?? `client-${++ClientSession.nextId}`;
         this.server = options.server;
         this.executor = options.executor;
         this.selectedDatabaseId = options.database ?? 0;
+        this.nodeRole = options.nodeRole;
         this.parkHandler = options.park ?? (0, redis_context_1.createDefaultParkHandler)();
         this.turnQueueOverride = options.turnQueue;
         if (options.signal) {
@@ -46,12 +79,26 @@ class ClientSession {
     get protocolVersion() {
         return this.respVersion;
     }
+    get clusterReadOnly() {
+        return this.clusterReadOnlyMode;
+    }
+    get isAuthenticated() {
+        return this.authenticated;
+    }
+    setAuthenticated(value) {
+        this.authenticated = value;
+    }
+    /** The live database object for the currently selected index. */
     get db() {
         return this.server.getDatabase(this.selectedDatabaseId);
     }
     setProtocolVersion(version) {
         this.respVersion = version;
     }
+    /** Toggle replica read mode for this connection (READONLY / READWRITE). */
+    setClusterReadOnly(value) {
+        this.clusterReadOnlyMode = value;
+    }
     selectDatabase(database) {
         if (!Number.isInteger(database) ||
             database < 0 ||
@@ -60,6 +107,7 @@ class ClientSession {
         }
         this.selectedDatabaseId = database;
     }
+    /** MULTI: enter transaction mode. Redis forbids nesting. */
     beginTransaction() {
         if (this.sessionMode === 'transaction') {
             throw new redis_error_1.RedisCommandError('MULTI calls can not be nested');
@@ -68,12 +116,19 @@ class ClientSession {
         this.transactionPlans = [];
         this.transactionDirty = false;
     }
+    /** Buffer one command while in MULTI; replies "+QUEUED" to the client. */
     queueTransaction(plan) {
         if (this.sessionMode !== 'transaction') {
             throw new redis_error_1.RedisCommandError('MULTI has not been called');
         }
         this.transactionPlans.push(plan);
     }
+    /**
+     * EXEC step 1: hand back the queued plans and atomically reset the session to
+     * normal mode (clearing the queue, dirty bit, and WATCHes). The caller is
+     * responsible for actually running the returned plans via
+     * {@link executeTransaction}. Returns an empty list if not in MULTI.
+     */
     drainTransaction() {
         if (this.sessionMode !== 'transaction') {
             return [];
@@ -85,12 +140,14 @@ class ClientSession {
         this.unwatch();
         return plans;
     }
+    /** DISCARD: drop the queued commands and leave transaction mode. */
     discardTransaction() {
         this.transactionPlans = [];
         this.sessionMode = 'normal';
         this.transactionDirty = false;
         this.unwatch();
     }
+    /** Flag the transaction as poisoned (a queued command failed). No-op outside MULTI. */
     markTransactionDirty() {
         if (this.sessionMode === 'transaction') {
             this.transactionDirty = true;
@@ -99,13 +156,50 @@ class ClientSession {
     isTransactionDirty() {
         return this.transactionDirty;
     }
+    /**
+     * EXEC step 2: run the drained plans in order and collect their replies into a
+     * single array reply. Each command runs in its own fresh execution context.
+     * Streaming commands (SUBSCRIBE/MONITOR) are not permitted inside a
+     * transaction: the stream is closed immediately and replaced with an error
+     * entry so the array stays positionally aligned with the queued commands.
+     */
     async executeTransaction(plans) {
         const values = [];
+        // Blocking commands must not park while the EXEC turn is held — that would
+        // deadlock because no other session could produce the wakeup write. Override
+        // park so any blocking command queued in MULTI behaves non-blocking (returns
+        // null immediately), matching real Redis BLPOP-inside-MULTI semantics.
+        const noBlockCtx = this.createExecutionContext(undefined, async () => null);
+        let currentDbId = this.selectedDatabaseId;
         for (const plan of plans) {
             if (this.signal.aborted) {
                 throw createAbortError();
             }
-            const result = await this.executor.executePlan(plan, this.createExecutionContext());
+            // A queued SELECT on a previous iteration may have switched databases.
+            // Move the held turn onto the now-selected database's queue so its
+            // keyspace stays serialized against other sessions (#94 follow-up). Only
+            // one turn is ever held at a time (release-then-acquire), so this cannot
+            // deadlock even if two transactions select databases in opposite orders.
+            if (this.selectedDatabaseId !== currentDbId) {
+                await this.handoffTurnToSelectedDb();
+                currentDbId = this.selectedDatabaseId;
+            }
+            // executePlan converts RedisCommandErrors into error results, but a
+            // command whose execute() throws an unexpected runtime error (TypeError,
+            // etc.) would otherwise propagate out and abandon the partial results
+            // array. Real Redis always replies with an N-element EXEC array, so trap
+            // the failure into this command's slot and keep running the rest (#83).
+            let result;
+            try {
+                result = await this.executor.executePlan(plan, noBlockCtx);
+            }
+            catch (err) {
+                if (this.signal.aborted) {
+                    throw err;
+                }
+                values.push(redis_value_1.RedisValue.error(err.message));
+                continue;
+            }
             if (result instanceof redis_result_1.RedisResult) {
                 values.push(result.value);
                 continue;
@@ -115,6 +209,33 @@ class ClientSession {
         }
         return redis_result_1.RedisResult.create(redis_value_1.RedisValue.array(values));
     }
+    /**
+     * Release the currently held serialization turn and acquire a fresh one on
+     * the selected database's queue. Called when a queued SELECT switches
+     * databases mid-EXEC so subsequent commands run under the correct
+     * per-database turn (see {@link executeTransaction}).
+     *
+     * No-op when a fixed turn-queue override is in force (a single queue already
+     * serializes every database) or when no managed turn is active.
+     */
+    async handoffTurnToSelectedDb() {
+        if (this.turnQueueOverride) {
+            return;
+        }
+        const turnAccess = this.activeTurnAccess;
+        if (!turnAccess) {
+            return;
+        }
+        turnAccess.get()?.release();
+        const nextTurn = await this.db.turnQueue.waitTurn();
+        turnAccess.set(nextTurn);
+    }
+    /**
+     * WATCH the given keys for optimistic locking. Each key is subscribed in the
+     * keyspace; any mutation flips its entry into {@link dirtyWatches}, which a
+     * subsequent EXEC checks via {@link isWatchDirty}. Already-watched keys are
+     * skipped so re-WATCHing is idempotent.
+     */
     watch(keys) {
         const database = this.selectedDatabaseId;
         const db = this.db;
@@ -133,6 +254,7 @@ class ClientSession {
             });
         }
     }
+    /** UNWATCH / cleanup: drop every keyspace subscription and clear dirty state. */
     unwatch() {
         for (const watch of this.watches.values()) {
             watch.unsubscribe();
@@ -140,47 +262,94 @@ class ClientSession {
         this.watches.clear();
         this.dirtyWatches.clear();
     }
+    /** True if any watched key was mutated since WATCH — EXEC must return nil. */
     isWatchDirty() {
         return this.dirtyWatches.size > 0;
     }
+    /**
+     * Public entry point for executing one client command.
+     *
+     * Acquires a turn on the database's turn queue before running, guaranteeing
+     * serialized access to the keyspace, and always releases it afterward. The
+     * acquired turn is exposed to the command via a turn-aware park handler so a
+     * blocking command can yield the turn while parked (see
+     * {@link createTurnAwareParkHandler}); `turn` is reassigned through the
+     * {@link TurnAccess} closure because suspending returns a *new* handle.
+     */
     async execute(rawCommand, rawArgs) {
         if (this.signal.aborted) {
             throw createAbortError();
         }
         const turnQueue = this.turnQueueOverride ?? this.db.turnQueue;
         let turn = await turnQueue.waitTurn();
+        const turnAccess = {
+            get: () => turn,
+            set: nextTurn => {
+                turn = nextTurn;
+            },
+        };
+        this.activeTurnAccess = turnAccess;
         try {
-            const ctx = this.createExecutionContext({
-                get: () => turn,
-                set: nextTurn => {
-                    turn = nextTurn;
-                },
-            });
+            const ctx = this.createExecutionContext(turnAccess);
             return await this.executor.executeRaw(rawCommand, rawArgs, ctx);
         }
         finally {
+            this.activeTurnAccess = undefined;
             turn?.release();
         }
     }
-    createExecutionContext(turnAccess) {
+    /**
+     * Build the {@link RedisExecutionContext} passed to a command's `execute`.
+     * When a turn is supplied (the normal client path) the context gets a
+     * turn-aware park handler so blocking commands release their turn while
+     * waiting; without one (e.g. nested transaction execution) the plain park
+     * handler is used.
+     */
+    createExecutionContext(turnAccess, parkOverride) {
+        // `db` is a live getter, not a snapshot: a queued `SELECT N` runs mid-EXEC
+        // and updates `selectedDatabaseId`, so every command must resolve the
+        // currently selected database at access time, not at context-build time
+        // (issue #94). Arrow keeps `this` bound to the session without aliasing.
+        const resolveDb = () => this.db;
         return {
-            db: this.db,
+            get db() {
+                return resolveDb();
+            },
             server: this.server,
             session: this,
             executor: this.executor,
+            ...(this.nodeRole ? { nodeRole: this.nodeRole } : {}),
             signal: this.signal,
-            park: turnAccess
-                ? this.createTurnAwareParkHandler(turnAccess)
-                : this.parkHandler,
+            park: parkOverride ??
+                (turnAccess
+                    ? this.createTurnAwareParkHandler(turnAccess)
+                    : this.parkHandler),
         };
     }
+    /** Tear down the session: abort in-flight work and reset all per-connection state. */
     close() {
         this.signalSource?.abort();
         this.unwatch();
         this.transactionPlans = [];
         this.transactionDirty = false;
         this.sessionMode = 'normal';
+        this.clusterReadOnlyMode = false;
     }
+    /**
+     * Wrap the base park handler so that parking also yields the command's turn.
+     *
+     * Blocking commands (BLPOP, BRPOP, ...) must not hold the database turn while
+     * they wait, or no other client could ever produce the value that unblocks
+     * them — a deadlock. The flow:
+     *  1. Start the underlying park, capturing its eventual value.
+     *  2. Clear the local turn and call `turn.suspend(parked)`, which releases the
+     *     turn back to the queue and resolves with a fresh turn once the park
+     *     settles and this session is scheduled again.
+     *  3. Store the new turn (so `finally`/subsequent parks see it) and return the
+     *     parked value.
+     *
+     * If there is no current turn, fall back to plain parking.
+     */
     createTurnAwareParkHandler(turnAccess) {
         return async (request) => {
             const turn = turnAccess.get();

package/dist/core/client-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-session.js","sourceRoot":"","sources":["../../src/core/client-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-session.js","sourceRoot":"","sources":["../../src/core/client-session.ts"],"names":[],"mappings":"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"}

package/dist/core/command-executor.d.ts

@@ -4,21 +4,100 @@ import type { ExecutionPolicy } from './execution-policies';
 import type { RedisExecutionContext } from './redis-context';
 import { RedisResult } from './redis-result';
 import { ResponseStream } from './response-stream';
+/**
+ * The result of running a command: either a finished {@link RedisResult} or a
+ * long-lived {@link ResponseStream} (e.g. SUBSCRIBE / MONITOR) whose frames the
+ * transport drains over time.
+ */
 export type ExecutorResult = RedisResult | ResponseStream;
 export type CommandExecutorOptions = {
     registry: CommandRegistry;
     policies?: readonly ExecutionPolicy[];
 };
+/**
+ * Central command pipeline shared by every client session.
+ *
+ * Responsibilities:
+ *  1. Resolve a raw command name to a {@link CommandDefinition} (case-insensitive).
+ *  2. Parse raw argument buffers into typed args and extract routing keys,
+ *     producing a {@link CommandPlan}.
+ *  3. Run the configured {@link ExecutionPolicy} chain around the command's own
+ *     `execute`, giving policies (transaction, cluster, ...) a chance to
+ *     short-circuit, rewrite, or wrap the result.
+ *
+ * Two execution paths exist on purpose:
+ *  - {@link executePlan} / {@link executeRaw} — async, used for real network
+ *    clients; may return a {@link ResponseStream} and may await async commands.
+ *  - {@link executePlanSync} — synchronous mirror used by the Lua runtime, where
+ *    `redis.call` must complete in a single tick. Streams and promises are
+ *    rejected rather than awaited.
+ *
+ * The executor is stateless per-call: all mutable state lives on the
+ * {@link RedisExecutionContext} (and the session it carries).
+ */
 export declare class CommandExecutor {
     private readonly registry;
     private readonly policies;
     constructor(options: CommandExecutorOptions);
     getCommandDefinition(name: string): CommandDefinition<unknown> | undefined;
     getCommandDefinitions(): readonly CommandDefinition<unknown>[];
+    /**
+     * Resolve a raw command + args into a {@link CommandPlan} without executing it.
+     * The command name is matched case-insensitively against the registry.
+     *
+     * @throws {UnknownRedisCommandError} if no command is registered under the name.
+     */
     plan(rawCommand: Buffer | string, rawArgs: readonly Buffer[]): CommandPlan;
+    /**
+     * Plan and execute a raw command in one step — the normal entry point for a
+     * network client.
+     *
+     * Errors thrown during *planning* (unknown command, arity/parse failures) are
+     * caught here and converted into a RESP error reply. Such a failure also marks
+     * any open MULTI transaction dirty so a later EXEC is aborted, matching Redis:
+     * a command that cannot even be parsed must not silently vanish from the queue.
+     * Execution-time errors are handled inside {@link executePlan}.
+     */
     executeRaw(rawCommand: Buffer | string, rawArgs: readonly Buffer[], ctx: RedisExecutionContext): Promise<ExecutorResult>;
+    private static normalizeCommandName;
+    /**
+     * Run a pre-built plan through the full async pipeline.
+     *
+     * Order of operations:
+     *  1. `beforeExecute` for each policy. The first policy that returns a result
+     *     short-circuits execution (e.g. the transaction policy queues the command
+     *     and returns "+QUEUED"; the cluster policy returns a MOVED/CROSSSLOT
+     *     error). A short-circuit error during MULTI also dirties the transaction.
+     *  2. The command's own `execute`.
+     *  3. If a {@link ResponseStream} is produced, run it through every policy's
+     *     `onStream` hook; otherwise await the value and run it through every
+     *     `afterExecute` hook (each may replace the result).
+     *
+     * Execution-time {@link RedisCommandError}s become RESP error replies (and
+     * dirty an open transaction when appropriate). Non-Redis errors propagate.
+     */
     executePlan(plan: CommandPlan, ctx: RedisExecutionContext): Promise<ExecutorResult>;
+    /**
+     * Synchronous counterpart to {@link executePlan}, used by the Lua runtime for
+     * `redis.call` / `redis.pcall`. Lua expects each nested command to resolve
+     * immediately, so anything that would require awaiting — a command that
+     * returns a promise, a {@link ResponseStream}, or an async policy hook — is
+     * rejected with a {@link RedisCommandError} instead of being awaited. Async
+     * command definitions are rejected before invocation so they cannot leave
+     * orphaned work running after the script error (see
+     * {@link assertSyncCommandDefinition}, {@link assertSyncCommandResult}, and
+     * {@link assertSyncPolicyResult}).
+     *
+     * The policy chain and transaction-dirty handling otherwise mirror the async
+     * path exactly.
+     */
     executePlanSync(plan: CommandPlan, ctx: RedisExecutionContext): RedisResult;
+    /**
+     * Build a {@link CommandPlan} from a resolved definition: parse the raw buffers
+     * against the command's schema (may throw arity/type errors) and extract the
+     * routing keys used for cluster slot validation. Flags are copied onto the plan
+     * so policies can inspect them without re-resolving the definition.
+     */
     private createPlan;
 }
 //# sourceMappingURL=command-executor.d.ts.map

package/dist/core/command-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/core/command-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAoB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEpE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAA;AAEzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACtC,CAAA;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,OAAO,EAAE,sBAAsB;IAK3C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI1E,qBAAqB,IAAI,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAI9D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW;IAcpE,UAAU,CACd,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IAapB,WAAW,CACf,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IAgD1B,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,qBAAqB,GAAG,WAAW;IA4C3E,OAAO,CAAC,UAAU;CAcnB"}
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/core/command-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAO3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAoB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEpE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAA;AAEzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,OAAO,EAAE,sBAAsB;IAK3C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI1E,qBAAqB,IAAI,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAI9D;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW;IAW1E;;;;;;;;;OASG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IA2B1B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAMnC;;;;;;;;;;;;;;;OAeG;IACG,WAAW,CACf,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IAgD1B;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,qBAAqB,GAAG,WAAW;IA6C3E;;;;;OAKG;IACH,OAAO,CAAC,UAAU;CAcnB"}