fusion-framework 1.1.2 → 1.2.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Fusion Framework
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -2,26 +2,24 @@
 
 Class-based HTTP APIs on a shared Rust core (`fusion-core`).
 
-Handlers use `this.params` / `this.query` / `this.body` / `this.state` (no signature param injection — that is Python-only DX).
+Handlers use `this.params` / `this.query` / `this.body` / `this.state` (no signature param injection — that is Python-only).
 
-## Links
+## Install
 
-- **Docs:** [fusion.cipherunit.xyz](https://fusion.cipherunit.xyz/)
-- **GitHub:** [cipherunits/fusion-framework](https://github.com/cipherunits/fusion-framework)
-- **CLI:** [cipherunits/fusion-tool](https://github.com/cipherunits/fusion-tool)
+```bash
+npm i fusion-framework
+```
 
-## Install
+From this repo:
 
 ```bash
-cd crates/fusion-node
-npm install
-npm run build:debug
+cd crates/fusion-node && npm install && npm run build:debug
 ```
 
-Or after publish:
+Scaffold with [Fusion Tool](https://github.com/cipherunits/fusion-tool):
 
 ```bash
-npm i fusion-framework
+fusion init --lang typescript --name my-app
 ```
 
 ## Quick start
@@ -37,7 +35,7 @@ export const ItemModule = route('/api/[module]/{id}')(
   },
 )
 
-const MIDDLEWARE = [] // optional — framework has no defaults
+const MIDDLEWARE = [] // your middleware; Fusion already adds frameworkHeaders() by default
 
 settings.ensureLoaded()
 const app = new FusionApp(getSettings())
@@ -45,32 +43,14 @@ for (const mw of MIDDLEWARE) app.use(mw)
 await app.listen()
 ```
 
-## Middleware
-
-```js
-import { bearerJwt, requireRoles, route } from 'fusion-framework'
-
-const MIDDLEWARE = [bearerJwt()] // or bearerJwt({ verify })
-
-route('/api/admin', { roles: ['admin', 'super_admin'] })(
-  class AdminModule extends FusionBaseApi {
-    get() {
-      return this.response({ user: this.state.jwt?.sub })
-    }
-  },
-)
-```
-
-Sync or async: `(request, callNext) => …` / `async (request, callNext) => await callNext(request)`.
+## Docs
 
-## Status codes
+Full guides (router, config, middleware):  
+**https://fusion.cipherunit.xyz/en/docs/typescript/v1**
 
-```js
-import { status } from 'fusion-framework'
-status.HTTP_SUCCESS // 200
-status.HTTP_404_NOT_FOUND
-```
+- Site: [fusion.cipherunit.xyz](https://fusion.cipherunit.xyz/)
+- GitHub: [cipherunits/fusion-framework](https://github.com/cipherunits/fusion-framework)
 
 ## License
 
-MIT
+BSD 3-Clause

package/index.d.ts

@@ -94,8 +94,27 @@ export function coerceParamJs(raw: string, kind?: string): unknown
 
 export const settings: Settings
 export const status: Record<string, number>
+export const header: HeaderModule
 export const HTTP_METHODS: string[]
 
+export interface HeaderModule {
+  [name: string]: string | ((...args: any[]) => Record<string, string>)
+  CONTENT_TYPE: string
+  CONTENT_DISPOSITION: string
+  LOCATION: string
+  AUTHORIZATION: string
+  APPLICATION_JSON: string
+  APPLICATION_OCTET_STREAM: string
+  APPLICATION_PDF: string
+  attachment(filename: string): Record<string, string>
+  inline(filename?: string | null): Record<string, string>
+  contentType(mediaType: string, charset?: string | null): Record<string, string>
+  location(url: string): Record<string, string>
+  cacheControl(value: string): Record<string, string>
+  download(filename: string, mediaType?: string | null): Record<string, string>
+  fingerprint(): Record<string, string>
+}
+
 export interface FusionSettings {
   host: string
   port: number
@@ -118,6 +137,8 @@ export type FusionMiddleware = (
   callNext: (request: FusionRequest) => unknown | Promise<unknown>,
 ) => unknown | Promise<unknown>
 
+export function frameworkHeaders(): FusionMiddleware
+
 export type FusionResponse =
   | string
   | {

package/index.js

@@ -63,6 +63,111 @@ if (typeof native.getHttpStatusCodes === 'function') {
   })
 }
 
+const header = Object.create(null)
+if (typeof native.getHttpHeaderConstants === 'function') {
+  for (const entry of native.getHttpHeaderConstants()) {
+    header[entry.name] = entry.value
+  }
+} else {
+  Object.assign(header, {
+    CONTENT_TYPE: 'Content-Type',
+    CONTENT_DISPOSITION: 'Content-Disposition',
+    LOCATION: 'Location',
+    AUTHORIZATION: 'Authorization',
+    APPLICATION_JSON: 'application/json',
+    APPLICATION_OCTET_STREAM: 'application/octet-stream',
+    APPLICATION_PDF: 'application/pdf',
+  })
+}
+
+function mergeHeaderMap(map) {
+  return map && typeof map === 'object' ? { ...map } : {}
+}
+
+header.attachment = (filename) =>
+  typeof native.headerAttachment === 'function'
+    ? mergeHeaderMap(native.headerAttachment(String(filename)))
+    : { [header.CONTENT_DISPOSITION]: `attachment; filename="${filename}"` }
+
+header.inline = (filename) =>
+  typeof native.headerInline === 'function'
+    ? mergeHeaderMap(native.headerInline(filename == null ? null : String(filename)))
+    : filename
+      ? { [header.CONTENT_DISPOSITION]: `inline; filename="${filename}"` }
+      : { [header.CONTENT_DISPOSITION]: 'inline' }
+
+header.contentType = (mediaType, charset) =>
+  typeof native.headerContentType === 'function'
+    ? mergeHeaderMap(native.headerContentType(String(mediaType), charset == null ? null : String(charset)))
+    : {
+        [header.CONTENT_TYPE]: charset
+          ? `${mediaType}; charset=${charset}`
+          : String(mediaType),
+      }
+
+header.location = (url) =>
+  typeof native.headerLocation === 'function'
+    ? mergeHeaderMap(native.headerLocation(String(url)))
+    : { [header.LOCATION]: String(url) }
+
+header.cacheControl = (value) =>
+  typeof native.headerCacheControl === 'function'
+    ? mergeHeaderMap(native.headerCacheControl(String(value)))
+    : { 'Cache-Control': String(value) }
+
+header.download = (filename, mediaType) =>
+  typeof native.headerDownload === 'function'
+    ? mergeHeaderMap(
+        native.headerDownload(
+          String(filename),
+          mediaType == null ? null : String(mediaType),
+        ),
+      )
+    : {
+        ...header.contentType(mediaType || header.APPLICATION_OCTET_STREAM),
+        ...header.attachment(filename),
+      }
+
+header.fingerprint = () =>
+  typeof native.getFingerprintHeaders === 'function'
+    ? mergeHeaderMap(native.getFingerprintHeaders())
+    : {
+        'X-Powered-By': 'Fusion Framework',
+        'X-Framework': 'Fusion',
+        'X-Fusion-Version': '1.2.1',
+      }
+
+function isThenable(value) {
+  return value != null && typeof value.then === 'function'
+}
+
+async function awaitMaybe(value) {
+  // Nested thenables (middleware wrapping async handlers) — same idea as Python
+  // awaiting coroutines before treating the value as an HTTP body.
+  let current = value
+  for (let i = 0; i < 8 && isThenable(current); i++) {
+    current = await current
+  }
+  return current
+}
+
+function mergeResponseHeaders(result, extra) {
+  if (!result || typeof result !== 'object') {
+    return { status: 200, body: result, headers: { ...extra } }
+  }
+  const headers = { ...extra, ...(result.headers || {}) }
+  return { ...result, headers }
+}
+
+function frameworkHeaders() {
+  const extra = header.fingerprint()
+  // Async so Promises from callNext are never stuffed into `body` as objects.
+  return async (request, callNext) => {
+    const result = await awaitMaybe(callNext(request))
+    return mergeResponseHeaders(result, extra)
+  }
+}
+
 class FusionBaseApi {
   constructor(request) {
     this.request = request
@@ -127,18 +232,14 @@ function isResponse(value) {
 
 async function runMiddlewareChain(request, middlewares, handler) {
   ensureState(request)
-  let index = 0
 
   async function dispatch(i, req) {
     if (i >= middlewares.length) {
-      return await handler(req)
+      return await awaitMaybe(handler(req))
     }
     const middleware = middlewares[i]
     const callNext = (nextReq) => dispatch(i + 1, nextReq)
-    let result = middleware(req, callNext)
-    if (result && typeof result.then === 'function') {
-      result = await result
-    }
+    const result = await awaitMaybe(middleware(req, callNext))
     if (isResponse(result)) return result
     return result
   }
@@ -488,7 +589,8 @@ class FusionApp {
     this.settings = getSettings()
     this.engine = new NativeApp()
     this.mounted = false
-    this._middleware = []
+    // Default: advertise Fusion to clients / Wappalyzer-style detectors.
+    this._middleware = [frameworkHeaders()]
   }
 
   use(middleware) {
@@ -639,10 +741,12 @@ module.exports = {
   getSettings,
   settings,
   status,
+  header,
   HTTP_METHODS,
   run,
   bearerJwt,
   requireRoles,
+  frameworkHeaders,
   runMiddlewareChain,
   coerceParam,
   getHttpMethods: () => HTTP_METHODS,

package/package.json

@@ -1,25 +1,21 @@
 {
   "name": "fusion-framework",
-  "version": "1.1.2",
-  "description": "Build high-performance class-based HTTP APIs in Node.js on a shared Rust core — routing, middleware, JWT auth, and TypeScript types",
+  "version": "1.2.1",
+  "description": "Class-based HTTP framework for Node.js, powered by a shared Rust core via N-API",
   "keywords": [
     "http",
     "framework",
     "nodejs",
-    "node",
-    "rust",
-    "napi",
     "http-server",
     "web-framework",
-    "rest-api",
+    "rest",
     "api",
     "routing",
     "middleware",
     "jwt",
     "typescript",
-    "openapi",
-    "swagger",
-    "hyper",
+    "napi",
+    "rust",
     "fusion"
   ],
   "homepage": "https://fusion.cipherunit.xyz/",
@@ -32,21 +28,33 @@
     "directory": "crates/fusion-node"
   },
   "author": "CipherUnits <cipherunit.dev@gmail.com>",
-  "license": "MIT",
-  "main": "index.js",
-  "types": "index.d.ts",
+  "license": "BSD-3-Clause",
+  "type": "commonjs",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "index.js",
     "index.d.ts",
     "README.md",
+    "LICENSE",
     "*.node"
   ],
   "napi": {
     "name": "fusion-node",
     "triples": {
-      "defaults": true,
+      "defaults": false,
       "additional": [
+        "x86_64-unknown-linux-gnu",
         "aarch64-unknown-linux-gnu",
+        "x86_64-pc-windows-msvc",
         "aarch64-apple-darwin"
       ]
     }
@@ -55,7 +63,7 @@
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
-    "prepublishOnly": "napi prepublish -t npm --skip-gh-release"
+    "prepublishOnly": "node -e \"const fs=require('fs');const ok=fs.readdirSync('.').some(f=>f.endsWith('.node'));if(!ok){console.error('Missing native .node binaries before publish');process.exit(1)}\""
   },
   "publishConfig": {
     "access": "public",
@@ -63,16 +71,14 @@
     "provenance": true
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
   "devDependencies": {
     "@napi-rs/cli": "^2.18.4"
-  },
-  "optionalDependencies": {
-    "fusion-framework-win32-x64-msvc": "1.1.2",
-    "fusion-framework-darwin-x64": "1.1.2",
-    "fusion-framework-linux-x64-gnu": "1.1.2",
-    "fusion-framework-linux-arm64-gnu": "1.1.2",
-    "fusion-framework-darwin-arm64": "1.1.2"
   }
-}
+}