@dimah-s3/core 0.7.4 → 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.
- package/README.md +4 -2
- package/dist/create-s3-client.d.ts +17 -3
- package/dist/create-s3-client.d.ts.map +1 -1
- package/dist/error-codes.d.ts +70 -0
- package/dist/error-codes.d.ts.map +1 -0
- package/dist/error.d.ts +31 -25
- package/dist/error.d.ts.map +1 -1
- package/dist/helpers/default-object-key.d.ts +6 -0
- package/dist/helpers/default-object-key.d.ts.map +1 -0
- package/dist/helpers/index.d.ts +2 -1
- package/dist/helpers/index.d.ts.map +1 -1
- package/dist/helpers/truncate-file-name.d.ts +0 -2
- package/dist/helpers/truncate-file-name.d.ts.map +1 -1
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +240 -153
- package/dist/index.js.map +1 -1
- package/dist/plugin/create-s3-fetch.d.ts +11 -0
- package/dist/plugin/create-s3-fetch.d.ts.map +1 -0
- package/dist/plugin/define-client-plugin.d.ts +10 -3
- package/dist/plugin/define-client-plugin.d.ts.map +1 -1
- package/dist/plugin/index.d.ts +3 -3
- package/dist/plugin/index.d.ts.map +1 -1
- package/dist/plugin/plugin-path.d.ts +9 -0
- package/dist/plugin/plugin-path.d.ts.map +1 -0
- package/dist/plugin/types.d.ts +28 -18
- package/dist/plugin/types.d.ts.map +1 -1
- package/dist/routes.d.ts +10 -9
- package/dist/routes.d.ts.map +1 -1
- package/dist/schema/delete.d.ts +6 -0
- package/dist/schema/delete.d.ts.map +1 -0
- package/dist/schema/download.d.ts +9 -0
- package/dist/schema/download.d.ts.map +1 -0
- package/dist/schema/error.d.ts +14 -0
- package/dist/schema/error.d.ts.map +1 -0
- package/dist/schema/index.d.ts +8 -0
- package/dist/schema/index.d.ts.map +1 -0
- package/dist/schema/multipart.d.ts +41 -0
- package/dist/schema/multipart.d.ts.map +1 -0
- package/dist/schema/shared.d.ts +11 -0
- package/dist/schema/shared.d.ts.map +1 -0
- package/dist/schema/upload.d.ts +19 -0
- package/dist/schema/upload.d.ts.map +1 -0
- package/dist/types/requests.d.ts +18 -75
- package/dist/types/requests.d.ts.map +1 -1
- package/package.json +7 -2
- package/dist/index.test.d.ts +0 -2
- package/dist/index.test.d.ts.map +0 -1
- package/dist/plugin/create-fetcher.d.ts +0 -10
- package/dist/plugin/create-fetcher.d.ts.map +0 -1
- package/dist/plugin/plugin-endpoint-path.d.ts +0 -9
- package/dist/plugin/plugin-endpoint-path.d.ts.map +0 -1
package/dist/index.js
CHANGED
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { APIError } from 'better-call/error';
|
|
3
|
+
import { createFetch } from '@better-fetch/fetch';
|
|
4
|
+
|
|
1
5
|
// src/helpers/validate-file.ts
|
|
2
6
|
function validateFile(file, options) {
|
|
3
7
|
if (options.accept?.length) {
|
|
@@ -84,6 +88,11 @@ function sanitizeFileName(fileName) {
|
|
|
84
88
|
return fileName.replace(/["\\\r\n]/g, "_");
|
|
85
89
|
}
|
|
86
90
|
|
|
91
|
+
// src/helpers/default-object-key.ts
|
|
92
|
+
function defaultObjectKey(file) {
|
|
93
|
+
return `${crypto.randomUUID()}/${sanitizeFileName(file.name)}`;
|
|
94
|
+
}
|
|
95
|
+
|
|
87
96
|
// src/helpers/truncate-file-name.ts
|
|
88
97
|
function truncateFileName(name, maxChars = 48) {
|
|
89
98
|
if (name.length <= maxChars) return name;
|
|
@@ -98,39 +107,132 @@ function truncateFileName(name, maxChars = 48) {
|
|
|
98
107
|
}
|
|
99
108
|
return name.slice(0, available) + "\u2026 " + ext;
|
|
100
109
|
}
|
|
101
|
-
var
|
|
110
|
+
var trimmedString = z.string().trim().min(1);
|
|
111
|
+
var optionalTrimmedString = z.string().trim().min(1).optional();
|
|
112
|
+
var s3ObjectAclSchema = z.enum(["private", "public-read"]);
|
|
113
|
+
var metadataSchema = z.record(z.string(), z.string());
|
|
114
|
+
var uploadBodySchema = z.object({
|
|
115
|
+
key: trimmedString,
|
|
116
|
+
contentType: optionalTrimmedString,
|
|
117
|
+
fileSize: z.number().positive().optional(),
|
|
118
|
+
metadata: metadataSchema.optional(),
|
|
119
|
+
bucket: optionalTrimmedString,
|
|
120
|
+
expiresIn: z.number().positive().optional(),
|
|
121
|
+
acl: s3ObjectAclSchema.optional(),
|
|
122
|
+
fileName: optionalTrimmedString
|
|
123
|
+
});
|
|
124
|
+
var confirmBodySchema = z.object({
|
|
125
|
+
key: trimmedString,
|
|
126
|
+
bucket: optionalTrimmedString
|
|
127
|
+
});
|
|
128
|
+
var downloadQuerySchema = z.object({
|
|
129
|
+
key: trimmedString,
|
|
130
|
+
bucket: optionalTrimmedString,
|
|
131
|
+
fileName: optionalTrimmedString,
|
|
132
|
+
expiresIn: z.coerce.number().positive().optional()
|
|
133
|
+
});
|
|
134
|
+
var deleteQuerySchema = z.object({
|
|
135
|
+
key: trimmedString,
|
|
136
|
+
bucket: optionalTrimmedString
|
|
137
|
+
});
|
|
138
|
+
var multipartInitBodySchema = uploadBodySchema;
|
|
139
|
+
var multipartSignPartBodySchema = z.object({
|
|
140
|
+
key: trimmedString,
|
|
141
|
+
uploadId: trimmedString,
|
|
142
|
+
partNumber: z.number().int().positive(),
|
|
143
|
+
partSize: z.number().positive().optional(),
|
|
144
|
+
bucket: optionalTrimmedString,
|
|
145
|
+
expiresIn: z.number().positive().optional()
|
|
146
|
+
});
|
|
147
|
+
var multipartListPartsQuerySchema = z.object({
|
|
148
|
+
key: trimmedString,
|
|
149
|
+
uploadId: trimmedString,
|
|
150
|
+
bucket: optionalTrimmedString
|
|
151
|
+
});
|
|
152
|
+
var multipartCompleteBodySchema = z.object({
|
|
153
|
+
key: trimmedString,
|
|
154
|
+
uploadId: trimmedString,
|
|
155
|
+
parts: z.array(z.object({ partNumber: z.number().int().positive() })).min(1),
|
|
156
|
+
bucket: optionalTrimmedString
|
|
157
|
+
});
|
|
158
|
+
var multipartAbortBodySchema = z.object({
|
|
159
|
+
key: trimmedString,
|
|
160
|
+
uploadId: trimmedString,
|
|
161
|
+
bucket: optionalTrimmedString
|
|
162
|
+
});
|
|
163
|
+
var s3ErrorParamsSchema = z.record(
|
|
164
|
+
z.string(),
|
|
165
|
+
z.union([z.string(), z.number()])
|
|
166
|
+
);
|
|
167
|
+
var s3FetchErrorSchema = z.object({
|
|
168
|
+
message: z.string(),
|
|
169
|
+
code: z.string().optional(),
|
|
170
|
+
params: s3ErrorParamsSchema.optional()
|
|
171
|
+
});
|
|
172
|
+
|
|
173
|
+
// src/error-codes.ts
|
|
174
|
+
function defineErrorCodes(messages) {
|
|
175
|
+
const codes = {};
|
|
176
|
+
for (const code of Object.keys(messages)) {
|
|
177
|
+
codes[code] = { code, message: messages[code] };
|
|
178
|
+
}
|
|
179
|
+
return codes;
|
|
180
|
+
}
|
|
181
|
+
var S3_ERROR_CODES = defineErrorCodes({
|
|
182
|
+
NOT_FOUND: "Not Found",
|
|
183
|
+
UNAUTHORIZED: "Unauthorized",
|
|
184
|
+
FORBIDDEN: "Forbidden",
|
|
185
|
+
CONFLICT: "Conflict",
|
|
186
|
+
INTERNAL_ERROR: "Internal server error",
|
|
187
|
+
OBJECT_NOT_FOUND: "Object not found",
|
|
188
|
+
FEATURE_DISABLED: "{feature} is disabled",
|
|
189
|
+
INVALID_KEY: "Object key is invalid",
|
|
190
|
+
INVALID_BUCKET: "Bucket is not allowed",
|
|
191
|
+
S3_NETWORK_ERROR: "S3 endpoint unreachable ({code}): check your endpoint URL and network connectivity",
|
|
192
|
+
FILE_SIZE_REQUIRED_UPLOAD: "fileSize is required when upload.requireFileSize is enabled",
|
|
193
|
+
FILE_SIZE_REQUIRED_MULTIPART: "fileSize is required when multipart.requireFileSize is enabled",
|
|
194
|
+
VALIDATION_ERROR: "Validation Error"
|
|
195
|
+
});
|
|
102
196
|
|
|
103
197
|
// src/error.ts
|
|
104
|
-
var
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
INTERNAL_ERROR: "INTERNAL_ERROR",
|
|
109
|
-
OBJECT_NOT_FOUND: "OBJECT_NOT_FOUND",
|
|
110
|
-
S3_NETWORK_ERROR: "S3_NETWORK_ERROR",
|
|
111
|
-
FIELD_REQUIRED: "FIELD_REQUIRED",
|
|
112
|
-
KEY_REQUIRED: "KEY_REQUIRED",
|
|
113
|
-
UPLOAD_ID_REQUIRED: "UPLOAD_ID_REQUIRED",
|
|
114
|
-
PART_NUMBER_INVALID: "PART_NUMBER_INVALID",
|
|
115
|
-
PARTS_REQUIRED: "PARTS_REQUIRED",
|
|
116
|
-
FILE_SIZE_REQUIRED_UPLOAD: "FILE_SIZE_REQUIRED_UPLOAD",
|
|
117
|
-
FILE_SIZE_REQUIRED_MULTIPART: "FILE_SIZE_REQUIRED_MULTIPART"
|
|
118
|
-
};
|
|
119
|
-
var DimahS3Error = class extends Error {
|
|
120
|
-
status;
|
|
121
|
-
code;
|
|
122
|
-
params;
|
|
123
|
-
constructor(message, status = 400, options) {
|
|
124
|
-
super(
|
|
125
|
-
message,
|
|
126
|
-
options?.cause !== void 0 ? { cause: options.cause } : void 0
|
|
127
|
-
);
|
|
198
|
+
var DimahS3Error = class _DimahS3Error extends APIError {
|
|
199
|
+
constructor(status = "BAD_REQUEST", body, headers) {
|
|
200
|
+
const { cause, ...rest } = body ?? {};
|
|
201
|
+
super(status, Object.keys(rest).length > 0 ? rest : void 0, headers);
|
|
128
202
|
this.name = "DimahS3Error";
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
203
|
+
if (cause !== void 0) {
|
|
204
|
+
this.cause = cause;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
get code() {
|
|
208
|
+
return this.body?.code;
|
|
209
|
+
}
|
|
210
|
+
get params() {
|
|
211
|
+
return this.body?.params;
|
|
212
|
+
}
|
|
213
|
+
/** Throw a catalog (or custom) `{ code, message }` with an HTTP status. */
|
|
214
|
+
static from(status, error) {
|
|
215
|
+
return new _DimahS3Error(status, {
|
|
216
|
+
message: error.message,
|
|
217
|
+
code: error.code,
|
|
218
|
+
...error.params !== void 0 ? { params: error.params } : {}
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
static fromStatus(status, body) {
|
|
222
|
+
return new _DimahS3Error(status, body);
|
|
132
223
|
}
|
|
133
224
|
};
|
|
225
|
+
function isAPIError(error) {
|
|
226
|
+
if (error instanceof APIError) return true;
|
|
227
|
+
const name = error?.name;
|
|
228
|
+
return name === "APIError" || name === "DimahS3Error";
|
|
229
|
+
}
|
|
230
|
+
function isDimahS3Error(error) {
|
|
231
|
+
return error instanceof DimahS3Error || error?.name === "DimahS3Error";
|
|
232
|
+
}
|
|
233
|
+
function isS3ErrorCode(error, code) {
|
|
234
|
+
return isDimahS3Error(error) && error.code === code;
|
|
235
|
+
}
|
|
134
236
|
|
|
135
237
|
// src/routes.ts
|
|
136
238
|
var S3_API_BASE_PATH = "/api/s3";
|
|
@@ -138,96 +240,60 @@ function normalizeS3ApiBasePath(basePath) {
|
|
|
138
240
|
return basePath.replace(/\/$/, "");
|
|
139
241
|
}
|
|
140
242
|
var S3_API_ROUTES = {
|
|
141
|
-
upload: "presign/upload",
|
|
142
|
-
uploadConfirm: "presign/upload/confirm",
|
|
143
|
-
download: "presign/download",
|
|
144
|
-
delete: "delete",
|
|
145
|
-
multipartInit: "presign/multipart/init",
|
|
146
|
-
multipartPart: "presign/multipart/part",
|
|
147
|
-
multipartComplete: "presign/multipart/complete",
|
|
148
|
-
multipartAbort: "presign/multipart/abort",
|
|
149
|
-
multipartListParts: "presign/multipart/parts"
|
|
243
|
+
upload: "/presign/upload",
|
|
244
|
+
uploadConfirm: "/presign/upload/confirm",
|
|
245
|
+
download: "/presign/download",
|
|
246
|
+
delete: "/delete",
|
|
247
|
+
multipartInit: "/presign/multipart/init",
|
|
248
|
+
multipartPart: "/presign/multipart/part",
|
|
249
|
+
multipartComplete: "/presign/multipart/complete",
|
|
250
|
+
multipartAbort: "/presign/multipart/abort",
|
|
251
|
+
multipartListParts: "/presign/multipart/parts"
|
|
150
252
|
};
|
|
151
|
-
|
|
152
|
-
// src/plugin/create-fetcher.ts
|
|
153
|
-
function buildQuery(query) {
|
|
154
|
-
if (!query) return "";
|
|
155
|
-
const params = new URLSearchParams();
|
|
156
|
-
for (const [key, value] of Object.entries(query)) {
|
|
157
|
-
if (value === void 0) continue;
|
|
158
|
-
params.set(key, String(value));
|
|
159
|
-
}
|
|
160
|
-
const qs = params.toString();
|
|
161
|
-
return qs ? `?${qs}` : "";
|
|
162
|
-
}
|
|
163
253
|
async function resolveHeaders(headers) {
|
|
164
254
|
if (headers == null) return void 0;
|
|
165
255
|
if (typeof headers === "function") return headers();
|
|
166
256
|
return headers;
|
|
167
257
|
}
|
|
168
|
-
function
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
if (!part) continue;
|
|
172
|
-
const h = new Headers(part);
|
|
173
|
-
h.forEach((value, key) => {
|
|
174
|
-
out[key] = value;
|
|
175
|
-
});
|
|
258
|
+
function fallbackMessage(error) {
|
|
259
|
+
if (typeof error.error === "string" && error.error.trim()) {
|
|
260
|
+
return error.error;
|
|
176
261
|
}
|
|
177
|
-
return
|
|
262
|
+
return error.statusText || "Request failed";
|
|
178
263
|
}
|
|
179
|
-
function
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
const extraHeaders = await resolveHeaders(options?.headers);
|
|
189
|
-
const res = await fetchImpl(url, {
|
|
190
|
-
...init,
|
|
191
|
-
credentials: options?.credentials ?? init?.credentials,
|
|
192
|
-
headers: mergeHeaders(extraHeaders, init?.headers)
|
|
264
|
+
function dimahErrorFromFetch(error) {
|
|
265
|
+
const status = error.status;
|
|
266
|
+
const parsed = s3FetchErrorSchema.safeParse(error);
|
|
267
|
+
if (parsed.success) {
|
|
268
|
+
const { message, code, params } = parsed.data;
|
|
269
|
+
return new DimahS3Error(status, {
|
|
270
|
+
message,
|
|
271
|
+
...code !== void 0 ? { code } : {},
|
|
272
|
+
...params !== void 0 ? { params } : {}
|
|
193
273
|
});
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
...jsonBody(body)
|
|
211
|
-
});
|
|
212
|
-
},
|
|
213
|
-
put(path, body) {
|
|
214
|
-
return json(`${base}/${path}`, {
|
|
215
|
-
method: "PUT",
|
|
216
|
-
...jsonBody(body)
|
|
217
|
-
});
|
|
218
|
-
},
|
|
219
|
-
patch(path, body) {
|
|
220
|
-
return json(`${base}/${path}`, {
|
|
221
|
-
method: "PATCH",
|
|
222
|
-
...jsonBody(body)
|
|
274
|
+
}
|
|
275
|
+
return new DimahS3Error(status, { message: fallbackMessage(error) });
|
|
276
|
+
}
|
|
277
|
+
function createS3Fetch(base, options) {
|
|
278
|
+
return createFetch({
|
|
279
|
+
baseURL: base,
|
|
280
|
+
throw: true,
|
|
281
|
+
errorSchema: s3FetchErrorSchema,
|
|
282
|
+
customFetchImpl: options?.fetch,
|
|
283
|
+
credentials: options?.credentials,
|
|
284
|
+
onRequest: async (ctx) => {
|
|
285
|
+
const extra = await resolveHeaders(options?.headers);
|
|
286
|
+
if (!extra) return ctx;
|
|
287
|
+
const headers = new Headers(ctx.headers);
|
|
288
|
+
new Headers(extra).forEach((value, key) => {
|
|
289
|
+
headers.set(key, value);
|
|
223
290
|
});
|
|
291
|
+
return { ...ctx, headers };
|
|
224
292
|
},
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
method: "DELETE"
|
|
228
|
-
});
|
|
293
|
+
onError: (ctx) => {
|
|
294
|
+
throw dimahErrorFromFetch(ctx.error);
|
|
229
295
|
}
|
|
230
|
-
};
|
|
296
|
+
});
|
|
231
297
|
}
|
|
232
298
|
|
|
233
299
|
// src/plugin/define-client-plugin.ts
|
|
@@ -235,9 +301,9 @@ function defineClientPlugin(plugin) {
|
|
|
235
301
|
return plugin;
|
|
236
302
|
}
|
|
237
303
|
|
|
238
|
-
// src/plugin/plugin-
|
|
239
|
-
function
|
|
240
|
-
return
|
|
304
|
+
// src/plugin/plugin-path.ts
|
|
305
|
+
function pluginPath(pluginId, path) {
|
|
306
|
+
return `/${pluginId}/${path.replace(/^\/+/, "")}`;
|
|
241
307
|
}
|
|
242
308
|
|
|
243
309
|
// src/plugin/types.ts
|
|
@@ -246,7 +312,12 @@ var RESERVED_CLIENT_KEYS = [
|
|
|
246
312
|
"confirm",
|
|
247
313
|
"download",
|
|
248
314
|
"delete",
|
|
249
|
-
"multipart"
|
|
315
|
+
"multipart",
|
|
316
|
+
"$ERROR_CODES",
|
|
317
|
+
"$fetch",
|
|
318
|
+
"$Infer",
|
|
319
|
+
"Provider",
|
|
320
|
+
"useApi"
|
|
250
321
|
];
|
|
251
322
|
|
|
252
323
|
// src/create-s3-client.ts
|
|
@@ -254,72 +325,82 @@ function withoutHeaders(value) {
|
|
|
254
325
|
const { headers: _headers, ...rest } = value;
|
|
255
326
|
return rest;
|
|
256
327
|
}
|
|
257
|
-
function
|
|
258
|
-
|
|
259
|
-
const base = normalizeS3ApiBasePath(basePath ?? S3_API_BASE_PATH);
|
|
260
|
-
const fetcher = createFetcher(base, fetchOptions);
|
|
261
|
-
const api = {
|
|
328
|
+
function createCoreApi($fetch) {
|
|
329
|
+
return {
|
|
262
330
|
upload(payload) {
|
|
263
|
-
return
|
|
264
|
-
|
|
265
|
-
withoutHeaders(payload)
|
|
266
|
-
);
|
|
331
|
+
return $fetch(S3_API_ROUTES.upload, {
|
|
332
|
+
method: "POST",
|
|
333
|
+
body: withoutHeaders(payload)
|
|
334
|
+
});
|
|
267
335
|
},
|
|
268
336
|
confirm(payload) {
|
|
269
|
-
return
|
|
270
|
-
|
|
271
|
-
withoutHeaders(payload)
|
|
272
|
-
);
|
|
337
|
+
return $fetch(S3_API_ROUTES.uploadConfirm, {
|
|
338
|
+
method: "POST",
|
|
339
|
+
body: withoutHeaders(payload)
|
|
340
|
+
});
|
|
273
341
|
},
|
|
274
|
-
download(key,
|
|
275
|
-
const { fileName, bucket } =
|
|
276
|
-
return
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
342
|
+
download(key, options) {
|
|
343
|
+
const { fileName, bucket, expiresIn } = options ?? {};
|
|
344
|
+
return $fetch(S3_API_ROUTES.download, {
|
|
345
|
+
method: "GET",
|
|
346
|
+
query: {
|
|
347
|
+
key,
|
|
348
|
+
fileName: fileName ? sanitizeFileName(fileName) : void 0,
|
|
349
|
+
bucket,
|
|
350
|
+
expiresIn
|
|
351
|
+
}
|
|
280
352
|
});
|
|
281
353
|
},
|
|
282
|
-
delete(key,
|
|
283
|
-
const { bucket } =
|
|
284
|
-
return
|
|
285
|
-
|
|
286
|
-
bucket
|
|
354
|
+
delete(key, options) {
|
|
355
|
+
const { bucket } = options ?? {};
|
|
356
|
+
return $fetch(S3_API_ROUTES.delete, {
|
|
357
|
+
method: "DELETE",
|
|
358
|
+
query: { key, bucket }
|
|
287
359
|
});
|
|
288
360
|
},
|
|
289
361
|
multipart: {
|
|
290
362
|
init(payload) {
|
|
291
|
-
return
|
|
292
|
-
|
|
293
|
-
withoutHeaders(payload)
|
|
294
|
-
);
|
|
363
|
+
return $fetch(S3_API_ROUTES.multipartInit, {
|
|
364
|
+
method: "POST",
|
|
365
|
+
body: withoutHeaders(payload)
|
|
366
|
+
});
|
|
295
367
|
},
|
|
296
368
|
signPart(payload) {
|
|
297
|
-
return
|
|
298
|
-
|
|
299
|
-
withoutHeaders(payload)
|
|
300
|
-
);
|
|
369
|
+
return $fetch(S3_API_ROUTES.multipartPart, {
|
|
370
|
+
method: "POST",
|
|
371
|
+
body: withoutHeaders(payload)
|
|
372
|
+
});
|
|
301
373
|
},
|
|
302
374
|
listParts(payload) {
|
|
303
375
|
const { key, uploadId, bucket } = withoutHeaders(payload);
|
|
304
|
-
return
|
|
376
|
+
return $fetch(
|
|
305
377
|
S3_API_ROUTES.multipartListParts,
|
|
306
|
-
{ key, uploadId, bucket }
|
|
378
|
+
{ method: "GET", query: { key, uploadId, bucket } }
|
|
307
379
|
);
|
|
308
380
|
},
|
|
309
381
|
complete(payload) {
|
|
310
|
-
return
|
|
382
|
+
return $fetch(
|
|
311
383
|
S3_API_ROUTES.multipartComplete,
|
|
312
|
-
|
|
384
|
+
{
|
|
385
|
+
method: "POST",
|
|
386
|
+
body: withoutHeaders(payload)
|
|
387
|
+
}
|
|
313
388
|
);
|
|
314
389
|
},
|
|
315
390
|
abort(payload) {
|
|
316
|
-
return
|
|
317
|
-
|
|
318
|
-
withoutHeaders(payload)
|
|
319
|
-
);
|
|
391
|
+
return $fetch(S3_API_ROUTES.multipartAbort, {
|
|
392
|
+
method: "POST",
|
|
393
|
+
body: withoutHeaders(payload)
|
|
394
|
+
});
|
|
320
395
|
}
|
|
321
396
|
}
|
|
322
397
|
};
|
|
398
|
+
}
|
|
399
|
+
function createS3Client(options) {
|
|
400
|
+
const { basePath, baseURL, plugins, ...fetchOptions } = options ?? {};
|
|
401
|
+
const base = normalizeS3ApiBasePath(baseURL ?? basePath ?? S3_API_BASE_PATH);
|
|
402
|
+
const $fetch = createS3Fetch(base, fetchOptions);
|
|
403
|
+
const api = createCoreApi($fetch);
|
|
323
404
|
const pluginMethods = {};
|
|
324
405
|
for (const plugin of plugins ?? []) {
|
|
325
406
|
if (RESERVED_CLIENT_KEYS.includes(plugin.id)) {
|
|
@@ -330,11 +411,17 @@ function createS3Client(options) {
|
|
|
330
411
|
if (plugin.id in pluginMethods) {
|
|
331
412
|
throw new Error(`Duplicate client plugin id "${plugin.id}".`);
|
|
332
413
|
}
|
|
333
|
-
pluginMethods[plugin.id] = plugin.
|
|
414
|
+
pluginMethods[plugin.id] = plugin.getActions($fetch);
|
|
334
415
|
}
|
|
335
|
-
return {
|
|
416
|
+
return {
|
|
417
|
+
...api,
|
|
418
|
+
...pluginMethods,
|
|
419
|
+
$ERROR_CODES: S3_ERROR_CODES,
|
|
420
|
+
$fetch,
|
|
421
|
+
$Infer: {}
|
|
422
|
+
};
|
|
336
423
|
}
|
|
337
424
|
|
|
338
|
-
export { DimahS3Error, RESERVED_CLIENT_KEYS, S3_API_BASE_PATH, S3_API_ROUTES, S3_ERROR_CODES, buildContentDisposition, buildObjectKey,
|
|
425
|
+
export { DimahS3Error, RESERVED_CLIENT_KEYS, S3_API_BASE_PATH, S3_API_ROUTES, S3_ERROR_CODES, buildContentDisposition, buildObjectKey, confirmBodySchema, createS3Client, createS3Fetch, defaultObjectKey, defineClientPlugin, defineErrorCodes, deleteQuerySchema, downloadQuerySchema, formatFileSize, getFileExtension, isAPIError, isDimahS3Error, isS3ErrorCode, metadataSchema, multipartAbortBodySchema, multipartCompleteBodySchema, multipartInitBodySchema, multipartListPartsQuerySchema, multipartSignPartBodySchema, normalizeS3ApiBasePath, optionalTrimmedString, parseFileName, pluginPath, s3ErrorParamsSchema, s3FetchErrorSchema, s3ObjectAclSchema, sanitizeFileName, trimmedString, truncateFileName, uploadBodySchema, validateFile };
|
|
339
426
|
//# sourceMappingURL=index.js.map
|
|
340
427
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/helpers/validate-file.ts","../src/helpers/build-object-key.ts","../src/helpers/get-file-extension.ts","../src/helpers/parse-file-name.ts","../src/helpers/format-file-size.ts","../src/helpers/build-content-disposition.ts","../src/helpers/sanitize-file-name.ts","../src/helpers/truncate-file-name.ts","../src/error.ts","../src/routes.ts","../src/plugin/create-fetcher.ts","../src/plugin/define-client-plugin.ts","../src/plugin/plugin-endpoint-path.ts","../src/plugin/types.ts","../src/create-s3-client.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["/** Machine-readable codes for client-side file validation failures. */\nexport type ValidateFileErrorCode =\n \"FILE_TYPE_NOT_ALLOWED\" | \"FILE_EMPTY\" | \"FILE_TOO_LARGE\";\n\n/** Result of {@link validateFile} when the file fails a check. */\nexport type ValidateFileError = {\n code: ValidateFileErrorCode;\n /** English fallback message (localize via Fuma when a translator is available). */\n message: string;\n /** Interpolation params for i18n (e.g. `{ type }`, `{ size }`). */\n params?: Record<string, string | number>;\n};\n\n/**\n * Client-side accept / size / empty checks before starting an upload.\n * Returns `null` when the file is valid.\n */\nexport function validateFile(\n file: File,\n options: { accept?: string[]; maxFileSize?: number },\n): ValidateFileError | null {\n if (options.accept?.length) {\n const allowed = options.accept.some((type) => {\n if (type.startsWith(\".\")) {\n return file.name.toLowerCase().endsWith(type.toLowerCase());\n }\n if (type.endsWith(\"/*\")) {\n return file.type.startsWith(type.replace(\"/*\", \"/\"));\n }\n return file.type === type;\n });\n if (!allowed) {\n const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n const type = ext ? `.${ext}` : file.type || \"unknown\";\n return {\n code: \"FILE_TYPE_NOT_ALLOWED\",\n message: `File type \"${type}\" is not allowed`,\n params: { type },\n };\n }\n }\n\n if (file.size === 0) {\n return {\n code: \"FILE_EMPTY\",\n message: \"File is empty\",\n };\n }\n\n if (options.maxFileSize && file.size > options.maxFileSize) {\n const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n return {\n code: \"FILE_TOO_LARGE\",\n message: `File size exceeds ${maxMB} MB limit`,\n params: { size: `${maxMB} MB` },\n };\n }\n\n return null;\n}\n","export function buildObjectKey(...parts: string[]): string {\n return parts\n .map((p) => p.replace(/^\\/+|\\/+$/g, \"\"))\n .filter(Boolean)\n .join(\"/\");\n}\n","export function getFileExtension(fileName: string): string {\n const dotIndex = fileName.lastIndexOf(\".\");\n if (dotIndex < 1) return \"\";\n return fileName.slice(dotIndex + 1).toLowerCase();\n}\n","export function parseFileName(\n contentDisposition: string | null | undefined,\n): string | undefined {\n if (!contentDisposition) return undefined;\n\n const utf8Match = contentDisposition.match(/filename\\*=UTF-8''([^;,\\s]+)/i);\n if (utf8Match) {\n try {\n return decodeURIComponent(utf8Match[1]);\n } catch {\n /* ignore malformed encoding */\n }\n }\n\n const asciiMatch = contentDisposition.match(/filename=\"([^\"]*)\"/i);\n return asciiMatch?.[1];\n}\n","export function formatFileSize(bytes: number): string {\n if (bytes === 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n const i = Math.floor(Math.log(bytes) / Math.log(1024));\n const size = bytes / Math.pow(1024, i);\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(fileName: string): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for safe use in URL query parameters. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n}\n","/**\n * Truncates a filename while preserving the extension when possible.\n */\nexport function truncateFileName(name: string, maxChars = 48): string {\n if (name.length <= maxChars) return name;\n const dotIndex = name.lastIndexOf(\".\");\n if (dotIndex <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n const ext = name.slice(dotIndex);\n const available = maxChars - ext.length - 1;\n if (available <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n return name.slice(0, available) + \"… \" + ext;\n}\n\n/** @deprecated Use {@link truncateFileName}. */\nexport const truncateFilename = truncateFileName;\n","/** Stable API error codes returned in JSON `{ code, message, params? }`. */\nexport const S3_ERROR_CODES = {\n NOT_FOUND: \"NOT_FOUND\",\n INVALID_JSON: \"INVALID_JSON\",\n FORBIDDEN: \"FORBIDDEN\",\n INTERNAL_ERROR: \"INTERNAL_ERROR\",\n OBJECT_NOT_FOUND: \"OBJECT_NOT_FOUND\",\n S3_NETWORK_ERROR: \"S3_NETWORK_ERROR\",\n FIELD_REQUIRED: \"FIELD_REQUIRED\",\n KEY_REQUIRED: \"KEY_REQUIRED\",\n UPLOAD_ID_REQUIRED: \"UPLOAD_ID_REQUIRED\",\n PART_NUMBER_INVALID: \"PART_NUMBER_INVALID\",\n PARTS_REQUIRED: \"PARTS_REQUIRED\",\n FILE_SIZE_REQUIRED_UPLOAD: \"FILE_SIZE_REQUIRED_UPLOAD\",\n FILE_SIZE_REQUIRED_MULTIPART: \"FILE_SIZE_REQUIRED_MULTIPART\",\n} as const;\n\nexport type S3ErrorCode = (typeof S3_ERROR_CODES)[keyof typeof S3_ERROR_CODES];\n\nexport type DimahS3ErrorParams = Record<string, string | number>;\n\nexport type DimahS3ErrorOptions = {\n cause?: unknown;\n code?: S3ErrorCode | string;\n params?: DimahS3ErrorParams;\n};\n\n/** Typed API / procedure error with HTTP status and optional stable code. */\nexport class DimahS3Error extends Error {\n readonly status: number;\n readonly code?: S3ErrorCode | string;\n readonly params?: DimahS3ErrorParams;\n\n constructor(message: string, status = 400, options?: DimahS3ErrorOptions) {\n super(\n message,\n options?.cause !== undefined ? { cause: options.cause } : undefined,\n );\n this.name = \"DimahS3Error\";\n this.status = status;\n this.code = options?.code;\n this.params = options?.params;\n }\n}\n","/** Default mount path for the catch-all route (`app/api/s3/[...s3]/route.ts`). */\nexport const S3_API_BASE_PATH = \"/api/s3\";\n\nexport function normalizeS3ApiBasePath(basePath: string): string {\n return basePath.replace(/\\/$/, \"\");\n}\n\nexport const S3_API_ROUTES = {\n upload: \"presign/upload\",\n uploadConfirm: \"presign/upload/confirm\",\n download: \"presign/download\",\n delete: \"delete\",\n multipartInit: \"presign/multipart/init\",\n multipartPart: \"presign/multipart/part\",\n multipartComplete: \"presign/multipart/complete\",\n multipartAbort: \"presign/multipart/abort\",\n multipartListParts: \"presign/multipart/parts\",\n} as const;\n","import { DimahS3Error } from \"../error\";\nimport type { S3ClientFetcher, S3ClientFetchOptions } from \"./types\";\n\nfunction buildQuery(\n query?: Record<string, string | number | boolean | undefined>,\n): string {\n if (!query) return \"\";\n const params = new URLSearchParams();\n for (const [key, value] of Object.entries(query)) {\n if (value === undefined) continue;\n params.set(key, String(value));\n }\n const qs = params.toString();\n return qs ? `?${qs}` : \"\";\n}\n\nasync function resolveHeaders(\n headers: S3ClientFetchOptions[\"headers\"],\n): Promise<HeadersInit | undefined> {\n if (headers == null) return undefined;\n if (typeof headers === \"function\") return headers();\n return headers;\n}\n\nfunction mergeHeaders(\n ...parts: (HeadersInit | undefined)[]\n): Record<string, string> {\n const out: Record<string, string> = {};\n for (const part of parts) {\n if (!part) continue;\n const h = new Headers(part);\n h.forEach((value, key) => {\n out[key] = value;\n });\n }\n return out;\n}\n\nfunction jsonBody(body: unknown): RequestInit {\n return {\n headers: { \"Content-Type\": \"application/json\" },\n body: body === undefined ? undefined : JSON.stringify(body),\n };\n}\n\n/**\n * Shared fetch + JSON error parsing for core routes and client plugins.\n * `base` is a normalized API prefix (e.g. `/api/s3`).\n *\n * Non-OK responses throw {@link DimahS3Error} with the HTTP status — same\n * class as server procedures, so client and server error shapes stay aligned.\n */\nexport function createFetcher(\n base: string,\n options?: S3ClientFetchOptions,\n): S3ClientFetcher {\n const fetchImpl = options?.fetch ?? fetch;\n\n const json = async <T>(url: string, init?: RequestInit): Promise<T> => {\n const extraHeaders = await resolveHeaders(options?.headers);\n const res = await fetchImpl(url, {\n ...init,\n credentials: options?.credentials ?? init?.credentials,\n headers: mergeHeaders(extraHeaders, init?.headers),\n });\n if (!res.ok) {\n const body = (await res.json().catch(() => ({}))) as {\n message?: string;\n code?: string;\n params?: Record<string, string | number>;\n };\n throw new DimahS3Error(body.message ?? res.statusText, res.status, {\n code: body.code,\n params: body.params,\n });\n }\n return res.json() as Promise<T>;\n };\n\n return {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`);\n },\n post<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"POST\",\n ...jsonBody(body),\n });\n },\n put<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PUT\",\n ...jsonBody(body),\n });\n },\n patch<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PATCH\",\n ...jsonBody(body),\n });\n },\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`, {\n method: \"DELETE\",\n });\n },\n };\n}\n","import type { S3ClientPlugin } from \"./types\";\n\n/**\n * Identity helper that preserves literal `id` and method types for\n * {@link createS3Client} inference (`api[id]`).\n *\n * ```ts\n * export function dbClient() {\n * return defineClientPlugin({\n * id: \"db\",\n * createMethods: (fetcher) => ({\n * listObjects: () => fetcher.get(pluginEndpointPath(\"db\", \"objects\")),\n * }),\n * });\n * }\n * ```\n */\nexport function defineClientPlugin<\n Id extends string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n>(plugin: S3ClientPlugin<Id, TMethods>): S3ClientPlugin<Id, TMethods> {\n return plugin;\n}\n","/**\n * Build the relative path for a plugin HTTP endpoint under `basePath`.\n * Server mounts and client fetchers share this so URLs never diverge.\n *\n * @example\n * pluginEndpointPath(\"db\", \"objects\") // \"plugins/db/objects\"\n */\nexport function pluginEndpointPath(pluginId: string, path: string): string {\n return `plugins/${pluginId}/${path.replace(/^\\/+/, \"\")}`;\n}\n","/**\n * Optional fetch configuration for {@link createFetcher} / {@link createS3Client}.\n * Applied to core routes and every client plugin sharing the same fetcher.\n */\nexport type S3ClientFetchOptions = {\n /** Defaults to global `fetch` — override for SSR, tests, or logging. */\n fetch?: typeof fetch;\n /** e.g. `\"include\"` to send cookies cross-origin. */\n credentials?: RequestCredentials;\n /**\n * Static headers or a (possibly async) factory called per request —\n * useful for Authorization tokens.\n */\n headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n};\n\n/**\n * Shared HTTP helper used by core `S3Api` methods and client plugins.\n * Built once by {@link createFetcher} / {@link createS3Client}.\n */\nexport type S3ClientFetcher = {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n post<T>(path: string, body?: unknown): Promise<T>;\n put<T>(path: string, body?: unknown): Promise<T>;\n patch<T>(path: string, body?: unknown): Promise<T>;\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n};\n\n/**\n * Browser / isomorphic client plugin — mirrors server `DimahS3Plugin`\n * (literal `id` + methods flattened onto the `createS3Client` result).\n *\n * @typeParam Id — unique plugin id; becomes `api[id]`.\n * @typeParam TMethods — methods returned by {@link createMethods}.\n */\nexport type S3ClientPlugin<\n Id extends string = string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n> = {\n id: Id;\n /** Build typed methods that call plugin endpoints via the shared fetcher. */\n createMethods: (fetcher: S3ClientFetcher) => TMethods;\n};\n\n/** Map client plugin ids → their method bags. */\nexport type ClientPluginMethodsMap<P extends readonly S3ClientPlugin[]> = {\n [K in P[number] as K[\"id\"]]: K extends S3ClientPlugin<string, infer M>\n ? M\n : never;\n};\n\n/** Keys reserved on the `createS3Client` result — client plugins may not use these as ids. */\nexport const RESERVED_CLIENT_KEYS = [\n \"upload\",\n \"confirm\",\n \"download\",\n \"delete\",\n \"multipart\",\n] as const;\n\nexport type ReservedClientKey = (typeof RESERVED_CLIENT_KEYS)[number];\n","import type {\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n PresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n} from \"./types\";\nimport { sanitizeFileName } from \"./helpers/sanitize-file-name\";\nimport {\n createFetcher,\n RESERVED_CLIENT_KEYS,\n type ClientPluginMethodsMap,\n type S3ClientFetchOptions,\n type S3ClientPlugin,\n} from \"./plugin\";\nimport {\n normalizeS3ApiBasePath,\n S3_API_BASE_PATH,\n S3_API_ROUTES,\n} from \"./routes\";\n\n/** Options for {@link createS3Client}. */\nexport type CreateS3ClientOptions<\n P extends readonly S3ClientPlugin[] = readonly S3ClientPlugin[],\n> = {\n /** API path prefix — must match server `basePath`. @default \"/api/s3\" */\n basePath?: string;\n /** Client plugins (e.g. `dbClient()` from `@dimah-s3/db/client`). */\n plugins?: P;\n} & S3ClientFetchOptions;\n\n/** Strip server-only `headers` before sending over HTTP. */\nfunction withoutHeaders<T extends { headers?: HeadersInit }>(\n value: T,\n): Omit<T, \"headers\"> {\n const { headers: _headers, ...rest } = value;\n return rest;\n}\n\n/**\n * Browser (or isomorphic) client for the dimah-s3 HTTP API.\n *\n * For React apps prefer `createS3Client` from `@dimah-s3/react` — same options,\n * plus a bound `S3Provider` / typed `useApi`.\n *\n * ```ts\n * import { createS3Client } from \"@dimah-s3/core\";\n * import { dbClient } from \"@dimah-s3/db/client\";\n *\n * export const api = createS3Client({\n * basePath: \"/api/s3\",\n * plugins: [dbClient()],\n * });\n *\n * await api.db.listObjects();\n * ```\n */\nexport function createS3Client<const P extends readonly S3ClientPlugin[] = []>(\n options?: CreateS3ClientOptions<P>,\n): S3Api & ClientPluginMethodsMap<P> {\n const { basePath, plugins, ...fetchOptions } = options ?? {};\n const base = normalizeS3ApiBasePath(basePath ?? S3_API_BASE_PATH);\n const fetcher = createFetcher(base, fetchOptions);\n\n const api: S3Api = {\n upload(payload) {\n return fetcher.post<UploadPresignResponse>(\n S3_API_ROUTES.upload,\n withoutHeaders(payload),\n );\n },\n\n confirm(payload) {\n return fetcher.post<UploadConfirmResponse>(\n S3_API_ROUTES.uploadConfirm,\n withoutHeaders(payload),\n );\n },\n\n download(key, options?) {\n const { fileName, bucket } = options ?? {};\n return fetcher.get<PresignResponse>(S3_API_ROUTES.download, {\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n bucket,\n });\n },\n\n delete(key, options?) {\n const { bucket } = options ?? {};\n return fetcher.delete<DeleteResponse>(S3_API_ROUTES.delete, {\n key,\n bucket,\n });\n },\n\n multipart: {\n init(payload) {\n return fetcher.post<MultipartInitResponse>(\n S3_API_ROUTES.multipartInit,\n withoutHeaders(payload),\n );\n },\n\n signPart(payload) {\n return fetcher.post<MultipartPartResponse>(\n S3_API_ROUTES.multipartPart,\n withoutHeaders(payload),\n );\n },\n\n listParts(payload) {\n const { key, uploadId, bucket } = withoutHeaders(payload);\n return fetcher.get<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { key, uploadId, bucket },\n );\n },\n\n complete(payload) {\n return fetcher.post<MultipartCompleteResponse>(\n S3_API_ROUTES.multipartComplete,\n withoutHeaders(payload),\n );\n },\n\n abort(payload) {\n return fetcher.post<MultipartAbortResponse>(\n S3_API_ROUTES.multipartAbort,\n withoutHeaders(payload),\n );\n },\n },\n };\n\n const pluginMethods: Record<string, unknown> = {};\n for (const plugin of plugins ?? []) {\n if ((RESERVED_CLIENT_KEYS as readonly string[]).includes(plugin.id)) {\n throw new Error(\n `Client plugin id \"${plugin.id}\" is reserved on the S3 client.`,\n );\n }\n if (plugin.id in pluginMethods) {\n throw new Error(`Duplicate client plugin id \"${plugin.id}\".`);\n }\n pluginMethods[plugin.id] = plugin.createMethods(fetcher);\n }\n\n return { ...api, ...pluginMethods } as S3Api & ClientPluginMethodsMap<P>;\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/helpers/validate-file.ts","../src/helpers/build-object-key.ts","../src/helpers/get-file-extension.ts","../src/helpers/parse-file-name.ts","../src/helpers/format-file-size.ts","../src/helpers/build-content-disposition.ts","../src/helpers/sanitize-file-name.ts","../src/helpers/default-object-key.ts","../src/helpers/truncate-file-name.ts","../src/schema/shared.ts","../src/schema/upload.ts","../src/schema/download.ts","../src/schema/delete.ts","../src/schema/multipart.ts","../src/schema/error.ts","../src/error-codes.ts","../src/error.ts","../src/routes.ts","../src/plugin/create-s3-fetch.ts","../src/plugin/define-client-plugin.ts","../src/plugin/plugin-path.ts","../src/plugin/types.ts","../src/create-s3-client.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/** Machine-readable codes for client-side file validation failures. */\nexport type ValidateFileErrorCode =\n \"FILE_TYPE_NOT_ALLOWED\" | \"FILE_EMPTY\" | \"FILE_TOO_LARGE\";\n\n/** Result of {@link validateFile} when the file fails a check. */\nexport type ValidateFileError = {\n code: ValidateFileErrorCode;\n /** English fallback message (localize via Fuma when a translator is available). */\n message: string;\n /** Interpolation params for i18n (e.g. `{ type }`, `{ size }`). */\n params?: Record<string, string | number>;\n};\n\n/**\n * Client-side accept / size / empty checks before starting an upload.\n * Returns `null` when the file is valid.\n */\nexport function validateFile(\n file: File,\n options: { accept?: string[]; maxFileSize?: number },\n): ValidateFileError | null {\n if (options.accept?.length) {\n const allowed = options.accept.some((type) => {\n if (type.startsWith(\".\")) {\n return file.name.toLowerCase().endsWith(type.toLowerCase());\n }\n if (type.endsWith(\"/*\")) {\n return file.type.startsWith(type.replace(\"/*\", \"/\"));\n }\n return file.type === type;\n });\n if (!allowed) {\n const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n const type = ext ? `.${ext}` : file.type || \"unknown\";\n return {\n code: \"FILE_TYPE_NOT_ALLOWED\",\n message: `File type \"${type}\" is not allowed`,\n params: { type },\n };\n }\n }\n\n if (file.size === 0) {\n return {\n code: \"FILE_EMPTY\",\n message: \"File is empty\",\n };\n }\n\n if (options.maxFileSize && file.size > options.maxFileSize) {\n const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n return {\n code: \"FILE_TOO_LARGE\",\n message: `File size exceeds ${maxMB} MB limit`,\n params: { size: `${maxMB} MB` },\n };\n }\n\n return null;\n}\n","export function buildObjectKey(...parts: string[]): string {\n return parts\n .map((p) => p.replace(/^\\/+|\\/+$/g, \"\"))\n .filter(Boolean)\n .join(\"/\");\n}\n","export function getFileExtension(fileName: string): string {\n const dotIndex = fileName.lastIndexOf(\".\");\n if (dotIndex < 1) return \"\";\n return fileName.slice(dotIndex + 1).toLowerCase();\n}\n","export function parseFileName(\n contentDisposition: string | null | undefined,\n): string | undefined {\n if (!contentDisposition) return undefined;\n\n const utf8Match = contentDisposition.match(/filename\\*=UTF-8''([^;,\\s]+)/i);\n if (utf8Match) {\n try {\n return decodeURIComponent(utf8Match[1]);\n } catch {\n /* ignore malformed encoding */\n }\n }\n\n const asciiMatch = contentDisposition.match(/filename=\"([^\"]*)\"/i);\n return asciiMatch?.[1];\n}\n","export function formatFileSize(bytes: number): string {\n if (bytes === 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n const i = Math.floor(Math.log(bytes) / Math.log(1024));\n const size = bytes / Math.pow(1024, i);\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(fileName: string): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for safe use in URL query parameters. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n}\n","import { sanitizeFileName } from \"./sanitize-file-name\";\n\n/**\n * Default object key for client uploads: a UUID prefix plus the sanitized\n * file name so two selections never overwrite the same key.\n */\nexport function defaultObjectKey(file: File): string {\n return `${crypto.randomUUID()}/${sanitizeFileName(file.name)}`;\n}\n","/**\n * Truncates a filename while preserving the extension when possible.\n */\nexport function truncateFileName(name: string, maxChars = 48): string {\n if (name.length <= maxChars) return name;\n const dotIndex = name.lastIndexOf(\".\");\n if (dotIndex <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n const ext = name.slice(dotIndex);\n const available = maxChars - ext.length - 1;\n if (available <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n return name.slice(0, available) + \"… \" + ext;\n}\n","import { z } from \"zod\";\n\n/** Non-empty trimmed string. */\nexport const trimmedString = z.string().trim().min(1);\n\n/** Optional non-empty trimmed string (empty / missing → omitted). */\nexport const optionalTrimmedString = z.string().trim().min(1).optional();\n\nexport const s3ObjectAclSchema = z.enum([\"private\", \"public-read\"]);\n\nexport const metadataSchema = z.record(z.string(), z.string());\n","import { z } from \"zod\";\nimport {\n metadataSchema,\n optionalTrimmedString,\n s3ObjectAclSchema,\n trimmedString,\n} from \"./shared\";\n\nexport const uploadBodySchema = z.object({\n key: trimmedString,\n contentType: optionalTrimmedString,\n fileSize: z.number().positive().optional(),\n metadata: metadataSchema.optional(),\n bucket: optionalTrimmedString,\n expiresIn: z.number().positive().optional(),\n acl: s3ObjectAclSchema.optional(),\n fileName: optionalTrimmedString,\n});\n\nexport const confirmBodySchema = z.object({\n key: trimmedString,\n bucket: optionalTrimmedString,\n});\n","import { z } from \"zod\";\nimport { optionalTrimmedString, trimmedString } from \"./shared\";\n\n/** Query string — numbers arrive as strings. */\nexport const downloadQuerySchema = z.object({\n key: trimmedString,\n bucket: optionalTrimmedString,\n fileName: optionalTrimmedString,\n expiresIn: z.coerce.number().positive().optional(),\n});\n","import { z } from \"zod\";\nimport { optionalTrimmedString, trimmedString } from \"./shared\";\n\nexport const deleteQuerySchema = z.object({\n key: trimmedString,\n bucket: optionalTrimmedString,\n});\n","import { z } from \"zod\";\nimport { uploadBodySchema } from \"./upload\";\nimport { optionalTrimmedString, trimmedString } from \"./shared\";\n\nexport const multipartInitBodySchema = uploadBodySchema;\n\nexport const multipartSignPartBodySchema = z.object({\n key: trimmedString,\n uploadId: trimmedString,\n partNumber: z.number().int().positive(),\n partSize: z.number().positive().optional(),\n bucket: optionalTrimmedString,\n expiresIn: z.number().positive().optional(),\n});\n\nexport const multipartListPartsQuerySchema = z.object({\n key: trimmedString,\n uploadId: trimmedString,\n bucket: optionalTrimmedString,\n});\n\nexport const multipartCompleteBodySchema = z.object({\n key: trimmedString,\n uploadId: trimmedString,\n parts: z.array(z.object({ partNumber: z.number().int().positive() })).min(1),\n bucket: optionalTrimmedString,\n});\n\nexport const multipartAbortBodySchema = z.object({\n key: trimmedString,\n uploadId: trimmedString,\n bucket: optionalTrimmedString,\n});\n","import { z } from \"zod\";\n\n/** `params` bag on API error JSON. */\nexport const s3ErrorParamsSchema = z.record(\n z.string(),\n z.union([z.string(), z.number()]),\n);\n\n/**\n * better-fetch `errorSchema` — same `{ message, code?, params? }` body\n * better-call serializes from `DimahS3Error`.\n */\nexport const s3FetchErrorSchema = z.object({\n message: z.string(),\n code: z.string().optional(),\n params: s3ErrorParamsSchema.optional(),\n});\n\nexport type S3FetchError = z.infer<typeof s3FetchErrorSchema>;\n","/**\n * Pair each stable API `code` with its English `message`.\n * Same shape as Better Auth `defineErrorCodes`.\n */\nexport function defineErrorCodes<const T extends Record<string, string>>(\n messages: T,\n): { readonly [K in keyof T]: { readonly code: K; readonly message: T[K] } } {\n const codes = {} as {\n [K in keyof T]: { readonly code: K; readonly message: T[K] };\n };\n for (const code of Object.keys(messages) as (keyof T)[]) {\n codes[code] = { code, message: messages[code] };\n }\n return codes;\n}\n\n/**\n * Domain error catalog. Zod failures share {@link S3_ERROR_CODES.VALIDATION_ERROR};\n * HTTP 404 for unknown routes uses {@link S3_ERROR_CODES.NOT_FOUND}.\n */\nexport const S3_ERROR_CODES = defineErrorCodes({\n NOT_FOUND: \"Not Found\",\n UNAUTHORIZED: \"Unauthorized\",\n FORBIDDEN: \"Forbidden\",\n CONFLICT: \"Conflict\",\n INTERNAL_ERROR: \"Internal server error\",\n OBJECT_NOT_FOUND: \"Object not found\",\n FEATURE_DISABLED: \"{feature} is disabled\",\n INVALID_KEY: \"Object key is invalid\",\n INVALID_BUCKET: \"Bucket is not allowed\",\n S3_NETWORK_ERROR:\n \"S3 endpoint unreachable ({code}): check your endpoint URL and network connectivity\",\n FILE_SIZE_REQUIRED_UPLOAD:\n \"fileSize is required when upload.requireFileSize is enabled\",\n FILE_SIZE_REQUIRED_MULTIPART:\n \"fileSize is required when multipart.requireFileSize is enabled\",\n VALIDATION_ERROR: \"Validation Error\",\n});\n\nexport type S3ErrorCode = keyof typeof S3_ERROR_CODES;\n","import { APIError } from \"better-call/error\";\nimport { type S3ErrorCode } from \"./error-codes\";\n\nexport {\n defineErrorCodes,\n S3_ERROR_CODES,\n type S3ErrorCode,\n} from \"./error-codes\";\n\nexport type DimahS3ErrorParams = Record<string, string | number>;\n\nexport type DimahS3ErrorStatus = NonNullable<\n ConstructorParameters<typeof APIError>[0]\n>;\n\nexport type DimahS3ErrorBody = {\n message?: string;\n code?: string;\n cause?: unknown;\n params?: DimahS3ErrorParams;\n} & Record<string, unknown>;\n\ntype RawError = {\n code: string;\n message: string;\n params?: DimahS3ErrorParams;\n};\n\n/**\n * Typed API error. Same constructor as better-call {@link APIError}\n * (`status`, `body`) so `ctx.error(...)` and `DimahS3Error.from(...)` share\n * a shape. HTTP serializes `{ message, code?, params? }` via native `toResponse`.\n */\nexport class DimahS3Error extends APIError {\n constructor(\n status: DimahS3ErrorStatus = \"BAD_REQUEST\",\n body?: DimahS3ErrorBody,\n headers?: HeadersInit,\n ) {\n const { cause, ...rest } = body ?? {};\n super(status, Object.keys(rest).length > 0 ? rest : undefined, headers);\n this.name = \"DimahS3Error\";\n if (cause !== undefined) {\n this.cause = cause;\n }\n }\n\n get code(): string | undefined {\n return this.body?.code;\n }\n\n get params(): DimahS3ErrorParams | undefined {\n return this.body?.params as DimahS3ErrorParams | undefined;\n }\n\n /** Throw a catalog (or custom) `{ code, message }` with an HTTP status. */\n static from(status: DimahS3ErrorStatus, error: RawError): DimahS3Error {\n return new DimahS3Error(status, {\n message: error.message,\n code: error.code,\n ...(error.params !== undefined ? { params: error.params } : {}),\n });\n }\n\n static fromStatus(\n status: DimahS3ErrorStatus,\n body?: DimahS3ErrorBody,\n ): DimahS3Error {\n return new DimahS3Error(status, body);\n }\n}\n\n/** True for {@link DimahS3Error} and better-call `APIError` (including duck-typed copies). */\nexport function isAPIError(error: unknown): error is APIError {\n if (error instanceof APIError) return true;\n const name = (error as { name?: string } | null)?.name;\n return name === \"APIError\" || name === \"DimahS3Error\";\n}\n\nexport function isDimahS3Error(error: unknown): error is DimahS3Error {\n return (\n error instanceof DimahS3Error ||\n (error as { name?: string } | null)?.name === \"DimahS3Error\"\n );\n}\n\n/** True when `error` is a {@link DimahS3Error} with this catalog `code`. */\nexport function isS3ErrorCode<C extends S3ErrorCode>(\n error: unknown,\n code: C,\n): error is DimahS3Error & { code: C } {\n return isDimahS3Error(error) && error.code === code;\n}\n","/** Default mount path for the catch-all route (`app/api/s3/[...s3]/route.ts`). */\nexport const S3_API_BASE_PATH = \"/api/s3\";\n\nexport function normalizeS3ApiBasePath(basePath: string): string {\n return basePath.replace(/\\/$/, \"\");\n}\n\n/** Relative paths under {@link S3_API_BASE_PATH}. Always start with `/`. */\nexport const S3_API_ROUTES = {\n upload: \"/presign/upload\",\n uploadConfirm: \"/presign/upload/confirm\",\n download: \"/presign/download\",\n delete: \"/delete\",\n multipartInit: \"/presign/multipart/init\",\n multipartPart: \"/presign/multipart/part\",\n multipartComplete: \"/presign/multipart/complete\",\n multipartAbort: \"/presign/multipart/abort\",\n multipartListParts: \"/presign/multipart/parts\",\n} as const;\n","import { createFetch } from \"@better-fetch/fetch\";\nimport type { Status } from \"better-call/error\";\nimport { DimahS3Error } from \"../error\";\nimport { s3FetchErrorSchema } from \"../schema/error\";\nimport type { S3ClientFetchOptions, S3Fetch } from \"./types\";\n\nasync function resolveHeaders(\n headers: S3ClientFetchOptions[\"headers\"],\n): Promise<HeadersInit | undefined> {\n if (headers == null) return undefined;\n if (typeof headers === \"function\") return headers();\n return headers;\n}\n\nfunction fallbackMessage(error: {\n statusText: string;\n error?: unknown;\n}): string {\n if (typeof error.error === \"string\" && error.error.trim()) {\n return error.error;\n }\n return error.statusText || \"Request failed\";\n}\n\n/**\n * better-fetch `onError` receives the JSON body spread with `status` /\n * `statusText` — not a `BetterFetchError` instance.\n */\nfunction dimahErrorFromFetch(error: {\n status: number;\n statusText: string;\n error?: unknown;\n}): DimahS3Error {\n const status = error.status as Status;\n const parsed = s3FetchErrorSchema.safeParse(error);\n if (parsed.success) {\n const { message, code, params } = parsed.data;\n return new DimahS3Error(status, {\n message,\n ...(code !== undefined ? { code } : {}),\n ...(params !== undefined ? { params } : {}),\n });\n }\n return new DimahS3Error(status, { message: fallbackMessage(error) });\n}\n\n/**\n * Shared `$fetch` for core routes and client plugins.\n * `base` is a normalized API prefix (e.g. `/api/s3`).\n *\n * Non-OK JSON matching {@link s3FetchErrorSchema} throws {@link DimahS3Error}.\n * `throw: true` is the better-fetch flag; `onError` maps onto the same class\n * the server throws so `instanceof DimahS3Error` works in the browser.\n */\nexport function createS3Fetch(\n base: string,\n options?: S3ClientFetchOptions,\n): S3Fetch {\n return createFetch({\n baseURL: base,\n throw: true,\n errorSchema: s3FetchErrorSchema,\n customFetchImpl: options?.fetch,\n credentials: options?.credentials,\n onRequest: async (ctx) => {\n const extra = await resolveHeaders(options?.headers);\n if (!extra) return ctx;\n const headers = new Headers(ctx.headers);\n new Headers(extra).forEach((value, key) => {\n headers.set(key, value);\n });\n return { ...ctx, headers };\n },\n onError: (ctx) => {\n throw dimahErrorFromFetch(ctx.error);\n },\n });\n}\n","import type { S3ClientPlugin } from \"./types\";\n\n/**\n * Identity helper that preserves literal `id` and method types for\n * {@link createS3Client} inference (`api[id]`).\n *\n * `$InferServerPlugin` must share the same `id` as the client plugin.\n *\n * ```ts\n * export function dbClient() {\n * return defineClientPlugin({\n * id: \"db\",\n * $InferServerPlugin: {} as ReturnType<typeof db>,\n * getActions: ($fetch) => ({\n * listObjects: () => $fetch(\"/db/objects\", { method: \"GET\" }),\n * }),\n * });\n * }\n * ```\n */\nexport function defineClientPlugin<\n Id extends string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n TServer extends { id: Id } = { id: Id },\n>(\n plugin: S3ClientPlugin<Id, TMethods, TServer>,\n): S3ClientPlugin<Id, TMethods, TServer> {\n return plugin;\n}\n","/**\n * Build a plugin HTTP path under `basePath`.\n * Server endpoints and client `getActions` share this so URLs never diverge.\n *\n * @example\n * pluginPath(\"db\", \"objects\") // \"/db/objects\"\n */\nexport function pluginPath(pluginId: string, path: string): string {\n return `/${pluginId}/${path.replace(/^\\/+/, \"\")}`;\n}\n","import type { BetterFetch } from \"@better-fetch/fetch\";\n\n/**\n * Shared `$fetch` for core routes and client plugins.\n * Always created with `throw: true` and `errorSchema` (`s3FetchErrorSchema`) —\n * non-OK JSON becomes {@link DimahS3Error} via `onError`.\n */\nexport type S3Fetch = BetterFetch<{ throw: true }>;\n\n/**\n * Optional fetch configuration for {@link createS3Client}.\n * Applied to core routes and every client plugin sharing the same `$fetch`.\n */\nexport type S3ClientFetchOptions = {\n /** Defaults to global `fetch` — override for SSR, tests, or logging. */\n fetch?: typeof fetch;\n /** e.g. `\"include\"` to send cookies cross-origin. */\n credentials?: RequestCredentials;\n /**\n * Static headers or a (possibly async) factory called per request —\n * useful for Authorization tokens.\n */\n headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n};\n\n/**\n * Browser / isomorphic client plugin — mirrors server `DimahS3Plugin`\n * (literal `id` + methods flattened onto the `createS3Client` result).\n *\n * @typeParam Id — unique plugin id; becomes `api[id]`.\n * @typeParam TMethods — methods returned by {@link S3ClientPlugin.getActions}.\n * @typeParam TServer — matching server plugin; `$InferServerPlugin` must share `id`.\n */\nexport type S3ClientPlugin<\n Id extends string = string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n TServer extends { id: string } = { id: Id },\n> = {\n id: Id;\n /**\n * Type-only pointer at the matching server plugin (`ReturnType<typeof db>`).\n * Constrains `id` to match the server plugin's `id`.\n */\n $InferServerPlugin?: TServer & { id: Id };\n /** Build typed methods that call plugin endpoints via the shared `$fetch`. */\n getActions: ($fetch: S3Fetch) => TMethods;\n};\n\n/** Map client plugin ids → their method bags. */\nexport type ClientPluginMethodsMap<P extends readonly S3ClientPlugin[]> = {\n [K in P[number] as K[\"id\"]]: K extends S3ClientPlugin<string, infer M>\n ? M\n : never;\n};\n\n/** Keys reserved on the `createS3Client` result — client plugins may not use these as ids. */\nexport const RESERVED_CLIENT_KEYS = [\n \"upload\",\n \"confirm\",\n \"download\",\n \"delete\",\n \"multipart\",\n \"$ERROR_CODES\",\n \"$fetch\",\n \"$Infer\",\n \"Provider\",\n \"useApi\",\n] as const;\n\nexport type ReservedClientKey = (typeof RESERVED_CLIENT_KEYS)[number];\n","import type {\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n PresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n} from \"./types\";\nimport { sanitizeFileName } from \"./helpers/sanitize-file-name\";\nimport { S3_ERROR_CODES } from \"./error\";\nimport {\n createS3Fetch,\n RESERVED_CLIENT_KEYS,\n type ClientPluginMethodsMap,\n type S3ClientFetchOptions,\n type S3ClientPlugin,\n type S3Fetch,\n} from \"./plugin\";\nimport {\n normalizeS3ApiBasePath,\n S3_API_BASE_PATH,\n S3_API_ROUTES,\n} from \"./routes\";\n\n/** Options for {@link createS3Client}. */\nexport type CreateS3ClientOptions<\n P extends readonly S3ClientPlugin[] = readonly S3ClientPlugin[],\n> = {\n /** API path prefix — must match server `basePath`. @default \"/api/s3\" */\n basePath?: string;\n /**\n * Absolute client origin + path (e.g. `https://api.example.com/api/s3`).\n * Wins over {@link basePath} when both are set.\n */\n baseURL?: string;\n /** Client plugins (e.g. `dbClient()` from `@dimah-s3/db/client`). */\n plugins?: P;\n} & S3ClientFetchOptions;\n\n/** Strip server-only `headers` before sending over HTTP. */\nfunction withoutHeaders<T extends { headers?: HeadersInit }>(\n value: T,\n): Omit<T, \"headers\"> {\n const { headers: _headers, ...rest } = value;\n return rest;\n}\n\nfunction createCoreApi($fetch: S3Fetch): S3Api {\n return {\n upload(payload) {\n return $fetch<UploadPresignResponse>(S3_API_ROUTES.upload, {\n method: \"POST\",\n body: withoutHeaders(payload),\n });\n },\n\n confirm(payload) {\n return $fetch<UploadConfirmResponse>(S3_API_ROUTES.uploadConfirm, {\n method: \"POST\",\n body: withoutHeaders(payload),\n });\n },\n\n download(key, options?) {\n const { fileName, bucket, expiresIn } = options ?? {};\n return $fetch<PresignResponse>(S3_API_ROUTES.download, {\n method: \"GET\",\n query: {\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n bucket,\n expiresIn,\n },\n });\n },\n\n delete(key, options?) {\n const { bucket } = options ?? {};\n return $fetch<DeleteResponse>(S3_API_ROUTES.delete, {\n method: \"DELETE\",\n query: { key, bucket },\n });\n },\n\n multipart: {\n init(payload) {\n return $fetch<MultipartInitResponse>(S3_API_ROUTES.multipartInit, {\n method: \"POST\",\n body: withoutHeaders(payload),\n });\n },\n\n signPart(payload) {\n return $fetch<MultipartPartResponse>(S3_API_ROUTES.multipartPart, {\n method: \"POST\",\n body: withoutHeaders(payload),\n });\n },\n\n listParts(payload) {\n const { key, uploadId, bucket } = withoutHeaders(payload);\n return $fetch<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { method: \"GET\", query: { key, uploadId, bucket } },\n );\n },\n\n complete(payload) {\n return $fetch<MultipartCompleteResponse>(\n S3_API_ROUTES.multipartComplete,\n {\n method: \"POST\",\n body: withoutHeaders(payload),\n },\n );\n },\n\n abort(payload) {\n return $fetch<MultipartAbortResponse>(S3_API_ROUTES.multipartAbort, {\n method: \"POST\",\n body: withoutHeaders(payload),\n });\n },\n },\n };\n}\n\n/** Browser client returned by {@link createS3Client}. */\nexport type CreateS3ClientResult<P extends readonly S3ClientPlugin[] = []> =\n S3Api &\n ClientPluginMethodsMap<P> & {\n $ERROR_CODES: typeof S3_ERROR_CODES;\n $fetch: S3Fetch;\n $Infer: { plugins: P };\n };\n\n/**\n * Browser (or isomorphic) client for the dimah-s3 HTTP API.\n *\n * For React apps prefer `createS3Client` from `@dimah-s3/react` — same options,\n * plus a bound `Provider` / typed `useApi` on the client object.\n *\n * ```ts\n * import { createS3Client } from \"@dimah-s3/core\";\n * import { dbClient } from \"@dimah-s3/db/client\";\n *\n * export const api = createS3Client({\n * basePath: \"/api/s3\",\n * plugins: [dbClient()],\n * });\n *\n * await api.db.listObjects();\n * ```\n */\nexport function createS3Client<const P extends readonly S3ClientPlugin[] = []>(\n options?: CreateS3ClientOptions<P>,\n): CreateS3ClientResult<P> {\n const { basePath, baseURL, plugins, ...fetchOptions } = options ?? {};\n const base = normalizeS3ApiBasePath(baseURL ?? basePath ?? S3_API_BASE_PATH);\n const $fetch = createS3Fetch(base, fetchOptions);\n\n const api = createCoreApi($fetch);\n\n const pluginMethods: Record<string, unknown> = {};\n for (const plugin of plugins ?? []) {\n if ((RESERVED_CLIENT_KEYS as readonly string[]).includes(plugin.id)) {\n throw new Error(\n `Client plugin id \"${plugin.id}\" is reserved on the S3 client.`,\n );\n }\n if (plugin.id in pluginMethods) {\n throw new Error(`Duplicate client plugin id \"${plugin.id}\".`);\n }\n pluginMethods[plugin.id] = plugin.getActions($fetch);\n }\n\n return {\n ...api,\n ...pluginMethods,\n $ERROR_CODES: S3_ERROR_CODES,\n $fetch,\n $Infer: {} as CreateS3ClientResult<P>[\"$Infer\"],\n } as CreateS3ClientResult<P>;\n}\n"]}
|