pipeline.ts

import type { Connection, SendCommandOptions } from "./connection.ts";
import { kEmptyRedisArgs } from "./connection.ts";
import { CommandExecutor } from "./executor.ts";
import {
  okReply,
  RawOrError,
  RedisReply,
  RedisValue,
} from "./protocol/shared/types.ts";
import { create, Redis } from "./redis.ts";
import { kUnstablePipeline } from "./internal/symbols.ts";

export interface RedisPipeline extends Redis {
  flush(): Promise<RawOrError[]>;
}

export function createRedisPipeline(
  connection: Connection,
  tx = false,
): RedisPipeline {
  const executor = new PipelineExecutor(connection, tx);
  function flush(): Promise<RawOrError[]> {
    return executor.flush();
  }
  const client = create(executor);
  return Object.assign(client, { flush });
}

export class PipelineExecutor implements CommandExecutor {
  private commands: {
    command: string;
    args: RedisValue[];
    returnUint8Arrays?: boolean;
  }[] = [];
  private queue: {
    commands: {
      command: string;
      args: RedisValue[];
      returnUint8Arrays?: boolean;
    }[];
    resolve: (value: RawOrError[]) => void;
    reject: (error: unknown) => void;
  }[] = [];

  constructor(
    readonly connection: Connection,
    private tx: boolean,
  ) {
  }

  exec(
    command: string,
    ...args: RedisValue[]
  ): Promise<RedisReply> {
    return this.sendCommand(command, args);
  }

  sendCommand(
    command: string,
    args?: RedisValue[],
    options?: SendCommandOptions,
  ): Promise<RedisReply> {
    this.commands.push({
      command,
      args: args ?? kEmptyRedisArgs,
      returnUint8Arrays: options?.returnUint8Arrays,
    });
    return Promise.resolve(okReply);
  }

  close(): void {
    return this.connection.close();
  }

  flush(): Promise<RawOrError[]> {
    if (this.tx) {
      this.commands.unshift({ command: "MULTI", args: [] });
      this.commands.push({ command: "EXEC", args: [] });
    }
    const { promise, resolve, reject } = Promise.withResolvers<RawOrError[]>();
    this.queue.push({ commands: [...this.commands], resolve, reject });
    if (this.queue.length === 1) {
      this.dequeue();
    }
    this.commands = [];
    return promise;
  }

  private dequeue(): void {
    const [e] = this.queue;
    if (!e) return;
    this.connection[kUnstablePipeline](e.commands)
      .then(e.resolve)
      .catch(e.reject)
      .finally(() => {
        this.queue.shift();
        this.dequeue();
      });
  }
}