@chuckcchen/vite-plugin 1.0.12 → 1.0.14

package/dist/factory/presets.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Server Wrapper Presets
+ *
+ * Built-in presets and utilities for extending presets
+ */
+/**
+ * Server wrapper preset configuration
+ */
+export interface ServerWrapperPreset {
+    imports?: string;
+    handlerSetup: string;
+    handlerCall: string;
+    requiresHtmlTemplate?: boolean;
+}
+/**
+ * Handler detection path configuration
+ *
+ * Supported path formats:
+ * - "default" - Check if default export is a function
+ * - "default.fetch" - Check if default export has a fetch method
+ * - "handler" - Check serverExports.handler
+ * - "app.fetch" - Check serverExports.app.fetch (Hono style)
+ * - "server.fetch" - Check serverExports.server.fetch (TanStack Start)
+ */
+export type HandlerDetectPath = string;
+/**
+ * Default handler detection paths for webHandler preset
+ */
+export declare const DEFAULT_HANDLER_DETECT_PATHS: HandlerDetectPath[];
+/**
+ * Create a webHandler preset with custom detection paths
+ *
+ * @example
+ * ```ts
+ * // TanStack Start - only check server.fetch
+ * const preset = createWebHandlerPreset(["default.fetch", "server.fetch"]);
+ *
+ * // Custom framework
+ * const preset = createWebHandlerPreset(["default", "myHandler", "app.handle"]);
+ * ```
+ */
+export declare function createWebHandlerPreset(detectPaths?: HandlerDetectPath[]): ServerWrapperPreset;
+/**
+ * Built-in server wrapper presets (generic, framework-agnostic)
+ *
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
+ */
+export declare const SERVER_WRAPPER_PRESETS: {
+    /**
+     * Web Handler - Request/Response pattern
+     *
+     * Supports multiple export patterns (configurable via createWebHandlerPreset):
+     * - default export function
+     * - default.fetch (app object with fetch method)
+     * - named `handler` export
+     * - named `fetch` export
+     * - `app.fetch` pattern (Hono style)
+     * - `server.fetch` pattern (TanStack Start)
+     */
+    readonly webHandler: ServerWrapperPreset;
+    /**
+     * HTML Render - render function returning {head, html}
+     *
+     * Standard Vite SSR pattern where render(url) returns HTML fragments
+     * that are injected into the HTML template.
+     */
+    readonly htmlRender: {
+        readonly requiresHtmlTemplate: true;
+        readonly handlerSetup: string;
+        readonly handlerCall: "handleSSRRequest(webRequest)";
+    };
+};
+/**
+ * Result of extending server wrapper presets
+ */
+export interface ExtendedPresetsResult<TCustom extends Record<string, ServerWrapperPreset>> {
+    /** Extended presets object (core + custom) */
+    presets: typeof SERVER_WRAPPER_PRESETS & TCustom;
+    /** Type-safe preset resolver function */
+    resolvePreset: (preset: keyof (typeof SERVER_WRAPPER_PRESETS & TCustom) | ServerWrapperPreset) => ServerWrapperPreset;
+    /** Get all available preset names */
+    getPresetNames: () => (keyof (typeof SERVER_WRAPPER_PRESETS & TCustom))[];
+}
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export declare function createServerWrapperPreset(config: ServerWrapperPreset): ServerWrapperPreset;
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "htmlRender");
+ * ```
+ */
+export declare function extendServerWrapperPresets<TCustom extends Record<string, ServerWrapperPreset>>(customPresets: TCustom): ExtendedPresetsResult<TCustom>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/factory/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/factory/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBAAiB,EAO3D,CAAC;AAkCF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,GAAE,iBAAiB,EAAiC,GAC9D,mBAAmB,CAKrB;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;;;;;;;OAUG;;IAGH;;;;;OAKG;;;;;;CAoCK,CAAC;AAMX;;GAEG;AACH,MAAM,WAAW,qBAAqB,CACpC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAEnD,8CAA8C;IAC9C,OAAO,EAAE,OAAO,sBAAsB,GAAG,OAAO,CAAC;IACjD,yCAAyC;IACzC,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,GAAG,mBAAmB,KAC1E,mBAAmB,CAAC;IACzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAC3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAarB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,aAAa,EAAE,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAwCxD"}

package/dist/factory/presets.js

@@ -0,0 +1,218 @@
+/**
+ * Server Wrapper Presets
+ *
+ * Built-in presets and utilities for extending presets
+ */
+/**
+ * Default handler detection paths for webHandler preset
+ */
+export const DEFAULT_HANDLER_DETECT_PATHS = [
+    "default", // export default handler
+    "default.fetch", // export default { fetch } (app object)
+    "handler", // export { handler }
+    "fetch", // export { fetch }
+    "app.fetch", // export { app } (Hono)
+    "server.fetch", // export { server } (TanStack Start)
+];
+/**
+ * Generate check code for a single detection path
+ */
+function generateDetectCheck(path) {
+    if (path === "default") {
+        return `  if (typeof defaultExport === 'function') return defaultExport;`;
+    }
+    if (path === "default.fetch") {
+        return `  if (typeof defaultExport === 'object' && defaultExport !== null && typeof defaultExport.fetch === 'function') return defaultExport.fetch.bind(defaultExport);`;
+    }
+    if (path.includes(".")) {
+        const [obj, method] = path.split(".");
+        return `  if (typeof serverExports.${obj} === 'object' && serverExports.${obj} !== null && typeof serverExports.${obj}.${method} === 'function') return serverExports.${obj}.${method}.bind(serverExports.${obj});`;
+    }
+    return `  if (typeof serverExports.${path} === 'function') return serverExports.${path};`;
+}
+/**
+ * Generate handler setup code from detection paths
+ */
+function generateHandlerSetup(detectPaths) {
+    const checks = detectPaths.map(generateDetectCheck).join("\n");
+    const expectedList = detectPaths.join(", ");
+    return `
+const getHandler = () => {
+${checks}
+  throw new Error('No handler found. Expected: ${expectedList}');
+};
+const handler = getHandler();`.trim();
+}
+/**
+ * Create a webHandler preset with custom detection paths
+ *
+ * @example
+ * ```ts
+ * // TanStack Start - only check server.fetch
+ * const preset = createWebHandlerPreset(["default.fetch", "server.fetch"]);
+ *
+ * // Custom framework
+ * const preset = createWebHandlerPreset(["default", "myHandler", "app.handle"]);
+ * ```
+ */
+export function createWebHandlerPreset(detectPaths = DEFAULT_HANDLER_DETECT_PATHS) {
+    return {
+        handlerSetup: generateHandlerSetup(detectPaths),
+        handlerCall: "handler(webRequest, ...args)",
+    };
+}
+// ============================================================================
+// Built-in Presets
+// ============================================================================
+/**
+ * Built-in server wrapper presets (generic, framework-agnostic)
+ *
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
+ */
+export const SERVER_WRAPPER_PRESETS = {
+    /**
+     * Web Handler - Request/Response pattern
+     *
+     * Supports multiple export patterns (configurable via createWebHandlerPreset):
+     * - default export function
+     * - default.fetch (app object with fetch method)
+     * - named `handler` export
+     * - named `fetch` export
+     * - `app.fetch` pattern (Hono style)
+     * - `server.fetch` pattern (TanStack Start)
+     */
+    webHandler: createWebHandlerPreset(),
+    /**
+     * HTML Render - render function returning {head, html}
+     *
+     * Standard Vite SSR pattern where render(url) returns HTML fragments
+     * that are injected into the HTML template.
+     */
+    htmlRender: {
+        requiresHtmlTemplate: true,
+        handlerSetup: `
+const renderFn = typeof serverExports.render === 'function' 
+  ? serverExports.render 
+  : (typeof defaultExport === 'function' ? defaultExport : null);
+
+if (!renderFn) {
+  throw new Error('No render function found in server build. Expected export: render(url)');
+}
+
+async function handleSSRRequest(request) {
+  const url = new URL(request.url);
+  const pathname = url.pathname;
+  
+  try {
+    const rendered = await renderFn(pathname);
+    let html = __HTML_TEMPLATE__
+      .replace('<!--app-head-->', rendered.head ?? '')
+      .replace('<!--app-html-->', rendered.html ?? '');
+    
+    return new Response(html, {
+      status: 200,
+      headers: { 'Content-Type': 'text/html; charset=utf-8' }
+    });
+  } catch (error) {
+    console.error('SSR render error:', error);
+    return new Response('Internal Server Error: ' + error.message, {
+      status: 500,
+      headers: { 'Content-Type': 'text/plain' }
+    });
+  }
+}`.trim(),
+        handlerCall: "handleSSRRequest(webRequest)",
+    },
+};
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export function createServerWrapperPreset(config) {
+    if (!config.handlerSetup) {
+        throw new Error("Server wrapper preset must have handlerSetup");
+    }
+    if (!config.handlerCall) {
+        throw new Error("Server wrapper preset must have handlerCall");
+    }
+    return {
+        imports: config.imports,
+        handlerSetup: config.handlerSetup.trim(),
+        handlerCall: config.handlerCall,
+        requiresHtmlTemplate: config.requiresHtmlTemplate,
+    };
+}
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "htmlRender");
+ * ```
+ */
+export function extendServerWrapperPresets(customPresets) {
+    // Validate and normalize all custom presets
+    const normalizedCustomPresets = {};
+    for (const [key, preset] of Object.entries(customPresets)) {
+        normalizedCustomPresets[key] =
+            createServerWrapperPreset(preset);
+    }
+    const extendedPresets = {
+        ...SERVER_WRAPPER_PRESETS,
+        ...normalizedCustomPresets,
+    };
+    function resolvePreset(preset) {
+        if (typeof preset === "string") {
+            const resolved = extendedPresets[preset];
+            if (!resolved) {
+                throw new Error(`Unknown server wrapper preset: "${preset}". Available presets: ${Object.keys(extendedPresets).join(", ")}`);
+            }
+            return resolved;
+        }
+        // Validate and normalize inline preset
+        return createServerWrapperPreset(preset);
+    }
+    function getPresetNames() {
+        return Object.keys(extendedPresets);
+    }
+    return {
+        presets: extendedPresets,
+        resolvePreset,
+        getPresetNames,
+    };
+}
+//# sourceMappingURL=presets.js.map

