trzsz2 1.0.0

package/dist/esm/buffer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * trzsz2: https://github.com/zxdong262/trzsz2
+ * Copyright(c) 2024 Lonny Wong
+ * @license MIT
+ *
+ * Pure protocol implementation without fs/browser dependencies.
+ */
+/**
+ * TrzszBuffer class for handling buffer operations.
+ */
+export declare class TrzszBuffer {
+    private bufArray;
+    private resolve;
+    private reject;
+    private bufHead;
+    private bufTail;
+    private nextIdx;
+    private nextBuf;
+    private arrBuf;
+    /**
+     * Add a buffer to the queue.
+     * @param buf - The buffer to add.
+     */
+    addBuffer(buf: string | ArrayBuffer | Uint8Array | Blob): void;
+    /**
+     * Stop the buffer and reject any pending operations.
+     */
+    stopBuffer(): void;
+    /**
+     * Drain all buffers.
+     */
+    drainBuffer(): void;
+    /**
+     * Convert a buffer to Uint8Array.
+     * @param buf - The buffer to convert.
+     * @return The resulting Uint8Array.
+     */
+    private toUint8Array;
+    /**
+     * Get the next buffer.
+     * @return The next buffer.
+     */
+    private nextBuffer;
+    /**
+     * Grow the buffer.
+     * @param dst - The destination buffer.
+     * @param idx - The current index.
+     * @param min - The minimum size needed.
+     * @return The grown buffer.
+     */
+    private growBuffer;
+    /**
+     * Append a buffer to another.
+     * @param dst - The destination buffer.
+     * @param idx - The current index.
+     * @param src - The source buffer.
+     * @return The resulting buffer.
+     */
+    private appendBuffer;
+    /**
+     * Read a line from the buffer.
+     * @return The line.
+     */
+    readLine(): Promise<string>;
+    /**
+     * Read binary data from the buffer.
+     * @param len - The length to read.
+     * @return The binary data.
+     */
+    readBinary(len: number): Promise<Uint8Array>;
+    /**
+     * Read a line on Windows (handles VT100 escape sequences).
+     * @return The line.
+     */
+    readLineOnWindows(): Promise<string>;
+}

package/dist/esm/buffer.js

