@mapl/web 0.1.16 → 0.2.0-alpha.1

package/README.md

@@ -1,7 +1,8 @@
 A compiled web framework for all runtimes.
 
 ```ts
-import { router, handle, layer, compile } from '@mapl/web';
+import { router, handle, layer } from '@mapl/web';
+import { compileToHandler } from '@mapl/web/compiler/jit';
 
 const api = router.init([], [
   handle.get('/', () => 'Hi')
@@ -19,6 +20,195 @@ const app = router.init(
 );
 
 export default {
-  fetch: compile(app)
+  fetch: compileToHandler(app)
 };
 ```
+
+## AOT compilation (experimental)
+Build `@mapl/web` to improve startup time.
+
+Setup:
+```ts
+// main.ts
+import { handle, layer, router } from '@mapl/web';
+
+export default router(
+  [
+    layer.tap((c) => {
+      console.log(c.req);
+    }),
+    layer.attach('id', () => performance.now()),
+  ],
+  [handle.any('/path', (c) => c.id)],
+  {
+    '/api': router(
+      [layer.parse('body', async (c) => c.req.text())],
+      [handle.post('/body', (c) => c.body)],
+    ),
+  },
+);
+
+// build.ts
+import app from './main.ts';
+import { compileToString } from '@mapl/web/compiler/jit';
+
+import { rolldown } from 'rolldown';
+import { minifySync } from '@swc/core';
+import { writeFileSync, readFileSync } from 'node:fs';
+
+const ENTRY = '/path/to/output.js';
+
+writeFileSync(
+  ENTRY,
+  `
+    import app from '${import.meta.resolve('./main.ts')}';
+    import hydrate from '@mapl/web/compiler/aot';
+
+    // Compatible with Bun, Deno, Cloudflare, ...
+    export default {
+      fetch: (${compileToString(app)})(...hydrate(app))
+    };
+  `
+);
+const input = await rolldown({
+  input: ENTRY,
+  transform: {
+    typescript: {
+      rewriteImportExtensions: true,
+    },
+  },
+});
+const output = await input.generate();
+const code = minifySync(output.output[0].code, { module: true }).code;
+writeFileSync(ENTRY, code);
+```
+
+Example output (formatted):
+```js
+// router()
+var e = (e, t, l) => [e, t, , l];
+// handle.route()
+let t = (e, t) => [1, t, e],
+  l = { type: null },
+  n = (e, t, n, ...r) => [
+    e,
+    t,
+    n,
+    0 === r.length ? l : Object.assign({ type: null }, ...r),
+  ];
+var r = e(
+  [
+    // inlined layer.tap()
+    [
+      0,
+      (e) => {
+        console.log(e.req);
+      },
+    ],
+    // layer.attach()
+    t("id", () => performance.now()),
+  ],
+  // handle.any()
+  [((...e) => n("", ...e))("/path", (e) => e.id)],
+  {
+    "/api": e(
+      // layer.attach()
+      [t("body", async (e) => e.req.text())],
+      // handle.post()
+      [((...e) => n("POST", ...e))("/body", (e) => e.body)],
+    ),
+  },
+);
+// hydration code
+let a = (e, t) => {
+    let l = e + t;
+    return /.\/$/.test(l) ? e : l;
+  },
+  s = (async () => {}).constructor,
+  o = [, , , , ,],
+  u = (e) => (e[3] ??= o[4](e[2][0], e[2][1], e)),
+  i = (e) => {
+    null != e[2] && (e[3] = null);
+  },
+  p = (e) => (e[1] ? "" : ((e[1] = !0), i(e), o[2])),
+  c = (e) => (e[0] ? "" : ((e[0] = !0), i(e), "return (async()=>{")),
+  d = (e) => (e[4] ? "t" : ((e[4] = !0), "let t")),
+  f = (e, t, l) => {
+    null != e[2] && ((t[2] = e[2]), (t[3] = null));
+    for (let l = 0, n = e[0]; l < n.length; l++) {
+      let e = n[l],
+        r = e[1],
+        a = e[0];
+      -1 === a
+        ? r(t)
+        : (o[1].push(r),
+          r.length > 0 && p(t),
+          r instanceof s && c(t),
+          1 === a
+            ? p(t)
+            : 2 === a
+              ? (d(t), u(t))
+              : 3 === a && (d(t), u(t), p(t)));
+    }
+    for (let n = 0, r = e[1]; n < r.length; n++) {
+      let e = r[n],
+        s = a(l, e[1]);
+      o[3](e[2], e[3], s, t);
+    }
+    let n = e[3];
+    if (null != n) for (let e in n) f(n[e], t.slice(), "/" === e ? l : l + e);
+  },
+  y = Symbol.for("@safe-std/error");
+var h = {
+  // built content
+  fetch: ((e, t, l, n, r, a, s) => {
+    var o = ["text/html", "application/json"].map((e) => ["Content-Type", e]),
+      [u, i] = o,
+      [p, c] = o.map((e) => ({ headers: [e] })),
+      [d, f] = [404, 400].map((e) => new Response(null, { status: e }));
+    return (e) => {
+      let o = e.url,
+        u = o.indexOf("/", 12) + 1,
+        i = o.indexOf("?", u),
+        p = -1 === i ? o.slice(u) : o.slice(u, i);
+      if ("POST" === e.method && "api/body" === p) {
+        let r = t(e);
+        return (
+          l(r),
+          (r.id = n()),
+          (async () => ((r.body = await a(r)), new Response(s(r), r)))()
+        );
+      }
+      if ("path" === p) {
+        let a = t(e);
+        return (l(a), (a.id = n()), new Response(r(a), a));
+      }
+      return d;
+    };
+  })(
+    ...((o[0] = {}),
+    (o[1] = []),
+    (o[2] = "let c=mwc(r);"),
+    (o[3] = (e) => (o[1].push(e), "")),
+    (o[4] = (e) => (o[1].push(e), "")),
+    f(r, [!1, !1, , "return mwb", !1], ""),
+
+    // inject dependencies
+    [
+      (e) => Array.isArray(e) && e[0] === y,
+      (e) => ({ status: 200, req: e, headers: [] }),
+    ].concat(o[1])),
+  ),
+};
+export { h as default };
+```
+
+### Hydration
+```ts
+import { isHydrating } from '@mapl/web/compiler/config';
+
+// false while building the output string
+// true while only building dependencies
+// Use this to for minifiedrs to eliminate unused code path in final output
+isHydrating();
+```

