@sentry/wizard 4.8.0 → 4.9.0

package/dist/src/apple/macos-system-helper.d.ts

@@ -0,0 +1,5 @@
+export declare class MacOSSystemHelpers {
+    static findSDKRootDirectoryPath(): string | undefined;
+    static findDeveloperDirectoryPath(): string | undefined;
+    static readXcodeBuildSettings(projectPath: string): Record<string, string> | undefined;
+}

package/dist/src/apple/macos-system-helper.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MacOSSystemHelpers = void 0;
+const child_process_1 = require("child_process");
+const debug_1 = require("../utils/debug");
+class MacOSSystemHelpers {
+    static findSDKRootDirectoryPath() {
+        try {
+            // Some Candidates:
+            // - /Applications/Xcode-16.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk
+            // - /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk
+            const sdkPath = (0, child_process_1.execSync)('xcrun --show-sdk-path', {
+                encoding: 'utf8',
+            }).trim();
+            return sdkPath;
+        }
+        catch (error) {
+            (0, debug_1.debug)(`Failed to find SDK root directory path: ${error}`);
+            return undefined;
+        }
+    }
+    static findDeveloperDirectoryPath() {
+        try {
+            // Some Candidates:
+            // - /Applications/Xcode.app/Contents/Developer
+            // - /Applications/Xcode-16.3.0.app/Contents/Developer
+            const developerPath = (0, child_process_1.execSync)('xcode-select --print-path', {
+                encoding: 'utf8',
+            }).trim();
+            return developerPath;
+        }
+        catch (error) {
+            (0, debug_1.debug)(`Failed to find developer directory path: ${error}`);
+            return undefined;
+        }
+    }
+    static readXcodeBuildSettings(projectPath) {
+        try {
+            // The child_process.execSync() method is generally identical to exec with the exception that the method will not return until the child process has fully closed.
+            // When a timeout has been encountered and killSignal is sent, the method won't return until the process has completely exited.
+            // If the child process intercepts and handles the SIGTERMsignal and doesn't exit, the parent process will wait until the child process has exited.
+            //
+            // If the process times out or has a non-zero exit code, this method will throw.
+            // The Error object will contain the entire result from spawnSync.
+            //
+            // IMPORTANT:
+            //      Never pass unsanitized user input to this function.
+            //      Any input containing shell metacharacters may be used to trigger arbitrary command execution.
+            const output = (0, child_process_1.execSync)([
+                `xcodebuild`,
+                `-project`,
+                projectPath.replace(/\\/g, '\\\\').replace(/"/g, '\\"'),
+                `-showBuildSettings`,
+            ]
+                .map((arg) => `"${arg.trim()}"`)
+                .join(' '), {
+                encoding: 'utf8',
+            }).trim();
+            // --- Example Output: ---
+            // Command line invocation:
+            // /Applications/Xcode-16.3.0.app/Contents/Developer/usr/bin/xcodebuild -project ./fixtures/test-applications/apple/project-with-synchronized-folders/Project.xcodeproj -showBuildSettings
+            //
+            // Build settings for action build and target Project:
+            //     ACTION = build
+            //     ALLOW_BUILD_REQUEST_OVERRIDES = NO
+            //     ALLOW_TARGET_PLATFORM_SPECIALIZATION = YES
+            //     ALTERNATE_GROUP = staff
+            //     ...
+            const lines = output.split('\n');
+            const settings = {};
+            lines.forEach((line) => {
+                const match = line.match(/^\s*(\w+)\s+=\s+(.*)$/);
+                if (match) {
+                    settings[match[1]] = match[2];
+                }
+            });
+            return settings;
+        }
+        catch (error) {
+            (0, debug_1.debug)(`Failed to read Xcode build settings: ${error}`);
+            return undefined;
+        }
+    }
+}
+exports.MacOSSystemHelpers = MacOSSystemHelpers;
+//# sourceMappingURL=macos-system-helper.js.map

package/dist/src/apple/macos-system-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-system-helper.js","sourceRoot":"","sources":["../../../src/apple/macos-system-helper.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,0CAAuC;AAEvC,MAAa,kBAAkB;IAC7B,MAAM,CAAC,wBAAwB;QAC7B,IAAI;YACF,mBAAmB;YACnB,0GAA0G;YAC1G,wDAAwD;YACxD,MAAM,OAAO,GAAG,IAAA,wBAAQ,EAAC,uBAAuB,EAAE;gBAChD,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,OAAO,CAAC;SAChB;QAAC,OAAO,KAAK,EAAE;YACd,IAAA,aAAK,EAAC,2CAA2C,KAAe,EAAE,CAAC,CAAC;YACpE,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;IAED,MAAM,CAAC,0BAA0B;QAC/B,IAAI;YACF,mBAAmB;YACnB,+CAA+C;YAC/C,sDAAsD;YACtD,MAAM,aAAa,GAAG,IAAA,wBAAQ,EAAC,2BAA2B,EAAE;gBAC1D,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,aAAa,CAAC;SACtB;QAAC,OAAO,KAAK,EAAE;YACd,IAAA,aAAK,EAAC,4CAA4C,KAAe,EAAE,CAAC,CAAC;YACrE,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;IAED,MAAM,CAAC,sBAAsB,CAC3B,WAAmB;QAEnB,IAAI;YACF,kKAAkK;YAClK,+HAA+H;YAC/H,mJAAmJ;YACnJ,EAAE;YACF,gFAAgF;YAChF,kEAAkE;YAClE,EAAE;YACF,aAAa;YACb,2DAA2D;YAC3D,qGAAqG;YACrG,MAAM,MAAM,GAAG,IAAA,wBAAQ,EACrB;gBACE,YAAY;gBACZ,UAAU;gBACV,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;gBACvD,oBAAoB;aACrB;iBACE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;iBAC/B,IAAI,CAAC,GAAG,CAAC,EACZ;gBACE,QAAQ,EAAE,MAAM;aACjB,CACF,CAAC,IAAI,EAAE,CAAC;YACT,0BAA0B;YAC1B,2BAA2B;YAC3B,0LAA0L;YAC1L,EAAE;YACF,sDAAsD;YACtD,qBAAqB;YACrB,yCAAyC;YACzC,iDAAiD;YACjD,8BAA8B;YAC9B,UAAU;YACV,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,QAAQ,GAA2B,EAAE,CAAC;YAC5C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAClD,IAAI,KAAK,EAAE;oBACT,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;iBAC/B;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;SACjB;QAAC,OAAO,KAAK,EAAE;YACd,IAAA,aAAK,EAAC,wCAAwC,KAAe,EAAE,CAAC,CAAC;YACjE,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;CACF;AAnFD,gDAmFC","sourcesContent":["import { execSync } from 'child_process';\nimport { debug } from '../utils/debug';\n\nexport class MacOSSystemHelpers {\n  static findSDKRootDirectoryPath(): string | undefined {\n    try {\n      // Some Candidates:\n      // - /Applications/Xcode-16.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk\n      // - /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk\n      const sdkPath = execSync('xcrun --show-sdk-path', {\n        encoding: 'utf8',\n      }).trim();\n      return sdkPath;\n    } catch (error) {\n      debug(`Failed to find SDK root directory path: ${error as string}`);\n      return undefined;\n    }\n  }\n\n  static findDeveloperDirectoryPath(): string | undefined {\n    try {\n      // Some Candidates:\n      // - /Applications/Xcode.app/Contents/Developer\n      // - /Applications/Xcode-16.3.0.app/Contents/Developer\n      const developerPath = execSync('xcode-select --print-path', {\n        encoding: 'utf8',\n      }).trim();\n      return developerPath;\n    } catch (error) {\n      debug(`Failed to find developer directory path: ${error as string}`);\n      return undefined;\n    }\n  }\n\n  static readXcodeBuildSettings(\n    projectPath: string,\n  ): Record<string, string> | undefined {\n    try {\n      // The child_process.execSync() method is generally identical to exec with the exception that the method will not return until the child process has fully closed.\n      // When a timeout has been encountered and killSignal is sent, the method won't return until the process has completely exited.\n      // If the child process intercepts and handles the SIGTERMsignal and doesn't exit, the parent process will wait until the child process has exited.\n      //\n      // If the process times out or has a non-zero exit code, this method will throw.\n      // The Error object will contain the entire result from spawnSync.\n      //\n      // IMPORTANT:\n      //      Never pass unsanitized user input to this function.\n      //      Any input containing shell metacharacters may be used to trigger arbitrary command execution.\n      const output = execSync(\n        [\n          `xcodebuild`,\n          `-project`,\n          projectPath.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"'),\n          `-showBuildSettings`,\n        ]\n          .map((arg) => `\"${arg.trim()}\"`)\n          .join(' '),\n        {\n          encoding: 'utf8',\n        },\n      ).trim();\n      // --- Example Output: ---\n      // Command line invocation:\n      // /Applications/Xcode-16.3.0.app/Contents/Developer/usr/bin/xcodebuild -project ./fixtures/test-applications/apple/project-with-synchronized-folders/Project.xcodeproj -showBuildSettings\n      //\n      // Build settings for action build and target Project:\n      //     ACTION = build\n      //     ALLOW_BUILD_REQUEST_OVERRIDES = NO\n      //     ALLOW_TARGET_PLATFORM_SPECIALIZATION = YES\n      //     ALTERNATE_GROUP = staff\n      //     ...\n      const lines = output.split('\\n');\n      const settings: Record<string, string> = {};\n      lines.forEach((line) => {\n        const match = line.match(/^\\s*(\\w+)\\s+=\\s+(.*)$/);\n        if (match) {\n          settings[match[1]] = match[2];\n        }\n      });\n\n      return settings;\n    } catch (error) {\n      debug(`Failed to read Xcode build settings: ${error as string}`);\n      return undefined;\n    }\n  }\n}\n"]}

package/dist/src/apple/templates.js

@@ -14,6 +14,11 @@ function getSwiftSnippet(dsn) {
     return `        SentrySDK.start { options in
             options.dsn = "${dsn}"
             options.debug = true // Enabled debug when first installing is always helpful
+
+            // Adds IP for users.
+            // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
+            options.sendDefaultPii = true
+
             // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
             options.tracesSampleRate = 1.0
@@ -36,6 +41,11 @@ function getObjcSnippet(dsn) {
     return `    [SentrySDK startWithConfigureOptions:^(SentryOptions * options) {
         options.dsn = @"${dsn}";
         options.debug = YES; // Enabled debug when first installing is always helpful
+
+        // Adds IP for users.
+        // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
+        options.sendDefaultPii = YES;
+
         // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         options.tracesSampleRate = @1.0;

package/dist/src/apple/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/apple/templates.ts"],"names":[],"mappings":";;;AAAA,SAAgB,oBAAoB,CAClC,OAAe,EACf,WAAmB,EACnB,YAAqB,EACrB,mBAA4B;IAE5B,6CAA6C;IAC7C,MAAM,eAAe,GAAG,mBAAmB;QACzC,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,0FAA0F,eAAe,+DAA+D,OAAO,4BAA4B,WAAW,4CAC3N,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EACxC,2OAA2O,CAAC;AAC9O,CAAC;AAbD,oDAaC;AAEY,QAAA,eAAe,GAC1B,6FAA6F,CAAC;AAEhG,SAAgB,eAAe,CAAC,GAAW;IACzC,OAAO;6BACoB,GAAG;;;;;;;;;;;;;;;;;iEAiBiC,CAAC;AAClE,CAAC;AApBD,0CAoBC;AAED,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO;0BACiB,GAAG;;;;;;;;;;;;;;;;;2DAiB8B,CAAC;AAC5D,CAAC;AApBD,wCAoBC;AAED,SAAgB,kBAAkB,CAAC,GAAW,EAAE,OAAe;IAC7D,OAAO;mBACU,GAAG;uBACC,OAAO;;MAExB,CAAC;AACP,CAAC;AAND,gDAMC","sourcesContent":["export function getRunScriptTemplate(\n  orgSlug: string,\n  projectSlug: string,\n  uploadSource: boolean,\n  includeHomebrewPath: boolean,\n): string {\n  // eslint-disable-next-line no-useless-escape\n  const includeHomebrew = includeHomebrewPath\n    ? '\\\\nif [[ \"$(uname -m)\" == arm64 ]]; then\\\\nexport PATH=\"/opt/homebrew/bin:$PATH\"\\\\nfi'\n    : '';\n  return `# This script is responsible for uploading debug symbols and source context for Sentry.${includeHomebrew}\\\\nif which sentry-cli >/dev/null; then\\\\nexport SENTRY_ORG=${orgSlug}\\\\nexport SENTRY_PROJECT=${projectSlug}\\\\nERROR=$(sentry-cli debug-files upload ${\n    uploadSource ? '--include-sources ' : ''\n  }\"$DWARF_DSYM_FOLDER_PATH\" 2>&1 >/dev/null)\\\\nif [ ! $? -eq 0 ]; then\\\\necho \"warning: sentry-cli - $ERROR\"\\\\nfi\\\\nelse\\\\necho \"warning: sentry-cli not installed, download from https://github.com/getsentry/sentry-cli/releases\"\\\\nfi\\\\n`;\n}\n\nexport const scriptInputPath =\n  '\"${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}\"';\n\nexport function getSwiftSnippet(dsn: string): string {\n  return `        SentrySDK.start { options in\n            options.dsn = \"${dsn}\"\n            options.debug = true // Enabled debug when first installing is always helpful\n            // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.\n            // We recommend adjusting this value in production.\n            options.tracesSampleRate = 1.0\n\n            // Configure profiling. Visit https://docs.sentry.io/platforms/apple/profiling/ to learn more.\n            options.configureProfiling = {\n                $0.sessionSampleRate = 1.0 // We recommend adjusting this value in production.\n                $0.lifecycle = .trace\n            }\n\n            // Uncomment the following lines to add more data to your events\n            // options.attachScreenshot = true // This adds a screenshot to the error events\n            // options.attachViewHierarchy = true // This adds the view hierarchy to the error events\n        }\n        // Remove the next line after confirming that your Sentry integration is working.\n        SentrySDK.capture(message: \"This app uses Sentry! :)\")\\n`;\n}\n\nexport function getObjcSnippet(dsn: string): string {\n  return `    [SentrySDK startWithConfigureOptions:^(SentryOptions * options) {\n        options.dsn = @\"${dsn}\";\n        options.debug = YES; // Enabled debug when first installing is always helpful\n        // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.\n        // We recommend adjusting this value in production.\n        options.tracesSampleRate = @1.0;\n\n        // Configure profiling. Visit https://docs.sentry.io/platforms/apple/profiling/ to learn more.\n        options.configureProfiling = ^(SentryProfileOptions *profiling) {\n            profiling.sessionSampleRate = 1.0; // We recommend adjusting this value in production.\n            profiling.lifecycle = SentryProfilingLifecycleTrace;\n        };\n\n        //Uncomment the following lines to add more data to your events\n        //options.attachScreenshot = YES; //This will add a screenshot to the error events\n        //options.attachViewHierarchy = YES; //This will add the view hierarchy to the error events\n    }];\n    //Remove the next line after confirming that your Sentry integration is working.\n    [SentrySDK captureMessage:@\"This app uses Sentry!\"];\\n`;\n}\n\nexport function getFastlaneSnippet(org: string, project: string): string {\n  return `    sentry_cli(\n      org_slug: '${org}',\n      project_slug: '${project}',\n      include_sources: true\n    )`;\n}\n"]}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/apple/templates.ts"],"names":[],"mappings":";;;AAAA,SAAgB,oBAAoB,CAClC,OAAe,EACf,WAAmB,EACnB,YAAqB,EACrB,mBAA4B;IAE5B,6CAA6C;IAC7C,MAAM,eAAe,GAAG,mBAAmB;QACzC,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,0FAA0F,eAAe,+DAA+D,OAAO,4BAA4B,WAAW,4CAC3N,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EACxC,2OAA2O,CAAC;AAC9O,CAAC;AAbD,oDAaC;AAEY,QAAA,eAAe,GAC1B,6FAA6F,CAAC;AAEhG,SAAgB,eAAe,CAAC,GAAW;IACzC,OAAO;6BACoB,GAAG;;;;;;;;;;;;;;;;;;;;;;iEAsBiC,CAAC;AAClE,CAAC;AAzBD,0CAyBC;AAED,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO;0BACiB,GAAG;;;;;;;;;;;;;;;;;;;;;;2DAsB8B,CAAC;AAC5D,CAAC;AAzBD,wCAyBC;AAED,SAAgB,kBAAkB,CAAC,GAAW,EAAE,OAAe;IAC7D,OAAO;mBACU,GAAG;uBACC,OAAO;;MAExB,CAAC;AACP,CAAC;AAND,gDAMC","sourcesContent":["export function getRunScriptTemplate(\n  orgSlug: string,\n  projectSlug: string,\n  uploadSource: boolean,\n  includeHomebrewPath: boolean,\n): string {\n  // eslint-disable-next-line no-useless-escape\n  const includeHomebrew = includeHomebrewPath\n    ? '\\\\nif [[ \"$(uname -m)\" == arm64 ]]; then\\\\nexport PATH=\"/opt/homebrew/bin:$PATH\"\\\\nfi'\n    : '';\n  return `# This script is responsible for uploading debug symbols and source context for Sentry.${includeHomebrew}\\\\nif which sentry-cli >/dev/null; then\\\\nexport SENTRY_ORG=${orgSlug}\\\\nexport SENTRY_PROJECT=${projectSlug}\\\\nERROR=$(sentry-cli debug-files upload ${\n    uploadSource ? '--include-sources ' : ''\n  }\"$DWARF_DSYM_FOLDER_PATH\" 2>&1 >/dev/null)\\\\nif [ ! $? -eq 0 ]; then\\\\necho \"warning: sentry-cli - $ERROR\"\\\\nfi\\\\nelse\\\\necho \"warning: sentry-cli not installed, download from https://github.com/getsentry/sentry-cli/releases\"\\\\nfi\\\\n`;\n}\n\nexport const scriptInputPath =\n  '\"${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}\"';\n\nexport function getSwiftSnippet(dsn: string): string {\n  return `        SentrySDK.start { options in\n            options.dsn = \"${dsn}\"\n            options.debug = true // Enabled debug when first installing is always helpful\n\n            // Adds IP for users.\n            // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/\n            options.sendDefaultPii = true\n\n            // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.\n            // We recommend adjusting this value in production.\n            options.tracesSampleRate = 1.0\n\n            // Configure profiling. Visit https://docs.sentry.io/platforms/apple/profiling/ to learn more.\n            options.configureProfiling = {\n                $0.sessionSampleRate = 1.0 // We recommend adjusting this value in production.\n                $0.lifecycle = .trace\n            }\n\n            // Uncomment the following lines to add more data to your events\n            // options.attachScreenshot = true // This adds a screenshot to the error events\n            // options.attachViewHierarchy = true // This adds the view hierarchy to the error events\n        }\n        // Remove the next line after confirming that your Sentry integration is working.\n        SentrySDK.capture(message: \"This app uses Sentry! :)\")\\n`;\n}\n\nexport function getObjcSnippet(dsn: string): string {\n  return `    [SentrySDK startWithConfigureOptions:^(SentryOptions * options) {\n        options.dsn = @\"${dsn}\";\n        options.debug = YES; // Enabled debug when first installing is always helpful\n\n        // Adds IP for users.\n        // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/\n        options.sendDefaultPii = YES;\n\n        // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.\n        // We recommend adjusting this value in production.\n        options.tracesSampleRate = @1.0;\n\n        // Configure profiling. Visit https://docs.sentry.io/platforms/apple/profiling/ to learn more.\n        options.configureProfiling = ^(SentryProfileOptions *profiling) {\n            profiling.sessionSampleRate = 1.0; // We recommend adjusting this value in production.\n            profiling.lifecycle = SentryProfilingLifecycleTrace;\n        };\n\n        //Uncomment the following lines to add more data to your events\n        //options.attachScreenshot = YES; //This will add a screenshot to the error events\n        //options.attachViewHierarchy = YES; //This will add the view hierarchy to the error events\n    }];\n    //Remove the next line after confirming that your Sentry integration is working.\n    [SentrySDK captureMessage:@\"This app uses Sentry!\"];\\n`;\n}\n\nexport function getFastlaneSnippet(org: string, project: string): string {\n  return `    sentry_cli(\n      org_slug: '${org}',\n      project_slug: '${project}',\n      include_sources: true\n    )`;\n}\n"]}

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

@@ -1,14 +1,24 @@
 import type { SentryProjectData } from '../utils/types';
-import { type PBXGroup, type PBXObjects, type Project } from 'xcode';
-interface ProjectFile {
-    key: string;
-    path: string;
-}
+import { PBXSourcesBuildPhase, type PBXNativeTarget, type PBXObjects, type Project } from 'xcode';
+import { XcodeProjectObjectWithId } from './xcode-project-object-with-id';
 export declare class XcodeProject {
-    projectPath: string;
+    /**
+     * The directory where the Xcode project is located.
+     */
+    baseDir: string;
+    /**
+     * The path to the `<PROJECT>.xcodeproj` directory.
+     */
+    xcodeprojPath: string;
+    /**
+     * The path to the `project.pbxproj` file.
+     */
+    pbxprojPath: string;
+    /**
+     * The Xcode project object.
+     */
     project: Project;
     objects: PBXObjects;
-    files: ProjectFile[] | undefined;
     /**
      * Creates a new XcodeProject instance, a wrapper around the Xcode project file `<PROJECT>.xcodeproj/project.pbxproj`.
      *
@@ -17,8 +27,224 @@ export declare class XcodeProject {
     constructor(projectPath: string);
     getAllTargets(): string[];
     updateXcodeProject(sentryProject: SentryProjectData, target: string, addSPMReference: boolean, uploadSource?: boolean): void;
-    filesForTarget(target: string): string[] | undefined;
-    projectFiles(): ProjectFile[];
-    buildGroup(group: PBXGroup, path?: string): ProjectFile[];
+    /**
+     * 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.
+     *
+     * @param targetName - The name of the target to get files for
+     * @returns An array of absolute file paths for the target's source files, or undefined if target not found
+     */
+    getSourceFilesForTarget(targetName: string): string[] | undefined;
+    /**
+     * Finds a native target by name.
+     *
+     * @param targetName - The name of the target to find
+     * @returns The native target, or undefined if the target is not found
+     */
+    private findNativeTargetByName;
+    /**
+     * Finds the source build phase in a target.
+     *
+     * @param target - The target to find the source build phase in
+     * @returns The source build phase, or undefined if the target is not found or has no source build phase
+     */
+    findSourceBuildPhaseInTarget(target: PBXNativeTarget): XcodeProjectObjectWithId<PBXSourcesBuildPhase> | undefined;
+    /**
+     * Finds all files in the source build phase of a target.
+     *
+     * @param nativeTarget - The target to find the files in
+     * @returns The files in the source build phase of the target, or an empty array if the target is not found or has no source build phase
+     */
+    findFilesInSourceBuildPhase(nativeTarget: XcodeProjectObjectWithId<PBXNativeTarget>): string[];
+    /**
+     * Resolves the absolute path of a file reference.
+     *
+     * @param fileRef - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsolutePathOfFileReference;
+    /**
+     * Resolves the absolute path of a file reference relative to the parent group.
+     *
+     * @param fileRef - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsoluteFilePathRelativeToGroup;
+    /**
+     * Resolves the absolute path of a file reference relative to the built products directory.
+     *
+     * @param buildFile - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsoluteFilePathRelativeToBuiltProductsDir;
+    /**
+     * Resolves the absolute path of a file reference relative to the source root.
+     *
+     * The source root is the directory where the `.xcodeproj` file is located.
+     *
+     * @param buildFile - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsoluteFilePathRelativeToSourceRoot;
+    /**
+     * Resolves the absolute path of a file reference relative to the SDK root.
+     *
+     * @param buildFile - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsoluteFilePathRelativeToSdkRoot;
+    /**
+     * Resolves the absolute path of a file reference relative to the developer directory.
+     *
+     * @param buildFile - The file reference to resolve the path of
+     * @returns The absolute path of the file reference, or undefined if the file reference is not found or has no path
+     */
+    private resolveAbsoluteFilePathRelativeToDeveloperDir;
+    /**
+     * Resolves the absolute path of a group.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The absolute path of the group, or undefined if the group is not found or has no path
+     */
+    private resolveAbsolutePathOfGroup;
+    /**
+     * Resolves the path of a group relative to the parent group.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the parent group, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfGroupRelativeToGroup;
+    /**
+     * Resolves the path of a group relative to the source root.
+     *
+     * The source root is the directory where the `.xcodeproj` file is located.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the source root, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfGroupRelativeToSourceRoot;
+    /**
+     * Resolves the path of a group relative to the built products directory.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the built products directory, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfGroupRelativeToBuiltProductsDir;
+    /**
+     * Resolves the path of a group relative to the SDK root.
+     *
+     * The SDK root is the directory where the SDK is installed.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the SDK root, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfGroupRelativeToSdkRoot;
+    /**
+     * Resolves the path of a group relative to the developer directory.
+     *
+     * The developer directory is the directory where the Xcode command line tools are installed.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the developer directory, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfGroupRelativeToDeveloperDir;
+    /**
+     * Resolves the absolute path of a group.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The absolute path of the group, or undefined if the group is not found or has no path
+     */
+    private resolveAbsolutePathOfSynchronizedRootGroup;
+    /**
+     * Resolves the path of a group relative to the parent group.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the parent group, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfSynchronizedRootGroupRelativeToGroup;
+    /**
+     * Resolves the path of a group relative to the source root.
+     *
+     * The source root is the directory where the `.xcodeproj` file is located.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the source root, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfSynchronizedRootGroupRelativeToSourceRoot;
+    /**
+     * Resolves the path of a group relative to the built products directory.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the built products directory, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfSynchronizedRootGroupRelativeToBuiltProductsDir;
+    /**
+     * Resolves the path of a group relative to the SDK root.
+     *
+     * The SDK root is the directory where the SDK is installed.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the SDK root, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfSynchronizedRootGroupRelativeToSdkRoot;
+    /**
+     * Resolves the path of a group relative to the developer directory.
+     *
+     * The developer directory is the directory where the Xcode command line tools are installed.
+     *
+     * @param group - The group to resolve the path of
+     * @returns The path of the group relative to the developer directory, or undefined if the group is not found or has no path
+     */
+    private resolvePathOfSynchronizedRootGroupRelativeToDeveloperDir;
+    /**
+     * Finds all files in the synchronized root groups of a target.
+     *
+     * @param nativeTarget - The target to find the files in
+     * @returns The files in the synchronized root groups of the target, or an empty array if the target is not found or has no synchronized root groups
+     */
+    findFilesInSynchronizedRootGroups(nativeTarget: XcodeProjectObjectWithId<PBXNativeTarget>): string[];
+    private getFilesInSynchronizedRootGroup;
+    /**
+     * Returns all files in a directory tree.
+     *
+     * @param dirPath - The path of the directory to get the files in
+     * @returns All files in the directory tree, or an empty array if the directory does not exist
+     */
+    private getAbsoluteFilePathsInDirectoryTree;
+    private filterFilesByExceptionSets;
+    /**
+     * Returns all groups that are PBXGroup.
+     *
+     * This is a helper method to avoid having to map and filter the groups manually.
+     *
+     * @returns All groups that are PBXGroup, excluding comments and non-object values.
+     */
+    private get groups();
+    /**
+     * Finds the parent group of a child group or file reference.
+     *
+     * @param childId - The ID of the child group or file reference
+     * @returns The parent group of the child group or file reference, or undefined if the child group or file reference is not found or has no parent group
+     */
+    private findParentGroupByChildId;
+    /**
+     * Checks if a group is the main group of any project.
+     *
+     * @param groupId - The ID of the group to check
+     * @returns True if the group is the main group, false otherwise
+     */
+    private isMainGroup;
+    private getExceptionSetsForGroup;
+    /**
+     * The path to the build products directory for the project.
+     *
+     * This is cached to avoid having to read the build settings from Xcode for each call to `getBuildProductsDirectoryPath`.
+     */
+    private buildProductsDir;
+    /**
+     * Returns the path to the build products directory for the project.
+     *
+     * @returns The path to the build products directory for the project, or undefined if the path is not found
+     */
+    private getBuildProductsDirectoryPath;
 }
-export {};