@loongdotjs/electron-winstaller 5.4.0

package/lib/index.js

@@ -0,0 +1,350 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWindowsInstaller = exports.convertVersion = void 0;
+var asar = __importStar(require("@electron/asar"));
+var temp_utils_1 = require("./temp-utils");
+var fs = __importStar(require("fs-extra"));
+var path = __importStar(require("path"));
+var os = __importStar(require("os"));
+var child_process_1 = require("child_process");
+var spawn_promise_1 = __importDefault(require("./spawn-promise"));
+var lodash_1 = require("lodash");
+var sign_1 = require("./sign");
+var log = require('debug')('electron-windows-installer:main');
+/**
+ * A utility function to convert SemVer version strings into NuGet-compatible
+ * version strings.
+ * @param version A SemVer version string
+ * @returns A NuGet-compatible version string
+ * @see {@link https://semver.org/ | Semantic Versioning specification}
+ * @see {@link https://learn.microsoft.com/en-us/nuget/concepts/package-versioning?tabs=semver20sort | NuGet versioning specification}
+ */
+function convertVersion(version) {
+    var parts = version.split('+')[0].split('-');
+    var mainVersion = parts.shift();
+    if (parts.length > 0) {
+        return [mainVersion, parts.join('-').replace(/\./g, '')].join('-');
+    }
+    else {
+        return mainVersion;
+    }
+}
+exports.convertVersion = convertVersion;
+function checkIfCommandExists(command) {
+    var checkCommand = os.platform() === 'win32' ? 'where' : 'which';
+    return new Promise(function (resolve) {
+        (0, child_process_1.exec)("".concat(checkCommand, " ").concat(command), function (error) {
+            resolve(error ? false : true);
+        });
+    });
+}
+/**
+ * This package's main function, which creates a Squirrel.Windows executable
+ * installer and optionally code-signs the output.
+ *
+ * @param options Options for installer generation and signing
+ * @see {@link https://github.com/Squirrel/Squirrel.Windows | Squirrel.Windows}
+ */
+function createWindowsInstaller(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var useMono, monoExe, wineExe, _a, hasWine, hasMono, appDirectory, outputDirectory, loadingGif, vendorPath, vendorUpdate, appUpdate, cmd_1, args_1, defaultLoadingGif, certificateFile, certificatePassword, remoteReleases, signWithParams, remoteToken, windowsSign, metadata, appResources, asarFile, appMetadata, templatePath, templateData, _i, _b, f, nuspecContent, nugetOutput, targetNuspecPath, cmd, args, _c, nupkgPath, _d, _e, setupPath, unfixedSetupPath, msiPath, unfixedMsiPath;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    useMono = false;
+                    monoExe = 'mono';
+                    wineExe = ['arm64', 'x64'].includes(process.arch) ? 'wine64' : 'wine';
+                    if (!(process.platform !== 'win32')) return [3 /*break*/, 2];
+                    useMono = true;
+                    return [4 /*yield*/, Promise.all([
+                            checkIfCommandExists(wineExe),
+                            checkIfCommandExists(monoExe)
+                        ])];
+                case 1:
+                    _a = _f.sent(), hasWine = _a[0], hasMono = _a[1];
+                    if (!hasWine || !hasMono) {
+                        throw new Error('You must install both Mono and Wine on non-Windows');
+                    }
+                    log("Using Mono: '".concat(monoExe, "'"));
+                    log("Using Wine: '".concat(wineExe, "'"));
+                    _f.label = 2;
+                case 2:
+                    appDirectory = options.appDirectory, outputDirectory = options.outputDirectory, loadingGif = options.loadingGif;
+                    outputDirectory = path.resolve(outputDirectory || 'installer');
+                    vendorPath = options.vendorDirectory || path.join(__dirname, '..', 'vendor');
+                    vendorUpdate = path.join(vendorPath, 'Squirrel.exe');
+                    appUpdate = path.join(appDirectory, 'Squirrel.exe');
+                    return [4 /*yield*/, fs.copy(vendorUpdate, appUpdate)];
+                case 3:
+                    _f.sent();
+                    if (!(options.setupIcon && (options.skipUpdateIcon !== true))) return [3 /*break*/, 5];
+                    cmd_1 = path.join(vendorPath, 'rcedit.exe');
+                    args_1 = [
+                        appUpdate,
+                        '--set-icon', options.setupIcon
+                    ];
+                    if (useMono) {
+                        args_1.unshift(cmd_1);
+                        cmd_1 = wineExe;
+                    }
+                    return [4 /*yield*/, (0, spawn_promise_1.default)(cmd_1, args_1)];
+                case 4:
+                    _f.sent();
+                    _f.label = 5;
+                case 5:
+                    defaultLoadingGif = path.join(__dirname, '..', 'resources', 'install-spinner.gif');
+                    loadingGif = loadingGif ? path.resolve(loadingGif) : defaultLoadingGif;
+                    certificateFile = options.certificateFile, certificatePassword = options.certificatePassword, remoteReleases = options.remoteReleases, signWithParams = options.signWithParams, remoteToken = options.remoteToken, windowsSign = options.windowsSign;
+                    metadata = {
+                        description: '',
+                        iconUrl: 'https://raw.githubusercontent.com/electron/electron/main/shell/browser/resources/win/electron.ico'
+                    };
+                    if (!(options.usePackageJson !== false)) return [3 /*break*/, 10];
+                    appResources = path.join(appDirectory, 'resources');
+                    asarFile = path.join(appResources, 'app.asar');
+                    appMetadata = void 0;
+                    return [4 /*yield*/, fs.pathExists(asarFile)];
+                case 6:
+                    if (!_f.sent()) return [3 /*break*/, 7];
+                    appMetadata = JSON.parse(asar.extractFile(asarFile, 'package.json').toString());
+                    return [3 /*break*/, 9];
+                case 7: return [4 /*yield*/, fs.readJson(path.join(appResources, 'app', 'package.json'))];
+                case 8:
+                    appMetadata = _f.sent();
+                    _f.label = 9;
+                case 9:
+                    Object.assign(metadata, {
+                        exe: "".concat(appMetadata.name, ".exe"),
+                        title: appMetadata.productName || appMetadata.name
+                    }, appMetadata);
+                    _f.label = 10;
+                case 10:
+                    Object.assign(metadata, options);
+                    if (!metadata.authors) {
+                        if (typeof (metadata.author) === 'string') {
+                            metadata.authors = metadata.author;
+                        }
+                        else {
+                            metadata.authors = (metadata.author || {}).name || '';
+                        }
+                    }
+                    metadata.owners = metadata.owners || metadata.authors;
+                    metadata.version = convertVersion(metadata.version);
+                    metadata.copyright = metadata.copyright ||
+                        "Copyright \u00A9 ".concat(new Date().getFullYear(), " ").concat(metadata.authors || metadata.owners);
+                    metadata.additionalFiles = metadata.additionalFiles || [];
+                    return [4 /*yield*/, fs.pathExists(path.join(appDirectory, 'swiftshader'))];
+                case 11:
+                    if (_f.sent()) {
+                        metadata.additionalFiles.push({ src: 'swiftshader\\**', target: 'lib\\net45\\swiftshader' });
+                    }
+                    return [4 /*yield*/, fs.pathExists(path.join(appDirectory, 'vk_swiftshader_icd.json'))];
+                case 12:
+                    if (_f.sent()) {
+                        metadata.additionalFiles.push({ src: 'vk_swiftshader_icd.json', target: 'lib\\net45' });
+                    }
+                    templatePath = options.nuspecTemplate || path.join(__dirname, '..', 'template.nuspectemplate');
+                    return [4 /*yield*/, fs.readFile(templatePath, 'utf8')];
+                case 13:
+                    templateData = _f.sent();
+                    if (path.sep === '/') {
+                        templateData = templateData.replace(/\\/g, '/');
+                        for (_i = 0, _b = metadata.additionalFiles; _i < _b.length; _i++) {
+                            f = _b[_i];
+                            f.src = f.src.replace(/\\/g, '/');
+                            f.target = f.target.replace(/\\/g, '/');
+                        }
+                    }
+                    nuspecContent = (0, lodash_1.template)(templateData)(metadata);
+                    log("Created NuSpec file:\n".concat(nuspecContent));
+                    return [4 /*yield*/, (0, temp_utils_1.createTempDir)('si-')];
+                case 14:
+                    nugetOutput = _f.sent();
+                    targetNuspecPath = path.join(nugetOutput, metadata.name + '.nuspec');
+                    return [4 /*yield*/, fs.writeFile(targetNuspecPath, nuspecContent)];
+                case 15:
+                    _f.sent();
+                    cmd = path.join(vendorPath, 'nuget.exe');
+                    args = [
+                        'pack', targetNuspecPath,
+                        '-BasePath', appDirectory,
+                        '-OutputDirectory', nugetOutput,
+                        '-NoDefaultExcludes'
+                    ];
+                    if (useMono) {
+                        args.unshift(cmd);
+                        cmd = monoExe;
+                    }
+                    // Call NuGet to create our package
+                    _c = log;
+                    return [4 /*yield*/, (0, spawn_promise_1.default)(cmd, args)];
+                case 16:
+                    // Call NuGet to create our package
+                    _c.apply(void 0, [_f.sent()]);
+                    nupkgPath = path.join(nugetOutput, "".concat(metadata.name, ".").concat(metadata.version, ".nupkg"));
+                    if (!remoteReleases) return [3 /*break*/, 18];
+                    cmd = path.join(vendorPath, 'SyncReleases.exe');
+                    args = ['-u', remoteReleases, '-r', outputDirectory];
+                    if (useMono) {
+                        args.unshift(cmd);
+                        cmd = monoExe;
+                    }
+                    if (remoteToken) {
+                        args.push('-t', remoteToken);
+                    }
+                    _d = log;
+                    return [4 /*yield*/, (0, spawn_promise_1.default)(cmd, args)];
+                case 17:
+                    _d.apply(void 0, [_f.sent()]);
+                    _f.label = 18;
+                case 18:
+                    cmd = path.join(vendorPath, 'Squirrel.exe');
+                    args = [
+                        '--releasify', nupkgPath,
+                        '--releaseDir', outputDirectory,
+                        '--loadingGif', loadingGif
+                    ];
+                    if (useMono) {
+                        args.unshift(path.join(vendorPath, 'Squirrel-Mono.exe'));
+                        cmd = monoExe;
+                    }
+                    // Legacy codesign options
+                    return [4 /*yield*/, (0, sign_1.resetSignTool)()];
+                case 19:
+                    // Legacy codesign options
+                    _f.sent();
+                    if (!signWithParams) return [3 /*break*/, 20];
+                    args.push('--signWithParams');
+                    if (!signWithParams.includes('/f') && !signWithParams.includes('/p') && certificateFile && certificatePassword) {
+                        args.push("".concat(signWithParams, " /a /f \"").concat(path.resolve(certificateFile), "\" /p \"").concat(certificatePassword, "\""));
+                    }
+                    else {
+                        args.push(signWithParams);
+                    }
+                    return [3 /*break*/, 23];
+                case 20:
+                    if (!(certificateFile && certificatePassword)) return [3 /*break*/, 21];
+                    args.push('--signWithParams');
+                    args.push("/a /f \"".concat(path.resolve(certificateFile), "\" /p \"").concat(certificatePassword, "\""));
+                    return [3 /*break*/, 23];
+                case 21:
+                    if (!windowsSign) return [3 /*break*/, 23];
+                    args.push('--signWithParams');
+                    args.push('windows-sign');
+                    return [4 /*yield*/, (0, sign_1.createSignTool)(options)];
+                case 22:
+                    _f.sent();
+                    _f.label = 23;
+                case 23:
+                    if (options.setupIcon) {
+                        args.push('--setupIcon');
+                        args.push(path.resolve(options.setupIcon));
+                    }
+                    if (options.noMsi) {
+                        args.push('--no-msi');
+                    }
+                    if (options.noDelta) {
+                        args.push('--no-delta');
+                    }
+                    if (options.frameworkVersion) {
+                        args.push('--framework-version');
+                        args.push(options.frameworkVersion);
+                    }
+                    _e = log;
+                    return [4 /*yield*/, (0, spawn_promise_1.default)(cmd, args)];
+                case 24:
+                    _e.apply(void 0, [_f.sent()]);
+                    if (!(options.fixUpPaths !== false)) return [3 /*break*/, 29];
+                    log('Fixing up paths');
+                    if (!(metadata.productName || options.setupExe)) return [3 /*break*/, 26];
+                    setupPath = path.join(outputDirectory, options.setupExe || "".concat(metadata.productName, "Setup.exe"));
+                    unfixedSetupPath = path.join(outputDirectory, 'Setup.exe');
+                    log("Renaming ".concat(unfixedSetupPath, " => ").concat(setupPath));
+                    return [4 /*yield*/, fs.rename(unfixedSetupPath, setupPath)];
+                case 25:
+                    _f.sent();
+                    _f.label = 26;
+                case 26:
+                    if (!(metadata.productName || options.setupMsi)) return [3 /*break*/, 29];
+                    msiPath = path.join(outputDirectory, options.setupMsi || "".concat(metadata.productName, "Setup.msi"));
+                    unfixedMsiPath = path.join(outputDirectory, 'Setup.msi');
+                    return [4 /*yield*/, fs.pathExists(unfixedMsiPath)];
+                case 27:
+                    if (!_f.sent()) return [3 /*break*/, 29];
+                    log("Renaming ".concat(unfixedMsiPath, " => ").concat(msiPath));
+                    return [4 /*yield*/, fs.rename(unfixedMsiPath, msiPath)];
+                case 28:
+                    _f.sent();
+                    _f.label = 29;
+                case 29: return [4 /*yield*/, (0, sign_1.resetSignTool)()];
+                case 30:
+                    _f.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.createWindowsInstaller = createWindowsInstaller;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/options.d.ts

@@ -0,0 +1,219 @@
+import { SignToolOptions } from '@electron/windows-sign';
+export interface SquirrelWindowsOptions {
+    /**
+     * The folder path of your Electron app
+     */
+    appDirectory: string;
+    /**
+     * The folder path of Squirrel windows
+     */
+    vendorDirectory?: string;
+    /**
+     * The folder path to create the .exe installer in.
+     *
+     * @defaultValue an `installer` folder at the project root.
+     */
+    outputDirectory?: string;
+    /**
+     * The path to the .nuspectemplate file used by Squirrel.exe.
+     *
+     * @defaultValue the bundled {@link https://github.com/electron/windows-installer/blob/main/template.nuspectemplate | template.nuspectemplate}.
+     */
+    nuspecTemplate?: string;
+    /**
+     * The local path to a `.gif` file to display during install.
+     *
+     * @defaultValue the bundled {@link https://github.com/electron/windows-installer/blob/main/resources/install-spinner.gif | install-spinner.gif}
+     */
+    loadingGif?: string;
+    /**
+     * The `authors` value for the NuGet package metadata.
+     *
+     * @defaultValue the `author` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    authors?: string;
+    /**
+     * The `owners` value for the NuGet package metadata.
+     *
+     * @defaultValue the `authors` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    owners?: string;
+    /**
+     * The `copyright` value for the NuGet package metadata.
+     *
+     * @defaultValue a generated copyright with {@link SquirrelWindowsOptions.authors | authors}
+     * or {@link SquirrelWindowsOptions.owners | owners}.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    copyright?: string;
+    /**
+     * The name of your app's main `.exe` file.
+     *
+     * @defaultValue the `name` field in your app's package.json file with an added `.exe` extension
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     */
+    exe?: string;
+    /**
+     * The `description` value for the NuGet package metadata.
+     *
+     * @defaultValue the `description` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    description?: string;
+    /**
+     * The `version` value for the Nuget package metadata.
+     *
+     * @defaultValue the `version` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    version?: string;
+    /**
+     * The `title` value for the nuget package metadata.
+     *
+     * @defaultValue the `productName` field and then the `name` field from your app's package.json
+     * file unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/nuget/reference/nuspec | the Microsoft .nuspec reference}.
+     */
+    title?: string;
+    /**
+     * Windows Application Model ID (appId).
+     *
+     * @defaultValue the `name` field in your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     * @see {@link https://learn.microsoft.com/en-us/windows/win32/shell/appids | Microsoft's Application User Model IDs documentation}.
+     */
+    name?: string;
+    /**
+     * The path to an Authenticode Code Signing Certificate.
+     *
+     * This is a legacy parameter provided for backwards compatibility.
+     * For more comprehensive support of various codesigning scenarios
+     * like EV certificates, see the
+     * {@link SquirrelWindowsOptions.windowsSign | windowsSign} parameter.
+     */
+    certificateFile?: string;
+    /**
+     * The password to decrypt the certificate given in `certificateFile`
+     *
+     * This is a legacy parameter provided for backwards compatibility.
+     * For more comprehensive support of various codesigning scenarios
+     * like EV certificates, see the
+     * {@link SquirrelWindowsOptions.windowsSign | windowsSign} parameter.
+     */
+    certificatePassword?: string;
+    /**
+     * Params to pass to signtool.
+     *
+     * Overrides {@link SquirrelWindowsOptions.certificateFile | certificateFile}
+     * and {@link SquirrelWindowsOptions.certificatePassword | certificatePassword}`.
+     *
+     * This is a legacy parameter provided for backwards compatibility.
+     * For more comprehensive support of various codesigning scenarios
+     * like EV certificates, see the
+     * {@link SquirrelWindowsOptions.windowsSign | windowsSign} parameter.
+     */
+    signWithParams?: string;
+    /**
+     * A publicly accessible, fully qualified HTTP(S) URL to an ICO file, used as the application icon
+     * displayed in Control Panel ➡ Programs and Features. The icon is retrieved at install time.
+     * Example: http://example.com/favicon.ico
+     *
+     * Does not accept `file:` URLs.
+     *
+     * @defaultValue the Electron icon.
+     */
+    iconUrl?: string;
+    /**
+     * The ICO file to use as the icon for the generated Setup.exe
+     */
+    setupIcon?: string;
+    /**
+     * The name to use for the generated Setup.exe file
+     * @defaultValue the `productName` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     */
+    setupExe?: string;
+    /**
+     * The name to use for the generated Setup.msi file
+     * @defaultValue the `productName` field from your app's package.json file
+     * unless {@link SquirrelWindowsOptions.usePackageJson | usePackageJson} is false.
+     */
+    setupMsi?: string;
+    /**
+     * Enable this flag to prevent Squirrel.Windows from creating an MSI installer.
+     * @defaultValue false
+     */
+    noMsi?: boolean;
+    /**
+     * Enable this flag to prevent Squirrel.Windows from creating delta packages (disable only if necessary, they are a Good Thing).
+     * @defaultValue false
+     */
+    noDelta?: boolean;
+    /**
+     * A URL to your existing updates. If given, these will be downloaded to create delta updates.
+     */
+    remoteReleases?: string;
+    /**
+     * Authentication token for remote updates using {@link SquirrelWindowsOptions.remoteReleases | remoteReleases}
+     */
+    remoteToken?: string;
+    /**
+     * Whether or not to infer metadata options from your app's package.json file.
+     * @defaultValue true
+     */
+    usePackageJson?: boolean;
+    /**
+     * Set the required .NET framework version (e.g. `net461`).
+     */
+    frameworkVersion?: string;
+    /**
+     * Attempt to create more descriptive installer names using metadata parameters.
+     * @defaultValue false
+     */
+    fixUpPaths?: boolean;
+    /**
+     * Enable this flag to skip setting a custom icon for `Update.exe`
+     * @defaultValue false
+     */
+    skipUpdateIcon?: boolean;
+    /**
+     * Requires Node.js 18 or newer.
+     *
+     * Sign your app with `@electron/windows-sign`, allowing for full customization
+     * of the code-signing process - and supports more complicated scenarios like
+     * cloud-hosted EV certificates, custom sign pipelines, and per-file overrides.
+     * It also supports all existing "simple" codesigning scenarios, including
+     * just passing a certificate file and password.
+     *
+     * @see {@link https://github.com/electron/windows-sign | @electron/windows-sign documentation}
+     * for all possible configuration options.
+     */
+    windowsSign?: SignToolOptions;
+}
+export interface PersonMetadata {
+    name: string;
+    email?: string;
+    url?: string;
+}
+export interface AdditionalFile {
+    src: string;
+    target: string;
+}
+export interface Metadata {
+    name?: string;
+    productName?: string;
+    version?: string;
+    copyright?: string;
+    author?: string | PersonMetadata;
+    authors?: string | PersonMetadata[];
+    owners?: string | PersonMetadata[];
+    description?: string;
+    iconUrl?: string;
+    additionalFiles?: AdditionalFile[];
+}

package/lib/options.js

@@ -0,0 +1,6 @@
+"use strict";
+// Originally from @types/electron-winstaller@2.6.2
+// Original definitions by: Brendan Forster <https://github.com/shiftkey>, Daniel Perez Alvarez <https://github.com/unindented>
+// Original definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";AAAA,mDAAmD;AACnD,+HAA+H;AAC/H,2EAA2E"}

package/lib/sign.d.ts

@@ -0,0 +1,15 @@
+import { SquirrelWindowsOptions } from './options';
+/**
+ * This method uses @electron/windows-sign to create a fake signtool.exe
+ * that can be called by Squirrel - but then just calls @electron/windows-sign
+ * to actually perform the signing.
+ *
+ * That's useful for users who need a high degree of customization of the signing
+ * process but still want to use @electron/windows-installer.
+ */
+export declare function createSignTool(options: SquirrelWindowsOptions): Promise<void>;
+/**
+ * Ensure that signtool.exe is actually the "real" signtool.exe, not our
+ * fake substitute.
+ */
+export declare function resetSignTool(): Promise<void>;