@metamask-previews/passkey-controller 3.1.0-preview-4f4c98e → 3.1.0-preview-eb263b0ee

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. package/CHANGELOG.md +0 -1
  2. package/dist/PasskeyController-method-action-types.cjs +7 -0
  3. package/dist/PasskeyController-method-action-types.cjs.map +1 -0
  4. package/dist/{PasskeyController-method-action-types.d.ts → PasskeyController-method-action-types.d.cts} +2 -2
  5. package/dist/PasskeyController-method-action-types.d.cts.map +1 -0
  6. package/dist/PasskeyController-method-action-types.d.mts +204 -0
  7. package/dist/PasskeyController-method-action-types.d.mts.map +1 -0
  8. package/dist/{PasskeyController-method-action-types.js → PasskeyController-method-action-types.mjs} +1 -1
  9. package/dist/PasskeyController-method-action-types.mjs.map +1 -0
  10. package/dist/PasskeyController.cjs +685 -0
  11. package/dist/PasskeyController.cjs.map +1 -0
  12. package/dist/{PasskeyController.d.ts → PasskeyController.d.cts} +6 -6
  13. package/dist/PasskeyController.d.cts.map +1 -0
  14. package/dist/PasskeyController.d.mts +208 -0
  15. package/dist/PasskeyController.d.mts.map +1 -0
  16. package/dist/{PasskeyController.js → PasskeyController.mjs} +15 -15
  17. package/dist/PasskeyController.mjs.map +1 -0
  18. package/dist/ceremony-manager.cjs +135 -0
  19. package/dist/ceremony-manager.cjs.map +1 -0
  20. package/dist/{ceremony-manager.d.ts → ceremony-manager.d.cts} +2 -2
  21. package/dist/ceremony-manager.d.cts.map +1 -0
  22. package/dist/ceremony-manager.d.mts +72 -0
  23. package/dist/ceremony-manager.d.mts.map +1 -0
  24. package/dist/{ceremony-manager.js → ceremony-manager.mjs} +1 -1
  25. package/dist/ceremony-manager.mjs.map +1 -0
  26. package/dist/constants.cjs +39 -0
  27. package/dist/constants.cjs.map +1 -0
  28. package/dist/{constants.d.ts → constants.d.cts} +12 -12
  29. package/dist/constants.d.cts.map +1 -0
  30. package/dist/constants.d.mts +36 -0
  31. package/dist/constants.d.mts.map +1 -0
  32. package/dist/{constants.js → constants.mjs} +1 -1
  33. package/dist/constants.mjs.map +1 -0
  34. package/dist/errors.cjs +57 -0
  35. package/dist/errors.cjs.map +1 -0
  36. package/dist/{errors.d.ts → errors.d.cts} +2 -2
  37. package/dist/errors.d.cts.map +1 -0
  38. package/dist/errors.d.mts +34 -0
  39. package/dist/errors.d.mts.map +1 -0
  40. package/dist/{errors.js → errors.mjs} +1 -1
  41. package/dist/errors.mjs.map +1 -0
  42. package/dist/index.cjs +15 -0
  43. package/dist/index.cjs.map +1 -0
  44. package/dist/{index.d.ts → index.d.cts} +8 -8
  45. package/dist/index.d.cts.map +1 -0
  46. package/dist/index.d.mts +8 -0
  47. package/dist/index.d.mts.map +1 -0
  48. package/dist/index.mjs +5 -0
  49. package/dist/index.mjs.map +1 -0
  50. package/dist/key-derivation.cjs +44 -0
  51. package/dist/key-derivation.cjs.map +1 -0
  52. package/dist/{key-derivation.d.ts → key-derivation.d.cts} +3 -3
  53. package/dist/key-derivation.d.cts.map +1 -0
  54. package/dist/key-derivation.d.mts +20 -0
  55. package/dist/key-derivation.d.mts.map +1 -0
  56. package/dist/{key-derivation.js → key-derivation.mjs} +5 -5
  57. package/dist/key-derivation.mjs.map +1 -0
  58. package/dist/logger.cjs +9 -0
  59. package/dist/logger.cjs.map +1 -0
  60. package/dist/logger.d.cts +5 -0
  61. package/dist/logger.d.cts.map +1 -0
  62. package/dist/logger.d.mts +5 -0
  63. package/dist/logger.d.mts.map +1 -0
  64. package/dist/logger.mjs +6 -0
  65. package/dist/logger.mjs.map +1 -0
  66. package/dist/types.cjs +4 -0
  67. package/dist/types.cjs.map +1 -0
  68. package/dist/{types.d.ts → types.d.cts} +6 -6
  69. package/dist/types.d.cts.map +1 -0
  70. package/dist/types.d.mts +132 -0
  71. package/dist/types.d.mts.map +1 -0
  72. package/dist/types.mjs +2 -0
  73. package/dist/types.mjs.map +1 -0
  74. package/dist/utils/crypto.cjs +66 -0
  75. package/dist/utils/crypto.cjs.map +1 -0
  76. package/dist/utils/{crypto.d.ts → crypto.d.cts} +1 -1
  77. package/dist/utils/crypto.d.cts.map +1 -0
  78. package/dist/utils/crypto.d.mts +37 -0
  79. package/dist/utils/crypto.d.mts.map +1 -0
  80. package/dist/utils/{crypto.js → crypto.mjs} +7 -7
  81. package/dist/utils/crypto.mjs.map +1 -0
  82. package/dist/utils/encoding.cjs +42 -0
  83. package/dist/utils/encoding.cjs.map +1 -0
  84. package/dist/utils/{encoding.d.ts → encoding.d.cts} +1 -1
  85. package/dist/utils/encoding.d.cts.map +1 -0
  86. package/dist/utils/encoding.d.mts +22 -0
  87. package/dist/utils/encoding.d.mts.map +1 -0
  88. package/dist/utils/{encoding.js → encoding.mjs} +2 -2
  89. package/dist/utils/encoding.mjs.map +1 -0
  90. package/dist/webauthn/constants.cjs +74 -0
  91. package/dist/webauthn/constants.cjs.map +1 -0
  92. package/dist/webauthn/{constants.d.ts → constants.d.cts} +1 -1
  93. package/dist/webauthn/constants.d.cts.map +1 -0
  94. package/dist/webauthn/constants.d.mts +68 -0
  95. package/dist/webauthn/constants.d.mts.map +1 -0
  96. package/dist/webauthn/{constants.js → constants.mjs} +1 -1
  97. package/dist/webauthn/constants.mjs.map +1 -0
  98. package/dist/webauthn/decode-attestation-object.cjs +18 -0
  99. package/dist/webauthn/decode-attestation-object.cjs.map +1 -0
  100. package/dist/webauthn/{decode-attestation-object.d.ts → decode-attestation-object.d.cts} +2 -2
  101. package/dist/webauthn/decode-attestation-object.d.cts.map +1 -0
  102. package/dist/webauthn/decode-attestation-object.d.mts +10 -0
  103. package/dist/webauthn/decode-attestation-object.d.mts.map +1 -0
  104. package/dist/webauthn/{decode-attestation-object.js → decode-attestation-object.mjs} +2 -2
  105. package/dist/webauthn/decode-attestation-object.mjs.map +1 -0
  106. package/dist/webauthn/decode-client-data-json.cjs +17 -0
  107. package/dist/webauthn/decode-client-data-json.cjs.map +1 -0
  108. package/dist/webauthn/{decode-client-data-json.d.ts → decode-client-data-json.d.cts} +2 -2
  109. package/dist/webauthn/decode-client-data-json.d.cts.map +1 -0
  110. package/dist/webauthn/decode-client-data-json.d.mts +9 -0
  111. package/dist/webauthn/decode-client-data-json.d.mts.map +1 -0
  112. package/dist/webauthn/{decode-client-data-json.js → decode-client-data-json.mjs} +2 -2
  113. package/dist/webauthn/decode-client-data-json.mjs.map +1 -0
  114. package/dist/webauthn/match-expected-rp-id.cjs +26 -0
  115. package/dist/webauthn/match-expected-rp-id.cjs.map +1 -0
  116. package/dist/webauthn/{match-expected-rp-id.d.ts → match-expected-rp-id.d.cts} +1 -1
  117. package/dist/webauthn/match-expected-rp-id.d.cts.map +1 -0
  118. package/dist/webauthn/match-expected-rp-id.d.mts +11 -0
  119. package/dist/webauthn/match-expected-rp-id.d.mts.map +1 -0
  120. package/dist/webauthn/{match-expected-rp-id.js → match-expected-rp-id.mjs} +4 -4
  121. package/dist/webauthn/match-expected-rp-id.mjs.map +1 -0
  122. package/dist/webauthn/parse-authenticator-data.cjs +69 -0
  123. package/dist/webauthn/parse-authenticator-data.cjs.map +1 -0
  124. package/dist/webauthn/{parse-authenticator-data.d.ts → parse-authenticator-data.d.cts} +2 -2
  125. package/dist/webauthn/parse-authenticator-data.d.cts.map +1 -0
  126. package/dist/webauthn/parse-authenticator-data.d.mts +10 -0
  127. package/dist/webauthn/parse-authenticator-data.d.mts.map +1 -0
  128. package/dist/webauthn/{parse-authenticator-data.js → parse-authenticator-data.mjs} +2 -2
  129. package/dist/webauthn/parse-authenticator-data.mjs.map +1 -0
  130. package/dist/webauthn/types.cjs +3 -0
  131. package/dist/webauthn/types.cjs.map +1 -0
  132. package/dist/webauthn/{types.d.ts → types.d.cts} +2 -2
  133. package/dist/webauthn/types.d.cts.map +1 -0
  134. package/dist/webauthn/types.d.mts +113 -0
  135. package/dist/webauthn/types.d.mts.map +1 -0
  136. package/dist/webauthn/types.mjs +2 -0
  137. package/dist/webauthn/types.mjs.map +1 -0
  138. package/dist/webauthn/verify-authentication-response.cjs +133 -0
  139. package/dist/webauthn/verify-authentication-response.cjs.map +1 -0
  140. package/dist/webauthn/{verify-authentication-response.d.ts → verify-authentication-response.d.cts} +3 -3
  141. package/dist/webauthn/verify-authentication-response.d.cts.map +1 -0
  142. package/dist/webauthn/verify-authentication-response.d.mts +64 -0
  143. package/dist/webauthn/verify-authentication-response.d.mts.map +1 -0
  144. package/dist/webauthn/{verify-authentication-response.js → verify-authentication-response.mjs} +9 -9
  145. package/dist/webauthn/verify-authentication-response.mjs.map +1 -0
  146. package/dist/webauthn/verify-registration-response.cjs +242 -0
  147. package/dist/webauthn/verify-registration-response.cjs.map +1 -0
  148. package/dist/webauthn/{verify-registration-response.d.ts → verify-registration-response.d.cts} +3 -3
  149. package/dist/webauthn/verify-registration-response.d.cts.map +1 -0
  150. package/dist/webauthn/verify-registration-response.d.mts +81 -0
  151. package/dist/webauthn/verify-registration-response.d.mts.map +1 -0
  152. package/dist/webauthn/{verify-registration-response.js → verify-registration-response.mjs} +11 -11
  153. package/dist/webauthn/verify-registration-response.mjs.map +1 -0
  154. package/dist/webauthn/verify-signature.cjs +176 -0
  155. package/dist/webauthn/verify-signature.cjs.map +1 -0
  156. package/dist/webauthn/{verify-signature.d.ts → verify-signature.d.cts} +1 -1
  157. package/dist/webauthn/verify-signature.d.cts.map +1 -0
  158. package/dist/webauthn/verify-signature.d.mts +21 -0
  159. package/dist/webauthn/verify-signature.d.mts.map +1 -0
  160. package/dist/webauthn/{verify-signature.js → verify-signature.mjs} +7 -7
  161. package/dist/webauthn/verify-signature.mjs.map +1 -0
  162. package/package.json +17 -12
  163. package/dist/PasskeyController-method-action-types.d.ts.map +0 -1
  164. package/dist/PasskeyController-method-action-types.js.map +0 -1
  165. package/dist/PasskeyController.d.ts.map +0 -1
  166. package/dist/PasskeyController.js.map +0 -1
  167. package/dist/ceremony-manager.d.ts.map +0 -1
  168. package/dist/ceremony-manager.js.map +0 -1
  169. package/dist/constants.d.ts.map +0 -1
  170. package/dist/constants.js.map +0 -1
  171. package/dist/errors.d.ts.map +0 -1
  172. package/dist/errors.js.map +0 -1
  173. package/dist/index.d.ts.map +0 -1
  174. package/dist/index.js +0 -5
  175. package/dist/index.js.map +0 -1
  176. package/dist/key-derivation.d.ts.map +0 -1
  177. package/dist/key-derivation.js.map +0 -1
  178. package/dist/logger.d.ts +0 -4
  179. package/dist/logger.d.ts.map +0 -1
  180. package/dist/logger.js +0 -6
  181. package/dist/logger.js.map +0 -1
  182. package/dist/types.d.ts.map +0 -1
  183. package/dist/types.js +0 -2
  184. package/dist/types.js.map +0 -1
  185. package/dist/utils/crypto.d.ts.map +0 -1
  186. package/dist/utils/crypto.js.map +0 -1
  187. package/dist/utils/encoding.d.ts.map +0 -1
  188. package/dist/utils/encoding.js.map +0 -1
  189. package/dist/webauthn/constants.d.ts.map +0 -1
  190. package/dist/webauthn/constants.js.map +0 -1
  191. package/dist/webauthn/decode-attestation-object.d.ts.map +0 -1
  192. package/dist/webauthn/decode-attestation-object.js.map +0 -1
  193. package/dist/webauthn/decode-client-data-json.d.ts.map +0 -1
  194. package/dist/webauthn/decode-client-data-json.js.map +0 -1
  195. package/dist/webauthn/match-expected-rp-id.d.ts.map +0 -1
  196. package/dist/webauthn/match-expected-rp-id.js.map +0 -1
  197. package/dist/webauthn/parse-authenticator-data.d.ts.map +0 -1
  198. package/dist/webauthn/parse-authenticator-data.js.map +0 -1
  199. package/dist/webauthn/types.d.ts.map +0 -1
  200. package/dist/webauthn/types.js +0 -2
  201. package/dist/webauthn/types.js.map +0 -1
  202. package/dist/webauthn/verify-authentication-response.d.ts.map +0 -1
  203. package/dist/webauthn/verify-authentication-response.js.map +0 -1
  204. package/dist/webauthn/verify-registration-response.d.ts.map +0 -1
  205. package/dist/webauthn/verify-registration-response.js.map +0 -1
  206. package/dist/webauthn/verify-signature.d.ts.map +0 -1
  207. package/dist/webauthn/verify-signature.js.map +0 -1
