@dimah-s3/react 0.7.3 → 0.8.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.
Files changed (40) hide show
  1. package/README.md +2 -3
  2. package/dist/create-s3-client.d.ts +15 -14
  3. package/dist/create-s3-client.d.ts.map +1 -1
  4. package/dist/helpers/format-dimah-error.d.ts.map +1 -1
  5. package/dist/hooks/index.d.ts +1 -2
  6. package/dist/hooks/index.d.ts.map +1 -1
  7. package/dist/hooks/use-delete.d.ts +3 -3
  8. package/dist/hooks/use-delete.d.ts.map +1 -1
  9. package/dist/hooks/use-download.d.ts +48 -10
  10. package/dist/hooks/use-download.d.ts.map +1 -1
  11. package/dist/hooks/use-file-upload.d.ts +3 -2
  12. package/dist/hooks/use-file-upload.d.ts.map +1 -1
  13. package/dist/hooks/use-multi-file-upload.d.ts +3 -2
  14. package/dist/hooks/use-multi-file-upload.d.ts.map +1 -1
  15. package/dist/hooks/use-multi-upload.d.ts +4 -3
  16. package/dist/hooks/use-multi-upload.d.ts.map +1 -1
  17. package/dist/hooks/use-upload.d.ts +4 -3
  18. package/dist/hooks/use-upload.d.ts.map +1 -1
  19. package/dist/index.d.ts +4 -4
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +191 -165
  22. package/dist/index.js.map +1 -1
  23. package/dist/s3-provider.d.ts +5 -10
  24. package/dist/s3-provider.d.ts.map +1 -1
  25. package/dist/translations/types.d.ts +5 -5
  26. package/dist/translations/types.d.ts.map +1 -1
  27. package/dist/types/error.d.ts +10 -12
  28. package/dist/types/error.d.ts.map +1 -1
  29. package/dist/types/multi-upload.d.ts +3 -2
  30. package/dist/types/multi-upload.d.ts.map +1 -1
  31. package/dist/upload/upload-file.d.ts.map +1 -1
  32. package/dist/upload/upload-files.d.ts +3 -3
  33. package/dist/upload/upload-files.d.ts.map +1 -1
  34. package/package.json +4 -4
  35. package/dist/helpers/format-dimah-error.test.d.ts +0 -2
  36. package/dist/helpers/format-dimah-error.test.d.ts.map +0 -1
  37. package/dist/helpers/helpers.test.d.ts +0 -2
  38. package/dist/helpers/helpers.test.d.ts.map +0 -1
  39. package/dist/hooks/use-fetch-download.d.ts +0 -33
  40. package/dist/hooks/use-fetch-download.d.ts.map +0 -1
package/README.md CHANGED
@@ -16,14 +16,13 @@ pnpm add @dimah-s3/react
16
16
  ```tsx
17
17
  import { createS3Client, useUpload } from "@dimah-s3/react";
18
18
 
19
- export const { api, S3Provider, useApi } = createS3Client();
19
+ export const s3Client = createS3Client();
20
20
 
21
21
  // App root
22
- <S3Provider>{children}</S3Provider>;
22
+ <s3Client.Provider>{children}</s3Client.Provider>;
23
23
 
24
24
  // In a component
25
25
  const { open, getInputProps } = useUpload({
26
- objectKey: (file) => `uploads/${file.name}`,
27
26
  noDrag: true,
28
27
  noClick: true,
29
28
  noKeyboard: true,
@@ -1,34 +1,35 @@
1
- import { type CreateS3ClientOptions, type S3Api, type S3ClientPlugin, type ClientPluginMethodsMap } from "@dimah-s3/core";
2
- import type { ReactNode } from "react";
1
+ import { type CreateS3ClientOptions, type CreateS3ClientResult, type S3ClientPlugin } from "@dimah-s3/core";
2
+ import type { ComponentType, ReactNode } from "react";
3
3
  import { type S3ProviderProps } from "./s3-provider";
4
4
  type BoundProviderProps = Omit<S3ProviderProps, "api"> & {
5
5
  children: ReactNode;
6
6
  };
7
+ export type ReactS3Client<P extends readonly S3ClientPlugin[] = []> = CreateS3ClientResult<P> & {
8
+ Provider: ComponentType<BoundProviderProps>;
9
+ useApi: () => CreateS3ClientResult<P>;
10
+ };
7
11
  /**
8
12
  * Create a typed S3 browser client — Better Auth–style one-shot setup.
9
13
  *
10
- * Returns the `api` singleton plus a bound `S3Provider` / `useApi` so plugin
11
- * methods stay typed without generics on every call.
14
+ * The returned object *is* the API (`s3Client.download(key)`), plus a bound
15
+ * `Provider` / `useApi` so plugin methods stay typed without generics.
12
16
  *
13
17
  * ```ts
