@bbthorson/atproto-cf-auth 0.3.0 → 0.4.0

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/README.md CHANGED
@@ -238,27 +238,81 @@ the handle before calling the server. Errors are `AuthError`s whose `message` is
238
238
  ready to show and whose `code` you can map to your own copy (`AUTH_ERROR_MESSAGES`
239
239
  holds the defaults). Spread `HANDLE_INPUT_ATTRIBUTES` onto your own `<input>` so
240
240
  phones don't capitalise the handle and password managers offer it.
241
- `searchHandles(query)` is an optional typeahead against Bluesky's public API.
241
+ `searchHandles(query)` is the typeahead search on its own, against Bluesky's public API.
242
+
243
+ ### Remembered accounts and typeahead
244
+
245
+ The pieces behind a "Continue as @alice" sign-in screen, for any framework:
246
+
247
+ ```ts
248
+ import { createRecentAccounts, createSignInController } from "@bbthorson/atproto-cf-auth/client";
249
+
250
+ const accounts = createRecentAccounts(); // localStorage; pass `storage` for React Native
251
+
252
+ // Once a sign-in has worked (the page the callback lands on):
253
+ const user = await auth.getUser();
254
+ if (user) await accounts.remember(user); // fills name and avatar from Bluesky's public API
255
+
256
+ // On the sign-in screen:
257
+ const controller = createSignInController({
258
+ signIn: (handle) => auth.signIn(handle), // or your own redirect; navigate away or throw
259
+ accounts,
260
+ typeahead: true, // off by default: it sends keystrokes to Bluesky
261
+ });
262
+ controller.subscribe(() => render(controller.getState()));
263
+ // state: { query, suggestions, activeIndex, accounts, status, error, pending }
264
+ // actions: setQuery, moveActive, closeSuggestions, submit, choose(account), forget(did), setError
265
+ ```
266
+
267
+ The controller owns everything that isn't markup: debounced, cancelled
268
+ searches that ignore late answers; handle normalisation and checking before
269
+ anything is sent; one sign-in at a time; and leaving the "loading" state when
270
+ the page comes back from the back/forward cache. In React, read it with
271
+ `useSyncExternalStore(controller.subscribe, controller.getState)` and draw it
272
+ with your own components.
273
+
274
+ Remembered accounts stay on the device and hold no tokens: DID, handle,
275
+ display name and an https avatar URL. Signing out doesn't forget them; the ✕
276
+ on a card does (`forget`). `lookupProfile(actor)` is the profile lookup on its
277
+ own.
242
278
 
243
279
  ### `<bsky-sign-in>`
244
280
 
245
281
  ```html
246
282
  <script type="module">import "@bbthorson/atproto-cf-auth/element";</script>
247
283
 
248
- <bsky-sign-in return-to="/campaigns" button-label="Continue with Bluesky"></bsky-sign-in>
284
+ <bsky-sign-in return-to="/campaigns" button-label="Continue" typeahead remember-accounts></bsky-sign-in>
249
285
  ```
250
286
 
