@visulima/storage 1.0.0-alpha.14 → 1.0.0-alpha.16

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 (144) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/LICENSE.md +1094 -382
  3. package/dist/adapter/nuxt/module.d.ts +41 -34
  4. package/dist/handler/http/fetch/index.d.ts +297 -4
  5. package/dist/handler/http/hono/index.d.ts +1474 -58
  6. package/dist/handler/http/nextjs/index.d.ts +66 -58
  7. package/dist/handler/http/node/index.d.ts +361 -4
  8. package/dist/handler/http/solid-start/index.d.ts +66 -57
  9. package/dist/index.d.ts +376 -17
  10. package/dist/openapi/index.d.ts +24 -5
  11. package/dist/packem_shared/{GCSMetaStorage-BjdSXKri.js → GCSMetaStorage-CNXq7vGd.js} +1 -1
  12. package/dist/packem_shared/{GCStorage-D3JVWisH.js → GCStorage-CdnSuQwa.js} +1 -1
  13. package/dist/packem_shared/S3Client.d-CZ62Jztg.d.ts +20357 -0
  14. package/dist/packem_shared/disk-storage-with-checksum.d-hEoe2ugb.d.ts +148 -0
  15. package/dist/packem_shared/{gcs-meta-storage-C8rMsqR_.js → gcs-meta-storage-B5AVt1aS.js} +1 -1
  16. package/dist/packem_shared/local-meta-storage.d-Dop9RP9k.d.ts +20 -0
  17. package/dist/packem_shared/media-transformer.d-DeHZkBVx.d.ts +331 -0
  18. package/dist/packem_shared/s3-base-storage.d-CczjSe98.d.ts +251 -0
  19. package/dist/packem_shared/storage.d-BOMUJD96.d.ts +939 -0
  20. package/dist/packem_shared/tus-base.d-BftIixIA.d.ts +99 -0
  21. package/dist/packem_shared/types.d-BPd_JkW1.d.ts +708 -0
  22. package/dist/packem_shared/types.d-D-mlfmef.d.ts +49 -0
  23. package/dist/storage/aws/clients/index.d.ts +166 -6
  24. package/dist/storage/aws/index.d.ts +320 -4
  25. package/dist/storage/aws-light/index.d.ts +252 -4
  26. package/dist/storage/azure/index.d.ts +10422 -4
  27. package/dist/storage/gcs/index.d.ts +4107 -5
  28. package/dist/storage/gcs/index.js +2 -2
  29. package/dist/storage/local/index.d.ts +7 -4
  30. package/dist/storage/netlify-blob/index.d.ts +142 -4
  31. package/dist/storage/vercel-blob/index.d.ts +129 -4
  32. package/dist/transformer/audio-transformer.d.ts +127 -125
  33. package/dist/transformer/image-transformer.d.ts +569 -568
  34. package/dist/transformer/index.d.ts +62 -5
  35. package/dist/transformer/video-transformer.d.ts +144 -142
  36. package/package.json +38 -38
  37. package/dist/handler/base/base-handler-core.d.ts +0 -91
  38. package/dist/handler/base/base-handler-fetch.d.ts +0 -76
  39. package/dist/handler/base/base-handler-node.d.ts +0 -137
  40. package/dist/handler/multipart/multipart-base.d.ts +0 -84
  41. package/dist/handler/multipart/multipart-fetch.d.ts +0 -64
  42. package/dist/handler/multipart/multipart.d.ts +0 -49
  43. package/dist/handler/rest/rest-base.d.ts +0 -106
  44. package/dist/handler/rest/rest-fetch.d.ts +0 -88
  45. package/dist/handler/rest/rest.d.ts +0 -93
  46. package/dist/handler/tus/tus-base.d.ts +0 -152
  47. package/dist/handler/tus/tus-fetch.d.ts +0 -72
  48. package/dist/handler/tus/tus.d.ts +0 -78
  49. package/dist/handler/types.d.ts +0 -53
  50. package/dist/handler/utils/request-parser.d.ts +0 -72
  51. package/dist/handler/utils/response-builder.d.ts +0 -83
  52. package/dist/handler/utils/storage-utils.d.ts +0 -10
  53. package/dist/handler/utils/stream-utils.d.ts +0 -29
  54. package/dist/handler/utils/upload-handlers.d.ts +0 -76
  55. package/dist/metrics/index.d.ts +0 -2
  56. package/dist/metrics/no-op-metrics.d.ts +0 -15
  57. package/dist/metrics/opentelemetry-metrics.d.ts +0 -55
  58. package/dist/openapi/rest.d.ts +0 -7
  59. package/dist/openapi/shared.d.ts +0 -13
  60. package/dist/openapi/transform.d.ts +0 -3
  61. package/dist/openapi/tus.d.ts +0 -7
  62. package/dist/openapi/xhr.d.ts +0 -7
  63. package/dist/storage/aws/clients/backblaze.d.ts +0 -12
  64. package/dist/storage/aws/clients/cloudflare.d.ts +0 -13
  65. package/dist/storage/aws/clients/digital-ocean.d.ts +0 -12
  66. package/dist/storage/aws/clients/minio.d.ts +0 -13
  67. package/dist/storage/aws/clients/tigris.d.ts +0 -12
  68. package/dist/storage/aws/clients/types.d.ts +0 -95
  69. package/dist/storage/aws/clients/wasabi.d.ts +0 -12
  70. package/dist/storage/aws/s3-base-storage.d.ts +0 -248
  71. package/dist/storage/aws/s3-client-adapter.d.ts +0 -110
  72. package/dist/storage/aws/s3-file.d.ts +0 -10
  73. package/dist/storage/aws/s3-meta-storage.d.ts +0 -15
  74. package/dist/storage/aws/s3-storage.d.ts +0 -70
  75. package/dist/storage/aws/types.d.ts +0 -118
  76. package/dist/storage/aws-light/aws-light-api-adapter.d.ts +0 -130
  77. package/dist/storage/aws-light/aws-light-file.d.ts +0 -10
  78. package/dist/storage/aws-light/aws-light-meta-storage.d.ts +0 -19
  79. package/dist/storage/aws-light/aws-light-storage.d.ts +0 -66
  80. package/dist/storage/aws-light/types.d.ts +0 -36
  81. package/dist/storage/azure/azure-file.d.ts +0 -6
  82. package/dist/storage/azure/azure-meta-storage.d.ts +0 -15
  83. package/dist/storage/azure/azure-storage.d.ts +0 -69
  84. package/dist/storage/azure/types.d.ts +0 -61
  85. package/dist/storage/gcs/fetch-error.d.ts +0 -11
  86. package/dist/storage/gcs/gcs-config.d.ts +0 -2
  87. package/dist/storage/gcs/gcs-file.d.ts +0 -6
  88. package/dist/storage/gcs/gcs-meta-storage.d.ts +0 -27
  89. package/dist/storage/gcs/gcs-storage.d.ts +0 -91
  90. package/dist/storage/gcs/types.d.ts +0 -54
  91. package/dist/storage/gcs/utils.d.ts +0 -7
  92. package/dist/storage/local/disk-storage-with-checksum.d.ts +0 -15
  93. package/dist/storage/local/disk-storage.d.ts +0 -135
  94. package/dist/storage/local/local-meta-storage.d.ts +0 -27
  95. package/dist/storage/meta-storage-options.d.ts +0 -11
  96. package/dist/storage/meta-storage.d.ts +0 -30
  97. package/dist/storage/netlify-blob/netlify-blob-file.d.ts +0 -12
  98. package/dist/storage/netlify-blob/netlify-blob-meta-storage.d.ts +0 -6
  99. package/dist/storage/netlify-blob/netlify-blob-storage.d.ts +0 -93
  100. package/dist/storage/netlify-blob/types.d.ts +0 -29
  101. package/dist/storage/storage.d.ts +0 -353
  102. package/dist/storage/types.d.ts +0 -217
  103. package/dist/storage/utils/file/file.d.ts +0 -25
  104. package/dist/storage/utils/file/get-file-status.d.ts +0 -9
  105. package/dist/storage/utils/file/has-content.d.ts +0 -9
  106. package/dist/storage/utils/file/index.d.ts +0 -10
  107. package/dist/storage/utils/file/is-expired.d.ts +0 -8
  108. package/dist/storage/utils/file/metadata.d.ts +0 -18
  109. package/dist/storage/utils/file/part-match.d.ts +0 -11
  110. package/dist/storage/utils/file/types.d.ts +0 -37
  111. package/dist/storage/utils/file/update-metadata.d.ts +0 -10
  112. package/dist/storage/utils/file/update-size.d.ts +0 -10
  113. package/dist/storage/vercel-blob/types.d.ts +0 -31
  114. package/dist/storage/vercel-blob/vercel-blob-file.d.ts +0 -16
  115. package/dist/storage/vercel-blob/vercel-blob-meta-storage.d.ts +0 -6
  116. package/dist/storage/vercel-blob/vercel-blob-storage.d.ts +0 -76
  117. package/dist/transformer/base-transformer.d.ts +0 -63
  118. package/dist/transformer/media-transformer.d.ts +0 -332
  119. package/dist/transformer/transformer-config.d.ts +0 -16
  120. package/dist/transformer/types.d.ts +0 -639
  121. package/dist/transformer/utils.d.ts +0 -33
  122. package/dist/transformer/validation-error.d.ts +0 -23
  123. package/dist/utils/cache.d.ts +0 -32
  124. package/dist/utils/chunked-upload.d.ts +0 -65
  125. package/dist/utils/detect-file-type.d.ts +0 -28
  126. package/dist/utils/errors.d.ts +0 -74
  127. package/dist/utils/file-path-url-matcher.d.ts +0 -18
  128. package/dist/utils/headers.d.ts +0 -111
  129. package/dist/utils/http.d.ts +0 -92
  130. package/dist/utils/locker.d.ts +0 -26
  131. package/dist/utils/pipes/stream-checksum.d.ts +0 -47
  132. package/dist/utils/pipes/stream-length.d.ts +0 -22
  133. package/dist/utils/primitives/get-last-one.d.ts +0 -3
  134. package/dist/utils/primitives/is-record.d.ts +0 -2
  135. package/dist/utils/primitives/map-values.d.ts +0 -9
  136. package/dist/utils/primitives/pick.d.ts +0 -2
  137. package/dist/utils/primitives/to-milliseconds.d.ts +0 -12
  138. package/dist/utils/primitives/to-seconds.d.ts +0 -12
  139. package/dist/utils/range-checksum.d.ts +0 -33
  140. package/dist/utils/range-hasher.d.ts +0 -46
  141. package/dist/utils/retry.d.ts +0 -64
  142. package/dist/utils/types.d.ts +0 -108
  143. package/dist/utils/validation-error.d.ts +0 -22
  144. package/dist/utils/validator.d.ts +0 -36
