openapi-sync 5.0.1 → 5.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -42,6 +42,8 @@ npm install -g openapi-sync
42
42
  npx openapi-sync
43
43
  ```
44
44
 
45
+ > ⚠️ **macOS Big Sur Users:** If you encounter an esbuild error (`Symbol not found: _SecTrustCopyCertificateChain`), install `esbuild@0.17.19` first. See [Troubleshooting](#troubleshooting) for details.
46
+
45
47
  ## Quick Start
46
48
 
47
49
  ### Option 1: Interactive Setup (Recommended) 🎯
@@ -337,6 +339,38 @@ For complete documentation including:
337
339
 
338
340
  ---
339
341
 
342
+ ## Troubleshooting
343
+
344
+ ### macOS Big Sur (11.x) - esbuild Installation Error
345
+
346
+ **Error:** `dyld: Symbol not found: _SecTrustCopyCertificateChain` when installing `openapi-sync`
347
+
348
+ **Cause:** The default esbuild version requires macOS 12.0+ APIs that aren't available in Big Sur.
349
+
350
+ **Solution:** Install a compatible esbuild version before installing openapi-sync:
351
+
352
+ ```bash
353
+ # Install compatible esbuild first
354
+ npm install esbuild@0.17.19
355
+
356
+ # Then install openapi-sync
357
+ npm install openapi-sync
358
+ ```
359
+
360
+ Alternatively, add an override to your `package.json`:
361
+
362
+ ```json
363
+ {
364
+ "overrides": {
365
+ "esbuild": "0.17.19"
366
+ }
367
+ }
368
+ ```
369
+
370
+ **Note:** This issue only affects macOS Big Sur (darwin 20.x). Users on macOS 12+ are not affected.
371
+
372
+ ---
373
+
340
374
  ## License
341
375
 
342
376
  ISC License - see [LICENSE](LICENSE) file for details.