@blinkk/root 1.0.5 → 1.0.7

package/dist/{chunk-MLPPFGKW.js → chunk-BMKSXG4B.js}

@@ -143,7 +143,7 @@ function sessionMiddleware(options) {
         sameSite
       });
     };
-    req.hooks.add("beforeRender", () => {
+    req.hooks.add("preRender", () => {
       res.saveSession();
     });
     next();
@@ -200,4 +200,4 @@ export {
   sessionMiddleware,
   Session
 };
-//# sourceMappingURL=chunk-MLPPFGKW.js.map
+//# sourceMappingURL=chunk-BMKSXG4B.js.map

package/dist/{chunk-MLPPFGKW.js.map → chunk-BMKSXG4B.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/middleware/common.ts","../src/middleware/multipart.ts","../src/middleware/session.ts"],"sourcesContent":["import path from 'node:path';\nimport micromatch from 'micromatch';\nimport {RootConfig} from '../core/config.js';\nimport {Request, Response, NextFunction} from '../core/types.js';\n\n/**\n * Middleware that injects the root.js project config into the request context.\n */\nexport function rootProjectMiddleware(options: {rootConfig: RootConfig}) {\n  return (req: Request, _: Response, next: NextFunction) => {\n    req.rootConfig = options.rootConfig;\n    next();\n  };\n}\n\n/**\n * Middleware that injects HTTP headers from the `server.headers` config in\n * root.config.ts.\n */\nexport function headersMiddleware(options: {rootConfig: RootConfig}) {\n  const headersUserConfig = options.rootConfig.server?.headers || [];\n  // Filter header config values that are invalid.\n  const headersConfig = headersUserConfig.filter((headerConfig) => {\n    return (\n      headerConfig.source &&\n      headerConfig.headers &&\n      headerConfig.headers.length > 0\n    );\n  });\n  return (req: Request, res: Response, next: NextFunction) => {\n    headersConfig.forEach((headerConfig) => {\n      if (micromatch.isMatch(req.path, headerConfig.source)) {\n        headerConfig.headers.forEach((header) => {\n          if (header.key) {\n            res.setHeader(String(header.key), String(header.value));\n          }\n        });\n      }\n    });\n    next();\n  };\n}\n\n/**\n * Trailing slash middleware. Handles trailing slash redirects (preserving any\n * query params) using the `server.trailingSlash` config in root.config.ts.\n */\nexport function trailingSlashMiddleware(options: {rootConfig: RootConfig}) {\n  const trailingSlash = options.rootConfig.server?.trailingSlash;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    // If `trailingSlash: false`, force a trailing slash in the URL.\n    if (\n      trailingSlash === true &&\n      !path.extname(req.path) &&\n      !req.path.endsWith('/')\n    ) {\n      const redirectPath = `${req.path}/`;\n      redirectWithQuery(req, res, 301, redirectPath);\n      return;\n    }\n\n    // If `trailingSlash: false`, remove any trailing slash from the URL.\n    if (\n      trailingSlash === false &&\n      !path.extname(req.path) &&\n      req.path !== '/' &&\n      req.path.endsWith('/')\n    ) {\n      const redirectPath = removeTrailingSlashes(req.path);\n      redirectWithQuery(req, res, 301, redirectPath);\n      return;\n    }\n\n    next();\n  };\n}\n\n/**\n * Issues an HTTP redirect, preserving any query params from the original req.\n */\nfunction redirectWithQuery(\n  req: Request,\n  res: Response,\n  redirectCode: number,\n  redirectPath: string\n) {\n  const queryStr = getQueryStr(req);\n  const redirectUrl = queryStr ? `${redirectPath}?${queryStr}` : redirectPath;\n  res.redirect(redirectCode, redirectUrl);\n}\n\n/**\n * Returns the query string for a request, or empty string if no query.\n */\nfunction getQueryStr(req: Request): string {\n  const qIndex = req.originalUrl.indexOf('?');\n  if (qIndex === -1) {\n    return '';\n  }\n  return req.originalUrl.slice(qIndex + 1);\n}\n\n/**\n * Removes trailing slashes from a URL path.\n * Note: A path with only slashes (e.g. `///`) returns `/`.\n */\nfunction removeTrailingSlashes(urlPath: string) {\n  while (urlPath.endsWith('/') && urlPath !== '/') {\n    urlPath = urlPath.slice(0, -1);\n  }\n  return urlPath;\n}\n","import busboy from 'busboy';\nimport {RequestHandler} from 'express';\nimport {Request, Response, NextFunction, MultipartFile} from '../core/types.js';\n\nconst DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB\n\n/**\n * Middleware for parsing multipart file uploads that's compatible with the dev\n * server and Firebase Functions.\n *\n * Context:\n * https://stackoverflow.com/questions/47242340/how-to-perform-an-http-file-upload-using-express-on-cloud-functions-for-firebase\n */\nexport function multipartMiddleware(options?: {\n  maxFileSize?: number;\n}): RequestHandler {\n  const maxFileSize = options?.maxFileSize || DEFAULT_MAX_FILE_SIZE;\n  const handler: any = (req: Request, res: Response, next: NextFunction) => {\n    const contentType = String(req.headers['content-type'] || '');\n    if (\n      req.method === 'POST' &&\n      contentType.startsWith('multipart/form-data')\n    ) {\n      const parser = busboy({headers: req.headers});\n\n      // Data storage for fields and files\n      const fields: {[fieldname: string]: string} = {};\n      const files: {[name: string]: MultipartFile} = {};\n\n      // Handle field data.\n      parser.on('field', (fieldname: string, val: any) => {\n        fields[fieldname] = val;\n      });\n\n      // Handle file data. Files are saved to an in-memory buffer.\n      parser.on(\n        'file',\n        (\n          fieldname: string,\n          file: any,\n          meta: {\n            filename: string;\n            encoding: string;\n            mimeType: string;\n          }\n        ) => {\n          const {filename, encoding, mimeType: mimetype} = meta;\n          const fileChunks: Uint8Array[] = [];\n          let totalBytesRead = 0;\n\n          file.on('data', (chunk: Uint8Array) => {\n            totalBytesRead += chunk.length;\n\n            if (totalBytesRead > maxFileSize) {\n              // File size exceeds the limit, stop reading.\n              console.error(`File size exceeds the limit: ${fieldname}.`);\n              file.removeAllListeners('data');\n              // Consume and discard remaining data.\n              file.resume();\n            } else {\n              fileChunks.push(chunk);\n            }\n          });\n\n          file.on('end', () => {\n            if (totalBytesRead <= maxFileSize) {\n              const buffer = Buffer.concat(fileChunks);\n\n              files[fieldname] = {\n                fieldname,\n                buffer,\n                originalName: filename,\n                encoding,\n                mimetype,\n              };\n            }\n          });\n        }\n      );\n\n      // Update `req.body` and `req.files`.\n      parser.on('finish', () => {\n        req.body = fields;\n        req.files = files;\n        next();\n      });\n\n      // Pipe the request to Busboy. On Firebase Functions, `rawBody` contains\n      // the multipart request. Otherwise the express request can be piped to\n      // the Busboy parser.\n      if (req.rawBody) {\n        parser.end(req.rawBody);\n      } else {\n        req.pipe(parser);\n      }\n    } else {\n      next();\n    }\n  };\n  return handler;\n}\n","import {NextFunction, Request, Response} from '../core/types.js';\n\nexport const SESSION_COOKIE = '__session';\n\n// 5 days.\nconst DEFAULT_MAX_AGE = 60 * 60 * 24 * 5 * 1000;\n\nexport interface SessionMiddlewareOptions {\n  maxAge?: number;\n}\n\nexport interface SaveSessionOptions {\n  sameSite?: 'strict' | 'lax' | 'none';\n}\n\n/**\n * Middleware for storing session data stored in an http cookie called\n * `__session`. This cookie is compatible with Firebase Hosting:\n * https://firebase.google.com/docs/hosting/manage-cache#using_cookies\n */\nexport function sessionMiddleware(options?: SessionMiddlewareOptions) {\n  const maxAge = options?.maxAge || DEFAULT_MAX_AGE;\n  return (req: Request, res: Response, next: NextFunction) => {\n    const cookieValue = String(req.signedCookies[SESSION_COOKIE] || '');\n    const session = Session.fromCookieValue(cookieValue);\n    req.session = session;\n    res.session = session;\n    res.saveSession = (saveSessionOptions?: SaveSessionOptions) => {\n      // \"secure\" cookies require https, so disable \"secure\" when in development.\n      const secureCookie = Boolean(process.env.NODE_ENV !== 'development');\n      const cookieValue = session.toString();\n      const sameSite = saveSessionOptions?.sameSite || 'strict';\n      res.cookie(SESSION_COOKIE, cookieValue, {\n        maxAge: maxAge,\n        httpOnly: true,\n        secure: secureCookie,\n        signed: true,\n        sameSite: sameSite,\n      });\n    };\n    req.hooks.add('beforeRender', () => {\n      res.saveSession();\n    });\n    next();\n  };\n}\n\nexport class Session {\n  private data: Record<string, string> = {};\n\n  constructor(data?: Record<string, string>) {\n    this.data = data || {};\n  }\n\n  static fromCookieValue(cookieValue: string) {\n    const data: Record<string, string> = {};\n    if (cookieValue.startsWith('b64:')) {\n      try {\n        const encodedStr = cookieValue.slice(4);\n        const params = new URLSearchParams(base64Decode(encodedStr));\n        for (const [key, value] of params.entries()) {\n          data[key] = value;\n        }\n      } catch (err) {\n        console.warn('failed to parse session cookie:', err);\n        return new Session();\n      }\n    }\n    return new Session(data);\n  }\n\n  getItem(key: string): string | null {\n    return this.data[key] ?? null;\n  }\n\n  setItem(key: string, value: string) {\n    this.data[key] = value;\n  }\n\n  removeItem(key: string) {\n    delete this.data[key];\n  }\n\n  toString(): string {\n    const params = new URLSearchParams(this.data);\n    return `b64:${base64Encode(params.toString())}`;\n  }\n}\n\nfunction base64Encode(str: string): string {\n  return Buffer.from(str, 'utf-8').toString('base64');\n}\n\nfunction base64Decode(str: string): string {\n  return Buffer.from(str, 'base64').toString('utf-8');\n}\n"],"mappings":"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","names":["cookieValue"]}
+{"version":3,"sources":["../src/middleware/common.ts","../src/middleware/multipart.ts","../src/middleware/session.ts"],"sourcesContent":["import path from 'node:path';\nimport micromatch from 'micromatch';\nimport {RootConfig} from '../core/config.js';\nimport {Request, Response, NextFunction} from '../core/types.js';\n\n/**\n * Middleware that injects the root.js project config into the request context.\n */\nexport function rootProjectMiddleware(options: {rootConfig: RootConfig}) {\n  return (req: Request, _: Response, next: NextFunction) => {\n    req.rootConfig = options.rootConfig;\n    next();\n  };\n}\n\n/**\n * Middleware that injects HTTP headers from the `server.headers` config in\n * root.config.ts.\n */\nexport function headersMiddleware(options: {rootConfig: RootConfig}) {\n  const headersUserConfig = options.rootConfig.server?.headers || [];\n  // Filter header config values that are invalid.\n  const headersConfig = headersUserConfig.filter((headerConfig) => {\n    return (\n      headerConfig.source &&\n      headerConfig.headers &&\n      headerConfig.headers.length > 0\n    );\n  });\n  return (req: Request, res: Response, next: NextFunction) => {\n    headersConfig.forEach((headerConfig) => {\n      if (micromatch.isMatch(req.path, headerConfig.source)) {\n        headerConfig.headers.forEach((header) => {\n          if (header.key) {\n            res.setHeader(String(header.key), String(header.value));\n          }\n        });\n      }\n    });\n    next();\n  };\n}\n\n/**\n * Trailing slash middleware. Handles trailing slash redirects (preserving any\n * query params) using the `server.trailingSlash` config in root.config.ts.\n */\nexport function trailingSlashMiddleware(options: {rootConfig: RootConfig}) {\n  const trailingSlash = options.rootConfig.server?.trailingSlash;\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    // If `trailingSlash: false`, force a trailing slash in the URL.\n    if (\n      trailingSlash === true &&\n      !path.extname(req.path) &&\n      !req.path.endsWith('/')\n    ) {\n      const redirectPath = `${req.path}/`;\n      redirectWithQuery(req, res, 301, redirectPath);\n      return;\n    }\n\n    // If `trailingSlash: false`, remove any trailing slash from the URL.\n    if (\n      trailingSlash === false &&\n      !path.extname(req.path) &&\n      req.path !== '/' &&\n      req.path.endsWith('/')\n    ) {\n      const redirectPath = removeTrailingSlashes(req.path);\n      redirectWithQuery(req, res, 301, redirectPath);\n      return;\n    }\n\n    next();\n  };\n}\n\n/**\n * Issues an HTTP redirect, preserving any query params from the original req.\n */\nfunction redirectWithQuery(\n  req: Request,\n  res: Response,\n  redirectCode: number,\n  redirectPath: string\n) {\n  const queryStr = getQueryStr(req);\n  const redirectUrl = queryStr ? `${redirectPath}?${queryStr}` : redirectPath;\n  res.redirect(redirectCode, redirectUrl);\n}\n\n/**\n * Returns the query string for a request, or empty string if no query.\n */\nfunction getQueryStr(req: Request): string {\n  const qIndex = req.originalUrl.indexOf('?');\n  if (qIndex === -1) {\n    return '';\n  }\n  return req.originalUrl.slice(qIndex + 1);\n}\n\n/**\n * Removes trailing slashes from a URL path.\n * Note: A path with only slashes (e.g. `///`) returns `/`.\n */\nfunction removeTrailingSlashes(urlPath: string) {\n  while (urlPath.endsWith('/') && urlPath !== '/') {\n    urlPath = urlPath.slice(0, -1);\n  }\n  return urlPath;\n}\n","import busboy from 'busboy';\nimport {RequestHandler} from 'express';\nimport {Request, Response, NextFunction, MultipartFile} from '../core/types.js';\n\nconst DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB\n\n/**\n * Middleware for parsing multipart file uploads that's compatible with the dev\n * server and Firebase Functions.\n *\n * Context:\n * https://stackoverflow.com/questions/47242340/how-to-perform-an-http-file-upload-using-express-on-cloud-functions-for-firebase\n */\nexport function multipartMiddleware(options?: {\n  maxFileSize?: number;\n}): RequestHandler {\n  const maxFileSize = options?.maxFileSize || DEFAULT_MAX_FILE_SIZE;\n  const handler: any = (req: Request, res: Response, next: NextFunction) => {\n    const contentType = String(req.headers['content-type'] || '');\n    if (\n      req.method === 'POST' &&\n      contentType.startsWith('multipart/form-data')\n    ) {\n      const parser = busboy({headers: req.headers});\n\n      // Data storage for fields and files\n      const fields: {[fieldname: string]: string} = {};\n      const files: {[name: string]: MultipartFile} = {};\n\n      // Handle field data.\n      parser.on('field', (fieldname: string, val: any) => {\n        fields[fieldname] = val;\n      });\n\n      // Handle file data. Files are saved to an in-memory buffer.\n      parser.on(\n        'file',\n        (\n          fieldname: string,\n          file: any,\n          meta: {\n            filename: string;\n            encoding: string;\n            mimeType: string;\n          }\n        ) => {\n          const {filename, encoding, mimeType: mimetype} = meta;\n          const fileChunks: Uint8Array[] = [];\n          let totalBytesRead = 0;\n\n          file.on('data', (chunk: Uint8Array) => {\n            totalBytesRead += chunk.length;\n\n            if (totalBytesRead > maxFileSize) {\n              // File size exceeds the limit, stop reading.\n              console.error(`File size exceeds the limit: ${fieldname}.`);\n              file.removeAllListeners('data');\n              // Consume and discard remaining data.\n              file.resume();\n            } else {\n              fileChunks.push(chunk);\n            }\n          });\n\n          file.on('end', () => {\n            if (totalBytesRead <= maxFileSize) {\n              const buffer = Buffer.concat(fileChunks);\n\n              files[fieldname] = {\n                fieldname,\n                buffer,\n                originalName: filename,\n                encoding,\n                mimetype,\n              };\n            }\n          });\n        }\n      );\n\n      // Update `req.body` and `req.files`.\n      parser.on('finish', () => {\n        req.body = fields;\n        req.files = files;\n        next();\n      });\n\n      // Pipe the request to Busboy. On Firebase Functions, `rawBody` contains\n      // the multipart request. Otherwise the express request can be piped to\n      // the Busboy parser.\n      if (req.rawBody) {\n        parser.end(req.rawBody);\n      } else {\n        req.pipe(parser);\n      }\n    } else {\n      next();\n    }\n  };\n  return handler;\n}\n","import {NextFunction, Request, Response} from '../core/types.js';\n\nexport const SESSION_COOKIE = '__session';\n\n// 5 days.\nconst DEFAULT_MAX_AGE = 60 * 60 * 24 * 5 * 1000;\n\nexport interface SessionMiddlewareOptions {\n  maxAge?: number;\n}\n\nexport interface SaveSessionOptions {\n  sameSite?: 'strict' | 'lax' | 'none';\n}\n\n/**\n * Middleware for storing session data stored in an http cookie called\n * `__session`. This cookie is compatible with Firebase Hosting:\n * https://firebase.google.com/docs/hosting/manage-cache#using_cookies\n */\nexport function sessionMiddleware(options?: SessionMiddlewareOptions) {\n  const maxAge = options?.maxAge || DEFAULT_MAX_AGE;\n  return (req: Request, res: Response, next: NextFunction) => {\n    const cookieValue = String(req.signedCookies[SESSION_COOKIE] || '');\n    const session = Session.fromCookieValue(cookieValue);\n    req.session = session;\n    res.session = session;\n    res.saveSession = (saveSessionOptions?: SaveSessionOptions) => {\n      // \"secure\" cookies require https, so disable \"secure\" when in development.\n      const secureCookie = Boolean(process.env.NODE_ENV !== 'development');\n      const cookieValue = session.toString();\n      const sameSite = saveSessionOptions?.sameSite || 'strict';\n      res.cookie(SESSION_COOKIE, cookieValue, {\n        maxAge: maxAge,\n        httpOnly: true,\n        secure: secureCookie,\n        signed: true,\n        sameSite: sameSite,\n      });\n    };\n    req.hooks.add('preRender', () => {\n      res.saveSession();\n    });\n    next();\n  };\n}\n\nexport class Session {\n  private data: Record<string, string> = {};\n\n  constructor(data?: Record<string, string>) {\n    this.data = data || {};\n  }\n\n  static fromCookieValue(cookieValue: string) {\n    const data: Record<string, string> = {};\n    if (cookieValue.startsWith('b64:')) {\n      try {\n        const encodedStr = cookieValue.slice(4);\n        const params = new URLSearchParams(base64Decode(encodedStr));\n        for (const [key, value] of params.entries()) {\n          data[key] = value;\n        }\n      } catch (err) {\n        console.warn('failed to parse session cookie:', err);\n        return new Session();\n      }\n    }\n    return new Session(data);\n  }\n\n  getItem(key: string): string | null {\n    return this.data[key] ?? null;\n  }\n\n  setItem(key: string, value: string) {\n    this.data[key] = value;\n  }\n\n  removeItem(key: string) {\n    delete this.data[key];\n  }\n\n  toString(): string {\n    const params = new URLSearchParams(this.data);\n    return `b64:${base64Encode(params.toString())}`;\n  }\n}\n\nfunction base64Encode(str: string): string {\n  return Buffer.from(str, 'utf-8').toString('base64');\n}\n\nfunction base64Decode(str: string): string {\n  return Buffer.from(str, 'base64').toString('utf-8');\n}\n"],"mappings":"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","names":["cookieValue"]}

package/dist/{chunk-YKQ4SVXX.js → chunk-G5ALYSEQ.js}

@@ -1,6 +1,6 @@
 import {
   getVitePlugins
-} from "./chunk-6JZGMQBR.js";
+} from "./chunk-WICFYADD.js";
 
 // src/node/load-config.ts
 import path2 from "node:path";
@@ -264,4 +264,4 @@ export {
   createViteServer,
   viteSsrLoadModule
 };
-//# sourceMappingURL=chunk-YKQ4SVXX.js.map
+//# sourceMappingURL=chunk-G5ALYSEQ.js.map

package/dist/{chunk-U2COJCIX.js → chunk-GNRN2XDJ.js}

@@ -3,7 +3,7 @@ import {
   rootProjectMiddleware,
   sessionMiddleware,
   trailingSlashMiddleware
-} from "./chunk-MLPPFGKW.js";
+} from "./chunk-BMKSXG4B.js";
 import {
   bundleRootConfig,
   copyDir,
@@ -21,11 +21,11 @@ import {
   rmDir,
   writeFile,
   writeJson
-} from "./chunk-YKQ4SVXX.js";
+} from "./chunk-G5ALYSEQ.js";
 import {
   configureServerPlugins,
   getVitePlugins
-} from "./chunk-6JZGMQBR.js";
+} from "./chunk-WICFYADD.js";
 import {
   RouteTrie,
   htmlMinify,
@@ -687,24 +687,104 @@ function formatParams(params) {
   }).join("\n");
 }
 