251
- It renders into the light DOM with plain classes (`bsky-sign-in__form`,
252
- `__label`, `__input`, `__button`, `__error`) and sets `data-state="idle|loading|error"`,
253
- so your own CSS or Tailwind styles it. To use your own markup, put a `<form>`
254
- containing `<input name="handle">`, a button and an element with
255
- `data-bsky-error` inside the element; it adds behaviour and leaves your markup
256
- alone. The form still works with JavaScript off, because it posts to
257
- `/auth/login`.
287
+ It renders into the light DOM with plain classes and sets
288
+ `data-state="idle|loading|error"`, so your own CSS or Tailwind styles it:
289
+ `bsky-sign-in__form`, `__accounts`, `__account`, `__account-choose`,
290
+ `__account-forget`, `__divider`, `__label`, `__field`, `__input`,
291
+ `__suggestions`, `__suggestion`, `__avatar` (`__avatar--empty` without a
292
+ picture), `__identity`, `__name`, `__handle`, `__button`, `__error`.
293
+
294
+ For a starting point, import `@bbthorson/atproto-cf-auth/element.css`. It
295
+ inherits the page's font and text colour, and takes its other choices from
296
+ custom properties (`--bsky-sign-in-accent`, `-surface`, `-border`, `-muted`,
297
+ `-hover`, `-error`, `-radius`, `-card-radius`, `-avatar-size`, `-gap`), so a
298
+ few lines make it match the site.
299
+
300
+ To use your own markup, put a `<form>` containing `<input name="handle">`, a
301
+ button and an element with `data-bsky-error` inside the element; it adds
302
+ behaviour and leaves your markup alone. Add an element with
303
+ `data-bsky-suggestions` for the typeahead list, `data-bsky-accounts` for the
304
+ remembered accounts, and `data-bsky-divider` to show only when there are any.
305
+ The form still works with JavaScript off, because it posts to `/auth/login`.
258
306
 
259
307
  Attributes: `base-path`, `return-to`, `label`, `placeholder`, `button-label`,
260
- `loading-label`, `ignore-redirect-errors`. Event: `bsky-sign-in:error` with
261
- `{ code, message }`. Call `preventDefault()` on it to show the error yourself.
308
+ `loading-label`, `divider-label`, `typeahead`, `remember-accounts`,
309
+ `ignore-redirect-errors`. Event: `bsky-sign-in:error` with `{ code, message }`.
310
+ Call `preventDefault()` on it to show the error yourself. The input is an ARIA
311
+ combobox when `typeahead` is on: arrow keys move through suggestions, Enter
312
+ signs in as the highlighted one, Escape closes the list.
313
+
314
+ `remember-accounts` only shows accounts; remembering one is the call to
315
+ `accounts.remember(user)` above, on a page where you know the sign-in worked.
262
316
 
263
317
  In React, render `<bsky-sign-in>` like any element. Importing the module in a
264
318
  client component registers it, and the import is a no-op during SSR.
