@sentry/wizard 6.12.0 → 6.13.0

package/dist/src/apple/snapshots/snapshot-verification-scheme.js

@@ -0,0 +1,147 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSnapshotVerificationSchemeName = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const xml_js_1 = __importDefault(require("xml-js"));
+const debug_1 = require("../../utils/debug");
+const files_1 = require("../../utils/files");
+function resolveSnapshotVerificationSchemeName({ hostedTestTargetName, xcodeprojPath, }) {
+    const explicitSchemes = getExplicitSchemes(xcodeprojPath);
+    const matchingExplicitSchemes = explicitSchemes.filter((scheme) => scheme.testTargetNames.includes(hostedTestTargetName));
+    const matchingExplicitSchemeNames = uniqueStrings(matchingExplicitSchemes.map((scheme) => scheme.name));
+    if (matchingExplicitSchemeNames.length === 1) {
+        return matchingExplicitSchemeNames[0];
+    }
+    const managedSchemeNames = getManagedSchemeNames(xcodeprojPath);
+    if (managedSchemeNames.length === 1) {
+        return managedSchemeNames[0];
+    }
+    return undefined;
+}
+exports.resolveSnapshotVerificationSchemeName = resolveSnapshotVerificationSchemeName;
+function getExplicitSchemes(xcodeprojPath) {
+    return getSchemeFilePaths(xcodeprojPath).flatMap((schemePath) => {
+        const schemeName = path.basename(schemePath, '.xcscheme');
+        const testTargetNames = readSchemeTestTargetNames(schemePath);
+        return schemeName ? [{ name: schemeName, testTargetNames }] : [];
+    });
+}
+function getSchemeFilePaths(xcodeprojPath) {
+    return [
+        path.join(xcodeprojPath, 'xcshareddata', 'xcschemes'),
+        path.join(xcodeprojPath, 'xcuserdata'),
+    ].flatMap((schemeDirectory) => (0, files_1.findFilesWithExtension)(schemeDirectory, '.xcscheme'));
+}
+function readSchemeTestTargetNames(schemePath) {
+    const scheme = readXmlFile(schemePath);
+    if (!scheme) {
+        return [];
+    }
+    const testAction = getChild(getChild(scheme, 'Scheme'), 'TestAction');
+    const targetNames = new Set();
+    collectBlueprintNames(testAction, targetNames);
+    return [...targetNames];
+}
+function getManagedSchemeNames(xcodeprojPath) {
+    return uniqueStrings((0, files_1.findFilesWithName)(xcodeprojPath, 'xcschememanagement.plist').flatMap(readManagedSchemeNames));
+}
+function readManagedSchemeNames(plistPath) {
+    const plist = readXmlFile(plistPath);
+    if (!plist) {
+        return [];
+    }
+    const schemeNames = [];
+    collectElementText(plist, 'key').forEach((key) => {
+        const schemeName = parseManagedSchemeName(key);
+        if (schemeName) {
+            schemeNames.push(schemeName);
+        }
+    });
+    return schemeNames;
+}
+function parseManagedSchemeName(key) {
+    return /^(.+)\.xcscheme(?:_.+)?$/.exec(key)?.[1];
+}
+function readXmlFile(filePath) {
+    try {
+        return xml_js_1.default.xml2js(fs.readFileSync(filePath, 'utf8'), {
+            compact: true,
+        });
+    }
+    catch (error) {
+        (0, debug_1.debug)('Could not read XML file:', filePath, error);
+        return undefined;
+    }
+}
+function getChild(node, childName) {
+    return isRecord(node) ? node[childName] : undefined;
+}
+function collectBlueprintNames(node, targetNames) {
+    if (Array.isArray(node)) {
+        node.forEach((item) => collectBlueprintNames(item, targetNames));
+        return;
+    }
+    if (!isRecord(node)) {
+        return;
+    }
+    const attributes = node._attributes;
+    if (isRecord(attributes) && typeof attributes.BlueprintName === 'string') {
+        targetNames.add(attributes.BlueprintName);
+    }
+    Object.values(node).forEach((value) => collectBlueprintNames(value, targetNames));
+}
+function collectElementText(node, elementName) {
+    if (Array.isArray(node)) {
+        return node.flatMap((item) => collectElementText(item, elementName));
+    }
+    if (!isRecord(node)) {
+        return [];
+    }
+    return Object.entries(node).flatMap(([key, value]) => {
+        const childText = key === elementName ? collectTextValues(value) : [];
+        return childText.concat(collectElementText(value, elementName));
+    });
+}
+function collectTextValues(node) {
+    if (Array.isArray(node)) {
+        return node.flatMap(collectTextValues);
+    }
+    if (!isRecord(node)) {
+        return [];
+    }
+    return typeof node._text === 'string' ? [node._text] : [];
+}
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=snapshot-verification-scheme.js.map

