@symbiote-native/local-auth 0.0.1 → 0.3.0

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { hasHardwareAsync, supportedAuthenticationTypesAsync, isEnrolledAsync, getEnrolledLevelAsync, authenticateAsync, cancelAuthenticate, } from './local-authentication';
+export { AuthenticationType, SecurityLevel, } from './types';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EACjC,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,aAAa,GAKd,MAAM,SAAS,CAAC"}

package/build-ngc/core/local-authentication.d.ts

@@ -0,0 +1,33 @@
+import type { AuthenticationType, ILocalAuthenticationOptions, ILocalAuthenticationResult, SecurityLevel } from './types';
+/**
+ * Determine whether a face or fingerprint scanner is available on the device.
+ */
+export declare function hasHardwareAsync(): Promise<boolean>;
+/**
+ * Determine what kinds of authentications are available on the device. Devices can support
+ * multiple authentication methods — e.g. `[FINGERPRINT, FACIAL_RECOGNITION]` means the device
+ * supports both. Returns an empty array if none are supported.
+ */
+export declare function supportedAuthenticationTypesAsync(): Promise<AuthenticationType[]>;
+/**
+ * Determine whether the device has saved fingerprints or facial data to use for authentication.
+ */
+export declare function isEnrolledAsync(): Promise<boolean>;
+/**
+ * Determine what kind of authentication is enrolled on the device.
+ * > On Android devices prior to M, `SECRET` can be returned if only the SIM lock has been
+ * enrolled, which is not the method `authenticateAsync` prompts.
+ */
+export declare function getEnrolledLevelAsync(): Promise<SecurityLevel>;
+/**
+ * Attempts to authenticate via Fingerprint/TouchID (or FaceID if available on the device).
+ * > Apple requires apps which use FaceID to provide a description of why they use this API
+ * (`NSFaceIDUsageDescription` in `Info.plist`). Without it, the module authenticates using the
+ * device passcode instead.
+ */
+export declare function authenticateAsync(options?: ILocalAuthenticationOptions): Promise<ILocalAuthenticationResult>;
+/**
+ * Cancels the authentication flow.
+ * @platform android
+ */
+export declare function cancelAuthenticate(): Promise<void>;

package/build-ngc/core/local-authentication.js

@@ -0,0 +1,76 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import invariant from 'invariant';
+import { expoLocalAuthentication } from './native-module';
+const NATIVE_MODULE_NAME = 'expo-local-authentication';
+const DEFAULT_PROMPT_MESSAGE = 'Authenticate';
+const DEFAULT_CANCEL_LABEL = 'Cancel';
+/**
+ * Determine whether a face or fingerprint scanner is available on the device.
+ */
+export async function hasHardwareAsync() {
+    if (!expoLocalAuthentication.hasHardwareAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'hasHardwareAsync');
+    }
+    return expoLocalAuthentication.hasHardwareAsync();
+}
+/**
+ * Determine what kinds of authentications are available on the device. Devices can support
+ * multiple authentication methods — e.g. `[FINGERPRINT, FACIAL_RECOGNITION]` means the device
+ * supports both. Returns an empty array if none are supported.
+ */
+export async function supportedAuthenticationTypesAsync() {
+    if (!expoLocalAuthentication.supportedAuthenticationTypesAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'supportedAuthenticationTypesAsync');
+    }
+    return expoLocalAuthentication.supportedAuthenticationTypesAsync();
+}
+/**
+ * Determine whether the device has saved fingerprints or facial data to use for authentication.
+ */
+export async function isEnrolledAsync() {
+    if (!expoLocalAuthentication.isEnrolledAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'isEnrolledAsync');
+    }
+    return expoLocalAuthentication.isEnrolledAsync();
+}
+/**
+ * Determine what kind of authentication is enrolled on the device.
+ * > On Android devices prior to M, `SECRET` can be returned if only the SIM lock has been
+ * enrolled, which is not the method `authenticateAsync` prompts.
+ */
+export async function getEnrolledLevelAsync() {
+    if (!expoLocalAuthentication.getEnrolledLevelAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getEnrolledLevelAsync');
+    }
+    return expoLocalAuthentication.getEnrolledLevelAsync();
+}
+/**
+ * Attempts to authenticate via Fingerprint/TouchID (or FaceID if available on the device).
+ * > Apple requires apps which use FaceID to provide a description of why they use this API
+ * (`NSFaceIDUsageDescription` in `Info.plist`). Without it, the module authenticates using the
+ * device passcode instead.
+ */
+export async function authenticateAsync(options = {}) {
+    if (!expoLocalAuthentication.authenticateAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'authenticateAsync');
+    }
+    if (options.promptMessage !== undefined) {
+        invariant(typeof options.promptMessage === 'string' && options.promptMessage.length > 0, 'LocalAuthentication.authenticateAsync: `options.promptMessage` must be a non-empty string.');
+    }
+    return expoLocalAuthentication.authenticateAsync({
+        ...options,
+        promptMessage: options.promptMessage || DEFAULT_PROMPT_MESSAGE,
+        cancelLabel: options.cancelLabel || DEFAULT_CANCEL_LABEL,
+    });
+}
+/**
+ * Cancels the authentication flow.
+ * @platform android
+ */
+export async function cancelAuthenticate() {
+    if (!expoLocalAuthentication.cancelAuthenticate) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'cancelAuthenticate');
+    }
+    await expoLocalAuthentication.cancelAuthenticate();
+}
+//# sourceMappingURL=local-authentication.js.map

