trzsz2 1.0.0

package/dist/esm/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","sources":["../../src/transfer.ts"],"sourcesContent":["/**\n * trzsz2: https://github.com/zxdong262/trzsz2\n * Copyright(c) 2024 Lonny Wong\n * @license MIT\n *\n * Pure protocol implementation without fs/browser dependencies.\n */\n\nimport { Md5 } from 'ts-md5'\nimport { TrzszBuffer } from './buffer'\nimport { escapeCharsToCodes, escapeData, unescapeData } from './escape'\nimport {\n  trzszVersion,\n  uint8ToStr,\n  encodeBuffer,\n  decodeBuffer,\n  TmuxMode,\n  TrzszError,\n  type TrzszFile,\n  type OpenSaveFile,\n  type TrzszFileReader,\n  type TrzszFileWriter,\n  type ProgressCallback,\n  stripTmuxStatusLine\n} from './comm'\n\n/**\n * TrzszTransfer class for handling file transfer protocol.\n */\nexport class TrzszTransfer {\n  private readonly buffer: TrzszBuffer = new TrzszBuffer()\n  private readonly writer: (data: string | Uint8Array) => void\n  private readonly isWindowsShell: boolean\n  private remoteIsWindows: boolean = false\n  private lastInputTime: number = 0\n  private readonly openedFiles: TrzszFile[] = []\n  private readonly createdFiles: TrzszFileWriter[] = []\n  private tmuxOutputJunk: boolean = false\n  private cleanTimeoutInMilliseconds: number = 100\n  private transferConfig: Record<string, unknown> = {}\n  private stopped: boolean = false\n  private maxChunkTimeInMilliseconds: number = 0\n  private protocolNewline: string = '\\n'\n\n  /**\n   * Create a TrzszTransfer.\n   * @param writer - The output writer function.\n   * @param isWindowsShell - Whether the shell is Windows.\n   */\n  public constructor (writer: (data: string | Uint8Array) => void, isWindowsShell: boolean = false) {\n    this.writer = writer\n    this.isWindowsShell = isWindowsShell\n  }\n\n  /**\n   * Cleanup resources.\n   */\n  public cleanup (): void {\n    for (const file of this.openedFiles) {\n      file.closeFile()\n    }\n  }\n\n  /**\n   * Add received data to the buffer.\n   * @param data - The received data.\n   */\n  public addReceivedData (data: string | ArrayBuffer | Uint8Array | Blob): void {\n    if (!this.stopped) {\n      this.buffer.addBuffer(data)\n    }\n    this.lastInputTime = Date.now()\n  }\n\n  /**\n   * Stop transferring.\n   */\n  public async stopTransferring (): Promise<void> {\n    this.cleanTimeoutInMilliseconds = Math.max(this.maxChunkTimeInMilliseconds * 2, 500)\n    this.stopped = true\n    this.buffer.stopBuffer()\n  }\n\n  /**\n   * Clean input buffer.\n   * @param timeoutInMilliseconds - The timeout in milliseconds.\n   */\n  private async cleanInput (timeoutInMilliseconds: number): Promise<void> {\n    this.stopped = true\n    this.buffer.drainBuffer()\n    this.lastInputTime = Date.now()\n    while (true) {\n      const sleepTime = timeoutInMilliseconds - (Date.now() - this.lastInputTime)\n      if (sleepTime <= 0) {\n        return\n      }\n      await new Promise((resolve) => setTimeout(resolve, sleepTime))\n    }\n  }\n\n  /**\n   * Send a line.\n   * @param typ - The type.\n   * @param buf - The buffer.\n   */\n  private async sendLine (typ: string, buf: string): Promise<void> {\n    this.writer(`#${typ}:${buf}${this.protocolNewline}`)\n  }\n\n  /**\n   * Receive a line.\n   * @param expectType - The expected type.\n   * @param mayHasJunk - Whether there may be junk.\n   */\n  private async recvLine (expectType: string, mayHasJunk: boolean = false): Promise<string> {\n    if (this.stopped) {\n      throw new TrzszError('Stopped')\n    }\n\n    if (this.isWindowsShell || this.remoteIsWindows) {\n      let line = await this.buffer.readLineOnWindows()\n      const idx = line.lastIndexOf('#' + expectType + ':')\n      if (idx >= 0) {\n        line = line.substring(idx)\n      } else {\n        const idx = line.lastIndexOf('#')\n        if (idx > 0) {\n          line = line.substring(idx)\n        }\n      }\n      return line\n    }\n\n    let line = await this.buffer.readLine()\n\n    if (this.tmuxOutputJunk || mayHasJunk) {\n      if (line.length > 0) {\n        while (line[line.length - 1] === '\\r') {\n          line = line.substring(0, line.length - 1) + (await this.buffer.readLine())\n        }\n      }\n      const idx = line.lastIndexOf('#' + expectType + ':')\n      if (idx >= 0) {\n        line = line.substring(idx)\n      } else {\n        const idx = line.lastIndexOf('#')\n        if (idx > 0) {\n          line = line.substring(idx)\n        }\n      }\n      line = stripTmuxStatusLine(line)\n    }\n\n    return line\n  }\n\n  /**\n   * Receive and check a line.\n   * @param expectType - The expected type.\n   * @param mayHasJunk - Whether there may be junk.\n   */\n  private async recvCheck (expectType: string, mayHasJunk: boolean = false): Promise<string> {\n    const line = await this.recvLine(expectType, mayHasJunk)\n    const idx = line.indexOf(':')\n    if (idx < 1) {\n      throw new TrzszError(encodeBuffer(line), 'colon', true)\n    }\n    const typ = line.substring(1, idx)\n    const buf = line.substring(idx + 1)\n    if (typ !== expectType) {\n      throw new TrzszError(buf, typ, true)\n    }\n    return buf\n  }\n\n  /**\n   * Send an integer.\n   * @param typ - The type.\n   * @param val - The value.\n   */\n  private async sendInteger (typ: string, val: number): Promise<void> {\n    await this.sendLine(typ, val.toString())\n  }\n\n  /**\n   * Receive an integer.\n   * @param typ - The type.\n   * @param mayHasJunk - Whether there may be junk.\n   */\n  private async recvInteger (typ: string, mayHasJunk: boolean = false): Promise<number> {\n    const buf = await this.recvCheck(typ, mayHasJunk)\n    return Number(buf)\n  }\n\n  /**\n   * Check an integer.\n   * @param expect - The expected value.\n   */\n  private async checkInteger (expect: number): Promise<void> {\n    const result = await this.recvInteger('SUCC')\n    if (result !== expect) {\n      throw new TrzszError(`Integer check [${result}] <> [${expect}]`, null, true)\n    }\n  }\n\n  /**\n   * Send a string.\n   * @param typ - The type.\n   * @param str - The string.\n   */\n  private async sendString (typ: string, str: string): Promise<void> {\n    await this.sendLine(typ, encodeBuffer(str))\n  }\n\n  /**\n   * Receive a string.\n   * @param typ - The type.\n   * @param mayHasJunk - Whether there may be junk.\n   */\n  private async recvString (typ: string, mayHasJunk: boolean = false): Promise<string> {\n    const buf = await this.recvCheck(typ, mayHasJunk)\n    return await uint8ToStr(decodeBuffer(buf), 'utf8')\n  }\n\n  /**\n   * Check a string.\n   * @param expect - The expected string.\n   */\n  protected async checkString (expect: string): Promise<void> {\n    const result = await this.recvString('SUCC')\n    if (result !== expect) {\n      throw new TrzszError(`String check [${result}] <> [${expect}]`, null, true)\n    }\n  }\n\n  /**\n   * Send binary data.\n   * @param typ - The type.\n   * @param buf - The buffer.\n   */\n  private async sendBinary (typ: string, buf: Uint8Array): Promise<void> {\n    await this.sendLine(typ, encodeBuffer(buf))\n  }\n\n  /**\n   * Receive binary data.\n   * @param typ - The type.\n   * @param mayHasJunk - Whether there may be junk.\n   */\n  private async recvBinary (typ: string, mayHasJunk: boolean = false): Promise<Uint8Array> {\n    const buf = await this.recvCheck(typ, mayHasJunk)\n    return decodeBuffer(buf)\n  }\n\n  /**\n   * Check binary data.\n   * @param expect - The expected buffer.\n   */\n  private async checkBinary (expect: Uint8Array): Promise<void> {\n    const result = await this.recvBinary('SUCC')\n    if (result.length !== expect.length) {\n      throw new TrzszError(\n        `Binary length check [${result.length}] <> [${expect.length}]`,\n        null,\n        true\n      )\n    }\n    for (let i = 0; i < result.length; i++) {\n      if (result[i] !== expect[i]) {\n        throw new TrzszError(`Binary check [${result[i]}] <> [${expect[i]}]`, null, true)\n      }\n    }\n  }\n\n  /**\n   * Send data.\n   * @param data - The data.\n   * @param binary - Whether to use binary mode.\n   * @param escapeCodes - The escape codes.\n   */\n  private async sendData (\n    data: Uint8Array,\n    binary: boolean,\n    escapeCodes: number[][]\n  ): Promise<void> {\n    if (!binary) {\n      await this.sendBinary('DATA', data)\n      return\n    }\n\n    const buf = escapeData(data, escapeCodes)\n    this.writer(`#DATA:${buf.length}\\n`)\n    this.writer(buf)\n  }\n\n  /**\n   * Receive data.\n   * @param binary - Whether to use binary mode.\n   * @param escapeCodes - The escape codes.\n   * @param timeoutInMilliseconds - The timeout in milliseconds.\n   */\n  private async recvData (\n    binary: boolean,\n    escapeCodes: number[][],\n    timeoutInMilliseconds: number\n  ): Promise<Uint8Array> {\n    return await Promise.race<Uint8Array>([\n      new Promise<Uint8Array>((_resolve, reject) =>\n        setTimeout(() => {\n          this.cleanTimeoutInMilliseconds = 3000\n          reject(new TrzszError('Receive data timeout'))\n        }, timeoutInMilliseconds)\n      ),\n      (async () => {\n        if (!binary) {\n          return await this.recvBinary('DATA')\n        }\n        const size = await this.recvInteger('DATA')\n        const data = await this.buffer.readBinary(size)\n        return unescapeData(data, escapeCodes)\n      })()\n    ])\n  }\n\n  /**\n   * Send action.\n   * @param confirm - Whether to confirm.\n   * @param remoteIsWindows - Whether the remote is Windows.\n   */\n  public async sendAction (confirm: boolean, remoteIsWindows: boolean): Promise<void> {\n    const action: Record<string, unknown> = {\n      lang: 'js',\n      confirm,\n      version: trzszVersion,\n      support_dir: true\n    }\n    if (this.isWindowsShell || remoteIsWindows) {\n      action.binary = false\n      action.newline = '!\\n'\n    }\n    if (remoteIsWindows) {\n      this.remoteIsWindows = true\n      this.protocolNewline = '!\\n'\n    }\n    await this.sendString('ACT', JSON.stringify(action))\n  }\n\n  /**\n   * Receive action.\n   */\n  public async recvAction (): Promise<Record<string, unknown>> {\n    const buf = await this.recvString('ACT', true)\n    const action = JSON.parse(buf)\n    const newline = (action as Record<string, unknown>).newline as string | undefined\n    if (typeof newline === 'string' && newline.length > 0) {\n      this.protocolNewline = newline\n    }\n    return action\n  }\n\n  /**\n   * Send config.\n   * @param args - The config arguments.\n   * @param escapeChars - The escape characters.\n   * @param tmuxMode - The tmux mode.\n   * @param tmuxPaneWidth - The tmux pane width.\n   */\n  public async sendConfig (\n    args: Record<string, unknown>,\n    escapeChars: string[][],\n    tmuxMode: number,\n    tmuxPaneWidth: number\n  ): Promise<void> {\n    const config: Record<string, unknown> = { lang: 'js' }\n    if ((args).quiet === true) {\n      config.quiet = true\n    }\n    if ((args).binary === true) {\n      config.binary = true\n      config.escape_chars = escapeChars\n    }\n    if ((args).directory === true) {\n      config.directory = true\n    }\n    if (typeof (args).bufsize === 'number') {\n      config.bufsize = (args).bufsize\n    }\n    if (typeof (args).timeout === 'number') {\n      config.timeout = (args).timeout\n    }\n    if ((args).overwrite === true) {\n      config.overwrite = true\n    }\n    if (tmuxMode === TmuxMode.TmuxNormalMode) {\n      config.tmux_output_junk = true\n    }\n    if (tmuxPaneWidth > 0) {\n      config.tmux_pane_width = tmuxPaneWidth\n    }\n    let jsonStr = JSON.stringify(config)\n    jsonStr = jsonStr.replace(/[\\u007F-\\uFFFF]/g, function (chr) {\n      return '\\\\u' + ('0000' + chr.charCodeAt(0).toString(16)).slice(-4)\n    })\n    this.transferConfig = config\n    await this.sendString('CFG', jsonStr)\n  }\n\n  /**\n   * Receive config.\n   */\n  public async recvConfig (): Promise<Record<string, unknown>> {\n    const buf = await this.recvString('CFG', true)\n    this.transferConfig = JSON.parse(buf)\n    this.tmuxOutputJunk = this.transferConfig.tmux_output_junk === true\n    return this.transferConfig\n  }\n\n  /**\n   * Send client exit.\n   * @param msg - The message.\n   */\n  public async clientExit (msg: string): Promise<void> {\n    await this.sendString('EXIT', msg)\n  }\n\n  /**\n   * Receive exit.\n   */\n  public async recvExit (): Promise<string> {\n    return await this.recvString('EXIT')\n  }\n\n  /**\n   * Delete created files.\n   */\n  private async deleteCreatedFiles (): Promise<string[]> {\n    const deletedFiles: string[] = []\n    for (const file of this.createdFiles) {\n      const path = await file.deleteFile()\n      if (typeof path === 'string' && path.length > 0) {\n        deletedFiles.push(path)\n      }\n    }\n    return deletedFiles\n  }\n\n  /**\n   * Handle client error.\n   * @param err - The error.\n   */\n  public async clientError (err: Error): Promise<void> {\n    await this.cleanInput(this.cleanTimeoutInMilliseconds)\n\n    const errMsg = TrzszError.getErrorMessage(err)\n    let trace = true\n    if (err instanceof TrzszError) {\n      trace = err.isTraceBack()\n      if (err.isRemoteExit()) {\n        return\n      }\n      if (err.isRemoteFail()) {\n        if (trace) {\n          console.log(errMsg)\n        }\n        return\n      }\n    }\n\n    await this.sendString(trace ? 'FAIL' : 'fail', errMsg)\n    if (trace) {\n      console.log(errMsg)\n    }\n  }\n\n  /**\n   * Handle server error.\n   * @param err - The error.\n   */\n  public async serverError (err: Error): Promise<void> {\n    await this.cleanInput(this.cleanTimeoutInMilliseconds)\n\n    const errMsg = TrzszError.getErrorMessage(err)\n    let trace = true\n    if (err instanceof TrzszError) {\n      if (err.isStopAndDelete()) {\n        const deletedFiles = await this.deleteCreatedFiles()\n        if (deletedFiles.length > 0) {\n          await this.serverExit([err.message + ':'].concat(deletedFiles).join('\\r\\n- '))\n          return\n        }\n      }\n      trace = err.isTraceBack()\n      if (err.isRemoteExit() || err.isRemoteFail()) {\n        await this.serverExit(errMsg)\n        return\n      }\n    }\n\n    await this.sendString(trace ? 'FAIL' : 'fail', errMsg)\n    await this.serverExit(errMsg)\n  }\n\n  /**\n   * Server exit - to be implemented by subclass or user.\n   * @param msg - The message.\n   */\n  public async serverExit (_msg: string): Promise<void> {\n    // Base implementation does nothing\n    // Subclasses or users should override this\n  }\n\n  /**\n   * Send file number.\n   * @param num - The number of files.\n   * @param progressCallback - The progress callback.\n   */\n  private async sendFileNum (num: number, progressCallback: ProgressCallback | null): Promise<void> {\n    await this.sendInteger('NUM', num)\n    await this.checkInteger(num)\n    if (progressCallback != null) {\n      progressCallback.onNum(num)\n    }\n  }\n\n  /**\n   * Send file name.\n   * @param file - The file reader.\n   * @param directory - Whether it's a directory.\n   * @param progressCallback - The progress callback.\n   */\n  private async sendFileName (\n    file: TrzszFileReader,\n    directory: boolean,\n    progressCallback: ProgressCallback | null\n  ): Promise<string> {\n    const relPath = file.getRelPath()\n    const fileName = relPath[relPath.length - 1]\n    if (directory) {\n      const jsonName = {\n        path_id: file.getPathId(),\n        path_name: relPath,\n        is_dir: file.isDir()\n      }\n      await this.sendString('NAME', JSON.stringify(jsonName))\n    } else {\n      await this.sendString('NAME', fileName)\n    }\n    const remoteName = await this.recvString('SUCC')\n    if (progressCallback != null) {\n      progressCallback.onName(fileName)\n    }\n    return remoteName\n  }\n\n  /**\n   * Send file size.\n   * @param size - The file size.\n   * @param progressCallback - The progress callback.\n   */\n  private async sendFileSize (\n    size: number,\n    progressCallback: ProgressCallback | null\n  ): Promise<void> {\n    await this.sendInteger('SIZE', size)\n    await this.checkInteger(size)\n    if (progressCallback != null) {\n      progressCallback.onSize(size)\n    }\n  }\n\n  /**\n   * Send file data.\n   * @param file - The file reader.\n   * @param size - The file size.\n   * @param binary - Whether to use binary mode.\n   * @param escapeCodes - The escape codes.\n   * @param maxBufSize - The maximum buffer size.\n   * @param progressCallback - The progress callback.\n   */\n  private async sendFileData (\n    file: TrzszFileReader,\n    size: number,\n    binary: boolean,\n    escapeCodes: number[][],\n    maxBufSize: number,\n    progressCallback: ProgressCallback | null\n  ): Promise<Uint8Array> {\n    let step = 0\n    if (progressCallback != null) {\n      progressCallback.onStep(step)\n    }\n    let bufSize = 1024\n    let buffer = new ArrayBuffer(bufSize)\n    const md5 = new Md5()\n    while (step < size) {\n      const beginTime = Date.now()\n      const data = await file.readFile(buffer)\n      await this.sendData(data, binary, escapeCodes)\n      md5.appendByteArray(data)\n      await this.checkInteger(data.length)\n      step += data.length\n      if (progressCallback != null) {\n        progressCallback.onStep(step)\n      }\n      const chunkTime = Date.now() - beginTime\n      if (data.length === bufSize && chunkTime < 500 && bufSize < maxBufSize) {\n        bufSize = Math.min(bufSize * 2, maxBufSize)\n        buffer = new ArrayBuffer(bufSize)\n      } else if (chunkTime >= 2000 && bufSize > 1024) {\n        bufSize = 1024\n        buffer = new ArrayBuffer(bufSize)\n      }\n      if (chunkTime > this.maxChunkTimeInMilliseconds) {\n        this.maxChunkTimeInMilliseconds = chunkTime\n      }\n    }\n    return new Uint8Array((md5.end(true) as Int32Array).buffer)\n  }\n\n  /**\n   * Send file MD5.\n   * @param digest - The MD5 digest.\n   * @param progressCallback - The progress callback.\n   */\n  private async sendFileMD5 (\n    digest: Uint8Array,\n    progressCallback: ProgressCallback | null\n  ): Promise<void> {\n    await this.sendBinary('MD5', digest)\n    await this.checkBinary(digest)\n    if (progressCallback != null) {\n      progressCallback.onDone()\n    }\n  }\n\n  /**\n   * Send files.\n   * @param files - The file readers.\n   * @param progressCallback - The progress callback.\n   */\n  public async sendFiles (\n    files: TrzszFileReader[],\n    progressCallback: ProgressCallback | null\n  ): Promise<string[]> {\n    this.openedFiles.push(...files)\n\n    const binary = this.transferConfig.binary === true\n    const directory = this.transferConfig.directory === true\n    const bufsizeVal = this.transferConfig.bufsize as number | undefined\n    const maxBufSize = typeof bufsizeVal === 'number' ? bufsizeVal : 10 * 1024 * 1024\n    const escapeCodes = Array.isArray(this.transferConfig.escape_chars)\n      ? escapeCharsToCodes(this.transferConfig.escape_chars as string[][])\n      : []\n\n    await this.sendFileNum(files.length, progressCallback)\n\n    const remoteNames: string[] = []\n    for (const file of files) {\n      const remoteName = await this.sendFileName(file, directory, progressCallback)\n\n      if (!remoteNames.includes(remoteName)) {\n        remoteNames.push(remoteName)\n      }\n\n      if (file.isDir()) {\n        continue\n      }\n\n      const size = file.getSize()\n      await this.sendFileSize(size, progressCallback)\n\n      const digest = await this.sendFileData(file, size, binary, escapeCodes, maxBufSize, progressCallback)\n      file.closeFile()\n\n      await this.sendFileMD5(digest, progressCallback)\n    }\n\n    return remoteNames\n  }\n\n  /**\n   * Receive file number.\n   * @param progressCallback - The progress callback.\n   */\n  private async recvFileNum (progressCallback: ProgressCallback | null): Promise<number> {\n    const num = await this.recvInteger('NUM')\n    await this.sendInteger('SUCC', num)\n    if (progressCallback != null) {\n      progressCallback.onNum(num)\n    }\n    return num\n  }\n\n  /**\n   * Receive file name.\n   * @param saveParam - The save parameter.\n   * @param openSaveFile - The open save file function.\n   * @param directory - Whether it's a directory.\n   * @param overwrite - Whether to overwrite.\n   * @param progressCallback - The progress callback.\n   */\n  private async recvFileName (\n    saveParam: unknown,\n    openSaveFile: OpenSaveFile,\n    directory: boolean,\n    overwrite: boolean,\n    progressCallback: ProgressCallback | null\n  ): Promise<TrzszFileWriter> {\n    const fileName = await this.recvString('NAME')\n    const file = await openSaveFile(saveParam, fileName, directory, overwrite)\n    this.createdFiles.push(file)\n    await this.sendString('SUCC', file.getLocalName())\n    if (progressCallback != null) {\n      progressCallback.onName(file.getFileName())\n    }\n    return file\n  }\n\n  /**\n   * Receive file size.\n   * @param progressCallback - The progress callback.\n   */\n  private async recvFileSize (progressCallback: ProgressCallback | null): Promise<number> {\n    const fileSize = await this.recvInteger('SIZE')\n    await this.sendInteger('SUCC', fileSize)\n    if (progressCallback != null) {\n      progressCallback.onSize(fileSize)\n    }\n    return fileSize\n  }\n\n  /**\n   * Receive file data.\n   * @param file - The file writer.\n   * @param size - The file size.\n   * @param binary - Whether to use binary mode.\n   * @param escapeCodes - The escape codes.\n   * @param timeoutInMilliseconds - The timeout in milliseconds.\n   * @param progressCallback - The progress callback.\n   */\n  private async recvFileData (\n    file: TrzszFileWriter,\n    size: number,\n    binary: boolean,\n    escapeCodes: number[][],\n    timeoutInMilliseconds: number,\n    progressCallback: ProgressCallback | null\n  ): Promise<Uint8Array> {\n    let step = 0\n    if (progressCallback != null) {\n      progressCallback.onStep(step)\n    }\n    const md5 = new Md5()\n    while (step < size) {\n      const beginTime = Date.now()\n      const data = await this.recvData(binary, escapeCodes, timeoutInMilliseconds)\n      await file.writeFile(data)\n      step += data.length\n      if (progressCallback != null) {\n        progressCallback.onStep(step)\n      }\n      await this.sendInteger('SUCC', data.length)\n      md5.appendByteArray(data)\n      const chunkTime = Date.now() - beginTime\n      if (chunkTime > this.maxChunkTimeInMilliseconds) {\n        this.maxChunkTimeInMilliseconds = chunkTime\n      }\n    }\n    return new Uint8Array((md5.end(true) as Int32Array).buffer)\n  }\n\n  /**\n   * Receive file MD5.\n   * @param digest - The MD5 digest.\n   * @param progressCallback - The progress callback.\n   */\n  private async recvFileMD5 (\n    digest: Uint8Array,\n    progressCallback: ProgressCallback | null\n  ): Promise<void> {\n    const expectDigest = await this.recvBinary('MD5')\n    if (digest.length !== expectDigest.length) {\n      throw new TrzszError('Check MD5 failed')\n    }\n    for (let j = 0; j < digest.length; j++) {\n      if (digest[j] !== expectDigest[j]) {\n        throw new TrzszError('Check MD5 failed')\n      }\n    }\n    await this.sendBinary('SUCC', digest)\n    if (progressCallback != null) {\n      progressCallback.onDone()\n    }\n  }\n\n  /**\n   * Receive files.\n   * @param saveParam - The save parameter.\n   * @param openSaveFile - The open save file function.\n   * @param progressCallback - The progress callback.\n   */\n  public async recvFiles (\n    saveParam: unknown,\n    openSaveFile: OpenSaveFile,\n    progressCallback: ProgressCallback | null\n  ): Promise<string[]> {\n    const binary = this.transferConfig.binary === true\n    const directory = this.transferConfig.directory === true\n    const overwrite = this.transferConfig.overwrite === true\n    const timeoutVal = this.transferConfig.timeout as number | undefined\n    const timeoutInMilliseconds = typeof timeoutVal === 'number' ? timeoutVal * 1000 : 100000\n    const escapeCodes = Array.isArray(this.transferConfig.escape_chars)\n      ? escapeCharsToCodes(this.transferConfig.escape_chars as string[][])\n      : []\n\n    const num = await this.recvFileNum(progressCallback)\n\n    const localNames: string[] = []\n    for (let i = 0; i < num; i++) {\n      const file = await this.recvFileName(\n        saveParam,\n        openSaveFile,\n        directory,\n        overwrite,\n        progressCallback\n      )\n\n      if (!localNames.includes(file.getLocalName())) {\n        localNames.push(file.getLocalName())\n      }\n\n      if (file.isDir()) {\n        continue\n      }\n\n      this.openedFiles.push(file)\n\n      const size = await this.recvFileSize(progressCallback)\n\n      const digest = await this.recvFileData(\n        file,\n        size,\n        binary,\n        escapeCodes,\n        timeoutInMilliseconds,\n        progressCallback\n      )\n      file.closeFile()\n\n      await this.recvFileMD5(digest, progressCallback)\n    }\n\n    return localNames\n  }\n}\n"],"names":["line","idx"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * trzsz2: https://github.com/zxdong262/trzsz2
+ * Copyright(c) 2024 Lonny Wong
+ * @license MIT
+ *
+ * Pure protocol implementation without fs/browser dependencies.
+ */
+export { trzszVersion } from './comm';
+export type { TrzszFile, TrzszFileReader, TrzszFileWriter, OpenSaveFile, ProgressCallback, TmuxModeType } from './comm';
+export type { TrzszOptions } from './options';
+export { TrzszError } from './comm';
+export { TrzszBuffer } from './buffer';
+export { TrzszTransfer } from './transfer';
+export { TextProgressBar } from './progress';
+export { strToUint8, uint8ToStr, strToArrBuf, encodeBuffer, decodeBuffer, checkDuplicateNames, isArrayOfType, isVT100End, stripServerOutput, formatSavedFiles, stripTmuxStatusLine, TmuxMode } from './comm';
+export { getEscapeChars, escapeCharsToCodes, escapeData, unescapeData } from './escape';
+export { getEllipsisString } from './progress';

package/dist/options.d.ts

@@ -0,0 +1,57 @@
+/**
+ * trzsz2: https://github.com/zxdong262/trzsz2
+ * Copyright(c) 2024 Lonny Wong
+ * @license MIT
+ *
+ * Pure protocol implementation without fs/browser dependencies.
+ */
+/**
+ * The trzsz options interface.
+ */
+export interface TrzszOptions {
+    /**
+     * Write the server output to the terminal.
+     * @param output - The server output.
+     */
+    writeToTerminal?: (output: string | ArrayBuffer | Uint8Array | Blob) => void;
+    /**
+     * Send the terminal input (aka: user input) to the server.
+     * @param input - The terminal input (aka: user input).
+     */
+    sendToServer?: (input: string | Uint8Array) => void;
+    /**
+     * Choose some files to be sent to the server.
+     * No need for webshell or which running in a browser.
+     * @param directory - choose directories and files, or just files.
+     * @return The file paths array to be sent.
+     *         undefined means the user has cancelled.
+     */
+    chooseSendFiles?: (directory?: boolean) => Promise<string[] | undefined>;
+    /**
+     * Choose a directory to save the received files.
+     * No need for webshell or which running in a browser.
+     * @return The directory to save the received files.
+     *         undefined means the user has cancelled.
+     */
+    chooseSaveDirectory?: () => Promise<string | undefined>;
+    /**
+     * @deprecated A user event may be required to open the save dialog in browsers.
+     * No need for nodejs environment ( e.g.: electron preload.js )
+     * @param fileName - The file name going to download.
+     * @return open the save dialog or cancel the download.
+     */
+    requireUserPermission?: (fileName: string) => Promise<boolean>;
+    /**
+     * The columns of terminal.
+     */
+    terminalColumns?: number;
+    /**
+     * Is there a windows shell? Such as `cmd` and `PowerShell`.
+     */
+    isWindowsShell?: boolean;
+    /**
+     * The timeout in milliseconds for initializing drag and drop files to upload.
+     * Default is 3000.
+     */
+    dragInitTimeout?: number | undefined | null;
+}

package/dist/progress.d.ts

@@ -0,0 +1,100 @@
+import { ProgressCallback } from './comm';
+/**
+ * Get ellipsis string if the string is too long.
+ * @param str - The input string.
+ * @param max - The maximum length.
+ * @return The ellipsis string and its length.
+ */
+export declare function getEllipsisString(str: string, max: number): {
+    sub: string;
+    len: number;
+};
+/**
+ * TextProgressBar class for displaying file transfer progress.
+ */
+export declare class TextProgressBar implements ProgressCallback {
+    private readonly writer;
+    private lastUpdateTime;
+    private columns;
+    private fileCount;
+    private fileIdx;
+    private fileName;
+    private fileSize;
+    private fileStep;
+    private startTime;
+    private tmuxPaneColumns;
+    private firstWrite;
+    private speedCnt;
+    private speedIdx;
+    private timeArray;
+    private stepArray;
+    /**
+     * Create a TextProgressBar.
+     * @param writer - The output writer function.
+     * @param columns - The terminal columns.
+     * @param tmuxPaneColumns - The tmux pane columns (optional).
+     */
+    constructor(writer: (output: string) => void, columns: number, tmuxPaneColumns?: number | undefined);
+    /**
+     * Set the terminal columns.
+     * @param columns - The terminal columns.
+     */
+    setTerminalColumns(columns: number): void;
+    /**
+     * Called when the number of files is known.
+     * @param num - The number of files.
+     */
+    onNum(num: number): void;
+    /**
+     * Called when a file name is known.
+     * @param name - The file name.
+     */
+    onName(name: string): void;
+    /**
+     * Called when the file size is known.
+     * @param size - The file size.
+     */
+    onSize(size: number): void;
+    /**
+     * Called when a step is completed.
+     * @param step - The step number.
+     */
+    onStep(step: number): void;
+    /**
+     * Hide the cursor.
+     */
+    hideCursor(): void;
+    /**
+     * Show the cursor.
+     */
+    showCursor(): void;
+    /**
+     * Show the progress.
+     */
+    private showProgress;
+    /**
+     * Get the current transfer speed.
+     * @param now - The current time.
+     * @return The speed in bytes per second.
+     */
+    private getSpeed;
+    /**
+     * Get the progress text.
+     * @param percentage - The percentage string.
+     * @param total - The total string.
+     * @param speed - The speed string.
+     * @param eta - The ETA string.
+     * @return The progress text.
+     */
+    private getProgressText;
+    /**
+     * Get the progress bar string.
+     * @param len - The length of the bar.
+     * @return The progress bar string.
+     */
+    private getProgressBar;
+    /**
+     * Called when the transfer is done.
+     */
+    onDone(): void;
+}

package/dist/transfer.d.ts

@@ -0,0 +1,259 @@
+import { OpenSaveFile, TrzszFileReader, ProgressCallback } from './comm';
+/**
+ * TrzszTransfer class for handling file transfer protocol.
+ */
+export declare class TrzszTransfer {
+    private readonly buffer;
+    private readonly writer;
+    private readonly isWindowsShell;
+    private remoteIsWindows;
+    private lastInputTime;
+    private readonly openedFiles;
+    private readonly createdFiles;
+    private tmuxOutputJunk;
+    private cleanTimeoutInMilliseconds;
+    private transferConfig;
+    private stopped;
+    private maxChunkTimeInMilliseconds;
+    private protocolNewline;
+    /**
+     * Create a TrzszTransfer.
+     * @param writer - The output writer function.
+     * @param isWindowsShell - Whether the shell is Windows.
+     */
+    constructor(writer: (data: string | Uint8Array) => void, isWindowsShell?: boolean);
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+    /**
+     * Add received data to the buffer.
+     * @param data - The received data.
+     */
+    addReceivedData(data: string | ArrayBuffer | Uint8Array | Blob): void;
+    /**
+     * Stop transferring.
+     */
+    stopTransferring(): Promise<void>;
+    /**
+     * Clean input buffer.
+     * @param timeoutInMilliseconds - The timeout in milliseconds.
+     */
+    private cleanInput;
+    /**
+     * Send a line.
+     * @param typ - The type.
+     * @param buf - The buffer.
+     */
+    private sendLine;
+    /**
+     * Receive a line.
+     * @param expectType - The expected type.
+     * @param mayHasJunk - Whether there may be junk.
+     */
+    private recvLine;
+    /**
+     * Receive and check a line.
+     * @param expectType - The expected type.
+     * @param mayHasJunk - Whether there may be junk.
+     */
+    private recvCheck;
+    /**
+     * Send an integer.
+     * @param typ - The type.
+     * @param val - The value.
+     */
+    private sendInteger;
+    /**
+     * Receive an integer.
+     * @param typ - The type.
+     * @param mayHasJunk - Whether there may be junk.
+     */
+    private recvInteger;
+    /**
+     * Check an integer.
+     * @param expect - The expected value.
+     */
+    private checkInteger;
+    /**
+     * Send a string.
+     * @param typ - The type.
+     * @param str - The string.
+     */
+    private sendString;
+    /**
+     * Receive a string.
+     * @param typ - The type.
+     * @param mayHasJunk - Whether there may be junk.
+     */
+    private recvString;
+    /**
+     * Check a string.
+     * @param expect - The expected string.
+     */
+    protected checkString(expect: string): Promise<void>;
+    /**
+     * Send binary data.
+     * @param typ - The type.
+     * @param buf - The buffer.
+     */
+    private sendBinary;
+    /**
+     * Receive binary data.
+     * @param typ - The type.
+     * @param mayHasJunk - Whether there may be junk.
+     */
+    private recvBinary;
+    /**
+     * Check binary data.
+     * @param expect - The expected buffer.
+     */
+    private checkBinary;
+    /**
+     * Send data.
+     * @param data - The data.
+     * @param binary - Whether to use binary mode.
+     * @param escapeCodes - The escape codes.
+     */
+    private sendData;
+    /**
+     * Receive data.
+     * @param binary - Whether to use binary mode.
+     * @param escapeCodes - The escape codes.
+     * @param timeoutInMilliseconds - The timeout in milliseconds.
+     */
+    private recvData;
+    /**
+     * Send action.
+     * @param confirm - Whether to confirm.
+     * @param remoteIsWindows - Whether the remote is Windows.
+     */
+    sendAction(confirm: boolean, remoteIsWindows: boolean): Promise<void>;
+    /**
+     * Receive action.
+     */
+    recvAction(): Promise<Record<string, unknown>>;
+    /**
+     * Send config.
+     * @param args - The config arguments.
+     * @param escapeChars - The escape characters.
+     * @param tmuxMode - The tmux mode.
+     * @param tmuxPaneWidth - The tmux pane width.
+     */
+    sendConfig(args: Record<string, unknown>, escapeChars: string[][], tmuxMode: number, tmuxPaneWidth: number): Promise<void>;
+    /**
+     * Receive config.
+     */
+    recvConfig(): Promise<Record<string, unknown>>;
+    /**
+     * Send client exit.
+     * @param msg - The message.
+     */
+    clientExit(msg: string): Promise<void>;
+    /**
+     * Receive exit.
+     */
+    recvExit(): Promise<string>;
+    /**
+     * Delete created files.
+     */
+    private deleteCreatedFiles;
+    /**
+     * Handle client error.
+     * @param err - The error.
+     */
+    clientError(err: Error): Promise<void>;
+    /**
+     * Handle server error.
+     * @param err - The error.
+     */
+    serverError(err: Error): Promise<void>;
+    /**
+     * Server exit - to be implemented by subclass or user.
+     * @param msg - The message.
+     */
+    serverExit(_msg: string): Promise<void>;
+    /**
+     * Send file number.
+     * @param num - The number of files.
+     * @param progressCallback - The progress callback.
+     */
+    private sendFileNum;
+    /**
+     * Send file name.
+     * @param file - The file reader.
+     * @param directory - Whether it's a directory.
+     * @param progressCallback - The progress callback.
+     */
+    private sendFileName;
+    /**
+     * Send file size.
+     * @param size - The file size.
+     * @param progressCallback - The progress callback.
+     */
+    private sendFileSize;
+    /**
+     * Send file data.
+     * @param file - The file reader.
+     * @param size - The file size.
+     * @param binary - Whether to use binary mode.
+     * @param escapeCodes - The escape codes.
+     * @param maxBufSize - The maximum buffer size.
+     * @param progressCallback - The progress callback.
+     */
+    private sendFileData;
+    /**
+     * Send file MD5.
+     * @param digest - The MD5 digest.
+     * @param progressCallback - The progress callback.
+     */
+    private sendFileMD5;
+    /**
+     * Send files.
+     * @param files - The file readers.
+     * @param progressCallback - The progress callback.
+     */
+    sendFiles(files: TrzszFileReader[], progressCallback: ProgressCallback | null): Promise<string[]>;
+    /**
+     * Receive file number.
+     * @param progressCallback - The progress callback.
+     */
+    private recvFileNum;
+    /**
+     * Receive file name.
+     * @param saveParam - The save parameter.
+     * @param openSaveFile - The open save file function.
+     * @param directory - Whether it's a directory.
+     * @param overwrite - Whether to overwrite.
+     * @param progressCallback - The progress callback.
+     */
+    private recvFileName;
+    /**
+     * Receive file size.
+     * @param progressCallback - The progress callback.
+     */
+    private recvFileSize;
+    /**
+     * Receive file data.
+     * @param file - The file writer.
+     * @param size - The file size.
+     * @param binary - Whether to use binary mode.
+     * @param escapeCodes - The escape codes.
+     * @param timeoutInMilliseconds - The timeout in milliseconds.
+     * @param progressCallback - The progress callback.
+     */
+    private recvFileData;
+    /**
+     * Receive file MD5.
+     * @param digest - The MD5 digest.
+     * @param progressCallback - The progress callback.
+     */
+    private recvFileMD5;
+    /**
+     * Receive files.
+     * @param saveParam - The save parameter.
+     * @param openSaveFile - The open save file function.
+     * @param progressCallback - The progress callback.
+     */
+    recvFiles(saveParam: unknown, openSaveFile: OpenSaveFile, progressCallback: ProgressCallback | null): Promise<string[]>;
+}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "trzsz2",
+  "version": "1.0.0",
+  "description": "A pure JavaScript/TypeScript implementation of trzsz protocol - file transfer similar to zmodem but more simple and efficient",
+  "keywords": [
+    "trzsz",
+    "file transfer",
+    "protocol",
+    "terminal",
+    "zmodem",
+    "rz",
+    "sz",
+    "upload",
+    "download"
+  ],
+  "homepage": "https://github.com/zxdong262/trzsz2#readme",
+  "bugs": {
+    "url": "https://github.com/zxdong262/trzsz2/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zxdong262/trzsz2.git"
+  },
+  "license": "MIT",
+  "author": "ZHAO Xudong <zxdong262@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    },
+    "./cjs-full": {
+      "require": {
+        "types": "./dist/cjs-full/index.d.ts",
+        "default": "./dist/cjs-full/index.cjs"
+      }
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "default": "./dist/browser/trzsz2.js"
+    }
+  },
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "browser": "./dist/browser/trzsz2.js",
+  "files": [
+    "dist",
+    "README.md",
+    "README.cn.md",
+    "LICENSE"
+  ],
+  "directories": {
+    "test": "test"
+  },
+  "scripts": {
+    "build": "node build/build-vite.mjs",
+    "build:esm": "vite build --config build/vite.config.esm.ts",
+    "build:cjs": "vite build --config build/vite.config.cjs.ts",
+    "build:cjs-full": "vite build --config build/vite.config.cjs-full.ts",
+    "build:browser": "vite build --config build/vite.config.browser.ts",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run test/unit",
+    "test:watch": "vitest",
+    "test:upload": "node test/integration/trzsz-upload.test.mjs",
+    "test:download": "node test/integration/trzsz-download.test.mjs",
+    "lint": "ts-standard --project tsconfig.eslint.json && standard test/**/*.js",
+    "fix": "ts-standard --fix --project tsconfig.eslint.json"
+  },
+  "dependencies": {
+    "pako": "^2.1.0",
+    "ts-md5": "^1.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/pako": "^2.0.4",
+    "ajv": "^8.18.0",
+    "esbuild": "^0.19.12",
+    "jsdom": "^28.1.0",
+    "ssh2": "^1.17.0",
+    "standard": "^17.1.0",
+    "ts-standard": "^12.0.2",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "standard": {
+    "env": [
+      "browser"
+    ],
+    "globals": [
+      "WebSocket",
+      "FileReader",
+      "atob",
+      "btoa"
+    ]
+  }
+}