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

package/plugins/withCopyFiles.js

@@ -0,0 +1,132 @@
+/**
+ * Copyright 2025 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const {
+  withXcodeProject,
+  withProjectBuildGradle,
+} = require('@expo/config-plugins')
+const fs = require('fs')
+const path = require('path')
+
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+}
+
+function copyFile(srcPath, dstPath, overwrite = true) {
+  ensureDir(path.dirname(dstPath))
+  if (!overwrite && fs.existsSync(dstPath)) {
+    console.log(`[withCopyFiles] Skipped (exists): ${dstPath}`)
+    return
+  }
+  fs.copyFileSync(srcPath, dstPath)
+  console.log(`[withCopyFiles] Copied: ${srcPath} -> ${dstPath}`)
+}
+
+function copyDirRecursive(srcDir, dstDir, overwrite = true, excludeFiles = []) {
+  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)
+
+    // Skip excluded files
+    if (excludeFiles.includes(entry.name)) {
+      console.log(`[withCopyFiles] Skipped (excluded): ${s}`)
+      continue
+    }
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(s, d, overwrite, excludeFiles)
+    } else {
+      copyFile(s, d, overwrite)
+    }
+  }
+}
+
+function runCopyPlatform(
+  config,
+  { sourceDir, overwrite, platform, excludeFiles = [] },
+) {
+  const projectRoot = config.modRequest.projectRoot
+
+  // Expect source layout:
+  //   <sourceDir>/
+  //     android/  -> will sync into <projectRoot>/android/
+  //     ios/      -> will sync into <projectRoot>/ios/
+  const srcRoot = path.resolve(projectRoot, sourceDir, platform)
+  const dstRoot = path.resolve(projectRoot, platform)
+
+  if (!fs.existsSync(srcRoot)) {
+    console.log(`[withCopyFiles] No ${platform} source folder: ${srcRoot}`)
+    return config
+  }
+
+  try {
+    console.log(`[withCopyFiles] Syncing ${platform}…`)
+    copyDirRecursive(srcRoot, dstRoot, overwrite, excludeFiles)
+  } catch (error) {
+    error.message = `[withCopyFiles] Error during file synchronization for ${platform}: ${error.message}`
+    throw error
+  }
+  return config
+}
+
+const withCopyFiles = (
+  config,
+  { sourceDir = 'prebuild-sync-src', overwrite = true } = {},
+) => {
+  // iOS
+  config = withXcodeProject(config, cfg => {
+    console.log('[withCopyFiles] iOS stage (withXcodeProject)')
+    return runCopyPlatform(cfg, { sourceDir, overwrite, platform: 'ios' })
+  })
+
+  // Android
+  config = withProjectBuildGradle(config, cfg => {
+    console.log('[withCopyFiles] Android stage (withProjectBuildGradle)')
+
+    const projectRoot = cfg.modRequest.projectRoot
+    const srcBuildGradle = path.resolve(
+      projectRoot,
+      sourceDir,
+      'android',
+      'build.gradle',
+    )
+
+    // 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}`,
+      )
+    }
+
+    // Copy other Android files (excluding build.gradle which is handled above)
+    return runCopyPlatform(cfg, {
+      sourceDir,
+      overwrite,
+      platform: 'android',
+      excludeFiles: ['build.gradle'],
+    })
+  })
+
+  return config
+}
+
+module.exports = withCopyFiles

package/plugins/withCopyFiles.md

@@ -0,0 +1,81 @@
+# Copy Files Plugin
+
+Config plugin to **copy entire platform folders** (`android/`, `ios/`) from a source directory into your generated native project during prebuild.  
+Any files or folders present under `<sourceDir>/android` or `<sourceDir>/ios` will be copied recursively.
+
+---
+
+## Features
+
+- Recursively copy files under `<sourceDir>/android` → `android/` and `<sourceDir>/ios` → `ios/`
+- Automatically creates target folders if they don’t exist
+- Supports **overwrite control** (`overwrite: true` or `false`)
+- Works during the **Expo prebuild** process
+
+---
+
+## Usage
+
+### 1. Configure in `app.json` or `app.config.ts`
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@circle-fin/w3s-pw-react-native-sdk/plugins/withCopyFiles",
+        {
+          "sourceDir": "prebuild-sync-src",
+          "overwrite": true
+        }
+      ]
+    ]
+  }
+}
+```
+
+> `sourceDir` is the path defined in your `app.json` or `app.config.js` under `expo.plugins` block, located within your project root.
+> Inside it, you can have both `android/` and `ios/` subfolders.
+
+---
+
+### 2. Directory structure example
+
+```
+prebuild-sync-src/
+  android/
+    app/build.gradle
+    app/src/main/res/values/strings.xml
+  ios/
+    YourApp/Info.plist
+    YourApp/CustomFile.m
+```
+
+Anything under these subfolders will be copied into your generated `android/` or `ios/` directories.
+
+---
+
+### 3. Run prebuild
+
+```bash
+npx expo prebuild
+```
+
+---
+
+## Configuration Options
+
+| Option      | Default               | Description                                                                                               |
+| ----------- | --------------------- | --------------------------------------------------------------------------------------------------------- |
+| `sourceDir` | `"prebuild-sync-src"` | Root directory containing your `android/` and/or `ios/` folders to copy                                   |
+| `overwrite` | `true`                | Whether to overwrite existing files in the target location (`false` will skip if the file already exists) |
+
+---
+
+## Notes
+
+- The plugin performs **one-way copy**: source → project native folders.
+  Removing files from the source won’t delete them in the target.
+- Removing the plugin and running `expo prebuild --clean` restores native folders to their default state.
+- Designed to be **idempotent** — running multiple times won’t duplicate files.
+- Works seamlessly with EAS Build and local `expo prebuild`.

package/src/ProgrammablewalletRnSdkModule.ts

@@ -1,41 +1,71 @@
-// Copyright (c) 2024, Circle Internet Financial, LTD. All rights reserved.
-//
-// SPDX-License-Identifier: Apache-2.0
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import { NativeModules, Platform } from 'react-native'
+/**
+ * Copyright 2025 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 
-const LINKING_ERROR =
-  `The package '@circle-fin/w3s-pw-react-native-sdk' doesn't seem to be linked. Make sure: \n\n` +
-  Platform.select({ ios: '- You have run \'pod install\'\n', default: '' }) +
-  '- You rebuilt the app after installing the package\n' +
-  '- You are not using Expo Go\n'
+import { NativeModule, requireNativeModule } from 'expo-modules-core'
+import {
+  ProgrammablewalletRnSdkModuleEvents,
+  Configuration,
+  DateFormat,
+  SuccessResult,
+  LoginResult,
+  SecurityQuestion,
+  TextConfig,
+} from './types'
 
-// @ts-expect-error
-const isTurboModuleEnabled = global.__turboModuleProxy != null
+declare class ProgrammablewalletRnSdkModule extends NativeModule<ProgrammablewalletRnSdkModuleEvents> {
+  sdkVersion: string
+  getDeviceId(): string
+  initSdk(configuration: Configuration): Promise<void>
+  setSecurityQuestions(securityQuestions: SecurityQuestion[]): void
+  execute(
+    userToken: string | null,
+    encryptionKey: string | null,
+    challengeIds: string[],
+  ): Promise<SuccessResult>
+  verifyOTP(
+    otpToken: string | null,
+    deviceToken: string | null,
+    deviceEncryptionKey: string | null,
+  ): Promise<LoginResult>
+  performLogin(
+    provider: string,
+    deviceToken: string,
+    deviceEncryptionKey: string,
+  ): Promise<LoginResult>
+  performLogout(provider: string): Promise<void>
+  setBiometricsPin(
+    userToken: string | null,
+    encryptionKey: string | null,
+  ): Promise<SuccessResult>
+  setDismissOnCallbackMap(map: Record<string, boolean>): void
+  moveTaskToFront(): void
+  moveRnTaskToFront(): void
+  setTextConfigsMap(map: Record<string, unknown[]>): void
+  setIconTextConfigsMap(map: Record<string, unknown>): void
+  setTextConfigMap(map: Record<string, TextConfig>): void
+  setImageMap(map: Record<string, string>): void
+  setDateFormat(format: DateFormat): void
+  setDebugging(debugging: boolean): void
+  setCustomUserAgent(userAgent: string): void
+  setErrorStringMap(map: Record<string, string>): void
+}
 
-const programmablewalletRnSdkModule = isTurboModuleEnabled
-  ? require('./NativeProgrammablewalletRnSdk').default
-  : NativeModules.ProgrammablewalletRnSdk
-
-const WalletSdkModule = programmablewalletRnSdkModule
-  ? programmablewalletRnSdkModule
-  : new Proxy(
-    {},
-    {
-      get() {
-        throw new Error(LINKING_ERROR)
-      },
-    },
-  )
-export default WalletSdkModule
+// This call loads the native module object from the JSI.
+export default requireNativeModule<ProgrammablewalletRnSdkModule>(
+  'ProgrammablewalletRnSdk',
+)