@nwutils/packager 0.4.0 → 0.6.0

package/types/util.d.ts

@@ -1,3 +1,35 @@
+declare namespace _default {
+    export { APPIMAGE_ARCH_KV };
+    export { desktopExecArg };
+    export { fileExists };
+    export { isWindowsFileName };
+    export { nsisEscape };
+    export { nsisPath };
+    export { parseDesktopEntry };
+    export { sha512 };
+    export { shellQuote };
+    export { stringifyDesktopEntry };
+    export { stringifyYaml };
+    export { updateInfoFileName };
+    export { windowsVersion };
+}
+export default _default;
+/**
+ * Map nw-builder's architecture identifiers to the identifiers used in
+ * `appimagetool` release asset names and its `ARCH` environment variable.
+ * @type {Record<"ia32" | "x64" | "arm64", string>}
+ */
+declare const APPIMAGE_ARCH_KV: Record<"ia32" | "x64" | "arm64", string>;
+/**
+ * Quote `value` as a single argument of a desktop entry's `Exec` key, per the
+ * Desktop Entry Specification: `%` is doubled so it isn't read as a field
+ * code, an argument with reserved characters is double quoted with `"`, `` ` ``,
+ * `$` and `\` backslash-escaped, and finally backslashes are escaped again as
+ * required for every string value.
+ * @param {string} value
+ * @returns {string}
+ */
+declare function desktopExecArg(value: string): string;
 /**
  * Check if a file or directory exists.
  * @async
@@ -6,6 +38,35 @@
  * @returns {Promise<boolean>}
  */
 declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Check that `value` can be used as a single Windows file name: no path
+ * separators, characters Windows forbids in file names, control characters,
+ * trailing dots or spaces, or reserved device names.
+ * @param {string} value
+ * @returns {boolean}
+ */
+declare function isWindowsFileName(value: string): boolean;
+/**
+ * Escape `value` for use inside a double quoted NSIS string. NSIS expands `$`
+ * variables and `$\` escapes there, so `$` is doubled and `"` is escaped.
+ * Line breaks are rejected rather than escaped: a raw one would end the
+ * command and let the value inject further script lines. The result is not
+ * quoted, so it can be joined with NSIS variables, eg. `"$INSTDIR\<value>"`.
+ * @param {string} value
+ * @returns {string}
+ */
+declare function nsisEscape(value: string): string;
+/**
+ * Check a path on the host for use inside a double quoted NSIS string that
+ * `makensis` reads at compile time, eg. a `File` source or `OutFile`. Unlike
+ * runtime strings, those keep `$` literally, so nothing is escaped. Instead,
+ * the sequences `makensis` would still interpret are rejected: `${define}`
+ * expansions and `$\` escapes, and `"` - an escaped `$\"` doesn't survive
+ * being passed through a `!define`, as the icon and license paths are.
+ * @param {string} value
+ * @returns {string}  `value`, unchanged.
+ */
+declare function nsisPath(value: string): string;
 /**
  * Parse a freedesktop.org desktop entry file's `[Desktop Entry]` group into
  * a key/value map. Other groups (eg. `[Desktop Action ...]`) are ignored.
@@ -13,16 +74,50 @@ declare function fileExists(filePath: string): Promise<boolean>;
  * @returns {Record<string, string>}
  */
 declare function parseDesktopEntry(contents: string): Record<string, string>;
+/**
+ * Compute the base64 encoded SHA-512 digest of the file at `filePath`, the
+ * same encoding electron-builder writes into its update info files.
+ * @async
+ * @function
+ * @param {string} filePath
+ * @returns {Promise<string>}
+ */
+declare function sha512(filePath: string): Promise<string>;
+/**
+ * Quote `value` as a single POSIX shell word. Inside single quotes nothing is
+ * expanded, so only single quotes themselves need escaping.
+ * @param {string} value
+ * @returns {string}
+ */
+declare function shellQuote(value: string): string;
 /**
  * Serialise a `[Desktop Entry]` key/value map back into a desktop entry file.
  * @param {Record<string, string | undefined>} entries
  * @returns {string}
  */
 declare function stringifyDesktopEntry(entries: Record<string, string | undefined>): string;
-declare const _default: {
-    APPIMAGE_ARCH_KV: Record<"arm64" | "ia32" | "x64", string>;
-    fileExists: typeof fileExists;
-    parseDesktopEntry: typeof parseDesktopEntry;
-    stringifyDesktopEntry: typeof stringifyDesktopEntry;
-};
-export default _default;
+/**
+ * Serialise a map of scalars, and lists of maps of scalars, as YAML. This is
+ * the only shape the update info and `app-update.yml` files use, so it avoids
+ * pulling in a YAML library for a handful of lines.
+ * @param {Record<string, string | number | boolean | Record<string, string | number | boolean>[] | undefined>} entries
+ * @returns {string}
+ */
+declare function stringifyYaml(entries: Record<string, string | number | boolean | Record<string, string | number | boolean>[] | undefined>): string;
+/**
+ * Name of the update info file `@nwutils/updater` downloads to find the
+ * latest release, following electron-builder's naming: `x64` gets the bare
+ * `latest-linux.yml`, every other architecture gets an `-<arch>` suffix.
+ * @param {"ia32" | "x64" | "arm64"} arch
+ * @returns {string}
+ */
+declare function updateInfoFileName(arch: "ia32" | "x64" | "arm64"): string;
+/**
+ * Convert a version such as `"1.2.3"` or `"1.2.3-beta.1"` into the
+ * `X.X.X.X` form Windows version resources (and NSIS' `VIProductVersion`)
+ * require. Up to four leading numeric parts are kept, missing ones are
+ * filled with `0`, and any prerelease or build suffix is dropped.
+ * @param {string} version
+ * @returns {string}
+ */
+declare function windowsVersion(version: string): string;