electron-incremental-update 2.0.0-beta.8 → 2.0.0

package/dist/core-DJdvtwvU.d.ts

@@ -1,134 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { a as UpdateJSON, U as UpdateInfo, D as DownloadingInfo, I as IProvider, c as URLHandler } from './types-CItP6bL-.js';
-
-declare const ErrorInfo: {
-    readonly download: "Download failed";
-    readonly validate: "Validate failed";
-    readonly param: "Missing params";
-    readonly network: "Network error";
-};
-declare class UpdaterError extends Error {
-    code: keyof typeof ErrorInfo;
-    constructor(msg: keyof typeof ErrorInfo, info: string);
-}
-type CheckResult<T extends UpdateJSON> = {
-    success: true;
-    data: Omit<T, 'beta'>;
-} | {
-    success: false;
-    /**
-     * minimal version that can update
-     */
-    data: string;
-} | {
-    success: false;
-    data: UpdaterError;
-};
-type DownloadResult = {
-    success: true;
-} | {
-    success: false;
-    data: UpdaterError;
-};
-interface Logger {
-    info: (msg: string) => void;
-    debug: (msg: string) => void;
-    warn: (msg: string) => void;
-    error: (msg: string, e?: unknown) => void;
-}
-interface UpdaterOption {
-    /**
-     * public key of signature, which will be auto generated by plugin,
-     * generate by `selfsigned` if not set
-     */
-    SIGNATURE_CERT?: string;
-    /**
-     * whether to receive beta update
-     */
-    receiveBeta?: boolean;
-    logger?: Logger;
-}
-
-declare class Updater extends EventEmitter<{
-    'checking': any;
-    'update-available': [data: UpdateInfo];
-    'update-unavailable': [reason: string];
-    'error': [error: UpdaterError];
-    'download-progress': [info: DownloadingInfo];
-    'update-downloaded': any;
-}> {
-    private CERT;
-    private info?;
-    private provider;
-    /**
-     * updater logger
-     */
-    logger?: Logger;
-    /**
-     * whether to receive beta update
-     */
-    receiveBeta?: boolean;
-    /**
-     * whether force update in DEV
-     */
-    forceUpdate?: boolean;
-    /**
-     * initialize incremental updater
-     * @param provider update provider
-     * @param option UpdaterOption
-     */
-    constructor(provider: IProvider, option?: UpdaterOption);
-    /**
-     * this function is used to parse download data.
-     * - if format is `'json'`
-     *   - if data is `UpdateJSON`, return it
-     *   - if data is string or absent, download URL data and return it
-     * - if format is `'buffer'`
-     *   - if data is `Buffer`, return it
-     *   - if data is string or absent, download URL data and return it
-     * @param format 'json' or 'buffer'
-     * @param data download URL or update json or buffer
-     */
-    private fetch;
-    /**
-     * handle error message and emit error event
-     */
-    private err;
-    /**
-     * check update info using default options
-     */
-    checkUpdate(): Promise<boolean>;
-    /**
-     * check update info using existing update json
-     * @param data existing update json
-     */
-    checkUpdate(data: UpdateJSON): Promise<boolean>;
-    /**
-     * download update using default options
-     */
-    downloadUpdate(): Promise<boolean>;
-    /**
-     * download update using existing `asar.gz` buffer and signature
-     * @param data existing `asar.gz` buffer
-     * @param info update info
-     */
-    downloadUpdate(data: Uint8Array, info: Omit<UpdateInfo, 'minimumVersion'>): Promise<boolean>;
-    /**
-     * quit App and install
-     */
-    quitAndInstall(): void;
-    /**
-     * setup provider URL handler
-     *
-     * @example
-     * updater.setURLHandler((url, isDownloadingAsar) => {
-     *   if (isDownloadingAsar) {
-     *     url.hostname = 'https://cdn.jsdelivr.net/gh'
-     *     return url
-     *   }
-     * })
-     */
-    setURLHandler(handler: URLHandler): void;
-}
-
-export { type CheckResult as C, type DownloadResult as D, ErrorInfo as E, type Logger as L, Updater as U, type UpdaterOption as a, UpdaterError as b };

package/dist/core-ZUlLHadf.d.cts

