@tempoxyz/auth 0.0.0-pr-71.sha-c01a453 → 0.0.0-pr-67.sha-7ff1fd6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/Actions.d.ts +0 -1
- package/dist/Actions.js +0 -1
- package/dist/Auth.d.ts +1 -1
- package/dist/Decorator.d.ts +1 -11
- package/dist/Decorator.js +24 -55
- package/dist/TempoAccount.d.ts +1 -7
- package/dist/TempoAccount.js +1 -1
- package/dist/actions/email.d.ts +0 -5
- package/dist/actions/email.js +1 -2
- package/dist/actions/tempoAccount.js +3 -9
- package/package.json +1 -1
- package/dist/actions/passkey.d.ts +0 -53
- package/dist/actions/passkey.js +0 -41
package/dist/Actions.d.ts
CHANGED
|
@@ -12,7 +12,6 @@ import type { Tokens } from './Tokens.ts';
|
|
|
12
12
|
export * as device from './actions/device.ts';
|
|
13
13
|
export * as email from './actions/email.ts';
|
|
14
14
|
export * as oauth from './actions/oauth.ts';
|
|
15
|
-
export * as passkey from './actions/passkey.ts';
|
|
16
15
|
export * as provider from './actions/provider.ts';
|
|
17
16
|
export * as redirect from './actions/redirect.ts';
|
|
18
17
|
export * as tempoAccount from './actions/tempoAccount.ts';
|
package/dist/Actions.js
CHANGED
|
@@ -4,7 +4,6 @@ import { request } from './internal/request.js';
|
|
|
4
4
|
export * as device from './actions/device.js';
|
|
5
5
|
export * as email from './actions/email.js';
|
|
6
6
|
export * as oauth from './actions/oauth.js';
|
|
7
|
-
export * as passkey from './actions/passkey.js';
|
|
8
7
|
export * as provider from './actions/provider.js';
|
|
9
8
|
export * as redirect from './actions/redirect.js';
|
|
10
9
|
export * as tempoAccount from './actions/tempoAccount.js';
|
package/dist/Auth.d.ts
CHANGED
|
@@ -86,7 +86,7 @@ export declare namespace RequestError {
|
|
|
86
86
|
uri?: string | undefined;
|
|
87
87
|
};
|
|
88
88
|
/** Each refusal's stable name. `docs/errors.md` explains each one. */
|
|
89
|
-
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'
|
|
89
|
+
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';
|
|
90
90
|
}
|
|
91
91
|
/** A client's {@link Account} read before a sign-in set it, or after sign-out emptied it. */
|
|
92
92
|
export declare class SignedOutError extends Error {
|
package/dist/Decorator.d.ts
CHANGED
|
@@ -82,10 +82,7 @@ export declare namespace tempoAuth {
|
|
|
82
82
|
email: {
|
|
83
83
|
/** `Actions.email.sendCode`. */
|
|
84
84
|
sendCode: (options: Actions.email.sendCode.Options) => Promise<void>;
|
|
85
|
-
/**
|
|
86
|
-
* `Actions.email.signIn`, which sets the client's account unless it returns a step. A step
|
|
87
|
-
* that another sign-in or a sign-out overtook throws {@link SupersededError}.
|
|
88
|
-
*/
|
|
85
|
+
/** `Actions.email.signIn`, which sets the client's account unless it returns a step. */
|
|
89
86
|
signIn: <const id extends number = chainId>(options: Actions.email.signIn.Options<id>) => Promise<Actions.email.signIn.ReturnType<id>>;
|
|
90
87
|
};
|
|
91
88
|
/** The instance the members call `Actions` with. */
|
|
@@ -98,13 +95,6 @@ export declare namespace tempoAuth {
|
|
|
98
95
|
/** `Actions.oauth.userInfo`. */
|
|
99
96
|
userInfo: (options: Actions.oauth.userInfo.Options) => Promise<User>;
|
|
100
97
|
};
|
|
101
|
-
passkey: {
|
|
102
|
-
/**
|
|
103
|
-
* `Actions.passkey.signIn`, which sets the client's account unless it returns a step. A step
|
|
104
|
-
* that another sign-in or a sign-out overtook throws {@link SupersededError}.
|
|
105
|
-
*/
|
|
106
|
-
signIn: <const id extends number = chainId>(options?: Actions.passkey.signIn.Options<id>) => Promise<Actions.passkey.signIn.ReturnType<id>>;
|
|
107
|
-
};
|
|
108
98
|
provider: {
|
|
109
99
|
/** `Actions.provider.list`. */
|
|
110
100
|
list: () => Promise<Actions.provider.list.ReturnType>;
|
package/dist/Decorator.js
CHANGED
|
@@ -54,58 +54,42 @@ export function tempoAuth(options) {
|
|
|
54
54
|
// sign-in or sign-out completed after it began, so a stale result never replaces a newer one,
|
|
55
55
|
// and a sign-in still pending at sign-out never signs the client back in.
|
|
56
56
|
let version = 0;
|
|
57
|
-
// The version the latest sign-out produced, while no change has followed it.
|
|
58
|
-
let signedOut;
|
|
59
57
|
/**
|
|
60
|
-
* Begins an operation that changes the client's account
|
|
61
|
-
* account to sign with, or `undefined` to stop signing.
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
* newer state contradicts.
|
|
58
|
+
* Begins an operation that changes the client's account, and returns the function that applies
|
|
59
|
+
* its result: the account to sign with, or `undefined` to stop signing. Applying an account that
|
|
60
|
+
* a newer change overtook throws {@link SupersededError}, so the caller never holds an
|
|
61
|
+
* authorization the client does not sign with.
|
|
65
62
|
*/
|
|
66
63
|
const begin = () => {
|
|
67
64
|
const started = version;
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
async apply(account) {
|
|
77
|
-
if (version !== started) {
|
|
78
|
-
if (account)
|
|
79
|
-
throw await superseded();
|
|
80
|
-
return;
|
|
81
|
-
}
|
|
82
|
-
state.account = account;
|
|
83
|
-
version++;
|
|
84
|
-
},
|
|
85
|
-
async check() {
|
|
86
|
-
if (version !== started)
|
|
87
|
-
throw await superseded();
|
|
88
|
-
},
|
|
65
|
+
return (account) => {
|
|
66
|
+
if (version !== started) {
|
|
67
|
+
if (account)
|
|
68
|
+
throw new SupersededError();
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
state.account = account;
|
|
72
|
+
version++;
|
|
89
73
|
};
|
|
90
74
|
};
|
|
91
75
|
return {
|
|
92
76
|
auth: {
|
|
93
77
|
async authorize(options = {}) {
|
|
94
|
-
const
|
|
78
|
+
const apply = begin();
|
|
95
79
|
const authorization = await Actions.authorize(auth, options);
|
|
96
80
|
// Without a session, the client stops signing as the user it last authorized.
|
|
97
|
-
|
|
81
|
+
apply(authorization?.account);
|
|
98
82
|
return authorization;
|
|
99
83
|
},
|
|
100
84
|
device: {
|
|
101
85
|
async authorize(options = {}) {
|
|
102
|
-
const
|
|
86
|
+
const apply = begin();
|
|
103
87
|
const device = await Actions.device.authorize(auth, options);
|
|
104
88
|
return {
|
|
105
89
|
...device,
|
|
106
90
|
async wait() {
|
|
107
91
|
const authorization = await device.wait();
|
|
108
|
-
|
|
92
|
+
apply(authorization.account);
|
|
109
93
|
return authorization;
|
|
110
94
|
},
|
|
111
95
|
};
|
|
@@ -114,12 +98,10 @@ export function tempoAuth(options) {
|
|
|
114
98
|
email: {
|
|
115
99
|
sendCode: (options) => Actions.email.sendCode(auth, options),
|
|
116
100
|
async signIn(options) {
|
|
117
|
-
const
|
|
101
|
+
const apply = begin();
|
|
118
102
|
const result = await Actions.email.signIn(auth, options);
|
|
119
|
-
if ('step' in result)
|
|
120
|
-
|
|
121
|
-
else
|
|
122
|
-
await change.apply(result.account);
|
|
103
|
+
if (!('step' in result))
|
|
104
|
+
apply(result.account);
|
|
123
105
|
return result;
|
|
124
106
|
},
|
|
125
107
|
},
|
|
@@ -129,35 +111,24 @@ export function tempoAuth(options) {
|
|
|
129
111
|
jwks: () => Actions.oauth.jwks(auth),
|
|
130
112
|
userInfo: (options) => Actions.oauth.userInfo(auth, options),
|
|
131
113
|
},
|
|
132
|
-
passkey: {
|
|
133
|
-
async signIn(options = {}) {
|
|
134
|
-
const change = begin();
|
|
135
|
-
const result = await Actions.passkey.signIn(auth, options);
|
|
136
|
-
if ('step' in result)
|
|
137
|
-
await change.check();
|
|
138
|
-
else
|
|
139
|
-
await change.apply(result.account);
|
|
140
|
-
return result;
|
|
141
|
-
},
|
|
142
|
-
},
|
|
143
114
|
provider: {
|
|
144
115
|
list: () => Actions.provider.list(auth),
|
|
145
116
|
signIn: (options) => Actions.provider.signIn(auth, options),
|
|
146
117
|
},
|
|
147
118
|
redirect: {
|
|
148
119
|
async complete(options = {}) {
|
|
149
|
-
const
|
|
120
|
+
const apply = begin();
|
|
150
121
|
const authorization = await Actions.redirect.complete(auth, options);
|
|
151
122
|
// `undefined` means the page is not a callback, which says nothing about the session.
|
|
152
123
|
if (authorization)
|
|
153
|
-
|
|
124
|
+
apply(authorization.account);
|
|
154
125
|
return authorization;
|
|
155
126
|
},
|
|
156
127
|
createUrl: (options = {}) => Actions.redirect.createUrl(auth, options),
|
|
157
128
|
async handleCallback(options) {
|
|
158
|
-
const
|
|
129
|
+
const apply = begin();
|
|
159
130
|
const authorization = await Actions.redirect.handleCallback(auth, options);
|
|
160
|
-
|
|
131
|
+
apply(authorization.account);
|
|
161
132
|
return authorization;
|
|
162
133
|
},
|
|
163
134
|
start: (options = {}) => Actions.redirect.start(auth, options),
|
|
@@ -167,8 +138,7 @@ export function tempoAuth(options) {
|
|
|
167
138
|
// A sign-in stored before `Key.chainId` existed gains it here.
|
|
168
139
|
const key = Key.from(authorization.key);
|
|
169
140
|
const account = Key.toAccount(key, options);
|
|
170
|
-
|
|
171
|
-
version++;
|
|
141
|
+
begin()(account);
|
|
172
142
|
return { ...authorization, account, key };
|
|
173
143
|
},
|
|
174
144
|
async signOut() {
|
|
@@ -176,7 +146,6 @@ export function tempoAuth(options) {
|
|
|
176
146
|
// pending is discarded, since the user asked to leave.
|
|
177
147
|
state.account = undefined;
|
|
178
148
|
version++;
|
|
179
|
-
signedOut = version;
|
|
180
149
|
await Actions.signOut(auth);
|
|
181
150
|
},
|
|
182
151
|
tempoAccount: {
|
package/dist/TempoAccount.d.ts
CHANGED
|
@@ -6,19 +6,13 @@
|
|
|
6
6
|
export type TempoAccount = {
|
|
7
7
|
/** The account's address, the same on every Tempo chain. */
|
|
8
8
|
address: `0x${string}`;
|
|
9
|
-
/**
|
|
10
|
-
* Who holds the account's owner key: a Privy wallet, which Tempo Auth signs with (`privy`), or a
|
|
11
|
-
* passkey, which signs only on a Tempo Auth page (`webAuthn`). Treat another value as an owner
|
|
12
|
-
* that may refuse a key authorization.
|
|
13
|
-
*/
|
|
14
|
-
owner: 'privy' | 'webAuthn' | (string & {});
|
|
15
9
|
};
|
|
16
10
|
/**
|
|
17
11
|
* Instantiates a {@link TempoAccount}.
|
|
18
12
|
*
|
|
19
13
|
* @example
|
|
20
14
|
* ```ts
|
|
21
|
-
* const tempoAccount = TempoAccount.from({ address: '0x…'
|
|
15
|
+
* const tempoAccount = TempoAccount.from({ address: '0x…' })
|
|
22
16
|
* ```
|
|
23
17
|
*/
|
|
24
18
|
export declare function from(value: TempoAccount): TempoAccount;
|
package/dist/TempoAccount.js
CHANGED
package/dist/actions/email.d.ts
CHANGED
|
@@ -44,11 +44,6 @@ export declare namespace signIn {
|
|
|
44
44
|
code: string;
|
|
45
45
|
/** The address the code was sent to. */
|
|
46
46
|
email: string;
|
|
47
|
-
/**
|
|
48
|
-
* The `link` from `Actions.passkey.signIn`'s email step, which links that wallet.tempo passkey
|
|
49
|
-
* to the user.
|
|
50
|
-
*/
|
|
51
|
-
link?: string | undefined;
|
|
52
47
|
/** What the key may do. It must fit the headless ceiling, which fills what it leaves out. */
|
|
53
48
|
permissions?: Permissions<chainId> | undefined;
|
|
54
49
|
};
|
package/dist/actions/email.js
CHANGED
|
@@ -23,14 +23,13 @@ export async function sendCode(auth, options) {
|
|
|
23
23
|
* ```
|
|
24
24
|
*/
|
|
25
25
|
export async function signIn(auth, options) {
|
|
26
|
-
const { code, email,
|
|
26
|
+
const { code, email, permissions } = options;
|
|
27
27
|
const key = await AccessKey.resolve(options.accessKey);
|
|
28
28
|
const body = await Api.json(await Api.post(auth, '/v1/auth/code/verify', {
|
|
29
29
|
json: {
|
|
30
30
|
authorize: request(auth, { accessKey: key.accessKey, permissions }),
|
|
31
31
|
code,
|
|
32
32
|
email,
|
|
33
|
-
...(link ? { link } : {}),
|
|
34
33
|
},
|
|
35
34
|
}));
|
|
36
35
|
if ('step' in body)
|
|
@@ -12,7 +12,8 @@ import * as Api from '../internal/api.js';
|
|
|
12
12
|
* ```
|
|
13
13
|
*/
|
|
14
14
|
export async function create(auth) {
|
|
15
|
-
|
|
15
|
+
const { address } = await Api.json(await Api.post(auth, '/v1/account/tempo', { json: {} }));
|
|
16
|
+
return { address };
|
|
16
17
|
}
|
|
17
18
|
/**
|
|
18
19
|
* Lists the signed-in user's Tempo Accounts, their default first.
|
|
@@ -26,12 +27,5 @@ export async function list(auth) {
|
|
|
26
27
|
const { tempo } = await Api.json(await (auth.fetch ?? fetch)(new URL('/v1/account', auth.url), {
|
|
27
28
|
credentials: 'include',
|
|
28
29
|
}));
|
|
29
|
-
return tempo.map(
|
|
30
|
-
}
|
|
31
|
-
/** Reads the account's address and the type of its owner, which the API lists first. */
|
|
32
|
-
function toTempoAccount(account) {
|
|
33
|
-
return {
|
|
34
|
-
address: account.address,
|
|
35
|
-
owner: account.config.owners[0].type,
|
|
36
|
-
};
|
|
30
|
+
return tempo.map(({ address }) => ({ address }));
|
|
37
31
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tempoxyz/auth",
|
|
3
|
-
"version": "0.0.0-pr-
|
|
3
|
+
"version": "0.0.0-pr-67.sha-7ff1fd6",
|
|
4
4
|
"description": "Signs users in to Tempo through Tempo Auth, and returns Viem access key accounts on their Tempo Accounts.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Signs the user in with a passkey from the app's own sign-in form. The browser offers every passkey
|
|
3
|
-
* it holds for Tempo's domain, so the app needs no email first.
|
|
4
|
-
* @module
|
|
5
|
-
*/
|
|
6
|
-
import { Authentication } from 'ox/webauthn';
|
|
7
|
-
import type { Account } from 'viem/tempo';
|
|
8
|
-
import type { Auth } from '../Auth.ts';
|
|
9
|
-
import type { Authorization } from '../Authorization.ts';
|
|
10
|
-
import type { Permissions } from '../Permissions.ts';
|
|
11
|
-
/**
|
|
12
|
-
* Signs the user in with a passkey, and authorizes the app in the same call. Returns the email step
|
|
13
|
-
* for a wallet.tempo passkey whose account has no email: the app signs the user in with
|
|
14
|
-
* `Actions.email.signIn`, passing the step's `link`, which links the passkey. Throws a `RequestError` with reason
|
|
15
|
-
* `webauthn_required` when a passkey owns the Tempo Account the key acts for, since a passkey signs a
|
|
16
|
-
* key authorization only on Tempo Auth's pages. `Actions.redirect.start` authorizes it there, where
|
|
17
|
-
* the user is already signed in.
|
|
18
|
-
*
|
|
19
|
-
* @example
|
|
20
|
-
* ```ts
|
|
21
|
-
* const result = await Actions.passkey.signIn(auth)
|
|
22
|
-
* if ('step' in result) showEmailForm()
|
|
23
|
-
* ```
|
|
24
|
-
*/
|
|
25
|
-
export declare function signIn<const chainId extends number = number>(auth: Auth, options?: signIn.Options<chainId>): Promise<signIn.ReturnType<chainId>>;
|
|
26
|
-
export declare namespace signIn {
|
|
27
|
-
type Options<chainId extends number = number> = {
|
|
28
|
-
/**
|
|
29
|
-
* The key to authorize, as a Viem account. Its `access` names the Tempo Account, which
|
|
30
|
-
* defaults to the user's first. Defaults to a new key.
|
|
31
|
-
*/
|
|
32
|
-
accessKey?: Account.Account | undefined;
|
|
33
|
-
/**
|
|
34
|
-
* Runs the WebAuthn ceremony in place of `navigator.credentials.get`, such as a native passkey
|
|
35
|
-
* module. Its assertion must report a web origin on the relying party's domain that the app
|
|
36
|
-
* registered, so an Android app's facet origin is refused.
|
|
37
|
-
*/
|
|
38
|
-
getFn?: Authentication.sign.Options['getFn'] | undefined;
|
|
39
|
-
/** What the key may do. It must fit the headless ceiling, which fills what it leaves out. */
|
|
40
|
-
permissions?: Permissions<chainId> | undefined;
|
|
41
|
-
};
|
|
42
|
-
/** The step a wallet.tempo passkey without an email needs: an emailed code, which links it. */
|
|
43
|
-
type EmailStep = {
|
|
44
|
-
/** Passed as `link` to `Actions.email.signIn`, which links the passkey to that user. */
|
|
45
|
-
link: string;
|
|
46
|
-
/** The kind of step. */
|
|
47
|
-
type: 'email';
|
|
48
|
-
};
|
|
49
|
-
/** The authorization, or the email step. */
|
|
50
|
-
type ReturnType<chainId extends number = number> = Authorization<chainId> | {
|
|
51
|
-
step: EmailStep;
|
|
52
|
-
};
|
|
53
|
-
}
|
package/dist/actions/passkey.js
DELETED
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Signs the user in with a passkey from the app's own sign-in form. The browser offers every passkey
|
|
3
|
-
* it holds for Tempo's domain, so the app needs no email first.
|
|
4
|
-
* @module
|
|
5
|
-
*/
|
|
6
|
-
import { Authentication } from 'ox/webauthn';
|
|
7
|
-
import * as AccessKey from '../internal/accessKey.js';
|
|
8
|
-
import * as Api from '../internal/api.js';
|
|
9
|
-
import { request } from '../internal/request.js';
|
|
10
|
-
/**
|
|
11
|
-
* Signs the user in with a passkey, and authorizes the app in the same call. Returns the email step
|
|
12
|
-
* for a wallet.tempo passkey whose account has no email: the app signs the user in with
|
|
13
|
-
* `Actions.email.signIn`, passing the step's `link`, which links the passkey. Throws a `RequestError` with reason
|
|
14
|
-
* `webauthn_required` when a passkey owns the Tempo Account the key acts for, since a passkey signs a
|
|
15
|
-
* key authorization only on Tempo Auth's pages. `Actions.redirect.start` authorizes it there, where
|
|
16
|
-
* the user is already signed in.
|
|
17
|
-
*
|
|
18
|
-
* @example
|
|
19
|
-
* ```ts
|
|
20
|
-
* const result = await Actions.passkey.signIn(auth)
|
|
21
|
-
* if ('step' in result) showEmailForm()
|
|
22
|
-
* ```
|
|
23
|
-
*/
|
|
24
|
-
export async function signIn(auth, options = {}) {
|
|
25
|
-
const { getFn, permissions } = options;
|
|
26
|
-
const key = await AccessKey.resolve(options.accessKey);
|
|
27
|
-
const requested = await Api.json(await Api.post(auth, '/v1/auth/passkey/options', { json: {} }));
|
|
28
|
-
const deserialized = Authentication.deserializeOptions(requested.options);
|
|
29
|
-
const assertion = Authentication.serializeResponse(await Authentication.sign(
|
|
30
|
-
// ox reads `getFn` beside request options at runtime, which its types admit only beside a challenge.
|
|
31
|
-
getFn ? { ...deserialized, getFn } : deserialized));
|
|
32
|
-
const body = await Api.json(await Api.post(auth, '/v1/auth/passkey/verify', {
|
|
33
|
-
json: {
|
|
34
|
-
assertion,
|
|
35
|
-
authorize: request(auth, { accessKey: key.accessKey, permissions }),
|
|
36
|
-
},
|
|
37
|
-
}));
|
|
38
|
-
if ('step' in body)
|
|
39
|
-
return { step: body.step };
|
|
40
|
-
return Api.authorization(body.authorization, key);
|
|
41
|
-
}
|