package/compiler/aot.d.ts

@@ -0,0 +1,3 @@
+import type { RouterTag } from "../core/index.js";
+declare const _default: (router: RouterTag) => any[];
+export default _default;

package/compiler/aot.js

@@ -0,0 +1 @@
+import{hydrateDependency,compilerState as state}from"@mapl/framework";import{isErr}from"@safe-std/error";import createContext from"../core/context.js";let compileHandler=fn=>{state[1].push(fn);return``};let compileErrorHandler=fn=>{``+state[1].push(fn);return``};export default router=>{state[0]={};state[1]=[];state[2]=`let c=mwc(r);`;state[3]=compileHandler;state[4]=compileErrorHandler;hydrateDependency(router,[false,false,,`return mwb`,false],``);return[isErr,createContext].concat(state[1])};

package/compiler/config.d.ts

@@ -0,0 +1,5 @@
+export declare const isHydrating: () => boolean;
+/**
+* @private
+*/
+export declare const notHydrating: () => void;

package/compiler/config.js

@@ -0,0 +1 @@
+let hydrateDependency=true;export let isHydrating=()=>hydrateDependency;export let notHydrating=()=>{hydrateDependency=false};

package/compiler/jit.d.ts

@@ -0,0 +1,3 @@
+import type { RouterTag } from "../core/index.js";
+export declare const compileToString: (router: RouterTag) => string;
+export declare const compileToHandler: (router: RouterTag) => ((req: Request) => any);

package/compiler/jit.js