@@ -1,134 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { a as UpdateJSON, U as UpdateInfo, D as DownloadingInfo, I as IProvider, c as URLHandler } from './types-CItP6bL-.cjs';
-
-declare const ErrorInfo: {
-    readonly download: "Download failed";
-    readonly validate: "Validate failed";
-    readonly param: "Missing params";
-    readonly network: "Network error";
-};
-declare class UpdaterError extends Error {
-    code: keyof typeof ErrorInfo;
-    constructor(msg: keyof typeof ErrorInfo, info: string);
-}
-type CheckResult<T extends UpdateJSON> = {
-    success: true;
-    data: Omit<T, 'beta'>;
-} | {
-    success: false;
-    /**
-     * minimal version that can update
-     */
-    data: string;
-} | {
-    success: false;
-    data: UpdaterError;
-};
-type DownloadResult = {
-    success: true;
-} | {
-    success: false;
-    data: UpdaterError;
-};
-interface Logger {
-    info: (msg: string) => void;
-    debug: (msg: string) => void;
-    warn: (msg: string) => void;
-    error: (msg: string, e?: unknown) => void;
-}
-interface UpdaterOption {
-    /**
-     * public key of signature, which will be auto generated by plugin,
-     * generate by `selfsigned` if not set
-     */
-    SIGNATURE_CERT?: string;
-    /**
-     * whether to receive beta update
-     */
-    receiveBeta?: boolean;
-    logger?: Logger;
-}
-
-declare class Updater extends EventEmitter<{
-    'checking': any;
-    'update-available': [data: UpdateInfo];
-    'update-unavailable': [reason: string];
-    'error': [error: UpdaterError];
-    'download-progress': [info: DownloadingInfo];
-    'update-downloaded': any;
-}> {
-    private CERT;
-    private info?;
-    private provider;
-    /**
-     * updater logger
-     */
-    logger?: Logger;
-    /**
-     * whether to receive beta update
-     */
-    receiveBeta?: boolean;
-    /**
-     * whether force update in DEV
-     */
-    forceUpdate?: boolean;
-    /**
-     * initialize incremental updater
-     * @param provider update provider
-     * @param option UpdaterOption
-     */
-    constructor(provider: IProvider, option?: UpdaterOption);
-    /**
-     * this function is used to parse download data.
-     * - if format is `'json'`
-     *   - if data is `UpdateJSON`, return it
-     *   - if data is string or absent, download URL data and return it
-     * - if format is `'buffer'`
-     *   - if data is `Buffer`, return it
-     *   - if data is string or absent, download URL data and return it
-     * @param format 'json' or 'buffer'
-     * @param data download URL or update json or buffer
-     */
-    private fetch;
-    /**
-     * handle error message and emit error event
-     */
-    private err;
-    /**
-     * check update info using default options
-     */
-    checkUpdate(): Promise<boolean>;
-    /**
-     * check update info using existing update json
-     * @param data existing update json
-     */
-    checkUpdate(data: UpdateJSON): Promise<boolean>;
-    /**
-     * download update using default options
-     */
-    downloadUpdate(): Promise<boolean>;
-    /**
-     * download update using existing `asar.gz` buffer and signature
-     * @param data existing `asar.gz` buffer
-     * @param info update info
-     */
-    downloadUpdate(data: Uint8Array, info: Omit<UpdateInfo, 'minimumVersion'>): Promise<boolean>;
-    /**
-     * quit App and install
-     */
-    quitAndInstall(): void;
-    /**
-     * setup provider URL handler
-     *
-     * @example
-     * updater.setURLHandler((url, isDownloadingAsar) => {
-     *   if (isDownloadingAsar) {
-     *     url.hostname = 'https://cdn.jsdelivr.net/gh'
-     *     return url
-     *   }
-     * })
-     */
-    setURLHandler(handler: URLHandler): void;
-}
-
-export { type CheckResult as C, type DownloadResult as D, ErrorInfo as E, type Logger as L, Updater as U, type UpdaterOption as a, UpdaterError as b };

package/dist/types-CItP6bL-.d.cts

