express-speed 1.0.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License + Trademark Notice
+
+Copyright (c) 2026 F10tme
+
+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:
+
+1. The above copyright notice and this permission notice shall be included in all
+   copies or substantial portions of the Software.
+
+2. The software is provided "AS IS", without warranty of any kind.
+
+---
+
+Trademark Notice:
+
+The name "express-speed" and its logo (if any) are registered trademarks of the author.
+No one is allowed to use the "express-speed" name or logo for derivative works,
+forks, or other projects without the explicit permission of the author.

package/README.md

@@ -0,0 +1,286 @@
+# express-speed
+
+`express-speed` Express uygulamalarında route oluşturmayı daha düzenli ve zincirleme (chainable) hale getiren basit bir pager sistemidir.
+
+Amaç:
+
+- Route tanımlamayı sadeleştirmek
+- Sayfaları modüler hale getirmek
+- Middleware ve rol kontrolünü kolaylaştırmak
+- API ve sayfa route'larını aynı yapı içinde yönetmek
+
+---
+
+# Installation
+
+```bash
+npm install express-speed
+```
+
+---
+
+# Basic Usage
+
+Basit bir sayfa oluşturma:
+
+```js
+import { pager } from "express-speed";
+
+let page = pager
+  .url("/")
+  .role("user")
+  .get((req, res) => {
+    res.send("Simple Page");
+  })
+  .build();
+
+export default page;
+```
+
+---
+
+# Multiple GET Handlers
+
+Aynı route içinde birden fazla handler tanımlayabilirsin.
+
+```js
+import { pager } from "express-speed";
+
+export default pager
+  .url("/example")
+  .get((req, res, next) => {
+    console.log("first handler");
+    next();
+  })
+  .get((req, res) => {
+    res.send("final response");
+  })
+  .build();
+```
+
+Bu yapı Express middleware mantığıyla çalışır.
+
+---
+
+# Sub Path Routes
+
+`get(path, handler)` kullanarak aynı pager içinde farklı endpointler oluşturabilirsin.
+
+```js
+import { pager } from "express-speed";
+
+export default pager
+  .url("/blog")
+
+  .get((req, res) => {
+    res.send("Blog Home");
+  })
+
+  .get("/post/:id", (req, res) => {
+    res.send(`Post ${req.params.id}`);
+  })
+
+  .get("/latest", (req, res) => {
+    res.send("Latest posts");
+  })
+
+  .build();
+```
+
+Oluşan route'lar:
+
+```
+/blog
+/blog/post/:id
+/blog/latest
+```
+
+---
+
+# Middleware Usage
+
+Pager içine middleware ekleyebilirsin.
+
+```js
+import { pager } from "express-speed";
+
+function logger(req, res, next) {
+  console.log("page visited");
+  next();
+}
+
+export default pager
+  .url("/profile")
+  .use(logger)
+  .get((req, res) => {
+    res.send("Profile page");
+  })
+  .build();
+```
+
+---
+
+# Role Based Access
+
+Role kullanarak sayfaya erişimi sınırlandırabilirsin.
+
+```js
+import { pager } from "express-speed";
+
+export default pager
+  .url("/admin")
+  .role("admin")
+  .get((req, res) => {
+    res.send("Admin Panel");
+  })
+  .build();
+```
+
+---
+
+# API Endpoint Example
+
+Pager API endpointleri için de kullanılabilir.
+
+```js
+import { pager } from "express-speed";
+
+export default pager
+  .url("/api/user")
+  .get((req, res) => {
+    res.json({
+      name: "Murat",
+      role: "user",
+    });
+  })
+  .build();
+```
+
+---
+
+# GraphQL Integration
+
+`express-speed` GraphQL endpointlerini de destekler.
+
+Bunun için projede şu paketler kurulu olmalıdır:
+
+```bash
+npm install express-graphql graphql
+```
+
+---
+
+## Basic GraphQL Example
+
+```js
+import { pager } from "express-speed";
+import { graphqlHTTP } from "express-graphql";
+import { buildSchema } from "graphql";
+
+const schema = buildSchema(`
+  type Query {
+    hello: String
+  }
+`);
+
+const root = {
+  hello: () => "Hello GraphQL",
+};
+
+export default pager
+  .url("/graphql")
+  .use(
+    graphqlHTTP({
+      schema,
+      rootValue: root,
+      graphiql: true,
+    }),
+  )
+  .build();
+```
+
+---
+
+## GraphQLObjectType Schema Example
+
+`express-speed` ayrıca klasik GraphQL schema yapısını da destekler.
+
+```js
+import { pager } from "express-speed";
+import { graphqlHTTP } from "express-graphql";
+import { GraphQLObjectType, GraphQLString, GraphQLSchema } from "graphql";
+
+const UserType = new GraphQLObjectType({
+  name: "User",
+  fields: {
+    name: { type: GraphQLString },
+    surname: { type: GraphQLString },
+  },
+});
+
+const RootQuery = new GraphQLObjectType({
+  name: "RootQueryType",
+  fields: {
+    user: {
+      type: UserType,
+      resolve() {
+        return {
+          name: "Ali",
+          surname: "Yılmaz",
+        };
+      },
+    },
+  },
+});
+
+const schema = new GraphQLSchema({
+  query: RootQuery,
+});
+
+export default pager
+  .url("/graphql")
+  .use(
+    graphqlHTTP({
+      schema: schema,
+      graphiql: true,
+    }),
+  )
+  .build();
+```
+
+---
+
+# Router Style Usage
+
+Pager küçük bir router gibi kullanılabilir.
+
+```js
+import { pager } from "express-speed";
+
+export default pager
+  .url("/api")
+
+  .get("/users", (req, res) => {
+    res.json(["user1", "user2"]);
+  })
+
+  .get("/products", (req, res) => {
+    res.json(["product1", "product2"]);
+  })
+
+  .build();
+```
+
+---
+
+# Features
+
+- Chainable route API
+- Express middleware uyumu
+- Role based access
+- Multiple route handlers
+- Sub path routing
+- GraphQL integration
+- API ve sayfa route desteği
+
+---

