primate 0.31.12 → 0.32.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) Terrablue <terrablue@proton.me> and contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "primate",
-  "version": "0.31.12",
+  "version": "0.32.0",
   "description": "Polymorphic development platform",
   "homepage": "https://primatejs.com",
   "bugs": "https://github.com/primatejs/primate/issues",
   "license": "MIT",
   "files": [
     "src/**/*.js",
-    "src/errors.json",
-    "src/defaults/*.html",
     "!src/**/*.spec.js",
     "types/*.ts"
   ],
@@ -19,12 +17,21 @@
     "directory": "packages/primate"
   },
   "dependencies": {
-    "rcompat": "^0.11.1"
+    "@rcompat/args": "^0.3.0",
+    "@rcompat/async": "^0.3.0",
+    "@rcompat/cli": "^0.5.1",
+    "@rcompat/fs": "^0.4.0",
+    "@rcompat/package": "^0.7.0",
+    "@primate/core": "^0.1.0"
   },
   "engines": {
     "node": ">=18"
   },
   "type": "module",
   "types": "./types/index.d.ts",
-  "exports": "./src/exports.js"
-}
+  "exports": {
+    "./handler/*": {
+      "default": "./src/handlers/*.js"
+    }
+  }
+}

package/src/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import args from "rcompat/args";
-import run from "./run.js";
-await run(args[0]);
+import args from "@rcompat/args";
+import init from "./init.js";
+await init(...args);

package/src/commands/build.js

@@ -0,0 +1,4 @@
+import build from "@primate/core/build";
+
+// build for production
+export default (target = "web", mode = "production") => build(mode, target);

package/src/commands/dev.js

@@ -1,3 +1,8 @@
-import start from "../start.js";
+import build from "./build.js";
+import serve from "./serve.js";
 
-export default app => start(app, "development");
+// build for development and serve
+export default async () => {
+  // will only serve is build is successful
+  await build("web", "development") === true && serve();
+};

package/src/commands/exports.js

@@ -1,4 +1,5 @@
+import { default as build } from "./build.js";
 import { default as dev } from "./dev.js";
 import { default as serve } from "./serve.js";
 
-export default name => ({ dev, serve })[name] ?? dev;
+export default name => ({ build, dev, serve })[name] ?? dev;

package/src/commands/serve.js

@@ -1,3 +1,8 @@
-import start from "../start.js";
+import root from "@rcompat/package/root";
+import tryreturn from "@rcompat/async/tryreturn";
+import resolve from "@rcompat/fs/resolve";
 
-export default app => start(app, "production");
+// serve from build directory
+export default async (from = "build") =>
+  (await tryreturn(_ => root()).orelse(_ => resolve()))
+    .join(`./${from}/serve.js`).import();

package/src/handlers/error.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/error";

package/src/handlers/json.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/json";

package/src/handlers/redirect.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/redirect";

package/src/handlers/sse.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/sse";

package/src/handlers/stream.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/stream";

package/src/handlers/text.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/text";

package/src/handlers/view.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/view";

package/src/handlers/ws.js

@@ -0,0 +1 @@
+export { default } from "@primate/core/handler/ws";

package/src/init.js

@@ -0,0 +1,12 @@
+import blue from "@rcompat/cli/color/blue";
+import bold from "@rcompat/cli/color/bold";
+import print from "@rcompat/cli/print";
+import manifest from "@rcompat/package/manifest";
+import find from "./commands/exports.js";
+
+export default async (...args) => {
+  const [command, ...flags] = args;
+  const primate = await manifest(import.meta.url);
+  print(blue(bold(primate.name)), blue(primate.version), "\n");
+  find(command)(...flags);
+};

package/README.md

@@ -1,14 +0,0 @@
-# Primate
-
-Polymorphic development platform. To start [read guide].
-
-## Resources
-
-* Website: https://primatejs.com
-* IRC: Join the `#primate` channel on `irc.libera.chat`
-
-## License
-
-MIT
-
-[read guide]: https://primatejs.com/guide/getting-started

package/src/Logger.js

