@kosmojs/dev 0.2.1 → 0.2.5

package/pkg/chassis.js

@@ -1,420 +1,327 @@
-import { createRequire } from "node:module";
-import { dirname, join, resolve } from "node:path";
-import { styleText } from "node:util";
-import { defaults } from "@kosmojs/core";
-import http from "node:http";
-import net from "node:net";
-import { build, createServer } from "vite";
-import { mergeConfigs, pathExists, pathResolver, routesFactory, spinnerFactory, vitePlugins } from "@kosmojs/lib";
-import coreGenerator from "@kosmojs/core-generator";
-import { readFileSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import crc from "crc/crc32";
-//#region src/cache.ts
-/**
-* Read the installed package.json at runtime to get the actual version.
-* A static `import ... with { type: "json" }` would be inlined by the
-* bundler with the pre-bump version, defeating the point.
-* */
-var self = JSON.parse(readFileSync(createRequire(import.meta.url).resolve("@kosmojs/dev/package.json"), "utf-8"));
-var cacheFactory = (route, sourceFolder, extraContext) => {
-	const cacheFile = pathResolver(sourceFolder).createPath.libApi(dirname(route.file), "cache.json");
-	const validateCache = async (cache) => {
-		if (!cache?.hash) return;
-		if (!cache.typeDeclarations || !cache.referencedFiles) return;
-		const hash = await generateFileHash(route.fileFullpath, { ...extraContext });
-		if (!identicalHashSum(cache.hash, hash)) return;
-		for (const [file, hash] of Object.entries(cache.referencedFiles)) if (!identicalHashSum(hash, await generateFileHash(resolve(sourceFolder.root, file)))) return;
-		return cache;
-	};
-	return {
-		async get(opt) {
-			if (await pathExists(cacheFile)) try {
-				const cache = JSON.parse(await readFile(cacheFile, "utf8"));
-				return opt?.validate ? validateCache(cache) : cache;
-			} catch (_e) {}
-		},
-		async set(cache) {
-			const hash = await generateFileHash(route.fileFullpath, { ...extraContext });
-			const referencedFiles = {};
-			for (const file of cache.referencedFiles) referencedFiles[file.replace(`${sourceFolder.root}/`, "")] = await generateFileHash(file);
-			const value = {
-				...cache,
-				hash,
-				referencedFiles
-			};
-			await mkdir(dirname(cacheFile), { recursive: true });
-			await writeFile(cacheFile, JSON.stringify(value, null, 2), "utf8");
-			return value;
-		}
-	};
-};
-var generateFileHash = async (file, extraContext) => {
-	let fileContent;
-	try {
-		fileContent = await readFile(file, "utf8");
-	} catch (_e) {
-		return 0;
-	}
-	return fileContent ? crc(JSON.stringify({
-		...extraContext,
-		[self.cacheVersion]: fileContent
-	})) : 0;
-};
-var identicalHashSum = (a, b) => {
-	return a === b;
-};
-//#endregion
-//#region src/chassis.ts
-var chassis_default = async (projectSettings) => {
-	const { devPort, command } = projectSettings;
-	for (const sourceFolder of projectSettings.sourceFolders) for (const base of folderGenerators(sourceFolder)) {
-		if (!base.meta?.name || typeof base.factory !== "function") throw new Error(`${sourceFolder.name}: Unrecognized generator - must be created via defineGenerator()`);
-		const factory = base.factory(sourceFolder);
-		if (!factory.meta?.name) throw new Error(`${sourceFolder.name}: ${base.meta.name} generator is missing meta property`);
-		try {
-			await factory.start?.();
-		} catch (error) {
-			console.error(styleText("red", `${sourceFolder.name}: ${base.meta.name} generator failed to initialize`));
-			throw error;
-		}
-	}
-	if (command === "build") {
-		for (const sourceFolder of projectSettings.sourceFolders) {
-			const { createPath } = pathResolver(sourceFolder);
-			const resolvedRoutes = [];
-			{
-				const { resolvers } = await routesFactory(sourceFolder, cacheFactory);
-				const spinner = spinnerFactory(`${sourceFolder.name}: resolving routes`);
-				for (const { name, handler } of resolvers.values()) {
-					spinner.append(`[ ${resolvedRoutes.length + 1} of ${resolvers.size} ] ${name}`);
-					resolvedRoutes.push(await handler());
-				}
-				spinner.succeed("ready ✨");
-			}
-			const generators = folderGenerators(sourceFolder);
-			for (const generator of generators) await generator.factory(sourceFolder).build?.(resolvedRoutes);
-			const plugins = [vitePlugins.tsconfigPaths(sourceFolder), vitePlugins.nodePrefix()];
-			await build(mergeConfigs(sourceFolder.config, ...generators.map(({ factory }) => {
-				return factory(sourceFolder).config?.({
-					kind: "client",
-					command
-				});
-			}), {
-				root: createPath.src(),
-				cacheDir: cacheDir(sourceFolder, command, "client"),
-				plugins,
-				build: {
-					outDir: createPath.distDir("client"),
-					manifest: true,
-					emptyOutDir: true
-				}
-			}));
-			const apiGenerator = generators.find((e) => e.meta.slot === "api");
-			if (apiGenerator) {
-				const dir = createPath.distDir("api");
-				await build(mergeConfigs(apiGenerator.options, apiGenerator.factory(sourceFolder).config?.({
-					kind: "backend",
-					command
-				}), {
-					base: "./",
-					root: createPath.src(),
-					appType: "custom",
-					plugins,
-					resolve: { conditions: ["node"] },
-					build: {
-						ssr: true,
-						target: "esnext",
-						sourcemap: true,
-						emptyOutDir: true,
-						rolldownOptions: {
-							input: [createPath.api("app.ts"), createPath.api("server.ts")],
-							output: {
-								dir,
-								format: "esm"
-							}
-						}
-					},
-					cacheDir: cacheDir(sourceFolder, command, "backend")
-				}));
-			}
-			for (const generator of generators) await generator.factory(sourceFolder).postBuild?.(resolvedRoutes);
-		}
-		return async () => {};
-	}
-	const requestHandlers = [];
-	const teardownHandlers = [];
-	const eventMap = {};
-	for (const sourceFolder of projectSettings.sourceFolders) eventMap[sourceFolder.name] = await eventFactory(sourceFolder);
-	let port = await findFreePort(devPort);
-	for (const sourceFolder of projectSettings.sourceFolders) {
-		const { createPath } = pathResolver(sourceFolder);
-		const requestMatchers = matchersFactory(sourceFolder);
-		const generators = folderGenerators(sourceFolder);
-		const plugins = [vitePlugins.tsconfigPaths(sourceFolder), vitePlugins.nodePrefix()];
-		{
-			const viteServer = await createServer(mergeConfigs(sourceFolder.config, ...generators.map(({ factory }) => {
-				return factory(sourceFolder).config?.({
-					kind: "client",
-					command
-				});
-			}), {
-				root: createPath.src(),
-				cacheDir: cacheDir(sourceFolder, command, "client"),
-				plugins,
-				server: {
-					port: port++,
-					middlewareMode: true,
-					hmr: { port: port++ }
-				}
-			}));
-			for (const [evt, handler] of Object.entries(eventMap[sourceFolder.name])) viteServer.watcher.on(evt, handler);
-			requestHandlers.push([
-				[sourceFolder.config.base],
-				() => requestMatchers.base,
-				() => viteServer.middlewares
-			]);
-			teardownHandlers.push(viteServer.close);
-		}
-		const apiGenerator = generators.find((e) => e.meta.slot === "api");
-		if (apiGenerator) {
-			const viteServer = await createServer(mergeConfigs(apiGenerator.options, apiGenerator.factory(sourceFolder).config?.({
-				kind: "backend",
-				command
-			}), {
-				root: createPath.src(),
-				appType: "custom",
-				cacheDir: cacheDir(sourceFolder, command, "backend"),
-				plugins,
-				server: {
-					port: port++,
-					middlewareMode: true,
-					hmr: { port: port++ }
-				},
-				resolve: { conditions: ["node"] },
-				environments: { api: { resolve: { conditions: ["node"] } } }
-			}));
-			const env = viteServer.environments.api;
-			const loadDevSetup = async () => {
-				env.runner.clearCache();
-				return env.runner.import(join(defaults.apiDir, "dev.ts")).then((e) => e.default);
-			};
-			let devSetup = await loadDevSetup();
-			for (const [evt, handler] of Object.entries(eventMap[sourceFolder.name])) viteServer.watcher.on(evt, async (file) => {
-				if (env.moduleGraph.getModulesByFile(file)?.size) {
-					await handler(file);
-					await devSetup?.teardownHandler?.();
-					devSetup = await loadDevSetup();
-				}
-			});
-			requestHandlers.push([
-				[sourceFolder.config.base, sourceFolder.config.apiBase],
-				() => devSetup.requestMatcher || requestMatchers.api,
-				() => devSetup.requestHandler()
-			]);
-			teardownHandlers.push(viteServer.close);
-		}
-	}
-	/**
-	* Sorting is essential to ensure more specific paths are matched before broader ones.
-	*
-	* Given source folders:
-	*   - main app:  baseurl=/  apiurl=/api
-	*   - admin app: baseurl=/admin  apiurl=/admin/api
-	*
-	* Correct sort order:
-	*   1. /admin/api  — most specific
-	*   2. /api
-	*   3. /admin
-	*   4. /
-	* */
-	const requestHandlerWeight = ([segments]) => {
-		const [base, api] = segments;
-		/**
-		* set weight to number of non-empty segments:
-		* "/" weight is 0
-		* "/admin" weight is 1
-		* */
-		const weight = base.split("/").filter(Boolean).length;
-		return api ? weight + 5 : weight;
-	};
-	const handlers = requestHandlers.sort((a, b) => requestHandlerWeight(b) - requestHandlerWeight(a));
-	const httpServer = http.createServer((req, res) => {
-		for (const [, matcherFactory, handlerFactory] of handlers) {
-			const [matcher, handler] = [matcherFactory(), handlerFactory()];
-			if (matcher(req)) {
-				handler(req, res);
-				return;
-			}
-		}
-		res.writeHead(404, { "Content-Type": "text/html" });
-		res.end("<h1>404: Not Found</h1>");
-	});
-	httpServer.on("error", (error) => {
-		console.error(styleText("red", `Failed to start dev server on port ${devPort}`));
-		console.error(error.message);
-		process.exit(1);
-	});
-	httpServer.listen(devPort);
-	teardownHandlers.push(async () => {
-		httpServer.close();
-	});
-	return async () => {
-		for (const handler of teardownHandlers) await handler();
-		await new Promise((resolve) => setTimeout(resolve, 100));
-	};
-};
-var cacheDir = ({ root, name }, command, mode) => {
-	return resolve(root, `var/.vite/${name}/${command}/${mode}`);
-};
-var folderGenerators = (sourceFolder) => {
-	const { generators = [] } = sourceFolder.config;
-	const coreGenerators = {};
-	const userGenerators = [];
-	for (const base of generators) if (base.meta.slot) coreGenerators[base.meta.slot] = base;
-	else userGenerators.push(base);
-	return [
-		coreGenerator(),
-		...coreGenerators.api ? [coreGenerators.api] : [],
-		...coreGenerators.fetch && coreGenerators.api ? [coreGenerators.fetch] : [],
-		...userGenerators,
-		...coreGenerators.ssr ? [coreGenerators.ssr] : [],
-		...coreGenerators.ssg ? [coreGenerators.ssg] : []
-	];
-};
-var eventFactory = async (sourceFolder) => {
-	const { resolvers, resolversFactory } = await routesFactory(sourceFolder, cacheFactory);
-	const { createPath } = pathResolver(sourceFolder);
-	const generators = [];
-	for (const base of folderGenerators(sourceFolder)) {
-		const factory = base.factory(sourceFolder);
-		generators.push({
-			name: base.meta.name,
-			factory
-		});
-	}
-	const resolvedRoutes = /* @__PURE__ */ new Map();
-	const runGenerators = async (event) => {
-		/**
-		* Watch handlers receive the full list of entries
-		* and should process only those whose source file or dependencies were updated.
-		* */
-		const entries = Array.from(resolvedRoutes.values());
-		for (const { name, factory } of generators) try {
-			await factory.watch?.(entries, event);
-		} catch (error) {
-			console.error(styleText("red", `${sourceFolder.name}: ${name} generator failed`));
-			if (event) console.error(event);
-			console.error(error);
-		}
-	};
-	const updateResolvedEntry = async (file) => {
-		const resolver = resolvers.get(file);
-		if (!resolver) return;
-		try {
-			const resolvedEntry = await resolver.handler(file);
-			resolvedRoutes.set(resolvedEntry.entry.fileFullpath, resolvedEntry);
-			return resolvedEntry;
-		} catch (error) {
-			const route = file.replace(`${createPath.api()}/`, "");
-			console.error(styleText("red", `${sourceFolder.name}: ${route} route resolution failed`));
-			console.error(error);
-			return;
-		}
-	};
-	{
-		const spinner = spinnerFactory(`${sourceFolder.name}: resolving routes`);
-		for (const { name, handler } of resolvers.values()) {
-			spinner.append(`[ ${resolvedRoutes.size + 1} of ${resolvers.size} ] ${name}`);
-			const route = await handler();
-			resolvedRoutes.set(route.entry.fileFullpath, route);
-		}
-		spinner.succeed("ready ✨");
-	}
-	await runGenerators();
-	return {
-		async add(file) {
-			const [resolver] = resolversFactory([file]).values();
-			if (!resolver) return;
-			resolvers.set(file, resolver);
-			if (await updateResolvedEntry(file)) await runGenerators({
-				kind: "create",
-				file
-			});
-		},
-		async change(file) {
-			if (resolvedRoutes.has(file)) await updateResolvedEntry(file);
-			else {
-				const relatedRoutes = resolvedRoutes.values().flatMap(({ kind, entry }) => {
-					return kind === "apiRoute" ? entry.referencedFiles.includes(file) ? [entry] : [] : [];
-				});
-				for (const route of relatedRoutes) await updateResolvedEntry(route.fileFullpath);
-			}
-			await runGenerators({
-				kind: "update",
-				file
-			});
-		},
-		async unlink(file) {
-			resolvers.delete(file);
-			resolvedRoutes.delete(file);
-			await runGenerators({
-				kind: "delete",
-				file
-			});
-		}
-	};
-};
-var matchersFactory = ({ config }) => {
-	const basePattern = new RegExp(`^${config.base}($|/*)`);
-	const apiPattern = new RegExp(`^${join(config.base, config.apiBase)}($|/*)`);
-	return {
-		base(req) {
-			return apiPattern.test(req.url) ? false : basePattern.test(req.url);
-		},
-		api(req) {
-			return apiPattern.test(req.url);
-		}
-	};
+import{createRequire as e}from"node:module";import{dirname as t,join as n,resolve as r}from"node:path";import{styleText as i}from"node:util";import{defaults as a}from"@kosmojs/core";import{defineGenerator as o,defineGeneratorFactory as s,mergeConfigs as c,pathExists as l,pathResolver as u,renderFactory as d,renderToFile as f,routesFactory as p,spinnerFactory as m,vitePlugins as h}from"@kosmojs/lib";import{routeRenderHelpers as g}from"@kosmojs/core/generators";import _ from"crc/crc32";import{build as v,createServer as y}from"vite";import{mkdir as b,readFile as x,writeFile as S}from"node:fs/promises";import C from"node:http";import w from"node:net";import{readFileSync as T}from"node:fs";var E={type:`module`,private:!0,name:`@kosmojs/core-generator`,version:`0.2.5`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`},devDependencies:{"path-to-regexp":`^8.4.2`}},D=`export const base = "{{config.base}}";
+export const apiBase = "{{config.apiBase}}";
+`,O=`export * from "./config";
+export * from "./routeMap";
+`,k=`import { compile } from "path-to-regexp";
+
+import type { PathMapperSignature } from "@kosmojs/core";
+import { createHost, join, stringify } from "@kosmojs/core/fetch";
+
+export const pathMapper = <ParamsT extends readonly unknown[]>(
+  basePath: string,
+  routeName: string,
+  pathPattern: string,
+  paramsMap: Array<[name: string, kind: string]>,
+  numericParams: Array<string>,
+): PathMapperSignature<ParamsT> => {
+  const toPath = compile(pathPattern);
+
+  const castParam = (name: string, value: unknown) => {
+    if (numericParams.includes(name)) {
+      const n = Number(value);
+      return Number.isFinite(n) ? n : String(value);
+    }
+    return String(value);
+  };
+
+  const paramsMapper: PathMapperSignature<ParamsT>["paramsMapper"] = (
+    params,
+  ) => {
+    return paramsMap.reduce<Record<string, unknown>>((map, [name, kind], i) => {
+      if (kind === "splat") {
+        if (Array.isArray(params[i]) && params[i].length) {
+          map[name] = params[i].map((v) => castParam(name, v));
+        }
+      } else if (params[i] !== undefined) {
+        map[name] = castParam(name, params[i]);
+      }
+      return map;
+    }, {});
+  };
+
+  const parametrize: PathMapperSignature<ParamsT>["parametrize"] = (params) => {
+    try {
+      return toPath(paramsMapper(params) as never);
+    } catch (error) {
+      console.error(\`❗ERROR: Failed building path for \${routeName}\`);
+      throw error;
+    }
+  };
+
+  const base: PathMapperSignature<ParamsT>["base"] = (params, query) => {
+    const path = join("/", parametrize(params));
+    return query ? [path, stringify(query)].join("?") : path;
+  };
+
+  const path: PathMapperSignature<ParamsT>["path"] = (params, query) => {
+    return join(basePath, base(params, query));
+  };
+
+  const href: PathMapperSignature<ParamsT>["href"] = (host, params, query) => {
+    return createHost(host) + path(params, query);
+  };
+
+  return {
+    paramsMapper,
+    parametrize,
+    base,
+    path,
+    href,
+  };
 };
-var findFreePort = async (devPort) => {
-	let minPort = 0;
-	let maxPort = 0;
-	for (const n of [
-		3,
-		2,
-		1,
-		""
-	]) {
-		minPort = Number(`${n}${devPort}`) + 100;
-		maxPort = minPort + 100;
-		if (maxPort < 65e3) break;
-	}
-	if (maxPort >= 65e3) throw new Error("the devPort in package.json should be less than 64000");
-	const range = maxPort - minPort + 1;
-	const startOffset = Math.floor(Math.random() * range);
-	const freePort = await Array.from({ length: range }, (_, i) => {
-		return minPort + (startOffset + i) % range;
-	}).reduce(async (prevPromise, port) => {
-		const freePort = await prevPromise;
-		if (freePort) return freePort;
-		return await isPortFree(port) ? port : void 0;
-	}, Promise.resolve(void 0));
-	if (!freePort) throw new Error(`No free ports found in range ${minPort}-${maxPort}`);
-	return freePort;
+`,A=`{{> pathMapper}}
+
+import { base, apiBase } from "./config";
+
+{{#if pageRoutes.length}}
+export type LinkProps =
+  {{#each pageRoutes}}
+  | [ "{{name}}", {{serializeParamsTupleElements .}} ]
+  {{/each}};
+{{else}}
+export type LinkProps = never;
+{{/if}}
+
+export const apiRouteMap = {
+  {{#each apiRoutes}}
+  "{{name}}": pathMapper<[{{serializeParamsTupleElements .}}]>(
+    apiBase,
+    "{{name}}",
+    "{{pathPattern}}",
+    [{{#each params.schema}}["{{name}}", "{{kind}}"], {{/each}}],
+    [{{#each numericParams}}"{{.}}", {{/each}}],
+  ),
+  {{/each}}
 };
-var isPortFree = (port) => {
-	return new Promise((resolve) => {
-		const server = net.createServer();
-		server.once("error", () => resolve(false));
-		server.once("listening", () => {
-			server.close();
-			resolve(true);
-		});
-		server.listen(port, "127.0.0.1");
-	});
+
+export const pageRouteMap = {
+  {{#each pageRoutes}}
+  "{{name}}": pathMapper<[{{serializeParamsTupleElements .}}]>(
+    base,
+    "{{name}}",
+    "{{pathPattern}}",
+    [{{#each params.schema}}["{{name}}", "{{kind}}"], {{/each}}],
+    [{{#each numericParams}}"{{.}}", {{/each}}],
+  ),
+  {{/each}}
 };
-//#endregion
-export { chassis_default as default };
+`,j=`declare const KOSMO_PRODUCTION_BUILD: boolean;
+declare const KOSMO_SERVERSIDE_FETCH: boolean;
+
+/**
+ * Enhances base TypeScript types with JSON Schema validation constraints.
+ * Allows declaring refined types that carry validation metadata for runtime
+ * schema validation while maintaining full TypeScript type safety.
+ *
+ * Useful for generating validation schemas and ensuring
+ * data conforms to specific business rules beyond basic type checking.
+ * */
+declare type VRefine<
+  T extends unknown[] | number | string | object,
+  _ extends T extends unknown[]
+    ? TArrayOptions
+    : T extends number
+      ? TNumberOptions
+      : T extends string
+        ? TStringOptions
+        : TObjectOptions,
+> = T;
+
+/**
+ * Type definitions inspired by and gently adapted from TypeBox.
+ * Original TypeBox created by sinclairzx81: https://github.com/sinclairzx81/typebox
+ * TypeBox is licensed under MIT: https://github.com/sinclairzx81/typebox/blob/main/license
+ *
+ * These types provide JSON Schema compatible type refinements for TypeScript.
+ * */
+interface TSchema {}
+
+// ------------------------------------------------------------------
+// ObjectOptions
+// ------------------------------------------------------------------
+interface TObjectOptions {
+  /**
+   * Defines whether additional properties are allowed beyond those explicitly defined in \`properties\`.
+   */
+  additionalProperties?: TSchema | boolean;
+  /**
+   * The minimum number of properties required in the object.
+   */
+  minProperties?: number;
+  /**
+   * The maximum number of properties allowed in the object.
+   */
+  maxProperties?: number;
+  /**
+   * Defines conditional requirements for properties.
+   */
+  dependencies?: Record<string, boolean | TSchema | string[]>;
+  /**
+   * Specifies properties that *must* be present if a given property is present.
+   */
+  dependentRequired?: Record<string, string[]>;
+  /**
+   * Defines schemas that apply if a specific property is present.
+   */
+  dependentSchemas?: Record<string, TSchema>;
+  /**
+   * Maps regular expressions to schemas properties matching a pattern must validate against the schema.
+   */
+  patternProperties?: Record<string, TSchema>;
+  /**
+   * A schema that all property names within the object must validate against.
+   */
+  propertyNames?: TSchema;
+}
+
+// ------------------------------------------------------------------
+// ArrayOptions
+// ------------------------------------------------------------------
+interface TArrayOptions {
+  /**
+   * The minimum number of items allowed in the array.
+   */
+  minItems?: number;
+  /**
+   * The maximum number of items allowed in the array.
+   */
+  maxItems?: number;
+  /**
+   * A schema that at least one item in the array must validate against.
+   */
+  contains?: TSchema;
+  /**
+   * The minimum number of array items that must validate against the \`contains\` schema.
+   */
+  minContains?: number;
+  /**
+   * The maximum number of array items that may validate against the \`contains\` schema.
+   */
+  maxContains?: number;
+  /**
+   * An array of schemas, where each schema in \`prefixItems\` validates against items at corresponding positions from the beginning of the array.
+   */
+  prefixItems?: TSchema[];
+  /**
+   * If \`true\`, all items in the array must be unique.
+   */
+  uniqueItems?: boolean;
+}
+
+// ------------------------------------------------------------------
+// NumberOptions
+// ------------------------------------------------------------------
+interface TNumberOptions {
+  /**
+   * Specifies an exclusive upper limit for the number (number must be less than this value).
+   */
+  exclusiveMaximum?: number | bigint;
+  /**
+   * Specifies an exclusive lower limit for the number (number must be greater than this value).
+   */
+  exclusiveMinimum?: number | bigint;
+  /**
+   * Specifies an inclusive upper limit for the number (number must be less than or equal to this value).
+   */
+  maximum?: number | bigint;
+  /**
+   * Specifies an inclusive lower limit for the number (number must be greater than or equal to this value).
+   */
+  minimum?: number | bigint;
+  /**
+   * Specifies that the number must be a multiple of this value.
+   */
+  multipleOf?: number | bigint;
+}
+
+// ------------------------------------------------------------------
+// StringOptions
+// ------------------------------------------------------------------
+type TFormat =
+  | "date-time"
+  | "date"
+  | "duration"
+  | "email"
+  | "hostname"
+  | "idn-email"
+  | "idn-hostname"
+  | "ipv4"
+  | "ipv6"
+  | "iri-reference"
+  | "iri"
+  | "json-pointer-uri-fragment"
+  | "json-pointer"
+  | "json-string"
+  | "regex"
+  | "relative-json-pointer"
+  | "time"
+  | "uri-reference"
+  | "uri-template"
+  | "url"
+  | "uuid";
+
+interface TStringOptions {
+  /**
+   * Specifies the expected string format.
+   *
+   * Common values include:
+   * - \`base64\` – Base64-encoded string.
+   * - \`date-time\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time format.
+   * - \`date\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (YYYY-MM-DD).
+   * - \`duration\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) duration format.
+   * - \`email\` – RFC 5321/5322 compliant email address.
+   * - \`hostname\` – RFC 1034/1035 compliant host name.
+   * - \`idn-email\` – Internationalized email address.
+   * - \`idn-hostname\` – Internationalized host name.
+   * - \`ipv4\` – IPv4 address.
+   * - \`ipv6\` – IPv6 address.
+   * - \`iri\` / \`iri-reference\` – Internationalized Resource Identifier.
+   * - \`json-pointer\` / \`json-pointer-uri-fragment\` – JSON Pointer format.
+   * - \`json-string\` – String containing valid JSON.
+   * - \`regex\` – Regular expression syntax.
+   * - \`relative-json-pointer\` – Relative JSON Pointer format.
+   * - \`time\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time (HH:MM:SS).
+   * - \`uri-reference\` / \`uri-template\` – URI reference or template.
+   * - \`url\` – Web URL format.
+   * - \`uuid\` – RFC 4122 UUID string.
+   *
+   * May also be a custom format string.
+   */
+  format?: TFormat;
+  /**
+   * Specifies the minimum number of characters allowed in the string.
+   * Must be a non-negative integer.
+   */
+  minLength?: number;
+  /**
+   * Specifies the maximum number of characters allowed in the string.
+   * Must be a non-negative integer.
+   */
+  maxLength?: number;
+  /**
+   * Specifies a regular expression pattern that the string value must match.
+   * Can be provided as a string (ECMA-262 regex syntax) or a \`RegExp\` object.
+   */
+  pattern?: string | RegExp;
+}
+`,M=`# Ignore all files
+*
+
+# But don't ignore directories (so Git can traverse them)
+!*/
 
+# And don't ignore these files at any depth
+!cache.json
+!types.ts
+`,N=`export declare global {
+  interface Window {
+    __KOSMO_HYDRATION_BOOL__: boolean;
+    __KOSMO_HYDRATION_DATA__: Record<string, unknown> | undefined;
+  }
+}
+`,P=`// stub schemas, specialized generators supposed to overwrite this file
+import type { ValidationSchemas } from "@kosmojs/core/api";
+export type { ValidationSchemas };
+export const validationSchemas: ValidationSchemas = {};
+`,F=e=>{let t="${configDir}",n={types:[`@types/node`,`vite/client`],moduleResolution:`bundler`,module:`ESNext`,target:`ESNext`,strict:!0,exactOptionalPropertyTypes:!0,noImplicitAny:!0,noImplicitThis:!0,noImplicitOverride:!0,noImplicitReturns:!0,noUnusedLocals:!1,noUnusedParameters:!1,allowArbitraryExtensions:!0,allowImportingTsExtensions:!0,allowUnreachableCode:!1,allowUnusedLabels:!1,useUnknownInCatchVariables:!0,noFallthroughCasesInSwitch:!0,noUncheckedSideEffectImports:!0,resolveJsonModule:!0,esModuleInterop:!0,verbatimModuleSyntax:!0,skipLibCheck:!0,noEmit:!0};return e?{include:[`${t}/`,`${t}/../../${a.libDir}/${e}/`,`${t}/../../**/*.d.ts`],compilerOptions:{...n,types:[...n.types],paths:{[`${a.appPrefix}/*`]:[`${t}/../../*`],[`${a.srcPrefix}/*`]:[`${t}/*`],[`${a.libPrefix}/*`]:[`${t}/../../${a.libDir}/${e}/*`]},jsx:`preserve`}}:{include:[`${t}/`],exclude:[`${t}/${a.srcDir}/`],compilerOptions:{...n,paths:{[`${a.appPrefix}/*`]:[`${t}/*`]}}}},I=s((e,n)=>{let{createPath:r,createImportHelpers:i}=u(n),a=async()=>{await f(r.lib(`../tsconfig.base.json`),JSON.stringify(F(),void 0,2),{});{let e=F(n.name),t={},i=new Set(e.compilerOptions.types||[]);for(let{meta:e}of n.config.generators||[]){e.jsxImportSource&&(t.jsxImportSource=e.jsxImportSource);for(let t of e.types||[])i.add(t)}await f(r.lib(`tsconfig.base.json`),JSON.stringify({...e,compilerOptions:{...e.compilerOptions,...t,types:[...i.values()]}},void 0,2),{})}for(let[e,t]of[[`env.d.ts`,j],[`global.d.ts`,N]])await f(r.lib(`../${e}`),t,{});await f(r.lib(`../.gitignore`),M,{},{overwrite:!1}),await f(r.lib(`ssg.ts`),`export default [];`,{})},o=async e=>{let{renderToFile:a}=d({helpers:{...i({origin:`lib`}),...g()},partials:{pathMapper:k}});await a(r.libCore(`routeMap.ts`),A,{apiRoutes:e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]),pageRoutes:e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[])});for(let[e,t]of[[`config.ts`,D],[`index.ts`,O]])await a(r.libCore(e),t,n);for(let{kind:n,entry:i}of e)n===`apiRoute`&&await a(r.libApi(t(i.file),`schemas.ts`),P,{route:i},{overwrite:!1})};return{meta:e,start:a,watch:o,build:o}}),L=o(()=>{let e={name:`Core`,dependencies:{"path-to-regexp":E.devDependencies[`path-to-regexp`]}};return{meta:e,options:void 0,factory:t=>I(e,t)}}),R=JSON.parse(T(e(import.meta.url).resolve(`@kosmojs/dev/package.json`),`utf-8`)),z=(e,n,i)=>{let a=u(n).createPath.libApi(t(e.file),`cache.json`),o=async t=>{if(!t?.hash||!t.typeDeclarations||!t.referencedFiles)return;let a=await B(e.fileFullpath,{...i});if(V(t.hash,a)){for(let[e,i]of Object.entries(t.referencedFiles))if(!V(i,await B(r(n.root,e))))return;return t}};return{async get(e){if(await l(a))try{let t=JSON.parse(await x(a,`utf8`));return e?.validate?o(t):t}catch{}},async set(r){let o=await B(e.fileFullpath,{...i}),s={};for(let e of r.referencedFiles)s[e.replace(`${n.root}/`,``)]=await B(e);let c={...r,hash:o,referencedFiles:s};return await b(t(a),{recursive:!0}),await S(a,JSON.stringify(c,null,2),`utf8`),c}}},B=async(e,t)=>{let n;try{n=await x(e,`utf8`)}catch{return 0}return n?_(JSON.stringify({...t,[R.cacheVersion]:n})):0},V=(e,t)=>e===t,H=async e=>{let{devPort:t,command:r}=e;for(let t of e.sourceFolders)for(let e of W(t)){if(!e.meta?.name||typeof e.factory!=`function`)throw Error(`${t.name}: Unrecognized generator - must be created via defineGenerator()`);let n=e.factory(t);if(!n.meta?.name)throw Error(`${t.name}: ${e.meta.name} generator is missing meta property`);try{await n.start?.()}catch(n){throw console.error(i(`red`,`${t.name}: ${e.meta.name} generator failed to initialize`)),n}}if(r===`build`){for(let t of e.sourceFolders){let{createPath:e}=u(t),n=[];{let{resolvers:e}=await p(t,z),r=m(`${t.name}: resolving routes`);for(let{name:t,handler:i}of e.values())r.append(`[ ${n.length+1} of ${e.size} ] ${t}`),n.push(await i());r.succeed(`ready ✨`)}let i=W(t);for(let e of i)await e.factory(t).build?.(n);let a=[h.tsconfigPaths(t),h.nodePrefix()];await v(c(t.config,...i.map(({factory:e})=>e(t).config?.({kind:`client`,command:r})),{root:e.src(),cacheDir:U(t,r,`client`),plugins:a,build:{outDir:e.distDir(`client`),manifest:!0,emptyOutDir:!0}}));let o=i.find(e=>e.meta.slot===`api`);if(o){let n=e.distDir(`api`);await v(c(o.options,o.factory(t).config?.({kind:`backend`,command:r}),{base:`./`,root:e.src(),appType:`custom`,plugins:a,resolve:{conditions:[`node`]},build:{ssr:!0,target:`esnext`,sourcemap:!0,emptyOutDir:!0,rolldownOptions:{input:[e.api(`app.ts`),e.api(`server.ts`)],output:{dir:n,format:`esm`}}},cacheDir:U(t,r,`backend`)}))}for(let e of i)await e.factory(t).postBuild?.(n)}return async()=>{}}let o=[],s=[],l={};for(let t of e.sourceFolders)l[t.name]=await G(t);let d=await q(t);for(let t of e.sourceFolders){let{createPath:e}=u(t),i=K(t),f=W(t),p=[h.tsconfigPaths(t),h.nodePrefix()];{let n=await y(c(t.config,...f.map(({factory:e})=>e(t).config?.({kind:`client`,command:r})),{root:e.src(),cacheDir:U(t,r,`client`),plugins:p,server:{port:d++,middlewareMode:!0,hmr:{port:d++}}}));for(let[e,r]of Object.entries(l[t.name]))n.watcher.on(e,r);o.push([[t.config.base],()=>i.base,()=>n.middlewares]),s.push(n.close)}let m=f.find(e=>e.meta.slot===`api`);if(m){let u=await y(c(m.options,m.factory(t).config?.({kind:`backend`,command:r}),{root:e.src(),appType:`custom`,cacheDir:U(t,r,`backend`),plugins:p,server:{port:d++,middlewareMode:!0,hmr:{port:d++}},resolve:{conditions:[`node`]},environments:{api:{resolve:{conditions:[`node`]}}}})),f=u.environments.api,h=async()=>(f.runner.clearCache(),f.runner.import(n(a.apiDir,`dev.ts`)).then(e=>e.default)),g=await h();for(let[e,n]of Object.entries(l[t.name]))u.watcher.on(e,async e=>{f.moduleGraph.getModulesByFile(e)?.size&&(await n(e),await g?.teardownHandler?.(),g=await h())});o.push([[t.config.base,t.config.apiBase],()=>g.requestMatcher||i.api,()=>g.requestHandler()]),s.push(u.close)}}let f=([e])=>{let[t,n]=e,r=t.split(`/`).filter(Boolean).length;return n?r+5:r},g=o.sort((e,t)=>f(t)-f(e)),_=C.createServer((e,t)=>{for(let[,n,r]of g){let[i,a]=[n(),r()];if(i(e)){a(e,t);return}}t.writeHead(404,{"Content-Type":`text/html`}),t.end(`<h1>404: Not Found</h1>`)});return _.on(`error`,e=>{console.error(i(`red`,`Failed to start dev server on port ${t}`)),console.error(e.message),process.exit(1)}),_.listen(t),s.push(async()=>{_.close()}),async()=>{for(let e of s)await e();await new Promise(e=>setTimeout(e,100))}},U=({root:e,name:t},n,i)=>r(e,`var/.vite/${t}/${n}/${i}`),W=e=>{let{generators:t=[]}=e.config,n={},r=[];for(let e of t)e.meta.slot?n[e.meta.slot]=e:r.push(e);return[L(),...n.api?[n.api]:[],...n.fetch&&n.api?[n.fetch]:[],...r,...n.ssr?[n.ssr]:[],...n.ssg?[n.ssg]:[]]},G=async e=>{let{resolvers:t,resolversFactory:n}=await p(e,z),{createPath:r}=u(e),a=[];for(let t of W(e)){let n=t.factory(e);a.push({name:t.meta.name,factory:n})}let o=new Map,s=async t=>{let n=Array.from(o.values());for(let{name:r,factory:o}of a)try{await o.watch?.(n,t)}catch(n){console.error(i(`red`,`${e.name}: ${r} generator failed`)),t&&console.error(t),console.error(n)}},c=async n=>{let a=t.get(n);if(a)try{let e=await a.handler(n);return o.set(e.entry.fileFullpath,e),e}catch(t){let a=n.replace(`${r.api()}/`,``);console.error(i(`red`,`${e.name}: ${a} route resolution failed`)),console.error(t);return}};{let n=m(`${e.name}: resolving routes`);for(let{name:e,handler:r}of t.values()){n.append(`[ ${o.size+1} of ${t.size} ] ${e}`);let i=await r();o.set(i.entry.fileFullpath,i)}n.succeed(`ready ✨`)}return await s(),{async add(e){let[r]=n([e]).values();r&&(t.set(e,r),await c(e)&&await s({kind:`create`,file:e}))},async change(e){if(o.has(e))await c(e);else{let t=o.values().flatMap(({kind:t,entry:n})=>t===`apiRoute`&&n.referencedFiles.includes(e)?[n]:[]);for(let e of t)await c(e.fileFullpath)}await s({kind:`update`,file:e})},async unlink(e){t.delete(e),o.delete(e),await s({kind:`delete`,file:e})}}},K=({config:e})=>{let t=RegExp(`^${e.base}($|/*)`),r=RegExp(`^${n(e.base,e.apiBase)}($|/*)`);return{base(e){return!r.test(e.url)&&t.test(e.url)},api(e){return r.test(e.url)}}},q=async e=>{let t=0,n=0;for(let r of[3,2,1,``])if(t=Number(`${r}${e}`)+100,n=t+100,n<65e3)break;if(n>=65e3)throw Error(`the devPort in package.json should be less than 64000`);let r=n-t+1,i=Math.floor(Math.random()*r),a=await Array.from({length:r},(e,n)=>t+(i+n)%r).reduce(async(e,t)=>await e||(await J(t)?t:void 0),Promise.resolve(void 0));if(!a)throw Error(`No free ports found in range ${t}-${n}`);return a},J=e=>new Promise(t=>{let n=w.createServer();n.once(`error`,()=>t(!1)),n.once(`listening`,()=>{n.close(),t(!0)}),n.listen(e,`127.0.0.1`)});export{H as default};
 //# sourceMappingURL=chassis.js.map