@@ -1,61 +1,69 @@
1
- import type { NextRequest } from "next/server.d.ts";
2
- import { NextResponse } from "next/server.d.ts";
3
- import type { UploadFile } from "../../../storage/utils/index.d.ts";
4
- import type { UploadOptions } from "../../types.d.ts";
1
+ import { NextRequest, NextResponse } from 'next/server.js';
2
+ import { U as UploadFile } from "../../../packem_shared/storage.d-BOMUJD96.js";
3
+ import 'node:stream';
4
+ import { U as UploadOptions } from "../../../packem_shared/types.d-D-mlfmef.js";
5
+ import 'node:crypto';
6
+ import 'node:http';
7
+ import 'lru-cache';
8
+ import 'node:events';
9
+ import '@visulima/pagination';
10
+ import "../../../packem_shared/media-transformer.d-DeHZkBVx.js";
11
+ import "../../../packem_shared/types.d-BPd_JkW1.js";
5
12
  /**
6
- * Configuration for Next.js handler.
7
- */
8
- export interface NextjsHandlerConfig<TFile extends UploadFile> extends UploadOptions<TFile> {
9
- /** Handler type to use */
10
- type: "multipart" | "rest" | "tus";
13
+ * Configuration for Next.js handler.
14
+ */
15
+ interface NextjsHandlerConfig<TFile extends UploadFile> extends UploadOptions<TFile> {
16
+ /** Handler type to use */
17
+ type: "multipart" | "rest" | "tus";
11
18
  }
12
19
  /**
13
- * Next.js route handler that automatically exports the correct HTTP methods for each handler type.
14
- * @example
15
- * ```ts
16
- * // app/api/upload/multipart/route.ts
17
- * import { DiskStorage } from "@visulima/storage";
18
- * import { createHandler } from "@visulima/storage/handler/http/nextjs";
19
- *
20
- * const storage = new DiskStorage({ directory: "./uploads" });
21
- * const handler = createHandler({ storage, type: "multipart" });
22
- *
23
- * export const POST = handler;
24
- * export const DELETE = handler;
25
- * export const GET = handler;
26
- * export const OPTIONS = handler;
27
- * ```
28
- * @example
29
- * ```ts
30
- * // app/api/upload/rest/route.ts
31
- * import { DiskStorage } from "@visulima/storage";
32
- * import { createHandler } from "@visulima/storage/handler/http/nextjs";
33
- *
34
- * const storage = new DiskStorage({ directory: "./uploads" });
35
- * const handler = createHandler({ storage, type: "rest" });
36
- *
37
- * export const POST = handler;
38
- * export const PUT = handler;
39
- * export const PATCH = handler;
40
- * export const GET = handler;
41
- * export const HEAD = handler;
42
- * export const DELETE = handler;
43
- * export const OPTIONS = handler;
44
- * ```
45
- * @example
46
- * ```ts
47
- * // app/api/upload/tus/route.ts
48
- * import { DiskStorage } from "@visulima/storage";
49
- * import { createHandler } from "@visulima/storage/handler/http/nextjs";
50
- *
51
- * const storage = new DiskStorage({ directory: "./uploads" });
52
- * const handler = createHandler({ storage, type: "tus" });
53
- *
54
- * export const POST = handler;
55
- * export const PATCH = handler;
56
- * export const HEAD = handler;
57
- * export const DELETE = handler;
58
- * export const OPTIONS = handler;
59
- * ```
60
- */
61
- export declare const createHandler: <TFile extends UploadFile>(config: NextjsHandlerConfig<TFile>) => (request: NextRequest) => Promise<NextResponse>;
20
+ * Next.js route handler that automatically exports the correct HTTP methods for each handler type.
21
+ * @example
22
+ * ```ts
23
+ * // app/api/upload/multipart/route.ts
24
+ * import { DiskStorage } from "@visulima/storage";
25
+ * import { createHandler } from "@visulima/storage/handler/http/nextjs";
26
+ *
27
+ * const storage = new DiskStorage({ directory: "./uploads" });
28
+ * const handler = createHandler({ storage, type: "multipart" });
29
+ *
30
+ * export const POST = handler;
31
+ * export const DELETE = handler;
32
+ * export const GET = handler;
33
+ * export const OPTIONS = handler;
34
+ * ```
35
+ * @example
36
+ * ```ts
37
+ * // app/api/upload/rest/route.ts
38
+ * import { DiskStorage } from "@visulima/storage";
39
+ * import { createHandler } from "@visulima/storage/handler/http/nextjs";
40
+ *
41
+ * const storage = new DiskStorage({ directory: "./uploads" });
42
+ * const handler = createHandler({ storage, type: "rest" });
43
+ *
44
+ * export const POST = handler;
45
+ * export const PUT = handler;
46
+ * export const PATCH = handler;
47
+ * export const GET = handler;
48
+ * export const HEAD = handler;
49
+ * export const DELETE = handler;
50
+ * export const OPTIONS = handler;
51
+ * ```
52
+ * @example
53
+ * ```ts
54
+ * // app/api/upload/tus/route.ts
55
+ * import { DiskStorage } from "@visulima/storage";
56
+ * import { createHandler } from "@visulima/storage/handler/http/nextjs";
57
+ *
58
+ * const storage = new DiskStorage({ directory: "./uploads" });
59
+ * const handler = createHandler({ storage, type: "tus" });
60
+ *
61
+ * export const POST = handler;
62
+ * export const PATCH = handler;
63
+ * export const HEAD = handler;
64
+ * export const DELETE = handler;
65
+ * export const OPTIONS = handler;
66
+ * ```
67
+ */
68
+ declare const createHandler: <TFile extends UploadFile>(config: NextjsHandlerConfig<TFile>) => (request: NextRequest) => Promise<NextResponse>;
69
+ export { NextjsHandlerConfig, createHandler };
@@ -1,4 +1,361 @@
1
- export { default as Multipart } from "../../multipart/multipart.d.ts";
2
- export { default as Rest } from "../../rest/rest.d.ts";
3
- export { Tus, TUS_RESUMABLE, TUS_VERSION } from "../../tus/tus.d.ts";
4
- export type { AsyncHandler, BaseHandler, Handlers, MethodHandler, RequestEvent, UploadErrorEvent, UploadEvent, UploadOptions } from "../../types.d.ts";
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { U as UploadFile, l as UploadResponse } from "../../../packem_shared/storage.d-BOMUJD96.js";
3
+ import { Readable } from 'node:stream';
4
+ import { H as Handlers, A as AsyncHandler, U as UploadOptions, R as ResponseFile, a as ResponseList, M as MethodHandler } from "../../../packem_shared/types.d-D-mlfmef.js";
5
+ export { type B as BaseHandler, type b as RequestEvent, type c as UploadErrorEvent, type d as UploadEvent } from "../../../packem_shared/types.d-D-mlfmef.js";
6
+ import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-BftIixIA.js";
7
+ export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-BftIixIA.js";
8
+ import 'node:crypto';
9
+ import 'lru-cache';
10
+ import 'node:events';
11
+ import '@visulima/pagination';
12
+ import "../../../packem_shared/media-transformer.d-DeHZkBVx.js";
13
+ import "../../../packem_shared/types.d-BPd_JkW1.js";
14
+ /**
15
+ * Base handler for Node.js platform (IncomingMessage/ServerResponse).
16
+ * Extends BaseHandlerCore with Node.js-specific request/response handling.
17
+ * @template TFile The file type used by this handler.
18
+ * @template NodeRequest The Node.js request type.
19
+ * @template NodeResponse The Node.js response type.
20
+ */
21
+ declare abstract class BaseHandlerNode<TFile extends UploadFile, NodeRequest extends IncomingMessage = IncomingMessage, NodeResponse extends ServerResponse = ServerResponse> extends BaseHandlerCore<TFile> implements MethodHandler<NodeRequest, NodeResponse> {
22
+ /**
23
+ * Limiting enabled HTTP method handler.
24
+ */
25
+ static readonly methods: Handlers[];
26
+ /**
27
+ * Map of registered HTTP method handlers.
28
+ */
29
+ protected registeredHandlers: Map<string, AsyncHandler<NodeRequest, NodeResponse>>;
30
+ constructor(options: UploadOptions<TFile>);
31
+ /**
32
+ * Gets the registered handlers map.
33
+ * @returns Map of registered handlers.
34
+ */
35
+ get handlers(): Map<string, AsyncHandler<NodeRequest, NodeResponse>>;
36
+ /**
37
+ * Handles HTTP request (alias for upload method).
38
+ * @param request Node.js IncomingMessage.
39
+ * @param response Node.js ServerResponse.
40
+ */
41
+ handle: (request: NodeRequest, response: NodeResponse) => Promise<void>;
42
+ /**
43
+ * Main upload handler that processes HTTP requests and routes them to appropriate method handlers.
44
+ * @param request Node.js IncomingMessage.
45
+ * @param response Node.js ServerResponse.
46
+ * @param next Optional Express-style next function for middleware compatibility.
47
+ * @throws {UploadError} When storage is not ready or method is not allowed.
48
+ */
49
+ upload: (request: NodeRequest, response: NodeResponse, next?: () => void) => Promise<void>;
50
+ /**
51
+ * Compose and register HTTP method handlers.
52
+ * Subclasses should override this to register their specific handlers.
53
+ */
54
+ protected abstract compose(): void;
55
+ /**
56
+ * Sends an HTTP response with the provided body, headers, and status code.
57
+ * @param response Node.js ServerResponse to send data to.
58
+ * @param body Response body, headers, and status code.
59
+ */
60
+ send(response: NodeResponse, {
61
+ body,
62
+ headers,
63
+ statusCode
64
+ }: UploadResponse): void;
65
+ /**
66
+ * Sends an error response to the client with appropriate status code and message.
67
+ * @param response Node.js ServerResponse to send error to.
68
+ * @param error Error object to convert to HTTP error response.
69
+ */
70
+ sendError(response: NodeResponse, error: Error): Promise<void>;
71
+ /**
72
+ * Sends streaming response to client with proper backpressure handling and range request support.
73
+ * @param response Node.js ServerResponse to stream data to.
74
+ * @param stream Readable stream containing the file data.
75
+ * @param options Streaming options including headers, range, size, and status code.
76
+ */
77
+ sendStream(response: NodeResponse, stream: Readable, {
78
+ headers,
79
+ range,
80
+ size,
81
+ statusCode
82
+ }: {
83
+ headers?: Record<string, string | number>;
84
+ range?: {
85
+ end: number;
86
+ start: number;
87
+ };
88
+ size?: number;
89
+ statusCode?: number;
90
+ }): void;
91
+ /**
92
+ * Finish upload by sending final response to client with completed file data.
93
+ * @param _request HTTP request (unused parameter)
94
+ * @param response HTTP response object to send final response to
95
+ * @param uploadResponse Final upload response data containing body, headers, and status code
96
+ */
97
+ protected finish(_request: NodeRequest, response: NodeResponse, uploadResponse: UploadResponse | ResponseFile<TFile>): void;
98
+ /**
99
+ * Build file URL from request and file data.
100
+ * @param request HTTP request with optional originalUrl property
101
+ * @param file File object containing ID and content type
102
+ * @returns Constructed file URL with extension based on content type
103
+ */
104
+ protected buildFileUrl(request: NodeRequest & {
105
+ originalUrl?: string;
106
+ }, file: TFile): string;
107
+ /**
108
+ * Negotiates content type based on Accept header and supported formats.
109
+ * @param request HTTP request object containing Accept header.
110
+ * @param supportedTypes Array of supported MIME types to match against.
111
+ * @returns Best matching content type or undefined if no match found.
112
+ */
113
+ negotiateContentType(request: NodeRequest, supportedTypes: string[]): string | undefined;
114
+ /**
115
+ * Default OPTIONS handler.
116
+ * @param _request HTTP request (unused)
117
+ * @param _response HTTP response (unused)
118
+ * @returns Promise resolving to ResponseFile with CORS headers
119
+ */
120
+ options(_request: NodeRequest, _response: NodeResponse): Promise<ResponseFile<TFile>>;
121
+ /**
122
+ * Retrieves a file or list of files based on the request path.
123
+ * @param request Node.js IncomingMessage with optional originalUrl.
124
+ * @param response Node.js ServerResponse.
125
+ * @returns Promise resolving to a single file, paginated list, or array of files.
126
+ * @throws {UploadError} When file is not found or storage error occurs.
127
+ */
128
+ get(request: NodeRequest & {
129
+ originalUrl?: string;
130
+ }, _response: NodeResponse): Promise<ResponseFile<TFile> | ResponseList<TFile>>;
131
+ /**
132
+ * Returns a list of uploaded files with optional pagination support.
133
+ * @param request Node.js IncomingMessage containing query parameters for pagination.
134
+ * @param _response Node.js ServerResponse (unused).
135
+ * @returns Promise resolving to a paginated or complete list of uploaded files.
136
+ */
137
+ list(request: NodeRequest, _response: NodeResponse): Promise<ResponseList<TFile>>;
138
+ /**
139
+ * Streams download of a file with resumable support using HTTP range requests.
140
+ * @param request Node.js IncomingMessage with optional originalUrl and range header.
141
+ * @param response Node.js ServerResponse to stream the file to.
142
+ * @throws {HttpError} When file is not found or streaming is not supported.
143
+ */
144
+ download(request: NodeRequest & {
145
+ originalUrl?: string;
146
+ }, response: NodeResponse): Promise<void>;
147
+ /**
148
+ * Check if error is related to undefined ID or path and throw appropriate HTTP error.
149
+ * @param error Error object to check
150
+ */
151
+ protected override checkForUndefinedIdOrPath(error: unknown): void;
152
+ }
153
+ /**
154
+ * Multipart/form-data upload handler (Node.js version).
155
+ * @example
156
+ * ```ts
157
+ * const multipart = new Multipart({
158
+ * storage,
159
+ * maxFileSize: 100 * 1024 * 1024, // 100MB
160
+ * });
161
+ *
162
+ * app.use('/files', multipart.handle);
163
+ * ```
164
+ */
165
+ declare class Multipart<TFile extends UploadFile, NodeRequest extends IncomingMessage = IncomingMessage, NodeResponse extends ServerResponse = ServerResponse> extends BaseHandlerNode<TFile, NodeRequest, NodeResponse> {
166
+ /**
167
+ * Limiting enabled http method handler
168
+ */
169
+ static override readonly methods: Handlers[];
170
+ private readonly multipartBase;
171
+ /**
172
+ * Maximum file size allowed for multipart uploads
173
+ */
174
+ private maxFileSize;
175
+ /**
176
+ * Maximum header size allowed for multipart parser
177
+ */
178
+ private maxHeaderSize;
179
+ constructor(options: UploadOptions<TFile>);
180
+ /**
181
+ * Handles multipart/form-data POST requests for file uploads.
182
+ * @param request Node.js IncomingMessage containing multipart data.
183
+ * @returns Promise resolving to ResponseFile with upload result.
184
+ */
185
+ post(request: NodeRequest): Promise<ResponseFile<TFile>>;
186
+ /**
187
+ * Delete an uploaded file.
188
+ * @param request Node.js IncomingMessage with file ID
189
+ * @returns Promise resolving to ResponseFile with deletion result
190
+ */
191
+ delete(request: NodeRequest): Promise<ResponseFile<TFile>>;
192
+ /**
193
+ * Compose and register HTTP method handlers.
194
+ */
195
+ protected compose(): void;
196
+ }
197
+ /**
198
+ * REST API handler for direct binary file uploads (Node.js version).
199
+ *
200
+ * This handler provides a clean REST interface for file operations:
201
+ * - POST: Create a new file with raw binary data or initialize chunked upload
202
+ * - PUT: Create or update a file (requires ID in URL)
203
+ * - PATCH: Upload chunks for chunked uploads (requires ID in URL)
204
+ * - GET: Retrieve a file or list files
205
+ * - DELETE: Delete a file (single) or multiple files (via ?ids=id1,id2 or JSON body)
206
+ * - HEAD: Get file metadata and upload progress
207
+ * - OPTIONS: CORS preflight
208
+ * @example
209
+ * ```ts
210
+ * const rest = new Rest({
211
+ * storage,
212
+ * });
213
+ *
214
+ * app.use('/files', rest.handle);
215
+ * ```
216
+ */
217
+ declare class Rest<TFile extends UploadFile, NodeRequest extends IncomingMessage = IncomingMessage, NodeResponse extends ServerResponse = ServerResponse> extends BaseHandlerNode<TFile, NodeRequest, NodeResponse> {
218
+ /**
219
+ * Limiting enabled http method handler
220
+ */
221
+ static override readonly methods: Handlers[];
222
+ private readonly restBase;
223
+ constructor(options: UploadOptions<TFile>);
224
+ /**
225
+ * Compose and register HTTP method handlers.
226
+ */
227
+ protected override compose(): void;
228
+ /**
229
+ * Build file URL from request and file data.
230
+ * @param requestUrl Request URL string
231
+ * @param file File object containing ID and content type
232
+ * @returns Constructed file URL with extension based on content type
233
+ */
234
+ protected buildFileUrlForRest(requestUrl: string, file: TFile): string;
235
+ /**
236
+ * Creates a new file via POST request with raw binary data.
237
+ * Supports both full file uploads and chunked upload initialization.
238
+ * @param request Node.js IncomingMessage with file data.
239
+ * @returns Promise resolving to ResponseFile with upload result.
240
+ */
241
+ post(request: NodeRequest): Promise<ResponseFile<TFile>>;
242
+ /**
243
+ * Create or update a file via PUT request.
244
+ * Requires file ID in the URL path.
245
+ * @param request Node.js IncomingMessage with file ID and data
246
+ * @returns Promise resolving to ResponseFile with upload result
247
+ */
248
+ put(request: NodeRequest): Promise<ResponseFile<TFile>>;
249
+ /**
250
+ * Delete an uploaded file or multiple files.
251
+ * Supports single file (ID in URL) or batch delete (via ?ids=id1,id2 or JSON body).
252
+ * @param request Node.js IncomingMessage with file ID(s)
253
+ * @returns Promise resolving to ResponseFile (single) or ResponseList (batch) with deletion result
254
+ */
255
+ delete(request: NodeRequest): Promise<ResponseFile<TFile> | ResponseList<TFile>>;
256
+ /**
257
+ * Uploads a chunk via PATCH request for chunked uploads.
258
+ * Headers required: X-Chunk-Offset (byte offset), Content-Length (chunk size).
259
+ * Optional: X-Chunk-Checksum (SHA256 checksum for validation).
260
+ * @param request Node.js IncomingMessage with chunk data.
261
+ * @returns Promise resolving to ResponseFile with upload progress.
262
+ */
263
+ patch(request: NodeRequest): Promise<ResponseFile<TFile>>;
264
+ /**
265
+ * Get file metadata via HEAD request.
266
+ * For chunked uploads, also returns upload progress information.
267
+ * @param request Node.js IncomingMessage with file ID
268
+ * @returns Promise resolving to ResponseFile with metadata headers
269
+ */
270
+ head(request: NodeRequest): Promise<ResponseFile<TFile>>;
271
+ /**
272
+ * Handle OPTIONS requests with REST API capabilities.
273
+ * @returns Promise resolving to ResponseFile with CORS headers
274
+ */
275
+ override options(): Promise<ResponseFile<TFile>>;
276
+ /**
277
+ * Retrieves a file or list of files based on the request path.
278
+ * Delegates to BaseHandlerNode.get() method.
279
+ * @param request Node.js IncomingMessage with optional originalUrl.
280
+ * @param response Node.js ServerResponse.
281
+ * @returns Promise resolving to a single file, paginated list, or array of files.
282
+ */
283
+ override get(request: NodeRequest, response: NodeResponse): Promise<ResponseFile<TFile> | ResponseList<TFile>>;
284
+ }
285
+ /**
286
+ * TUS resumable upload protocol handler (Node.js version).
287
+ *
288
+ * [tus resumable upload protocol](https://github.com/tus/tus-resumable-upload-protocol/blob/master/protocol.md)
289
+ * @example
290
+ * ```ts
291
+ * const tus = new Tus({storage});
292
+ *
293
+ * app.all('/files', tus.handle);
294
+ * ```
295
+ */
296
+ declare class Tus<TFile extends UploadFile, NodeRequest extends IncomingMessage = IncomingMessage, NodeResponse extends ServerResponse = ServerResponse> extends BaseHandlerNode<TFile, NodeRequest, NodeResponse> {
297
+ /**
298
+ * Limiting enabled http method handler
299
+ */
300
+ static override readonly methods: Handlers[];
301
+ override disableTerminationForFinishedUploads: boolean;
302
+ private readonly tusBase;
303
+ constructor(options: UploadOptions<TFile>);
304
+ /**
305
+ * Handle OPTIONS requests with TUS protocol capabilities.
306
+ * @returns Promise resolving to ResponseFile with TUS headers
307
+ */
308
+ override options(): Promise<ResponseFile<TFile>>;
309
+ /**
310
+ * Creates a new TUS upload and optionally starts uploading data.
311
+ * @param request Node.js IncomingMessage with TUS headers.
312
+ * @returns Promise resolving to ResponseFile with upload location and offset.
313
+ */
314
+ post(request: NodeRequest): Promise<ResponseFile<TFile>>;
315
+ /**
316
+ * Write a chunk of data to an existing TUS upload.
317
+ * @param request Node.js IncomingMessage with chunk data and TUS headers
318
+ * @returns Promise resolving to ResponseFile with updated offset
319
+ */
320
+ patch(request: NodeRequest): Promise<ResponseFile<TFile>>;
321
+ /**
322
+ * Get current upload offset and metadata for TUS resumable uploads.
323
+ * @param request Node.js IncomingMessage with upload ID
324
+ * @returns Promise resolving to ResponseFile with upload-offset and metadata headers
325
+ */
326
+ head(request: NodeRequest): Promise<ResponseFile<TFile>>;
327
+ /**
328
+ * Get TUS upload metadata and current status.
329
+ * @param request Node.js IncomingMessage with upload ID
330
+ * @returns Promise resolving to ResponseFile with file metadata as JSON
331
+ */
332
+ override get(request: NodeRequest): Promise<ResponseFile<TFile>>;
333
+ /**
334
+ * Delete a TUS upload and its associated data.
335
+ * @param request Node.js IncomingMessage with upload ID
336
+ * @returns Promise resolving to ResponseFile with deletion confirmation
337
+ */
338
+ delete(request: NodeRequest): Promise<ResponseFile<TFile>>;
339
+ /**
340
+ * Send TUS protocol response with required headers.
341
+ * @param response Node.js ServerResponse to send response to
342
+ * @param uploadResponse Response data with body, headers, and status code
343
+ */
344
+ override send(response: NodeResponse, {
345
+ body,
346
+ headers,
347
+ statusCode
348
+ }: UploadResponse): void;
349
+ /**
350
+ * Compose and register HTTP method handlers.
351
+ */
352
+ protected compose(): void;
353
+ /**
354
+ * Build file URL for TUS uploads (without file extension).
355
+ * @param requestUrl Request URL string
356
+ * @param file File object containing ID
357
+ * @returns Constructed file URL for TUS protocol
358
+ */
359
+ protected buildFileUrlForTus(requestUrl: string, file: TFile): string;
360
+ }
361
+ export { type AsyncHandler, type Handlers, type MethodHandler, Multipart, Rest, Tus, type UploadOptions };
@@ -1,60 +1,69 @@
1
- import type { APIEvent } from "@solidjs/start/server";
2
- import type { UploadFile } from "../../../storage/utils/index.d.ts";
3
- import type { UploadOptions } from "../../types.d.ts";
1
+ import { APIEvent } from '@solidjs/start/server';
2
+ import { U as UploadFile } from "../../../packem_shared/storage.d-BOMUJD96.js";
3
+ import 'node:stream';
4
+ import { U as UploadOptions } from "../../../packem_shared/types.d-D-mlfmef.js";
5
+ import 'node:crypto';
6
+ import 'node:http';
7
+ import 'lru-cache';
8
+ import 'node:events';
9
+ import '@visulima/pagination';
10
+ import "../../../packem_shared/media-transformer.d-DeHZkBVx.js";
11
+ import "../../../packem_shared/types.d-BPd_JkW1.js";
4
12
  /**
5
- * Configuration for SolidStart handler.
6
- */
7
- export interface SolidStartHandlerConfig<TFile extends UploadFile> extends UploadOptions<TFile> {
8
- /** Handler type to use */
9
- type: "multipart" | "rest" | "tus";
13
+ * Configuration for SolidStart handler.
14
+ */
15
+ interface SolidStartHandlerConfig<TFile extends UploadFile> extends UploadOptions<TFile> {
16
+ /** Handler type to use */
17
+ type: "multipart" | "rest" | "tus";
10
18
  }
11
19
  /**
12
- * SolidStart API route handler that automatically handles the correct HTTP methods for each handler type.
13
- * @example
14
- * ```ts
15
- * // app/routes/api/upload/multipart.ts
16
- * import { DiskStorage } from "@visulima/storage";
17
- * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
18
- *
19
- * const storage = new DiskStorage({ directory: "./uploads" });
20
- * const handler = createSolidStartHandler({ storage, type: "multipart" });
21
- *
22
- * export const POST = handler;
23
- * export const DELETE = handler;
24
- * export const GET = handler;
25
- * export const OPTIONS = handler;
26
- * ```
27
- * @example
28
- * ```ts
29
- * // app/routes/api/upload/rest.ts
30
- * import { DiskStorage } from "@visulima/storage";
31
- * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
32
- *
33
- * const storage = new DiskStorage({ directory: "./uploads" });
34
- * const handler = createSolidStartHandler({ storage, type: "rest" });
35
- *
36
- * export const POST = handler;
37
- * export const PUT = handler;
38
- * export const PATCH = handler;
39
- * export const GET = handler;
40
- * export const HEAD = handler;
41
- * export const DELETE = handler;
42
- * export const OPTIONS = handler;
43
- * ```
44
- * @example
45
- * ```ts
46
- * // app/routes/api/upload/tus.ts
47
- * import { DiskStorage } from "@visulima/storage";
48
- * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
49
- *
50
- * const storage = new DiskStorage({ directory: "./uploads" });
51
- * const handler = createSolidStartHandler({ storage, type: "tus" });
52
- *
53
- * export const POST = handler;
54
- * export const PATCH = handler;
55
- * export const HEAD = handler;
56
- * export const DELETE = handler;
57
- * export const OPTIONS = handler;
58
- * ```
59
- */
60
- export declare const createSolidStartHandler: <TFile extends UploadFile>(config: SolidStartHandlerConfig<TFile>) => (event: APIEvent) => Promise<Response>;
20
+ * SolidStart API route handler that automatically handles the correct HTTP methods for each handler type.
21
+ * @example
22
+ * ```ts
23
+ * // app/routes/api/upload/multipart.ts
24
+ * import { DiskStorage } from "@visulima/storage";
25
+ * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
26
+ *
27
+ * const storage = new DiskStorage({ directory: "./uploads" });
28
+ * const handler = createSolidStartHandler({ storage, type: "multipart" });
29
+ *
30
+ * export const POST = handler;
31
+ * export const DELETE = handler;
32
+ * export const GET = handler;
33
+ * export const OPTIONS = handler;
34
+ * ```
35
+ * @example
36
+ * ```ts
37
+ * // app/routes/api/upload/rest.ts
38
+ * import { DiskStorage } from "@visulima/storage";
39
+ * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
40
+ *
41
+ * const storage = new DiskStorage({ directory: "./uploads" });
42
+ * const handler = createSolidStartHandler({ storage, type: "rest" });
43
+ *
44
+ * export const POST = handler;
45
+ * export const PUT = handler;
46
+ * export const PATCH = handler;
47
+ * export const GET = handler;
48
+ * export const HEAD = handler;
49
+ * export const DELETE = handler;
50
+ * export const OPTIONS = handler;
51
+ * ```
52
+ * @example
53
+ * ```ts
54
+ * // app/routes/api/upload/tus.ts
55
+ * import { DiskStorage } from "@visulima/storage";
56
+ * import { createSolidStartHandler } from "@visulima/storage/handler/http/solid-start";
57
+ *
58
+ * const storage = new DiskStorage({ directory: "./uploads" });
59
+ * const handler = createSolidStartHandler({ storage, type: "tus" });
60
+ *
61
+ * export const POST = handler;
62
+ * export const PATCH = handler;
63
+ * export const HEAD = handler;
64
+ * export const DELETE = handler;
65
+ * export const OPTIONS = handler;
66
+ * ```
67
+ */
68
+ declare const createSolidStartHandler: <TFile extends UploadFile>(config: SolidStartHandlerConfig<TFile>) => (event: APIEvent) => Promise<Response>;
69
+ export { SolidStartHandlerConfig, createSolidStartHandler };