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

package/src/core/types.ts

@@ -0,0 +1,121 @@
+// Типы и enum-ы `expo-apple-authentication`, порт `AppleAuthentication.types.ts`
+
+/** Scopes for `signInAsync`, the user may deny any of them, so handle `null` fields */
+export enum AppleAuthenticationScope {
+  FULL_NAME = 0,
+  EMAIL = 1,
+}
+
+export 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 enum AppleAuthenticationCredentialState {
+  REVOKED,
+  AUTHORIZED,
+  NOT_FOUND,
+  TRANSFERRED,
+}
+
+/** The system's guess of how likely the user is a real person */
+export enum AppleAuthenticationUserDetectionStatus {
+  /** The system does not support this determination and there is no data */
+  UNSUPPORTED,
+  /** The system has not determined whether the user might be a real person */
+  UNKNOWN,
+  /** The user appears to be a real person */
+  LIKELY_REAL,
+}
+
+/** Which pre-defined text the button shows */
+export enum AppleAuthenticationButtonType {
+  /** "Sign in with Apple" */
+  SIGN_IN,
+  /** "Continue with Apple" */
+  CONTINUE,
+  /**
+   * "Sign up with Apple"
+   * @platform ios 13.2+
+   */
+  SIGN_UP,
+}
+
+/** Which pre-defined color scheme the button uses */
+export enum AppleAuthenticationButtonStyle {
+  /** White button with black text */
+  WHITE,
+  /** White button with a black outline and black text */
+  WHITE_OUTLINE,
+  /** Black button with white text */
+  BLACK,
+}
+
+/** 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 };

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

@@ -0,0 +1,12 @@
+import type { ReactElement } from 'react';
+import { descriptorToReact } from '@symbiote-native/react';
+import { renderAppleAuthenticationButton } from '../core/apple-authentication-button';
+import type { IAppleAuthenticationButtonProps } from '../core/apple-authentication-button';
+
+/** React twin of `expo-apple-authentication`'s `AppleAuthenticationButton`, iOS only */
+export function AppleAuthenticationButton(
+  props: IAppleAuthenticationButtonProps & { className?: string },
+): ReactElement | null {
+  const descriptor = renderAppleAuthenticationButton(props);
+  return descriptor ? descriptorToReact(descriptor) : null;
+}

package/src/react/index.ts

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

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

@@ -0,0 +1,9 @@
+import { defineOptionalDescriptorComponent } from '@symbiote-native/solid';
+import { renderAppleAuthenticationButton } from '../core/apple-authentication-button';
+import type { IAppleAuthenticationButtonProps } from '../core/apple-authentication-button';
+
+/** Solid twin of `expo-apple-authentication`'s `AppleAuthenticationButton`, iOS only */
+export const AppleAuthenticationButton =
+  defineOptionalDescriptorComponent<IAppleAuthenticationButtonProps>(
+    renderAppleAuthenticationButton,
+  );

package/src/solid/index.ts

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

package/src/svelte/apple-authentication-button.svelte

@@ -0,0 +1,17 @@
+<script lang="ts">
+  // The native view name is mixed-case, which a literal tag would parse as a component reference,
+  // so the tag is dynamic
+  import { hostProps } from '@symbiote-native/svelte/native-view-bridge';
+  import { renderAppleAuthenticationButton } from '../core/apple-authentication-button';
+  import type { IAppleAuthenticationButtonProps } from '../core/apple-authentication-button';
+
+  const props: IAppleAuthenticationButtonProps = $props();
+  const descriptor = $derived(renderAppleAuthenticationButton({ ...props }));
+</script>
+
+{#if descriptor}
+  <svelte:element
+    this={descriptor.type}
+    {@attach hostProps(descriptor.props)}
+  />
+{/if}

package/src/svelte/index.ts

@@ -0,0 +1,4 @@
+// @symbiote-native/apple-authentication/svelte: кнопка и поток входа на общем ядре
+
+export { default as AppleAuthenticationButton } from './apple-authentication-button.svelte';
+export * from '../core';

package/src/svelte/svelte-ambient.d.ts

@@ -0,0 +1,3 @@
+// Pulls in svelte's ambient globals ($state/$effect/...) for this package's tsc program
+// This package has no value import from 'svelte', so a triple-slash reference does it explicitly
+/// <reference types="svelte" />

package/src/svelte/svelte-compile.test-helper.ts

@@ -0,0 +1,6 @@
+// Re-exports the existing harness instead of another copy
+export {
+  createSvelteHarness,
+  loadComponent,
+  type ISvelteHarness,
+} from '../../../sqlite/src/svelte/svelte-compile.test-helper';

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

@@ -0,0 +1,18 @@
+import { defineComponent, type VNode } from '@vue/runtime-core';
+import { descriptorToVue, normalizeVueAttrs } from '@symbiote-native/vue';
+import { renderAppleAuthenticationButton } from '../core/apple-authentication-button';
+
+/** Vue twin of `expo-apple-authentication`'s `AppleAuthenticationButton`, iOS only */
+export const AppleAuthenticationButton = defineComponent({
+  name: 'AppleAuthenticationButton',
+  // Все атрибуты это пропсы нативного view, на обёртку ничего не должно просочиться
+  inheritAttrs: false,
+  setup(_props, { attrs }) {
+    return (): VNode | null => {
+      const descriptor = renderAppleAuthenticationButton(
+        normalizeVueAttrs(attrs),
+      );
+      return descriptor ? descriptorToVue(descriptor) : null;
+    };
+  },
+});

package/src/vue/index.ts

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