@dimah-s3/core 1.5.11 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"create-s3-client.d.ts","sourceRoot":"","sources":["../src/create-s3-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EASV,KAAK,EAIN,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,UAAU,CAAC;AAOlB,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,SAAS,cAAc,EAAE,IAC7D;IACF,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,GAAG,oBAAoB,CAAC;AAuGzB,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,IACvE,KAAK,GACH,sBAAsB,CAAC,CAAC,CAAC,GAAG;IAC1B,YAAY,EAAE,OAAO,cAAc,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC;CACxB,CAAC;AAEN;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,EAC3E,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,oBAAoB,CAAC,CAAC,CAAC,CA2BzB"}
1
+ {"version":3,"file":"create-s3-client.d.ts","sourceRoot":"","sources":["../src/create-s3-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EASV,KAAK,EAIN,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,UAAU,CAAC;AAOlB,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,SAAS,cAAc,EAAE,IAC7D;IACF,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,GAAG,oBAAoB,CAAC;AAyGzB,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,IACvE,KAAK,GACH,sBAAsB,CAAC,CAAC,CAAC,GAAG;IAC1B,YAAY,EAAE,OAAO,cAAc,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC;CACxB,CAAC;AAEN;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,EAAE,EAC3E,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,oBAAoB,CAAC,CAAC,CAAC,CA2BzB"}
package/dist/index.js CHANGED
@@ -243,6 +243,11 @@ var routeCatalogUploadSchema = z3.discriminatedUnion("enabled", [
243
243
  var routeCatalogDownloadSchema = z3.discriminatedUnion("enabled", [
244
244
  z3.strictObject({
245
245
  enabled: z3.literal(true),
246
+ /**
247
+ * Maximum presign TTL in seconds. Clients may request a shorter
248
+ * `expiresIn`. Omitted means the protocol default (600).
249
+ */
250
+ expiresIn: z3.int().positive().max(S3_MAX_EXPIRES_IN).optional(),
246
251
  disposition: downloadDispositionSchema.optional(),
247
252
  mode: downloadModeSchema.optional()
248
253
  }),
@@ -262,11 +267,26 @@ var routeCatalogResponseSchema = z3.strictObject({
262
267
  });
263
268
 
264
269
  // src/schema/download.ts
270
+ var optionalExpiresInSchema = z3.preprocess((value) => {
271
+ if (value == null || value === "") return void 0;
272
+ if (typeof value === "number") return value;
273
+ if (typeof value === "string") {
274
+ const trimmed = value.trim();
275
+ if (trimmed === "") return void 0;
276
+ if (/^\d+$/.test(trimmed)) return Number(trimmed);
277
+ }
278
+ return value;
279
+ }, z3.int().positive().max(S3_MAX_EXPIRES_IN).optional());
265
280
  var downloadQuerySchema = z3.strictObject({
266
281
  route: routeNameSchema,
267
282
  key: objectKeySchema,
268
283
  fileName: optionalTrimmedString,
269
- disposition: downloadDispositionSchema.optional()
284
+ disposition: downloadDispositionSchema.optional(),
285
+ /**
286
+ * Requested TTL in seconds. Signed only when it is shorter than the
287
+ * route `download.expiresIn`. `download.resolve` can still replace it.
288
+ */
289
+ expiresIn: optionalExpiresInSchema
270
290
  });
271
291
  var DELETE_BATCH_MAX_KEYS = 100;
272
292
  var deleteQuerySchema = z3.strictObject({
@@ -495,14 +515,15 @@ function createCoreApi($fetch) {
495
515
  });
496
516
  },
497
517
  download(payload) {
498
- const { route, key, fileName, disposition } = withoutHeaders(payload);
518
+ const { route, key, fileName, disposition, expiresIn } = withoutHeaders(payload);
499
519
  return $fetch(S3_API_ROUTES.download, {
500
520
  method: "GET",
501
521
  query: {
502
522
  route,
503
523
  key,
504
524
  fileName: fileName ? sanitizeFileName(fileName) : void 0,
505
- disposition
525
+ disposition,
526
+ expiresIn
506
527
  }
507
528
  });
508
529
  },
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.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","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\n .replaceAll(/[^\\x20-\\x7E]/g, \"_\")\n .replaceAll(/[\"\\\\]/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.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 } 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.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 } = 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 (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/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.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","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\n .replaceAll(/[^\\x20-\\x7E]/g, \"_\")\n .replaceAll(/[\"\\\\]/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.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 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"]}
@@ -20,6 +20,7 @@ export declare const routeCatalogUploadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
20
20
  }, z.core.$strict>], "enabled">;
21
21
  export declare const routeCatalogDownloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
22
22
  enabled: z.ZodLiteral<true>;
23
+ expiresIn: z.ZodOptional<z.ZodInt>;
23
24
  disposition: z.ZodOptional<z.ZodEnum<{
24
25
  attachment: "attachment";
25
26
  inline: "inline";
@@ -49,6 +50,7 @@ export declare const routeCatalogEntrySchema: z.ZodObject<{
49
50
  }, z.core.$strict>], "enabled">;
50
51
  download: z.ZodDiscriminatedUnion<[z.ZodObject<{
51
52
  enabled: z.ZodLiteral<true>;
53
+ expiresIn: z.ZodOptional<z.ZodInt>;
52
54
  disposition: z.ZodOptional<z.ZodEnum<{
53
55
  attachment: "attachment";
54
56
  inline: "inline";
@@ -80,6 +82,7 @@ export declare const routeCatalogResponseSchema: z.ZodObject<{
80
82
  }, z.core.$strict>], "enabled">;
81
83
  download: z.ZodDiscriminatedUnion<[z.ZodObject<{
82
84
  enabled: z.ZodLiteral<true>;
85
+ expiresIn: z.ZodOptional<z.ZodInt>;
83
86
  disposition: z.ZodOptional<z.ZodEnum<{
84
87
  attachment: "attachment";
85
88
  inline: "inline";
@@ -1 +1 @@
1
- {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/schema/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,yBAAyB;;;EAAmC,CAAC;AAC1E,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAE/D,eAAO,MAAM,wBAAwB;;;;;;;;;+BAUnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;+BAOrC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;+BAGnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAErC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;CAChD,CAAC"}
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/schema/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,yBAAyB;;;EAAmC,CAAC;AAC1E,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAE/D,eAAO,MAAM,wBAAwB;;;;;;;;;+BAUnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;+BAYrC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;+BAGnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAErC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;CAChD,CAAC"}
@@ -8,5 +8,6 @@ export declare const downloadQuerySchema: z.ZodObject<{
8
8
  attachment: "attachment";
9
9
  inline: "inline";
10
10
  }>>;
11
+ expiresIn: z.ZodPreprocess<z.ZodOptional<z.ZodInt>, unknown>;
11
12
  }, z.core.$strict>;
12
13
  //# sourceMappingURL=download.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/schema/download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;;;;;;;kBAK9B,CAAC"}
1
+ {"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/schema/download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAwBzB,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;;;;;;;;kBAU9B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dimah-s3/core",
3
- "version": "1.5.11",
3
+ "version": "1.6.0",
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",
@@ -34,20 +34,20 @@
34
34
  "dist"
35
35
  ],
36
36
  "dependencies": {
37
- "@better-fetch/fetch": "1.3.2",
38
- "better-call": "1.4.2",
39
- "zod": "^4.6.5"
37
+ "@better-fetch/fetch": "1.3.3",
38
+ "better-call": "1.4.4",
39
+ "zod": "^4.6.7"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@workspace/eslint-config": "0.0.1",
43
43
  "@workspace/tsup-config": "0.0.0",
44
44
  "@workspace/typescript-config": "0.0.1",
45
45
  "@workspace/vitest-config": "0.0.7",
46
- "eslint": "^10.12.0",
47
- "tsc-alias": "^1.9.7",
48
- "tsup": "^8.5.1",
46
+ "eslint": "^10.13.0",
47
+ "tsc-alias": "^1.9.9",
48
+ "tsup": "^9.0.0",
49
49
  "typescript": "7.0.2",
50
- "vitest": "^5.0.3"
50
+ "vitest": "^5.0.5"
51
51
  },
52
52
  "publishConfig": {
53
53
  "access": "public"