package/dist/factory/presets.js.map

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

package/dist/factory.d.ts

@@ -108,6 +108,62 @@ export declare function createFrameworkAdapter(config: AdapterFactoryConfig, opt
  * Create a stateful adapter (for complex adapters needing shared state)
  */
 export declare function createStatefulAdapter<TState extends object>(initialState: TState, factory: (state: TState) => FrameworkAdapter): FrameworkAdapter;
+/**
+ * Result of extending server wrapper presets
+ */
+export interface ExtendedPresetsResult<TCustom extends Record<string, ServerWrapperPreset>> {
+    /** Extended presets object (core + custom) */
+    presets: typeof SERVER_WRAPPER_PRESETS & TCustom;
+    /** Type-safe preset resolver function */
+    resolvePreset: (preset: keyof (typeof SERVER_WRAPPER_PRESETS & TCustom) | ServerWrapperPreset) => ServerWrapperPreset;
+    /** Get all available preset names */
+    getPresetNames: () => (keyof (typeof SERVER_WRAPPER_PRESETS & TCustom))[];
+}
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export declare function createServerWrapperPreset(config: ServerWrapperPreset): ServerWrapperPreset;
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "viteSSR");
+ * ```
+ */
+export declare function extendServerWrapperPresets<TCustom extends Record<string, ServerWrapperPreset>>(customPresets: TCustom): ExtendedPresetsResult<TCustom>;
 /**
  * Combine multiple detector functions (returns true if any matches)
  */

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,YAAY,EAEZ,SAAS,EAET,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC,0DAA0D;;;;;IAa1D,sCAAsC;;;;;IAetC,wDAAwD;;;;;;CAoChD,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC;IAC7D,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,OAAO,sBAAsB,GAAG,mBAAmB,CAAC;IAC1E,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAmND;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,qBAA0B,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAoDlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,MAAM,EACzD,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAC3C,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,EAAE,IAEzD,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAQvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAC/C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAcvD"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}

package/dist/factory.js

@@ -5,6 +5,7 @@
  */
 import path from "path";
 import { pathExists, readFile, detectConfigFile, detectBuildDir, detectServerEntry, generateServerWrapperCode, createDefaultMeta, logBuildArtifacts, } from "./utils.js";
+import { ViteConfigParser, } from "./vite-config-parser.js";
 import { parseRoutesFromSources, } from "./route-parser.js";
 /**
  * Built-in server wrapper presets (generic, framework-agnostic)
@@ -92,11 +93,23 @@ function createDefaultDetector(configFiles) {
 }
 /**
  * Create default getBuildArtifacts function
+ * Uses ViteConfigParser for comprehensive Vite config support:
+ * - build.outDir: custom output directory
+ * - build.assetsDir: static assets directory name
+ * - build.ssr: SSR entry point
+ * - build.manifest: manifest.json generation
+ * - base: public base path
+ * - rollupOptions.input: entry file(s)
+ * - rollupOptions.output.dir: output directory override
+ * - rollupOptions.output.entryFileNames: output filename pattern
+ * - rollupOptions.output.assetFileNames: asset filename pattern
+ * - rollupOptions.output.chunkFileNames: chunk filename pattern
  */
 function createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, options) {
     const { clientBuildDir, serverBuildDir, serverEntry } = options;
     return async (context) => {
-        const { projectRoot, isSSR, logger } = context;
+        const { projectRoot, isSSR, logger, viteConfig } = context;
+        // Resolve client directory
         let clientDir = null;
         if (clientBuildDir) {
             clientDir = path.join(projectRoot, clientBuildDir);
@@ -107,17 +120,61 @@ function createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, op
         let serverDir = null;
         let serverEntryPath = null;
         if (isSSR && buildDirs.server) {
-            if (serverBuildDir) {
-                serverDir = path.join(projectRoot, serverBuildDir);
+            // Use ViteConfigParser for comprehensive config support
+            if (viteConfig) {
+                const configParser = new ViteConfigParser(viteConfig, projectRoot, {
+                    logger,
+                    serverEntryCandidates: serverEntryFiles,
+                });
+                // Priority 1: Explicit serverBuildDir option
+                if (serverBuildDir) {
+                    serverDir = path.join(projectRoot, serverBuildDir);
+                }
+                else {
+                    // Priority 2: Get from Vite config using parser
+                    serverDir = configParser.getServerDir();
+                }
+                // Priority 3: Fall back to predefined build directories
+                if (!serverDir) {
+                    serverDir = await detectBuildDir(projectRoot, buildDirs.server);
+                }
+                // Find server entry
+                if (serverEntry) {
+                    // Explicit server entry path provided
+                    serverEntryPath = path.join(projectRoot, serverEntry);
+                }
+                else if (serverDir) {
+                    // Priority 1: Try to get server entry from Vite config using parser
+                    serverEntryPath = await configParser.findServerEntry(serverDir);
+                    if (serverEntryPath) {
+                        logger.verbose(`Using server entry from Vite config: ${serverEntryPath}`);
+                    }
+                    // Priority 2: Fall back to file detection with recursive search
+                    if (!serverEntryPath) {
+                        serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles, {
+                            recursive: true,
+                            logger,
+                        });
+                    }
+                }
             }
             else {
-                serverDir = await detectBuildDir(projectRoot, buildDirs.server);
-            }
-            if (serverEntry) {
-                serverEntryPath = path.join(projectRoot, serverEntry);
-            }
-            else if (serverDir) {
-                serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles);
+                // No Vite config available, use fallback detection
+                if (serverBuildDir) {
+                    serverDir = path.join(projectRoot, serverBuildDir);
+                }
+                else {
+                    serverDir = await detectBuildDir(projectRoot, buildDirs.server);
+                }
+                if (serverEntry) {
+                    serverEntryPath = path.join(projectRoot, serverEntry);
+                }
+                else if (serverDir) {
+                    serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles, {
+                        recursive: true,
+                        logger,
+                    });
+                }
             }
         }
         logBuildArtifacts(logger, name, {
@@ -285,6 +342,94 @@ export function createFrameworkAdapter(config, options = {}, overrides) {
 export function createStatefulAdapter(initialState, factory) {
     return factory({ ...initialState });
 }
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export function createServerWrapperPreset(config) {
+    if (!config.handlerSetup) {
+        throw new Error("Server wrapper preset must have handlerSetup");
+    }
+    if (!config.handlerCall) {
+        throw new Error("Server wrapper preset must have handlerCall");
+    }
+    return {
+        imports: config.imports,
+        handlerSetup: config.handlerSetup.trim(),
+        handlerCall: config.handlerCall,
+        requiresHtmlTemplate: config.requiresHtmlTemplate,
+    };
+}
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "viteSSR");
+ * ```
+ */
+export function extendServerWrapperPresets(customPresets) {
+    // Validate and normalize all custom presets
+    const normalizedCustomPresets = {};
+    for (const [key, preset] of Object.entries(customPresets)) {
+        normalizedCustomPresets[key] =
+            createServerWrapperPreset(preset);
+    }
+    const extendedPresets = {
+        ...SERVER_WRAPPER_PRESETS,
+        ...normalizedCustomPresets,
+    };
+    function resolvePreset(preset) {
+        if (typeof preset === "string") {
+            const resolved = extendedPresets[preset];
+            if (!resolved) {
+                throw new Error(`Unknown server wrapper preset: "${preset}". Available presets: ${Object.keys(extendedPresets).join(", ")}`);
+            }
+            return resolved;
+        }
+        // Validate and normalize inline preset
+        return createServerWrapperPreset(preset);
+    }
+    function getPresetNames() {
+        return Object.keys(extendedPresets);
+    }
+    return {
+        presets: extendedPresets,
+        resolvePreset,
+        getPresetNames,
+    };
+}
 /**
  * Combine multiple detector functions (returns true if any matches)
  */