package/build-ngc/core/local-authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-authentication.js","sourceRoot":"","sources":["../../src/core/local-authentication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAQ1D,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AACvD,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAC9C,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC;IACrD,IAAI,CAAC,uBAAuB,CAAC,iCAAiC,EAAE,CAAC;QAC/D,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,uBAAuB,CAAC,iCAAiC,EAAE,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,uBAAuB,CAAC,eAAe,EAAE,CAAC;QAC7C,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,uBAAuB,CAAC,eAAe,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,CAAC;QACnD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,uBAAuB,CAAC,qBAAqB,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAuC,EAAE;IAEzC,IAAI,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,CAAC;QAC/C,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,SAAS,CACP,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAC7E,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IAED,OAAO,uBAAuB,CAAC,iBAAiB,CAAC;QAC/C,GAAG,OAAO;QACV,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,sBAAsB;QAC9D,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,uBAAuB,CAAC,kBAAkB,EAAE,CAAC;AACrD,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,13 @@
+import type { AuthenticationType, ILocalAuthenticationOptions, ILocalAuthenticationResult, SecurityLevel } from './types';
+export type INativeLocalAuthenticationModule = {
+    hasHardwareAsync?(): Promise<boolean>;
+    supportedAuthenticationTypesAsync?(): Promise<AuthenticationType[]>;
+    isEnrolledAsync?(): Promise<boolean>;
+    getEnrolledLevelAsync?(): Promise<SecurityLevel>;
+    authenticateAsync?(options: ILocalAuthenticationOptions & {
+        promptMessage: string;
+        cancelLabel: string;
+    }): Promise<ILocalAuthenticationResult>;
+    cancelAuthenticate?(): Promise<void>;
+};
+export declare const expoLocalAuthentication: INativeLocalAuthenticationModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_LOCAL_AUTHENTICATION_MODULE_NAME = 'ExpoLocalAuthentication';
+export const expoLocalAuthentication = requireNativeModule(EXPO_LOCAL_AUTHENTICATION_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQxD,MAAM,qCAAqC,GAAG,yBAAyB,CAAC;AAgBxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CACxD,qCAAqC,CACtC,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,83 @@
+export type ILocalAuthenticationResult = {
+    success: true;
+} | {
+    success: false;
+    error: ILocalAuthenticationError;
+    warning?: string;
+};
+export declare enum AuthenticationType {
+    /** Indicates fingerprint support. */
+    FINGERPRINT = 1,
+    /** Indicates facial recognition support. */
+    FACIAL_RECOGNITION = 2,
+    /**
+     * Indicates iris recognition support.
+     * @platform android
+     */
+    IRIS = 3
+}
+export declare enum SecurityLevel {
+    /** Indicates no enrolled authentication. */
+    NONE = 0,
+    /** Indicates non-biometric authentication (e.g. PIN, Pattern). */
+    SECRET = 1,
+    /**
+     * Indicates biometric authentication.
+     * @deprecated please use `BIOMETRIC_STRONG` or `BIOMETRIC_WEAK` instead.
+     * @hidden
+     */
+    BIOMETRIC,
+    /**
+     * Indicates weak biometric authentication. For example, a 2D image-based face unlock. There
+     * are currently no weak biometric authentication options on iOS.
+     */
+    BIOMETRIC_WEAK = 2,
+    /** Indicates strong biometric authentication. For example, a fingerprint scan or 3D face unlock. */
+    BIOMETRIC_STRONG = 3
+}
+/**
+ * Security level of the biometric authentication to allow.
+ * @platform android
+ */
+export type IBiometricsSecurityLevel = 'weak' | 'strong';
+export type ILocalAuthenticationOptions = {
+    /** A message that is shown alongside the TouchID or FaceID prompt. */
+    promptMessage?: string;
+    /**
+     * A subtitle displayed below the prompt message in the authentication prompt.
+     * @platform android
+     */
+    promptSubtitle?: string;
+    /**
+     * A description displayed in the middle of the authentication prompt.
+     * @platform android
+     */
+    promptDescription?: string;
+    /** Allows customizing the default `Cancel` label shown. */
+    cancelLabel?: string;
+    /**
+     * After several failed attempts, the system falls back to the device passcode. This setting
+     * allows you to disable this option and instead handle the fallback yourself. Defaults to `false`.
+     */
+    disableDeviceFallback?: boolean;
+    /**
+     * Sets a hint to the system for whether to require user confirmation after authentication.
+     * Defaults to `true`.
+     * @platform android
+     */
+    requireConfirmation?: boolean;
+    /**
+     * Sets the security class of biometric authentication to allow. `strong` allows only Android
+     * Class 3 biometrics; `weak` allows both Class 3 and Class 2.
+     * @platform android
+     * @default 'weak'
+     */
+    biometricsSecurityLevel?: IBiometricsSecurityLevel;
+    /**
+     * Allows customizing the default `Use Passcode` label shown after several failed attempts. An
+     * empty string disables the button.
+     * @platform ios
+     */
+    fallbackLabel?: string;
+};
+export type ILocalAuthenticationError = 'not_enrolled' | 'user_cancel' | 'app_cancel' | 'not_available' | 'lockout' | 'no_space' | 'timeout' | 'unable_to_process' | 'unknown' | 'system_cancel' | 'user_fallback' | 'invalid_context' | 'passcode_not_set' | 'authentication_failed';

package/build-ngc/core/types.js

@@ -0,0 +1,56 @@
+// expo-local-authentication's own types file imports Platform from the `expo` meta-package. We
+// never depend on `expo` itself (it drags in a second Metro/babel pipeline — see the
+// symbiote-expo-native-module skill) so this pulls Platform straight from expo-modules-core,
+// which is where `expo` re-exports it from — same source device-sensor.ts (packages/sensors)
+// uses for the same reason.
+import { Platform } from 'expo-modules-core';
+export var AuthenticationType;
+(function (AuthenticationType) {
+    /** Indicates fingerprint support. */
+    AuthenticationType[AuthenticationType["FINGERPRINT"] = 1] = "FINGERPRINT";
+    /** Indicates facial recognition support. */
+    AuthenticationType[AuthenticationType["FACIAL_RECOGNITION"] = 2] = "FACIAL_RECOGNITION";
+    /**
+     * Indicates iris recognition support.
+     * @platform android
+     */
+    AuthenticationType[AuthenticationType["IRIS"] = 3] = "IRIS";
+})(AuthenticationType || (AuthenticationType = {}));
+export var SecurityLevel;
+(function (SecurityLevel) {
+    /** Indicates no enrolled authentication. */
+    SecurityLevel[SecurityLevel["NONE"] = 0] = "NONE";
+    /** Indicates non-biometric authentication (e.g. PIN, Pattern). */
+    SecurityLevel[SecurityLevel["SECRET"] = 1] = "SECRET";
+    /**
+     * Indicates biometric authentication.
+     * @deprecated please use `BIOMETRIC_STRONG` or `BIOMETRIC_WEAK` instead.
+     * @hidden
+     */
+    SecurityLevel[SecurityLevel["BIOMETRIC"] = Platform.OS === 'android'
+        ? SecurityLevel.BIOMETRIC_WEAK
+        : SecurityLevel.BIOMETRIC_STRONG] = "BIOMETRIC";
+    /**
+     * Indicates weak biometric authentication. For example, a 2D image-based face unlock. There
+     * are currently no weak biometric authentication options on iOS.
+     */
+    SecurityLevel[SecurityLevel["BIOMETRIC_WEAK"] = 2] = "BIOMETRIC_WEAK";
+    /** Indicates strong biometric authentication. For example, a fingerprint scan or 3D face unlock. */
+    SecurityLevel[SecurityLevel["BIOMETRIC_STRONG"] = 3] = "BIOMETRIC_STRONG";
+})(SecurityLevel || (SecurityLevel = {}));
+// Upstream deprecation shim: SecurityLevel.BIOMETRIC used to be a real enum member; it's now a
+// getter aliasing to the platform-correct strong/weak member, so old call sites still resolve
+// but see a console warning steering them to the non-deprecated name.
+Object.defineProperty(SecurityLevel, 'BIOMETRIC', {
+    get() {
+        const additionalMessage = Platform.OS === 'android'
+            ? '. `SecurityLevel.BIOMETRIC` is currently an alias for `SecurityLevel.BIOMETRIC_WEAK` on Android, which might lead to unexpected behaviour.'
+            : '';
+        console.warn('`SecurityLevel.BIOMETRIC` has been deprecated. Use `SecurityLevel.BIOMETRIC_WEAK` or `SecurityLevel.BIOMETRIC_STRONG` instead' +
+            additionalMessage);
+        return Platform.OS === 'android'
+            ? SecurityLevel.BIOMETRIC_WEAK
+            : SecurityLevel.BIOMETRIC_STRONG;
+    },
+});
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,qFAAqF;AACrF,6FAA6F;AAC7F,6FAA6F;AAC7F,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAU7C,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,qCAAqC;IACrC,yEAAe,CAAA;IACf,4CAA4C;IAC5C,uFAAsB,CAAA;IACtB;;;OAGG;IACH,2DAAQ,CAAA;AACV,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B;AAED,MAAM,CAAN,IAAY,aAoBX;AApBD,WAAY,aAAa;IACvB,4CAA4C;IAC5C,iDAAQ,CAAA;IACR,kEAAkE;IAClE,qDAAU,CAAA;IACV;;;;OAIG;IACH,2CAAY,QAAQ,CAAC,EAAE,KAAK,SAAS;QACnC,CAAC,CAAC,aAAa,CAAC,cAAc;QAC9B,CAAC,CAAC,aAAa,CAAC,gBAAgB,eAAA,CAAA;IAClC;;;OAGG;IACH,qEAAkB,CAAA;IAClB,oGAAoG;IACpG,yEAAoB,CAAA;AACtB,CAAC,EApBW,aAAa,KAAb,aAAa,QAoBxB;AAED,+FAA+F;AAC/F,8FAA8F;AAC9F,sEAAsE;AACtE,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,WAAW,EAAE;IAChD,GAAG;QACD,MAAM,iBAAiB,GACrB,QAAQ,CAAC,EAAE,KAAK,SAAS;YACvB,CAAC,CAAC,4IAA4I;YAC9I,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CACV,+HAA+H;YAC7H,iBAAiB,CACpB,CAAC;QACF,OAAO,QAAQ,CAAC,EAAE,KAAK,SAAS;YAC9B,CAAC,CAAC,aAAa,CAAC,cAAc;YAC9B,CAAC,CAAC,aAAa,CAAC,gBAAgB,CAAC;IACrC,CAAC;CACF,CAAC,CAAC"}

package/native-link.json

@@ -0,0 +1,17 @@
+{
+  "android": {
+    "gradleProjectName": "expo-local-authentication",
+    "modules": [
+      {
+        "importPath": "expo.modules.localauthentication.LocalAuthenticationModule",
+        "className": "LocalAuthenticationModule",
+        "nativeName": "ExpoLocalAuthentication"
+      }
+    ]
+  },
+  "ios": {
+    "infoPlistKeys": {
+      "NSFaceIDUsageDescription": "This app uses Face ID to authenticate you."
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "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.",
+  "version": "0.3.0",
+  "description": "expo-local-authentication wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. FaceID/TouchID on iOS, the Fingerprint/Biometric API on Android.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -13,7 +13,114 @@
     "url": "https://github.com/OneEyed1366/symbiote-native/issues"
   },
   "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./svelte": {
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "expo-local-authentication": "57.0.2",
+    "expo-modules-core": "57.0.5",
+    "invariant": "^2.2.4"
+  },
+  "peerDependencies": {
+    "@symbiote-native/angular": ">=0.6.2",
+    "@symbiote-native/engine": ">=0.1.7",
+    "@symbiote-native/react": ">=0.2.8",
+    "@symbiote-native/svelte": ">=0.1.0",
+    "@symbiote-native/vue": ">=0.3.8",
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/invariant": "^2.2.37",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "0.7.0",
+    "@symbiote-native/engine": "0.2.0",
+    "@symbiote-native/react": "0.3.0",
+    "@symbiote-native/svelte": "0.2.0",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/vue": "0.4.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
   }
-}
+}

package/src/angular/index.ts

@@ -0,0 +1,4 @@
+// @symbiote-native/local-auth/angular: the Angular entry over the framework-agnostic core. Same
+// reasoning as the React/Vue entries — no per-instance state or event stream to wrap in a
+// service, so this is a plain re-export.
+export * from '../core';

package/src/core/index.ts

@@ -0,0 +1,16 @@
+export {
+  hasHardwareAsync,
+  supportedAuthenticationTypesAsync,
+  isEnrolledAsync,
+  getEnrolledLevelAsync,
+  authenticateAsync,
+  cancelAuthenticate,
+} from './local-authentication';
+export {
+  AuthenticationType,
+  SecurityLevel,
+  type IBiometricsSecurityLevel,
+  type ILocalAuthenticationOptions,
+  type ILocalAuthenticationResult,
+  type ILocalAuthenticationError,
+} from './types';

package/src/core/local-authentication.ts

@@ -0,0 +1,96 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import invariant from 'invariant';
+
+import { expoLocalAuthentication } from './native-module';
+import type {
+  AuthenticationType,
+  ILocalAuthenticationOptions,
+  ILocalAuthenticationResult,
+  SecurityLevel,
+} from './types';
+
+const NATIVE_MODULE_NAME = 'expo-local-authentication';
+const DEFAULT_PROMPT_MESSAGE = 'Authenticate';
+const DEFAULT_CANCEL_LABEL = 'Cancel';
+
+/**
+ * Determine whether a face or fingerprint scanner is available on the device.
+ */
+export async function hasHardwareAsync(): Promise<boolean> {
+  if (!expoLocalAuthentication.hasHardwareAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'hasHardwareAsync');
+  }
+  return expoLocalAuthentication.hasHardwareAsync();
+}
+
+/**
+ * Determine what kinds of authentications are available on the device. Devices can support
+ * multiple authentication methods — e.g. `[FINGERPRINT, FACIAL_RECOGNITION]` means the device
+ * supports both. Returns an empty array if none are supported.
+ */
+export async function supportedAuthenticationTypesAsync(): Promise<AuthenticationType[]> {
+  if (!expoLocalAuthentication.supportedAuthenticationTypesAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'supportedAuthenticationTypesAsync');
+  }
+  return expoLocalAuthentication.supportedAuthenticationTypesAsync();
+}
+
+/**
+ * Determine whether the device has saved fingerprints or facial data to use for authentication.
+ */
+export async function isEnrolledAsync(): Promise<boolean> {
+  if (!expoLocalAuthentication.isEnrolledAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'isEnrolledAsync');
+  }
+  return expoLocalAuthentication.isEnrolledAsync();
+}
+
+/**
+ * Determine what kind of authentication is enrolled on the device.
+ * > On Android devices prior to M, `SECRET` can be returned if only the SIM lock has been
+ * enrolled, which is not the method `authenticateAsync` prompts.
+ */
+export async function getEnrolledLevelAsync(): Promise<SecurityLevel> {
+  if (!expoLocalAuthentication.getEnrolledLevelAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getEnrolledLevelAsync');
+  }
+  return expoLocalAuthentication.getEnrolledLevelAsync();
+}
+
+/**
+ * Attempts to authenticate via Fingerprint/TouchID (or FaceID if available on the device).
+ * > Apple requires apps which use FaceID to provide a description of why they use this API
+ * (`NSFaceIDUsageDescription` in `Info.plist`). Without it, the module authenticates using the
+ * device passcode instead.
+ */
+export async function authenticateAsync(
+  options: ILocalAuthenticationOptions = {},
+): Promise<ILocalAuthenticationResult> {
+  if (!expoLocalAuthentication.authenticateAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'authenticateAsync');
+  }
+
+  if (options.promptMessage !== undefined) {
+    invariant(
+      typeof options.promptMessage === 'string' && options.promptMessage.length > 0,
+      'LocalAuthentication.authenticateAsync: `options.promptMessage` must be a non-empty string.',
+    );
+  }
+
+  return expoLocalAuthentication.authenticateAsync({
+    ...options,
+    promptMessage: options.promptMessage || DEFAULT_PROMPT_MESSAGE,
+    cancelLabel: options.cancelLabel || DEFAULT_CANCEL_LABEL,
+  });
+}
+
+/**
+ * Cancels the authentication flow.
+ * @platform android
+ */
+export async function cancelAuthenticate(): Promise<void> {
+  if (!expoLocalAuthentication.cancelAuthenticate) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'cancelAuthenticate');
+  }
+  await expoLocalAuthentication.cancelAuthenticate();
+}

