@hxa-rn/rnaa 8.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hxa-rn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+本项目基于 [react-native-app-auth](https://github.com/FormidableLabs/react-native-app-auth)开发。如果在使用过程中有任何问题，欢迎在AtomGit提交Issue，会及时跟进。
+
+## 项目介绍
+
+`@hxa-rn/rnaa` 为 React Native 库 [react-native-app-auth](https://github.com/FormidableLabs/react-native-app-auth) 的鸿蒙适配包，提供 OAuth 2.0 / OpenID Connect 授权码流程（含 PKCE）、配置预取、令牌刷新、动态客户端注册、令牌吊销与会话登出。当前版本 `8.1.0`，对应上游 `8.1.0`，支持 Autolink，编译目标 API 12+。
+
+## 集成指南
+
+```bash
+npm install @hxa-rn/rnaa
+```
+
+**peerDependencies**：`react-native` >= 0.72。
+
+包内已声明 `harmony.alias` 为 `react-native-app-auth`。业务代码在配置 alias 后仍从原库名导入：
+
+```ts
+import { authorize, prefetchConfiguration, refresh } from 'react-native-app-auth';
+```
+
+不要写成 `from '@hxa-rn/rnaa'`。
+
+当前版本支持 Autolink；工程已接入时可跳过手动配置。如需 Manual Link：
+
+1. 在工程根 `oh-package.json5` 配置 `@rnoh/react-native-openharmony` 的 overrides（按宿主工程约定）。
+2. 在 `entry/oh-package.json5` 添加依赖：`"@hxa-rn/rnaa": "file:../../node_modules/@hxa-rn/rnaa/harmony/rnaa.har"`，并执行 `ohpm install`。
+3. 在 `entry/src/main/cpp/CMakeLists.txt` 中 `add_subdirectory` 本模块 C++ 并 `target_link_libraries`。
+4. 在 `PackageProvider.cpp` 注册 `RNAppAuthPackage`（C++）。
+5. 在 `RNPackagesFactory.ets` 注册 `RNAppAuthPackage`（ETS）。
+
+授权/登出重定向：在 entry `module.json5` 的 `EntryAbility.skills.uris` 中声明自定义 scheme（如 `rnaa://oauth2redirect`）。
+
+本地验证可参考仓库 `example`：安装依赖、`npm run dev` 生成 bundle 后，用 DevEco Studio 打开 `example/harmony` 编译运行。
+
+## 使用说明
+
+```tsx
+import { authorize, prefetchConfiguration, refresh } from 'react-native-app-auth';
+
+async function runAuthFlow() {
+  const config = {
+    issuer: 'https://demo.duendesoftware.com',
+    clientId: 'interactive.public',
+    redirectUrl: 'rnaa://oauth2redirect',
+    scopes: ['openid', 'profile', 'email', 'offline_access'],
+  };
+
+  await prefetchConfiguration({ ...config, connectionTimeoutSeconds: 10 });
+
+  const result = await authorize({ ...config, connectionTimeoutSeconds: 10 });
+  console.log(result.accessToken, result.idToken);
+
+  const refreshed = await refresh(config, { refreshToken: result.refreshToken });
+  console.log(refreshed.accessToken);
+}
+```
+
+## 接口文档
+
+| API | 描述 | 参数 | 返回值 | HarmonyOS |
+|-----|------|------|--------|-----------|
+| `prefetchConfiguration` | 预取并缓存 OIDC 服务发现配置 | `AuthConfiguration` | `Promise<void>` | 返回 void（与 Android resolve boolean 不同） |
+| `authorize` | 授权码登录（PKCE、clientAuthMethod、附加参数） | `AuthConfiguration` | `Promise<AuthorizeResult>` | 系统浏览器 + 重定向回调 |
+| `refresh` | 使用刷新令牌获取新访问令牌 | `AuthConfiguration`, `RefreshConfiguration` | `Promise<RefreshResult>` | 支持 |
+| `register` | OIDC 动态客户端注册（DCR） | `RegistrationConfiguration` | `Promise<RegistrationResponse>` | 支持 |
+| `revoke` | 吊销访问令牌（JS fetch） | `BaseAuthConfiguration`, `RevokeConfiguration` | `Promise<void>` | 支持 |
+| `logout` | RP-Initiated Logout | `EndSessionConfiguration`, `LogoutConfiguration` | `Promise<EndSessionResult>` | 系统浏览器 + 重定向回调 |
+
+平台差异要点：
+
+- `warmAndPrefetchChrome` 在鸿蒙为 no-op。
+- `dangerouslyAllowInsecureHttpRequests` 被忽略。
+- `handleRedirect` / `cancelPendingFlow` 为内部方法，不对业务开放。
+
+## 快速验证（运行 Example）
+
+### 前置条件
+
+| 依赖 | 版本要求 |
+|------|----------|
+| Node.js | >= 18 |
+| DevEco Studio | 5.0+ |
+| HarmonyOS SDK | API 12+ |
+
+### 运行步骤
+
+**1. 克隆仓库**
+
+```bash
+git clone https://gitcode.com/hxa-rn/react-native-app-auth.git
+cd react-native-app-auth
+git checkout br_rnoh0.72
+```
+
+**2. 安装仓库开发依赖**
+
+```bash
+npm install --legacy-peer-deps
+```
+
+Example 已改为从 npm 公仓安装 `@hxa-rn/rnaa@8.1.0`，不再使用本地 `file:../xxx.tgz`，运行 Example 不必再执行 `npm pack`。
+
+**3. 进入 example 目录，安装依赖**
+
+```bash
+cd example          # 或 example_auto
+npm install --legacy-peer-deps
+```
+
+**4. 生成 JS Bundle**
+
+```bash
+npm run dev
+```
+
+产物：`harmony/entry/src/main/resources/rawfile/bundle.harmony.js`
+
+**5. 用 DevEco Studio 打开鸿蒙工程**
+
+- 打开 DevEco Studio
+- 选择 `example/harmony`（或 `example_auto/harmony`）目录
+- 等待 Sync 完成
+
+**6. 编译并运行 HAP**
+
+在 DevEco Studio 中点击运行按钮，将 HAP 安装到设备/模拟器。
+
+> **注意**：Example 中已预置插件依赖和 Package 注册，无需手动配置 Link。Example 已声明 `ohos.permission.INTERNET`，并需在 entry `module.json5` 中配置 OAuth 重定向 scheme。
+
+## 约束与限制
+
+**兼容性**
+
+- 鸿蒙 SDK：API 12+
+- DevEco Studio：5.0+
+- 上游 RN 库：react-native-app-auth `8.1.0`
+- React Native / RNOH：0.72+
+
+**权限**
+
+- `ohos.permission.INTERNET`（entry `module.json5` 的 `requestPermissions`）
+
+**其它**
+
+- `authorize` / `logout` 须声明自定义 redirect scheme，否则浏览器无法回跳。
+- 重定向回调依赖应用存活；进程被回收后挂起请求会丢失。
+- `revoke` 未配置 `revocationEndpoint` 时会请求 issuer 的 OIDC discovery（需网络）。
+
+## 开源license
+
+本项目基于 MIT 协议，详见 [LICENSE](LICENSE) 文件。
+
+## 问题反馈渠道
+
+使用问题请在 AtomGit 提交 Issue。也可在 GitCode 仓库反馈：
+
+https://gitcode.com/hxa-rn/react-native-app-auth
+
+https://gitcode.com/hxa-rn/react-native-app-auth/issues

package/harmony/rnaa/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hxa-rn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/harmony/rnaa/NOTICE

@@ -0,0 +1,33 @@
+OPEN SOURCE SOFTWARE NOTICE
+
+Please note we provide an open source software notice for the third party open source software along with this software and/or this software component (in the following just “this SOFTWARE”). The open source software licenses are granted by the respective right holders.
+
+Warranty Disclaimer
+THE OPEN SOURCE SOFTWARE IN THIS PRODUCT IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE APPLICABLE LICENSES FOR MORE DETAILS.
+
+Copyright Notice and License Texts
+
+----------------------------------------------------------------------
+Software: react-native-netinfo V11.1.0
+
+MIT License
+
+Copyright (c) 2015-present, Facebook, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/harmony/rnaa/OAT.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+	<oatconfig>
+	<licensefile>LICENSE</licensefile>
+		<filefilterlist>
+			<filefilter name="copyrightPolicyFilter" desc="Filters for compatibility，license header policies">
+				<filteritem type="filename" name="hvigorfile.ts" desc="hvigor构建脚本，DevEco Studio自动生成，不需要添加版权头"/>
+				<filteritem type="filename" name="*.json5" desc="hvigor工程配置文件，DevEco Studio自动生成，不需要添加版权头"/>
+				<filteritem type="filename" name="*.proto" desc="资源文件，不需要添加版权头"/>
+				<filteritem type="filename" name="*.json" desc="资源文件，不需要添加版权头"/>
+				<filteritem type="filepath" name="hvigorw" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigorw.bat" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigor/hvigor-wrapper.js" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+                <filteritem type="filename" name="LICENSE" desc="工程文件，不修改版权头"/>
+			</filefilter>
+			<filefilter name="defaultPolicyFilter" desc="Filters for compatibility，license header policies">
+				<filteritem type="filename" name="hvigorfile.ts" desc="hvigor构建脚本，DevEco Studio自动生成，不需要添加许可证头"/>
+				<filteritem type="filename" name="*.json5" desc="hvigor工程配置文件，DevEco Studio自动生成，不需要添加许可证头"/>
+				<filteritem type="filename" name="LICENSE" desc="原三方库证书文件无需更改，因此添加过滤"/>
+				<filteritem type="filename" name="*.proto" desc="资源文件，不需要添加许可证头"/>
+				<filteritem type="filename" name="*.json" desc="资源文件，不需要添加许可证头"/>
+				<filteritem type="filepath" name="hvigorw" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigorw.bat" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigor/hvigor-wrapper.js" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+			</filefilter>
+			<filefilter name="binaryFileTypePolicyFilter" desc="Filters for resources files policies">
+				<filteritem type="filename" name="icon.png" desc="应用图标"/>
+				<filteritem type="filename" name="app_icon.png" desc="应用图标"/>
+				<filteritem type="filename" name="warn.png" desc="页面展示图标"/>
+			</filefilter>
+		</filefilterlist>
+        <policylist>
+            <policy name="projectPolicy" desc="">
+                <policyitem type="license" name="MIT" path="*.*" desc="license under the MIT"/>
+            </policy>
+        </policylist>
+	</oatconfig>
+</configuration>

package/harmony/rnaa/build-profile.json5

@@ -0,0 +1,19 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "arkOptions": {
+      "byteCodeHar": false
+    },
+    "packingOptions": {
+      "asset": {
+        "include": ["./src/main/cpp/**"]
+      }
+    }
+  },
+  "targets": [
+    {
+      "name": "default",
+      "runtimeOS": "HarmonyOS"
+    }
+  ]
+}

