@jay-framework/dev-server 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -2,42 +2,66 @@ import { ViteDevServer, Connect } from 'vite';
 import { JayRoute } from '@jay-framework/stack-route-scanner';
 import { RequestHandler } from 'express-serve-static-core';
 import { JayRollupConfig } from '@jay-framework/rollup-plugin';
+import { ProjectClientInitInfo, PluginWithInit, ActionRegistry } from '@jay-framework/stack-server-runtime';
+import { RequestHandler as RequestHandler$1 } from 'express';
 
 interface DevServerOptions {
     publicBaseUrlPath?: string;
     projectRootFolder?: string;
     pagesRootFolder?: string;
+    /**
+     * Folder where build artifacts are stored.
+     * Pre-rendered jay-html files are written to `<buildFolder>/slow-render-cache/`.
+     * Defaults to `<projectRootFolder>/build`.
+     */
+    buildFolder?: string;
     jayRollupConfig: JayRollupConfig;
     dontCacheSlowly: boolean;
+    /**
+     * Disable automation integration.
+     * When false (default), pages are wrapped with automation API for dev tooling.
+     * The automation API is available at `window.__jay.automation` and via `AUTOMATION_CONTEXT`.
+     */
+    disableAutomation?: boolean;
 }
 
 /**
  * Service lifecycle management for the Jay Stack dev-server.
  *
- * Handles loading jay.init.ts, running init/shutdown callbacks,
- * hot reloading services, and graceful shutdown.
+ * Handles loading lib/init.ts, running init/shutdown callbacks,
+ * hot reloading services, graceful shutdown, and action auto-discovery.
  */
 
 declare class ServiceLifecycleManager {
     private projectRoot;
     private sourceBase;
-    private initFilePath;
+    /** Path to project's lib/init.ts (makeJayInit pattern) */
+    private projectInitFilePath;
     private isInitialized;
     private viteServer;
+    private pluginsWithInit;
     constructor(projectRoot: string, sourceBase?: string);
     /**
      * Set the Vite server instance for SSR module loading
      */
     setViteServer(viteServer: ViteDevServer): void;
     /**
-     * Finds the jay.init.ts (or .js) file in the source directory.
-     * Looks in: {projectRoot}/{sourceBase}/jay.init.{ts,js,mts,mjs}
+     * Finds the project init file using makeJayInit pattern.
+     * Looks in: {projectRoot}/{sourceBase}/init.{ts,js}
      */
-    private findInitFile;
+    private findProjectInitFile;
     /**
-     * Initializes services by loading and executing jay.init.ts
+     * Initializes services by:
+     * 1. Discovering and executing plugin server inits (in dependency order)
+     * 2. Loading and executing project lib/init.ts
+     * 3. Running all registered onInit callbacks
+     * 4. Auto-discovering and registering actions
      */
     initialize(): Promise<void>;
+    /**
+     * Auto-discovers and registers actions from project and plugins.
+     */
+    private discoverActions;
     /**
      * Shuts down services gracefully with timeout
      */
@@ -47,9 +71,18 @@ declare class ServiceLifecycleManager {
      */
     reload(): Promise<void>;
     /**
-     * Returns the path to the init file if found
+     * Returns the path to the init file if found.
      */
     getInitFilePath(): string | null;
+    /**
+     * Returns project init info for client-side embedding.
+     */
+    getProjectInit(): ProjectClientInitInfo | null;
+    /**
+     * Returns the discovered plugins with init configurations.
+     * Sorted by dependencies (plugins with no deps first).
+     */
+    getPluginsWithInit(): PluginWithInit[];
     /**
      * Checks if services are initialized
      */
@@ -69,4 +102,53 @@ interface DevServer {
 }
 declare function mkDevServer(options: DevServerOptions): Promise<DevServer>;
 
-export { type DevServer, type DevServerOptions, type DevServerRoute, mkDevServer };
+/**
+ * Action Router for Jay Stack dev server.
+ *
+ * Handles HTTP requests to /_jay/actions/:actionName
+ * and routes them to registered action handlers.
+ */
+
+/**
+ * The base path for action endpoints.
+ */
+declare const ACTION_ENDPOINT_BASE = "/_jay/actions";
+/**
+ * Options for creating the action router.
+ */
+interface ActionRouterOptions {
+    /**
+     * The action registry to use.
+     * Defaults to the global actionRegistry.
+     */
+    registry?: ActionRegistry;
+}
+/**
+ * Creates the action router middleware.
+ *
+ * Handles requests to /_jay/actions/:actionName
+ *
+ * For GET requests, input is parsed from query string.
+ * For POST/PUT/PATCH/DELETE, input is parsed from request body.
+ *
+ * @param options - Optional configuration including custom registry for testing
+ *
+ * @example
+ * ```typescript
+ * // In dev-server setup (uses default registry)
+ * const actionRouter = createActionRouter();
+ * app.use(ACTION_ENDPOINT_BASE, actionRouter);
+ *
+ * // For testing (uses isolated registry)
+ * const testRegistry = new ActionRegistry();
+ * const actionRouter = createActionRouter({ registry: testRegistry });
+ * ```
+ */
+declare function createActionRouter(options?: ActionRouterOptions): RequestHandler$1;
+/**
+ * Express middleware to parse JSON body for action requests.
+ * Should be applied before the action router.
+ */
+declare function actionBodyParser(): RequestHandler$1;
+
+export { ACTION_ENDPOINT_BASE, type ActionRouterOptions, type DevServer, type DevServerOptions, type DevServerRoute, actionBodyParser, createActionRouter, mkDevServer };