@circle-fin/w3s-pw-react-native-sdk 2.0.0 → 2.0.2

package/README.md

@@ -10,6 +10,12 @@
 
 ---
 
+## Migrating from SDK v1 (Bare React Native)
+
+If you have an existing bare React Native project using SDK v1 and want to upgrade to SDK v2, see the [SDK v1 Migration Guide](https://github.com/circlefin/w3s-react-native-sample-app-wallets/blob/master/MIGRATION_GUIDE.md).
+
+You can also find the SDK v1 sample app in the sample app repository's [sdk-v1 branch](https://github.com/circlefin/w3s-react-native-sample-app-wallets/tree/sdk-v1).
+
 ## System Requirements
 
 | Platform     | Minimum Version | Recommended Version |
@@ -96,8 +102,7 @@ During `expo prebuild`, files from `prebuild-sync-src/android` → `android/` an
 | `sourceDir` | `prebuild-sync-src` | Root directory with android/ and ios/ folders |
 | `overwrite` | `true`              | Whether to overwrite existing files           |
 
-> [!NOTE]
-> This solves the problem of `expo prebuild --clean` erasing manual changes.
+**Note:** This solves the problem of `expo prebuild --clean` erasing manual changes.
 
 </details>
 
@@ -211,6 +216,8 @@ eas build --profile development --platform all
 - [User-Controlled Wallets Documentation](https://developers.circle.com/wallets/user-controlled) - Product overview and architecture
 - [React Native SDK Documentation](https://developers.circle.com/wallets/user-controlled/react-native-sdk) - Complete API reference
 - [UI Customization API](https://developers.circle.com/wallets/user-controlled/react-native-sdk-ui-customization-api) - Theming and localization options
+- [React Native Sample App](https://github.com/circlefin/w3s-react-native-sample-app-wallets) - Working Expo sample app with integration guide
+- [SDK v1 Migration Guide](https://github.com/circlefin/w3s-react-native-sample-app-wallets/blob/master/MIGRATION_GUIDE.md) - Complete guide for upgrading from bare React Native + SDK v1 to Expo Modules + SDK v2
 
 **Expo Resources:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/w3s-pw-react-native-sdk",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "packageManager": "yarn@1.22.22",
   "description": "React Native SDK for Circle Programmable Wallet",
   "main": "build/index.js",
@@ -44,7 +44,8 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "check:type": "tsc --noEmit",
-    "publish:sdk": "npm publish --registry https://npm.pkg.github.com/"
+    "publish:sdk": "npm publish --registry https://npm.pkg.github.com/",
+    "test:with-copy-files": "npm --prefix ./example run verify:with-copy-files"
   },
   "keywords": [
     "react-native",

package/plugins/withCopyFiles.js

@@ -37,21 +37,32 @@ function copyFile(srcPath, dstPath, overwrite = true) {
   console.log(`[withCopyFiles] Copied: ${srcPath} -> ${dstPath}`)
 }
 
-function copyDirRecursive(srcDir, dstDir, overwrite = true, excludeFiles = []) {
+function normalizeRelativePath(relativePath) {
+  return relativePath.split(path.sep).join('/')
+}
+
+function copyDirRecursive(
+  srcDir,
+  dstDir,
+  overwrite = true,
+  excludeFiles = [],
+  relativeDir = '',
+) {
   if (!fs.existsSync(srcDir)) return
   const entries = fs.readdirSync(srcDir, { withFileTypes: true })
   for (const entry of entries) {
     const s = path.join(srcDir, entry.name)
     const d = path.join(dstDir, entry.name)
+    const relativePath = normalizeRelativePath(path.join(relativeDir, entry.name))
 
-    // Skip excluded files
-    if (excludeFiles.includes(entry.name)) {
+    // Skip excluded file paths (relative to platform source root)
+    if (excludeFiles.includes(relativePath)) {
       console.log(`[withCopyFiles] Skipped (excluded): ${s}`)
       continue
     }
 
     if (entry.isDirectory()) {
-      copyDirRecursive(s, d, overwrite, excludeFiles)
+      copyDirRecursive(s, d, overwrite, excludeFiles, relativePath)
     } else {
       copyFile(s, d, overwrite)
     }
@@ -101,6 +112,7 @@ const withCopyFiles = (
     console.log('[withCopyFiles] Android stage (withProjectBuildGradle)')
 
     const projectRoot = cfg.modRequest.projectRoot
+    const dstBuildGradle = path.resolve(projectRoot, 'android', 'build.gradle')
     const srcBuildGradle = path.resolve(
       projectRoot,
       sourceDir,
@@ -110,11 +122,15 @@ const withCopyFiles = (
 
     // Special handling for build.gradle: update modResults.contents instead of direct file copy
     if (fs.existsSync(srcBuildGradle)) {
-      const buildGradleContents = fs.readFileSync(srcBuildGradle, 'utf8')
-      cfg.modResults.contents = buildGradleContents
-      console.log(
-        `[withCopyFiles] Updated build.gradle contents from: ${srcBuildGradle}`,
-      )
+      if (!overwrite && fs.existsSync(dstBuildGradle)) {
+        console.log(`[withCopyFiles] Skipped (exists): ${dstBuildGradle}`)
+      } else {
+        const buildGradleContents = fs.readFileSync(srcBuildGradle, 'utf8')
+        cfg.modResults.contents = buildGradleContents
+        console.log(
+          `[withCopyFiles] Updated build.gradle contents from: ${srcBuildGradle}`,
+        )
+      }
     }
 
     // Copy other Android files (excluding build.gradle which is handled above)