rar-stream 5.2.1 → 5.3.0

package/README.md

@@ -1,15 +1,19 @@
-# rar-stream
+<div align="center">
+  <h1>rar-stream</h1>
+</div>
+
+<div align="center"><p>
+    <a href="https://crates.io/crates/rar-stream"><img alt="Crates.io" src="https://img.shields.io/crates/v/rar-stream?style=for-the-badge&logo=rust&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://crates.io/crates/rar-stream"><img alt="Crates.io Downloads" src="https://img.shields.io/crates/d/rar-stream?style=for-the-badge&logo=rust&color=A6E3A1&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://docs.rs/rar-stream"><img alt="docs.rs" src="https://img.shields.io/docsrs/rar-stream?style=for-the-badge&logo=docs.rs&color=8bd5ca&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://www.npmjs.com/package/rar-stream"><img alt="npm" src="https://img.shields.io/npm/v/rar-stream?style=for-the-badge&logo=npm&color=F5A97F&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://www.npmjs.com/package/rar-stream"><img alt="npm Downloads" src="https://img.shields.io/npm/dm/rar-stream?style=for-the-badge&logo=npm&color=F5E0DC&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://github.com/doom-fish/rar-stream#license"><img alt="License" src="https://img.shields.io/crates/l/rar-stream?style=for-the-badge&logo=apache&color=ee999f&logoColor=D9E0EE&labelColor=302D41" /></a>
+    <a href="https://github.com/doom-fish/rar-stream/actions"><img alt="Build Status" src="https://img.shields.io/github/actions/workflow/status/doom-fish/rar-stream/ci.yml?branch=main&style=for-the-badge&logo=github&color=c69ff5&logoColor=D9E0EE&labelColor=302D41" /></a>
+</p></div>
 
 > Fast RAR archive streaming for Rust, Node.js, and browsers. Zero dependencies core.
 
