@cedarjs/web-server 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cedar
+
+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/README.md

@@ -0,0 +1,6 @@
+# Redwood's server for the Web side
+
+This package contains code for Redwood's web server.
+
+This package isn't optimized for production use at scale on it's own.
+It's recommended to use a CDN or a web server like Nginx as performant alternatives.

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+"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 __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/webServer.ts
+async function serveWeb(options = {}) {
+  const start = Date.now();
+  console.log(import_chalk.default.dim.italic("Starting Web Server..."));
+  const distIndexExists = await import_fs_extra.default.pathExists(
+    import_path.default.join((0, import_project_config.getPaths)().web.dist, "index.html")
+  );
+  if (!distIndexExists) {
+    throw new Error(
+      "no built files to serve; run `yarn rw build web` before serving the web side"
+    );
+  }
+  if (process.env.REDWOOD_WEB_PORT) {
+    options.port ??= parseInt(process.env.REDWOOD_WEB_PORT);
+  }
+  options.port ??= (0, import_project_config.getConfig)().web.port;
+  options.host ??= process.env.REDWOOD_WEB_HOST;
+  options.host ??= (0, import_project_config.getConfig)().web.host;
+  options.host ??= process.env.NODE_ENV === "production" ? "0.0.0.0" : "::";
+  if (process.env.NODE_ENV === "production" && options.host !== "0.0.0.0") {
+    console.warn(
+      `Warning: host '${options.host}' may need to be '0.0.0.0' in production for containerized deployments`
+    );
+  }
+  const fastify = (0, import_fastify.default)({
+    requestTimeout: 15e3,
+    logger: {
+      level: process.env.LOG_LEVEL ?? (process.env.NODE_ENV === "development" ? "debug" : "warn")
+    }
+  });
+  fastify.register(import_fastify_web.redwoodFastifyWeb, { redwood: options });
+  const address = await fastify.listen({
+    port: options.port,
+    host: options.host
+  });
+  console.log(import_chalk.default.dim.italic("Took " + (Date.now() - start) + " ms"));
+  console.log(`Web server listening at ${import_chalk.default.green(address)}`);
+}
+var import_path, import_chalk, import_fastify, import_fs_extra, import_fastify_web, import_project_config;
+var init_webServer = __esm({
+  "src/webServer.ts"() {
+    "use strict";
+    import_path = __toESM(require("path"));
+    import_chalk = __toESM(require("chalk"));
+    import_fastify = __toESM(require("fastify"));
+    import_fs_extra = __toESM(require("fs-extra"));
+    import_fastify_web = require("@cedarjs/fastify-web");
+    import_project_config = require("@cedarjs/project-config");
+  }
+});
+
+// src/cliConfigHandler.ts
+async function handler(options) {
+  try {
+    await serveWeb(options);
+  } catch (error) {
+    process.exitCode ||= 1;
+    console.error(`Error: ${error.message}`);
+  }
+}
+var init_cliConfigHandler = __esm({
+  "src/cliConfigHandler.ts"() {
+    "use strict";
+    init_webServer();
+  }
+});
+
+// src/bin.ts
+var import_path2 = __toESM(require("path"));
+var import_dotenv_defaults = require("dotenv-defaults");
+var import_helpers = require("yargs/helpers");
+var import_yargs = __toESM(require("yargs/yargs"));
+var import_project_config2 = require("@cedarjs/project-config");
+
+// package.json
+var bin = {
+  "rw-web-server": "./dist/bin.js"
+};
+
+// src/cliConfig.ts
+var description = "Start a server for serving the web side";
+function builder(yargs2) {
+  yargs2.options({
+    port: {
+      description: "The port to listen on",
+      type: "number",
+      alias: "p"
+    },
+    host: {
+      description: "The host to listen on. Note that you most likely want this to be '0.0.0.0' in production",
+      type: "string"
+    },
+    apiProxyTarget: {
+      description: "Forward requests from the apiUrl (in the redwood.toml) to this target. apiUrl must be a relative URL",
+      type: "string",
+      alias: "api-proxy-target"
+    },
+    // Deprecated alias of `apiProxyTarget`
+    apiHost: {
+      hidden: true,
+      alias: "api-host"
+    }
+  });
+}
+
+// src/bin.ts
+init_cliConfigHandler();
+if (!process.env.REDWOOD_ENV_FILES_LOADED) {
+  (0, import_dotenv_defaults.config)({
+    path: import_path2.default.join((0, import_project_config2.getPaths)().base, ".env"),
+    defaults: import_path2.default.join((0, import_project_config2.getPaths)().base, ".env.defaults"),
+    multiline: true
+  });
+  process.env.REDWOOD_ENV_FILES_LOADED = "true";
+}
+process.env.NODE_ENV ??= "production";
+var [scriptName] = Object.keys(bin);
+(0, import_yargs.default)((0, import_helpers.hideBin)(process.argv)).scriptName(scriptName).alias("h", "help").alias("v", "version").strict().example(
+  "yarn $0 --api-url=/api --api-proxy-target=https://api.redwood.horse",
+  "Start the web server and proxy requests made to '/api' to 'https://api.redwood.horse'"
+).example(
+  "yarn $0 --api-url=https://api.redwood.horse",
+  "Start the web server send api requests to 'https://api.redwood.horse' (make sure to configure CORS)"
+).command("$0", description, builder, handler).parse();