@@ -0,0 +1 @@
+import{compileGroup,createArgSet,AsyncFunction,compilerState as state}from"@mapl/framework";import compile from"@mapl/router/method/compiler";import{countParams}from"@mapl/router/path";import{isErr}from"@safe-std/error";import createContext from"../core/context.js";import{notHydrating}from"./config.js";notHydrating();let paramArgs=createArgSet(new Array(16).fill(0).map((_1,i)=>`q`+i));let compileReturn=(dat,fnAsync,scopeAsync,contextCreated,result)=>{let typ=dat.type;if(typ===`raw`)return`return `+result;fnAsync&&(result=`await `+result);let str=typ==null?`return new Response(`+result+(contextCreated?`,c)`:`)`):contextCreated?`c.headers.push(`+(typ===`json`?`mwj`:`mwh`)+`);return new Response(`+(typ===`json`?`JSON.stringify(`+result+`)`:result)+`,c)`:`return new Response(`+(typ===`json`?`JSON.stringify(`+result+`),mwoj`:result+`,mwoh`)+`)`;return fnAsync&&!scopeAsync?`return (async()=>{`+str+`})()`:str};let compileHandler=(fn,dat,path,scope)=>{let call=`f`+state[1].push(fn)+`(`;let paramCount=countParams(path);paramCount>0&&(call+=paramArgs[paramCount]);if(fn.length>paramCount){call+=paramCount===0?`c`:`,c`;if(!scope[1])return state[2]+compileReturn(dat,fn instanceof AsyncFunction,scope[0],true,call+`)`)}return compileReturn(dat,fn instanceof AsyncFunction,scope[0],scope[1],call+`)`)};let compileErrorHandler=(fn,dat,scope)=>{let call=`f`+state[1].push(fn)+`(t`;if(fn.length>1){call+=`,c`;if(!scope[1])return state[2]+compileReturn(dat,fn instanceof AsyncFunction,scope[0],true,call+`)`)}return compileReturn(dat,fn instanceof AsyncFunction,scope[0],scope[1],call+`)`)};let compileToState=router=>{state[0]={};state[1]=[];state[2]=`let c=mwc(r);`;state[3]=compileHandler;state[4]=compileErrorHandler;compileGroup(router,[false,false,,`return mwb`,false],``,``)};let stateToString=()=>`"use strict";var t=["text/html","application/json"].map(c=>["Content-Type",c]),[mwh,mwj]=t,[mwoh,mwoj]=t.map(c=>({headers:[c]})),[mwn,mwb]=[404,400].map(s=>new Response(null,{status:s}));return(r)=>{`+compile(state[0],`r.method`,`let u=r.url,s=u.indexOf("/",12)+1,e=u.indexOf("?",s),p=e===-1?u.slice(s):u.slice(s,e);`,1)+`return mwn}`;let stateToArgs=()=>{let depsString=`me,mwc`;let deps=state[1];for(let i=0;i<deps.length;i++)depsString+=`,f`+(i+1);return depsString};export let compileToString=router=>{compileToState(router);return`(`+stateToArgs()+`)=>{`+stateToString()+`}`};export let compileToHandler=router=>{compileToState(router);return Function(stateToArgs(),stateToString())(isErr,createContext,...state[1])};

package/index.d.ts

@@ -0,0 +1,6 @@
+export { default as router } from "./core/index.js";
+export * as layer from "./core/middleware.js";
+export * as handle from "./core/handler.js";
+export * as cors from "./utils/cors.js";
+export { default as headers } from "./utils/headers.js";
+export { default as secureHeaders } from "./utils/secure-headers.js";

package/index.js

@@ -0,0 +1 @@
+export{default as router}from"./core/index.js";export*as layer from"./core/middleware.js";export*as handle from"./core/handler.js";export*as cors from"./utils/cors.js";export{default as headers}from"./utils/headers.js";export{default as secureHeaders}from"./utils/secure-headers.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 "name": "@mapl/web",
-"version": "0.1.16",
+"version": "0.2.0-alpha.1",
 "description": "A compiled web framework for all runtimes",
 "keywords": ["fast", "lightweight", "cross-runtime", "framework", "web", "backend"],
 "repository": {
@@ -12,7 +12,7 @@
 "main": "./index.js",
 "types": "./index.d.ts",
 "dependencies": {
-"@mapl/framework": "^0.2.8",
+"@mapl/framework": "^0.3.3",
 "@mapl/router": "^0.6.2",
 "@safe-std/error": "^1.0.1"
 },
@@ -21,14 +21,17 @@
 },
 "exports": {
 "./constants": "./constants.js",
-"./core/compile": "./core/compile.js",
+".": "./index.js",
 "./core/utils": "./core/utils.js",
-"./utils/secure-headers": "./utils/secure-headers.js",
-"./utils/headers": "./utils/headers.js",
-"./core": "./core/index.js",
 "./core/middleware": "./core/middleware.js",
-"./core/context": "./core/context.js",
+"./core": "./core/index.js",
 "./utils/cors": "./utils/cors.js",
-"./core/handler": "./core/handler.js"
+"./core/handler": "./core/handler.js",
+"./core/context": "./core/context.js",
+"./utils/headers": "./utils/headers.js",
+"./compiler/aot": "./compiler/aot.js",
+"./compiler/jit": "./compiler/jit.js",
+"./utils/secure-headers": "./utils/secure-headers.js",
+"./compiler/config": "./compiler/config.js"
 }
 }

