#App

App is the application abstraction in Esmx, providing a unified interface for lifecycle management, static assets, and server-side rendering.

export default {
  async devApp(esmx) {
    return import('@esmx/rspack').then((m) =>
      m.createRspackHtmlApp(esmx, {
        config(rc) {
        }
      })
    );
  }
}

#Type Definitions

#App

interface App {
  middleware: Middleware;
  render: (options?: RenderContextOptions) => Promise<RenderContext>;
  build?: () => Promise<boolean>;
  destroy?: () => Promise<boolean>;
}

#middleware

• Type: Middleware

Static assets middleware.

Development:

• Serves static assets from source
• Supports on-demand compilation and HMR
• Uses no-cache strategy

Production:

• Serves built static assets
• Supports long-term caching for immutable files (.final.xxx)
• Optimized asset loading strategy

server.use(esmx.middleware);

#render

• Type: (options?: RenderContextOptions) => Promise<RenderContext>

Server-side rendering function with environment-specific behavior:

• Production (start): loads built server entry (entry.server) for rendering
• Development (dev): loads server entry from source

const rc = await esmx.render({
  params: { url: '/page' }
});
res.end(rc.html);

#build

• Type: () => Promise<boolean>

Production build. Handles bundling and optimizations. Resolves to true on success, false on failure.

#destroy

• Type: () => Promise<boolean>

Resource cleanup. Closes servers and disconnects. Resolves to true on success, false on failure.