tar-vern 0.2.0 → 0.3.0

package/dist/generated/packageMetadata.d.ts

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
@@ -8,7 +8,7 @@
  */
 
 export declare const name = "tar-vern";
-export declare const version = "0.2.0";
+export declare const version = "0.3.0";
 export declare const description = "Tape archiver library for Typescript";
 export declare const author = "Kouji Matsui (@kekyo@mi.kekyo.net)";
 export declare const license = "MIT";

package/dist/index.cjs

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
@@ -200,6 +200,7 @@ const storeReaderToFile = (reader, path) => {
   return new Promise((res, rej) => {
     writer.on("finish", res);
     writer.on("error", rej);
+    reader.on("error", rej);
   });
 };
 const utf8ByteLength = (str) => {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/utils.ts","../src/packer.ts"],"sourcesContent":["// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { createReadStream, createWriteStream } from \"fs\";\nimport { stat } from \"fs/promises\";\nimport { Readable } from \"stream\";\nimport { CreateItemOptions, CreateReadableFileItemOptions, FileItem, DirectoryItem, ReflectStats, CreateDirectoryItemOptions } from \"./types\";\n\n/**\n * Get the user/group name from the candidate name or ID\n * @param candidateName - The candidate user/group name\n * @param candidateId - The candidate user/group ID\n * @param reflectStat - Whether to reflect the stat (all, exceptName, none)\n * @returns The user/group name\n */\nconst getUName = (candidateName: string | undefined, candidateId: number, reflectStat: ReflectStats | undefined) => {\n  return candidateName ?? (reflectStat === 'all' ? candidateId.toString() : 'root');\n}\n\n/**\n * Get a buffer from the string or Buffer\n * @param data - The data to get a buffer from\n * @returns A buffer\n */\nexport const getBuffer = (data: Buffer | string) => {\n  return Buffer.isBuffer(data) ? data : Buffer.from(data, 'utf8');\n}\n\n/**\n * Create a DirectoryItem\n * @param path - The path to the directory in the tar archive\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'none')\n * @param options - Metadata for the directory including path in tar archive\n * @returns A DirectoryItem\n * @remarks When reflectStat is 'all' or 'exceptName', `options.directoryPath` must be provided.\n */\nexport const createDirectoryItem = async (\n  path: string,\n  reflectStat?: ReflectStats,\n  options?: CreateDirectoryItemOptions\n): Promise<DirectoryItem> => {\n  const rs = reflectStat ?? 'none';\n\n  if (rs !== 'none' && options?.directoryPath) {\n    const stats = await stat(options.directoryPath);\n    const mode = options?.mode ?? stats.mode;\n    const uid = options?.uid ?? stats.uid;\n    const gid = options?.gid ?? stats.gid;\n    const date = options?.date ?? stats.mtime;\n    const uname = getUName(options?.uname, stats.uid, rs);\n    const gname = getUName(options?.gname, stats.gid, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  } else {\n    const mode = options?.mode ?? 0o755;\n    const uid = options?.uid ?? 0;\n    const gid = options?.gid ?? 0;\n    const date = options?.date ?? new Date();\n    const uname = getUName(options?.uname, undefined, rs);\n    const gname = getUName(options?.gname, undefined, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  }\n};\n\n/**\n * Create a FileItem from content data directly\n * @param path - The path to the file in the tar archive\n * @param content - Content data\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createFileItem = async (\n  path: string,\n  content: string | Buffer,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // Create a FileItem\n  return {\n    kind: 'file',\n    path, mode, uname, gname, uid, gid, date,\n    content\n  };\n};\n\n/**\n * Create a FileItem from a Readable stream\n * @param path - The path to the file in the tar archive\n * @param readable - The readable stream\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadableFileItem = async (\n  path: string,\n  readable: Readable,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of readable) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a generator\n * @param path - The path to the file in the tar archive\n * @param generator - The generator to read the file from\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createGeneratorFileItem = async (\n  path: string,\n  generator: AsyncGenerator<Buffer, void, unknown>,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of generator) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'generator',\n        length,\n        generator\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a local file path\n * @param path - The path to the file in the tar archive\n * @param filePath - The path to the file to read from real filesystem\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'exceptName')\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadFileItem = async (\n  path: string,\n  filePath: string,\n  reflectStat?: ReflectStats,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const rs = reflectStat ?? 'exceptName';\n\n  // Get file stats to extract metadata\n  const stats = await stat(filePath);\n  // Create readable stream from file\n  const reader = createReadStream(filePath);\n\n  const mode = options?.mode ?? (rs !== 'none' ? stats.mode : undefined);\n  const uid = options?.uid ?? (rs !== 'none' ? stats.uid : undefined);\n  const gid = options?.gid ?? (rs !== 'none' ? stats.gid : undefined);\n  const date = options?.date ?? (rs !== 'none' ? stats.mtime : undefined);\n\n  const uname = getUName(options?.uname, stats.uid, rs);\n  const gname = getUName(options?.gname, stats.gid, rs);\n\n  // Create a FileItem\n  return await createReadableFileItem(path, reader, {\n    length: stats.size, mode, uname, gname, uid, gid, date,\n  });\n};\n\n/**\n * Store a readable stream to a file\n * @param reader - The readable stream\n * @param path - The path to the file to store the readable stream to\n * @returns A promise that resolves when the stream is finished\n */\nexport const storeReaderToFile = (reader: Readable, path: string) => {\n  const writer = createWriteStream(path);\n  reader.pipe(writer);\n  return new Promise<void>((res, rej) => {\n    writer.on('finish', res);\n    writer.on('error', rej);\n  });\n};\n","// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { Readable } from \"stream\";\nimport { createGzip } from \"zlib\";\nimport { getBuffer } from \"./utils\";\nimport { CompressionTypes, EntryItem } from \"./types\";\n\n/**\n * Get the byte length of a string in UTF-8\n * @param str - The string to get the byte length of\n * @returns The byte length of the string\n */\nconst utf8ByteLength = (str: string) => {\n  return Buffer.byteLength(str, \"utf8\");\n}\n\n/**\n * Truncate a string to a maximum byte length in UTF-8\n * @param str - The string to truncate\n * @param maxBytes - The maximum byte length\n * @returns The truncated string\n */\nconst truncateUtf8Safe = (str: string, maxBytes: number) => {\n  let total = 0;\n  let i = 0;\n  while (i < str.length) {\n    const codePoint = str.codePointAt(i)!;\n    const char = String.fromCodePoint(codePoint);\n    const charBytes = Buffer.byteLength(char, \"utf8\");\n    if (total + charBytes > maxBytes) break;\n    total += charBytes;\n    i += char.length;\n  }\n  return str.slice(0, i);\n}\n\n// Tar specification: name max 100 bytes, prefix max 155 bytes\nconst MAX_NAME = 100;\nconst MAX_PREFIX = 155;\n\n/**\n * Split a path into a name and a prefix\n * @param path - The path to split\n * @returns The name and prefix\n */\nconst splitPath = (path: string) => {\n  if (utf8ByteLength(path) <= MAX_NAME) {\n    return { prefix: \"\", name: path };\n  }\n\n  // Split by '/' and find the part that fits in name from the end\n  const parts = path.split(\"/\");\n  let name = parts.pop() ?? \"\";\n  let prefix = parts.join(\"/\");\n\n  // Truncate if name exceeds 100 bytes\n  if (utf8ByteLength(name) > MAX_NAME) {\n    name = truncateUtf8Safe(name, MAX_NAME);\n  }\n\n  // Truncate if prefix exceeds 155 bytes\n  while (utf8ByteLength(prefix) > MAX_PREFIX) {\n    prefix = truncateUtf8Safe(prefix, MAX_PREFIX);\n  }\n\n  return { prefix, name };\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Get octal bytes from a number\n * @param value - The number to get octal bytes from\n * @param length - The length of the octal bytes\n * @returns The octal bytes\n */\nconst getOctalBytes = (value: number, length: number) => {\n  const str = value.toString(8).padStart(length - 1, \"0\") + \"\\0\";\n  return Buffer.from(str, \"ascii\");\n};\n\n/**\n * Get padded bytes from a buffer\n * @param buffer - The buffer to get padded bytes from\n * @returns The padded bytes\n */\nconst getPaddedBytes = (buffer: Buffer) => {\n  const extra = buffer.length % 512;\n  if (extra === 0) {\n    return buffer;\n  } else {\n    return Buffer.concat([buffer, Buffer.alloc(512 - extra, 0)]);\n  }\n}\n\n/**\n * The terminator bytes\n */\nconst terminatorBytes = Buffer.alloc(1024, 0);\n\n/**\n * Create a tar header\n * @param type - The type of the entry\n * @param path - The path of the entry\n * @param size - The size of the entry\n * @param mode - The mode of the entry\n * @param uname - The user name of the entry\n * @param gname - The group name of the entry\n */\nconst createTarHeader = (\n  type: 'file' | 'directory',\n  path: string,\n  size: number,\n  mode: number,\n  uname: string,\n  gname: string,\n  uid: number,\n  gid: number,\n  date: Date\n) => {\n  // Allocate header bytes\n  const buffer = Buffer.alloc(512, 0);\n\n  // Split path into name and prefix\n  const { name, prefix } = splitPath(path);\n\n  // Write name, mode, uid, gid, size, mtime, typeflag, prefix, checksum\n  buffer.write(name, 0, 100, \"utf8\");\n  getOctalBytes(mode & 0o7777, 8).copy(buffer, 100);\n  getOctalBytes(uid, 8).copy(buffer, 108);\n  getOctalBytes(gid, 8).copy(buffer, 116);\n  getOctalBytes(size, 12).copy(buffer, 124);\n  getOctalBytes(Math.floor(date.getTime() / 1000), 12).copy(buffer, 136);\n\n  // Check sum space\n  Buffer.from(\"        \", \"ascii\").copy(buffer, 148);\n\n  if (type === 'file') {\n    buffer.write(\"0\", 156, 1, \"ascii\");    // typeflag (file)\n  } else {\n    buffer.write(\"5\", 156, 1, \"ascii\");    // typeflag (directory)\n  }\n  buffer.write(\"ustar\\0\", 257, 6, \"ascii\");\n  buffer.write(\"00\", 263, 2, \"ascii\");     // version\n  buffer.write(uname, 265, 32, \"utf8\");\n  buffer.write(gname, 297, 32, \"utf8\");\n  buffer.write(prefix, 345, 155, \"utf8\");  // Path prefix\n\n  // Calculate check sum\n  let sum = 0;\n  for (let i = 0; i < 512; i++) {\n    sum += buffer[i];\n  }\n  getOctalBytes(sum, 8).copy(buffer, 148);\n\n  return buffer;\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Create a tar packer\n * @param entryItemGenerator - The async generator of the entry items\n * @param compressionType - The compression type to use (Default: 'none')\n * @param signal - The abort signal to cancel the tar packer\n * @returns Readable stream of the tar packer\n */\nexport const createTarPacker = (\n  entryItemGenerator: AsyncGenerator<EntryItem, void, unknown>,\n  compressionType?: CompressionTypes,\n  signal?: AbortSignal) => {\n\n  // Create async generator function from entry item iterator\n  const entryItemIterator = async function*() {\n    // Iterate over the entry items\n    for await (const entryItem of entryItemGenerator) {\n      signal?.throwIfAborted();\n\n      switch (entryItem.kind) {\n        // Entry is a file\n        case 'file': {\n          const entryItemContent = entryItem.content;\n          // Content is a string or buffer\n          if (typeof entryItemContent === 'string' || Buffer.isBuffer(entryItemContent)) {\n            // Get content bytes from string or buffer\n            const contentBytes = getBuffer(entryItemContent);\n\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              contentBytes.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            // Content bytes to adjust padding space and produce\n            const totalPaddedContentBytes = getPaddedBytes(contentBytes);\n            yield totalPaddedContentBytes;\n          } else {\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              entryItemContent.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            let position = 0;\n            switch (entryItemContent.kind) {\n              // Content is a generator\n              case 'generator': {\n                for await (const contentBytes of entryItemContent.generator) {\n                  signal?.throwIfAborted();\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n              // Content is a readable stream\n              case 'readable': {\n                for await (const content of entryItemContent.readable) {\n                  signal?.throwIfAborted();\n                  const contentBytes = getBuffer(content);\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n            }\n\n            // Padding space\n            if (position % 512 !== 0) {\n              signal?.throwIfAborted();\n              yield Buffer.alloc(512 - (position % 512), 0);\n            }\n          }\n          break;\n        }\n        // Entry is a directory\n        case 'directory': {\n          // Create and produce tar header bytes\n          const tarHeaderBytes = createTarHeader(\n            'directory',\n            entryItem.path,\n            0,\n            entryItem.mode,\n            entryItem.uname,\n            entryItem.gname,\n            entryItem.uid,\n            entryItem.gid,\n            entryItem.date\n          );\n          yield tarHeaderBytes;\n          break;\n        }\n      }\n    }\n\n    // Terminates for tar stream\n    yield terminatorBytes;\n  };\n\n  const ct = compressionType ?? 'none';\n\n  switch (ct) {\n    // No compression\n    case 'none': {\n      // Create readable stream from entry item iterator\n      return Readable.from(entryItemIterator());\n    }\n    // Gzip compression\n    case 'gzip': {\n      // Create gzip stream\n      const gzipStream = createGzip({ level: 9 });\n      // Create readable stream from entry item iterator\n      const entryItemStream = Readable.from(entryItemIterator());\n      // Pipe the entry item stream to the gzip stream\n      entryItemStream.pipe(gzipStream);\n      // Return the gzip stream\n      return gzipStream;\n    }\n  }\n};\n"],"names":["stat","Readable","createReadStream","createWriteStream","createGzip"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/utils.ts","../src/packer.ts"],"sourcesContent":["// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { createReadStream, createWriteStream } from \"fs\";\nimport { stat } from \"fs/promises\";\nimport { Readable } from \"stream\";\nimport { CreateItemOptions, CreateReadableFileItemOptions, FileItem, DirectoryItem, ReflectStats, CreateDirectoryItemOptions } from \"./types\";\n\n/**\n * Get the user/group name from the candidate name or ID\n * @param candidateName - The candidate user/group name\n * @param candidateId - The candidate user/group ID\n * @param reflectStat - Whether to reflect the stat (all, exceptName, none)\n * @returns The user/group name\n */\nconst getUName = (candidateName: string | undefined, candidateId: number, reflectStat: ReflectStats | undefined) => {\n  return candidateName ?? (reflectStat === 'all' ? candidateId.toString() : 'root');\n}\n\n/**\n * Get a buffer from the string or Buffer\n * @param data - The data to get a buffer from\n * @returns A buffer\n */\nexport const getBuffer = (data: Buffer | string) => {\n  return Buffer.isBuffer(data) ? data : Buffer.from(data, 'utf8');\n}\n\n/**\n * Create a DirectoryItem\n * @param path - The path to the directory in the tar archive\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'none')\n * @param options - Metadata for the directory including path in tar archive\n * @returns A DirectoryItem\n * @remarks When reflectStat is 'all' or 'exceptName', `options.directoryPath` must be provided.\n */\nexport const createDirectoryItem = async (\n  path: string,\n  reflectStat?: ReflectStats,\n  options?: CreateDirectoryItemOptions\n): Promise<DirectoryItem> => {\n  const rs = reflectStat ?? 'none';\n\n  if (rs !== 'none' && options?.directoryPath) {\n    const stats = await stat(options.directoryPath);\n    const mode = options?.mode ?? stats.mode;\n    const uid = options?.uid ?? stats.uid;\n    const gid = options?.gid ?? stats.gid;\n    const date = options?.date ?? stats.mtime;\n    const uname = getUName(options?.uname, stats.uid, rs);\n    const gname = getUName(options?.gname, stats.gid, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  } else {\n    const mode = options?.mode ?? 0o755;\n    const uid = options?.uid ?? 0;\n    const gid = options?.gid ?? 0;\n    const date = options?.date ?? new Date();\n    const uname = getUName(options?.uname, undefined, rs);\n    const gname = getUName(options?.gname, undefined, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  }\n};\n\n/**\n * Create a FileItem from content data directly\n * @param path - The path to the file in the tar archive\n * @param content - Content data\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createFileItem = async (\n  path: string,\n  content: string | Buffer,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // Create a FileItem\n  return {\n    kind: 'file',\n    path, mode, uname, gname, uid, gid, date,\n    content\n  };\n};\n\n/**\n * Create a FileItem from a Readable stream\n * @param path - The path to the file in the tar archive\n * @param readable - The readable stream\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadableFileItem = async (\n  path: string,\n  readable: Readable,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of readable) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a generator\n * @param path - The path to the file in the tar archive\n * @param generator - The generator to read the file from\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createGeneratorFileItem = async (\n  path: string,\n  generator: AsyncGenerator<Buffer, void, unknown>,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of generator) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'generator',\n        length,\n        generator\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a local file path\n * @param path - The path to the file in the tar archive\n * @param filePath - The path to the file to read from real filesystem\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'exceptName')\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadFileItem = async (\n  path: string,\n  filePath: string,\n  reflectStat?: ReflectStats,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const rs = reflectStat ?? 'exceptName';\n\n  // Get file stats to extract metadata\n  const stats = await stat(filePath);\n  // Create readable stream from file\n  const reader = createReadStream(filePath);\n\n  const mode = options?.mode ?? (rs !== 'none' ? stats.mode : undefined);\n  const uid = options?.uid ?? (rs !== 'none' ? stats.uid : undefined);\n  const gid = options?.gid ?? (rs !== 'none' ? stats.gid : undefined);\n  const date = options?.date ?? (rs !== 'none' ? stats.mtime : undefined);\n\n  const uname = getUName(options?.uname, stats.uid, rs);\n  const gname = getUName(options?.gname, stats.gid, rs);\n\n  // Create a FileItem\n  return await createReadableFileItem(path, reader, {\n    length: stats.size, mode, uname, gname, uid, gid, date,\n  });\n};\n\n/**\n * Store a readable stream to a file\n * @param reader - The readable stream\n * @param path - The path to the file to store the readable stream to\n * @returns A promise that resolves when the stream is finished\n */\nexport const storeReaderToFile = (reader: Readable, path: string) => {\n  const writer = createWriteStream(path);\n  reader.pipe(writer);\n  return new Promise<void>((res, rej) => {\n    writer.on('finish', res);\n    writer.on('error', rej);\n    reader.on('error', rej);\n  });\n};\n","// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { Readable } from \"stream\";\nimport { createGzip } from \"zlib\";\nimport { getBuffer } from \"./utils\";\nimport { CompressionTypes, EntryItem } from \"./types\";\n\n/**\n * Get the byte length of a string in UTF-8\n * @param str - The string to get the byte length of\n * @returns The byte length of the string\n */\nconst utf8ByteLength = (str: string) => {\n  return Buffer.byteLength(str, \"utf8\");\n}\n\n/**\n * Truncate a string to a maximum byte length in UTF-8\n * @param str - The string to truncate\n * @param maxBytes - The maximum byte length\n * @returns The truncated string\n */\nconst truncateUtf8Safe = (str: string, maxBytes: number) => {\n  let total = 0;\n  let i = 0;\n  while (i < str.length) {\n    const codePoint = str.codePointAt(i)!;\n    const char = String.fromCodePoint(codePoint);\n    const charBytes = Buffer.byteLength(char, \"utf8\");\n    if (total + charBytes > maxBytes) break;\n    total += charBytes;\n    i += char.length;\n  }\n  return str.slice(0, i);\n}\n\n// Tar specification: name max 100 bytes, prefix max 155 bytes\nconst MAX_NAME = 100;\nconst MAX_PREFIX = 155;\n\n/**\n * Split a path into a name and a prefix\n * @param path - The path to split\n * @returns The name and prefix\n */\nconst splitPath = (path: string) => {\n  if (utf8ByteLength(path) <= MAX_NAME) {\n    return { prefix: \"\", name: path };\n  }\n\n  // Split by '/' and find the part that fits in name from the end\n  const parts = path.split(\"/\");\n  let name = parts.pop() ?? \"\";\n  let prefix = parts.join(\"/\");\n\n  // Truncate if name exceeds 100 bytes\n  if (utf8ByteLength(name) > MAX_NAME) {\n    name = truncateUtf8Safe(name, MAX_NAME);\n  }\n\n  // Truncate if prefix exceeds 155 bytes\n  while (utf8ByteLength(prefix) > MAX_PREFIX) {\n    prefix = truncateUtf8Safe(prefix, MAX_PREFIX);\n  }\n\n  return { prefix, name };\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Get octal bytes from a number\n * @param value - The number to get octal bytes from\n * @param length - The length of the octal bytes\n * @returns The octal bytes\n */\nconst getOctalBytes = (value: number, length: number) => {\n  const str = value.toString(8).padStart(length - 1, \"0\") + \"\\0\";\n  return Buffer.from(str, \"ascii\");\n};\n\n/**\n * Get padded bytes from a buffer\n * @param buffer - The buffer to get padded bytes from\n * @returns The padded bytes\n */\nconst getPaddedBytes = (buffer: Buffer) => {\n  const extra = buffer.length % 512;\n  if (extra === 0) {\n    return buffer;\n  } else {\n    return Buffer.concat([buffer, Buffer.alloc(512 - extra, 0)]);\n  }\n}\n\n/**\n * The terminator bytes\n */\nconst terminatorBytes = Buffer.alloc(1024, 0);\n\n/**\n * Create a tar header\n * @param type - The type of the entry\n * @param path - The path of the entry\n * @param size - The size of the entry\n * @param mode - The mode of the entry\n * @param uname - The user name of the entry\n * @param gname - The group name of the entry\n */\nconst createTarHeader = (\n  type: 'file' | 'directory',\n  path: string,\n  size: number,\n  mode: number,\n  uname: string,\n  gname: string,\n  uid: number,\n  gid: number,\n  date: Date\n) => {\n  // Allocate header bytes\n  const buffer = Buffer.alloc(512, 0);\n\n  // Split path into name and prefix\n  const { name, prefix } = splitPath(path);\n\n  // Write name, mode, uid, gid, size, mtime, typeflag, prefix, checksum\n  buffer.write(name, 0, 100, \"utf8\");\n  getOctalBytes(mode & 0o7777, 8).copy(buffer, 100);\n  getOctalBytes(uid, 8).copy(buffer, 108);\n  getOctalBytes(gid, 8).copy(buffer, 116);\n  getOctalBytes(size, 12).copy(buffer, 124);\n  getOctalBytes(Math.floor(date.getTime() / 1000), 12).copy(buffer, 136);\n\n  // Check sum space\n  Buffer.from(\"        \", \"ascii\").copy(buffer, 148);\n\n  if (type === 'file') {\n    buffer.write(\"0\", 156, 1, \"ascii\");    // typeflag (file)\n  } else {\n    buffer.write(\"5\", 156, 1, \"ascii\");    // typeflag (directory)\n  }\n  buffer.write(\"ustar\\0\", 257, 6, \"ascii\");\n  buffer.write(\"00\", 263, 2, \"ascii\");     // version\n  buffer.write(uname, 265, 32, \"utf8\");\n  buffer.write(gname, 297, 32, \"utf8\");\n  buffer.write(prefix, 345, 155, \"utf8\");  // Path prefix\n\n  // Calculate check sum\n  let sum = 0;\n  for (let i = 0; i < 512; i++) {\n    sum += buffer[i];\n  }\n  getOctalBytes(sum, 8).copy(buffer, 148);\n\n  return buffer;\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Create a tar packer\n * @param entryItemGenerator - The async generator of the entry items\n * @param compressionType - The compression type to use (Default: 'none')\n * @param signal - The abort signal to cancel the tar packer\n * @returns Readable stream of the tar packer\n */\nexport const createTarPacker = (\n  entryItemGenerator: AsyncGenerator<EntryItem, void, unknown>,\n  compressionType?: CompressionTypes,\n  signal?: AbortSignal) => {\n\n  // Create async generator function from entry item iterator\n  const entryItemIterator = async function*() {\n    // Iterate over the entry items\n    for await (const entryItem of entryItemGenerator) {\n      signal?.throwIfAborted();\n\n      switch (entryItem.kind) {\n        // Entry is a file\n        case 'file': {\n          const entryItemContent = entryItem.content;\n          // Content is a string or buffer\n          if (typeof entryItemContent === 'string' || Buffer.isBuffer(entryItemContent)) {\n            // Get content bytes from string or buffer\n            const contentBytes = getBuffer(entryItemContent);\n\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              contentBytes.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            // Content bytes to adjust padding space and produce\n            const totalPaddedContentBytes = getPaddedBytes(contentBytes);\n            yield totalPaddedContentBytes;\n          } else {\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              entryItemContent.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            let position = 0;\n            switch (entryItemContent.kind) {\n              // Content is a generator\n              case 'generator': {\n                for await (const contentBytes of entryItemContent.generator) {\n                  signal?.throwIfAborted();\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n              // Content is a readable stream\n              case 'readable': {\n                for await (const content of entryItemContent.readable) {\n                  signal?.throwIfAborted();\n                  const contentBytes = getBuffer(content);\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n            }\n\n            // Padding space\n            if (position % 512 !== 0) {\n              signal?.throwIfAborted();\n              yield Buffer.alloc(512 - (position % 512), 0);\n            }\n          }\n          break;\n        }\n        // Entry is a directory\n        case 'directory': {\n          // Create and produce tar header bytes\n          const tarHeaderBytes = createTarHeader(\n            'directory',\n            entryItem.path,\n            0,\n            entryItem.mode,\n            entryItem.uname,\n            entryItem.gname,\n            entryItem.uid,\n            entryItem.gid,\n            entryItem.date\n          );\n          yield tarHeaderBytes;\n          break;\n        }\n      }\n    }\n\n    // Terminates for tar stream\n    yield terminatorBytes;\n  };\n\n  const ct = compressionType ?? 'none';\n\n  switch (ct) {\n    // No compression\n    case 'none': {\n      // Create readable stream from entry item iterator\n      return Readable.from(entryItemIterator());\n    }\n    // Gzip compression\n    case 'gzip': {\n      // Create gzip stream\n      const gzipStream = createGzip({ level: 9 });\n      // Create readable stream from entry item iterator\n      const entryItemStream = Readable.from(entryItemIterator());\n      // Pipe the entry item stream to the gzip stream\n      entryItemStream.pipe(gzipStream);\n      // Return the gzip stream\n      return gzipStream;\n    }\n  }\n};\n"],"names":["stat","Readable","createReadStream","createWriteStream","createGzip"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT

package/dist/index.js

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
@@ -198,6 +198,7 @@ const storeReaderToFile = (reader, path) => {
   return new Promise((res, rej) => {
     writer.on("finish", res);
     writer.on("error", rej);
+    reader.on("error", rej);
   });
 };
 const utf8ByteLength = (str) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/utils.ts","../src/packer.ts"],"sourcesContent":["// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { createReadStream, createWriteStream } from \"fs\";\nimport { stat } from \"fs/promises\";\nimport { Readable } from \"stream\";\nimport { CreateItemOptions, CreateReadableFileItemOptions, FileItem, DirectoryItem, ReflectStats, CreateDirectoryItemOptions } from \"./types\";\n\n/**\n * Get the user/group name from the candidate name or ID\n * @param candidateName - The candidate user/group name\n * @param candidateId - The candidate user/group ID\n * @param reflectStat - Whether to reflect the stat (all, exceptName, none)\n * @returns The user/group name\n */\nconst getUName = (candidateName: string | undefined, candidateId: number, reflectStat: ReflectStats | undefined) => {\n  return candidateName ?? (reflectStat === 'all' ? candidateId.toString() : 'root');\n}\n\n/**\n * Get a buffer from the string or Buffer\n * @param data - The data to get a buffer from\n * @returns A buffer\n */\nexport const getBuffer = (data: Buffer | string) => {\n  return Buffer.isBuffer(data) ? data : Buffer.from(data, 'utf8');\n}\n\n/**\n * Create a DirectoryItem\n * @param path - The path to the directory in the tar archive\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'none')\n * @param options - Metadata for the directory including path in tar archive\n * @returns A DirectoryItem\n * @remarks When reflectStat is 'all' or 'exceptName', `options.directoryPath` must be provided.\n */\nexport const createDirectoryItem = async (\n  path: string,\n  reflectStat?: ReflectStats,\n  options?: CreateDirectoryItemOptions\n): Promise<DirectoryItem> => {\n  const rs = reflectStat ?? 'none';\n\n  if (rs !== 'none' && options?.directoryPath) {\n    const stats = await stat(options.directoryPath);\n    const mode = options?.mode ?? stats.mode;\n    const uid = options?.uid ?? stats.uid;\n    const gid = options?.gid ?? stats.gid;\n    const date = options?.date ?? stats.mtime;\n    const uname = getUName(options?.uname, stats.uid, rs);\n    const gname = getUName(options?.gname, stats.gid, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  } else {\n    const mode = options?.mode ?? 0o755;\n    const uid = options?.uid ?? 0;\n    const gid = options?.gid ?? 0;\n    const date = options?.date ?? new Date();\n    const uname = getUName(options?.uname, undefined, rs);\n    const gname = getUName(options?.gname, undefined, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  }\n};\n\n/**\n * Create a FileItem from content data directly\n * @param path - The path to the file in the tar archive\n * @param content - Content data\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createFileItem = async (\n  path: string,\n  content: string | Buffer,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // Create a FileItem\n  return {\n    kind: 'file',\n    path, mode, uname, gname, uid, gid, date,\n    content\n  };\n};\n\n/**\n * Create a FileItem from a Readable stream\n * @param path - The path to the file in the tar archive\n * @param readable - The readable stream\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadableFileItem = async (\n  path: string,\n  readable: Readable,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of readable) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a generator\n * @param path - The path to the file in the tar archive\n * @param generator - The generator to read the file from\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createGeneratorFileItem = async (\n  path: string,\n  generator: AsyncGenerator<Buffer, void, unknown>,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of generator) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'generator',\n        length,\n        generator\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a local file path\n * @param path - The path to the file in the tar archive\n * @param filePath - The path to the file to read from real filesystem\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'exceptName')\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadFileItem = async (\n  path: string,\n  filePath: string,\n  reflectStat?: ReflectStats,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const rs = reflectStat ?? 'exceptName';\n\n  // Get file stats to extract metadata\n  const stats = await stat(filePath);\n  // Create readable stream from file\n  const reader = createReadStream(filePath);\n\n  const mode = options?.mode ?? (rs !== 'none' ? stats.mode : undefined);\n  const uid = options?.uid ?? (rs !== 'none' ? stats.uid : undefined);\n  const gid = options?.gid ?? (rs !== 'none' ? stats.gid : undefined);\n  const date = options?.date ?? (rs !== 'none' ? stats.mtime : undefined);\n\n  const uname = getUName(options?.uname, stats.uid, rs);\n  const gname = getUName(options?.gname, stats.gid, rs);\n\n  // Create a FileItem\n  return await createReadableFileItem(path, reader, {\n    length: stats.size, mode, uname, gname, uid, gid, date,\n  });\n};\n\n/**\n * Store a readable stream to a file\n * @param reader - The readable stream\n * @param path - The path to the file to store the readable stream to\n * @returns A promise that resolves when the stream is finished\n */\nexport const storeReaderToFile = (reader: Readable, path: string) => {\n  const writer = createWriteStream(path);\n  reader.pipe(writer);\n  return new Promise<void>((res, rej) => {\n    writer.on('finish', res);\n    writer.on('error', rej);\n  });\n};\n","// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { Readable } from \"stream\";\nimport { createGzip } from \"zlib\";\nimport { getBuffer } from \"./utils\";\nimport { CompressionTypes, EntryItem } from \"./types\";\n\n/**\n * Get the byte length of a string in UTF-8\n * @param str - The string to get the byte length of\n * @returns The byte length of the string\n */\nconst utf8ByteLength = (str: string) => {\n  return Buffer.byteLength(str, \"utf8\");\n}\n\n/**\n * Truncate a string to a maximum byte length in UTF-8\n * @param str - The string to truncate\n * @param maxBytes - The maximum byte length\n * @returns The truncated string\n */\nconst truncateUtf8Safe = (str: string, maxBytes: number) => {\n  let total = 0;\n  let i = 0;\n  while (i < str.length) {\n    const codePoint = str.codePointAt(i)!;\n    const char = String.fromCodePoint(codePoint);\n    const charBytes = Buffer.byteLength(char, \"utf8\");\n    if (total + charBytes > maxBytes) break;\n    total += charBytes;\n    i += char.length;\n  }\n  return str.slice(0, i);\n}\n\n// Tar specification: name max 100 bytes, prefix max 155 bytes\nconst MAX_NAME = 100;\nconst MAX_PREFIX = 155;\n\n/**\n * Split a path into a name and a prefix\n * @param path - The path to split\n * @returns The name and prefix\n */\nconst splitPath = (path: string) => {\n  if (utf8ByteLength(path) <= MAX_NAME) {\n    return { prefix: \"\", name: path };\n  }\n\n  // Split by '/' and find the part that fits in name from the end\n  const parts = path.split(\"/\");\n  let name = parts.pop() ?? \"\";\n  let prefix = parts.join(\"/\");\n\n  // Truncate if name exceeds 100 bytes\n  if (utf8ByteLength(name) > MAX_NAME) {\n    name = truncateUtf8Safe(name, MAX_NAME);\n  }\n\n  // Truncate if prefix exceeds 155 bytes\n  while (utf8ByteLength(prefix) > MAX_PREFIX) {\n    prefix = truncateUtf8Safe(prefix, MAX_PREFIX);\n  }\n\n  return { prefix, name };\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Get octal bytes from a number\n * @param value - The number to get octal bytes from\n * @param length - The length of the octal bytes\n * @returns The octal bytes\n */\nconst getOctalBytes = (value: number, length: number) => {\n  const str = value.toString(8).padStart(length - 1, \"0\") + \"\\0\";\n  return Buffer.from(str, \"ascii\");\n};\n\n/**\n * Get padded bytes from a buffer\n * @param buffer - The buffer to get padded bytes from\n * @returns The padded bytes\n */\nconst getPaddedBytes = (buffer: Buffer) => {\n  const extra = buffer.length % 512;\n  if (extra === 0) {\n    return buffer;\n  } else {\n    return Buffer.concat([buffer, Buffer.alloc(512 - extra, 0)]);\n  }\n}\n\n/**\n * The terminator bytes\n */\nconst terminatorBytes = Buffer.alloc(1024, 0);\n\n/**\n * Create a tar header\n * @param type - The type of the entry\n * @param path - The path of the entry\n * @param size - The size of the entry\n * @param mode - The mode of the entry\n * @param uname - The user name of the entry\n * @param gname - The group name of the entry\n */\nconst createTarHeader = (\n  type: 'file' | 'directory',\n  path: string,\n  size: number,\n  mode: number,\n  uname: string,\n  gname: string,\n  uid: number,\n  gid: number,\n  date: Date\n) => {\n  // Allocate header bytes\n  const buffer = Buffer.alloc(512, 0);\n\n  // Split path into name and prefix\n  const { name, prefix } = splitPath(path);\n\n  // Write name, mode, uid, gid, size, mtime, typeflag, prefix, checksum\n  buffer.write(name, 0, 100, \"utf8\");\n  getOctalBytes(mode & 0o7777, 8).copy(buffer, 100);\n  getOctalBytes(uid, 8).copy(buffer, 108);\n  getOctalBytes(gid, 8).copy(buffer, 116);\n  getOctalBytes(size, 12).copy(buffer, 124);\n  getOctalBytes(Math.floor(date.getTime() / 1000), 12).copy(buffer, 136);\n\n  // Check sum space\n  Buffer.from(\"        \", \"ascii\").copy(buffer, 148);\n\n  if (type === 'file') {\n    buffer.write(\"0\", 156, 1, \"ascii\");    // typeflag (file)\n  } else {\n    buffer.write(\"5\", 156, 1, \"ascii\");    // typeflag (directory)\n  }\n  buffer.write(\"ustar\\0\", 257, 6, \"ascii\");\n  buffer.write(\"00\", 263, 2, \"ascii\");     // version\n  buffer.write(uname, 265, 32, \"utf8\");\n  buffer.write(gname, 297, 32, \"utf8\");\n  buffer.write(prefix, 345, 155, \"utf8\");  // Path prefix\n\n  // Calculate check sum\n  let sum = 0;\n  for (let i = 0; i < 512; i++) {\n    sum += buffer[i];\n  }\n  getOctalBytes(sum, 8).copy(buffer, 148);\n\n  return buffer;\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Create a tar packer\n * @param entryItemGenerator - The async generator of the entry items\n * @param compressionType - The compression type to use (Default: 'none')\n * @param signal - The abort signal to cancel the tar packer\n * @returns Readable stream of the tar packer\n */\nexport const createTarPacker = (\n  entryItemGenerator: AsyncGenerator<EntryItem, void, unknown>,\n  compressionType?: CompressionTypes,\n  signal?: AbortSignal) => {\n\n  // Create async generator function from entry item iterator\n  const entryItemIterator = async function*() {\n    // Iterate over the entry items\n    for await (const entryItem of entryItemGenerator) {\n      signal?.throwIfAborted();\n\n      switch (entryItem.kind) {\n        // Entry is a file\n        case 'file': {\n          const entryItemContent = entryItem.content;\n          // Content is a string or buffer\n          if (typeof entryItemContent === 'string' || Buffer.isBuffer(entryItemContent)) {\n            // Get content bytes from string or buffer\n            const contentBytes = getBuffer(entryItemContent);\n\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              contentBytes.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            // Content bytes to adjust padding space and produce\n            const totalPaddedContentBytes = getPaddedBytes(contentBytes);\n            yield totalPaddedContentBytes;\n          } else {\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              entryItemContent.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            let position = 0;\n            switch (entryItemContent.kind) {\n              // Content is a generator\n              case 'generator': {\n                for await (const contentBytes of entryItemContent.generator) {\n                  signal?.throwIfAborted();\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n              // Content is a readable stream\n              case 'readable': {\n                for await (const content of entryItemContent.readable) {\n                  signal?.throwIfAborted();\n                  const contentBytes = getBuffer(content);\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n            }\n\n            // Padding space\n            if (position % 512 !== 0) {\n              signal?.throwIfAborted();\n              yield Buffer.alloc(512 - (position % 512), 0);\n            }\n          }\n          break;\n        }\n        // Entry is a directory\n        case 'directory': {\n          // Create and produce tar header bytes\n          const tarHeaderBytes = createTarHeader(\n            'directory',\n            entryItem.path,\n            0,\n            entryItem.mode,\n            entryItem.uname,\n            entryItem.gname,\n            entryItem.uid,\n            entryItem.gid,\n            entryItem.date\n          );\n          yield tarHeaderBytes;\n          break;\n        }\n      }\n    }\n\n    // Terminates for tar stream\n    yield terminatorBytes;\n  };\n\n  const ct = compressionType ?? 'none';\n\n  switch (ct) {\n    // No compression\n    case 'none': {\n      // Create readable stream from entry item iterator\n      return Readable.from(entryItemIterator());\n    }\n    // Gzip compression\n    case 'gzip': {\n      // Create gzip stream\n      const gzipStream = createGzip({ level: 9 });\n      // Create readable stream from entry item iterator\n      const entryItemStream = Readable.from(entryItemIterator());\n      // Pipe the entry item stream to the gzip stream\n      entryItemStream.pipe(gzipStream);\n      // Return the gzip stream\n      return gzipStream;\n    }\n  }\n};\n"],"names":[],"mappings":";;;;AAiBA,MAAM,WAAW,CAAC,eAAmC,aAAqB,gBAA0C;AAClH,SAAO,kBAAkB,gBAAgB,QAAQ,YAAY,aAAa;AAC5E;AAOO,MAAM,YAAY,CAAC,SAA0B;AAClD,SAAO,OAAO,SAAS,IAAI,IAAI,OAAO,OAAO,KAAK,MAAM,MAAM;AAChE;AAUO,MAAM,sBAAsB,OACjC,MACA,aACA,YAC2B;AAC3B,QAAM,KAAK,eAAe;AAE1B,MAAI,OAAO,UAAU,SAAS,eAAe;AAC3C,UAAM,QAAQ,MAAM,KAAK,QAAQ,aAAa;AAC9C,UAAM,OAAO,SAAS,QAAQ,MAAM;AACpC,UAAM,MAAM,SAAS,OAAO,MAAM;AAClC,UAAM,MAAM,SAAS,OAAO,MAAM;AAClC,UAAM,OAAO,SAAS,QAAQ,MAAM;AACpC,UAAM,QAAQ,SAAS,SAAS,OAAO,MAAM,KAAK,EAAE;AACpD,UAAM,QAAQ,SAAS,SAAS,OAAO,MAAM,KAAK,EAAE;AACpD,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,IAAA;AAAA,EAExC,OAAO;AACL,UAAM,OAAO,SAAS,QAAQ;AAC9B,UAAM,MAAM,SAAS,OAAO;AAC5B,UAAM,MAAM,SAAS,OAAO;AAC5B,UAAM,OAAO,SAAS,QAAQ,oBAAI,KAAA;AAClC,UAAM,QAAQ,SAAS,SAAS,OAAO,QAAW,EAAE;AACpD,UAAM,QAAQ,SAAS,SAAS,OAAO,QAAW,EAAE;AACpD,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,IAAA;AAAA,EAExC;AACF;AASO,MAAM,iBAAiB,OAC5B,MACA,SACA,YACsB;AACtB,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,OAAO,SAAS,QAAQ,oBAAI,KAAA;AAElC,QAAM,QAAQ,SAAS,SAAS;AAChC,QAAM,QAAQ,SAAS,SAAS;AAGhC,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IAAM;AAAA,IAAM;AAAA,IAAO;AAAA,IAAO;AAAA,IAAK;AAAA,IAAK;AAAA,IACpC;AAAA,EAAA;AAEJ;AASO,MAAM,yBAAyB,OACpC,MACA,UACA,YACsB;AACtB,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,OAAO,SAAS,QAAQ,oBAAI,KAAA;AAElC,QAAM,QAAQ,SAAS,SAAS;AAChC,QAAM,QAAQ,SAAS,SAAS;AAGhC,MAAI,SAAS,SAAS;AACtB,MAAI,CAAC,QAAQ;AAEX,UAAM,SAAmB,CAAA;AACzB,aAAS;AAGT,qBAAiB,SAAS,UAAU;AAClC,YAAM,SAAS,UAAU,KAAK;AAC9B,aAAO,KAAK,MAAM;AAClB,gBAAU,OAAO;AAAA,IACnB;AAGA,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,MACpC,SAAS;AAAA,QACP,MAAM;AAAA,QACN;AAAA,QACA,UAAU,SAAS,KAAK,MAAM;AAAA,MAAA;AAAA,IAChC;AAAA,EAEJ,OAAO;AAEL,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,MACpC,SAAS;AAAA,QACP,MAAM;AAAA,QACN;AAAA,QACA;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ;AACF;AASO,MAAM,0BAA0B,OACrC,MACA,WACA,YACsB;AACtB,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,MAAM,SAAS,OAAO;AAC5B,QAAM,OAAO,SAAS,QAAQ,oBAAI,KAAA;AAElC,QAAM,QAAQ,SAAS,SAAS;AAChC,QAAM,QAAQ,SAAS,SAAS;AAGhC,MAAI,SAAS,SAAS;AACtB,MAAI,CAAC,QAAQ;AAEX,UAAM,SAAmB,CAAA;AACzB,aAAS;AAGT,qBAAiB,SAAS,WAAW;AACnC,YAAM,SAAS,UAAU,KAAK;AAC9B,aAAO,KAAK,MAAM;AAClB,gBAAU,OAAO;AAAA,IACnB;AAGA,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,MACpC,SAAS;AAAA,QACP,MAAM;AAAA,QACN;AAAA,QACA,UAAU,SAAS,KAAK,MAAM;AAAA,MAAA;AAAA,IAChC;AAAA,EAEJ,OAAO;AAEL,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MAAM;AAAA,MAAM;AAAA,MAAO;AAAA,MAAO;AAAA,MAAK;AAAA,MAAK;AAAA,MACpC,SAAS;AAAA,QACP,MAAM;AAAA,QACN;AAAA,QACA;AAAA,MAAA;AAAA,IACF;AAAA,EAEJ;AACF;AAUO,MAAM,qBAAqB,OAChC,MACA,UACA,aACA,YACsB;AACtB,QAAM,KAAK,eAAe;AAG1B,QAAM,QAAQ,MAAM,KAAK,QAAQ;AAEjC,QAAM,SAAS,iBAAiB,QAAQ;AAExC,QAAM,OAAO,SAAS,SAAS,OAAO,SAAS,MAAM,OAAO;AAC5D,QAAM,MAAM,SAAS,QAAQ,OAAO,SAAS,MAAM,MAAM;AACzD,QAAM,MAAM,SAAS,QAAQ,OAAO,SAAS,MAAM,MAAM;AACzD,QAAM,OAAO,SAAS,SAAS,OAAO,SAAS,MAAM,QAAQ;AAE7D,QAAM,QAAQ,SAAS,SAAS,OAAO,MAAM,KAAK,EAAE;AACpD,QAAM,QAAQ,SAAS,SAAS,OAAO,MAAM,KAAK,EAAE;AAGpD,SAAO,MAAM,uBAAuB,MAAM,QAAQ;AAAA,IAChD,QAAQ,MAAM;AAAA,IAAM;AAAA,IAAM;AAAA,IAAO;AAAA,IAAO;AAAA,IAAK;AAAA,IAAK;AAAA,EAAA,CACnD;AACH;AAQO,MAAM,oBAAoB,CAAC,QAAkB,SAAiB;AACnE,QAAM,SAAS,kBAAkB,IAAI;AACrC,SAAO,KAAK,MAAM;AAClB,SAAO,IAAI,QAAc,CAAC,KAAK,QAAQ;AACrC,WAAO,GAAG,UAAU,GAAG;AACvB,WAAO,GAAG,SAAS,GAAG;AAAA,EACxB,CAAC;AACH;ACxPA,MAAM,iBAAiB,CAAC,QAAgB;AACtC,SAAO,OAAO,WAAW,KAAK,MAAM;AACtC;AAQA,MAAM,mBAAmB,CAAC,KAAa,aAAqB;AAC1D,MAAI,QAAQ;AACZ,MAAI,IAAI;AACR,SAAO,IAAI,IAAI,QAAQ;AACrB,UAAM,YAAY,IAAI,YAAY,CAAC;AACnC,UAAM,OAAO,OAAO,cAAc,SAAS;AAC3C,UAAM,YAAY,OAAO,WAAW,MAAM,MAAM;AAChD,QAAI,QAAQ,YAAY,SAAU;AAClC,aAAS;AACT,SAAK,KAAK;AAAA,EACZ;AACA,SAAO,IAAI,MAAM,GAAG,CAAC;AACvB;AAGA,MAAM,WAAW;AACjB,MAAM,aAAa;AAOnB,MAAM,YAAY,CAAC,SAAiB;AAClC,MAAI,eAAe,IAAI,KAAK,UAAU;AACpC,WAAO,EAAE,QAAQ,IAAI,MAAM,KAAA;AAAA,EAC7B;AAGA,QAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,MAAI,OAAO,MAAM,IAAA,KAAS;AAC1B,MAAI,SAAS,MAAM,KAAK,GAAG;AAG3B,MAAI,eAAe,IAAI,IAAI,UAAU;AACnC,WAAO,iBAAiB,MAAM,QAAQ;AAAA,EACxC;AAGA,SAAO,eAAe,MAAM,IAAI,YAAY;AAC1C,aAAS,iBAAiB,QAAQ,UAAU;AAAA,EAC9C;AAEA,SAAO,EAAE,QAAQ,KAAA;AACnB;AAUA,MAAM,gBAAgB,CAAC,OAAe,WAAmB;AACvD,QAAM,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS,SAAS,GAAG,GAAG,IAAI;AAC1D,SAAO,OAAO,KAAK,KAAK,OAAO;AACjC;AAOA,MAAM,iBAAiB,CAAC,WAAmB;AACzC,QAAM,QAAQ,OAAO,SAAS;AAC9B,MAAI,UAAU,GAAG;AACf,WAAO;AAAA,EACT,OAAO;AACL,WAAO,OAAO,OAAO,CAAC,QAAQ,OAAO,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC;AAAA,EAC7D;AACF;AAKA,MAAM,kBAAkB,OAAO,MAAM,MAAM,CAAC;AAW5C,MAAM,kBAAkB,CACtB,MACA,MACA,MACA,MACA,OACA,OACA,KACA,KACA,SACG;AAEH,QAAM,SAAS,OAAO,MAAM,KAAK,CAAC;AAGlC,QAAM,EAAE,MAAM,WAAW,UAAU,IAAI;AAGvC,SAAO,MAAM,MAAM,GAAG,KAAK,MAAM;AACjC,gBAAc,OAAO,MAAQ,CAAC,EAAE,KAAK,QAAQ,GAAG;AAChD,gBAAc,KAAK,CAAC,EAAE,KAAK,QAAQ,GAAG;AACtC,gBAAc,KAAK,CAAC,EAAE,KAAK,QAAQ,GAAG;AACtC,gBAAc,MAAM,EAAE,EAAE,KAAK,QAAQ,GAAG;AACxC,gBAAc,KAAK,MAAM,KAAK,QAAA,IAAY,GAAI,GAAG,EAAE,EAAE,KAAK,QAAQ,GAAG;AAGrE,SAAO,KAAK,YAAY,OAAO,EAAE,KAAK,QAAQ,GAAG;AAEjD,MAAI,SAAS,QAAQ;AACnB,WAAO,MAAM,KAAK,KAAK,GAAG,OAAO;AAAA,EACnC,OAAO;AACL,WAAO,MAAM,KAAK,KAAK,GAAG,OAAO;AAAA,EACnC;AACA,SAAO,MAAM,WAAW,KAAK,GAAG,OAAO;AACvC,SAAO,MAAM,MAAM,KAAK,GAAG,OAAO;AAClC,SAAO,MAAM,OAAO,KAAK,IAAI,MAAM;AACnC,SAAO,MAAM,OAAO,KAAK,IAAI,MAAM;AACnC,SAAO,MAAM,QAAQ,KAAK,KAAK,MAAM;AAGrC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,WAAO,OAAO,CAAC;AAAA,EACjB;AACA,gBAAc,KAAK,CAAC,EAAE,KAAK,QAAQ,GAAG;AAEtC,SAAO;AACT;AAWO,MAAM,kBAAkB,CAC7B,oBACA,iBACA,WAAyB;AAGzB,QAAM,oBAAoB,mBAAkB;AAE1C,qBAAiB,aAAa,oBAAoB;AAChD,cAAQ,eAAA;AAER,cAAQ,UAAU,MAAA;AAAA;AAAA,QAEhB,KAAK,QAAQ;AACX,gBAAM,mBAAmB,UAAU;AAEnC,cAAI,OAAO,qBAAqB,YAAY,OAAO,SAAS,gBAAgB,GAAG;AAE7E,kBAAM,eAAe,UAAU,gBAAgB;AAG/C,kBAAM,iBAAiB;AAAA,cACrB;AAAA,cACA,UAAU;AAAA,cACV,aAAa;AAAA,cACb,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,YAAA;AACZ,kBAAM;AAGN,kBAAM,0BAA0B,eAAe,YAAY;AAC3D,kBAAM;AAAA,UACR,OAAO;AAEL,kBAAM,iBAAiB;AAAA,cACrB;AAAA,cACA,UAAU;AAAA,cACV,iBAAiB;AAAA,cACjB,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,cACV,UAAU;AAAA,YAAA;AACZ,kBAAM;AAEN,gBAAI,WAAW;AACf,oBAAQ,iBAAiB,MAAA;AAAA;AAAA,cAEvB,KAAK,aAAa;AAChB,iCAAiB,gBAAgB,iBAAiB,WAAW;AAC3D,0BAAQ,eAAA;AACR,wBAAM;AACN,8BAAY,aAAa;AAAA,gBAC3B;AACA;AAAA,cACF;AAAA;AAAA,cAEA,KAAK,YAAY;AACf,iCAAiB,WAAW,iBAAiB,UAAU;AACrD,0BAAQ,eAAA;AACR,wBAAM,eAAe,UAAU,OAAO;AACtC,wBAAM;AACN,8BAAY,aAAa;AAAA,gBAC3B;AACA;AAAA,cACF;AAAA,YAAA;AAIF,gBAAI,WAAW,QAAQ,GAAG;AACxB,sBAAQ,eAAA;AACR,oBAAM,OAAO,MAAM,MAAO,WAAW,KAAM,CAAC;AAAA,YAC9C;AAAA,UACF;AACA;AAAA,QACF;AAAA;AAAA,QAEA,KAAK,aAAa;AAEhB,gBAAM,iBAAiB;AAAA,YACrB;AAAA,YACA,UAAU;AAAA,YACV;AAAA,YACA,UAAU;AAAA,YACV,UAAU;AAAA,YACV,UAAU;AAAA,YACV,UAAU;AAAA,YACV,UAAU;AAAA,YACV,UAAU;AAAA,UAAA;AAEZ,gBAAM;AACN;AAAA,QACF;AAAA,MAAA;AAAA,IAEJ;AAGA,UAAM;AAAA,EACR;AAEA,QAAM,KAAK,mBAAmB;AAE9B,UAAQ,IAAA;AAAA;AAAA,IAEN,KAAK,QAAQ;AAEX,aAAO,SAAS,KAAK,mBAAmB;AAAA,IAC1C;AAAA;AAAA,IAEA,KAAK,QAAQ;AAEX,YAAM,aAAa,WAAW,EAAE,OAAO,GAAG;AAE1C,YAAM,kBAAkB,SAAS,KAAK,kBAAA,CAAmB;AAEzD,sBAAgB,KAAK,UAAU;AAE/B,aAAO;AAAA,IACT;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"index.js","sources":["../src/utils.ts","../src/packer.ts"],"sourcesContent":["// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { createReadStream, createWriteStream } from \"fs\";\nimport { stat } from \"fs/promises\";\nimport { Readable } from \"stream\";\nimport { CreateItemOptions, CreateReadableFileItemOptions, FileItem, DirectoryItem, ReflectStats, CreateDirectoryItemOptions } from \"./types\";\n\n/**\n * Get the user/group name from the candidate name or ID\n * @param candidateName - The candidate user/group name\n * @param candidateId - The candidate user/group ID\n * @param reflectStat - Whether to reflect the stat (all, exceptName, none)\n * @returns The user/group name\n */\nconst getUName = (candidateName: string | undefined, candidateId: number, reflectStat: ReflectStats | undefined) => {\n  return candidateName ?? (reflectStat === 'all' ? candidateId.toString() : 'root');\n}\n\n/**\n * Get a buffer from the string or Buffer\n * @param data - The data to get a buffer from\n * @returns A buffer\n */\nexport const getBuffer = (data: Buffer | string) => {\n  return Buffer.isBuffer(data) ? data : Buffer.from(data, 'utf8');\n}\n\n/**\n * Create a DirectoryItem\n * @param path - The path to the directory in the tar archive\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'none')\n * @param options - Metadata for the directory including path in tar archive\n * @returns A DirectoryItem\n * @remarks When reflectStat is 'all' or 'exceptName', `options.directoryPath` must be provided.\n */\nexport const createDirectoryItem = async (\n  path: string,\n  reflectStat?: ReflectStats,\n  options?: CreateDirectoryItemOptions\n): Promise<DirectoryItem> => {\n  const rs = reflectStat ?? 'none';\n\n  if (rs !== 'none' && options?.directoryPath) {\n    const stats = await stat(options.directoryPath);\n    const mode = options?.mode ?? stats.mode;\n    const uid = options?.uid ?? stats.uid;\n    const gid = options?.gid ?? stats.gid;\n    const date = options?.date ?? stats.mtime;\n    const uname = getUName(options?.uname, stats.uid, rs);\n    const gname = getUName(options?.gname, stats.gid, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  } else {\n    const mode = options?.mode ?? 0o755;\n    const uid = options?.uid ?? 0;\n    const gid = options?.gid ?? 0;\n    const date = options?.date ?? new Date();\n    const uname = getUName(options?.uname, undefined, rs);\n    const gname = getUName(options?.gname, undefined, rs);\n    return {\n      kind: 'directory',\n      path, mode, uname, gname, uid, gid, date,\n    };\n  }\n};\n\n/**\n * Create a FileItem from content data directly\n * @param path - The path to the file in the tar archive\n * @param content - Content data\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createFileItem = async (\n  path: string,\n  content: string | Buffer,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // Create a FileItem\n  return {\n    kind: 'file',\n    path, mode, uname, gname, uid, gid, date,\n    content\n  };\n};\n\n/**\n * Create a FileItem from a Readable stream\n * @param path - The path to the file in the tar archive\n * @param readable - The readable stream\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadableFileItem = async (\n  path: string,\n  readable: Readable,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of readable) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a generator\n * @param path - The path to the file in the tar archive\n * @param generator - The generator to read the file from\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createGeneratorFileItem = async (\n  path: string,\n  generator: AsyncGenerator<Buffer, void, unknown>,\n  options?: CreateReadableFileItemOptions\n): Promise<FileItem> => {\n  const mode = options?.mode ?? 0o644;\n  const uid = options?.uid ?? 0;\n  const gid = options?.gid ?? 0;\n  const date = options?.date ?? new Date();\n\n  const uname = options?.uname ?? 'root';\n  const gname = options?.gname ?? 'root';\n\n  // When length is not provided, calculate the total size by reading all chunks\n  let length = options?.length;\n  if (!length) {\n    // Calculate the total size by reading all chunks\n    const chunks: Buffer[] = [];\n    length = 0;\n\n    // Collect all chunks to calculate size\n    for await (const chunk of generator) {\n      const buffer = getBuffer(chunk);\n      chunks.push(buffer);\n      length += buffer.length;\n    }\n\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'readable',\n        length,\n        readable: Readable.from(chunks)\n      }\n    };\n  } else {\n    // Create a FileItem\n    return {\n      kind: 'file',\n      path, mode, uname, gname, uid, gid, date,\n      content: {\n        kind: 'generator',\n        length,\n        generator\n      }\n    };\n  }\n};\n\n/**\n * Create a FileItem from a local file path\n * @param path - The path to the file in the tar archive\n * @param filePath - The path to the file to read from real filesystem\n * @param reflectStat - Whether to reflect optional stat of the file (mode, uid, gid, mtime. Default: 'exceptName')\n * @param options - Metadata for the file including path in tar archive\n * @returns A FileItem\n */\nexport const createReadFileItem = async (\n  path: string,\n  filePath: string,\n  reflectStat?: ReflectStats,\n  options?: CreateItemOptions\n): Promise<FileItem> => {\n  const rs = reflectStat ?? 'exceptName';\n\n  // Get file stats to extract metadata\n  const stats = await stat(filePath);\n  // Create readable stream from file\n  const reader = createReadStream(filePath);\n\n  const mode = options?.mode ?? (rs !== 'none' ? stats.mode : undefined);\n  const uid = options?.uid ?? (rs !== 'none' ? stats.uid : undefined);\n  const gid = options?.gid ?? (rs !== 'none' ? stats.gid : undefined);\n  const date = options?.date ?? (rs !== 'none' ? stats.mtime : undefined);\n\n  const uname = getUName(options?.uname, stats.uid, rs);\n  const gname = getUName(options?.gname, stats.gid, rs);\n\n  // Create a FileItem\n  return await createReadableFileItem(path, reader, {\n    length: stats.size, mode, uname, gname, uid, gid, date,\n  });\n};\n\n/**\n * Store a readable stream to a file\n * @param reader - The readable stream\n * @param path - The path to the file to store the readable stream to\n * @returns A promise that resolves when the stream is finished\n */\nexport const storeReaderToFile = (reader: Readable, path: string) => {\n  const writer = createWriteStream(path);\n  reader.pipe(writer);\n  return new Promise<void>((res, rej) => {\n    writer.on('finish', res);\n    writer.on('error', rej);\n    reader.on('error', rej);\n  });\n};\n","// tar-vern - Tape archiver library for Typescript\n// Copyright (c) Kouji Matsui (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/tar-vern/\n\nimport { Readable } from \"stream\";\nimport { createGzip } from \"zlib\";\nimport { getBuffer } from \"./utils\";\nimport { CompressionTypes, EntryItem } from \"./types\";\n\n/**\n * Get the byte length of a string in UTF-8\n * @param str - The string to get the byte length of\n * @returns The byte length of the string\n */\nconst utf8ByteLength = (str: string) => {\n  return Buffer.byteLength(str, \"utf8\");\n}\n\n/**\n * Truncate a string to a maximum byte length in UTF-8\n * @param str - The string to truncate\n * @param maxBytes - The maximum byte length\n * @returns The truncated string\n */\nconst truncateUtf8Safe = (str: string, maxBytes: number) => {\n  let total = 0;\n  let i = 0;\n  while (i < str.length) {\n    const codePoint = str.codePointAt(i)!;\n    const char = String.fromCodePoint(codePoint);\n    const charBytes = Buffer.byteLength(char, \"utf8\");\n    if (total + charBytes > maxBytes) break;\n    total += charBytes;\n    i += char.length;\n  }\n  return str.slice(0, i);\n}\n\n// Tar specification: name max 100 bytes, prefix max 155 bytes\nconst MAX_NAME = 100;\nconst MAX_PREFIX = 155;\n\n/**\n * Split a path into a name and a prefix\n * @param path - The path to split\n * @returns The name and prefix\n */\nconst splitPath = (path: string) => {\n  if (utf8ByteLength(path) <= MAX_NAME) {\n    return { prefix: \"\", name: path };\n  }\n\n  // Split by '/' and find the part that fits in name from the end\n  const parts = path.split(\"/\");\n  let name = parts.pop() ?? \"\";\n  let prefix = parts.join(\"/\");\n\n  // Truncate if name exceeds 100 bytes\n  if (utf8ByteLength(name) > MAX_NAME) {\n    name = truncateUtf8Safe(name, MAX_NAME);\n  }\n\n  // Truncate if prefix exceeds 155 bytes\n  while (utf8ByteLength(prefix) > MAX_PREFIX) {\n    prefix = truncateUtf8Safe(prefix, MAX_PREFIX);\n  }\n\n  return { prefix, name };\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Get octal bytes from a number\n * @param value - The number to get octal bytes from\n * @param length - The length of the octal bytes\n * @returns The octal bytes\n */\nconst getOctalBytes = (value: number, length: number) => {\n  const str = value.toString(8).padStart(length - 1, \"0\") + \"\\0\";\n  return Buffer.from(str, \"ascii\");\n};\n\n/**\n * Get padded bytes from a buffer\n * @param buffer - The buffer to get padded bytes from\n * @returns The padded bytes\n */\nconst getPaddedBytes = (buffer: Buffer) => {\n  const extra = buffer.length % 512;\n  if (extra === 0) {\n    return buffer;\n  } else {\n    return Buffer.concat([buffer, Buffer.alloc(512 - extra, 0)]);\n  }\n}\n\n/**\n * The terminator bytes\n */\nconst terminatorBytes = Buffer.alloc(1024, 0);\n\n/**\n * Create a tar header\n * @param type - The type of the entry\n * @param path - The path of the entry\n * @param size - The size of the entry\n * @param mode - The mode of the entry\n * @param uname - The user name of the entry\n * @param gname - The group name of the entry\n */\nconst createTarHeader = (\n  type: 'file' | 'directory',\n  path: string,\n  size: number,\n  mode: number,\n  uname: string,\n  gname: string,\n  uid: number,\n  gid: number,\n  date: Date\n) => {\n  // Allocate header bytes\n  const buffer = Buffer.alloc(512, 0);\n\n  // Split path into name and prefix\n  const { name, prefix } = splitPath(path);\n\n  // Write name, mode, uid, gid, size, mtime, typeflag, prefix, checksum\n  buffer.write(name, 0, 100, \"utf8\");\n  getOctalBytes(mode & 0o7777, 8).copy(buffer, 100);\n  getOctalBytes(uid, 8).copy(buffer, 108);\n  getOctalBytes(gid, 8).copy(buffer, 116);\n  getOctalBytes(size, 12).copy(buffer, 124);\n  getOctalBytes(Math.floor(date.getTime() / 1000), 12).copy(buffer, 136);\n\n  // Check sum space\n  Buffer.from(\"        \", \"ascii\").copy(buffer, 148);\n\n  if (type === 'file') {\n    buffer.write(\"0\", 156, 1, \"ascii\");    // typeflag (file)\n  } else {\n    buffer.write(\"5\", 156, 1, \"ascii\");    // typeflag (directory)\n  }\n  buffer.write(\"ustar\\0\", 257, 6, \"ascii\");\n  buffer.write(\"00\", 263, 2, \"ascii\");     // version\n  buffer.write(uname, 265, 32, \"utf8\");\n  buffer.write(gname, 297, 32, \"utf8\");\n  buffer.write(prefix, 345, 155, \"utf8\");  // Path prefix\n\n  // Calculate check sum\n  let sum = 0;\n  for (let i = 0; i < 512; i++) {\n    sum += buffer[i];\n  }\n  getOctalBytes(sum, 8).copy(buffer, 148);\n\n  return buffer;\n}\n\n///////////////////////////////////////////////////////////////////////////////////\n\n/**\n * Create a tar packer\n * @param entryItemGenerator - The async generator of the entry items\n * @param compressionType - The compression type to use (Default: 'none')\n * @param signal - The abort signal to cancel the tar packer\n * @returns Readable stream of the tar packer\n */\nexport const createTarPacker = (\n  entryItemGenerator: AsyncGenerator<EntryItem, void, unknown>,\n  compressionType?: CompressionTypes,\n  signal?: AbortSignal) => {\n\n  // Create async generator function from entry item iterator\n  const entryItemIterator = async function*() {\n    // Iterate over the entry items\n    for await (const entryItem of entryItemGenerator) {\n      signal?.throwIfAborted();\n\n      switch (entryItem.kind) {\n        // Entry is a file\n        case 'file': {\n          const entryItemContent = entryItem.content;\n          // Content is a string or buffer\n          if (typeof entryItemContent === 'string' || Buffer.isBuffer(entryItemContent)) {\n            // Get content bytes from string or buffer\n            const contentBytes = getBuffer(entryItemContent);\n\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              contentBytes.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            // Content bytes to adjust padding space and produce\n            const totalPaddedContentBytes = getPaddedBytes(contentBytes);\n            yield totalPaddedContentBytes;\n          } else {\n            // Create and produce tar header bytes\n            const tarHeaderBytes = createTarHeader(\n              'file',\n              entryItem.path,\n              entryItemContent.length,\n              entryItem.mode,\n              entryItem.uname,\n              entryItem.gname,\n              entryItem.uid,\n              entryItem.gid,\n              entryItem.date);\n            yield tarHeaderBytes;\n\n            let position = 0;\n            switch (entryItemContent.kind) {\n              // Content is a generator\n              case 'generator': {\n                for await (const contentBytes of entryItemContent.generator) {\n                  signal?.throwIfAborted();\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n              // Content is a readable stream\n              case 'readable': {\n                for await (const content of entryItemContent.readable) {\n                  signal?.throwIfAborted();\n                  const contentBytes = getBuffer(content);\n                  yield contentBytes;\n                  position += contentBytes.length;\n                }\n                break;\n              }\n            }\n\n            // Padding space\n            if (position % 512 !== 0) {\n              signal?.throwIfAborted();\n              yield Buffer.alloc(512 - (position % 512), 0);\n            }\n          }\n          break;\n        }\n        // Entry is a directory\n        case 'directory': {\n          // Create and produce tar header bytes\n          const tarHeaderBytes = createTarHeader(\n            'directory',\n            entryItem.path,\n            0,\n            entryItem.mode,\n            entryItem.uname,\n            entryItem.gname,\n            entryItem.uid,\n            entryItem.gid,\n            entryItem.date\n          );\n          yield tarHeaderBytes;\n          break;\n        }\n      }\n    }\n\n    // Terminates for tar stream\n    yield terminatorBytes;\n  };\n\n  const ct = compressionType ?? 'none';\n\n  switch (ct) {\n    // No compression\n    case 'none': {\n      // Create readable stream from entry item iterator\n      return Readable.from(entryItemIterator());\n    }\n    // Gzip compression\n    case 'gzip': {\n      // Create gzip stream\n      const gzipStream = createGzip({ level: 9 });\n      // Create readable stream from entry item iterator\n      const entryItemStream = Readable.from(entryItemIterator());\n      // Pipe the entry item stream to the gzip stream\n      entryItemStream.pipe(gzipStream);\n      // Return the gzip stream\n      return gzipStream;\n    }\n  }\n};\n"],"names":[],"mappings":"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"}

package/dist/packer.d.ts

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT

package/dist/utils.d.ts

@@ -1,6 +1,6 @@
 /*!
  * name: tar-vern
- * version: 0.2.0
+ * version: 0.3.0
  * description: Tape archiver library for Typescript
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAa9I;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,MAAM,4BAE9C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,EACZ,cAAc,YAAY,EAC1B,UAAU,0BAA0B,KACnC,OAAO,CAAC,aAAa,CA2BvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,MAAM,GAAG,MAAM,EACxB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,QAAQ,CAelB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,UAAU,QAAQ,EAClB,UAAU,6BAA6B,KACtC,OAAO,CAAC,QAAQ,CA6ClB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,WAAW,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAChD,UAAU,6BAA6B,KACtC,OAAO,CAAC,QAAQ,CA6ClB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,cAAc,YAAY,EAC1B,UAAU,iBAAiB,KAC1B,OAAO,CAAC,QAAQ,CAoBlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,QAAQ,EAAE,MAAM,MAAM,kBAO/D,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAa9I;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,MAAM,4BAE9C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,EACZ,cAAc,YAAY,EAC1B,UAAU,0BAA0B,KACnC,OAAO,CAAC,aAAa,CA2BvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,MAAM,GAAG,MAAM,EACxB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,QAAQ,CAelB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,UAAU,QAAQ,EAClB,UAAU,6BAA6B,KACtC,OAAO,CAAC,QAAQ,CA6ClB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,WAAW,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAChD,UAAU,6BAA6B,KACtC,OAAO,CAAC,QAAQ,CA6ClB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,cAAc,YAAY,EAC1B,UAAU,iBAAiB,KAC1B,OAAO,CAAC,QAAQ,CAoBlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,QAAQ,EAAE,MAAM,MAAM,kBAQ/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tar-vern",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Tape archiver library for Typescript",
   "keywords": [
     "typescript",