electron-incremental-update 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/utils.js

@@ -1,62 +1,3 @@
-import {
-  decrypt,
-  disableHWAccForWin7,
-  encrypt,
-  getAppVersion,
-  getEntryVersion,
-  getPathFromAppNameAsar,
-  getPathFromEntryAsar,
-  getPathFromPreload,
-  getPathFromPublic,
-  handleUnexpectedErrors,
-  hashString,
-  isDev,
-  isLinux,
-  isLowerVersionDefault,
-  isMac,
-  isUpdateJSON,
-  isWin,
-  loadPage,
-  parseVersion,
-  requireNative,
-  restartApp,
-  setAppUserModelId,
-  setPortableAppDataPath,
-  signature,
-  singleInstance,
-  unzipFile,
-  verifySignatureDefault,
-  waitAppReady,
-  zipFile
-} from "./chunk-RSLOPAIZ.js";
-export {
-  decrypt,
-  disableHWAccForWin7,
-  encrypt,
-  getAppVersion,
-  getEntryVersion,
-  getPathFromAppNameAsar,
-  getPathFromEntryAsar,
-  getPathFromPreload,
-  getPathFromPublic,
-  handleUnexpectedErrors,
-  hashString,
-  isDev,
-  isLinux,
-  isLowerVersionDefault,
-  isMac,
-  isUpdateJSON,
-  isWin,
-  loadPage,
-  parseVersion,
-  requireNative,
-  restartApp,
-  setAppUserModelId,
-  setPortableAppDataPath,
-  signature,
-  singleInstance,
-  unzipFile,
-  verifySignatureDefault,
-  waitAppReady,
-  zipFile
-};
+export { disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, isDev, isLinux, isMac, isWin, loadPage, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance } from './chunk-IABBXJFB.js';
+export { aesDecrypt, aesEncrypt, defaultSignature, defaultUnzipFile, defaultVerifySignature, defaultZipFile, hashBuffer } from './chunk-KZSYEXLO.js';
+export { defaultIsLowerVersion, defaultVersionJsonGenerator, isUpdateJSON, parseVersion } from './chunk-RCRKUKFX.js';

package/dist/version-BYVQ367i.d.cts

@@ -0,0 +1,62 @@
+interface Version {
+    /**
+     * `4` of `4.3.2-beta.1`
+     */
+    major: number;
+    /**
+     * `3` of `4.3.2-beta.1`
+     */
+    minor: number;
+    /**
+     * `2` of `4.3.2-beta.1`
+     */
+    patch: number;
+    /**
+     * `beta` of `4.3.2-beta.1`
+     */
+    stage: string;
+    /**
+     * `1` of `4.3.2-beta.1`
+     */
+    stageVersion: number;
+}
+/**
+ * Parse version string to {@link Version}, like `0.2.0-beta.1`
+ * @param version version string
+ */
+declare function parseVersion(version: string): Version;
+/**
+ * Default function to check the old version is less than new version
+ * @param oldVer old version string
+ * @param newVer new version string
+ */
+declare function defaultIsLowerVersion(oldVer: string, newVer: string): boolean;
+/**
+ * Update info json
+ */
+type UpdateInfo = {
+    signature: string;
+    minimumVersion: string;
+    version: string;
+};
+/**
+ * {@link UpdateInfo} with beta
+ */
+type UpdateJSON = UpdateInfo & {
+    beta: UpdateInfo;
+};
+/**
+ * Check is `UpdateJSON`
+ * @param json any variable
+ */
+declare function isUpdateJSON(json: any): json is UpdateJSON;
+/**
+ * Default function to generate `UpdateJSON`
+ * @param existingJson exising update json
+ * @param signature sigature
+ * @param version target version
+ * @param minimumVersion minimum version
+ */
+declare function defaultVersionJsonGenerator(existingJson: UpdateJSON, signature: string, version: string, minimumVersion: string): UpdateJSON;
+
+export { type UpdateInfo as U, type Version as V, type UpdateJSON as a, defaultVersionJsonGenerator as b, defaultIsLowerVersion as d, isUpdateJSON as i, parseVersion as p };

package/dist/version-BYVQ367i.d.ts

