crowdplaysdk 0.6.2 → 0.6.3

package/README.md

@@ -97,7 +97,7 @@ Bare React Native (no Expo):
 npm install crowdplaysdk
 cd ios && pod install
 gem install xcodeproj --user-install              # one time
-ruby node_modules/crowdplaysdk/ios/wire.rb <YourProjectName>
+ruby ../node_modules/crowdplaysdk/ios/wire.rb <YourProjectName>   # from ios/
 ```
 
 `wire.rb` is idempotent. It adds the compiled CrowdPlaySDK Swift package,
@@ -107,6 +107,18 @@ keeps explicit Swift modules on for the app target (React Native 0.8x turns
 them off project-wide on Xcode 26, which breaks importing the compiled
 engine). There is no CocoaPod of our own, so your Podfile stays untouched.
 
+**Updating.** `npm install crowdplaysdk@latest`, then wire again so the
+engine moves with the bridge: Expo, `npx expo prebuild` (or a build that
+runs prebuild; an `ios/` folder committed to git is not re-wired by
+`eas build`, so run prebuild yourself and commit the result); bare React
+Native, re-run `wire.rb`. Since 0.6.3 that also re-pins the engine to the
+version this package ships with. 0.6.2 and older only added the engine
+the first time, so upgrading in place kept the old engine. Before the
+next local build, clean (Xcode: Product > Clean Build Folder): an
+incremental build can reuse Xcode's cached copy of the previous engine's
+interface and fail on new symbols such as `storageWarning`. EAS Build
+starts clean every time.
+
 **2. Declare permissions in Info.plist** (bare React Native only; the Expo
 plugin does this for you).
 

package/ios/wire.rb

@@ -6,7 +6,8 @@
 #   ruby node_modules/crowdplaysdk/ios/wire.rb <YourProjectName>
 #
 # What it does (idempotent; safe to re-run):
-#   1. adds the CrowdPlaySDK Swift package (compiled engine) to the project
+#   1. adds the CrowdPlaySDK Swift package (compiled engine) to the project,
+#      or re-pins an existing one to SDK_VERSION (an upgrade)
 #   2. copies the three bridge files into your app group + target
 #   3. creates/points the Swift bridging header at the React headers, raises
 #      the app target to iOS 17 and keeps explicit Swift modules ON for it
@@ -44,17 +45,30 @@ target = project.targets.find { |t| t.name == project_name } ||
          project.targets.find { |t| t.product_type == 'com.apple.product-type.application' }
 abort 'no application target found' unless target
 
-# 1. CrowdPlaySDK Swift package (skip when already present).
-unless project.root_object.package_references.any? { |r| r.respond_to?(:repositoryURL) && r.repositoryURL == SDK_URL }
+# 1. CrowdPlaySDK Swift package, pinned to exactly SDK_VERSION. An existing
+#    reference is re-pinned, never skipped: step 2 always replaces the bridge
+#    files, and a new bridge against the old engine does not compile (0.6.2
+#    upgraded in place kept engine 0.5.3 and failed on storageWarning, D-151).
+requirement = { 'kind' => 'exactVersion', 'version' => SDK_VERSION }
+existing = project.root_object.package_references.select { |r| r.respond_to?(:repositoryURL) && r.repositoryURL == SDK_URL }
+if existing.empty?
   pkg = project.new(Xcodeproj::Project::Object::XCRemoteSwiftPackageReference)
   pkg.repositoryURL = SDK_URL
-  pkg.requirement = { 'kind' => 'exactVersion', 'version' => SDK_VERSION }
+  pkg.requirement = requirement
   project.root_object.package_references << pkg
   dep = project.new(Xcodeproj::Project::Object::XCSwiftPackageProductDependency)
   dep.package = pkg
   dep.product_name = 'CrowdPlaySDK'
   target.package_product_dependencies << dep
   puts "+ CrowdPlaySDK package #{SDK_VERSION}"
+else
+  existing.each do |pkg|
+    next if pkg.requirement == requirement
+
+    was = (pkg.requirement || {})['version'] || (pkg.requirement || {})['minimumVersion'] || 'unpinned'
+    pkg.requirement = requirement
+    puts "+ CrowdPlaySDK package #{was} -> #{SDK_VERSION}"
+  end
 end
 
 # 2. Bridge files into the app group + target.

package/llms.txt

@@ -81,6 +81,14 @@ EXPO (managed, prebuild or EAS Build; app builders such as X1):
     Xcode project. Do not add those Info.plist keys or any native code
     yourself. Expo SDK 50 or newer.
 3.  Rebuild: npx expo prebuild, a development build, or eas build.
+    UPDATING the package later: npx expo prebuild again so the plugin
+    re-pins the engine to the version the package ships with (0.6.3+). An
+    ios/ folder committed to git is not re-wired by eas build on its own:
+    run prebuild and commit the result. Then clean before a LOCAL build
+    (Xcode: Product > Clean Build Folder); an incremental build can reuse
+    the previous engine's cached interface and fail with "has no member
+    '$storageWarning'". That error after an update means "clean", never
+    "edit the bridge". EAS Build starts clean.
 4.  Expo Go and any preview that never ran the plugin cannot load native
     modules: there the consent text, the call and recording fail with a
     clear error and the video view shows a placeholder. That is EXPECTED;
@@ -92,7 +100,8 @@ BARE REACT NATIVE (no Expo):
 2.  cd ios && pod install        (installs RN's own pods; CrowdPlay has none)
 3.  gem install xcodeproj --user-install   (one-time; wire.rb needs it
     and says so itself if missing)
-    ruby node_modules/crowdplaysdk/ios/wire.rb <YourProjectName>
+    ruby ../node_modules/crowdplaysdk/ios/wire.rb <YourProjectName>
+    (from ios/, where step 2 left you; wire.rb must run there)
     Idempotent. It: adds the CrowdPlaySDK binary Swift package to the Xcode
     project, copies the three native bridge files into the app target,
     creates/points the Swift bridging header at the React headers, raises
@@ -100,7 +109,10 @@ BARE REACT NATIVE (no Expo):
     sets SWIFT_ENABLE_EXPLICIT_MODULES = YES on the app target (React Native
     0.8x sets it to NO project-wide on Xcode 26, and with implicit modules
     the compiled engine's interface cannot be imported). Rerun it any time;
-    it never duplicates. Never undo that setting to fix an unrelated error.
+    it never duplicates, and after updating the package it re-pins the
+    engine to the version the package ships with (0.6.3+); then Product >
+    Clean Build Folder before building. Never undo that setting to fix an
+    unrelated error.
 4.  Info.plist: NSMicrophoneUsageDescription, NSCameraUsageDescription,
     UIBackgroundModes = [audio]. A missing usage string makes iOS kill
     the app at first mic/camera access (uncatchable).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crowdplaysdk",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "CrowdPlay lossless conversation capture for React Native (iOS). Studio-grade per-participant recording during live video calls, delivered to CrowdPlay automatically.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",