nyxCore-Systems
diff --git a/‎CHANGELOG.md‎
Lines changed: 21 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 21 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 16 additions & 15 deletions b/‎README.md‎
Lines changed: 16 additions & 15 deletions
diff --git a/‎docs/getting-started.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/getting-started.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎examples/shared/demo-template.ts‎
Lines changed: 1 addition & 1 deletion b/‎examples/shared/demo-template.ts‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎package.json‎
Lines changed: 5 additions & 2 deletions b/‎package.json‎
Lines changed: 5 additions & 2 deletions
diff --git a/‎packages/middleware-express/README.md‎
Lines changed: 111 additions & 0 deletions b/‎packages/middleware-express/README.md‎
Lines changed: 111 additions & 0 deletions
diff --git a/‎packages/middleware-express/package.json‎
Lines changed: 1 addition & 1 deletion b/‎packages/middleware-express/package.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎packages/middleware-fastify/README.md‎
Lines changed: 110 additions & 0 deletions b/‎packages/middleware-fastify/README.md‎
Lines changed: 110 additions & 0 deletions
diff --git a/‎packages/middleware-fastify/package.json‎
Lines changed: 1 addition & 1 deletion b/‎packages/middleware-fastify/package.json‎
Lines changed: 1 addition & 1 deletion
@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.0 (2026-02-22)
+
+### Features
+
+- **GPU detection** — Classify GPU tier from WebGL renderer string: software renderers → `low`, RTX/RX 5000+/Apple M-series → `high`, everything else → `mid`
+- **Battery API signal** — Collect battery level and charging status via `navigator.getBattery()` (Chromium-only, silently skipped elsewhere). When unplugged and below 15%, `deferHeavyComponents`, `reduceAnimations`, and `disableAutoplay` are forced on
+- **Signal validation** — New `isValidSignals()` type guard for validating incoming probe payloads
+- **Custom GPU thresholds** — `softwarePattern` and `highEndPattern` are configurable via `GpuThresholds`
+
+### Dependencies
+
+- Bump `esbuild` from 0.25.12 to 0.27.3
+- Bump `koa` and `@types/koa`
+- Bump `actions/checkout` from v4 to v6
+- Bump `actions/setup-node` from v4 to v6
+
+### Infrastructure
+
+- Split CI into separate lint, audit, and test jobs
+- Add Dependabot config for automated dependency updates
+
 ## 0.1.0 (2026-02-22)
 
 Initial release.
 
@@ -1,8 +1,8 @@
 # DeviceRouter
 