@@ -0,0 +1,62 @@
+interface Version {
+    /**
+     * `4` of `4.3.2-beta.1`
+     */
+    major: number;
+    /**
+     * `3` of `4.3.2-beta.1`
+     */
+    minor: number;
+    /**
+     * `2` of `4.3.2-beta.1`
+     */
+    patch: number;
+    /**
+     * `beta` of `4.3.2-beta.1`
+     */
+    stage: string;
+    /**
+     * `1` of `4.3.2-beta.1`
+     */
+    stageVersion: number;
+}
+/**
+ * Parse version string to {@link Version}, like `0.2.0-beta.1`
+ * @param version version string
+ */
+declare function parseVersion(version: string): Version;
+/**
+ * Default function to check the old version is less than new version
+ * @param oldVer old version string
+ * @param newVer new version string
+ */
+declare function defaultIsLowerVersion(oldVer: string, newVer: string): boolean;
+/**
+ * Update info json
+ */
+type UpdateInfo = {
+    signature: string;
+    minimumVersion: string;
+    version: string;
+};
+/**
+ * {@link UpdateInfo} with beta
+ */
+type UpdateJSON = UpdateInfo & {
+    beta: UpdateInfo;
+};
+/**
+ * Check is `UpdateJSON`
+ * @param json any variable
+ */
+declare function isUpdateJSON(json: any): json is UpdateJSON;
+/**
+ * Default function to generate `UpdateJSON`
+ * @param existingJson exising update json
+ * @param signature sigature
+ * @param version target version
+ * @param minimumVersion minimum version
+ */
+declare function defaultVersionJsonGenerator(existingJson: UpdateJSON, signature: string, version: string, minimumVersion: string): UpdateJSON;
+
+export { type UpdateInfo as U, type Version as V, type UpdateJSON as a, defaultVersionJsonGenerator as b, defaultIsLowerVersion as d, isUpdateJSON as i, parseVersion as p };

package/dist/vite.d.ts

