@kosmojs/dev 0.0.10 → 0.0.20

package/pkg/index.js

@@ -1,33 +1,141 @@
-// src/index.ts
-import { default as default2 } from "@kosmojs/api-generator";
-import { default as default3 } from "@kosmojs/fetch-generator";
-
 // src/alias-plugin/index.ts
 import { glob } from "tinyglobby";
+
+// src/paths.ts
+import { join } from "node:path";
+
+// src/defaults.ts
+var defaults = {
+  appPrefix: "~",
+  srcPrefix: "@",
+  libPrefix: "_",
+  coreDir: "core",
+  srcDir: "src",
+  libDir: "lib",
+  configDir: "config",
+  apiDir: "api",
+  pagesDir: "pages",
+  entryDir: "entry",
+  fetchDir: "fetch"
+};
+
+// src/paths.ts
+var createTsconfigPaths = (prefix) => {
+  return {
+    [`${defaults.appPrefix}/*`]: [`${prefix}/*`],
+    [`${defaults.srcPrefix}/*`]: [`${prefix}/${defaults.srcDir}/*`],
+    [`${defaults.libPrefix}/*`]: [
+      `${prefix}/${defaults.libDir}/${defaults.srcDir}/*`
+    ]
+  };
+};
+var pathResolver = ({
+  appRoot,
+  sourceFolder
+}) => {
+  const createPath = (...a) => {
+    return appRoot ? join(appRoot, ...a) : join(...a);
+  };
+  const createImport = {
+    coreApi(...a) {
+      return join(defaults.appPrefix, defaults.coreDir, defaults.apiDir, ...a);
+    },
+    src(...a) {
+      return join(defaults.srcPrefix, sourceFolder, ...a);
+    },
+    config(...a) {
+      return this.src(defaults.configDir, ...a);
+    },
+    api(...a) {
+      return this.src(defaults.apiDir, ...a);
+    },
+    pages(...a) {
+      return this.src(defaults.pagesDir, ...a);
+    },
+    lib(...a) {
+      return join(defaults.libPrefix, sourceFolder, ...a);
+    },
+    libApi(...a) {
+      return this.lib(defaults.apiDir, ...a);
+    },
+    libEntry(...a) {
+      return this.lib(defaults.entryDir, ...a);
+    },
+    fetch(...a) {
+      return this.lib(defaults.fetchDir, ...a);
+    }
+  };
+  return {
+    createPath: {
+      coreApi(...a) {
+        return createPath(defaults.coreDir, defaults.apiDir, ...a);
+      },
+      src(...a) {
+        return createPath(defaults.srcDir, sourceFolder, ...a);
+      },
+      api(...a) {
+        return this.src(defaults.apiDir, ...a);
+      },
+      pages(...a) {
+        return this.src(defaults.pagesDir, ...a);
+      },
+      config(...a) {
+        return this.src(defaults.configDir, ...a);
+      },
+      entry(...a) {
+        return this.src(defaults.entryDir, ...a);
+      },
+      lib(...a) {
+        return createPath(defaults.libDir, defaults.srcDir, sourceFolder, ...a);
+      },
+      libApi(...a) {
+        return this.lib(defaults.apiDir, ...a);
+      },
+      libEntry(...a) {
+        return this.lib(defaults.entryDir, ...a);
+      },
+      libPages(...a) {
+        return this.lib(defaults.pagesDir, ...a);
+      },
+      fetch(...a) {
+        return this.lib(defaults.fetchDir, ...a);
+      }
+    },
+    createImport,
+    createImportHelper: (key, ...a) => {
+      return createImport[key](...a.slice(0, -1));
+    }
+  };
+};
+
+// src/alias-plugin/index.ts
 var alias_plugin_default = (appRoot, opt) => {
   return {
     name: "@kosmojs:aliasPlugin",
     async config() {
-      const compilerOptions = await import(`${appRoot}/tsconfig.json`, {
-        with: { type: "json" }
-      }).then((e) => e.default.compilerOptions);
+      const paths = await import(`${appRoot}/tsconfig.json`, { with: { type: "json" } }).then((e) => {
+        return {
+          ...e.default.compilerOptions?.paths,
+          ...createTsconfigPaths(".")
+        };
+      });
       const aliasmap = [];
-      const pathEntries = Object.entries({ ...compilerOptions?.paths });
+      const pathEntries = Object.entries(paths);
       for (const [aliasPattern, pathPatterns] of pathEntries) {
         const alias = aliasPattern.replace("/*", "");
-        const paths = pathPatterns.map((e) => e.replace("/*", "")).sort((a, b) => a.split(/\/+/).length - b.split(/\/+/).length);
-        if (paths.length === 1) {
+        const paths2 = pathPatterns.map((e) => e.replace("/*", "")).sort((a, b) => a.split(/\/+/).length - b.split(/\/+/).length);
+        if (paths2.length === 1) {
           aliasmap.push({
             find: new RegExp(`^${alias}/`),
-            replacement: `${appRoot}/${paths[0]}/`
+            replacement: `${appRoot}/${paths2[0]}/`
           });
-        } else if (paths.length > 1) {
+        } else if (paths2.length > 1) {
           aliasmap.push({
             find: new RegExp(`^${alias}/`),
             replacement: "",
             async customResolver(_src) {
               const src = _src.replace(/(\$|\^|\+|\(|\)|\[|\])/g, "\\$1");
-              const patterns = paths.flatMap((path) => [
+              const patterns = paths2.flatMap((path) => [
                 // Case 1: Extension is explicitly provided
                 // e.g. import styles from "@admin/{solid}/styles.module.css"
                 `${path}/${src}*`,
@@ -67,105 +175,92 @@ var alias_plugin_default = (appRoot, opt) => {
 };
 
 // src/base-plugin/index.ts
-import { basename, join as join3, resolve as resolve5 } from "node:path";
+import { basename as basename2, join as join5, resolve as resolve5 } from "node:path";
 import { styleText as styleText2 } from "node:util";
 import { Worker } from "node:worker_threads";
-import apiGenerator from "@kosmojs/api-generator";
 import stubGenerator from "@kosmojs/dev/stub-generator";
-import fetchGenerator from "@kosmojs/fetch-generator";
 
-// src/base-plugin/api-handler.ts
-import { join, resolve } from "node:path";
-import { styleText } from "node:util";
-import { context } from "esbuild";
-import { defaults } from "@kosmojs/devlib";
-var api_handler_default = async (options) => {
-  const { appRoot, sourceFolder, baseurl, apiurl } = options;
-  const apiDir = join(sourceFolder, defaults.apiDir);
-  const outDir = join(options.outDir, defaults.apiDir);
-  const esbuildOptions = await import(resolve(appRoot, "esbuild.json"), { with: { type: "json" } }).then((e) => e.default);
-  let app;
-  let devMiddlewareFactory;
-  let teardownHandler;
-  const watcher = async () => {
-    const rebuildPlugin = {
-      name: "rebuild",
-      setup(build) {
-        build.onEnd(async () => {
-          if (app) {
-            await teardownHandler?.(app);
-          }
-          try {
-            const exports = await import(`${outDir}/app.js?${Date.now()}`);
-            devMiddlewareFactory = exports.devMiddlewareFactory;
-            teardownHandler = exports.teardownHandler;
-            app = await exports.default();
-            console.debug(`${styleText("green", "\u279C")} Api handler ready`);
-          } catch (error) {
-            console.error(`${styleText("red", "\u2717")} Api handler error`);
-            console.error(error);
-          }
-        });
-      }
-    };
-    const ctx = await context({
-      ...esbuildOptions,
-      logLevel: "error",
-      bundle: true,
-      entryPoints: [join(apiDir, "app.ts")],
-      plugins: [rebuildPlugin],
-      outdir: outDir
-    });
-    return {
-      async start() {
-        await ctx.watch({
-          // waits this many milliseconds before rebuilding after a change is detected
-          delay: options.watcher.delay
-        });
-      },
-      async stop() {
-        await ctx.dispose();
-      }
-    };
-  };
-  const devMiddleware = async (req, res, viteHandler) => {
-    const next = () => {
-      return viteHandler();
-    };
-    if (devMiddlewareFactory) {
-      const handler = devMiddlewareFactory(app);
-      await handler(req, res, next);
-    } else {
-      !req?.url || !new RegExp(`^${join(baseurl, apiurl)}($|/)`).test(req.url) ? next() : await app?.callback()(req, res);
+// src/routes-factory/resolve.ts
+import { dirname as dirname3, join as join3, resolve as resolve3 } from "node:path";
+import crc5 from "crc/crc32";
+import picomatch from "picomatch";
+import { glob as glob2 } from "tinyglobby";
+
+// src/render.ts
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join as join2 } from "node:path";
+import crc from "crc/crc32";
+import handlebars from "handlebars";
+
+// src/fs.ts
+import { access, constants } from "node:fs/promises";
+var pathExists = async (path) => {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+// src/render.ts
+var render = (template, context2, options) => {
+  const { noEscape = true, renderer = handlebars } = { ...options };
+  return renderer.compile(template, { noEscape })(context2);
+};
+var renderAsFile = (file, template, context2, options) => {
+  const { formatters, ...renderOpts } = { ...options };
+  const content = render(template, context2, renderOpts);
+  return Array.isArray(formatters) ? formatters.reduce((c, f) => f(c, file), content) : content;
+};
+var renderToFile = async (file, template, context2, options) => {
+  const content = renderAsFile(file, template, context2, options);
+  if (await pathExists(file)) {
+    const { overwrite = true } = { ...options };
+    if (overwrite === false) {
+      return;
     }
-  };
+    const fileContent = await readFile(file, "utf8");
+    if (typeof overwrite === "function" && !overwrite(fileContent)) {
+      return;
+    }
+    if (crc(content) === crc(fileContent)) {
+      return;
+    }
+  }
+  await mkdir(dirname(file), { recursive: true });
+  await writeFile(file, content, "utf8");
+};
+var renderFactory = (options) => {
+  const renderer = handlebars.create();
+  if (options?.partials) {
+    renderer.registerPartial(options.partials);
+  }
+  if (options?.helpers) {
+    renderer.registerHelper(options.helpers);
+  }
   return {
-    watcher,
-    devMiddleware
+    render(template, context2, selfOoptions) {
+      return render(template, context2, {
+        renderer,
+        ...options,
+        ...selfOoptions
+      });
+    },
+    async renderToFile(file, template, context2, selfOoptions) {
+      return renderToFile(
+        options?.outdir ? join2(options.outdir, file) : file,
+        template,
+        context2,
+        { renderer, ...options, ...selfOoptions }
+      );
+    }
   };
 };
 
-// src/base-plugin/routes.ts
-import {
-  defaults as defaults3
-} from "@kosmojs/devlib";
-
-// src/base-plugin/routes/resolve.ts
-import { dirname as dirname2, join as join2, resolve as resolve4 } from "node:path";
-import crc3 from "crc/crc32";
-import picomatch from "picomatch";
-import { glob as glob2 } from "tinyglobby";
-import {
-  defaults as defaults2,
-  pathResolver as pathResolver2,
-  pathTokensFactory,
-  render,
-  renderToFile
-} from "@kosmojs/devlib";
-
-// src/base-plugin/ast.ts
-import { resolve as resolve2 } from "node:path";
-import crc from "crc/crc32";
+// src/ast.ts
+import { resolve } from "node:path";
+import crc2 from "crc/crc32";
 import { flattener } from "tfusion";
 import {
   Project,
@@ -252,14 +347,14 @@ var extractRouteMethods = (callExpression, route) => {
     const payloadText = payloadGeneric?.node ? payloadGeneric.node.getChildren().length === 0 ? "{}" : payloadGeneric.node.getFullText() : void 0;
     const responseText = responseGeneric?.node.getText();
     const responseType = responseText ? {
-      id: ["ResponseT", crc(route.importName + method)].join(""),
+      id: ["ResponseT", crc2(route.id + method)].join(""),
       method,
       skipValidation: responseGeneric?.comments ? responseGeneric.comments.some(skipValidationFilter) : false,
       text: ["never", "object"].includes(responseText) ? "{}" : responseText,
       resolvedType: void 0
     } : void 0;
     const payloadType = payloadText ? {
-      id: ["PayloadT", crc(route.importName + method)].join(""),
+      id: ["PayloadT", crc2(route.id + method)].join(""),
       responseTypeId: responseType?.id,
       method,
       skipValidation: payloadGeneric?.comments ? payloadGeneric.comments.some(skipValidationFilter) : false,
@@ -388,12 +483,12 @@ var extractGenerics = (callExpression) => {
 };
 var typeResolverFactory = ({ appRoot }) => {
   const project = createProject({
-    tsConfigFilePath: resolve2(appRoot, "tsconfig.json"),
+    tsConfigFilePath: resolve(appRoot, "tsconfig.json"),
     skipAddingFilesFromTsConfig: true
   });
   const literalTypesResolver = (literalTypes, options) => {
     const sourceFile = project.createSourceFile(
-      `${crc(literalTypes)}-${Date.now()}.ts`,
+      `${crc2(literalTypes)}-${Date.now()}.ts`,
       literalTypes,
       { overwrite: true }
     );
@@ -418,12 +513,11 @@ var typeResolverFactory = ({ appRoot }) => {
   };
 };
 
-// src/base-plugin/cache.ts
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, resolve as resolve3 } from "node:path";
-import crc2 from "crc/crc32";
+// src/cache.ts
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname2, resolve as resolve2 } from "node:path";
+import crc3 from "crc/crc32";
 import self from "@kosmojs/dev/package.json" with { type: "json" };
-import { pathExists, pathResolver } from "@kosmojs/devlib";
 var cacheFactory = (route, {
   appRoot,
   sourceFolder,
@@ -432,11 +526,11 @@ var cacheFactory = (route, {
   const cacheFile = pathResolver({
     appRoot,
     sourceFolder
-  }).resolve("apiLibDir", dirname(route.file), "cache.json");
+  }).createPath.libApi(dirname2(route.file), "cache.json");
   const getCache = async (opt) => {
     if (await pathExists(cacheFile)) {
       try {
-        const cache = JSON.parse(await readFile(cacheFile, "utf8"));
+        const cache = JSON.parse(await readFile2(cacheFile, "utf8"));
         return opt?.validate ? validateCache(cache) : cache;
       } catch (_e) {
       }
@@ -459,8 +553,8 @@ var cacheFactory = (route, {
       ] = await generateFileHash(file);
     }
     const cache = { ...rest, hash, referencedFiles };
-    await mkdir(dirname(cacheFile), { recursive: true });
-    await writeFile(cacheFile, JSON.stringify(cache, null, 2), "utf8");
+    await mkdir2(dirname2(cacheFile), { recursive: true });
+    await writeFile2(cacheFile, JSON.stringify(cache, null, 2), "utf8");
     return cache;
   };
   const validateCache = async (cache) => {
@@ -477,7 +571,7 @@ var cacheFactory = (route, {
       return;
     }
     for (const [file, hash2] of Object.entries(cache.referencedFiles)) {
-      if (!identicalHashSum(hash2, await generateFileHash(resolve3(appRoot, file)))) {
+      if (!identicalHashSum(hash2, await generateFileHash(resolve2(appRoot, file)))) {
         return;
       }
     }
@@ -492,11 +586,11 @@ var cacheFactory = (route, {
 var generateFileHash = async (file, extraContext) => {
   let fileContent;
   try {
-    fileContent = await readFile(file, "utf8");
+    fileContent = await readFile2(file, "utf8");
   } catch (_e) {
     return 0;
   }
-  return fileContent ? crc2(
+  return fileContent ? crc3(
     JSON.stringify({
       ...extraContext,
       [self.cacheVersion]: fileContent
@@ -507,13 +601,77 @@ var identicalHashSum = (a, b) => {
   return a === b;
 };
 
-// src/base-plugin/templates/resolved-types.hbs
+// src/routes-factory/base.ts
+import crc4 from "crc/crc32";
+var pathTokensFactory = (path) => {
+  const requiredParamRegex = /^\[([^\]]+)\]$/;
+  const optionalParamRegex = /^\[\[([^\]]+)\]\]$/;
+  const restParamRegex = /^\[\.\.\.([^\]]+)\]$/;
+  return path.split("/").map((orig, i) => {
+    const [base, ext = ""] = orig.split(/(\.([\w\d-]+)$)/);
+    const paramBase = (regex) => {
+      const name = base.replace(regex, "$1") || base;
+      return {
+        name,
+        const: /\W/.test(name) ? [name.replace(/\W/g, "_"), crc4(orig)].join("_") : name
+      };
+    };
+    let param;
+    if (base.startsWith("[")) {
+      if (restParamRegex.test(base)) {
+        param = {
+          ...paramBase(restParamRegex),
+          isRequired: false,
+          isOptional: false,
+          isRest: true
+        };
+      } else if (optionalParamRegex.test(base)) {
+        param = {
+          ...paramBase(optionalParamRegex),
+          isRequired: false,
+          isOptional: true,
+          isRest: false
+        };
+      } else if (requiredParamRegex.test(base)) {
+        param = {
+          ...paramBase(requiredParamRegex),
+          isRequired: true,
+          isOptional: false,
+          isRest: false
+        };
+      }
+    }
+    return {
+      orig,
+      base,
+      path: i === 0 ? orig.replace(/^index$/, "/") : orig,
+      ext,
+      ...param ? { param } : {}
+    };
+  });
+};
+var sortRoutes = (a, b) => {
+  const aStaticSegments = staticSegments(a.pathTokens);
+  const bStaticSegments = staticSegments(b.pathTokens);
+  if (aStaticSegments !== bStaticSegments) {
+    return bStaticSegments - aStaticSegments;
+  }
+  if (a.pathTokens.length !== b.pathTokens.length) {
+    return a.pathTokens.length - b.pathTokens.length;
+  }
+  return a.name.localeCompare(b.name);
+};
+var staticSegments = (pathTokens) => {
+  return pathTokens.reduce((a, e) => a + (e.param ? 0 : 1), 0);
+};
+
+// src/routes-factory/templates/resolved-types.hbs
 var resolved_types_default = "{{#each resolvedTypes}}\nexport type {{name}} = {{text}};\n{{/each}}\n";
 
-// src/base-plugin/templates/types.hbs
+// src/routes-factory/templates/types.hbs
 var types_default = '{{#each typeDeclarations}}{{text}}\n{{/each}}\n\nexport type {{params.id}} = {\n  {{#each paramsSchema}}\n  "{{name}}"{{#unless isRequired}}?{{/unless}}:{{#if isRest}} Array<{{/if}}\n    {{#if refinement}}{{refinement.text}}{{else}}string{{/if}}\n  {{#if isRest}}>{{/if}}\n  {{/each}}\n};\n\n{{#each payloadTypes}}\nexport type {{id}} = {{text}};\n{{/each}}\n\n{{#each responseTypes}}\nexport type {{id}} = {{text}};\n{{/each}}\n';
 
-// src/base-plugin/routes/resolve.ts
+// src/routes-factory/resolve.ts
 var API_INDEX_BASENAME = "index";
 var API_INDEX_PATTERN = `${API_INDEX_BASENAME}.ts`;
 var API_USE_BASENAME = "use";
@@ -524,29 +682,30 @@ var PAGE_LAYOUT_BASENAME = "layout";
 var PAGE_LAYOUT_PATTERN = `${PAGE_LAYOUT_BASENAME}.{tsx,vue}`;
 var ROUTE_FILE_PATTERNS = [
   // match index files in api dir
-  `${defaults2.apiDir}/**/${API_INDEX_PATTERN}`,
+  `${defaults.apiDir}/**/${API_INDEX_PATTERN}`,
   // match use files in api dir
-  `${defaults2.apiDir}/**/${API_USE_PATTERN}`,
+  `${defaults.apiDir}/**/${API_USE_PATTERN}`,
   // match index files in pages dir
-  `${defaults2.pagesDir}/**/${PAGE_INDEX_PATTERN}`,
+  `${defaults.pagesDir}/**/${PAGE_INDEX_PATTERN}`,
   // match layout files in pages dir
-  `${defaults2.pagesDir}/**/${PAGE_LAYOUT_PATTERN}`
+  `${defaults.pagesDir}/**/${PAGE_LAYOUT_PATTERN}`
 ];
 var scanRoutes = async ({
   appRoot,
   sourceFolder
 }) => {
+  const { createPath } = pathResolver({ appRoot, sourceFolder });
   return glob2(ROUTE_FILE_PATTERNS, {
-    cwd: resolve4(appRoot, sourceFolder),
+    cwd: createPath.src(),
     absolute: true,
     onlyFiles: true,
     followSymbolicLinks: false,
     ignore: [
       // ignore top-level matches, routes resides in folders, even index route
-      `${defaults2.apiDir}/${API_INDEX_PATTERN}`,
-      `${defaults2.apiDir}/${API_USE_PATTERN}`,
-      `${defaults2.pagesDir}/${PAGE_INDEX_PATTERN}`,
-      `${defaults2.pagesDir}/${PAGE_LAYOUT_PATTERN}`
+      `${defaults.apiDir}/${API_INDEX_PATTERN}`,
+      `${defaults.apiDir}/${API_USE_PATTERN}`,
+      `${defaults.pagesDir}/${PAGE_INDEX_PATTERN}`,
+      `${defaults.pagesDir}/${PAGE_LAYOUT_PATTERN}`
     ]
   });
 };
@@ -554,11 +713,11 @@ var isRouteFile = (file, {
   appRoot,
   sourceFolder
 }) => {
-  const [_sourceFolder, folder, ...rest] = resolve4(appRoot, file).replace(`${appRoot}/`, "").split("/");
+  const [_sourceFolder, folder, ...rest] = resolve3(appRoot, file).replace(`${appRoot}/${defaults.srcDir}/`, "").split("/");
   if (!folder || _sourceFolder !== sourceFolder || rest.length < 2) {
-    return;
+    return false;
   }
-  return picomatch.isMatch(join2(folder, ...rest), ROUTE_FILE_PATTERNS) ? [folder, rest.join("/")] : void 0;
+  return picomatch.isMatch(join3(folder, ...rest), ROUTE_FILE_PATTERNS) ? [folder, rest.join("/")] : false;
 };
 var isApiRoute = (file) => {
   return picomatch.matchBase(file, `**/${API_INDEX_PATTERN}`);
@@ -572,28 +731,23 @@ var isPageRoute = (file) => {
 var isPageLayout = (file) => {
   return picomatch.matchBase(file, `**/${PAGE_LAYOUT_PATTERN}`);
 };
-var createRouteEntry = (_file, {
+var createRouteEntry = (fileFullpath, {
   appRoot,
   sourceFolder
 }) => {
-  const resolvedPaths = isRouteFile(_file, { appRoot, sourceFolder });
+  const resolvedPaths = isRouteFile(fileFullpath, { appRoot, sourceFolder });
   if (!resolvedPaths) {
     return;
   }
   const [folder, file] = resolvedPaths;
-  const fileFullpath = join2(appRoot, sourceFolder, folder, file);
-  const pathTokens = pathTokensFactory(dirname2(file));
-  const name = pathTokens.map((e) => e.orig).join("/");
-  const importFile = file;
-  const importName = `${importFile.replace(/\W+/g, "_")}_${crc3(importFile)}`;
+  const pathTokens = pathTokensFactory(dirname3(file));
   return {
-    name,
+    id: `${file.replace(/\W+/g, "_")}_${crc5(file)}`,
+    name: pathTokens.map((e) => e.orig).join("/"),
     folder,
     file,
     fileFullpath,
-    pathTokens,
-    importFile,
-    importName
+    pathTokens
   };
 };
 var pageLayoutResolverFactory = () => {
@@ -610,17 +764,10 @@ var pageLayoutResolverFactory = () => {
 };
 var pageRouteResolverFactory = () => {
   return (entry) => {
-    const {
-      name,
-      folder,
-      file,
-      fileFullpath,
-      pathTokens,
-      importFile,
-      importName
-    } = entry;
+    const { id, name, folder, file, fileFullpath, pathTokens } = entry;
     const handler = async () => {
       const entry2 = {
+        id,
         name,
         pathTokens,
         params: {
@@ -628,9 +775,7 @@ var pageRouteResolverFactory = () => {
         },
         folder,
         file,
-        fileFullpath,
-        importFile,
-        importName
+        fileFullpath
       };
       return {
         kind: "pageRoute",
@@ -673,22 +818,14 @@ var apiRouteResolverFactory = (pluginOptions) => {
     refreshSourceFile
   } = typeResolverFactory(pluginOptions);
   return (entry) => {
-    const {
-      name,
-      file,
-      folder,
-      fileFullpath,
-      pathTokens,
-      importFile,
-      importName
-    } = entry;
+    const { id, name, file, folder, fileFullpath, pathTokens } = entry;
     const handler = async (updatedFile) => {
       const paramsSchema = pathTokens.flatMap((e) => {
         return e.param ? [e.param] : [];
       });
       const optionalParams = paramsSchema.length ? !paramsSchema.some((e) => e.isRequired) : true;
       const { getCache, persistCache } = cacheFactory(
-        { file, fileFullpath, importName },
+        { id, file, fileFullpath },
         {
           appRoot,
           sourceFolder,
@@ -708,12 +845,12 @@ var apiRouteResolverFactory = (pluginOptions) => {
           responseTypes,
           referencedFiles = []
         } = await resolveRouteSignature(
-          { importName, fileFullpath, optionalParams },
+          { id, fileFullpath, optionalParams },
           {
             withReferencedFiles: true,
             sourceFile: getSourceFile(fileFullpath),
             relpathResolver(path) {
-              return join2(sourceFolder, defaults2.apiDir, dirname2(file), path);
+              return join3(sourceFolder, defaults.apiDir, dirname3(file), path);
             }
           }
         );
@@ -724,13 +861,12 @@ var apiRouteResolverFactory = (pluginOptions) => {
           }
           return [];
         }) : [];
-        const typesFile = pathResolver2({ appRoot, sourceFolder }).resolve(
-          "apiLibDir",
-          dirname2(file),
-          "types.ts"
-        );
+        const typesFile = pathResolver({
+          appRoot,
+          sourceFolder
+        }).createPath.libApi(dirname3(file), "types.ts");
         const params = {
-          id: ["ParamsT", crc3(name)].join(""),
+          id: ["ParamsT", crc5(name)].join(""),
           schema: paramsSchema,
           resolvedType: void 0
         };
@@ -748,9 +884,9 @@ var apiRouteResolverFactory = (pluginOptions) => {
         });
         const resolvedTypes = resolveTypes ? literalTypesResolver(typesFileContent, {
           overrides: [...payloadTypes, ...responseTypes].reduce(
-            (map, { id, skipValidation }) => {
+            (map, { id: id2, skipValidation }) => {
               if (skipValidation) {
-                map[id] = "never";
+                map[id2] = "never";
               }
               return map;
             },
@@ -787,13 +923,12 @@ var apiRouteResolverFactory = (pluginOptions) => {
         });
       }
       const entry2 = {
+        id,
         name,
         pathTokens,
         params: cache.params,
         numericParams: cache.numericParams,
         optionalParams,
-        importName,
-        importFile,
         folder,
         file,
         fileFullpath,
@@ -804,7 +939,7 @@ var apiRouteResolverFactory = (pluginOptions) => {
         referencedFiles: Object.keys(cache.referencedFiles).map(
           // expand referenced files path,
           // they are stored as relative in cache
-          (e) => resolve4(appRoot, e)
+          (e) => resolve3(appRoot, e)
         )
       };
       return {
@@ -816,13 +951,93 @@ var apiRouteResolverFactory = (pluginOptions) => {
   };
 };
 
-// src/base-plugin/routes/nesting.ts
-import {
-  sortRoutes
-} from "@kosmojs/devlib";
+// src/routes-factory/nesting.ts
+import { basename } from "node:path";
+var nestedRoutesFactory = (routeEntries) => {
+  const entryStack = structuredClone(routeEntries).sort(sortRoutes);
+  const transformEntries = (entries, parent) => {
+    return [...new Set(entries.map((e) => e.name))].flatMap((name) => {
+      const nameEntries = entryStack.flatMap(({ fileFullpath, ...entry }) => {
+        return entry.name === name ? [entry] : [];
+      });
+      const index = nameEntries.find(
+        (e) => basename(e.file).startsWith(PAGE_INDEX_BASENAME)
+      );
+      const layout = nameEntries.find(
+        (e) => basename(e.file).startsWith(PAGE_LAYOUT_BASENAME)
+      );
+      if (index || layout) {
+        return [
+          {
+            index: index ? {
+              ...index,
+              pathTokens: index.pathTokens.slice(
+                parent?.pathTokens.length || 0
+              )
+            } : void 0,
+            layout: layout ? {
+              ...layout,
+              pathTokens: layout.pathTokens.slice(
+                parent?.pathTokens.length || 0
+              )
+            } : void 0,
+            parent: parent?.name,
+            children: transformEntries(
+              findDescendantEntries(index || layout),
+              index || layout
+            )
+          }
+        ];
+      }
+      return [];
+    });
+  };
+  const findDescendantEntries = ({
+    name,
+    pathTokens
+  }) => {
+    const potentialChildren = entryStack.filter((entry) => {
+      if (entry.pathTokens.length <= pathTokens.length) {
+        return false;
+      }
+      if (!entry.name.startsWith(`${name}/`)) {
+        return false;
+      }
+      return true;
+    });
+    return potentialChildren.filter((child) => {
+      const hasIntermediateRoute = potentialChildren.some((intermediate) => {
+        if (intermediate === child) {
+          return false;
+        }
+        if (intermediate.pathTokens.length <= pathTokens.length) {
+          return false;
+        }
+        if (intermediate.pathTokens.length >= child.pathTokens.length) {
+          return false;
+        }
+        return child.name.startsWith(`${intermediate.name}/`);
+      });
+      return !hasIntermediateRoute;
+    });
+  };
+  const rootEntries = entryStack.filter((entry) => {
+    const hasParent = entryStack.some((potential) => {
+      if (potential === entry) {
+        return false;
+      }
+      if (potential.pathTokens.length >= entry.pathTokens.length) {
+        return false;
+      }
+      return entry.name.startsWith(`${potential.name}/`);
+    });
+    return !hasParent;
+  });
+  return transformEntries(rootEntries);
+};
 
-// src/base-plugin/routes.ts
-var routes_default = async (pluginOptions) => {
+// src/routes-factory/index.ts
+var routesFactory = async (pluginOptions) => {
   const { appRoot, sourceFolder } = pluginOptions;
   const apiRouteResolver = apiRouteResolverFactory(pluginOptions);
   const apiUseResolver = apiUseResolverFactory(pluginOptions);
@@ -835,13 +1050,13 @@ var routes_default = async (pluginOptions) => {
       return entry ? [entry] : [];
     });
     for (const entry of entries) {
-      if (entry.folder === defaults3.apiDir) {
+      if (entry.folder === defaults.apiDir) {
         if (isApiRoute(entry.file)) {
           resolvers.set(entry.fileFullpath, apiRouteResolver(entry));
         } else if (isApiUse(entry.file)) {
           resolvers.set(entry.fileFullpath, apiUseResolver(entry));
         }
-      } else if (entry.folder === defaults3.pagesDir) {
+      } else if (entry.folder === defaults.pagesDir) {
         if (isPageRoute(entry.file)) {
           resolvers.set(entry.fileFullpath, pageRouteResolver(entry));
         } else if (isPageLayout(entry.file)) {
@@ -858,6 +1073,76 @@ var routes_default = async (pluginOptions) => {
   };
 };
 
+// src/base-plugin/api-handler.ts
+import { join as join4, resolve as resolve4 } from "node:path";
+import { styleText } from "node:util";
+import { context } from "esbuild";
+var api_handler_default = async (options) => {
+  const { appRoot, sourceFolder, baseurl, apiurl } = options;
+  const { createPath } = pathResolver({ appRoot, sourceFolder });
+  const outDir = join4(options.outDir, defaults.apiDir);
+  const esbuildOptions = await import(resolve4(appRoot, "esbuild.json"), { with: { type: "json" } }).then((e) => e.default);
+  let app;
+  let devMiddlewareFactory;
+  let teardownHandler;
+  const watcher = async () => {
+    const rebuildPlugin = {
+      name: "rebuild",
+      setup(build) {
+        build.onEnd(async () => {
+          if (app) {
+            await teardownHandler?.(app);
+          }
+          try {
+            const exports = await import(`${outDir}/app.js?${Date.now()}`);
+            devMiddlewareFactory = exports.devMiddlewareFactory;
+            teardownHandler = exports.teardownHandler;
+            app = await exports.default();
+            console.debug(`${styleText("green", "\u279C")} Api handler ready`);
+          } catch (error) {
+            console.error(`${styleText("red", "\u2717")} Api handler error`);
+            console.error(error);
+          }
+        });
+      }
+    };
+    const ctx = await context({
+      ...esbuildOptions,
+      logLevel: "error",
+      bundle: true,
+      entryPoints: [createPath.api("app.ts")],
+      plugins: [rebuildPlugin],
+      outdir: outDir
+    });
+    return {
+      async start() {
+        await ctx.watch({
+          // waits this many milliseconds before rebuilding after a change is detected
+          delay: options.watcher.delay
+        });
+      },
+      async stop() {
+        await ctx.dispose();
+      }
+    };
+  };
+  const devMiddleware = async (req, res, viteHandler) => {
+    const next = () => {
+      return viteHandler();
+    };
+    if (devMiddlewareFactory) {
+      const handler = devMiddlewareFactory(app);
+      await handler(req, res, next);
+    } else {
+      !req?.url || !new RegExp(`^${join4(baseurl, apiurl)}($|/)`).test(req.url) ? next() : await app?.callback()(req, res);
+    }
+  };
+  return {
+    watcher,
+    devMiddleware
+  };
+};
+
 // src/base-plugin/spinner.ts
 import ora from "ora";
 var spinnerFactory = (startText) => {
@@ -974,15 +1259,15 @@ var base_plugin_default = (apiurl, pluginOptions) => {
       }
       return {
         build: {
-          outDir: join3(config.build.outDir, outDirSuffix),
+          outDir: join5(config.build.outDir, outDirSuffix),
           manifest: true
         }
       };
     },
     async configResolved(_config) {
       store.config = _config;
-      const appRoot = resolve5(store.config.root, "..");
-      const sourceFolder = basename(store.config.root);
+      const appRoot = resolve5(store.config.root, "../..");
+      const sourceFolder = basename2(store.config.root);
       const outDir = resolve5(appRoot, resolve5(store.config.build.outDir, ".."));
       const { stabilityThreshold = 1e3 } = typeof store.config.server.watch?.awaitWriteFinish === "object" ? store.config.server.watch.awaitWriteFinish : {};
       const watcher = {
@@ -995,9 +1280,14 @@ var base_plugin_default = (apiurl, pluginOptions) => {
           formatters = [],
           refineTypeName = "TRefine"
         } = { ...pluginOptions };
-        const _apiGenerator = generators.find((e) => e.kind === "api");
-        const _fetchGenerator = generators.find((e) => e.kind === "fetch");
-        const _ssrGenerator = generators.find((e) => e.kind === "ssr");
+        const apiGenerator = generators.find((e) => e.kind === "api");
+        const fetchGenerator = generators.find((e) => e.kind === "fetch");
+        const ssrGenerator = generators.find((e) => e.kind === "ssr");
+        if (!apiGenerator || !fetchGenerator) {
+          throw new Error(
+            "Some of required generators missing, make sure both `api` and `fetch` generators configured properly"
+          );
+        }
         store.resolvedOptions = {
           ...pluginOptions,
           command: store.config.command,
@@ -1006,15 +1296,15 @@ var base_plugin_default = (apiurl, pluginOptions) => {
             // 1. stub generator should run first
             stubGenerator(),
             // 2. then api generator
-            _apiGenerator || apiGenerator(),
+            apiGenerator,
             // 3. then fetch generator
-            _fetchGenerator || fetchGenerator(),
+            fetchGenerator,
             // 4. user generators in the order they were added
             ...generators.filter((e) => {
               return e.kind ? !["api", "fetch", "ssr"].includes(e.kind) : true;
             }),
             // 5. ssr generator should run last
-            ..._ssrGenerator ? [_ssrGenerator] : []
+            ...ssrGenerator ? [ssrGenerator] : []
           ],
           formatters: formatters.map((e) => e.formatter),
           refineTypeName,
@@ -1026,7 +1316,7 @@ var base_plugin_default = (apiurl, pluginOptions) => {
         };
       }
       if (store.config.command === "build") {
-        const { resolvers } = await routes_default(store.resolvedOptions);
+        const { resolvers } = await routesFactory(store.resolvedOptions);
         const resolvedEntries = [];
         {
           const spinner = spinnerFactory("Resolving Routes");
@@ -1042,8 +1332,8 @@ var base_plugin_default = (apiurl, pluginOptions) => {
           const spinner = spinnerFactory("Running Generators");
           for (const { name, factory } of store.resolvedOptions.generators) {
             spinner.append(name);
-            const { watchHandler } = await factory(store.resolvedOptions);
-            await watchHandler(resolvedEntries);
+            const { build } = await factory(store.resolvedOptions);
+            await build(resolvedEntries);
           }
           spinner.succeed();
         }
@@ -1070,9 +1360,8 @@ var base_plugin_default = (apiurl, pluginOptions) => {
 };
 
 // src/define-plugin/index.ts
-import { readFile as readFile2 } from "node:fs/promises";
+import { readFile as readFile3 } from "node:fs/promises";
 import { parse as dotenv } from "dotenv";
-import { pathExists as pathExists2 } from "@kosmojs/devlib";
 var define_plugin_default = (entries) => {
   return {
     name: "@kosmojs:definePlugin",
@@ -1080,8 +1369,8 @@ var define_plugin_default = (entries) => {
       const define = {};
       for (const { keys, file, defineOn = "process.env", use } of entries) {
         define[defineOn] = {};
-        const fileExists = file ? await pathExists2(file) : false;
-        const env = fileExists ? dotenv(await readFile2(file, "utf8")) : process.env;
+        const fileExists = file ? await pathExists(file) : false;
+        const env = fileExists ? dotenv(await readFile3(file, "utf8")) : process.env;
         for (const [key, val] of Object.entries(env)) {
           if (keys.includes(key)) {
             define[`${defineOn}.${key}`] = JSON.stringify(val);
@@ -1093,11 +1382,56 @@ var define_plugin_default = (entries) => {
     }
   };
 };
+
+// src/typebox.ts
+var typeboxLiteralText = (text, options) => {
+  return [
+    // Escape backticks for safe use in template literals
+    [/(?<!\\)`/g, "\\`"],
+    // Escape $ for safe use in template literals
+    [/(?<!\\)\$\{/g, "\\${"],
+    /**
+     * TypeBox's built-in `Options` type is not configurable.
+     * To allow a custom type name, exposing `refineTypeName` option,
+     * defaulted to TRefine, then renaming it to `Options`.
+     * */
+    [new RegExp(`\\b${options.refineTypeName}\\s*<`, "g"), "Options<"]
+  ].reduce((text2, [a, b]) => text2.replace(a, b), text);
+};
 export {
+  API_INDEX_BASENAME,
+  API_INDEX_PATTERN,
+  API_USE_BASENAME,
+  API_USE_PATTERN,
+  PAGE_INDEX_BASENAME,
+  PAGE_INDEX_PATTERN,
+  PAGE_LAYOUT_BASENAME,
+  PAGE_LAYOUT_PATTERN,
   alias_plugin_default as aliasPlugin,
-  default2 as apiGenerator,
+  apiRouteResolverFactory,
+  apiUseResolverFactory,
+  createRouteEntry,
+  createTsconfigPaths,
   base_plugin_default as default,
+  defaults,
   define_plugin_default as definePlugin,
-  default3 as fetchGenerator
+  isApiRoute,
+  isApiUse,
+  isPageLayout,
+  isPageRoute,
+  isRouteFile,
+  nestedRoutesFactory,
+  pageLayoutResolverFactory,
+  pageRouteResolverFactory,
+  pathResolver,
+  pathTokensFactory,
+  render,
+  renderAsFile,
+  renderFactory,
+  renderToFile,
+  routesFactory,
+  scanRoutes,
+  sortRoutes,
+  typeboxLiteralText
 };
 //# sourceMappingURL=index.js.map