@@ -0,0 +1,10 @@
1
+ import type { ParsedAuthenticatorData } from "./types.mjs";
2
+ /**
3
+ * Parse an authenticator data buffer per §6.1 of the WebAuthn spec.
4
+ *
5
+ * @param authData - Raw authenticator data bytes.
6
+ * @returns Parsed authenticator data with flags, rpIdHash, counter, and
7
+ * optional attested credential data.
8
+ */
9
+ export declare function parseAuthenticatorData(authData: Uint8Array): ParsedAuthenticatorData;
10
+ //# sourceMappingURL=parse-authenticator-data.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-authenticator-data.d.mts","sourceRoot":"","sources":["../../src/webauthn/parse-authenticator-data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAExB,oBAAmB;AAIpB;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,UAAU,GACnB,uBAAuB,CAkFzB"}
@@ -1,4 +1,4 @@
1
- import { decodePartialCBOR } from '@levischuck/tiny-cbor';
1
+ import { decodePartialCBOR } from "@levischuck/tiny-cbor";
2
2
  /* eslint-disable no-bitwise */
3
3
  /**
4
4
  * Parse an authenticator data buffer per §6.1 of the WebAuthn spec.
@@ -62,4 +62,4 @@ export function parseAuthenticatorData(authData) {
62
62
  return result;
63
63
  }
64
64
  /* eslint-enable no-bitwise */
