fulmine.js 5.0.0-rc.1

package/src/index.js

@@ -0,0 +1,71 @@
+/*
+Copyright 2024 dimden.dev
+Copyright 2026 Nigro Simone
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// H3App, DeclarativeResponse and _cfg all exist at runtime but are missing from the
+// declaration file the package ships, so the module is read through a loose alias
+const uWS = require("uWebSockets.js");
+const uWSAny = /** @type {any} */ (uWS);
+const Application = require("./application.js");
+const Router = require("./router.js");
+const middlewares = require("./middlewares.js");
+const Request = require("./request.js");
+const Response = require("./response.js");
+
+try {
+    // disable Uwebsockets header
+    uWSAny._cfg("999999990007");
+} catch (error) {
+    // older uWS builds do not expose _cfg; there is nothing to fall back to
+}
+
+// The factory doubles as a namespace, as in Express: Router, static and the body parsers hang off
+// the function that creates an app.
+//
+// Written as `module.exports.name = ...` and never through an alias: cjs-module-lexer reads this
+// file as text to decide which named exports an ESM importer gets, and it cannot see through one.
+// Nothing here is executed to find that out.
+/**
+ * @type {typeof Application & {
+ *   Router: Function,
+ *   request: object,
+ *   response: object,
+ *   application: object,
+ *   static: Function,
+ *   json: Function,
+ *   urlencoded: Function,
+ *   text: Function,
+ *   raw: Function
+ * }}
+ */
+module.exports = /** @type {any} */ (Application);
+
+// a router is a function too, for the same reason an app is: it has to be callable to be usable as
+// middleware
+module.exports.Router = function (options) {
+    return new Router(options)._asCallable();
+};
+
+module.exports.request = Request.prototype;
+module.exports.response = Response.prototype;
+// the third of the trio: adding a method here adds it to every app, the same as express.application
+module.exports.application = Application.Application.prototype;
+
+module.exports.static = middlewares.static;
+module.exports.json = middlewares.json;
+module.exports.urlencoded = middlewares.urlencoded;
+module.exports.text = middlewares.text;
+module.exports.raw = middlewares.raw;