nw-builder 4.17.12 → 4.18.0

package/src/index.d.ts

@@ -1,54 +1,55 @@
-
 /** NW supported platform */
 export type SupportedPlatform = "linux" | "osx" | "win";
 
 /** Configuration options
  */
 export interface Options<P extends SupportedPlatform = SupportedPlatform> {
-    /** String of space separated glob patterns which correspond to NW app code */
-    srcDir?: "./" | string,
-    /** Run or build application */
-    mode?: "build" | "get" | "run",
-    /** NW runtime version */
-    version?: "latest" | "stable" | string,
-    /** NW runtime flavor */
-    flavor?: "normal" | "sdk",
-    /** NW supported platforms */
-    platform?: P,
-    /** NW supported architectures */
-    arch?: "ia32" | "x64" | "arm64",
-    /** Directory to store build artifacts */
-    outDir?: "./out" | string,
-    /** Directry to store NW binaries */
-    cacheDir?: "./cache" | string,
-    /** URI to download NW binaries from */
-    downloadUrl?: "https://dl.nwjs.io" | string,
-    /** URI to download manifest */
-    manifestUrl?: "https://nwjs.io/versions.json" | string,
-    /** Refer to Linux/Windows/Osx specific options */
-    app: AppOptions<P>,
-    /** If true the existing cache is used. Otherwise it removes and redownloads it. */
-    cache?: boolean,
-    /** If true, "zip", "tar" or "tgz" the outDir directory is compressed. */
-    zip?: boolean | "zip" | "tar" | "tgz",
-    /** If true the CLI is used to glob srcDir and parse other options */
-    cli?: boolean,
-    /** If true the chromium ffmpeg is replaced by community version */
-    ffmpeg?: boolean,
-    /** If true globbing is enabled */
-    glob?: boolean,
-    /** Specified log level. */
-    logLevel?: "error" | "warn" | "info" | "debug",
-	/** Managed manifest */
-	managedManifest?: boolean | string | object,
+  /** String of space separated glob patterns which correspond to NW app code */
+  srcDir?: "./" | string;
+  /** Run or build application */
+  mode?: "build" | "get" | "run";
+  /** NW runtime version */
+  version?: "latest" | "stable" | string;
+  /** NW runtime flavor */
+  flavor?: "normal" | "sdk";
+  /** NW supported platforms */
+  platform?: P;
+  /** NW supported architectures */
+  arch?: "ia32" | "x64" | "arm64";
+  /** Directory to store build artifacts */
+  outDir?: "./out" | string;
+  /** Directry to store NW binaries */
+  cacheDir?: "./cache" | string;
+  /** URI to download NW binaries from */
+  downloadUrl?: "https://dl.nwjs.io" | string;
+  /** URI to download manifest */
+  manifestUrl?: "https://nwjs.io/versions.json" | string;
+  /** Refer to Linux/Windows/Osx specific options */
+  app: AppOptions<P>;
+  /** If true the existing cache is used. Otherwise it removes and redownloads it. */
+  cache?: boolean;
+  /** If true, "zip", "tar" or "tgz" the outDir directory is compressed. */
+  zip?: boolean | "zip" | "tar" | "tgz";
+  /** If true the CLI is used to glob srcDir and parse other options */
+  cli?: boolean;
+  /** If true the chromium ffmpeg is replaced by community version */
+  ffmpeg?: boolean;
+  /** If true globbing is enabled */
+  glob?: boolean;
+  /** Specified log level. */
+  logLevel?: "error" | "warn" | "info" | "debug";
+  /** Managed manifest */
+  managedManifest?: boolean | string | object;
 }
 
 /** Platform-specific application options */
