@metamask-previews/passkey-controller 4.0.0-preview-d3f9964be → 4.1.0-preview-aecbce4ff

package/dist/ceremony-manager.js

@@ -41,6 +41,9 @@ export class CeremonyManager {
         for (const [key, ceremony] of map) {
             if (now - ceremony.createdAt > CEREMONY_MAX_AGE_MS) {
                 map.delete(key);
+                if (ceremonyType === 'registration') {
+                    this.#deleteAuthenticationCeremoniesForRegistration(key);
+                }
             }
         }
     }
@@ -64,6 +67,16 @@ export class CeremonyManager {
                 break;
             }
             map.delete(oldestKey);
+            if (ceremonyType === 'registration') {
+                this.#deleteAuthenticationCeremoniesForRegistration(oldestKey);
+            }
+        }
+    }
+    #deleteAuthenticationCeremoniesForRegistration(registrationChallenge) {
+        for (const [authenticationChallenge, ceremony] of this.#authenticationMap) {
+            if (ceremony.registrationChallenge === registrationChallenge) {
+                this.#authenticationMap.delete(authenticationChallenge);
+            }
         }
     }
     /**
@@ -115,7 +128,9 @@ export class CeremonyManager {
      * @returns Whether an entry was deleted.
      */
     deleteRegistrationCeremony(challenge) {
-        return this.#registrationMap.delete(challenge);
+        const deleted = this.#registrationMap.delete(challenge);
+        this.#deleteAuthenticationCeremoniesForRegistration(challenge);
+        return deleted;
     }
     /**
      * Removes an authentication ceremony by challenge.

package/dist/ceremony-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ceremony-manager.js","sourceRoot":"","sources":["../src/ceremony-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PasskeyAuthenticationCeremony,\n  PasskeyRegistrationCeremony,\n} from './types.js';\n\n/** WebAuthn `timeout` for credential creation and assertion (ms). */\nexport const WEBAUTHN_TIMEOUT_MS = 60_000;\n\n/**\n * Extra allowance beyond {@link WEBAUTHN_TIMEOUT_MS} before in-memory\n * ceremony state is discarded (covers slow UX, multi-step enrollment, and\n * clock skew).\n */\nexport const CEREMONY_TTL_SLACK_MS = 120_000;\n\n/**\n * Maximum age for in-flight registration or authentication ceremony state\n * (between options and verified response). This bounds the lifetime of a\n * single WebAuthn ceremony only; it is not a user login session timeout.\n */\nexport const CEREMONY_MAX_AGE_MS = WEBAUTHN_TIMEOUT_MS + CEREMONY_TTL_SLACK_MS;\n\n/**\n * Upper bound on concurrent in-memory ceremonies per flow type (registration\n * vs authentication), for abuse / leak protection.\n */\nexport const MAX_CONCURRENT_PASSKEY_CEREMONIES = 16;\n\ntype CeremonyFlow = 'registration' | 'authentication';\n\n/**\n * In-memory store for in-flight WebAuthn ceremonies (registration vs authentication),\n * keyed by base64url challenge. Enforces TTL and a per-flow size cap; not user session state.\n */\nexport class CeremonyManager {\n  readonly #registrationMap = new Map<string, PasskeyRegistrationCeremony>();\n\n  readonly #authenticationMap = new Map<\n    string,\n    PasskeyAuthenticationCeremony\n  >();\n\n  /**\n   * Challenge-keyed map for prune/capacity helpers.\n   *\n   * @param ceremonyType - Which in-flight ceremony map to use.\n   * @returns The registration or authentication ceremony map for the given flow.\n   */\n  #getMap(\n    ceremonyType: CeremonyFlow,\n  ): Map<string, PasskeyRegistrationCeremony | PasskeyAuthenticationCeremony> {\n    return ceremonyType === 'registration'\n      ? this.#registrationMap\n      : this.#authenticationMap;\n  }\n\n  #pruneExpired(ceremonyType: CeremonyFlow): void {\n    const now = Date.now();\n    const map = this.#getMap(ceremonyType);\n    for (const [key, ceremony] of map) {\n      if (now - ceremony.createdAt > CEREMONY_MAX_AGE_MS) {\n        map.delete(key);\n      }\n    }\n  }\n\n  /**\n   * Removes the oldest entry (by `createdAt`) until size is below the cap.\n   *\n   * @param ceremonyType - Which in-flight ceremony map to evict from.\n   */\n  #enforceCapacity(ceremonyType: CeremonyFlow): void {\n    const map = this.#getMap(ceremonyType);\n    while (map.size >= MAX_CONCURRENT_PASSKEY_CEREMONIES) {\n      let oldestKey: string | undefined;\n      let oldestTime = Infinity;\n      for (const [mapKey, ceremony] of map) {\n        if (ceremony.createdAt < oldestTime) {\n          oldestTime = ceremony.createdAt;\n          oldestKey = mapKey;\n        }\n      }\n      if (oldestKey === undefined) {\n        break;\n      }\n      map.delete(oldestKey);\n    }\n  }\n\n  /**\n   * Records registration ceremony state after pruning expired rows and evicting oldest if at cap.\n   *\n   * @param challenge - Same base64url challenge as in the creation options `challenge` field.\n   * @param ceremony - Payload to retrieve when the registration response returns.\n   */\n  saveRegistrationCeremony(\n    challenge: string,\n    ceremony: PasskeyRegistrationCeremony,\n  ): void {\n    this.#pruneExpired('registration');\n    this.#enforceCapacity('registration');\n    this.#registrationMap.set(challenge, ceremony);\n  }\n\n  /**\n   * Records authentication ceremony state after pruning expired rows and evicting oldest if at cap.\n   *\n   * @param challenge - Same base64url challenge as in the request options `challenge` field.\n   * @param ceremony - Payload to retrieve when the assertion response returns.\n   */\n  saveAuthenticationCeremony(\n    challenge: string,\n    ceremony: PasskeyAuthenticationCeremony,\n  ): void {\n    this.#pruneExpired('authentication');\n    this.#enforceCapacity('authentication');\n    this.#authenticationMap.set(challenge, ceremony);\n  }\n\n  /**\n   * Returns registration ceremony for a challenge, pruning expired entries on this map first.\n   *\n   * @param challenge - Base64url challenge from decoded `clientDataJSON` (matches stored key).\n   * @returns Stored ceremony, or `undefined` if none or expired.\n   */\n  getRegistrationCeremony(\n    challenge: string,\n  ): PasskeyRegistrationCeremony | undefined {\n    this.#pruneExpired('registration');\n    return this.#registrationMap.get(challenge);\n  }\n\n  /**\n   * Returns authentication ceremony for a challenge, pruning expired entries on this map first.\n   *\n   * @param challenge - Base64url challenge from decoded `clientDataJSON` (matches stored key).\n   * @returns Stored ceremony, or `undefined` if none or expired.\n   */\n  getAuthenticationCeremony(\n    challenge: string,\n  ): PasskeyAuthenticationCeremony | undefined {\n    this.#pruneExpired('authentication');\n    return this.#authenticationMap.get(challenge);\n  }\n\n  /**\n   * Removes a registration ceremony by challenge.\n   *\n   * @param challenge - Map key for the ceremony to remove.\n   * @returns Whether an entry was deleted.\n   */\n  deleteRegistrationCeremony(challenge: string): boolean {\n    return this.#registrationMap.delete(challenge);\n  }\n\n  /**\n   * Removes an authentication ceremony by challenge.\n   *\n   * @param challenge - Map key for the ceremony to remove.\n   * @returns Whether an entry was deleted.\n   */\n  deleteAuthenticationCeremony(challenge: string): boolean {\n    return this.#authenticationMap.delete(challenge);\n  }\n\n  /** Drops all in-flight registration and authentication ceremonies. */\n  clear(): void {\n    this.#registrationMap.clear();\n    this.#authenticationMap.clear();\n  }\n}\n"]}
+{"version":3,"file":"ceremony-manager.js","sourceRoot":"","sources":["../src/ceremony-manager.ts"],"names":[],"mappings":"AAKA,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAIpD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACjB,gBAAgB,GAAG,IAAI,GAAG,EAAuC,CAAC;IAElE,kBAAkB,GAAG,IAAI,GAAG,EAGlC,CAAC;IAEJ;;;;;OAKG;IACH,OAAO,CACL,YAA0B;QAE1B,OAAO,YAAY,KAAK,cAAc;YACpC,CAAC,CAAC,IAAI,CAAC,gBAAgB;YACvB,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,YAA0B;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;YAClC,IAAI,GAAG,GAAG,QAAQ,CAAC,SAAS,GAAG,mBAAmB,EAAE,CAAC;gBACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChB,IAAI,YAAY,KAAK,cAAc,EAAE,CAAC;oBACpC,IAAI,CAAC,8CAA8C,CAAC,GAAG,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,YAA0B;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,IAAI,IAAI,iCAAiC,EAAE,CAAC;YACrD,IAAI,SAA6B,CAAC;YAClC,IAAI,UAAU,GAAG,QAAQ,CAAC;YAC1B,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;gBACrC,IAAI,QAAQ,CAAC,SAAS,GAAG,UAAU,EAAE,CAAC;oBACpC,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC;oBAChC,SAAS,GAAG,MAAM,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM;YACR,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtB,IAAI,YAAY,KAAK,cAAc,EAAE,CAAC;gBACpC,IAAI,CAAC,8CAA8C,CAAC,SAAS,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C,CAC5C,qBAA6B;QAE7B,KAAK,MAAM,CAAC,uBAAuB,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1E,IAAI,QAAQ,CAAC,qBAAqB,KAAK,qBAAqB,EAAE,CAAC;gBAC7D,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,wBAAwB,CACtB,SAAiB,EACjB,QAAqC;QAErC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACnC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CACxB,SAAiB,EACjB,QAAuC;QAEvC,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QACxC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CACrB,SAAiB;QAEjB,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,yBAAyB,CACvB,SAAiB;QAEjB,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CAAC,SAAiB;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,8CAA8C,CAAC,SAAS,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,4BAA4B,CAAC,SAAiB;QAC5C,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;CACF","sourcesContent":["import type {\n  PasskeyAuthenticationCeremony,\n  PasskeyRegistrationCeremony,\n} from './types.js';\n\n/** WebAuthn `timeout` for credential creation and assertion (ms). */\nexport const WEBAUTHN_TIMEOUT_MS = 60_000;\n\n/**\n * Extra allowance beyond {@link WEBAUTHN_TIMEOUT_MS} before in-memory\n * ceremony state is discarded (covers slow UX, multi-step enrollment, and\n * clock skew).\n */\nexport const CEREMONY_TTL_SLACK_MS = 120_000;\n\n/**\n * Maximum age for in-flight registration or authentication ceremony state\n * (between options and verified response). This bounds the lifetime of a\n * single WebAuthn ceremony only; it is not a user login session timeout.\n */\nexport const CEREMONY_MAX_AGE_MS = WEBAUTHN_TIMEOUT_MS + CEREMONY_TTL_SLACK_MS;\n\n/**\n * Upper bound on concurrent in-memory ceremonies per flow type (registration\n * vs authentication), for abuse / leak protection.\n */\nexport const MAX_CONCURRENT_PASSKEY_CEREMONIES = 16;\n\ntype CeremonyFlow = 'registration' | 'authentication';\n\n/**\n * In-memory store for in-flight WebAuthn ceremonies (registration vs authentication),\n * keyed by base64url challenge. Enforces TTL and a per-flow size cap; not user session state.\n */\nexport class CeremonyManager {\n  readonly #registrationMap = new Map<string, PasskeyRegistrationCeremony>();\n\n  readonly #authenticationMap = new Map<\n    string,\n    PasskeyAuthenticationCeremony\n  >();\n\n  /**\n   * Challenge-keyed map for prune/capacity helpers.\n   *\n   * @param ceremonyType - Which in-flight ceremony map to use.\n   * @returns The registration or authentication ceremony map for the given flow.\n   */\n  #getMap(\n    ceremonyType: CeremonyFlow,\n  ): Map<string, PasskeyRegistrationCeremony | PasskeyAuthenticationCeremony> {\n    return ceremonyType === 'registration'\n      ? this.#registrationMap\n      : this.#authenticationMap;\n  }\n\n  #pruneExpired(ceremonyType: CeremonyFlow): void {\n    const now = Date.now();\n    const map = this.#getMap(ceremonyType);\n    for (const [key, ceremony] of map) {\n      if (now - ceremony.createdAt > CEREMONY_MAX_AGE_MS) {\n        map.delete(key);\n        if (ceremonyType === 'registration') {\n          this.#deleteAuthenticationCeremoniesForRegistration(key);\n        }\n      }\n    }\n  }\n\n  /**\n   * Removes the oldest entry (by `createdAt`) until size is below the cap.\n   *\n   * @param ceremonyType - Which in-flight ceremony map to evict from.\n   */\n  #enforceCapacity(ceremonyType: CeremonyFlow): void {\n    const map = this.#getMap(ceremonyType);\n    while (map.size >= MAX_CONCURRENT_PASSKEY_CEREMONIES) {\n      let oldestKey: string | undefined;\n      let oldestTime = Infinity;\n      for (const [mapKey, ceremony] of map) {\n        if (ceremony.createdAt < oldestTime) {\n          oldestTime = ceremony.createdAt;\n          oldestKey = mapKey;\n        }\n      }\n      if (oldestKey === undefined) {\n        break;\n      }\n      map.delete(oldestKey);\n      if (ceremonyType === 'registration') {\n        this.#deleteAuthenticationCeremoniesForRegistration(oldestKey);\n      }\n    }\n  }\n\n  #deleteAuthenticationCeremoniesForRegistration(\n    registrationChallenge: string,\n  ): void {\n    for (const [authenticationChallenge, ceremony] of this.#authenticationMap) {\n      if (ceremony.registrationChallenge === registrationChallenge) {\n        this.#authenticationMap.delete(authenticationChallenge);\n      }\n    }\n  }\n\n  /**\n   * Records registration ceremony state after pruning expired rows and evicting oldest if at cap.\n   *\n   * @param challenge - Same base64url challenge as in the creation options `challenge` field.\n   * @param ceremony - Payload to retrieve when the registration response returns.\n   */\n  saveRegistrationCeremony(\n    challenge: string,\n    ceremony: PasskeyRegistrationCeremony,\n  ): void {\n    this.#pruneExpired('registration');\n    this.#enforceCapacity('registration');\n    this.#registrationMap.set(challenge, ceremony);\n  }\n\n  /**\n   * Records authentication ceremony state after pruning expired rows and evicting oldest if at cap.\n   *\n   * @param challenge - Same base64url challenge as in the request options `challenge` field.\n   * @param ceremony - Payload to retrieve when the assertion response returns.\n   */\n  saveAuthenticationCeremony(\n    challenge: string,\n    ceremony: PasskeyAuthenticationCeremony,\n  ): void {\n    this.#pruneExpired('authentication');\n    this.#enforceCapacity('authentication');\n    this.#authenticationMap.set(challenge, ceremony);\n  }\n\n  /**\n   * Returns registration ceremony for a challenge, pruning expired entries on this map first.\n   *\n   * @param challenge - Base64url challenge from decoded `clientDataJSON` (matches stored key).\n   * @returns Stored ceremony, or `undefined` if none or expired.\n   */\n  getRegistrationCeremony(\n    challenge: string,\n  ): PasskeyRegistrationCeremony | undefined {\n    this.#pruneExpired('registration');\n    return this.#registrationMap.get(challenge);\n  }\n\n  /**\n   * Returns authentication ceremony for a challenge, pruning expired entries on this map first.\n   *\n   * @param challenge - Base64url challenge from decoded `clientDataJSON` (matches stored key).\n   * @returns Stored ceremony, or `undefined` if none or expired.\n   */\n  getAuthenticationCeremony(\n    challenge: string,\n  ): PasskeyAuthenticationCeremony | undefined {\n    this.#pruneExpired('authentication');\n    return this.#authenticationMap.get(challenge);\n  }\n\n  /**\n   * Removes a registration ceremony by challenge.\n   *\n   * @param challenge - Map key for the ceremony to remove.\n   * @returns Whether an entry was deleted.\n   */\n  deleteRegistrationCeremony(challenge: string): boolean {\n    const deleted = this.#registrationMap.delete(challenge);\n    this.#deleteAuthenticationCeremoniesForRegistration(challenge);\n    return deleted;\n  }\n\n  /**\n   * Removes an authentication ceremony by challenge.\n   *\n   * @param challenge - Map key for the ceremony to remove.\n   * @returns Whether an entry was deleted.\n   */\n  deleteAuthenticationCeremony(challenge: string): boolean {\n    return this.#authenticationMap.delete(challenge);\n  }\n\n  /** Drops all in-flight registration and authentication ceremonies. */\n  clear(): void {\n    this.#registrationMap.clear();\n    this.#authenticationMap.clear();\n  }\n}\n"]}

package/dist/constants.d.ts

@@ -6,6 +6,9 @@ export declare const controllerName = "PasskeyController";
 export declare const PasskeyControllerErrorCode: {
     readonly NotEnrolled: 'not_enrolled';
     readonly AlreadyEnrolled: 'already_enrolled';
+    readonly MigrationNotRequired: 'migration_not_required';
+    readonly PrfRequired: 'prf_required';
+    readonly ReplacementSourceChanged: 'replacement_source_changed';
     readonly NoRegistrationCeremony: 'no_registration_ceremony';
     readonly RegistrationVerificationFailed: 'registration_verification_failed';
     readonly NoAuthenticationCeremony: 'no_authentication_ceremony';
@@ -23,6 +26,9 @@ export type PasskeyControllerErrorCode = (typeof PasskeyControllerErrorCode)[key
 export declare enum PasskeyControllerErrorMessage {
     NotEnrolled = "PasskeyController - Passkey is not enrolled",
     AlreadyEnrolled = "PasskeyController - Passkey is already enrolled",
+    MigrationNotRequired = "PasskeyController - PRF migration is not required",
+    PrfRequired = "PasskeyController - PRF output required for passkey migration",
+    ReplacementSourceChanged = "PasskeyController - Passkey replacement source changed",
     NoRegistrationCeremony = "PasskeyController - No active passkey registration ceremony",
     RegistrationVerificationFailed = "PasskeyController - Passkey registration verification failed",
     NoAuthenticationCeremony = "PasskeyController - No active passkey authentication ceremony",

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;aACrC,WAAW,EAAE,cAAc;aAC3B,eAAe,EAAE,kBAAkB;aACnC,sBAAsB,EAAE,0BAA0B;aAClD,8BAA8B,EAAE,kCAAkC;aAClE,wBAAwB,EAAE,4BAA4B;aACtD,gCAAgC,EAAE,oCAAoC;aACtE,kBAAkB,EAAE,sBAAsB;aAC1C,wBAAwB,EAAE,6BAA6B;aACvD,gBAAgB,EAAE,oBAAoB;aACtC,qBAAqB,EAAE,0BAA0B;aACjD,0BAA0B,EAAE,8BAA8B;CAClD,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAE/E;;GAEG;AACH,oBAAY,6BAA6B;IACvC,WAAW,gDAAgD;IAC3D,eAAe,oDAAoD;IACnE,sBAAsB,gEAAgE;IACtF,8BAA8B,iEAAiE;IAC/F,wBAAwB,kEAAkE;IAC1F,gCAAgC,mEAAmE;IACnG,kBAAkB,wEAAwE;IAC1F,wBAAwB,4DAA4D;IACpF,gBAAgB,oFAAoF;IACpG,0BAA0B,8DAA8D;IACxF,qBAAqB,yDAAyD;CAC/E"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;aACrC,WAAW,EAAE,cAAc;aAC3B,eAAe,EAAE,kBAAkB;aACnC,oBAAoB,EAAE,wBAAwB;aAC9C,WAAW,EAAE,cAAc;aAC3B,wBAAwB,EAAE,4BAA4B;aACtD,sBAAsB,EAAE,0BAA0B;aAClD,8BAA8B,EAAE,kCAAkC;aAClE,wBAAwB,EAAE,4BAA4B;aACtD,gCAAgC,EAAE,oCAAoC;aACtE,kBAAkB,EAAE,sBAAsB;aAC1C,wBAAwB,EAAE,6BAA6B;aACvD,gBAAgB,EAAE,oBAAoB;aACtC,qBAAqB,EAAE,0BAA0B;aACjD,0BAA0B,EAAE,8BAA8B;CAClD,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAE/E;;GAEG;AACH,oBAAY,6BAA6B;IACvC,WAAW,gDAAgD;IAC3D,eAAe,oDAAoD;IACnE,oBAAoB,sDAAsD;IAC1E,WAAW,kEAAkE;IAC7E,wBAAwB,2DAA2D;IACnF,sBAAsB,gEAAgE;IACtF,8BAA8B,iEAAiE;IAC/F,wBAAwB,kEAAkE;IAC1F,gCAAgC,mEAAmE;IACnG,kBAAkB,wEAAwE;IAC1F,wBAAwB,4DAA4D;IACpF,gBAAgB,oFAAoF;IACpG,0BAA0B,8DAA8D;IACxF,qBAAqB,yDAAyD;CAC/E"}

package/dist/constants.js

@@ -6,6 +6,9 @@ export const controllerName = 'PasskeyController';
 export const PasskeyControllerErrorCode = {
     NotEnrolled: 'not_enrolled',
     AlreadyEnrolled: 'already_enrolled',
+    MigrationNotRequired: 'migration_not_required',
+    PrfRequired: 'prf_required',
+    ReplacementSourceChanged: 'replacement_source_changed',
     NoRegistrationCeremony: 'no_registration_ceremony',
     RegistrationVerificationFailed: 'registration_verification_failed',
     NoAuthenticationCeremony: 'no_authentication_ceremony',
@@ -23,6 +26,9 @@ export var PasskeyControllerErrorMessage;
 (function (PasskeyControllerErrorMessage) {
     PasskeyControllerErrorMessage["NotEnrolled"] = "PasskeyController - Passkey is not enrolled";
     PasskeyControllerErrorMessage["AlreadyEnrolled"] = "PasskeyController - Passkey is already enrolled";
+    PasskeyControllerErrorMessage["MigrationNotRequired"] = "PasskeyController - PRF migration is not required";
+    PasskeyControllerErrorMessage["PrfRequired"] = "PasskeyController - PRF output required for passkey migration";
+    PasskeyControllerErrorMessage["ReplacementSourceChanged"] = "PasskeyController - Passkey replacement source changed";
     PasskeyControllerErrorMessage["NoRegistrationCeremony"] = "PasskeyController - No active passkey registration ceremony";
     PasskeyControllerErrorMessage["RegistrationVerificationFailed"] = "PasskeyController - Passkey registration verification failed";
     PasskeyControllerErrorMessage["NoAuthenticationCeremony"] = "PasskeyController - No active passkey authentication ceremony";

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,kBAAkB;IACnC,sBAAsB,EAAE,0BAA0B;IAClD,8BAA8B,EAAE,kCAAkC;IAClE,wBAAwB,EAAE,4BAA4B;IACtD,gCAAgC,EAAE,oCAAoC;IACtE,kBAAkB,EAAE,sBAAsB;IAC1C,wBAAwB,EAAE,6BAA6B;IACvD,gBAAgB,EAAE,oBAAoB;IACtC,qBAAqB,EAAE,0BAA0B;IACjD,0BAA0B,EAAE,8BAA8B;CAClD,CAAC;AAKX;;GAEG;AACH,MAAM,CAAN,IAAY,6BAYX;AAZD,WAAY,6BAA6B;IACvC,4FAA2D,CAAA;IAC3D,oGAAmE,CAAA;IACnE,uHAAsF,CAAA;IACtF,gIAA+F,CAAA;IAC/F,2HAA0F,CAAA;IAC1F,oIAAmG,CAAA;IACnG,2HAA0F,CAAA;IAC1F,qHAAoF,CAAA;IACpF,qIAAoG,CAAA;IACpG,yHAAwF,CAAA;IACxF,+GAA8E,CAAA;AAChF,CAAC,EAZW,6BAA6B,KAA7B,6BAA6B,QAYxC","sourcesContent":["export const controllerName = 'PasskeyController';\n\n/**\n * Stable programmatic codes for {@link PasskeyControllerError}.\n * Use these instead of matching `message` strings.\n */\nexport const PasskeyControllerErrorCode = {\n  NotEnrolled: 'not_enrolled',\n  AlreadyEnrolled: 'already_enrolled',\n  NoRegistrationCeremony: 'no_registration_ceremony',\n  RegistrationVerificationFailed: 'registration_verification_failed',\n  NoAuthenticationCeremony: 'no_authentication_ceremony',\n  AuthenticationVerificationFailed: 'authentication_verification_failed',\n  MissingKeyMaterial: 'missing_key_material',\n  VaultKeyDecryptionFailed: 'vault_key_decryption_failed',\n  VaultKeyMismatch: 'vault_key_mismatch',\n  VaultKeyRenewalFailed: 'vault_key_renewal_failed',\n  EnrollmentPasswordRequired: 'enrollment_password_required',\n} as const;\n\nexport type PasskeyControllerErrorCode =\n  (typeof PasskeyControllerErrorCode)[keyof typeof PasskeyControllerErrorCode];\n\n/**\n * Human-readable messages for {@link PasskeyControllerError}.\n */\nexport enum PasskeyControllerErrorMessage {\n  NotEnrolled = `${controllerName} - Passkey is not enrolled`,\n  AlreadyEnrolled = `${controllerName} - Passkey is already enrolled`,\n  NoRegistrationCeremony = `${controllerName} - No active passkey registration ceremony`,\n  RegistrationVerificationFailed = `${controllerName} - Passkey registration verification failed`,\n  NoAuthenticationCeremony = `${controllerName} - No active passkey authentication ceremony`,\n  AuthenticationVerificationFailed = `${controllerName} - Passkey authentication verification failed`,\n  MissingKeyMaterial = `${controllerName} - Passkey assertion missing required key material`,\n  VaultKeyDecryptionFailed = `${controllerName} - Passkey vault key decryption failed`,\n  VaultKeyMismatch = `${controllerName} - Passkey authentication does not match the current vault key`,\n  EnrollmentPasswordRequired = `${controllerName} - Password required to register passkey`,\n  VaultKeyRenewalFailed = `${controllerName} - Passkey vault key renewal failed`,\n}\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,kBAAkB;IACnC,oBAAoB,EAAE,wBAAwB;IAC9C,WAAW,EAAE,cAAc;IAC3B,wBAAwB,EAAE,4BAA4B;IACtD,sBAAsB,EAAE,0BAA0B;IAClD,8BAA8B,EAAE,kCAAkC;IAClE,wBAAwB,EAAE,4BAA4B;IACtD,gCAAgC,EAAE,oCAAoC;IACtE,kBAAkB,EAAE,sBAAsB;IAC1C,wBAAwB,EAAE,6BAA6B;IACvD,gBAAgB,EAAE,oBAAoB;IACtC,qBAAqB,EAAE,0BAA0B;IACjD,0BAA0B,EAAE,8BAA8B;CAClD,CAAC;AAKX;;GAEG;AACH,MAAM,CAAN,IAAY,6BAeX;AAfD,WAAY,6BAA6B;IACvC,4FAA2D,CAAA;IAC3D,oGAAmE,CAAA;IACnE,2GAA0E,CAAA;IAC1E,8GAA6E,CAAA;IAC7E,oHAAmF,CAAA;IACnF,uHAAsF,CAAA;IACtF,gIAA+F,CAAA;IAC/F,2HAA0F,CAAA;IAC1F,oIAAmG,CAAA;IACnG,2HAA0F,CAAA;IAC1F,qHAAoF,CAAA;IACpF,qIAAoG,CAAA;IACpG,yHAAwF,CAAA;IACxF,+GAA8E,CAAA;AAChF,CAAC,EAfW,6BAA6B,KAA7B,6BAA6B,QAexC","sourcesContent":["export const controllerName = 'PasskeyController';\n\n/**\n * Stable programmatic codes for {@link PasskeyControllerError}.\n * Use these instead of matching `message` strings.\n */\nexport const PasskeyControllerErrorCode = {\n  NotEnrolled: 'not_enrolled',\n  AlreadyEnrolled: 'already_enrolled',\n  MigrationNotRequired: 'migration_not_required',\n  PrfRequired: 'prf_required',\n  ReplacementSourceChanged: 'replacement_source_changed',\n  NoRegistrationCeremony: 'no_registration_ceremony',\n  RegistrationVerificationFailed: 'registration_verification_failed',\n  NoAuthenticationCeremony: 'no_authentication_ceremony',\n  AuthenticationVerificationFailed: 'authentication_verification_failed',\n  MissingKeyMaterial: 'missing_key_material',\n  VaultKeyDecryptionFailed: 'vault_key_decryption_failed',\n  VaultKeyMismatch: 'vault_key_mismatch',\n  VaultKeyRenewalFailed: 'vault_key_renewal_failed',\n  EnrollmentPasswordRequired: 'enrollment_password_required',\n} as const;\n\nexport type PasskeyControllerErrorCode =\n  (typeof PasskeyControllerErrorCode)[keyof typeof PasskeyControllerErrorCode];\n\n/**\n * Human-readable messages for {@link PasskeyControllerError}.\n */\nexport enum PasskeyControllerErrorMessage {\n  NotEnrolled = `${controllerName} - Passkey is not enrolled`,\n  AlreadyEnrolled = `${controllerName} - Passkey is already enrolled`,\n  MigrationNotRequired = `${controllerName} - PRF migration is not required`,\n  PrfRequired = `${controllerName} - PRF output required for passkey migration`,\n  ReplacementSourceChanged = `${controllerName} - Passkey replacement source changed`,\n  NoRegistrationCeremony = `${controllerName} - No active passkey registration ceremony`,\n  RegistrationVerificationFailed = `${controllerName} - Passkey registration verification failed`,\n  NoAuthenticationCeremony = `${controllerName} - No active passkey authentication ceremony`,\n  AuthenticationVerificationFailed = `${controllerName} - Passkey authentication verification failed`,\n  MissingKeyMaterial = `${controllerName} - Passkey assertion missing required key material`,\n  VaultKeyDecryptionFailed = `${controllerName} - Passkey vault key decryption failed`,\n  VaultKeyMismatch = `${controllerName} - Passkey authentication does not match the current vault key`,\n  EnrollmentPasswordRequired = `${controllerName} - Password required to register passkey`,\n  VaultKeyRenewalFailed = `${controllerName} - Passkey vault key renewal failed`,\n}\n"]}

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export { PasskeyController, getDefaultPasskeyControllerState, passkeyControllerS
 export type { PasskeyControllerState, PasskeyControllerMessenger, PasskeyControllerOptions, PasskeyControllerGetStateAction, PasskeyControllerActions, PasskeyControllerStateChangedEvent, PasskeyControllerEvents, PasskeyCredentialInfo, PasskeyDerivationMethod, PasskeyKeyDerivation, PasskeyRecord, PrfEvalExtension, PrfClientExtensionResults, } from './types.js';
 export type { PasskeyRegistrationOptions, PasskeyRegistrationResponse, PasskeyAuthenticationOptions, PasskeyAuthenticationResponse, } from './webauthn/types.js';
 export { getAAGUIDFromRegistrationResponse } from './webauthn/verify-registration-response.js';
-export type { PasskeyControllerIsPasskeyEnrolledAction, PasskeyControllerGenerateRegistrationOptionsAction, PasskeyControllerGeneratePostRegistrationAuthenticationOptionsAction, PasskeyControllerGenerateAuthenticationOptionsAction, PasskeyControllerProtectVaultKeyWithPasskeyAction, PasskeyControllerRetrieveVaultKeyWithPasskeyAction, PasskeyControllerUnlockWithPasskeyAction, PasskeyControllerExportSeedPhraseWithPasskeyAction, PasskeyControllerExportAccountsWithPasskeyAction, PasskeyControllerVerifyPasskeyAuthenticationAction, PasskeyControllerRenewVaultKeyProtectionAction, PasskeyControllerChangePasswordWithPasskeyVerificationAction, PasskeyControllerRemovePasskeyWithPasskeyVerificationAction, PasskeyControllerRemovePasskeyWithPasswordVerificationAction, PasskeyControllerClearStateAction, PasskeyControllerDestroyAction, } from './PasskeyController-method-action-types.js';
+export type { PasskeyControllerIsPasskeyEnrolledAction, PasskeyControllerGenerateRegistrationOptionsAction, PasskeyControllerGeneratePasskeyReplacementRegistrationOptionsAction, PasskeyControllerCompletePasskeyReplacementAction, PasskeyControllerCancelPasskeyReplacementAction, PasskeyControllerGeneratePostRegistrationAuthenticationOptionsAction, PasskeyControllerGenerateAuthenticationOptionsAction, PasskeyControllerProtectVaultKeyWithPasskeyAction, PasskeyControllerRetrieveVaultKeyWithPasskeyAction, PasskeyControllerUnlockWithPasskeyAction, PasskeyControllerExportSeedPhraseWithPasskeyAction, PasskeyControllerExportAccountsWithPasskeyAction, PasskeyControllerVerifyPasskeyAuthenticationAction, PasskeyControllerRenewVaultKeyProtectionAction, PasskeyControllerChangePasswordWithPasskeyVerificationAction, PasskeyControllerRemovePasskeyWithPasskeyVerificationAction, PasskeyControllerRemovePasskeyWithPasswordVerificationAction, PasskeyControllerClearStateAction, PasskeyControllerDestroyAction, } from './PasskeyController-method-action-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,kCAAkC,EAClC,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,YAAY,EACV,wCAAwC,EACxC,kDAAkD,EAClD,oEAAoE,EACpE,oDAAoD,EACpD,iDAAiD,EACjD,kDAAkD,EAClD,wCAAwC,EACxC,kDAAkD,EAClD,gDAAgD,EAChD,kDAAkD,EAClD,8CAA8C,EAC9C,4DAA4D,EAC5D,2DAA2D,EAC3D,4DAA4D,EAC5D,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,kCAAkC,EAClC,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,YAAY,EACV,wCAAwC,EACxC,kDAAkD,EAClD,oEAAoE,EACpE,iDAAiD,EACjD,+CAA+C,EAC/C,oEAAoE,EACpE,oDAAoD,EACpD,iDAAiD,EACjD,kDAAkD,EAClD,wCAAwC,EACxC,kDAAkD,EAClD,gDAAgD,EAChD,kDAAkD,EAClD,8CAA8C,EAC9C,4DAA4D,EAC5D,2DAA2D,EAC3D,4DAA4D,EAC5D,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC","sourcesContent":["export {\n  PasskeyControllerErrorCode,\n  PasskeyControllerErrorMessage,\n} from './constants.js';\nexport { PasskeyControllerError } from './errors.js';\nexport {\n  PasskeyController,\n  getDefaultPasskeyControllerState,\n  passkeyControllerSelectors,\n} from './PasskeyController.js';\nexport type {\n  PasskeyControllerState,\n  PasskeyControllerMessenger,\n  PasskeyControllerOptions,\n  PasskeyControllerGetStateAction,\n  PasskeyControllerActions,\n  PasskeyControllerStateChangedEvent,\n  PasskeyControllerEvents,\n  PasskeyCredentialInfo,\n  PasskeyDerivationMethod,\n  PasskeyKeyDerivation,\n  PasskeyRecord,\n  PrfEvalExtension,\n  PrfClientExtensionResults,\n} from './types.js';\nexport type {\n  PasskeyRegistrationOptions,\n  PasskeyRegistrationResponse,\n  PasskeyAuthenticationOptions,\n  PasskeyAuthenticationResponse,\n} from './webauthn/types.js';\nexport { getAAGUIDFromRegistrationResponse } from './webauthn/verify-registration-response.js';\nexport type {\n  PasskeyControllerIsPasskeyEnrolledAction,\n  PasskeyControllerGenerateRegistrationOptionsAction,\n  PasskeyControllerGeneratePostRegistrationAuthenticationOptionsAction,\n  PasskeyControllerGenerateAuthenticationOptionsAction,\n  PasskeyControllerProtectVaultKeyWithPasskeyAction,\n  PasskeyControllerRetrieveVaultKeyWithPasskeyAction,\n  PasskeyControllerUnlockWithPasskeyAction,\n  PasskeyControllerExportSeedPhraseWithPasskeyAction,\n  PasskeyControllerExportAccountsWithPasskeyAction,\n  PasskeyControllerVerifyPasskeyAuthenticationAction,\n  PasskeyControllerRenewVaultKeyProtectionAction,\n  PasskeyControllerChangePasswordWithPasskeyVerificationAction,\n  PasskeyControllerRemovePasskeyWithPasskeyVerificationAction,\n  PasskeyControllerRemovePasskeyWithPasswordVerificationAction,\n  PasskeyControllerClearStateAction,\n  PasskeyControllerDestroyAction,\n} from './PasskeyController-method-action-types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC","sourcesContent":["export {\n  PasskeyControllerErrorCode,\n  PasskeyControllerErrorMessage,\n} from './constants.js';\nexport { PasskeyControllerError } from './errors.js';\nexport {\n  PasskeyController,\n  getDefaultPasskeyControllerState,\n  passkeyControllerSelectors,\n} from './PasskeyController.js';\nexport type {\n  PasskeyControllerState,\n  PasskeyControllerMessenger,\n  PasskeyControllerOptions,\n  PasskeyControllerGetStateAction,\n  PasskeyControllerActions,\n  PasskeyControllerStateChangedEvent,\n  PasskeyControllerEvents,\n  PasskeyCredentialInfo,\n  PasskeyDerivationMethod,\n  PasskeyKeyDerivation,\n  PasskeyRecord,\n  PrfEvalExtension,\n  PrfClientExtensionResults,\n} from './types.js';\nexport type {\n  PasskeyRegistrationOptions,\n  PasskeyRegistrationResponse,\n  PasskeyAuthenticationOptions,\n  PasskeyAuthenticationResponse,\n} from './webauthn/types.js';\nexport { getAAGUIDFromRegistrationResponse } from './webauthn/verify-registration-response.js';\nexport type {\n  PasskeyControllerIsPasskeyEnrolledAction,\n  PasskeyControllerGenerateRegistrationOptionsAction,\n  PasskeyControllerGeneratePasskeyReplacementRegistrationOptionsAction,\n  PasskeyControllerCompletePasskeyReplacementAction,\n  PasskeyControllerCancelPasskeyReplacementAction,\n  PasskeyControllerGeneratePostRegistrationAuthenticationOptionsAction,\n  PasskeyControllerGenerateAuthenticationOptionsAction,\n  PasskeyControllerProtectVaultKeyWithPasskeyAction,\n  PasskeyControllerRetrieveVaultKeyWithPasskeyAction,\n  PasskeyControllerUnlockWithPasskeyAction,\n  PasskeyControllerExportSeedPhraseWithPasskeyAction,\n  PasskeyControllerExportAccountsWithPasskeyAction,\n  PasskeyControllerVerifyPasskeyAuthenticationAction,\n  PasskeyControllerRenewVaultKeyProtectionAction,\n  PasskeyControllerChangePasswordWithPasskeyVerificationAction,\n  PasskeyControllerRemovePasskeyWithPasskeyVerificationAction,\n  PasskeyControllerRemovePasskeyWithPasswordVerificationAction,\n  PasskeyControllerClearStateAction,\n  PasskeyControllerDestroyAction,\n} from './PasskeyController-method-action-types.js';\n"]}

package/dist/types.d.ts

@@ -60,9 +60,10 @@ export type PasskeyRecord = {
 };
 /**
  * In-memory state for one **in-flight** WebAuthn **registration** ceremony
- * (from `create()` options until `protectVaultKeyWithPasskey` completes). This is
- * not a user login session; it is keyed by challenge and distinct from the full
- * spec ceremony (which includes the authenticator round-trip).
+ * (from `create()` options until the enrollment or replacement completion
+ * method finishes). This is not a user login session; it is keyed by challenge
+ * and distinct from the full spec ceremony (which includes the authenticator
+ * round-trip).
  */
 export type PasskeyRegistrationCeremony = {
     userHandle: Base64URLString;
@@ -70,6 +71,14 @@ export type PasskeyRegistrationCeremony = {
     challenge: Base64URLString;
     /** When this ceremony was started (ms since epoch); used for TTL pruning. */
     createdAt: number;
+    /**
+     * Whether this ceremony is for replacing an existing passkey.
+     *
+     * Omitted or `false` for existing enrollment ceremonies.
+     */
+    isReplacement?: boolean;
+    /** Credential ID of the record being replaced. */
+    sourceCredentialId?: Base64URLString;
 };
 /**
  * In-memory state for one **in-flight** WebAuthn **authentication** ceremony
@@ -77,6 +86,11 @@ export type PasskeyRegistrationCeremony = {
  */
 export type PasskeyAuthenticationCeremony = {
     challenge: Base64URLString;
+    /**
+     * Registration challenge when this authentication is the post-registration
+     * step of an enrollment or replacement ceremony.
+     */
+    registrationChallenge?: Base64URLString;
     /** When this ceremony was started (ms since epoch); used for TTL pruning. */
     createdAt: number;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n} from '@metamask/base-controller';\nimport type {\n  KeyringControllerChangePasswordAction,\n  KeyringControllerExportAccountAction,\n  KeyringControllerExportEncryptionKeyAction,\n  KeyringControllerExportSeedPhraseAction,\n  KeyringControllerSubmitEncryptionKeyAction,\n  KeyringControllerVerifyPasswordAction,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport { controllerName } from './constants.js';\nimport type { PasskeyControllerMethodActions } from './PasskeyController-method-action-types.js';\n\nexport type Base64String = string;\n\nexport type Base64URLString = string;\n\nexport type AuthenticatorTransportFuture =\n  | 'ble'\n  | 'cable'\n  | 'hybrid'\n  | 'internal'\n  | 'nfc'\n  | 'smart-card'\n  | 'usb';\n\n/**\n * WebAuthn credential metadata used to identify the passkey and verify\n * subsequent assertions.\n */\nexport type PasskeyCredentialInfo = {\n  /** WebAuthn credential ID (base64url). */\n  id: Base64URLString;\n  /** COSE-encoded credential public key (base64url) used to verify assertions. */\n  publicKey: Base64URLString;\n  /** Authenticator signature counter for replay/clone detection. */\n  counter: number;\n  /** Authenticator transports hint for `allowCredentials`. */\n  transports?: AuthenticatorTransportFuture[];\n  /** Authenticator AAGUID captured from attested credential data at registration. */\n  aaguid: string;\n};\n\n/**\n * Vault key wrapped under the passkey-derived AES-256-GCM key.\n */\nexport type EncryptedVaultKey = {\n  /** Base64-encoded AES-256-GCM ciphertext of the vault key. */\n  ciphertext: Base64String;\n  /** Base64-encoded AES-GCM IV used during encryption. */\n  iv: Base64String;\n};\n\n/**\n * Parameters needed to reproduce the AES-256 wrapping key at unlock time.\n *\n * Encoded as a discriminated union so PRF-only fields (e.g. `prfSalt`) can\n * only exist on the PRF branch, removing the \"optional but actually\n * required\" footgun.\n */\nexport type PasskeyKeyDerivation =\n  | {\n      method: 'prf';\n      /**\n       * PRF salt sent in `get()` extension options to reproduce the same PRF\n       * output that was generated at registration.\n       */\n      prfSalt: Base64URLString;\n    }\n  | { method: 'userHandle' };\n\n/** Discriminator value for {@link PasskeyKeyDerivation}. */\nexport type PasskeyDerivationMethod = PasskeyKeyDerivation['method'];\n\nexport type PasskeyRecord = {\n  /** WebAuthn credential metadata used for assertion verification & re-discovery. */\n  credential: PasskeyCredentialInfo;\n  /** Vault key wrapped under the passkey-derived key. */\n  encryptedVaultKey: EncryptedVaultKey;\n  /** How the wrapping key is reconstructed at unlock time. */\n  keyDerivation: PasskeyKeyDerivation;\n};\n\n/**\n * In-memory state for one **in-flight** WebAuthn **registration** ceremony\n * (from `create()` options until `protectVaultKeyWithPasskey` completes). This is\n * not a user login session; it is keyed by challenge and distinct from the full\n * spec ceremony (which includes the authenticator round-trip).\n */\nexport type PasskeyRegistrationCeremony = {\n  userHandle: Base64URLString;\n  prfSalt?: Base64URLString;\n  challenge: Base64URLString;\n  /** When this ceremony was started (ms since epoch); used for TTL pruning. */\n  createdAt: number;\n};\n\n/**\n * In-memory state for one **in-flight** WebAuthn **authentication** ceremony\n * (`get()` options until the assertion is verified). Not a user login session.\n */\nexport type PasskeyAuthenticationCeremony = {\n  challenge: Base64URLString;\n  /** When this ceremony was started (ms since epoch); used for TTL pruning. */\n  createdAt: number;\n};\n\n/**\n * PRF extension types not covered by DOM typings.\n */\nexport type PrfEvalExtension = {\n  eval: {\n    first: Base64URLString;\n  };\n};\n\nexport type PrfClientExtensionResults = {\n  prf?: {\n    enabled?: boolean;\n    results?: { first?: Base64URLString };\n  };\n};\n\nexport type PasskeyControllerState = {\n  passkeyRecord: PasskeyRecord | null;\n};\n\nexport type PasskeyControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  PasskeyControllerState\n>;\n\n/**\n * KeyringController actions that {@link PasskeyController} may call during\n * orchestrated passkey flows. The restricted messenger must allow these at init.\n */\nexport type PasskeyControllerAllowedActions =\n  | KeyringControllerVerifyPasswordAction\n  | KeyringControllerExportEncryptionKeyAction\n  | KeyringControllerSubmitEncryptionKeyAction\n  | KeyringControllerChangePasswordAction\n  | KeyringControllerExportSeedPhraseAction\n  | KeyringControllerExportAccountAction;\n\n/**\n * Actions exposed by {@link PasskeyController} on its messenger, including\n * `:getState`, enrollment/unlock ceremony methods, and lifecycle helpers.\n */\nexport type PasskeyControllerActions =\n  | PasskeyControllerGetStateAction\n  | PasskeyControllerMethodActions;\n\nexport type PasskeyControllerStateChangedEvent = ControllerStateChangedEvent<\n  typeof controllerName,\n  PasskeyControllerState\n>;\n\nexport type PasskeyControllerEvents = PasskeyControllerStateChangedEvent;\n\nexport type PasskeyControllerMessenger = Messenger<\n  typeof controllerName,\n  PasskeyControllerActions | PasskeyControllerAllowedActions,\n  PasskeyControllerEvents\n>;\n\nexport type PasskeyControllerOptions = {\n  messenger: PasskeyControllerMessenger;\n  state?: Partial<PasskeyControllerState>;\n  rpId?: string;\n  expectedRPID: string | string[];\n  rpName: string;\n  expectedOrigin: string | string[];\n  userName?: string;\n  userDisplayName?: string;\n  /**\n   * Returns whether wallet onboarding is complete. When `true`, enrollment\n   * requires password step-up. The integrator typically supplies\n   * `() => onboardingController.state.completedOnboarding`.\n   */\n  getIsOnboardingCompleted: () => boolean;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangedEvent,\n} from '@metamask/base-controller';\nimport type {\n  KeyringControllerChangePasswordAction,\n  KeyringControllerExportAccountAction,\n  KeyringControllerExportEncryptionKeyAction,\n  KeyringControllerExportSeedPhraseAction,\n  KeyringControllerSubmitEncryptionKeyAction,\n  KeyringControllerVerifyPasswordAction,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport { controllerName } from './constants.js';\nimport type { PasskeyControllerMethodActions } from './PasskeyController-method-action-types.js';\n\nexport type Base64String = string;\n\nexport type Base64URLString = string;\n\nexport type AuthenticatorTransportFuture =\n  | 'ble'\n  | 'cable'\n  | 'hybrid'\n  | 'internal'\n  | 'nfc'\n  | 'smart-card'\n  | 'usb';\n\n/**\n * WebAuthn credential metadata used to identify the passkey and verify\n * subsequent assertions.\n */\nexport type PasskeyCredentialInfo = {\n  /** WebAuthn credential ID (base64url). */\n  id: Base64URLString;\n  /** COSE-encoded credential public key (base64url) used to verify assertions. */\n  publicKey: Base64URLString;\n  /** Authenticator signature counter for replay/clone detection. */\n  counter: number;\n  /** Authenticator transports hint for `allowCredentials`. */\n  transports?: AuthenticatorTransportFuture[];\n  /** Authenticator AAGUID captured from attested credential data at registration. */\n  aaguid: string;\n};\n\n/**\n * Vault key wrapped under the passkey-derived AES-256-GCM key.\n */\nexport type EncryptedVaultKey = {\n  /** Base64-encoded AES-256-GCM ciphertext of the vault key. */\n  ciphertext: Base64String;\n  /** Base64-encoded AES-GCM IV used during encryption. */\n  iv: Base64String;\n};\n\n/**\n * Parameters needed to reproduce the AES-256 wrapping key at unlock time.\n *\n * Encoded as a discriminated union so PRF-only fields (e.g. `prfSalt`) can\n * only exist on the PRF branch, removing the \"optional but actually\n * required\" footgun.\n */\nexport type PasskeyKeyDerivation =\n  | {\n      method: 'prf';\n      /**\n       * PRF salt sent in `get()` extension options to reproduce the same PRF\n       * output that was generated at registration.\n       */\n      prfSalt: Base64URLString;\n    }\n  | { method: 'userHandle' };\n\n/** Discriminator value for {@link PasskeyKeyDerivation}. */\nexport type PasskeyDerivationMethod = PasskeyKeyDerivation['method'];\n\nexport type PasskeyRecord = {\n  /** WebAuthn credential metadata used for assertion verification & re-discovery. */\n  credential: PasskeyCredentialInfo;\n  /** Vault key wrapped under the passkey-derived key. */\n  encryptedVaultKey: EncryptedVaultKey;\n  /** How the wrapping key is reconstructed at unlock time. */\n  keyDerivation: PasskeyKeyDerivation;\n};\n\n/**\n * In-memory state for one **in-flight** WebAuthn **registration** ceremony\n * (from `create()` options until the enrollment or replacement completion\n * method finishes). This is not a user login session; it is keyed by challenge\n * and distinct from the full spec ceremony (which includes the authenticator\n * round-trip).\n */\nexport type PasskeyRegistrationCeremony = {\n  userHandle: Base64URLString;\n  prfSalt?: Base64URLString;\n  challenge: Base64URLString;\n  /** When this ceremony was started (ms since epoch); used for TTL pruning. */\n  createdAt: number;\n  /**\n   * Whether this ceremony is for replacing an existing passkey.\n   *\n   * Omitted or `false` for existing enrollment ceremonies.\n   */\n  isReplacement?: boolean;\n  /** Credential ID of the record being replaced. */\n  sourceCredentialId?: Base64URLString;\n};\n\n/**\n * In-memory state for one **in-flight** WebAuthn **authentication** ceremony\n * (`get()` options until the assertion is verified). Not a user login session.\n */\nexport type PasskeyAuthenticationCeremony = {\n  challenge: Base64URLString;\n  /**\n   * Registration challenge when this authentication is the post-registration\n   * step of an enrollment or replacement ceremony.\n   */\n  registrationChallenge?: Base64URLString;\n  /** When this ceremony was started (ms since epoch); used for TTL pruning. */\n  createdAt: number;\n};\n\n/**\n * PRF extension types not covered by DOM typings.\n */\nexport type PrfEvalExtension = {\n  eval: {\n    first: Base64URLString;\n  };\n};\n\nexport type PrfClientExtensionResults = {\n  prf?: {\n    enabled?: boolean;\n    results?: { first?: Base64URLString };\n  };\n};\n\nexport type PasskeyControllerState = {\n  passkeyRecord: PasskeyRecord | null;\n};\n\nexport type PasskeyControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  PasskeyControllerState\n>;\n\n/**\n * KeyringController actions that {@link PasskeyController} may call during\n * orchestrated passkey flows. The restricted messenger must allow these at init.\n */\nexport type PasskeyControllerAllowedActions =\n  | KeyringControllerVerifyPasswordAction\n  | KeyringControllerExportEncryptionKeyAction\n  | KeyringControllerSubmitEncryptionKeyAction\n  | KeyringControllerChangePasswordAction\n  | KeyringControllerExportSeedPhraseAction\n  | KeyringControllerExportAccountAction;\n\n/**\n * Actions exposed by {@link PasskeyController} on its messenger, including\n * `:getState`, enrollment/unlock ceremony methods, and lifecycle helpers.\n */\nexport type PasskeyControllerActions =\n  | PasskeyControllerGetStateAction\n  | PasskeyControllerMethodActions;\n\nexport type PasskeyControllerStateChangedEvent = ControllerStateChangedEvent<\n  typeof controllerName,\n  PasskeyControllerState\n>;\n\nexport type PasskeyControllerEvents = PasskeyControllerStateChangedEvent;\n\nexport type PasskeyControllerMessenger = Messenger<\n  typeof controllerName,\n  PasskeyControllerActions | PasskeyControllerAllowedActions,\n  PasskeyControllerEvents\n>;\n\nexport type PasskeyControllerOptions = {\n  messenger: PasskeyControllerMessenger;\n  state?: Partial<PasskeyControllerState>;\n  rpId?: string;\n  expectedRPID: string | string[];\n  rpName: string;\n  expectedOrigin: string | string[];\n  userName?: string;\n  userDisplayName?: string;\n  /**\n   * Returns whether wallet onboarding is complete. When `true`, enrollment\n   * requires password step-up. The integrator typically supplies\n   * `() => onboardingController.state.completedOnboarding`.\n   */\n  getIsOnboardingCompleted: () => boolean;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/passkey-controller",
-  "version": "4.0.0-preview-d3f9964be",
+  "version": "4.1.0-preview-aecbce4ff",
   "description": "Controller and utilities for passkey-based wallet unlock",
   "keywords": [
     "Ethereum",
@@ -62,14 +62,14 @@
     "async-mutex": "^0.5.0"
   },
   "devDependencies": {
-    "@metamask/auto-changelog": "^6.1.0",
+    "@metamask/auto-changelog": "^6.2.1",
     "@types/jest": "^30.0.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "deepmerge": "^4.2.2",
     "jest": "^30.4.2",
-    "rimraf": "^5.0.5",
-    "ts-jest": "^29.4.11",
-    "tsx": "^4.20.5",
+    "rimraf": "^6.1.3",
+    "ts-jest": "^29.4.12",
+    "tsx": "^4.23.13",
     "typedoc": "^0.25.13",
     "typedoc-plugin-missing-exports": "^2.0.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2"