.eslintrc

@@ -0,0 +1,30 @@
+{
+  "extends": "eslint:recommended",
+  "parserOptions": {
+    "ecmaVersion": 2020
+  },
+  "env": {
+    "node": true,
+    "es6": true
+  },
+  "rules": {
+    "no-var": "error",
+    "prefer-const": "error",
+    "curly": "error",
+    "eqeqeq": "error",
+    "prefer-arrow-callback": "error",
+    "no-new-object": "error",
+    "object-shorthand": "error",
+    "no-array-constructor": "error",
+    "array-callback-return": "error",
+    "no-eval": "error",
+    "no-new-func": "error",
+    "prefer-rest-params": "error",
+    "prefer-spread": "error",
+    "no-useless-constructor": "error",
+    "no-dupe-class-members": "error",
+    "no-duplicate-imports": "error",
+    "no-unneeded-ternary": "error",
+    "no-console": "error"
+  }
+}

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: antelle
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/ci-checks.yaml

@@ -0,0 +1,27 @@
+name: CI Checks
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: NPM install
+        run: npm ci
+      - name: Lint
+        run: npm run lint
+      - name: Check types
+        run: npm run check-types
+      - name: Run tests
+        run: npm test
+      - name: Setup Node.js 10
+        uses: actions/setup-node@v2
+        with:
+          node-version: '10'
+      - name: Run tests on Node.js 10
+        run: npm test

.prettierrc

@@ -0,0 +1,5 @@
+{
+    "tabWidth": 4,
+    "printWidth": 100,
+    "singleQuote": true
+}

MIT-LICENSE.txt → LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2015 Antelle https://github.com/antelle
+Copyright (c) 2021 Antelle https://github.com/antelle
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

README.md

@@ -1,4 +1,4 @@
-# node-stream-zip [![Build status](https://travis-ci.org/antelle/node-stream-zip.svg?branch=master)](https://travis-ci.org/antelle/node-stream-zip)
+# node-stream-zip ![CI Checks](https://github.com/antelle/node-stream-zip/workflows/CI%20Checks/badge.svg)
 
 node.js library for reading and extraction of ZIP archives.  
 Features:
@@ -9,22 +9,103 @@ Features:
 - fast initialization
 - no dependencies, no binary addons
 - decompression with built-in zlib module
-- deflate, deflate64, sfx, macosx/windows built-in archives
+- deflate, sfx, macosx/windows built-in archives
 - ZIP64 support
 
-# Installation
+## Installation
 