@@ -0,0 +1,91 @@
1
+ /**
2
+ * Accounts this browser has signed in with, for a "Continue as @alice" card
3
+ * above the handle field.
4
+ *
5
+ * Kept on the device only (`localStorage` by default), never sent anywhere.
6
+ * Holds what's needed to draw the card and start a sign-in: DID, handle,
7
+ * display name and avatar URL. No tokens.
8
+ *
9
+ * Remember an account once you know the sign-in worked: on the page the
10
+ * callback lands on, after `getUser()` returns someone.
11
+ *
12
+ * const accounts = createRecentAccounts();
13
+ * const user = await auth.getUser();
14
+ * if (user) await accounts.remember(user);
15
+ *
16
+ * Signing out doesn't forget the account; that is what lets the next sign-in
17
+ * take one tap. People remove it with the card's ✕ (`forget`).
18
+ */
19
+ export interface RecentAccount {
20
+ did: string;
21
+ handle: string;
22
+ displayName?: string;
23
+ /** An https URL. Anything else is dropped when the account is stored. */
24
+ avatar?: string;
25
+ /** ISO timestamp of the last time this account was remembered. */
26
+ lastUsedAt: string;
27
+ }
28
+ /** What `remember` accepts: a `User` from `getUser()` is enough. */
29
+ export interface AccountInput {
30
+ did: string;
31
+ handle?: string | undefined;
32
+ displayName?: string | undefined;
33
+ avatar?: string | undefined;
34
+ }
35
+ /**
36
+ * Where the list lives. `localStorage` fits as it is; on React Native, wrap
37
+ * SecureStore or AsyncStorage (either may return promises).
38
+ */
39
+ export interface AccountStorage {
40
+ getItem(key: string): string | null | undefined | Promise<string | null | undefined>;
41
+ setItem(key: string, value: string): void | Promise<void>;
42
+ removeItem(key: string): void | Promise<void>;
43
+ }
44
+ export interface RecentAccountsOptions {
45
+ /** Default: `localStorage`, where it exists and can be written. `null` keeps the list in memory only. */
46
+ storage?: AccountStorage | null;
47
+ /** Default `atproto-cf-auth:recent-accounts`. */
48
+ key?: string;
49
+ /** Most accounts kept, newest first. Default 3. */
50
+ max?: number;
51
+ /**
52
+ * Fill in a missing handle, display name or avatar from Bluesky's public
53
+ * profile API when remembering. Default true. This sends the DID (only) to
54
+ * `public.api.bsky.app`.
55
+ */
56
+ lookup?: boolean;
57
+ fetch?: typeof fetch;
58
+ }
59
+ export interface RecentAccounts {
60
+ /** Newest first. Never throws: unreadable storage reads as an empty list. */
61
+ list(): Promise<RecentAccount[]>;
62
+ /**
63
+ * Put the account at the top of the list, looking up whatever profile
64
+ * details are missing. Resolves to the stored entry, or `null` if no handle
65
+ * could be found for it (a card needs one).
66
+ */
67
+ remember(account: AccountInput): Promise<RecentAccount | null>;
68
+ forget(did: string): Promise<void>;
69
+ clear(): Promise<void>;
70
+ /** Called after every change made through this object. */
71
+ subscribe(listener: (accounts: RecentAccount[]) => void): () => void;
72
+ }
73
+ export declare const RECENT_ACCOUNTS_KEY = "atproto-cf-auth:recent-accounts";
74
+ export declare function createRecentAccounts(options?: RecentAccountsOptions): RecentAccounts;
75
+ export interface ProfileSummary {
76
+ did: string;
77
+ handle: string;
78
+ displayName?: string;
79
+ avatar?: string;
80
+ }
81
+ /**
82
+ * A handle, display name and avatar for a DID or handle, from Bluesky's
83
+ * public AppView. `null` when it doesn't answer or doesn't know the account
84
+ * (accounts that never used Bluesky have no profile there).
85
+ */
86
+ export declare function lookupProfile(actor: string, options?: {
87
+ fetch?: typeof fetch;
88
+ signal?: AbortSignal;
89
+ }): Promise<ProfileSummary | null>;
90
+ /** Only https URLs reach an `<img src>`. */
91
+ export declare function httpsUrl(value: unknown): string | undefined;
@@ -0,0 +1,179 @@
1
+ /**
2
+ * Accounts this browser has signed in with, for a "Continue as @alice" card
3
+ * above the handle field.
4
+ *
5
+ * Kept on the device only (`localStorage` by default), never sent anywhere.
6
+ * Holds what's needed to draw the card and start a sign-in: DID, handle,
7
+ * display name and avatar URL. No tokens.
8
+ *
9
+ * Remember an account once you know the sign-in worked: on the page the
10
+ * callback lands on, after `getUser()` returns someone.
11
+ *
12
+ * const accounts = createRecentAccounts();
13
+ * const user = await auth.getUser();
14
+ * if (user) await accounts.remember(user);
15
+ *
16
+ * Signing out doesn't forget the account; that is what lets the next sign-in
17
+ * take one tap. People remove it with the card's ✕ (`forget`).
18
+ */
19
+ export const RECENT_ACCOUNTS_KEY = "atproto-cf-auth:recent-accounts";
20
+ export function createRecentAccounts(options = {}) {
21
+ const key = options.key ?? RECENT_ACCOUNTS_KEY;
22
+ const max = Math.max(1, options.max ?? 3);
23
+ const storage = options.storage === undefined ? defaultStorage() : options.storage;
24
+ const lookup = options.lookup ?? true;
25
+ const listeners = new Set();
26
+ let memory = [];
27
+ async function read() {
28
+ if (!storage)
29
+ return memory;
30
+ try {
31
+ const raw = await storage.getItem(key);
32
+ return raw ? parseAccounts(raw) : [];
33
+ }
34
+ catch {
35
+ return [];
36
+ }
37
+ }
38
+ async function write(accounts) {
39
+ memory = accounts;
40
+ if (storage) {
41
+ try {
42
+ if (accounts.length)
43
+ await storage.setItem(key, JSON.stringify(accounts));
44
+ else
45
+ await storage.removeItem(key);
46
+ }
47
+ catch {
48
+ // Private mode or a full quota: the list just isn't kept.
49
+ }
50
+ }
51
+ for (const listener of listeners)
52
+ listener(accounts);
53
+ }
54
+ return {
55
+ list: read,
56
+ async remember(input) {
57
+ if (!input.did.startsWith("did:"))
58
+ return null;
59
+ const known = (await read()).find((a) => a.did === input.did);
60
+ let handle = input.handle ?? known?.handle;
61
+ let displayName = input.displayName ?? known?.displayName;
62
+ let avatar = input.avatar ?? known?.avatar;
63
+ if (lookup && (!input.handle || !displayName || !avatar)) {
64
+ const profile = await lookupProfile(input.did, options.fetch ? { fetch: options.fetch } : {});
65
+ if (profile) {
66
+ handle = input.handle ?? profile.handle;
67
+ displayName = input.displayName ?? profile.displayName ?? displayName;
68
+ avatar = input.avatar ?? profile.avatar ?? avatar;
69
+ }
70
+ }
71
+ if (!handle || handle === "handle.invalid")
72
+ return null;
73
+ const entry = toAccount({ did: input.did, handle, displayName, avatar, lastUsedAt: new Date().toISOString() });
74
+ if (!entry)
75
+ return null;
76
+ const rest = (await read()).filter((a) => a.did !== entry.did);
77
+ await write([entry, ...rest].slice(0, max));
78
+ return entry;
79
+ },
80
+ async forget(did) {
81
+ const accounts = await read();
82
+ const next = accounts.filter((a) => a.did !== did);
83
+ if (next.length !== accounts.length)
84
+ await write(next);
85
+ },
86
+ async clear() {
87
+ await write([]);
88
+ },
89
+ subscribe(listener) {
90
+ listeners.add(listener);
91
+ return () => listeners.delete(listener);
92
+ },
93
+ };
94
+ }
95
+ /**
96
+ * A handle, display name and avatar for a DID or handle, from Bluesky's
97
+ * public AppView. `null` when it doesn't answer or doesn't know the account
98
+ * (accounts that never used Bluesky have no profile there).
99
+ */
100
+ export async function lookupProfile(actor, options = {}) {
101
+ const url = new URL("https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile");
102
+ url.searchParams.set("actor", actor);
103
+ const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
104
+ try {
105
+ const res = await doFetch(url, options.signal ? { signal: options.signal } : {});
106
+ if (!res.ok)
107
+ return null;
108
+ const body = await res.json();
109
+ if (!isRecord(body) || typeof body["did"] !== "string" || typeof body["handle"] !== "string")
110
+ return null;
111
+ const displayName = typeof body["displayName"] === "string" && body["displayName"].trim() ? body["displayName"] : undefined;
112
+ const avatar = httpsUrl(body["avatar"]);
113
+ return {
114
+ did: body["did"],
115
+ handle: body["handle"],
116
+ ...(displayName ? { displayName } : {}),
117
+ ...(avatar ? { avatar } : {}),
118
+ };
119
+ }
120
+ catch {
121
+ return null;
122
+ }
123
+ }
124
+ function parseAccounts(raw) {
125
+ let value;
126
+ try {
127
+ value = JSON.parse(raw);
128
+ }
129
+ catch {
130
+ return [];
131
+ }
132
+ if (!Array.isArray(value))
133
+ return [];
134
+ return value.flatMap((item) => {
135
+ const account = isRecord(item) ? toAccount(item) : null;
136
+ return account ? [account] : [];
137
+ });
138
+ }
139
+ function toAccount(item) {
140
+ const { did, handle, displayName, lastUsedAt } = item;
141
+ if (typeof did !== "string" || !did.startsWith("did:"))
142
+ return null;
143
+ if (typeof handle !== "string" || !handle)
144
+ return null;
145
+ const avatar = httpsUrl(item["avatar"]);
146
+ return {
147
+ did,
148
+ handle,
149
+ ...(typeof displayName === "string" && displayName ? { displayName } : {}),
150
+ ...(avatar ? { avatar } : {}),
151
+ lastUsedAt: typeof lastUsedAt === "string" ? lastUsedAt : new Date(0).toISOString(),
152
+ };
153
+ }
154
+ /** Only https URLs reach an `<img src>`. */
155
+ export function httpsUrl(value) {
156
+ if (typeof value !== "string")
157
+ return undefined;
158
+ try {
159
+ return new URL(value).protocol === "https:" ? value : undefined;
160
+ }
161
+ catch {
162
+ return undefined;
163
+ }
164
+ }
165
+ function isRecord(value) {
166
+ return typeof value === "object" && value !== null && !Array.isArray(value);
167
+ }
168
+ function defaultStorage() {
169
+ try {
170
+ if (typeof localStorage === "undefined")
171
+ return null;
172
+ return localStorage;
173
+ }
174
+ catch {
175
+ // Reading `localStorage` itself throws where site data is blocked.
176
+ return null;
177
+ }
178
+ }
179
+ //# sourceMappingURL=accounts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accounts.js","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA6DH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAErE,MAAM,UAAU,oBAAoB,CAAC,UAAiC,EAAE;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACnF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IACjE,IAAI,MAAM,GAAoB,EAAE,CAAC;IAEjC,KAAK,UAAU,IAAI;QACjB,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,QAAyB;QAC5C,MAAM,GAAG,QAAQ,CAAC;QAClB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,MAAM;oBAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;;oBACrE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI;QAEV,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,MAAM,CAAC;YAC3C,IAAI,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,EAAE,WAAW,CAAC;YAC1D,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,MAAM,CAAC;YAC3C,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9F,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;oBACxC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;oBACtE,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;gBACpD,CAAC;YACH,CAAC;YACD,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,gBAAgB;gBAAE,OAAO,IAAI,CAAC;YACxD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/G,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AASD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,UAA0D,EAAE;IAE5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAClF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAY,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1G,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5H,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;YAChB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAA6B;IAC9C,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,OAAO;QACL,GAAG;QACH,MAAM;QACN,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,UAAU,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;KACpF,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,IAAI,OAAO,YAAY,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
package/dist/client.d.ts CHANGED
@@ -5,6 +5,9 @@
5
5
  */