package/core/compile.d.ts

@@ -1,6 +0,0 @@
-import type { RouterTag } from "./index.js";
-export declare const compileToState: (router: RouterTag) => void;
-export declare const stateToString: () => string;
-export declare const stateToArgs: () => string;
-declare const _default: (router: RouterTag) => ((req: Request) => any);
-export default _default;

package/core/compile.js

@@ -1 +0,0 @@
-import{compileGroup,createArgSet,AsyncFunction,compilerState as state}from"@mapl/framework";import compile from"@mapl/router/method/compiler";import{countParams}from"@mapl/router/path";import{isErr}from"@safe-std/error";import createContext from"./context.js";let paramArgs=createArgSet(new Array(16).fill(0).map((_1,i)=>`q`+i));let compileReturn=(dat,fnAsync,scopeAsync,contextCreated,result)=>{let typ=dat.type;if(typ===`raw`)return`return `+result;fnAsync&&(result=`await `+result);let str=typ==null?`return new Response(`+result+(contextCreated?`,c)`:`)`):contextCreated?`c.headers.push(`+(typ===`json`?`mwj`:`mwh`)+`);return new Response(`+(typ===`json`?`JSON.stringify(`+result+`)`:result)+`,c)`:`return new Response(`+(typ===`json`?`JSON.stringify(`+result+`),mwoj`:result+`,mwoh`)+`)`;return fnAsync&&!scopeAsync?`return (async()=>{`+str+`})()`:str};let compileHandler=(fn,dat,path,scope)=>{let call=`f`+state[1].push(fn)+`(`;let paramCount=countParams(path);paramCount>0&&(call+=paramArgs[paramCount]);if(fn.length>paramCount){call+=paramCount===0?`c`:`,c`;if(!scope[1])return state[2]+compileReturn(dat,fn instanceof AsyncFunction,scope[0],true,call+`)`)}return compileReturn(dat,fn instanceof AsyncFunction,scope[0],scope[1],call+`)`)};let compileErrorHandler=(fn,dat,scope)=>{let call=`f`+state[1].push(fn)+`(t`;if(fn.length>1){call+=`,c`;if(!scope[1])return state[2]+compileReturn(dat,fn instanceof AsyncFunction,scope[0],true,call+`)`)}return compileReturn(dat,fn instanceof AsyncFunction,scope[0],scope[1],call+`)`)};export let compileToState=router=>{state[0]={};state[1]=[];state[2]=`let c=mwc(r);`;state[3]=compileHandler;state[4]=compileErrorHandler;compileGroup(router,[false,false,,`return mwb`,false],``,``)};export let stateToString=()=>`"use strict";var t=["text/html","application/json"].map(c=>["Content-Type",c]),[mwh,mwj]=t,[mwoh,mwoj]=t.map(c=>({headers:[c]})),[mwn,mwb]=[404,400].map(s=>new Response(null,{status:s}));return(r)=>{`+compile(state[0],`r.method`,`let u=r.url,s=u.indexOf("/",12)+1,e=u.indexOf("?",s),p=e===-1?u.slice(s):u.slice(s,e);`,1)+`return mwn}`;export let stateToArgs=()=>{let depsString=`me,mwc`;let deps=state[1];for(let i=0;i<deps.length;i++)depsString+=`,f`+(i+1);return depsString};export default router=>{compileToState(router);return Function(stateToArgs(),stateToString())(isErr,createContext,...state[1])};