@hyperspan/framework 2.0.0-alpha.13 → 2.0.0-alpha.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspan/framework",
-  "version": "2.0.0-alpha.13",
+  "version": "2.0.0-alpha.14",
   "description": "Hyperspan Web Framework",
   "type": "module",
   "main": "src/server.ts",
@@ -104,7 +104,7 @@
     "vitest": "^4.1.10"
   },
   "dependencies": {
-    "@hyperspan/html": "^2.0.0-alpha.13",
+    "@hyperspan/html": "^2.0.0-alpha.14",
     "debug": "^4.4.3",
     "isbot": "^5.1.32",
     "zod": "^4.4.3"

package/src/adapter.test.ts

@@ -4,11 +4,7 @@ import { createConfig } from './server';
 
 const cloudflare: Adapter = {
   name: 'cloudflare',
-  createEntry() {
-    return {
-      fetch: async () => new Response('ok'),
-    };
-  },
+  renderServerEntry: (template) => template(),
 };
 
 describe('createConfig deployAdapter', () => {

package/src/index.ts

@@ -35,4 +35,6 @@ export type {
   AdapterAfterBuildContext,
   DeployEntry,
   DeployEntryContext,
+  ServerEntrySlots,
+  ServerEntryTemplate,
 } from './types';

package/src/types.ts

@@ -69,8 +69,12 @@ export namespace Hyperspan {
     outDir: string;
   };
 
+  export type ServerCreateContext = {
+    env: unknown;
+  };
+
   export type DeployEntryContext = {
-    createHyperspanServer: () => Promise<Server>;
+    createHyperspanServer: (ctx: ServerCreateContext) => Promise<Server>;
     config: Config;
   };
 
@@ -79,6 +83,18 @@ export namespace Hyperspan {
     fetch?(request: Request, env?: unknown, ctx?: unknown): Response | Promise<Response>;
   };
 
+  /** Optional snippets interpolated into generated `dist/server.ts`. Null/omitted slots emit nothing. */
+  export type ServerEntrySlots = {
+    beforeFileContent?: string | null;
+    beforeCreateServer?: string | null;
+    afterCreateServer?: string | null;
+    beforeRoutes?: string | null;
+    afterRoutes?: string | null;
+    afterFileContent?: string | null;
+  };
+
+  export type ServerEntryTemplate = (slots?: ServerEntrySlots) => string;
+
   export type Adapter = {
     /** Diagnostic name, e.g. `node`, `cloudflare`. */
     name: string;
@@ -88,18 +104,17 @@ export namespace Hyperspan {
      */
     devModule?: string;
     resolveDevEnv?(root: string): Promise<unknown>;
-    /** Platform entry (`start` and/or `fetch`). Called from generated `dist/server.ts`. */
-    createEntry(ctx: DeployEntryContext): DeployEntry;
+    /**
+     * Render generated `dist/server.ts` from the shared bootstrap template.
+     * Fill slots (especially `afterFileContent`) for the platform entry.
+     */
+    renderServerEntry(template: ServerEntryTemplate): string | Promise<string>;
     afterBuild?(ctx: AdapterAfterBuildContext): void | Promise<void>;
   };
 
   /** Runtime adapter object (`nodeAdapter()`, `cloudflareAdapter()`, …). */
   export type DeployAdapter = Adapter;
 
-  export type ServerCreateContext = {
-    env: unknown;
-  };
-
   export type Config = {
     appDir: string;
     publicDir: string;
@@ -443,6 +458,8 @@ export type Adapter = Hyperspan.Adapter;
 export type AdapterAfterBuildContext = Hyperspan.AdapterAfterBuildContext;
 export type DeployEntry = Hyperspan.DeployEntry;
 export type DeployEntryContext = Hyperspan.DeployEntryContext;
+export type ServerEntrySlots = Hyperspan.ServerEntrySlots;
+export type ServerEntryTemplate = Hyperspan.ServerEntryTemplate;
 
 declare global {
   interface DocumentEventMap {