package/src/core/native-module.ts

@@ -0,0 +1,27 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  AuthenticationType,
+  ILocalAuthenticationOptions,
+  ILocalAuthenticationResult,
+  SecurityLevel,
+} from './types';
+
+const EXPO_LOCAL_AUTHENTICATION_MODULE_NAME = 'ExpoLocalAuthentication';
+
+// Every method is optional — each call site checks for its presence before calling through and
+// throws an UnavailabilityError itself, matching upstream's own per-platform capability checks
+// rather than assuming the native module implements the whole surface.
+export type INativeLocalAuthenticationModule = {
+  hasHardwareAsync?(): Promise<boolean>;
+  supportedAuthenticationTypesAsync?(): Promise<AuthenticationType[]>;
+  isEnrolledAsync?(): Promise<boolean>;
+  getEnrolledLevelAsync?(): Promise<SecurityLevel>;
+  authenticateAsync?(
+    options: ILocalAuthenticationOptions & { promptMessage: string; cancelLabel: string },
+  ): Promise<ILocalAuthenticationResult>;
+  cancelAuthenticate?(): Promise<void>;
+};
+
+export const expoLocalAuthentication = requireNativeModule<INativeLocalAuthenticationModule>(
+  EXPO_LOCAL_AUTHENTICATION_MODULE_NAME,
+);