@dimah-s3/core 1.5.5 → 1.5.6
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/dist/index.js +5 -5
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/index.js
CHANGED
|
@@ -415,16 +415,16 @@ function fallbackMessage(error) {
|
|
|
415
415
|
return error.statusText || "Request failed";
|
|
416
416
|
}
|
|
417
417
|
function apiErrorFromFetch(error) {
|
|
418
|
-
const
|
|
419
|
-
if (
|
|
420
|
-
const { message, code, params } =
|
|
421
|
-
return new APIError(
|
|
418
|
+
const { status } = error;
|
|
419
|
+
if (s3FetchErrorSchema.validate(error)) {
|
|
420
|
+
const { message, code, params } = error;
|
|
421
|
+
return new APIError(status, {
|
|
422
422
|
message,
|
|
423
423
|
...code !== void 0 ? { code } : {},
|
|
424
424
|
...params !== void 0 ? { params } : {}
|
|
425
425
|
});
|
|
426
426
|
}
|
|
427
|
-
return new APIError(
|
|
427
|
+
return new APIError(status, { message: fallbackMessage(error) });
|
|
428
428
|
}
|
|
429
429
|
function createS3Fetch(base, options) {
|
|
430
430
|
return createFetch({
|
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/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/helpers/normalize-object-key.ts","../src/helpers/checksum.ts","../src/helpers/magic-bytes.ts","../src/helpers/public-object-url.ts","../src/schema/shared.ts","../src/schema/upload.ts","../src/schema/catalog.ts","../src/schema/download.ts","../src/schema/delete.ts","../src/schema/file.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","z2","z4","z5","z6","z7","z8","BetterCallAPIError"],"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 * Whether `fileName` / `contentType` match HTML `accept` / route `fileTypes`\n * tokens (`image/*`, `application/pdf`, `.png`).\n */\nexport function matchesFileTypes(\n fileName: string,\n contentType: string | undefined,\n fileTypes: readonly string[],\n): boolean {\n if (!fileTypes.length) return true;\n const type = contentType ?? \"\";\n return fileTypes.some((token) => {\n if (token.startsWith(\".\")) {\n return fileName.toLowerCase().endsWith(token.toLowerCase());\n }\n if (token.endsWith(\"/*\")) {\n return type.startsWith(token.replace(\"/*\", \"/\"));\n }\n return type === token;\n });\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 if (!matchesFileTypes(file.name, file.type, options.accept)) {\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 (\n typeof options.maxFileSize === \"number\" &&\n file.size > options.maxFileSize\n ) {\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 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\n/** Last path segment of an object key (`uploads/uuid/a.png` → `a.png`). */\nexport function fileNameFromKey(key: string): string | undefined {\n return key\n .split(\"/\")\n .filter((part) => part.length > 0)\n .at(-1);\n}\n\n/**\n * Filename from `Content-Disposition`, falling back to the object key leaf.\n * Used after HeadObject when the disposition header is missing.\n */\nexport function resolveStoredFileName(\n contentDisposition: string | null | undefined,\n key: string,\n): string | undefined {\n return parseFileName(contentDisposition) ?? fileNameFromKey(key);\n}\n","export function formatFileSize(bytes: number): string {\n if (!Number.isFinite(bytes) || bytes <= 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\"] as const;\n const i = Math.min(\n Math.floor(Math.log(bytes) / Math.log(1024)),\n units.length - 1,\n );\n const size = bytes / 1024 ** i;\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","export type ContentDispositionType = \"inline\" | \"attachment\";\n\n/**\n * Builds a RFC 6266 `Content-Disposition` value.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(\n fileName: string,\n type: ContentDispositionType = \"attachment\",\n): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `${type}; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for Content-Disposition, query params, and object keys. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n\\0]/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","/** S3 object key maximum (1024 bytes). */\nexport const S3_MAX_OBJECT_KEY_LENGTH = 1024;\n\n/**\n * Strip leading/trailing slashes and reject `.` / `..` / empty segments,\n * NUL, backslashes, and oversized keys. Returns `null` when the key is unsafe.\n */\nexport function normalizeObjectKey(key: string): string | null {\n const trimmed = key.replace(/^\\/+/u, \"\").replace(/\\/+$/u, \"\");\n if (!trimmed) return null;\n if (trimmed.length > S3_MAX_OBJECT_KEY_LENGTH) return null;\n if (trimmed.includes(\"\\\\\") || trimmed.includes(\"\\0\")) return null;\n const parts = trimmed.split(\"/\");\n if (parts.some((part) => part === \"\" || part === \".\" || part === \"..\")) {\n return null;\n }\n return parts.join(\"/\");\n}\n","/** SHA-256 digest as unpadded base64 (S3 `ChecksumSHA256`). */\nexport async function sha256Base64(data: BufferSource): Promise<string> {\n const digest = await crypto.subtle.digest(\"SHA-256\", data);\n const bytes = new Uint8Array(digest);\n let binary = \"\";\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/=+$/, \"\");\n}\n\n/** SHA-256 of a `Blob` / `File` as unpadded base64. */\nexport async function sha256File(file: Blob): Promise<string> {\n return sha256Base64(await file.arrayBuffer());\n}\n","type MagicMatch = {\n mime: string;\n bytes: number[];\n offset?: number;\n};\n\nconst MAGIC: readonly MagicMatch[] = [\n { mime: \"image/png\", bytes: [0x89, 0x50, 0x4e, 0x47] },\n { mime: \"image/jpeg\", bytes: [0xff, 0xd8, 0xff] },\n { mime: \"image/gif\", bytes: [0x47, 0x49, 0x46, 0x38] },\n { mime: \"image/webp\", bytes: [0x52, 0x49, 0x46, 0x46], offset: 0 },\n { mime: \"application/pdf\", bytes: [0x25, 0x50, 0x44, 0x46] },\n { mime: \"application/zip\", bytes: [0x50, 0x4b, 0x03, 0x04] },\n { mime: \"video/webm\", bytes: [0x1a, 0x45, 0xdf, 0xa3] },\n];\n\nfunction prefixEquals(\n bytes: Uint8Array,\n expected: readonly number[],\n offset = 0,\n): boolean {\n if (bytes.length < offset + expected.length) return false;\n return expected.every((value, i) => bytes[offset + i] === value);\n}\n\n/**\n * Sniff a MIME type from the start of a file. Returns `undefined` when\n * the prefix is unknown — this is not a substitute for `fileTypes`.\n */\nexport function sniffContentType(bytes: Uint8Array): string | undefined {\n if (prefixEquals(bytes, [0x52, 0x49, 0x46, 0x46]) && bytes.length >= 12) {\n const tag = String.fromCharCode(bytes[8], bytes[9], bytes[10], bytes[11]);\n if (tag === \"WEBP\") return \"image/webp\";\n }\n for (const entry of MAGIC) {\n if (entry.mime === \"image/webp\") continue;\n if (prefixEquals(bytes, entry.bytes, entry.offset)) return entry.mime;\n }\n return undefined;\n}\n\n/**\n * Whether `bytes` match `expected` (exact MIME or `image/*`).\n * Unknown prefixes return `false`.\n */\nexport function matchesMagicBytes(\n bytes: Uint8Array,\n expected: string,\n): boolean {\n const sniffed = sniffContentType(bytes);\n if (!sniffed) return false;\n if (expected.endsWith(\"/*\")) {\n return sniffed.startsWith(expected.replace(\"/*\", \"/\"));\n }\n return sniffed === expected;\n}\n","/**\n * Join a public origin (CDN or virtual-hosted S3) with an object key.\n * Does not sign — only for `public-read` objects or a fronting CDN.\n */\nexport function buildPublicObjectUrl(options: {\n /** Origin with no trailing slash, e.g. `https://cdn.example.com`. */\n baseUrl: string;\n key: string;\n}): string {\n const base = options.baseUrl.replace(/\\/+$/, \"\");\n const path = options.key\n .split(\"/\")\n .filter((part) => part.length > 0)\n .map((part) => encodeURIComponent(part))\n .join(\"/\");\n return `${base}/${path}`;\n}\n","import * as z from \"zod\";\nimport {\n normalizeObjectKey,\n S3_MAX_OBJECT_KEY_LENGTH,\n} from \"@/helpers/normalize-object-key\";\n\n/** Fallback when the route omits `expiresIn`. */\nexport const S3_DEFAULT_EXPIRES_IN = 600;\n\n/** AWS SigV4 presign maximum (7 days), in seconds. */\nexport const S3_MAX_EXPIRES_IN = 604_800;\n\n/** S3 POST object maximum (5 GiB), in bytes. */\nexport const S3_MAX_POST_OBJECT_BYTES = 5 * 1024 * 1024 * 1024;\n\n/** S3 multipart part number maximum. */\nexport const S3_MAX_PART_NUMBER = 10_000;\n\n/** Max user-defined metadata entries on an upload body. */\nexport const S3_MAX_METADATA_ENTRIES = 32;\n\n/** Named file-route identifier (`avatars`, `uploads`, …). */\nexport const ROUTE_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;\n\n/** Non-empty trimmed string. */\nexport const trimmedString = z.string().trim().min(1);\n\n/** Optional trimmed string. Blank or whitespace-only values are omitted. */\nexport const optionalTrimmedString = z.preprocess((value: unknown) => {\n if (typeof value !== \"string\") return value;\n const trimmed = value.trim();\n return trimmed === \"\" ? undefined : trimmed;\n}, z.string().optional());\n\nexport const routeNameSchema = trimmedString.regex(\n ROUTE_NAME_PATTERN,\n \"Invalid route name\",\n);\n\n/** Stored object key — normalized, no `.` / `..` / NUL / backslash segments. */\nexport const objectKeySchema = trimmedString\n .max(S3_MAX_OBJECT_KEY_LENGTH)\n .transform((value, ctx) => {\n const normalized = normalizeObjectKey(value);\n if (normalized == null) {\n ctx.issues.push({\n code: \"custom\",\n message: \"Invalid object key\",\n input: value,\n });\n return z.NEVER;\n }\n return normalized;\n });\n\n/** 1-based S3 multipart part number. */\nexport const partNumberSchema = z.int().min(1).max(S3_MAX_PART_NUMBER);\n\nexport const s3ObjectAclSchema = z.enum([\"private\", \"public-read\"]);\n\n/**\n * S3 `ChecksumSHA256` — 32-byte SHA-256 as standard base64 (padding optional).\n * Matches `sha256Base64()` output and the padded form AWS also accepts.\n */\nexport const sha256ChecksumSchema = z.stringFormat(\n \"sha256-base64\",\n /^[A-Za-z0-9+/]{43}=?$/,\n);\n\n/** Optional checksum; blank / whitespace-only values are omitted. */\nexport const optionalChecksumSchema = optionalTrimmedString.pipe(\n sha256ChecksumSchema.optional(),\n);\n\nconst metadataKeySchema = z\n .string()\n .regex(/^[a-z0-9][a-z0-9-]*$/i, \"Invalid metadata key\")\n .max(128);\n\nexport const metadataSchema = z\n .record(metadataKeySchema, z.string().max(2048))\n .refine((value) => Object.keys(value).length <= S3_MAX_METADATA_ENTRIES, {\n message: \"Too many metadata entries\",\n });\n","import * as z from \"zod\";\nimport {\n metadataSchema,\n objectKeySchema,\n optionalChecksumSchema,\n optionalTrimmedString,\n routeNameSchema,\n trimmedString,\n} from \"./shared\";\n\nexport const uploadBodySchema = z.strictObject({\n route: routeNameSchema,\n fileName: trimmedString,\n fileSize: z.int().positive(),\n contentType: optionalTrimmedString,\n metadata: metadataSchema.optional(),\n /** Unpadded base64 SHA-256. Required when the route sets `upload.checksum`. */\n checksum: optionalChecksumSchema,\n});\n\nexport const confirmBodySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n});\n","import * as z from \"zod\";\nimport type { S3RouteName } from \"@/types/routes\";\nimport { routeNameSchema } from \"./shared\";\n\nexport const downloadDispositionSchema = z.enum([\"inline\", \"attachment\"]);\nexport const downloadModeSchema = z.enum([\"presign\", \"proxy\"]);\n\nexport const routeCatalogUploadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n fileTypes: z.array(z.string()).optional(),\n maxFileSize: z.int().positive().optional(),\n multipart: z.boolean(),\n checksum: z.boolean().optional(),\n replace: z.literal(\"overwrite\").optional(),\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDownloadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n disposition: downloadDispositionSchema.optional(),\n mode: downloadModeSchema.optional(),\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDeleteSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({ enabled: z.literal(true) }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogEntrySchema = z.strictObject({\n upload: routeCatalogUploadSchema,\n download: routeCatalogDownloadSchema,\n delete: routeCatalogDeleteSchema,\n});\n\nexport const routeCatalogResponseSchema = z.strictObject({\n routes: z.record(routeNameSchema, routeCatalogEntrySchema),\n});\n\nexport type RouteCatalogEntry = z.output<typeof routeCatalogEntrySchema>;\nexport type RouteCatalogResponse = {\n routes: Record<S3RouteName, RouteCatalogEntry>;\n};\n","import * as z from \"zod\";\nimport { downloadDispositionSchema } from \"./catalog\";\nimport {\n objectKeySchema,\n optionalTrimmedString,\n routeNameSchema,\n} from \"./shared\";\n\n/** Query string — numbers arrive as strings. Extra keys are rejected. */\nexport const downloadQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n fileName: optionalTrimmedString,\n disposition: downloadDispositionSchema.optional(),\n});\n","import * as z from \"zod\";\nimport { objectKeySchema, routeNameSchema } from \"./shared\";\n\nexport const DELETE_BATCH_MAX_KEYS = 100;\n\nexport const deleteQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n});\n\nexport const deleteBatchBodySchema = z.strictObject({\n route: routeNameSchema,\n keys: z.array(objectKeySchema).min(1).max(DELETE_BATCH_MAX_KEYS),\n});\n","import * as z from \"zod\";\nimport { downloadDispositionSchema } from \"./catalog\";\nimport {\n objectKeySchema,\n optionalTrimmedString,\n routeNameSchema,\n} from \"./shared\";\n\n/** Query for the same-origin proxy download (`GET /file`). */\nexport const fileQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n fileName: optionalTrimmedString,\n disposition: downloadDispositionSchema.optional(),\n});\n","import * as z from \"zod\";\nimport { uploadBodySchema } from \"./upload\";\nimport {\n objectKeySchema,\n partNumberSchema,\n routeNameSchema,\n trimmedString,\n} from \"./shared\";\n\nexport const multipartInitBodySchema = uploadBodySchema;\n\nconst multipartSessionFields = {\n route: routeNameSchema,\n key: objectKeySchema,\n uploadId: trimmedString,\n};\n\nexport const multipartSignPartBodySchema = z.strictObject({\n ...multipartSessionFields,\n partNumber: partNumberSchema,\n partSize: z.int().positive(),\n});\n\nexport const multipartListPartsQuerySchema = z.strictObject({\n ...multipartSessionFields,\n});\n\nexport const multipartCompletedPartSchema = z.strictObject({\n partNumber: partNumberSchema,\n});\n\nexport const multipartCompleteBodySchema = z.strictObject({\n ...multipartSessionFields,\n parts: z.array(multipartCompletedPartSchema).min(1),\n});\n\nexport const multipartAbortBodySchema = z.strictObject({\n ...multipartSessionFields,\n});\n","import * as 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 `APIError`.\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.output<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 UNKNOWN_ROUTE: \"Unknown file route\",\n FILE_TYPE_NOT_ALLOWED: \"File type is not allowed\",\n S3_NETWORK_ERROR:\n \"S3 endpoint unreachable ({code}): check your endpoint URL and network connectivity\",\n MULTIPART_PART_MISSING: \"Uploaded part {partNumber} was not found\",\n PAYLOAD_TOO_LARGE: \"Payload too large\",\n QUOTA_EXCEEDED: \"Storage quota exceeded\",\n VALIDATION_ERROR: \"Validation Error\",\n});\n\nexport type S3ErrorCode = keyof typeof S3_ERROR_CODES;\n","import { APIError as BetterCallAPIError } 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\ntype NamedStatus = ConstructorParameters<typeof BetterCallAPIError>[0];\ntype APIErrorStatus = NamedStatus | number;\ntype APIErrorBody = ConstructorParameters<typeof BetterCallAPIError>[1] & {\n params?: Record<string, string | number>;\n cause?: unknown;\n};\n\n/**\n * better-call `APIError` — same name and `(status, body)` constructor as\n * `ctx.error(...)`. HTTP serializes `{ message, code?, params? }` via native\n * `toResponse`.\n */\nexport class APIError extends BetterCallAPIError {\n constructor(\n status: APIErrorStatus = \"BAD_REQUEST\",\n body?: APIErrorBody,\n headers?: HeadersInit,\n ) {\n const { cause, ...rest } = body ?? {};\n super(\n status as NamedStatus,\n Object.keys(rest).length > 0 ? rest : undefined,\n headers,\n );\n this.name = \"APIError\";\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(): Record<string, string | number> | undefined {\n return this.body?.params as Record<string, string | number> | undefined;\n }\n\n /** Throw a catalog (or custom) `{ code, message }` with an HTTP status. */\n static from(\n status: APIErrorStatus,\n error: {\n code: string;\n message: string;\n params?: Record<string, string | number>;\n },\n ): APIError {\n return new APIError(status, {\n message: error.message,\n code: error.code,\n ...(error.params !== undefined ? { params: error.params } : {}),\n });\n }\n\n static fromStatus(status: APIErrorStatus, body?: APIErrorBody): APIError {\n return new APIError(status, body);\n }\n}\n\n/** True for {@link APIError} and better-call copies (including duck-typed). */\nexport function isAPIError(error: unknown): error is APIError {\n return (\n error instanceof BetterCallAPIError ||\n error instanceof APIError ||\n (error as { name?: string } | null)?.name === \"APIError\"\n );\n}\n\n/** True when `error` is an {@link APIError} with this catalog `code`. */\nexport function isS3ErrorCode<C extends S3ErrorCode>(\n error: unknown,\n code: C,\n): error is APIError & { code: C } {\n return isAPIError(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 file: \"/file\",\n catalog: \"/routes\",\n delete: \"/delete\",\n deleteBatch: \"/delete/batch\",\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 { APIError } 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 apiErrorFromFetch(error: {\n status: number;\n statusText: string;\n error?: unknown;\n}): APIError {\n const parsed = s3FetchErrorSchema.safeParse(error);\n if (parsed.success) {\n const { message, code, params } = parsed.data;\n return new APIError(error.status, {\n message,\n ...(code !== undefined ? { code } : {}),\n ...(params !== undefined ? { params } : {}),\n });\n }\n return new APIError(error.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 APIError}.\n * `throw: true` is the better-fetch flag; `onError` maps onto the same class\n * the server throws so `instanceof APIError` 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 apiErrorFromFetch(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","import { ROUTE_NAME_PATTERN } from \"@/schema/shared\";\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 if (!ROUTE_NAME_PATTERN.test(pluginId)) {\n throw new Error(`Invalid plugin id \"${pluginId}\"`);\n }\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 APIError} 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 \"catalog\",\n \"delete\",\n \"deleteMany\",\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 DeleteBatchResponse,\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n DownloadPresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n RouteCatalogResponse,\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(payload) {\n const { route, key, fileName, disposition } = withoutHeaders(payload);\n return $fetch<DownloadPresignResponse>(S3_API_ROUTES.download, {\n method: \"GET\",\n query: {\n route,\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n disposition,\n },\n });\n },\n\n catalog() {\n return $fetch<RouteCatalogResponse>(S3_API_ROUTES.catalog, {\n method: \"GET\",\n });\n },\n\n delete(payload) {\n const { route, key } = withoutHeaders(payload);\n return $fetch<DeleteResponse>(S3_API_ROUTES.delete, {\n method: \"DELETE\",\n query: { route, key },\n });\n },\n\n deleteMany(payload) {\n return $fetch<DeleteBatchResponse>(S3_API_ROUTES.deleteBatch, {\n method: \"POST\",\n body: withoutHeaders(payload),\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 { route, key, uploadId } = withoutHeaders(payload);\n return $fetch<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { method: \"GET\", query: { route, key, uploadId } },\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"]}
|
|
1
|
+
{"version":3,"sources":["../src/helpers/validate-file.ts","../src/helpers/build-object-key.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/helpers/normalize-object-key.ts","../src/helpers/checksum.ts","../src/helpers/magic-bytes.ts","../src/helpers/public-object-url.ts","../src/schema/shared.ts","../src/schema/upload.ts","../src/schema/catalog.ts","../src/schema/download.ts","../src/schema/delete.ts","../src/schema/file.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","z2","z4","z5","z6","z7","z8","BetterCallAPIError"],"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 * Whether `fileName` / `contentType` match HTML `accept` / route `fileTypes`\n * tokens (`image/*`, `application/pdf`, `.png`).\n */\nexport function matchesFileTypes(\n fileName: string,\n contentType: string | undefined,\n fileTypes: readonly string[],\n): boolean {\n if (!fileTypes.length) return true;\n const type = contentType ?? \"\";\n return fileTypes.some((token) => {\n if (token.startsWith(\".\")) {\n return fileName.toLowerCase().endsWith(token.toLowerCase());\n }\n if (token.endsWith(\"/*\")) {\n return type.startsWith(token.replace(\"/*\", \"/\"));\n }\n return type === token;\n });\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 if (!matchesFileTypes(file.name, file.type, options.accept)) {\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 (\n typeof options.maxFileSize === \"number\" &&\n file.size > options.maxFileSize\n ) {\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 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\n/** Last path segment of an object key (`uploads/uuid/a.png` → `a.png`). */\nexport function fileNameFromKey(key: string): string | undefined {\n return key\n .split(\"/\")\n .filter((part) => part.length > 0)\n .at(-1);\n}\n\n/**\n * Filename from `Content-Disposition`, falling back to the object key leaf.\n * Used after HeadObject when the disposition header is missing.\n */\nexport function resolveStoredFileName(\n contentDisposition: string | null | undefined,\n key: string,\n): string | undefined {\n return parseFileName(contentDisposition) ?? fileNameFromKey(key);\n}\n","export function formatFileSize(bytes: number): string {\n if (!Number.isFinite(bytes) || bytes <= 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\"] as const;\n const i = Math.min(\n Math.floor(Math.log(bytes) / Math.log(1024)),\n units.length - 1,\n );\n const size = bytes / 1024 ** i;\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","export type ContentDispositionType = \"inline\" | \"attachment\";\n\n/**\n * Builds a RFC 6266 `Content-Disposition` value.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(\n fileName: string,\n type: ContentDispositionType = \"attachment\",\n): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `${type}; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for Content-Disposition, query params, and object keys. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n\\0]/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","/** S3 object key maximum (1024 bytes). */\nexport const S3_MAX_OBJECT_KEY_LENGTH = 1024;\n\n/**\n * Strip leading/trailing slashes and reject `.` / `..` / empty segments,\n * NUL, backslashes, and oversized keys. Returns `null` when the key is unsafe.\n */\nexport function normalizeObjectKey(key: string): string | null {\n const trimmed = key.replace(/^\\/+/u, \"\").replace(/\\/+$/u, \"\");\n if (!trimmed) return null;\n if (trimmed.length > S3_MAX_OBJECT_KEY_LENGTH) return null;\n if (trimmed.includes(\"\\\\\") || trimmed.includes(\"\\0\")) return null;\n const parts = trimmed.split(\"/\");\n if (parts.some((part) => part === \"\" || part === \".\" || part === \"..\")) {\n return null;\n }\n return parts.join(\"/\");\n}\n","/** SHA-256 digest as unpadded base64 (S3 `ChecksumSHA256`). */\nexport async function sha256Base64(data: BufferSource): Promise<string> {\n const digest = await crypto.subtle.digest(\"SHA-256\", data);\n const bytes = new Uint8Array(digest);\n let binary = \"\";\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/=+$/, \"\");\n}\n\n/** SHA-256 of a `Blob` / `File` as unpadded base64. */\nexport async function sha256File(file: Blob): Promise<string> {\n return sha256Base64(await file.arrayBuffer());\n}\n","type MagicMatch = {\n mime: string;\n bytes: number[];\n offset?: number;\n};\n\nconst MAGIC: readonly MagicMatch[] = [\n { mime: \"image/png\", bytes: [0x89, 0x50, 0x4e, 0x47] },\n { mime: \"image/jpeg\", bytes: [0xff, 0xd8, 0xff] },\n { mime: \"image/gif\", bytes: [0x47, 0x49, 0x46, 0x38] },\n { mime: \"image/webp\", bytes: [0x52, 0x49, 0x46, 0x46], offset: 0 },\n { mime: \"application/pdf\", bytes: [0x25, 0x50, 0x44, 0x46] },\n { mime: \"application/zip\", bytes: [0x50, 0x4b, 0x03, 0x04] },\n { mime: \"video/webm\", bytes: [0x1a, 0x45, 0xdf, 0xa3] },\n];\n\nfunction prefixEquals(\n bytes: Uint8Array,\n expected: readonly number[],\n offset = 0,\n): boolean {\n if (bytes.length < offset + expected.length) return false;\n return expected.every((value, i) => bytes[offset + i] === value);\n}\n\n/**\n * Sniff a MIME type from the start of a file. Returns `undefined` when\n * the prefix is unknown — this is not a substitute for `fileTypes`.\n */\nexport function sniffContentType(bytes: Uint8Array): string | undefined {\n if (prefixEquals(bytes, [0x52, 0x49, 0x46, 0x46]) && bytes.length >= 12) {\n const tag = String.fromCharCode(bytes[8], bytes[9], bytes[10], bytes[11]);\n if (tag === \"WEBP\") return \"image/webp\";\n }\n for (const entry of MAGIC) {\n if (entry.mime === \"image/webp\") continue;\n if (prefixEquals(bytes, entry.bytes, entry.offset)) return entry.mime;\n }\n return undefined;\n}\n\n/**\n * Whether `bytes` match `expected` (exact MIME or `image/*`).\n * Unknown prefixes return `false`.\n */\nexport function matchesMagicBytes(\n bytes: Uint8Array,\n expected: string,\n): boolean {\n const sniffed = sniffContentType(bytes);\n if (!sniffed) return false;\n if (expected.endsWith(\"/*\")) {\n return sniffed.startsWith(expected.replace(\"/*\", \"/\"));\n }\n return sniffed === expected;\n}\n","/**\n * Join a public origin (CDN or virtual-hosted S3) with an object key.\n * Does not sign — only for `public-read` objects or a fronting CDN.\n */\nexport function buildPublicObjectUrl(options: {\n /** Origin with no trailing slash, e.g. `https://cdn.example.com`. */\n baseUrl: string;\n key: string;\n}): string {\n const base = options.baseUrl.replace(/\\/+$/, \"\");\n const path = options.key\n .split(\"/\")\n .filter((part) => part.length > 0)\n .map((part) => encodeURIComponent(part))\n .join(\"/\");\n return `${base}/${path}`;\n}\n","import * as z from \"zod\";\nimport {\n normalizeObjectKey,\n S3_MAX_OBJECT_KEY_LENGTH,\n} from \"@/helpers/normalize-object-key\";\n\n/** Fallback when the route omits `expiresIn`. */\nexport const S3_DEFAULT_EXPIRES_IN = 600;\n\n/** AWS SigV4 presign maximum (7 days), in seconds. */\nexport const S3_MAX_EXPIRES_IN = 604_800;\n\n/** S3 POST object maximum (5 GiB), in bytes. */\nexport const S3_MAX_POST_OBJECT_BYTES = 5 * 1024 * 1024 * 1024;\n\n/** S3 multipart part number maximum. */\nexport const S3_MAX_PART_NUMBER = 10_000;\n\n/** Max user-defined metadata entries on an upload body. */\nexport const S3_MAX_METADATA_ENTRIES = 32;\n\n/** Named file-route identifier (`avatars`, `uploads`, …). */\nexport const ROUTE_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;\n\n/** Non-empty trimmed string. */\nexport const trimmedString = z.string().trim().min(1);\n\n/** Optional trimmed string. Blank or whitespace-only values are omitted. */\nexport const optionalTrimmedString = z.preprocess((value: unknown) => {\n if (typeof value !== \"string\") return value;\n const trimmed = value.trim();\n return trimmed === \"\" ? undefined : trimmed;\n}, z.string().optional());\n\nexport const routeNameSchema = trimmedString.regex(\n ROUTE_NAME_PATTERN,\n \"Invalid route name\",\n);\n\n/** Stored object key — normalized, no `.` / `..` / NUL / backslash segments. */\nexport const objectKeySchema = trimmedString\n .max(S3_MAX_OBJECT_KEY_LENGTH)\n .transform((value, ctx) => {\n const normalized = normalizeObjectKey(value);\n if (normalized == null) {\n ctx.issues.push({\n code: \"custom\",\n message: \"Invalid object key\",\n input: value,\n });\n return z.NEVER;\n }\n return normalized;\n });\n\n/** 1-based S3 multipart part number. */\nexport const partNumberSchema = z.int().min(1).max(S3_MAX_PART_NUMBER);\n\nexport const s3ObjectAclSchema = z.enum([\"private\", \"public-read\"]);\n\n/**\n * S3 `ChecksumSHA256` — 32-byte SHA-256 as standard base64 (padding optional).\n * Matches `sha256Base64()` output and the padded form AWS also accepts.\n */\nexport const sha256ChecksumSchema = z.stringFormat(\n \"sha256-base64\",\n /^[A-Za-z0-9+/]{43}=?$/,\n);\n\n/** Optional checksum; blank / whitespace-only values are omitted. */\nexport const optionalChecksumSchema = optionalTrimmedString.pipe(\n sha256ChecksumSchema.optional(),\n);\n\nconst metadataKeySchema = z\n .string()\n .regex(/^[a-z0-9][a-z0-9-]*$/i, \"Invalid metadata key\")\n .max(128);\n\nexport const metadataSchema = z\n .record(metadataKeySchema, z.string().max(2048))\n .refine((value) => Object.keys(value).length <= S3_MAX_METADATA_ENTRIES, {\n message: \"Too many metadata entries\",\n });\n","import * as z from \"zod\";\nimport {\n metadataSchema,\n objectKeySchema,\n optionalChecksumSchema,\n optionalTrimmedString,\n routeNameSchema,\n trimmedString,\n} from \"./shared\";\n\nexport const uploadBodySchema = z.strictObject({\n route: routeNameSchema,\n fileName: trimmedString,\n fileSize: z.int().positive(),\n contentType: optionalTrimmedString,\n metadata: metadataSchema.optional(),\n /** Unpadded base64 SHA-256. Required when the route sets `upload.checksum`. */\n checksum: optionalChecksumSchema,\n});\n\nexport const confirmBodySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n});\n","import * as z from \"zod\";\nimport type { S3RouteName } from \"@/types/routes\";\nimport { routeNameSchema } from \"./shared\";\n\nexport const downloadDispositionSchema = z.enum([\"inline\", \"attachment\"]);\nexport const downloadModeSchema = z.enum([\"presign\", \"proxy\"]);\n\nexport const routeCatalogUploadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n fileTypes: z.array(z.string()).optional(),\n maxFileSize: z.int().positive().optional(),\n multipart: z.boolean(),\n checksum: z.boolean().optional(),\n replace: z.literal(\"overwrite\").optional(),\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDownloadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n disposition: downloadDispositionSchema.optional(),\n mode: downloadModeSchema.optional(),\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDeleteSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({ enabled: z.literal(true) }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogEntrySchema = z.strictObject({\n upload: routeCatalogUploadSchema,\n download: routeCatalogDownloadSchema,\n delete: routeCatalogDeleteSchema,\n});\n\nexport const routeCatalogResponseSchema = z.strictObject({\n routes: z.record(routeNameSchema, routeCatalogEntrySchema),\n});\n\nexport type RouteCatalogEntry = z.output<typeof routeCatalogEntrySchema>;\nexport type RouteCatalogResponse = {\n routes: Record<S3RouteName, RouteCatalogEntry>;\n};\n","import * as z from \"zod\";\nimport { downloadDispositionSchema } from \"./catalog\";\nimport {\n objectKeySchema,\n optionalTrimmedString,\n routeNameSchema,\n} from \"./shared\";\n\n/** Query string — numbers arrive as strings. Extra keys are rejected. */\nexport const downloadQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n fileName: optionalTrimmedString,\n disposition: downloadDispositionSchema.optional(),\n});\n","import * as z from \"zod\";\nimport { objectKeySchema, routeNameSchema } from \"./shared\";\n\nexport const DELETE_BATCH_MAX_KEYS = 100;\n\nexport const deleteQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n});\n\nexport const deleteBatchBodySchema = z.strictObject({\n route: routeNameSchema,\n keys: z.array(objectKeySchema).min(1).max(DELETE_BATCH_MAX_KEYS),\n});\n","import * as z from \"zod\";\nimport { downloadDispositionSchema } from \"./catalog\";\nimport {\n objectKeySchema,\n optionalTrimmedString,\n routeNameSchema,\n} from \"./shared\";\n\n/** Query for the same-origin proxy download (`GET /file`). */\nexport const fileQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n fileName: optionalTrimmedString,\n disposition: downloadDispositionSchema.optional(),\n});\n","import * as z from \"zod\";\nimport { uploadBodySchema } from \"./upload\";\nimport {\n objectKeySchema,\n partNumberSchema,\n routeNameSchema,\n trimmedString,\n} from \"./shared\";\n\nexport const multipartInitBodySchema = uploadBodySchema;\n\nconst multipartSessionFields = {\n route: routeNameSchema,\n key: objectKeySchema,\n uploadId: trimmedString,\n};\n\nexport const multipartSignPartBodySchema = z.strictObject({\n ...multipartSessionFields,\n partNumber: partNumberSchema,\n partSize: z.int().positive(),\n});\n\nexport const multipartListPartsQuerySchema = z.strictObject({\n ...multipartSessionFields,\n});\n\nexport const multipartCompletedPartSchema = z.strictObject({\n partNumber: partNumberSchema,\n});\n\nexport const multipartCompleteBodySchema = z.strictObject({\n ...multipartSessionFields,\n parts: z.array(multipartCompletedPartSchema).min(1),\n});\n\nexport const multipartAbortBodySchema = z.strictObject({\n ...multipartSessionFields,\n});\n","import * as 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 `APIError`.\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.output<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 UNKNOWN_ROUTE: \"Unknown file route\",\n FILE_TYPE_NOT_ALLOWED: \"File type is not allowed\",\n S3_NETWORK_ERROR:\n \"S3 endpoint unreachable ({code}): check your endpoint URL and network connectivity\",\n MULTIPART_PART_MISSING: \"Uploaded part {partNumber} was not found\",\n PAYLOAD_TOO_LARGE: \"Payload too large\",\n QUOTA_EXCEEDED: \"Storage quota exceeded\",\n VALIDATION_ERROR: \"Validation Error\",\n});\n\nexport type S3ErrorCode = keyof typeof S3_ERROR_CODES;\n","import { APIError as BetterCallAPIError } 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\ntype NamedStatus = ConstructorParameters<typeof BetterCallAPIError>[0];\ntype APIErrorStatus = NamedStatus | number;\ntype APIErrorBody = ConstructorParameters<typeof BetterCallAPIError>[1] & {\n params?: Record<string, string | number>;\n cause?: unknown;\n};\n\n/**\n * better-call `APIError` — same name and `(status, body)` constructor as\n * `ctx.error(...)`. HTTP serializes `{ message, code?, params? }` via native\n * `toResponse`.\n */\nexport class APIError extends BetterCallAPIError {\n constructor(\n status: APIErrorStatus = \"BAD_REQUEST\",\n body?: APIErrorBody,\n headers?: HeadersInit,\n ) {\n const { cause, ...rest } = body ?? {};\n super(\n status as NamedStatus,\n Object.keys(rest).length > 0 ? rest : undefined,\n headers,\n );\n this.name = \"APIError\";\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(): Record<string, string | number> | undefined {\n return this.body?.params as Record<string, string | number> | undefined;\n }\n\n /** Throw a catalog (or custom) `{ code, message }` with an HTTP status. */\n static from(\n status: APIErrorStatus,\n error: {\n code: string;\n message: string;\n params?: Record<string, string | number>;\n },\n ): APIError {\n return new APIError(status, {\n message: error.message,\n code: error.code,\n ...(error.params !== undefined ? { params: error.params } : {}),\n });\n }\n\n static fromStatus(status: APIErrorStatus, body?: APIErrorBody): APIError {\n return new APIError(status, body);\n }\n}\n\n/** True for {@link APIError} and better-call copies (including duck-typed). */\nexport function isAPIError(error: unknown): error is APIError {\n return (\n error instanceof BetterCallAPIError ||\n error instanceof APIError ||\n (error as { name?: string } | null)?.name === \"APIError\"\n );\n}\n\n/** True when `error` is an {@link APIError} with this catalog `code`. */\nexport function isS3ErrorCode<C extends S3ErrorCode>(\n error: unknown,\n code: C,\n): error is APIError & { code: C } {\n return isAPIError(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 file: \"/file\",\n catalog: \"/routes\",\n delete: \"/delete\",\n deleteBatch: \"/delete/batch\",\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 { APIError } 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 apiErrorFromFetch(error: {\n status: number;\n statusText: string;\n error?: unknown;\n}): APIError {\n const { status } = error;\n if (s3FetchErrorSchema.validate(error)) {\n const { message, code, params } = error;\n return new APIError(status, {\n message,\n ...(code !== undefined ? { code } : {}),\n ...(params !== undefined ? { params } : {}),\n });\n }\n return new APIError(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 APIError}.\n * `throw: true` is the better-fetch flag; `onError` maps onto the same class\n * the server throws so `instanceof APIError` 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 apiErrorFromFetch(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","import { ROUTE_NAME_PATTERN } from \"@/schema/shared\";\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 if (!ROUTE_NAME_PATTERN.test(pluginId)) {\n throw new Error(`Invalid plugin id \"${pluginId}\"`);\n }\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 APIError} 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 \"catalog\",\n \"delete\",\n \"deleteMany\",\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 DeleteBatchResponse,\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n DownloadPresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n RouteCatalogResponse,\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(payload) {\n const { route, key, fileName, disposition } = withoutHeaders(payload);\n return $fetch<DownloadPresignResponse>(S3_API_ROUTES.download, {\n method: \"GET\",\n query: {\n route,\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n disposition,\n },\n });\n },\n\n catalog() {\n return $fetch<RouteCatalogResponse>(S3_API_ROUTES.catalog, {\n method: \"GET\",\n });\n },\n\n delete(payload) {\n const { route, key } = withoutHeaders(payload);\n return $fetch<DeleteResponse>(S3_API_ROUTES.delete, {\n method: \"DELETE\",\n query: { route, key },\n });\n },\n\n deleteMany(payload) {\n return $fetch<DeleteBatchResponse>(S3_API_ROUTES.deleteBatch, {\n method: \"POST\",\n body: withoutHeaders(payload),\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 { route, key, uploadId } = withoutHeaders(payload);\n return $fetch<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { method: \"GET\", query: { route, key, uploadId } },\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"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dimah-s3/core",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.6",
|
|
4
4
|
"description": "Typed S3 presign protocol and fetch client shared by @dimah-s3/server and @dimah-s3/react",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"s3",
|
|
@@ -36,12 +36,12 @@
|
|
|
36
36
|
"dependencies": {
|
|
37
37
|
"@better-fetch/fetch": "1.3.1",
|
|
38
38
|
"better-call": "1.4.0",
|
|
39
|
-
"zod": "^4.
|
|
39
|
+
"zod": "^4.6.1"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
42
|
"@workspace/eslint-config": "0.0.1",
|
|
43
43
|
"@workspace/typescript-config": "0.0.1",
|
|
44
|
-
"@workspace/vitest-config": "0.0.
|
|
44
|
+
"@workspace/vitest-config": "0.0.6",
|
|
45
45
|
"eslint": "^10.10.0",
|
|
46
46
|
"tsc-alias": "^1.9.4",
|
|
47
47
|
"tsup": "^8.5.1",
|