@nativeguard/passkey (core)

Cliente WebAuthn/FIDO2 framework-agnostic. É a base sobre a qual os pacotes @nativeguard/passkey-react e @nativeguard/passkey-angular são construídos — instale-o diretamente apenas se estiver integrando um framework ainda sem wrapper dedicado.

• npm: @nativeguard/passkey
• Código-fonte: packages/core

Instalação

pnpm add @nativeguard/passkey

API pública

Exportado por src/index.ts:

• NativePasskeyClient — cliente principal (registerPasskey, authenticateWithPasskey, registerWithRecoveryAssertion).
• PasskeyError — erro tipado por PasskeyErrorCode.
• Tipos: NativePasskeyConfig, RegisterPasskeyOptions, RegisterResult, RegisterWithRecoveryAssertionOptions, AuthenticateOptions, AuthenticateResult, PasskeyCredential, PasskeySupport, PasskeyErrorCode.

Exemplo mínimo

import { NativePasskeyClient } from '@nativeguard/passkey';

const client = new NativePasskeyClient({ projectId: 'proj_xxx' });

const result = await client.authenticateWithPasskey();
if (!result.success) {
  console.error(result.error?.code, result.error?.message);
}

Para uso com React ou Angular, prefira os wrappers @nativeguard/passkey-react e @nativeguard/passkey-angular, que já expõem este cliente através de hooks/serviços idiomáticos.