@dimah-s3/core 1.7.0 → 1.7.1
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/helpers/build-object-key.d.ts.map +1 -1
- package/dist/helpers/normalize-object-key.d.ts.map +1 -1
- package/dist/helpers/public-object-url.d.ts.map +1 -1
- package/dist/helpers/strip-slashes.d.ts +5 -0
- package/dist/helpers/strip-slashes.d.ts.map +1 -0
- package/dist/index.js +19 -4
- package/dist/index.js.map +1 -1
- package/dist/routes.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"build-object-key.d.ts","sourceRoot":"","sources":["../../src/helpers/build-object-key.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"build-object-key.d.ts","sourceRoot":"","sources":["../../src/helpers/build-object-key.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAKzD"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"normalize-object-key.d.ts","sourceRoot":"","sources":["../../src/helpers/normalize-object-key.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"normalize-object-key.d.ts","sourceRoot":"","sources":["../../src/helpers/normalize-object-key.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU7D"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"public-object-url.d.ts","sourceRoot":"","sources":["../../src/helpers/public-object-url.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"public-object-url.d.ts","sourceRoot":"","sources":["../../src/helpers/public-object-url.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAQT"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** Drop trailing `/` in linear time so a long slash run cannot backtrack. */
|
|
2
|
+
export declare function stripTrailingSlashes(value: string): string;
|
|
3
|
+
/** Drop leading and trailing `/` in linear time so a long slash run cannot backtrack. */
|
|
4
|
+
export declare function stripSurroundingSlashes(value: string): string;
|
|
5
|
+
//# sourceMappingURL=strip-slashes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strip-slashes.d.ts","sourceRoot":"","sources":["../../src/helpers/strip-slashes.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7D"}
|
package/dist/index.js
CHANGED
|
@@ -45,9 +45,24 @@ function validateFile(file, options) {
|
|
|
45
45
|
return null;
|
|
46
46
|
}
|
|
47
47
|
|
|
48
|
+
// src/helpers/strip-slashes.ts
|
|
49
|
+
var SLASH = "/";
|
|
50
|
+
function stripTrailingSlashes(value) {
|
|
51
|
+
let end = value.length;
|
|
52
|
+
while (end > 0 && value.charAt(end - 1) === SLASH) end -= 1;
|
|
53
|
+
return end === value.length ? value : value.slice(0, end);
|
|
54
|
+
}
|
|
55
|
+
function stripSurroundingSlashes(value) {
|
|
56
|
+
let start = 0;
|
|
57
|
+
let end = value.length;
|
|
58
|
+
while (start < end && value.charAt(start) === SLASH) start += 1;
|
|
59
|
+
while (end > start && value.charAt(end - 1) === SLASH) end -= 1;
|
|
60
|
+
return start === 0 && end === value.length ? value : value.slice(start, end);
|
|
61
|
+
}
|
|
62
|
+
|
|
48
63
|
// src/helpers/build-object-key.ts
|
|
49
64
|
function buildObjectKey(...parts) {
|
|
50
|
-
return parts.map((
|
|
65
|
+
return parts.map((part) => stripSurroundingSlashes(part)).filter(Boolean).join("/");
|
|
51
66
|
}
|
|
52
67
|
|
|
53
68
|
// src/helpers/parse-file-name.ts
|
|
@@ -205,7 +220,7 @@ function truncateFileName(name, maxChars = 48) {
|
|
|
205
220
|
// src/helpers/normalize-object-key.ts
|
|
206
221
|
var S3_MAX_OBJECT_KEY_LENGTH = 1024;
|
|
207
222
|
function normalizeObjectKey(key) {
|
|
208
|
-
const trimmed = key
|
|
223
|
+
const trimmed = stripSurroundingSlashes(key);
|
|
209
224
|
if (!trimmed) return null;
|
|
210
225
|
if (trimmed.length > S3_MAX_OBJECT_KEY_LENGTH) return null;
|
|
211
226
|
if (trimmed.includes("\\") || trimmed.includes("\0")) return null;
|
|
@@ -262,7 +277,7 @@ function matchesMagicBytes(bytes, expected) {
|
|
|
262
277
|
|
|
263
278
|
// src/helpers/public-object-url.ts
|
|
264
279
|
function buildPublicObjectUrl(options) {
|
|
265
|
-
const base = options.baseUrl
|
|
280
|
+
const base = stripTrailingSlashes(options.baseUrl);
|
|
266
281
|
const path = options.key.split("/").filter((part) => part.length > 0).map((part) => encodeURIComponent(part)).join("/");
|
|
267
282
|
return `${base}/${path}`;
|
|
268
283
|
}
|
|
@@ -500,7 +515,7 @@ function isS3ErrorCode(error, code) {
|
|
|
500
515
|
// src/routes.ts
|
|
501
516
|
var S3_API_BASE_PATH = "/api/s3";
|
|
502
517
|
function normalizeS3ApiBasePath(basePath) {
|
|
503
|
-
return basePath
|
|
518
|
+
return stripTrailingSlashes(basePath);
|
|
504
519
|
}
|
|
505
520
|
var S3_API_ROUTES = {
|
|
506
521
|
upload: "/presign/upload",
|
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/resolve-inline-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.slice(0, -1));\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.replaceAll(/^\\/+|\\/+$/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.split(\"/\").findLast((part) => part.length > 0);\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","/** Binary size units used by {@link formatFileSize}. */\nexport type FileSizeUnit = \"B\" | \"KB\" | \"MB\" | \"GB\" | \"TB\" | \"PB\" | \"EB\";\n\nconst UNITS: readonly FileSizeUnit[] = [\n \"B\",\n \"KB\",\n \"MB\",\n \"GB\",\n \"TB\",\n \"PB\",\n \"EB\",\n];\n\n/** Options for {@link formatFileSize}. */\nexport type FormatFileSizeOptions = {\n /**\n * Locale for digits and the decimal mark, such as `\"fa\"` for `۱۲٫۴`.\n * @default \"en-US\"\n */\n locale?: string | readonly string[];\n /** Unit labels, such as translated ones. Missing units stay `B`, `KB`, … */\n units?: Partial<Record<FileSizeUnit, string>>;\n};\n\nconst numberFormats = new Map<string, Intl.NumberFormat>();\n\nfunction numberFormat(\n locale: string | readonly string[],\n fractionDigits: number,\n): Intl.NumberFormat {\n const id = `${String(locale)}|${fractionDigits}`;\n let format = numberFormats.get(id);\n if (!format) {\n format = new Intl.NumberFormat(\n typeof locale === \"string\" ? locale : [...locale],\n {\n minimumFractionDigits: fractionDigits,\n maximumFractionDigits: fractionDigits,\n useGrouping: false,\n },\n );\n numberFormats.set(id, format);\n }\n return format;\n}\n\n/**\n * Formats a byte count with 1024-based units: `1.2 MB`, `512 B`.\n * Pass `locale` for native digits and `units` for translated labels.\n */\nexport function formatFileSize(\n bytes: number,\n options: FormatFileSizeOptions = {},\n): string {\n const size = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;\n const i =\n size === 0\n ? 0\n : Math.min(Math.floor(Math.log(size) / Math.log(1024)), UNITS.length - 1);\n const unit = UNITS[i] ?? \"B\";\n const value = numberFormat(options.locale ?? \"en-US\", i === 0 ? 0 : 1).format(\n size / 1024 ** i,\n );\n return `${value} ${options.units?.[unit] ?? unit}`;\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\n .replaceAll(/[^\\x20-\\x7E]/g, \"_\")\n .replaceAll(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `${type}; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","import type { ContentDispositionType } from \"./build-content-disposition\";\n\n/** Types a browser can render from a name alone, for objects stored without a type. */\nconst TYPE_BY_EXTENSION: Readonly<Record<string, string>> = {\n avif: \"image/avif\",\n bmp: \"image/bmp\",\n gif: \"image/gif\",\n jpeg: \"image/jpeg\",\n jpg: \"image/jpeg\",\n png: \"image/png\",\n svg: \"image/svg+xml\",\n webp: \"image/webp\",\n pdf: \"application/pdf\",\n json: \"application/json\",\n csv: \"text/csv\",\n txt: \"text/plain\",\n htm: \"text/html\",\n html: \"text/html\",\n xhtml: \"application/xhtml+xml\",\n xml: \"application/xml\",\n js: \"text/javascript\",\n mjs: \"text/javascript\",\n m4a: \"audio/mp4\",\n mp3: \"audio/mpeg\",\n oga: \"audio/ogg\",\n ogg: \"audio/ogg\",\n wav: \"audio/wav\",\n weba: \"audio/webm\",\n mov: \"video/quicktime\",\n mp4: \"video/mp4\",\n ogv: \"video/ogg\",\n webm: \"video/webm\",\n};\n\n/** Types without a real value: fall back to the file name. */\nconst UNTYPED = new Set([\n \"\",\n \"application/octet-stream\",\n \"binary/octet-stream\",\n]);\n\nfunction baseType(contentType: string | undefined): string {\n const [type = \"\"] = (contentType ?? \"\").split(\";\", 1);\n return type.trim().toLowerCase();\n}\n\nfunction typeFromFileName(fileName: string | undefined): string | undefined {\n const dot = fileName?.lastIndexOf(\".\") ?? -1;\n if (!fileName || dot < 0) return undefined;\n return TYPE_BY_EXTENSION[fileName.slice(dot + 1).toLowerCase()];\n}\n\n/**\n * Types that run as a page in the browser: HTML, any XML (SVG, XHTML), and\n * JavaScript. Only an exact entry in the allow list renders them inline.\n */\nfunction isActiveContentType(type: string): boolean {\n return (\n type === \"text/html\" ||\n type.endsWith(\"/xml\") ||\n type.endsWith(\"+xml\") ||\n type.includes(\"javascript\") ||\n type.includes(\"ecmascript\")\n );\n}\n\nfunction isAllowed(type: string, allow: readonly string[]): boolean {\n const active = isActiveContentType(type);\n return allow.some((entry) => {\n const token = entry.trim().toLowerCase();\n if (token === type) return true;\n if (active || !token.endsWith(\"/*\")) return false;\n return type.startsWith(token.slice(0, -1));\n });\n}\n\n/** Input for {@link resolveInlineDisposition}. */\nexport type ResolveInlineDispositionInput = {\n /** Stored type, such as HeadObject `ContentType`. */\n contentType?: string;\n /** Used for the type when `contentType` is missing or `application/octet-stream`. */\n fileName?: string;\n /**\n * MIME types, or `type/*` wildcards, that may open in the browser.\n * File extensions are not accepted: the name does not decide what renders.\n * A wildcard never matches HTML, XML (including `image/svg+xml`), or\n * JavaScript; list those types exactly to allow them.\n */\n allow: readonly string[];\n /** Client request or route default. */\n requested?: ContentDispositionType;\n};\n\n/** Result of {@link resolveInlineDisposition}. */\nexport type ResolveInlineDispositionResult = {\n disposition: ContentDispositionType;\n /**\n * Set when inline is allowed but the object has no usable stored type:\n * the type matched from the file name. Sign it as `ResponseContentType`\n * so the browser renders the object.\n */\n contentType?: string;\n};\n\n/**\n * Whether an object may open in the browser. `inline` is kept only when the\n * object's type is on `allow`; anything else is signed as `attachment`.\n * `download.inlineTypes` on a route runs this on presign and `/file`, and a\n * client can call it with the same list to choose Preview or Download.\n */\nexport function resolveInlineDisposition(\n input: ResolveInlineDispositionInput,\n): ResolveInlineDispositionResult {\n if (input.requested !== \"inline\") return { disposition: \"attachment\" };\n const stored = baseType(input.contentType);\n const untyped = UNTYPED.has(stored);\n const type = untyped ? typeFromFileName(input.fileName) : stored;\n if (!type || !isAllowed(type, input.allow)) {\n return { disposition: \"attachment\" };\n }\n return untyped\n ? { disposition: \"inline\", contentType: type }\n : { disposition: \"inline\" };\n}\n","/** Sanitizes a file name for Content-Disposition, query params, and object keys. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replaceAll(/[\"\\\\\\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.replaceAll(/^\\/+|\\/+$/gu, \"\");\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 return btoa(String.fromCharCode(...bytes)).replaceAll(/=+$/g, \"\");\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.subarray(8, 12));\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.slice(0, -1));\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.replaceAll(/\\/+$/g, \"\");\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-z][\\w-]{0,63}$/i;\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-Z0-9+/]{43}=?$/i,\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, S3_MAX_EXPIRES_IN } 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 /**\n * Maximum presign TTL in seconds. Clients may request a shorter\n * `expiresIn`. Omitted means the protocol default (600).\n */\n expiresIn: z.int().positive().max(S3_MAX_EXPIRES_IN).optional(),\n disposition: downloadDispositionSchema.optional(),\n /** Types that may open inline. Pass to `resolveInlineDisposition`. */\n inlineTypes: z.array(z.string()).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 S3_MAX_EXPIRES_IN,\n} from \"./shared\";\n\n/**\n * Positive TTL in seconds. Query strings arrive as digits; blank is omitted.\n * Values above the SigV4 maximum are rejected. The route cap is applied later.\n */\nconst optionalExpiresInSchema = z.preprocess((value: unknown) => {\n if (value == null || value === \"\") return undefined;\n if (typeof value === \"number\") return value;\n if (typeof value === \"string\") {\n const trimmed = value.trim();\n if (trimmed === \"\") return undefined;\n if (/^\\d+$/.test(trimmed)) return Number(trimmed);\n }\n return value;\n}, z.int().positive().max(S3_MAX_EXPIRES_IN).optional());\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 * Requested TTL in seconds. Signed only when it is shorter than the\n * route `download.expiresIn`. `download.resolve` can still replace it.\n */\n expiresIn: optionalExpiresInSchema,\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.replaceAll(/\\/+$/g, \"\");\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 for (const [key, value] of new Headers(extra)) {\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.replaceAll(/^\\/+/g, \"\")}`;\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, expiresIn } =\n 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 expiresIn,\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 (Object.hasOwn(pluginMethods, plugin.id)) {\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/strip-slashes.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/resolve-inline-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.slice(0, -1));\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","const SLASH = \"/\";\n\n/** Drop trailing `/` in linear time so a long slash run cannot backtrack. */\nexport function stripTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value.charAt(end - 1) === SLASH) end -= 1;\n return end === value.length ? value : value.slice(0, end);\n}\n\n/** Drop leading and trailing `/` in linear time so a long slash run cannot backtrack. */\nexport function stripSurroundingSlashes(value: string): string {\n let start = 0;\n let end = value.length;\n while (start < end && value.charAt(start) === SLASH) start += 1;\n while (end > start && value.charAt(end - 1) === SLASH) end -= 1;\n return start === 0 && end === value.length ? value : value.slice(start, end);\n}\n","import { stripSurroundingSlashes } from \"./strip-slashes\";\n\nexport function buildObjectKey(...parts: string[]): string {\n return parts\n .map((part) => stripSurroundingSlashes(part))\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.split(\"/\").findLast((part) => part.length > 0);\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","/** Binary size units used by {@link formatFileSize}. */\nexport type FileSizeUnit = \"B\" | \"KB\" | \"MB\" | \"GB\" | \"TB\" | \"PB\" | \"EB\";\n\nconst UNITS: readonly FileSizeUnit[] = [\n \"B\",\n \"KB\",\n \"MB\",\n \"GB\",\n \"TB\",\n \"PB\",\n \"EB\",\n];\n\n/** Options for {@link formatFileSize}. */\nexport type FormatFileSizeOptions = {\n /**\n * Locale for digits and the decimal mark, such as `\"fa\"` for `۱۲٫۴`.\n * @default \"en-US\"\n */\n locale?: string | readonly string[];\n /** Unit labels, such as translated ones. Missing units stay `B`, `KB`, … */\n units?: Partial<Record<FileSizeUnit, string>>;\n};\n\nconst numberFormats = new Map<string, Intl.NumberFormat>();\n\nfunction numberFormat(\n locale: string | readonly string[],\n fractionDigits: number,\n): Intl.NumberFormat {\n const id = `${String(locale)}|${fractionDigits}`;\n let format = numberFormats.get(id);\n if (!format) {\n format = new Intl.NumberFormat(\n typeof locale === \"string\" ? locale : [...locale],\n {\n minimumFractionDigits: fractionDigits,\n maximumFractionDigits: fractionDigits,\n useGrouping: false,\n },\n );\n numberFormats.set(id, format);\n }\n return format;\n}\n\n/**\n * Formats a byte count with 1024-based units: `1.2 MB`, `512 B`.\n * Pass `locale` for native digits and `units` for translated labels.\n */\nexport function formatFileSize(\n bytes: number,\n options: FormatFileSizeOptions = {},\n): string {\n const size = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;\n const i =\n size === 0\n ? 0\n : Math.min(Math.floor(Math.log(size) / Math.log(1024)), UNITS.length - 1);\n const unit = UNITS[i] ?? \"B\";\n const value = numberFormat(options.locale ?? \"en-US\", i === 0 ? 0 : 1).format(\n size / 1024 ** i,\n );\n return `${value} ${options.units?.[unit] ?? unit}`;\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\n .replaceAll(/[^\\x20-\\x7E]/g, \"_\")\n .replaceAll(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `${type}; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","import type { ContentDispositionType } from \"./build-content-disposition\";\n\n/** Types a browser can render from a name alone, for objects stored without a type. */\nconst TYPE_BY_EXTENSION: Readonly<Record<string, string>> = {\n avif: \"image/avif\",\n bmp: \"image/bmp\",\n gif: \"image/gif\",\n jpeg: \"image/jpeg\",\n jpg: \"image/jpeg\",\n png: \"image/png\",\n svg: \"image/svg+xml\",\n webp: \"image/webp\",\n pdf: \"application/pdf\",\n json: \"application/json\",\n csv: \"text/csv\",\n txt: \"text/plain\",\n htm: \"text/html\",\n html: \"text/html\",\n xhtml: \"application/xhtml+xml\",\n xml: \"application/xml\",\n js: \"text/javascript\",\n mjs: \"text/javascript\",\n m4a: \"audio/mp4\",\n mp3: \"audio/mpeg\",\n oga: \"audio/ogg\",\n ogg: \"audio/ogg\",\n wav: \"audio/wav\",\n weba: \"audio/webm\",\n mov: \"video/quicktime\",\n mp4: \"video/mp4\",\n ogv: \"video/ogg\",\n webm: \"video/webm\",\n};\n\n/** Types without a real value: fall back to the file name. */\nconst UNTYPED = new Set([\n \"\",\n \"application/octet-stream\",\n \"binary/octet-stream\",\n]);\n\nfunction baseType(contentType: string | undefined): string {\n const [type = \"\"] = (contentType ?? \"\").split(\";\", 1);\n return type.trim().toLowerCase();\n}\n\nfunction typeFromFileName(fileName: string | undefined): string | undefined {\n const dot = fileName?.lastIndexOf(\".\") ?? -1;\n if (!fileName || dot < 0) return undefined;\n return TYPE_BY_EXTENSION[fileName.slice(dot + 1).toLowerCase()];\n}\n\n/**\n * Types that run as a page in the browser: HTML, any XML (SVG, XHTML), and\n * JavaScript. Only an exact entry in the allow list renders them inline.\n */\nfunction isActiveContentType(type: string): boolean {\n return (\n type === \"text/html\" ||\n type.endsWith(\"/xml\") ||\n type.endsWith(\"+xml\") ||\n type.includes(\"javascript\") ||\n type.includes(\"ecmascript\")\n );\n}\n\nfunction isAllowed(type: string, allow: readonly string[]): boolean {\n const active = isActiveContentType(type);\n return allow.some((entry) => {\n const token = entry.trim().toLowerCase();\n if (token === type) return true;\n if (active || !token.endsWith(\"/*\")) return false;\n return type.startsWith(token.slice(0, -1));\n });\n}\n\n/** Input for {@link resolveInlineDisposition}. */\nexport type ResolveInlineDispositionInput = {\n /** Stored type, such as HeadObject `ContentType`. */\n contentType?: string;\n /** Used for the type when `contentType` is missing or `application/octet-stream`. */\n fileName?: string;\n /**\n * MIME types, or `type/*` wildcards, that may open in the browser.\n * File extensions are not accepted: the name does not decide what renders.\n * A wildcard never matches HTML, XML (including `image/svg+xml`), or\n * JavaScript; list those types exactly to allow them.\n */\n allow: readonly string[];\n /** Client request or route default. */\n requested?: ContentDispositionType;\n};\n\n/** Result of {@link resolveInlineDisposition}. */\nexport type ResolveInlineDispositionResult = {\n disposition: ContentDispositionType;\n /**\n * Set when inline is allowed but the object has no usable stored type:\n * the type matched from the file name. Sign it as `ResponseContentType`\n * so the browser renders the object.\n */\n contentType?: string;\n};\n\n/**\n * Whether an object may open in the browser. `inline` is kept only when the\n * object's type is on `allow`; anything else is signed as `attachment`.\n * `download.inlineTypes` on a route runs this on presign and `/file`, and a\n * client can call it with the same list to choose Preview or Download.\n */\nexport function resolveInlineDisposition(\n input: ResolveInlineDispositionInput,\n): ResolveInlineDispositionResult {\n if (input.requested !== \"inline\") return { disposition: \"attachment\" };\n const stored = baseType(input.contentType);\n const untyped = UNTYPED.has(stored);\n const type = untyped ? typeFromFileName(input.fileName) : stored;\n if (!type || !isAllowed(type, input.allow)) {\n return { disposition: \"attachment\" };\n }\n return untyped\n ? { disposition: \"inline\", contentType: type }\n : { disposition: \"inline\" };\n}\n","/** Sanitizes a file name for Content-Disposition, query params, and object keys. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replaceAll(/[\"\\\\\\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","import { stripSurroundingSlashes } from \"./strip-slashes\";\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 = stripSurroundingSlashes(key);\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 return btoa(String.fromCharCode(...bytes)).replaceAll(/=+$/g, \"\");\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.subarray(8, 12));\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.slice(0, -1));\n }\n return sniffed === expected;\n}\n","import { stripTrailingSlashes } from \"./strip-slashes\";\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 = stripTrailingSlashes(options.baseUrl);\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-z][\\w-]{0,63}$/i;\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-Z0-9+/]{43}=?$/i,\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, S3_MAX_EXPIRES_IN } 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 /**\n * Maximum presign TTL in seconds. Clients may request a shorter\n * `expiresIn`. Omitted means the protocol default (600).\n */\n expiresIn: z.int().positive().max(S3_MAX_EXPIRES_IN).optional(),\n disposition: downloadDispositionSchema.optional(),\n /** Types that may open inline. Pass to `resolveInlineDisposition`. */\n inlineTypes: z.array(z.string()).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 S3_MAX_EXPIRES_IN,\n} from \"./shared\";\n\n/**\n * Positive TTL in seconds. Query strings arrive as digits; blank is omitted.\n * Values above the SigV4 maximum are rejected. The route cap is applied later.\n */\nconst optionalExpiresInSchema = z.preprocess((value: unknown) => {\n if (value == null || value === \"\") return undefined;\n if (typeof value === \"number\") return value;\n if (typeof value === \"string\") {\n const trimmed = value.trim();\n if (trimmed === \"\") return undefined;\n if (/^\\d+$/.test(trimmed)) return Number(trimmed);\n }\n return value;\n}, z.int().positive().max(S3_MAX_EXPIRES_IN).optional());\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 * Requested TTL in seconds. Signed only when it is shorter than the\n * route `download.expiresIn`. `download.resolve` can still replace it.\n */\n expiresIn: optionalExpiresInSchema,\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","import { stripTrailingSlashes } from \"./helpers/strip-slashes\";\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 stripTrailingSlashes(basePath);\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 for (const [key, value] of new Headers(extra)) {\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.replaceAll(/^\\/+/g, \"\")}`;\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, expiresIn } =\n 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 expiresIn,\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 (Object.hasOwn(pluginMethods, plugin.id)) {\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/dist/routes.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa;aACxB,MAAM,EAAE,iBAAiB;aACzB,aAAa,EAAE,yBAAyB;aACxC,QAAQ,EAAE,mBAAmB;aAC7B,IAAI,EAAE,OAAO;aACb,OAAO,EAAE,SAAS;aAClB,MAAM,EAAE,SAAS;aACjB,WAAW,EAAE,eAAe;aAC5B,aAAa,EAAE,yBAAyB;aACxC,aAAa,EAAE,yBAAyB;aACxC,iBAAiB,EAAE,6BAA6B;aAChD,cAAc,EAAE,0BAA0B;aAC1C,kBAAkB,EAAE,0BAA0B;CACtC,CAAC"}
|