react-native-nitro-passkeys 0.1.0

package/nitrogen/generated/ios/swift/Func_void_std__string.swift

@@ -0,0 +1,46 @@
+///
+/// Func_void_std__string.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Wraps a Swift `(_ value: String) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_std__string {
+  public typealias bridge = margelo.nitro.nitropasskeys.bridge.swift
+
+  private let closure: (_ value: String) -> Void
+
+  public init(_ closure: @escaping (_ value: String) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(value: std.string) -> Void {
+    self.closure(String(value))
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_std__string`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__string>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__string {
+    return Unmanaged<Func_void_std__string>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/HybridNitroPasskeysSpec.swift

@@ -0,0 +1,56 @@
+///
+/// HybridNitroPasskeysSpec.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/// See ``HybridNitroPasskeysSpec``
+public protocol HybridNitroPasskeysSpec_protocol: HybridObject {
+  // Properties
+  var isSupported: Bool { get }
+
+  // Methods
+  func create(creationOptionsJson: String) throws -> Promise<String>
+  func get(requestOptionsJson: String) throws -> Promise<String>
+}
+
+public extension HybridNitroPasskeysSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject NitroPasskeys]"
+  }
+}
+
+/// See ``HybridNitroPasskeysSpec``
+open class HybridNitroPasskeysSpec_base {
+  private weak var cxxWrapper: HybridNitroPasskeysSpec_cxx? = nil
+  public init() { }
+  public func getCxxWrapper() -> HybridNitroPasskeysSpec_cxx {
+  #if DEBUG
+    guard self is any HybridNitroPasskeysSpec else {
+      fatalError("`self` is not a `HybridNitroPasskeysSpec`! Did you accidentally inherit from `HybridNitroPasskeysSpec_base` instead of `HybridNitroPasskeysSpec`?")
+    }
+  #endif
+    if let cxxWrapper = self.cxxWrapper {
+      return cxxWrapper
+    } else {
+      let cxxWrapper = HybridNitroPasskeysSpec_cxx(self as! any HybridNitroPasskeysSpec)
+      self.cxxWrapper = cxxWrapper
+      return cxxWrapper
+    }
+  }
+}
+
+/**
+ * A Swift base-protocol representing the NitroPasskeys HybridObject.
+ * Implement this protocol to create Swift-based instances of NitroPasskeys.
+ * ```swift
+ * class HybridNitroPasskeys : HybridNitroPasskeysSpec {
+ *   // ...
+ * }
+ * ```
+ */
+public typealias HybridNitroPasskeysSpec = HybridNitroPasskeysSpec_protocol & HybridNitroPasskeysSpec_base

package/nitrogen/generated/ios/swift/HybridNitroPasskeysSpec_cxx.swift

@@ -0,0 +1,169 @@
+///
+/// HybridNitroPasskeysSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridNitroPasskeysSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridNitroPasskeysSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::nitropasskeys::bridge::swift`)
+   * from `NitroPasskeys-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.nitropasskeys.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridNitroPasskeysSpec` Swift protocol.
+   */
+  private var __implementation: any HybridNitroPasskeysSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridNitroPasskeysSpec_
+
+  /**
+   * Create a new `HybridNitroPasskeysSpec_cxx` that wraps the given `HybridNitroPasskeysSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridNitroPasskeysSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridNitroPasskeysSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridNitroPasskeysSpec() -> any HybridNitroPasskeysSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridNitroPasskeysSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridNitroPasskeysSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridNitroPasskeysSpec_cxx {
+    return Unmanaged<HybridNitroPasskeysSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridNitroPasskeysSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridNitroPasskeysSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridNitroPasskeysSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridNitroPasskeysSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Compares this object with the given [other] object for reference equality.
+   */
+  @inline(__always)
+  public func equals(other: HybridNitroPasskeysSpec_cxx) -> Bool {
+    return self.__implementation === other.__implementation
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  public final var isSupported: Bool {
+    @inline(__always)
+    get {
+      return self.__implementation.isSupported
+    }
+  }
+
+  // Methods
+  @inline(__always)
+  public final func create(creationOptionsJson: std.string) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+    do {
+      let __result = try self.__implementation.create(creationOptionsJson: String(creationOptionsJson))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(std.string(__result)) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func get(requestOptionsJson: std.string) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+    do {
+      let __result = try self.__implementation.get(requestOptionsJson: String(requestOptionsJson))
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(std.string(__result)) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_std__string___(__exceptionPtr)
+    }
+  }
+}

package/nitrogen/generated/shared/c++/HybridNitroPasskeysSpec.cpp

@@ -0,0 +1,23 @@
+///
+/// HybridNitroPasskeysSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridNitroPasskeysSpec.hpp"
+
+namespace margelo::nitro::nitropasskeys {
+
+  void HybridNitroPasskeysSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("isSupported", &HybridNitroPasskeysSpec::getIsSupported);
+      prototype.registerHybridMethod("create", &HybridNitroPasskeysSpec::create);
+      prototype.registerHybridMethod("get", &HybridNitroPasskeysSpec::get);
+    });
+  }
+
+} // namespace margelo::nitro::nitropasskeys

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

