@symbiote-native/apple-authentication 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,104 @@
+/** Scopes for `signInAsync`, the user may deny any of them, so handle `null` fields */
+export declare enum AppleAuthenticationScope {
+    FULL_NAME = 0,
+    EMAIL = 1
+}
+export declare enum AppleAuthenticationOperation {
+    /** An operation that depends on the particular kind of credential provider */
+    IMPLICIT = 0,
+    LOGIN = 1,
+    REFRESH = 2,
+    LOGOUT = 3
+}
+/** The state of a credential checked with `getCredentialStateAsync` */
+export declare enum AppleAuthenticationCredentialState {
+    REVOKED = 0,
+    AUTHORIZED = 1,
+    NOT_FOUND = 2,
+    TRANSFERRED = 3
+}
+/** The system's guess of how likely the user is a real person */
+export declare enum AppleAuthenticationUserDetectionStatus {
+    /** The system does not support this determination and there is no data */
+    UNSUPPORTED = 0,
+    /** The system has not determined whether the user might be a real person */
+    UNKNOWN = 1,
+    /** The user appears to be a real person */
+    LIKELY_REAL = 2
+}
+/** Which pre-defined text the button shows */
+export declare enum AppleAuthenticationButtonType {
+    /** "Sign in with Apple" */
+    SIGN_IN = 0,
+    /** "Continue with Apple" */
+    CONTINUE = 1,
+    /**
+     * "Sign up with Apple"
+     * @platform ios 13.2+
+     */
+    SIGN_UP = 2
+}
+/** Which pre-defined color scheme the button uses */
+export declare enum AppleAuthenticationButtonStyle {
+    /** White button with black text */
+    WHITE = 0,
+    /** White button with a black outline and black text */
+    WHITE_OUTLINE = 1,
+    /** Black button with white text */
+    BLACK = 2
+}
+/** The style a name is formatted in, see `formatFullName` */
+export type IAppleAuthenticationFullNameFormatStyle = 'default' | 'short' | 'medium' | 'long' | 'abbreviated';
+/** The tokenized portions of the user's name, only what the user allowed is not `null` */
+export type IAppleAuthenticationFullName = {
+    namePrefix: string | null;
+    givenName: string | null;
+    middleName: string | null;
+    familyName: string | null;
+    nameSuffix: string | null;
+    nickname: string | null;
+};
+type IRequestOptions = {
+    /**
+     * Scopes the app asks for, they come only the first time a user signs in
+     * @default []
+     */
+    requestedScopes?: AppleAuthenticationScope[];
+    /** An arbitrary string returned unmodified in the credential, it guards against replay attacks */
+    state?: string;
+};
+/** Options for `signInAsync`, none is required */
+export type IAppleAuthenticationSignInOptions = IRequestOptions & {
+    /** An arbitrary string that prevents replay attacks */
+    nonce?: string;
+};
+/** Options for `refreshAsync`, `user` is the id of the user whose credentials refresh */
+export type IAppleAuthenticationRefreshOptions = IRequestOptions & {
+    user: string;
+};
+/** Options for `signOutAsync`, `user` is the id of the user to sign out */
+export type IAppleAuthenticationSignOutOptions = {
+    user: string;
+    state?: string;
+};
+/** What a successful `signInAsync`, `refreshAsync` or `signOutAsync` resolves with */
+export type IAppleAuthenticationCredential = {
+    /** Stable across apps of one development team, use it to check the user later */
+    user: string;
+    /** The `state` the request carried, `null` when none was given */
+    state: string | null;
+    /** `null` without the `FULL_NAME` scope, on a denial, or after the first sign-in */
+    fullName: IAppleAuthenticationFullName | null;
+    /** Obscured with an Apple domain when the user withholds the address */
+    email: string | null;
+    realUserStatus: AppleAuthenticationUserDetectionStatus;
+    /** A JSON Web Token with information about the user */
+    identityToken: string | null;
+    /** A short-lived session token for the app's server, it changes every session */
+    authorizationCode: string | null;
+};
+/** What the native module accepts: the options of a call plus the operation it performs */
+export type IAppleAuthenticationRequest = (IAppleAuthenticationSignInOptions | IAppleAuthenticationRefreshOptions | IAppleAuthenticationSignOutOptions) & {
+    requestedOperation: AppleAuthenticationOperation;
+};
+export {};