@@ -1,104 +0,0 @@
-import { Promisable } from '@subframe7536/type-utils';
-
-interface Version {
-    major: number;
-    minor: number;
-    patch: number;
-    stage: string;
-    stageVersion: number;
-}
-declare function parseVersion(version: string): Version;
-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;
-};
-declare function isUpdateJSON(json: any): json is UpdateJSON;
-declare function defaultVersionJsonGenerator(existingJson: UpdateJSON, signature: string, version: string, minimumVersion: string): UpdateJSON;
-
-type URLHandler = (url: URL, isDownloadAsar: boolean) => Promisable<URL | string | undefined | null>;
-type OnDownloading = (progress: DownloadingInfo) => void;
-interface DownloadingInfo {
-    /**
-     * download delta
-     */
-    delta: number;
-    /**
-     * downloaded percent, 0 ~ 100
-     *
-     * If not `Content-Length` header, will be nagative
-     */
-    percent: number;
-    /**
-     * total size
-     *
-     * If not `Content-Length` header, will be -1
-     */
-    total: number;
-    /**
-     * downloaded size
-     */
-    transferred: number;
-    /**
-     * download speed, bytes per second
-     */
-    bps: number;
-}
-interface IProvider {
-    /**
-     * provider name
-     */
-    name: string;
-    /**
-     * custom url handler
-     *
-     * for Github, there are some {@link https://github.com/XIU2/UserScript/blob/master/GithubEnhanced-High-Speed-Download.user.js#L34 public CDN links}
-     */
-    urlHandler?: URLHandler;
-    onDownloading?: OnDownloading;
-    /**
-     * download update json
-     * @param versionPath parsed version path
-     */
-    downloadJSON: (versionPath: string) => Promise<UpdateJSON>;
-    /**
-     * download update asar
-     * @param name app name
-     * @param updateInfo existing update info
-     * @param onDownloading hook for on downloading
-     */
-    downloadAsar: (name: string, updateInfo: UpdateInfo, onDownloading?: (info: DownloadingInfo) => void) => Promise<Buffer>;
-    /**
-     * compare version
-     * @param oldVer old version string
-     * @param newVer new version string
-     * @returns if version1 < version2
-     */
-    isLowerVersion: (oldVer: string, newVer: string) => boolean;
-    /**
-     * unzip file buffer
-     * @param buffer source buffer
-     */
-    unzipFile: (buffer: Buffer) => Promise<Buffer>;
-    /**
-     * verify asar signature
-     * @param buffer file buffer
-     * @param version target version
-     * @param signature signature
-     * @param cert certificate
-     * @returns if signature is valid, returns the version, otherwise returns `undefined`
-     */
-    verifySignaure: (buffer: Buffer, version: string, signature: string, cert: string) => Promisable<boolean>;
-}
-
-export { type DownloadingInfo as D, type IProvider as I, type OnDownloading as O, type UpdateInfo as U, type Version as V, type UpdateJSON as a, defaultVersionJsonGenerator as b, type URLHandler as c, defaultIsLowerVersion as d, isUpdateJSON as i, parseVersion as p };

package/dist/types-CItP6bL-.d.ts

@@ -1,104 +0,0 @@
-import { Promisable } from '@subframe7536/type-utils';
-
-interface Version {
-    major: number;
-    minor: number;
-    patch: number;
-    stage: string;
-    stageVersion: number;
-}
-declare function parseVersion(version: string): Version;
-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;
-};
-declare function isUpdateJSON(json: any): json is UpdateJSON;
-declare function defaultVersionJsonGenerator(existingJson: UpdateJSON, signature: string, version: string, minimumVersion: string): UpdateJSON;
-
-type URLHandler = (url: URL, isDownloadAsar: boolean) => Promisable<URL | string | undefined | null>;
-type OnDownloading = (progress: DownloadingInfo) => void;
-interface DownloadingInfo {
-    /**
-     * download delta
-     */
-    delta: number;
-    /**
-     * downloaded percent, 0 ~ 100
-     *
-     * If not `Content-Length` header, will be nagative
-     */
-    percent: number;
-    /**
-     * total size
-     *
-     * If not `Content-Length` header, will be -1
-     */
-    total: number;
-    /**
-     * downloaded size
-     */
-    transferred: number;
-    /**
-     * download speed, bytes per second
-     */
-    bps: number;
-}
-interface IProvider {
-    /**
-     * provider name
-     */
-    name: string;
-    /**
-     * custom url handler
-     *
-     * for Github, there are some {@link https://github.com/XIU2/UserScript/blob/master/GithubEnhanced-High-Speed-Download.user.js#L34 public CDN links}
-     */
-    urlHandler?: URLHandler;
-    onDownloading?: OnDownloading;
-    /**
-     * download update json
-     * @param versionPath parsed version path
-     */
-    downloadJSON: (versionPath: string) => Promise<UpdateJSON>;
-    /**
-     * download update asar
-     * @param name app name
-     * @param updateInfo existing update info
-     * @param onDownloading hook for on downloading
-     */
-    downloadAsar: (name: string, updateInfo: UpdateInfo, onDownloading?: (info: DownloadingInfo) => void) => Promise<Buffer>;
-    /**
-     * compare version
-     * @param oldVer old version string
-     * @param newVer new version string
-     * @returns if version1 < version2
-     */
-    isLowerVersion: (oldVer: string, newVer: string) => boolean;
-    /**
-     * unzip file buffer
-     * @param buffer source buffer
-     */
-    unzipFile: (buffer: Buffer) => Promise<Buffer>;
-    /**
-     * verify asar signature
-     * @param buffer file buffer
-     * @param version target version
-     * @param signature signature
-     * @param cert certificate
-     * @returns if signature is valid, returns the version, otherwise returns `undefined`
-     */
-    verifySignaure: (buffer: Buffer, version: string, signature: string, cert: string) => Promisable<boolean>;
-}
-
-export { type DownloadingInfo as D, type IProvider as I, type OnDownloading as O, type UpdateInfo as U, type Version as V, type UpdateJSON as a, defaultVersionJsonGenerator as b, type URLHandler as c, defaultIsLowerVersion as d, isUpdateJSON as i, parseVersion as p };