@dimah-s3/react 0.6.2 → 0.7.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 +5 -2
- package/dist/helpers/file-preview.d.ts +5 -0
- package/dist/helpers/file-preview.d.ts.map +1 -0
- package/dist/helpers/index.d.ts +2 -0
- package/dist/helpers/index.d.ts.map +1 -1
- package/dist/helpers/to-dropzone-accept.d.ts +16 -0
- package/dist/helpers/to-dropzone-accept.d.ts.map +1 -0
- package/dist/hooks/index.d.ts +5 -4
- package/dist/hooks/index.d.ts.map +1 -1
- package/dist/hooks/use-delete.d.ts.map +1 -1
- package/dist/hooks/use-download.d.ts.map +1 -1
- package/dist/hooks/use-fetch-download.d.ts.map +1 -1
- package/dist/hooks/use-file-intake.d.ts +46 -0
- package/dist/hooks/use-file-intake.d.ts.map +1 -0
- package/dist/hooks/use-file-upload.d.ts +76 -0
- package/dist/hooks/use-file-upload.d.ts.map +1 -0
- package/dist/hooks/use-multi-file-upload.d.ts +39 -0
- package/dist/hooks/use-multi-file-upload.d.ts.map +1 -0
- package/dist/hooks/use-multi-upload.d.ts +44 -22
- package/dist/hooks/use-multi-upload.d.ts.map +1 -1
- package/dist/hooks/use-upload.d.ts +51 -67
- package/dist/hooks/use-upload.d.ts.map +1 -1
- package/dist/index.d.ts +6 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +503 -247
- package/dist/index.js.map +1 -1
- package/dist/store/create-hook-store.d.ts +48 -0
- package/dist/store/create-hook-store.d.ts.map +1 -0
- package/dist/store/memory-store.d.ts +1 -1
- package/dist/translations/types.d.ts +1 -5
- package/dist/translations/types.d.ts.map +1 -1
- package/dist/types/multi-upload.d.ts +7 -0
- package/dist/types/multi-upload.d.ts.map +1 -1
- package/dist/types/upload.d.ts +15 -1
- package/dist/types/upload.d.ts.map +1 -1
- package/package.json +6 -3
- package/dist/hooks/use-multi-upload-controls.d.ts +0 -45
- package/dist/hooks/use-multi-upload-controls.d.ts.map +0 -1
- package/dist/hooks/use-upload-controls.d.ts +0 -54
- package/dist/hooks/use-upload-controls.d.ts.map +0 -1
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { type Draft } from "immer";
|
|
2
|
+
import { type StoreApi } from "zustand/vanilla";
|
|
3
|
+
/**
|
|
4
|
+
* Per-instance Zustand store API.
|
|
5
|
+
*
|
|
6
|
+
* @internal
|
|
7
|
+
*/
|
|
8
|
+
export type HookStore<T> = StoreApi<T>;
|
|
9
|
+
/**
|
|
10
|
+
* Create a per-instance vanilla Zustand store.
|
|
11
|
+
*
|
|
12
|
+
* @internal — used by stateful hooks; not a public app-wide store.
|
|
13
|
+
*/
|
|
14
|
+
export declare function createHookStore<T extends object>(initialState: T): HookStore<T>;
|
|
15
|
+
/**
|
|
16
|
+
* Lazily create one store per hook instance (survives re-renders).
|
|
17
|
+
*
|
|
18
|
+
* @internal
|
|
19
|
+
*/
|
|
20
|
+
export declare function useHookStoreInstance<T extends object>(initialState: T): HookStore<T>;
|
|
21
|
+
/**
|
|
22
|
+
* Subscribe to a per-instance store with a selector.
|
|
23
|
+
*
|
|
24
|
+
* @internal
|
|
25
|
+
*/
|
|
26
|
+
export declare function useHookStore<T, U>(store: HookStore<T>, selector: (state: T) => U): U;
|
|
27
|
+
/**
|
|
28
|
+
* Subscribe to multiple store fields with shallow equality.
|
|
29
|
+
* Prefer this over selecting the whole state object so unchanged slices
|
|
30
|
+
* (via Immer structural sharing) skip re-renders.
|
|
31
|
+
*
|
|
32
|
+
* @internal
|
|
33
|
+
*/
|
|
34
|
+
export declare function useHookStoreShallow<T extends object, U extends object>(store: HookStore<T>, selector: (state: T) => U): U;
|
|
35
|
+
/**
|
|
36
|
+
* Apply an Immer recipe to the store state.
|
|
37
|
+
*
|
|
38
|
+
* @internal
|
|
39
|
+
*/
|
|
40
|
+
export declare function patchHookState<T extends object>(store: HookStore<T>, recipe: (draft: Draft<T>) => void): void;
|
|
41
|
+
/**
|
|
42
|
+
* Replace the entire store state with a fresh clone of `next`.
|
|
43
|
+
* Avoids Immer freeze issues when reusing module-level INITIAL constants.
|
|
44
|
+
*
|
|
45
|
+
* @internal
|
|
46
|
+
*/
|
|
47
|
+
export declare function replaceHookState<T extends object>(store: HookStore<T>, next: T): void;
|
|
48
|
+
//# sourceMappingURL=create-hook-store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-hook-store.d.ts","sourceRoot":"","sources":["../../src/store/create-hook-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,YAAY,EAAE,CAAC,GACd,SAAS,CAAC,CAAC,CAAC,CAEd;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,YAAY,EAAE,CAAC,GACd,SAAS,CAAC,CAAC,CAAC,CAGd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GACxB,CAAC,CAEH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACpE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GACxB,CAAC,CAEH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAChC,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC,GACN,IAAI,CAEN"}
|
|
@@ -8,7 +8,7 @@ import type { UploadStore } from "../types/upload-store";
|
|
|
8
8
|
* @example
|
|
9
9
|
* ```ts
|
|
10
10
|
* const store = createMemoryStore();
|
|
11
|
-
*
|
|
11
|
+
* useFileUpload({ api, uploadStore: store });
|
|
12
12
|
* ```
|
|
13
13
|
*/
|
|
14
14
|
export declare function createMemoryStore(): UploadStore;
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
export type Translations = {
|
|
2
2
|
"\"{name}\" deleted(status)": string;
|
|
3
|
-
"Accepted {types}.(dropzone hint)": string;
|
|
4
3
|
"Access denied(API error)": string;
|
|
5
4
|
"All {count} file(s) uploaded(status)": string;
|
|
6
5
|
"Are you sure you want to delete \"{name}\"? This action cannot be undone.(dialog description)": string;
|
|
@@ -24,9 +23,9 @@ export type Translations = {
|
|
|
24
23
|
"Download started(toast)": string;
|
|
25
24
|
"Download(button)": string;
|
|
26
25
|
"Drag and drop files here(dropzone)": string;
|
|
27
|
-
"Each up to {size}(dropzone hint)": string;
|
|
28
26
|
"File deleted(toast)": string;
|
|
29
27
|
"File is empty(file validation)": string;
|
|
28
|
+
"File not accepted(toast)": string;
|
|
30
29
|
"File not found(API error)": string;
|
|
31
30
|
"File size exceeds {size} limit(file validation)": string;
|
|
32
31
|
"File size is required(multipart)": string;
|
|
@@ -40,7 +39,6 @@ export type Translations = {
|
|
|
40
39
|
"Preparing…(upload status)": string;
|
|
41
40
|
"Something went wrong(API error)": string;
|
|
42
41
|
"Unknown error(fallback)": string;
|
|
43
|
-
"Up to {size}(dropzone hint)": string;
|
|
44
42
|
"Upload ID is required(API error)": string;
|
|
45
43
|
"Upload complete(toast)": string;
|
|
46
44
|
"Upload failed(status)": string;
|
|
@@ -51,8 +49,6 @@ export type Translations = {
|
|
|
51
49
|
"Uploading {done}/{total}(toast)": string;
|
|
52
50
|
"Uploading(toast)": string;
|
|
53
51
|
"Validating…(upload status)": string;
|
|
54
|
-
"You can upload a file(dropzone hint)": string;
|
|
55
|
-
"You can upload {count} files(dropzone hint)": string;
|
|
56
52
|
"{count} file(s) uploaded(toast)": string;
|
|
57
53
|
"{done}/{total} files(upload progress)": string;
|
|
58
54
|
"{name} is required(API error)": string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/translations/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,4BAA4B,EAAE,MAAM,CAAC;IACrC,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/translations/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,4BAA4B,EAAE,MAAM,CAAC;IACrC,0BAA0B,EAAE,MAAM,CAAC;IACnC,sCAAsC,EAAE,MAAM,CAAC;IAC/C,+FAA+F,EAAE,MAAM,CAAC;IACxG,iDAAiD,EAAE,MAAM,CAAC;IAC1D,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,6CAA6C,EAAE,MAAM,CAAC;IACtD,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oCAAoC,EAAE,MAAM,CAAC;IAC7C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gCAAgC,EAAE,MAAM,CAAC;IACzC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,iDAAiD,EAAE,MAAM,CAAC;IAC1D,kCAAkC,EAAE,MAAM,CAAC;IAC3C,+BAA+B,EAAE,MAAM,CAAC;IACxC,sDAAsD,EAAE,MAAM,CAAC;IAC/D,4BAA4B,EAAE,MAAM,CAAC;IACrC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mCAAmC,EAAE,MAAM,CAAC;IAC5C,mDAAmD,EAAE,MAAM,CAAC;IAC5D,uBAAuB,EAAE,MAAM,CAAC;IAChC,2BAA2B,EAAE,MAAM,CAAC;IACpC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,yBAAyB,EAAE,MAAM,CAAC;IAClC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oCAAoC,EAAE,MAAM,CAAC;IAC7C,iCAAiC,EAAE,MAAM,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4BAA4B,EAAE,MAAM,CAAC;IACrC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,uCAAuC,EAAE,MAAM,CAAC;IAChD,+BAA+B,EAAE,MAAM,CAAC;IACxC,+CAA+C,EAAE,MAAM,CAAC;CACzD,CAAC"}
|
|
@@ -8,6 +8,13 @@ export type MultiUploadFileState = {
|
|
|
8
8
|
fileName: string;
|
|
9
9
|
/** File size in bytes. */
|
|
10
10
|
fileSize: number;
|
|
11
|
+
/** MIME type from the browser `File`. */
|
|
12
|
+
fileType: string;
|
|
13
|
+
/**
|
|
14
|
+
* Object URL for an image thumbnail, or `null` for non-images.
|
|
15
|
+
* Kept through success; revoked when the batch is cleared.
|
|
16
|
+
*/
|
|
17
|
+
previewUrl: string | null;
|
|
11
18
|
status: "pending" | "uploading" | "success" | "error";
|
|
12
19
|
progress: UploadProgress;
|
|
13
20
|
error: string | null;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"multi-upload.d.ts","sourceRoot":"","sources":["../../src/types/multi-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAC1B,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACxC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC"}
|
|
1
|
+
{"version":3,"file":"multi-upload.d.ts","sourceRoot":"","sources":["../../src/types/multi-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAC1B,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACxC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC"}
|
package/dist/types/upload.d.ts
CHANGED
|
@@ -18,6 +18,20 @@ export type UploadProgress = {
|
|
|
18
18
|
speed?: number;
|
|
19
19
|
};
|
|
20
20
|
export type UploadPhase = "idle" | "validating" | "presigning" | "uploading" | "finalizing" | "success" | "error";
|
|
21
|
+
/** Display metadata for a file in upload UI (no raw `File`). */
|
|
22
|
+
export type UploadFileInfo = {
|
|
23
|
+
/** Display file name. */
|
|
24
|
+
name: string;
|
|
25
|
+
/** File size in bytes. */
|
|
26
|
+
size: number;
|
|
27
|
+
/** MIME type from the browser `File`. */
|
|
28
|
+
type: string;
|
|
29
|
+
/**
|
|
30
|
+
* Object URL for an image thumbnail, or `null` for non-images.
|
|
31
|
+
* Created/revoked by upload hooks — do not revoke manually while hooks own it.
|
|
32
|
+
*/
|
|
33
|
+
previewUrl: string | null;
|
|
34
|
+
};
|
|
21
35
|
/** Per-upload options passed to the presign API. */
|
|
22
36
|
export type UploadRequestOptions = {
|
|
23
37
|
/** Custom S3 object metadata (`x-amz-meta-*`). */
|
|
@@ -66,7 +80,7 @@ export type RetryConfig = {
|
|
|
66
80
|
/** Base delay in ms for exponential backoff. @default 1000 */
|
|
67
81
|
baseDelay?: number;
|
|
68
82
|
};
|
|
69
|
-
/** Upload engine configuration for `
|
|
83
|
+
/** Upload engine configuration for `useFileUpload` and `useMultiFileUpload`. */
|
|
70
84
|
export type UploadConfig = {
|
|
71
85
|
/** Enable multipart uploads for large files. */
|
|
72
86
|
multipart?: boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG;IACzB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG;IAC3B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,SAAS,GACT,OAAO,CAAC;AAEZ,oDAAoD;AACpD,MAAM,MAAM,oBAAoB,GAAG;IACjC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG;IACxB,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1D,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5D,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,0EAA0E;IAC1E,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1E,yDAAyD;IACzD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG;IACxB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,
|
|
1
|
+
{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dimah-s3/react",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"description": "React hooks for S3-compatible file uploads, downloads, and deletes",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"s3",
|
|
@@ -34,7 +34,10 @@
|
|
|
34
34
|
],
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@fuma-translate/react": "^1.0.2",
|
|
37
|
-
"
|
|
37
|
+
"immer": "^11.1.16",
|
|
38
|
+
"react-dropzone": "^20.1.0",
|
|
39
|
+
"zustand": "^5.0.14",
|
|
40
|
+
"@dimah-s3/core": "0.7.0"
|
|
38
41
|
},
|
|
39
42
|
"peerDependencies": {
|
|
40
43
|
"@fuma-translate/react": "^1.0.2",
|
|
@@ -43,7 +46,7 @@
|
|
|
43
46
|
"devDependencies": {
|
|
44
47
|
"@types/react": "^19.2.18",
|
|
45
48
|
"@types/react-dom": "^19.2.4",
|
|
46
|
-
"eslint": "^10.8.
|
|
49
|
+
"eslint": "^10.8.1",
|
|
47
50
|
"fuma-translate": "^1.0.2",
|
|
48
51
|
"jsdom": "^30.0.1",
|
|
49
52
|
"react": "^19.2.8",
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
import type { UploadProgress, MultiUploadFileState, MultiUploadPhase } from "../types";
|
|
2
|
-
import { type UseMultiUploadOptions } from "./use-multi-upload";
|
|
3
|
-
/** Options for {@link useMultiUploadControls}. */
|
|
4
|
-
export type UseMultiUploadControlsOptions = UseMultiUploadOptions & {
|
|
5
|
-
/** S3 object key, or a function that derives it from each file. */
|
|
6
|
-
objectKey: string | ((file: File) => string);
|
|
7
|
-
};
|
|
8
|
-
export type UseMultiUploadControlsReturn = {
|
|
9
|
-
/** Current batch upload phase. */
|
|
10
|
-
phase: MultiUploadPhase;
|
|
11
|
-
/** Per-file upload states. */
|
|
12
|
-
files: MultiUploadFileState[];
|
|
13
|
-
/** Aggregated progress across all files. */
|
|
14
|
-
totalProgress: UploadProgress;
|
|
15
|
-
/** Batch-level error message, or `null`. */
|
|
16
|
-
error: string | null;
|
|
17
|
-
/** `true` while uploading. */
|
|
18
|
-
isUploading: boolean;
|
|
19
|
-
/** Handle files from drag-and-drop or a file input. */
|
|
20
|
-
handleFiles: (files: FileList | null) => void;
|
|
21
|
-
/** Open the hidden file picker. */
|
|
22
|
-
openFilePicker: () => void;
|
|
23
|
-
/** Abort all in-flight uploads. */
|
|
24
|
-
cancel: () => void;
|
|
25
|
-
/** Preserve multipart store entries for resume. */
|
|
26
|
-
detach: () => void;
|
|
27
|
-
/** Reset state to `idle`. */
|
|
28
|
-
reset: () => void;
|
|
29
|
-
/** Spread on a hidden `<input>` element. */
|
|
30
|
-
inputProps: {
|
|
31
|
-
ref: React.RefObject<HTMLInputElement | null>;
|
|
32
|
-
type: "file";
|
|
33
|
-
multiple: true;
|
|
34
|
-
accept?: string;
|
|
35
|
-
hidden: true;
|
|
36
|
-
onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
|
|
37
|
-
};
|
|
38
|
-
/** Spread on a container to enable drag-and-drop. */
|
|
39
|
-
dropHandlers: {
|
|
40
|
-
onDragOver: (e: React.DragEvent) => void;
|
|
41
|
-
onDrop: (e: React.DragEvent) => void;
|
|
42
|
-
};
|
|
43
|
-
};
|
|
44
|
-
export declare function useMultiUploadControls(options: UseMultiUploadControlsOptions): UseMultiUploadControlsReturn;
|
|
45
|
-
//# sourceMappingURL=use-multi-upload-controls.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"use-multi-upload-controls.d.ts","sourceRoot":"","sources":["../../src/hooks/use-multi-upload-controls.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG;IAClE,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,kCAAkC;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,8BAA8B;IAC9B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,aAAa,EAAE,cAAc,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,mCAAmC;IACnC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4CAA4C;IAC5C,UAAU,EAAE;QACV,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,IAAI,CAAC;QACb,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;KAC5D,CAAC;IACF,qDAAqD;IACrD,YAAY,EAAE;QACZ,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;QACzC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;KACtC,CAAC;CACH,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAgD9B"}
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
import type { UploadPhase, UploadProgress, UploadRequestOptions } from "../types";
|
|
2
|
-
import { type UseUploadOptions } from "./use-upload";
|
|
3
|
-
/** Options for {@link useUploadControls}. */
|
|
4
|
-
export type UseUploadControlsOptions = UseUploadOptions & {
|
|
5
|
-
/** S3 object key, or a function that derives it from the file. */
|
|
6
|
-
objectKey: string | ((file: File) => string);
|
|
7
|
-
/** Static request options applied to the upload. */
|
|
8
|
-
uploadOptions?: UploadRequestOptions;
|
|
9
|
-
/** Per-upload request options override. */
|
|
10
|
-
getUploadOptions?: (file: File) => UploadRequestOptions;
|
|
11
|
-
};
|
|
12
|
-
export type UseUploadControlsReturn = {
|
|
13
|
-
/** Current upload phase. */
|
|
14
|
-
phase: UploadPhase;
|
|
15
|
-
/** Info about the selected file. */
|
|
16
|
-
fileInfo: {
|
|
17
|
-
name: string;
|
|
18
|
-
size: number;
|
|
19
|
-
} | null;
|
|
20
|
-
/** Byte transfer progress. */
|
|
21
|
-
progress: UploadProgress;
|
|
22
|
-
/** Error message, or `null`. */
|
|
23
|
-
error: string | null;
|
|
24
|
-
/** `true` while uploading. */
|
|
25
|
-
isUploading: boolean;
|
|
26
|
-
/** Handle files from drag-and-drop or a file input. */
|
|
27
|
-
handleFiles: (files: FileList | null) => void;
|
|
28
|
-
/** Open the hidden file picker. */
|
|
29
|
-
openFilePicker: () => void;
|
|
30
|
-
/** Abort and reset to idle. */
|
|
31
|
-
cancel: () => void;
|
|
32
|
-
/**
|
|
33
|
-
* Soft-stop: preserves S3 parts and store entry so a future `upload()` can
|
|
34
|
-
* resume. For non-resumable uploads, identical to `cancel()`.
|
|
35
|
-
* See `UseUploadReturn.detach` for full semantics.
|
|
36
|
-
*/
|
|
37
|
-
detach: () => void;
|
|
38
|
-
reset: () => void;
|
|
39
|
-
/** Spread on a hidden `<input>` element. */
|
|
40
|
-
inputProps: {
|
|
41
|
-
ref: React.RefObject<HTMLInputElement | null>;
|
|
42
|
-
type: "file";
|
|
43
|
-
accept?: string;
|
|
44
|
-
hidden: true;
|
|
45
|
-
onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
|
|
46
|
-
};
|
|
47
|
-
/** Spread on a container to enable drag-and-drop. */
|
|
48
|
-
dropHandlers: {
|
|
49
|
-
onDragOver: (e: React.DragEvent) => void;
|
|
50
|
-
onDrop: (e: React.DragEvent) => void;
|
|
51
|
-
};
|
|
52
|
-
};
|
|
53
|
-
export declare function useUploadControls(options: UseUploadControlsOptions): UseUploadControlsReturn;
|
|
54
|
-
//# sourceMappingURL=use-upload-controls.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"use-upload-controls.d.ts","sourceRoot":"","sources":["../../src/hooks/use-upload-controls.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG;IACxD,kEAAkE;IAClE,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;IAC7C,oDAAoD;IACpD,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,oBAAoB,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,mCAAmC;IACnC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4CAA4C;IAC5C,UAAU,EAAE;QACV,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,IAAI,CAAC;QACb,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;KAC5D,CAAC;IACF,qDAAqD;IACrD,YAAY,EAAE;QACZ,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;QACzC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;KACtC,CAAC;CACH,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CA2DzB"}
|