@@ -0,0 +1,252 @@
+import { TrzszError, strToUint8, uint8ToStr, isVT100End } from "./comm.js";
+function isTrzszLetter(c) {
+  if (c >= 97 && c <= 122) {
+    return true;
+  }
+  if (c >= 65 && c <= 90) {
+    return true;
+  }
+  if (c >= 48 && c <= 57) {
+    return true;
+  }
+  if (c === 35 || c === 58 || c === 43 || c === 47 || c === 61) {
+    return true;
+  }
+  return false;
+}
+class TrzszBuffer {
+  constructor() {
+    this.bufArray = [];
+    this.resolve = null;
+    this.reject = null;
+    this.bufHead = 0;
+    this.bufTail = 0;
+    this.nextIdx = 0;
+    this.nextBuf = null;
+    this.arrBuf = new ArrayBuffer(128);
+  }
+  /**
+   * Add a buffer to the queue.
+   * @param buf - The buffer to add.
+   */
+  addBuffer(buf) {
+    this.bufArray[this.bufTail++] = buf;
+    if (this.resolve != null) {
+      this.resolve();
+      this.resolve = null;
+      this.reject = null;
+    }
+  }
+  /**
+   * Stop the buffer and reject any pending operations.
+   */
+  stopBuffer() {
+    if (this.reject != null) {
+      this.reject(new TrzszError("Stopped"));
+      this.reject = null;
+      this.resolve = null;
+    }
+  }
+  /**
+   * Drain all buffers.
+   */
+  drainBuffer() {
+    this.bufArray = [];
+    this.bufHead = 0;
+    this.bufTail = 0;
+  }
+  /**
+   * Convert a buffer to Uint8Array.
+   * @param buf - The buffer to convert.
+   * @return The resulting Uint8Array.
+   */
+  async toUint8Array(buf) {
+    if (typeof buf === "string") {
+      return strToUint8(buf);
+    } else if (buf instanceof ArrayBuffer) {
+      return new Uint8Array(buf);
+    } else if (buf instanceof Uint8Array) {
+      return buf;
+    } else if (buf instanceof Blob) {
+      const buffer = await buf.arrayBuffer();
+      return new Uint8Array(buffer);
+    } else {
+      throw new TrzszError("The buffer type is not supported", null, true);
+    }
+  }
+  /**
+   * Get the next buffer.
+   * @return The next buffer.
+   */
+  async nextBuffer() {
+    if (this.nextBuf != null && this.nextIdx < this.nextBuf.length) {
+      return this.nextBuf.subarray(this.nextIdx);
+    }
+    if (this.bufHead === this.bufTail) {
+      if (this.bufHead !== 0) {
+        this.bufHead = 0;
+        this.bufTail = 0;
+      }
+      await new Promise((resolve, reject) => {
+        this.resolve = resolve;
+        this.reject = reject;
+      });
+    }
+    const buf = this.bufArray[this.bufHead];
+    this.bufArray[this.bufHead] = null;
+    this.bufHead++;
+    if (buf == null) {
+      throw new TrzszError("Unexpected null buffer");
+    }
+    this.nextBuf = await this.toUint8Array(buf);
+    this.nextIdx = 0;
+    return this.nextBuf;
+  }
+  /**
+   * Grow the buffer.
+   * @param dst - The destination buffer.
+   * @param idx - The current index.
+   * @param min - The minimum size needed.
+   * @return The grown buffer.
+   */
+  growBuffer(dst, idx, min) {
+    const len = Math.max(dst.length * 2, idx + min);
+    this.arrBuf = new ArrayBuffer(len);
+    const buf = new Uint8Array(this.arrBuf);
+    buf.set(dst.subarray(0, idx));
+    return buf;
+  }
+  /**
+   * Append a buffer to another.
+   * @param dst - The destination buffer.
+   * @param idx - The current index.
+   * @param src - The source buffer.
+   * @return The resulting buffer.
+   */
+  appendBuffer(dst, idx, src) {
+    const buf = dst.length >= idx + src.length ? dst : this.growBuffer(dst, idx, src.length);
+    buf.set(src, idx);
+    return buf;
+  }
+  /**
+   * Read a line from the buffer.
+   * @return The line.
+   */
+  async readLine() {
+    let buf = new Uint8Array(this.arrBuf);
+    let len = 0;
+    while (true) {
+      let next = await this.nextBuffer();
+      const newLineIdx = next.indexOf(10);
+      if (newLineIdx >= 0) {
+        this.nextIdx += newLineIdx + 1;
+        next = next.subarray(0, newLineIdx);
+      } else {
+        this.nextIdx += next.length;
+      }
+      if (next.includes(3)) {
+        throw new TrzszError("Interrupted");
+      }
+      buf = this.appendBuffer(buf, len, next);
+      len += next.length;
+      if (newLineIdx >= 0) {
+        return await uint8ToStr(buf.subarray(0, len));
+      }
+    }
+  }
+  /**
+   * Read binary data from the buffer.
+   * @param len - The length to read.
+   * @return The binary data.
+   */
+  async readBinary(len) {
+    if (this.arrBuf.byteLength < len) {
+      this.arrBuf = new ArrayBuffer(len);
+    }
+    const buf = new Uint8Array(this.arrBuf, 0, len);
+    let idx = 0;
+    while (idx < len) {
+      const left = len - idx;
+      let next = await this.nextBuffer();
+      if (next.length > left) {
+        this.nextIdx += left;
+        next = next.subarray(0, left);
+      } else {
+        this.nextIdx += next.length;
+      }
+      buf.set(next, idx);
+      idx += next.length;
+    }
+    return buf;
+  }
+  /**
+   * Read a line on Windows (handles VT100 escape sequences).
+   * @return The line.
+   */
+  async readLineOnWindows() {
+    let buf = new Uint8Array(this.arrBuf);
+    let lastByte = 27;
+    let skipVT100 = false;
+    let hasNewline = false;
+    let mayDuplicate = false;
+    let hasCursorHome = false;
+    let preHasCursorHome = false;
+    let idx = 0;
+    while (true) {
+      let next = await this.nextBuffer();
+      const newLineIdx = next.indexOf(33);
+      if (newLineIdx >= 0) {
+        this.nextIdx += newLineIdx + 1;
+        next = next.subarray(0, newLineIdx);
+      } else {
+        this.nextIdx += next.length;
+      }
+      for (let i = 0; i < next.length; i++) {
+        const c = next[i];
+        if (c === 3) {
+          throw new TrzszError("Interrupted");
+        }
+        if (c === 10) {
+          hasNewline = true;
+        }
+        if (skipVT100) {
+          if (isVT100End(c)) {
+            skipVT100 = false;
+            if (c === 72 && lastByte >= 48 && lastByte <= 57) {
+              mayDuplicate = true;
+            }
+          }
+          if (lastByte === 91 && c === 72) {
+            hasCursorHome = true;
+          }
+          lastByte = c;
+        } else if (c === 27) {
+          skipVT100 = true;
+          lastByte = c;
+        } else if (isTrzszLetter(c)) {
+          if (mayDuplicate) {
+            mayDuplicate = false;
+            if (hasNewline && idx > 0 && (c === buf[idx - 1] || preHasCursorHome)) {
+              buf[idx - 1] = c;
+              continue;
+            }
+          }
+          if (idx >= buf.length) {
+            buf = this.growBuffer(buf, idx, next.length);
+          }
+          buf[idx++] = c;
+          preHasCursorHome = hasCursorHome;
+          hasCursorHome = false;
+          hasNewline = false;
+        }
+      }
+      if (newLineIdx >= 0 && idx > 0 && !skipVT100) {
+        return await uint8ToStr(buf.subarray(0, idx));
+      }
+    }
+  }
+}
+export {
+  TrzszBuffer
+};
+//# sourceMappingURL=buffer.js.map

