stratum-rs-overlay 1.0.0

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2026 JJoGeon <zgh9807@gmail.com>
+
+All rights reserved.
+
+This software is provided for use "as is". 
+Modification, reverse engineering, decompiling, or redistribution of this software 
+without express written permission from the copyright holder is strictly prohibited.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND ANY EXPRESS OR 
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
+SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES.
+
+To obtain a commercial license or usage key, please visit:
+https://stratum-rs.com

package/README.md

@@ -0,0 +1,112 @@
+# ⚡ Stratum Overlay (stratum-rs-overlay)
+
+> **High-Performance, DLL-Injection Free Game Overlay Library for Electron.** > Powered by **Rust** 🦀 + **N-API**.
+
+[![npm version](https://img.shields.io/npm/v/stratum-rs-overlay.svg)](https://www.npmjs.com/package/stratum-rs-overlay)
+[![Platform](https://img.shields.io/badge/platform-win32-blue.svg)](https://www.npmjs.com/package/stratum-rs-overlay)
+[![License](https://img.shields.io/badge/license-Commercial-red.svg)](https://stratum-rs.com)
+
+**Stratum Overlay** is a specialized library designed to create invisible, click-through overlays for Windows applications using Electron. Unlike traditional methods, it does **not** inject DLLs into game processes, making it safer and more compatible with anti-cheat systems.
+
+---
+
+## 🚀 Key Features
+
+- **🛡️ Anti-Cheat Friendly:** Uses external window overlay method. No memory writing or code injection.
+- **⚡ Blazing Fast:** Core logic written in **Rust** for minimal overhead and maximum performance.
+- **🖱️ Click-Through Support:** Perfectly handles mouse events, passing clicks to the game behind the overlay.
+- **🔒 Secure Licensing:** Built-in license verification system powered by Ed25519 cryptography.
+- **🪟 Windows Native:** Fully optimized for Windows (x64) using native Win32 APIs.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install stratum-rs-overlay
+```
+
+*Note: This library currently supports **Windows (x64)** only.*
+
+---
+
+## 🛠️ Usage
+
+### 1. Get a License Key
+To use this library, you need a valid license key.  
+👉 **Get your key at:** [https://stratum-rs.com](https://stratum-rs.com)
+
+### 2. Integration in Electron
+Add the following code to your Electron **Main Process** (`main.js`):
+
+```javascript
+const { app, BrowserWindow } = require('electron');
+const stratum = require('stratum-rs-overlay');
+
+// Load environment variables (Recommended)
+require('dotenv').config();
+
+const LICENSE_KEY = process.env.STRATUM_LICENSE_KEY || "YOUR_LICENSE_KEY";
+
+function createWindow() {
+  const win = new BrowserWindow({
+    width: 800,
+    height: 600,
+    transparent: true,    // Required
+    frame: false,         // Required
+    alwaysOnTop: true,    // Recommended for overlays
+    webPreferences: {
+      nodeIntegration: true,
+      contextIsolation: false,
+    },
+  });
+
+  win.loadFile('index.html'); // or loadURL(...)
+
+  // ---------------------------------------------------------
+  // 🔐 1. Initialize & Verify License
+  // ---------------------------------------------------------
+  console.log("🔑 Verifying License...");
+  const isVerified = stratum.init(LICENSE_KEY);
+
+  if (isVerified) {
+    console.log("✅ License Verified! Activating Overlay...");
+
+    // -------------------------------------------------------
+    // 🖱️ 2. Enable Click-Through Mode
+    // Pass the native window handle (HWND) to Rust
+    // -------------------------------------------------------
+    const hwnd = win.getNativeWindowHandle();
+    stratum.setClickThrough(hwnd);
+    
+    console.log("✨ Overlay Mode: ACTIVATED");
+  } else {
+    console.error("❌ License Verification Failed.");
+    console.error("   - Overlay features are disabled.");
+    // Handle invalid license (e.g., show error dialog or quit)
+  }
+}
+
+app.whenReady().then(createWindow);
+```
+
+---
+
+## ⚠️ Requirements
+
+- **OS:** Windows 10 / 11 (64-bit)
+- **Runtime:** Node.js 16+ / Electron
+- **Dependencies:** Microsoft Visual C++ Redistributable (usually pre-installed on Windows)
+
+---
+
+## 📞 Support & License
+
+This project is a **Commercial Software**.  
+Usage without a valid license key is strictly prohibited.
+
+- **Website:** [stratum-rs.com](https://stratum-rs.com)
+- **Contact:** [zgh9807@gmail.com](mailto:zgh9807@gmail.com)
+
+Copyright (c) 2026 JJoGeon <zgh9807@gmail.com>.
+All rights reserved.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export declare function helloFromRust(): string
+export declare function init(licenseKeyHex: string): boolean
+export declare function setClickThrough(hwndBuffer: Buffer): void

package/dist/index.js

@@ -0,0 +1,317 @@
+/* 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, 'index.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm64.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-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, 'index.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'index.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.darwin-universal.node')
+      } else {
+        nativeBinding = require('stratum-rs-overlay-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'index.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-x64.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-arm64.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-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, 'index.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.freebsd-x64.node')
+      } else {
+        nativeBinding = require('stratum-rs-overlay-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('stratum-rs-overlay-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('stratum-rs-overlay-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 { helloFromRust, init, setClickThrough } = nativeBinding
+
+module.exports.helloFromRust = helloFromRust
+module.exports.init = init
+module.exports.setClickThrough = setClickThrough

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "stratum-rs-overlay",
+  "version": "1.0.0",
+  "description": "A high-performance, non-intrusive game overlay library for Electron powered by Rust.",
+  "os": [
+    "win32"
+  ],
+  "keywords": [
+    "electron",
+    "overlay",
+    "window",
+    "transparent",
+    "click-through",
+    "rust",
+    "napi-rs",
+    "game-overlay"
+  ],
+  "homepage": "https://stratum-rs.com",
+  "author": "JJoGeon <zgh9807@gmail.com>",
+  "bugs": {
+    "email": "zgh9807@gmail.com"
+  },
+  "license": "UNLICENSED",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "shx rm -rf dist && shx mkdir -p dist && napi build --platform --release --js index.js --dts index.d.ts && shx mv index.js index.d.ts *.node dist/",
+    "build:debug": "shx rm -rf dist && shx mkdir -p dist && napi build --platform --js index.js --dts index.d.ts && shx mv index.js index.d.ts *.node dist/",
+    "start": "npm run build:debug && electron examples/main.js"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "dotenv": "^17.2.3",
+    "electron": "^40.0.0",
+    "shx": "^0.4.0"
+  },
+  "napi": {
+    "binaryName": "index",
+    "targets": [
+      "x86_64-pc-windows-msvc"
+    ]
+  }
+}