passkey-kit 0.12.0 → 0.13.1

package/dist/errors.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Typed error model for the Passkey Kit SDK.
+ *
+ * Every error the kit throws is a {@link PasskeyKitError} (or subclass) carrying
+ * a numeric {@link PasskeyKitErrorCode}, optional structured `context`, and an
+ * optional `cause`. Callers branch on `error.code` (or `instanceof`) instead of
+ * matching on message strings.
+ *
+ * Submission methods are the one exception to "throw on failure": they return a
+ * discriminated {@link import("./types.js").TransactionResult} whose failure arm
+ * carries one of these typed errors (see `contract-errors.ts`).
+ *
+ * @packageDocumentation
+ */
+/**
+ * Error codes for Passkey Kit operations, grouped by concern.
+ *
+ * Ranges (per SDK architecture spec #599 §5, extended with validation/storage):
+ * - 1xxx configuration
+ * - 2xxx wallet state
+ * - 3xxx WebAuthn
+ * - 4xxx signing
+ * - 5xxx transaction (simulation/submission)
+ * - 6xxx indexer
+ * - 7xxx relayer
+ * - 8xxx validation
+ * - 9xxx storage
+ * - 10000 contract-level failure decoded from on-chain diagnostics (the raw
+ *   contract code 1-9 is carried separately on {@link ContractError}).
+ */
+export declare enum PasskeyKitErrorCode {
+    INVALID_CONFIG = 1001,
+    MISSING_CONFIG = 1002,
+    WALLET_NOT_CONNECTED = 2001,
+    WALLET_ALREADY_EXISTS = 2002,
+    WALLET_NOT_FOUND = 2003,
+    WALLET_OWNERSHIP_MISMATCH = 2004,
+    WEBAUTHN_REGISTRATION_FAILED = 3001,
+    WEBAUTHN_AUTHENTICATION_FAILED = 3002,
+    WEBAUTHN_NOT_SUPPORTED = 3003,
+    WEBAUTHN_CANCELLED = 3004,
+    PUBLIC_KEY_EXTRACTION_FAILED = 3005,
+    SIGNING_FAILED = 4001,
+    SIGNER_NOT_FOUND = 4002,
+    INVALID_SIGNER = 4003,
+    INVALID_SIGNATURE_EXPIRATION = 4004,
+    UNSUPPORTED_CREDENTIALS = 4005,
+    SIMULATION_FAILED = 5001,
+    SUBMISSION_FAILED = 5002,
+    TRANSACTION_TIMEOUT = 5003,
+    RESTORE_REQUIRED = 5004,
+    INDEXER_NOT_CONFIGURED = 6001,
+    INDEXER_REQUEST_FAILED = 6002,
+    RELAYER_NOT_CONFIGURED = 7001,
+    RELAYER_REQUEST_FAILED = 7002,
+    /** Submitted but not yet in a terminal state — keep polling getTransaction. */
+    RELAYER_PENDING = 7003,
+    INVALID_ADDRESS = 8001,
+    INVALID_AMOUNT = 8002,
+    INVALID_INPUT = 8003,
+    INVALID_PUBLIC_KEY = 8004,
+    STORAGE_READ_FAILED = 9001,
+    STORAGE_WRITE_FAILED = 9002,
+    CONTRACT_ERROR = 10000
+}
+/**
+ * Base error class for all Passkey Kit errors.
+ */
+export declare class PasskeyKitError extends Error {
+    /** Error code for programmatic handling. */
+    readonly code: PasskeyKitErrorCode;
+    /** Structured context about the error. */
+    readonly context?: Record<string, unknown>;
+    /** The underlying error that caused this one, if any. */
+    readonly cause?: Error;
+    constructor(message: string, code: PasskeyKitErrorCode, options?: {
+        context?: Record<string, unknown>;
+        cause?: Error;
+    });
+    /** Format the error with its code, context, and cause for logging. */
+    toDetailedString(): string;
+}
+/** Thrown when the client is misconfigured. */
+export declare class ConfigurationError extends PasskeyKitError {
+    constructor(message: string, code?: PasskeyKitErrorCode.INVALID_CONFIG | PasskeyKitErrorCode.MISSING_CONFIG, context?: Record<string, unknown>);
+}
+/** Thrown when an operation requires a connected wallet but none is connected. */
+export declare class WalletNotConnectedError extends PasskeyKitError {
+    constructor(operation?: string);
+}
+/**
+ * Thrown when a connected wallet does not actually own the credential used to
+ * connect (connectWallet ownership verification, #601 F7).
+ */
+export declare class WalletOwnershipError extends PasskeyKitError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Thrown when a WebAuthn ceremony fails. */
+export declare class WebAuthnError extends PasskeyKitError {
+    constructor(message: string, code: PasskeyKitErrorCode.WEBAUTHN_REGISTRATION_FAILED | PasskeyKitErrorCode.WEBAUTHN_AUTHENTICATION_FAILED | PasskeyKitErrorCode.WEBAUTHN_NOT_SUPPORTED | PasskeyKitErrorCode.WEBAUTHN_CANCELLED | PasskeyKitErrorCode.PUBLIC_KEY_EXTRACTION_FAILED, cause?: Error);
+}
+/** Thrown when signing an authorization entry fails. */
+export declare class SigningError extends PasskeyKitError {
+    constructor(message: string, code?: PasskeyKitErrorCode.SIGNING_FAILED | PasskeyKitErrorCode.INVALID_SIGNER | PasskeyKitErrorCode.INVALID_SIGNATURE_EXPIRATION | PasskeyKitErrorCode.UNSUPPORTED_CREDENTIALS, context?: Record<string, unknown>);
+}
+/** Thrown when a requested signer cannot be found. */
+export declare class SignerNotFoundError extends PasskeyKitError {
+    constructor(identifier: string, hint?: string);
+}
+/** Thrown when transaction simulation fails. */
+export declare class SimulationError extends PasskeyKitError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Thrown when transaction submission fails. */
+export declare class SubmissionError extends PasskeyKitError {
+    constructor(message: string, hash?: string, context?: Record<string, unknown>);
+}
+/** Thrown when input validation fails. */
+export declare class ValidationError extends PasskeyKitError {
+    constructor(message: string, code?: PasskeyKitErrorCode.INVALID_ADDRESS | PasskeyKitErrorCode.INVALID_AMOUNT | PasskeyKitErrorCode.INVALID_INPUT | PasskeyKitErrorCode.INVALID_PUBLIC_KEY, context?: Record<string, unknown>);
+}
+/** Thrown when an indexer request fails or the indexer is not configured. */
+export declare class IndexerError extends PasskeyKitError {
+    constructor(message: string, code?: PasskeyKitErrorCode.INDEXER_NOT_CONFIGURED | PasskeyKitErrorCode.INDEXER_REQUEST_FAILED, context?: Record<string, unknown>, cause?: Error);
+}
+/** Thrown when a relayer request fails or the relayer is not configured. */
+export declare class RelayerError extends PasskeyKitError {
+    constructor(message: string, code?: PasskeyKitErrorCode.RELAYER_NOT_CONFIGURED | PasskeyKitErrorCode.RELAYER_REQUEST_FAILED | PasskeyKitErrorCode.RELAYER_PENDING, context?: Record<string, unknown>, cause?: Error);
+}
+/**
+ * Error decoded from an on-chain smart-wallet failure code.
+ *
+ * Produced by `decodeContractError` when a simulation/submission diagnostic
+ * reports an `Error(Contract, #N)`. Carries the raw contract code and its enum
+ * variant name so callers can branch on the exact failure.
+ *
+ * @example
+ * ```typescript
+ * const result = await server.send(tx);
+ * if (!result.success && result.error instanceof ContractError) {
+ *   if (result.error.contractErrorName === "SignerExpired") { ... }
+ * }
+ * ```
+ */
+export declare class ContractError extends PasskeyKitError {
+    /** Raw contract error code (e.g. 4). */
+    readonly contractCode: number;
+    /** Enum variant name from the contract (e.g. "SignerExpired"). */
+    readonly contractErrorName: string;
+    /** Contract family the code belongs to (e.g. "SmartWallet"). */
+    readonly family: string;
+    constructor(contractCode: number, contractErrorName: string, family: string, message: string, options?: {
+        context?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Wrap an unknown thrown value in a {@link PasskeyKitError}.
+ *
+ * Passes through values that are already {@link PasskeyKitError}s.
+ */
+export declare function wrapError(err: unknown, defaultCode?: PasskeyKitErrorCode): PasskeyKitError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,244 @@
+/**
+ * Typed error model for the Passkey Kit SDK.
+ *
+ * Every error the kit throws is a {@link PasskeyKitError} (or subclass) carrying
+ * a numeric {@link PasskeyKitErrorCode}, optional structured `context`, and an
+ * optional `cause`. Callers branch on `error.code` (or `instanceof`) instead of
+ * matching on message strings.
+ *
+ * Submission methods are the one exception to "throw on failure": they return a
+ * discriminated {@link import("./types.js").TransactionResult} whose failure arm
+ * carries one of these typed errors (see `contract-errors.ts`).
+ *
+ * @packageDocumentation
+ */
+/**
+ * Error codes for Passkey Kit operations, grouped by concern.
+ *
+ * Ranges (per SDK architecture spec #599 §5, extended with validation/storage):
+ * - 1xxx configuration
+ * - 2xxx wallet state
+ * - 3xxx WebAuthn
+ * - 4xxx signing
+ * - 5xxx transaction (simulation/submission)
+ * - 6xxx indexer
+ * - 7xxx relayer
+ * - 8xxx validation
+ * - 9xxx storage
+ * - 10000 contract-level failure decoded from on-chain diagnostics (the raw
+ *   contract code 1-9 is carried separately on {@link ContractError}).
+ */
+export var PasskeyKitErrorCode;
+(function (PasskeyKitErrorCode) {
+    // Configuration (1xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_CONFIG"] = 1001] = "INVALID_CONFIG";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["MISSING_CONFIG"] = 1002] = "MISSING_CONFIG";
+    // Wallet state (2xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WALLET_NOT_CONNECTED"] = 2001] = "WALLET_NOT_CONNECTED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WALLET_ALREADY_EXISTS"] = 2002] = "WALLET_ALREADY_EXISTS";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WALLET_NOT_FOUND"] = 2003] = "WALLET_NOT_FOUND";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WALLET_OWNERSHIP_MISMATCH"] = 2004] = "WALLET_OWNERSHIP_MISMATCH";
+    // WebAuthn (3xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WEBAUTHN_REGISTRATION_FAILED"] = 3001] = "WEBAUTHN_REGISTRATION_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WEBAUTHN_AUTHENTICATION_FAILED"] = 3002] = "WEBAUTHN_AUTHENTICATION_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WEBAUTHN_NOT_SUPPORTED"] = 3003] = "WEBAUTHN_NOT_SUPPORTED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["WEBAUTHN_CANCELLED"] = 3004] = "WEBAUTHN_CANCELLED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["PUBLIC_KEY_EXTRACTION_FAILED"] = 3005] = "PUBLIC_KEY_EXTRACTION_FAILED";
+    // Signing (4xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["SIGNING_FAILED"] = 4001] = "SIGNING_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["SIGNER_NOT_FOUND"] = 4002] = "SIGNER_NOT_FOUND";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_SIGNER"] = 4003] = "INVALID_SIGNER";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_SIGNATURE_EXPIRATION"] = 4004] = "INVALID_SIGNATURE_EXPIRATION";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["UNSUPPORTED_CREDENTIALS"] = 4005] = "UNSUPPORTED_CREDENTIALS";
+    // Transaction (5xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["SIMULATION_FAILED"] = 5001] = "SIMULATION_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["SUBMISSION_FAILED"] = 5002] = "SUBMISSION_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["TRANSACTION_TIMEOUT"] = 5003] = "TRANSACTION_TIMEOUT";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["RESTORE_REQUIRED"] = 5004] = "RESTORE_REQUIRED";
+    // Indexer (6xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INDEXER_NOT_CONFIGURED"] = 6001] = "INDEXER_NOT_CONFIGURED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INDEXER_REQUEST_FAILED"] = 6002] = "INDEXER_REQUEST_FAILED";
+    // Relayer (7xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["RELAYER_NOT_CONFIGURED"] = 7001] = "RELAYER_NOT_CONFIGURED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["RELAYER_REQUEST_FAILED"] = 7002] = "RELAYER_REQUEST_FAILED";
+    /** Submitted but not yet in a terminal state — keep polling getTransaction. */
+    PasskeyKitErrorCode[PasskeyKitErrorCode["RELAYER_PENDING"] = 7003] = "RELAYER_PENDING";
+    // Validation (8xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_ADDRESS"] = 8001] = "INVALID_ADDRESS";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_AMOUNT"] = 8002] = "INVALID_AMOUNT";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_INPUT"] = 8003] = "INVALID_INPUT";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["INVALID_PUBLIC_KEY"] = 8004] = "INVALID_PUBLIC_KEY";
+    // Storage (9xxx)
+    PasskeyKitErrorCode[PasskeyKitErrorCode["STORAGE_READ_FAILED"] = 9001] = "STORAGE_READ_FAILED";
+    PasskeyKitErrorCode[PasskeyKitErrorCode["STORAGE_WRITE_FAILED"] = 9002] = "STORAGE_WRITE_FAILED";
+    // Contract-level failure decoded from on-chain diagnostics (10xxx).
+    // The raw contract code (1-9) is carried separately on ContractError so the
+    // SDK code space never collides with the contract's own small code range.
+    PasskeyKitErrorCode[PasskeyKitErrorCode["CONTRACT_ERROR"] = 10000] = "CONTRACT_ERROR";
+})(PasskeyKitErrorCode || (PasskeyKitErrorCode = {}));
+/**
+ * Base error class for all Passkey Kit errors.
+ */
+export class PasskeyKitError extends Error {
+    /** Error code for programmatic handling. */
+    code;
+    /** Structured context about the error. */
+    context;
+    /** The underlying error that caused this one, if any. */
+    cause;
+    constructor(message, code, options) {
+        super(message);
+        this.name = "PasskeyKitError";
+        this.code = code;
+        this.context = options?.context;
+        this.cause = options?.cause;
+        // Maintain a proper stack trace in V8 environments.
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, PasskeyKitError);
+        }
+    }
+    /** Format the error with its code, context, and cause for logging. */
+    toDetailedString() {
+        let msg = `[${this.code}] ${this.message}`;
+        if (this.context) {
+            msg += `\nContext: ${JSON.stringify(this.context, null, 2)}`;
+        }
+        if (this.cause) {
+            msg += `\nCaused by: ${this.cause.message}`;
+        }
+        return msg;
+    }
+}
+/** Thrown when the client is misconfigured. */
+export class ConfigurationError extends PasskeyKitError {
+    constructor(message, code = PasskeyKitErrorCode.INVALID_CONFIG, context) {
+        super(message, code, { context });
+        this.name = "ConfigurationError";
+    }
+}
+/** Thrown when an operation requires a connected wallet but none is connected. */
+export class WalletNotConnectedError extends PasskeyKitError {
+    constructor(operation) {
+        super(operation
+            ? `A connected wallet is required to ${operation}`
+            : "Wallet not connected", PasskeyKitErrorCode.WALLET_NOT_CONNECTED, { context: operation ? { operation } : undefined });
+        this.name = "WalletNotConnectedError";
+    }
+}
+/**
+ * Thrown when a connected wallet does not actually own the credential used to
+ * connect (connectWallet ownership verification, #601 F7).
+ */
+export class WalletOwnershipError extends PasskeyKitError {
+    constructor(message, context) {
+        super(message, PasskeyKitErrorCode.WALLET_OWNERSHIP_MISMATCH, { context });
+        this.name = "WalletOwnershipError";
+    }
+}
+/** Thrown when a WebAuthn ceremony fails. */
+export class WebAuthnError extends PasskeyKitError {
+    constructor(message, code, cause) {
+        super(message, code, { cause });
+        this.name = "WebAuthnError";
+    }
+}
+/** Thrown when signing an authorization entry fails. */
+export class SigningError extends PasskeyKitError {
+    constructor(message, code = PasskeyKitErrorCode.SIGNING_FAILED, context) {
+        super(message, code, { context });
+        this.name = "SigningError";
+    }
+}
+/** Thrown when a requested signer cannot be found. */
+export class SignerNotFoundError extends PasskeyKitError {
+    constructor(identifier, hint) {
+        super(hint
+            ? `No signer found for: ${identifier}. ${hint}`
+            : `No signer found for: ${identifier}`, PasskeyKitErrorCode.SIGNER_NOT_FOUND, { context: { identifier } });
+        this.name = "SignerNotFoundError";
+    }
+}
+/** Thrown when transaction simulation fails. */
+export class SimulationError extends PasskeyKitError {
+    constructor(message, context) {
+        super(message, PasskeyKitErrorCode.SIMULATION_FAILED, { context });
+        this.name = "SimulationError";
+    }
+}
+/** Thrown when transaction submission fails. */
+export class SubmissionError extends PasskeyKitError {
+    constructor(message, hash, context) {
+        super(message, PasskeyKitErrorCode.SUBMISSION_FAILED, {
+            context: { hash, ...context },
+        });
+        this.name = "SubmissionError";
+    }
+}
+/** Thrown when input validation fails. */
+export class ValidationError extends PasskeyKitError {
+    constructor(message, code = PasskeyKitErrorCode.INVALID_INPUT, context) {
+        super(message, code, { context });
+        this.name = "ValidationError";
+    }
+}
+/** Thrown when an indexer request fails or the indexer is not configured. */
+export class IndexerError extends PasskeyKitError {
+    constructor(message, code = PasskeyKitErrorCode.INDEXER_REQUEST_FAILED, context, cause) {
+        super(message, code, { context, cause });
+        this.name = "IndexerError";
+    }
+}
+/** Thrown when a relayer request fails or the relayer is not configured. */
+export class RelayerError extends PasskeyKitError {
+    constructor(message, code = PasskeyKitErrorCode.RELAYER_REQUEST_FAILED, context, cause) {
+        super(message, code, { context, cause });
+        this.name = "RelayerError";
+    }
+}
+/**
+ * Error decoded from an on-chain smart-wallet failure code.
+ *
+ * Produced by `decodeContractError` when a simulation/submission diagnostic
+ * reports an `Error(Contract, #N)`. Carries the raw contract code and its enum
+ * variant name so callers can branch on the exact failure.
+ *
+ * @example
+ * ```typescript
+ * const result = await server.send(tx);
+ * if (!result.success && result.error instanceof ContractError) {
+ *   if (result.error.contractErrorName === "SignerExpired") { ... }
+ * }
+ * ```
+ */
+export class ContractError extends PasskeyKitError {
+    /** Raw contract error code (e.g. 4). */
+    contractCode;
+    /** Enum variant name from the contract (e.g. "SignerExpired"). */
+    contractErrorName;
+    /** Contract family the code belongs to (e.g. "SmartWallet"). */
+    family;
+    constructor(contractCode, contractErrorName, family, message, options) {
+        super(message, PasskeyKitErrorCode.CONTRACT_ERROR, {
+            context: { contractCode, contractErrorName, family, ...options?.context },
+            cause: options?.cause,
+        });
+        this.name = "ContractError";
+        this.contractCode = contractCode;
+        this.contractErrorName = contractErrorName;
+        this.family = family;
+    }
+}
+/**
+ * Wrap an unknown thrown value in a {@link PasskeyKitError}.
+ *
+ * Passes through values that are already {@link PasskeyKitError}s.
+ */
+export function wrapError(err, defaultCode = PasskeyKitErrorCode.INVALID_INPUT) {
+    if (err instanceof PasskeyKitError) {
+        return err;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    const cause = err instanceof Error ? err : undefined;
+    return new PasskeyKitError(message, defaultCode, { cause });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Typed event emitter for passkey / wallet lifecycle events.
+ *
+ * `on()` returns an unsubscribe function; a listener that throws is isolated so
+ * it never prevents the other listeners from running.
+ *
+ * @packageDocumentation
+ */
+import type { SignerStore } from "./types.js";
+/**
+ * The events the kit can emit, mapped to their payload shapes.
+ */
+export type PasskeyEventMap = {
+    /** A new wallet was deployed. */
+    walletCreated: {
+        contractId: string;
+        keyId: string;
+    };
+    /** An existing wallet was connected. */
+    walletConnected: {
+        contractId: string;
+        keyId: string;
+    };
+    /** The connected wallet was disconnected. */
+    walletDisconnected: {
+        contractId: string;
+    };
+    /** A signer was added to the connected wallet. */
+    signerAdded: {
+        contractId: string;
+        kind: "Policy" | "Ed25519" | "Secp256r1";
+        storage: SignerStore;
+    };
+    /** A signer was updated on the connected wallet. */
+    signerUpdated: {
+        contractId: string;
+        kind: "Policy" | "Ed25519" | "Secp256r1";
+        storage: SignerStore;
+    };
+    /** A signer was removed from the connected wallet. */
+    signerRemoved: {
+        contractId: string;
+        kind: "Policy" | "Ed25519" | "Secp256r1";
+    };
+    /** An authorization entry was signed. */
+    transactionSigned: {
+        contractId: string;
+        keyId?: string;
+    };
+    /** A transaction was submitted. */
+    transactionSubmitted: {
+        hash: string;
+        success: boolean;
+    };
+};
+/** The set of event names the kit emits. */
+export type PasskeyEvent = keyof PasskeyEventMap;
+/** An event listener. */
+export type EventListener<T> = (data: T) => void;
+/**
+ * A small typed event emitter for passkey lifecycle events.
+ *
+ * @example
+ * ```typescript
+ * const events = new PasskeyEventEmitter();
+ * const off = events.on("walletConnected", ({ contractId }) => {
+ *   console.log("connected", contractId);
+ * });
+ * events.emit("walletConnected", { contractId: "C…", keyId: "…" });
+ * off();
+ * ```
+ */
+export declare class PasskeyEventEmitter {
+    private listeners;
+    private errorHandler;
+    /**
+     * Set the handler invoked when a listener throws. Pass `undefined` to silence
+     * listener errors entirely.
+     */
+    setErrorHandler(handler: ((event: PasskeyEvent, error: unknown) => void) | undefined): void;
+    /** Subscribe to an event. Returns an unsubscribe function. */
+    on<E extends PasskeyEvent>(event: E, listener: EventListener<PasskeyEventMap[E]>): () => void;
+    /** Subscribe to an event, firing at most once. Returns an unsubscribe fn. */
+    once<E extends PasskeyEvent>(event: E, listener: EventListener<PasskeyEventMap[E]>): () => void;
+    /** Unsubscribe a specific listener from an event. */
+    off<E extends PasskeyEvent>(event: E, listener: EventListener<PasskeyEventMap[E]>): void;
+    /** Emit an event to all subscribers, isolating any that throw. */
+    emit<E extends PasskeyEvent>(event: E, data: PasskeyEventMap[E]): void;
+    /** Remove all listeners for an event, or for every event when omitted. */
+    removeAllListeners(event?: PasskeyEvent): void;
+    /** Number of listeners registered for an event. */
+    listenerCount(event: PasskeyEvent): number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,iCAAiC;IACjC,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAErD,wCAAwC;IACxC,eAAe,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvD,6CAA6C;IAC7C,kBAAkB,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3C,kDAAkD;IAClD,WAAW,EAAE;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;QACzC,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;IAEF,oDAAoD;IACpD,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;QACzC,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;IAEF,sDAAsD;IACtD,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;KAC1C,CAAC;IAEF,yCAAyC;IACzC,iBAAiB,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1D,mCAAmC;IACnC,oBAAoB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD,yBAAyB;AACzB,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAajD;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAGH;IAEd,OAAO,CAAC,YAAY,CAEwB;IAE5C;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,GACnE,IAAI;IAIP,8DAA8D;IAC9D,EAAE,CAAC,CAAC,SAAS,YAAY,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC1C,MAAM,IAAI;IAeb,6EAA6E;IAC7E,IAAI,CAAC,CAAC,SAAS,YAAY,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC1C,MAAM,IAAI;IAQb,qDAAqD;IACrD,GAAG,CAAC,CAAC,SAAS,YAAY,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC1C,IAAI;IAMP,kEAAkE;IAClE,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAYtE,0EAA0E;IAC1E,kBAAkB,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAQ9C,mDAAmD;IACnD,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;CAG3C"}

package/dist/events.js

@@ -0,0 +1,92 @@
+/**
+ * Typed event emitter for passkey / wallet lifecycle events.
+ *
+ * `on()` returns an unsubscribe function; a listener that throws is isolated so
+ * it never prevents the other listeners from running.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Default handler for errors thrown by listeners: log to the console so a
+ * misbehaving listener is visible rather than silently swallowed.
+ */
+function defaultListenerErrorHandler(event, error) {
+    console.error(`[PasskeyKit] Listener for "${event}" threw:`, error);
+}
+/**
+ * A small typed event emitter for passkey lifecycle events.
+ *
+ * @example
+ * ```typescript
+ * const events = new PasskeyEventEmitter();
+ * const off = events.on("walletConnected", ({ contractId }) => {
+ *   console.log("connected", contractId);
+ * });
+ * events.emit("walletConnected", { contractId: "C…", keyId: "…" });
+ * off();
+ * ```
+ */
+export class PasskeyEventEmitter {
+    listeners = new Map();
+    errorHandler = defaultListenerErrorHandler;
+    /**
+     * Set the handler invoked when a listener throws. Pass `undefined` to silence
+     * listener errors entirely.
+     */
+    setErrorHandler(handler) {
+        this.errorHandler = handler;
+    }
+    /** Subscribe to an event. Returns an unsubscribe function. */
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        const listeners = this.listeners.get(event);
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    /** Subscribe to an event, firing at most once. Returns an unsubscribe fn. */
+    once(event, listener) {
+        const unsubscribe = this.on(event, (data) => {
+            unsubscribe();
+            listener(data);
+        });
+        return unsubscribe;
+    }
+    /** Unsubscribe a specific listener from an event. */
+    off(event, listener) {
+        this.listeners
+            .get(event)
+            ?.delete(listener);
+    }
+    /** Emit an event to all subscribers, isolating any that throw. */
+    emit(event, data) {
+        const listeners = this.listeners.get(event);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            try {
+                listener(data);
+            }
+            catch (err) {
+                this.errorHandler?.(event, err);
+            }
+        }
+    }
+    /** Remove all listeners for an event, or for every event when omitted. */
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /** Number of listeners registered for an event. */
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkDH;;;GAGG;AACH,SAAS,2BAA2B,CAClC,KAAmB,EACnB,KAAc;IAEd,OAAO,CAAC,KAAK,CAAC,8BAA8B,KAAK,UAAU,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAmB;IACtB,SAAS,GAGb,IAAI,GAAG,EAAE,CAAC;IAEN,YAAY,GAEJ,2BAA2B,CAAC;IAE5C;;;OAGG;IACH,eAAe,CACb,OAAoE;QAEpE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,8DAA8D;IAC9D,EAAE,CACA,KAAQ,EACR,QAA2C;QAE3C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAC7C,SAAS,CAAC,GAAG,CACX,QAAwD,CACzD,CAAC;QACF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CACd,QAAwD,CACzD,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,IAAI,CACF,KAAQ,EACR,QAA2C;QAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1C,WAAW,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,qDAAqD;IACrD,GAAG,CACD,KAAQ,EACR,QAA2C;QAE3C,IAAI,CAAC,SAAS;aACX,GAAG,CAAC,KAAK,CAAC;YACX,EAAE,MAAM,CAAC,QAAwD,CAAC,CAAC;IACvE,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAyB,KAAQ,EAAE,IAAwB;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,kBAAkB,CAAC,KAAoB;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,aAAa,CAAC,KAAmB;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Passkey Kit — create and use smart-wallet accounts on Stellar with WebAuthn
+ * passkeys.
+ *
+ * Storage adapters live under the `passkey-kit/storage` subpath; the server-only
+ * entrypoint lives under `passkey-kit/server`.
+ *
+ * @packageDocumentation
+ */
+export { PasskeyKit, type PasskeyKitConfig, type CreateOptions, type ConnectOptions, } from "./kit.js";
+export { SACClient, buildTokenTransferHostFunction } from "./sac.js";
+export { Client as PasskeyClient } from "passkey-kit-sdk";
+export { PasskeySigner, Ed25519Signer, PolicySigner, type Signer, type SignerContext, type PreparedSignature, type WebAuthnAuthenticator, } from "./signers.js";
+export { SignerKey, SignerStore, type SignerKeyTag, type SignerLimits, type StoredPasskey, type StorageAdapter, type CreateWalletResult, type ConnectWalletResult, type TransactionResult, type TransactionSuccess, type TransactionFailure, type SubmissionMethod, } from "./types.js";
+export { PasskeyKitError, PasskeyKitErrorCode, ConfigurationError, WalletNotConnectedError, WalletOwnershipError, WebAuthnError, SigningError, SignerNotFoundError, SimulationError, SubmissionError, ValidationError, IndexerError, RelayerError, ContractError, wrapError, } from "./errors.js";
+export { CONTRACT_ERROR_REGISTRY, contractErrorFromCode, decodeContractError, type ContractErrorFamily, type ContractErrorInfo, } from "./contract-errors.js";
+export { MercuryIndexer, mercuryPasskeyIndexerUrl, MERCURY_PASSKEY_INDEXER_URLS, lookupWithRetry, type MercuryIndexerConfig, type SignerIndexer, type WalletSigner, type IndexerHealth, type SignerStatus, type SignerStorageClass, type FindWalletsHardeningDeps, } from "./indexer/index.js";
+export { PasskeyEventEmitter, type PasskeyEvent, type PasskeyEventMap, type EventListener, } from "./events.js";
+export { deriveContractAddress, extractPublicKeyFromAttestation, compactSignature, generateChallenge, } from "./utils.js";
+export { validateAddress, validateAmount, validateExpiration, validateSecp256r1PublicKey, } from "./validation.js";
+export { VERSION, NAME } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAGrE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}