node-pkware 1.0.2 → 2.0.0

package/README.md

@@ -34,13 +34,13 @@ Calling either explode or implode with the `-v` or `--version` flag will display
 
 `implode test/files/fast.fts.unpacked --output=C:/fast.fts --binary --large --offset=1816`
 
-`explode test/files/fast.fts --auto-detect --debug --output=E:/fast.fts.unpacked`
+`explode test/files/fast.fts --auto-detect --verbose --output=E:/fast.fts.unpacked`
 
-`explode test/files/fast.fts --auto-detect --debug --output=E:/fast.fts.unpacked --offset=2000`
+`explode test/files/fast.fts --auto-detect --verbose --output=E:/fast.fts.unpacked --offset=2000`
 
 ### piping also works
 
-**Don't use --debug when piping, because debug messages will be outputted to where the decompressed data is being outputted!**
+**Don't use --verbose when piping, because verbose messages will be outputted to where the decompressed data is being outputted!**
 
 `cat c:/arx/level8.llf | explode > c:/arx/level8.llf.unpacked`
 
@@ -66,7 +66,7 @@ Takes an optional config object, which has the following properties:
 
 ```js
 {
-  debug: boolean, // whether the code should display debug messages on the console or not (default = false)
+  verbose: boolean, // whether the code should display extra debug messages on the console or not (default = false)
   inputBufferSize: int, // the starting size of the input buffer, may expand later as needed. Not having to expand may have performance impact (default 0)
   outputBufferSize: int // same as inputBufferSize, but for the outputBuffer (default 0)
 }
@@ -80,7 +80,7 @@ Takes an optional config object, which has the following properties:
 
 ```js
 {
-  debug: boolean, // whether the code should display debug messages on the console or not (default = false)
+  verbose: boolean, // whether the code should display extra debug messages on the console or not (default = false)
   inputBufferSize: int, // the starting size of the input buffer, may expand later as needed. Not having to expand may have performance impact (default 0)
   outputBufferSize: int // same as inputBufferSize, but for the outputBuffer (default 0)
 }
@@ -148,9 +148,9 @@ const { through, streamToBuffer } = stream
 Readable.from(buffer) // buffer is of type Buffer with compressed data
   .pipe(through(explode()))
   .pipe(
-    streamToBuffer(decompressedData => {
+    streamToBuffer((decompressedData) => {
       // decompressedData holds the decompressed buffer
-    })
+    }),
   )
 ```
 
@@ -190,18 +190,18 @@ const { explode, stream } = require('node-pkware')
 const { through } = stream
 
 fs.createReadStream(`path-to-compressed-file`)
-  .on('error', err => {
+  .on('error', (err) => {
     console.error('readstream error')
   })
   .pipe(
-    through(explode()).on('error', err => {
+    through(explode()).on('error', (err) => {
       console.error('explode error')
-    })
+    }),
   )
   .pipe(
-    fs.createWriteStream(`path-to-write-decompressed-data`).on('error', err => {
+    fs.createWriteStream(`path-to-write-decompressed-data`).on('error', (err) => {
       console.error('writestream error')
-    })
+    }),
   )
 ```
 

package/bin/explode.js