-[![npm](https://img.shields.io/npm/v/@device-router/types?label=npm&color=cb3837)](https://www.npmjs.com/package/@device-router/types)
+[![npm](https://img.shields.io/npm/v/@device-router/types?label=npm&color=cb3837)](https://www.npmjs.com/search?q=%40device-router)
 [![CI](https://img.shields.io/github/actions/workflow/status/SimplyLiz/DeviceRouter/ci.yml?branch=main&label=CI)](https://github.com/SimplyLiz/DeviceRouter/actions/workflows/ci.yml)
-[![bundle size](https://img.shields.io/badge/probe-988%20B%20gzipped-blue)](https://github.com/SimplyLiz/DeviceRouter/tree/main/packages/probe)
+[![bundle size](https://img.shields.io/badge/probe-~1%20KB%20gzipped-blue)](https://github.com/SimplyLiz/DeviceRouter/tree/main/packages/probe)
 [![license](https://img.shields.io/github/license/SimplyLiz/DeviceRouter)](https://github.com/SimplyLiz/DeviceRouter/blob/main/LICENSE)
 [![node](https://img.shields.io/badge/node-%E2%89%A520-417e38)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178c6)](https://www.typescriptlang.org/)
@@ -11,7 +11,7 @@
 
 Stop guessing what your users' devices can handle. DeviceRouter detects real device capabilities — CPU cores, memory, network speed, and more — and gives your server the intelligence to adapt responses instantly.
 
-A **988-byte** client probe. One middleware call. Full device awareness on every request.
+A **~1 KB** client probe. One middleware call. Full device awareness on every request.
 
 ## Why DeviceRouter?
 
@@ -27,7 +27,7 @@ No user-agent sniffing. No guesswork. Real signals from real devices, classified
 ```
 ┌──────────┐                  ┌────────────┐     ┌─────────┐
 │ Browser  │  POST /probe     │  Express   │     │ Storage │
-│ (988 B)  │ ──────────────>  │ Middleware │ ──> │         │
+│ (~1 KB)  │ ──────────────>  │ Middleware │ ──> │         │
 │          │  device signals  │            │     │         │
 └──────────┘                  └────────────┘     └─────────┘
                                     │
@@ -39,7 +39,7 @@ No user-agent sniffing. No guesswork. Real signals from real devices, classified
 ```
 
 1. **Probe** — A tiny script runs once per session, collecting device signals via browser APIs
-2. **Classify** — The middleware classifies the device into CPU, memory, and connection tiers
+2. **Classify** — The middleware classifies the device into CPU, memory, connection, and GPU tiers
 3. **Hint** — Rendering hints like `deferHeavyComponents` and `reduceAnimations` are derived automatically
 4. **Serve** — Your route handlers read `req.deviceProfile` and respond accordingly
 
@@ -93,6 +93,7 @@ app.get('/', (req, res) => {
 | Prefers reduced motion | `matchMedia`               | All modern browsers   |
 | Prefers color scheme   | `matchMedia`               | All modern browsers   |
 | GPU renderer           | WebGL debug info           | Chrome, Firefox, Edge |
+| Battery status         | `navigator.getBattery()`   | Chrome, Edge          |
 
 All signals are optional — the probe gracefully degrades based on what the browser supports.
 
@@ -111,15 +112,15 @@ Devices are classified across three dimensions:
 
 Based on tiers and user preferences, DeviceRouter derives actionable booleans:
 
-| Hint                    | When it activates                             |
-| ----------------------- | --------------------------------------------- |
-| `deferHeavyComponents`  | Low-end device or slow connection             |
-| `serveMinimalCSS`       | Low-end device                                |
-| `reduceAnimations`      | Low-end device or user prefers reduced motion |
-| `useImagePlaceholders`  | Slow connection (2G/3G)                       |
-| `disableAutoplay`       | Low-end device or slow connection             |
-| `preferServerRendering` | Low-end device                                |
-| `disable3dEffects`      | No GPU or software renderer                   |
+| Hint                    | When it activates                                      |
+| ----------------------- | ------------------------------------------------------ |
+| `deferHeavyComponents`  | Low-end device, slow connection, or low battery        |
+| `serveMinimalCSS`       | Low-end device                                         |
+| `reduceAnimations`      | Low-end device, prefers reduced motion, or low battery |
+| `useImagePlaceholders`  | Slow connection (2G/3G)                                |
+| `disableAutoplay`       | Low-end device, slow connection, or low battery        |
+| `preferServerRendering` | Low-end device                                         |
+| `disable3dEffects`      | No GPU or software renderer                            |
 
 ## Custom Thresholds
 
@@ -156,7 +157,7 @@ No need to manually add `<script>` tags — the probe is injected before `</head
 
 | Package                                                               | Description                                           | Size              |
 | --------------------------------------------------------------------- | ----------------------------------------------------- | ----------------- |
-| [`@device-router/probe`](docs/api/probe.md)                           | Client-side capability probe                          | **988 B** gzipped |
+| [`@device-router/probe`](docs/api/probe.md)                           | Client-side capability probe                          | **~1 KB** gzipped |
 | [`@device-router/types`](docs/api/types.md)                           | Type definitions, classification, and hint derivation | —                 |
 | [`@device-router/storage`](docs/api/storage.md)                       | Storage adapters (in-memory + Redis)                  | —                 |
 | [`@device-router/middleware-express`](docs/api/middleware-express.md) | Express middleware                                    | —                 |
 
@@ -129,7 +129,7 @@ app.use(async (ctx) => {
 <script src="/path/to/device-router-probe.min.js"></script>
 ```
 
-The probe script (~988 bytes gzipped) runs once per session. It collects device signals and POSTs them to the probe endpoint.
+The probe script (~1 KB gzipped) runs once per session. It collects device signals and POSTs them to the probe endpoint.
 
 ### Auto-Injection
 
 
@@ -170,7 +170,7 @@ ${full ? '    <svg style="display:block;width:100%;position:absolute;bottom:-1px
           : '\u26A1'
       }</span>
       <h3>Real-Time Detection</h3>
-      <p>A 901-byte probe collects CPU, memory, GPU, and network signals via browser APIs \u2014 no user-agent sniffing.</p>
+      <p>A ~1 KB probe collects CPU, memory, GPU, network, and battery signals via browser APIs \u2014 no user-agent sniffing.</p>
     </div>
     <div class="card">
       <span class="card-icon">${
 
@@ -1,6 +1,6 @@
 {
   "name": "device-router",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": true,
   "type": "module",
   "license": "MIT",
@@ -22,7 +22,10 @@
   "pnpm": {
     "onlyBuiltDependencies": [
       "esbuild"
-    ]
+    ],
+    "overrides": {
+      "minimatch@<10.2.1": "^10.2.1"
+    }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
 
@@ -0,0 +1,111 @@
+# @device-router/middleware-express
+
+Express middleware for [DeviceRouter](https://github.com/SimplyLiz/DeviceRouter). Adds device classification and rendering hints to every request.
+
+## Installation
+
+```bash
+pnpm add @device-router/middleware-express @device-router/storage
+```
+
+For automatic probe injection:
+
+```bash
+pnpm add @device-router/probe
+```
+
+## Quick start
+
+```typescript
+import express from 'express';
+import { createDeviceRouter } from '@device-router/middleware-express';
+import { MemoryStorageAdapter } from '@device-router/storage';
+
+const app = express();
+const { middleware, probeEndpoint } = createDeviceRouter({
+  storage: new MemoryStorageAdapter(),
+});
+
+app.use(express.json());
+app.post('/device-router/probe', probeEndpoint);
+app.use(middleware);
+
+app.get('/', (req, res) => {
+  const profile = req.deviceProfile;
+
+  if (profile?.hints.preferServerRendering) {
+    return res.send(renderSSR());
+  }
+  if (profile?.hints.deferHeavyComponents) {
+    return res.send(renderLite());
+  }
+  res.send(renderFull());
+});
+
+app.listen(3000);
+```
+
+## How it works
+
+1. **Probe endpoint** receives device signals from the browser and stores a classified profile
+2. **Middleware** reads the session cookie, loads the profile from storage, and attaches it to `req.deviceProfile`
+3. Your route handlers use `req.deviceProfile.hints` and `req.deviceProfile.tiers` to adapt responses
+
+## Probe auto-injection
+
+Automatically inject the probe `<script>` into HTML responses before `</head>`:
+
+```typescript
+const { middleware, probeEndpoint, injectionMiddleware } = createDeviceRouter({
+  storage: new MemoryStorageAdapter(),
+  injectProbe: true,
+  probeNonce: 'my-csp-nonce', // optional, for Content-Security-Policy
+});
+
+app.use(injectionMiddleware); // before routes
+app.post('/device-router/probe', probeEndpoint);
+app.use(middleware);
+```
+
+## Custom thresholds
+
+Override default tier classification boundaries:
+
+```typescript
+const { middleware, probeEndpoint } = createDeviceRouter({
+  storage,
+  thresholds: {
+    cpu: { lowUpperBound: 4, midUpperBound: 8 },
+    memory: { midUpperBound: 8 },
+  },
+});
+```
+
+## Options
+
+| Option        | Type                                   | Default           | Description                           |
+| ------------- | -------------------------------------- | ----------------- | ------------------------------------- |
+| `storage`     | `StorageAdapter`                       | _(required)_      | Storage backend for profiles          |
+| `cookieName`  | `string`                               | `'dr_session'`    | Session cookie name                   |
+| `cookiePath`  | `string`                               | `'/'`             | Cookie path                           |
+| `ttl`         | `number`                               | `86400` (24h)     | Profile TTL in seconds                |
+| `probePath`   | `string`                               | —                 | Custom probe endpoint path            |
+| `thresholds`  | `TierThresholds`                       | Built-in defaults | Custom tier classification thresholds |
+| `injectProbe` | `boolean`                              | `false`           | Auto-inject probe into HTML           |
+| `probeNonce`  | `string \| ((req: Request) => string)` | —                 | CSP nonce for injected script         |
+
+## Exports
+
+- `createDeviceRouter(options)` — All-in-one setup returning `{ middleware, probeEndpoint, injectionMiddleware? }`
+- `createMiddleware(options)` — Standalone middleware
+- `createProbeEndpoint(options)` — Standalone probe endpoint handler
+- `createInjectionMiddleware(options)` — Standalone probe injection middleware
+
+## Compatibility
+
+- Express 4.x and 5.x
+- Node.js >= 20
+
+## License
+
+MIT
@@ -1,6 +1,6 @@
 {
   "name": "@device-router/middleware-express",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",
 
@@ -0,0 +1,110 @@
+# @device-router/middleware-fastify
+
+Fastify plugin for [DeviceRouter](https://github.com/SimplyLiz/DeviceRouter). Adds device classification and rendering hints to every request.
+
+## Installation
+
+```bash
+pnpm add @device-router/middleware-fastify @device-router/storage @fastify/cookie
+```
+
+For automatic probe injection:
+
+```bash
+pnpm add @device-router/probe
+```
+
+## Quick start
+
+```typescript
+import Fastify from 'fastify';
+import cookie from '@fastify/cookie';
+import { createDeviceRouter } from '@device-router/middleware-fastify';
+import { MemoryStorageAdapter } from '@device-router/storage';
+
+const app = Fastify();
+const { plugin, probeEndpoint } = createDeviceRouter({
+  storage: new MemoryStorageAdapter(),
+});
+
+await app.register(cookie);
+await app.register(plugin);
+
+app.post('/device-router/probe', probeEndpoint);
+
+app.get('/', (req, reply) => {
+  const profile = req.deviceProfile;
+
+  if (profile?.hints.preferServerRendering) {
+    return reply.send(renderSSR());
+  }
+  if (profile?.hints.deferHeavyComponents) {
+    return reply.send(renderLite());
+  }
+  reply.send(renderFull());
+});
+
+app.listen({ port: 3000 });
+```
+
+## How it works
+
+1. **Probe endpoint** receives device signals from the browser and stores a classified profile
+2. **Plugin** registers a `preHandler` hook that reads the session cookie, loads the profile from storage, and attaches it to `req.deviceProfile`
+3. Your route handlers use `req.deviceProfile.hints` and `req.deviceProfile.tiers` to adapt responses
+
+## Probe auto-injection
+
+Automatically inject the probe `<script>` into HTML responses:
+
+```typescript
+const { plugin, probeEndpoint, injectionHook } = createDeviceRouter({
+  storage: new MemoryStorageAdapter(),
+  injectProbe: true,
+  probeNonce: 'my-csp-nonce', // optional
+});
+```
+
+When `injectProbe` is enabled, the plugin registers an `onSend` hook that injects the script before `</head>`.
+
+## Custom thresholds
+
+```typescript
+const { plugin, probeEndpoint } = createDeviceRouter({
+  storage,
+  thresholds: {
+    cpu: { lowUpperBound: 4, midUpperBound: 8 },
+    memory: { midUpperBound: 8 },
+  },
+});
+```
+
+## Options
+
+| Option        | Type                                          | Default           | Description                   |
+| ------------- | --------------------------------------------- | ----------------- | ----------------------------- |
+| `storage`     | `StorageAdapter`                              | _(required)_      | Storage backend for profiles  |
+| `cookieName`  | `string`                                      | `'dr_session'`    | Session cookie name           |
+| `cookiePath`  | `string`                                      | `'/'`             | Cookie path                   |
+| `ttl`         | `number`                                      | `86400` (24h)     | Profile TTL in seconds        |
+| `thresholds`  | `TierThresholds`                              | Built-in defaults | Custom tier thresholds        |
+| `injectProbe` | `boolean`                                     | `false`           | Auto-inject probe into HTML   |
+| `probePath`   | `string`                                      | —                 | Custom probe endpoint path    |
+| `probeNonce`  | `string \| ((req: FastifyRequest) => string)` | —                 | CSP nonce for injected script |
+
+## Exports
+
+- `createDeviceRouter(options)` — All-in-one setup returning `{ plugin, probeEndpoint, injectionHook? }`
+- `createMiddleware(options)` — Standalone preHandler hook
+- `createProbeEndpoint(options)` — Standalone probe endpoint handler
+- `createInjectionHook(options)` — Standalone onSend injection hook
+
+## Compatibility
+
+- Fastify 5.x
+- `@fastify/cookie` 11.x
+- Node.js >= 20
+
+## License
+
+MIT
@@ -1,6 +1,6 @@
 {
   "name": "@device-router/middleware-fastify",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@device-router/middleware-express",`
`3`		`- "version": "0.2.0",`
	`3`	`+ "version": "0.2.1",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@device-router/middleware-fastify",`
`3`		`- "version": "0.2.0",`
	`3`	`+ "version": "0.2.1",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"main": "./dist/index.js",`