-[![CI](https://github.com/doom-fish/rar-stream/actions/workflows/ci.yml/badge.svg)](https://github.com/doom-fish/rar-stream/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/rar-stream.svg)](https://www.npmjs.com/package/rar-stream)
-[![npm downloads](https://img.shields.io/npm/dm/rar-stream.svg)](https://www.npmjs.com/package/rar-stream)
-[![crates.io](https://img.shields.io/crates/v/rar-stream.svg)](https://crates.io/crates/rar-stream)
-[![crates.io downloads](https://img.shields.io/crates/d/rar-stream.svg)](https://crates.io/crates/rar-stream)
-[![docs.rs](https://docs.rs/rar-stream/badge.svg)](https://docs.rs/rar-stream)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
 ## Installation
 
 ### Node.js
@@ -18,6 +22,8 @@
 npm install rar-stream
 ```
 
+Native binaries are automatically downloaded from [GitHub Releases](https://github.com/doom-fish/rar-stream/releases) during install. Supported platforms: Linux (x64, arm64), macOS (x64, arm64), Windows (x64).
+
 ### Rust
 
 ```toml

package/index.d.ts

@@ -28,7 +28,7 @@ export interface RarFileInfo {
  * The buffer should contain at least the first ~300 bytes of a .rar file.
  */
 export declare function parseRarHeader(buffer: Buffer): RarFileInfo | null
-/** Check if a buffer starts with a RAR signature. */
+/** Check if a buffer starts with a RAR signature (RAR4 or RAR5). */
 export declare function isRarArchive(buffer: Buffer): boolean
 /** LocalFileMedia - reads from local filesystem. */
 export declare class LocalFileMedia {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rar-stream",
-  "version": "5.2.1",
+  "version": "5.3.0",
   "description": "RAR streaming library - Rust implementation with NAPI and WASM bindings",
   "main": "lib/index.mjs",
   "browser": "lib/browser.mjs",
@@ -75,7 +75,7 @@
     "bench:compare": "cargo bench -- --baseline main",
     "profile": "cargo build --release && perf record -g ./target/release/examples/profile_decompress && perf report",
     "flamegraph": "cargo flamegraph --bench decompress -- --bench",
-    "prepublishOnly": "napi prepublish -t npm --skip-gh-release"
+    "postinstall": "node scripts/postinstall.js"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",
@@ -100,15 +100,7 @@
     "pkg/rar_stream.js",
     "pkg/rar_stream.d.ts",
     "pkg/rar_stream_bg.wasm",
-    "pkg/rar_stream_bg.wasm.d.ts"
-  ],
-  "optionalDependencies": {
-    "rar-stream-win32-x64-msvc": "5.2.1",
-    "rar-stream-darwin-x64": "5.2.1",
-    "rar-stream-linux-x64-gnu": "5.2.1",
-    "rar-stream-linux-x64-musl": "5.2.1",
-    "rar-stream-linux-arm64-gnu": "5.2.1",
-    "rar-stream-darwin-arm64": "5.2.1",
-    "rar-stream-linux-arm64-musl": "5.2.1"
-  }
+    "pkg/rar_stream_bg.wasm.d.ts",
+    "scripts/postinstall.js"
+  ]
 }

package/scripts/postinstall.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+'use strict'
+
+const { existsSync, readFileSync, createWriteStream, unlinkSync } = require('fs')
+const { join } = require('path')
+const https = require('https')
+const http = require('http')
+
+const REPO = 'doom-fish/rar-stream'
+const PKG_DIR = join(__dirname, '..')
+
+function isMusl() {
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch {
+      return true
+    }
+  }
+  const { glibcVersionRuntime } = process.report.getReport().header
+  return !glibcVersionRuntime
+}
+
+function getBinaryName() {
+  const { platform, arch } = process
+  switch (platform) {
+    case 'win32':
+      if (arch === 'x64') return 'rar-stream.win32-x64-msvc.node'
+      break
+    case 'darwin':
+      if (arch === 'x64') return 'rar-stream.darwin-x64.node'
+      if (arch === 'arm64') return 'rar-stream.darwin-arm64.node'
+      break
+    case 'linux':
+      if (arch === 'x64') return isMusl() ? 'rar-stream.linux-x64-musl.node' : 'rar-stream.linux-x64-gnu.node'
+      if (arch === 'arm64') return isMusl() ? 'rar-stream.linux-arm64-musl.node' : 'rar-stream.linux-arm64-gnu.node'
+      break
+  }
+  return null
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith('https') ? https : http
+    client.get(url, { headers: { 'User-Agent': 'rar-stream-postinstall' } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve, reject)
+      }
+      if (res.statusCode !== 200) {
+        res.resume()
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`))
+      }
+      resolve(res)
+    }).on('error', reject)
+  })
+}
+
+async function main() {
+  const binaryName = getBinaryName()
+  if (!binaryName) {
+    console.log(`rar-stream: no prebuilt binary for ${process.platform}-${process.arch}, skipping download`)
+    return
+  }
+
+  const dest = join(PKG_DIR, binaryName)
+  if (existsSync(dest)) return // already present (local build or cached)
+
+  const version = require(join(PKG_DIR, 'package.json')).version
+  const url = `https://github.com/${REPO}/releases/download/v${version}/${binaryName}`
+
+  console.log(`rar-stream: downloading ${binaryName} from GitHub Release v${version}...`)
+
+  try {
+    const res = await download(url)
+    const file = createWriteStream(dest)
+    await new Promise((resolve, reject) => {
+      res.pipe(file)
+      file.on('finish', resolve)
+      file.on('error', (err) => { unlinkSync(dest); reject(err) })
+    })
+    console.log(`rar-stream: installed ${binaryName}`)
+  } catch (err) {
+    console.warn(`rar-stream: failed to download binary (${err.message}). You may need to build from source.`)
+  }
+}
+
+main()