package/dist/cliConfig.d.ts

@@ -0,0 +1,6 @@
+import type { Argv } from 'yargs';
+import type { ParsedOptions } from './types';
+export declare const description = "Start a server for serving the web side";
+export declare function builder(yargs: Argv<ParsedOptions>): void;
+export declare function handler(options: ParsedOptions): Promise<void>;
+//# sourceMappingURL=cliConfig.d.ts.map

package/dist/cliConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliConfig.d.ts","sourceRoot":"","sources":["../src/cliConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,eAAO,MAAM,WAAW,4CAA4C,CAAA;AAEpE,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,QAwBjD;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,iBAGnD"}

package/dist/cliConfig.js

@@ -0,0 +1,69 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cliConfig_exports = {};
+__export(cliConfig_exports, {
+  builder: () => builder,
+  description: () => description,
+  handler: () => handler
+});
+module.exports = __toCommonJS(cliConfig_exports);
+const description = "Start a server for serving the web side";
+function builder(yargs) {
+  yargs.options({
+    port: {
+      description: "The port to listen on",
+      type: "number",
+      alias: "p"
+    },
+    host: {
+      description: "The host to listen on. Note that you most likely want this to be '0.0.0.0' in production",
+      type: "string"
+    },
+    apiProxyTarget: {
+      description: "Forward requests from the apiUrl (in the redwood.toml) to this target. apiUrl must be a relative URL",
+      type: "string",
+      alias: "api-proxy-target"
+    },
+    // Deprecated alias of `apiProxyTarget`
+    apiHost: {
+      hidden: true,
+      alias: "api-host"
+    }
+  });
+}
+async function handler(options) {
+  const { handler: handler2 } = await import("./cliConfigHandler.js");
+  await handler2(options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  builder,
+  description,
+  handler
+});

package/dist/cliConfigHandler.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedOptions } from './types';
+export declare function handler(options: ParsedOptions): Promise<void>;
+//# sourceMappingURL=cliConfigHandler.d.ts.map

package/dist/cliConfigHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliConfigHandler.d.ts","sourceRoot":"","sources":["../src/cliConfigHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG5C,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,iBAQnD"}

package/dist/cliConfigHandler.js

