@tempoxyz/auth 0.0.0-pr-69.sha-c8c4134 → 0.0.0-pr-73.sha-5d2ffa4

package/dist/Actions.d.ts

@@ -12,6 +12,7 @@ import type { Tokens } from './Tokens.ts';
 export * as device from './actions/device.ts';
 export * as email from './actions/email.ts';
 export * as oauth from './actions/oauth.ts';
+export * as passkey from './actions/passkey.ts';
 export * as provider from './actions/provider.ts';
 export * as redirect from './actions/redirect.ts';
 export * as tempoAccount from './actions/tempoAccount.ts';
@@ -34,6 +35,12 @@ export declare namespace authorize {
          * defaults to the user's first. Defaults to a new key.
          */
         accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
         /** What the key may do. It must fit the headless ceiling, which fills what it leaves out. */
         permissions?: Permissions<chainId> | undefined;
     };

package/dist/Actions.js

@@ -4,6 +4,7 @@ import { request } from './internal/request.js';
 export * as device from './actions/device.js';
 export * as email from './actions/email.js';
 export * as oauth from './actions/oauth.js';
+export * as passkey from './actions/passkey.js';
 export * as provider from './actions/provider.js';
 export * as redirect from './actions/redirect.js';
 export * as tempoAccount from './actions/tempoAccount.js';
