@primate/core 0.5.0 → 0.6.0

package/lib/private/App.d.ts

@@ -1,13 +1,20 @@
+import type BuildApp from "#build/App";
 import type Config from "#config/Config";
 import type Flags from "#Flags";
 import type Mode from "#Mode";
-import type Module from "#Module";
+import type { Created } from "#module/create";
+import type ServeApp from "#serve/App";
 import TargetManager from "#target/Manager";
 import type { FileRef } from "@rcompat/fs";
 export default class App {
     #private;
     constructor(root: FileRef, config: Config, flags: typeof Flags.infer);
-    init(): Promise<App>;
+    init(): Promise<this>;
+    register(created: Created): void;
+    build_hooks(app: BuildApp): Promise<BuildApp>;
+    serve_hooks(app: ServeApp): Promise<ServeApp>;
+    get handle_hooks(): import("./index.js").HandleHook[];
+    get route_hooks(): import("./index.js").RouteHook[];
     get location(): {
         app_html: "app.html";
         client: "client";
@@ -37,14 +44,13 @@ export default class App {
         build: FileRef;
     };
     get mode(): Mode;
-    get modules(): Module[];
     get livereload(): {
         host: string;
         port: number;
     };
     get<T>(key: symbol): T;
     set(key: symbol, value: unknown): void;
-    config<P extends string>(path: P): P extends `${infer P1}.${infer Rest}` ? P1 extends "http" | "livereload" | "request" | "modules" ? (Rest extends `${infer P1}.${infer Rest}` ? P1 extends keyof Exclude<{
+    config<P extends string>(path: P): P extends `${infer P1}.${infer Rest}` ? P1 extends "http" | "livereload" | "db" | "env" | "request" | "modules" ? (Rest extends `${infer P1}.${infer Rest}` ? P1 extends keyof Exclude<{
         http: {
             csp: Record<string, string[]> | undefined;
             headers: Record<string, string> | undefined;
@@ -63,7 +69,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -88,7 +105,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -113,7 +141,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -138,7 +177,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -163,7 +213,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -188,7 +249,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -213,7 +285,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -238,7 +321,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -263,7 +357,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -288,7 +393,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -313,7 +429,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -338,7 +465,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -363,7 +501,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -388,7 +537,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -413,7 +573,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -438,7 +609,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -463,7 +645,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -488,7 +681,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -513,7 +717,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
@@ -538,13 +753,24 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;
             };
         };
-    }[P1] & undefined) : undefined : P extends "http" | "livereload" | "request" | "modules" ? {
+    }[P1] & undefined) : undefined : P extends "http" | "livereload" | "db" | "env" | "request" | "modules" ? {
         http: {
             csp: Record<string, string[]> | undefined;
             headers: Record<string, string> | undefined;
@@ -563,7 +789,18 @@ export default class App {
             host: string | undefined;
             port: number | undefined;
         };
-        modules: Module[] | undefined;
+        db: {
+            migrations: {
+                table: string;
+                db: import("./db/DB.js").default;
+            } | undefined;
+        };
+        env: {
+            schema: import("pema").ObjectType<import("@rcompat/dict").Dict<import("pema").Parsed<unknown>>, {
+                [x: string]: unknown;
+            }> | undefined;
+        };
+        modules: import("./Module.js").default[];
         request: {
             body: {
                 parse: boolean;

package/lib/private/App.js

@@ -1,27 +1,34 @@
-import fail from "#fail";
+import E from "#errors";
 import location from "#location";
-import reducer from "#reducer";
+import create from "#module/create";
 import TargetManager from "#target/Manager";
 import dict from "@rcompat/dict";
 import entries from "@rcompat/dict/entries";
 import p from "pema";
-const doubled = (set) => set.find((part, i, array) => array.filter((_, j) => i !== j).includes(part)) ?? "";
 export default class App {
     #path;
     #root;
     #config;
-    #modules;
+    #hooks = {
+        init: [],
+        build: [],
+        serve: [],
+        handle: [],
+        route: [],
+    };
+    #module_names = new Set();
     #kv = new Map();
     #mode;
     #target;
     #target_name;
     constructor(root, config, flags) {
         if (Object.values(location).includes(flags.dir)) {
-            throw fail("cannot build to {0} - reserved directory", flags.dir);
+            throw E.app_reserved_directory(flags.dir);
         }
         this.#root = root;
         this.#config = config;
-        this.#modules = config.modules?.flat(10) ?? [];
+        for (const module of config.modules)
+            this.register(create(module));
         this.#path = entries({
             ...location,
             build: flags.dir,
@@ -31,14 +38,38 @@ export default class App {
         this.#target_name = flags.target;
     }
     async init() {
-        const names = this.#modules.map(({ name }) => name);
-        if (new Set(names).size !== this.#modules.length) {
-            throw fail("module {0} loaded twice", doubled(names));
-        }
-        const app = await reducer(this.#modules, this, "init");
+        for (const hook of this.#hooks.init)
+            await hook(this);
         this.#target.set(this.#target_name);
+        return this;
+    }
+    register(created) {
+        if (this.#module_names.has(created.name)) {
+            throw E.app_duplicate_module(created.name);
+        }
+        this.#module_names.add(created.name);
+        this.#hooks.init.push(...created.hooks.init);
+        this.#hooks.build.push(...created.hooks.build);
+        this.#hooks.serve.push(...created.hooks.serve);
+        this.#hooks.handle.push(...created.hooks.handle);
+        this.#hooks.route.push(...created.hooks.route);
+    }
+    async build_hooks(app) {
+        for (const hook of this.#hooks.build)
+            await hook(app);
         return app;
     }
+    async serve_hooks(app) {
+        for (const hook of this.#hooks.serve)
+            await hook(app);
+        return app;
+    }
+    get handle_hooks() {
+        return [...this.#hooks.handle];
+    }
+    get route_hooks() {
+        return [...this.#hooks.route];
+    }
     get location() {
         return { ...location };
     }
@@ -54,9 +85,6 @@ export default class App {
     get mode() {
         return this.#mode;
     }
-    get modules() {
-        return [...this.#modules];
-    }
     get livereload() {
         const { host = this.config("http.host"), port = p.uint.port().parse(this.config("http.port") - 1), } = this.config("livereload");
         return { host, port };

package/lib/private/Flags.d.ts

@@ -1,7 +1,11 @@
-declare const _default: import("pema").ObjectType<{
-    mode: import("pema").UnionType<[import("pema").LiteralType<"production">, import("pema").LiteralType<"development">, import("pema").LiteralType<"testing">]>;
-    target: import("pema").DefaultType<import("pema").StringType, "web">;
-    dir: import("pema").DefaultType<import("pema").StringType, "build">;
+declare const _default: import("pema").ObjectType<import("pema").NormalizeSchemaObject<{
+    readonly mode: import("pema").UnionType<[import("pema").LiteralType<"production">, import("pema").LiteralType<"development">, import("pema").LiteralType<"testing">]>;
+    readonly target: import("pema").DefaultType<import("pema").StringType, "web">;
+    readonly dir: import("pema").DefaultType<import("pema").StringType, "build">;
+}>, {
+    mode: "development" | "production" | "testing";
+    target: string;
+    dir: string;
 }>;
 export default _default;
 //# sourceMappingURL=Flags.d.ts.map

package/lib/private/Module.d.ts

@@ -1,18 +1,6 @@
-import type App from "#App";
-import type BuildApp from "#build/App";
-import type Next from "#module/Next";
-import type NextBuild from "#module/NextBuild";
-import type NextHandle from "#module/NextHandle";
-import type NextRoute from "#module/NextRoute";
-import type NextServe from "#module/NextServe";
-import type RequestFacade from "#request/RequestFacade";
-import type ServeApp from "#serve/App";
-export default abstract class Module {
-    abstract get name(): string;
-    init<T extends App>(app: T, next: Next<T>): import("@rcompat/type").MaybePromise<T>;
-    build(app: BuildApp, next: NextBuild): import("@rcompat/type").MaybePromise<BuildApp>;
-    serve(app: ServeApp, next: NextServe): import("@rcompat/type").MaybePromise<ServeApp>;
-    handle(request: RequestFacade, next: NextHandle): import("@rcompat/type").MaybePromise<Response>;
-    route(request: RequestFacade, next: NextRoute): import("@rcompat/type").MaybePromise<import("./response/ResponseLike.js").default>;
+import type Setup from "#module/Setup";
+export default interface Module {
+    name: string;
+    setup(setup: Setup): void;
 }
 //# sourceMappingURL=Module.d.ts.map

package/lib/private/Module.js

@@ -1,18 +1,2 @@
-export default class Module {
-    init(app, next) {
-        return next(app);
-    }
-    build(app, next) {
-        return next(app);
-    }
-    serve(app, next) {
-        return next(app);
-    }
-    handle(request, next) {
-        return next(request);
-    }
-    route(request, next) {
-        return next(request);
-    }
-}
+export {};
 //# sourceMappingURL=Module.js.map

package/lib/private/app/EnvSchema.d.ts

@@ -0,0 +1,5 @@
+import type { Dict } from "@rcompat/type";
+import type { Parsed } from "pema";
+type EnvSchema = Dict<Parsed<unknown>>;
+export type { EnvSchema as default };
+//# sourceMappingURL=EnvSchema.d.ts.map

package/lib/private/app/EnvSchema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EnvSchema.js.map

package/lib/private/app/Facade.browser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser stub for AppFacade.
+ * env must never be called in frontend code, ecrets must not leak to clients
+ */
+export default class AppFacade {
+    config(_path: string): never;
+    env(_key: string): never;
+    view(_name: string): never;
+    get root(): never;
+}
+//# sourceMappingURL=Facade.browser.d.ts.map

package/lib/private/app/Facade.browser.js

@@ -0,0 +1,19 @@
+/**
+ * Browser stub for AppFacade.
+ * env must never be called in frontend code, ecrets must not leak to clients
+ */
+export default class AppFacade {
+    config(_path) {
+        throw new Error("AppFacade.config() is not available in the browser");
+    }
+    env(_key) {
+        throw new Error("AppFacade.env() is server-only. Do not call env() in frontend/browser code.");
+    }
+    view(_name) {
+        throw new Error("AppFacade.view() is not available in the browser");
+    }
+    get root() {
+        throw new Error("AppFacade.root is not available in the browser");
+    }
+}
+//# sourceMappingURL=Facade.browser.js.map