@@ -8,7 +8,7 @@ const { explode } = require('../src/explode.js')
 
 const args = minimist(process.argv.slice(2), {
   string: ['output', 'offset', 'input-buffer-size', 'output-buffer-size'],
-  boolean: ['version', 'drop-before-offset', 'debug'],
+  boolean: ['version', 'drop-before-offset', 'verbose'],
   alias: {
     v: 'version',
   },
@@ -62,7 +62,7 @@ const decompress = (input, output, offset, keepHeader, config) => {
 
   const keepHeader = !args['drop-before-offset']
   const config = {
-    debug: args.debug,
+    verbose: args.verbose,
     inputBufferSize: parseNumberString(args['input-buffer-size'], 0x10000),
     outputBufferSize: parseNumberString(args['output-buffer-size'], 0x40000),
   }

package/bin/implode.js

@@ -26,7 +26,7 @@ const decompress = (input, output, offset, keepHeader, compressionType, dictiona
 
 const args = minimist(process.argv.slice(2), {
   string: ['output', 'offset', 'input-buffer-size', 'output-buffer-size'],
-  boolean: ['version', 'binary', 'ascii', 'drop-before-offset', 'debug', 'small', 'medium', 'large'],
+  boolean: ['version', 'binary', 'ascii', 'drop-before-offset', 'verbose', 'small', 'medium', 'large'],
   alias: {
     a: 'ascii',
     b: 'binary',
@@ -100,7 +100,7 @@ const args = minimist(process.argv.slice(2), {
 
   const keepHeader = !args['drop-before-offset']
   const config = {
-    debug: args.debug,
+    verbose: args.verbose,
     inputBufferSize: parseNumberString(args['input-buffer-size'], 0x10000),
     outputBufferSize: parseNumberString(args['output-buffer-size'], 0x12000),
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-pkware",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "The nodejs implementation of StormLib's pkware compressor/de-compressor",
   "main": "src/index.js",
   "types": "types/index.d.ts",
@@ -36,27 +36,27 @@
     "ramda": "^0.28.0"
   },
   "devDependencies": {
-    "@types/node": "^18.7.14",
-    "arx-header-size": "^0.7.0",
+    "@types/node": "^18.11.10",
+    "arx-header-size": "^2.0.0",
     "binary-comparator": "^0.5.0",
-    "esbuild": "^0.15.6",
-    "eslint": "^8.23.0",
+    "esbuild": "^0.15.16",
+    "eslint": "^8.28.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-config-prettier-standard": "^4.0.1",
     "eslint-config-standard": "^17.0.0",
     "eslint-plugin-import": "^2.26.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-promise": "^6.0.1",
+    "eslint-plugin-promise": "^6.1.1",
     "eslint-plugin-ramda": "^2.5.1",
     "eslint-plugin-standard": "^4.1.0",
-    "lint-staged": "^13.0.3",
-    "mocha": "^10.0.0",
-    "nodemon": "^2.0.19",
+    "lint-staged": "^13.0.4",
+    "mocha": "^10.1.0",
+    "nodemon": "^2.0.20",
     "pre-commit": "^1.2.2",
-    "prettier": "^2.7.1",
+    "prettier": "^2.8.0",
     "prettier-config-standard": "^5.0.0",
-    "typescript": "^4.8.2"
+    "typescript": "^4.9.3"
   },
   "pre-commit": [
     "lint:staged",
@@ -65,5 +65,14 @@
   ],
   "lint-staged": {
     "*.js": "eslint --fix"
-  }
+  },
+  "keywords": [
+    "arx-fatalis",
+    "pkware",
+    "stormlib",
+    "implode",
+    "explode",
+    "compression",
+    "blast"
+  ]
 }

package/src/explode.js

@@ -104,7 +104,7 @@ const generateAsciiTables = () => {
   return tables
 }
 
-const parseInitialData = (state, debug = false) => {
+const parseInitialData = (state, verbose = false) => {
   if (state.inputBuffer.size() < 4) {
     return false
   }
@@ -124,7 +124,7 @@ const parseInitialData = (state, debug = false) => {
     })
   }
 
-  if (debug) {
+  if (verbose) {
     console.log(`explode: compression type: ${state.compressionType === COMPRESSION_BINARY ? 'binary' : 'ascii'}`)
     console.log(
       `explode: compression level: ${
@@ -244,13 +244,13 @@ const decodeDistance = (state, repeatLength) => {
   return distance + 1
 }
 
-const processChunkData = (state, debug = false) => {
+const processChunkData = (state, verbose = false) => {
   if (state.inputBuffer.isEmpty()) {
     return
   }
 
   if (!has('compressionType', state)) {
-    const parsedHeader = parseInitialData(state, debug)
+    const parsedHeader = parseInitialData(state, verbose)
     if (!parsedHeader || state.inputBuffer.isEmpty()) {
       return
     }
@@ -309,7 +309,7 @@ const generateDecodeTables = (startIndexes, lengthBits) => {
 }
 
 const explode = (config = {}) => {
-  const { debug = false, inputBufferSize = 0x0, outputBufferSize = 0x0 } = config
+  const { verbose = false, inputBufferSize = 0x0, outputBufferSize = 0x0 } = config
 
   const handler = function (chunk, encoding, callback) {
     if (!isFunction(callback)) {
@@ -327,11 +327,11 @@ const explode = (config = {}) => {
         this._flush = state.onInputFinished
       }
 
-      if (debug) {
+      if (verbose) {
         console.log(`explode: reading ${toHex(chunk.length)} bytes from chunk #${state.stats.chunkCounter++}`)
       }
 
-      processChunkData(state, debug)
+      processChunkData(state, verbose)
 
       const blockSize = 0x1000
       if (state.outputBuffer.size() > blockSize) {
@@ -364,7 +364,7 @@ const explode = (config = {}) => {
     onInputFinished: (callback) => {
       const state = handler._state
 
-      if (debug) {
+      if (verbose) {
         console.log('---------------')
         console.log('explode: total number of chunks read:', state.stats.chunkCounter)
         console.log('explode: inputBuffer heap size', toHex(state.inputBuffer.heapSize()))

package/src/implode.js

@@ -178,7 +178,7 @@ const handleFirstTwoBytes = (state) => {
   state.startIndex += 2
 }
 
-const processChunkData = (state, debug = false) => {
+const processChunkData = (state, verbose = false) => {
   if (!has('dictionarySizeMask', state)) {
     setup(state)
   }
@@ -271,7 +271,7 @@ const processChunkData = (state, debug = false) => {
 }
 
 const implode = (compressionType, dictionarySizeBits, config = {}) => {
-  const { debug = false, inputBufferSize = 0x0, outputBufferSize = 0x0 } = config
+  const { verbose = false, inputBufferSize = 0x0, outputBufferSize = 0x0 } = config
 
   const handler = function (chunk, encoding, callback) {
     if (!isFunction(callback)) {
@@ -288,11 +288,11 @@ const implode = (compressionType, dictionarySizeBits, config = {}) => {
         this._flush = state.onInputFinished
       }
 
-      if (debug) {
+      if (verbose) {
         console.log(`implode: reading ${toHex(chunk.length)} bytes from chunk #${state.stats.chunkCounter++}`)
       }
 
-      processChunkData(state, debug)
+      processChunkData(state, verbose)
 
       const blockSize = 0x800
       if (state.outputBuffer.size() > blockSize) {
@@ -330,9 +330,9 @@ const implode = (compressionType, dictionarySizeBits, config = {}) => {
       const state = handler._state
       state.streamEnded = true
       try {
-        processChunkData(state, debug)
+        processChunkData(state, verbose)
 
-        if (debug) {
+        if (verbose) {
           console.log('---------------')
           console.log('implode: total number of chunks read:', state.stats.chunkCounter)
           console.log('implode: inputBuffer heap size', toHex(state.inputBuffer.heapSize()))

package/types/explode.d.ts

@@ -49,7 +49,7 @@ export function generateAsciiTables(): {
   asciiTable2E34: number[]
   asciiTable2EB4: number[]
 }
-export function processChunkData(state: PrivateExplodeState, debug?: boolean): void
+export function processChunkData(state: PrivateExplodeState, verbose?: boolean): void
 export function wasteBits(state: PrivateExplodeState, numberOfBits: number): typeof PKDCL_STREAM_END | typeof PKDCL_OK
 export function decodeNextLiteral(state: PrivateExplodeState): typeof LITERAL_STREAM_ABORTED | number
 export function decodeDistance(state: PrivateExplodeState, repeatLength: number): number

package/types/helpers/Shared.d.ts

@@ -27,10 +27,10 @@ export type PrivateState<T> = { _state: T }
  */
 export type Config = {
   /**
-   * Whether the code should display debug messages on the console or not
+   * Whether the code should display extra messages on the console or not
    * @default false
    */
-  debug?: boolean
+  verbose?: boolean
   /**
    * The starting size of the input buffer, may expand later as needed.
    * Not having to expand may have performance impact.

package/types/implode.d.ts

@@ -39,15 +39,15 @@ export function getSizeOfMatching(inputBytes: number[], a: number, b: number): n
 export function findRepetitions(
   inputBytes: number[],
   endOfLastMatch: number,
-  cursor: number
+  cursor: number,
 ): { size: number; distance: number }
 export function isRepetitionFlushable(
   size: number,
   distance: number,
   startIndex: number,
-  inputBufferSize: number
+  inputBufferSize: number,
 ): boolean | null
-export function processChunkData(state: PrivateExplodeState, debug?: boolean): void
+export function processChunkData(state: PrivateExplodeState, verbose?: boolean): void
 
 /**
  * Compresses stream
@@ -59,5 +59,5 @@ export function processChunkData(state: PrivateExplodeState, debug?: boolean): v
 export function implode(
   compressionType: CompressionType,
   dictionarySizeBits: DictionarySizeBits,
-  config?: Config
+  config?: Config,
 ): PrivateState<PrivateExplodeState> & Handler