package/build-ngc/core/types.js

@@ -0,0 +1,57 @@
+// Типы и enum-ы `expo-apple-authentication`, порт `AppleAuthentication.types.ts`
+/** Scopes for `signInAsync`, the user may deny any of them, so handle `null` fields */
+export var AppleAuthenticationScope;
+(function (AppleAuthenticationScope) {
+    AppleAuthenticationScope[AppleAuthenticationScope["FULL_NAME"] = 0] = "FULL_NAME";
+    AppleAuthenticationScope[AppleAuthenticationScope["EMAIL"] = 1] = "EMAIL";
+})(AppleAuthenticationScope || (AppleAuthenticationScope = {}));
+export var AppleAuthenticationOperation;
+(function (AppleAuthenticationOperation) {
+    /** An operation that depends on the particular kind of credential provider */
+    AppleAuthenticationOperation[AppleAuthenticationOperation["IMPLICIT"] = 0] = "IMPLICIT";
+    AppleAuthenticationOperation[AppleAuthenticationOperation["LOGIN"] = 1] = "LOGIN";
+    AppleAuthenticationOperation[AppleAuthenticationOperation["REFRESH"] = 2] = "REFRESH";
+    AppleAuthenticationOperation[AppleAuthenticationOperation["LOGOUT"] = 3] = "LOGOUT";
+})(AppleAuthenticationOperation || (AppleAuthenticationOperation = {}));
+/** The state of a credential checked with `getCredentialStateAsync` */
+export var AppleAuthenticationCredentialState;
+(function (AppleAuthenticationCredentialState) {
+    AppleAuthenticationCredentialState[AppleAuthenticationCredentialState["REVOKED"] = 0] = "REVOKED";
+    AppleAuthenticationCredentialState[AppleAuthenticationCredentialState["AUTHORIZED"] = 1] = "AUTHORIZED";
+    AppleAuthenticationCredentialState[AppleAuthenticationCredentialState["NOT_FOUND"] = 2] = "NOT_FOUND";
+    AppleAuthenticationCredentialState[AppleAuthenticationCredentialState["TRANSFERRED"] = 3] = "TRANSFERRED";
+})(AppleAuthenticationCredentialState || (AppleAuthenticationCredentialState = {}));
+/** The system's guess of how likely the user is a real person */
+export var AppleAuthenticationUserDetectionStatus;
+(function (AppleAuthenticationUserDetectionStatus) {
+    /** The system does not support this determination and there is no data */
+    AppleAuthenticationUserDetectionStatus[AppleAuthenticationUserDetectionStatus["UNSUPPORTED"] = 0] = "UNSUPPORTED";
+    /** The system has not determined whether the user might be a real person */
+    AppleAuthenticationUserDetectionStatus[AppleAuthenticationUserDetectionStatus["UNKNOWN"] = 1] = "UNKNOWN";
+    /** The user appears to be a real person */
+    AppleAuthenticationUserDetectionStatus[AppleAuthenticationUserDetectionStatus["LIKELY_REAL"] = 2] = "LIKELY_REAL";
+})(AppleAuthenticationUserDetectionStatus || (AppleAuthenticationUserDetectionStatus = {}));
+/** Which pre-defined text the button shows */
+export var AppleAuthenticationButtonType;
+(function (AppleAuthenticationButtonType) {
+    /** "Sign in with Apple" */
+    AppleAuthenticationButtonType[AppleAuthenticationButtonType["SIGN_IN"] = 0] = "SIGN_IN";
+    /** "Continue with Apple" */
+    AppleAuthenticationButtonType[AppleAuthenticationButtonType["CONTINUE"] = 1] = "CONTINUE";
+    /**
+     * "Sign up with Apple"
+     * @platform ios 13.2+
+     */
+    AppleAuthenticationButtonType[AppleAuthenticationButtonType["SIGN_UP"] = 2] = "SIGN_UP";
+})(AppleAuthenticationButtonType || (AppleAuthenticationButtonType = {}));
+/** Which pre-defined color scheme the button uses */
+export var AppleAuthenticationButtonStyle;
+(function (AppleAuthenticationButtonStyle) {
+    /** White button with black text */
+    AppleAuthenticationButtonStyle[AppleAuthenticationButtonStyle["WHITE"] = 0] = "WHITE";
+    /** White button with a black outline and black text */
+    AppleAuthenticationButtonStyle[AppleAuthenticationButtonStyle["WHITE_OUTLINE"] = 1] = "WHITE_OUTLINE";
+    /** Black button with white text */
+    AppleAuthenticationButtonStyle[AppleAuthenticationButtonStyle["BLACK"] = 2] = "BLACK";
+})(AppleAuthenticationButtonStyle || (AppleAuthenticationButtonStyle = {}));
+//# 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,iFAAiF;AAEjF,uFAAuF;AACvF,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,iFAAa,CAAA;IACb,yEAAS,CAAA;AACX,CAAC,EAHW,wBAAwB,KAAxB,wBAAwB,QAGnC;AAED,MAAM,CAAN,IAAY,4BAMX;AAND,WAAY,4BAA4B;IACtC,8EAA8E;IAC9E,uFAAY,CAAA;IACZ,iFAAS,CAAA;IACT,qFAAW,CAAA;IACX,mFAAU,CAAA;AACZ,CAAC,EANW,4BAA4B,KAA5B,4BAA4B,QAMvC;AAED,uEAAuE;AACvE,MAAM,CAAN,IAAY,kCAKX;AALD,WAAY,kCAAkC;IAC5C,iGAAO,CAAA;IACP,uGAAU,CAAA;IACV,qGAAS,CAAA;IACT,yGAAW,CAAA;AACb,CAAC,EALW,kCAAkC,KAAlC,kCAAkC,QAK7C;AAED,iEAAiE;AACjE,MAAM,CAAN,IAAY,sCAOX;AAPD,WAAY,sCAAsC;IAChD,0EAA0E;IAC1E,iHAAW,CAAA;IACX,4EAA4E;IAC5E,yGAAO,CAAA;IACP,2CAA2C;IAC3C,iHAAW,CAAA;AACb,CAAC,EAPW,sCAAsC,KAAtC,sCAAsC,QAOjD;AAED,8CAA8C;AAC9C,MAAM,CAAN,IAAY,6BAUX;AAVD,WAAY,6BAA6B;IACvC,2BAA2B;IAC3B,uFAAO,CAAA;IACP,4BAA4B;IAC5B,yFAAQ,CAAA;IACR;;;OAGG;IACH,uFAAO,CAAA;AACT,CAAC,EAVW,6BAA6B,KAA7B,6BAA6B,QAUxC;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,8BAOX;AAPD,WAAY,8BAA8B;IACxC,mCAAmC;IACnC,qFAAK,CAAA;IACL,uDAAuD;IACvD,qGAAa,CAAA;IACb,mCAAmC;IACnC,qFAAK,CAAA;AACP,CAAC,EAPW,8BAA8B,KAA9B,8BAA8B,QAOzC"}