-export type AppOptions<P extends SupportedPlatform> =
-    P extends 'win' ? WindowsAppOptions :
-    P extends 'osx' ? OsxAppOptions :
-    P extends 'linux' ? LinuxAppOptions
-    : (WindowsAppOptions | OsxAppOptions | LinuxAppOptions);
+export type AppOptions<P extends SupportedPlatform> = P extends "win"
+  ? WindowsAppOptions
+  : P extends "osx"
+    ? OsxAppOptions
+    : P extends "linux"
+      ? LinuxAppOptions
+      : WindowsAppOptions | OsxAppOptions | LinuxAppOptions;
 
 /** Windows configuration options
  *
@@ -59,38 +60,38 @@ export type AppOptions<P extends SupportedPlatform> =
  * - https://learn.microsoft.com/en-gb/windows/win32/menurc/versioninfo-resource
  */
 export interface WindowsAppOptions {
-    /** The name of the application */
-    name?: string,
-    /** The version of the application */
-    version?: string,
-    /** Additional information that should be displayed for diagnostic purposes. */
-    comments?: string,
-    /** Company that produced the file—for example, Microsoft Corporation or Standard Microsystems Corporation, Inc. This string is required. */
-    company: string,
-    /** File description to be presented to users. This string may be displayed in a list box when the user is choosing files to install. For example, Keyboard Driver for AT-Style Keyboards. This string is required. */
-    fileDescription: string,
-    /** Version number of the file. For example, 3.10 or 5.00.RC2. This string is required. */
-    fileVersion: string,
-    /** The path to the icon file. It should be a .ico file. */
-    icon?: string,
-    /** Internal name of the file, if one exists—for example, a module name if the file is a dynamic-link library. If the file has no internal name, this string should be the original filename, without extension. This string is required. */
-    internalName: string,
-    /** Copyright notices that apply to the file. This should include the full text of all notices, legal symbols, copyright dates, and so on. This string is optional. */
-    legalCopyright?: string,
-    /** Trademarks and registered trademarks that apply to the file. This should include the full text of all notices, legal symbols, trademark numbers, and so on. This string is optional. */
-    legalTrademark?: string,
-    /** Original name of the file, not including a path. This information enables an application to determine whether a file has been renamed by a user. The format of the name depends on the file system for which the file was created. This string is required. */
-    originalFilename: string,
-    /** Information about a private version of the file—for example, Built by TESTER1 on \\TESTBED. This string should be present only if VS_FF_PRIVATEBUILD is specified in the fileflags parameter of the root block. */
-    privateBuild?: string,
-    /** Name of the product with which the file is distributed. This string is required. */
-    productName: string,
-    /** Version of the product with which the file is distributed—for example, 3.10 or 5.00.RC2. This string is required. */
-    productVersion: string,
-    /** Text that specifies how this version of the file differs from the standard version—for example, Private build for TESTER1 solving mouse problems on M250 and M250E computers. This string should be present only if VS_FF_SPECIALBUILD is specified in the fileflags parameter of the root block. */
-    specialBuild?: string,
-    /** Language of the file, defined by Microsoft, see: https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a */
-    languageCode?: number,
+  /** The name of the application */
+  name?: string;
+  /** The version of the application */
+  version?: string;
+  /** Additional information that should be displayed for diagnostic purposes. */
+  comments?: string;
+  /** Company that produced the file—for example, Microsoft Corporation or Standard Microsystems Corporation, Inc. This string is required. */
+  company: string;
+  /** File description to be presented to users. This string may be displayed in a list box when the user is choosing files to install. For example, Keyboard Driver for AT-Style Keyboards. This string is required. */
+  fileDescription: string;
+  /** Version number of the file. For example, 3.10 or 5.00.RC2. This string is required. */
+  fileVersion: string;
+  /** The path to the icon file. It should be a .ico file. */
+  icon?: string;
+  /** Internal name of the file, if one exists—for example, a module name if the file is a dynamic-link library. If the file has no internal name, this string should be the original filename, without extension. This string is required. */
+  internalName: string;
+  /** Copyright notices that apply to the file. This should include the full text of all notices, legal symbols, copyright dates, and so on. This string is optional. */
+  legalCopyright?: string;
+  /** Trademarks and registered trademarks that apply to the file. This should include the full text of all notices, legal symbols, trademark numbers, and so on. This string is optional. */
+  legalTrademark?: string;
+  /** Original name of the file, not including a path. This information enables an application to determine whether a file has been renamed by a user. The format of the name depends on the file system for which the file was created. This string is required. */
+  originalFilename: string;
+  /** Information about a private version of the file—for example, Built by TESTER1 on \\TESTBED. This string should be present only if VS_FF_PRIVATEBUILD is specified in the fileflags parameter of the root block. */
+  privateBuild?: string;
+  /** Name of the product with which the file is distributed. This string is required. */
+  productName: string;
+  /** Version of the product with which the file is distributed—for example, 3.10 or 5.00.RC2. This string is required. */
+  productVersion: string;
+  /** Text that specifies how this version of the file differs from the standard version—for example, Private build for TESTER1 solving mouse problems on M250 and M250E computers. This string should be present only if VS_FF_SPECIALBUILD is specified in the fileflags parameter of the root block. */
+  specialBuild?: string;
+  /** Language of the file, defined by Microsoft, see: https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a */
+  languageCode?: number;
 }
 
 /** Linux configuration options
@@ -99,48 +100,48 @@ export interface WindowsAppOptions {
  * https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html
  */
 export interface LinuxAppOptions {
-    /** Name of the application */
-    name?: string,
-    /** Generic name of the application */
-    genericName?: string,
-    /** If true the application is not displayed */
-    noDisplay?: boolean,
-    /** Tooltip for the entry, for example "View sites on the Internet". */
-    comment?: string,
-    /** Icon to display in file manager, menus, etc. */
-    icon?: string,
-    /** A list of strings identifying the desktop environments that should (/not) display a given desktop entry */
-    onlyShowIn?: string[],
-    /**  A list of strings identifying the desktop environments that should (/not) display a given desktop entry */
-    notShowIn?: string[],
-    /** A boolean value specifying if D-Bus activation is supported for this application */
-    dBusActivatable?: boolean,
-    /** Path to an executable file on disk used to determine if the program is actually installed */
-    tryExec?: string,
-    /** Program to execute, possibly with arguments. */
-    exec?: string,
-    /** If entry is of type Application, the working directory to run the program in. */
-    path?: string,
-    /** Whether the program runs in a terminal window. */
-    terminal?: boolean,
-    /** Identifiers for application actions. */
-    actions?: string[],
-    /** The MIME type(s) supported by this application. */
-    mimeType?: string[],
-    /** Categories in which the entry should be shown in a menu */
-    categories?: string[],
-    /** A list of interfaces that this application implements. */
-    implements?: string[],
-    /** A list of strings which may be used in addition to other metadata to describe this entry. */
-    keywords?: string[],
-    /** If true, it is KNOWN that the application will send a "remove" message when started with the DESKTOP_STARTUP_ID environment variable set. If false, it is KNOWN that the application does not work with startup notification at all. */
-    startupNotify?: boolean,
-    /** If specified, it is known that the application will map at least one window with the given string as its WM class or WM name hin */
-    startupWMClass?: string,
-    /** If true, the application prefers to be run on a more powerful discrete GPU if available. */
-    prefersNonDefaultGPU?: boolean,
-    /** If true, the application has a single main window, and does not support having an additional one opened. */
-    singleMainWindow?: string,
+  /** Name of the application */
+  name?: string;
+  /** Generic name of the application */
+  genericName?: string;
+  /** If true the application is not displayed */
+  noDisplay?: boolean;
+  /** Tooltip for the entry, for example "View sites on the Internet". */
+  comment?: string;
+  /** Icon to display in file manager, menus, etc. */
+  icon?: string;
+  /** A list of strings identifying the desktop environments that should (/not) display a given desktop entry */
+  onlyShowIn?: string[];
+  /**  A list of strings identifying the desktop environments that should (/not) display a given desktop entry */
+  notShowIn?: string[];
+  /** A boolean value specifying if D-Bus activation is supported for this application */
+  dBusActivatable?: boolean;
+  /** Path to an executable file on disk used to determine if the program is actually installed */
+  tryExec?: string;
+  /** Program to execute, possibly with arguments. */
+  exec?: string;
+  /** If entry is of type Application, the working directory to run the program in. */
+  path?: string;
+  /** Whether the program runs in a terminal window. */
+  terminal?: boolean;
+  /** Identifiers for application actions. */
+  actions?: string[];
+  /** The MIME type(s) supported by this application. */
+  mimeType?: string[];
+  /** Categories in which the entry should be shown in a menu */
+  categories?: string[];
+  /** A list of interfaces that this application implements. */
+  implements?: string[];
+  /** A list of strings which may be used in addition to other metadata to describe this entry. */
+  keywords?: string[];
+  /** If true, it is KNOWN that the application will send a "remove" message when started with the DESKTOP_STARTUP_ID environment variable set. If false, it is KNOWN that the application does not work with startup notification at all. */
+  startupNotify?: boolean;
+  /** If specified, it is known that the application will map at least one window with the given string as its WM class or WM name hin */
+  startupWMClass?: string;
+  /** If true, the application prefers to be run on a more powerful discrete GPU if available. */
+  prefersNonDefaultGPU?: boolean;
+  /** If true, the application has a single main window, and does not support having an additional one opened. */
+  singleMainWindow?: string;
 }
 
 /** OSX resource configuration options
@@ -149,33 +150,35 @@ export interface LinuxAppOptions {
  * https://developer.apple.com/documentation/bundleresources/information_property_list
  */
 export interface OsxAppOptions {
-    /** The name of the application */
-    name?: string,
-    /** The path to the icon file. It should be a .icns file. */
-    icon?: string,
-    /** The category that best describes your app for the App Store. */
-    LSApplicationCategoryType?: string,
-    /** A unique identifier for a bundle usually in reverse DNS format. */
-    CFBundleIdentifier?: string,
-    /** A user-visible short name for the bundle. */
-    CFBundleName?: string,
-    /** The user-visible name for the bundle. */
-    CFBundleDisplayName?: string,
-    /** A replacement for the app name in text-to-speech operations. */
-    CFBundleSpokenName?: string,
-    /** The version of the build that identifies an iteration of the bundle. */
-    CFBundleVersion?: string,
-    /** The release or version number of the bundle. */
-    CFBundleShortVersionString?: string,
-    /** A human-readable copyright notice for the bundle. */
-    NSHumanReadableCopyright?: string,
-    /** A human-readable description of why the application needs access to the local network. */
-    NSLocalNetworkUsageDescription?: string,
+  /** The name of the application */
+  name?: string;
+  /** The path to the icon file. It should be a .icns file. */
+  icon?: string;
+  /** The category that best describes your app for the App Store. */
+  LSApplicationCategoryType?: string;
+  /** A unique identifier for a bundle usually in reverse DNS format. */
+  CFBundleIdentifier?: string;
+  /** A user-visible short name for the bundle. */
+  CFBundleName?: string;
+  /** The user-visible name for the bundle. */
+  CFBundleDisplayName?: string;
+  /** A replacement for the app name in text-to-speech operations. */
+  CFBundleSpokenName?: string;
+  /** The version of the build that identifies an iteration of the bundle. */
+  CFBundleVersion?: string;
+  /** The release or version number of the bundle. */
+  CFBundleShortVersionString?: string;
+  /** A human-readable copyright notice for the bundle. */
+  NSHumanReadableCopyright?: string;
+  /** A human-readable description of why the application needs access to the local network. */
+  NSLocalNetworkUsageDescription?: string;
 }
 
 /**
  * Automates building an NW.js application.
  */
