@dimah-s3/react 1.5.11 → 1.6.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.
@@ -2,5 +2,6 @@ export { useUpload, type UseUploadOptions, type UseUploadReturn, type UploadPoli
2
2
  export { useDownload, isFetchDownload, type DownloadPhase, type DownloadHooks, type FetchDownloadPhase, type FetchDownloadProgress, type FetchDownloadHooks, type UseDownloadOptions, type UseDownloadReturn, type UseNavigateDownloadOptions, type UseNavigateDownloadReturn, type UseFetchDownloadOptions, type UseFetchDownloadState, type UseFetchDownloadReturn, } from "./use-download";
3
3
  export { useDelete, type UseDeleteOptions, type UseDeleteState, type UseDeleteReturn, } from "./use-delete";
4
4
  export { useObjectUrl, type UseObjectUrlOptions, type UseObjectUrlReturn, } from "./use-object-url";
5
+ export { useObjectList, type UseObjectListOptions, type UseObjectListReturn, type ObjectListFolder, type ObjectListPage, type ObjectListQuery, type ObjectListQueryInput, } from "./use-object-list";
5
6
  export { useRouteUploadPolicy, type CatalogLoadStatus, type UseRouteUploadPolicyOptions, type UseRouteUploadPolicyReturn, } from "./use-route-upload-policy";
6
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC"}
@@ -33,7 +33,10 @@ export type UseDeleteReturn = UseDeleteState & {
33
33
  /** Delete `key` immediately — no confirm step. */
34
34
  remove: (key: string) => Promise<void>;
35
35
  /** Delete several keys via `api.deleteMany`. */
36
- removeMany: (keys: string[]) => Promise<void>;
36
+ removeMany: (keys: string[]) => Promise<{
37
+ deleted: string[];
38
+ failed: string[];
39
+ }>;
37
40
  /** Cancel confirmation and return to `idle`. */
38
41
  cancelDelete: () => void;
39
42
  /** Reset state to `idle`. */
@@ -1 +1 @@
1
- {"version":3,"file":"use-delete.d.ts","sourceRoot":"","sources":["../../src/hooks/use-delete.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKxD,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,kDAAkD;IAClD,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,iFAAiF;IACjF,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gDAAgD;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,gDAAgD;IAChD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAcF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAyNpE"}
1
+ {"version":3,"file":"use-delete.d.ts","sourceRoot":"","sources":["../../src/hooks/use-delete.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKxD,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,kDAAkD;IAClD,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,iFAAiF;IACjF,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gDAAgD;IAChD,UAAU,EAAE,CACV,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtD,gDAAgD;IAChD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAcF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAqOpE"}
@@ -46,11 +46,33 @@ export type UseNavigateDownloadReturn = UseNavigateDownloadState & {
46
46
  isPending: boolean;
47
47
  /** Presign and trigger a native browser download. */
48
48
  download: (key: string, downloadName?: string) => Promise<void>;
49
- /** Fetch the presigned URL without triggering a browser download. */
50
- presign: (key: string, downloadName?: string) => Promise<{
49
+ /**
50
+ * Fetch the presigned URL without triggering a browser download.
51
+ * `expiresIn` requests a shorter TTL. The server clamps it to the route cap.
52
+ */
53
+ presign: (key: string, downloadName?: string, expiresIn?: number) => Promise<{
51
54
  url: string;
52
55
  expiresIn: number;
53
56
  } | null>;
57
+ /**
58
+ * Presign many files without changing `phase` or `objectKey`.
59
+ * A shared single-file control therefore does not react to each key.
60
+ * `expiresIn` on an entry asks for a shorter TTL. The server clamps it.
61
+ * `beforeDownload` rejections and request errors are listed in `failed`.
62
+ * This does not hand the URLs to the browser.
63
+ */
64
+ presignMany: (files: readonly {
65
+ key: string;
66
+ fileName?: string;
67
+ expiresIn?: number;
68
+ }[]) => Promise<{
69
+ signed: {
70
+ key: string;
71
+ url: string;
72
+ expiresIn: number;
73
+ }[];
74
+ failed: string[];
75
+ }>;
54
76
  /** Reset state to `idle`. */
55
77
  reset: () => void;
56
78
  };
@@ -1 +1 @@
1
- {"version":3,"file":"use-download.d.ts","sourceRoot":"","sources":["../../src/hooks/use-download.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"use-download.d.ts","sourceRoot":"","sources":["../../src/hooks/use-download.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ import type { APIError } from "@dimah-s3/core";
2
+ import type { ObjectListFolder, ObjectListUsage, UseObjectListOptions } from "../list/types.js";
3
+ export type { ObjectListFolder, ObjectListPage, ObjectListQuery, ObjectListQueryInput, ObjectListUsage, UseObjectListOptions, } from "../list/types.js";
4
+ /** State and commands returned by {@link useObjectList}. */
5
+ export type UseObjectListReturn<TItem> = {
6
+ items: readonly TItem[];
7
+ /** Child folders from the latest first page. */
8
+ folders: readonly ObjectListFolder[];
9
+ /** Path from the root, root excluded. */
10
+ trail: readonly ObjectListFolder[];
11
+ parent: string | null;
12
+ nextCursor: string | null;
13
+ error: APIError | null;
14
+ /** True while the first page for this folder is in flight. */
15
+ isLoading: boolean;
16
+ /** True while a later page is in flight. */
17
+ isLoadingMore: boolean;
18
+ /** True while the current folder is reloading and previous rows stay visible. */
19
+ isRefreshing: boolean;
20
+ /**
21
+ * Totals from the latest page that sent them. `null` when the source
22
+ * did not.
23
+ */
24
+ usage: ObjectListUsage | null;
25
+ hasMore: boolean;
26
+ loadMore: () => Promise<void>;
27
+ refresh: () => Promise<void>;
28
+ /** Open a child folder and load its first page. */
29
+ openFolder: (folder: ObjectListFolder) => void;
30
+ /** Replace the path. Pass `[]` for the root. */
31
+ navigate: (trail: readonly ObjectListFolder[]) => void;
32
+ };
33
+ /**
34
+ * Page through a folder catalog without knowing the backend.
35
+ *
36
+ * Pass `query`. It receives the current folder id, a cursor, and an abort
37
+ * signal. `dbObjectQuery` from `@dimah-s3/db/client` is one adapter; a
38
+ * route handler or in-memory list is another. The hook never calls S3.
39
+ *
40
+ * ```ts
41
+ * const list = useObjectList({
42
+ * query: ({ parent, cursor, signal }) =>
43
+ * fetchFiles({ folderId: parent, cursor, signal }),
44
+ * queryKey: [route],
45
+ * });
46
+ * ```
47
+ */
48
+ export declare function useObjectList<TItem>(options: UseObjectListOptions<TItem>): UseObjectListReturn<TItem>;
49
+ //# sourceMappingURL=use-object-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-object-list.d.ts","sourceRoot":"","sources":["../../src/hooks/use-object-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EACf,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAKtB,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI;IACvC,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,yCAAyC;IACzC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,YAAY,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,mDAAmD;IACnD,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,gDAAgD;IAChD,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACxD,CAAC;AA+BF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,EACjC,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,GACnC,mBAAmB,CAAC,KAAK,CAAC,CA4N5B"}
package/dist/index.d.ts CHANGED
@@ -18,4 +18,6 @@ export { useDownload, isFetchDownload, type UseDownloadOptions, type UseDownload
18
18
  export { useDelete, type UseDeleteOptions, type UseDeleteState, type UseDeleteReturn, } from "./hooks/use-delete";
19
19
  export { useRouteUploadPolicy, type CatalogLoadStatus, type UseRouteUploadPolicyOptions, type UseRouteUploadPolicyReturn, } from "./hooks/use-route-upload-policy";
20
20
  export { useObjectUrl, type UseObjectUrlOptions, type UseObjectUrlReturn, } from "./hooks/use-object-url";
21
+ export { useObjectList, type UseObjectListOptions, type UseObjectListReturn, type ObjectListFolder, type ObjectListPage, type ObjectListQuery, type ObjectListQueryInput, type ObjectListUsage, } from "./hooks/use-object-list";
22
+ export { readObjectListLevel, type ObjectListLevel, } from "./list/read-object-list-level";
21
23
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGzE,sEAAsE;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGrE,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { createS3Client as createS3Client$1, sha256File, formatFileSize, isAPIError, S3_ERROR_CODES, parseFileName, DELETE_BATCH_MAX_KEYS, isS3ErrorCode, APIError, validateFile } from '@dimah-s3/core';
2
2
  export { APIError, S3_ERROR_CODES, buildContentDisposition, buildObjectKey, buildPublicObjectUrl, fileNameFromKey, formatFileSize, isAPIError, isS3ErrorCode, matchesMagicBytes, sanitizeFileName, sha256Base64, sha256File, sniffContentType, validateFile } from '@dimah-s3/core';
3
- import { createContext, useContext, useCallback, useState, useEffect, useRef, useLayoutEffect } from 'react';
3
+ import { createContext, useContext, useCallback, useState, useEffect, useRef, useMemo, useLayoutEffect } from 'react';
4
4
  import { TranslationProvider, useTranslations } from '@fuma-translate/react';
5
5
  import { jsx } from 'react/jsx-runtime';
6
6
  import { produce } from 'immer';
@@ -1530,7 +1530,7 @@ function useDownload(options) {
1530
1530
  createThrottledSpeedUpdater(createSpeedTracker())
1531
1531
  );
1532
1532
  const requestDownloadUrl = useCallback(
1533
- async (key, downloadName, generation) => {
1533
+ async (key, downloadName, generation, expiresIn) => {
1534
1534
  const opts = optsRef.current;
1535
1535
  const api = opts.api ?? apiRef.current;
1536
1536
  if (!api) throw new Error(missingApiMessage("useDownload"));
@@ -1546,7 +1546,8 @@ function useDownload(options) {
1546
1546
  route: opts.route,
1547
1547
  key,
1548
1548
  fileName: downloadName,
1549
- ...opts.disposition ? { disposition: opts.disposition } : {}
1549
+ ...opts.disposition ? { disposition: opts.disposition } : {},
1550
+ ...expiresIn != null ? { expiresIn } : {}
1550
1551
  });
1551
1552
  if (generation !== generationRef.current) {
1552
1553
  return { url: result.url, expiresIn: result.expiresIn };
@@ -1573,12 +1574,51 @@ function useDownload(options) {
1573
1574
  [apiRef, optsRef, patch]
1574
1575
  );
1575
1576
  const presign = useCallback(
1576
- async (key, downloadName) => {
1577
+ async (key, downloadName, expiresIn) => {
1577
1578
  const generation = ++generationRef.current;
1578
- return requestDownloadUrl(key, downloadName, generation);
1579
+ return requestDownloadUrl(key, downloadName, generation, expiresIn);
1579
1580
  },
1580
1581
  [requestDownloadUrl]
1581
1582
  );
1583
+ const presignMany = useCallback(
1584
+ async (files) => {
1585
+ const signed = [];
1586
+ const failed = [];
1587
+ if (files.length === 0) return { signed, failed };
1588
+ const opts = optsRef.current;
1589
+ const api = opts.api ?? apiRef.current;
1590
+ if (!api) throw new Error(missingApiMessage("useDownload"));
1591
+ for (const file of files) {
1592
+ if (opts.beforeDownload) {
1593
+ const allowed = await opts.beforeDownload(file.key);
1594
+ if (!allowed) {
1595
+ failed.push(file.key);
1596
+ opts.onError?.(file.key, new Error("blocked"));
1597
+ continue;
1598
+ }
1599
+ }
1600
+ try {
1601
+ const result = await api.download({
1602
+ route: opts.route,
1603
+ key: file.key,
1604
+ fileName: file.fileName,
1605
+ ...opts.disposition ? { disposition: opts.disposition } : {},
1606
+ ...file.expiresIn != null ? { expiresIn: file.expiresIn } : {}
1607
+ });
1608
+ signed.push({
1609
+ key: file.key,
1610
+ url: result.url,
1611
+ expiresIn: result.expiresIn
1612
+ });
1613
+ } catch (err) {
1614
+ failed.push(file.key);
1615
+ opts.onError?.(file.key, err);
1616
+ }
1617
+ }
1618
+ return { signed, failed };
1619
+ },
1620
+ [apiRef, optsRef]
1621
+ );
1582
1622
  const downloadNavigate = useCallback(
1583
1623
  async (key, downloadName) => {
1584
1624
  const opts = optsRef.current;
@@ -1783,6 +1823,7 @@ function useDownload(options) {
1783
1823
  isPending: state.phase === "presigning",
1784
1824
  download,
1785
1825
  presign,
1826
+ presignMany,
1786
1827
  reset
1787
1828
  };
1788
1829
  }
@@ -1894,7 +1935,8 @@ function useDelete(options) {
1894
1935
  );
1895
1936
  const removeMany = useCallback(
1896
1937
  async (keys) => {
1897
- if (inFlightRef.current || keys.length === 0) return;
1938
+ const empty = { deleted: [], failed: [] };
1939
+ if (inFlightRef.current || keys.length === 0) return empty;
1898
1940
  const opts = optsRef.current;
1899
1941
  const api = opts.api ?? apiRef.current;
1900
1942
  if (!api)
@@ -1913,21 +1955,24 @@ function useDelete(options) {
1913
1955
  draft.error = null;
1914
1956
  draft.objectKey = null;
1915
1957
  });
1958
+ const deleted = [];
1959
+ const failed = [];
1916
1960
  try {
1917
1961
  const { results } = await api.deleteMany({
1918
1962
  route: opts.route,
1919
1963
  keys
1920
1964
  });
1921
- if (generation !== generationRef.current) return;
1922
- const failed = results.filter((item) => !item.success);
1965
+ if (generation !== generationRef.current) return { deleted, failed };
1923
1966
  for (const item of results) {
1924
1967
  if (item.success) {
1968
+ deleted.push(item.key);
1925
1969
  try {
1926
1970
  await opts.onSuccess?.(item.key);
1927
1971
  } catch (err) {
1928
1972
  opts.onError?.(item.key, err, "success");
1929
1973
  }
1930
1974
  } else {
1975
+ failed.push(item.key);
1931
1976
  opts.onError?.(
1932
1977
  item.key,
1933
1978
  new Error(item.error?.message ?? "Delete failed"),
@@ -1939,23 +1984,30 @@ function useDelete(options) {
1939
1984
  patch((draft) => {
1940
1985
  draft.phase = "error";
1941
1986
  draft.error = toHookError(
1942
- new Error(failed[0]?.error?.message ?? "Delete failed"),
1987
+ new Error(
1988
+ results.find((item) => !item.success)?.error?.message ?? "Delete failed"
1989
+ ),
1943
1990
  "Delete failed"
1944
1991
  );
1945
1992
  });
1946
- return;
1993
+ return { deleted, failed };
1947
1994
  }
1948
1995
  patch((draft) => {
1949
1996
  draft.phase = "success";
1950
1997
  draft.error = null;
1951
1998
  });
1999
+ return { deleted, failed };
1952
2000
  } catch (err) {
1953
- if (generation !== generationRef.current) return;
2001
+ if (generation !== generationRef.current) return { deleted, failed };
1954
2002
  patch((draft) => {
1955
2003
  draft.phase = "error";
1956
2004
  draft.error = toHookError(err, "Delete failed");
1957
2005
  });
1958
2006
  opts.onError?.(keys[0] ?? "", err, "deleting");
2007
+ return {
2008
+ deleted,
2009
+ failed: keys.filter((key) => !deleted.includes(key))
2010
+ };
1959
2011
  } finally {
1960
2012
  if (generation === generationRef.current) {
1961
2013
  inFlightRef.current = false;
@@ -2090,7 +2142,269 @@ function useObjectUrl(options) {
2090
2142
  }, [disposition, fileName, objectKey, route]);
2091
2143
  return { url, expiresIn, error, isLoading, refresh };
2092
2144
  }
2145
+ function serializeQueryKey(key) {
2146
+ return JSON.stringify(key ?? []);
2147
+ }
2148
+ function trailsEqual(a, b) {
2149
+ return a.length === b.length && a.every((folder, index) => {
2150
+ const other = b[index];
2151
+ return other != null && folder.id === other.id && folder.name === other.name;
2152
+ });
2153
+ }
2154
+ function syncTrail(trail, parent) {
2155
+ if (parent == null) return [];
2156
+ const index = trail.findIndex((folder) => folder.id === parent);
2157
+ if (index >= 0) return trail.slice(0, index + 1);
2158
+ return [{ id: parent, name: parent }];
2159
+ }
2160
+ function useObjectList(options) {
2161
+ const optionsRef = useLiveRef(options);
2162
+ const controlled = options.parent !== void 0;
2163
+ const enabled = options.enabled !== false;
2164
+ const queryKey = serializeQueryKey(options.queryKey);
2165
+ const [parentState, setParentState] = useState(() => {
2166
+ if (options.defaultParent !== void 0) return options.defaultParent;
2167
+ return options.defaultTrail?.at(-1)?.id ?? null;
2168
+ });
2169
+ const parent = controlled ? options.parent ?? null : parentState;
2170
+ const [trailState, setTrailState] = useState(
2171
+ () => {
2172
+ const initial = options.defaultTrail ?? [];
2173
+ if (options.parent !== void 0)
2174
+ return syncTrail(initial, options.parent);
2175
+ if (options.defaultParent !== void 0) {
2176
+ return syncTrail(initial, options.defaultParent);
2177
+ }
2178
+ return initial;
2179
+ }
2180
+ );
2181
+ const trail = useMemo(
2182
+ () => controlled ? syncTrail(trailState, parent) : trailState,
2183
+ [controlled, trailState, parent]
2184
+ );
2185
+ const [items, setItems] = useState([]);
2186
+ const [folders, setFolders] = useState([]);
2187
+ const [nextCursor, setNextCursor] = useState(null);
2188
+ const [usage, setUsage] = useState(null);
2189
+ const [error, setError] = useState(null);
2190
+ const [status, setStatus] = useState(enabled ? "loading" : "ready");
2191
+ const parentRef = useLiveRef(parent);
2192
+ const trailRef = useLiveRef(trail);
2193
+ const cursorRef = useLiveRef(nextCursor);
2194
+ const statusRef = useLiveRef(status);
2195
+ const itemsRef = useLiveRef(items);
2196
+ const foldersRef = useLiveRef(folders);
2197
+ const abortRef = useRef(null);
2198
+ const generationRef = useRef(0);
2199
+ const applyPage = useCallback(
2200
+ (page, mode) => {
2201
+ if (mode === "append") {
2202
+ setItems((current) => [...current, ...page.items]);
2203
+ if (page.usage) setUsage(page.usage);
2204
+ } else {
2205
+ setItems(page.items);
2206
+ setFolders(page.folders ?? []);
2207
+ setUsage(page.usage ?? null);
2208
+ }
2209
+ const cursor = page.nextCursor ? page.nextCursor : null;
2210
+ cursorRef.current = cursor;
2211
+ statusRef.current = "ready";
2212
+ setNextCursor(cursor);
2213
+ setError(null);
2214
+ setStatus("ready");
2215
+ },
2216
+ [cursorRef, statusRef]
2217
+ );
2218
+ const run = useCallback(
2219
+ async (mode) => {
2220
+ if (optionsRef.current.enabled === false) return;
2221
+ const cursor = mode === "append" ? cursorRef.current : null;
2222
+ if (mode === "append") {
2223
+ if (!cursor) return;
2224
+ const current = statusRef.current;
2225
+ if (current === "loading" || current === "loading-more" || current === "refreshing") {
2226
+ return;
2227
+ }
2228
+ }
2229
+ abortRef.current?.abort();
2230
+ const controller = new AbortController();
2231
+ abortRef.current = controller;
2232
+ const generation = ++generationRef.current;
2233
+ const requestParent = parentRef.current;
2234
+ const hasRows = itemsRef.current.length > 0 || foldersRef.current.length > 0;
2235
+ if (mode === "replace") {
2236
+ setItems([]);
2237
+ setFolders([]);
2238
+ setNextCursor(null);
2239
+ setError(null);
2240
+ statusRef.current = "loading";
2241
+ setStatus("loading");
2242
+ } else if (mode === "refresh") {
2243
+ setError(null);
2244
+ const nextStatus = hasRows ? "refreshing" : "loading";
2245
+ statusRef.current = nextStatus;
2246
+ setStatus(nextStatus);
2247
+ } else {
2248
+ statusRef.current = "loading-more";
2249
+ setStatus("loading-more");
2250
+ }
2251
+ try {
2252
+ const page = await optionsRef.current.query({
2253
+ parent: requestParent,
2254
+ cursor,
2255
+ signal: controller.signal
2256
+ });
2257
+ if (generation !== generationRef.current || controller.signal.aborted) {
2258
+ return;
2259
+ }
2260
+ applyPage(page, mode);
2261
+ } catch (err) {
2262
+ if (generation !== generationRef.current || controller.signal.aborted || isAbortError(err)) {
2263
+ return;
2264
+ }
2265
+ setError(toHookError(err, "Could not load files"));
2266
+ statusRef.current = "error";
2267
+ setStatus("error");
2268
+ }
2269
+ },
2270
+ [
2271
+ abortRef,
2272
+ applyPage,
2273
+ cursorRef,
2274
+ foldersRef,
2275
+ generationRef,
2276
+ itemsRef,
2277
+ optionsRef,
2278
+ parentRef,
2279
+ statusRef
2280
+ ]
2281
+ );
2282
+ useEffect(() => {
2283
+ if (!enabled) {
2284
+ abortRef.current?.abort();
2285
+ return;
2286
+ }
2287
+ let active = true;
2288
+ void (async () => {
2289
+ await Promise.resolve();
2290
+ if (!active) return;
2291
+ await run("replace");
2292
+ })();
2293
+ return () => {
2294
+ active = false;
2295
+ abortRef.current?.abort();
2296
+ };
2297
+ }, [abortRef, enabled, parent, queryKey, run]);
2298
+ const navigate = useCallback(
2299
+ (nextTrail) => {
2300
+ const nextParent = nextTrail.at(-1)?.id ?? null;
2301
+ if (nextParent === parentRef.current && trailsEqual(nextTrail, trailRef.current)) {
2302
+ return;
2303
+ }
2304
+ const previousParent = parentRef.current;
2305
+ trailRef.current = nextTrail;
2306
+ setTrailState(nextTrail);
2307
+ if (optionsRef.current.parent === void 0) {
2308
+ parentRef.current = nextParent;
2309
+ setParentState(nextParent);
2310
+ }
2311
+ if (nextParent !== previousParent) {
2312
+ cursorRef.current = null;
2313
+ setItems([]);
2314
+ setFolders([]);
2315
+ setNextCursor(null);
2316
+ setError(null);
2317
+ statusRef.current = "loading";
2318
+ setStatus("loading");
2319
+ }
2320
+ optionsRef.current.onParentChange?.(nextParent);
2321
+ },
2322
+ [cursorRef, optionsRef, parentRef, statusRef, trailRef]
2323
+ );
2324
+ const openFolder = useCallback(
2325
+ (folder) => {
2326
+ const current = trailRef.current;
2327
+ const index = current.findIndex((entry) => entry.id === folder.id);
2328
+ const next = index >= 0 ? current.slice(0, index + 1) : [...current, folder];
2329
+ navigate(next);
2330
+ },
2331
+ [navigate, trailRef]
2332
+ );
2333
+ const loadMore = useCallback(() => run("append"), [run]);
2334
+ const refresh = useCallback(() => run("refresh"), [run]);
2335
+ return {
2336
+ items,
2337
+ folders,
2338
+ trail,
2339
+ parent,
2340
+ nextCursor,
2341
+ error,
2342
+ isLoading: enabled && status === "loading",
2343
+ isLoadingMore: enabled && status === "loading-more",
2344
+ isRefreshing: enabled && status === "refreshing",
2345
+ usage,
2346
+ hasMore: nextCursor != null,
2347
+ loadMore,
2348
+ refresh,
2349
+ openFolder,
2350
+ navigate
2351
+ };
2352
+ }
2353
+
2354
+ // src/list/read-object-list-level.ts
2355
+ function readObjectListLevel(records, input) {
2356
+ const parent = normalizeFolder(input.parent);
2357
+ const folders = /* @__PURE__ */ new Map();
2358
+ const items = [];
2359
+ for (const record of records) {
2360
+ const folder = normalizeFolder(input.getFolder(record));
2361
+ if (parent == null) {
2362
+ if (folder == null) {
2363
+ items.push(record);
2364
+ continue;
2365
+ }
2366
+ const name2 = folder.split("/")[0];
2367
+ if (!name2) continue;
2368
+ folders.set(name2, { id: name2, name: name2 });
2369
+ continue;
2370
+ }
2371
+ if (folder == null) continue;
2372
+ if (folder === parent) {
2373
+ items.push(record);
2374
+ continue;
2375
+ }
2376
+ const prefix = `${parent}/`;
2377
+ if (!folder.startsWith(prefix)) continue;
2378
+ const name = folder.slice(prefix.length).split("/")[0];
2379
+ if (!name) continue;
2380
+ const id = `${parent}/${name}`;
2381
+ folders.set(id, { id, name });
2382
+ }
2383
+ return {
2384
+ folders: [...folders.values()].sort(
2385
+ (a, b) => a.name.localeCompare(b.name, void 0, {
2386
+ numeric: true,
2387
+ sensitivity: "base"
2388
+ })
2389
+ ),
2390
+ items
2391
+ };
2392
+ }
2393
+ function normalizeFolder(folder) {
2394
+ if (folder == null) return null;
2395
+ const parts = [];
2396
+ for (const raw of folder.split("/")) {
2397
+ const part = raw.trim();
2398
+ if (!part || part === ".") continue;
2399
+ if (part === "..") {
2400
+ parts.pop();
2401
+ continue;
2402
+ }
2403
+ parts.push(part);
2404
+ }
2405
+ return parts.length > 0 ? parts.join("/") : null;
2406
+ }
2093
2407
 
2094
- export { DEFAULT_MULTIPART_THRESHOLD, S3Provider, S3UploadError, createLocalStorageStore, createMemoryStore, createS3Client, defineApi, formatAcceptLabels, formatEta, formatSpeed, formatUploadProgress, isFetchDownload, loadRouteCatalog, mergeRouteUploadPolicy, multipartResumeKey, resolveRouteUploadPolicy, uploadFile, uploadFiles, useApi, useDelete, useDownload, useFormatDimahError, useFormatValidateFileError, useObjectUrl, useRouteUploadPolicy, useUpload };
2408
+ export { DEFAULT_MULTIPART_THRESHOLD, S3Provider, S3UploadError, createLocalStorageStore, createMemoryStore, createS3Client, defineApi, formatAcceptLabels, formatEta, formatSpeed, formatUploadProgress, isFetchDownload, loadRouteCatalog, mergeRouteUploadPolicy, multipartResumeKey, readObjectListLevel, resolveRouteUploadPolicy, uploadFile, uploadFiles, useApi, useDelete, useDownload, useFormatDimahError, useFormatValidateFileError, useObjectList, useObjectUrl, useRouteUploadPolicy, useUpload };
2095
2409
  //# sourceMappingURL=index.js.map
2096
2410
  //# sourceMappingURL=index.js.map