6
6
  import { AuthError, type User } from "./shared.js";
7
7
  export { AUTH_ERROR_MESSAGES, AUTH_ERROR_PARAM, AuthError, isAuthErrorCode, isValidHandle, normalizeHandle, type AuthErrorCode, type User, } from "./shared.js";
8
+ export { createRecentAccounts, lookupProfile, RECENT_ACCOUNTS_KEY, type AccountInput, type AccountStorage, type ProfileSummary, type RecentAccount, type RecentAccounts, type RecentAccountsOptions, } from "./accounts.js";
9
+ export { searchHandles, type HandleSuggestion } from "./search.js";
10
+ export { createSignInController, type SignInController, type SignInControllerOptions, type SignInState, type SignInStatus, } from "./controller.js";
8
11
  export interface AuthClientOptions {
9
12
  /** Must match the server's `basePath`. Default `/auth`. */
10
13
  basePath?: string;
@@ -50,19 +53,3 @@ export declare const HANDLE_INPUT_ATTRIBUTES: {
50
53
  readonly enterkeyhint: "go";
51
54
  readonly placeholder: "you.bsky.social";
52
55
  };
53
- export interface HandleSuggestion {
54
- did: string;
55
- handle: string;
56
- displayName?: string;
57
- avatar?: string;
58
- }
59
- /**
60
- * Handle typeahead from Bluesky's public AppView. Optional, and it sends what
61
- * the person types to Bluesky as they type, so only use it where that's fine.
62
- * Pass an `AbortSignal` and abort the previous call on each keystroke.
63
- */
64
- export declare function searchHandles(query: string, options?: {
65
- limit?: number;
66
- signal?: AbortSignal;
67
- fetch?: typeof fetch;
68
- }): Promise<HandleSuggestion[]>;
package/dist/client.js CHANGED
@@ -5,6 +5,9 @@
5
5
  */
6
6
  import { AUTH_ERROR_PARAM, AuthError, isAuthErrorCode, isValidHandle, normalizeHandle, } from "./shared.js";
7
7
  export { AUTH_ERROR_MESSAGES, AUTH_ERROR_PARAM, AuthError, isAuthErrorCode, isValidHandle, normalizeHandle, } from "./shared.js";
8
+ export { createRecentAccounts, lookupProfile, RECENT_ACCOUNTS_KEY, } from "./accounts.js";
9
+ export { searchHandles } from "./search.js";
10
+ export { createSignInController, } from "./controller.js";
8
11
  export function createAuthClient(options = {}) {
9
12
  const base = (options.basePath ?? "/auth").replace(/\/+$/, "");
10
13
  const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
@@ -78,32 +81,4 @@ export const HANDLE_INPUT_ATTRIBUTES = {
78
81
  enterkeyhint: "go",
79
82
  placeholder: "you.bsky.social",
80
83
  };
81
- /**
82
- * Handle typeahead from Bluesky's public AppView. Optional, and it sends what
83
- * the person types to Bluesky as they type, so only use it where that's fine.
84
- * Pass an `AbortSignal` and abort the previous call on each keystroke.
85
- */
86
- export async function searchHandles(query, options = {}) {
87
- const q = query.trim().replace(/^@/, "");
88
- if (q.length < 2)
89
- return [];
90
- const url = new URL("https://public.api.bsky.app/xrpc/app.bsky.actor.searchActorsTypeahead");
91
- url.searchParams.set("q", q);
92
- url.searchParams.set("limit", String(options.limit ?? 5));
93
- const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
94
- const res = await doFetch(url, options.signal ? { signal: options.signal } : {});
95
- if (!res.ok)
96
- return [];
97
- const body = (await res.json());
98
- return (body.actors ?? []).flatMap((a) => typeof a["did"] === "string" && typeof a["handle"] === "string"
99
- ? [
100
- {
101
- did: a["did"],
102
- handle: a["handle"],
103
- ...(typeof a["displayName"] === "string" && a["displayName"] ? { displayName: a["displayName"] } : {}),
104
- ...(typeof a["avatar"] === "string" ? { avatar: a["avatar"] } : {}),
105
- },
106
- ]
107
- : []);
108
- }
109
84
  //# sourceMappingURL=client.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ /**
2
+ * The state behind a sign-in screen, without the screen: what's typed, the
3
+ * typeahead suggestions and which one is highlighted, the remembered
4
+ * accounts, and whether a sign-in is under way or has failed.
5
+ *
6
+ * Every UI wraps the same controller: `<bsky-sign-in>` does, and a React
7
+ * component can with `useSyncExternalStore(controller.subscribe,
8
+ * controller.getState)`. State objects are immutable snapshots, replaced on
9
+ * every change.
10
+ *
11
+ * const controller = createSignInController({
12
+ * signIn: (handle) => auth.signIn(handle), // or your own redirect
13
+ * accounts: createRecentAccounts(),
14
+ * typeahead: true,
15
+ * });
16
+ *
17
+ * `signIn` gets a normalised, checked handle or DID. It should navigate away
18
+ * (the controller then stays `loading` until the page goes) or throw; an
19
+ * `AuthError` it throws is shown as it is, anything else as `authorize_failed`.
20
+ */
21
+ import type { RecentAccount, RecentAccounts } from "./accounts.js";
22
+ import { type HandleSuggestion } from "./search.js";
23
+ import { AuthError } from "./shared.js";
24
+ export type SignInStatus = "idle" | "loading" | "error";
25
+ export interface SignInState {
26
+ /** What's in the field, as typed. */
27
+ query: string;
28
+ /** Typeahead results for `query`; empty when closed. */
29
+ suggestions: readonly HandleSuggestion[];
30
+ /** Index into `suggestions` of the highlighted one, or -1. */
31
+ activeIndex: number;
32
+ /** Remembered accounts, newest first. */
33
+ accounts: readonly RecentAccount[];
34
+ status: SignInStatus;
35
+ /** Set when `status` is `error`. */
36
+ error: AuthError | null;
37
+ /** The handle or DID a sign-in is under way for, while `loading`. */
38
+ pending: string | null;
39
+ }
40
+ export interface SignInControllerOptions {
41
+ /** Start the sign-in for a normalised, valid handle or DID. Navigate away, or throw. */
42
+ signIn: (identifier: string) => Promise<void>;
43
+ /** Remembered accounts to offer above the field. */
44
+ accounts?: RecentAccounts | null;
45
+ /**
46
+ * Suggest accounts as the person types. `true` uses `searchHandles`
47
+ * (Bluesky's public AppView, which sees every keystroke); pass your own
48
+ * function to search elsewhere. Default off.
49
+ */
50
+ typeahead?: boolean | ((query: string, options: {
51
+ signal: AbortSignal;
52
+ }) => Promise<HandleSuggestion[]>);
53
+ /** Wait this long after the last keystroke before searching. Default 150 ms. */
54
+ debounceMs?: number;
55
+ /** Shortest query searched. Default 2. */
56
+ minQueryLength?: number;
57
+ /** Suggestions shown. Default 5. */
58
+ limit?: number;
59
+ /** Passed to `normalizeHandle`: what a bare name gets appended. Default `bsky.social`; `null` for none. */
60
+ defaultDomain?: string | null;
61
+ /** Map what `signIn` threw to the error to show. Default: `AuthError`s as they are, else `authorize_failed`. */
62
+ toError?: (error: unknown) => AuthError;
63
+ }
64
+ export interface SignInController {
65
+ getState(): SignInState;
66
+ /** Called after every state change. Returns the unsubscribe function. */
67
+ subscribe(listener: () => void): () => void;
68
+ /** The field changed. Clears an error and, with typeahead on, searches. */
69
+ setQuery(query: string): void;
70
+ /** Move the highlight by `delta` (wrapping), e.g. from arrow keys. Opens nothing on its own. */
71
+ moveActive(delta: number): void;
72
+ setActive(index: number): void;
73
+ /** Close the suggestions (Escape, or the field losing focus). */
74
+ closeSuggestions(): void;
75
+ /** Sign in as the highlighted suggestion if there is one, else as what's typed. */
76
+ submit(): Promise<void>;
77
+ /** Sign in as a suggestion or remembered account. */
78
+ choose(account: HandleSuggestion | RecentAccount): Promise<void>;
79
+ /** Drop a remembered account. */
80
+ forget(did: string): Promise<void>;
81
+ /** Show an error from elsewhere, such as `takeAuthError()` after a failed redirect. `null` clears it. */
82
+ setError(error: AuthError | null): void;
83
+ /** Stop listening and cancel any search. */
84
+ destroy(): void;
85
+ }
86
+ export declare function createSignInController(options: SignInControllerOptions): SignInController;