-declare function nwbuild<P extends SupportedPlatform>(options: Options<P>): Promise<child_process.ChildProcess | null | undefined>;
+declare function nwbuild<P extends SupportedPlatform>(
+  options: Options<P>,
+): Promise<child_process.ChildProcess | null | undefined>;
 
 export default nwbuild;

package/src/index.js

@@ -1,13 +1,13 @@
-import child_process from 'node:child_process';
-import console from 'node:console';
-import fs from 'node:fs';
-import path from 'node:path';
+import child_process from "node:child_process";
+import console from "node:console";
+import fs from "node:fs";
+import path from "node:path";
 
-import get from '@nwutils/getter';
-import run from '@nwutils/runner';
+import get from "@nwutils/getter";
+import run from "@nwutils/runner";
 
-import bld from './bld.js';
-import util from './util.js';
+import bld from "./bld.js";
+import util from "./util.js";
 
 /**
  * @typedef {object} Options Configuration options
@@ -44,31 +44,43 @@ async function nwbuild(options) {
   let built;
   let releaseInfo;
   let manifest = {
-    path: '',
+    path: "",
     json: undefined,
   };
 
   try {
     /* Parse options */
     options = await util.parse(options, manifest);
-    util.log('debug', 'info', 'Parse initial options');
+    util.log("debug", "info", "Parse initial options");
 
