create-nifra 3.5.0 → 4.0.2

package/dist/scaffold/site-files.js

@@ -1,93 +1,60 @@
 /**
- * The rest of a site scaffold's mechanical files: the adapter re-export, the manifest, the tsconfig.
- *
- * Same argument as `site-build.ts`. These three were five copies each whose only real difference was
- * which framework they name, and keeping five copies is how `.vercel` came to be excluded from four
- * tsconfigs and not the fifth.
+ * A site scaffold's mechanical files: the adapter re-export, the manifest, the tsconfig. These were
+ * five copies each whose only real difference was which framework they name, and keeping five copies
+ * is how `.vercel` came to be excluded from four tsconfigs and not the fifth.
  */
 import { NIFRA_DEP_RANGE } from "./frameworks.js";
+import { deployScript, TARGETS } from "./targets.js";
 /** JSON as these files are written: two-space indent, trailing newline. */
 const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
 /**
- * `framework.ts` - the one file every server entry imports the adapter from, which is what keeps the
- * entries themselves framework-agnostic and therefore shareable.
+ * `backend/framework.ts` - the file the generated server entry imports the adapter from. It stays
+ * edge-bundlable: CLI-only tooling (Vite plugins, compilers) lives in `nifra.config.ts`.
  */
 export function renderFrameworkModule(framework) {
     return `// The frontend adapter for this app. \`create-nifra --framework <react|preact|vue|solid|svelte>\` swaps
-// this one line (and the routes + build config); every server entry imports the adapter from here, so
-// they stay framework-agnostic.
+// this one line (and the routes + build config); the server entry \`nifra build\` generates imports the
+// adapter from here, so it stays framework-agnostic.
 import { ${framework.adapter} } from "${framework.package}"
 
 export const adapter = ${framework.adapter}
 `;
 }