package/dist/src/apple/snapshots/snapshot-verification-scheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-verification-scheme.js","sourceRoot":"","sources":["../../../../src/apple/snapshots/snapshot-verification-scheme.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport xml from 'xml-js';\n\nimport { debug } from '../../utils/debug';\nimport { findFilesWithExtension, findFilesWithName } from '../../utils/files';\n\ntype SnapshotVerificationSchemeOptions = {\n  hostedTestTargetName: string;\n  xcodeprojPath: string;\n};\n\ntype ExplicitScheme = {\n  name: string;\n  testTargetNames: string[];\n};\n\nexport function resolveSnapshotVerificationSchemeName({\n  hostedTestTargetName,\n  xcodeprojPath,\n}: SnapshotVerificationSchemeOptions): string | undefined {\n  const explicitSchemes = getExplicitSchemes(xcodeprojPath);\n  const matchingExplicitSchemes = explicitSchemes.filter((scheme) =>\n    scheme.testTargetNames.includes(hostedTestTargetName),\n  );\n  const matchingExplicitSchemeNames = uniqueStrings(\n    matchingExplicitSchemes.map((scheme) => scheme.name),\n  );\n  if (matchingExplicitSchemeNames.length === 1) {\n    return matchingExplicitSchemeNames[0];\n  }\n\n  const managedSchemeNames = getManagedSchemeNames(xcodeprojPath);\n  if (managedSchemeNames.length === 1) {\n    return managedSchemeNames[0];\n  }\n\n  return undefined;\n}\n\nfunction getExplicitSchemes(xcodeprojPath: string): ExplicitScheme[] {\n  return getSchemeFilePaths(xcodeprojPath).flatMap((schemePath) => {\n    const schemeName = path.basename(schemePath, '.xcscheme');\n    const testTargetNames = readSchemeTestTargetNames(schemePath);\n    return schemeName ? [{ name: schemeName, testTargetNames }] : [];\n  });\n}\n\nfunction getSchemeFilePaths(xcodeprojPath: string): string[] {\n  return [\n    path.join(xcodeprojPath, 'xcshareddata', 'xcschemes'),\n    path.join(xcodeprojPath, 'xcuserdata'),\n  ].flatMap((schemeDirectory) =>\n    findFilesWithExtension(schemeDirectory, '.xcscheme'),\n  );\n}\n\nfunction readSchemeTestTargetNames(schemePath: string): string[] {\n  const scheme = readXmlFile(schemePath);\n  if (!scheme) {\n    return [];\n  }\n\n  const testAction = getChild(getChild(scheme, 'Scheme'), 'TestAction');\n  const targetNames = new Set<string>();\n  collectBlueprintNames(testAction, targetNames);\n  return [...targetNames];\n}\n\nfunction getManagedSchemeNames(xcodeprojPath: string): string[] {\n  return uniqueStrings(\n    findFilesWithName(xcodeprojPath, 'xcschememanagement.plist').flatMap(\n      readManagedSchemeNames,\n    ),\n  );\n}\n\nfunction readManagedSchemeNames(plistPath: string): string[] {\n  const plist = readXmlFile(plistPath);\n  if (!plist) {\n    return [];\n  }\n\n  const schemeNames: string[] = [];\n  collectElementText(plist, 'key').forEach((key) => {\n    const schemeName = parseManagedSchemeName(key);\n    if (schemeName) {\n      schemeNames.push(schemeName);\n    }\n  });\n  return schemeNames;\n}\n\nfunction parseManagedSchemeName(key: string): string | undefined {\n  return /^(.+)\\.xcscheme(?:_.+)?$/.exec(key)?.[1];\n}\n\nfunction readXmlFile(filePath: string): unknown | undefined {\n  try {\n    return xml.xml2js(fs.readFileSync(filePath, 'utf8'), {\n      compact: true,\n    });\n  } catch (error) {\n    debug('Could not read XML file:', filePath, error);\n    return undefined;\n  }\n}\n\nfunction getChild(node: unknown, childName: string): unknown {\n  return isRecord(node) ? node[childName] : undefined;\n}\n\nfunction collectBlueprintNames(node: unknown, targetNames: Set<string>): void {\n  if (Array.isArray(node)) {\n    node.forEach((item) => collectBlueprintNames(item, targetNames));\n    return;\n  }\n\n  if (!isRecord(node)) {\n    return;\n  }\n\n  const attributes = node._attributes;\n  if (isRecord(attributes) && typeof attributes.BlueprintName === 'string') {\n    targetNames.add(attributes.BlueprintName);\n  }\n\n  Object.values(node).forEach((value) =>\n    collectBlueprintNames(value, targetNames),\n  );\n}\n\nfunction collectElementText(node: unknown, elementName: string): string[] {\n  if (Array.isArray(node)) {\n    return node.flatMap((item) => collectElementText(item, elementName));\n  }\n\n  if (!isRecord(node)) {\n    return [];\n  }\n\n  return Object.entries(node).flatMap(([key, value]) => {\n    const childText = key === elementName ? collectTextValues(value) : [];\n    return childText.concat(collectElementText(value, elementName));\n  });\n}\n\nfunction collectTextValues(node: unknown): string[] {\n  if (Array.isArray(node)) {\n    return node.flatMap(collectTextValues);\n  }\n\n  if (!isRecord(node)) {\n    return [];\n  }\n\n  return typeof node._text === 'string' ? [node._text] : [];\n}\n\nfunction uniqueStrings(values: string[]): string[] {\n  return [...new Set(values)];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"]}

package/dist/src/apple/snapshots/snapshotpreviews-package.d.ts

@@ -0,0 +1,4 @@
+export declare const SNAPSHOTPREVIEWS_PACKAGE_URL = "https://github.com/getsentry/SnapshotPreviews";
+export declare const SNAPSHOTPREVIEWS_MINIMUM_VERSION = "0.17.0";
+export declare const SNAPSHOTPREVIEWS_SNAPSHOT_TESTS_PRODUCT = "SnapshottingTests";
+export declare const SNAPSHOTPREVIEWS_PREFERENCES_PRODUCT = "SnapshotPreferences";

package/dist/src/apple/snapshots/snapshotpreviews-package.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SNAPSHOTPREVIEWS_PREFERENCES_PRODUCT = exports.SNAPSHOTPREVIEWS_SNAPSHOT_TESTS_PRODUCT = exports.SNAPSHOTPREVIEWS_MINIMUM_VERSION = exports.SNAPSHOTPREVIEWS_PACKAGE_URL = void 0;
+exports.SNAPSHOTPREVIEWS_PACKAGE_URL = 'https://github.com/getsentry/SnapshotPreviews';
+exports.SNAPSHOTPREVIEWS_MINIMUM_VERSION = '0.17.0';
+exports.SNAPSHOTPREVIEWS_SNAPSHOT_TESTS_PRODUCT = 'SnapshottingTests';
+exports.SNAPSHOTPREVIEWS_PREFERENCES_PRODUCT = 'SnapshotPreferences';
+//# sourceMappingURL=snapshotpreviews-package.js.map

package/dist/src/apple/snapshots/snapshotpreviews-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotpreviews-package.js","sourceRoot":"","sources":["../../../../src/apple/snapshots/snapshotpreviews-package.ts"],"names":[],"mappings":";;;AAAa,QAAA,4BAA4B,GACvC,+CAA+C,CAAC;AAErC,QAAA,gCAAgC,GAAG,QAAQ,CAAC;AAE5C,QAAA,uCAAuC,GAAG,mBAAmB,CAAC;AAE9D,QAAA,oCAAoC,GAAG,qBAAqB,CAAC","sourcesContent":["export const SNAPSHOTPREVIEWS_PACKAGE_URL =\n  'https://github.com/getsentry/SnapshotPreviews';\n\nexport const SNAPSHOTPREVIEWS_MINIMUM_VERSION = '0.17.0';\n\nexport const SNAPSHOTPREVIEWS_SNAPSHOT_TESTS_PRODUCT = 'SnapshottingTests';\n\nexport const SNAPSHOTPREVIEWS_PREFERENCES_PRODUCT = 'SnapshotPreferences';\n"]}

package/dist/src/apple/snapshots/snapshots-cli-preflight.d.ts

@@ -0,0 +1,23 @@
+type SnapshotVerificationGuidance = {
+    appId?: string;
+    hostedTestTargetName: string;
+    projectDir: string;
+    projectPath: string;
+    schemeName?: string;
+    snapshotTestClassName: string;
+};
+export declare function checkInstalledCLISnapshots({ projectDir, nonInteractive, verificationGuidance, }: {
+    projectDir: string;
+    nonInteractive: boolean;
+    verificationGuidance: SnapshotVerificationGuidance;
+}): Promise<void>;
+export declare function getSnapshotFastlaneGuidance(projectDir: string): {
+    hasUploadLane: boolean;
+    hasSentryUploadAction: boolean;
+    fastfilePath?: undefined;
+} | {
+    fastfilePath: string;
+    hasUploadLane: boolean;
+    hasSentryUploadAction: boolean;
+};
+export {};

package/dist/src/apple/snapshots/snapshots-cli-preflight.js

@@ -0,0 +1,136 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSnapshotFastlaneGuidance = exports.checkInstalledCLISnapshots = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+// @ts-expect-error - clack is ESM and TS complains about that. It works though
+const prompts_1 = __importDefault(require("@clack/prompts"));
+const Sentry = __importStar(require("@sentry/node"));
+const bash = __importStar(require("../../utils/bash"));
+const check_installed_cli_1 = require("../check-installed-cli");
+const fastlane = __importStar(require("../fastlane"));
+async function checkInstalledCLISnapshots({ projectDir, nonInteractive, verificationGuidance, }) {
+    const hasCli = await (0, check_installed_cli_1.checkInstalledCLI)("Without sentry-cli, you won't be able to upload snapshots to Sentry. You can install it later by following the instructions at https://docs.sentry.io/cli/", nonInteractive);
+    if (hasCli) {
+        verifySnapshotsUploadCommand();
+    }
+    printSnapshotsUploadGuidance({
+        fastlaneGuidance: getSnapshotFastlaneGuidance(projectDir),
+        verificationGuidance,
+    });
+}
+exports.checkInstalledCLISnapshots = checkInstalledCLISnapshots;
+function getSnapshotFastlaneGuidance(projectDir) {
+    const fastfilePath = fastlane.fastFile(projectDir) ?? undefined;
+    if (!fastfilePath) {
+        return {
+            hasUploadLane: false,
+            hasSentryUploadAction: false,
+        };
+    }
+    let contents;
+    try {
+        contents = fs.readFileSync(fastfilePath, 'utf8');
+    }
+    catch {
+        prompts_1.default.log.warn(`Could not read the Fastfile at ${fastfilePath}. Skipping Fastlane snapshots upload detection.`);
+        return {
+            hasUploadLane: false,
+            hasSentryUploadAction: false,
+        };
+    }
+    return {
+        fastfilePath,
+        hasUploadLane: /lane\s+:upload_sentry_snapshots\b/.test(contents),
+        hasSentryUploadAction: /\bsentry_upload_snapshots\s*\(/.test(contents),
+    };
+}
+exports.getSnapshotFastlaneGuidance = getSnapshotFastlaneGuidance;
+function verifySnapshotsUploadCommand() {
+    try {
+        bash.executeSync('sentry-cli snapshots upload --help');
+        Sentry.setTag('sentry-cli-snapshots-upload', true);
+        prompts_1.default.log.success('sentry-cli snapshots upload is available.');
+    }
+    catch {
+        Sentry.setTag('sentry-cli-snapshots-upload', false);
+        prompts_1.default.log.warn('sentry-cli is installed, but this version does not expose `sentry-cli snapshots upload`. Please update sentry-cli before uploading snapshots.');
+    }
+}
+function printSnapshotsUploadGuidance({ fastlaneGuidance, verificationGuidance, }) {
+    if (fastlaneGuidance.fastfilePath && fastlaneGuidance.hasUploadLane) {
+        prompts_1.default.log.info([
+            'Detected existing Fastlane snapshots upload support.',
+            buildSnapshotExportCommand(verificationGuidance),
+            'Then verify upload with:',
+            'bundle exec fastlane ios upload_sentry_snapshots path: "$PWD/snapshot-images"',
+        ].join('\n'));
+        return;
+    }
+    if (fastlaneGuidance.fastfilePath && fastlaneGuidance.hasSentryUploadAction) {
+        prompts_1.default.log.info([
+            'Detected a Fastlane lane that calls sentry_upload_snapshots.',
+            'After exporting snapshots, run that existing lane with your snapshot image path.',
+            'If you are unsure which lane to use, fall back to sentry-cli snapshots upload below.',
+        ].join('\n'));
+    }
+    prompts_1.default.log.info([
+        buildSnapshotExportCommand(verificationGuidance),
+        '',
+        'After SnapshotPreviews exports images, verify local upload with:',
+        'sentry-cli snapshots upload "$PWD/snapshot-images" \\',
+        '  --org your-org \\',
+        '  --project your-ios-project \\',
+        verificationGuidance.appId
+            ? `  --app-id ${verificationGuidance.appId}`
+            : '  --app-id YOUR_APP_BUNDLE_ID # replace with your app bundle identifier',
+        '',
+        'Auth comes from SENTRY_AUTH_TOKEN or --auth-token. CI workflow setup is documented at https://docs.sentry.io/platforms/apple/snapshots/#step-3-integrate-into-ci; this wizard does not write workflow files.',
+    ].join('\n'));
+}
+function buildSnapshotExportCommand(guidance) {
+    return [
+        `From ${quoteShell(guidance.projectDir)}, export snapshots with:`,
+        'TEST_RUNNER_SNAPSHOTS_EXPORT_DIR="$PWD/snapshot-images" \\',
+        'xcodebuild test \\',
+        `  -project ${quoteShell(path.relative(guidance.projectDir, guidance.projectPath) ||
+            guidance.projectPath)} \\`,
+        `  -scheme ${guidance.schemeName ? quoteShell(guidance.schemeName) : '<scheme>'} \\`,
+        "  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' \\",
+        `  -only-testing:${quoteShell(`${guidance.hostedTestTargetName}/${guidance.snapshotTestClassName}`)} \\`,
+        '  CODE_SIGNING_ALLOWED=NO \\',
+        '  | xcpretty',
+    ].join('\n');
+}
+function quoteShell(value) {
+    return /^[A-Za-z0-9_./:-]+$/.test(value)
+        ? value
+        : `'${value.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=snapshots-cli-preflight.js.map

package/dist/src/apple/snapshots/snapshots-cli-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots-cli-preflight.js","sourceRoot":"","sources":["../../../../src/apple/snapshots/snapshots-cli-preflight.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n// @ts-expect-error - clack is ESM and TS complains about that. It works though\nimport clack from '@clack/prompts';\nimport * as Sentry from '@sentry/node';\nimport * as bash from '../../utils/bash';\nimport { checkInstalledCLI } from '../check-installed-cli';\nimport * as fastlane from '../fastlane';\n\ntype SnapshotVerificationGuidance = {\n  appId?: string;\n  hostedTestTargetName: string;\n  projectDir: string;\n  projectPath: string;\n  schemeName?: string;\n  snapshotTestClassName: string;\n};\n\nexport async function checkInstalledCLISnapshots({\n  projectDir,\n  nonInteractive,\n  verificationGuidance,\n}: {\n  projectDir: string;\n  nonInteractive: boolean;\n  verificationGuidance: SnapshotVerificationGuidance;\n}): Promise<void> {\n  const hasCli = await checkInstalledCLI(\n    \"Without sentry-cli, you won't be able to upload snapshots to Sentry. You can install it later by following the instructions at https://docs.sentry.io/cli/\",\n    nonInteractive,\n  );\n\n  if (hasCli) {\n    verifySnapshotsUploadCommand();\n  }\n\n  printSnapshotsUploadGuidance({\n    fastlaneGuidance: getSnapshotFastlaneGuidance(projectDir),\n    verificationGuidance,\n  });\n}\n\nexport function getSnapshotFastlaneGuidance(projectDir: string) {\n  const fastfilePath = fastlane.fastFile(projectDir) ?? undefined;\n  if (!fastfilePath) {\n    return {\n      hasUploadLane: false,\n      hasSentryUploadAction: false,\n    };\n  }\n\n  let contents: string;\n  try {\n    contents = fs.readFileSync(fastfilePath, 'utf8');\n  } catch {\n    clack.log.warn(\n      `Could not read the Fastfile at ${fastfilePath}. Skipping Fastlane snapshots upload detection.`,\n    );\n    return {\n      hasUploadLane: false,\n      hasSentryUploadAction: false,\n    };\n  }\n\n  return {\n    fastfilePath,\n    hasUploadLane: /lane\\s+:upload_sentry_snapshots\\b/.test(contents),\n    hasSentryUploadAction: /\\bsentry_upload_snapshots\\s*\\(/.test(contents),\n  };\n}\n\nfunction verifySnapshotsUploadCommand(): void {\n  try {\n    bash.executeSync('sentry-cli snapshots upload --help');\n    Sentry.setTag('sentry-cli-snapshots-upload', true);\n    clack.log.success('sentry-cli snapshots upload is available.');\n  } catch {\n    Sentry.setTag('sentry-cli-snapshots-upload', false);\n    clack.log.warn(\n      'sentry-cli is installed, but this version does not expose `sentry-cli snapshots upload`. Please update sentry-cli before uploading snapshots.',\n    );\n  }\n}\n\nfunction printSnapshotsUploadGuidance({\n  fastlaneGuidance,\n  verificationGuidance,\n}: {\n  fastlaneGuidance: ReturnType<typeof getSnapshotFastlaneGuidance>;\n  verificationGuidance: SnapshotVerificationGuidance;\n}): void {\n  if (fastlaneGuidance.fastfilePath && fastlaneGuidance.hasUploadLane) {\n    clack.log.info(\n      [\n        'Detected existing Fastlane snapshots upload support.',\n        buildSnapshotExportCommand(verificationGuidance),\n        'Then verify upload with:',\n        'bundle exec fastlane ios upload_sentry_snapshots path: \"$PWD/snapshot-images\"',\n      ].join('\\n'),\n    );\n    return;\n  }\n\n  if (fastlaneGuidance.fastfilePath && fastlaneGuidance.hasSentryUploadAction) {\n    clack.log.info(\n      [\n        'Detected a Fastlane lane that calls sentry_upload_snapshots.',\n        'After exporting snapshots, run that existing lane with your snapshot image path.',\n        'If you are unsure which lane to use, fall back to sentry-cli snapshots upload below.',\n      ].join('\\n'),\n    );\n  }\n\n  clack.log.info(\n    [\n      buildSnapshotExportCommand(verificationGuidance),\n      '',\n      'After SnapshotPreviews exports images, verify local upload with:',\n      'sentry-cli snapshots upload \"$PWD/snapshot-images\" \\\\',\n      '  --org your-org \\\\',\n      '  --project your-ios-project \\\\',\n      verificationGuidance.appId\n        ? `  --app-id ${verificationGuidance.appId}`\n        : '  --app-id YOUR_APP_BUNDLE_ID # replace with your app bundle identifier',\n      '',\n      'Auth comes from SENTRY_AUTH_TOKEN or --auth-token. CI workflow setup is documented at https://docs.sentry.io/platforms/apple/snapshots/#step-3-integrate-into-ci; this wizard does not write workflow files.',\n    ].join('\\n'),\n  );\n}\n\nfunction buildSnapshotExportCommand(\n  guidance: SnapshotVerificationGuidance,\n): string {\n  return [\n    `From ${quoteShell(guidance.projectDir)}, export snapshots with:`,\n    'TEST_RUNNER_SNAPSHOTS_EXPORT_DIR=\"$PWD/snapshot-images\" \\\\',\n    'xcodebuild test \\\\',\n    `  -project ${quoteShell(\n      path.relative(guidance.projectDir, guidance.projectPath) ||\n        guidance.projectPath,\n    )} \\\\`,\n    `  -scheme ${\n      guidance.schemeName ? quoteShell(guidance.schemeName) : '<scheme>'\n    } \\\\`,\n    \"  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' \\\\\",\n    `  -only-testing:${quoteShell(\n      `${guidance.hostedTestTargetName}/${guidance.snapshotTestClassName}`,\n    )} \\\\`,\n    '  CODE_SIGNING_ALLOWED=NO \\\\',\n    '  | xcpretty',\n  ].join('\\n');\n}\n\nfunction quoteShell(value: string): string {\n  return /^[A-Za-z0-9_./:-]+$/.test(value)\n    ? value\n    : `'${value.replace(/'/g, \"'\\\\''\")}'`;\n}\n"]}

package/dist/src/apple/xcode-manager.d.ts

@@ -1,6 +1,23 @@
 import type { SentryProjectData } from '../utils/types';
 import { PBXSourcesBuildPhase, type PBXNativeTarget, type PBXObjects, type Project } from 'xcode';
 import { XcodeProjectObjectWithId } from './xcode-project-object-with-id';
+export type SwiftPackageSpec = {
+    repositoryURL: string;
+    requirement: {
+        kind: 'upToNextMajorVersion';
+        minimumVersion: string;
+    };
+    commentName: string;
+};
+export type SwiftPackageProductSpec = {
+    package: SwiftPackageSpec;
+    productName: string;
+};
+export type SwiftPackageProductLinkOptions = {
+    product: SwiftPackageProductSpec;
+    existingFrameworkComment?: string;
+    successMessage?: string;
+};
 export declare class XcodeProject {
     /**
      * The directory where the Xcode project is located.
@@ -26,12 +43,38 @@ export declare class XcodeProject {
      */
     constructor(projectPath: string);
     getAllTargets(): string[];
-    updateXcodeProject(sentryProject: SentryProjectData, target: string, addSPMReference: boolean, uploadSource?: boolean): void;
+    getUnitTestTargetNames(): string[];
+    getHostedUnitTestTargetNames(): string[];
+    getHostedUnitTestTargetNamesForApplicationTarget(appTargetName: string): string[];
+    getBundleIdentifierForTarget(targetName: string): string | undefined;
+    /**
+     * Idempotently links a Swift package product to one target dependency list
+     * and Frameworks build phase. Returns whether the pbxproj graph changed and
+     * whether the product is linked after the operation.
+     */
+    ensureSwiftPackageProductLinked(targetName: string, product: SwiftPackageProductSpec): {
+        changed: boolean;
+        linked: boolean;
+    };
+    updateXcodeProject(sentryProject: SentryProjectData, target: string, swiftPackageProduct?: SwiftPackageProductLinkOptions, uploadSource?: boolean): void;
     addUploadSymbolsScript({ sentryProject, targetName, uploadSource, }: {
         sentryProject: SentryProjectData;
         targetName: string;
         uploadSource: boolean;
     }): void;
+    write(): void;
+    getSynchronizedRootGroupPathsForTarget(targetName: string): string[];
+    /**
+     * Ensures a Swift file is compiled by a target, either through an Xcode
+     * synchronized root group or an explicit Sources build phase entry.
+     */
+    addSwiftSourceFileToTarget(args: {
+        targetName: string;
+        filePath: string;
+    }): {
+        changed: boolean;
+        included: boolean;
+    };
     /**
      * Retrieves all source files associated with a specific target in the Xcode project.
      * This is used to find files where we can inject Sentry initialization code.
@@ -40,6 +83,21 @@ export declare class XcodeProject {
      * @returns An array of absolute file paths for the target's source files, or undefined if target not found
      */
     getSourceFilesForTarget(targetName: string): string[] | undefined;
+    private isUnitTestTargetEntry;
+    private getTargetBuildSettings;
+    private getApplicationHostCandidates;
+    private getProductReferencePath;
+    private hasFrameworkBuildFileCommentInTarget;
+    private ensureSwiftPackageReference;
+    private ensureProjectSwiftPackageReference;
+    private ensureSwiftPackageProductDependency;
+    private ensureFrameworksBuildFile;
+    private findFrameworksBuildPhaseInTarget;
+    private swiftPackageReferenceComment;
+    private isFileIncludedBySynchronizedRootGroup;
+    private ensureSwiftFileReference;
+    private addFileReferenceToBestGroup;
+    private get mainGroup();
     /**
      * Finds a native target by name.
      *