fluxwright 0.1.0

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fluxwright contributors
+
+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.

package/MISSING.md

@@ -0,0 +1,16 @@
+# Playwright methods not in Fluxwright (TypeScript)
+
+The TS binding covers the same small page API as the Rust crate. Missing on purpose:
+
+- Firefox / WebKit
+- Tracing, HAR, video
+- `page.route` beyond resource-type / URL blocking on the job
+- Network idle waits as first-class APIs
+- Storage state import/export
+- `page.emulateMedia`, geolocation, permissions helpers
+- Playwright Test runner, fixtures, expect
+- `locator.filter`, `getByRole`, `getByText` (basic CSS locator only)
+- Multiple pages per context
+- Download / upload helpers
+- WebSocket / worker APIs
+- `connectOverCDP` (planned as a later `BrowserSource`)

package/README.md

@@ -0,0 +1,56 @@
+# fluxwright
+
+In-process **Chromium fleet** for Node. Lease API (fresh context per `newPage`), not Playwright parity.
+
+Requires a local Chrome/Chromium binary (`FLUXWRIGHT_CHROMIUM`, `CHROME`, `CHROMIUM`, or a standard install path).
+
+## Install
+
+```bash
+npm install fluxwright
+```
+
+If no prebuild exists for your platform, you need Rust + Chrome, then from this package directory:
+
+```bash
+npm run build
+```
+
+## Use
+
+```ts
+import { chromium } from "fluxwright";
+
+const browser = await chromium.launch({ maxBrowsers: 4 });
+const page = await browser.newPage();
+await page.goto("https://example.com");
+console.log(await page.title());
+await page.click("css-selector");
+await page.fill("input", "value");
+const html = await page.content();
+const png = await page.screenshot(); // Buffer
+await page.close();
+await browser.close();
+```
+
+`chromium.launch` starts the Fluxwright engine in-process. Each `newPage` is a **new browser context**. Drop/`close` destroys that context and returns the slot.
+
+### API
+
+| Method | What it does |
+|---|---|
+| `chromium.launch({ maxBrowsers? })` | Start the pool |
+| `browser.newPage()` | Acquire a lease |
+| `page.goto(url)` | Navigate |
+| `page.title()` / `page.content()` | Read |
+| `page.click(selector)` / `page.fill(selector, value)` | CSS only |
+| `page.evaluate(expression)` | `Runtime.evaluate`, JSON |
+| `page.screenshot()` | PNG `Buffer` |
+| `page.waitForSelector(selector)` | Actionable wait |
+| `page.close()` / `browser.close()` | Dispose context / shut down |
+
+See `MISSING.md` for Playwright methods that will not be added.
+
+## License
+
+MIT OR Apache-2.0

package/addon.d.ts

@@ -0,0 +1,5 @@
+export * from './index'
+import { Chromium } from './index'
+/** Playwright-style export: `chromium.launch(...)`. Same as `Chromium.launch`. */
+export const chromium: typeof Chromium
+export default { chromium }

package/addon.js

@@ -0,0 +1,17 @@
+'use strict'
+
+try {
+  const native = require('./index.js')
+  module.exports = native
+  module.exports.chromium = native.Chromium
+  module.exports.default = module.exports
+} catch (err) {
+  module.exports = {
+    chromium: {
+      launch: async () => {
+        throw new Error('build the native addon: npm run build')
+      },
+    },
+  }
+  module.exports.default = module.exports
+}

package/index.d.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface LaunchOptions {
+  maxBrowsers?: number
+}
+export declare function chromium(): Chromium
+export declare class Browser {
+  newPage(): Promise<Page>
+  close(): Promise<void>
+}
+export declare class Page {
+  goto(url: string): Promise<void>
+  title(): Promise<string>
+  content(): Promise<string>
+  click(selector: string): Promise<void>
+  fill(selector: string, value: string): Promise<void>
+  evaluate(expression: string): Promise<any>
+  screenshot(): Promise<Buffer>
+  waitForSelector(selector: string): Promise<void>
+  close(): Promise<void>
+}
+export declare class Chromium {
+  static launch(options?: LaunchOptions | undefined | null): Promise<Browser>
+}

package/index.js

@@ -0,0 +1,318 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  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 (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.android-arm64.node')
+          } else {
+            nativeBinding = require('fluxwright-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('fluxwright-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('fluxwright-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fluxwright.darwin-universal.node')
+      } else {
+        nativeBinding = require('fluxwright-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'fluxwright.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.darwin-x64.node')
+          } else {
+            nativeBinding = require('fluxwright-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.darwin-arm64.node')
+          } else {
+            nativeBinding = require('fluxwright-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'fluxwright.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fluxwright.freebsd-x64.node')
+      } else {
+        nativeBinding = require('fluxwright-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fluxwright.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fluxwright.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('fluxwright-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'fluxwright.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fluxwright.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('fluxwright-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { Browser, Page, Chromium, chromium } = nativeBinding
+
+module.exports.Browser = Browser
+module.exports.Page = Page
+module.exports.Chromium = Chromium
+module.exports.chromium = chromium

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "fluxwright",
+  "version": "0.1.0",
+  "description": "In-process Chromium fleet engine (napi-rs). Lease API, not Playwright parity.",
+  "main": "addon.js",
+  "types": "addon.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harshit-d3v/fluxwright.git",
+    "directory": "bindings/node"
+  },
+  "homepage": "https://github.com/harshit-d3v/fluxwright#readme",
+  "bugs": {
+    "url": "https://github.com/harshit-d3v/fluxwright/issues"
+  },
+  "keywords": [
+    "chromium",
+    "chrome",
+    "cdp",
+    "browser-pool",
+    "automation",
+    "napi-rs"
+  ],
+  "author": "Fluxwright contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "addon.js",
+    "addon.d.ts",
+    "index.js",
+    "index.d.ts",
+    "MISSING.md",
+    "README.md",
+    "LICENSE-MIT"
+  ],
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "artifacts": "napi artifacts",
+    "prepublishOnly": "napi prepublish -t npm --skip-gh-release"
+  },
+  "napi": {
+    "name": "fluxwright",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4"
+  },
+  "optionalDependencies": {
+    "fluxwright-win32-x64-msvc": "0.1.0",
+    "fluxwright-darwin-x64": "0.1.0",
+    "fluxwright-linux-x64-gnu": "0.1.0",
+    "fluxwright-darwin-arm64": "0.1.0"
+  }
+}