package/harmony/rnaa/hvigorfile.ts

@@ -0,0 +1,2 @@
+// Script for compiling build behavior. It is built in the build plug-in and cannot be modified currently.
+export { harTasks } from '@ohos/hvigor-ohos-plugin';

package/harmony/rnaa/index.ets

@@ -0,0 +1 @@
+export { RNAppAuthPackage as default } from './src/main/ets/RNAppAuthTurboModulesFactory';

package/harmony/rnaa/oh-package.json5

@@ -0,0 +1,14 @@
+{
+  "license": "Apache-2.0",
+  "devDependencies": {
+
+  },
+  "author": "",
+  "name": "@hxa-rn/rnaa",
+  "description": "React Native bridge for AppAuth for supporting any OAuth 2 provider",
+  "main": "index.ets",
+  "version": "8.1.0",
+  "dependencies": {
+    "@rnoh/react-native-openharmony": "file:../react_native_openharmony_release.har"
+  }
+}

package/harmony/rnaa/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,15 @@
+# the minimum version of CMake.
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+# react-native codegen-harmony 将 C++ 产物放在 generated/；#include 以 src/main/cpp 为根（如 generated/Foo.h），
+# 同时 generated 下的 .cpp 常使用 #include "Foo.h"，故需同时加入 cpp 与 cpp/generated。
+set(library_generated_dir "${CMAKE_CURRENT_SOURCE_DIR}/generated")
+# 不用 **/*.cpp：OHOS 自带 CMake 在 Windows 上常匹配不到，会得到空列表 → add_library 报 No SOURCES。
+file(GLOB_RECURSE library_generated_SRC CONFIGURE_DEPENDS "${library_generated_dir}/*.cpp")
+file(GLOB library_SRC CONFIGURE_DEPENDS *.cpp)
+add_library(rnaa SHARED ${library_SRC} ${library_generated_SRC})
+target_include_directories(rnaa PUBLIC
+    ${CMAKE_CURRENT_SOURCE_DIR}
+    ${library_generated_dir})
+target_link_libraries(rnaa PUBLIC rnoh)

