@symbiote-native/local-auth 0.0.1

package/README.md

@@ -0,0 +1,40 @@
+# @symbiote-native/local-auth
+
+Planned port of [`expo-local-authentication`](https://docs.expo.dev/versions/latest/sdk/local-authentication/)
+for [SymbioteNative](../../README.md) — FaceID/TouchID on iOS, the Fingerprint/Biometric API on
+Android, reachable from every adapter (React, Vue, Angular), not just React.
+
+**Status: skeleton only.** This package is not implemented yet — no source, no native wiring, not
+functional. Published early to reserve the npm name. Built the same way as
+[`@symbiote-native/sensors`](../sensors), a prior `expo-modules-core`-based wrapper (see the
+`symbiote-expo-native-module` project skill for the full mechanism: why `expo-modules-core` is
+depended on directly and never the `expo` meta-package, why the upstream JS is hand-ported into
+`core/` rather than imported, and how autolinking picks up the native module).
+
+## Planned API surface
+
+Free functions, no event stream, no per-instance state — upstream ships a handful of async
+functions and two enums, not a subscribable sensor:
+
+```ts
+hasHardwareAsync(): Promise<boolean>
+isEnrolledAsync(): Promise<boolean>
+getEnrolledLevelAsync(): Promise<SecurityLevel>
+supportedAuthenticationTypesAsync(): Promise<AuthenticationType[]>
+authenticateAsync(options?: LocalAuthenticationOptions): Promise<LocalAuthenticationResult>
+cancelAuthenticate(): Promise<void> // Android only
+```
+
+Plus `AuthenticationType`, `SecurityLevel`, `LocalAuthenticationOptions`,
+`LocalAuthenticationResult`, `LocalAuthenticationError`, `BiometricsSecurityLevel` — ported
+verbatim from upstream's `LocalAuthentication.types.ts`, since they're plain data with no native or
+React dependency.
+
+## Not yet done
+
+- `src/core` — ported types/enums + the six functions over `requireNativeModule('ExpoLocalAuthentication')`
+- `react`/`vue`/`angular` entry points — thin re-exports, no adapter-specific state needed
+- Native wiring in an example app (`use_expo_modules!`, Android Gradle autolinking,
+  `NSFaceIDUsageDescription` in `Info.plist`, `USE_BIOMETRIC`/`USE_FINGERPRINT` on Android)
+- Tests, following upstream's own fake-native-module pattern (no Fabric/Descriptor angle — this
+  wraps no native view)

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@symbiote-native/local-auth",
+  "version": "0.0.1",
+  "description": "expo-local-authentication wrapped for SymbioteNative — planned: one framework-agnostic core, reachable from the React, Vue, and Angular adapters. FaceID/TouchID (iOS) and the Fingerprint/Biometric API (Android). Skeleton only — no implementation yet, see README.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/local-auth"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/local-auth#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "publishConfig": {
+    "access": "public"
+  }
+}