-    util.log('debug', 'info', 'Get node manifest...');
-    manifest = await util.getNodeManifest({ srcDir: options.srcDir, glob: options.glob });
-    if (typeof manifest.json?.nwbuild === 'object') {
+    util.log("debug", "info", "Get node manifest...");
+    manifest = await util.getNodeManifest({
+      srcDir: options.srcDir,
+      glob: options.glob,
+    });
+    if (typeof manifest.json?.nwbuild === "object") {
       options = { ...options, ...manifest.json.nwbuild };
     }
 
-    util.log('info', options.logLevel, 'Parse final options using node manifest');
+    util.log(
+      "info",
+      options.logLevel,
+      "Parse final options using node manifest",
+    );
     options = await util.parse(options, manifest.json);
-    util.log('debug', options.logLevel, 'Manifest: ', `${manifest.path}\n${manifest.json}\n`);
+    util.log(
+      "debug",
+      options.logLevel,
+      "Manifest: ",
+      `${manifest.path}\n${manifest.json}\n`,
+    );
 
     built = fs.existsSync(options.cacheDir);
     if (built === false) {
       await fs.promises.mkdir(options.cacheDir, { recursive: true });
     }
 
-    if (options.mode === 'build') {
+    if (options.mode === "build") {
       built = fs.existsSync(options.outDir);
       if (built === false) {
         await fs.promises.mkdir(options.outDir, { recursive: true });
@@ -76,7 +88,7 @@ async function nwbuild(options) {
     }
 
     /* Validate options.version to get the version specific release info */
-    util.log('info', options.logLevel, 'Get version specific release info...');
+    util.log("info", options.logLevel, "Get version specific release info...");
     releaseInfo = await util.getReleaseInfo(
       options.version,
       options.platform,
@@ -84,16 +96,24 @@ async function nwbuild(options) {
       options.cacheDir,
       options.manifestUrl,
     );
-    util.log('debug', options.logLevel, `Release info:\n${JSON.stringify(releaseInfo, null, 2)}\n`);
+    util.log(
+      "debug",
+      options.logLevel,
+      `Release info:\n${JSON.stringify(releaseInfo, null, 2)}\n`,
+    );
 
-    util.log('info', options.logLevel, 'Validate options.* ...');
+    util.log("info", options.logLevel, "Validate options.* ...");
     await util.validate(options, releaseInfo);
-    util.log('debug', options.logLevel, `Options:\n${JSON.stringify(options, null, 2)}`);
+    util.log(
+      "debug",
+      options.logLevel,
+      `Options:\n${JSON.stringify(options, null, 2)}`,
+    );
 
     /* Remove leading "v" from version string */
     options.version = releaseInfo.version.slice(1);
 
-    util.log('info', options.logLevel, 'Getting NW.js and related binaries...');
+    util.log("info", options.logLevel, "Getting NW.js and related binaries...");
     await get({
       version: options.version,
       flavor: options.flavor,
@@ -109,15 +129,17 @@ async function nwbuild(options) {
       logLevel: options.logLevel,
     });
 
-    if (options.mode === 'get') {
+    if (options.mode === "get") {
       // Do nothing else since we have already downloaded the binaries.
       return undefined;
     }
 
-    if (options.mode === 'run') {
-      util.log('info', options.logLevel, 'Running NW.js in run mode...');
+    if (options.mode === "run") {
+      util.log("info", options.logLevel, "Running NW.js in run mode...");
       if (options.glob) {
-        throw new Error('Glob option is not supported when mode is set to run.');
+        throw new Error(
+          "Glob option is not supported when mode is set to run.",
+        );
       }
       const nwProcess = await run({
         version: options.version,
@@ -129,8 +151,12 @@ async function nwbuild(options) {
         argv: options.argv,
       });
       return nwProcess;
-    } else if (options.mode === 'build') {
-      util.log('info', options.logLevel, `Build a NW.js application for ${options.platform} ${options.arch}...`);
+    } else if (options.mode === "build") {
+      util.log(
+        "info",
+        options.logLevel,
+        `Build a NW.js application for ${options.platform} ${options.arch}...`,
+      );
       await bld({
         version: options.version,
         flavor: options.flavor,
@@ -146,7 +172,11 @@ async function nwbuild(options) {
         zip: options.zip,
         releaseInfo: releaseInfo,
       });
-      util.log('info', options.logLevel, `Appliction is available at ${path.resolve(options.outDir)}`);
+      util.log(
+        "info",
+        options.logLevel,
+        `Appliction is available at ${path.resolve(options.outDir)}`,
+      );
     }
   } catch (error) {
     console.error(error);

package/src/postinstall.js

@@ -1,11 +1,19 @@
-import path  from 'node:path';
-import url from 'node:url';
+import path from "node:path";
+import url from "node:url";
 
 const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
 
-const baseVoltaPath = path.resolve(path.join(__dirname, '..', 'node_modules', 'base-volta-off-of-nwjs', 'index.js'));
+const baseVoltaPath = path.resolve(
+  path.join(
+    __dirname,
+    "..",
+    "node_modules",
+    "base-volta-off-of-nwjs",
+    "index.js",
+  ),
+);
 
 /* Execute the script in development mode only since it is used during testing */
 import(baseVoltaPath)
-  .then(() => console.log('Node version is updated'))
+  .then(() => console.log("Node version is updated"))
   .catch((error) => console.log(error));