electron-incremental-update 1.3.0 → 2.0.0-beta.10

package/dist/vite.d.ts

@@ -1,24 +1,30 @@
-import { Plugin } from 'vite';
+import { PluginOption } from 'vite';
 import { ElectronSimpleOptions } from 'vite-plugin-electron/simple';
 import { Promisable } from '@subframe7536/type-utils';
 import { BuildOptions } from 'esbuild';
+export { isCI } from 'ci-info';
 
+/**
+ * Update info json
+ */
 type UpdateInfo = {
     signature: string;
     minimumVersion: string;
     version: string;
-    size: number;
 };
+/**
+ * {@link UpdateInfo} with beta
+ */
 type UpdateJSON = UpdateInfo & {
     beta: UpdateInfo;
 };
 
-type PKG = {
+interface PKG {
     name: string;
     version: string;
     main: string;
-};
-type DistinguishedName = {
+}
+interface DistinguishedName {
     countryName?: string;
     stateOrProvinceName?: string;
     localityName?: string;
@@ -30,30 +36,29 @@ type DistinguishedName = {
     description?: string;
     businessCategory?: string;
     emailAddress?: string;
-};
-type BuildEntryOption = {
+}
+interface BuildEntryOption {
     /**
-     * whether to minify
+     * Override to minify on entry
      * @default isBuild
      */
     minify?: boolean;
     /**
-     * whether to generate sourcemap
-     * @default isBuild
+     * Override to generate sourcemap on entry
      */
     sourcemap?: boolean;
     /**
-     * path to app entry output file
+     * Path to app entry output file
      * @default 'dist-entry'
      */
     entryOutputDirPath?: string;
     /**
-     * path to app entry file
+     * Path to app entry file
      * @default 'electron/entry.ts'
      */
     appEntryPath?: string;
     /**
-     * esbuild path map of native modules in entry directory
+     * Esbuild path map of native modules in entry directory
      *
      * @default {}
      * @example
@@ -61,7 +66,7 @@ type BuildEntryOption = {
      */
     nativeModuleEntryMap?: Record<string, string>;
     /**
-     * custom options for esbuild
+     * Custom options for esbuild
      * ```ts
      * // default options
      * const options = {
@@ -88,43 +93,43 @@ type BuildEntryOption = {
      */
     overrideEsbuildOptions?: BuildOptions;
     /**
-     * resolve extra files on startup, such as `.node`
+     * Resolve extra files on startup, such as `.node`
      * @remark won't trigger will reload
      */
     postBuild?: (args: {
         /**
-         * get path from `entryOutputDirPath`
+         * Get path from `entryOutputDirPath`
          */
         getPathFromEntryOutputDir: (...paths: string[]) => string;
         /**
-         * check exist and copy file to `entryOutputDirPath`
+         * Check exist and copy file to `entryOutputDirPath`
          *
-         * if `to` absent, set to `basename(from)`
+         * If `to` absent, set to `basename(from)`
          *
-         * if `skipIfExist` absent, skip copy if `to` exist
+         * If `skipIfExist` absent, skip copy if `to` exist
          */
         copyToEntryOutputDir: (options: {
             from: string;
             to?: string;
             /**
-             * skip copy if `to` exist
+             * Skip copy if `to` exist
              * @default true
              */
             skipIfExist?: boolean;
         }) => void;
     }) => Promisable<void>;
-};
-type GeneratorOverrideFunctions = {
+}
+interface GeneratorOverrideFunctions {
     /**
-     * custom signature generate function
+     * Custom signature generate function
      * @param buffer file buffer
      * @param privateKey private key
      * @param cert certificate string, **EOL must be '\n'**
      * @param version current version
      */
-    generateSignature?: (buffer: Buffer, privateKey: string, cert: string, version: string) => string | Promise<string>;
+    generateSignature?: (buffer: Buffer, privateKey: string, cert: string, version: string) => Promisable<string>;
     /**
-     * custom generate version json function
+     * Custom generate version json function
      * @param existingJson The existing JSON object.
      * @param buffer file buffer
      * @param signature generated signature
@@ -132,9 +137,14 @@ type GeneratorOverrideFunctions = {
      * @param minVersion The minimum version
      * @returns The updated version json
      */
-    generateVersionJson?: (existingJson: UpdateJSON, buffer: Buffer, signature: string, version: string, minVersion: string) => UpdateJSON | Promise<UpdateJSON>;
-};
-type ElectronUpdaterOptions = {
+    generateVersionJson?: (existingJson: UpdateJSON, signature: string, version: string, minVersion: string) => Promisable<UpdateJSON>;
+    /**
+     * Custom generate zip file buffer
+     * @param buffer source buffer
+     */
+    generateGzipFile?: (buffer: Buffer) => Promisable<Buffer>;
+}
+interface ElectronUpdaterOptions {
     /**
      * mini version of entry
      * @default '0.0.0'
@@ -218,20 +228,23 @@ type ElectronUpdaterOptions = {
              */
             days?: number;
         };
-        overrideGenerator?: GeneratorOverrideFunctions;
     };
-};
+    overrideGenerator?: GeneratorOverrideFunctions;
+}
 