package/harmony/rnaa/src/main/cpp/RNAppAuthPackage.h

@@ -0,0 +1,13 @@
+#ifndef RNAPPAUTHPACKAGE_H
+#define RNAPPAUTHPACKAGE_H
+
+#include "generated/RNOH/generated/BaseRnaaPackage.h"
+#pragma once
+
+namespace rnoh {
+class RNAppAuthPackage : public BaseRnaaPackage {
+    using Super = BaseRnaaPackage;
+    using Super::Super;
+};
+} // namespace rnoh
+#endif //RNAPPAUTHPACKAGE_H

package/harmony/rnaa/src/main/cpp/generated/RNOH/generated/BaseRnaaPackage.h

@@ -0,0 +1,72 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+#pragma once
+
+#include "RNOH/Package.h"
+#include "RNOH/ArkTSTurboModule.h"
+#include "RNOH/generated/turbo_modules/RNAppAuth.h"
+
+namespace rnoh {
+
+class BaseRnaaPackageTurboModuleFactoryDelegate : public TurboModuleFactoryDelegate {
+  public:
+    SharedTurboModule createTurboModule(Context ctx, const std::string &name) const override {
+        if (name == "RNAppAuth") {
+            return std::make_shared<RNAppAuth>(ctx, name);
+        }
+        return nullptr;
+    };
+};
+
+class BaseRnaaPackageEventEmitRequestHandler : public EventEmitRequestHandler {
+  public:
+    void handleEvent(Context const &ctx) override {
+        auto eventEmitter = ctx.shadowViewRegistry->getEventEmitter<facebook::react::EventEmitter>(ctx.tag);
+        auto componentName = ctx.shadowViewRegistry->getComponentName(ctx.tag);
+
+        if (eventEmitter == nullptr) {
+            return;
+        }
+
+        std::vector<std::string> supportedComponentNames = {
+        };
+
+        std::vector<std::string> supportedEventNames = {
+        };
+
+        if (std::find(supportedComponentNames.begin(), supportedComponentNames.end(), componentName) != supportedComponentNames.end() &&
+            std::find(supportedEventNames.begin(), supportedEventNames.end(), ctx.eventName) != supportedEventNames.end()) {
+            eventEmitter->dispatchEvent(ctx.eventName, ArkJS(ctx.env).getDynamic(ctx.payload));
+        }    
+    }
+};
+
+
+class BaseRnaaPackage : public Package {
+  public:
+    BaseRnaaPackage(Package::Context ctx) : Package(ctx){};
+
+    std::unique_ptr<TurboModuleFactoryDelegate> createTurboModuleFactoryDelegate() override {
+        return std::make_unique<BaseRnaaPackageTurboModuleFactoryDelegate>();
+    }
+
+    std::vector<facebook::react::ComponentDescriptorProvider> createComponentDescriptorProviders() override {
+        return {
+        };
+    }
+
+    ComponentJSIBinderByString createComponentJSIBinderByName() override {
+        return {
+        };
+    };
+
+    EventEmitRequestHandlers createEventEmitRequestHandlers() override {
+        return {
+            std::make_shared<BaseRnaaPackageEventEmitRequestHandler>(),
+        };
+    }
+};
+
+} // namespace rnoh