@@ -1,111 +0,0 @@
-import { assert, is } from "rcompat/invariant";
-import { blue, bold, green, red, yellow, dim } from "rcompat/colors";
-import o from "rcompat/object";
-import console from "rcompat/console";
-import { stdout } from "rcompat/stdio";
-
-const levels = {
-  Error: 0,
-  Warn: 1,
-  Info: 2,
-};
-
-const print = (...messages) => stdout.write(messages.join(" "));
-const bye = _ => print(dim(yellow("~~ bye\n")));
-const mark = (format, ...params) => params.reduce((formatted, param, i) =>
-  formatted.replace(`{${i}}`, bold(param)), format);
-
-const reference = (module, error) => {
-  const base = module === "primate" ? "guide/logging" : `modules/${module}`;
-  return `https://primatejs.com/${base}#${hyphenate(error)}`;
-};
-
-const hyphenate = class_cased => class_cased
-  .split("")
-  .map(letter => letter.replace(/[A-Z]/u, upper => `-${upper.toLowerCase()}`))
-  .join("")
-  .slice(1);
-
-const throwable = ({ message, level, fix }, name, module) => ({
-  new(...args) {
-    const error = new Error(mark(message, ...args));
-    error.level = Logger[level];
-    error.fix = mark(fix, ...args);
-    error.name = name;
-    error.module = module;
-    return error;
-  },
-  throw(...args) {
-    throw this.new(...args);
-  },
-  warn(logger, ...args) {
-    const error = { level: Logger[level], message: mark(message, ...args),
-      fix: mark(fix, ...args) };
-    logger.auto({ ...error, name, module });
-  },
-});
-
-const Logger = class Logger {
-  #level; #trace;
-
-  static err(errors, module) {
-    return o.map(errors, ([key, value]) => [key, throwable(value, key, module)]);
-  }
-
-  constructor({ level = levels.Error, trace = false } = {}) {
-    assert(level !== undefined && level <= levels.Info);
-    is(trace).boolean();
-    this.#level = level;
-    this.#trace = trace;
-  }
-
-  static get Error() {
-    return levels.Error;
-  }
-
-  static get Warn() {
-    return levels.Warn;
-  }
-
-  static get Info() {
-    return levels.Info;
-  }
-
-  #print(pre, color, message, error = {}) {
-    const { fix, module, name, level } = error;
-    print(color(pre), `${module !== undefined ? `${color(module)} ` : ""}${message}`, "\n");
-    if (fix) {
-      print(blue("++"), fix);
-      name && print(dim(`\n   -> ${reference(module, name)}`), "\n");
-    }
-    if (level === levels.Error || level === undefined && error.message) {
-      this.#trace && console.log(error);
-    }
-  }
-
-  get level() {
-    return this.#level;
-  }
-
-  info(...args) {
-    this.level >= levels.Info && this.#print("--", green, ...args);
-  }
-
-  warn(...args) {
-    this.level >= levels.Warn && this.#print("??", yellow, ...args);
-  }
-
-  error(...args) {
-    this.level >= levels.Warn && this.#print("!!", red, ...args);
-  }
-
-  auto(error) {
-    const { message } = error;
-    const matches = o.map(levels, ([key, level]) => [level, key.toLowerCase()]);
-    return this[matches[error.level] ?? "error"](message, error);
-  }
-};
-
-export default Logger;
-
-export { print, bye, mark };

package/src/app.js

