sliftutils 1.2.19 → 1.2.20

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/index.d.ts CHANGED
@@ -1336,7 +1336,7 @@ declare module "sliftutils/storage/fileSystemPointer" {
1336
1336
  export declare function getFileSystemPointer(config: {
1337
1337
  pointer: FileSystemPointer;
1338
1338
  }): Promise<{
1339
- onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle | undefined>;
1339
+ onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle>;
1340
1340
  } | undefined>;
1341
1341
 
1342
1342
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sliftutils",
3
- "version": "1.2.19",
3
+ "version": "1.2.20",
4
4
  "main": "index.js",
5
5
  "license": "MIT",
6
6
  "files": [
@@ -221,146 +221,8 @@ class NodeJSDirectoryHandleWrapper implements DirectoryWrapper {
221
221
  }
222
222
 
223
223
 
224
- function isNotAllowedError(e: unknown): boolean {
225
- return !!e && typeof e === "object" && (e as any).name === "NotAllowedError";
226
- }
227
-
228
- // Deduplicates concurrent retry-prompts so only one button is shown to the user,
229
- // and all in-flight callers wait on the same grant.
230
- let pendingPermissionPrompt: Promise<void> | undefined;
231
- async function requestPermissionInteractive(handle: any, mode: "read" | "readwrite" = "readwrite"): Promise<void> {
232
- if (pendingPermissionPrompt) return pendingPermissionPrompt;
233
- pendingPermissionPrompt = (async () => {
234
- // Some browsers grant without user activation (persistent permissions, multi-tab).
235
- // Try once cheaply before showing UI.
236
- try {
237
- if (typeof handle?.requestPermission === "function") {
238
- const result = await handle.requestPermission({ mode });
239
- if (result === "granted") return;
240
- }
241
- } catch { /* user activation required — fall through to button */ }
242
-
243
- let root = document.createElement("div");
244
- document.body.appendChild(root);
245
- preact.render(<DirectoryPrompter />, root);
246
- try {
247
- await new Promise<void>(resolve => {
248
- displayData.ui = (
249
- <button
250
- className={css.fontSize(40).pad2(80, 40)}
251
- onClick={async () => {
252
- try {
253
- const result = await handle.requestPermission({ mode });
254
- if (result === "granted") {
255
- resolve();
256
- return;
257
- }
258
- } catch (err) {
259
- console.error("requestPermission failed:", (err as Error).stack ?? err);
260
- }
261
- // Permission still not granted — fall back to a fresh directory pick.
262
- try {
263
- const pickedHandle = await window.showDirectoryPicker();
264
- const grantResult = await (pickedHandle as any).requestPermission({ mode: "readwrite" });
265
- if (grantResult !== "granted") return;
266
- let newStoredId = await storeFileSystemPointer({ mode: "readwrite", handle: pickedHandle });
267
- localStorage.setItem(getFileAPIKey(), newStoredId);
268
- // Reload so all storage layers re-bind to the new root.
269
- window.location.reload();
270
- } catch (err) {
271
- console.error("showDirectoryPicker failed:", (err as Error).stack ?? err);
272
- }
273
- }}
274
- >
275
- Click to allow file system access
276
- </button>
277
- );
278
- });
279
- } finally {
280
- displayData.ui = undefined;
281
- preact.render(null, root);
282
- root.remove();
283
- }
284
- })();
285
- try {
286
- await pendingPermissionPrompt;
287
- } finally {
288
- pendingPermissionPrompt = undefined;
289
- }
290
- }
291
-
292
- async function withPermissionRetry<T>(permissionHandle: any, op: () => Promise<T>): Promise<T> {
293
- try {
294
- return await op();
295
- } catch (e) {
296
- if (!isNotAllowedError(e)) throw e;
297
- await requestPermissionInteractive(permissionHandle);
298
- return await op();
299
- }
300
- }
301
-
302
- function wrapFileWithRetry(file: FileWrapper, permissionHandle: any): FileWrapper {
303
- return {
304
- getFile: () => withPermissionRetry(permissionHandle, () => file.getFile()),
305
- createWritable: async (config) => {
306
- const writable = await withPermissionRetry(permissionHandle, () => file.createWritable(config));
307
- return {
308
- seek: (offset) => withPermissionRetry(permissionHandle, () => writable.seek(offset)),
309
- write: (value) => withPermissionRetry(permissionHandle, () => writable.write(value)),
310
- close: () => withPermissionRetry(permissionHandle, () => writable.close()),
311
- };
312
- },
313
- };
314
- }
315
-
316
- function wrapDirectoryWithRetry(handle: DirectoryWrapper): DirectoryWrapper {
317
- const permissionHandle = handle;
318
- return {
319
- removeEntry: (key, options) => withPermissionRetry(permissionHandle, () => handle.removeEntry(key, options)),
320
- getFileHandle: (async (key: string, options?: { create?: boolean }) =>
321
- wrapFileWithRetry(
322
- await withPermissionRetry(permissionHandle, () => handle.getFileHandle(key, options)),
323
- permissionHandle,
324
- )) as DirectoryWrapper["getFileHandle"],
325
- getDirectoryHandle: async (key, options) =>
326
- wrapDirectoryWithRetry(await withPermissionRetry(permissionHandle, () => handle.getDirectoryHandle(key, options))),
327
- async *[Symbol.asyncIterator]() {
328
- let iter: AsyncIterator<any> | undefined;
329
- while (true) {
330
- let result: IteratorResult<any>;
331
- try {
332
- if (!iter) iter = handle[Symbol.asyncIterator]();
333
- result = await iter.next();
334
- } catch (e) {
335
- if (!isNotAllowedError(e)) throw e;
336
- await requestPermissionInteractive(permissionHandle);
337
- // Restart iteration after re-grant. Callers of getKeys/reset
338
- // collect into arrays, so a fresh full iteration is correct.
339
- iter = undefined;
340
- continue;
341
- }
342
- if (result.done) return;
343
- const [name, entry] = result.value;
344
- if (entry.kind === "directory") {
345
- yield [name, {
346
- ...entry,
347
- getDirectoryHandle: async (k: string, o?: { create?: boolean }) =>
348
- wrapDirectoryWithRetry(await withPermissionRetry(permissionHandle, () => entry.getDirectoryHandle(k, o))),
349
- }];
350
- } else {
351
- yield [name, {
352
- ...entry,
353
- getFile: async () =>
354
- wrapFileWithRetry(await withPermissionRetry(permissionHandle, () => entry.getFile()), permissionHandle),
355
- }];
356
- }
357
- }
358
- },
359
- };
360
- }
361
-
362
224
  // NOTE: Blocks until the user provides a directory
363
- const getDirectoryHandleRaw = lazy(async function getDirectoryHandle(): Promise<DirectoryWrapper> {
225
+ export const getDirectoryHandle = lazy(async function getDirectoryHandle(): Promise<DirectoryWrapper> {
364
226
  if (isNode()) {
365
227
  return new NodeJSDirectoryHandleWrapper(path.resolve("./data/"));
366
228
  }
@@ -467,12 +329,6 @@ const getDirectoryHandleRaw = lazy(async function getDirectoryHandle(): Promise<
467
329
  }
468
330
  });
469
331
 
470
- export const getDirectoryHandle = lazy(async function getDirectoryHandle(): Promise<DirectoryWrapper> {
471
- const handle = await getDirectoryHandleRaw();
472
- if (isNode()) return handle;
473
- return wrapDirectoryWithRetry(handle);
474
- });
475
-
476
332
  export const getFileStorageNested = cache(async function getFileStorage(path: string): Promise<FileStorage> {
477
333
  let base = await getDirectoryHandle();
478
334
  for (let part of path.split("/")) {
@@ -7,5 +7,5 @@ export declare function deleteFileSystemPointer(pointer: FileSystemPointer): Pro
7
7
  export declare function getFileSystemPointer(config: {
8
8
  pointer: FileSystemPointer;
9
9
  }): Promise<{
10
- onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle | undefined>;
10
+ onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle>;
11
11
  } | undefined>;
@@ -63,7 +63,7 @@ export async function getFileSystemPointer(config: {
63
63
  // IMPORTANT! In some circumstances user activation is not required (with multiple tabs,
64
64
  // and potentially with https://developer.chrome.com/blog/persistent-permissions-for-the-file-system-access-api),
65
65
  // so... trying to call onUserActivation immmediately is a good idea (although it might throw).
66
- onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle | undefined>
66
+ onUserActivation(modeOverride?: "read" | "readwrite"): Promise<FileSystemFileHandle | FileSystemDirectoryHandle>
67
67
  } | undefined
68
68
  > {
69
69
  const handle = await read(config.pointer);
@@ -71,14 +71,10 @@ export async function getFileSystemPointer(config: {
71
71
  let mode = config.pointer.split("_").at(-1);
72
72
  return {
73
73
  async onUserActivation(modeOverride) {
74
- let requestedMode = modeOverride ?? mode;
75
- let permission = await (handle as any).queryPermission({ mode: requestedMode });
76
- if (permission !== "granted") {
77
- permission = await (handle as any).requestPermission({ mode: requestedMode });
74
+ let testMode = await (handle as any).queryPermission({ mode: mode });
75
+ if (testMode !== mode) {
76
+ await (handle as any).requestPermission({ mode: modeOverride ?? mode });
78
77
  }
79
- // If the user denied (or otherwise didn't grant) the request, treat the
80
- // stored pointer as unusable so callers can fall back to showDirectoryPicker.
81
- if (permission !== "granted") return undefined;
82
78
  return handle;
83
79
  }
84
80
  };