@types/tar 4.0.1 → 4.0.5

tar/LICENSE

@@ -1,21 +1,21 @@
-    MIT License
-
-    Copyright (c) Microsoft Corporation. All rights reserved.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

tar/README.md

@@ -2,15 +2,15 @@
 > `npm install --save @types/tar`
 
 # Summary
-This package contains type definitions for tar ( https://github.com/npm/node-tar ).
+This package contains type definitions for tar (https://github.com/npm/node-tar).
 
 # Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar.
 
-Additional Details
- * Last updated: Mon, 17 Jun 2019 07:12:22 GMT
- * Dependencies: @types/node
+### Additional Details
+ * Last updated: Fri, 02 Jul 2021 21:32:11 GMT
+ * Dependencies: [@types/minipass](https://npmjs.com/package/@types/minipass), [@types/node](https://npmjs.com/package/@types/node)
  * Global values: none
 
 # Credits
-These definitions were written by Maxime LUCE <https://github.com/SomaticIT>, Connor Peet <https://github.com/connor4312>.
+These definitions were written by [Maxime LUCE](https://github.com/SomaticIT), and [Connor Peet](https://github.com/connor4312).

tar/index.d.ts

@@ -6,31 +6,33 @@
 
 /// <reference types="node" />
 
-import stream = require("stream");
-import events = require("events");
-import zlib = require("zlib");
+import stream = require('stream');
+import events = require('events');
+import zlib = require('zlib');
+import MiniPass = require('minipass');
 
 // #region Interfaces
 
 export interface HeaderProperties {
-    path?: string;
-    mode?: number;
-    noProprietary?: boolean;
-    uid?: number;
-    gid?: number;
-    size?: number;
-    mtime?: number;
-    uname?: string;
-    gname?: string;
-    devmaj?: number;
-    devmin?: number;
+    path: string;
+    mode?: number | undefined;
+    noProprietary?: boolean | undefined;
+    uid?: number | undefined;
+    gid?: number | undefined;
+    size?: number | undefined;
+    mtime?: number | undefined;
+    type?: string | undefined;
+    uname?: string | undefined;
+    gname?: string | undefined;
+    devmaj?: number | undefined;
+    devmin?: number | undefined;
 }
 
 export interface ExtractOptions {
-    type?: string;
-    Directory?: boolean;
-    path?: string;
-    strip?: number;
+    type?: string | undefined;
+    Directory?: boolean | undefined;
+    path?: string | undefined;
+    strip?: number | undefined;
 }
 
 export interface ParseStream extends NodeJS.ReadWriteStream {
@@ -234,6 +236,24 @@ export interface FileStat extends stream.Readable, Fields {
     size: number;
 }
 
+export interface ReadEntry extends MiniPass, HeaderProperties {
+    /** The extended metadata object provided to the constructor. */
+    extended: any;
+    /** The global extended metadata object provided to the constructor. */
+    globalExtended: any;
+    /** The number of bytes remaining to be written into the stream. */
+    remain: number;
+    /** The number of 512-byte blocks remaining to be written into the stream. */
+    blockRemain: number;
+    /** Whether this entry should be ignored. */
+    ignore: boolean;
+    /**
+     * True if this represents metadata about the next entry, false if it
+     * represents a filesystem object.
+     */
+    meta: boolean;
+}
+
 export interface CreateOptions {
     /**
      * A function that will get called with (message, data)
@@ -244,28 +264,28 @@ export interface CreateOptions {
     /**
      * Treat warnings as crash-worthy errors. Default false.
      */
-    strict?: boolean;
+    strict?: boolean | undefined;
 
     /**
      * The current working directory for creating the archive. Defaults to process.cwd().
      */
-    cwd?: string;
+    cwd?: string | undefined;
 
     /**
      * Alias for cwd.
      */
-    C?: string;
+    C?: string | undefined;
 
     /**
      * Set to any truthy value to create a gzipped archive,
      * or an object with settings for zlib.Gzip()
      */
-    gzip?: boolean | zlib.ZlibOptions;
+    gzip?: boolean | zlib.ZlibOptions | undefined;
 
     /**
      * Alias for gzip.
      */
-    z?: boolean | zlib.ZlibOptions;
+    z?: boolean | zlib.ZlibOptions | undefined;
 
     /**
      * A function that gets called with (path, stat) for each entry being
@@ -278,55 +298,55 @@ export interface CreateOptions {
      * gname, dev, ino, and nlink. Note that mtime is still included,
      * because this is necessary other time-based operations.
      */
-    portable?: boolean;
+    portable?: boolean | undefined;
 
     /**
      * Allow absolute paths. By default, / is stripped from absolute paths.
      */
-    preservePaths?: boolean;
+    preservePaths?: boolean | undefined;
 
     /**
      * Alias for presevePaths.
      */
-    P?: boolean;
+    P?: boolean | undefined;
 
     /**
      * The mode to set on the created file archive.
      */
-    mode?: number;
+    mode?: number | undefined;
 
     /**
      * Do not recursively archive the contents of directories.
      */
-    noDirRecurse?: boolean;
+    noDirRecurse?: boolean | undefined;
 
     /**
      * Set to true to pack the targets of symbolic links. Without this
      * option, symbolic links are archived as such.
      */
-    follow?: boolean;
+    follow?: boolean | undefined;
 
     /**
      * Alias for follow.
      */
-    L?: boolean;
+    L?: boolean | undefined;
 
     /**
      * Alias for follow.
      */
-    h?: boolean;
+    h?: boolean | undefined;
 
     /**
      * 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;
+    noPax?: boolean | undefined;
 
     /**
      * A path portion to prefix onto the entries in the archive.
      */
-    prefix?: string;
+    prefix?: string | undefined;
 }
 
 export interface ExtractOptions {
@@ -339,18 +359,18 @@ export interface ExtractOptions {
     /**
      * Treat warnings as crash-worthy errors. Default false.
      */
-    strict?: boolean;
+    strict?: boolean | undefined;
 
     /**
      * Extract files relative to the specified directory. Defaults to
      * process.cwd(). If provided, this must exist and must be a directory.
      */
-    cwd?: string;
+    cwd?: string | undefined;
 
     /**
      * Alias for cwd.
      */
-    C?: string;
+    C?: string | undefined;
 
     /**
      * A function that gets called with (path, stat) for each entry being
@@ -362,33 +382,33 @@ export interface ExtractOptions {
      * Set to true to keep the existing file on disk if it's newer than
      * the file in the archive.
      */
-    newer?: boolean;
+    newer?: boolean | undefined;
 
     /**
      * Alias for newer.
      */
-    'keep-newer'?: boolean;
+    'keep-newer'?: boolean | undefined;
 
     /**
      * Alias for newer.
      */
-    'keep-newer-files'?: boolean;
+    'keep-newer-files'?: boolean | undefined;
 
     /**
      * Do not overwrite existing files. In particular, if a file appears more
      * than once in an archive, later copies will not overwrite earlier copies
      */
-    keep?: boolean;
+    keep?: boolean | undefined;
 
     /**
      * Alias for keep.
      */
-    k?: boolean;
+    k?: boolean | undefined;
 
     /**
      * Alias for keep.
      */
-    'keep-existing'?: boolean;
+    'keep-existing'?: boolean | undefined;
 
     /**
      * Unlink files before creating them. Without this option, tar overwrites
@@ -396,24 +416,24 @@ export interface ExtractOptions {
      * existing hardlinks will be broken, as will any symlink that would
      * affect the location of an extracted file.
      */
-    unlink?: boolean;
+    unlink?: boolean | undefined;
 
     /**
      * Remove the specified number of leading path elements. Pathnames with
      * fewer elements will be silently skipped. Note that the pathname
      * is edited after applying the filter, but before security checks.
      */
-    strip?: number;
+    strip?: number | undefined;
 
     /**
      * Alias for strip.
      */
-    'strip-components'?: number;
+    'strip-components'?: number | undefined;
 
     /**
      * Alias for strip.
      */
-    stripComponents?: number;
+    stripComponents?: number | undefined;
 
     /**
      * If true, tar will set the uid and gid of extracted entries to the uid
@@ -424,12 +444,12 @@ export interface ExtractOptions {
      * never unpacked in this implementation, and modes
      * are set by default already.
      */
-    preserveOwner?: boolean;
+    preserveOwner?: boolean | undefined;
 
     /**
      * Alias for preserveOwner.
      */
-    p?: boolean;
+    p?: boolean | undefined;
 
     /**
      * Set to a number to force ownership of all extracted files and folders,
@@ -437,7 +457,7 @@ export interface ExtractOptions {
      * user id, regardless of the uid field in the archive. Cannot be used
      * along with preserveOwner. Requires also setting a gid option.
      */
-    uid?: number;
+    uid?: number | undefined;
 
     /**
      * Set to a number to force ownership of all extracted files and folders,
@@ -445,25 +465,61 @@ export interface ExtractOptions {
      * group id, regardless of the gid field in the archive. Cannot be used
      * along with preserveOwner. Requires also setting a uid option
      */
-    gui?: number;
+    gid?: number | undefined;
+
+    /**
+     * Set to true to omit writing mtime value for extracted entries.
+     * [Alias: m, no-mtime]
+     */
+    noMtime?: boolean | undefined;
+    m?: boolean | undefined;
+    'no-mtime'?: boolean | undefined;
+
+    /**
+     * Provide a function that takes an entry object, and returns a stream,
+     * or any falsey value. If a stream is provided, then that stream's data
+     * will be written instead of the contents of the archive entry. If a
+     * falsey value is provided, then the entry is written to disk as normal.
+     * (To exclude items from extraction, use the filter option described above.)
+     */
+    transform?(entry: ReadEntry): NodeJS.WritableStream | undefined | false | null;
+
+    /**
+     * A function that gets called with (entry) for each entry that passes the
+     * filter.
+     */
+    onentry?(entry: ReadEntry): void;
+
+    // The following options are mostly internal, but can be modified in some
+    // advanced use cases, such as re-using caches between runs.
+
+    /**
+     * The maximum buffer size for fs.read() operations (in bytes). Defaults to 16 MB.
+     */
+    maxReadSize?: number | undefined;
+
+    /**
+     * The maximum size of meta entries that is supported. Defaults to 1 MB.
+     */
+    maxMetaEntrySize?: number | undefined;
 }
 
 export interface ListOptions {
     /**
      * Treat warnings as crash-worthy errors. Default false.
      */
-    strict?: boolean;
+    strict?: boolean | undefined;
 
     /**
      * Extract files relative to the specified directory. Defaults to
      * process.cwd(). If provided, this must exist and must be a directory.
      */
-    cwd?: string;
+    cwd?: string | undefined;
 
     /**
      * Alias for cwd.
      */
-    C?: string;
+    C?: string | undefined;
 
     /**
      * A function that gets called with (path, stat) for each entry being
@@ -481,7 +537,7 @@ export interface ListOptions {
     /**
      * The maximum buffer size for fs.read() operations. Defaults to 16 MB.
      */
-    maxReadSize?: number;
+    maxReadSize?: number | undefined;
 
     /**
      * By default, entry streams are resumed immediately after the call to
@@ -489,7 +545,7 @@ export interface ListOptions {
      * opting into this, the stream will never complete until the entry
      * data is consumed.
      */
-    noResume?: boolean;
+    noResume?: boolean | undefined;
 }
 
 export interface ReplaceOptions {
@@ -502,7 +558,7 @@ export interface ReplaceOptions {
      * Act synchronously. If this is set, then any provided file will be
      * fully written after the call to tar.c.
      */
-    sync?: boolean;
+    sync?: boolean | undefined;
 
     /**
      * A function that will get called with (message, data)
@@ -513,29 +569,29 @@ export interface ReplaceOptions {
     /**
      * Treat warnings as crash-worthy errors. Default false.
      */
-    strict?: boolean;
+    strict?: boolean | undefined;
 
     /**
      * Extract files relative to the specified directory. Defaults to
      * process.cwd(). If provided, this must exist and must be a directory.
      */
-    cwd?: string;
+    cwd?: string | undefined;
 
     /**
      * Alias for cwd.
      */
-    C?: string;
+    C?: string | undefined;
 
     /**
      * A path portion to prefix onto the entries in the archive.
      */
-    prefix?: string;
+    prefix?: string | undefined;
 
     /**
      * Set to any truthy value to create a gzipped archive,
      * or an object with settings for zlib.Gzip()
      */
-    gzip?: boolean | zlib.ZlibOptions;
+    gzip?: boolean | zlib.ZlibOptions | undefined;
 
     /**
      * A function that gets called with (path, stat) for each entry being
@@ -546,52 +602,52 @@ export interface ReplaceOptions {
     /**
      * Allow absolute paths. By default, / is stripped from absolute paths.
      */
-    preservePaths?: boolean;
+    preservePaths?: boolean | undefined;
 
     /**
      * The maximum buffer size for fs.read() operations. Defaults to 16 MB.
      */
-    maxReadSize?: number;
+    maxReadSize?: number | undefined;
 
     /**
      * Do not recursively archive the contents of directories.
      */
-    noDirRecurse?: boolean;
+    noDirRecurse?: boolean | undefined;
 
     /**
      * Set to true to pack the targets of symbolic links. Without this
      * option, symbolic links are archived as such.
      */
-    follow?: boolean;
+    follow?: boolean | undefined;
 
     /**
      * Alias for follow.
      */
-    L?: boolean;
+    L?: boolean | undefined;
 
     /**
      * Alias for follow.
      */
-    h?: boolean;
+    h?: boolean | undefined;
 
     /**
      * uppress 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;
+    noPax?: boolean | undefined;
 }
 
 export interface FileOptions {
     /**
      * Uses the given file as the input or output of this function.
      */
-    file?: string;
+    file?: string | undefined;
 
     /**
      * Alias for file.
      */
-    f?: string;
+    f?: string | undefined;
 }
 
 /**
@@ -660,7 +716,7 @@ export const x: typeof extract;
  *
  * Archive data should be written to the returned stream.
  */
-export function list(options?: ListOptions, fileList?: ReadonlyArray<string>, callback?: (err?: Error) => void): stream.Writable;
+export function list(options?: ListOptions  & FileOptions, fileList?: ReadonlyArray<string>, callback?: (err?: Error) => void): stream.Writable;
 
 /**
  * List the contents of a tarball archive. The fileList is an array of paths

tar/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@types/tar",
-    "version": "4.0.1",
+    "version": "4.0.5",
     "description": "TypeScript definitions for tar",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar",
     "license": "MIT",
     "contributors": [
         {
@@ -16,7 +17,7 @@
         }
     ],
     "main": "",
-    "types": "index",
+    "types": "index.d.ts",
     "repository": {
         "type": "git",
         "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
@@ -24,8 +25,9 @@
     },
     "scripts": {},
     "dependencies": {
+        "@types/minipass": "*",
         "@types/node": "*"
     },
-    "typesPublisherContentHash": "fa48ef973d769fac749d202a47e36b1aafff9afd1b0a601f484b105713bd5b2e",
-    "typeScriptVersion": "2.0"
+    "typesPublisherContentHash": "a6efdc2394562ab1a73de84074e183b53ab21d470ff13ecf93b28ba3993bd3d7",
+    "typeScriptVersion": "3.6"
 }