@mnaoumov/typescript-lib 0.0.0 → 1.0.1

package/dist/lib/esm/desktop-zip-extractor.mjs

@@ -0,0 +1,136 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+import { inflateRawSync } from "node:zlib";
+import {
+  dirname,
+  join
+} from "./path.mjs";
+const END_OF_CENTRAL_DIRECTORY_SIGNATURE = 101010256;
+const CENTRAL_DIRECTORY_HEADER_SIGNATURE = 33639248;
+const LOCAL_FILE_HEADER_SIGNATURE = 67324752;
+const END_OF_CENTRAL_DIRECTORY_SIZE = 22;
+const MAX_ARCHIVE_COMMENT_LENGTH = 65535;
+const SATURATED_UINT_16 = 65535;
+const SATURATED_UINT_32 = 4294967295;
+const ARCHIVE_ENTRY_COUNT_OFFSET = 10;
+const CENTRAL_DIRECTORY_START_OFFSET = 16;
+const CENTRAL_DIRECTORY_FLAGS_OFFSET = 8;
+const CENTRAL_DIRECTORY_COMPRESSION_METHOD_OFFSET = 10;
+const CENTRAL_DIRECTORY_COMPRESSED_SIZE_OFFSET = 20;
+const CENTRAL_DIRECTORY_NAME_LENGTH_OFFSET = 28;
+const CENTRAL_DIRECTORY_EXTRA_LENGTH_OFFSET = 30;
+const CENTRAL_DIRECTORY_COMMENT_LENGTH_OFFSET = 32;
+const CENTRAL_DIRECTORY_LOCAL_HEADER_OFFSET_OFFSET = 42;
+const CENTRAL_DIRECTORY_HEADER_SIZE = 46;
+const LOCAL_HEADER_NAME_LENGTH_OFFSET = 26;
+const LOCAL_HEADER_EXTRA_LENGTH_OFFSET = 28;
+const LOCAL_HEADER_SIZE = 30;
+const COMPRESSION_METHOD_STORED = 0;
+const COMPRESSION_METHOD_DEFLATED = 8;
+const ENCRYPTED_FLAG_DIVISOR = 2;
+const ENTRY_NAME_SEPARATOR = "/";
+const WINDOWS_DRIVE_PREFIX_REG_EXP = /^[A-Za-z]:/;
+function extractZipArchive(params) {
+  const {
+    archive,
+    fileSystem,
+    targetDirectory
+  } = params;
+  fileSystem.mkdirSync(targetDirectory, { recursive: true });
+  for (const entry of readCentralDirectory(archive)) {
+    assertSafeEntryName(entry.name);
+    if (entry.name.endsWith(ENTRY_NAME_SEPARATOR)) {
+      fileSystem.mkdirSync(join(targetDirectory, entry.name.slice(0, -1)), { recursive: true });
+      continue;
+    }
+    const entryPath = join(targetDirectory, entry.name);
+    fileSystem.mkdirSync(dirname(entryPath), { recursive: true });
+    fileSystem.writeFileSync(entryPath, readEntryData(archive, entry));
+  }
+}
+function assertSafeEntryName(entryName) {
+  if (entryName.startsWith(ENTRY_NAME_SEPARATOR)) {
+    throw new Error(`Refusing to extract the absolute archive entry '${entryName}'.`);
+  }
+  if (WINDOWS_DRIVE_PREFIX_REG_EXP.test(entryName)) {
+    throw new Error(`Refusing to extract the drive-qualified archive entry '${entryName}'.`);
+  }
+  if (entryName.includes("\\")) {
+    throw new Error(`Refusing to extract the archive entry '${entryName}', which uses a backslash separator.`);
+  }
+  if (entryName.split(ENTRY_NAME_SEPARATOR).includes("..")) {
+    throw new Error(`Refusing to extract the archive entry '${entryName}', which points outside the target directory.`);
+  }
+}
+function findEndOfCentralDirectoryOffset(archive) {
+  const lastPossibleOffset = archive.length - END_OF_CENTRAL_DIRECTORY_SIZE;
+  const firstPossibleOffset = Math.max(0, lastPossibleOffset - MAX_ARCHIVE_COMMENT_LENGTH);
+  for (let offset = lastPossibleOffset; offset >= firstPossibleOffset; offset--) {
+    if (archive.readUInt32LE(offset) === END_OF_CENTRAL_DIRECTORY_SIGNATURE) {
+      return offset;
+    }
+  }
+  throw new Error("The archive is not a ZIP file: its end-of-central-directory record is missing.");
+}
+function readCentralDirectory(archive) {
+  const endOfCentralDirectoryOffset = findEndOfCentralDirectoryOffset(archive);
+  const entryCount = archive.readUInt16LE(endOfCentralDirectoryOffset + ARCHIVE_ENTRY_COUNT_OFFSET);
+  let entryOffset = archive.readUInt32LE(endOfCentralDirectoryOffset + CENTRAL_DIRECTORY_START_OFFSET);
+  if (entryCount === SATURATED_UINT_16 || entryOffset === SATURATED_UINT_32) {
+    throw new Error("ZIP64 archives are not supported.");
+  }
+  const entries = [];
+  for (let entryIndex = 0; entryIndex < entryCount; entryIndex++) {
+    if (archive.readUInt32LE(entryOffset) !== CENTRAL_DIRECTORY_HEADER_SIGNATURE) {
+      throw new Error(`The archive's central directory is corrupt at entry ${String(entryIndex)}.`);
+    }
+    const flags = archive.readUInt16LE(entryOffset + CENTRAL_DIRECTORY_FLAGS_OFFSET);
+    if (flags % ENCRYPTED_FLAG_DIVISOR === 1) {
+      throw new Error("Encrypted ZIP archives are not supported.");
+    }
+    const compressedSize = archive.readUInt32LE(entryOffset + CENTRAL_DIRECTORY_COMPRESSED_SIZE_OFFSET);
+    const localHeaderOffset = archive.readUInt32LE(entryOffset + CENTRAL_DIRECTORY_LOCAL_HEADER_OFFSET_OFFSET);
+    if (compressedSize === SATURATED_UINT_32 || localHeaderOffset === SATURATED_UINT_32) {
+      throw new Error("ZIP64 archives are not supported.");
+    }
+    const nameLength = archive.readUInt16LE(entryOffset + CENTRAL_DIRECTORY_NAME_LENGTH_OFFSET);
+    const nameOffset = entryOffset + CENTRAL_DIRECTORY_HEADER_SIZE;
+    entries.push({
+      compressedSize,
+      compressionMethod: archive.readUInt16LE(entryOffset + CENTRAL_DIRECTORY_COMPRESSION_METHOD_OFFSET),
+      localHeaderOffset,
+      name: archive.toString("utf-8", nameOffset, nameOffset + nameLength)
+    });
+    entryOffset = nameOffset + nameLength + archive.readUInt16LE(entryOffset + CENTRAL_DIRECTORY_EXTRA_LENGTH_OFFSET) + archive.readUInt16LE(entryOffset + CENTRAL_DIRECTORY_COMMENT_LENGTH_OFFSET);
+  }
+  return entries;
+}
+function readEntryData(archive, entry) {
+  if (archive.readUInt32LE(entry.localHeaderOffset) !== LOCAL_FILE_HEADER_SIGNATURE) {
+    throw new Error(`The archive entry '${entry.name}' has a corrupt local header.`);
+  }
+  const dataOffset = entry.localHeaderOffset + LOCAL_HEADER_SIZE + archive.readUInt16LE(entry.localHeaderOffset + LOCAL_HEADER_NAME_LENGTH_OFFSET) + archive.readUInt16LE(entry.localHeaderOffset + LOCAL_HEADER_EXTRA_LENGTH_OFFSET);
+  const dataEnd = dataOffset + entry.compressedSize;
+  if (dataEnd > archive.length) {
+    throw new Error(`The archive is truncated: entry '${entry.name}' runs past its end.`);
+  }
+  const compressedData = archive.subarray(dataOffset, dataEnd);
+  switch (entry.compressionMethod) {
+    case COMPRESSION_METHOD_DEFLATED: {
+      return inflateRawSync(compressedData);
+    }
+    case COMPRESSION_METHOD_STORED: {
+      return compressedData;
+    }
+    default: {
+      throw new Error(`The archive entry '${entry.name}' uses unsupported compression method ${String(entry.compressionMethod)}.`);
+    }
+  }
+}
+export {
+  extractZipArchive
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Rlc2t0b3AtemlwLWV4dHJhY3Rvci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEV4dHJhY3RzIGEgWklQIGFyY2hpdmUgdG8gZGlzayB1c2luZyBvbmx5IE5vZGUncyBgemxpYmAgXHUyMDE0IHdpdGggbm8gdGhpcmQtcGFydHkgdW56aXAgZGVwZW5kZW5jeS5cbiAqXG4gKiBJdCBleGlzdHMgZm9yIG9uZSBtZWFzdXJlZCByZWFzb24uIFRoZSBkZXBlbmRlbmN5IGl0IHJlcGxhY2VkIG9uIHRoaXMgcGF0aCwgYGFkbS16aXBgLCBidW5kbGVkXG4gKiByb3VnaGx5IDM0IEtCIG9mIG1pbmlmaWVkIEphdmFTY3JpcHQgaW50byBFVkVSWSBPYnNpZGlhbiBwbHVnaW4gYnVpbHQgd2l0aCB0aGlzIGxpYnJhcnk6IGEgcGx1Z2luXG4gKiBzaGlwcyBhIHNpbmdsZSBDSlMgYG1haW4uanNgLCBlc2J1aWxkIGhhcyBubyBjb2RlIHNwbGl0dGluZyB0byBwdXQgYSBkZXBlbmRlbmN5IGJlaGluZCwgYW5kIGFcbiAqIGBhd2FpdCBpbXBvcnQoKWAgb25seSBkZWZlcnMgZXZhbHVhdGlvbiBcdTIwMTQgdGhlIG1vZHVsZSBib2R5IGlzIGlubGluZWQgZWl0aGVyIHdheS4gYG5vZGU6emxpYmAgaXNcbiAqIGFscmVhZHkgYW4gZXNidWlsZCBleHRlcm5hbCwgc28gdGhlIHNhbWUgd29yayBub3cgY29zdHMgYSBwbHVnaW4gYnVuZGxlIG5vdGhpbmcgYXQgYWxsLiBBcmNoaXZlcyBhcmVcbiAqIFdSSVRURU4gd2l0aCBgZmZsYXRlYCBhdCByZWxlYXNlIHRpbWUgKGBzY3JpcHQtdXRpbHMvZGVtby12YXVsdC50c2ApLCB3aGljaCBpcyBOb2RlLXNpZGUgdG9vbGluZyBhbmRcbiAqIG5ldmVyIHJlYWNoZXMgYSBwbHVnaW4gYnVuZGxlIFx1MjAxNCBhIHRoaXJkLXBhcnR5IHdyaXRlciB0aGVyZSBpcyBhbHNvIHdoYXQga2VlcHMgdGhpcyByZWFkZXIgY2hlY2tlZFxuICogYWdhaW5zdCBhbiBpbXBsZW1lbnRhdGlvbiB0aGF0IGlzIG5vdCBpdHMgb3duLlxuICpcbiAqIERlbGliZXJhdGVseSBuYXJyb3c6IGl0IHJlYWRzIGV4YWN0bHkgd2hhdCB0aGF0IHdyaXRlciBwcm9kdWNlcyBcdTIwMTQgc3RvcmVkIGFuZCBkZWZsYXRlZCBlbnRyaWVzIGluIGFuXG4gKiB1bmVuY3J5cHRlZCBhcmNoaXZlIGJlbG93IHRoZSA0IEdCIC8gNjU1MzUtZW50cnkgWklQNjQgdGhyZXNob2xkIFx1MjAxNCBhbmQgcmFpc2VzIGEgbmFtZWQgZXJyb3IgZm9yXG4gKiBhbnl0aGluZyBlbHNlIHJhdGhlciB0aGFuIGd1ZXNzaW5nIGF0IGl0LiBTaXplcyBhbmQgb2Zmc2V0cyBhcmUgdGFrZW4gZnJvbSB0aGUgY2VudHJhbCBkaXJlY3RvcnksXG4gKiB3aGljaCBpcyBhdXRob3JpdGF0aXZlIGV2ZW4gZm9yIGFyY2hpdmVzIHdyaXR0ZW4gd2l0aCBkYXRhIGRlc2NyaXB0b3JzLlxuICpcbiAqIFRoZSBgbm9kZTpgIGltcG9ydHMgYmVsb3cgYXJlIHNhZmUgdG8gbWVyZWx5IEVWQUxVQVRFIG9uIG1vYmlsZSBcdTIwMTQgYHJlcXVpcmVgIGhhbmRzIGJhY2sgYHVuZGVmaW5lZGBcbiAqIHRoZXJlIGFuZCBub3RoaW5nIHJlYWRzIGl0IGF0IGxvYWQgdGltZSBcdTIwMTQgc28gdGhpcyBtb2R1bGUgY2FuIHNpdCBpbiB0aGUgZ2VuZXJhdGVkIGJhcnJlbHMgd2l0aG91dFxuICogYnJlYWtpbmcgdGhlIGxpYnJhcnkncyBsb2FkIG9uIEFuZHJvaWQuIE9ubHkgdGhlIGNhbGxzIGFyZSBkZXNrdG9wLW9ubHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBCdWZmZXIgfSBmcm9tICdub2RlOmJ1ZmZlcic7XG5cbmltcG9ydCB7IGluZmxhdGVSYXdTeW5jIH0gZnJvbSAnbm9kZTp6bGliJztcblxuaW1wb3J0IHtcbiAgZGlybmFtZSxcbiAgam9pblxufSBmcm9tICcuL3BhdGgudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBleHRyYWN0WmlwQXJjaGl2ZX0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRXh0cmFjdFppcEFyY2hpdmVQYXJhbXMge1xuICAvKipcbiAgICogVGhlIHJhdyBaSVAgYXJjaGl2ZSBieXRlcy5cbiAgICovXG4gIHJlYWRvbmx5IGFyY2hpdmU6IEJ1ZmZlcjtcblxuICAvKipcbiAgICogVGhlIGZpbGUtc3lzdGVtIGltcGxlbWVudGF0aW9uIHRoZSBleHRyYWN0ZWQgZW50cmllcyBhcmUgd3JpdHRlbiB3aXRoLlxuICAgKlxuICAgKiBJbmplY3RlZCByYXRoZXIgdGhhbiBpbXBvcnRlZCBzbyB0aGUgY2FsbGVyIGNob29zZXMgd2hpY2ggYGZzYCB3cml0ZXMgdGhlIGZpbGVzLiBUaGUgZGVtby12YXVsdFxuICAgKiBvcGVuZXIgaGFuZHMgb3ZlciBFbGVjdHJvbidzIGBvcmlnaW5hbC1mc2AgKHNlZSB7QGxpbmsgWmlwRXh0cmFjdGlvbkZpbGVTeXN0ZW19KS5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGVTeXN0ZW06IFppcEV4dHJhY3Rpb25GaWxlU3lzdGVtO1xuXG4gIC8qKlxuICAgKiBUaGUgZGlyZWN0b3J5IHRvIGV4dHJhY3QgaW50by4gQ3JlYXRlZCBpZiBpdCBkb2VzIG5vdCBleGlzdC5cbiAgICovXG4gIHJlYWRvbmx5IHRhcmdldERpcmVjdG9yeTogc3RyaW5nO1xufVxuXG4vKipcbiAqIFRoZSBzbGljZSBvZiBgbm9kZTpmc2AgZXh0cmFjdGlvbiBuZWVkcy5cbiAqXG4gKiBPbmx5IHRoZSB0d28gV1JJVElORyBjYWxscyBhcmUgcmVxdWlyZWQsIGFuZCB0aGF0IGlzIGRlbGliZXJhdGU6IEVsZWN0cm9uJ3MgYXNhciBsYXllciBpbnRlcmNlcHRzXG4gKiBgZnNgIFJFQURTIChhbmQgYGV4aXN0c1N5bmNgKSBvbiBhbnkgcGF0aCBjb250YWluaW5nIGAuYXNhcmAsIHdoaWNoIGEgZGVtbyB2YXVsdCBtYXkgbGVnaXRpbWF0ZWx5XG4gKiBzaGlwIGFzIGEgcGxhaW4gZmlsZS4gTmV2ZXIgcHJvYmluZyB0aGUgdGFyZ2V0IHdpdGggYSByZWFkIGtlZXBzIHRoYXQgaW50ZXJjZXB0aW9uIG91dCBvZiB0aGVcbiAqIHBpY3R1cmUgZW50aXJlbHksIGFuZCBhIGNhbGxlciB0aGF0IGhhbmRzIG92ZXIgRWxlY3Ryb24ncyBgb3JpZ2luYWwtZnNgIGlzIHNhZmUgZXZlbiBmcm9tIHRoZVxuICogd3JpdGUgc2lkZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBaaXBFeHRyYWN0aW9uRmlsZVN5c3RlbSB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgZGlyZWN0b3J5LCBpbmNsdWRpbmcgYW55IG1pc3NpbmcgcGFyZW50cy5cbiAgICpcbiAgICogQHBhcmFtIHBhdGggLSBUaGUgZGlyZWN0b3J5IHRvIGNyZWF0ZS5cbiAgICogQHBhcmFtIG9wdGlvbnMgLSBUaGUge0BsaW5rIFppcEV4dHJhY3Rpb25Na2Rpck9wdGlvbnN9LlxuICAgKiBAcmV0dXJucyBUaGUgZmlyc3QgZGlyZWN0b3J5IGNyZWF0ZWQsIGlmIGFueS5cbiAgICovXG4gIG1rZGlyU3luYzogKHBhdGg6IHN0cmluZywgb3B0aW9uczogWmlwRXh0cmFjdGlvbk1rZGlyT3B0aW9ucykgPT4gc3RyaW5nIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBXcml0ZXMgYSBmaWxlLCBvdmVyd3JpdGluZyBpdCBpZiBpdCBleGlzdHMuXG4gICAqXG4gICAqIEBwYXJhbSBwYXRoIC0gVGhlIGZpbGUgdG8gd3JpdGUuXG4gICAqIEBwYXJhbSBkYXRhIC0gVGhlIGJ5dGVzIHRvIHdyaXRlLlxuICAgKi9cbiAgd3JpdGVGaWxlU3luYzogKHBhdGg6IHN0cmluZywgZGF0YTogQnVmZmVyKSA9PiB2b2lkO1xufVxuXG4vKipcbiAqIFRoZSBvcHRpb25zIHtAbGluayBaaXBFeHRyYWN0aW9uRmlsZVN5c3RlbS5ta2RpclN5bmN9IGlzIGFsd2F5cyBjYWxsZWQgd2l0aC5cbiAqXG4gKiBFeHRyYWN0aW9uIG5ldmVyIHByb2JlcyBmb3IgYW4gZXhpc3RpbmcgZGlyZWN0b3J5LCBzbyBldmVyeSBjYWxsIGhhcyB0byBjcmVhdGUgdGhlIG1pc3NpbmcgcGFyZW50c1xuICogaXRzZWxmIGFuZCB0b2xlcmF0ZSBhIGRpcmVjdG9yeSB0aGF0IGlzIGFscmVhZHkgdGhlcmUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgWmlwRXh0cmFjdGlvbk1rZGlyT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBBbHdheXMgYHRydWVgLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVjdXJzaXZlOiB0cnVlO1xufVxuXG5pbnRlcmZhY2UgWmlwRW50cnkge1xuICByZWFkb25seSBjb21wcmVzc2VkU2l6ZTogbnVtYmVyO1xuICByZWFkb25seSBjb21wcmVzc2lvbk1ldGhvZDogbnVtYmVyO1xuICByZWFkb25seSBsb2NhbEhlYWRlck9mZnNldDogbnVtYmVyO1xuICByZWFkb25seSBuYW1lOiBzdHJpbmc7XG59XG5cbmNvbnN0IEVORF9PRl9DRU5UUkFMX0RJUkVDVE9SWV9TSUdOQVRVUkUgPSAweDA2XzA1XzRCXzUwO1xuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfSEVBREVSX1NJR05BVFVSRSA9IDB4MDJfMDFfNEJfNTA7XG5jb25zdCBMT0NBTF9GSUxFX0hFQURFUl9TSUdOQVRVUkUgPSAweDA0XzAzXzRCXzUwO1xuXG5jb25zdCBFTkRfT0ZfQ0VOVFJBTF9ESVJFQ1RPUllfU0laRSA9IDIyO1xuY29uc3QgTUFYX0FSQ0hJVkVfQ09NTUVOVF9MRU5HVEggPSA2NV81MzU7XG5cbi8vIEEgY291bnQgb3Igb2Zmc2V0IHNhdHVyYXRlZCB0byBhbGwtb25lcyBtZWFucyB0aGUgcmVhbCB2YWx1ZSBsaXZlcyBpbiBhIFpJUDY0IHJlY29yZCB0aGlzIHJlYWRlclxuLy8gZG9lcyBub3QgaW1wbGVtZW50LCBzbyB0aGUgZmllbGQgbXVzdCBuZXZlciBiZSByZWFkIGF0IGZhY2UgdmFsdWUuXG5jb25zdCBTQVRVUkFURURfVUlOVF8xNiA9IDY1XzUzNTtcbmNvbnN0IFNBVFVSQVRFRF9VSU5UXzMyID0gNF8yOTRfOTY3XzI5NTtcblxuLy8gRmllbGQgb2Zmc2V0cyB3aXRoaW4gdGhlIGVuZC1vZi1jZW50cmFsLWRpcmVjdG9yeSByZWNvcmQuXG5jb25zdCBBUkNISVZFX0VOVFJZX0NPVU5UX09GRlNFVCA9IDEwO1xuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfU1RBUlRfT0ZGU0VUID0gMTY7XG5cbi8vIEZpZWxkIG9mZnNldHMgd2l0aGluIGEgY2VudHJhbC1kaXJlY3RvcnkgaGVhZGVyLlxuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfRkxBR1NfT0ZGU0VUID0gODtcbmNvbnN0IENFTlRSQUxfRElSRUNUT1JZX0NPTVBSRVNTSU9OX01FVEhPRF9PRkZTRVQgPSAxMDtcbmNvbnN0IENFTlRSQUxfRElSRUNUT1JZX0NPTVBSRVNTRURfU0laRV9PRkZTRVQgPSAyMDtcbmNvbnN0IENFTlRSQUxfRElSRUNUT1JZX05BTUVfTEVOR1RIX09GRlNFVCA9IDI4O1xuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfRVhUUkFfTEVOR1RIX09GRlNFVCA9IDMwO1xuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfQ09NTUVOVF9MRU5HVEhfT0ZGU0VUID0gMzI7XG5jb25zdCBDRU5UUkFMX0RJUkVDVE9SWV9MT0NBTF9IRUFERVJfT0ZGU0VUX09GRlNFVCA9IDQyO1xuY29uc3QgQ0VOVFJBTF9ESVJFQ1RPUllfSEVBREVSX1NJWkUgPSA0NjtcblxuLy8gRmllbGQgb2Zmc2V0cyB3aXRoaW4gYSBsb2NhbCBmaWxlIGhlYWRlci5cbmNvbnN0IExPQ0FMX0hFQURFUl9OQU1FX0xFTkdUSF9PRkZTRVQgPSAyNjtcbmNvbnN0IExPQ0FMX0hFQURFUl9FWFRSQV9MRU5HVEhfT0ZGU0VUID0gMjg7XG5jb25zdCBMT0NBTF9IRUFERVJfU0laRSA9IDMwO1xuXG5jb25zdCBDT01QUkVTU0lPTl9NRVRIT0RfU1RPUkVEID0gMDtcbmNvbnN0IENPTVBSRVNTSU9OX01FVEhPRF9ERUZMQVRFRCA9IDg7XG5cbi8vIEJpdCAwIG9mIHRoZSBnZW5lcmFsLXB1cnBvc2UgZmxhZ3MgbWFya3MgYW4gZW5jcnlwdGVkIGVudHJ5LCBhbmQgaXQgaXMgdGhlIGxvd2VzdCBiaXQgXHUyMDE0IHNvIHRoZVxuLy8gcmVtYWluZGVyIHRlc3RzIGl0IHdpdGhvdXQgcmVhY2hpbmcgZm9yIGEgYml0d2lzZSBvcGVyYXRvci5cbmNvbnN0IEVOQ1JZUFRFRF9GTEFHX0RJVklTT1IgPSAyO1xuXG5jb25zdCBFTlRSWV9OQU1FX1NFUEFSQVRPUiA9ICcvJztcbmNvbnN0IFdJTkRPV1NfRFJJVkVfUFJFRklYX1JFR19FWFAgPSAvXltBLVphLXpdOi87XG5cbi8qKlxuICogRXh0cmFjdHMgZXZlcnkgZW50cnkgb2YgYSBaSVAgYXJjaGl2ZSBpbnRvIGEgZGlyZWN0b3J5LlxuICpcbiAqIERpcmVjdG9yeSBlbnRyaWVzIGJlY29tZSBkaXJlY3RvcmllczsgYSBmaWxlIGVudHJ5J3MgcGFyZW50cyBhcmUgY3JlYXRlZCB3aGV0aGVyIG9yIG5vdCB0aGUgYXJjaGl2ZVxuICogZGVjbGFyZWQgdGhlbS4gQW4gZW50cnkgd2hvc2UgbmFtZSB3b3VsZCBlc2NhcGUge0BsaW5rIEV4dHJhY3RaaXBBcmNoaXZlUGFyYW1zLnRhcmdldERpcmVjdG9yeX0gaXNcbiAqIHJlZnVzZWQgcmF0aGVyIHRoYW4gd3JpdHRlbiAodGhlIFwiemlwIHNsaXBcIiB0cmF2ZXJzYWwpLCBhcyBpcyBhbiBlbmNyeXB0ZWQsIFpJUDY0LCBvclxuICogdW5rbm93bi1jb21wcmVzc2lvbiBhcmNoaXZlLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIEV4dHJhY3RaaXBBcmNoaXZlUGFyYW1zfS5cbiAqIEB0aHJvd3MgQW4ge0BsaW5rIEVycm9yfSBuYW1pbmcgdGhlIHJlYXNvbiB3aGVuIHRoZSBhcmNoaXZlIGNhbm5vdCBiZSByZWFkIGFzIHdyaXR0ZW4uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBleHRyYWN0WmlwQXJjaGl2ZShwYXJhbXM6IEV4dHJhY3RaaXBBcmNoaXZlUGFyYW1zKTogdm9pZCB7XG4gIGNvbnN0IHtcbiAgICBhcmNoaXZlLFxuICAgIGZpbGVTeXN0ZW0sXG4gICAgdGFyZ2V0RGlyZWN0b3J5XG4gIH0gPSBwYXJhbXM7XG5cbiAgZmlsZVN5c3RlbS5ta2RpclN5bmModGFyZ2V0RGlyZWN0b3J5LCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcblxuICBmb3IgKGNvbnN0IGVudHJ5IG9mIHJlYWRDZW50cmFsRGlyZWN0b3J5KGFyY2hpdmUpKSB7XG4gICAgYXNzZXJ0U2FmZUVudHJ5TmFtZShlbnRyeS5uYW1lKTtcblxuICAgIGlmIChlbnRyeS5uYW1lLmVuZHNXaXRoKEVOVFJZX05BTUVfU0VQQVJBVE9SKSkge1xuICAgICAgLy8gTmFtZWQgd2l0aG91dCBpdHMgdHJhaWxpbmcgc2VwYXJhdG9yLCBzbyB0aGUgY3JlYXRlZCBwYXRoIHJlYWRzIHRoZSBzYW1lIGFzIGV2ZXJ5IG90aGVyIG9uZS5cbiAgICAgIGZpbGVTeXN0ZW0ubWtkaXJTeW5jKGpvaW4odGFyZ2V0RGlyZWN0b3J5LCBlbnRyeS5uYW1lLnNsaWNlKDAsIC0xKSksIHsgcmVjdXJzaXZlOiB0cnVlIH0pO1xuICAgICAgY29udGludWU7XG4gICAgfVxuXG4gICAgY29uc3QgZW50cnlQYXRoID0gam9pbih0YXJnZXREaXJlY3RvcnksIGVudHJ5Lm5hbWUpO1xuICAgIGZpbGVTeXN0ZW0ubWtkaXJTeW5jKGRpcm5hbWUoZW50cnlQYXRoKSwgeyByZWN1cnNpdmU6IHRydWUgfSk7XG4gICAgZmlsZVN5c3RlbS53cml0ZUZpbGVTeW5jKGVudHJ5UGF0aCwgcmVhZEVudHJ5RGF0YShhcmNoaXZlLCBlbnRyeSkpO1xuICB9XG59XG5cbi8qKlxuICogUmVmdXNlcyBhbiBlbnRyeSBuYW1lIHRoYXQgd291bGQgcGxhY2UgdGhlIGV4dHJhY3RlZCBmaWxlIG91dHNpZGUgdGhlIHRhcmdldCBkaXJlY3RvcnkuXG4gKlxuICogQW4gYXJjaGl2ZSBpcyB1bnRydXN0ZWQgaW5wdXQgZXZlbiB3aGVuIHdlIHB1Ymxpc2hlZCBpdCBvdXJzZWx2ZXMsIGFuZCBldmVyeSBvbmUgb2YgdGhlc2Ugc2hhcGVzXG4gKiBlc2NhcGVzIHRoZSB0YXJnZXQ6IGFuIGFic29sdXRlIFBPU0lYIHBhdGgsIGEgV2luZG93cyBkcml2ZS1xdWFsaWZpZWQgcGF0aCwgYSBiYWNrc2xhc2ggKHdoaWNoIHRoZVxuICogWklQIHNwZWNpZmljYXRpb24gZm9yYmlkcyBhcyBhIHNlcGFyYXRvciwgc28gaXRzIG9ubHkgdXNlIGhlcmUgaXMgdG8gc211Z2dsZSBvbmUgcGFzdCBhXG4gKiBmb3J3YXJkLXNsYXNoIGNoZWNrKSwgYW5kIGEgYC4uYCBzZWdtZW50LlxuICpcbiAqIEBwYXJhbSBlbnRyeU5hbWUgLSBUaGUgZW50cnkgbmFtZSBhcyByZWNvcmRlZCBpbiB0aGUgYXJjaGl2ZS5cbiAqL1xuZnVuY3Rpb24gYXNzZXJ0U2FmZUVudHJ5TmFtZShlbnRyeU5hbWU6IHN0cmluZyk6IHZvaWQge1xuICBpZiAoZW50cnlOYW1lLnN0YXJ0c1dpdGgoRU5UUllfTkFNRV9TRVBBUkFUT1IpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBSZWZ1c2luZyB0byBleHRyYWN0IHRoZSBhYnNvbHV0ZSBhcmNoaXZlIGVudHJ5ICcke2VudHJ5TmFtZX0nLmApO1xuICB9XG5cbiAgaWYgKFdJTkRPV1NfRFJJVkVfUFJFRklYX1JFR19FWFAudGVzdChlbnRyeU5hbWUpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBSZWZ1c2luZyB0byBleHRyYWN0IHRoZSBkcml2ZS1xdWFsaWZpZWQgYXJjaGl2ZSBlbnRyeSAnJHtlbnRyeU5hbWV9Jy5gKTtcbiAgfVxuXG4gIGlmIChlbnRyeU5hbWUuaW5jbHVkZXMoJ1xcXFwnKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgUmVmdXNpbmcgdG8gZXh0cmFjdCB0aGUgYXJjaGl2ZSBlbnRyeSAnJHtlbnRyeU5hbWV9Jywgd2hpY2ggdXNlcyBhIGJhY2tzbGFzaCBzZXBhcmF0b3IuYCk7XG4gIH1cblxuICBpZiAoZW50cnlOYW1lLnNwbGl0KEVOVFJZX05BTUVfU0VQQVJBVE9SKS5pbmNsdWRlcygnLi4nKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgUmVmdXNpbmcgdG8gZXh0cmFjdCB0aGUgYXJjaGl2ZSBlbnRyeSAnJHtlbnRyeU5hbWV9Jywgd2hpY2ggcG9pbnRzIG91dHNpZGUgdGhlIHRhcmdldCBkaXJlY3RvcnkuYCk7XG4gIH1cbn1cblxuLyoqXG4gKiBMb2NhdGVzIHRoZSBlbmQtb2YtY2VudHJhbC1kaXJlY3RvcnkgcmVjb3JkIGFuZCByZXR1cm5zIGl0cyBvZmZzZXQuXG4gKlxuICogVGhlIHJlY29yZCBzaXRzIGF0IHRoZSB2ZXJ5IGVuZCBvZiB0aGUgYXJjaGl2ZSB1bmxlc3MgYSB0cmFpbGluZyBjb21tZW50IGZvbGxvd3MgaXQsIHNvIGl0IGlzIGZvdW5kXG4gKiBieSBzY2FubmluZyBiYWNrd2FyZHMgb3ZlciB0aGUgY29tbWVudCdzIG1heGltdW0gbGVuZ3RoIHJhdGhlciB0aGFuIGFzc3VtZWQgdG8gYmUgYXQgYSBmaXhlZCBwbGFjZS5cbiAqXG4gKiBAcGFyYW0gYXJjaGl2ZSAtIFRoZSByYXcgWklQIGFyY2hpdmUgYnl0ZXMuXG4gKiBAcmV0dXJucyBUaGUgcmVjb3JkJ3Mgb2Zmc2V0LlxuICovXG5mdW5jdGlvbiBmaW5kRW5kT2ZDZW50cmFsRGlyZWN0b3J5T2Zmc2V0KGFyY2hpdmU6IEJ1ZmZlcik6IG51bWJlciB7XG4gIGNvbnN0IGxhc3RQb3NzaWJsZU9mZnNldCA9IGFyY2hpdmUubGVuZ3RoIC0gRU5EX09GX0NFTlRSQUxfRElSRUNUT1JZX1NJWkU7XG4gIGNvbnN0IGZpcnN0UG9zc2libGVPZmZzZXQgPSBNYXRoLm1heCgwLCBsYXN0UG9zc2libGVPZmZzZXQgLSBNQVhfQVJDSElWRV9DT01NRU5UX0xFTkdUSCk7XG5cbiAgZm9yIChsZXQgb2Zmc2V0ID0gbGFzdFBvc3NpYmxlT2Zmc2V0OyBvZmZzZXQgPj0gZmlyc3RQb3NzaWJsZU9mZnNldDsgb2Zmc2V0LS0pIHtcbiAgICBpZiAoYXJjaGl2ZS5yZWFkVUludDMyTEUob2Zmc2V0KSA9PT0gRU5EX09GX0NFTlRSQUxfRElSRUNUT1JZX1NJR05BVFVSRSkge1xuICAgICAgcmV0dXJuIG9mZnNldDtcbiAgICB9XG4gIH1cblxuICB0aHJvdyBuZXcgRXJyb3IoJ1RoZSBhcmNoaXZlIGlzIG5vdCBhIFpJUCBmaWxlOiBpdHMgZW5kLW9mLWNlbnRyYWwtZGlyZWN0b3J5IHJlY29yZCBpcyBtaXNzaW5nLicpO1xufVxuXG4vKipcbiAqIFJlYWRzIHRoZSBjZW50cmFsIGRpcmVjdG9yeSwgd2hpY2ggaXMgdGhlIGFyY2hpdmUncyBhdXRob3JpdGF0aXZlIGluZGV4IG9mIGl0cyBlbnRyaWVzLlxuICpcbiAqIEBwYXJhbSBhcmNoaXZlIC0gVGhlIHJhdyBaSVAgYXJjaGl2ZSBieXRlcy5cbiAqIEByZXR1cm5zIE9uZSB7QGxpbmsgWmlwRW50cnl9IHBlciBlbnRyeSwgaW4gdGhlIG9yZGVyIHRoZSBhcmNoaXZlIGxpc3RzIHRoZW0uXG4gKi9cbmZ1bmN0aW9uIHJlYWRDZW50cmFsRGlyZWN0b3J5KGFyY2hpdmU6IEJ1ZmZlcik6IFppcEVudHJ5W10ge1xuICBjb25zdCBlbmRPZkNlbnRyYWxEaXJlY3RvcnlPZmZzZXQgPSBmaW5kRW5kT2ZDZW50cmFsRGlyZWN0b3J5T2Zmc2V0KGFyY2hpdmUpO1xuICBjb25zdCBlbnRyeUNvdW50ID0gYXJjaGl2ZS5yZWFkVUludDE2TEUoZW5kT2ZDZW50cmFsRGlyZWN0b3J5T2Zmc2V0ICsgQVJDSElWRV9FTlRSWV9DT1VOVF9PRkZTRVQpO1xuICBsZXQgZW50cnlPZmZzZXQgPSBhcmNoaXZlLnJlYWRVSW50MzJMRShlbmRPZkNlbnRyYWxEaXJlY3RvcnlPZmZzZXQgKyBDRU5UUkFMX0RJUkVDVE9SWV9TVEFSVF9PRkZTRVQpO1xuXG4gIGlmIChlbnRyeUNvdW50ID09PSBTQVRVUkFURURfVUlOVF8xNiB8fCBlbnRyeU9mZnNldCA9PT0gU0FUVVJBVEVEX1VJTlRfMzIpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoJ1pJUDY0IGFyY2hpdmVzIGFyZSBub3Qgc3VwcG9ydGVkLicpO1xuICB9XG5cbiAgY29uc3QgZW50cmllczogWmlwRW50cnlbXSA9IFtdO1xuICBmb3IgKGxldCBlbnRyeUluZGV4ID0gMDsgZW50cnlJbmRleCA8IGVudHJ5Q291bnQ7IGVudHJ5SW5kZXgrKykge1xuICAgIGlmIChhcmNoaXZlLnJlYWRVSW50MzJMRShlbnRyeU9mZnNldCkgIT09IENFTlRSQUxfRElSRUNUT1JZX0hFQURFUl9TSUdOQVRVUkUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgVGhlIGFyY2hpdmUncyBjZW50cmFsIGRpcmVjdG9yeSBpcyBjb3JydXB0IGF0IGVudHJ5ICR7U3RyaW5nKGVudHJ5SW5kZXgpfS5gKTtcbiAgICB9XG5cbiAgICBjb25zdCBmbGFncyA9IGFyY2hpdmUucmVhZFVJbnQxNkxFKGVudHJ5T2Zmc2V0ICsgQ0VOVFJBTF9ESVJFQ1RPUllfRkxBR1NfT0ZGU0VUKTtcbiAgICBpZiAoZmxhZ3MgJSBFTkNSWVBURURfRkxBR19ESVZJU09SID09PSAxKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ0VuY3J5cHRlZCBaSVAgYXJjaGl2ZXMgYXJlIG5vdCBzdXBwb3J0ZWQuJyk7XG4gICAgfVxuXG4gICAgY29uc3QgY29tcHJlc3NlZFNpemUgPSBhcmNoaXZlLnJlYWRVSW50MzJMRShlbnRyeU9mZnNldCArIENFTlRSQUxfRElSRUNUT1JZX0NPTVBSRVNTRURfU0laRV9PRkZTRVQpO1xuICAgIGNvbnN0IGxvY2FsSGVhZGVyT2Zmc2V0ID0gYXJjaGl2ZS5yZWFkVUludDMyTEUoZW50cnlPZmZzZXQgKyBDRU5UUkFMX0RJUkVDVE9SWV9MT0NBTF9IRUFERVJfT0ZGU0VUX09GRlNFVCk7XG4gICAgaWYgKGNvbXByZXNzZWRTaXplID09PSBTQVRVUkFURURfVUlOVF8zMiB8fCBsb2NhbEhlYWRlck9mZnNldCA9PT0gU0FUVVJBVEVEX1VJTlRfMzIpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignWklQNjQgYXJjaGl2ZXMgYXJlIG5vdCBzdXBwb3J0ZWQuJyk7XG4gICAgfVxuXG4gICAgY29uc3QgbmFtZUxlbmd0aCA9IGFyY2hpdmUucmVhZFVJbnQxNkxFKGVudHJ5T2Zmc2V0ICsgQ0VOVFJBTF9ESVJFQ1RPUllfTkFNRV9MRU5HVEhfT0ZGU0VUKTtcbiAgICBjb25zdCBuYW1lT2Zmc2V0ID0gZW50cnlPZmZzZXQgKyBDRU5UUkFMX0RJUkVDVE9SWV9IRUFERVJfU0laRTtcbiAgICBlbnRyaWVzLnB1c2goe1xuICAgICAgY29tcHJlc3NlZFNpemUsXG4gICAgICBjb21wcmVzc2lvbk1ldGhvZDogYXJjaGl2ZS5yZWFkVUludDE2TEUoZW50cnlPZmZzZXQgKyBDRU5UUkFMX0RJUkVDVE9SWV9DT01QUkVTU0lPTl9NRVRIT0RfT0ZGU0VUKSxcbiAgICAgIGxvY2FsSGVhZGVyT2Zmc2V0LFxuICAgICAgbmFtZTogYXJjaGl2ZS50b1N0cmluZygndXRmLTgnLCBuYW1lT2Zmc2V0LCBuYW1lT2Zmc2V0ICsgbmFtZUxlbmd0aClcbiAgICB9KTtcblxuICAgIGVudHJ5T2Zmc2V0ID0gbmFtZU9mZnNldFxuICAgICAgKyBuYW1lTGVuZ3RoXG4gICAgICArIGFyY2hpdmUucmVhZFVJbnQxNkxFKGVudHJ5T2Zmc2V0ICsgQ0VOVFJBTF9ESVJFQ1RPUllfRVhUUkFfTEVOR1RIX09GRlNFVClcbiAgICAgICsgYXJjaGl2ZS5yZWFkVUludDE2TEUoZW50cnlPZmZzZXQgKyBDRU5UUkFMX0RJUkVDVE9SWV9DT01NRU5UX0xFTkdUSF9PRkZTRVQpO1xuICB9XG5cbiAgcmV0dXJuIGVudHJpZXM7XG59XG5cbi8qKlxuICogUmVhZHMgYW5kIGRlY29tcHJlc3NlcyBvbmUgZW50cnkncyBieXRlcy5cbiAqXG4gKiBUaGUgZGF0YSdzIHN0YXJ0IGlzIGNvbXB1dGVkIGZyb20gdGhlIExPQ0FMIGhlYWRlciByYXRoZXIgdGhhbiB0aGUgY2VudHJhbCBvbmU6IHRoZSB0d28gY2FycnlcbiAqIGluZGVwZW5kZW50IG5hbWUgYW5kIGV4dHJhLWZpZWxkIGxlbmd0aHMsIGFuZCBvbmx5IHRoZSBsb2NhbCBwYWlyIGRlc2NyaWJlcyB3aGVyZSB0aGUgYnl0ZXNcbiAqIGFjdHVhbGx5IGJlZ2luLlxuICpcbiAqIEBwYXJhbSBhcmNoaXZlIC0gVGhlIHJhdyBaSVAgYXJjaGl2ZSBieXRlcy5cbiAqIEBwYXJhbSBlbnRyeSAtIFRoZSBlbnRyeSwgYXMgcmVhZCBmcm9tIHRoZSBjZW50cmFsIGRpcmVjdG9yeS5cbiAqIEByZXR1cm5zIFRoZSBlbnRyeSdzIHVuY29tcHJlc3NlZCBjb250ZW50LlxuICovXG5mdW5jdGlvbiByZWFkRW50cnlEYXRhKGFyY2hpdmU6IEJ1ZmZlciwgZW50cnk6IFppcEVudHJ5KTogQnVmZmVyIHtcbiAgaWYgKGFyY2hpdmUucmVhZFVJbnQzMkxFKGVudHJ5LmxvY2FsSGVhZGVyT2Zmc2V0KSAhPT0gTE9DQUxfRklMRV9IRUFERVJfU0lHTkFUVVJFKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBUaGUgYXJjaGl2ZSBlbnRyeSAnJHtlbnRyeS5uYW1lfScgaGFzIGEgY29ycnVwdCBsb2NhbCBoZWFkZXIuYCk7XG4gIH1cblxuICBjb25zdCBkYXRhT2Zmc2V0ID0gZW50cnkubG9jYWxIZWFkZXJPZmZzZXRcbiAgICArIExPQ0FMX0hFQURFUl9TSVpFXG4gICAgKyBhcmNoaXZlLnJlYWRVSW50MTZMRShlbnRyeS5sb2NhbEhlYWRlck9mZnNldCArIExPQ0FMX0hFQURFUl9OQU1FX0xFTkdUSF9PRkZTRVQpXG4gICAgKyBhcmNoaXZlLnJlYWRVSW50MTZMRShlbnRyeS5sb2NhbEhlYWRlck9mZnNldCArIExPQ0FMX0hFQURFUl9FWFRSQV9MRU5HVEhfT0ZGU0VUKTtcbiAgY29uc3QgZGF0YUVuZCA9IGRhdGFPZmZzZXQgKyBlbnRyeS5jb21wcmVzc2VkU2l6ZTtcbiAgaWYgKGRhdGFFbmQgPiBhcmNoaXZlLmxlbmd0aCkge1xuICAgIHRocm93IG5ldyBFcnJvcihgVGhlIGFyY2hpdmUgaXMgdHJ1bmNhdGVkOiBlbnRyeSAnJHtlbnRyeS5uYW1lfScgcnVucyBwYXN0IGl0cyBlbmQuYCk7XG4gIH1cblxuICBjb25zdCBjb21wcmVzc2VkRGF0YSA9IGFyY2hpdmUuc3ViYXJyYXkoZGF0YU9mZnNldCwgZGF0YUVuZCk7XG4gIHN3aXRjaCAoZW50cnkuY29tcHJlc3Npb25NZXRob2QpIHtcbiAgICBjYXNlIENPTVBSRVNTSU9OX01FVEhPRF9ERUZMQVRFRDoge1xuICAgICAgcmV0dXJuIGluZmxhdGVSYXdTeW5jKGNvbXByZXNzZWREYXRhKTtcbiAgICB9XG4gICAgY2FzZSBDT01QUkVTU0lPTl9NRVRIT0RfU1RPUkVEOiB7XG4gICAgICByZXR1cm4gY29tcHJlc3NlZERhdGE7XG4gICAgfVxuICAgIGRlZmF1bHQ6IHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgVGhlIGFyY2hpdmUgZW50cnkgJyR7ZW50cnkubmFtZX0nIHVzZXMgdW5zdXBwb3J0ZWQgY29tcHJlc3Npb24gbWV0aG9kICR7U3RyaW5nKGVudHJ5LmNvbXByZXNzaW9uTWV0aG9kKX0uYCk7XG4gICAgfVxuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7OztBQTBCQSxTQUFTLHNCQUFzQjtBQUUvQjtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQXlFUCxNQUFNLHFDQUFxQztBQUMzQyxNQUFNLHFDQUFxQztBQUMzQyxNQUFNLDhCQUE4QjtBQUVwQyxNQUFNLGdDQUFnQztBQUN0QyxNQUFNLDZCQUE2QjtBQUluQyxNQUFNLG9CQUFvQjtBQUMxQixNQUFNLG9CQUFvQjtBQUcxQixNQUFNLDZCQUE2QjtBQUNuQyxNQUFNLGlDQUFpQztBQUd2QyxNQUFNLGlDQUFpQztBQUN2QyxNQUFNLDhDQUE4QztBQUNwRCxNQUFNLDJDQUEyQztBQUNqRCxNQUFNLHVDQUF1QztBQUM3QyxNQUFNLHdDQUF3QztBQUM5QyxNQUFNLDBDQUEwQztBQUNoRCxNQUFNLCtD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

package/dist/lib/esm/disposable.d.mts

@@ -0,0 +1,387 @@
+/// <reference path="./library-references.d.mts" />
+/**
+ * @file
+ *
+ * Disposable utilities for `using` / `await using` declarations.
+ */
+import type { Promisable } from 'type-fest';
+/**
+ * Determines the error semantics of a {@link CombineDisposable} or {@link CombineAsyncDisposable} when
+ * one of its children throws while being disposed.
+ */
+export declare enum DisposeErrorBehavior {
+    /**
+     * Dispose every child even if some of them throw, collecting the thrown errors and re-throwing them
+     * as a single {@link AggregateError} once all children have been disposed.
+     */
+    Aggregate = 0,
+    /**
+     * Re-throw the first error a child throws immediately, leaving the remaining children undisposed.
+     */
+    FailFast = 1
+}
+/**
+ * Determines the order in which a {@link CombineDisposable} or {@link CombineAsyncDisposable} disposes
+ * its children.
+ */
+export declare enum DisposeOrder {
+    /**
+     * Dispose the last-registered child first (last-in, first-out), like nested `using` declarations
+     * unwinding in reverse.
+     */
+    Lifo = 0,
+    /**
+     * Dispose the first-registered child first (first-in, first-out).
+     */
+    Fifo = 1
+}
+/**
+ * Determines how a {@link CallbackDisposable} or {@link AsyncCallbackDisposable} behaves when it is
+ * disposed more than once.
+ */
+export declare enum MultipleDisposeBehavior {
+    /**
+     * Invoke the callback on every dispose.
+     */
+    Invoke = 0,
+    /**
+     * Invoke the callback on the first dispose only; subsequent disposes are no-ops.
+     */
+    Ignore = 1,
+    /**
+     * Invoke the callback on the first dispose only; subsequent disposes throw.
+     */
+    Throw = 2
+}
+/**
+ * The parameters for constructing an {@link AsyncCallbackDisposable}.
+ */
+export interface AsyncCallbackDisposableConstructorParams {
+    /**
+     * The callback to execute when disposed.
+     */
+    readonly callback: AsyncDisposeCallback;
+    /**
+     * How the disposable behaves when disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    readonly multipleDisposeBehavior?: MultipleDisposeBehavior;
+}
+/**
+ * An {@link AsyncDisposable} that additionally exposes a convenience {@link AsyncDisposableEx.asyncDispose}
+ * method, so a stored handle can be disposed as `handle.asyncDispose()` instead of the clunkier
+ * `handle[Symbol.asyncDispose]()`.
+ */
+export interface AsyncDisposableEx extends AsyncDisposable {
+    /**
+     * Disposes the object. Delegates to `this[Symbol.asyncDispose]()`.
+     *
+     * @returns A {@link Promise} that resolves once disposal completes.
+     */
+    asyncDispose: () => Promise<void>;
+}
+/**
+ * A callback invoked when an {@link AsyncCallbackDisposable} is disposed.
+ */
+export type AsyncDisposeCallback = () => Promisable<void>;
+/**
+ * The parameters for constructing a {@link CallbackDisposable}.
+ */
+export interface CallbackDisposableConstructorParams {
+    /**
+     * The callback to execute when disposed.
+     */
+    readonly callback: DisposeCallback;
+    /**
+     * How the disposable behaves when disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    readonly multipleDisposeBehavior?: MultipleDisposeBehavior;
+}
+/**
+ * The parameters for constructing a {@link CombineAsyncDisposable}.
+ */
+export interface CombineAsyncDisposableConstructorParams {
+    /**
+     * The async disposables to dispose when the combiner is disposed.
+     */
+    readonly asyncDisposables: Iterable<AsyncDisposable>;
+    /**
+     * The order in which the children are disposed.
+     *
+     * @default {@link DisposeOrder.Lifo}
+     */
+    readonly disposeOrder?: DisposeOrder;
+    /**
+     * How the combiner behaves when one of its children throws while being disposed.
+     *
+     * @default {@link DisposeErrorBehavior.Aggregate}
+     */
+    readonly errorBehavior?: DisposeErrorBehavior;
+    /**
+     * How the combiner behaves when it is disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    readonly multipleDisposeBehavior?: MultipleDisposeBehavior;
+}
+/**
+ * The parameters for constructing a {@link CombineDisposable}.
+ */
+export interface CombineDisposableConstructorParams {
+    /**
+     * The disposables to dispose when the combiner is disposed.
+     */
+    readonly disposables: Iterable<Disposable>;
+    /**
+     * The order in which the children are disposed.
+     *
+     * @default {@link DisposeOrder.Lifo}
+     */
+    readonly disposeOrder?: DisposeOrder;
+    /**
+     * How the combiner behaves when one of its children throws while being disposed.
+     *
+     * @default {@link DisposeErrorBehavior.Aggregate}
+     */
+    readonly errorBehavior?: DisposeErrorBehavior;
+    /**
+     * How the combiner behaves when it is disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    readonly multipleDisposeBehavior?: MultipleDisposeBehavior;
+}
+/**
+ * A {@link Disposable} that additionally exposes a convenience {@link DisposableEx.dispose} method, so a
+ * stored handle can be disposed as `handle.dispose()` instead of the clunkier `handle[Symbol.dispose]()`.
+ */
+export interface DisposableEx extends Disposable {
+    /**
+     * Disposes the object. Delegates to `this[Symbol.dispose]()`.
+     */
+    dispose: () => void;
+}
+/**
+ * A callback invoked when a {@link CallbackDisposable} is disposed.
+ */
+export type DisposeCallback = () => void;
+/**
+ * Abstract base for an {@link AsyncDisposableEx}: it carries the re-dispose guard (via
+ * {@link MultipleDisposeBehavior}) and the {@link AsyncDisposableEx.asyncDispose} alias; a subclass only
+ * implements {@link AsyncDisposableBase.performDisposeAsync}.
+ */
+export declare abstract class AsyncDisposableBase implements AsyncDisposableEx {
+    /**
+     * How the disposable behaves when disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    protected multipleDisposeBehavior: MultipleDisposeBehavior;
+    /**
+     * Whether this disposable has been disposed (its teardown has run at least once).
+     *
+     * @returns `true` once disposal has started.
+     */
+    protected get isDisposed(): boolean;
+    private _isDisposed;
+    /**
+     * Disposes the object. Convenience alias that delegates to `this[Symbol.asyncDispose]()`.
+     *
+     * @returns A {@link Promise} that resolves once teardown completes.
+     */
+    asyncDispose(): Promise<void>;
+    /**
+     * Disposes the object by running {@link AsyncDisposableBase.performDisposeAsync}, honoring the configured
+     * {@link MultipleDisposeBehavior} on a repeat dispose.
+     *
+     * @returns A {@link Promise} that resolves once teardown completes.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Performs the actual teardown. Called at most once unless {@link MultipleDisposeBehavior.Invoke} is set.
+     *
+     * @returns A {@link Promisable} that resolves once teardown completes.
+     */
+    protected abstract performDisposeAsync(): Promisable<void>;
+}
+/**
+ * An async disposable that executes a callback when disposed via `await using` (or a manual
+ * `await disposable[Symbol.asyncDispose]()`).
+ */
+export declare class AsyncCallbackDisposable extends AsyncDisposableBase {
+    private readonly callback;
+    /**
+     * Creates a new instance of {@link AsyncCallbackDisposable}.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: AsyncCallbackDisposableConstructorParams);
+    /**
+     * Runs the dispose callback.
+     *
+     * @returns A {@link Promise} that resolves once the callback completes.
+     */
+    protected performDisposeAsync(): Promise<void>;
+}
+/**
+ * Disposes a {@link Disposable}.
+ *
+ * Prefer this over calling `disposable[Symbol.dispose]()` at the call site: it reads better and keeps the
+ * well-known symbol referenced in a single place.
+ *
+ * @param disposable - the disposable to dispose
+ */
+export declare function dispose(disposable: Disposable): void;
+/**
+ * Abstract base for a {@link DisposableEx}: it carries the re-dispose guard (via {@link MultipleDisposeBehavior})
+ * and the {@link DisposableEx.dispose} alias; a subclass only implements {@link DisposableBase.performDispose}.
+ */
+export declare abstract class DisposableBase implements DisposableEx {
+    /**
+     * How the disposable behaves when disposed more than once.
+     *
+     * @default {@link MultipleDisposeBehavior.Ignore}
+     */
+    protected multipleDisposeBehavior: MultipleDisposeBehavior;
+    /**
+     * Whether this disposable has been disposed (its teardown has run at least once).
+     *
+     * @returns `true` once disposal has started.
+     */
+    protected get isDisposed(): boolean;
+    private _isDisposed;
+    /**
+     * Disposes the object. Convenience alias that delegates to `this[Symbol.dispose]()`.
+     */
+    dispose(): void;
+    /**
+     * Disposes the object by running {@link DisposableBase.performDispose}, honoring the configured
+     * {@link MultipleDisposeBehavior} on a repeat dispose.
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Performs the actual teardown. Called at most once unless {@link MultipleDisposeBehavior.Invoke} is set.
+     */
+    protected abstract performDispose(): void;
+}
+/**
+ * A disposable that executes a callback when disposed.
+ */
+export declare class CallbackDisposable extends DisposableBase {
+    private readonly callback;
+    /**
+     * Creates a new instance of {@link CallbackDisposable}.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: CallbackDisposableConstructorParams);
+    /**
+     * Runs the dispose callback.
+     */
+    protected performDispose(): void;
+}
+/**
+ * An {@link AsyncDisposableEx} that combines multiple async disposables and disposes all of them when it
+ * is disposed.
+ */
+export declare class CombineAsyncDisposable extends AsyncDisposableBase {
+    private readonly children;
+    private readonly disposeOrder;
+    private readonly errorBehavior;
+    /**
+     * Creates a new instance of {@link CombineAsyncDisposable}.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: CombineAsyncDisposableConstructorParams);
+    /**
+     * Disposes all combined children in the configured {@link DisposeOrder}, applying the configured
+     * {@link DisposeErrorBehavior} when a child throws.
+     *
+     * @returns A {@link Promise} that resolves once all children have been disposed.
+     */
+    protected performDisposeAsync(): Promise<void>;
+    private getOrderedChildren;
+}
+/**
+ * A {@link DisposableEx} that combines multiple disposables and disposes all of them when it is
+ * disposed.
+ */
+export declare class CombineDisposable extends DisposableBase {
+    private readonly children;
+    private readonly disposeOrder;
+    private readonly errorBehavior;
+    /**
+     * Creates a new instance of {@link CombineDisposable}.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: CombineDisposableConstructorParams);
+    /**
+     * Disposes all combined children in the configured {@link DisposeOrder}, applying the configured
+     * {@link DisposeErrorBehavior} when a child throws.
+     */
+    protected performDispose(): void;
+    private getOrderedChildren;
+}
+/**
+ * Disposes an {@link AsyncDisposable}.
+ *
+ * Prefer this over calling `asyncDisposable[Symbol.asyncDispose]()` at the call site: it reads better and
+ * keeps the well-known symbol referenced in a single place.
+ *
+ * @param asyncDisposable - the async disposable to dispose
+ * @returns A {@link Promise} that resolves once the disposal completes.
+ */
+export declare function disposeAsync(asyncDisposable: AsyncDisposable): Promise<void>;
+/**
+ * Type guard to check if an object implements the {@link AsyncDisposable} interface.
+ *
+ * @param $unknown - the object to check for the {@link AsyncDisposable} interface
+ * @returns Whether the object implements the {@link AsyncDisposable} interface
+ */
+export declare function isAsyncDisposable($unknown: unknown): $unknown is AsyncDisposable;
+/**
+ * Type guard to check if an object implements the {@link AsyncDisposableEx} interface.
+ *
+ * @param $unknown - the object to check for the {@link AsyncDisposableEx} interface
+ * @returns Whether the object implements the {@link AsyncDisposableEx} interface
+ */
+export declare function isAsyncDisposableEx($unknown: unknown): $unknown is AsyncDisposableEx;
+/**
+ * Type guard to check if an object implements the {@link Disposable} interface.
+ *
+ * @param $unknown - the object to check for the {@link Disposable} interface
+ * @returns Whether the object implements the {@link Disposable} interface
+ */
+export declare function isDisposable($unknown: unknown): $unknown is Disposable;
+/**
+ * Type guard to check if an object implements the {@link DisposableEx} interface.
+ *
+ * @param $unknown - the object to check for the {@link DisposableEx} interface
+ * @returns Whether the object implements the {@link DisposableEx} interface
+ */
+export declare function isDisposableEx($unknown: unknown): $unknown is DisposableEx;
+/**
+ * Adapts a plain {@link AsyncDisposable} into an {@link AsyncDisposableEx} by adding a convenience
+ * {@link AsyncDisposableEx.asyncDispose} method that delegates to `Symbol.asyncDispose`.
+ *
+ * If the object already implements {@link AsyncDisposableEx}, it is returned unchanged.
+ *
+ * @param asyncDisposable - the async disposable to adapt
+ * @returns An {@link AsyncDisposableEx} wrapping the async disposable.
+ */
+export declare function toAsyncDisposableEx(asyncDisposable: AsyncDisposable): AsyncDisposableEx;
+/**
+ * Adapts a plain {@link Disposable} into a {@link DisposableEx} by adding a convenience
+ * {@link DisposableEx.dispose} method that delegates to `Symbol.dispose`.
+ *
+ * If the object already implements {@link DisposableEx}, it is returned unchanged.
+ *
+ * @param disposable - the disposable to adapt
+ * @returns A {@link DisposableEx} wrapping the disposable.
+ */
+export declare function toDisposableEx(disposable: Disposable): DisposableEx;