package/index.js

@@ -0,0 +1,4 @@
+import expressSpeed from "./src/expressSpeed.js";
+import pager from "./src/pager.js";
+
+export { expressSpeed, pager };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "express-speed",
+  "description": "A simple pager system for Express apps",
+  "version": "1.0.1",
+  "main": "index.js",
+  "type": "module",
+  "files": [
+    "src",
+    "index.js",
+    "app.js"
+  ],
+  "author": "f10tme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/f10tme/express-speed"
+  },
+  "keywords": [
+    "express",
+    "pager",
+    "routing",
+    "middleware",
+    "graphql"
+  ],
+  "dependencies": {
+    "express": "^4.22.1",
+    "fs-extra": "^11.3.3",
+    "glob": "^10.5.0"
+  }
+}

package/src/expressSpeed.js

@@ -0,0 +1,123 @@
+// * ExpressSpeed mvc yapısına uygun daha hızlı şekilde kullanılabilir formatta
+// * Sayfalara özel Rol kontrol özelliği
+// * Graphql Uyumlu
+
+import express from "express";
+import { globSync } from "glob";
+import pager from "./pager.js";
+
+let expressSpeed = {
+  app: express(),
+  config: {
+    port: 80,
+    path: {
+      page: {
+        render: [],
+        exclude: [],
+        nodir: true,
+      },
+    },
+    use: [],
+    settings: {},
+  },
+  trigger: {
+    start: {
+    },
+    end: {
+    }
+  },
+  complier: {
+    pagesMap(renderPathArrayValue, pageExcludeArrayValue, nodirBooleanValue) {
+      const pageFiles = renderPathArrayValue.flatMap((pathValue) =>
+        globSync(pathValue, {
+          nodir: nodirBooleanValue || true,
+          ignore: pageExcludeArrayValue,
+        })
+          .map((e) => "file:///" + process.cwd().replaceAll("\\", "/") + "/" + e.replaceAll("\\", "/"))
+      );
+      return pageFiles;
+    },
+    async pagesImport(pagePathArrayValue) {
+      const pages = await Promise.all(pagePathArrayValue.map(async (pathValue) => {
+        if (pathValue) {
+          let page = (await import(pathValue)).default;
+          if (page) {
+            page._path = pathValue;
+            return page;
+          } else console.log("@ERROR", pathValue);
+        }
+      }));
+      return pages;
+    },
+    pageRender(pageObjectValue) {
+      if (!pageObjectValue) {
+        return false;
+      }
+      const app = expressSpeed.app;
+      for (const router of pageObjectValue.methods) {
+        let parameters = ("string" == typeof router.parameters[0]) ? [...router.parameters] : [router.url, ...router.parameters];
+        switch (router.method.toString().toLowerCase()) {
+          case "use":
+            app.use(...parameters);
+            break;
+          case "all":
+            app.all(...parameters);
+            break;
+          case "param":
+            app.param(...parameters);
+            break;
+          case "get":
+            app.get(...parameters);
+            break;
+          case "post":
+            app.post(...parameters);
+            break;
+          case "put":
+            app.put(...parameters);
+            break;
+          case "delete":
+            app.delete(...parameters);
+            break;
+
+          default:
+            break;
+        }
+      }
+    },
+    async load() {
+      for (const useValue of expressSpeed.config.use) expressSpeed.app.use(useValue);
+      for (let [setKey, setValue] of Object.entries(expressSpeed.config.settings)) expressSpeed.app.set(setKey, setValue);
+      let pagesMap = expressSpeed.complier.pagesMap(expressSpeed.config.path.page.render, expressSpeed.config.path.page.exclude);
+      let pages = await expressSpeed.complier.pagesImport(pagesMap);
+      for (let page of pages) expressSpeed.complier.pageRender(page);
+    }
+  },
+  async listen(port = 80, config = {
+    port: null,
+    page: {},
+    use: [],
+    usings: [],
+    settings: {},
+    go: null,
+  }) {
+    if (typeof config.go == "function") config.go(expressSpeed);
+    config.port = port;
+    console.log(typeof config);
+    if (typeof config == "object") {
+    }
+      expressSpeed.config.path.page = {
+        ...expressSpeed.config.path.page,
+        ...config.page
+      } || {};
+      expressSpeed.config.port = config.port || 80;
+      expressSpeed.config.use = config.use || [];
+      expressSpeed.config.settings = config.settings || {};
+
+    expressSpeed.complier.load();
+    expressSpeed.app.listen(expressSpeed.config.port);
+  },
+}
+
+expressSpeed.pager = pager;
+
+export default expressSpeed;