@@ -0,0 +1,64 @@
+///
+/// HybridNitroPasskeysSpec.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
+
+
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+
+namespace margelo::nitro::nitropasskeys {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `NitroPasskeys`
+   * Inherit this class to create instances of `HybridNitroPasskeysSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridNitroPasskeys: public HybridNitroPasskeysSpec {
+   * public:
+   *   HybridNitroPasskeys(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridNitroPasskeysSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridNitroPasskeysSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridNitroPasskeysSpec() override = default;
+
+    public:
+      // Properties
+      virtual bool getIsSupported() = 0;
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<std::string>> create(const std::string& creationOptionsJson) = 0;
+      virtual std::shared_ptr<Promise<std::string>> get(const std::string& requestOptionsJson) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "NitroPasskeys";
+  };
+
+} // namespace margelo::nitro::nitropasskeys

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "react-native-nitro-passkeys",
+  "version": "0.1.0",
+  "description": "WebAuthn passkeys for bare React Native, built with Nitro Modules",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "format": "oxfmt",
+    "test": "bun test src",
+    "example:server": "bun example/server/index.ts",
+    "clean": "git clean -dfX",
+    "prepare": "lefthook install || true",
+    "release": "semantic-release",
+    "build": "bun run typecheck && bob build",
+    "codegen": "nitrogen --logLevel=\"debug\" && bun run build"
+  },
+  "keywords": [
+    "react-native",
+    "nitro",
+    "passkeys",
+    "webauthn",
+    "fido2",
+    "react-native-nitro-passkeys"
+  ],
+  "files": [
+    "src",
+    "!src/**/__tests__",
+    "lib",
+    "nitrogen",
+    "nitro.json",
+    "android/build.gradle",
+    "android/fix-prefab.gradle",
+    "android/gradle.properties",
+    "android/CMakeLists.txt",
+    "android/src",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "*.podspec",
+    "README.md"
+  ],
+  "workspaces": [
+    "example"
+  ],
+  "repository": "https://github.com/aparedes/react-native-nitro-passkeys.git",
+  "author": "aparedes",
+  "license": "MIT",
+  "bugs": "https://github.com/aparedes/react-native-nitro-passkeys/issues",
+  "homepage": "https://github.com/aparedes/react-native-nitro-passkeys#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": ">=0.37.1 <0.38.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^7.0.0",
+    "@semantic-release/git": "^11.0.1",
+    "@simplewebauthn/server": "^14.0.2",
+    "@types/bun": "^1.4.0",
+    "@types/react": "19.2.18",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "lefthook": "^2.1.10",
+    "nitrogen": "0.37.1",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "react": "19.2.3",
+    "react-native": "0.87.1",
+    "react-native-builder-bob": "^0.43.0",
+    "react-native-nitro-modules": "0.37.1",
+    "semantic-release": "^25.0.9",
+    "typescript": "^7.0.2"
+  },
+  "overrides": {
+    "lodash-es": "4.17.21",
+    "typescript": "$typescript"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "trustedDependencies": [
+    "lefthook"
+  ]
+}

package/src/PasskeyError.ts

@@ -0,0 +1,58 @@
+export type PasskeyErrorCode =
+  | 'canceled'
+  | 'noCredentials'
+  | 'alreadyRegistered'
+  | 'domainNotAssociated'
+  | 'unsupported'
+  | 'invalidOptions'
+  | 'unknown';
+
+const CODES: ReadonlySet<string> = new Set<PasskeyErrorCode>([
+  'canceled',
+  'noCredentials',
+  'alreadyRegistered',
+  'domainNotAssociated',
+  'unsupported',
+  'invalidOptions',
+  'unknown',
+]);
+
+const TOKEN_RE = /\[Passkeys:([A-Za-z0-9-]+)\]\s?/;
+const ASAUTH_RE = /^asauth-\d+$/;
+
+function codeForToken(token: string | undefined): PasskeyErrorCode {
+  if (token === undefined) return 'unknown';
+  if (token === 'asauth-1001') return 'canceled';
+  if (token === 'asauth-1006') return 'alreadyRegistered';
+  if (ASAUTH_RE.test(token)) return 'unknown';
+  return CODES.has(token) ? (token as PasskeyErrorCode) : 'unknown';
+}
+
+export class PasskeyError extends Error {
+  readonly code: PasskeyErrorCode;
+
+  constructor(code: PasskeyErrorCode, message: string) {
+    super(message);
+    this.name = 'PasskeyError';
+    this.code = code;
+  }
+
+  /** Normalises any thrown value into a `PasskeyError`. Never throws. */
+  static from(error: unknown): PasskeyError {
+    try {
+      if (error instanceof PasskeyError) return error;
+      const original =
+        error instanceof Error
+          ? error.message
+          : typeof error === 'string'
+            ? error
+            : 'Unknown error';
+      const match = TOKEN_RE.exec(original);
+      const code = codeForToken(match?.[1]);
+      const stripped = match ? original.replace(TOKEN_RE, '') : original;
+      return new PasskeyError(code, stripped.length > 0 ? stripped : original);
+    } catch {
+      return new PasskeyError('unknown', 'Unknown error');
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+import { NitroModules } from 'react-native-nitro-modules';
+
+import { PasskeyError } from './PasskeyError';
+import {
+  parseAuthenticationResponse,
+  parseRegistrationResponse,
+} from './response';
+import type { NitroPasskeys } from './specs/nitro-passkeys.nitro';
+import type {
+  AuthenticationResponseJSON,
+  PublicKeyCredentialCreationOptionsJSON,
+  PublicKeyCredentialRequestOptionsJSON,
+  RegistrationResponseJSON,
+} from './types';
+import { validateCreationOptions, validateRequestOptions } from './validate';
+
+// Deliberately not exported: every caller goes through the helpers and gets typed errors.
+const native = NitroModules.createHybridObject<NitroPasskeys>('NitroPasskeys');
+
+export function isPasskeySupported(): boolean {
+  return native.isSupported;
+}
+
+export async function createPasskey(
+  options: PublicKeyCredentialCreationOptionsJSON,
+): Promise<RegistrationResponseJSON> {
+  if (!isPasskeySupported()) {
+    throw new PasskeyError(
+      'unsupported',
+      'Passkeys are not supported on this device',
+    );
+  }
+  const reason = validateCreationOptions(options);
+  if (reason) throw new PasskeyError('invalidOptions', reason);
+  let raw: string;
+  try {
+    raw = await native.create(JSON.stringify(options));
+  } catch (error) {
+    throw PasskeyError.from(error);
+  }
+  return parseRegistrationResponse(raw);
+}
+
+export async function getPasskey(
+  options: PublicKeyCredentialRequestOptionsJSON,
+): Promise<AuthenticationResponseJSON> {
+  if (!isPasskeySupported()) {
+    throw new PasskeyError(
+      'unsupported',
+      'Passkeys are not supported on this device',
+    );
+  }
+  const reason = validateRequestOptions(options);
+  if (reason) throw new PasskeyError('invalidOptions', reason);
+  let raw: string;
+  try {
+    raw = await native.get(JSON.stringify(options));
+  } catch (error) {
+    throw PasskeyError.from(error);
+  }
+  return parseAuthenticationResponse(raw);
+}
+
+export { PasskeyError } from './PasskeyError';
+export type { PasskeyErrorCode } from './PasskeyError';
+export type * from './types';

package/src/response.ts

@@ -0,0 +1,49 @@
+import { PasskeyError } from './PasskeyError';
+import type {
+  AuthenticationResponseJSON,
+  RegistrationResponseJSON,
+} from './types';
+import {
+  validateAuthenticationResponse,
+  validateRegistrationResponse,
+} from './validate';
+
+function parse<T extends { clientExtensionResults: unknown }>(
+  raw: string,
+  label: 'registration' | 'authentication',
+  validate: (value: unknown) => string | undefined,
+): T {
+  let value: unknown;
+  try {
+    value = JSON.parse(raw);
+  } catch {
+    throw new PasskeyError('unknown', `Malformed ${label} response: not JSON`);
+  }
+  const reason = validate(value);
+  if (reason)
+    throw new PasskeyError('unknown', `Malformed ${label} response: ${reason}`);
+  const result = value as T;
+  // The only normalisation: nothing else is added, removed or re-encoded.
+  result.clientExtensionResults ??= {};
+  return result;
+}
+
+export function parseRegistrationResponse(
+  raw: string,
+): RegistrationResponseJSON {
+  return parse<RegistrationResponseJSON>(
+    raw,
+    'registration',
+    validateRegistrationResponse,
+  );
+}
+
+export function parseAuthenticationResponse(
+  raw: string,
+): AuthenticationResponseJSON {
+  return parse<AuthenticationResponseJSON>(
+    raw,
+    'authentication',
+    validateAuthenticationResponse,
+  );
+}

package/src/specs/nitro-passkeys.nitro.ts

@@ -0,0 +1,12 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface NitroPasskeys extends HybridObject<{
+  ios: 'swift';
+  android: 'kotlin';
+}> {
+  readonly isSupported: boolean;
+  /** creationOptionsJson: PublicKeyCredentialCreationOptionsJSON → RegistrationResponseJSON (both JSON strings). */
+  create(creationOptionsJson: string): Promise<string>;
+  /** requestOptionsJson: PublicKeyCredentialRequestOptionsJSON → AuthenticationResponseJSON (both JSON strings). */
+  get(requestOptionsJson: string): Promise<string>;
+}