@@ -1,220 +0,0 @@
-import crypto from "rcompat/crypto";
-import { tryreturn } from "rcompat/async";
-import FS from "rcompat/fs";
-import { is } from "rcompat/invariant";
-import o from "rcompat/object";
-import { globify } from "rcompat/string";
-import * as runtime from "rcompat/meta";
-import { identity } from "rcompat/function";
-import { Response, Status, MediaType } from "rcompat/http";
-
-import errors from "./errors.js";
-import to_sorted from "./to_sorted.js";
-import * as handlers from "./handlers.js";
-import * as loaders from "./loaders/exports.js";
-
-const { DoubleFileExtension } = errors;
-
-const to_csp = (config_csp, assets, csp) => config_csp
-  // only csp entries in the config will be enriched
-  .map(([key, directives]) =>
-    // enrich with application assets
-    [key, assets[key] ? directives.concat(...assets[key]) : directives])
-  .map(([key, directives]) =>
-    // enrich with explicit csp
-    [key, csp[key] ? directives.concat(...csp[key]) : directives])
-  .map(([key, directives]) => `${key} ${directives.join(" ")}`)
-  .join(";");
-
-// use user-provided file or fall back to default
-const load = (base, page, fallback) =>
-  tryreturn(_ => FS.File.text(`${base.join(page)}`))
-    .orelse(_ => FS.File.text(`${base.join(fallback)}`));
-
-const encoder = new TextEncoder();
-
-const attribute = attributes => Object.keys(attributes).length > 0
-  ? " ".concat(Object.entries(attributes)
-    .map(([key, value]) => `${key}="${value}"`).join(" "))
-  : "";
-const tag = ({ name, attributes = {}, code = "", close = true }) =>
-  `<${name}${attribute(attributes)}${close ? `>${code}</${name}>` : "/>"}`;
-const tags = {
-  // inline: <script type integrity>...</script>
-  // outline: <script type integrity src></script>
-  script({ inline, code, type, integrity, src }) {
-    return inline
-      ? tag({ name: "script", attributes: { type, integrity }, code })
-      : tag({ name: "script", attributes: { type, integrity, src } });
-  },
-  // inline: <style>...</style>
-  // outline: <link rel="stylesheet" href/>
-  style({ inline, code, href, rel = "stylesheet" }) {
-    return inline
-      ? tag({ name: "style", code })
-      : tag({ name: "link", attributes: { rel, href }, close: false });
-  },
-};
-
-const render_head = (assets, head) =>
-  to_sorted(assets, ({ type }) => -1 * (type === "importmap"))
-    .map(({ src, code, type, inline, integrity }) =>
-      type === "style"
-        ? tags.style({ inline, code, href: src })
-        : tags.script({ inline, code, type, integrity, src }),
-    ).join("\n").concat("\n", head ?? "");
-
-export default async (log, root, config) => {
-  const { http } = config;
-  const secure = http?.ssl !== undefined;
-  const path = o.valmap(config.location, value => root.join(value));
-
-  // if ssl activated, resolve key and cert early
-  if (secure) {
-    http.ssl.key = root.join(http.ssl.key);
-    http.ssl.cert = root.join(http.ssl.cert);
-  }
-
-  const error = await path.routes.join("+error.js");
-
-  return {
-    secure,
-    importmaps: {},
-    assets: [],
-    path,
-    root,
-    log,
-    // pseudostatic thus arrowbound
-    get: (config_key, fallback) => o.get(config, config_key) ?? fallback,
-    error: {
-      default: await error.exists() ? await error.import("default") : undefined,
-    },
-    handlers: { ...handlers },
-    extensions: {
-      ".html": {
-        handle: handlers.html,
-      },
-    },
-    modules: await loaders.modules(log, root, config.modules ?? []),
-    ...runtime,
-    // copy files to build folder, potentially transforming them
-    async stage(source, directory, filter) {
-      const { paths = [], mapper = identity } = this.get("build.transform", {});
-      is(paths).array();
-      is(mapper).function();
-
-      const regexs = paths.map(file => globify(file));
-      const target_base = this.runpath(directory);
-
-      await source.copy(target_base);
-
-      await Promise.all((await source.collect(filter)).map(async path => {
-        const debased = path.debase(this.root).path.slice(1);
-        const filename = FS.File.join(directory, path.debase(source));
-        const target = await target_base.join(filename.debase(directory));
-        await target.directory.create();
-        regexs.some(regex => regex.test(debased))
-          && target.write(mapper(await path.text()));
-      }));
-    },
-    async compile(component) {
-      const { server, client, components } = this.get("location");
-
-      const source = this.path.components;
-      const compile = this.extensions[component.fullExtension]?.compile
-        ?? this.extensions[component.extension]?.compile;
-      if (compile === undefined) {
-        const debased = `${component.path}`.replace(source, "");
-
-        const server_target = this.runpath(server, components, debased);
-        await server_target.directory.create();
-        await component.copy(server_target);
-
-        const client_target = this.runpath(client, components, debased);
-        await client_target.directory.create();
-        await component.copy(client_target);
-      } else {
-        // compile server components
-        await compile.server(component);
-
-        // compile client components
-        await compile.client(component);
-      }
-    },
-    headers(csp = {}) {
-      const http_csp = Object.entries(this.get("http.csp", {}));
-
-      return {
-        ...this.get("http.headers", {}),
-        ...http_csp.length === 0 ? {} : {
-          "Content-Security-Policy": to_csp(http_csp, this.asset_csp, csp),
-        },
-      };
-    },
-    runpath(...directories) {
-      return this.path.build.join(...directories);
-    },
-    async render(content) {
-      const index = this.get("pages.index");
-      const { body, head, partial, placeholders = {}, page = index } = content;
-      ["body", "head"].every(used => is(placeholders[used]).undefined());
-
-      return partial ? body : Object.entries(placeholders)
-        // replace given placeholders, defaulting to ""
-        .reduce((html, [key, value]) => html.replace(`%${key}%`, value ?? ""),
-          await load(this.runpath(this.get("location.pages")), page, index))
-        // replace non-given placeholders, aside from %body% / %head%
-        .replaceAll(/(?<keep>%(?:head|body)%)|%.*?%/gus, "$1")
-        // replace body and head
-        .replace("%body%", body)
-        .replace("%head%", render_head(this.assets, head));
-    },
-    respond(body, { status = Status.OK, headers = {} } = {}) {
-      return new Response(body, { status, headers: {
-        "Content-Type": MediaType.TEXT_HTML, ...this.headers(), ...headers },
-      });
-    },
-    async view(options) {
-      // split render and respond options
-      const { status, headers, ...rest } = options;
-      return this.respond(await this.render(rest), { status, headers });
-    },
-    media(type, { status, headers } = {}) {
-      return { status, headers: { ...headers, "Content-Type": type } };
-    },
-    async inline(code, type) {
-      const integrity = await this.hash(code);
-      const tag_name = type === "style" ? "style" : "script";
-      const head = tags[tag_name]({ code, type, inline: true, integrity });
-      return { head, integrity: `'${integrity}'` };
-    },
-    async publish({ src, code, type = "", inline = false }) {
-      if (inline || type === "style") {
-        this.assets.push({
-          src: FS.File.join(http.static.root, src ?? "").path,
-          code: inline ? code : "",
-          type,
-          inline,
-          integrity: await this.hash(code),
-        });
-      }
-      // rehash assets_csp
-      this.asset_csp = this.assets.map(({ type: directive, integrity }) => [
-        `${directive === "style" ? "style" : "script"}-src`, integrity])
-        .reduce((csp, [directive, hash]) =>
-          ({ ...csp, [directive]: csp[directive].concat(`'${hash}'`) } ),
-          { "style-src": [], "script-src": [] },
-        );
-    },
-    register(extension, operations) {
-      is(this.handlers[extension]).undefined(DoubleFileExtension.new(extension));
-      this.handlers[extension] = operations.handle;
-      this.extensions[extension] = operations;
-    },
-    async hash(data, algorithm = "sha-384") {
-      const bytes = await crypto.subtle.digest(algorithm, encoder.encode(data));
-      const prefix = algorithm.replace("-", _ => "");
-      return `${prefix}-${btoa(String.fromCharCode(...new Uint8Array(bytes)))}`;
-    },
-  };
-};

