@primate/core 0.4.6 → 0.6.0

package/lib/private/App.js

@@ -1,26 +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 entries from "@rcompat/record/entries";
-import get from "@rcompat/record/get";
-const doubled = (set) => set.find((part, i, array) => array.filter((_, j) => i !== j).includes(part)) ?? "";
+import dict from "@rcompat/dict";
+import entries from "@rcompat/dict/entries";
+import p from "pema";
 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,
@@ -30,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 };
     }
@@ -53,8 +85,9 @@ 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 };
     }
     get(key) {
         return this.#kv.get(key);
@@ -63,7 +96,7 @@ export default class App {
         this.#kv.set(key, value);
     }
     config(path) {
-        return get(this.#config, path);
+        return dict.get(this.#config, path);
     }
     runpath(...directories) {
         return this.#path.build.join(...directories);

package/lib/private/Binder.d.ts

@@ -1,5 +1,5 @@
-import type FileRef from "@rcompat/fs/FileRef";
-import type MaybePromise from "@rcompat/type/MaybePromise";
+import type { FileRef } from "@rcompat/fs";
+import type { MaybePromise } from "@rcompat/type";
 type Options = {
     build: {
         id: string;

package/lib/private/Flags.d.ts

@@ -1,7 +1,11 @@
-declare const _default: import("pema").ObjectType<{
-    mode: import("pema/union").UnionType<[import("pema").LiteralType<"production">, import("pema").LiteralType<"development">, import("pema").LiteralType<"testing">]>;
-    target: import("pema").DefaultType<import("pema/string").StringType, "web">;
-    dir: import("pema").DefaultType<import("pema/string").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").default<T>;
-    build(app: BuildApp, next: NextBuild): import("@rcompat/type/MaybePromise").default<BuildApp>;
-    serve(app: ServeApp, next: NextServe): import("@rcompat/type/MaybePromise").default<ServeApp>;
-    handle(request: RequestFacade, next: NextHandle): import("@rcompat/type/MaybePromise").default<Response>;
-    route(request: RequestFacade, next: NextRoute): import("@rcompat/type/MaybePromise").default<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