@onekeyfe/react-native-webview-cleaner 1.0.0 → 6.7.0-alpha.369

package/README.md

@@ -1,9 +1,13 @@
 # react-native-webview-cleaner
 
-React Native Webview Cache Cleaner for iOS and Android.
+React Native WebView website data cleaner for iOS and Android.
 
-## Usage
-```js
-import WebViewCleaner from "react-native-webview-cleaner"
+See the [behavioral contract](docs/SPEC.md) for platform behavior and completion limits.
 
-WebViewCleaner.clearAll()
+```ts
+import WebViewCleaner from 'react-native-webview-cleaner';
+
+WebViewCleaner.clearAll();
+```
+
+The public API and native module name are retained from the published legacy bridge package.

package/android/build.gradle

@@ -2,7 +2,7 @@
 apply plugin: 'com.android.library'
 
 android {
-    compileSdkVersion 30
+    compileSdkVersion(rootProject.ext.has('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 30)
     buildToolsVersion "23.0.1"
 
     defaultConfig {
@@ -22,4 +22,3 @@ android {
 dependencies {
     implementation 'com.facebook.react:react-native:+'
 }
-  

package/docs/SPEC.md

@@ -0,0 +1,59 @@
+# React Native WebView Cleaner contract
+
+Status: Implemented migration of the published `@onekeyfe/react-native-webview-cleaner` legacy bridge. Source and local package checks passed; consumer Release runtime checks are pending.
+
+## Purpose, scope, and non-goals
+
+The package exposes the existing `clearAll()` call to React Native on iOS and Android. It requests removal of app-wide WebView website data through the platform APIs described below. It does not clear every on-disk WebView cache, distinguish wallet accounts, or add a completion result to the JavaScript API. Web is unsupported.
+
+## Definitions and ownership boundaries
+
+JavaScript owns only a wrapper around `NativeModules.RNWebViewCleaner`. Native code invokes system-owned WebKit or Android WebView stores. The system owns the stored website data and completion timing. On iOS and Android, the app's `main` and `bg` JavaScript heaps are independent, while their native website data stores are app-wide resources; calls from either runtime can affect the same underlying data. No caller-specific partition or cross-runtime queue is provided.
+
+## Public API and defaults
+
+The package default export has `clearAll(): void`. The wrapper invokes `NativeModules.RNWebViewCleaner.clearAll()` and does not return its native result. It takes no arguments, applies no filters, and has no caller-visible completion callback. The native module name remains `RNWebViewCleaner`; the package name remains `@onekeyfe/react-native-webview-cleaner`, with the existing React Native consumer alias `react-native-webview-cleaner`.
+
+The package retains its CommonJS, ESM, TypeScript declarations, and React Native source entry points. This migration must preserve the old import and autolinking paths. No data is serialized across the bridge by this call.
+
+## Lifecycle and concurrency
+
+Each call starts the platform deletion work. The wrapper does not await completion, cancel a call, serialize calls, or guard concurrent calls from separate JavaScript runtimes. Callers must not assume that a later WebView use waits for deletion to finish. Repeated calls may overlap. The package retains no JavaScript cache or request state.
+
+## Data, cache, and identity
+
+The operation targets the default platform website data stores, without a wallet, account, tab, URL, or request key. It does not own persistent data formats or perform migrations. Clearing may affect other WebViews in the same app because the native stores are app-wide.
+
+## Platform contract
+
+| Platform | Existing native action | Completion visible to JavaScript |
+| --- | --- | --- |
+| iOS | On the main queue, `WKWebsiteDataStore.defaultDataStore` removes all website data types modified since the Unix epoch. The native promise resolves with `nil` in the completion handler. | No. The JavaScript wrapper discards the native promise. |
+| Android | `CookieManager.removeAllCookies(null)`, `CookieManager.flush()`, then `WebStorage.deleteAllData()`. | No. The native method returns `void`; cookie removal may still be pending. |
+| Web | Unsupported. | Not applicable. |
+
+The Android operation does not claim to clear every WebView disk cache. Platform APIs and ordering remain as in the published package; the migration must not normalize these differences by changing the public API.
+
+## Failure, fallback, and safety
+
+The wrapper has no retry, fallback, or explicit error mapping. An unavailable `NativeModules.RNWebViewCleaner` can cause a synchronous JavaScript failure. Native asynchronous failures are not reported through `clearAll()`. The package does not bypass platform permissions or security checks. The system APIs determine data volume and duration; the package sets no numeric limit.
+
+## Performance and resource budget
+
+The wrapper performs one bridge call. Native deletion can involve system I/O; neither latency nor bytes removed are guaranteed. No measured performance claim is made. The iOS native code dispatches its WebKit call to the main queue as in the published implementation.
+
+## Migration exception and conformance
+
+Repository policy requires starting new packages with `yarn create:module`; that template generates a Nitro implementation. This package is an explicit legacy-bridge migration exception: the generated Nitro interface, Swift implementation, Kotlin module, C++ adapter, CMake file, `nitro.json`, and Nitro-only peer/configuration must be replaced or removed. A Nitro rewrite would change the native module name, generated ABI, and JavaScript call path without being required to fix the Android compile SDK issue.
+
+The template-created `src/index.tsx`, `src/ReactNativeWebviewCleaner.nitro.ts`, `ios/ReactNativeWebviewCleaner.swift`, generated podspec, `android/CMakeLists.txt`, `android/gradle.properties`, C++ adapter, two Kotlin files, and `nitro.json` were removed. The package uses its original `src/index.ts`, Objective-C bridge, Android Java bridge, podspec, Babel/TypeScript build settings, and copyright license. The repository's ESLint, Git hook, and Turbo task conventions remain; the Turbo task has no Nitro output.
+
+The migrated `src/index.ts`, `ios/RNWebViewCleaner/*`, Android Java module/package, and podspec must retain the published behavior. The only Android native build change is to use `rootProject.ext.compileSdkVersion` when defined, falling back to the old API 30 value otherwise. The existing minimum SDK, target SDK, ABI filter, and build tools declaration remain unchanged.
+
+The standalone package's Yarn 3 `packageManager`, ignored dependency resolution, and nonexistent `example` workspace/script are omitted so this workspace uses the repository's Yarn 4 installation. Its release script follows the repository's package workflow. The newer Bob version emits the same CommonJS implementation and TypeScript declarations, adds `"use strict"` to an already strict ESM module, and updates JavaScript source maps; these changes do not add an API or native behavior. The legacy podspec still contains its historical `s.source` repository placeholder. The current consumer uses CocoaPods `:path` autolinking from the installed npm package and does not fetch that source; standalone CocoaPods source-based installation is outside this migration's verified scope.
+
+The generated template `.gitignore`, migrated Android Gradle file, and migrated podspec had trailing blank whitespace removed to satisfy repository diff checks. Those edits do not change native code, dependency coordinates, or build settings.
+
+The standalone Xcode project contained ignored `project.xcworkspace/contents.xcworkspacedata`, `project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist`, and `xcuserdata/cancue.xcuserdatad/xcschemes/xcschememanagement.plist` files. They are omitted from this workspace and its published tarball because none is tracked by the template policy or used by the podspec's Objective-C source selection. The original standalone repository retains them; this omission has no runtime effect.
+
+Source and package comparison with published 1.0.0 must show the native implementation and JavaScript source byte-identical; the Android Gradle file differs by the compile SDK line and terminal whitespace, and the podspec differs only by terminal whitespace. Generated entry points and declarations must preserve `clearAll(): void`; the shipped package must include this spec linked from its README. The candidate Android AAR metadata task must pass with the consumer's compile SDK and React Native version. Full consumer Release APK/R8 and iOS archive/runtime tests are separate evidence and remain pending until the published version is installed and locked.

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","clearAll","NativeModules","RNWebViewCleaner"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAA6C,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAE9B;EACbC,QAAQ,EAAEA,CAAA,KAAM;IACdC,0BAAa,CAACC,gBAAgB,CAACF,QAAQ,CAAC,CAAC;EAC3C;AACF,CAAC"}
+{"version":3,"names":["_reactNative","require","_default","exports","default","clearAll","NativeModules","RNWebViewCleaner"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAA6C,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAE9B;EACbC,QAAQ,EAAEA,CAAA,KAAM;IACdC,0BAAa,CAACC,gBAAgB,CAACF,QAAQ,CAAC,CAAC;EAC3C;AACF,CAAC","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/module/index.js

@@ -1,3 +1,5 @@
+"use strict";
+
 import { NativeModules } from 'react-native';
 export default {
   clearAll: () => {

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","clearAll","RNWebViewCleaner"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA,SAASA,aAAa,QAAQ,cAAc;AAE5C,eAAe;EACbC,QAAQ,EAAEA,CAAA,KAAM;IACdD,aAAa,CAACE,gBAAgB,CAACD,QAAQ,CAAC,CAAC;EAC3C;AACF,CAAC"}
+{"version":3,"names":["NativeModules","clearAll","RNWebViewCleaner"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAE5C,eAAe;EACbC,QAAQ,EAAEA,CAAA,KAAM;IACdD,aAAa,CAACE,gBAAgB,CAACD,QAAQ,CAAC,CAAC;EAC3C;AACF,CAAC","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-webview-cleaner",
-  "version": "1.0.0",
+  "version": "6.7.0-alpha.369",
   "description": "webview cleaner",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "lib",
+    "docs",
     "keys",
     "android",
     "ios",
@@ -27,13 +28,12 @@
     "!**/.*"
   ],
   "scripts": {
-    "example": "yarn workspace react-native-webview-cleaner-example",
     "test": "jest",
     "typecheck": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "bob build",
-    "release": "release-it"
+    "release": "yarn prepare && npm whoami && npm publish --access public"
   },
   "keywords": [
     "react-native",
@@ -42,51 +42,47 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/OneKeyHQ/react-native-webview-cleaner.git"
+    "url": "git+https://github.com/OneKeyHQ/app-modules.git",
+    "directory": "native-modules/react-native-webview-cleaner"
   },
   "author": "OneKeyHQ <hi@onekey.so> (https://github.com/OneKeyHQ)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/OneKeyHQ/react-native-webview-cleaner/issues"
