@marko/run 0.0.1-beta5 → 0.0.1-beta7

package/README.md

@@ -1,3 +1,6 @@
+> **Warning**
+> This project is in BETA - use at your own peril, but please do provide helpful feedback.
+
 <div align="center">
   <!-- Logo -->
   <h1>
@@ -51,9 +54,9 @@ The package provides a command line tool `marko-run` which can be run using scri
 > npx marko-run build
 ```
 
-**`preview`** - Create a production build and serve
+**`serve`** - Create a production build and serve
 ```bash
-> npx marko-run preview
+> npx marko-run serve
 ```
 or (default command)
 ```bash
@@ -76,38 +79,30 @@ export default defineConfig({
 
 ## Adapters
 
-*🎗 TODO: provide a quick overview*
+<!-- TODO: link to existing adapters>
+
+<!-- *🎗 TODO: provide a quick overview* -->
 
 ## Runtime
 
 Generally, when using an adapter, this runtime will be abstracted away.
 
+<!-- TODO: Add examples -->
+<!-- TODO: Split fetch and match + invoke in two sections and explain why you might use one or the other  -->
+
 ```ts
 import { router, matchRoute, invokeRoute } from '@marko/run/router`;
 ```
 
-### `router`
+### `fetch`
 
 ```ts
-interface RequestContext<T> {
-  url: URL;
-  method: string;
-  request: Request;
-  platform: T;
-}
-
-async function router(context: RequestContext) => Promise<Response | void>;
+async function fetch<T>(request: Request, platform: T) => Promise<Response | void>;
 ```
 
-This asynchronous function takes a context object and returns the [WHATWG `Response` object](https://fetch.spec.whatwg.org/#response-class) from executing any matched route files or undefined if the request was explicitly not handled. If no route matches the requested path, a `404` status code response will be returned. If an error occurs a `500` status code response will be returned.
+This asynchronous function takes a [WHATWG `Request` object](https://fetch.spec.whatwg.org/#request-class) object and an object containing any platform specific data you may want access to and returns the [WHATWG `Response` object](https://fetch.spec.whatwg.org/#response-class) from executing any matched route files or undefined if the request was explicitly not handled. If no route matches the requested path, a `404` status code response will be returned. If an error occurs a `500` status code response will be returned.
 
-The context object contains the following properties
-- `url`: The URL reprensting the requested resource
-- `method`: The HTTP method used
-- `request`: [WHATWG `Request` object](https://fetch.spec.whatwg.org/#request-class)
-- `platform`: An object containing any platform-specific data (eg Node request/response) and will vary between adapters.
-
-### `matchRoute`
+### `match`
 
 ```ts
 interface interface Route {
@@ -115,7 +110,7 @@ interface interface Route {
   meta: unknown;
 }
 
-function matchRoute(method: string, pathname: string) => Route | null;
+function match(method: string, pathname: string) => Route | null;
 ```
 
 This synchronous function takes an HTTP method and path name, then returns an object representing the best match — or `null` if no match is found.
@@ -123,20 +118,20 @@ This synchronous function takes an HTTP method and path name, then returns an ob
 - `params` - a `{ key: value }` collection of any path parameters for the route
 - `meta` - metadata for the route
 
-### `invokeRoute`
+### `invoke`
 
 ```ts
-function invokeRoute(route: Route, context: RequestContext) => Promise<Response | void>;
+async function invoke<T>(route: Route, request: Request, platform: T) => Promise<Response | void>;
 ```
-This asynchronous function takes a route object returned by [matchRoute](#matchRoute) and a context object and returns a response in the same way the [router](#router) does.
+This asynchronous function takes a route object returned by [match](#match) the request and platform data and returns a response in the same way the [fetch](#fetch) does.
 
 
 
 ## File-based Routing
 
-### Nested Routing
+<!-- ### Nested Routing
 
-*🎗 TODO: provide a quick overview*
+*🎗 TODO: provide a quick overview* -->
 
 ### Routes Directory
 
@@ -276,6 +271,8 @@ Responses with this page will have a `500` status code.
 
 ### Execution Order
 
+<!-- TODO: add file tree and update flow-chart with file names -->
+
 For a matched route, the routable files execute in the following order:
 
 1. Middlewares from root-most to leaf-most
@@ -315,16 +312,15 @@ Within the _routes directory_, the directory structure will determine the path t
   /projects
   ```
 
-2. **Pathless directories** - These directories do **not** contribute their name to the route's served path. Directory names that start with an underscore (`_`) or directories named `index` will be a pathless directory.
+2. **Pathless directories** - These directories do **not** contribute their name to the route's served path. Directory names that start with an underscore (`_`) will be a pathless directory.
 
   Examples:
   ```
   /_users
   /_public
-  /index
   ```
 
-3. **Dynamic directories** - These directories introduce a dynamic parameter to the route's served path and will match any value at that segment. Any directory name that starts with a single dollar sign (`$`) will be a dynamic directory, and the remaining directory name will be the parameter at runtime. If the directory name is exactly `$/`, the parameter will not exist at runtime but will be matched.
+3. **Dynamic directories** - These directories introduce a dynamic parameter to the route's served path and will match any value at that segment. Any directory name that starts with a single dollar sign (`$`) will be a dynamic directory, and the remaining directory name will be the parameter at runtime. If the directory name is exactly `$`, the parameter will not be captured but it will be matched.
 
   Examples:
   ```
@@ -333,7 +329,7 @@ Within the _routes directory_, the directory structure will determine the path t
   /$
   ```
 
-4. **Catch-all directories** - These directories are similar to dynamic directories and introduce a dynamic parameter, but instead of matching a single path segment, they match to the end of the path. Any directory that starts with two dollar signs (`$$`) will be a catch-all directory, and the remaining directory name will be the parameter at runtime. In the case of a directory named `$$/`, the parameter name at runtime will be `*`. Catch-all directories can be used to make `404` Not Found routes at any level, including the root.
+4. **Catch-all directories** - These directories are similar to dynamic directories and introduce a dynamic parameter, but instead of matching a single path segment, they match to the end of the path. Any directory that starts with two dollar signs (`$$`) will be a catch-all directory, and the remaining directory name will be the parameter at runtime. In the case of a directory named `$$`, the parameter name will not be captured but it will match. Catch-all directories can be used to make `404` Not Found routes at any level, including the root.
 
   Because catch-all directories match any path segment and consume the rest of the path, you cannot nest route files in them and no further directories will be traversed.
 
@@ -344,6 +340,10 @@ Within the _routes directory_, the directory structure will determine the path t
   /$$
   ```
 
-### Match Ranking
+<!-- ### Match Ranking
+
+*TODO: Write some things* -->
+
+
+## TypeScript
 
-*TODO: Write some things*

package/dist/adapter/default-entry.mjs

@@ -1,17 +1,20 @@
 import createStaticServe from "serve-static";
 import compression from "compression";
 import { createServer } from "http";
-import createMiddleware from "@marko/run/adapter/middleware";
-import { router } from "@marko/run/router";
+import { createMiddleware } from "@marko/run/adapter/middleware";
+import { fetch } from "@marko/run/router";
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const { PORT = 3456 } = process.env;
 
-const dir = process.cwd();
-const middleware = createMiddleware(router);
+const middleware = createMiddleware(fetch);
 const compress = compression({
   threshold: 500,
 });
-const staticServe = createStaticServe(dir, {
+const staticServe = createStaticServe(__dirname, {
   index: false,
   immutable: true,
   maxAge: "365 days",

package/dist/adapter/index.cjs

@@ -37,15 +37,35 @@ var import_url = require("url");
 // src/adapter/dev-server.ts
 var import_vite = require("vite");
 
-// src/adapter/middleware.ts
-var webStream = __toESM(require("stream/web"), 1);
-var import_crypto = __toESM(require("@hattip/polyfills/crypto"), 1);
-(0, import_crypto.default)();
-for (const key of Object.keys(webStream)) {
-  if (!(key in global)) {
-    global[key] = webStream[key];
+// src/adapter/polyfill.ts
+var import_web = require("stream/web");
+var import_crypto = require("crypto");
+var import_undici = require("undici");
+var globals = {
+  crypto: import_crypto.webcrypto,
+  fetch: import_undici.fetch,
+  Response: import_undici.Response,
+  Request: import_undici.Request,
+  Headers: import_undici.Headers,
+  ReadableStream: import_web.ReadableStream,
+  TransformStream: import_web.TransformStream,
+  WritableStream: import_web.WritableStream,
+  FormData: import_undici.FormData,
+  File: import_undici.File
+};
+function installPolyfills() {
+  for (const name in globals) {
+    Object.defineProperty(globalThis, name, {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: globals[name]
+    });
   }
 }
+
+// src/adapter/middleware.ts
+installPolyfills();
 function getForwardedHeader(req, name) {
   const value = req.headers["x-forwarded-" + name];
   if (value) {
@@ -74,7 +94,7 @@ function getOrigin(req, protocol, host, trustProxy) {
   }
   return `${protocol}://${host}`;
 }
-function createMiddleware(router, options = {}) {
+function createMiddleware(fetch2, options = {}) {
   const { trustProxy = process.env.TRUST_PROXY === "1" } = options;
   let { origin = process.env.ORIGIN } = options;
   let protocol;
@@ -87,45 +107,28 @@ function createMiddleware(router, options = {}) {
     origin ?? (origin = getOrigin(req, protocol, host, trustProxy));
     const url = new URL(req.url, origin);
     const ip = req.ip || trustProxy && getForwardedHeader(req, "for") || req.socket.remoteAddress || "";
-    const requestContext = {
+    const headers = req.headers;
+    const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
+      start(controller) {
+        req.on("data", (chunk) => controller.enqueue(chunk));
+        req.on("end", () => controller.close());
+        req.on("error", (err) => controller.error(err));
+      }
+    });
+    const request = new Request(url, {
       method: req.method,
-      url,
-      platform: {
-        ip,
-        request: req,
-        response: res,
-        setCookie(cookie) {
-          res.appendHeader("set-cookie", cookie);
-        }
+      headers,
+      body,
+      duplex: "half"
+    });
+    const response = await fetch2(request, {
+      ip,
+      request: req,
+      response: res,
+      setCookie(cookie) {
+        res.appendHeader("set-cookie", cookie);
       }
-    };
-    Object.defineProperty(requestContext, "request", {
-      get() {
-        const headers = req.headers;
-        const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
-          start(controller) {
-            req.on("data", (chunk) => controller.enqueue(chunk));
-            req.on("end", () => controller.close());
-            req.on("error", (err) => controller.error(err));
-          }
-        });
-        const request = new Request(url, {
-          method: req.method,
-          headers,
-          body,
-          duplex: "half"
-        });
-        Object.defineProperty(this, "request", {
-          value: request,
-          enumerable: true,
-          configurable: true
-        });
-        return request;
-      },
-      enumerable: true,
-      configurable: true
     });
-    const response = await router(requestContext);
     if (!response) {
       if (next) {
         next();
@@ -230,8 +233,8 @@ async function createDevServer(configFile) {
   });
   const middleware = createViteDevMiddleware(
     devServer,
-    async () => (await devServer.ssrLoadModule("@marko/run/router")).router,
-    createMiddleware
+    async () => await devServer.ssrLoadModule("@marko/run/router"),
+    (module2) => createMiddleware(module2.fetch)
   );
   return devServer.middlewares.use(middleware);
 }
@@ -327,8 +330,8 @@ function adapter() {
         });
       });
     },
