feat: add api route handler and server manifest

Author: LiasCode

examples/basic/src/pages/api/route.ts

@@ -1,15 +1,17 @@
-export const GET = () => {
-  return true;
-};
+import { defineHandler } from "pranx/server";
 
-export const POST = () => {
-  return true;
-};
+export const GET = defineHandler(() => {
+  return { ok: true };
+});
 
-export const PUT = () => {
-  return true;
-};
+export const POST = defineHandler(() => {
+  return { ok: true };
+});
 
-export const DELETE = () => {
-  return true;
-};
+export const PUT = defineHandler(() => {
+  return { ok: true };
+});
+
+export const DELETE = defineHandler(() => {
+  return { ok: true };
+});

packages/pranx/src/cmd/build.ts

@@ -38,26 +38,53 @@ export async function build() {
   await fse.emptyDir(OUTPUT_PRANX_DIR);
 
   // Bundling
-  await bundle_server({
-    optimize: true,
+  const optimize_output = false;
+
+  const server_bundle_result = await bundle_server({
+    optimize: optimize_output,
     user_config: await get_user_pranx_config(),
   });
 
   const browser_bundle_result = await bundle_browser({
-    optimize: true,
+    optimize: optimize_output,
     user_config: await get_user_pranx_config(),
   });
 
   // Manifests
   const server_site_manifest: SERVER_MANIFEST = {
     entry_server: join(OUTPUT_BUNDLE_SERVER_DIR, "entry-server.js"),
     routes: [],
+    api: [],
   };
 
   let server_entry_module: ServerEntryModule | null = null;
 
   server_entry_module = (await import(server_site_manifest.entry_server)) as ServerEntryModule;
 
+  // Generating api routes Manifest
+  const pranx_server_base_path = join(".pranx", "server");
+
+  for (const [file, _output] of Object.entries(server_bundle_result.metafile.outputs)) {
+    if (!file.endsWith("route.js")) continue;
+
+    const pages_relative_path = file.replace(pranx_server_base_path, "");
+
+    const final_path_normalized = `/${pages_relative_path
+      .replace("route.js", "")
+      .replace("pages", "")
+      .split("/")
+      .filter(Boolean)
+      .join("/")}`;
+
+    const module_path = join(OUTPUT_BUNDLE_SERVER_DIR, "pages", pages_relative_path);
+
+    server_site_manifest.api.push({
+      path: final_path_normalized,
+      module: pages_relative_path,
+      absolute_module_path: module_path,
+    });
+  }
+
   const pranx_browser_base_path = join(".pranx", "browser");
 
   type CSS_OUTPUT = {
@@ -266,7 +293,7 @@ export async function build() {
         const html = generate_html_template({
           page_prerendered,
           hydrate_data_as_string,
-          minify: true,
+          minify: optimize_output,
           css: route.css,
         });
 

packages/pranx/src/server/public-exports.ts

@@ -1,2 +1,4 @@
 export { Meta } from "./Meta.js";
 export { Scripts } from "./Scripts.js";
+
+export { defineHandler } from "h3";

packages/pranx/types/index.d.ts

@@ -1,5 +1,5 @@
 import { BuildOptions } from "esbuild";
-import { EventHandlerRequest, H3Event } from "h3";
+import { EventHandlerRequest, H3Event, defineHandler } from "h3";
 import { VNode } from "preact";
 import { PropsWithChildren } from "preact/compat";
 import { useHead } from "unhead";
@@ -74,9 +74,27 @@ export type ServerManifestRoute = {
   css: string[];
 };
 
+export type PranxApiHandler = typeof defineHandler;
+
+export type PranxRouteModule = {
+  GET?: PranxApiHandler;
+  POST?: PranxApiHandler;
+  PUT?: PranxApiHandler;
+  DELETE?: PranxApiHandler;
+  PATCH?: PranxApiHandler;
+  HEAD?: PranxApiHandler;
+};
+
+export type ServerManifestApiHandler = {
+  path: string;
+  module: string;
+  absolute_module_path: string;
+};
+
 export type SERVER_MANIFEST = {
   entry_server: string;
   routes: ServerManifestRoute[];
+  api: ServerManifestApiHandler[];
 };
 
 export type HydrateDataRoute = {

packages/pranx/types/server.d.ts

@@ -2,3 +2,5 @@ import { VNode } from "preact";
 
 export declare function Scripts(): VNode<any>;
 export declare function Meta(): VNode<any>;
+
+export { defineHandler } from "h3";