65
- //# sourceMappingURL=parse-authenticator-data.js.map
65
+ //# sourceMappingURL=parse-authenticator-data.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-authenticator-data.mjs","sourceRoot":"","sources":["../../src/webauthn/parse-authenticator-data.ts"],"names":[],"mappings":"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","sourcesContent":["import { decodePartialCBOR } from '@levischuck/tiny-cbor';\n\nimport type {\n ParsedAuthenticatorData,\n AuthenticatorDataFlags,\n} from './types.js';\n\n/* eslint-disable no-bitwise */\n\n/**\n * Parse an authenticator data buffer per §6.1 of the WebAuthn spec.\n *\n * @param authData - Raw authenticator data bytes.\n * @returns Parsed authenticator data with flags, rpIdHash, counter, and\n * optional attested credential data.\n */\nexport function parseAuthenticatorData(\n authData: Uint8Array,\n): ParsedAuthenticatorData {\n if (authData.byteLength < 37) {\n throw new Error(\n `authenticatorData is ${authData.byteLength} bytes, expected at least 37`,\n );\n }\n\n let pointer = 0;\n\n const rpIdHash = authData.slice(pointer, pointer + 32);\n pointer += 32;\n\n const flagsByte = authData[pointer];\n const flags: AuthenticatorDataFlags = {\n up: Boolean(flagsByte & (1 << 0)),\n uv: Boolean(flagsByte & (1 << 2)),\n be: Boolean(flagsByte & (1 << 3)),\n bs: Boolean(flagsByte & (1 << 4)),\n at: Boolean(flagsByte & (1 << 6)),\n ed: Boolean(flagsByte & (1 << 7)),\n flagsByte,\n };\n pointer += 1;\n\n const counterView = new DataView(\n authData.buffer,\n authData.byteOffset + pointer,\n 4,\n );\n const counter = counterView.getUint32(0, false);\n pointer += 4;\n\n const result: ParsedAuthenticatorData = {\n rpIdHash,\n flags,\n counter,\n };\n\n if (flags.at) {\n const aaguid = authData.slice(pointer, pointer + 16);\n pointer += 16;\n\n const credIDLenView = new DataView(\n authData.buffer,\n authData.byteOffset + pointer,\n 2,\n );\n const credIDLen = credIDLenView.getUint16(0, false);\n pointer += 2;\n\n const credentialID = authData.slice(pointer, pointer + credIDLen);\n pointer += credIDLen;\n\n const pubKeyBytes = authData.slice(pointer);\n const [, nextOffset] = decodePartialCBOR(\n new Uint8Array(pubKeyBytes),\n 0,\n ) as [unknown, number];\n const credentialPublicKey = authData.slice(pointer, pointer + nextOffset);\n pointer += nextOffset;\n\n result.aaguid = aaguid;\n result.credentialID = credentialID;\n result.credentialPublicKey = credentialPublicKey;\n }\n\n if (flags.ed) {\n const remaining = authData.slice(pointer);\n const [decoded, consumed] = decodePartialCBOR(\n new Uint8Array(remaining),\n 0,\n ) as [Map<string, unknown>, number];\n result.extensionsData = decoded;\n result.extensionsDataBuffer = remaining.slice(0, consumed);\n pointer += consumed;\n }\n\n if (authData.byteLength > pointer) {\n throw new Error('Leftover bytes detected while parsing authenticator data');\n }\n\n return result;\n}\n\n/* eslint-enable no-bitwise */\n"]}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../src/webauthn/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n AuthenticatorTransportFuture,\n Base64URLString as Base64URL,\n} from '../types.js';\n\nexport type PublicKeyCredentialDescriptorJSON = {\n id: Base64URL;\n type: 'public-key';\n transports?: AuthenticatorTransportFuture[];\n};\n\nexport type PublicKeyCredentialHint =\n | 'hybrid'\n | 'security-key'\n | 'client-device';\n\nexport type PasskeyRegistrationOptions = {\n rp: { name: string; id?: string };\n user: {\n id: Base64URL;\n name: string;\n displayName: string;\n };\n challenge: Base64URL;\n pubKeyCredParams: { alg: number; type: 'public-key' }[];\n timeout?: number;\n excludeCredentials?: PublicKeyCredentialDescriptorJSON[];\n authenticatorSelection?: {\n authenticatorAttachment?: 'cross-platform' | 'platform';\n residentKey?: 'discouraged' | 'preferred' | 'required';\n requireResidentKey?: boolean;\n userVerification?: 'discouraged' | 'preferred' | 'required';\n };\n hints?: PublicKeyCredentialHint[];\n attestation?: 'direct' | 'enterprise' | 'indirect' | 'none';\n extensions?: Record<string, unknown>;\n};\n\nexport type PasskeyRegistrationResponse = {\n id: Base64URL;\n rawId: Base64URL;\n type: 'public-key';\n response: {\n clientDataJSON: Base64URL;\n attestationObject: Base64URL;\n transports?: string[];\n publicKeyAlgorithm?: number;\n publicKey?: Base64URL;\n authenticatorData?: Base64URL;\n };\n authenticatorAttachment?: 'cross-platform' | 'platform';\n clientExtensionResults: Record<string, unknown>;\n};\n\nexport type PasskeyAuthenticationOptions = {\n challenge: Base64URL;\n timeout?: number;\n rpId?: string;\n allowCredentials?: PublicKeyCredentialDescriptorJSON[];\n userVerification?: 'discouraged' | 'preferred' | 'required';\n hints?: PublicKeyCredentialHint[];\n extensions?: Record<string, unknown>;\n};\n\nexport type PasskeyAuthenticationResponse = {\n id: Base64URL;\n rawId: Base64URL;\n type: 'public-key';\n response: {\n clientDataJSON: Base64URL;\n authenticatorData: Base64URL;\n signature: Base64URL;\n userHandle?: Base64URL;\n };\n authenticatorAttachment?: 'cross-platform' | 'platform';\n clientExtensionResults: Record<string, unknown>;\n};\n\nexport type ClientDataJSON = {\n type: string;\n challenge: string;\n origin: string;\n crossOrigin?: boolean;\n tokenBinding?: {\n id?: string;\n status: 'present' | 'supported' | 'not-supported';\n };\n};\n\nexport type AttestationFormat =\n | 'fido-u2f'\n | 'packed'\n | 'android-safetynet'\n | 'android-key'\n | 'tpm'\n | 'apple'\n | 'none';\n\nexport type AttestationObject = {\n get(key: 'fmt'): AttestationFormat;\n get(key: 'attStmt'): AttestationStatement;\n get(key: 'authData'): Uint8Array;\n};\n\nexport type AttestationStatement = {\n get(key: 'sig'): Uint8Array | undefined;\n get(key: 'x5c'): Uint8Array[] | undefined;\n get(key: 'alg'): number | undefined;\n readonly size: number;\n};\n\nexport type AuthenticatorDataFlags = {\n up: boolean;\n uv: boolean;\n be: boolean;\n bs: boolean;\n at: boolean;\n ed: boolean;\n flagsByte: number;\n};\n\nexport type ParsedAuthenticatorData = {\n rpIdHash: Uint8Array;\n flags: AuthenticatorDataFlags;\n counter: number;\n aaguid?: Uint8Array;\n credentialID?: Uint8Array;\n credentialPublicKey?: Uint8Array;\n extensionsData?: Map<string, unknown>;\n extensionsDataBuffer?: Uint8Array;\n};\n"]}
@@ -1,4 +1,4 @@
1
- import type { AuthenticatorTransportFuture, Base64URLString as Base64URL } from '../types.js';
1
+ import type { AuthenticatorTransportFuture, Base64URLString as Base64URL } from "../types.cjs";
2
2
  export type PublicKeyCredentialDescriptorJSON = {
3
3
  id: Base64URL;
4
4
  type: 'public-key';
@@ -110,4 +110,4 @@ export type ParsedAuthenticatorData = {
110
110
  extensionsData?: Map<string, unknown>;
111
111
  extensionsDataBuffer?: Uint8Array;
112
112
  };
113
- //# sourceMappingURL=types.d.ts.map
113
+ //# sourceMappingURL=types.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/webauthn/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ import type { AuthenticatorTransportFuture, Base64URLString as Base64URL } from "../types.mjs";
2
+ export type PublicKeyCredentialDescriptorJSON = {
3
+ id: Base64URL;
4
+ type: 'public-key';
5
+ transports?: AuthenticatorTransportFuture[];
6
+ };
7
+ export type PublicKeyCredentialHint = 'hybrid' | 'security-key' | 'client-device';
8
+ export type PasskeyRegistrationOptions = {
9
+ rp: {
10
+ name: string;
11
+ id?: string;
12
+ };
13
+ user: {
14
+ id: Base64URL;
15
+ name: string;
16
+ displayName: string;
17
+ };
18
+ challenge: Base64URL;
19
+ pubKeyCredParams: {
20
+ alg: number;
21
+ type: 'public-key';
22
+ }[];
23
+ timeout?: number;
24
+ excludeCredentials?: PublicKeyCredentialDescriptorJSON[];
25
+ authenticatorSelection?: {
26
+ authenticatorAttachment?: 'cross-platform' | 'platform';
27
+ residentKey?: 'discouraged' | 'preferred' | 'required';
28
+ requireResidentKey?: boolean;
29
+ userVerification?: 'discouraged' | 'preferred' | 'required';
30
+ };
31
+ hints?: PublicKeyCredentialHint[];
32
+ attestation?: 'direct' | 'enterprise' | 'indirect' | 'none';
33
+ extensions?: Record<string, unknown>;
34
+ };
35
+ export type PasskeyRegistrationResponse = {
36
+ id: Base64URL;
37
+ rawId: Base64URL;
38
+ type: 'public-key';
39
+ response: {
40
+ clientDataJSON: Base64URL;
41
+ attestationObject: Base64URL;
42
+ transports?: string[];
43
+ publicKeyAlgorithm?: number;
44
+ publicKey?: Base64URL;
45
+ authenticatorData?: Base64URL;
46
+ };
47
+ authenticatorAttachment?: 'cross-platform' | 'platform';
48
+ clientExtensionResults: Record<string, unknown>;
49
+ };
50
+ export type PasskeyAuthenticationOptions = {
51
+ challenge: Base64URL;
52
+ timeout?: number;
53
+ rpId?: string;
54
+ allowCredentials?: PublicKeyCredentialDescriptorJSON[];
55
+ userVerification?: 'discouraged' | 'preferred' | 'required';
56
+ hints?: PublicKeyCredentialHint[];
57
+ extensions?: Record<string, unknown>;
58
+ };
59
+ export type PasskeyAuthenticationResponse = {
60
+ id: Base64URL;
61
+ rawId: Base64URL;
62
+ type: 'public-key';
63
+ response: {
64
+ clientDataJSON: Base64URL;
65
+ authenticatorData: Base64URL;
66
+ signature: Base64URL;
67
+ userHandle?: Base64URL;
68
+ };
69
+ authenticatorAttachment?: 'cross-platform' | 'platform';
70
+ clientExtensionResults: Record<string, unknown>;
71
+ };
72
+ export type ClientDataJSON = {
73
+ type: string;
74
+ challenge: string;
75
+ origin: string;
76
+ crossOrigin?: boolean;
77
+ tokenBinding?: {
78
+ id?: string;
79
+ status: 'present' | 'supported' | 'not-supported';
80
+ };
81
+ };
82
+ export type AttestationFormat = 'fido-u2f' | 'packed' | 'android-safetynet' | 'android-key' | 'tpm' | 'apple' | 'none';
83
+ export type AttestationObject = {
84
+ get(key: 'fmt'): AttestationFormat;
85
+ get(key: 'attStmt'): AttestationStatement;
86
+ get(key: 'authData'): Uint8Array;
87
+ };
88
+ export type AttestationStatement = {
89
+ get(key: 'sig'): Uint8Array | undefined;
90
+ get(key: 'x5c'): Uint8Array[] | undefined;
91
+ get(key: 'alg'): number | undefined;
92
+ readonly size: number;
93
+ };
94
+ export type AuthenticatorDataFlags = {
95
+ up: boolean;
96
+ uv: boolean;
97
+ be: boolean;
98
+ bs: boolean;
99
+ at: boolean;
100
+ ed: boolean;
101
+ flagsByte: number;
102
+ };
103
+ export type ParsedAuthenticatorData = {
104
+ rpIdHash: Uint8Array;
105
+ flags: AuthenticatorDataFlags;
106
+ counter: number;
107
+ aaguid?: Uint8Array;
108
+ credentialID?: Uint8Array;
109
+ credentialPublicKey?: Uint8Array;
110
+ extensionsData?: Map<string, unknown>;
111
+ extensionsDataBuffer?: Uint8Array;
112
+ };
113
+ //# sourceMappingURL=types.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/webauthn/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/webauthn/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n AuthenticatorTransportFuture,\n Base64URLString as Base64URL,\n} from '../types.js';\n\nexport type PublicKeyCredentialDescriptorJSON = {\n id: Base64URL;\n type: 'public-key';\n transports?: AuthenticatorTransportFuture[];\n};\n\nexport type PublicKeyCredentialHint =\n | 'hybrid'\n | 'security-key'\n | 'client-device';\n\nexport type PasskeyRegistrationOptions = {\n rp: { name: string; id?: string };\n user: {\n id: Base64URL;\n name: string;\n displayName: string;\n };\n challenge: Base64URL;\n pubKeyCredParams: { alg: number; type: 'public-key' }[];\n timeout?: number;\n excludeCredentials?: PublicKeyCredentialDescriptorJSON[];\n authenticatorSelection?: {\n authenticatorAttachment?: 'cross-platform' | 'platform';\n residentKey?: 'discouraged' | 'preferred' | 'required';\n requireResidentKey?: boolean;\n userVerification?: 'discouraged' | 'preferred' | 'required';\n };\n hints?: PublicKeyCredentialHint[];\n attestation?: 'direct' | 'enterprise' | 'indirect' | 'none';\n extensions?: Record<string, unknown>;\n};\n\nexport type PasskeyRegistrationResponse = {\n id: Base64URL;\n rawId: Base64URL;\n type: 'public-key';\n response: {\n clientDataJSON: Base64URL;\n attestationObject: Base64URL;\n transports?: string[];\n publicKeyAlgorithm?: number;\n publicKey?: Base64URL;\n authenticatorData?: Base64URL;\n };\n authenticatorAttachment?: 'cross-platform' | 'platform';\n clientExtensionResults: Record<string, unknown>;\n};\n\nexport type PasskeyAuthenticationOptions = {\n challenge: Base64URL;\n timeout?: number;\n rpId?: string;\n allowCredentials?: PublicKeyCredentialDescriptorJSON[];\n userVerification?: 'discouraged' | 'preferred' | 'required';\n hints?: PublicKeyCredentialHint[];\n extensions?: Record<string, unknown>;\n};\n\nexport type PasskeyAuthenticationResponse = {\n id: Base64URL;\n rawId: Base64URL;\n type: 'public-key';\n response: {\n clientDataJSON: Base64URL;\n authenticatorData: Base64URL;\n signature: Base64URL;\n userHandle?: Base64URL;\n };\n authenticatorAttachment?: 'cross-platform' | 'platform';\n clientExtensionResults: Record<string, unknown>;\n};\n\nexport type ClientDataJSON = {\n type: string;\n challenge: string;\n origin: string;\n crossOrigin?: boolean;\n tokenBinding?: {\n id?: string;\n status: 'present' | 'supported' | 'not-supported';\n };\n};\n\nexport type AttestationFormat =\n | 'fido-u2f'\n | 'packed'\n | 'android-safetynet'\n | 'android-key'\n | 'tpm'\n | 'apple'\n | 'none';\n\nexport type AttestationObject = {\n get(key: 'fmt'): AttestationFormat;\n get(key: 'attStmt'): AttestationStatement;\n get(key: 'authData'): Uint8Array;\n};\n\nexport type AttestationStatement = {\n get(key: 'sig'): Uint8Array | undefined;\n get(key: 'x5c'): Uint8Array[] | undefined;\n get(key: 'alg'): number | undefined;\n readonly size: number;\n};\n\nexport type AuthenticatorDataFlags = {\n up: boolean;\n uv: boolean;\n be: boolean;\n bs: boolean;\n at: boolean;\n ed: boolean;\n flagsByte: number;\n};\n\nexport type ParsedAuthenticatorData = {\n rpIdHash: Uint8Array;\n flags: AuthenticatorDataFlags;\n counter: number;\n aaguid?: Uint8Array;\n credentialID?: Uint8Array;\n credentialPublicKey?: Uint8Array;\n extensionsData?: Map<string, unknown>;\n extensionsDataBuffer?: Uint8Array;\n};\n"]}
@@ -0,0 +1,133 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.verifyAuthenticationResponse = void 0;
4
+ const tiny_cbor_1 = require("@levischuck/tiny-cbor");
5
+ const utils_1 = require("@metamask/utils");
6
+ const sha2_1 = require("@noble/hashes/sha2");
7
+ const encoding_js_1 = require("../utils/encoding.cjs");
8
+ const decode_client_data_json_js_1 = require("./decode-client-data-json.cjs");
9
+ const match_expected_rp_id_js_1 = require("./match-expected-rp-id.cjs");
10
+ const parse_authenticator_data_js_1 = require("./parse-authenticator-data.cjs");
11
+ const verify_signature_js_1 = require("./verify-signature.cjs");
12
+ /**
13
+ * Verifies a WebAuthn authentication (assertion) response per
14
+ * W3C WebAuthn Level 3 §7.2.
15
+ *
16
+ * Performs the following checks in order:
17
+ * 1. Credential ID presence, base64url consistency, and type.
18
+ * 2. `clientDataJSON` -- type is `"webauthn.get"`, challenge and origin
19
+ * match.
20
+ * 3. `authenticatorData` -- RP ID hash matches, user-presence flag is
21
+ * set, and optional user-verification flag is checked.
22
+ * 4. Signature verification -- `signature` is verified over
23
+ * `authData || SHA-256(clientDataJSON)` using the stored credential
24
+ * public key (COSE-encoded).
25
+ * 5. Counter monotonicity -- if either the stored or returned counter
26
+ * is non-zero, the new counter must exceed the stored value.
27
+ *
28
+ * @param opts - Verification options.
29
+ * @param opts.response - The `PublicKeyCredential` result from
30
+ * `navigator.credentials.get()`, serialized as JSON.
31
+ * @param opts.expectedChallenge - The base64url challenge that was issued
32
+ * for this ceremony.
33
+ * @param opts.expectedOrigin - One or more acceptable origins.
34
+ * @param opts.expectedRPIDs - Relying Party ID strings to match against `rpIdHash`.
35
+ * @param opts.credential - The stored credential record to verify against.
36
+ * @param opts.credential.id - The credential ID (base64url).
37
+ * @param opts.credential.publicKey - The COSE-encoded public key bytes
38
+ * persisted during registration.
39
+ * @param opts.credential.counter - The last known signature counter value.
40
+ * @param opts.credential.transports - Optional authenticator transports.
41
+ * @param opts.requireUserVerification - When `true`, verification fails
42
+ * if the UV flag is not set. Defaults to `false`.
43
+ * @returns Verification result containing `verified` status and parsed
44
+ * authentication info (new counter, origin, RP ID).
45
+ */
46
+ async function verifyAuthenticationResponse(opts) {
47
+ const { response, expectedChallenge, expectedOrigin, expectedRPIDs, credential, requireUserVerification = false, } = opts;
48
+ const { id, rawId, type: credentialType, response: assertionResponse, } = response;
49
+ // Ensure credential specified an ID
50
+ if (!id) {
51
+ throw new Error('Missing credential ID');
52
+ }
53
+ // Ensure ID is base64url-encoded
54
+ if (id !== rawId) {
55
+ throw new Error('Credential ID was not base64url-encoded');
56
+ }
57
+ // Make sure credential type is public-key
58
+ if (credentialType !== 'public-key') {
59
+ throw new Error(`Unexpected credential type ${String(credentialType)}, expected "public-key"`);
60
+ }
61
+ if (typeof assertionResponse?.clientDataJSON !== 'string') {
62
+ throw new Error('Credential response clientDataJSON was not a string');
63
+ }
64
+ const clientDataJSON = (0, decode_client_data_json_js_1.decodeClientDataJSON)(assertionResponse.clientDataJSON);
65
+ const { type, challenge, origin, tokenBinding } = clientDataJSON;
66
+ // Make sure we're handling an authentication
67
+ if (type !== 'webauthn.get') {
68
+ throw new Error(`Unexpected authentication response type: ${type}`);
69
+ }
70
+ // Ensure the device provided the challenge we gave it
71
+ if (challenge !== expectedChallenge) {
72
+ throw new Error(`Unexpected authentication response challenge "${challenge}", expected "${expectedChallenge}"`);
73
+ }
74
+ // Check that the origin is our site
75
+ const expectedOrigins = Array.isArray(expectedOrigin)
76
+ ? expectedOrigin
77
+ : [expectedOrigin];
78
+ if (!expectedOrigins.includes(origin)) {
79
+ throw new Error(`Unexpected authentication response origin "${origin}", expected one of: ${expectedOrigins.join(', ')}`);
80
+ }
81
+ if (assertionResponse.userHandle &&
82
+ typeof assertionResponse.userHandle !== 'string') {
83
+ throw new Error('Credential response userHandle was not a string');
84
+ }
85
+ if (tokenBinding) {
86
+ if (typeof tokenBinding !== 'object') {
87
+ throw new Error('ClientDataJSON tokenBinding was not an object');
88
+ }
89
+ if (!['present', 'supported', 'not-supported'].includes(tokenBinding.status)) {
90
+ throw new Error(`Unexpected tokenBinding status ${tokenBinding.status}`);
91
+ }
92
+ }
93
+ const authDataBuffer = (0, encoding_js_1.base64URLToBytes)(assertionResponse.authenticatorData);
94
+ const parsedAuthData = (0, parse_authenticator_data_js_1.parseAuthenticatorData)(authDataBuffer);
95
+ const { rpIdHash, flags, counter } = parsedAuthData;
96
+ const matchedRPID = expectedRPIDs.length > 0 ? (0, match_expected_rp_id_js_1.matchExpectedRPID)(rpIdHash, expectedRPIDs) : '';
97
+ // WebAuthn only requires the user presence flag be true
98
+ if (!flags.up) {
99
+ throw new Error('User not present during authentication');
100
+ }
101
+ // Enforce user verification if required
102
+ if (requireUserVerification && !flags.uv) {
103
+ throw new Error('User verification required, but user could not be verified');
104
+ }
105
+ const clientDataHash = (0, sha2_1.sha256)((0, encoding_js_1.base64URLToBytes)(assertionResponse.clientDataJSON));
106
+ const signatureBase = (0, utils_1.concatBytes)([authDataBuffer, clientDataHash]);
107
+ const signature = (0, encoding_js_1.base64URLToBytes)(assertionResponse.signature);
108
+ const cosePublicKey = (0, tiny_cbor_1.decodePartialCBOR)(new Uint8Array(credential.publicKey), 0)[0];
109
+ const verified = await (0, verify_signature_js_1.verifySignature)({
110
+ cosePublicKey,
111
+ signature,
112
+ data: signatureBase,
113
+ });
114
+ if (!verified) {
115
+ return { verified: false };
116
+ }
117
+ if ((counter > 0 || credential.counter > 0) &&
118
+ counter <= credential.counter) {
119
+ throw new Error(`Response counter value ${counter} must be greater than stored counter ${credential.counter}`);
120
+ }
121
+ return {
122
+ verified: true,
123
+ authenticationInfo: {
124
+ credentialId: credential.id,
125
+ newCounter: counter,
126
+ userVerified: flags.uv,
127
+ origin: clientDataJSON.origin,
128
+ rpID: matchedRPID,
129
+ },
130
+ };
131
+ }
132
+ exports.verifyAuthenticationResponse = verifyAuthenticationResponse;
133
+ //# sourceMappingURL=verify-authentication-response.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify-authentication-response.cjs","sourceRoot":"","sources":["../../src/webauthn/verify-authentication-response.ts"],"names":[],"mappings":"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","sourcesContent":["import { decodePartialCBOR } from '@levischuck/tiny-cbor';\nimport { concatBytes } from '@metamask/utils';\nimport { sha256 } from '@noble/hashes/sha2';\n\nimport type { AuthenticatorTransportFuture } from '../types.js';\nimport { base64URLToBytes } from '../utils/encoding.js';\nimport { decodeClientDataJSON } from './decode-client-data-json.js';\nimport { matchExpectedRPID } from './match-expected-rp-id.js';\nimport { parseAuthenticatorData } from './parse-authenticator-data.js';\nimport type { ParsedAuthenticatorData } from './types.js';\nimport type { PasskeyAuthenticationResponse } from './types.js';\nimport { verifySignature } from './verify-signature.js';\n\nexport type VerifiedAuthenticationResponse =\n | { verified: false; authenticationInfo?: never }\n | {\n verified: true;\n authenticationInfo: {\n credentialId: string;\n newCounter: number;\n userVerified: boolean;\n origin: string;\n /** Matched RP ID, or `\"\"` when `expectedRPIDs` is empty (RP ID hash check skipped). */\n rpID: string;\n };\n };\n\n/**\n * Verifies a WebAuthn authentication (assertion) response per\n * W3C WebAuthn Level 3 §7.2.\n *\n * Performs the following checks in order:\n * 1. Credential ID presence, base64url consistency, and type.\n * 2. `clientDataJSON` -- type is `\"webauthn.get\"`, challenge and origin\n * match.\n * 3. `authenticatorData` -- RP ID hash matches, user-presence flag is\n * set, and optional user-verification flag is checked.\n * 4. Signature verification -- `signature` is verified over\n * `authData || SHA-256(clientDataJSON)` using the stored credential\n * public key (COSE-encoded).\n * 5. Counter monotonicity -- if either the stored or returned counter\n * is non-zero, the new counter must exceed the stored value.\n *\n * @param opts - Verification options.\n * @param opts.response - The `PublicKeyCredential` result from\n * `navigator.credentials.get()`, serialized as JSON.\n * @param opts.expectedChallenge - The base64url challenge that was issued\n * for this ceremony.\n * @param opts.expectedOrigin - One or more acceptable origins.\n * @param opts.expectedRPIDs - Relying Party ID strings to match against `rpIdHash`.\n * @param opts.credential - The stored credential record to verify against.\n * @param opts.credential.id - The credential ID (base64url).\n * @param opts.credential.publicKey - The COSE-encoded public key bytes\n * persisted during registration.\n * @param opts.credential.counter - The last known signature counter value.\n * @param opts.credential.transports - Optional authenticator transports.\n * @param opts.requireUserVerification - When `true`, verification fails\n * if the UV flag is not set. Defaults to `false`.\n * @returns Verification result containing `verified` status and parsed\n * authentication info (new counter, origin, RP ID).\n */\nexport async function verifyAuthenticationResponse(opts: {\n response: PasskeyAuthenticationResponse;\n expectedChallenge: string;\n expectedOrigin: string | string[];\n expectedRPIDs: string[];\n credential: {\n id: string;\n publicKey: Uint8Array;\n counter: number;\n transports?: AuthenticatorTransportFuture[];\n };\n requireUserVerification?: boolean;\n}): Promise<VerifiedAuthenticationResponse> {\n const {\n response,\n expectedChallenge,\n expectedOrigin,\n expectedRPIDs,\n credential,\n requireUserVerification = false,\n } = opts;\n\n const {\n id,\n rawId,\n type: credentialType,\n response: assertionResponse,\n } = response;\n\n // Ensure credential specified an ID\n if (!id) {\n throw new Error('Missing credential ID');\n }\n\n // Ensure ID is base64url-encoded\n if (id !== rawId) {\n throw new Error('Credential ID was not base64url-encoded');\n }\n\n // Make sure credential type is public-key\n if (credentialType !== 'public-key') {\n throw new Error(\n `Unexpected credential type ${String(credentialType)}, expected \"public-key\"`,\n );\n }\n\n if (typeof assertionResponse?.clientDataJSON !== 'string') {\n throw new Error('Credential response clientDataJSON was not a string');\n }\n\n const clientDataJSON = decodeClientDataJSON(assertionResponse.clientDataJSON);\n const { type, challenge, origin, tokenBinding } = clientDataJSON;\n\n // Make sure we're handling an authentication\n if (type !== 'webauthn.get') {\n throw new Error(`Unexpected authentication response type: ${type}`);\n }\n\n // Ensure the device provided the challenge we gave it\n if (challenge !== expectedChallenge) {\n throw new Error(\n `Unexpected authentication response challenge \"${challenge}\", expected \"${expectedChallenge}\"`,\n );\n }\n\n // Check that the origin is our site\n const expectedOrigins = Array.isArray(expectedOrigin)\n ? expectedOrigin\n : [expectedOrigin];\n if (!expectedOrigins.includes(origin)) {\n throw new Error(\n `Unexpected authentication response origin \"${origin}\", expected one of: ${expectedOrigins.join(', ')}`,\n );\n }\n\n if (\n assertionResponse.userHandle &&\n typeof assertionResponse.userHandle !== 'string'\n ) {\n throw new Error('Credential response userHandle was not a string');\n }\n\n if (tokenBinding) {\n if (typeof tokenBinding !== 'object') {\n throw new Error('ClientDataJSON tokenBinding was not an object');\n }\n\n if (\n !['present', 'supported', 'not-supported'].includes(tokenBinding.status)\n ) {\n throw new Error(`Unexpected tokenBinding status ${tokenBinding.status}`);\n }\n }\n\n const authDataBuffer = base64URLToBytes(assertionResponse.authenticatorData);\n const parsedAuthData: ParsedAuthenticatorData =\n parseAuthenticatorData(authDataBuffer);\n const { rpIdHash, flags, counter } = parsedAuthData;\n\n const matchedRPID =\n expectedRPIDs.length > 0 ? matchExpectedRPID(rpIdHash, expectedRPIDs) : '';\n\n // WebAuthn only requires the user presence flag be true\n if (!flags.up) {\n throw new Error('User not present during authentication');\n }\n\n // Enforce user verification if required\n if (requireUserVerification && !flags.uv) {\n throw new Error(\n 'User verification required, but user could not be verified',\n );\n }\n\n const clientDataHash = sha256(\n base64URLToBytes(assertionResponse.clientDataJSON),\n );\n const signatureBase = concatBytes([authDataBuffer, clientDataHash]);\n\n const signature = base64URLToBytes(assertionResponse.signature);\n\n const cosePublicKey = decodePartialCBOR(\n new Uint8Array(credential.publicKey),\n 0,\n )[0] as Map<number, number | Uint8Array>;\n\n const verified = await verifySignature({\n cosePublicKey,\n signature,\n data: signatureBase,\n });\n\n if (!verified) {\n return { verified: false };\n }\n\n if (\n (counter > 0 || credential.counter > 0) &&\n counter <= credential.counter\n ) {\n throw new Error(\n `Response counter value ${counter} must be greater than stored counter ${credential.counter}`,\n );\n }\n\n return {\n verified: true,\n authenticationInfo: {\n credentialId: credential.id,\n newCounter: counter,\n userVerified: flags.uv,\n origin: clientDataJSON.origin,\n rpID: matchedRPID,\n },\n };\n}\n"]}
@@ -1,5 +1,5 @@
1
- import type { AuthenticatorTransportFuture } from '../types.js';
2
- import type { PasskeyAuthenticationResponse } from './types.js';
1
+ import type { AuthenticatorTransportFuture } from "../types.cjs";
2
+ import type { PasskeyAuthenticationResponse } from "./types.cjs";
3
3
  export type VerifiedAuthenticationResponse = {
4
4
  verified: false;
5
5
  authenticationInfo?: never;
@@ -61,4 +61,4 @@ export declare function verifyAuthenticationResponse(opts: {
61
61
  };
62
62
  requireUserVerification?: boolean;
63
63
  }): Promise<VerifiedAuthenticationResponse>;
64
- //# sourceMappingURL=verify-authentication-response.d.ts.map
64
+ //# sourceMappingURL=verify-authentication-response.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify-authentication-response.d.cts","sourceRoot":"","sources":["../../src/webauthn/verify-authentication-response.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAoB;AAMhE,OAAO,KAAK,EAAE,6BAA6B,EAAE,oBAAmB;AAGhE,MAAM,MAAM,8BAA8B,GACtC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,kBAAkB,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/C;IACE,QAAQ,EAAE,IAAI,CAAC;IACf,kBAAkB,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,uFAAuF;QACvF,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,UAAU,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC7C,CAAC;IACF,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,8BAA8B,CAAC,CA+I1C"}
@@ -0,0 +1,64 @@
1
+ import type { AuthenticatorTransportFuture } from "../types.mjs";
2
+ import type { PasskeyAuthenticationResponse } from "./types.mjs";
3
+ export type VerifiedAuthenticationResponse = {
4
+ verified: false;
5
+ authenticationInfo?: never;
6
+ } | {
7
+ verified: true;
8
+ authenticationInfo: {
9
+ credentialId: string;
10
+ newCounter: number;
11
+ userVerified: boolean;
12
+ origin: string;
13
+ /** Matched RP ID, or `""` when `expectedRPIDs` is empty (RP ID hash check skipped). */
14
+ rpID: string;
15
+ };
16
+ };
17
+ /**
18
+ * Verifies a WebAuthn authentication (assertion) response per
19
+ * W3C WebAuthn Level 3 §7.2.
20
+ *
21
+ * Performs the following checks in order:
22
+ * 1. Credential ID presence, base64url consistency, and type.
23
+ * 2. `clientDataJSON` -- type is `"webauthn.get"`, challenge and origin
24
+ * match.
25
+ * 3. `authenticatorData` -- RP ID hash matches, user-presence flag is
26
+ * set, and optional user-verification flag is checked.
27
+ * 4. Signature verification -- `signature` is verified over
28
+ * `authData || SHA-256(clientDataJSON)` using the stored credential
29
+ * public key (COSE-encoded).
30
+ * 5. Counter monotonicity -- if either the stored or returned counter
31
+ * is non-zero, the new counter must exceed the stored value.
32
+ *
33
+ * @param opts - Verification options.
34
+ * @param opts.response - The `PublicKeyCredential` result from
35
+ * `navigator.credentials.get()`, serialized as JSON.
36
+ * @param opts.expectedChallenge - The base64url challenge that was issued
37
+ * for this ceremony.
38
+ * @param opts.expectedOrigin - One or more acceptable origins.
39
+ * @param opts.expectedRPIDs - Relying Party ID strings to match against `rpIdHash`.
40
+ * @param opts.credential - The stored credential record to verify against.
41
+ * @param opts.credential.id - The credential ID (base64url).
42
+ * @param opts.credential.publicKey - The COSE-encoded public key bytes
43
+ * persisted during registration.
44
+ * @param opts.credential.counter - The last known signature counter value.
45
+ * @param opts.credential.transports - Optional authenticator transports.
46
+ * @param opts.requireUserVerification - When `true`, verification fails
47
+ * if the UV flag is not set. Defaults to `false`.
48
+ * @returns Verification result containing `verified` status and parsed
49
+ * authentication info (new counter, origin, RP ID).
50
+ */
51
+ export declare function verifyAuthenticationResponse(opts: {
52
+ response: PasskeyAuthenticationResponse;
53
+ expectedChallenge: string;
54
+ expectedOrigin: string | string[];
55
+ expectedRPIDs: string[];
56
+ credential: {
57
+ id: string;
58
+ publicKey: Uint8Array;
59
+ counter: number;
60
+ transports?: AuthenticatorTransportFuture[];
61
+ };
62
+ requireUserVerification?: boolean;
63
+ }): Promise<VerifiedAuthenticationResponse>;
64
+ //# sourceMappingURL=verify-authentication-response.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify-authentication-response.d.mts","sourceRoot":"","sources":["../../src/webauthn/verify-authentication-response.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAoB;AAMhE,OAAO,KAAK,EAAE,6BAA6B,EAAE,oBAAmB;AAGhE,MAAM,MAAM,8BAA8B,GACtC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,kBAAkB,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/C;IACE,QAAQ,EAAE,IAAI,CAAC;IACf,kBAAkB,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,uFAAuF;QACvF,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,UAAU,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC7C,CAAC;IACF,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,8BAA8B,CAAC,CA+I1C"}
@@ -1,11 +1,11 @@
1
- import { decodePartialCBOR } from '@levischuck/tiny-cbor';
2
- import { concatBytes } from '@metamask/utils';
3
- import { sha256 } from '@noble/hashes/sha2';
4
- import { base64URLToBytes } from '../utils/encoding.js';
5
- import { decodeClientDataJSON } from './decode-client-data-json.js';
6
- import { matchExpectedRPID } from './match-expected-rp-id.js';
7
- import { parseAuthenticatorData } from './parse-authenticator-data.js';
8
- import { verifySignature } from './verify-signature.js';
1
+ import { decodePartialCBOR } from "@levischuck/tiny-cbor";
2
+ import { concatBytes } from "@metamask/utils";
3
+ import { sha256 } from "@noble/hashes/sha2";
4
+ import { base64URLToBytes } from "../utils/encoding.mjs";
5
+ import { decodeClientDataJSON } from "./decode-client-data-json.mjs";
6
+ import { matchExpectedRPID } from "./match-expected-rp-id.mjs";
7
+ import { parseAuthenticatorData } from "./parse-authenticator-data.mjs";
8
+ import { verifySignature } from "./verify-signature.mjs";
9
9
  /**
10
10
  * Verifies a WebAuthn authentication (assertion) response per
11
11
  * W3C WebAuthn Level 3 §7.2.
@@ -126,4 +126,4 @@ export async function verifyAuthenticationResponse(opts) {
126
126
  },
127
127
  };
128
128
  }
129
- //# sourceMappingURL=verify-authentication-response.js.map
129
+ //# sourceMappingURL=verify-authentication-response.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify-authentication-response.mjs","sourceRoot":"","sources":["../../src/webauthn/verify-authentication-response.ts"],"names":[],"mappings":"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","sourcesContent":["import { decodePartialCBOR } from '@levischuck/tiny-cbor';\nimport { concatBytes } from '@metamask/utils';\nimport { sha256 } from '@noble/hashes/sha2';\n\nimport type { AuthenticatorTransportFuture } from '../types.js';\nimport { base64URLToBytes } from '../utils/encoding.js';\nimport { decodeClientDataJSON } from './decode-client-data-json.js';\nimport { matchExpectedRPID } from './match-expected-rp-id.js';\nimport { parseAuthenticatorData } from './parse-authenticator-data.js';\nimport type { ParsedAuthenticatorData } from './types.js';\nimport type { PasskeyAuthenticationResponse } from './types.js';\nimport { verifySignature } from './verify-signature.js';\n\nexport type VerifiedAuthenticationResponse =\n | { verified: false; authenticationInfo?: never }\n | {\n verified: true;\n authenticationInfo: {\n credentialId: string;\n newCounter: number;\n userVerified: boolean;\n origin: string;\n /** Matched RP ID, or `\"\"` when `expectedRPIDs` is empty (RP ID hash check skipped). */\n rpID: string;\n };\n };\n\n/**\n * Verifies a WebAuthn authentication (assertion) response per\n * W3C WebAuthn Level 3 §7.2.\n *\n * Performs the following checks in order:\n * 1. Credential ID presence, base64url consistency, and type.\n * 2. `clientDataJSON` -- type is `\"webauthn.get\"`, challenge and origin\n * match.\n * 3. `authenticatorData` -- RP ID hash matches, user-presence flag is\n * set, and optional user-verification flag is checked.\n * 4. Signature verification -- `signature` is verified over\n * `authData || SHA-256(clientDataJSON)` using the stored credential\n * public key (COSE-encoded).\n * 5. Counter monotonicity -- if either the stored or returned counter\n * is non-zero, the new counter must exceed the stored value.\n *\n * @param opts - Verification options.\n * @param opts.response - The `PublicKeyCredential` result from\n * `navigator.credentials.get()`, serialized as JSON.\n * @param opts.expectedChallenge - The base64url challenge that was issued\n * for this ceremony.\n * @param opts.expectedOrigin - One or more acceptable origins.\n * @param opts.expectedRPIDs - Relying Party ID strings to match against `rpIdHash`.\n * @param opts.credential - The stored credential record to verify against.\n * @param opts.credential.id - The credential ID (base64url).\n * @param opts.credential.publicKey - The COSE-encoded public key bytes\n * persisted during registration.\n * @param opts.credential.counter - The last known signature counter value.\n * @param opts.credential.transports - Optional authenticator transports.\n * @param opts.requireUserVerification - When `true`, verification fails\n * if the UV flag is not set. Defaults to `false`.\n * @returns Verification result containing `verified` status and parsed\n * authentication info (new counter, origin, RP ID).\n */\nexport async function verifyAuthenticationResponse(opts: {\n response: PasskeyAuthenticationResponse;\n expectedChallenge: string;\n expectedOrigin: string | string[];\n expectedRPIDs: string[];\n credential: {\n id: string;\n publicKey: Uint8Array;\n counter: number;\n transports?: AuthenticatorTransportFuture[];\n };\n requireUserVerification?: boolean;\n}): Promise<VerifiedAuthenticationResponse> {\n const {\n response,\n expectedChallenge,\n expectedOrigin,\n expectedRPIDs,\n credential,\n requireUserVerification = false,\n } = opts;\n\n const {\n id,\n rawId,\n type: credentialType,\n response: assertionResponse,\n } = response;\n\n // Ensure credential specified an ID\n if (!id) {\n throw new Error('Missing credential ID');\n }\n\n // Ensure ID is base64url-encoded\n if (id !== rawId) {\n throw new Error('Credential ID was not base64url-encoded');\n }\n\n // Make sure credential type is public-key\n if (credentialType !== 'public-key') {\n throw new Error(\n `Unexpected credential type ${String(credentialType)}, expected \"public-key\"`,\n );\n }\n\n if (typeof assertionResponse?.clientDataJSON !== 'string') {\n throw new Error('Credential response clientDataJSON was not a string');\n }\n\n const clientDataJSON = decodeClientDataJSON(assertionResponse.clientDataJSON);\n const { type, challenge, origin, tokenBinding } = clientDataJSON;\n\n // Make sure we're handling an authentication\n if (type !== 'webauthn.get') {\n throw new Error(`Unexpected authentication response type: ${type}`);\n }\n\n // Ensure the device provided the challenge we gave it\n if (challenge !== expectedChallenge) {\n throw new Error(\n `Unexpected authentication response challenge \"${challenge}\", expected \"${expectedChallenge}\"`,\n );\n }\n\n // Check that the origin is our site\n const expectedOrigins = Array.isArray(expectedOrigin)\n ? expectedOrigin\n : [expectedOrigin];\n if (!expectedOrigins.includes(origin)) {\n throw new Error(\n `Unexpected authentication response origin \"${origin}\", expected one of: ${expectedOrigins.join(', ')}`,\n );\n }\n\n if (\n assertionResponse.userHandle &&\n typeof assertionResponse.userHandle !== 'string'\n ) {\n throw new Error('Credential response userHandle was not a string');\n }\n\n if (tokenBinding) {\n if (typeof tokenBinding !== 'object') {\n throw new Error('ClientDataJSON tokenBinding was not an object');\n }\n\n if (\n !['present', 'supported', 'not-supported'].includes(tokenBinding.status)\n ) {\n throw new Error(`Unexpected tokenBinding status ${tokenBinding.status}`);\n }\n }\n\n const authDataBuffer = base64URLToBytes(assertionResponse.authenticatorData);\n const parsedAuthData: ParsedAuthenticatorData =\n parseAuthenticatorData(authDataBuffer);\n const { rpIdHash, flags, counter } = parsedAuthData;\n\n const matchedRPID =\n expectedRPIDs.length > 0 ? matchExpectedRPID(rpIdHash, expectedRPIDs) : '';\n\n // WebAuthn only requires the user presence flag be true\n if (!flags.up) {\n throw new Error('User not present during authentication');\n }\n\n // Enforce user verification if required\n if (requireUserVerification && !flags.uv) {\n throw new Error(\n 'User verification required, but user could not be verified',\n );\n }\n\n const clientDataHash = sha256(\n base64URLToBytes(assertionResponse.clientDataJSON),\n );\n const signatureBase = concatBytes([authDataBuffer, clientDataHash]);\n\n const signature = base64URLToBytes(assertionResponse.signature);\n\n const cosePublicKey = decodePartialCBOR(\n new Uint8Array(credential.publicKey),\n 0,\n )[0] as Map<number, number | Uint8Array>;\n\n const verified = await verifySignature({\n cosePublicKey,\n signature,\n data: signatureBase,\n });\n\n if (!verified) {\n return { verified: false };\n }\n\n if (\n (counter > 0 || credential.counter > 0) &&\n counter <= credential.counter\n ) {\n throw new Error(\n `Response counter value ${counter} must be greater than stored counter ${credential.counter}`,\n );\n }\n\n return {\n verified: true,\n authenticationInfo: {\n credentialId: credential.id,\n newCounter: counter,\n userVerified: flags.uv,\n origin: clientDataJSON.origin,\n rpID: matchedRPID,\n },\n };\n}\n"]}