-`$ npm install node-stream-zip`
+```sh
+npm i node-stream-zip
+```
+
+## Usage
+
+There are two APIs provided:
+1. [promise-based / async](#async-api) 
+2. [callbacks](#callback-api)
+
+It's recommended to use the new, promise API, however the legacy callback API 
+may be more flexible for certain operations.
 
-# Usage
+### Async API
 
 Open a zip file
 ```javascript
 const StreamZip = require('node-stream-zip');
-const zip = new StreamZip({
-    file: 'archive.zip',
-    storeEntries: true
+const zip = new StreamZip.async({ file: 'archive.zip' });
+```
+
+Stream one entry to stdout
+```javascript
+const stm = await zip.stream('path/inside/zip.txt');
+stm.pipe(process.stdout);
+stm.on('end', () => zip.close());
+```
+
+Read a file as buffer
+```javascript
+const data = await zip.entryData('path/inside/zip.txt');
+await zip.close();
+```
+
+Extract one file to disk
+```javascript
+await zip.extract('path/inside/zip.txt', './extracted.txt');
+await zip.close();
+```
+
+List entries
+```javascript
+const entriesCount = await zip.entriesCount;
+console.log(`Entries read: ${entriesCount}`);
+
+const entries = await zip.entries();
+for (const entry of Object.values(entries)) {
+    const desc = entry.isDirectory ? 'directory' : `${entry.size} bytes`;
+    console.log(`Entry ${entry.name}: ${desc}`);
+}
+
+// Do not forget to close the file once you're done
+await zip.close();
+```
+
+Extract a folder from archive to disk
+```javascript
+fs.mkdirSync('extracted');
+await zip.extract('path/inside/zip/', './extracted');
+await zip.close();
+```
+
+Extract everything
+```javascript
+fs.mkdirSync('extracted');
+const count = await zip.extract(null, './extracted');
+console.log(`Extracted ${count} entries`);
+await zip.close();
+```
+
+When extracting a folder, you can listen to `extract` event
+```javascript
+zip.on('extract', (entry, file) => {
+    console.log(`Extracted ${entry.name} to ${file}`);
+});
+```
+
+`entry` event is generated for every entry during loading
+```javascript
+zip.on('entry', entry => {
+    // you can already stream this entry,
+    // without waiting until all entry descriptions are read (suitable for very large archives)
+    console.log(`Read entry ${entry.name}`);
 });
+```
+
+### Callback API
+
+Open a zip file
+```javascript
+const StreamZip = require('node-stream-zip');
+const zip = new StreamZip({ file: 'archive.zip' });
 
 // Handle errors
 zip.on('error', err => { /*...*/ });
@@ -39,7 +120,7 @@ zip.on('ready', () => {
         console.log(`Entry ${entry.name}: ${desc}`);
     }
     // Do not forget to close the file once you're done
-    zip.close()
+    zip.close();
 });
 ```
 
@@ -109,30 +190,32 @@ zip.on('entry', entry => {
 });
 ```
 
-# Options
+## Options
 
 You can pass these options to the constructor
 - `storeEntries: true` - you will be able to work with entries inside zip archive, otherwise the only way to access them is `entry` event
 - `skipEntryNameValidation: true` - by default, entry name is checked for malicious characters, like `../` or `c:\123`, pass this flag to disable validation errors
 
-# Methods
+## Methods
 
 - `zip.entries()` - get all entries description
 - `zip.entry(name)` - get entry description by name
 - `zip.stream(entry, function(err, stm) { })` - get entry data reader stream
 - `zip.entryDataSync(entry)` - get entry data in sync way
 - `zip.close()` - cleanup after all entries have been read, streamed, extracted, and you don't need the archive
 
-# Building
+## Building
 
 The project doesn't require building. To run unit tests with [nodeunit](https://github.com/caolan/nodeunit):  
-`$ npm test`
+```sh
+npm test
+```
 
-# Known issues
+## Known issues
 
 - [utf8](https://github.com/rubyzip/rubyzip/wiki/Files-with-non-ascii-filenames) file names
 - AES encrypted files
 
-# Contributors
+## Contributors
 
 ZIP parsing code has been partially forked from [cthackers/adm-zip](https://github.com/cthackers/adm-zip) (MIT license).

example-async.js

@@ -0,0 +1,35 @@
+/* eslint-disable no-console,no-unused-vars */
+const StreamZip = require('./');
+
+(async () => {
+    console.log('Loading zip...');
+
+    const zip = new StreamZip.async({ file: './test/ok/normal.zip' });
+    const entriesCount = await zip.entriesCount;
+
+    console.log(`Done in ${process.uptime()}s. Entries read: ${entriesCount}`);
+
+    const entry = await zip.entry('README.md');
+    console.log('Entry for README.md:', entry);
+
+    const data = await zip.entryData('README.md');
+    const firstLine = data.toString().split('\n')[0].trim();
+    console.log(`First line of README.md: "${firstLine}"`);
+
+    async function streamDataToStdOut() {
+        const stm = await zip.stream('README.md');
+        console.log('README.md contents streamed:\n');
+        stm.pipe(process.stdout);
+    }
+
+    async function extractEntry() {
+        await zip.extract('README.md', './tmp');
+    }
+
+    async function extractAll() {
+        const extracted = await zip.extract(null, './tmp');
+        console.log(`Extracted ${extracted} entries`);
+    }
+
+    await zip.close();
+})().catch(console.error);

example-callbacks.js

@@ -0,0 +1,47 @@
+/* eslint-disable no-console,no-unused-vars */
+const StreamZip = require('./');
+
+const zip = new StreamZip({ file: './test/ok/normal.zip' });
+zip.on('error', (err) => {
+    console.error('ERROR: ' + err);
+});
+zip.on('ready', () => {
+    const entriesCount = zip.entriesCount;
+    console.log(`Done in ${process.uptime()}s. Entries read: ${entriesCount}`);
+
+    const entry = zip.entry('README.md');
+    console.log('Entry for README.md:', entry);
+
+    const data = zip.entryDataSync('README.md');
+    const firstLine = data.toString().split('\n')[0].trim();
+    console.log(`First line of README.md: "${firstLine}"`);
+
+    zip.close();
+
+    function streamDataToStdOut() {
+        zip.stream('README.md', (err, stm) => {
+            if (err) {
+                return console.error(err);
+            }
+            console.log('README.md contents streamed:\n');
+            stm.pipe(process.stdout);
+        });
+    }
+
+    function extractEntry() {
+        zip.extract('README.md', './tmp', (err) => {
+            console.log(err ? err : 'Entry extracted');
+            zip.close();
+        });
+    }
+
+    function extractAll() {
+        zip.extract(null, './tmp', (err, count) => {
+            console.log(err ? err : `Extracted ${count} entries`);
+            zip.close();
+        });
+    }
+});
+zip.on('extract', (entry, file) => {
+    console.log('extract', entry.name, file);
+});