@types/tar 6.1.3 → 6.1.5

tar/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for tar (https://github.com/npm/node-tar)
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar.
 
 ### Additional Details
- * Last updated: Mon, 26 Sep 2022 19:33:06 GMT
+ * Last updated: Tue, 09 May 2023 22:02:56 GMT
  * Dependencies: [@types/minipass](https://npmjs.com/package/@types/minipass), [@types/node](https://npmjs.com/package/@types/node)
  * Global values: none
 

tar/index.d.ts

@@ -7,7 +7,6 @@
 /// <reference types="node" />
 
 import stream = require('stream');
-import events = require('events');
 import zlib = require('zlib');
 import MiniPass = require('minipass');
 
@@ -213,18 +212,146 @@ export interface Parse extends ParseStream {
 }
 
 export const Parse: {
-    new(opt?: ParseOptions): Parse;
+    new (opt?: ParseOptions): Parse;
 };
 //#endregion
 
 //#region Global Methods
 
+export interface PackOptions {
+    /**
+     * A function that will get called with (code, message, data) for any
+     * warnings encountered. (See "Warnings and Errors")
+     */
+    onwarn?(code: string, message: string, data: Buffer): void;
+    /**
+     * Treat warnings as crash-worthy errors.
+     *
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * The current working directory for creating the archive.
+     *
+     * @default process.cwd()
+     */
+    cwd?: string[];
+    /**
+     * A path portion to prefix onto the entries in the archive.
+     */
+    prefix?: string;
+    /**
+     * Set to any truthy value to create a gzipped archive, or an object with
+     * settings for zlib.Gzip()
+     */
+    gzip?: boolean | zlib.ZlibOptions;
+    /**
+     * A function that gets called with (path, stat) for each entry being added.
+     * Return true to add the entry to the archive, or false to omit it.
+     */
+    filter?(path: string, stat: FileStat): boolean;
+    /**
+     * Omit metadata that is system-specific: ctime, atime, uid, gid, uname,
+     * gname, dev, ino, and nlink. Note that mtime is still included, because
+     * this is necessary for other time-based operations. Additionally, mode is
+     * set to a "reasonable default" for most unix systems, based on a umask
+     * value of 0o22.
+     */
+    portable?: boolean;
+    /**
+     * Allow absolute paths. By default, / is stripped from absolute paths.
+     */
+    preservePaths?: boolean;
+    /**
+     * A Map object containing the device and inode value for any file whose
+     * nlink is > 1, to identify hard links.
+     */
+    linkCache?: Map<string, string>;
+    /**
+     * A Map object that caches calls lstat.
+     */
+    statCache?: Map<string, string>;
+    /**
+     * A Map object that caches calls to readdir.
+     */
+    readdirCache?: Map<string, string>;
+    /**
+     * A number specifying how many concurrent jobs to run.
+     *
+     * @default 4
+     */
+    jobs?: number;
+    /**
+     * The maximum buffer size for fs.read() operations.
+     *
+     * @default 16 MB
+     */
+    maxReadSize?: number;
+    /**
+     * Do not recursively archive the contents of directories.
+     */
+    noDirRecurse?: boolean;
+    /**
+     * Set to true to pack the targets of symbolic links. Without this option,
+     * symbolic links are archived as such.
+     */
+    follow?: boolean;
+    /**
+     * Suppress pax extended headers. Note that this means that long paths and
+     * linkpaths will be truncated, and large or negative numeric values may be
+     * interpreted incorrectly.
+     */
+    noPax?: boolean;
+    /**
+     * Set to true to omit writing mtime values for entries. Note that this
+     * prevents using other mtime-based features like tar.update or the
+     * keepNewer option with the resulting tar archive.
+     */
+    noMtime?: boolean;
+    /**
+     * Set to a Date object to force a specific mtime for everything added to
+     * the archive. Overridden by noMtime.
+     */
+    mtime?: number;
+}
+
 /**
  * Returns a through stream. Use fstream to write files into the pack stream and you will receive tar archive data from the pack stream.
  * This only works with directories, it does not work with individual files.
  * The optional properties object are used to set properties in the tar 'Global Extended Header'.
  */
-export function Pack(props?: HeaderProperties): PackStream;
+export class Pack extends MiniPass {
+    linkCache: PackOptions['linkCache'];
+    readdirCache: PackOptions['readdirCache'];
+    statCache: PackOptions['statCache'];
+
+    static Sync: typeof PackSync;
+
+    constructor(opt?: PackOptions);
+
+    add(path: string): this;
+}
+
+declare class PackSync extends Pack {
+    constructor(opt: PackOptions);
+
+    // pause/resume are no-ops in sync streams.
+    pause(): void;
+    resume(): void;
+}
+
+declare class PackJob {
+    path: string;
+    absolute: string;
+    entry: unknown | null;
+    stat: unknown | null;
+    readdir: unknown | null;
+    pending: boolean;
+    ignore: boolean;
+    piped: boolean;
+
+    constructor(path?: string, absolute?: string);
+}
 
 /**
  * Returns a through stream. Write tar data to the stream and the files in the tarball will be extracted onto the filesystem.
@@ -269,10 +396,10 @@ export interface ReadEntry extends MiniPass, HeaderProperties {
 
 export interface CreateOptions {
     /**
-     * A function that will get called with (message, data)
-     * for any warnings encountered.
+     * A function that will get called with (code, message, data) for any
+     * warnings encountered. (See "Warnings and Errors")
      */
-    onwarn?(message: string, data: Buffer): void;
+    onwarn?(code: string, message: string, data: Buffer): void;
 
     /**
      * Treat warnings as crash-worthy errors. Default false.
@@ -364,10 +491,10 @@ export interface CreateOptions {
 
 export interface ExtractOptions {
     /**
-     * A function that will get called with (message, data)
-     * for any warnings encountered.
+     * A function that will get called with (code, message, data) for any
+     * warnings encountered. (See "Warnings and Errors")
      */
-    onwarn?(message: string, data: Buffer): void;
+    onwarn?(code: string, message: string, data: Buffer): void;
 
     /**
      * Treat warnings as crash-worthy errors. Default false.
@@ -582,10 +709,10 @@ export interface ReplaceOptions {
     sync?: boolean | undefined;
 
     /**
-     * A function that will get called with (message, data)
-     * for any warnings encountered.
+     * A function that will get called with (code, message, data) for any
+     * warnings encountered. (See "Warnings and Errors")
      */
-    onwarn?(message: string, data: Buffer): void;
+    onwarn?(code: string, message: string, data: Buffer): void;
 
     /**
      * Treat warnings as crash-worthy errors. Default false.
@@ -812,3 +939,5 @@ export function update(
  * Alias for update
  */
 export const u: typeof update;
+
+export {};

tar/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/tar",
-    "version": "6.1.3",
+    "version": "6.1.5",
     "description": "TypeScript definitions for tar",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar",
     "license": "MIT",
@@ -26,8 +26,8 @@
     "scripts": {},
     "dependencies": {
         "@types/node": "*",
-        "minipass": "^3.3.5"
+        "minipass": "^4.0.0"
     },
-    "typesPublisherContentHash": "73d2759e05ef82c75abf82485bcfc9688944e454f3ab49a061586d8a42e1fec8",
-    "typeScriptVersion": "4.1"
+    "typesPublisherContentHash": "e0e9c306b0a501a7d753543d5a95ddc55bef6a6be7f2423a03ba6f5de5adaf26",
+    "typeScriptVersion": "4.3"
 }