@appium/coresim 1.14.0 → 1.14.1

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.14.1](https://github.com/appium/appium-ios/compare/@appium/coresim@1.14.0...@appium/coresim@1.14.1) (2026-11-06)
+
+### Bug Fixes
+
+* **coresim:** include the failure reason and underlying errors in operation errors ([#163](https://github.com/appium/appium-ios/issues/163)) ([0032a91](https://github.com/appium/appium-ios/commit/0032a918d11d6d883f2896b907b0fbca2a734353))
+
+
 ## [1.14.0](https://github.com/appium/appium-ios/compare/@appium/coresim@1.13.2...@appium/coresim@1.14.0) (2026-10-24)
 
 ### Features

package/lib/src/errors.d.ts

@@ -40,7 +40,7 @@ export declare class NativeSimOperationError extends NativeSimError {
     readonly code: number;
     name: string;
     /**
-     * @param message — `NSError.localizedDescription`
+     * @param message — `NSError.localizedDescription`, followed by its failure reason and underlying errors
      * @param domain — `NSError.domain`
      * @param code — `NSError.code`
      */

package/lib/src/errors.js

@@ -51,7 +51,7 @@ export class NativeSimOperationError extends NativeSimError {
     code;
     name = 'NativeSimOperationError';
     /**
-     * @param message — `NSError.localizedDescription`
+     * @param message — `NSError.localizedDescription`, followed by its failure reason and underlying errors
      * @param domain — `NSError.domain`
      * @param code — `NSError.code`
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appium/coresim",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "description": "Native bindings to CoreSimulator.framework for Apple platform simulator control",
   "bugs": {
     "url": "https://github.com/appium/appium-ios/issues"
@@ -62,5 +62,5 @@
     "npm": ">=10"
   },
   "gypfile": true,
-  "gitHead": "1e3ecf666350a1868a196e84bf09cc1fe116cc4a"
+  "gitHead": "90882926f5dd3e4d34a056312f05787d513d0fd5"
 }

package/src/errors.ts

@@ -55,7 +55,7 @@ export class NativeSimOperationError extends NativeSimError {
   public override name = 'NativeSimOperationError';
 
   /**
-   * @param message — `NSError.localizedDescription`
+   * @param message — `NSError.localizedDescription`, followed by its failure reason and underlying errors
    * @param domain — `NSError.domain`
    * @param code — `NSError.code`
    */

package/src/native/nserror_bridge.h

@@ -11,6 +11,10 @@
 
 namespace coresim {
 
+// localizedDescription is often generic ("Simulator device failed to install the application."), so
+// the failure reason and the NSUnderlyingErrorKey chain are appended.
+std::string DescribeNSError(NSError* error);
+
 // Thrown by async work lambdas (see async_bridge.h) when a native call fails via an NSError**
 // out-param rather than raising. domain/code/message are captured immediately at throw time
 // (never the NSError* itself), since this only ever needs to survive within the same background
@@ -18,7 +22,7 @@ namespace coresim {
 class NSErrorException : public std::runtime_error {
  public:
   explicit NSErrorException(NSError* error)
-      : std::runtime_error(error.localizedDescription ? error.localizedDescription.UTF8String : "Operation failed"),
+      : std::runtime_error(DescribeNSError(error)),
         domain(error.domain ? error.domain.UTF8String : ""),
         code(error.code) {}
 

package/src/native/nserror_bridge.mm

@@ -2,6 +2,36 @@
 
 namespace coresim {
 
+std::string DescribeNSError(NSError* error) {
+  constexpr NSUInteger kMaxErrorDepth = 10;
+  NSMutableArray<NSString*>* parts = [NSMutableArray array];
+  NSError* current = error;
+  for (NSUInteger depth = 0; current != nil && depth < kMaxErrorDepth; ++depth) {
+    for (NSString* text in @[ current.localizedDescription ?: @"", current.localizedFailureReason ?: @"" ]) {
+      NSString* trimmed = [text stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceAndNewlineCharacterSet];
+      NSUInteger known = [parts indexOfObjectPassingTest:^BOOL(NSString* part, NSUInteger, BOOL*) {
+        return [part containsString:trimmed];
+      }];
+      if (trimmed.length == 0 || known != NSNotFound) {
+        continue;
+      }
+      NSIndexSet* covered = [parts indexesOfObjectsPassingTest:^BOOL(NSString* part, NSUInteger, BOOL*) {
+        return [trimmed containsString:part];
+      }];
+      [parts removeObjectsAtIndexes:covered];
+      [parts addObject:trimmed];
+    }
+    id underlying = current.userInfo[NSUnderlyingErrorKey];
+    current = [underlying isKindOfClass:NSError.class] ? underlying : nil;
+  }
+  NSMutableArray<NSString*>* sentences = [NSMutableArray arrayWithCapacity:parts.count];
+  for (NSString* part in parts) {
+    BOOL terminated = [part hasSuffix:@"."] || [part hasSuffix:@"!"] || [part hasSuffix:@"?"];
+    [sentences addObject:terminated ? part : [part stringByAppendingString:@"."]];
+  }
+  return sentences.count > 0 ? [sentences componentsJoinedByString:@" "].UTF8String : "Operation failed";
+}
+
 Napi::Error NSErrorExceptionToJsError(Napi::Env env, const NSErrorException& error) {
   Napi::Error jsError = Napi::Error::New(env, error.what());
   jsError.Set("name", "NativeSimOperationError");