OP-Engineering · ospfranco · Aug 11, 2026 · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026
diff --git a/.github/actions/setup/action.yml b/.github/actions/setup/action.yml
@@ -15,15 +15,21 @@ runs:
 
     - name: Cache dependencies
       id: yarn-cache
-      uses: actions/cache@v4
+      uses: actions/cache@v6
       with:
         path: |
           **/node_modules
           .yarn/install-state.gz
-        # key: ${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}-${{ hashFiles('**/package.json', '!node_modules/**') }}
+        # Deliberately no `restore-keys` fallback: a fallback match restores
+        # node_modules/.yarn/install-state.gz from an OLDER lockfile/package.json
+        # state (any change to either misses the exact key below), and `yarn
+        # install --immutable` then reconciles incrementally on top of that
+        # stale state instead of a clean install. patch-package (run via
+        # postinstall) is sensitive to exact package content and doesn't
+        # reliably re-apply patches in that scenario — this caused CI to
+        # intermittently fail with "cannot apply the following patch file"
+        # after any dependency version bump. Exact-match-or-miss avoids it.
         key: ${{ runner.os }}-yarn-${{ hashFiles('yarn.lock', 'example/yarn.lock') }}-${{ hashFiles('package.json', 'example/package.json') }}
-        restore-keys: |
-          ${{ runner.os }}-yarn-
 
     - name: Install dependencies
       if: steps.yarn-cache.outputs.cache-hit != 'true'

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -27,27 +27,28 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: install bundler dependencies
-        run: |
-          cd example
-          bundle install
-
-      - name: Cache cocoapods
-        id: cocoapods-cache
-        uses: actions/cache@v4
+      - name: Cache SwiftPM artifacts
+        uses: actions/cache@v6
         with:
-          path: |
-            **/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('example/ios/Podfile.lock') }}
+          path: ~/Library/Caches/ReactNative/spm-artifacts
+          key: ${{ runner.os }}-spm-artifacts-${{ hashFiles('example/node_modules/react-native/package.json') }}
           restore-keys: |
-            ${{ runner.os }}-cocoapods-
+            ${{ runner.os }}-spm-artifacts-
 
-      - name: Install cocoapods
+      - name: Set up SwiftPM
         run: |
           cd example/ios
-          bundle exec pod install
-        env:
-          NO_FLIPPER: 1
+          # download-spm-artifacts.js resolves Hermes via the `hermes-compiler`
+          # npm package's `latest-v1` dist-tag by default — a rolling tag
+          # decoupled from the exact `hermes-compiler` version react-native
+          # itself depends on (used to bytecode-compile the JS bundle). When
+          # they drift, the app crashes at launch with a Hermes bytecode
+          # version mismatch ("Wrong bytecode version. Expected X but got Y").
+          # Pin HERMES_VERSION to the installed react-native's own resolved
+          # hermes-compiler version so both always match.
+          export HERMES_VERSION=$(node -p "require('../node_modules/react-native/package.json').dependencies['hermes-compiler']")
+          echo "Pinning HERMES_VERSION=${HERMES_VERSION}"
+          npx react-native spm update --yes
 
       - name: run tests
         run: |
@@ -66,27 +67,28 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: install bundler dependencies
-        run: |
-          cd example
-          bundle install
-
-      - name: Cache cocoapods
-        id: cocoapods-cache
+      - name: Cache SwiftPM artifacts
         uses: actions/cache@v4
         with:
-          path: |
-            **/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('example/ios/Podfile.lock') }}
+          path: ~/Library/Caches/ReactNative/spm-artifacts
+          key: ${{ runner.os }}-spm-artifacts-${{ hashFiles('example/node_modules/react-native/package.json') }}
           restore-keys: |
-            ${{ runner.os }}-cocoapods-
+            ${{ runner.os }}-spm-artifacts-
 
-      - name: Install cocoapods
+      - name: Set up SwiftPM
         run: |
           cd example/ios
-          bundle exec pod install
-        env:
-          NO_FLIPPER: 1
+          # download-spm-artifacts.js resolves Hermes via the `hermes-compiler`
+          # npm package's `latest-v1` dist-tag by default — a rolling tag
+          # decoupled from the exact `hermes-compiler` version react-native
+          # itself depends on (used to bytecode-compile the JS bundle). When
+          # they drift, the app crashes at launch with a Hermes bytecode
+          # version mismatch ("Wrong bytecode version. Expected X but got Y").
+          # Pin HERMES_VERSION to the installed react-native's own resolved
+          # hermes-compiler version so both always match.
+          export HERMES_VERSION=$(node -p "require('../node_modules/react-native/package.json').dependencies['hermes-compiler']")
+          echo "Pinning HERMES_VERSION=${HERMES_VERSION}"
+          npx react-native spm update --yes
 
       - name: run tests
         run: |
@@ -105,27 +107,28 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: install bundler dependencies
-        run: |
-          cd example
-          bundle install
-
-      - name: Cache cocoapods
-        id: cocoapods-cache
+      - name: Cache SwiftPM artifacts
         uses: actions/cache@v4
         with:
-          path: |
-            **/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('example/ios/Podfile.lock') }}
+          path: ~/Library/Caches/ReactNative/spm-artifacts
+          key: ${{ runner.os }}-spm-artifacts-${{ hashFiles('example/node_modules/react-native/package.json') }}
           restore-keys: |