-// src/cli/create-package.ts
+// src/cli/codegen.ts
 import { promises as fs3 } from "node:fs";
 import path4 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import glob3 from "tiny-glob";
+var __dirname2 = path4.dirname(fileURLToPath2(import.meta.url));
+async function codegen(type, name, options) {
+  const rootDir = path4.resolve(process.cwd());
+  const project = new Project(rootDir);
+  await project.generateCode(type, name, options);
+}
+var Project = class {
+  rootDir;
+  tplDirs;
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+    this.tplDirs = [
+      path4.join(rootDir, "codegen"),
+      path4.join(__dirname2, "../codegen")
+    ];
+  }
+  async generateCode(type, name, options) {
+    const files = await this.loadFiles(type);
+    if (Object.keys(files).length === 0) {
+      console.log(`no files in codegen/${type}/*.tpl`);
+      return;
+    }
+    const outname = options?.out || `${type}s`;
+    const outdir = path4.join(this.rootDir, outname, name);
+    if (await dirExists(outdir)) {
+      await rmDir(outdir);
+    }
+    await makeDir(outdir);
+    for (const tplName in files) {
+      const tpl = await files[tplName].read();
+      const content = tpl.replaceAll("[[name]]", name).replaceAll("[[name:camel_upper]]", toCamelCaseUpper(name));
+      const filename = tplName.replace("[name]", name);
+      const filepath = path4.join(outdir, filename);
+      await writeFile(filepath, content);
+      console.log(`saved ${filepath}`);
+    }
+  }
+  /**
+   * Searches the project's "codegen" dir (or fallsback to root's "codegen" dir)
+   * and returns a `TemplateMap` for all files in `codgen/<type>/*.tpl`.
+   */
+  async loadFiles(type) {
+    for (const tplDir of this.tplDirs) {
+      const typeDir = path4.join(tplDir, type);
+      if (await dirExists(typeDir)) {
+        return this.loadTplFiles(typeDir);
+      }
+    }
+    return {};
+  }
+  /**
+   * Reads files matching `*.tpl` in a given directory.
+   */
+  async loadTplFiles(dirpath) {
+    const tplFiles = {};
+    const files = await glob3("*.tpl", { cwd: dirpath });
+    for (const filename of files) {
+      const filepath = path4.join(dirpath, filename);
+      const name = filename.slice(0, -4);
+      tplFiles[name] = {
+        read: () => fs3.readFile(filepath, "utf-8")
+      };
+    }
+    return tplFiles;
+  }
+};
+function toCamelCaseUpper(str) {
+  const segments = str.split("-");
+  return segments.map((part) => toTitleCase(part)).join("");
+}
+function toTitleCase(str) {
+  const ch = String(str).charAt(0).toUpperCase();
+  return `${ch}${str.slice(1)}`;
+}
+
+// src/cli/create-package.ts
+import { promises as fs4 } from "node:fs";
+import path5 from "node:path";
 import { build as esbuild } from "esbuild";
 async function createPackage(rootProjectDir, options) {
   const mode = options?.mode || "production";
   process.env.NODE_ENV = mode;
-  const rootDir = path4.resolve(rootProjectDir || process.cwd());
-  const distDir = path4.join(rootDir, "dist");
+  const rootDir = path5.resolve(rootProjectDir || process.cwd());
+  const distDir = path5.join(rootDir, "dist");
   const target = options?.target || await getDefaultTarget(rootDir);
-  const outDir = path4.resolve(options?.out || target || "out");
+  const outDir = path5.resolve(options?.out || target || "out");
   await build(rootProjectDir, { ssrOnly: true, mode });
   await rmDir(outDir);
   await makeDir(outDir);
-  await copyDir(distDir, path4.resolve(outDir, "dist"));
-  const collectionsDir = path4.resolve(rootDir, "collections");
+  await copyDir(distDir, path5.resolve(outDir, "dist"));
+  const collectionsDir = path5.resolve(rootDir, "collections");
   if (await dirExists(collectionsDir)) {
-    await copyDir(collectionsDir, path4.join(outDir, "collections"));
+    await copyDir(collectionsDir, path5.join(outDir, "collections"));
   }
   const packageJson = await generatePackageJson(rootDir);
   if (options?.version && packageJson.dependencies) {
@@ -723,16 +803,16 @@ async function createPackage(rootProjectDir, options) {
   } else if (target === "firebase") {
     await onFirebase({ rootDir, packageJson, outDir });
   }
-  await writeJson(path4.resolve(outDir, "package.json"), packageJson);
+  await writeJson(path5.resolve(outDir, "package.json"), packageJson);
   console.log("done!");
   console.log(`saved package to ${outDir}`);
 }
 async function getDefaultTarget(rootDir) {
-  const firebaseConfigPath = path4.resolve(rootDir, "firebase.json");
+  const firebaseConfigPath = path5.resolve(rootDir, "firebase.json");
   if (await fileExists(firebaseConfigPath)) {
     return "firebase";
   }
-  const appEngineConfigPath = path4.resolve(rootDir, "app.yaml");
+  const appEngineConfigPath = path5.resolve(rootDir, "app.yaml");
   if (await fileExists(appEngineConfigPath)) {
     return "appengine";
   }
@@ -740,7 +820,7 @@ async function getDefaultTarget(rootDir) {
 }
 async function generatePackageJson(rootDir) {
   const packageJson = await loadJson(
-    path4.resolve(rootDir, "package.json")
+    path5.resolve(rootDir, "package.json")
   );
   if (packageJson.peerDependencies) {
     await updatePeerDepsFromWorkspace(rootDir, packageJson);
@@ -756,7 +836,7 @@ async function updatePeerDepsFromWorkspace(rootDir, packageJson) {
   if (!workspaceRoot) {
     return;
   }
-  const workspacePackageJsonPath = path4.resolve(workspaceRoot, "package.json");
+  const workspacePackageJsonPath = path5.resolve(workspaceRoot, "package.json");
   const workspacePackageJson = await loadJson(
     workspacePackageJsonPath
   );
@@ -779,15 +859,15 @@ async function updatePeerDepsFromWorkspace(rootDir, packageJson) {
   }
 }
 async function findWorkspaceRoot(rootDir) {
-  const parentDir = path4.dirname(rootDir);
+  const parentDir = path5.dirname(rootDir);
   if (parentDir === "/") {
     return null;
   }
-  const pnpmWorkspaceFile = path4.resolve(parentDir, "pnpm-workspace.yaml");
+  const pnpmWorkspaceFile = path5.resolve(parentDir, "pnpm-workspace.yaml");
   if (await fileExists(pnpmWorkspaceFile)) {
     return parentDir;
   }
-  const packageJsonPath = path4.resolve(parentDir, "package.json");
+  const packageJsonPath = path5.resolve(parentDir, "package.json");
   if (await fileExists(packageJsonPath)) {
     const parentPackageJson = await loadJson(packageJsonPath);
     if (parentPackageJson && parentPackageJson.workspaces) {
@@ -809,21 +889,31 @@ function getRequiredPeerDeps(packageJson) {
   return requiredPeerDeps;
 }
 async function onAppEngine(options) {
-  const { rootDir, outDir } = options;
-  const configPath = path4.resolve(rootDir, "app.yaml");
+  const { rootDir, outDir, packageJson } = options;
+  const configPath = path5.resolve(rootDir, "app.yaml");
   if (await fileExists(configPath)) {
-    await fs3.copyFile(configPath, path4.resolve(outDir, "app.yaml"));
+    await fs4.copyFile(configPath, path5.resolve(outDir, "app.yaml"));
+  }
+  if (packageJson.scripts?.start) {
+    packageJson.scripts = { start: packageJson.scripts.start };
+  } else {
+    packageJson.scripts = { start: "root start --host=0.0.0.0" };
   }
 }
 async function onFirebase(options) {
-  const { rootDir, outDir } = options;
-  const outBasename = path4.basename(outDir);
+  const { rootDir, outDir, packageJson } = options;
+  const outBasename = path5.basename(outDir);
   if (outBasename === "functions") {
-    const indexTsFile = path4.resolve(rootDir, "index.ts");
+    const indexTsFile = path5.resolve(rootDir, "index.ts");
     if (await fileExists(indexTsFile)) {
-      await bundleTsFile(indexTsFile, path4.resolve(outDir, "index.js"));
+      await bundleTsFile(indexTsFile, path5.resolve(outDir, "index.js"));
     }
   }
+  if (packageJson.scripts?.start) {
+    packageJson.scripts = { start: packageJson.scripts.start };
+  } else {
+    packageJson.scripts = { start: "root start --host=0.0.0.0" };
+  }
 }
 async function bundleTsFile(srcPath, outPath) {
   await esbuild({
@@ -841,7 +931,7 @@ async function bundleTsFile(srcPath, outPath) {
         setup(build2) {
           build2.onResolve({ filter: /.*/ }, (args) => {
             const id = args.path;
-            if (id[0] !== "." && !path4.isAbsolute(id)) {
+            if (id[0] !== "." && !path5.isAbsolute(id)) {
               return {
                 external: true
               };
@@ -855,13 +945,13 @@ async function bundleTsFile(srcPath, outPath) {
 }
 
 // src/cli/dev.ts
-import path6 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import path7 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import cookieParser from "cookie-parser";
 import { default as express } from "express";
 import { dim as dim2 } from "kleur/colors";
 import sirv from "sirv";
-import glob3 from "tiny-glob";
+import glob4 from "tiny-glob";
 
 // src/middleware/hooks.ts
 function hooksMiddleware() {
@@ -930,7 +1020,7 @@ function replaceParams(urlPathFormat, params) {
 }
 
 // src/render/asset-map/dev-asset-map.ts
-import path5 from "node:path";
+import path6 from "node:path";
 import { searchForWorkspaceRoot as searchForWorkspaceRoot2 } from "vite";
 var DevServerAssetMap = class {
   rootConfig;
@@ -940,7 +1030,7 @@ var DevServerAssetMap = class {
     this.moduleGraph = moduleGraph;
   }
   async get(src) {
-    const file = path5.resolve(this.rootConfig.rootDir, src);
+    const file = path6.resolve(this.rootConfig.rootDir, src);
     const viteModules = this.moduleGraph.getModulesByFile(file);
     if (viteModules && viteModules.size > 0) {
       const [viteModule] = viteModules;
@@ -972,7 +1062,7 @@ var DevServerAssetMap = class {
     return null;
   }
   filePathToSrc(file) {
-    return path5.relative(this.rootConfig.rootDir, file);
+    return path6.relative(this.rootConfig.rootDir, file);
   }
 };
 var DevServerAsset = class _DevServerAsset {
@@ -1014,7 +1104,7 @@ var DevServerAsset = class _DevServerAsset {
       return;
     }
     visited.add(asset.moduleId);
-    const parts = path5.parse(asset.assetUrl);
+    const parts = path6.parse(asset.assetUrl);
     if ([".js", ".jsx", ".ts", ".tsx"].includes(parts.ext) && asset.moduleId.includes("/elements/")) {
       urls.add(asset.assetUrl);
     }
@@ -1041,7 +1131,7 @@ var DevServerAsset = class _DevServerAsset {
     }
     visited.add(asset.assetUrl);
     if (asset.src.endsWith(".scss")) {
-      const parts = path5.parse(asset.src);
+      const parts = path6.parse(asset.src);
       if (!parts.name.startsWith("_")) {
         urls.add(asset.assetUrl);
       }
@@ -1108,10 +1198,10 @@ function randString(len) {
 }
 
 // src/cli/dev.ts
-var __dirname2 = path6.dirname(fileURLToPath2(import.meta.url));
+var __dirname3 = path7.dirname(fileURLToPath3(import.meta.url));
 async function dev(rootProjectDir, options) {
   process.env.NODE_ENV = "development";
-  const rootDir = path6.resolve(rootProjectDir || process.cwd());
+  const rootDir = path7.resolve(rootProjectDir || process.cwd());
   const defaultPort = parseInt(process.env.PORT || "4007");
   const host = options?.host || "localhost";
   const port = await findOpenPort(defaultPort, defaultPort + 10);
@@ -1129,7 +1219,7 @@ async function dev(rootProjectDir, options) {
   server.listen(port, host);
 }
 async function createDevServer(options) {
-  const rootDir = path6.resolve(options?.rootDir || process.cwd());
+  const rootDir = path7.resolve(options?.rootDir || process.cwd());
   const rootConfig = await loadRootConfig(rootDir, { command: "dev" });
   const port = options?.port;
   const server = express();
@@ -1162,7 +1252,7 @@ async function createDevServer(options) {
       if (rootConfig.server?.headers) {
         server.use(headersMiddleware({ rootConfig }));
       }
-      const publicDir = path6.join(rootDir, "public");
+      const publicDir = path7.join(rootDir, "public");
       if (await dirExists(publicDir)) {
         server.use(rootPublicDirMiddleware({ publicDir, viteServer }));
       }
@@ -1184,10 +1274,10 @@ async function createViteMiddleware(options) {
     return sourceFile.relPath;
   });
   const bundleScripts = [];
-  if (await isDirectory(path6.join(rootDir, "bundles"))) {
-    const bundleFiles = await glob3("bundles/*", { cwd: rootDir });
+  if (await isDirectory(path7.join(rootDir, "bundles"))) {
+    const bundleFiles = await glob4("bundles/*", { cwd: rootDir });
     bundleFiles.forEach((file) => {
-      const parts = path6.parse(file);
+      const parts = path7.parse(file);
       if (isJsFile(parts.base)) {
         bundleScripts.push(file);
       }
@@ -1199,7 +1289,7 @@ async function createViteMiddleware(options) {
     optimizeDeps
   });
   function isInElementsDir(changedFilePath) {
-    const filePath = path6.resolve(changedFilePath);
+    const filePath = path7.resolve(changedFilePath);
     const elementsDirs = getElementsDirs(rootConfig);
     return elementsDirs.some((dirPath) => filePath.startsWith(dirPath));
   }
@@ -1218,7 +1308,7 @@ async function createViteMiddleware(options) {
   const viteMiddleware = async (req, res, next) => {
     try {
       req.viteServer = viteServer;
-      const renderModulePath = path6.resolve(__dirname2, "./render.js");
+      const renderModulePath = path7.resolve(__dirname3, "./render.js");
       const render = await viteServer.ssrLoadModule(
         renderModulePath
       );
@@ -1242,7 +1332,7 @@ function rootPublicDirMiddleware(options) {
     handler = sirv(publicDir, sirvOptions);
   }, 1e3);
   function isInPublicDir(changedFilePath) {
-    const filePath = path6.resolve(changedFilePath);
+    const filePath = path7.resolve(changedFilePath);
     return filePath.startsWith(publicDir);
   }
   const watcher = options.viteServer.watcher;
@@ -1272,7 +1362,7 @@ function rootDevServer404Middleware() {
     console.error(`\u2753 404 ${req.originalUrl}`);
     if (req.renderer) {
       const url = req.path;
-      const ext = path6.extname(url);
+      const ext = path7.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.renderDevServer404(req);
@@ -1290,7 +1380,7 @@ function rootDevServer500Middleware() {
     console.error(String(err.stack || err));
     if (req.renderer) {
       const url = req.path;
-      const ext = path6.extname(url);
+      const ext = path7.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.renderDevServer500(req, err);
@@ -1315,7 +1405,7 @@ function debounce(fn, timeout) {
 }
 
 // src/cli/preview.ts
-import path7 from "node:path";
+import path8 from "node:path";
 import compression from "compression";
 import cookieParser2 from "cookie-parser";
 import { default as express2 } from "express";
@@ -1323,7 +1413,7 @@ import { dim as dim3 } from "kleur/colors";
 import sirv2 from "sirv";
 async function preview(rootProjectDir, options) {
   process.env.NODE_ENV = "development";
-  const rootDir = path7.resolve(rootProjectDir || process.cwd());
+  const rootDir = path8.resolve(rootProjectDir || process.cwd());
   const server = await createPreviewServer({ rootDir });
   const port = parseInt(process.env.PORT || "4007");
   const host = options?.host || "localhost";
@@ -1337,7 +1427,7 @@ async function preview(rootProjectDir, options) {
 async function createPreviewServer(options) {
   const rootDir = options.rootDir;
   const rootConfig = await loadBundledConfig(rootDir, { command: "preview" });
-  const distDir = path7.join(rootDir, "dist");
+  const distDir = path8.join(rootDir, "dist");
   const server = express2();
   server.disable("x-powered-by");
   server.use(compression());
@@ -1363,7 +1453,7 @@ async function createPreviewServer(options) {
       if (rootConfig.server?.headers) {
         server.use(headersMiddleware({ rootConfig }));
       }
-      const publicDir = path7.join(distDir, "html");
+      const publicDir = path8.join(distDir, "html");
       server.use(sirv2(publicDir, { dev: false }));
       server.use(trailingSlashMiddleware({ rootConfig }));
       server.use(rootPreviewServerMiddleware());
@@ -1377,14 +1467,14 @@ async function createPreviewServer(options) {
 }
 async function rootPreviewRendererMiddleware(options) {
   const { distDir, rootConfig } = options;
-  const render = await import(path7.join(distDir, "server/render.js"));
-  const manifestPath = path7.join(distDir, ".root/manifest.json");
+  const render = await import(path8.join(distDir, "server/render.js"));
+  const manifestPath = path8.join(distDir, ".root/manifest.json");
   if (!await fileExists(manifestPath)) {
     throw new Error(
       `could not find ${manifestPath}. run \`root build\` before \`root preview\`.`
     );
   }
-  const elementGraphJsonPath = path7.join(distDir, ".root/elements.json");
+  const elementGraphJsonPath = path8.join(distDir, ".root/elements.json");
   if (!await fileExists(elementGraphJsonPath)) {
     throw new Error(
       `could not find ${elementGraphJsonPath}. run \`root build\` before \`root preview\`.`
@@ -1424,7 +1514,7 @@ function rootPreviewServer404Middleware() {
     console.error(`\u2753 404 ${req.originalUrl}`);
     if (req.renderer) {
       const url = req.path;
-      const ext = path7.extname(url);
+      const ext = path8.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.render404({ currentPath: url });
@@ -1442,7 +1532,7 @@ function rootPreviewServer500Middleware() {
     console.error(String(err.stack || err));
     if (req.renderer) {
       const url = req.path;
-      const ext = path7.extname(url);
+      const ext = path8.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.renderDevServer500(req, err);
@@ -1456,7 +1546,7 @@ function rootPreviewServer500Middleware() {
 }
 
 // src/cli/start.ts
-import path8 from "node:path";
+import path9 from "node:path";
 import compression2 from "compression";
 import cookieParser3 from "cookie-parser";
 import { default as express3 } from "express";
@@ -1464,7 +1554,7 @@ import { dim as dim4 } from "kleur/colors";
 import sirv3 from "sirv";
 async function start(rootProjectDir, options) {
   process.env.NODE_ENV = "production";
-  const rootDir = path8.resolve(rootProjectDir || process.cwd());
+  const rootDir = path9.resolve(rootProjectDir || process.cwd());
   const server = await createProdServer({ rootDir });
   const port = parseInt(process.env.PORT || "4007");
   const host = options?.host || "localhost";
@@ -1478,7 +1568,7 @@ async function start(rootProjectDir, options) {
 async function createProdServer(options) {
   const rootDir = options.rootDir;
   const rootConfig = await loadBundledConfig(rootDir, { command: "start" });
-  const distDir = path8.join(rootDir, "dist");
+  const distDir = path9.join(rootDir, "dist");
   const server = express3();
   server.disable("x-powered-by");
   server.use(compression2());
@@ -1504,7 +1594,7 @@ async function createProdServer(options) {
       if (rootConfig.server?.headers) {
         server.use(headersMiddleware({ rootConfig }));
       }
-      const publicDir = path8.join(distDir, "html");
+      const publicDir = path9.join(distDir, "html");
       server.use(sirv3(publicDir, { dev: false }));
       server.use(trailingSlashMiddleware({ rootConfig }));
       server.use(rootProdServerMiddleware());
@@ -1518,14 +1608,14 @@ async function createProdServer(options) {
 }
 async function rootProdRendererMiddleware(options) {
   const { distDir, rootConfig } = options;
-  const render = await import(path8.join(distDir, "server/render.js"));
-  const manifestPath = path8.join(distDir, ".root/manifest.json");
+  const render = await import(path9.join(distDir, "server/render.js"));
+  const manifestPath = path9.join(distDir, ".root/manifest.json");
   if (!await fileExists(manifestPath)) {
     throw new Error(
       `could not find ${manifestPath}. run \`root build\` before \`root start\`.`
     );
   }
-  const elementGraphJsonPath = path8.join(distDir, ".root/elements.json");
+  const elementGraphJsonPath = path9.join(distDir, ".root/elements.json");
   if (!await fileExists(elementGraphJsonPath)) {
     throw new Error(
       `could not find ${elementGraphJsonPath}. run \`root build\` before \`root start\`.`
@@ -1565,7 +1655,7 @@ function rootProdServer404Middleware() {
     console.error(`\u2753 404 ${req.originalUrl}`);
     if (req.renderer) {
       const url = req.path;
-      const ext = path8.extname(url);
+      const ext = path9.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.render404({ currentPath: url });
@@ -1583,7 +1673,7 @@ function rootProdServer500Middleware() {
     console.error(String(err.stack || err));
     if (req.renderer) {
       const url = req.path;
-      const ext = path8.extname(url);
+      const ext = path9.extname(url);
       if (!ext) {
         const renderer = req.renderer;
         const data = await renderer.renderError(err);
@@ -1625,6 +1715,7 @@ var CliRunner = class {
       "number of files to build concurrently",
       "10"
     ).action(build);
+    program.command("codegen [type] [name]").description("generates boilerplate code").option("--out <outdir>", "output dir").action(codegen);
     program.command("create-package [path]").alias("package").description(
       "creates a standalone npm package for deployment to various hosting services"
     ).option("--target <target>", "hosting target, i.e. appengine or firebase").option("--out <outdir>", "output dir").option("--mode <mode>", "deployment mode, i.e. production or preview").action((rootPackageDir, options) => {
@@ -1658,4 +1749,4 @@ export {
   createProdServer,
   CliRunner
 };
-//# sourceMappingURL=chunk-U2COJCIX.js.map
+//# sourceMappingURL=chunk-GNRN2XDJ.js.map