app-builder-lib 26.11.1 → 26.12.1

package/out/targets/snap/coreLegacy.d.ts

@@ -0,0 +1,20 @@
+import { Arch } from "builder-util";
+import { SnapOptions } from "../../options/SnapOptions";
+import { SnapCore } from "./SnapTarget";
+import { SnapcraftYAML } from "./snapcraft";
+export declare class SnapCoreLegacy extends SnapCore<SnapOptions> {
+    private isUseTemplateApp;
+    defaultPlugs: string[];
+    private replaceDefault;
+    createDescriptor(arch: Arch): Promise<SnapcraftYAML>;
+    buildSnap(props: {
+        snap: any;
+        appOutDir: string;
+        stageDir: string;
+        snapArch: Arch;
+        artifactPath: string;
+    }): Promise<void>;
+    private normalizePlugConfiguration;
+    private isBrowserSandboxAllowed;
+    private archNameToTriplet;
+}

package/out/targets/snap/coreLegacy.js

@@ -0,0 +1,278 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapCoreLegacy = void 0;
+const builder_util_1 = require("builder-util");
+const builder_util_runtime_1 = require("builder-util-runtime");
+const fs_extra_1 = require("fs-extra");
+const js_yaml_1 = require("js-yaml");
+const path = require("path");
+const pathManager_1 = require("../../util/pathManager");
+const SnapTarget_1 = require("./SnapTarget");
+const snapcraftBuilder_1 = require("./snapcraftBuilder");
+// Handles core18/core20/core22 snaps via the app-builder binary (not the snapcraft CLI).
+// See: https://github.com/develar/app-builder/blob/master/pkg/package-format/snap
+class SnapCoreLegacy extends SnapTarget_1.SnapCore {
+    constructor() {
+        super(...arguments);
+        this.isUseTemplateApp = false;
+        this.defaultPlugs = ["desktop", "desktop-legacy", "home", "x11", "wayland", "unity7", "browser-support", "network", "gsettings", "audio-playback", "pulseaudio", "opengl"];
+    }
+    replaceDefault(inList, defaultList) {
+        const result = (0, builder_util_1.replaceDefault)(inList, defaultList);
+        // Any customisation opts out of the pre-built template app.
+        if (result !== defaultList) {
+            this.isUseTemplateApp = false;
+        }
+        return result;
+    }
+    async createDescriptor(arch) {
+        const appInfo = this.packager.appInfo;
+        const snapName = this.packager.executableName.toLowerCase();
+        const options = this.options;
+        const plugs = this.normalizePlugConfiguration(this.options.plugs);
+        const plugNames = this.replaceDefault(plugs == null ? null : Object.getOwnPropertyNames(plugs), this.defaultPlugs);
+        const slots = this.normalizePlugConfiguration(this.options.slots);
+        const buildPackages = (0, builder_util_runtime_1.asArray)(options.buildPackages);
+        const stagePackages = this.replaceDefault(options.stagePackages, snapcraftBuilder_1.DEFAULT_STAGE_PACKAGES);
+        const stageSet = new Set(stagePackages);
+        const stageMatchesDefaults = stagePackages.length === snapcraftBuilder_1.DEFAULT_STAGE_PACKAGES.length && snapcraftBuilder_1.DEFAULT_STAGE_PACKAGES.every((p) => stageSet.has(p));
+        // Template app is only available for x64/armv7l, and only when no packages are customised.
+        this.isUseTemplateApp = this.options.useTemplateApp !== false && (arch === builder_util_1.Arch.x64 || arch === builder_util_1.Arch.armv7l) && buildPackages.length === 0 && stageMatchesDefaults;
+        const appDescriptor = {
+            command: "command.sh",
+            plugs: plugNames,
+            adapter: "none",
+        };
+        const snap = (0, js_yaml_1.load)(await (0, fs_extra_1.readFile)(path.join((0, pathManager_1.getTemplatePath)("snap"), "snapcraft.yaml"), "utf-8"));
+        if (this.isUseTemplateApp) {
+            delete appDescriptor.adapter;
+        }
+        if (options.base != null) {
+            snap.base = options.base;
+            // from core22 onwards adapter is legacy
+            if (Number(snap.base.split("core")[1]) >= 22) {
+                delete appDescriptor.adapter;
+            }
+        }
+        if (options.grade != null) {
+            snap.grade = options.grade;
+        }
+        if (options.confinement != null) {
+            snap.confinement = options.confinement;
+        }
+        if (options.appPartStage != null) {
+            snap.parts.app.stage = options.appPartStage;
+        }
+        if (options.layout != null) {
+            snap.layout = options.layout;
+        }
+        if (slots != null) {
+            appDescriptor.slots = Object.getOwnPropertyNames(slots);
+            for (const slotName of appDescriptor.slots) {
+                if (!(0, builder_util_runtime_1.isValidKey)(slotName)) {
+                    throw new Error(`Invalid plug/slot name: ${slotName}`);
+                }
+                const slotOptions = slots[slotName];
+                if (slotOptions == null) {
+                    continue;
+                }
+                if (!snap.slots) {
+                    snap.slots = {};
+                }
+                snap.slots[slotName] = slotOptions;
+            }
+        }
+        (0, builder_util_runtime_1.deepAssign)(snap, {
+            name: snapName,
+            version: appInfo.version,
+            title: options.title || appInfo.productName,
+            summary: options.summary || appInfo.productName,
+            compression: options.compression,
+            description: this.helper.getDescription(options),
+            architectures: [(0, builder_util_1.toLinuxArchString)(arch, "snap")],
+            apps: {
+                [snapName]: appDescriptor,
+            },
+            parts: {
+                app: {
+                    "stage-packages": stagePackages,
+                },
+            },
+        });
+        if (options.autoStart) {
+            appDescriptor.autostart = `${snap.name}.desktop`;
+        }
+        if (options.confinement === "classic") {
+            delete appDescriptor.plugs;
+            delete snap.plugs;
+        }
+        else {
+            const archTriplet = this.archNameToTriplet(arch);
+            const environment = {
+                PATH: "$SNAP/usr/sbin:$SNAP/usr/bin:$SNAP/sbin:$SNAP/bin:$PATH",
+                SNAP_DESKTOP_RUNTIME: "$SNAP/gnome-platform",
+                LD_LIBRARY_PATH: [
+                    "$SNAP_LIBRARY_PATH",
+                    "$SNAP/lib:$SNAP/usr/lib:$SNAP/lib/" + archTriplet + ":$SNAP/usr/lib/" + archTriplet,
+                    "$LD_LIBRARY_PATH:$SNAP/lib:$SNAP/usr/lib",
+                    "$SNAP/lib/" + archTriplet + ":$SNAP/usr/lib/" + archTriplet,
+                ].join(":"),
+                ...options.environment,
+            };
+            // Determine whether Wayland should be disabled based on:
+            // - Electron version (<38 historically had Wayland disabled)
+            // - Explicit allowNativeWayland override.
+            // https://github.com/electron-userland/electron-builder/issues/9320
+            const allow = options.allowNativeWayland;
+            const isOldElectron = !this.helper.isElectronVersionGreaterOrEqualThan("38.0.0", "7.0.0");
+            if ((allow == null && isOldElectron) || // No explicit option -> use legacy behavior for old Electron
+                allow === false // Explicitly disallowed
+            ) {
+                environment.DISABLE_WAYLAND = "1";
+            }
+            appDescriptor.environment = environment;
+            if (plugs != null) {
+                for (const plugName of plugNames) {
+                    if (!(0, builder_util_runtime_1.isValidKey)(plugName)) {
+                        throw new Error(`Invalid plug/slot name: ${plugName}`);
+                    }
+                    const plugOptions = plugs[plugName];
+                    if (plugOptions == null) {
+                        continue;
+                    }
+                    if (!snap.plugs) {
+                        snap.plugs = {};
+                    }
+                    snap.plugs[plugName] = plugOptions;
+                }
+            }
+        }
+        if (buildPackages.length > 0) {
+            snap.parts.app["build-packages"] = buildPackages;
+        }
+        if (options.after != null) {
+            snap.parts.app.after = options.after;
+        }
+        if (options.assumes != null) {
+            snap.assumes = (0, builder_util_runtime_1.asArray)(options.assumes);
+        }
+        return snap;
+    }
+    async buildSnap(props) {
+        var _a;
+        const { snap, appOutDir, stageDir, snapArch, artifactPath } = props;
+        const args = [
+            "snap",
+            "--app",
+            appOutDir,
+            "--stage",
+            stageDir,
+            "--arch",
+            (0, builder_util_1.toLinuxArchString)(snapArch, "snap"),
+            "--output",
+            artifactPath,
+            "--executable",
+            this.packager.executableName,
+        ];
+        await this.helper.icons;
+        if (this.helper.maxIconPath != null) {
+            if (!this.isUseTemplateApp) {
+                snap.icon = "snap/gui/icon.png";
+            }
+            args.push("--icon", this.helper.maxIconPath);
+        }
+        // snapcraft.yaml inside a snap directory, or snap.yaml inside meta/ for template builds
+        const snapMetaDir = path.join(stageDir, this.isUseTemplateApp ? "meta" : "snap");
+        const desktopFile = path.join(snapMetaDir, "gui", `${snap.name}.desktop`);
+        await this.helper.writeDesktopEntry(this.options, this.packager.executableName + " %U", desktopFile, {
+            // tslint:disable:no-invalid-template-strings
+            Icon: "${SNAP}/meta/gui/icon.png",
+        });
+        const extraAppArgs = (_a = this.options.executableArgs) !== null && _a !== void 0 ? _a : [];
+        if (this.helper.isElectronVersionGreaterOrEqualThan("5.0.0") && !this.isBrowserSandboxAllowed(snap)) {
+            const noSandboxArg = "--no-sandbox";
+            if (!extraAppArgs.includes(noSandboxArg)) {
+                extraAppArgs.push(noSandboxArg);
+            }
+            if (this.isUseTemplateApp) {
+                args.push("--exclude", "chrome-sandbox");
+            }
+        }
+        if (extraAppArgs.length > 0) {
+            args.push("--extraAppArgs=" + extraAppArgs.join(" "));
+        }
+        if (snap.compression != null) {
+            args.push("--compression", snap.compression);
+        }
+        if (this.isUseTemplateApp) {
+            // remove fields that are valid in snapcraft.yaml but not in snap.yaml (template format)
+            const fieldsToStrip = ["compression", "contact", "donation", "issues", "parts", "source-code", "website"];
+            for (const field of fieldsToStrip) {
+                delete snap[field];
+            }
+        }
+        if (this.packager.packagerOptions.effectiveOptionComputed != null && (await this.packager.packagerOptions.effectiveOptionComputed({ snap, desktopFile, args }))) {
+            return;
+        }
+        await (0, fs_extra_1.outputFile)(path.join(snapMetaDir, this.isUseTemplateApp ? "snap.yaml" : "snapcraft.yaml"), (0, builder_util_1.serializeToYaml)(snap));
+        const hooksDir = await this.packager.getResource(this.options.hooks, "snap-hooks");
+        if (hooksDir != null) {
+            args.push("--hooks", hooksDir);
+        }
+        if (this.isUseTemplateApp) {
+            // Map TypeScript Arch enum to the string keys expected by app-builder's ResolveTemplateDir.
+            // The previous code passed the raw numeric enum value (e.g. Arch.x64 = 1 → "electron4:1")
+            // which fell through to the default case and was treated as a bare URL, failing with
+            // "unsupported protocol scheme". The switch in snap.go expects "electron4:amd64" / "electron4:armhf".
+            const templateArch = snapArch === builder_util_1.Arch.x64 ? "amd64" : "armhf";
+            args.push("--template-url", `electron4:${templateArch}`);
+        }
+        await (0, builder_util_1.executeAppBuilder)(args);
+    }
+    normalizePlugConfiguration(raw) {
+        if (raw == null) {
+            return null;
+        }
+        const result = {};
+        for (const item of Array.isArray(raw) ? raw : [raw]) {
+            if (typeof item === "string") {
+                if (!(0, builder_util_runtime_1.isValidKey)(item)) {
+                    throw new Error(`Invalid plug/slot name: ${item}`);
+                }
+                result[item] = null;
+            }
+            else {
+                (0, builder_util_runtime_1.deepAssign)(result, item);
+            }
+        }
+        return result;
+    }
+    isBrowserSandboxAllowed(snap) {
+        if (snap.plugs != null) {
+            for (const plugName of Object.keys(snap.plugs)) {
+                const plug = snap.plugs[plugName];
+                if (plug.interface === "browser-support" && plug["allow-sandbox"] === true) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    archNameToTriplet(arch) {
+        switch (arch) {
+            case builder_util_1.Arch.x64:
+                return "x86_64-linux-gnu";
+            case builder_util_1.Arch.ia32:
+                return "i386-linux-gnu";
+            case builder_util_1.Arch.armv7l:
+                // noinspection SpellCheckingInspection
+                return "arm-linux-gnueabihf";
+            case builder_util_1.Arch.arm64:
+                return "aarch64-linux-gnu";
+            default:
+                throw new Error(`Unsupported arch ${arch}`);
+        }
+    }
+}
+exports.SnapCoreLegacy = SnapCoreLegacy;
+//# sourceMappingURL=coreLegacy.js.map

package/out/targets/snap/coreLegacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreLegacy.js","sourceRoot":"","sources":["../../../src/targets/snap/coreLegacy.ts"],"names":[],"mappings":"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","sourcesContent":["import { replaceDefault as _replaceDefault, Arch, executeAppBuilder, serializeToYaml, toLinuxArchString } from \"builder-util\"\nimport { asArray, deepAssign, isValidKey, Nullish } from \"builder-util-runtime\"\nimport { outputFile, readFile } from \"fs-extra\"\nimport { load } from \"js-yaml\"\nimport * as path from \"path\"\nimport { PlugDescriptor, SnapOptions } from \"../../options/SnapOptions\"\nimport { getTemplatePath } from \"../../util/pathManager\"\nimport { SnapCore } from \"./SnapTarget\"\nimport { SnapcraftYAML } from \"./snapcraft\"\nimport { DEFAULT_STAGE_PACKAGES } from \"./snapcraftBuilder\"\n\n// Handles core18/core20/core22 snaps via the app-builder binary (not the snapcraft CLI).\n// See: https://github.com/develar/app-builder/blob/master/pkg/package-format/snap\nexport class SnapCoreLegacy extends SnapCore<SnapOptions> {\n  private isUseTemplateApp = false\n\n  defaultPlugs = [\"desktop\", \"desktop-legacy\", \"home\", \"x11\", \"wayland\", \"unity7\", \"browser-support\", \"network\", \"gsettings\", \"audio-playback\", \"pulseaudio\", \"opengl\"]\n\n  private replaceDefault(inList: Array<string> | Nullish, defaultList: Array<string>) {\n    const result = _replaceDefault(inList, defaultList)\n    // Any customisation opts out of the pre-built template app.\n    if (result !== defaultList) {\n      this.isUseTemplateApp = false\n    }\n    return result\n  }\n\n  async createDescriptor(arch: Arch): Promise<SnapcraftYAML> {\n    const appInfo = this.packager.appInfo\n    const snapName = this.packager.executableName.toLowerCase()\n    const options = this.options\n\n    const plugs = this.normalizePlugConfiguration(this.options.plugs)\n\n    const plugNames = this.replaceDefault(plugs == null ? null : Object.getOwnPropertyNames(plugs), this.defaultPlugs)\n\n    const slots = this.normalizePlugConfiguration(this.options.slots)\n\n    const buildPackages = asArray(options.buildPackages)\n    const stagePackages = this.replaceDefault(options.stagePackages, DEFAULT_STAGE_PACKAGES)\n\n    const stageSet = new Set(stagePackages)\n    const stageMatchesDefaults = stagePackages.length === DEFAULT_STAGE_PACKAGES.length && DEFAULT_STAGE_PACKAGES.every((p: string) => stageSet.has(p))\n\n    // Template app is only available for x64/armv7l, and only when no packages are customised.\n    this.isUseTemplateApp = this.options.useTemplateApp !== false && (arch === Arch.x64 || arch === Arch.armv7l) && buildPackages.length === 0 && stageMatchesDefaults\n\n    const appDescriptor: any = {\n      command: \"command.sh\",\n      plugs: plugNames,\n      adapter: \"none\",\n    }\n\n    const snap: any = load(await readFile(path.join(getTemplatePath(\"snap\"), \"snapcraft.yaml\"), \"utf-8\"))\n    if (this.isUseTemplateApp) {\n      delete appDescriptor.adapter\n    }\n    if (options.base != null) {\n      snap.base = options.base\n      // from core22 onwards adapter is legacy\n      if (Number(snap.base.split(\"core\")[1]) >= 22) {\n        delete appDescriptor.adapter\n      }\n    }\n    if (options.grade != null) {\n      snap.grade = options.grade\n    }\n    if (options.confinement != null) {\n      snap.confinement = options.confinement\n    }\n    if (options.appPartStage != null) {\n      snap.parts.app.stage = options.appPartStage\n    }\n    if (options.layout != null) {\n      snap.layout = options.layout\n    }\n    if (slots != null) {\n      appDescriptor.slots = Object.getOwnPropertyNames(slots)\n      for (const slotName of appDescriptor.slots) {\n        if (!isValidKey(slotName)) {\n          throw new Error(`Invalid plug/slot name: ${slotName}`)\n        }\n        const slotOptions = slots[slotName]\n        if (slotOptions == null) {\n          continue\n        }\n        if (!snap.slots) {\n          snap.slots = {}\n        }\n        snap.slots[slotName] = slotOptions\n      }\n    }\n\n    deepAssign(snap, {\n      name: snapName,\n      version: appInfo.version,\n      title: options.title || appInfo.productName,\n      summary: options.summary || appInfo.productName,\n      compression: options.compression,\n      description: this.helper.getDescription(options),\n      architectures: [toLinuxArchString(arch, \"snap\")],\n      apps: {\n        [snapName]: appDescriptor,\n      },\n      parts: {\n        app: {\n          \"stage-packages\": stagePackages,\n        },\n      },\n    })\n\n    if (options.autoStart) {\n      appDescriptor.autostart = `${snap.name}.desktop`\n    }\n\n    if (options.confinement === \"classic\") {\n      delete appDescriptor.plugs\n      delete snap.plugs\n    } else {\n      const archTriplet = this.archNameToTriplet(arch)\n      const environment: Record<string, string> = {\n        PATH: \"$SNAP/usr/sbin:$SNAP/usr/bin:$SNAP/sbin:$SNAP/bin:$PATH\",\n        SNAP_DESKTOP_RUNTIME: \"$SNAP/gnome-platform\",\n        LD_LIBRARY_PATH: [\n          \"$SNAP_LIBRARY_PATH\",\n          \"$SNAP/lib:$SNAP/usr/lib:$SNAP/lib/\" + archTriplet + \":$SNAP/usr/lib/\" + archTriplet,\n          \"$LD_LIBRARY_PATH:$SNAP/lib:$SNAP/usr/lib\",\n          \"$SNAP/lib/\" + archTriplet + \":$SNAP/usr/lib/\" + archTriplet,\n        ].join(\":\"),\n        ...options.environment,\n      }\n      // Determine whether Wayland should be disabled based on:\n      // - Electron version (<38 historically had Wayland disabled)\n      // - Explicit allowNativeWayland override.\n      // https://github.com/electron-userland/electron-builder/issues/9320\n      const allow = options.allowNativeWayland\n      const isOldElectron = !this.helper.isElectronVersionGreaterOrEqualThan(\"38.0.0\", \"7.0.0\")\n      if (\n        (allow == null && isOldElectron) || // No explicit option -> use legacy behavior for old Electron\n        allow === false // Explicitly disallowed\n      ) {\n        environment.DISABLE_WAYLAND = \"1\"\n      }\n\n      appDescriptor.environment = environment\n\n      if (plugs != null) {\n        for (const plugName of plugNames) {\n          if (!isValidKey(plugName)) {\n            throw new Error(`Invalid plug/slot name: ${plugName}`)\n          }\n          const plugOptions = plugs[plugName]\n          if (plugOptions == null) {\n            continue\n          }\n          if (!snap.plugs) {\n            snap.plugs = {}\n          }\n          snap.plugs[plugName] = plugOptions\n        }\n      }\n    }\n\n    if (buildPackages.length > 0) {\n      snap.parts.app[\"build-packages\"] = buildPackages\n    }\n    if (options.after != null) {\n      snap.parts.app.after = options.after\n    }\n\n    if (options.assumes != null) {\n      snap.assumes = asArray(options.assumes)\n    }\n\n    return snap\n  }\n\n  async buildSnap(props: { snap: any; appOutDir: string; stageDir: string; snapArch: Arch; artifactPath: string }): Promise<void> {\n    const { snap, appOutDir, stageDir, snapArch, artifactPath } = props\n    const args = [\n      \"snap\",\n      \"--app\",\n      appOutDir,\n      \"--stage\",\n      stageDir,\n      \"--arch\",\n      toLinuxArchString(snapArch, \"snap\"),\n      \"--output\",\n      artifactPath,\n      \"--executable\",\n      this.packager.executableName,\n    ]\n\n    await this.helper.icons\n    if (this.helper.maxIconPath != null) {\n      if (!this.isUseTemplateApp) {\n        snap.icon = \"snap/gui/icon.png\"\n      }\n      args.push(\"--icon\", this.helper.maxIconPath)\n    }\n\n    // snapcraft.yaml inside a snap directory, or snap.yaml inside meta/ for template builds\n    const snapMetaDir = path.join(stageDir, this.isUseTemplateApp ? \"meta\" : \"snap\")\n    const desktopFile = path.join(snapMetaDir, \"gui\", `${snap.name}.desktop`)\n    await this.helper.writeDesktopEntry(this.options, this.packager.executableName + \" %U\", desktopFile, {\n      // tslint:disable:no-invalid-template-strings\n      Icon: \"${SNAP}/meta/gui/icon.png\",\n    })\n\n    const extraAppArgs: Array<string> = this.options.executableArgs ?? []\n    if (this.helper.isElectronVersionGreaterOrEqualThan(\"5.0.0\") && !this.isBrowserSandboxAllowed(snap)) {\n      const noSandboxArg = \"--no-sandbox\"\n      if (!extraAppArgs.includes(noSandboxArg)) {\n        extraAppArgs.push(noSandboxArg)\n      }\n      if (this.isUseTemplateApp) {\n        args.push(\"--exclude\", \"chrome-sandbox\")\n      }\n    }\n    if (extraAppArgs.length > 0) {\n      args.push(\"--extraAppArgs=\" + extraAppArgs.join(\" \"))\n    }\n\n    if (snap.compression != null) {\n      args.push(\"--compression\", snap.compression)\n    }\n\n    if (this.isUseTemplateApp) {\n      // remove fields that are valid in snapcraft.yaml but not in snap.yaml (template format)\n      const fieldsToStrip = [\"compression\", \"contact\", \"donation\", \"issues\", \"parts\", \"source-code\", \"website\"]\n      for (const field of fieldsToStrip) {\n        delete snap[field]\n      }\n    }\n\n    if (this.packager.packagerOptions.effectiveOptionComputed != null && (await this.packager.packagerOptions.effectiveOptionComputed({ snap, desktopFile, args }))) {\n      return\n    }\n\n    await outputFile(path.join(snapMetaDir, this.isUseTemplateApp ? \"snap.yaml\" : \"snapcraft.yaml\"), serializeToYaml(snap))\n\n    const hooksDir = await this.packager.getResource(this.options.hooks, \"snap-hooks\")\n    if (hooksDir != null) {\n      args.push(\"--hooks\", hooksDir)\n    }\n\n    if (this.isUseTemplateApp) {\n      // Map TypeScript Arch enum to the string keys expected by app-builder's ResolveTemplateDir.\n      // The previous code passed the raw numeric enum value (e.g. Arch.x64 = 1 → \"electron4:1\")\n      // which fell through to the default case and was treated as a bare URL, failing with\n      // \"unsupported protocol scheme\". The switch in snap.go expects \"electron4:amd64\" / \"electron4:armhf\".\n      const templateArch = snapArch === Arch.x64 ? \"amd64\" : \"armhf\"\n      args.push(\"--template-url\", `electron4:${templateArch}`)\n    }\n\n    await executeAppBuilder(args)\n  }\n\n  private normalizePlugConfiguration(raw: Array<string | PlugDescriptor> | PlugDescriptor | Nullish): Record<string, Record<string, any> | null> | null {\n    if (raw == null) {\n      return null\n    }\n\n    const result: any = {}\n    for (const item of Array.isArray(raw) ? raw : [raw]) {\n      if (typeof item === \"string\") {\n        if (!isValidKey(item)) {\n          throw new Error(`Invalid plug/slot name: ${item}`)\n        }\n        result[item] = null\n      } else {\n        deepAssign(result, item)\n      }\n    }\n    return result\n  }\n\n  private isBrowserSandboxAllowed(snap: any): boolean {\n    if (snap.plugs != null) {\n      for (const plugName of Object.keys(snap.plugs)) {\n        const plug = snap.plugs[plugName]\n        if (plug.interface === \"browser-support\" && plug[\"allow-sandbox\"] === true) {\n          return true\n        }\n      }\n    }\n    return false\n  }\n\n  private archNameToTriplet(arch: Arch): string {\n    switch (arch) {\n      case Arch.x64:\n        return \"x86_64-linux-gnu\"\n      case Arch.ia32:\n        return \"i386-linux-gnu\"\n      case Arch.armv7l:\n        // noinspection SpellCheckingInspection\n        return \"arm-linux-gnueabihf\"\n      case Arch.arm64:\n        return \"aarch64-linux-gnu\"\n\n      default:\n        throw new Error(`Unsupported arch ${arch}`)\n    }\n  }\n}\n"]}

package/out/targets/snap/snapcraftBuilder.d.ts

@@ -0,0 +1,39 @@
+import { LinuxPackager } from "../../linuxPackager";
+import { RemoteBuildOptions } from "../../options/SnapOptions";
+import { SnapcraftYAML } from "./snapcraft";
+export declare const SNAPCRAFT_YAML_OPTIONS: {
+    readonly indent: 2;
+    readonly lineWidth: -1;
+    readonly noRefs: true;
+};
+export declare const DEFAULT_STAGE_PACKAGES: string[];
+interface BuildSnapOptions {
+    /** The snapcraft YAML configuration */
+    snapcraftConfig: SnapcraftYAML;
+    /** Working directory where snapcraft.yaml is written and the build executes */
+    stageDir: string;
+    /** Whether to use remote build (builds on Launchpad) */
+    remoteBuild?: RemoteBuildOptions;
+    /** Whether to use LXD for local builds */
+    useLXD?: boolean;
+    /** Whether to use Multipass for local builds */
+    useMultipass?: boolean;
+    /** Whether to use destructive mode (builds directly on host, Linux only) */
+    useDestructiveMode?: boolean;
+    /** The snap output path */
+    artifactPath: string;
+    /** LinuxPackager instance, used to resolve workspace dir for remote build authentication */
+    packager: LinuxPackager;
+    /** Snap Store credentials from SnapcraftOptions root — base64 string or file path */
+    cscLink?: string;
+}
+/**
+ * Builds a snap package from SnapcraftYAML configuration.
+ *
+ * `SNAPCRAFT_NO_NETWORK` is intentionally **not** forced to `"1"` here.
+ * All build modes (destructive-mode, LXD, Multipass, remote) require network
+ * access to download stage-packages, the base image, and extensions.
+ * To opt into an offline build, set `SNAPCRAFT_NO_NETWORK=1` in your environment.
+ */
+export declare function buildSnap(options: BuildSnapOptions): Promise<string>;
+export {};