@types/tar 4.0.5 → 6.1.2

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: Fri, 02 Jul 2021 21:32:11 GMT
+ * Last updated: Mon, 01 Aug 2022 22:02:17 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

@@ -1,4 +1,4 @@
-// Type definitions for tar 4.0
+// Type definitions for tar 6.1
 // Project: https://github.com/npm/node-tar
 // Definitions by: Maxime LUCE <https://github.com/SomaticIT>, Connor Peet <https://github.com/connor4312>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
@@ -102,8 +102,8 @@ export const fieldEnds: number[];
  */
 export const types: {
     0: string;
-    "\0": string;
-    "": string;
+    '\0': string;
+    '': string;
     1: string;
     2: string;
     3: string;
@@ -198,14 +198,27 @@ export const knownExtended: {
 export const headerSize: number;
 export const blockSize: number;
 
+export interface ParseOptions {
+    strict?: boolean;
+    filter?: (path: string, entry: ReadEntry) => boolean;
+    onentry?: (entry: ReadEntry) => void;
+    onwarn?: (code: string, message: string, data: Buffer) => void;
+}
+/**
+ * A writable stream. Write tar data to it and it will emit entry events for each entry parsed from the tarball. This is used by tar.Extract.
+ */
+export interface Parse extends ParseStream {
+    on(event: 'end' | 'close', listener: () => void): this;
+    on(event: 'entry', listener: (entry: ReadEntry) => void): this;
+}
+
+export const Parse: {
+    new(opt?: ParseOptions): Parse;
+};
 //#endregion
 
 //#region Global Methods
 
-/**
- * Returns a writable stream. Write tar data to it and it will emit entry events for each entry parsed from the tarball. This is used by tar.Extract.
- */
-export function Parse(): ParseStream;
 /**
  * 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.
@@ -490,6 +503,14 @@ export interface ExtractOptions {
      */
     onentry?(entry: ReadEntry): void;
 
+    /**
+     * Set to true to omit calling `fs.chmod()` to ensure that the extracted file
+     * matches the entry mode. This also suppresses the call to `process.umask()`
+     * to determine the default umask value, since tar will extract with whatever
+     * mode is provided, and let the process `umask` apply normally.
+     */
+    noChmod?: boolean | undefined;
+
     // The following options are mostly internal, but can be modified in some
     // advanced use cases, such as re-using caches between runs.
 
@@ -658,7 +679,11 @@ export interface FileOptions {
  *
  * Archive data may be read from the returned stream.
  */
-export function create(options: CreateOptions, fileList: ReadonlyArray<string>, callback?: (err?: Error) => void): stream.Readable;
+export function create(
+    options: CreateOptions,
+    fileList: ReadonlyArray<string>,
+    callback?: (err?: Error) => void,
+): stream.Readable;
 
 /**
  * Create a tarball archive. The fileList is an array of paths to add to the
@@ -668,7 +693,11 @@ export function create(options: CreateOptions, fileList: ReadonlyArray<string>,
  */
 export function create(options: CreateOptions & FileOptions, fileList: ReadonlyArray<string>): Promise<void>;
 export function create(options: CreateOptions & FileOptions & { sync: true }, fileList: ReadonlyArray<string>): void;
-export function create(options: CreateOptions & FileOptions, fileList: ReadonlyArray<string>, callback: (err?: Error) => void): void;
+export function create(
+    options: CreateOptions & FileOptions,
+    fileList: ReadonlyArray<string>,
+    callback: (err?: Error) => void,
+): void;
 
 /**
  * Alias for create
@@ -687,7 +716,11 @@ export const c: typeof create;
  *
  * Archive data should be written to the returned stream.
  */
-export function extract(options: ExtractOptions, fileList?: ReadonlyArray<string>, callback?: (err?: Error) => void): stream.Writable;
+export function extract(
+    options: ExtractOptions,
+    fileList?: ReadonlyArray<string>,
+    callback?: (err?: Error) => void,
+): stream.Writable;
 
 /**
  * Extract a tarball archive. The fileList is an array of paths to extract
@@ -701,7 +734,11 @@ export function extract(options: ExtractOptions, fileList?: ReadonlyArray<string
  */
 export function extract(options: ExtractOptions & FileOptions, fileList?: ReadonlyArray<string>): Promise<void>;
 export function extract(options: ExtractOptions & FileOptions & { sync: true }, fileList?: ReadonlyArray<string>): void;
-export function extract(options: ExtractOptions & FileOptions, fileList: ReadonlyArray<string> | undefined, callback: (err?: Error) => void): void;
+export function extract(
+    options: ExtractOptions & FileOptions,
+    fileList: ReadonlyArray<string> | undefined,
+    callback: (err?: Error) => void,
+): void;
 
 /**
  * Alias for extract
@@ -716,7 +753,11 @@ export const x: typeof extract;
  *
  * Archive data should be written to the returned stream.
  */
-export function list(options?: ListOptions  & FileOptions, 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
@@ -741,7 +782,11 @@ export const t: typeof list;
  * starts with @, prepend it with ./.
  */
 export function replace(options: ReplaceOptions, fileList?: ReadonlyArray<string>): Promise<void>;
-export function replace(options: ReplaceOptions, fileList: ReadonlyArray<string> | undefined, callback: (err?: Error) => void): Promise<void>;
+export function replace(
+    options: ReplaceOptions,
+    fileList: ReadonlyArray<string> | undefined,
+    callback: (err?: Error) => void,
+): Promise<void>;
 
 /**
  * Alias for replace
@@ -756,7 +801,11 @@ export const r: typeof replace;
  * To add a file that starts with @, prepend it with ./.
  */
 export function update(options: ReplaceOptions, fileList?: ReadonlyArray<string>): Promise<void>;
-export function update(options: ReplaceOptions, fileList: ReadonlyArray<string> | undefined, callback: (err?: Error) => void): Promise<void>;
+export function update(
+    options: ReplaceOptions,
+    fileList: ReadonlyArray<string> | undefined,
+    callback: (err?: Error) => void,
+): Promise<void>;
 
 /**
  * Alias for update

tar/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/tar",
-    "version": "4.0.5",
+    "version": "6.1.2",
     "description": "TypeScript definitions for tar",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar",
     "license": "MIT",
@@ -25,9 +25,9 @@
     },
     "scripts": {},
     "dependencies": {
-        "@types/minipass": "*",
-        "@types/node": "*"
+        "@types/node": "*",
+        "minipass": "^3.3.5"
     },
-    "typesPublisherContentHash": "a6efdc2394562ab1a73de84074e183b53ab21d470ff13ecf93b28ba3993bd3d7",
-    "typeScriptVersion": "3.6"
+    "typesPublisherContentHash": "1ed2a9537078e1f4506663bfa209058cfdcad5f1d6770ed205517e663ec67a8b",
+    "typeScriptVersion": "4.0"
 }