package/harmony/rnaa/src/main/cpp/generated/RNOH/generated/turbo_modules/RNAppAuth.cpp

@@ -0,0 +1,22 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+#include "RNAppAuth.h"
+
+namespace rnoh {
+using namespace facebook;
+
+RNAppAuth::RNAppAuth(const ArkTSTurboModule::Context ctx, const std::string name) : ArkTSTurboModule(ctx, name) {
+    methodMap_ = {
+        ARK_ASYNC_METHOD_METADATA(prefetchConfiguration, 9),
+        ARK_ASYNC_METHOD_METADATA(register, 11),
+        ARK_ASYNC_METHOD_METADATA(authorize, 14),
+        ARK_ASYNC_METHOD_METADATA(refresh, 12),
+        ARK_ASYNC_METHOD_METADATA(logout, 6),
+        ARK_ASYNC_METHOD_METADATA(handleRedirect, 1),
+        ARK_ASYNC_METHOD_METADATA(cancelPendingFlow, 0),
+    };
+}
+
+} // namespace rnoh

package/harmony/rnaa/src/main/cpp/generated/RNOH/generated/turbo_modules/RNAppAuth.h

@@ -0,0 +1,16 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+#pragma once
+
+#include "RNOH/ArkTSTurboModule.h"
+
+namespace rnoh {
+
+class JSI_EXPORT RNAppAuth : public ArkTSTurboModule {
+  public:
+    RNAppAuth(const ArkTSTurboModule::Context ctx, const std::string name);
+};
+
+} // namespace rnoh

package/harmony/rnaa/src/main/ets/DateUtil.ets

@@ -0,0 +1,28 @@
+/**
+ * Timestamp formatting aligned with DateUtil.java on Android:
+ * 'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'' (UTC, no milliseconds).
+ */
+
+export class DateUtil {
+  /**
+   * Format a Unix timestamp (milliseconds since epoch) as an RFC 3339-ish
+   * UTC string without fractional seconds: 2024-01-01T00:00:00Z.
+   */
+  static formatTimestamp(timestamp: number): string {
+    let date = new Date(timestamp);
+    let year = date.getUTCFullYear();
+    let month = DateUtil.pad2(date.getUTCMonth() + 1);
+    let day = DateUtil.pad2(date.getUTCDate());
+    let hours = DateUtil.pad2(date.getUTCHours());
+    let minutes = DateUtil.pad2(date.getUTCMinutes());
+    let seconds = DateUtil.pad2(date.getUTCSeconds());
+    return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}Z`;
+  }
+
+  private static pad2(value: number): string {
+    if (value < 10) {
+      return `0${value}`;
+    }
+    return `${value}`;
+  }
+}