alepha 0.13.0 → 0.13.1

package/dist/vite/index.d.cts

@@ -1,542 +0,0 @@
-import { Alepha } from "alepha";
-import { Logger, Plugin, ResolvedConfig, UserConfig, ViteDevServer, defineConfig } from "vite";
-import { BrotliOptions, ZlibOptions } from "node:zlib";
-
-//#region src/vite/helpers/boot.d.ts
-declare const boot: {
-  getClientEntry: (root?: string) => Promise<string | undefined>;
-  getServerEntry: (root?: string, explicitEntry?: string) => Promise<string>;
-};
-//#endregion
-//#region src/vite/helpers/createBufferedLogger.d.ts
-interface BufferedLogEntry {
-  level: "info" | "warn" | "error";
-  msg: string;
-  timestamp: Date;
-}
-interface BufferedLogger extends Logger {
-  /**
-   * Flush all buffered log messages to console.
-   * Call this on build failure to show what happened.
-   */
-  flush(): void;
-  /**
-   * Get all buffered log entries.
-   */
-  getEntries(): BufferedLogEntry[];
-  /**
-   * Clear all buffered entries without printing.
-   */
-  clear(): void;
-}
-/**
- * Creates a Vite logger that buffers all messages instead of printing them.
- * Useful for silent builds that only show output on failure.
- *
- * @example
- * ```ts
- * const logger = createBufferedLogger();
- * try {
- *   await viteBuild({ customLogger: logger, logLevel: 'info' });
- * } catch (error) {
- *   logger.flush(); // Print all buffered logs
- *   throw error;
- * }
- * ```
- */
-declare function createBufferedLogger(): BufferedLogger;
-//#endregion
-//#region src/vite/plugins/viteCompress.d.ts
-interface ViteCompressOptions {
-  /**
-   * If true, the plugin will not compress the files.
-   *
-   * @default false
-   */
-  disabled?: boolean;
-  /**
-   * If true, the plugin will compress the files using brotli.
-   * Can also be an object with brotli options.
-   *
-   * @default true
-   */
-  brotli?: boolean | BrotliOptions;
-  /**
-   * If true, the plugin will compress the files using gzip.
-   * Can also be an object with gzip options.
-   *
-   * @default true
-   */
-  gzip?: boolean | ZlibOptions;
-  /**
-   * A filter to determine which files to compress.
-   * Can be a RegExp or a function that returns true for files to compress.
-   *
-   * @default /\.(js|mjs|cjs|css|wasm|svg|html)$/
-   */
-  filter?: RegExp | ((fileName: string) => boolean);
-}
-declare function viteCompress(options?: ViteCompressOptions): Plugin;
-declare function compressFile(options: ViteCompressOptions | undefined, filePath: string): Promise<void>;
-//#endregion
-//#region src/vite/tasks/buildClient.d.ts
-interface BuildClientOptions {
-  /**
-   * Output directory for client build.
-   */
-  dist: string;
-  /**
-   * If true, precompress assets using gzip and brotli compression.
-   *
-   * @default false
-   */
-  precompress?: ViteCompressOptions | boolean;
-  /**
-   * If true, prerender all static routes found in the $pages directory.
-   *
-   * @default false
-   */
-  prerender?: boolean;
-  /**
-   * Build a sitemap.xml file based on the $pages routes.
-   */
-  sitemap?: {
-    hostname: string;
-  };
-  /**
-   * Override Vite config options.
-   */
-  config?: UserConfig;
-  /**
-   * If true, generate build stats report.
-   */
-  stats?: boolean;
-  /**
-   * If true, suppress build output. Logs are buffered and only shown on failure.
-   *
-   * @default false
-   */
-  silent?: boolean;
-}
-/**
- * Build client-side bundle with Vite.
- *
- * This task compiles the browser/client code for production,
- * including code splitting, minification, and optional compression.
- */
-declare function buildClient(opts: BuildClientOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/buildServer.d.ts
-interface BuildServerOptions {
-  /**
-   * Path to the server entry file.
-   */
-  entry: string;
-  /**
-   * Output directory for server build.
-   */
-  distDir: string;
-  /**
-   * Optional client directory name (relative to distDir).
-   * If provided, the client template will be embedded in the server output.
-   */
-  clientDir?: string;
-  /**
-   * Override Vite config options.
-   */
-  config?: UserConfig;
-  /**
-   * If true, generate build stats report.
-   */
-  stats?: boolean;
-  /**
-   * If true, suppress build output. Logs are buffered and only shown on failure.
-   *
-   * @default false
-   */
-  silent?: boolean;
-}
-interface BuildServerResult {
-  /**
-   * The filename of the built server entry (e.g., "abc123.js").
-   */
-  entryFile: string;
-}
-/**
- * Build server-side SSR bundle with Vite.
- *
- * This task compiles the server code for production,
- * generates the externals package.json, and creates
- * the dist/index.js entry wrapper.
- */
-declare function buildServer(opts: BuildServerOptions): Promise<BuildServerResult>;
-//#endregion
-//#region src/vite/tasks/copyAssets.d.ts
-interface CopyAssetsOptions {
-  /**
-   * Entry point for the built Alepha application.
-   */
-  entry: string;
-  /**
-   * Output directory for copied assets.
-   */
-  distDir: string;
-}
-/**
- * Copy assets from Alepha packages to the build output directory.
- *
- * This task loads the built Alepha application, reads the
- * `alepha.build.assets` state to find packages with assets,
- * and copies their `/assets` directories to the build output.
- *
- * Used by modules like AlephaServerSwagger to distribute UI files.
- */
-declare function copyAssets(opts: CopyAssetsOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/generateCloudflare.d.ts
-interface GenerateCloudflareOptions {
-  /**
-   * The directory where the build output is placed.
-   *
-   * @default "dist"
-   */
-  distDir?: string;
-}
-/**
- * Generate Cloudflare Workers deployment configuration.
- *
- * This task creates:
- * - wrangler.jsonc with worker configuration
- * - worker.js entry point for Cloudflare Workers
- */
-declare function generateCloudflare(opts?: GenerateCloudflareOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/generateDocker.d.ts
-interface GenerateDockerOptions {
-  /**
-   * The directory where the build output is placed.
-   *
-   * @default "dist"
-   */
-  distDir?: string;
-  /**
-   * Docker image name to use in the Dockerfile.
-   *
-   * @default "node:24-alpine"
-   */
-  image?: string;
-  /**
-   * Command to run in the Docker container.
-   *
-   * @default "node"
-   */
-  command?: string;
-}
-/**
- * Generate Docker deployment configuration.
- *
- * This task creates:
- * - Dockerfile with configurable Node image
- * - Copies drizzle migrations if they exist
- */
-declare function generateDocker(opts?: GenerateDockerOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/generateExternals.d.ts
-interface GenerateExternalsOptions {
-  /**
-   * Output directory for package.json.
-   */
-  distDir: string;
-  /**
-   * List of external package names.
-   */
-  externals: string[];
-}
-/**
- * Generate minimal package.json with pinned external dependencies.
- *
- * This task creates a package.json in the dist directory containing
- * only the external dependencies needed at runtime, with their versions
- * pinned to the currently installed versions.
- */
-declare function generateExternals(opts: GenerateExternalsOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/generateSitemap.d.ts
-interface GenerateSitemapOptions {
-  /**
-   * Entry point for the built Alepha application.
-   */
-  entry: string;
-  /**
-   * Base URL for the sitemap (e.g., "https://example.com").
-   */
-  baseUrl: string;
-  /**
-   * Optional HTML template (for React SSR).
-   */
-  template?: string;
-}
-/**
- * Generate sitemap.xml from Alepha page descriptors.
- *
- * This task loads the built Alepha application,
- * queries all page descriptors, and generates a sitemap.xml
- * containing URLs for all accessible pages.
- */
-declare function generateSitemap(opts: GenerateSitemapOptions): Promise<string>;
-//#endregion
-//#region src/vite/tasks/generateVercel.d.ts
-interface GenerateVercelOptions {
-  /**
-   * The directory where the build output is placed.
-   *
-   * @default "dist"
-   */
-  distDir?: string;
-  /**
-   * The name of the client directory.
-   *
-   * @default "public"
-   */
-  clientDir?: string;
-  /**
-   * Vercel configuration options.
-   */
-  config?: VercelConfig;
-}
-interface VercelConfig {
-  projectName?: string;
-  orgId?: string;
-  projectId?: string;
-  config?: Record<string, any> & {
-    crons?: Array<{
-      path: string;
-      schedule: string;
-    }>;
-  };
-}
-/**
- * Generate Vercel deployment configuration.
- *
- * This task creates:
- * - vercel.json with route rewrites
- * - api/index.js entry point for Vercel serverless function
- * - .vercel/project.json if VERCEL_PROJECT_ID and VERCEL_ORG_ID are set
- */
-declare function generateVercel(opts?: GenerateVercelOptions): Promise<void>;
-//#endregion
-//#region src/vite/tasks/prerenderPages.d.ts
-interface PrerenderPagesOptions {
-  /**
-   * Entry point for the built Alepha application.
-   */
-  entry: string;
-  /**
-   * Client dist directory for output files.
-   */
-  dist: string;
-  /**
-   * Optional compression options.
-   */
-  compress?: ViteCompressOptions | boolean;
-}
-interface PrerenderPagesResult {
-  /**
-   * Number of pages pre-rendered.
-   */
-  count: number;
-}
-/**
- * Pre-render static pages defined in the Alepha application.
- *
- * This task loads the built Alepha application, queries all page
- * descriptors with `static: true`, and generates static HTML files
- * for each page. Supports pages with parameterized routes via
- * `static.entries` configuration.
- */
-declare function prerenderPages(opts: PrerenderPagesOptions): Promise<PrerenderPagesResult>;
-//#endregion
-//#region src/vite/tasks/runAlepha.d.ts
-interface AlephaRunnerOptions {
-  /**
-   * Path to the server entry file.
-   */
-  entry: string;
-  /**
-   * Enable debug logging.
-   */
-  debug?: boolean;
-}
-interface AlephaRunnerState {
-  root: string;
-  started: boolean;
-  app?: Alepha;
-  config?: ResolvedConfig;
-  lock?: PromiseWithResolvers<void>;
-  log: (...msg: string[]) => void;
-  entry: string;
-  onReload?: () => void;
-}
-/**
- * Create an Alepha runner for development.
- *
- * The runner manages the lifecycle of an Alepha application during
- * Vite dev server operation, handling start/stop/restart and HMR.
- */
-declare function createAlephaRunner(opts: AlephaRunnerOptions): AlephaRunner;
-declare class AlephaRunner {
-  protected state: AlephaRunnerState;
-  constructor(state: AlephaRunnerState);
-  /**
-   * Set resolved Vite config.
-   */
-  setConfig(config: ResolvedConfig): void;
-  /**
-   * Check if SSR is enabled for the running app.
-   */
-  isSsrEnabled(): boolean;
-  /**
-   * Check if app is started.
-   */
-  get isStarted(): boolean;
-  /**
-   * Get the running Alepha app instance.
-   */
-  get app(): Alepha | undefined;
-  /**
-   * Start the Alepha application.
-   */
-  start(server: ViteDevServer): Promise<void>;
-  /**
-   * Stop the Alepha application.
-   */
-  stop(): Promise<void>;
-  /**
-   * Restart the Alepha application.
-   *
-   * @returns true if the restart was skipped due to locking
-   */
-  restart(server: ViteDevServer, invalidate?: boolean): Promise<boolean>;
-  /**
-   * Send reload event to client.
-   */
-  sendReload(server: ViteDevServer): void;
-}
-/**
- * Check if a URL path is a Vite internal file.
- */
-declare function isViteInternalPath(pathname: string): boolean;
-//#endregion
-//#region src/vite/plugins/viteAlephaBuild.d.ts
-interface ViteAlephaBuildOptions {
-  /**
-   * Path to the entry file for the server build.
-   * If empty, SSR build will be skipped.
-   */
-  serverEntry?: string | false;
-  /**
-   * Set false to skip the client build.
-   * This is useful if you only want to build the server-side application.
-   */
-  client?: false | Partial<BuildClientOptions>;
-  /**
-   * If true, the build will be optimized for Vercel deployment.
-   *
-   * If `VERCEL_PROJECT_ID` and `VERCEL_ORG_ID` environment variables are set, .vercel will be generated with the correct configuration.
-   *
-   * @default false
-   */
-  vercel?: boolean | VercelConfig;
-  /**
-   * If true, the build will generate Cloudflare Workers configuration.
-   *
-   * @default false
-   */
-  cloudflare?: boolean;
-  /**
-   * If true, the build will be optimized for Docker deployment.
-   * Additionally, it will generate a Dockerfile in the dist directory.
-   */
-  docker?: boolean | Omit<GenerateDockerOptions, "distDir">;
-  /**
-   * If true, build statistics will be printed after the build completes.
-   */
-  stats?: boolean;
-}
-/**
- * Build modes controlled by ALEPHA_BUILD_MODE environment variable:
- * - "cli": Skip plugin entirely, CLI handles all tasks
- * - "client": Only build client bundle
- * - "server": Only build server bundle
- * - undefined/other: Full build (default behavior)
- */
-type AlephaBuildMode = "cli" | "client" | "server";
-/**
- * Alepha build plugin for Vite.
- *
- * This plugin orchestrates the complete build process:
- * 1. Build client (if index.html exists)
- * 2. Build server (SSR)
- * 3. Copy assets from packages
- * 4. Pre-render static pages (if enabled)
- * 5. Generate sitemap (if enabled)
- * 6. Generate deployment config (Vercel/Cloudflare/Docker)
- *
- * Build mode can be controlled via ALEPHA_BUILD_MODE env var for CLI integration.
- */
-declare function viteAlephaBuild(options?: ViteAlephaBuildOptions): Promise<Plugin>;
-//#endregion
-//#region src/vite/plugins/viteAlephaDev.d.ts
-interface ViteAlephaDevOptions {
-  /**
-   * Path to the entry file for the server build.
-   * If empty, plugin will be disabled.
-   */
-  serverEntry?: string | false;
-  /**
-   * If true, enables debug logging.
-   *
-   * @default false
-   */
-  debug?: boolean;
-}
-/**
- * Plug Alepha into Vite development server.
- *
- * This plugin manages the Alepha application lifecycle during development,
- * handling hot module replacement and request forwarding.
- */
-declare function viteAlephaDev(options?: ViteAlephaDevOptions): Promise<Plugin>;
-//#endregion
-//#region src/vite/plugins/viteAlepha.d.ts
-type ViteAlephaOptions = ViteAlephaDevOptions & ViteAlephaBuildOptions & {
-  react?: false;
-};
-declare function viteAlepha(options?: ViteAlephaOptions): (Plugin | Promise<Plugin>)[];
-//#endregion
-//#region src/vite/index.d.ts
-declare global {
-  var __cli_alepha: Alepha;
-}
-/**
- * Plugin vite for Alepha framework.
- *
- * This module provides Vite plugins and configurations to integrate Alepha applications with Vite's build and development processes.
- *
- * @example
- * ```ts
- * import { defineConfig } from "vite";
- * import { viteAlepha } from "alepha/vite";
- *
- * export default defineConfig({
- *   plugins: [viteAlepha()],
- *   // other Vite configurations...
- * });
- * ```
- *
- * @module alepha.vite
- */
-
-//#endregion
-export { AlephaBuildMode, AlephaRunner, AlephaRunnerOptions, AlephaRunnerState, BufferedLogger, BuildClientOptions, BuildServerOptions, BuildServerResult, CopyAssetsOptions, GenerateCloudflareOptions, GenerateDockerOptions, GenerateExternalsOptions, GenerateSitemapOptions, GenerateVercelOptions, PrerenderPagesOptions, PrerenderPagesResult, VercelConfig, ViteAlephaBuildOptions, ViteAlephaDevOptions, ViteAlephaOptions, ViteCompressOptions, boot, buildClient, buildServer, compressFile, copyAssets, createAlephaRunner, createBufferedLogger, defineConfig, generateCloudflare, generateDocker, generateExternals, generateSitemap, generateVercel, isViteInternalPath, prerenderPages, viteAlepha, viteAlephaBuild, viteAlephaDev, viteCompress };
-//# sourceMappingURL=index.d.cts.map