@server/next 0.19.0 → 0.20.1

package/index.d.ts

@@ -0,0 +1,50 @@
+type Bucket = {};
+
+type Method =
+  | "socket"
+  | "get"
+  | "head"
+  | "post"
+  | "put"
+  | "patch"
+  | "delete"
+  | "options";
+
+type ServerOptions = {
+  port?: number;
+  views?: string | Bucket;
+  public?: string | Bucket;
+  uploads?: string | Bucket;
+};
+
+type Context = {
+  method: Method;
+  headers: { [key: string]: string | string[] };
+  cookies: { [key: string]: any };
+  body?: any;
+  url: URL & { params: {}; query: {} };
+  options: ServerOptions;
+};
+
+type Middleware = (ctx: Context) => any;
+
+type Router = {};
+
+declare interface Server {
+  (options?: ServerOptions): this;
+
+  socket(path: string, ...middleware: Middleware[]): this;
+  get(path: string, ...middleware: Middleware[]): this;
+  head(path: string, ...middleware: Middleware[]): this;
+  post(path: string, ...middleware: Middleware[]): this;
+  put(path: string, ...middleware: Middleware[]): this;
+  patch(path: string, ...middleware: Middleware[]): this;
+  del(path: string, ...middleware: Middleware[]): this;
+  options(path: string, ...middleware: Middleware[]): this;
+
+  use(...middleware: Middleware[]): this;
+  router(router: Router): this;
+}
+
+declare const server: Server;
+export default server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@server/next",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "description": "An experimental reimplementation of server.js focused on the DX",
   "homepage": "https://node-server.com/",
   "repository": "https://github.com/franciscop/server-next.git",
@@ -10,9 +10,7 @@
   "license": "UNLICENSED",
   "scripts": {
     "demo": "nodemon ./demo/app.js",
-    "build": "bun build src/index.js --outdir ./ --entry-naming server.js",
     "start": "bun test --watch",
-    "size": "echo \"$(gzip -c server.js | wc -c) bytes\" # Only for Unix",
     "test": "bun test"
   },
   "keywords": [
@@ -21,9 +19,11 @@
     "server.js"
   ],
   "type": "module",