-type BytecodeOptions = {
+interface BytecodeOptions {
+    enable: boolean;
     /**
-     * strings that should be transformed
+     * Enable in preload script. Remember to set `sandbox: false` when creating window
      */
-    protectedStrings?: string[];
+    preload?: boolean;
     /**
-     * Remember to set `sandbox: false` when creating window
+     * Before transformed code compile function. If return `Falsy` value, it will be ignored
+     * @param code transformed code
+     * @param id file path
      */
-    enablePreload?: boolean;
-};
+    beforeCompile?: (code: string, id: string) => Promisable<string | null | undefined | void>;
+}
 
 type MakeRequired<T, K extends keyof T> = Exclude<T, undefined> & {
     [P in K]-?: T[P];
@@ -256,9 +269,21 @@ declare function debugStartup(args: {
     startup: (argv?: string[]) => Promise<void>;
     reload: () => void;
 }): void;
-type ElectronWithUpdaterOptions = {
+type ExcludeOutputDirOptions = {
+    vite?: {
+        build?: {
+            outDir: never;
+            rollupOptions?: {
+                output?: {
+                    dir: never;
+                };
+            };
+        };
+    };
+};
+interface ElectronWithUpdaterOptions {
     /**
-     * whether is in build mode
+     * Whether is in build mode
      * ```ts
      * export default defineConfig(({ command }) => {
      *   const isBuild = command === 'build'
@@ -267,106 +292,79 @@ type ElectronWithUpdaterOptions = {
      */
     isBuild: boolean;
     /**
-     * manually setup package.json, read name, version and main
+     * Manually setup package.json, read name, version and main,
+     * use `local-pkg` of `loadPackageJSON()` to load package.json by default
      * ```ts
      * import pkg from './package.json'
      * ```
      */
     pkg?: PKG;
     /**
-     * whether to generate sourcemap
+     * Whether to generate sourcemap
      * @default !isBuild
      */
     sourcemap?: boolean;
     /**
-     * whether to minify the code
+     * Whether to minify the code
      * @default isBuild
      */
     minify?: boolean;
     /**
-     * whether to generate bytecode
+     * Whether to generate bytecode
      *
-     * **only support commonjs**
+     * **Only support CommonJS**
      *
-     * only main process by default, if you want to use in preload script, please use `electronWithUpdater({ bytecode: { enablePreload: true } })` and set `sandbox: false` when creating window
+     * Only main process by default, if you want to use in preload script, please use `electronWithUpdater({ bytecode: { enablePreload: true } })` and set `sandbox: false` when creating window
      */
     bytecode?: boolean | BytecodeOptions;
     /**
-     * use NotBundle() plugin in main
+     * Use `NotBundle()` plugin in main
      * @default true
      */
     useNotBundle?: boolean;
+    /**
+     * Whether to generate version json
+     * @default isCI
+     */
+    buildVersionJson?: boolean;
     /**
      * Whether to log parsed options
      *
-     * to show certificate and private keys, set `logParsedOptions: { showKeys: true }`
+     * To show certificate and private keys, set `logParsedOptions: { showKeys: true }`
      */
     logParsedOptions?: boolean | {
         showKeys: boolean;
     };
     /**
-     * main options
+     * Main process options
+     *
+     * To change output directories, use `options.updater.paths.electronDistPath` instead
      */
-    main: MakeRequiredAndReplaceKey<ElectronSimpleOptions['main'], 'entry', 'files'>;
+    main: MakeRequiredAndReplaceKey<ElectronSimpleOptions['main'], 'entry', 'files'> & ExcludeOutputDirOptions;
     /**
-     * preload options
+     * Preload process options
+     *
+     * To change output directories, use `options.updater.paths.electronDistPath` instead
      */
-    preload: MakeRequiredAndReplaceKey<Exclude<ElectronSimpleOptions['preload'], undefined>, 'input', 'files'>;
+    preload: MakeRequiredAndReplaceKey<Exclude<ElectronSimpleOptions['preload'], undefined>, 'input', 'files'> & ExcludeOutputDirOptions;
     /**
-     * updater options
+     * Updater options
      */
     updater?: ElectronUpdaterOptions;
-};
+}
 /**
- * build options for `vite-plugin-electron/simple`
+ * Base on `vite-plugin-electron/simple`
  * - integrate with updater
- * - only contains `main` and `preload` configs
- * - remove old electron files
+ * - no `renderer` config
+ * - remove old output file
  * - externalize dependencies
  * - auto restart when entry file changes
  * - other configs in {@link https://github.com/electron-vite/electron-vite-vue/blob/main/vite.config.ts electron-vite-vue template}
- * - no `vite-plugin-electron-renderer` config
  *
- * you can override all the configs
- *
- * **Limitation**: entry file change cannot trigger auto restart
+ * You can override all the vite configs, except output directories (use `options.updater.paths.electronDistPath` instead)
  *
  * @example
- * import { defineConfig } from 'vite'
- * import { debugStartup, electronWithUpdater } from 'electron-incremental-update/vite'
- * import pkg from './package.json'
- *
- * export default defineConfig(async ({ command }) => {
- *   const isBuild = command === 'build'
- *   return {
- *     plugins: [
- *       electronWithUpdater({
- *         pkg,
- *         isBuild,
- *         logParsedOptions: true,
- *         main: {
- *           files: ['./electron/main/index.ts', './electron/main/worker.ts'],
- *           // see https://github.com/electron-vite/electron-vite-vue/blob/85ed267c4851bf59f32888d766c0071661d4b94c/vite.config.ts#L22-L28
- *           onstart: debugStartup,
- *         },
- *         preload: {
- *           files: './electron/preload/index.ts',
- *         },
- *         updater: {
- *           // options
- *         }
- *       }),
- *     ],
- *     server: process.env.VSCODE_DEBUG && (() => {
- *       const url = new URL(pkg.debug.env.VITE_DEV_SERVER_URL)
- *       return {
- *         host: url.hostname,
- *         port: +url.port,
- *       }
- *     })(),
- *   }
- * })
  */
-declare function electronWithUpdater(options: ElectronWithUpdaterOptions): Promise<(Plugin<any> | Promise<Plugin<any>[]> | undefined)[] | null>;
+declare function electronWithUpdater(options: ElectronWithUpdaterOptions): Promise<PluginOption[] | undefined>;
 
-export { type ElectronWithUpdaterOptions, debugStartup, electronWithUpdater };
+export { type ElectronWithUpdaterOptions, debugStartup, electronWithUpdater as default, electronWithUpdater };