package/native-link.json

@@ -0,0 +1,11 @@
+{
+  "ios": {
+    "upstreamPackage": "expo-apple-authentication",
+    "infoPlistBooleanKeys": {
+      "CFBundleAllowMixedLocalizations": true
+    },
+    "entitlements": {
+      "com.apple.developer.applesignin": ["Default"]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,148 @@
 {
   "name": "@symbiote-native/apple-authentication",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "expo-apple-authentication wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Sign in with Apple: the credential flow and the native button, iOS only.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/apple-authentication"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/apple-authentication#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-apple-authentication",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "sign-in-with-apple",
+    "apple-authentication"
+  ],
+  "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": "./src/svelte/index.ts",
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/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-apple-authentication": "57.0.2",
+    "expo-modules-core": "57.0.20",
+    "@symbiote-native/components": "3.2.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.3.0",
+    "@symbiote-native/engine": "^1.6.0",
+    "@symbiote-native/react": "^3.3.0",
+    "@symbiote-native/solid": "^3.2.0",
+    "@symbiote-native/svelte": "^3.2.0",
+    "@symbiote-native/vue": "^3.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "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/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.3.0",
+    "@symbiote-native/engine": "1.6.0",
+    "@symbiote-native/react": "3.3.0",
+    "@symbiote-native/solid": "3.2.0",
+    "@symbiote-native/svelte": "3.2.0",
+    "@symbiote-native/test-utils": "0.4.7",
+    "@symbiote-native/vue": "3.3.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/apple-authentication-button/index.ts

@@ -0,0 +1,36 @@
+import { ChangeDetectionStrategy, Component, Input } from '@angular/core';
+import { DescriptorOutlet, NativeViewBase } from '@symbiote-native/angular';
+import type { IDescriptor } from '@symbiote-native/components';
+import { renderAppleAuthenticationButton } from '../../core/apple-authentication-button';
+import type { IAppleAuthenticationButtonProps } from '../../core/apple-authentication-button';
+
+/** Angular twin of `expo-apple-authentication`'s `AppleAuthenticationButton`, iOS only */
+@Component({
+  selector: 'AppleAuthenticationButton',
+  standalone: true,
+  imports: [DescriptorOutlet],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  template: `@if (descriptor; as node) {
+    <symbiote-descriptor-outlet [node]="node" />
+  }`,
+})
+export class AppleAuthenticationButton extends NativeViewBase {
+  @Input({ required: true })
+  onPress!: IAppleAuthenticationButtonProps['onPress'];
+  @Input({ required: true })
+  buttonType!: IAppleAuthenticationButtonProps['buttonType'];
+  @Input({ required: true })
+  buttonStyle!: IAppleAuthenticationButtonProps['buttonStyle'];
+  @Input() cornerRadius?: IAppleAuthenticationButtonProps['cornerRadius'];
+
+  protected override readonly propNames = [
+    'onPress',
+    'buttonType',
+    'buttonStyle',
+    'cornerRadius',
+  ] as const satisfies readonly (keyof AppleAuthenticationButton)[];
+
+  protected override renderView(props: object): IDescriptor | null {
+    return renderAppleAuthenticationButton(props);
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,28 @@
+// @symbiote-native/apple-authentication/angular: кнопка и поток входа на общем ядре
+
+export { AppleAuthenticationButton } from './apple-authentication-button';
+export {
+  APPLE_AUTHENTICATION_MODULE_NAME,
+  AppleAuthenticationButtonStyle,
+  AppleAuthenticationButtonType,
+  AppleAuthenticationCredentialState,
+  AppleAuthenticationOperation,
+  AppleAuthenticationScope,
+  AppleAuthenticationUserDetectionStatus,
+  addRevokeListener,
+  appleAuthenticationButtonViewName,
+  formatFullName,
+  getCredentialStateAsync,
+  isAvailableAsync,
+  refreshAsync,
+  signInAsync,
+  signOutAsync,
+  type EventSubscription,
+  type IAppleAuthenticationButtonProps,
+  type IAppleAuthenticationCredential,
+  type IAppleAuthenticationFullName,
+  type IAppleAuthenticationFullNameFormatStyle,
+  type IAppleAuthenticationRefreshOptions,
+  type IAppleAuthenticationSignInOptions,
+  type IAppleAuthenticationSignOutOptions,
+} from '../core';

package/src/core/apple-authentication-button.ts

@@ -0,0 +1,69 @@
+// Ядро `AppleAuthenticationButton`: нативный view системной кнопки Sign in with Apple, только iOS
+import { Platform, requireNativeViewManager } from 'expo-modules-core';
+import { el } from '@symbiote-native/components';
+import type {
+  IAccessibilityProps,
+  IAriaProps,
+  IDescriptor,
+  IResponderProps,
+} from '@symbiote-native/components';
+import { defineExpoNativeView, isDevBuild } from '@symbiote-native/engine';
+import type {
+  IStyleProp,
+  ISymbioteEvent,
+  IViewStyle,
+} from '@symbiote-native/engine';
+import { APPLE_AUTHENTICATION_MODULE_NAME } from './constants';
+import type {
+  AppleAuthenticationButtonStyle,
+  AppleAuthenticationButtonType,
+} from './types';
+
+const PRESS_EVENT_PROP = 'onButtonPress';
+
+// Фон и скругление задают `buttonStyle` и `cornerRadius`, а не `style`, это правило App Store
+export type IAppleAuthenticationButtonProps = IAccessibilityProps &
+  IAriaProps &
+  IResponderProps & {
+    /** Call `signInAsync` in here */
+    onPress: () => void;
+    buttonType: AppleAuthenticationButtonType;
+    buttonStyle: AppleAuthenticationButtonStyle;
+    /** Works like `style.borderRadius` of a View */
+    cornerRadius?: number;
+    /** Needs a width and a height, or the button does not appear */
+    style?: IStyleProp<Omit<IViewStyle, 'backgroundColor' | 'borderRadius'>>;
+    testID?: string;
+    nativeID?: string;
+    onLayout?: (event: ISymbioteEvent) => void;
+  };
+
+// Регистрация идёт при рендере: побочный эффект барреля теряется в release
+const buttonView = defineExpoNativeView(
+  requireNativeViewManager,
+  APPLE_AUTHENTICATION_MODULE_NAME,
+);
+
+export const appleAuthenticationButtonViewName = buttonView.name;
+
+export function ensureAppleAuthenticationButtonRegistered(): boolean {
+  if (!Platform.select({ ios: true, default: false })) return false;
+  return buttonView.ensureRegistered();
+}
+
+/** `null` means the caller renders nothing, the system button exists only on iOS */
+export function renderAppleAuthenticationButton(
+  props: object,
+): IDescriptor | null {
+  if (!ensureAppleAuthenticationButtonRegistered()) {
+    if (isDevBuild()) {
+      console.warn("'AppleAuthenticationButton' is not available.");
+    }
+    return null;
+  }
+  const { onPress, ...viewProps } = Object.fromEntries(Object.entries(props));
+  return el(appleAuthenticationButtonViewName(), {
+    ...viewProps,
+    [PRESS_EVENT_PROP]: onPress,
+  });
+}

package/src/core/apple-authentication.ts

@@ -0,0 +1,130 @@
+import { CodedError, UnavailabilityError } from 'expo-modules-core';
+import type { EventSubscription } from 'expo-modules-core';
+import { REVOKE_EVENT_NAME } from './constants';
+import { expoAppleAuthentication } from './native-module';
+import { AppleAuthenticationOperation } from './types';
+import type {
+  AppleAuthenticationCredentialState,
+  IAppleAuthenticationCredential,
+  IAppleAuthenticationFullName,
+  IAppleAuthenticationFullNameFormatStyle,
+  IAppleAuthenticationRefreshOptions,
+  IAppleAuthenticationRequest,
+  IAppleAuthenticationSignInOptions,
+  IAppleAuthenticationSignOutOptions,
+} from './types';
+
+const NATIVE_MODULE_NAME = 'expo-apple-authentication';
+
+// Сообщение ссылается на имя вызванной функции, поэтому оно приходит параметром
+async function requestCredential(
+  functionName: string,
+  request: IAppleAuthenticationRequest,
+): Promise<IAppleAuthenticationCredential> {
+  if (!expoAppleAuthentication.requestAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, functionName);
+  }
+  return expoAppleAuthentication.requestAsync(request);
+}
+
+// Вход и обновление возвращают токены, без них учётные данные бесполезны
+async function requestCompleteCredential(
+  functionName: string,
+  request: IAppleAuthenticationRequest,
+): Promise<IAppleAuthenticationCredential> {
+  const credential = await requestCredential(functionName, request);
+  if (
+    !credential.authorizationCode ||
+    !credential.identityToken ||
+    !credential.user
+  ) {
+    throw new CodedError(
+      'ERR_REQUEST_FAILED',
+      `The credential returned by \`${functionName}\` is missing one or more required fields.`,
+    );
+  }
+  return credential;
+}
+
+/**
+ * Whether the device's operating system supports Apple authentication
+ * @returns `true` when the system supports it, `false` otherwise
+ */
+export async function isAvailableAsync(): Promise<boolean> {
+  if (!expoAppleAuthentication.isAvailableAsync) return false;
+  return expoAppleAuthentication.isAvailableAsync();
+}
+
+/**
+ * Starts the Apple authentication flow, which presents a modal over the app
+ * The credential carries the name and email only the first time a user signs in, store it
+ * @returns The credential, rejects with `ERR_REQUEST_CANCELED` when the user cancels
+ */
+export async function signInAsync(
+  options?: IAppleAuthenticationSignInOptions,
+): Promise<IAppleAuthenticationCredential> {
+  return requestCompleteCredential('signInAsync', {
+    ...options,
+    requestedOperation: AppleAuthenticationOperation.LOGIN,
+  });
+}
+
+/**
+ * Refreshes the credentials of the logged-in user, the sign in modal shows first
+ * @returns The credential, rejects with `ERR_REQUEST_CANCELED` when the user cancels
+ */
+export async function refreshAsync(
+  options: IAppleAuthenticationRefreshOptions,
+): Promise<IAppleAuthenticationCredential> {
+  return requestCompleteCredential('refreshAsync', {
+    ...options,
+    requestedOperation: AppleAuthenticationOperation.REFRESH,
+  });
+}
+
+/**
+ * Ends the authenticated session, the sign in modal shows first
+ * Clearing the stored user data after `signInAsync` is the recommended way to sign out
+ * @returns The credential, rejects with `ERR_REQUEST_CANCELED` when the user cancels
+ */
+export async function signOutAsync(
+  options: IAppleAuthenticationSignOutOptions,
+): Promise<IAppleAuthenticationCredential> {
+  return requestCredential('signOutAsync', {
+    ...options,
+    requestedOperation: AppleAuthenticationOperation.LOGOUT,
+  });
+}
+
+/**
+ * Whether the credential of a user is still valid or was revoked
+ * On the iOS simulator it always throws, test on a real device
+ * @param user The `user` field of an `IAppleAuthenticationCredential`
+ */
+export async function getCredentialStateAsync(
+  user: string,
+): Promise<AppleAuthenticationCredentialState> {
+  if (!expoAppleAuthentication.getCredentialStateAsync) {
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getCredentialStateAsync',
+    );
+  }
+  return expoAppleAuthentication.getCredentialStateAsync(user);
+}
+
+/** A locale-aware string of a person's name built from its tokenized portions */
+export function formatFullName(
+  fullName: IAppleAuthenticationFullName,
+  formatStyle?: IAppleAuthenticationFullNameFormatStyle,
+): string {
+  if (!expoAppleAuthentication.formatFullName) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'formatFullName');
+  }
+  return expoAppleAuthentication.formatFullName(fullName, formatStyle);
+}
+
+/** Calls the listener when the user revokes the credential of the app in the system settings */
+export function addRevokeListener(listener: () => void): EventSubscription {
+  return expoAppleAuthentication.addListener(REVOKE_EVENT_NAME, listener);
+}

package/src/core/constants.ts

@@ -0,0 +1,5 @@
+// Отдельно от `native-module`: оно резолвит нативный модуль при импорте, а имя нужно и view
+
+export const APPLE_AUTHENTICATION_MODULE_NAME = 'ExpoAppleAuthentication';
+
+export const REVOKE_EVENT_NAME = 'Expo.appleIdCredentialRevoked';

package/src/core/index.ts

@@ -0,0 +1,31 @@
+export {
+  addRevokeListener,
+  formatFullName,
+  getCredentialStateAsync,
+  isAvailableAsync,
+  refreshAsync,
+  signInAsync,
+  signOutAsync,
+} from './apple-authentication';
+export {
+  appleAuthenticationButtonViewName,
+  ensureAppleAuthenticationButtonRegistered,
+  renderAppleAuthenticationButton,
+  type IAppleAuthenticationButtonProps,
+} from './apple-authentication-button';
+export { APPLE_AUTHENTICATION_MODULE_NAME } from './constants';
+export {
+  AppleAuthenticationButtonStyle,
+  AppleAuthenticationButtonType,
+  AppleAuthenticationCredentialState,
+  AppleAuthenticationOperation,
+  AppleAuthenticationScope,
+  AppleAuthenticationUserDetectionStatus,
+  type IAppleAuthenticationCredential,
+  type IAppleAuthenticationFullName,
+  type IAppleAuthenticationFullNameFormatStyle,
+  type IAppleAuthenticationRefreshOptions,
+  type IAppleAuthenticationSignInOptions,
+  type IAppleAuthenticationSignOutOptions,
+} from './types';
+export type { EventSubscription } from 'expo-modules-core';

package/src/core/native-module.ts

@@ -0,0 +1,38 @@
+import { requireOptionalNativeModule } from 'expo-modules-core';
+import type { EventSubscription } from 'expo-modules-core';
+import { APPLE_AUTHENTICATION_MODULE_NAME } from './constants';
+import type {
+  IAppleAuthenticationCredential,
+  IAppleAuthenticationFullName,
+  IAppleAuthenticationFullNameFormatStyle,
+  IAppleAuthenticationRequest,
+  AppleAuthenticationCredentialState,
+} from './types';
+
+// Каждый метод проверяется в месте вызова и бросает `UnavailabilityError`, как у upstream:
+// без нативного кода (не iOS) остаётся только заглушка ниже
+export type INativeAppleAuthenticationModule = {
+  addListener(eventName: string, listener: () => void): EventSubscription;
+  isAvailableAsync?(): Promise<boolean>;
+  requestAsync?(
+    options: IAppleAuthenticationRequest,
+  ): Promise<IAppleAuthenticationCredential>;
+  getCredentialStateAsync?(
+    user: string,
+  ): Promise<AppleAuthenticationCredentialState>;
+  formatFullName?(
+    fullName: IAppleAuthenticationFullName,
+    formatStyle?: IAppleAuthenticationFullNameFormatStyle,
+  ): string;
+};
+
+// Вместо `null` на неподдерживаемой платформе, чтобы `isAvailableAsync` отвечал `false`
+const unsupportedModule: INativeAppleAuthenticationModule = {
+  isAvailableAsync: () => Promise.resolve(false),
+  addListener: () => ({ remove: () => undefined }),
+};
+
+export const expoAppleAuthentication: INativeAppleAuthenticationModule =
+  requireOptionalNativeModule<INativeAppleAuthenticationModule>(
+    APPLE_AUTHENTICATION_MODULE_NAME,
+  ) ?? unsupportedModule;