@@ -0,0 +1,372 @@
+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;
+};
+/**
+ * {@link UpdateInfo} with beta
+ */
+type UpdateJSON = UpdateInfo & {
+    beta: UpdateInfo;
+};
+
+interface PKG {
+    name: string;
+    version: string;
+    main: string;
+    type: 'commonjs' | 'module';
+}
+interface DistinguishedName {
+    countryName?: string;
+    stateOrProvinceName?: string;
+    localityName?: string;
+    organizationName?: string;
+    organizationalUnitName?: string;
+    commonName?: string;
+    serialNumber?: string;
+    title?: string;
+    description?: string;
+    businessCategory?: string;
+    emailAddress?: string;
+}
+interface BuildEntryOption {
+    /**
+     * Override to minify on entry
+     * @default isBuild
+     */
+    minify?: boolean;
+    /**
+     * Override to generate sourcemap on entry
+     */
+    sourcemap?: boolean;
+    /**
+     * Path to app entry output file
+     * @default 'dist-entry'
+     */
+    entryOutputDirPath?: string;
+    /**
+     * Path to app entry file
+     * @default 'electron/entry.ts'
+     */
+    appEntryPath?: string;
+    /**
+     * Esbuild path map of native modules in entry directory
+     *
+     * @default {}
+     * @example
+     * { db: './electron/native/db.ts' }
+     */
+    nativeModuleEntryMap?: Record<string, string>;
+    /**
+     * Custom options for esbuild
+     * ```ts
+     * // default options
+     * const options = {
+     *   entryPoints: {
+     *     entry: appEntryPath,
+     *     ...moduleEntryMap,
+     *   },
+     *   bundle: true,
+     *   platform: 'node',
+     *   outdir: entryOutputDirPath,
+     *   minify,
+     *   sourcemap,
+     *   entryNames: '[dir]/[name]',
+     *   assetNames: '[dir]/[name]',
+     *   external: ['electron', 'original-fs'],
+     *   loader: {
+     *     '.node': 'empty',
+     *   },
+     *   define: {
+     *     __EIU_SIGNATURE_CERT__: JSON.stringify(cert),
+     *     // ...
+     *   },
+     * }
+     * ```
+     */
+    overrideEsbuildOptions?: BuildOptions;
+    /**
+     * Resolve extra files on startup, such as `.node`
+     * @remark won't trigger will reload
+     */
+    postBuild?: (args: {
+        /**
+         * Get path from `entryOutputDirPath`
+         */
+        getPathFromEntryOutputDir: (...paths: string[]) => string;
+        /**
+         * Check exist and copy file to `entryOutputDirPath`
+         *
+         * If `to` absent, set to `basename(from)`
+         *
+         * If `skipIfExist` absent, skip copy if `to` exist
+         */
+        copyToEntryOutputDir: (options: {
+            from: string;
+            to?: string;
+            /**
+             * Skip copy if `to` exist
+             * @default true
+             */
+            skipIfExist?: boolean;
+        }) => void;
+    }) => Promisable<void>;
+}
+interface GeneratorOverrideFunctions {
+    /**
+     * 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) => Promisable<string>;
+    /**
+     * Custom generate version json function
+     * @param existingJson The existing JSON object.
+     * @param buffer file buffer
+     * @param signature generated signature
+     * @param version current version
+     * @param minVersion The minimum version
+     * @returns The updated version json
+     */
+    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'
+     */
+    minimumVersion?: string;
+    /**
+     * config for entry (app.asar)
+     */
+    entry?: BuildEntryOption;
+    /**
+     * paths config
+     */
+    paths?: {
+        /**
+         * Path to asar file
+         * @default `release/${app.name}.asar`
+         */
+        asarOutputPath?: string;
+        /**
+         * Path to version info output, content is {@link UpdateJSON}
+         * @default `version.json`
+         */
+        versionPath?: string;
+        /**
+         * Path to gzipped asar file
+         * @default `release/${app.name}-${version}.asar.gz`
+         */
+        gzipPath?: string;
+        /**
+         * Path to electron build output
+         * @default `dist-electron`
+         */
+        electronDistPath?: string;
+        /**
+         * Path to renderer build output
+         * @default `dist`
+         */
+        rendererDistPath?: string;
+    };
+    /**
+     * signature config
+     */
+    keys?: {
+        /**
+         * path to the pem file that contains private key
+         * if not ended with .pem, it will be appended
+         *
+         * **if `UPDATER_PK` is set, will read it instead of read from `privateKeyPath`**
+         * @default 'keys/private.pem'
+         */
+        privateKeyPath?: string;
+        /**
+         * path to the pem file that contains public key
+         * if not ended with .pem, it will be appended
+         *
+         * **if `UPDATER_CERT` is set, will read it instead of read from `certPath`**
+         * @default 'keys/cert.pem'
+         */
+        certPath?: string;
+        /**
+         * length of the key
+         * @default 2048
+         */
+        keyLength?: number;
+        /**
+         * X509 certificate info
+         *
+         * only generate simple **self-signed** certificate **without extensions**
+         */
+        certInfo?: {
+            /**
+             * the subject of the certificate
+             *
+             * @default { commonName: `${app.name}`, organizationName: `org.${app.name}` }
+             */
+            subject?: DistinguishedName;
+            /**
+             * expire days of the certificate
+             *
+             * @default 3650
+             */
+            days?: number;
+        };
+    };
+    overrideGenerator?: GeneratorOverrideFunctions;
+}
+
+interface BytecodeOptions {
+    enable: boolean;
+    /**
+     * Enable in preload script. Remember to set `sandbox: false` when creating window
+     */
+    preload?: boolean;
+    /**
+     * Before transformed code compile function. If return `Falsy` value, it will be ignored
+     * @param code transformed code
+     * @param id file path
+     */
+    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];
+};
+type ReplaceKey<T, Key extends keyof T, NewKey extends string> = Omit<T, Key> & {
+    [P in NewKey]: T[Key];
+};
+type MakeRequiredAndReplaceKey<T, K extends keyof T, NewKey extends string> = MakeRequired<ReplaceKey<T, K, NewKey>, NewKey>;
+/**
+ * startup function for debug (see {@link https://github.com/electron-vite/electron-vite-vue/blob/main/vite.config.ts electron-vite-vue template})
+ * @example
+ * import { debugStartup, buildElectronPluginOptions } from 'electron-incremental-update/vite'
+ * const options = buildElectronPluginOptions({
+ *   // ...
+ *   main: {
+ *     // ...
+ *     startup: debugStartup
+ *   },
+ * })
+ */
+declare function debugStartup(args: {
+    startup: (argv?: string[]) => Promise<void>;
+    reload: () => void;
+}): void;
+type ExcludeOutputDirOptions = {
+    vite?: {
+        build?: {
+            outDir: never;
+            rollupOptions?: {
+                output?: {
+                    dir: never;
+                };
+            };
+        };
+    };
+};
+interface ElectronWithUpdaterOptions {
+    /**
+     * Whether is in build mode
+     * ```ts
+     * export default defineConfig(({ command }) => {
+     *   const isBuild = command === 'build'
+     * })
+     * ```
+     */
+    isBuild: boolean;
+    /**
+     * 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
+     * @default !isBuild
+     */
+    sourcemap?: boolean;
+    /**
+     * Whether to minify the code
+     * @default isBuild
+     */
+    minify?: boolean;
+    /**
+     * Whether to generate bytecode
+     *
+     * **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
+     */
+    bytecode?: boolean | BytecodeOptions;
+    /**
+     * 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 }`
+     */
+    logParsedOptions?: boolean | {
+        showKeys: boolean;
+    };
+    /**
+     * Main process options
+     *
+     * To change output directories, use `options.updater.paths.electronDistPath` instead
+     */
+    main: MakeRequiredAndReplaceKey<ElectronSimpleOptions['main'], 'entry', 'files'> & ExcludeOutputDirOptions;
+    /**
+     * Preload process options
+     *
+     * To change output directories, use `options.updater.paths.electronDistPath` instead
+     */
+    preload: MakeRequiredAndReplaceKey<Exclude<ElectronSimpleOptions['preload'], undefined>, 'input', 'files'> & ExcludeOutputDirOptions;
+    /**
+     * Updater options
+     */
+    updater?: ElectronUpdaterOptions;
+}
+/**
+ * Base on `vite-plugin-electron/simple`
+ * - integrate with updater
+ * - 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}
+ *
+ * You can override all the vite configs, except output directories (use `options.updater.paths.electronDistPath` instead)
+ *
+ * @example
+ */
+declare function electronWithUpdater(options: ElectronWithUpdaterOptions): Promise<PluginOption[] | undefined>;
+
+export { type ElectronWithUpdaterOptions, debugStartup, electronWithUpdater as default, electronWithUpdater };