@chuckcchen/vite-plugin 1.0.3 → 1.0.5

package/dist/utils.d.ts

@@ -1,164 +1,103 @@
 /**
  * EdgeOne Vite Plugin Adapter - Utility Functions Module
  *
- * This module provides a set of general utility functions, including:
+ * This module provides utility functions for:
  * - Logging
- * - File system operations (read, write, copy, delete, etc.)
+ * - File system operations
  * - Path detection
- * - File size formatting
- * - Conditional waiting, etc.
+ * - Config file loading
+ * - Server wrapper generation
+ * - Meta configuration
  */
-import type { Logger } from "./types.js";
+import type { Logger, RouteInfo, MetaConfig } from "./types.js";
 /**
  * Create logger instance
- *
- * @param verbose - Enable verbose logging mode, default is false
- * @returns Logger object with log, verbose, warn, error methods
- *
- * @example
- * const logger = createLogger(true);
- * logger.verbose("This message only shows in verbose mode");
- * logger.warn("This is a warning message");
  */
 export declare function createLogger(verbose?: boolean): Logger;
 /**
  * Check if specified path exists
- *
- * @param filePath - File or directory path to check
- * @returns True if path exists, false otherwise
- *
- * @example
- * if (await pathExists('/path/to/file')) {
- *   console.log('File exists');
- * }
  */
 export declare function pathExists(filePath: string): Promise<boolean>;
-/**
- * Find first existing path from candidate list
- *
- * @param candidates - Candidate paths array, sorted by priority
- * @returns First existing path, or null if none exist
- *
- * @example
- * const buildDir = await findExistingPath([
- *   '/project/dist',
- *   '/project/build',
- *   '/project/output'
- * ]);
- */
-export declare function findExistingPath(candidates: string[]): Promise<string | null>;
 /**
  * Recursively copy directory
- * Copy all contents from source directory to destination directory
- *
- * @param src - Source directory path
- * @param dest - Destination directory path
- *
- * @example
- * await copyDirectory('dist/client', '.edgeone/assets');
  */
 export declare function copyDirectory(src: string, dest: string): Promise<void>;
 /**
- * Clean directory (delete and recreate)
- * Used to ensure directory is in a clean empty state
- *
- * @param dir - Directory path to clean
- *
- * @example
- * await cleanDirectory('.edgeone');
- */
-export declare function cleanDirectory(dir: string): Promise<void>;
-/**
- * Ensure directory exists
- * Recursively create if directory doesn't exist
- *
- * @param dir - Directory path
- *
- * @example
- * await ensureDirectory('.edgeone/server-handler');
+ * Ensure directory exists (creates recursively if needed)
  */
 export declare function ensureDirectory(dir: string): Promise<void>;
 /**
  * Read file content as string
- *
- * @param filePath - File path
- * @returns File content string (UTF-8 encoded)
- *
- * @example
- * const content = await readFile('dist/server/index.js');
  */
 export declare function readFile(filePath: string): Promise<string>;
 /**
- * Write content to file
- * Automatically creates parent directory if it doesn't exist
- *
- * @param filePath - File path
- * @param content - Content to write
- *
- * @example
- * await writeFile('.edgeone/meta.json', JSON.stringify(config));
+ * Write content to file (auto-creates parent directory)
  */
 export declare function writeFile(filePath: string, content: string): Promise<void>;
 /**
  * Delete file
- *
- * @param filePath - File path to delete
- *
- * @example
- * await deleteFile('server-wrapper.temp.js');
  */
 export declare function deleteFile(filePath: string): Promise<void>;
 /**
- * Format file size to human-readable string
- *
- * @param bytes - Number of bytes
- * @returns Formatted string, e.g. "1.5 KB", "2.3 MB"
- *
- * @example
- * formatSize(1536);    // "1.5 KB"
- * formatSize(2457600); // "2.34 MB"
+ * List files in directory
+ * @param dir - Directory path
+ * @param logger - Optional logger for verbose error reporting
  */
-export declare function formatSize(bytes: number): string;
+export declare function listFiles(dir: string, logger?: Logger): Promise<string[]>;
 /**
- * Wait for condition to be met (with retry mechanism)
- * Used to wait for async operations to complete, like file writes
- *
- * @param condition - Async condition function returning boolean
- * @param options - Configuration options
- * @param options.maxRetries - Maximum retry count, default 15
- * @param options.delay - Delay between retries in milliseconds, default 300ms
- * @returns True if condition met, false if timeout
- *
- * @example
- * const ready = await waitFor(
- *   async () => await pathExists('dist/index.html'),
- *   { maxRetries: 10, delay: 500 }
- * );
- */
-export declare function waitFor(condition: () => Promise<boolean>, options?: {
-    maxRetries?: number;
-    delay?: number;
-}): Promise<boolean>;
-/**
- * List files and subdirectory names in directory
- *
- * @param dir - Directory path
- * @returns Array of file and directory names, empty array if directory doesn't exist
- *
- * @example
- * const files = await listFiles('dist/client');
- * // ['index.html', 'assets', 'favicon.ico']
+ * Detect config file from candidate list
  */
-export declare function listFiles(dir: string): Promise<string[]>;
+export declare function detectConfigFile(projectRoot: string, patterns: string[]): Promise<string | null>;
 /**
- * Recursively count files in directory
- *
- * @param dir - Directory path
- * @returns Total file count (excluding directories)
- *
- * @example
- * const count = await countFiles('dist');
- * console.log(`Build artifacts contain ${count} files`);
+ * Detect build directory from candidate list
+ */
+export declare function detectBuildDir(projectRoot: string, candidates: string[]): Promise<string | null>;
+/**
+ * Detect server entry file from candidate list
+ */
+export declare function detectServerEntry(serverDir: string, candidates?: string[]): Promise<string | null>;
+/**
+ * Dynamically import config file
+ */
+/**
+ * Dynamically import config file
+ * @param configPath - Path to config file
+ * @param logger - Optional logger for verbose error reporting
+ */
+export declare function loadConfigFile<T = unknown>(configPath: string, logger?: Logger): Promise<T | null>;
+/**
+ * Normalize route path
+ */
+export declare function normalizeRoutePath(routePath: string): string;
+/**
+ * Create default meta configuration
+ */
+export declare function createDefaultMeta(routes: RouteInfo[], options?: {
+    isSSR?: boolean;
+    has404?: boolean;
+}): MetaConfig;
+/** Node.js IncomingMessage to Web Request converter code */
+export declare const NODE_REQUEST_CONVERTER_CODE: string;
+/** Server wrapper generator options */
+export interface ServerWrapperGeneratorOptions {
+    serverEntryPath: string;
+    handlerSetup?: string;
+    handlerCall: string;
+    imports?: string;
+    needsNodeRequestConversion?: boolean;
+    mode?: "inline" | "import";
+    additionalExports?: string[];
+}
+/**
+ * Generate server wrapper code
+ */
+export declare function generateServerWrapperCode(options: ServerWrapperGeneratorOptions): Promise<string>;
+/**
+ * Log build artifacts info
  */
-export declare function countFiles(dir: string): Promise<number>;
+export declare function logBuildArtifacts(logger: Logger, adapterName: string, artifacts: {
+    clientDir?: string | null;
+    serverDir?: string | null;
+    serverEntry?: string | null;
+}): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,OAAe,GAAG,MAAM,CAqB7D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACjC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM9D;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB7D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}