-    async startPreview(dir, entry, port, envFile) {
-      const server = await spawnServer(`node ${entry}`, port, envFile, dir);
+    async startPreview(_dir, entry, port, envFile) {
+      const server = await spawnServer(`node ${entry}`, port, envFile);
       console.log(`Preview server started: http://localhost:${server.port}`);
     }
   };

package/dist/adapter/index.js

@@ -5,15 +5,35 @@ import { fileURLToPath } from "url";
 // src/adapter/dev-server.ts
 import { createServer } from "vite";
 
-// src/adapter/middleware.ts
-import * as webStream from "stream/web";
-import installCrypto from "@hattip/polyfills/crypto";
-installCrypto();
-for (const key of Object.keys(webStream)) {
-  if (!(key in global)) {
-    global[key] = webStream[key];
+// src/adapter/polyfill.ts
+import { ReadableStream as ReadableStream2, TransformStream, WritableStream } from "stream/web";
+import { webcrypto as crypto } from "crypto";
+import { fetch, Response, Request as Request2, Headers, FormData, File } from "undici";
+var globals = {
+  crypto,
+  fetch,
+  Response,
+  Request: Request2,
+  Headers,
+  ReadableStream: ReadableStream2,
+  TransformStream,
+  WritableStream,
+  FormData,
+  File
+};
+function installPolyfills() {
+  for (const name in globals) {
+    Object.defineProperty(globalThis, name, {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: globals[name]
+    });
   }
 }
+
+// src/adapter/middleware.ts
+installPolyfills();
 function getForwardedHeader(req, name) {
   const value = req.headers["x-forwarded-" + name];
   if (value) {
@@ -42,7 +62,7 @@ function getOrigin(req, protocol, host, trustProxy) {
   }
   return `${protocol}://${host}`;
 }
-function createMiddleware(router, options = {}) {
+function createMiddleware(fetch2, options = {}) {
   const { trustProxy = process.env.TRUST_PROXY === "1" } = options;
   let { origin = process.env.ORIGIN } = options;
   let protocol;
@@ -55,45 +75,28 @@ function createMiddleware(router, options = {}) {
     origin ?? (origin = getOrigin(req, protocol, host, trustProxy));
     const url = new URL(req.url, origin);
     const ip = req.ip || trustProxy && getForwardedHeader(req, "for") || req.socket.remoteAddress || "";
-    const requestContext = {
+    const headers = req.headers;
+    const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
+      start(controller) {
+        req.on("data", (chunk) => controller.enqueue(chunk));
+        req.on("end", () => controller.close());
+        req.on("error", (err) => controller.error(err));
+      }
+    });
+    const request = new Request(url, {
       method: req.method,
-      url,
-      platform: {
-        ip,
-        request: req,
-        response: res,
-        setCookie(cookie) {
-          res.appendHeader("set-cookie", cookie);
-        }
+      headers,
+      body,
+      duplex: "half"
+    });
+    const response = await fetch2(request, {
+      ip,
+      request: req,
+      response: res,
+      setCookie(cookie) {
+        res.appendHeader("set-cookie", cookie);
       }
-    };
-    Object.defineProperty(requestContext, "request", {
-      get() {
-        const headers = req.headers;
-        const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
-          start(controller) {
-            req.on("data", (chunk) => controller.enqueue(chunk));
-            req.on("end", () => controller.close());
-            req.on("error", (err) => controller.error(err));
-          }
-        });
-        const request = new Request(url, {
-          method: req.method,
-          headers,
-          body,
-          duplex: "half"
-        });
-        Object.defineProperty(this, "request", {
-          value: request,
-          enumerable: true,
-          configurable: true
-        });
-        return request;
-      },
-      enumerable: true,
-      configurable: true
     });
-    const response = await router(requestContext);
     if (!response) {
       if (next) {
         next();
@@ -198,8 +201,8 @@ async function createDevServer(configFile) {
   });
   const middleware = createViteDevMiddleware(
     devServer,
-    async () => (await devServer.ssrLoadModule("@marko/run/router")).router,
-    createMiddleware
+    async () => await devServer.ssrLoadModule("@marko/run/router"),
+    (module) => createMiddleware(module.fetch)
   );
   return devServer.middlewares.use(middleware);
 }
@@ -294,8 +297,8 @@ function adapter() {
         });
       });
     },
-    async startPreview(dir, entry, port, envFile) {
-      const server = await spawnServer(`node ${entry}`, port, envFile, dir);
+    async startPreview(_dir, entry, port, envFile) {
+      const server = await spawnServer(`node ${entry}`, port, envFile);
       console.log(`Preview server started: http://localhost:${server.port}`);
     }
   };

package/dist/adapter/middleware.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,27 +15,45 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/adapter/middleware.ts
 var middleware_exports = {};
 __export(middleware_exports, {
-  default: () => createMiddleware,
+  createMiddleware: () => createMiddleware,
   getOrigin: () => getOrigin
 });
 module.exports = __toCommonJS(middleware_exports);
-var webStream = __toESM(require("stream/web"), 1);
-var import_crypto = __toESM(require("@hattip/polyfills/crypto"), 1);
-(0, import_crypto.default)();
-for (const key of Object.keys(webStream)) {
-  if (!(key in global)) {
-    global[key] = webStream[key];
+
+// src/adapter/polyfill.ts
+var import_web = require("stream/web");
+var import_crypto = require("crypto");
+var import_undici = require("undici");
+var globals = {
+  crypto: import_crypto.webcrypto,
+  fetch: import_undici.fetch,
+  Response: import_undici.Response,
+  Request: import_undici.Request,
+  Headers: import_undici.Headers,
+  ReadableStream: import_web.ReadableStream,
+  TransformStream: import_web.TransformStream,
+  WritableStream: import_web.WritableStream,
+  FormData: import_undici.FormData,
+  File: import_undici.File
+};
+function installPolyfills() {
+  for (const name in globals) {
+    Object.defineProperty(globalThis, name, {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: globals[name]
+    });
   }
 }
+
+// src/adapter/middleware.ts
+installPolyfills();
 function getForwardedHeader(req, name) {
   const value = req.headers["x-forwarded-" + name];
   if (value) {
@@ -66,7 +82,7 @@ function getOrigin(req, protocol, host, trustProxy) {
   }
   return `${protocol}://${host}`;
 }
-function createMiddleware(router, options = {}) {
+function createMiddleware(fetch2, options = {}) {
   const { trustProxy = process.env.TRUST_PROXY === "1" } = options;
   let { origin = process.env.ORIGIN } = options;
   let protocol;
@@ -79,45 +95,28 @@ function createMiddleware(router, options = {}) {
     origin ?? (origin = getOrigin(req, protocol, host, trustProxy));
     const url = new URL(req.url, origin);
     const ip = req.ip || trustProxy && getForwardedHeader(req, "for") || req.socket.remoteAddress || "";
-    const requestContext = {
+    const headers = req.headers;
+    const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
+      start(controller) {
+        req.on("data", (chunk) => controller.enqueue(chunk));
+        req.on("end", () => controller.close());
+        req.on("error", (err) => controller.error(err));
+      }
+    });
+    const request = new Request(url, {
       method: req.method,
-      url,
-      platform: {
-        ip,
-        request: req,
-        response: res,
-        setCookie(cookie) {
-          res.appendHeader("set-cookie", cookie);
-        }
+      headers,
+      body,
+      duplex: "half"
+    });
+    const response = await fetch2(request, {
+      ip,
+      request: req,
+      response: res,
+      setCookie(cookie) {
+        res.appendHeader("set-cookie", cookie);
       }
-    };
-    Object.defineProperty(requestContext, "request", {
-      get() {
-        const headers = req.headers;
-        const body = req.method === "GET" || req.method === "HEAD" ? void 0 : req.socket ? req : new ReadableStream({
-          start(controller) {
-            req.on("data", (chunk) => controller.enqueue(chunk));
-            req.on("end", () => controller.close());
-            req.on("error", (err) => controller.error(err));
-          }
-        });
-        const request = new Request(url, {
-          method: req.method,
-          headers,
-          body,
-          duplex: "half"
-        });
-        Object.defineProperty(this, "request", {
-          value: request,
-          enumerable: true,
-          configurable: true
-        });
-        return request;
-      },
-      enumerable: true,
-      configurable: true
     });
-    const response = await router(requestContext);
     if (!response) {
       if (next) {
         next();
@@ -195,5 +194,6 @@ function createMiddleware(router, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createMiddleware,
   getOrigin
 });

package/dist/adapter/middleware.d.ts

@@ -1,4 +1,4 @@
-import type { Router } from "../runtime";
+import type { Fetch } from "../runtime";
 import type { IncomingMessage, ServerResponse } from "http";
 declare module "net" {
     interface Socket {
@@ -52,4 +52,4 @@ export declare function getOrigin(req: IncomingMessage, protocol?: string, host?
  * Creates a request handler to be passed to http.createServer() or used as a
  * middleware in Connect-style frameworks like Express.
  */
-export default function createMiddleware(router: Router<NodePlatformInfo>, options?: NodeAdapterOptions): NodeMiddleware;
+export declare function createMiddleware(fetch: Fetch<NodePlatformInfo>, options?: NodeAdapterOptions): NodeMiddleware;