+    "url": "https://github.com/OneKeyHQ/app-modules/issues"
   },
-  "homepage": "https://github.com/OneKeyHQ/react-native-webview-cleaner#readme",
+  "homepage": "https://github.com/OneKeyHQ/app-modules/tree/main/native-modules/react-native-webview-cleaner#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^17.0.2",
-    "@evilmartians/lefthook": "^1.5.0",
-    "@react-native/eslint-config": "^0.72.2",
-    "@release-it/conventional-changelog": "^5.0.0",
-    "@types/jest": "^28.1.2",
-    "@types/react": "~17.0.21",
-    "@types/react-native": "0.70.0",
-    "commitlint": "^17.0.2",
-    "del-cli": "^5.0.0",
-    "eslint": "^8.4.1",
-    "eslint-config-prettier": "^8.5.0",
-    "eslint-plugin-prettier": "^4.0.0",
-    "jest": "^28.1.1",
-    "pod-install": "^0.1.0",
-    "prettier": "^2.0.5",
-    "react": "18.2.0",
-    "react-native": "0.73.1",
-    "react-native-builder-bob": "^0.23.2",
-    "release-it": "^15.0.0",
-    "turbo": "^1.10.7",
-    "typescript": "^5.0.2"
-  },
-  "resolutions": {
-    "@types/react": "17.0.21"
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/eslint-config": "0.86.2",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.3",
+    "react-native": "0.86.2",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*"
   },
-  "workspaces": [
-    "example"
-  ],
-  "packageManager": "yarn@3.6.1",
   "engines": {
     "node": ">= 18.0.0"
   },

package/react-native-webview-cleaner.podspec

@@ -25,4 +25,3 @@ Pod::Spec.new do |s|
   # ...
   # s.dependency "..."
 end
-

package/ios/RNWebViewCleaner.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<Workspace
-   version = "1.0">
-   <FileRef
-      location = "self:RNWebViewCleaner.xcodeproj">
-   </FileRef>
-</Workspace>

package/ios/RNWebViewCleaner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>IDEDidComputeMac32BitWarning</key>
-	<true/>
-</dict>
-</plist>

package/ios/RNWebViewCleaner.xcodeproj/xcuserdata/cancue.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>SchemeUserState</key>
-	<dict>
-		<key>RNWebViewCleaner.xcscheme_^#shared#^_</key>
-		<dict>
-			<key>orderHint</key>
-			<integer>0</integer>
-		</dict>
-	</dict>
-</dict>
-</plist>