14
18
  * import { createS3Client } from "@dimah-s3/react";
15
19
  * import { dbClient } from "@dimah-s3/db/client";
16
20
  *
17
- * export const { api, S3Provider, useApi } = createS3Client({
21
+ * export const s3Client = createS3Client({
18
22
  * basePath: "/api/s3",
19
23
  * plugins: [dbClient()],
20
24
  * });
21
25
  *
22
- * await api.db.listObjects();
26
+ * await s3Client.db.listObjects();
23
27
  *
24
- * const api = useApi(); // includes .db
25
- * <S3Provider>{children}</S3Provider>
28
+ * const api = s3Client.useApi(); // includes .db
29
+ * // Vite / Hono: <s3Client.Provider>
30
+ * // Next.js: export const S3Provider = s3Client.Provider
26
31
  * ```
27
32
  */
28
- export declare function createS3Client<const P extends readonly S3ClientPlugin[] = []>(options?: CreateS3ClientOptions<P>): {
29
- api: S3Api & ClientPluginMethodsMap<P>;
30
- S3Provider: (props: BoundProviderProps) => import("react").JSX.Element;
31
- useApi: () => S3Api & ClientPluginMethodsMap<P>;
32
- };
33
- export type { CreateS3ClientOptions };
33
+ export declare function createS3Client<const P extends readonly S3ClientPlugin[] = []>(options?: CreateS3ClientOptions<P>): ReactS3Client<P>;
34
+ export type { CreateS3ClientOptions, CreateS3ClientResult };
34
35
  //# sourceMappingURL=create-s3-client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"create-s3-client.d.ts","sourceRoot":"","sources":["../src/create-s3-client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,KAAK,kBAAkB,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG;IACvD,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,EAC3E,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;;wBAMP,kBAAkB;;EAS9C;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
1
+ {"version":3,"file":"create-s3-client.d.ts","sourceRoot":"","sources":["../src/create-s3-client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,KAAK,kBAAkB,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG;IACvD,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,IAChE,oBAAoB,CAAC,CAAC,CAAC,GAAG;IACxB,QAAQ,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,EAC3E,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,aAAa,CAAC,CAAC,CAAC,CAclB;AAED,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"format-dimah-error.d.ts","sourceRoot":"","sources":["../../src/helpers/format-dimah-error.tsx"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAsD9D"}
1
+ {"version":3,"file":"format-dimah-error.d.ts","sourceRoot":"","sources":["../../src/helpers/format-dimah-error.tsx"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAoD9D"}
@@ -3,7 +3,6 @@ export { useMultiFileUpload, type UseMultiFileUploadOptions, type UseMultiFileUp
3
3
  export { useUpload, type UseUploadOptions, type UseUploadReturn, } from "./use-upload";
4
4
  export { useMultiUpload, type UseMultiUploadOptions, type UseMultiUploadReturn, } from "./use-multi-upload";
5
5
  export { useFileIntake, type UseFileIntakeOptions, type UseFileIntakeReturn, type FileRejection, type DropzoneRootProps, type DropzoneInputProps, } from "./use-file-intake";
6
- export { useDownload, type DownloadPhase, type DownloadHooks, type UseDownloadOptions, type UseDownloadState, type UseDownloadReturn, } from "./use-download";
7
- export { useFetchDownload, type FetchDownloadPhase, type FetchDownloadProgress, type FetchDownloadHooks, type UseFetchDownloadOptions, type UseFetchDownloadState, type UseFetchDownloadReturn, } from "./use-fetch-download";
6
+ export { useDownload, type DownloadPhase, type DownloadHooks, type FetchDownloadPhase, type FetchDownloadProgress, type FetchDownloadHooks, type UseDownloadOptions, type UseDownloadState, type UseDownloadReturn, type UseNavigateDownloadOptions, type UseNavigateDownloadReturn, type UseFetchDownloadOptions, type UseFetchDownloadState, type UseFetchDownloadReturn, } from "./use-download";
8
7
  export { useDelete, type UseDeleteOptions, type UseDeleteState, type UseDeleteReturn, } from "./use-delete";
9
8
  //# 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,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,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,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,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"}
@@ -1,4 +1,4 @@
1
- import type { S3Api } from "@dimah-s3/core";
1
+ import type { DimahS3Error, S3Api } from "@dimah-s3/core";
2
2
  import type { DeletePhase, DeleteHooks } from "../types";
3
3
  /** Options for {@link useDelete}. */
4
4
  export type UseDeleteOptions = DeleteHooks & {
@@ -10,8 +10,8 @@ export type UseDeleteOptions = DeleteHooks & {
10
10
  export type UseDeleteState = {
11
11
  /** Current delete phase. */
12
12
  phase: DeletePhase;
13
- /** Error message, or `null`. */
14
- error: string | null;
13
+ /** Last error, or `null`. */
14
+ error: DimahS3Error | null;
15
15
  };
16
16
  export type UseDeleteReturn = UseDeleteState & {
17
17
  /** Key awaiting confirmation, or `null`. */
@@ -1 +1 @@
1
- {"version":3,"file":"use-delete.d.ts","sourceRoot":"","sources":["../../src/hooks/use-delete.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AASzD,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,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,CA4FpE"}
1
+ {"version":3,"file":"use-delete.d.ts","sourceRoot":"","sources":["../../src/hooks/use-delete.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAUzD,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,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,CA2FpE"}
@@ -1,24 +1,37 @@
1
- import type { S3Api } from "@dimah-s3/core";
2
- export type { DownloadPhase, DownloadHooks } from "../types/download";
3
- import type { DownloadPhase, DownloadHooks } from "../types/download";
4
- /** Options for {@link useDownload}. */
5
- export type UseDownloadOptions = DownloadHooks & {
1
+ import type { DimahS3Error, S3Api } from "@dimah-s3/core";
2
+ import type { UploadProgress } from "../types/upload";
3
+ import type { DownloadPhase, DownloadHooks, FetchDownloadPhase, FetchDownloadHooks } from "../types/download";
4
+ export type { DownloadPhase, DownloadHooks, FetchDownloadPhase, FetchDownloadProgress, FetchDownloadHooks, } from "../types/download";
5
+ type SharedDownloadOptions = {
6
6
  /** S3Api. Optional when an `<S3Provider>` is present in the tree. */
7
7
  api?: S3Api;
8
8
  /** Target bucket (overrides server default). */
9
9
  bucket?: string;
10
10
  };
11
- export type UseDownloadState = {
11
+ /** Options for {@link useDownload} in navigate mode (the default). */
12
+ export type UseNavigateDownloadOptions = SharedDownloadOptions & DownloadHooks & {
13
+ /**
14
+ * `"navigate"` (default) — presign then hand the URL to the browser.
15
+ * `"fetch"` — stream bytes in the browser for progress and cancel.
16
+ */
17
+ mode?: "navigate";
18
+ };
19
+ /** Options for {@link useDownload} with `{ mode: "fetch" }`. */
20
+ export type UseFetchDownloadOptions = SharedDownloadOptions & FetchDownloadHooks & {
21
+ mode: "fetch";
22
+ };
23
+ export type UseDownloadOptions = UseNavigateDownloadOptions | UseFetchDownloadOptions;
24
+ export type UseNavigateDownloadState = {
12
25
  /** Current download phase. */
13
26
  phase: DownloadPhase;
14
- /** Error message, or `null`. */
15
- error: string | null;
27
+ /** Last error, or `null`. */
28
+ error: DimahS3Error | null;
16
29
  /** Presigned URL — set after a successful presign, cleared on reset. */
17
30
  url: string | null;
18
31
  /** Validity window in seconds for the presigned URL. */
19
32
  expiresIn: number | null;
20
33
  };
21
- export type UseDownloadReturn = UseDownloadState & {
34
+ export type UseNavigateDownloadReturn = UseNavigateDownloadState & {
22
35
  /** Presign and trigger a native browser download. */
23
36
  download: (key: string, downloadName?: string) => Promise<void>;
24
37
  /** Fetch the presigned URL without triggering a browser download. */
@@ -29,5 +42,30 @@ export type UseDownloadReturn = UseDownloadState & {
29
42
  /** Reset state to `idle`. */
30
43
  reset: () => void;
31
44
  };
32
- export declare function useDownload(options: UseDownloadOptions): UseDownloadReturn;
45
+ export type UseFetchDownloadState = {
46
+ /** Current download phase. */
47
+ phase: FetchDownloadPhase;
48
+ /** Byte transfer progress. */
49
+ progress: UploadProgress;
50
+ /** Last error, or `null`. */
51
+ error: DimahS3Error | null;
52
+ /** Resolved download filename. */
53
+ fileName: string | null;
54
+ /** Total file size in bytes. */
55
+ fileSize: number | null;
56
+ };
57
+ export type UseFetchDownloadReturn = UseFetchDownloadState & {
58
+ /** Presign, fetch bytes, and save via the browser. */
59
+ download: (key: string, downloadName?: string) => Promise<void>;
60
+ /** Abort the active download. */
61
+ cancel: () => void;
62
+ /** Reset state to `idle`. */
63
+ reset: () => void;
64
+ };
65
+ /** @deprecated Use {@link UseNavigateDownloadState}. */
66
+ export type UseDownloadState = UseNavigateDownloadState;
67
+ /** Default (navigate) return. Fetch mode is {@link UseFetchDownloadReturn}. */
68
+ export type UseDownloadReturn = UseNavigateDownloadReturn;
69
+ export declare function useDownload(options?: UseNavigateDownloadOptions): UseNavigateDownloadReturn;
70
+ export declare function useDownload(options: UseFetchDownloadOptions): UseFetchDownloadReturn;
33
71
  //# sourceMappingURL=use-download.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"use-download.d.ts","sourceRoot":"","sources":["../../src/hooks/use-download.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAU5C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtE,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8BAA8B;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IACjD,qDAAqD;IACrD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,qEAAqE;IACrE,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACxD,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AASF,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAmF1E"}
1
+ {"version":3,"file":"use-download.d.ts","sourceRoot":"","sources":["../../src/hooks/use-download.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAa1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,qBAAqB,GAAG;IAC3B,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,GAC5D,aAAa,GAAG;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GACzD,kBAAkB,GAAG;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAC5B,0BAA0B,GAAG,uBAAuB,CAAC;AAEvD,MAAM,MAAM,wBAAwB,GAAG;IACrC,8BAA8B;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,GAAG;IACjE,qDAAqD;IACrD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,qEAAqE;IACrE,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACxD,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,8BAA8B;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG;IAC3D,sDAAsD;IACtD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,iCAAiC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACxD,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AA4B1D,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB,CAAC;AAC7B,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAAC"}
@@ -1,4 +1,5 @@
1
1
  import type { S3Api } from "@dimah-s3/core";
2
+ import { DimahS3Error } from "@dimah-s3/core";
2
3
  import type { UploadConfig, UploadHooks, UploadPhase, UploadProgress, UploadResult, UploadRequestOptions } from "../types";
3
4
  /** Options for {@link useFileUpload}. */
4
5
  export type UseFileUploadOptions = UploadConfig & UploadHooks & {
@@ -10,8 +11,8 @@ export type UseFileUploadState = {
10
11
  phase: UploadPhase;
11
12
  /** Byte transfer progress. */
12
13
  progress: UploadProgress;
13
- /** Error message, or `null`. */
14
- error: string | null;
14
+ /** Last error, or `null`. */
15
+ error: DimahS3Error | null;
15
16
  /** Result after success, or `null`. */
16
17
  result: UploadResult | null;
17
18
  /** Name of the file being uploaded. */
@@ -1 +1 @@
1
- {"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-file-upload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAiB5C,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAGlB,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAC7C,WAAW,GAAG;IACZ,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,oBAAoB,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAyBF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CA+NrB"}
1
+ {"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-file-upload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAgB5D,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAIlB,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAC7C,WAAW,GAAG;IACZ,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,uCAAuC;IACvC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,oBAAoB,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAyBF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAiOrB"}
@@ -1,4 +1,5 @@
1
1
  import type { S3Api } from "@dimah-s3/core";
2
+ import { DimahS3Error } from "@dimah-s3/core";
2
3
  import type { UploadConfig, UploadProgress, UploadRequestOptions, MultiUploadPhase, MultiUploadFileState, MultiUploadHooks } from "../types";
3
4
  /** Options for {@link useMultiFileUpload}. */
4
5
  export type UseMultiFileUploadOptions = UploadConfig & MultiUploadHooks & {
@@ -16,8 +17,8 @@ export type UseMultiFileUploadState = {
16
17
  files: MultiUploadFileState[];
17
18
  /** Aggregated progress across all files. */
18
19
  totalProgress: UploadProgress;
19
- /** Batch-level error message, or `null`. */
20
- error: string | null;
20
+ /** Batch-level error, or `null`. */
21
+ error: DimahS3Error | null;
21
22
  };
22
23
  export type UseMultiFileUploadReturn = UseMultiFileUploadState & {
23
24
  /** Upload multiple files. */
@@ -1 +1 @@
1
- {"version":3,"file":"use-multi-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-multi-file-upload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAiB5C,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAClD,gBAAgB,GAAG;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,mDAAmD;IACnD,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,oBAAoB,CAAC;CACzD,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAAG;IACpC,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;CACtB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAC/D,6BAA6B;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAsBF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CA4U1B"}
1
+ {"version":3,"file":"use-multi-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-multi-file-upload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAgB5D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAIlB,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAClD,gBAAgB,GAAG;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,mDAAmD;IACnD,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,oBAAoB,CAAC;CACzD,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAAG;IACpC,kCAAkC;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,8BAA8B;IAC9B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,aAAa,EAAE,cAAc,CAAC;IAC9B,oCAAoC;IACpC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAC/D,6BAA6B;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAsBF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CA+U1B"}
@@ -1,10 +1,11 @@
1
+ import { type DimahS3Error } from "@dimah-s3/core";
1
2
  import type { UploadProgress, MultiUploadFileState, MultiUploadPhase } from "../types";
2
3
  import { type UseMultiFileUploadOptions } from "./use-multi-file-upload";
3
4
  import { type DropzoneInputProps, type DropzoneRootProps, type FileRejection } from "./use-file-intake";
4
5
  /** Options for {@link useMultiUpload}. */
5
6
  export type UseMultiUploadOptions = UseMultiFileUploadOptions & {
6
7
  /** S3 object key, or a function that derives it from each file. */
7
- objectKey: string | ((file: File) => string);
8
+ objectKey?: string | ((file: File) => string);
8
9
  /** Disable all intake interactions. */
9
10
  disabled?: boolean;
10
11
  /**
@@ -32,8 +33,8 @@ export type UseMultiUploadReturn = {
32
33
  files: MultiUploadFileState[];
33
34
  /** Aggregated progress across all files. */
34
35
  totalProgress: UploadProgress;
35
- /** Batch-level error message, or `null`. */
36
- error: string | null;
36
+ /** Batch-level error, or `null`. */
37
+ error: DimahS3Error | null;
37
38
  /** `true` while uploading. */
38
39
  isUploading: boolean;
39
40
  /** Handle files programmatically (bypasses dropzone). */
@@ -1 +1 @@
1
- {"version":3,"file":"use-multi-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-multi-upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,GAAG;IAC9D,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;IAC7C,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,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,yDAAyD;IACzD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5D,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,CAAC;AAEF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAwDtB"}
1
+ {"version":3,"file":"use-multi-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-multi-upload.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,GAAG;IAC9D,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,kCAAkC;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,8BAA8B;IAC9B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,4CAA4C;IAC5C,aAAa,EAAE,cAAc,CAAC;IAC9B,oCAAoC;IACpC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5D,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,CAAC;AAEF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CA2DtB"}
@@ -1,10 +1,11 @@
1
+ import { type DimahS3Error } from "@dimah-s3/core";
1
2
  import type { UploadFileInfo, UploadPhase, UploadProgress, UploadRequestOptions } from "../types";
2
3
  import { type UseFileUploadOptions } from "./use-file-upload";
3
4
  import { type DropzoneInputProps, type DropzoneRootProps, type FileRejection } from "./use-file-intake";
4
5
  /** Options for {@link useUpload}. */
5
6
  export type UseUploadOptions = UseFileUploadOptions & {
6
7
  /** S3 object key, or a function that derives it from the file. */
7
- objectKey: string | ((file: File) => string);
8
+ objectKey?: string | ((file: File) => string);
8
9
  /** Static request options applied to the upload. */
9
10
  uploadOptions?: UploadRequestOptions;
10
11
  /** Per-upload request options override. */
@@ -36,8 +37,8 @@ export type UseUploadReturn = {
36
37
  fileInfo: UploadFileInfo | null;
37
38
  /** Byte transfer progress. */
38
39
  progress: UploadProgress;
39
- /** Error message, or `null`. */
40
- error: string | null;
40
+ /** Last error, or `null`. */
41
+ error: DimahS3Error | null;
41
42
  /** `true` while uploading. */
42
43
  isUploading: boolean;
43
44
  /** Handle files programmatically (bypasses dropzone). */
@@ -1 +1 @@
1
- {"version":3,"file":"use-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,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;IACxD,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5D,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAuEpE"}
1
+ {"version":3,"file":"use-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-upload.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;IAC9C,oDAAoD;IACpD,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,oBAAoB,CAAC;IACxD,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5D,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA0EpE"}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  export * from "./types";
2
+ export { DimahS3Error, S3_ERROR_CODES, buildObjectKey, defaultObjectKey, formatFileSize, isAPIError, isDimahS3Error, isS3ErrorCode, sanitizeFileName, validateFile, type S3Api, type S3ErrorCode, type ValidateFileError, } from "@dimah-s3/core";
2
3
  export { defineApi } from "./api";
3
- export { createS3Client, type CreateS3ClientOptions } from "./create-s3-client";
4
- export { S3Provider, useApi, S3Context, type S3ProviderProps, } from "./s3-provider";
4
+ export { createS3Client, type CreateS3ClientOptions, type CreateS3ClientResult, type ReactS3Client, } from "./create-s3-client";
5
+ export { S3Provider, useApi, type S3ProviderProps } from "./s3-provider";
5
6
  /** Generated key map — use with `satisfies Partial<Translations>`. */
6
7
  export type { Translations } from "./translations";
7
8
  export { createLocalStorageStore, createMemoryStore } from "./store";
@@ -12,7 +13,6 @@ export { useMultiFileUpload, type UseMultiFileUploadOptions, type UseMultiFileUp
12
13
  export { useUpload, type UseUploadOptions, type UseUploadReturn, } from "./hooks/use-upload";
13
14
  export { useMultiUpload, type UseMultiUploadOptions, type UseMultiUploadReturn, } from "./hooks/use-multi-upload";
14
15
  export { useFileIntake, type UseFileIntakeOptions, type UseFileIntakeReturn, type FileRejection, type DropzoneRootProps, type DropzoneInputProps, } from "./hooks/use-file-intake";
15
- export { useDownload, type DownloadPhase, type DownloadHooks, type UseDownloadOptions, type UseDownloadState, type UseDownloadReturn, } from "./hooks/use-download";
16
- export { useFetchDownload, type FetchDownloadPhase, type FetchDownloadProgress, type FetchDownloadHooks, type UseFetchDownloadOptions, type UseFetchDownloadState, type UseFetchDownloadReturn, } from "./hooks/use-fetch-download";
16
+ export { useDownload, type UseDownloadOptions, type UseDownloadState, type UseDownloadReturn, type UseNavigateDownloadOptions, type UseNavigateDownloadReturn, type UseFetchDownloadOptions, type UseFetchDownloadState, type UseFetchDownloadReturn, } from "./hooks/use-download";
17
17
  export { useDelete, type UseDeleteOptions, type UseDeleteState, type UseDeleteReturn, } from "./hooks/use-delete";
18
18
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EACL,UAAU,EACV,MAAM,EACN,SAAS,EACT,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,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,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,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,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,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,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,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"}