-            ${{ runner.os }}-cocoapods-
+            ${{ runner.os }}-spm-artifacts-
 
-      - name: Install cocoapods
+      - name: Set up SwiftPM
         run: |
           cd example/ios
-          bundle exec pod install
-        env:
-          NO_FLIPPER: 1
+          # download-spm-artifacts.js resolves Hermes via the `hermes-compiler`
+          # npm package's `latest-v1` dist-tag by default — a rolling tag
+          # decoupled from the exact `hermes-compiler` version react-native
+          # itself depends on (used to bytecode-compile the JS bundle). When
+          # they drift, the app crashes at launch with a Hermes bytecode
+          # version mismatch ("Wrong bytecode version. Expected X but got Y").
+          # Pin HERMES_VERSION to the installed react-native's own resolved
+          # hermes-compiler version so both always match.
+          export HERMES_VERSION=$(node -p "require('../node_modules/react-native/package.json').dependencies['hermes-compiler']")
+          echo "Pinning HERMES_VERSION=${HERMES_VERSION}"
+          npx react-native spm update --yes
 
       - name: run tests
         run: |
@@ -144,27 +147,28 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: install bundler dependencies
-        run: |
-          cd example
-          bundle install
-
-      - name: Cache cocoapods
-        id: cocoapods-cache
+      - name: Cache SwiftPM artifacts
         uses: actions/cache@v4
         with:
-          path: |
-            **/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('example/ios/Podfile.lock') }}
+          path: ~/Library/Caches/ReactNative/spm-artifacts
+          key: ${{ runner.os }}-spm-artifacts-${{ hashFiles('example/node_modules/react-native/package.json') }}
           restore-keys: |
-            ${{ runner.os }}-cocoapods-
+            ${{ runner.os }}-spm-artifacts-
 
-      - name: Install cocoapods
+      - name: Set up SwiftPM
         run: |
           cd example/ios
-          bundle exec pod install
-        env:
-          NO_FLIPPER: 1
+          # download-spm-artifacts.js resolves Hermes via the `hermes-compiler`
+          # npm package's `latest-v1` dist-tag by default — a rolling tag
+          # decoupled from the exact `hermes-compiler` version react-native
+          # itself depends on (used to bytecode-compile the JS bundle). When
+          # they drift, the app crashes at launch with a Hermes bytecode
+          # version mismatch ("Wrong bytecode version. Expected X but got Y").
+          # Pin HERMES_VERSION to the installed react-native's own resolved
+          # hermes-compiler version so both always match.
+          export HERMES_VERSION=$(node -p "require('../node_modules/react-native/package.json').dependencies['hermes-compiler']")
+          echo "Pinning HERMES_VERSION=${HERMES_VERSION}"
+          npx react-native spm update --yes
 
       - name: run tests
         run: |
@@ -414,27 +418,28 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-      - name: install bundler dependencies
-        run: |
-          cd example
-          bundle install
-
-      - name: Cache cocoapods
-        id: cocoapods-cache
+      - name: Cache SwiftPM artifacts
         uses: actions/cache@v4
         with:
-          path: |
-            **/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('example/ios/Podfile.lock') }}
+          path: ~/Library/Caches/ReactNative/spm-artifacts
+          key: ${{ runner.os }}-spm-artifacts-${{ hashFiles('example/node_modules/react-native/package.json') }}
           restore-keys: |
-            ${{ runner.os }}-cocoapods-
+            ${{ runner.os }}-spm-artifacts-
 
-      - name: Install cocoapods
+      - name: Set up SwiftPM
         run: |
           cd example/ios
-          bundle exec pod install
-        env:
-          NO_FLIPPER: 1
+          # download-spm-artifacts.js resolves Hermes via the `hermes-compiler`
+          # npm package's `latest-v1` dist-tag by default — a rolling tag
+          # decoupled from the exact `hermes-compiler` version react-native
+          # itself depends on (used to bytecode-compile the JS bundle). When
+          # they drift, the app crashes at launch with a Hermes bytecode
+          # version mismatch ("Wrong bytecode version. Expected X but got Y").
+          # Pin HERMES_VERSION to the installed react-native's own resolved
+          # hermes-compiler version so both always match.
+          export HERMES_VERSION=$(node -p "require('../node_modules/react-native/package.json').dependencies['hermes-compiler']")
+          echo "Pinning HERMES_VERSION=${HERMES_VERSION}"
+          npx react-native spm update --yes
 
       - name: run tests
         run: |

diff --git a/.gitignore b/.gitignore
@@ -89,5 +89,17 @@ android/c_sources
 # c_sources/
 
 scripts/sqlite-vec-*
-turso/
-.tmp/
+# Root-level turso SDK source checkout used by build-turso-binaries.sh — not
+# anchored with a trailing-slash-only pattern, this also matched cpp/turso/
+# (the real, tracked source dir for the turso backend bridge), silently
+# untracking turso_bridge.cpp after it was moved there.
+/turso/
+.tmp/
+
+# SwiftPM (regenerated on every manifest evaluation)
+.build/
+.swiftpm/
+Package.resolved
+# Leftover temp file if `react-native spm scaffold`/`read-podspec.js` gets
+# interrupted mid-run before its own cleanup step
+.spm-scaffold-*
diff --git a/.nvmrc b/.nvmrc
@@ -1 +1 @@
-v20
+v24