-/** The scripts every site scaffold ships, identical across frameworks. */
-const SCRIPTS = {
-    dev: "nifra dev",
-    preview: "bunx wrangler pages dev dist",
-    build: "bun run build.ts",
-    "build:bun": "bun run build-bun.ts",
-    "build:node": "bun run build-node.ts",
-    "build:deno": "bun run build-deno.ts",
-    "build:vercel": "bun run build-vercel.ts",
-    start: "bun dist-bun/server-bun.js",
-    "start:node": "node dist-node/server-node.js",
-    "deploy:cf": "wrangler pages deploy dist",
-    "deploy:vercel": "vercel deploy --prebuilt",
-    check: "nifra check && nifra assure",
-};
-/** Nifra packages every site depends on, whatever it renders with. */
-const NIFRA_RUNTIME = ["client", "core", "middleware", "schema", "deno", "node", "web"];
-export function renderPackageJson(framework) {
+/** Nifra packages every site depends on, whatever it renders with and wherever it deploys. */
+const NIFRA_RUNTIME = ["client", "core", "middleware", "schema", "web"];
+export function renderPackageJson(framework, site) {
+    const spec = TARGETS[site.target];
     const dependencies = {};
-    for (const name of NIFRA_RUNTIME)
+    for (const name of [...NIFRA_RUNTIME, ...(spec.runtime ?? [])].sort()) {
         dependencies[`@nifrajs/${name}`] = NIFRA_DEP_RANGE;
+    }
     dependencies[framework.package] = NIFRA_DEP_RANGE;
     Object.assign(dependencies, framework.runtimeDependencies);
+    const deploy = deployScript(site.target, site.name, site.docker);
     return json({
         name: "nifra-site",
         version: "0.0.0",
         type: "module",
         private: true,
-        scripts: SCRIPTS,
+        scripts: {
+            dev: "nifra dev",
+            build: "nifra build",
+            ...(spec.start === undefined ? {} : { start: spec.start }),
+            ...(deploy === undefined ? {} : { deploy }),
+            check: "nifra check && nifra assure",
+        },
         dependencies,
         devDependencies: {
             "@nifrajs/cli": NIFRA_DEP_RANGE,
+            "@types/bun": "^1.4.2",
             ...framework.devDependencies,
             typescript: "^6.0.3",
             vite: "^8.2.1",
         },
     });
 }
-/**
- * Directories a build writes and a typecheck must not read, plus the entries that are run by Bun
- * rather than typechecked as part of the app.
- *
- * `.vercel` is in here for every framework. It was missing from React's copy alone, which is the shape
- * this whole refactor is about: `build-vercel.ts` writes there in all five, and four tsconfigs knew.
- */
-const EXCLUDE = [
-    "node_modules",
-    "dist",
-    "dist-bun",
-    "dist-node",
-    "dist-deno",
-    "dist-vercel",
-    ".nifra",
-    ".vercel",
-    ".wrangler",
-    "server-manifest.ts",
-    "server-bun.ts",
-    "server-node.ts",
-    "server-deno.ts",
-    "server-vercel.ts",
-    "_worker.ts",
-    "build.ts",
-    "build-bun.ts",
-    "build-node.ts",
-    "build-deno.ts",
-    "build-vercel.ts",
-];
+/** Directories a build writes and a typecheck must not read. */
+const EXCLUDE = ["node_modules", "dist", ".nifra", ".nifra-build", ".vercel", ".wrangler"];
 export function renderTsconfig(framework) {
     const ts = framework.typescript;
     return json({
@@ -103,9 +70,11 @@ export function renderTsconfig(framework) {
             skipLibCheck: true,
             noEmit: true,
             verbatimModuleSyntax: true,
-            ...(ts.types === undefined ? {} : { types: ts.types }),
+            types: ["bun", ...(ts.types ?? [])],
+            // Merges the generated `.nifra/types` tree in, so a route imports its types as `./+types/<name>`.
+            rootDirs: [".", "./.nifra/types"],
         },
-        include: ts.includeTsx === false ? ["**/*.ts"] : ["**/*.ts", "**/*.tsx"],
+        include: ts.include ?? ["**/*.ts", "**/*.tsx"],
         exclude: EXCLUDE,
     });
 }

package/dist/scaffold/site-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"site-files.js","sourceRoot":"","sources":["../../src/scaffold/site-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"site-files.js","sourceRoot":"","sources":["../../src/scaffold/site-files.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/site.d.ts

@@ -1,4 +1,5 @@
 import { type FrameworkSpec } from "./frameworks.js";
+import { type SiteTarget } from "./site-files.js";
 /**
  * Files identical in every site scaffold, taken from the base directory.
  *
@@ -9,16 +10,18 @@ import { type FrameworkSpec } from "./frameworks.js";
 export declare const SHARED_SITE_FILES: readonly string[];
 /** Files each framework supplies itself, relative to its overlay directory. */
 export declare const FRAMEWORK_SITE_FILES: readonly string[];
-/** Route files, whose extension is the framework's own. */
+/** Route frontend files, whose extension is the framework's own. The backend half is shared. */
 export declare const ROUTE_BASENAMES: readonly string[];
 /** Extension the framework's route files carry. */
 export declare function routeExtension(framework: FrameworkSpec): string;
 /** The base directory: the shared files plus React's own, which is also the React overlay. */
 export declare const SITE_BASE_DIR: string;
 export declare function overlayDir(framework: FrameworkSpec): string;
-/** Every file a site scaffold emits, and the text it holds. Generated files only. */
-export declare function generatedSiteFiles(framework: FrameworkSpec): Map<string, string>;
-export interface MaterializeOptions {
+/** Every file a site scaffold generates, and the text it holds. */
+export declare function generatedSiteFiles(framework: FrameworkSpec, site: SiteTarget): Map<string, string>;
+/** The framework's `nifra.config.ts`, declaring the target `nifra build` emits. */
+export declare function withTarget(config: string, site: SiteTarget): string;
+export interface MaterializeOptions extends SiteTarget {
     /** Overwrite an existing destination. Default false, which refuses rather than clobbers. */
     readonly force?: boolean;
 }
@@ -29,5 +32,5 @@ export interface MaterializeOptions {
  * `errorOnExist` did that before this was generated, and losing it would turn a mistyped path into
  * silent data loss in someone's working directory. `--force` is what `bun create nifra .` needs.
  */
-export declare function materializeSite(target: string, id: string, options?: MaterializeOptions): Promise<void>;
+export declare function materializeSite(target: string, id: string, options: MaterializeOptions): Promise<void>;
 //# sourceMappingURL=site.d.ts.map

package/dist/scaffold/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/scaffold/site.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,iBAAiB,CAAA;AAInE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAc9C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAqC,CAAA;AAEvF,2DAA2D;AAC3D,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiC,CAAA;AAE9E,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI/D;AAGD,8FAA8F;AAC9F,eAAO,MAAM,aAAa,QAA0C,CAAA;AACpE,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI3D;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/scaffold/site.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,iBAAiB,CAAA;AAEnE,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAGxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAM9C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAqC,CAAA;AAEvF,gGAAgG;AAChG,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiC,CAAA;AAE9E,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI/D;AAGD,8FAA8F;AAC9F,eAAO,MAAM,aAAa,QAA0C,CAAA;AACpE,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI3D;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,UAAU,GACf,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrB;AAcD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnE;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/scaffold/site.js

@@ -1,21 +1,23 @@
 /**
- * Compose a site scaffold: shared base, generated files, framework overlay.
+ * Compose a site scaffold: shared base, generated files, framework overlay, target files.
  *
- * A site is 26 files. Thirteen are the same whatever you render with - the Dockerfile, every server
- * entry, the worker, the assurance config - eight are mechanical enough to emit from a model, and five
- * are genuinely the framework's own. Keeping five copies of all 26 is what let `.vercel` reach four
- * tsconfigs and not the fifth, and a Vercel comment reach one build entry and not the other four.
+ * A site is the same few files whatever it renders with or deploys to - the backend, the assurance
+ * config, the landing page's backend half - plus what is mechanical enough to emit from a model (the
+ * manifest, the tsconfig, the adapter module, the target's config), and the files that are genuinely
+ * the framework's own. There is no per-runtime server entry or build script: `nifra build` generates
+ * the target's entry from `backend/` and `routes/`.
  *
- * The five that stay literal stay literal on purpose. `nifra.config.ts` explains why Solid wants a
- * `solid` resolve condition and what `@preact/preset-vite` is; the routes are the app a user reads
- * first. That prose belongs in a file you can open, not in a TypeScript string.
+ * The framework files stay literal on purpose. `nifra.config.ts` explains why Solid wants a `solid`
+ * resolve condition and what `@preact/preset-vite` is; the routes are the app a user reads first. That
+ * prose belongs in a file you can open, not in a TypeScript string.
  */
-import { cp, mkdir, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { frameworkSpec } from "./frameworks.js";
-import { BUILD_TARGETS, renderBuildFile } from "./site-build.js";
-import { renderFrameworkModule, renderPackageJson, renderTsconfig } from "./site-files.js";
+import { starterRouteTypes } from "./route-types.js";
+import { renderFrameworkModule, renderPackageJson, renderTsconfig, } from "./site-files.js";
+import { targetFiles } from "./targets.js";
 /**
  * Files identical in every site scaffold, taken from the base directory.
  *
@@ -24,23 +26,15 @@ import { renderFrameworkModule, renderPackageJson, renderTsconfig } from "./site
  * here, and `site-composition.test.ts` fails if this list and the directory disagree.
  */
 export const SHARED_SITE_FILES = [
-    ".dockerignore",
-    "Dockerfile",
-    "_worker.ts",
-    "backend.ts",
-    "counter.ts",
-    "deno.json",
+    "backend/app.ts",
+    "backend/counter.ts",
     "gitignore",
     "nifra.assurance.ts",
-    "server-bun.ts",
-    "server-deno.ts",
-    "server-node.ts",
-    "server-vercel.ts",
-    "wrangler.toml",
+    "routes/index.backend.ts",
 ];
 /** Files each framework supplies itself, relative to its overlay directory. */
 export const FRAMEWORK_SITE_FILES = ["README.md", "nifra.config.ts"];
-/** Route files, whose extension is the framework's own. */
+/** Route frontend files, whose extension is the framework's own. The backend half is shared. */
 export const ROUTE_BASENAMES = ["_404", "_layout", "index"];
 /** Extension the framework's route files carry. */
 export function routeExtension(framework) {
@@ -58,16 +52,33 @@ export function overlayDir(framework) {
         ? SITE_BASE_DIR
         : join(here, "..", "..", `template-site-${framework.id}`);
 }
-/** Every file a site scaffold emits, and the text it holds. Generated files only. */
-export function generatedSiteFiles(framework) {
+/** Every file a site scaffold generates, and the text it holds. */
+export function generatedSiteFiles(framework, site) {
     const files = new Map();
-    for (const target of BUILD_TARGETS)
-        files.set(target.file, renderBuildFile(target, framework));
-    files.set("framework.ts", renderFrameworkModule(framework));
-    files.set("package.json", renderPackageJson(framework));
+    files.set("backend/framework.ts", renderFrameworkModule(framework));
+    files.set("package.json", renderPackageJson(framework, site));
     files.set("tsconfig.json", renderTsconfig(framework));
+    for (const [file, text] of targetFiles(site.target, site.name, site.docker))
+        files.set(file, text);
+    for (const [file, text] of starterRouteTypes(routeExtension(framework)))
+        files.set(file, text);
     return files;
 }
+/**
+ * Declared for every target, not just the edge ones, so `nifra target cloudflare` later keeps the
+ * shared backend's rate limit working without a second edit.
+ */
+const CLIENT_IP_DECLARATION = `// Cloudflare and Vercel expose no socket: the caller's address arrives in a header their edge
+// overwrites (\`cf-connecting-ip\` / \`x-real-ip\`), and this trusts it so backend/app.ts's rate limit can
+// tell visitors apart. Without it an edge build has no caller address and the limit refuses every
+// request. It holds only while that edge is the one way in - served any other way (\`wrangler pages
+// dev\`, your own workerd) the header is whatever the client sent. Bun, Node and Deno use the socket.
+export const clientIp = "platform"
+`;
+/** The framework's `nifra.config.ts`, declaring the target `nifra build` emits. */
+export function withTarget(config, site) {
+    return `${config.replace(/\n*$/, "\n")}\n${CLIENT_IP_DECLARATION}\n// The deploy target \`nifra build\` emits; \`nifra target <t>\` switches it.\nexport const target = "${site.target}"\n`;
+}
 /**
  * Write a complete site scaffold into `target`.
  *
@@ -75,21 +86,23 @@ export function generatedSiteFiles(framework) {
  * `errorOnExist` did that before this was generated, and losing it would turn a mistyped path into
  * silent data loss in someone's working directory. `--force` is what `bun create nifra .` needs.
  */
-export async function materializeSite(target, id, options = {}) {
+export async function materializeSite(target, id, options) {
     const framework = frameworkSpec(id);
     const overlay = overlayDir(framework);
     const force = options.force === true;
     const copy = (from, to) => cp(from, to, force ? { force: true } : { errorOnExist: true, force: false });
     // `wx` fails when the file exists, which is the write-side equivalent of `errorOnExist`.
     const emit = (to, contents) => writeFile(to, contents, force ? {} : { flag: "wx" });
-    await mkdir(join(target, "routes"), { recursive: true });
+    for (const dir of ["routes", "backend"])
+        await mkdir(join(target, dir), { recursive: true });
     for (const file of SHARED_SITE_FILES)
         await copy(join(SITE_BASE_DIR, file), join(target, file));
-    for (const [file, contents] of generatedSiteFiles(framework)) {
+    for (const [file, contents] of generatedSiteFiles(framework, options)) {
+        await mkdir(dirname(join(target, file)), { recursive: true });
         await emit(join(target, file), contents);
     }
-    for (const file of FRAMEWORK_SITE_FILES)
-        await copy(join(overlay, file), join(target, file));
+    await copy(join(overlay, "README.md"), join(target, "README.md"));
+    await emit(join(target, "nifra.config.ts"), withTarget(await readFile(join(overlay, "nifra.config.ts"), "utf8"), options));
     const extension = routeExtension(framework);
     for (const base of ROUTE_BASENAMES) {
         const name = join("routes", `${base}.${extension}`);

package/dist/scaffold/site.js.map

@@ -1 +1 @@
-{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/scaffold/site.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAsB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE1F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,WAAW;IACX,oBAAoB;IACpB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;CAChB,CAAA;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAA;AAEvF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;AAE9E,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,SAAwB;IACrD,IAAI,SAAS,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC9C,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IACxC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACpD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAA;AACpE,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,OAAO,SAAS,CAAC,EAAE,KAAK,OAAO;QAC7B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,SAAS,CAAC,EAAE,EAAE,CAAC,CAAA;AAC7D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,SAAwB;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,MAAM,IAAI,aAAa;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9F,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;IAC3D,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;IACvD,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;IACrD,OAAO,KAAK,CAAA;AACd,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,EAAU,EACV,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAA;IACpC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAU,EAAiB,EAAE,CACvD,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9E,yFAAyF;IACzF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,QAAgB,EAAiB,EAAE,CAC3D,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAEtD,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,KAAK,MAAM,IAAI,IAAI,iBAAiB;QAAE,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAC/F,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,oBAAoB;QAAE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAC5F,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IAC3C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IACrD,CAAC;AACH,CAAC"}
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/scaffold/site.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/targets.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Where a site deploys. A scaffold picks ONE target (`--target`, default `bun`): `nifra build` generates
+ * that target's server entry from `backend/` and `routes/`, so the app carries no per-runtime entry or
+ * build script - only the target's own config file, when it has one, and the scripts that run it.
+ * `nifra target <t>` switches it later.
+ */
+export declare const DEPLOY_TARGETS: readonly ["bun", "node", "deno", "cloudflare", "vercel"];
+export type DeployTarget = (typeof DEPLOY_TARGETS)[number];
+export interface TargetSpec {
+    readonly label: string;
+    /** `start` script: run the built app locally. */
+    readonly start?: string;
+    /** `deploy` script. Self-hosted targets have none unless the app is built into a Docker image. */
+    readonly deploy?: string;
+    /** `@nifrajs/*` packages the generated server entry imports beyond the shared set. */
+    readonly runtime?: readonly string[];
+    /** Whether `--docker` applies: a self-hosting server, not a platform's own runtime. */
+    readonly docker: boolean;
+}
+export declare const TARGETS: Readonly<Record<DeployTarget, TargetSpec>>;
+export declare function isDeployTarget(value: string): value is DeployTarget;
+/**
+ * The project name as a platform knows the app: a Docker image tag and a Cloudflare Pages or Deno Deploy
+ * project name take lowercase letters, digits, and "-", where the project itself may be `MyApp`,
+ * `my_app`, or `my.app`.
+ */
+export declare function deployName(name: string): string;
+/** The `deploy` script for `target`, or `undefined` when there is none. */
+export declare function deployScript(target: DeployTarget, name: string, docker: boolean): string | undefined;
+/** A Dockerfile that builds with Bun and runs the self-contained `dist/` on the target's runtime. */
+export declare function renderDockerfile(target: "bun" | "node"): string;
+export declare const DOCKERIGNORE = "node_modules\ndist\n.nifra\n.nifra-build\n.vercel\n.wrangler\n.git\n*.log\n";
+/** `deno.json` for the Deno target: Bun builds, Deno runs and deploys the bundle. */
+export declare const DENO_JSON: string;
+/** `wrangler.toml` for the Cloudflare target; `NAME` is the Pages project. */
+export declare const WRANGLER_TOML = "name = \"NAME\"\npages_build_output_dir = \"dist\"\n# 2025-04-01 or later: from that date `nodejs_compat` fills `process.env` from the project's variables,\n# where backend/app.ts reads NIFRA_ALLOW_MEMORY_RATE_LIMIT; until that variable is \"true\" the worker\n# refuses to start. Set it (a Pages variable, or a [vars] table here) only if a per-isolate rate limit\n# will do: Cloudflare runs many isolates and each counts alone. `bun run start` sets it for its one\n# local process.\ncompatibility_date = \"2025-04-01\"\ncompatibility_flags = [\"nodejs_compat\"]\n";
+/** The config files `target` needs at the app root, by name. */
+export declare function targetFiles(target: DeployTarget, name: string, docker: boolean): Map<string, string>;
+//# sourceMappingURL=targets.d.ts.map

package/dist/scaffold/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/scaffold/targets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,0DAA2D,CAAA;AACtF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,kGAAkG;IAClG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAiB9D,CAAA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,SAAS,CAKpB;AAQD,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAwB/D;AAED,eAAO,MAAM,YAAY,gFAQxB,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,SAAS,QAOjB,CAAA;AAEL,8EAA8E;AAC9E,eAAO,MAAM,aAAa,yjBASzB,CAAA;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrB"}

package/dist/scaffold/targets.js

@@ -0,0 +1,116 @@
+/**
+ * Where a site deploys. A scaffold picks ONE target (`--target`, default `bun`): `nifra build` generates
+ * that target's server entry from `backend/` and `routes/`, so the app carries no per-runtime entry or
+ * build script - only the target's own config file, when it has one, and the scripts that run it.
+ * `nifra target <t>` switches it later.
+ */
+export const DEPLOY_TARGETS = ["bun", "node", "deno", "cloudflare", "vercel"];
+export const TARGETS = {
+    bun: { label: "Bun", start: "bun dist/server.js", docker: true },
+    node: { label: "Node", start: "node dist/server.js", runtime: ["node"], docker: true },
+    deno: {
+        label: "Deno Deploy",
+        start: "deno run --allow-net --allow-read --allow-env dist/server.js",
+        deploy: "deployctl deploy --prod --entrypoint=dist/server.js",
+        docker: false,
+    },
+    cloudflare: {
+        label: "Cloudflare Pages",
+        // `pages dev` is only ever one local process - the single instance the memory rate limit allows.
+        start: "wrangler pages dev dist --binding NIFRA_ALLOW_MEMORY_RATE_LIMIT=true",
+        deploy: "wrangler pages deploy dist",
+        docker: false,
+    },
+    vercel: { label: "Vercel", deploy: "vercel deploy --prebuilt", docker: false },
+};
+export function isDeployTarget(value) {
+    return DEPLOY_TARGETS.includes(value);
+}
+/**
+ * The project name as a platform knows the app: a Docker image tag and a Cloudflare Pages or Deno Deploy
+ * project name take lowercase letters, digits, and "-", where the project itself may be `MyApp`,
+ * `my_app`, or `my.app`.
+ */
+export function deployName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/-+$/, "");
+}
+/** The `deploy` script for `target`, or `undefined` when there is none. */
+export function deployScript(target, name, docker) {
+    const image = deployName(name);
+    return docker
+        ? `docker build -t ${image} . && docker run -p 3000:3000 ${image}`
+        : TARGETS[target].deploy;
+}
+/** The image a Docker scaffold runs the built server in. */
+const DOCKER_RUN = {
+    bun: { image: "oven/bun:1-slim", user: "bun", cmd: '["bun", "dist/server.js"]' },
+    node: { image: "node:22-slim", user: "node", cmd: '["node", "dist/server.js"]' },
+};
+/** A Dockerfile that builds with Bun and runs the self-contained `dist/` on the target's runtime. */
+export function renderDockerfile(target) {
+    const run = DOCKER_RUN[target];
+    return `# Build with Bun (nifra's build toolchain), then run the self-contained bundle - the final image
+# carries no build tools or node_modules.
+#   docker build -t my-nifra-app .
+#   docker run -p 3000:3000 my-nifra-app
+FROM oven/bun:1 AS build
+WORKDIR /app
+# Copy manifests first so the install layer caches across source-only changes.
+COPY package.json bun.lock* ./
+RUN bun install
+COPY . .
+RUN bun run build
+
+FROM ${run.image} AS run
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3000
+COPY --from=build /app/dist ./dist
+# The bundle needs no elevated privileges; a compromised request handler should not inherit root.
+USER ${run.user}
+EXPOSE 3000
+CMD ${run.cmd}
+`;
+}
+export const DOCKERIGNORE = `node_modules
+dist
+.nifra
+.nifra-build
+.vercel
+.wrangler
+.git
+*.log
+`;
+/** `deno.json` for the Deno target: Bun builds, Deno runs and deploys the bundle. */
+export const DENO_JSON = `${JSON.stringify({
+    tasks: { start: TARGETS.deno.start },
+    "//": "Build with Bun (`bun run build`), run the self-contained bundle on Deno. Deploy: deployctl deploy --prod --entrypoint=dist/server.js",
+}, null, 2)}\n`;
+/** `wrangler.toml` for the Cloudflare target; `NAME` is the Pages project. */
+export const WRANGLER_TOML = `name = "NAME"
+pages_build_output_dir = "dist"
+# 2025-04-01 or later: from that date \`nodejs_compat\` fills \`process.env\` from the project's variables,
+# where backend/app.ts reads NIFRA_ALLOW_MEMORY_RATE_LIMIT; until that variable is "true" the worker
+# refuses to start. Set it (a Pages variable, or a [vars] table here) only if a per-isolate rate limit
+# will do: Cloudflare runs many isolates and each counts alone. \`bun run start\` sets it for its one
+# local process.
+compatibility_date = "2025-04-01"
+compatibility_flags = ["nodejs_compat"]
+`;
+/** The config files `target` needs at the app root, by name. */
+export function targetFiles(target, name, docker) {
+    const files = new Map();
+    if (target === "deno")
+        files.set("deno.json", DENO_JSON);
+    if (target === "cloudflare")
+        files.set("wrangler.toml", WRANGLER_TOML.replace("NAME", deployName(name)));
+    if (docker && (target === "bun" || target === "node")) {
+        files.set("Dockerfile", renderDockerfile(target));
+        files.set(".dockerignore", DOCKERIGNORE);
+    }
+    return files;
+}
+//# sourceMappingURL=targets.js.map

package/dist/scaffold/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/scaffold/targets.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nifra",
-  "version": "3.5.0",
+  "version": "4.0.2",
   "description": "Scaffold a new nifra app - `bun create nifra <dir>`.",
   "keywords": [
     "bun",
@@ -17,6 +17,9 @@
     "cli"
   ],
   "type": "module",
+  "nifra": {
+    "environment": "backend"
+  },
   "bin": {
     "create-nifra": "./dist/cli.js"
   },