package/dist/esm/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sources":["../../src/buffer.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 { strToUint8, uint8ToStr, TrzszError, isVT100End } from './comm'\n\n/**\n * Check if a character is a trzsz letter.\n * @param c - The character code.\n * @return True if it's a trzsz letter.\n */\nfunction isTrzszLetter (c: number): boolean {\n  if (c >= 0x61 && c <= 0x7a) {\n    // 'a' <= c && c <= 'z'\n    return true\n  }\n  if (c >= 0x41 && c <= 0x5a) {\n    // 'A' <= c && c <= 'Z'\n    return true\n  }\n  if (c >= 0x30 && c <= 0x39) {\n    // '0' <= c && c <= '9'\n    return true\n  }\n  if (c === 0x23 || c === 0x3a || c === 0x2b || c === 0x2f || c === 0x3d) {\n    // c == '#' || c == ':' || c == '+' || c == '/' || c == '='\n    return true\n  }\n  return false\n}\n\n/**\n * TrzszBuffer class for handling buffer operations.\n */\nexport class TrzszBuffer {\n  private bufArray: Array<string | ArrayBuffer | Uint8Array | Blob | null> = []\n  private resolve: (() => void) | null = null\n  private reject: ((err: Error) => void) | null = null\n  private bufHead: number = 0\n  private bufTail: number = 0\n  private nextIdx: number = 0\n  private nextBuf: Uint8Array | null = null\n  private arrBuf: ArrayBuffer = new ArrayBuffer(128)\n\n  /**\n   * Add a buffer to the queue.\n   * @param buf - The buffer to add.\n   */\n  public addBuffer (buf: string | ArrayBuffer | Uint8Array | Blob): void {\n    this.bufArray[this.bufTail++] = buf\n    if (this.resolve != null) {\n      this.resolve()\n      this.resolve = null\n      this.reject = null\n    }\n  }\n\n  /**\n   * Stop the buffer and reject any pending operations.\n   */\n  public stopBuffer (): void {\n    if (this.reject != null) {\n      this.reject(new TrzszError('Stopped'))\n      this.reject = null\n      this.resolve = null\n    }\n  }\n\n  /**\n   * Drain all buffers.\n   */\n  public drainBuffer (): void {\n    this.bufArray = []\n    this.bufHead = 0\n    this.bufTail = 0\n  }\n\n  /**\n   * Convert a buffer to Uint8Array.\n   * @param buf - The buffer to convert.\n   * @return The resulting Uint8Array.\n   */\n  private async toUint8Array (buf: string | ArrayBuffer | Uint8Array | Blob): Promise<Uint8Array> {\n    if (typeof buf === 'string') {\n      return strToUint8(buf)\n    } else if (buf instanceof ArrayBuffer) {\n      return new Uint8Array(buf)\n    } else if (buf instanceof Uint8Array) {\n      return buf\n    } else if (buf instanceof Blob) {\n      const buffer = await buf.arrayBuffer()\n      return new Uint8Array(buffer)\n    } else {\n      throw new TrzszError('The buffer type is not supported', null, true)\n    }\n  }\n\n  /**\n   * Get the next buffer.\n   * @return The next buffer.\n   */\n  private async nextBuffer (): Promise<Uint8Array> {\n    if ((this.nextBuf != null) && this.nextIdx < this.nextBuf.length) {\n      return this.nextBuf.subarray(this.nextIdx)\n    }\n    if (this.bufHead === this.bufTail) {\n      if (this.bufHead !== 0) {\n        this.bufHead = 0\n        this.bufTail = 0\n      }\n      await new Promise<void>((resolve, reject) => {\n        this.resolve = resolve\n        this.reject = reject\n      })\n    }\n    const buf = this.bufArray[this.bufHead]\n    this.bufArray[this.bufHead] = null\n    this.bufHead++\n    if (buf == null) {\n      throw new TrzszError('Unexpected null buffer')\n    }\n    this.nextBuf = await this.toUint8Array(buf)\n    this.nextIdx = 0\n    return this.nextBuf\n  }\n\n  /**\n   * Grow the buffer.\n   * @param dst - The destination buffer.\n   * @param idx - The current index.\n   * @param min - The minimum size needed.\n   * @return The grown buffer.\n   */\n  private growBuffer (dst: Uint8Array, idx: number, min: number): Uint8Array {\n    const len = Math.max(dst.length * 2, idx + min)\n    this.arrBuf = new ArrayBuffer(len)\n    const buf = new Uint8Array(this.arrBuf)\n    buf.set(dst.subarray(0, idx))\n    return buf\n  }\n\n  /**\n   * Append a buffer to another.\n   * @param dst - The destination buffer.\n   * @param idx - The current index.\n   * @param src - The source buffer.\n   * @return The resulting buffer.\n   */\n  private appendBuffer (dst: Uint8Array, idx: number, src: Uint8Array): Uint8Array {\n    const buf = dst.length >= idx + src.length ? dst : this.growBuffer(dst, idx, src.length)\n    buf.set(src, idx)\n    return buf\n  }\n\n  /**\n   * Read a line from the buffer.\n   * @return The line.\n   */\n  public async readLine (): Promise<string> {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n    let buf = new Uint8Array(this.arrBuf) as Uint8Array\n    let len = 0\n    while (true) {\n      let next = await this.nextBuffer()\n      const newLineIdx = next.indexOf(0x0a) // '\\n'\n      if (newLineIdx >= 0) {\n        this.nextIdx += newLineIdx + 1 // +1 to ignore the '\\n'\n        next = next.subarray(0, newLineIdx)\n      } else {\n        this.nextIdx += next.length\n      }\n      if (next.includes(0x03)) {\n        // `ctrl + c` to interrupt\n        throw new TrzszError('Interrupted')\n      }\n      buf = this.appendBuffer(buf, len, next)\n      len += next.length\n      if (newLineIdx >= 0) {\n        return await uint8ToStr(buf.subarray(0, len))\n      }\n    }\n  }\n\n  /**\n   * Read binary data from the buffer.\n   * @param len - The length to read.\n   * @return The binary data.\n   */\n  public async readBinary (len: number): Promise<Uint8Array> {\n    if (this.arrBuf.byteLength < len) {\n      this.arrBuf = new ArrayBuffer(len)\n    }\n    const buf = new Uint8Array(this.arrBuf, 0, len)\n    let idx = 0\n    while (idx < len) {\n      const left = len - idx\n      let next = await this.nextBuffer()\n      if (next.length > left) {\n        this.nextIdx += left\n        next = next.subarray(0, left)\n      } else {\n        this.nextIdx += next.length\n      }\n      buf.set(next, idx)\n      idx += next.length\n    }\n    return buf\n  }\n\n  /**\n   * Read a line on Windows (handles VT100 escape sequences).\n   * @return The line.\n   */\n  public async readLineOnWindows (): Promise<string> {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n    let buf = new Uint8Array(this.arrBuf) as Uint8Array\n    let lastByte = 0x1b\n    let skipVT100 = false\n    let hasNewline = false\n    let mayDuplicate = false\n    let hasCursorHome = false\n    let preHasCursorHome = false\n    let idx = 0\n    while (true) {\n      let next = await this.nextBuffer()\n      const newLineIdx = next.indexOf(0x21) // '!'\n      if (newLineIdx >= 0) {\n        this.nextIdx += newLineIdx + 1 // +1 to ignore the '!'\n        next = next.subarray(0, newLineIdx)\n      } else {\n        this.nextIdx += next.length\n      }\n      for (let i = 0; i < next.length; i++) {\n        const c = next[i]\n        if (c === 0x03) {\n          // `ctrl + c` to interrupt\n          throw new TrzszError('Interrupted')\n        }\n        if (c === 0x0a) {\n          hasNewline = true\n        }\n        if (skipVT100) {\n          if (isVT100End(c)) {\n            skipVT100 = false\n            // moving the cursor may result in duplicate characters\n            if (c === 0x48 && lastByte >= 0x30 && lastByte <= 0x39) {\n              mayDuplicate = true\n            }\n          }\n          if (lastByte === 0x5b && c === 0x48) {\n            hasCursorHome = true\n          }\n          lastByte = c\n        } else if (c === 0x1b) {\n          skipVT100 = true\n          lastByte = c\n        } else if (isTrzszLetter(c)) {\n          if (mayDuplicate) {\n            mayDuplicate = false\n            // skip the duplicate characters, e.g., the \"8\" in \"8\\r\\n\\x1b[25;119H8\".\n            if (hasNewline && idx > 0 && (c === buf[idx - 1] || preHasCursorHome)) {\n              buf[idx - 1] = c\n              continue\n            }\n          }\n          if (idx >= buf.length) {\n            buf = this.growBuffer(buf, idx, next.length)\n          }\n          buf[idx++] = c\n          preHasCursorHome = hasCursorHome\n          hasCursorHome = false\n          hasNewline = false\n        }\n      }\n      if (newLineIdx >= 0 && idx > 0 && !skipVT100) {\n        return await uint8ToStr(buf.subarray(0, idx))\n      }\n    }\n  }\n}\n"],"names":[],"mappings":";AAeA,SAAS,cAAe,GAAoB;AAC1C,MAAI,KAAK,MAAQ,KAAK,KAAM;AAE1B,WAAO;AAAA,EACT;AACA,MAAI,KAAK,MAAQ,KAAK,IAAM;AAE1B,WAAO;AAAA,EACT;AACA,MAAI,KAAK,MAAQ,KAAK,IAAM;AAE1B,WAAO;AAAA,EACT;AACA,MAAI,MAAM,MAAQ,MAAM,MAAQ,MAAM,MAAQ,MAAM,MAAQ,MAAM,IAAM;AAEtE,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAKO,MAAM,YAAY;AAAA,EAAlB,cAAA;AACL,SAAQ,WAAmE,CAAA;AAC3E,SAAQ,UAA+B;AACvC,SAAQ,SAAwC;AAChD,SAAQ,UAAkB;AAC1B,SAAQ,UAAkB;AAC1B,SAAQ,UAAkB;AAC1B,SAAQ,UAA6B;AACrC,SAAQ,SAAsB,IAAI,YAAY,GAAG;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM1C,UAAW,KAAqD;AACrE,SAAK,SAAS,KAAK,SAAS,IAAI;AAChC,QAAI,KAAK,WAAW,MAAM;AACxB,WAAK,QAAA;AACL,WAAK,UAAU;AACf,WAAK,SAAS;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,aAAoB;AACzB,QAAI,KAAK,UAAU,MAAM;AACvB,WAAK,OAAO,IAAI,WAAW,SAAS,CAAC;AACrC,WAAK,SAAS;AACd,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,cAAqB;AAC1B,SAAK,WAAW,CAAA;AAChB,SAAK,UAAU;AACf,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,aAAc,KAAoE;AAC9F,QAAI,OAAO,QAAQ,UAAU;AAC3B,aAAO,WAAW,GAAG;AAAA,IACvB,WAAW,eAAe,aAAa;AACrC,aAAO,IAAI,WAAW,GAAG;AAAA,IAC3B,WAAW,eAAe,YAAY;AACpC,aAAO;AAAA,IACT,WAAW,eAAe,MAAM;AAC9B,YAAM,SAAS,MAAM,IAAI,YAAA;AACzB,aAAO,IAAI,WAAW,MAAM;AAAA,IAC9B,OAAO;AACL,YAAM,IAAI,WAAW,oCAAoC,MAAM,IAAI;AAAA,IACrE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,aAAmC;AAC/C,QAAK,KAAK,WAAW,QAAS,KAAK,UAAU,KAAK,QAAQ,QAAQ;AAChE,aAAO,KAAK,QAAQ,SAAS,KAAK,OAAO;AAAA,IAC3C;AACA,QAAI,KAAK,YAAY,KAAK,SAAS;AACjC,UAAI,KAAK,YAAY,GAAG;AACtB,aAAK,UAAU;AACf,aAAK,UAAU;AAAA,MACjB;AACA,YAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,aAAK,UAAU;AACf,aAAK,SAAS;AAAA,MAChB,CAAC;AAAA,IACH;AACA,UAAM,MAAM,KAAK,SAAS,KAAK,OAAO;AACtC,SAAK,SAAS,KAAK,OAAO,IAAI;AAC9B,SAAK;AACL,QAAI,OAAO,MAAM;AACf,YAAM,IAAI,WAAW,wBAAwB;AAAA,IAC/C;AACA,SAAK,UAAU,MAAM,KAAK,aAAa,GAAG;AAC1C,SAAK,UAAU;AACf,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,WAAY,KAAiB,KAAa,KAAyB;AACzE,UAAM,MAAM,KAAK,IAAI,IAAI,SAAS,GAAG,MAAM,GAAG;AAC9C,SAAK,SAAS,IAAI,YAAY,GAAG;AACjC,UAAM,MAAM,IAAI,WAAW,KAAK,MAAM;AACtC,QAAI,IAAI,IAAI,SAAS,GAAG,GAAG,CAAC;AAC5B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,aAAc,KAAiB,KAAa,KAA6B;AAC/E,UAAM,MAAM,IAAI,UAAU,MAAM,IAAI,SAAS,MAAM,KAAK,WAAW,KAAK,KAAK,IAAI,MAAM;AACvF,QAAI,IAAI,KAAK,GAAG;AAChB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAa,WAA6B;AAExC,QAAI,MAAM,IAAI,WAAW,KAAK,MAAM;AACpC,QAAI,MAAM;AACV,WAAO,MAAM;AACX,UAAI,OAAO,MAAM,KAAK,WAAA;AACtB,YAAM,aAAa,KAAK,QAAQ,EAAI;AACpC,UAAI,cAAc,GAAG;AACnB,aAAK,WAAW,aAAa;AAC7B,eAAO,KAAK,SAAS,GAAG,UAAU;AAAA,MACpC,OAAO;AACL,aAAK,WAAW,KAAK;AAAA,MACvB;AACA,UAAI,KAAK,SAAS,CAAI,GAAG;AAEvB,cAAM,IAAI,WAAW,aAAa;AAAA,MACpC;AACA,YAAM,KAAK,aAAa,KAAK,KAAK,IAAI;AACtC,aAAO,KAAK;AACZ,UAAI,cAAc,GAAG;AACnB,eAAO,MAAM,WAAW,IAAI,SAAS,GAAG,GAAG,CAAC;AAAA,MAC9C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAa,WAAY,KAAkC;AACzD,QAAI,KAAK,OAAO,aAAa,KAAK;AAChC,WAAK,SAAS,IAAI,YAAY,GAAG;AAAA,IACnC;AACA,UAAM,MAAM,IAAI,WAAW,KAAK,QAAQ,GAAG,GAAG;AAC9C,QAAI,MAAM;AACV,WAAO,MAAM,KAAK;AAChB,YAAM,OAAO,MAAM;AACnB,UAAI,OAAO,MAAM,KAAK,WAAA;AACtB,UAAI,KAAK,SAAS,MAAM;AACtB,aAAK,WAAW;AAChB,eAAO,KAAK,SAAS,GAAG,IAAI;AAAA,MAC9B,OAAO;AACL,aAAK,WAAW,KAAK;AAAA,MACvB;AACA,UAAI,IAAI,MAAM,GAAG;AACjB,aAAO,KAAK;AAAA,IACd;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAa,oBAAsC;AAEjD,QAAI,MAAM,IAAI,WAAW,KAAK,MAAM;AACpC,QAAI,WAAW;AACf,QAAI,YAAY;AAChB,QAAI,aAAa;AACjB,QAAI,eAAe;AACnB,QAAI,gBAAgB;AACpB,QAAI,mBAAmB;AACvB,QAAI,MAAM;AACV,WAAO,MAAM;AACX,UAAI,OAAO,MAAM,KAAK,WAAA;AACtB,YAAM,aAAa,KAAK,QAAQ,EAAI;AACpC,UAAI,cAAc,GAAG;AACnB,aAAK,WAAW,aAAa;AAC7B,eAAO,KAAK,SAAS,GAAG,UAAU;AAAA,MACpC,OAAO;AACL,aAAK,WAAW,KAAK;AAAA,MACvB;AACA,eAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,cAAM,IAAI,KAAK,CAAC;AAChB,YAAI,MAAM,GAAM;AAEd,gBAAM,IAAI,WAAW,aAAa;AAAA,QACpC;AACA,YAAI,MAAM,IAAM;AACd,uBAAa;AAAA,QACf;AACA,YAAI,WAAW;AACb,cAAI,WAAW,CAAC,GAAG;AACjB,wBAAY;AAEZ,gBAAI,MAAM,MAAQ,YAAY,MAAQ,YAAY,IAAM;AACtD,6BAAe;AAAA,YACjB;AAAA,UACF;AACA,cAAI,aAAa,MAAQ,MAAM,IAAM;AACnC,4BAAgB;AAAA,UAClB;AACA,qBAAW;AAAA,QACb,WAAW,MAAM,IAAM;AACrB,sBAAY;AACZ,qBAAW;AAAA,QACb,WAAW,cAAc,CAAC,GAAG;AAC3B,cAAI,cAAc;AAChB,2BAAe;AAEf,gBAAI,cAAc,MAAM,MAAM,MAAM,IAAI,MAAM,CAAC,KAAK,mBAAmB;AACrE,kBAAI,MAAM,CAAC,IAAI;AACf;AAAA,YACF;AAAA,UACF;AACA,cAAI,OAAO,IAAI,QAAQ;AACrB,kBAAM,KAAK,WAAW,KAAK,KAAK,KAAK,MAAM;AAAA,UAC7C;AACA,cAAI,KAAK,IAAI;AACb,6BAAmB;AACnB,0BAAgB;AAChB,uBAAa;AAAA,QACf;AAAA,MACF;AACA,UAAI,cAAc,KAAK,MAAM,KAAK,CAAC,WAAW;AAC5C,eAAO,MAAM,WAAW,IAAI,SAAS,GAAG,GAAG,CAAC;AAAA,MAC9C;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/esm/comm.d.ts

@@ -0,0 +1,162 @@
+/**
+ * trzsz2: https://github.com/zxdong262/trzsz2
+ * Copyright(c) 2024 Lonny Wong
+ * @license MIT
+ *
+ * Pure protocol implementation without fs/browser dependencies.
+ */
+/**
+ * trzsz version
+ */
+export declare const trzszVersion = "2.0.0";
+/**
+ * Convert a string to Uint8Array.
+ * @param {string} str - The input string.
+ * @return {Uint8Array} The resulting Uint8Array.
+ */
+export declare function strToUint8(str: string): Uint8Array;
+/**
+ * Convert a Uint8Array to string.
+ * @param {Uint8Array} buf - The input buffer.
+ * @param {string} encoding - The encoding to use.
+ * @return {Promise<string>} The resulting string.
+ */
+export declare function uint8ToStr(buf: Uint8Array, encoding?: string): Promise<string>;
+/**
+ * Convert a string to ArrayBuffer.
+ * @param {string} str - The input string.
+ * @return {ArrayBuffer} The resulting ArrayBuffer.
+ */
+export declare function strToArrBuf(str: string): ArrayBuffer;
+/**
+ * Encode a buffer (compress and base64).
+ * @param {string | Uint8Array} buf - The input buffer.
+ * @return {string} The encoded string.
+ */
+export declare function encodeBuffer(buf: string | Uint8Array): string;
+/**
+ * Decode a buffer (base64 and decompress).
+ * @param {string} buf - The encoded string.
+ * @return {Uint8Array} The decoded buffer.
+ */
+export declare function decodeBuffer(buf: string): Uint8Array;
+/**
+ * Custom error class for trzsz operations.
+ */
+export declare class TrzszError extends Error {
+    private readonly type;
+    private readonly trace;
+    constructor(message: string, type?: string | null, trace?: boolean);
+    /**
+     * Check if the error should include traceback.
+     * @return {boolean} True if traceback should be included.
+     */
+    isTraceBack(): boolean;
+    /**
+     * Check if the error is a remote exit.
+     * @return {boolean} True if remote exit.
+     */
+    isRemoteExit(): boolean;
+    /**
+     * Check if the error is a remote failure.
+     * @return {boolean} True if remote failure.
+     */
+    isRemoteFail(): boolean;
+    /**
+     * Check if the error indicates stop and delete.
+     * @return {boolean} True if stop and delete.
+     */
+    isStopAndDelete(): boolean;
+    /**
+     * Get the error message.
+     * @param {Error} err - The error object.
+     * @return {string} The error message.
+     */
+    static getErrorMessage(err: Error): string;
+}
+/**
+ * Interface for trzsz file operations.
+ */
+export interface TrzszFile {
+    closeFile: () => void;
+}
+/**
+ * Interface for trzsz file reader.
+ */
+export interface TrzszFileReader extends TrzszFile {
+    getPathId: () => number;
+    getRelPath: () => string[];
+    isDir: () => boolean;
+    getSize: () => number;
+    readFile: (buf: ArrayBuffer) => Promise<Uint8Array>;
+}
+/**
+ * Interface for trzsz file writer.
+ */
+export interface TrzszFileWriter extends TrzszFile {
+    getFileName: () => string;
+    getLocalName: () => string;
+    isDir: () => boolean;
+    writeFile: (buf: Uint8Array) => Promise<void>;
+    deleteFile: () => Promise<string>;
+}
+/**
+ * Type for opening save file.
+ */
+export type OpenSaveFile = (saveParam: any, fileName: string, directory: boolean, overwrite: boolean) => Promise<TrzszFileWriter>;
+/**
+ * Interface for progress callback.
+ */
+export interface ProgressCallback {
+    onNum: (num: number) => void;
+    onName: (name: string) => void;
+    onSize: (size: number) => void;
+    onStep: (step: number) => void;
+    onDone: () => void;
+}
+/**
+ * Check for duplicate file names.
+ * @param {TrzszFileReader[]} files - The files to check.
+ */
+export declare function checkDuplicateNames(files: TrzszFileReader[]): void;
+/**
+ * Check if an array contains only elements of a specific type.
+ * @param {any} arr - The array to check.
+ * @param {string} type - The type to check for.
+ * @return {boolean} True if all elements are of the specified type.
+ */
+export declare function isArrayOfType(arr: any, type: string): boolean;
+/**
+ * Check if a character is a VT100 end character.
+ * @param {number} c - The character code.
+ * @return {boolean} True if it's a VT100 end character.
+ */
+export declare function isVT100End(c: number): boolean;
+/**
+ * Strip VT100 escape sequences from server output.
+ * @param {string | ArrayBuffer | Uint8Array | Blob} output - The server output.
+ * @return {string | ArrayBuffer | Uint8Array | Blob} The stripped output.
+ */
+export declare function stripServerOutput(output: string | ArrayBuffer | Uint8Array | Blob): string | ArrayBuffer | Uint8Array | Blob;
+/**
+ * Tmux mode constants.
+ */
+export declare const TmuxMode: {
+    readonly NoTmux: 0;
+    readonly TmuxNormalMode: 1;
+    readonly TmuxControlMode: 2;
+};
+export type TmuxModeType = (typeof TmuxMode)[keyof typeof TmuxMode];
+/**
+ * Format saved files message.
+ * @param {string[]} fileNames - The file names.
+ * @param {string} destPath - The destination path.
+ * @return {string} The formatted message.
+ */
+export declare function formatSavedFiles(fileNames: string[], destPath: string): string;
+/**
+ * Strip tmux status line from buffer.
+ * @param {string} buf - The input buffer.
+ * @return {string} The stripped buffer.
+ */
+export declare function stripTmuxStatusLine(buf: string): string;