package/src/pager.js

@@ -0,0 +1,126 @@
+// * Sayfa yapısını oluşturan obje haline getiren zincir fonksiyonlar
+
+const pager = {
+    _id: 0,
+    _config: {
+        url: null,
+        role: null,
+        usings: null,
+        methods: [],
+        // method: {
+        //     use: null,
+        //     all: null,
+        //     param: null,
+        //     get: null,
+        //     post: null,
+        //     put: null,
+        //     delete: null,
+        // },
+        render: null,
+        renderConfig: null,
+    },
+    url(urlStringValue) {
+        pager._config.url = urlStringValue;
+        return pager;
+    },
+    role(roleStringAndArrayValue) {
+        pager._config.role = roleStringAndArrayValue;
+        return pager;
+    },
+    usings(usingsArrayValue) {
+        pager._config.usings = usingsArrayValue;
+        return pager;
+    },
+    use(...useVariableValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "use",
+            parameters: [...useVariableValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    param(...paramVariableValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "param",
+            parameters: [...paramVariableValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    all(...allFunctionValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "all",
+            parameters: [...allFunctionValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    get(...getFunctionValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "get",
+            parameters: [...getFunctionValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    post(...postFunctionValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "post",
+            parameters: [...postFunctionValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    put(...putFunctionValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "put",
+            parameters: [...putFunctionValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    delete(...deleteFunctionValue) {
+        pager._config.methods.push({
+            url: pager._config.url,
+            method: "delete",
+            parameters: [...deleteFunctionValue],
+        });
+        // ? delete pager.url;
+        return pager;
+    },
+    // render(renderStringValue, renderObjectConfiguration = {}) {
+    //     pager._config.render = renderStringValue;
+    //     pager._config.renderConfig = renderObjectConfiguration;
+    //     return pager;
+    // },
+    build() {
+        const data = { ...pager._config }
+        pager._config = {
+            url: null,
+            role: null,
+            usings: [],
+            settings: [],
+            methods: [],
+            // method: {
+            //     use: null,
+            //     all: null,
+            //     param: null,
+            //     get: null,
+            //     post: null,
+            //     put: null,
+            //     delete: null,
+            // },
+            render: null,
+            renderConfig: null,
+        };
+        return data;
+    },
+}
+
+export default pager;