// Package Mac App tests cover package mac app script behavior. import { spawnSync } from "node:child_process"; import { chmodSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import path from "node:path"; import { afterEach, describe, expect, it } from "vitest"; const tempDirs: string[] = []; const scriptPath = "scripts/package-mac-app.sh"; function makePlist(): string { const dir = mkdtempSync(path.join(tmpdir(), "openclaw-plistbuddy-")); tempDirs.push(dir); const plist = path.join(dir, "Info.plist"); writeFileSync( plist, [ '', '', '', "", "CFBundleIdentifier", "old.bundle", "", "", "", ].join("\n"), "utf8", ); return plist; } function runHelper(script: string) { return spawnSync("bash", ["-lc", script], { cwd: process.cwd(), encoding: "utf8", }); } function getPackageManagerHelperBlock(): string { const script = readFileSync(scriptPath, "utf8"); const start = script.indexOf("PNPM_CMD=()"); const end = script.indexOf("merge_framework_machos()"); expect(start).toBeGreaterThanOrEqual(0); expect(end).toBeGreaterThan(start); return script.slice(start, end); } function getSparkleBuildHelperBlock(): string { const script = readFileSync(scriptPath, "utf8"); const start = script.indexOf("sparkle_canonical_build_from_version()"); const end = script.indexOf("build_path_for_arch()"); expect(start).toBeGreaterThanOrEqual(0); expect(end).toBeGreaterThan(start); return script.slice(start, end); } function getStopPackagedAppBlock(): string { const script = readFileSync(scriptPath, "utf8"); const start = script.indexOf("running_packaged_app_pids()"); const end = script.indexOf("\nstop_packaged_app_if_running\n"); expect(start).toBeGreaterThanOrEqual(0); expect(end).toBeGreaterThan(start); return script.slice(start, end); } function getSwiftCompatibilityBlock(): string { const script = readFileSync(scriptPath, "utf8"); const start = script.indexOf('echo "📦 Copying Swift 6.2 compatibility libraries"'); const end = script.indexOf('echo "🖼 Copying app icon"'); expect(start).toBeGreaterThanOrEqual(0); expect(end).toBeGreaterThan(start); return script.slice(start, end); } function runStopPackagedAppHarness(killZeroStatus: 0 | 1) { const root = mkdtempSync(path.join(tmpdir(), "openclaw-package-stop-root-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-stop-tools-")); tempDirs.push(root, toolsDir); const appRoot = path.join(root, "dist", "OpenClaw.app"); const appBinary = path.join(appRoot, "Contents", "MacOS", "OpenClaw"); const lsofPath = path.join(toolsDir, "lsof"); const pgrepPath = path.join(toolsDir, "pgrep"); const sleepPath = path.join(toolsDir, "sleep"); writeFileSync( lsofPath, ["#!/usr/bin/env bash", `printf 'n%s\\n' ${JSON.stringify(appBinary)}`].join("\n"), "utf8", ); writeFileSync(pgrepPath, "#!/usr/bin/env bash\nprintf '123\\n'\n", "utf8"); writeFileSync(sleepPath, "#!/usr/bin/env bash\nexit 0\n", "utf8"); chmodSync(lsofPath, 0o755); chmodSync(pgrepPath, 0o755); chmodSync(sleepPath, 0o755); return runHelper(` set -euo pipefail APP_ROOT=${JSON.stringify(appRoot)} PRODUCT=OpenClaw PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} kill() { if [[ "\${1:-}" == "-0" ]]; then return ${killZeroStatus} fi return 0 } ${getStopPackagedAppBlock()} stop_packaged_app_if_running `); } function runSwiftCompatibilityHarness(buildConfig: "debug" | "release") { const root = mkdtempSync(path.join(tmpdir(), "openclaw-package-swift-root-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-swift-tools-")); const developerDir = path.join(root, "Xcode.app", "Contents", "Developer"); const appRoot = path.join(root, "OpenClaw.app"); const xcodeSelectPath = path.join(toolsDir, "xcode-select"); tempDirs.push(root, toolsDir); writeFileSync( xcodeSelectPath, ["#!/usr/bin/env bash", `printf '%s\\n' ${JSON.stringify(developerDir)}`].join("\n"), "utf8", ); chmodSync(xcodeSelectPath, 0o755); return runHelper(` set -euo pipefail APP_ROOT=${JSON.stringify(appRoot)} BUILD_CONFIG=${JSON.stringify(buildConfig)} PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} mkdir -p "$APP_ROOT/Contents/Frameworks" ${getSwiftCompatibilityBlock()} `); } afterEach(() => { for (const dir of tempDirs.splice(0)) { rmSync(dir, { recursive: true, force: true }); } }); describe("package-mac-app plist stamping", () => { it("keeps dependency installation lockfile-safe", () => { const script = readFileSync(scriptPath, "utf8"); const installBlock = script.slice( script.indexOf('if [[ "${SKIP_PNPM_INSTALL:-0}" != "1" ]]'), script.indexOf('if [[ -z "${APP_BUILD:-}" ]]'), ); expect(installBlock).toContain("run_pnpm install --frozen-lockfile"); expect(installBlock).toContain("--config.node-linker=hoisted"); expect(installBlock).not.toContain("--no-frozen-lockfile"); }); it("falls back to corepack pnpm when the pnpm shim is absent", () => { const helperBlock = getPackageManagerHelperBlock(); const tempRoot = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-root-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-tools-")); const logPath = path.join(tempRoot, "corepack.log"); tempDirs.push(tempRoot, toolsDir); const corepackPath = path.join(toolsDir, "corepack"); writeFileSync( corepackPath, [ "#!/usr/bin/env bash", "set -euo pipefail", 'printf \'%s|%s\\n\' "$PWD" "$*" >> "$OPENCLAW_TEST_LOG"', 'if [[ "${1:-}" == "pnpm" && "${2:-}" == "--version" ]]; then', " echo '11.2.2'", "fi", "", ].join("\n"), "utf8", ); chmodSync(corepackPath, 0o755); const result = runHelper(` set -euo pipefail ROOT_DIR=${JSON.stringify(tempRoot)} OPENCLAW_TEST_LOG=${JSON.stringify(logPath)} export OPENCLAW_TEST_LOG PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} ${helperBlock} run_pnpm install --frozen-lockfile --config.node-linker=hoisted run_pnpm build `); expect(result.status).toBe(0); expect(readFileSync(logPath, "utf8").trim().split("\n")).toEqual([ `${tempRoot}|pnpm --version`, `${tempRoot}|pnpm install --frozen-lockfile --config.node-linker=hoisted`, `${tempRoot}|pnpm build`, ]); }); it("prefers repo Corepack pnpm over a global pnpm shim", () => { const helperBlock = getPackageManagerHelperBlock(); const tempRoot = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-root-")); const outerRoot = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-outer-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-tools-")); const logPath = path.join(tempRoot, "pnpm.log"); tempDirs.push(tempRoot, outerRoot, toolsDir); writeFileSync( path.join(tempRoot, "package.json"), '{\n "packageManager": "pnpm@11.2.2+sha512.test"\n}\n', ); writeFileSync( path.join(outerRoot, "package.json"), '{\n "packageManager": "pnpm@11.8.0+sha512.test"\n}\n', ); writeFileSync( path.join(toolsDir, "pnpm"), [ "#!/usr/bin/env bash", "set -euo pipefail", 'printf "global|%s|%s\\n" "$PWD" "$*" >> "$OPENCLAW_TEST_LOG"', 'if [[ "${1:-}" == "--version" ]]; then echo "11.8.0"; fi', "", ].join("\n"), "utf8", ); writeFileSync( path.join(toolsDir, "corepack"), [ "#!/usr/bin/env bash", "set -euo pipefail", 'printf "corepack|%s|%s\\n" "$PWD" "$*" >> "$OPENCLAW_TEST_LOG"', 'if [[ "${1:-}" == "pnpm" && "${2:-}" == "--version" ]]; then', ' if grep -q "pnpm@11.2.2" package.json 2>/dev/null; then echo "11.2.2"; else echo "11.8.0"; fi', "fi", "", ].join("\n"), "utf8", ); chmodSync(path.join(toolsDir, "pnpm"), 0o755); chmodSync(path.join(toolsDir, "corepack"), 0o755); const result = runHelper(` set -euo pipefail ROOT_DIR=${JSON.stringify(tempRoot)} OPENCLAW_TEST_LOG=${JSON.stringify(logPath)} export OPENCLAW_TEST_LOG PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} cd ${JSON.stringify(outerRoot)} ${helperBlock} run_pnpm --version `); expect(result.status).toBe(0); expect(result.stdout).toBe("11.2.2\n"); expect(readFileSync(logPath, "utf8").trim().split("\n")).toEqual([ `corepack|${tempRoot}|pnpm --version`, `corepack|${tempRoot}|pnpm --version`, ]); }); it("fails with an actionable error when neither pnpm nor corepack pnpm is available", () => { const helperBlock = getPackageManagerHelperBlock(); const tempRoot = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-root-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-pnpm-tools-")); tempDirs.push(tempRoot, toolsDir); const result = runHelper(` set -euo pipefail ROOT_DIR=${JSON.stringify(tempRoot)} PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} ${helperBlock} run_pnpm build `); expect(result.status).toBe(1); expect(result.stderr).toContain("pnpm is not on PATH and corepack pnpm is unavailable"); }); it("runs Sparkle build metadata derivation from the repository root", () => { const helperBlock = getSparkleBuildHelperBlock(); const tempRoot = mkdtempSync(path.join(tmpdir(), "openclaw-package-sparkle-root-")); const toolsDir = mkdtempSync(path.join(tmpdir(), "openclaw-package-sparkle-tools-")); tempDirs.push(tempRoot, toolsDir); const nodePath = path.join(toolsDir, "node"); writeFileSync( nodePath, [ "#!/usr/bin/env bash", "set -euo pipefail", 'if [[ "$PWD" != "$OPENCLAW_ROOT" ]]; then', ' echo "node ran outside repo root: $PWD" >&2', " exit 1", "fi", "echo 2026060290", "", ].join("\n"), "utf8", ); chmodSync(nodePath, 0o755); const result = runHelper(` set -euo pipefail ROOT_DIR=${JSON.stringify(tempRoot)} OPENCLAW_ROOT=${JSON.stringify(tempRoot)} PATH=${JSON.stringify(`${toolsDir}:/usr/bin:/bin`)} export OPENCLAW_ROOT PATH cd /tmp ${helperBlock} sparkle_canonical_build_from_version 2026.6.2 `); expect(result.status).toBe(0); expect(result.stdout).toBe("2026060290\n"); expect(result.stderr).toBe(""); }); it("does not kill unrelated OpenClaw processes during packaging", () => { const script = readFileSync(scriptPath, "utf8"); const stopBlock = script.slice( script.indexOf("running_packaged_app_pids()"), script.indexOf('echo "🔏 Signing bundle'), ); expect(script).not.toContain("killall -q OpenClaw"); expect(stopBlock).toContain('local app_binary="$APP_ROOT/Contents/MacOS/OpenClaw"'); expect(stopBlock).toContain('pgrep -x "$PRODUCT"'); expect(stopBlock).toContain('grep -Fx "$app_binary"'); expect(stopBlock).toContain( '[[ "$command_line" == "$app_binary" || "$command_line" == "$app_binary "* ]]', ); }); it("fails when the packaged app survives forced shutdown", () => { const result = runStopPackagedAppHarness(0); expect(result.status).toBe(1); expect(result.stderr).toContain("ERROR: Packaged OpenClaw bundle did not exit: 123"); }); it("fails release packaging when the Swift compatibility library is missing", () => { const result = runSwiftCompatibilityHarness("release"); expect(result.status).toBe(1); expect(result.stderr).toContain("ERROR: Swift compatibility library not found"); }); it("allows debug packaging to continue without the Swift compatibility library", () => { const result = runSwiftCompatibilityHarness("debug"); expect(result.status).toBe(0); expect(result.stderr).toContain("WARN: Swift compatibility library not found"); }); it("passes when the packaged app exits after shutdown", () => { const result = runStopPackagedAppHarness(1); expect(result.status).toBe(0); expect(result.stderr).toBe(""); }); it("keeps mac packaging script checks in the macOS CI lane", () => { const pkg = JSON.parse(readFileSync("package.json", "utf8")) as { scripts?: Record; }; const macosCi = pkg.scripts?.["test:macos:ci"] ?? ""; expect(macosCi).toContain("test/scripts/package-mac-app.test.ts"); expect(macosCi).toContain("test/scripts/package-mac-dist.test.ts"); expect(macosCi).toContain("test/scripts/create-dmg.test.ts"); expect(macosCi).toContain("test/scripts/codesign-mac-app.test.ts"); expect(macosCi).toContain("test/scripts/notarize-mac-artifact.test.ts"); }); it("fails closed when required Swift resources are missing", () => { const script = readFileSync(scriptPath, "utf8"); const openClawKitBlock = script.slice( script.indexOf( 'OPENCLAWKIT_BUNDLE="$(build_path_for_arch "$PRIMARY_ARCH")/$BUILD_CONFIG/OpenClawKit_OpenClawKit.bundle"', ), script.indexOf('echo "📦 Copying Textual resources"'), ); expect(openClawKitBlock).toContain("ERROR: OpenClawKit resource bundle not found"); expect(openClawKitBlock).toContain("exit 1"); expect(openClawKitBlock).not.toContain("WARN:"); expect(openClawKitBlock).not.toContain("continuing"); }); it("does not mask required Info.plist stamp failures", () => { const script = readFileSync(scriptPath, "utf8"); const stampBlock = script.slice( script.indexOf("plist_set_string_required"), script.indexOf('echo "🚚 Copying binary"'), ); expect(stampBlock).toContain("plist_set_string_required"); expect(stampBlock).not.toContain("|| true"); }); it.runIf(process.platform === "darwin")( "sets required strings and fails when the plist cannot be stamped", () => { const plist = makePlist(); const result = runHelper(` set -euo pipefail source scripts/lib/plistbuddy.sh plist_set_string_required ${JSON.stringify(plist)} CFBundleIdentifier 'ai.openclaw.test' /usr/libexec/PlistBuddy -c 'Print :CFBundleIdentifier' ${JSON.stringify(plist)} broken="$(mktemp -d)" plist_set_string_required "$broken" CFBundleIdentifier broken `); expect(result.status).toBe(1); expect(result.stdout).toContain("ai.openclaw.test"); expect(result.stderr).toContain("Error Reading File"); }, ); it.runIf(process.platform === "darwin")("adds optional strings and booleans", () => { const plist = makePlist(); const result = runHelper(` set -euo pipefail source scripts/lib/plistbuddy.sh plist_set_or_add_string ${JSON.stringify(plist)} SUFeedURL '' plist_set_or_add_string ${JSON.stringify(plist)} SUPublicEDKey 'key"with\\\\slashes' plist_set_or_add_bool ${JSON.stringify(plist)} SUEnableAutomaticChecks false /usr/libexec/PlistBuddy -c 'Print :SUFeedURL' ${JSON.stringify(plist)} /usr/libexec/PlistBuddy -c 'Print :SUPublicEDKey' ${JSON.stringify(plist)} /usr/libexec/PlistBuddy -c 'Print :SUEnableAutomaticChecks' ${JSON.stringify(plist)} `); expect(result.status).toBe(0); expect(result.stdout).toContain('key"with\\\\slashes'); expect(result.stdout).toContain("false"); }); });