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

package/src/bridgeSafe.ts

@@ -0,0 +1,156 @@
+/**
+ * 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.
+ */
+
+/**
+ * Bridge-safe utilities for React Native/Expo
+ * - bridgeSafe: Converts values to JSON-safe format
+ * - bridgeDiff: Detects data loss or unexpected transformations
+ */
+
+export type BridgePrimitive = string | number | boolean | null;
+export type BridgeValue = BridgePrimitive | { [k: string]: BridgeValue } | BridgeValue[];
+
+type TypeName =
+    | 'null' | 'boolean' | 'number' | 'string'
+    | 'array' | 'object'
+    | 'date' | 'bigint' | 'map' | 'set'
+    | 'function' | 'symbol' | 'undefined'
+    | 'nan' | 'infinity';
+
+function typeOf(x: unknown): TypeName {
+    if (x === null) return 'null'
+    const t = typeof x
+    if (t === 'number') {
+        if (Number.isNaN(x as number)) return 'nan'
+        if (!Number.isFinite(x as number)) return 'infinity'
+        return 'number'
+    }
+    if (t === 'bigint') return 'bigint'
+    if (t === 'function') return 'function'
+    if (t === 'symbol') return 'symbol'
+    if (t === 'undefined') return 'undefined'
+    if (t === 'string' || t === 'boolean') return t
+    // Check complex types
+    if (x instanceof Date) return 'date'
+    if (Array.isArray(x)) return 'array'
+    if (x instanceof Map) return 'map'
+    if (x instanceof Set) return 'set'
+    return 'object'
+}
+
+export function bridgeSafe<T = unknown>(input: T): BridgeValue {
+    const seen = new WeakSet<object>()
+    const replacer = (_k: string, v: unknown) => {
+        const ty = typeOf(v)
+        if (ty === 'undefined' || ty === 'function' || ty === 'symbol') return undefined
+        if (ty === 'nan' || ty === 'infinity') return String(v)
+        if (ty === 'bigint') return String(v)
+        if (ty === 'date') return (v as Date).toISOString()
+        if (ty === 'map') {
+            return Object.fromEntries(Array.from((v as Map<unknown, unknown>).entries(), ([k, val]) => [String(k), val]))
+        }
+        if (ty === 'set') {
+            return Array.from((v as Set<unknown>).values())
+        }
+        if (v && typeof v === 'object') {
+            if (seen.has(v)) return '[Circular]'
+            seen.add(v)
+        }
+        return v
+    }
+    return JSON.parse(JSON.stringify(input, replacer)) as BridgeValue
+}
+
+export interface BridgeDiff {
+    lostPaths: string[];               // paths that disappeared after serialization
+    transformed: Array<{ path: string; from: TypeName; to: TypeName; note?: string }>;
+}
+
+export interface DiffPolicy {
+    /** allow typical transforms without flagging */
+    allow?: Partial<Record<`${TypeName}->${TypeName}`, boolean>>;
+    /** treat dropping undefined/function/symbol as allowed (default true) */
+    allowDropSpecial?: boolean;
+}
+
+/**
+ * Compare original and bridged values to identify transformations and data loss
+ * @note This is a best-effort detector that cannot guarantee perfect bijection
+ */
+export function bridgeDiff(original: unknown, bridged: BridgeValue, policy?: DiffPolicy): BridgeDiff {
+    const allow = new Set<string>(Object.entries({
+        'date->string': true,
+        'bigint->string': true,
+        'map->object': true,
+        'set->array': true,
+        'nan->string': true,
+        'infinity->string': true,
+        ...(policy?.allow ?? {}),
+    }).filter(([, v]) => v).map(([k]) => k))
+
+    const allowDropSpecial = policy?.allowDropSpecial ?? true
+
+    const lostPaths: string[] = []
+    const transformed: Array<{ path: string; from: TypeName; to: TypeName; note?: string }> = []
+
+    function walk(o: unknown, b: unknown, path: string) {
+        const to = typeOf(b)
+        const fo = typeOf(o)
+
+        // record transform
+        if (!(fo === to || allow.has(`${fo}->${to}`))) {
+            // exclude expected object/array shape diffs handled below
+            if (!(fo === 'object' && to === 'object') && !(fo === 'array' && to === 'array')) {
+                transformed.push({ path, from: fo, to })
+            }
+        }
+
+        // if bridged is undefined, nothing to recurse
+        if (b === undefined) return
+
+        if (to === 'object') {
+            const oKeys = (o && typeof o === 'object') ? Object.keys(o) : []
+            const bKeys = (b && typeof b === 'object') ? Object.keys(b) : []
+            // find missing keys
+            for (const k of oKeys) {
+                if (!(k in (b as Record<string, unknown>))) {
+                    const child = (o as Record<string, unknown>)[k]
+                    const tChild = typeOf(child)
+                    const droppedSpecial = (tChild === 'undefined' || tChild === 'function' || tChild === 'symbol')
+                    if (!(allowDropSpecial && droppedSpecial)) {
+                        lostPaths.push(path ? `${path}.${k}` : k)
+                    }
+                }
+            }
+            // recurse
+            for (const k of bKeys) {
+                walk((o as Record<string, unknown>)?.[k], (b as Record<string, unknown>)[k], path ? `${path}.${k}` : k)
+            }
+        } else if (to === 'array') {
+            const len = Array.isArray(b) ? (b as unknown[]).length : 0
+            for (let i = 0; i < len; i++) {
+                walk((o as unknown[])?.[i], (b as unknown[])[i], `${path}[${i}]`)
+            }
+        }
+    }
+
+    walk(original, bridged, '')
+
+    return { lostPaths, transformed }
+}
+

