@onekeyfe/react-native-photo-library 0.0.0-stage → 3.0.166

package/nitrogen/generated/shared/c++/HybridReactNativePhotoLibrarySpec.hpp

@@ -0,0 +1,67 @@
+///
+/// HybridReactNativePhotoLibrarySpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `PhotoSavePermission` to properly resolve imports.
+namespace margelo::nitro::reactnativephotolibrary { struct PhotoSavePermission; }
+
+#include "PhotoSavePermission.hpp"
+#include <NitroModules/Promise.hpp>
+#include <string>
+
+namespace margelo::nitro::reactnativephotolibrary {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `ReactNativePhotoLibrary`
+   * Inherit this class to create instances of `HybridReactNativePhotoLibrarySpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridReactNativePhotoLibrary: public HybridReactNativePhotoLibrarySpec {
+   * public:
+   *   HybridReactNativePhotoLibrary(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridReactNativePhotoLibrarySpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridReactNativePhotoLibrarySpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridReactNativePhotoLibrarySpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<PhotoSavePermission>> getSavePermission() = 0;
+      virtual std::shared_ptr<Promise<PhotoSavePermission>> requestSavePermission() = 0;
+      virtual std::shared_ptr<Promise<void>> saveToLibrary(const std::string& path) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "ReactNativePhotoLibrary";
+  };
+
+} // namespace margelo::nitro::reactnativephotolibrary

package/nitrogen/generated/shared/c++/PhotoSavePermission.hpp

@@ -0,0 +1,88 @@
+///
+/// PhotoSavePermission.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `PhotoSavePermissionStatus` to properly resolve imports.
+namespace margelo::nitro::reactnativephotolibrary { enum class PhotoSavePermissionStatus; }
+
+#include "PhotoSavePermissionStatus.hpp"
+
+namespace margelo::nitro::reactnativephotolibrary {
+
+  /**
+   * A struct which can be represented as a JavaScript object (PhotoSavePermission).
+   */
+  struct PhotoSavePermission final {
+  public:
+    PhotoSavePermissionStatus status     SWIFT_PRIVATE;
+    bool canAskAgain     SWIFT_PRIVATE;
+
+  public:
+    PhotoSavePermission() = default;
+    explicit PhotoSavePermission(PhotoSavePermissionStatus status, bool canAskAgain): status(status), canAskAgain(canAskAgain) {}
+
+  public:
+    friend bool operator==(const PhotoSavePermission& lhs, const PhotoSavePermission& rhs) = default;
+  };
+
+} // namespace margelo::nitro::reactnativephotolibrary
+
+namespace margelo::nitro {
+
+  // C++ PhotoSavePermission <> JS PhotoSavePermission (object)
+  template <>
+  struct JSIConverter<margelo::nitro::reactnativephotolibrary::PhotoSavePermission> final {
+    static inline margelo::nitro::reactnativephotolibrary::PhotoSavePermission fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::reactnativephotolibrary::PhotoSavePermission(
+        JSIConverter<margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "status"))),
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "canAskAgain")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::reactnativephotolibrary::PhotoSavePermission& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "status"), JSIConverter<margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus>::toJSI(runtime, arg.status));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "canAskAgain"), JSIConverter<bool>::toJSI(runtime, arg.canAskAgain));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "status")))) return false;
+      if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "canAskAgain")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/PhotoSavePermissionStatus.hpp

@@ -0,0 +1,80 @@
+///
+/// PhotoSavePermissionStatus.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::reactnativephotolibrary {
+
+  /**
+   * An enum which can be represented as a JavaScript union (PhotoSavePermissionStatus).
+   */
+  enum class PhotoSavePermissionStatus {
+    GRANTED      SWIFT_NAME(granted) = 0,
+    DENIED      SWIFT_NAME(denied) = 1,
+    UNDETERMINED      SWIFT_NAME(undetermined) = 2,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::reactnativephotolibrary
+
+namespace margelo::nitro {
+
+  // C++ PhotoSavePermissionStatus <> JS PhotoSavePermissionStatus (union)
+  template <>
+  struct JSIConverter<margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus> final {
+    static inline margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("granted"): return margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::GRANTED;
+        case hashString("denied"): return margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::DENIED;
+        case hashString("undetermined"): return margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::UNDETERMINED;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PhotoSavePermissionStatus - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus arg) {
+      switch (arg) {
+        case margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::GRANTED: return JSIConverter<std::string>::toJSI(runtime, "granted");
+        case margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::DENIED: return JSIConverter<std::string>::toJSI(runtime, "denied");
+        case margelo::nitro::reactnativephotolibrary::PhotoSavePermissionStatus::UNDETERMINED: return JSIConverter<std::string>::toJSI(runtime, "undetermined");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PhotoSavePermissionStatus to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("granted"):
+        case hashString("denied"):
+        case hashString("undetermined"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,173 @@
 {
   "name": "@onekeyfe/react-native-photo-library",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.0.166",
+  "description": "Add-only photo saving with version-scoped Android write permission",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*",
+    "docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "yarn prepare && npm whoami && npm publish --access public"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneKeyHQ/app-modules.git",
+    "directory": "native-modules/react-native-photo-library"
+  },
+  "author": "onekeyfe <huanming@onekey.so> (https://github.com/OneKeyHQ/app-modules)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/OneKeyHQ/app-modules/issues"
+  },
+  "homepage": "https://github.com/OneKeyHQ/app-modules/tree/main/native-modules/react-native-photo-library#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@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",
+    "nitrogen": "0.37.0",
+    "prettier": "^2.8.8",
+    "react": "19.2.3",
+    "react-native": "patch:react-native@npm%3A0.86.2#~/.yarn/patches/react-native-npm-0.86.2-c9d546616f.patch",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-nitro-modules": "0.37.0",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "0.37.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  }
+}

package/src/ReactNativePhotoLibrary.nitro.ts

@@ -0,0 +1,15 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export type PhotoSavePermissionStatus = 'granted' | 'denied' | 'undetermined';
+
+export interface PhotoSavePermission {
+  status: PhotoSavePermissionStatus;
+  canAskAgain: boolean;
+}
+
+export interface ReactNativePhotoLibrary
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  getSavePermission(): Promise<PhotoSavePermission>;
+  requestSavePermission(): Promise<PhotoSavePermission>;
+  saveToLibrary(path: string): Promise<void>;
+}

package/src/index.tsx

@@ -0,0 +1,79 @@
+import { NitroModules } from 'react-native-nitro-modules';
+
+import type {
+  PhotoSavePermission,
+  ReactNativePhotoLibrary,
+} from './ReactNativePhotoLibrary.nitro';
+
+export type {
+  PhotoSavePermission,
+  PhotoSavePermissionStatus,
+} from './ReactNativePhotoLibrary.nitro';
+
+let hybridObject: ReactNativePhotoLibrary | undefined;
+
+function native(): ReactNativePhotoLibrary {
+  if (!hybridObject) {
+    hybridObject = NitroModules.createHybridObject<ReactNativePhotoLibrary>(
+      'ReactNativePhotoLibrary'
+    );
+  }
+  return hybridObject;
+}
+
+const ERROR_CODES = [
+  'E_NO_LIBRARY_PERMISSION',
+  'E_NO_IMAGE_DATA_FOUND',
+  'E_CANNOT_SAVE_IMAGE',
+  'E_PERMISSION_IN_PROGRESS',
+  'E_ACTIVITY_DOES_NOT_EXIST',
+] as const;
+
+export type PhotoLibraryErrorCode = (typeof ERROR_CODES)[number] | 'E_UNKNOWN';
+
+export class PhotoLibraryError extends Error {
+  readonly code: PhotoLibraryErrorCode;
+
+  constructor(code: PhotoLibraryErrorCode, message: string) {
+    super(message);
+    this.name = 'PhotoLibraryError';
+    this.code = code;
+  }
+}
+
+function toError(error: unknown): PhotoLibraryError {
+  if (error instanceof PhotoLibraryError) return error;
+  const message = error instanceof Error ? error.message : String(error);
+  const match = /\b(E_[A-Z_]+): (.*)/.exec(message);
+  const code = ERROR_CODES.find((value) => value === match?.[1]);
+  return new PhotoLibraryError(
+    code ?? 'E_UNKNOWN',
+    code ? match?.[2]?.trim() ?? '' : 'Photo library operation failed'
+  );
+}
+
+export async function getSavePermission(): Promise<PhotoSavePermission> {
+  try {
+    return await native().getSavePermission();
+  } catch (error) {
+    throw toError(error);
+  }
+}
+
+export async function requestSavePermission(): Promise<PhotoSavePermission> {
+  try {
+    return await native().requestSavePermission();
+  } catch (error) {
+    throw toError(error);
+  }
+}
+
+export async function saveToLibrary(path: string): Promise<void> {
+  try {
+    await native().saveToLibrary(path);
+  } catch (error) {
+    throw toError(error);
+  }
+}
+
+export default { getSavePermission, requestSavePermission, saveToLibrary };