package/src/defaults/app.html

@@ -1,9 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <title>Primate app</title>
-    <meta charset="utf-8" />
-    %head%
-  </head>
-  <body>%body%</body>
-</html>

package/src/defaults/error.html

@@ -1,14 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <title>Error page</title>
-    <meta charset="utf-8" />
-    %head%
-  </head>
-  <body>
-    <h1>Error page</h1>
-    <p>
-      %body%
-    </p>
-  </body>
-</html>

package/src/defaults/primate.config.js

@@ -1,55 +0,0 @@
-import { identity } from "rcompat/function";
-import Logger from "../Logger.js";
-
-export default {
-  base: "/",
-  modules: [],
-  pages: {
-    index: "app.html",
-    error: "error.html",
-  },
-  logger: {
-    level: Logger.Warn,
-    trace: false,
-  },
-  http: {
-    host: "localhost",
-    port: 6161,
-    csp: {},
-    static: {
-      root: "/",
-    },
-  },
-  request: {
-    body: {
-      parse: true,
-    },
-  },
-  location: {
-    // renderable components
-    components: "components",
-    // HTML pages
-    pages: "pages",
-    // hierarchical routes
-    routes: "routes",
-    // static assets
-    static: "static",
-    // runtime types
-    types: "types",
-    // build environment
-    build: "build",
-    // client build
-    client: "client",
-    // server build
-    server: "server",
-  },
-  build: {
-    name: "app",
-    includes: [],
-    excludes: [],
-    transform: {
-      paths: [],
-      mapper: identity,
-    },
-  },
-};

package/src/dispatch.js

@@ -1,28 +0,0 @@
-import { is } from "rcompat/invariant";
-import { tryreturn } from "rcompat/sync";
-import o from "rcompat/object";
-import { camelcased } from "rcompat/string";
-import errors from "./errors.js";
-import validate from "./validate.js";
-
-export default (patches = {}) => (object, raw, cased = true) => {
-  return Object.assign(Object.create(null), {
-    ...o.map(patches, ([name, patch]) => [`get${camelcased(name)}`, key => {
-      is(key).defined(`\`${name}\` called without key`);
-      return tryreturn(_ => validate(patch, object[key], key))
-        .orelse(({ message }) => errors.MismatchedType.throw(message));
-    }]),
-    get(key) {
-      is(key).string();
-
-      return object[cased ? key : key.toLowerCase()];
-    },
-    json() {
-      return JSON.parse(JSON.stringify(object));
-    },
-    toString() {
-      return JSON.stringify(object);
-    },
-    raw,
-  });
-};

package/src/errors.js

@@ -1,8 +0,0 @@
-import FS from "rcompat/fs";
-import Logger from "./Logger.js";
-
-const json = await new FS.File(import.meta.url).up(1).join("errors.json").json();
-
-const errors = Logger.err(json.errors, json.module);
-
-export default errors;