package/src/index.ts

@@ -0,0 +1,21 @@
+/**
+ * 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.
+ */
+
+export { default } from './ProgrammablewalletRnSdkModule'
+export * from './types'
+export { WalletSdk } from './WalletSdk'

package/src/types.ts

@@ -1,73 +1,117 @@
-// 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 type { ImageSourcePropType } from 'react-native/Libraries/Image/Image'
+/**
+ * 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.
+ */
+import { ImageSourcePropType } from 'react-native'
+
+export type ProgrammablewalletRnSdkModuleEvents = {
+  CirclePwOnEvent: (params: CirclePwEventPayload) => void
+  CirclePwOnSuccess: (params: CirclePwSuccessPayload) => void
+  CirclePwOnError: (params: CirclePwErrorPayload) => void
+}
+
+export const CIRCLE_PW_ON_EVENT = 'CirclePwOnEvent'
+
+export type CirclePwEventPayload = {
+  name: ExecuteEvent
+}
+
+export type CirclePwSuccessPayload = {
+  [key: string]: SuccessResult
+}
+
+export type CirclePwErrorPayload = {
+  [key: string]: unknown
+}
 
 export interface IWalletSdk {
-  sdkVersion: SdkVersion;
-  deviceId: string;
-  init: (configuration: Configuration) => Promise<void>;
-  setSecurityQuestions: (securityQuestions: SecurityQuestion[]) => void;
-  addListener: (listener: EventListener) => void;
-  removeAllListeners: () => void;
-  getDeviceId: () => string;
+  sdkVersion: SdkVersion
+  deviceId: string
+  getDeviceId: () => string
+  init: (configuration: Configuration) => Promise<void>
+  setSecurityQuestions: (securityQuestions: SecurityQuestion[]) => void
   execute: (
     userToken: string,
     encryptionKey: string,
     challengeIds: string[],
     successCallback: SuccessCallback,
     errorCallback: ErrorCallback,
-  ) => void;
-  setBiometricsPin: (
-    userToken: string,
-    encryptionKey: string,
-    successCallback: SuccessCallback,
-    errorCallback: ErrorCallback,
-  ) => void;
-  performLogin: (
-    provider: SocialProvider,
+  ) => void
+  verifyOTP: (
+    otpToken: string,
     deviceToken: string,
     deviceEncryptionKey: string,
     successCallback: LoginSuccessCallback,
     errorCallback: ErrorCallback,
-  ) => void;
-  verifyOTP: (
-    otpToken: string,
+  ) => void
+  performLogin: (
+    provider: SocialProvider,
     deviceToken: string,
     deviceEncryptionKey: string,
     successCallback: LoginSuccessCallback,
     errorCallback: ErrorCallback,
-  ) => void;
+  ) => void
   performLogout: (
     provider: SocialProvider,
-    completeCallback: CompleteCallback,
+    completedCallback: CompletedCallback,
+    errorCallback: ErrorCallback,
+  ) => void
+  setBiometricsPin: (
+    userToken: string,
+    encryptionKey: string,
+    successCallback: SuccessCallback,
     errorCallback: ErrorCallback,
-  ) => void;
-  setDismissOnCallbackMap: (map: Map<ErrorCode, boolean>) => void;
-  moveTaskToFront: () => void;
-  moveRnTaskToFront: () => void;
-  setTextConfigsMap: (map: Map<TextsKey, TextConfig[]>) => void;
-  setIconTextConfigsMap: (
-    map: Map<IconTextsKey, Array<IconTextConfig>>,
-  ) => void;
-  setTextConfigMap: (map: Map<TextKey, TextConfig>) => void;
-  setImageMap: (map: Map<ImageKey, ImageSourcePropType>) => void;
-  setDateFormat: (format: DateFormat) => void;
-  setDebugging: (debugging: boolean) => void;
-  setCustomUserAgent: (userAgent: string) => void;
-  setErrorStringMap: (map: Map<ErrorCode, string>) => void;
+  ) => void
+
+  setDismissOnCallbackMap: (map: Map<ErrorCode, boolean>) => void
+  moveTaskToFront: () => void
+  moveRnTaskToFront: () => void
+  setTextConfigsMap: (map: Map<TextsKey, TextConfig[]>) => void
+  setIconTextConfigsMap: (map: Map<IconTextsKey, Array<IconTextConfig>>) => void
+  setTextConfigMap: (map: Map<TextKey, TextConfig>) => void
+  setImageMap: (map: Map<ImageKey, ImageSourcePropType>) => void
+  setDateFormat: (format: DateFormat) => void
+  setDebugging: (debugging: boolean) => void
+  setCustomUserAgent: (userAgent: string) => void
+  setErrorStringMap: (map: Map<ErrorCode, string>) => void
+}
+
+export interface SdkVersion {
+  native: string
+  rn?: string
+}
+
+export interface Configuration {
+  endpoint: string
+  appId: string
+  settingsManagement?: SettingsManagement
+}
+
+export interface SettingsManagement {
+  enableBiometricsPin: boolean
+}
+
+export class SecurityQuestion {
+  title: string
+  inputType?: InputType
+
+  constructor(title: string, inputType?: InputType) {
+    this.title = title
+    this.inputType = inputType
+  }
 }
 
 export enum TextsKey {
@@ -322,81 +366,36 @@ export enum ErrorCode {
   loginInfoMissing = '155721',
 }
 
-export class SecurityQuestion {
-  title: string
-  inputType?: InputType
-
-  constructor(title: string, inputType?: InputType) {
-    this.title = title
-    this.inputType = inputType
-  }
-}
-
-export interface Configuration {
-  endpoint: string;
-  appId: string;
-  settingsManagement?: SettingsManagement;
-}
-
-export type EventListener = (event: ExecuteEvent) => void
 export type SuccessCallback = (result: SuccessResult) => void
 export type LoginSuccessCallback = (result: LoginResult) => void
-export type CompleteCallback = () => void
+export type CompletedCallback = () => void
 export type ErrorCallback = (error: Error) => void
-export interface SdkVersion {
-  native: string;
-  rn?: string;
-}
 
 export interface SuccessResult {
-  result: ExecuteResult;
-  warning?: ExecuteWarning;
+  result: ExecuteResult
+  warning?: ExecuteWarning
 }
 
 export interface Error {
-  code?: string;
-  message: string;
-}
-
-export interface LoginResult {
-  userToken?: string;
-  encryptionKey?: string;
-  refreshToken?: string;
-  oauthInfo?: OauthInfo;
-}
-
-export interface OauthInfo {
-  provider?: string;
-  scope?: string[];
-  socialUserUUID?: string;
-  socialUserInfo?: SocialUserInfo;
-}
-
-export interface SocialUserInfo {
-  name?: string;
-  email?: string;
-  phone?: string;
+  code?: string
+  message: string
 }
 
 export interface ExecuteResult {
-  resultType: ExecuteResultType;
-  status: ExecuteResultStatus;
-  data?: ExecuteResultData;
+  resultType: ExecuteResultType
+  status: ExecuteResultStatus
+  data?: ExecuteResultData
 }
 
 export interface ExecuteWarning {
-  warningType: ErrorCode;
-  warningString: string;
+  warningType: ErrorCode
+  warningString: string
 }
 
 export interface ExecuteResultData {
-  signature?: string;
-  signedTransaction?: string;
-  txHash?: string;
-}
-
-export interface SettingsManagement {
-  enableBiometricsPin: boolean;
+  signature?: string
+  signedTransaction?: string
+  txHash?: string
 }
 
 export class IconTextConfig {
@@ -420,7 +419,7 @@ export class TextConfig {
     font?: string,
   ) {
     this.text = text
-    if(Array.isArray(gradientColorsOrTextColor)){
+    if (Array.isArray(gradientColorsOrTextColor)) {
       this.gradientColors = gradientColorsOrTextColor
     } else {
       this.textColor = gradientColorsOrTextColor
@@ -465,8 +464,32 @@ export enum InputType {
   datePicker = 'datePicker',
 }
 
+// ==========================
+// MARK: Social Login
+// ==========================
+
 export enum SocialProvider {
   Google = 'Google',
   Facebook = 'Facebook',
   Apple = 'Apple',
 }
+
+export interface LoginResult {
+  userToken?: string
+  encryptionKey?: string
+  refreshToken?: string
+  oauthInfo?: OauthInfo
+}
+
+export interface OauthInfo {
+  provider?: string
+  scope?: string[]
+  socialUserUUID?: string
+  socialUserInfo?: SocialUserInfo
+}
+
+export interface SocialUserInfo {
+  name?: string
+  email?: string
+  phone?: string
+}

package/src/utils/securityQuestionUtils.ts

@@ -0,0 +1,121 @@
+/**
+ * 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.
+ */
+
+import { SecurityQuestion, InputType } from '../types'
+
+/**
+ * Extract string representation from unknown value
+ * @param value - Value to convert to string
+ * @returns String representation
+ */
+export function getStringFromUnknown(value: unknown): string {
+    if (value === null || value === undefined) return ''
+
+    if (typeof value === 'object' && value !== null) {
+        const obj = value as Record<string, unknown>
+        if ('name' in obj && typeof obj.name === 'string') {
+            return obj.name
+        }
+    }
+    return typeof value?.toString === 'function' ? value.toString() : ''
+}
+
+/**
+ * Normalize various input types to InputType enum values
+ * @param v - Input value to normalize
+ * @returns Normalized InputType or undefined
+ */
+export function normalizeInputType(v: unknown): InputType | undefined {
+    if (v == null) return undefined
+
+    if (v === InputType.text || v === InputType.datePicker) {
+        return v
+    }
+
+    if (typeof v === 'string') {
+        const s = v.toLowerCase()
+        if (s.includes('date') || s.includes('birth')) return InputType.datePicker
+        if (s !== 'text' && s !== '') {
+            console.warn(`[WalletSdk] Unexpected inputType string: "${v}", using default "text"`)
+        }
+        return InputType.text
+    }
+
+    if (typeof v === 'number') {
+        if (v === 1) return InputType.datePicker
+        if (v !== 0) {
+            console.warn(`[WalletSdk] Unexpected inputType number: ${v}, using default "text"`)
+        }
+        return InputType.text
+    }
+
+    const hint = getStringFromUnknown(v).toLowerCase()
+    if (hint.includes('date')) return InputType.datePicker
+
+    if (v !== null && v !== undefined) {
+        console.warn(`[WalletSdk] Unexpected inputType: ${typeof v}, using default "text"`)
+    }
+
+    return InputType.text
+}
+
+/**
+ * Convert security question input to standardized SecurityQuestion object
+ * 
+ * Supports three input formats:
+ * 1. Tuple [title, inputType]
+ * 2. Object {title, inputType}
+ * 3. String or other primitive
+ * 
+ * @param q - Security question input (any type)
+ * @returns Standardized SecurityQuestion instance
+ */
+export function toPlainSecurityQuestion(q: unknown): SecurityQuestion {
+    const securityQuestion = new SecurityQuestion('', InputType.text)
+
+    if (Array.isArray(q)) {
+        // Handle array/tuple format: [title, inputType]
+        const [title, it] = q
+        securityQuestion.title = String(title || '')
+        securityQuestion.inputType = normalizeInputType(it) ?? InputType.text
+    }
+    else if (q && typeof q === 'object') {
+        // Handle object/class instances
+        const o = q as Record<string, unknown>
+        securityQuestion.title = String(
+            o.title ||
+            o.Title ||
+            (typeof o.getTitle === 'function' ? o.getTitle() : undefined) ||
+            '',
+        )
+
+        const inputTypeRaw =
+            o.inputType ||
+            o.InputType ||
+            (typeof o.getInputType === 'function' ? o.getInputType() : undefined)
+
+        securityQuestion.inputType = normalizeInputType(inputTypeRaw) ?? InputType.text
+    }
+    else {
+        // Handle string or other primitive
+        securityQuestion.title = String(q || '')
+        securityQuestion.inputType = InputType.text
+    }
+
+    return securityQuestion
+}

package/COPYRIGHT

@@ -1,10 +0,0 @@
-Copyright (c) 2024, Circle Internet Financial, LTD. All rights reserved.
-
-This file is licensed to you 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 REPRESENTATIONS
-OF ANY KIND, either express or implied. See the License for the specific language
-governing permissions and limitations under the License.

package/android/gradle.properties

@@ -1,21 +0,0 @@
-# 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.
-
-ProgrammablewalletRnSdk_kotlinVersion=1.7.0
-ProgrammablewalletRnSdk_minSdkVersion=21
-ProgrammablewalletRnSdk_targetSdkVersion=31
-ProgrammablewalletRnSdk_compileSdkVersion=31
-ProgrammablewalletRnSdk_ndkversion=21.4.7075529

package/android/src/main/AndroidManifestNew.xml

@@ -1,22 +0,0 @@
-<!--
-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.
--->
-
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-
-  <uses-permission android:name="android.permission.REORDER_TASKS" />
-</manifest>