+  "types": "index.d.ts",
   "main": "src/index.js",
   "files": [
-    "src/"
+    "src/",
+    "index.d.ts"
   ],
   "engines": {
     "node": ">=20.0.0"

package/readme.md

@@ -1,6 +1,8 @@
 # Server @ Next
 
-> **EXPERIMENTAL LIBRARY**
+> **⚠️ WIP** This is an **experimental library** right now!
+
+[**Documentation Here**](https://node-server.com/documentation/)
 
 A fully-fledged web server for Bun and Node.js, with all the basics covered for you:
 
@@ -9,26 +11,26 @@ import server from "@server/next";
 
 // Create a running instance of the server
 export default server(options)
-  .router("/admin/", dashboard)
-  .get("/users", getUsers)
-  .post("/users", createUser)
-  .put("/users/:id", editUser);
+  .get("/books", () => Book.list())
+  .post("/books", { body: BookSchema }, (ctx) => {
+    return Book.create(ctx.body).save();
+  });
 ```
 
-It includes all the things you would expect from a modern Server framework, like routing, static file serving, options\*, body+file parsing, gzip+brotli, streaming, server-timing, plugins\*, etc.
-
-> \* not yet available
+It includes all the things you would expect from a modern Server framework, like routing, static file serving, body+file parsing, gzip+brotli, streaming, testing, error handling, websockets, etc. We also have integrations with these:
 
-For testing it's also easy, since we are exporting our server throught the WinterCG API we can do:
+- KV Stores: in-memory, Redis, Consul, DynamoDB.
+- Buckets: AWS S3, Cloudflare R2, Backblaze B2.
+- Validation libraries: Zod, Joi, Yup.
 
 ```js
-// index.test.js
+// Easy testing as well - index.test.js
 import app from "./";
 
 it("can retrieve the homepage", async () => {
-  const res = await app.fetch(new Request("http://localhost:3000/hello/"));
-  const data = await res.text();
-  expect(data).toBe("Hello world");
+  const res = await app.fetch(new Request("http://localhost:3000/books/"));
+  const books = await res.json();
+  expect(books[0]).toEqual({ id: 0, name: 'The Catcher In The Rye', ... });
 });
 ```
 
@@ -43,18 +45,10 @@ Why? We live in the era of multi-cloud (Heroku, Workers, Lambda, etc) and multi-
 - Changed the reply logic greatly, including the removal of `render()`. This is the main reason express was removed. Many servers don't need render() at all.
 - **[security]** Removed mandatory CSRF token, since this is only useful for server-rendered pages and not for SPA. Now we provide an `auth` module instead.
 
-Major changes:
-
-- New fully fledged `ctx.url` that extends [`URL`](https://developer.mozilla.org/en-US/docs/Web/API/URL) object inside `ctx` (also note: `ctx.url` is no longer a string):
-  - `ctx.params` is now `ctx.url.params`, e.g. `ctx.url.params.id`.
-  - `ctx.query` is now `ctx.url.query`, e.g. `ctx.url.query.search`.
-  - `ctx.path` is now `ctx.url.path` (or `ctx.url.pathname`).
-  - All URL properties are available, like `ctx.url.port`, `ctx.url.searchParams`, etc.
-
 ## Progress
 
 - Router has all verbs, as well as URL pattern matches
-- Full URL parsing, including `query` and `params` in ctx.url.
+- Full URL parsing, including `query` and `params` in `ctx.url`.
 - Body and Files parsing is working (need testing)
 - The middleware can return:
   - A number and it'll be set as the status code
@@ -63,42 +57,6 @@ Major changes:
   - An object with `status`, `body` and `headers` and it'll be set raw.
 - Response compression works
 
-## Some plugins
-
-> This question is just some concepts/ideas
-
-Plugins? Or internals?
-
-```js
-import Bucket from 'bucket/s3';
-import Redis from 'redis';
-
-const bucket = Bucket('my-bucket', { id, key });
-const cache = Redis('my-redis', ...);
-
-const app = server({ public: bucket, uploads: bucket, cache });
-
-app([
-  post('/uploads', ctx => {
-    // Without { public: bucket }, it'd be a local file in the filesystem
-    console.log(ctx.files.profile);
-    // file.name
-    // file.id
-    // file.path
-    // file.type
-    // file.size
-
-    // With { public: bucket }, it's the reference to the bucket file
-    console.log(ctx.files.profile);
-    // file.name
-    // file.id
-    // file.path
-    // file.type
-    // file.size
-  })
-]);
-```
-
 ## Examples
 
 ### Streams
@@ -156,58 +114,3 @@ export default server()
     return 201;
   });
 ```
-
-```js
-import server, { jwtAuth } from "server";
-import BookRouter from "./BookRouter";
-import UserRouter from "./UserRouter";
-
-export default server({ port: 3000 })
-  .use(jwtAuth)
-  .route("/users", UserRouter)
-  .route("/books", BookRouter);
-```
-
-```js
-// UserRouter.js -> A custom router
-import server, { router } from "server";
-
-export default router()
-  .get("/", getUsers)
-  .get("/:id", getUser)
-  .post("/", createUser);
-```
-
-MAYBE?
-
-```js
-// BookRouter.js -> a REST API router
-import { RestRouter } from "server";
-
-export default class BookRouter extends RestRouter {
-  async create(ctx) {
-    // POST /
-  }
-  async list(ctx) {
-    // GET /
-  }
-  async get(ctx) {
-    // GET /:id
-  }
-  async search(ctx) {
-    // GET /?...
-  }
-  async update(ctx) {
-    // PUT /:id
-  }
-  async set(ctx) {
-    // PATCH /:id
-  }
-  async delete(ctx) {
-    // DELETE /:id
-  }
-  async error(ctx) {
-    // ctx.error
-  }
-}
-```

package/src/bucket.js

@@ -21,7 +21,6 @@ export default function (root) {
     path: root,
     read: (name, type = "utf8") => {
       const fullPath = absolute(name);
-      console.log(name, fullPath);
       return fsp.readFile(fullPath, type);
     },
     write: (name, value, type = "utf8") => {

package/src/context/node.js

@@ -20,10 +20,23 @@ export default async (request, options = {}) => {
     Object.fromEntries(url.searchParams.entries())
   );
 
-  if (request.body) {
-    const type = ctx.headers["content-type"];
-    ctx.body = await parseBody(request, type, options.uploads);
-  }
+  await new Promise((resolve, reject) => {
+    const body = [];
+    request
+      .on("data", (chunk) => {
+        body.push(chunk);
+      })
+      .on("end", async () => {
+        const type = ctx.headers["content-type"];
+        ctx.body = await parseBody(
+          Buffer.concat(body).toString(),
+          type,
+          options.uploads
+        );
+        resolve();
+      })
+      .on("error", reject);
+  });
 
   return ctx;
 };

package/src/helpers/StatusError.js

@@ -0,0 +1,6 @@
+export default class StatusError extends Error {
+  constructor(msg, status = 500) {
+    super(msg);
+    this.status = status;
+  }
+}

package/src/helpers/handleRequest.js

@@ -1,6 +1,7 @@
 import parseResponse from "../parseResponse.js";
 import pathPattern from "../pathPattern.js";
 import define from "./define.js";
+import validate from "./validate.js";
 
 export default async function handleRequest(handlers, ctx) {
   for (let [matcher, ...cbs] of handlers[ctx.method]) {
@@ -11,10 +12,17 @@ export default async function handleRequest(handlers, ctx) {
     define(ctx.url, "params", () => match);
 
     for (let cb of cbs) {
-      const out = await parseResponse(cb, ctx);
-      if (out) return out;
+      try {
+        validate(ctx, cb);
+        if (typeof cb === "function") {
+          const out = await parseResponse(cb, ctx);
+          if (out) return out;
+        }
+      } catch (error) {
+        return new Response(error.message, { status: error.status || 500 });
+      }
     }
   }
 
-  return Response("Not Found", { status: 404 });
+  return new Response("Not Found", { status: 404 });
 }

package/src/helpers/validate.js

@@ -0,0 +1,35 @@
+import StatusError from "./StatusError.js";
+
+export default function (ctx, schema) {
+  if (!schema || typeof schema !== "object") return;
+
+  let base;
+  try {
+    if (typeof schema?.body === "function") {
+      base = "body";
+      schema.body(ctx.body || {});
+    }
+    if (typeof schema?.body?.parse === "function") {
+      base = "body";
+      schema.body.parse(ctx.body || {});
+    }
+    if (typeof schema?.query === "function") {
+      base = "query";
+      schema.query(ctx.url.query || {});
+    }
+    if (typeof schema?.query?.parse === "function") {
+      base = "query";
+      schema.query.parse(ctx.url.query || {});
+    }
+  } catch (error) {
+    if (error.constructor.name === "ZodError") {
+      console.log(error);
+      const message = error.issues
+        .map(({ path, message }) => `[${base}.${path.join(".")}]: ${message}`)
+        .sort()
+        .join("\n");
+      throw new StatusError(message, 422);
+    }
+    throw error;
+  }
+}

package/src/index.js

@@ -21,6 +21,8 @@ export default function server(options = {}) {
 
   this.handlers = {};
 
+  options.port = options.port || process.env.PORT || 3000;
+
   options.views = options.views ? Bucket(options.views) : null;
   options.public = options.public ? Bucket(options.public) : null;
   options.uploads = options.uploads ? Bucket(options.uploads) : null;
@@ -64,7 +66,7 @@ export default function server(options = {}) {
   this.fetch = async (request, env, fetchCtx) => {
     if (env?.upgrade(request)) return;
 
-    const ctx = await createWinterContext(request, options);
+    const ctx = await createWinterContext(request, options, this.platform);
     ctx.platform = this.platform;
 
     return await handleRequest(this.handlers, ctx);

package/src/index.test.js

@@ -1,21 +1,37 @@
 import server, { status } from "./index.js";
 
-describe("server", () => {
+describe("return different types", () => {
   const app = server()
     .get("/", () => "Hello world")
     .get("/text", () => "Hello world")
     .get("/array", () => ["Hello world"])
     .get("/object", () => ({ hello: "world" }))
-    .get("/status", () => 201)
-    .post("/", (ctx) => status(201).send(ctx.body));
+    .get("/status", () => 201);
 
-  it("can render hello world", async () => {
-    const res = await app.fetch(new Request("http://localhost:3000/"));
-
-    expect(res.status).toBe(200);
+  it("can get the plain text", async () => {
+    const res = await app.fetch(new Request("http://localhost:3000/text"));
     expect(await res.text()).toBe("Hello world");
   });
 
+  it("can get the array", async () => {
+    const res = await app.fetch(new Request("http://localhost:3000/array"));
+    expect(await res.json()).toEqual(["Hello world"]);
+  });
+
+  it("can get the object", async () => {
+    const res = await app.fetch(new Request("http://localhost:3000/object"));
+    expect(await res.json()).toEqual({ hello: "world" });
+  });
+
+  it("can get the status", async () => {
+    const res = await app.fetch(new Request("http://localhost:3000/status"));
+    expect(res.status).toBe(201);
+  });
+});
+
+describe("simple post works", () => {
+  const app = server().post("/", (ctx) => status(201).send(ctx.body));
+
   it("can post new data", async () => {
     const res = await app.fetch(
       new Request("http://localhost:3000/", {
@@ -41,5 +57,3 @@ describe("server", () => {
     expect(await res.json()).toEqual({ hello: "world" });
   });
 });
-
-describe("all the replies", () => {});

package/src/reply.js

@@ -64,7 +64,6 @@ Reply.prototype.file = async function (path) {
 
 Reply.prototype.view = async function (path) {
   return async (ctx) => {
-    console.log(ctx);
     if (!ctx.options.views) {
       throw new Error("Views not enabled");
     }