@@ -0,0 +1,36 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cliConfigHandler_exports = {};
+__export(cliConfigHandler_exports, {
+  handler: () => handler
+});
+module.exports = __toCommonJS(cliConfigHandler_exports);
+var import_webServer = require("./webServer");
+async function handler(options) {
+  try {
+    await (0, import_webServer.serveWeb)(options);
+  } catch (error) {
+    process.exitCode ||= 1;
+    console.error(`Error: ${error.message}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handler
+});

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+import type { RedwoodFastifyWebOptions } from '@cedarjs/fastify-web';
+export type ParsedOptions = {
+    port?: number;
+    host?: string;
+} & RedwoodFastifyWebOptions['redwood'];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA"}

package/dist/webServer.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedOptions } from './types';
+export declare function serveWeb(options?: ParsedOptions): Promise<void>;
+//# sourceMappingURL=webServer.d.ts.map

package/dist/webServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webServer.d.ts","sourceRoot":"","sources":["../src/webServer.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,wBAAsB,QAAQ,CAAC,OAAO,GAAE,aAAkB,iBA8CzD"}

package/dist/webServer.js

@@ -0,0 +1,80 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var webServer_exports = {};
+__export(webServer_exports, {
+  serveWeb: () => serveWeb
+});
+module.exports = __toCommonJS(webServer_exports);
+var import_path = __toESM(require("path"));
+var import_chalk = __toESM(require("chalk"));
+var import_fastify = __toESM(require("fastify"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_fastify_web = require("@cedarjs/fastify-web");
+var import_project_config = require("@cedarjs/project-config");
+async function serveWeb(options = {}) {
+  const start = Date.now();
+  console.log(import_chalk.default.dim.italic("Starting Web Server..."));
+  const distIndexExists = await import_fs_extra.default.pathExists(
+    import_path.default.join((0, import_project_config.getPaths)().web.dist, "index.html")
+  );
+  if (!distIndexExists) {
+    throw new Error(
+      "no built files to serve; run `yarn rw build web` before serving the web side"
+    );
+  }
+  if (process.env.REDWOOD_WEB_PORT) {
+    options.port ??= parseInt(process.env.REDWOOD_WEB_PORT);
+  }
+  options.port ??= (0, import_project_config.getConfig)().web.port;
+  options.host ??= process.env.REDWOOD_WEB_HOST;
+  options.host ??= (0, import_project_config.getConfig)().web.host;
+  options.host ??= process.env.NODE_ENV === "production" ? "0.0.0.0" : "::";
+  if (process.env.NODE_ENV === "production" && options.host !== "0.0.0.0") {
+    console.warn(
+      `Warning: host '${options.host}' may need to be '0.0.0.0' in production for containerized deployments`
+    );
+  }
+  const fastify = (0, import_fastify.default)({
+    requestTimeout: 15e3,
+    logger: {
+      level: process.env.LOG_LEVEL ?? (process.env.NODE_ENV === "development" ? "debug" : "warn")
+    }
+  });
+  fastify.register(import_fastify_web.redwoodFastifyWeb, { redwood: options });
+  const address = await fastify.listen({
+    port: options.port,
+    host: options.host
+  });
+  console.log(import_chalk.default.dim.italic("Took " + (Date.now() - start) + " ms"));
+  console.log(`Web server listening at ${import_chalk.default.green(address)}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  serveWeb
+});

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cedarjs/web-server",
+  "version": "0.0.4",
+  "description": "CedarJS's server for the Web side",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cedarjs/cedar.git",
+    "directory": "packages/web-server"
+  },
+  "license": "MIT",
+  "main": "./dist/cliConfig.js",
+  "types": "./dist/cliConfig.d.ts",
+  "bin": {
+    "rw-web-server": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsx ./build.mts && yarn build:types",
+    "build:pack": "yarn pack -o cedar-web-server.tgz",
+    "build:types": "tsc --build --verbose",
+    "build:watch": "nodemon --watch src --ext \"js,jsx,ts,tsx\" --ignore dist --exec \"yarn build && yarn fix:permissions\"",
+    "fix:permissions": "chmod +x dist/index.js; chmod +x dist/watch.js",
+    "prepublishOnly": "NODE_ENV=production yarn build"
+  },
+  "dependencies": {
+    "@cedarjs/fastify-web": "0.0.4",
+    "@cedarjs/project-config": "0.0.4",
+    "chalk": "4.1.2",
+    "dotenv-defaults": "5.0.2",
+    "fastify": "4.28.1",
+    "fs-extra": "11.2.0",
+    "yargs": "17.7.2"
+  },
+  "devDependencies": {
+    "@cedarjs/framework-tools": "0.0.4",
+    "tsx": "4.19.3",
+    "typescript": "5.6.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "5b4f77f985bd86ee31ee7338312627accf0cb85b"
+}