@@ -29,6 +30,7 @@ export async function authorize(auth, options = {}) {
     const response = await Api.post(auth, '/v1/authorize', {
         json: request(auth, {
             accessKey: key.accessKey,
+            challenge: options.challenge,
             permissions: options.permissions,
         }),
     });

package/dist/Auth.d.ts

@@ -86,7 +86,7 @@ export declare namespace RequestError {
         uri?: string | undefined;
     };
     /** Each refusal's stable name. `docs/errors.md` explains each one. */
-    type Reason = 'already_decided' | 'approval_pending' | 'body_too_large' | 'cross_site_request' | 'device_code_expired' | 'duplicate_limit' | 'empty_limits' | 'empty_scopes' | 'expiry_exceeds_maximum' | 'expiry_passed' | 'foreign_account' | 'foreign_origin' | 'invalid_chain' | 'invalid_code' | 'invalid_expiry' | 'invalid_field' | 'invalid_origin' | 'invalid_period' | 'invalid_public_key' | 'limit_exceeds_maximum' | 'malformed_body' | 'missing_code_challenge' | 'missing_key' | 'missing_recipients' | 'polling_too_fast' | 'rate_limited' | 'rejected' | 'request_denied' | 'scope_without_limit' | 'session_required' | 'unexpected' | 'unknown_code' | 'unknown_endpoint' | 'unsupported_call' | 'unsupported_step' | 'unsupported_token' | 'upstream_unavailable' | 'webauthn_rejected' | 'webauthn_required';
+    type Reason = 'already_decided' | 'approval_pending' | 'body_too_large' | 'challenge_not_permitted' | 'cross_site_request' | 'device_code_expired' | 'duplicate_limit' | 'empty_limits' | 'empty_scopes' | 'expiry_exceeds_maximum' | 'expiry_passed' | 'foreign_account' | 'foreign_origin' | 'invalid_chain' | 'invalid_code' | 'invalid_expiry' | 'invalid_field' | 'invalid_origin' | 'invalid_period' | 'invalid_public_key' | 'limit_exceeds_maximum' | 'malformed_body' | 'missing_code_challenge' | 'missing_key' | 'missing_recipients' | 'polling_too_fast' | 'rate_limited' | 'rejected' | 'request_denied' | 'scope_without_limit' | 'session_required' | 'unexpected' | 'unknown_code' | 'unknown_endpoint' | 'unsupported_call' | 'unsupported_step' | 'unsupported_token' | 'upstream_unavailable' | 'webauthn_rejected' | 'webauthn_required';
 }
 /** A client's {@link Account} read before a sign-in set it, or after sign-out emptied it. */
 export declare class SignedOutError extends Error {

package/dist/Decorator.d.ts

@@ -95,6 +95,10 @@ export declare namespace tempoAuth {
                 /** `Actions.oauth.userInfo`. */
                 userInfo: (options: Actions.oauth.userInfo.Options) => Promise<User>;
             };
+            passkey: {
+                /** `Actions.passkey.signIn`, which sets the client's account unless it returns a step. */
+                signIn: <const id extends number = chainId>(options?: Actions.passkey.signIn.Options<id>) => Promise<Actions.passkey.signIn.ReturnType<id>>;
+            };
             provider: {
                 /** `Actions.provider.list`. */
                 list: () => Promise<Actions.provider.list.ReturnType>;

package/dist/Decorator.js

@@ -111,6 +111,15 @@ export function tempoAuth(options) {
                     jwks: () => Actions.oauth.jwks(auth),
                     userInfo: (options) => Actions.oauth.userInfo(auth, options),
                 },
+                passkey: {
+                    async signIn(options = {}) {
+                        const apply = begin();
+                        const result = await Actions.passkey.signIn(auth, options);
+                        if (!('step' in result))
+                            apply(result.account);
+                        return result;
+                    },
+                },
                 provider: {
                     list: () => Actions.provider.list(auth),
                     signIn: (options) => Actions.provider.signIn(auth, options),

package/dist/actions/device.d.ts

@@ -21,6 +21,12 @@ export declare namespace authorize {
          * defaults to the user's first. Defaults to a new key.
          */
         accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
         /**
          * The name the approval page shows. Defaults to the machine's hostname in Node, Bun, and Deno,
          * and to `Unknown device` elsewhere.

package/dist/actions/device.js

@@ -17,6 +17,9 @@ export async function authorize(auth, options = {}) {
     const key = await AccessKey.resolve(options.accessKey);
     const code = await Api.json(await Api.post(auth, '/v1/device/authorize', {
         json: {
+            ...(options.challenge === undefined
+                ? {}
+                : { challenge: options.challenge }),
             device: options.device ?? hostname(),
             key_authorization: request(auth, {
                 accessKey: key.accessKey,

package/dist/actions/email.d.ts

@@ -40,10 +40,21 @@ export declare namespace signIn {
          * defaults to the user's first. Defaults to a new key.
          */
         accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
         /** The 6-digit code the user was emailed. */
         code: string;
         /** The address the code was sent to. */
         email: string;
+        /**
+         * The `link` from `Actions.passkey.signIn`'s email step, which links that wallet.tempo passkey
+         * to the user.
+         */
+        link?: string | undefined;
         /** What the key may do. It must fit the headless ceiling, which fills what it leaves out. */
         permissions?: Permissions<chainId> | undefined;
     };

package/dist/actions/email.js

@@ -23,13 +23,18 @@ export async function sendCode(auth, options) {
  * ```
  */
 export async function signIn(auth, options) {
-    const { code, email, permissions } = options;
+    const { challenge, code, email, link, permissions } = options;
     const key = await AccessKey.resolve(options.accessKey);
     const body = await Api.json(await Api.post(auth, '/v1/auth/code/verify', {
         json: {
-            authorize: request(auth, { accessKey: key.accessKey, permissions }),
+            authorize: request(auth, {
+                accessKey: key.accessKey,
+                challenge,
+                permissions,
+            }),
             code,
             email,
+            ...(link ? { link } : {}),
         },
     }));
     if ('step' in body)

package/dist/actions/passkey.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Signs the user in with a passkey from the app's own sign-in form. The browser offers every passkey
+ * it holds for Tempo's domain, so the app needs no email first.
+ * @module
+ */
+import { Authentication } from 'ox/webauthn';
+import type { Account } from 'viem/tempo';
+import type { Auth } from '../Auth.ts';
+import type { Authorization } from '../Authorization.ts';
+import type { Permissions } from '../Permissions.ts';
+/**
+ * Signs the user in with a passkey, and authorizes the app in the same call. Returns the email step
+ * for a wallet.tempo passkey whose account has no email: the app signs the user in with
+ * `Actions.email.signIn`, passing the step's `link`, which links the passkey, and the same
+ * `accessKey`, `challenge`, and `permissions`, which this call does not authorize. Throws a `RequestError` with reason
+ * `webauthn_required` when a passkey owns the Tempo Account the key acts for, since a passkey signs a
+ * key authorization only on Tempo Auth's pages. `Actions.redirect.start` authorizes it there, where
+ * the user is already signed in.
+ *
+ * @example
+ * ```ts
+ * const result = await Actions.passkey.signIn(auth)
+ * if ('step' in result) showEmailForm()
+ * ```
+ */
+export declare function signIn<const chainId extends number = number>(auth: Auth, options?: signIn.Options<chainId>): Promise<signIn.ReturnType<chainId>>;
+export declare namespace signIn {
+    type Options<chainId extends number = number> = {
+        /**
+         * The key to authorize, as a Viem account. Its `access` names the Tempo Account, which
+         * defaults to the user's first. Defaults to a new key.
+         */
+        accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
+        /**
+         * Runs the WebAuthn ceremony in place of `navigator.credentials.get`, such as a native passkey
+         * module. Its assertion must report a web origin on the relying party's domain that the app
+         * registered, so an Android app's facet origin is refused.
+         */
+        getFn?: Authentication.sign.Options['getFn'] | undefined;
+        /** What the key may do. It must fit the headless ceiling, which fills what it leaves out. */
+        permissions?: Permissions<chainId> | undefined;
+    };
+    /** The step a wallet.tempo passkey without an email needs: an emailed code, which links it. */
+    type EmailStep = {
+        /** Passed as `link` to `Actions.email.signIn`, which links the passkey to that user. */
+        link: string;
+        /** The kind of step. */
+        type: 'email';
+    };
+    /** The authorization, or the email step. */
+    type ReturnType<chainId extends number = number> = Authorization<chainId> | {
+        step: EmailStep;
+    };
+}

package/dist/actions/passkey.js

@@ -0,0 +1,46 @@
+/**
+ * Signs the user in with a passkey from the app's own sign-in form. The browser offers every passkey
+ * it holds for Tempo's domain, so the app needs no email first.
+ * @module
+ */
+import { Authentication } from 'ox/webauthn';
+import * as AccessKey from '../internal/accessKey.js';
+import * as Api from '../internal/api.js';
+import { request } from '../internal/request.js';
+/**
+ * Signs the user in with a passkey, and authorizes the app in the same call. Returns the email step
+ * for a wallet.tempo passkey whose account has no email: the app signs the user in with
+ * `Actions.email.signIn`, passing the step's `link`, which links the passkey, and the same
+ * `accessKey`, `challenge`, and `permissions`, which this call does not authorize. Throws a `RequestError` with reason
+ * `webauthn_required` when a passkey owns the Tempo Account the key acts for, since a passkey signs a
+ * key authorization only on Tempo Auth's pages. `Actions.redirect.start` authorizes it there, where
+ * the user is already signed in.
+ *
+ * @example
+ * ```ts
+ * const result = await Actions.passkey.signIn(auth)
+ * if ('step' in result) showEmailForm()
+ * ```
+ */
+export async function signIn(auth, options = {}) {
+    const { challenge, getFn, permissions } = options;
+    const key = await AccessKey.resolve(options.accessKey);
+    const requested = await Api.json(await Api.post(auth, '/v1/auth/passkey/options', { json: {} }));
+    const deserialized = Authentication.deserializeOptions(requested.options);
+    const assertion = Authentication.serializeResponse(await Authentication.sign(
+    // ox reads `getFn` beside request options at runtime, which its types admit only beside a challenge.
+    getFn ? { ...deserialized, getFn } : deserialized));
+    const body = await Api.json(await Api.post(auth, '/v1/auth/passkey/verify', {
+        json: {
+            assertion,
+            authorize: request(auth, {
+                accessKey: key.accessKey,
+                challenge,
+                permissions,
+            }),
+        },
+    }));
+    if ('step' in body)
+        return { step: body.step };
+    return Api.authorization(body.authorization, key);
+}

package/dist/actions/redirect.d.ts

@@ -45,6 +45,12 @@ export declare namespace createUrl {
          * defaults to the user's first. Defaults to a new key, whose material `pending` keeps.
          */
         accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
         /** What the key may do. Tempo Auth's pages show it, and the headless ceiling fills what it leaves out. */
         permissions?: Permissions | undefined;
         /** Where Tempo Auth redirects back to. Defaults to the instance's `redirectUri`. */
@@ -97,6 +103,12 @@ export declare namespace start {
          * key, which `storage` keeps until the browser returns.
          */
         accessKey?: Account.Account | undefined;
+        /**
+         * A message the owner's signature binds, such as a sign-in challenge the app's backend issued.
+         * Tempo Auth binds its EIP-191 hash as the key authorization's `witness`. Only an app with the
+         * `tempo-auth:sign` scope may send one.
+         */
+        challenge?: string | undefined;
         /** What the key may do. Tempo Auth's pages show it, and the headless ceiling fills what it leaves out. */
         permissions?: Permissions | undefined;
     };

package/dist/actions/redirect.js

@@ -75,6 +75,9 @@ export async function createUrl(auth, options = {}) {
     });
     const url = new URL('/authorize', auth.url);
     url.search = new URLSearchParams({
+        ...(options.challenge === undefined
+            ? {}
+            : { challenge: options.challenge }),
         client_id,
         code_challenge: Base64.fromBytes(Hash.sha256(Bytes.fromString(pending.verifier)), base64url),
         key_authorization: Base64.fromString(JSON.stringify(key_authorization), base64url),

package/dist/internal/request.d.ts

@@ -7,8 +7,11 @@ import type { Permissions } from '../Permissions.ts';
  */
 export declare function request(auth: Auth, options: {
     accessKey: Account.Account;
+    /** A message the key's witness binds. */
+    challenge?: string | undefined;
     permissions?: Permissions | undefined;
 }): {
+    challenge?: string;
     client_id: string;
     key_authorization: {
         account?: `0x${string}`;

package/dist/internal/request.js

@@ -9,8 +9,9 @@ import { Hex } from 'ox';
  * key account names its Tempo Account through `access`, and a plain key leaves it to Tempo Auth.
  */
 export function request(auth, options) {
-    const { accessKey, permissions = {} } = options;
+    const { accessKey, challenge, permissions = {} } = options;
     return {
+        ...(challenge === undefined ? {} : { challenge }),
         client_id: auth.clientId,
         key_authorization: {
             ...(accessKey.accessKeyAddress ? { account: accessKey.address } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempoxyz/auth",
-  "version": "0.0.0-pr-69.sha-c8c4134",
+  "version": "0.0.0-pr-73.sha-5d2ffa4",
   "description": "Signs users in to Tempo through Tempo Auth, and returns Viem access key accounts on their Tempo Accounts.",
   "type": "module",
   "exports": {