@dimah-s3/server 0.7.3 → 0.8.0

package/README.md

@@ -14,16 +14,15 @@ pnpm add @dimah-s3/server @aws-sdk/client-s3
 ## Minimal setup
 
 ```ts
+import { S3Client } from "@aws-sdk/client-s3";
 import { dimahS3 } from "@dimah-s3/server";
-import { s3Client, defaultBucket } from "@/lib/s3-client";
+
+export const awsS3 = new S3Client({/* env */});
 
 export const s3 = dimahS3({
-  s3: s3Client,
-  defaultBucket,
-  upload: { enabled: true },
-  download: { enabled: false },
-  delete: { enabled: false },
-  multipart: { enabled: false },
+  client: awsS3,
+  bucket: process.env.S3_BUCKET!,
+  upload: { prefix: "uploads" },
 });
 ```
 
@@ -32,7 +31,7 @@ Mount with a framework adapter:
 ```ts
 // Next.js
 import { toNextJsHandler } from "@dimah-s3/server/next";
-export const { GET, POST, DELETE } = toNextJsHandler(s3);
+export const { GET, POST, PUT, PATCH, DELETE } = toNextJsHandler(s3);
 
 // Express — @dimah-s3/server/express → toExpressHandler
 // Hono    — @dimah-s3/server/hono → toHonoHandler
@@ -47,7 +46,7 @@ See [Server setup](https://dimah-s3.vercel.app/docs/server/setup) for full examp
 Server-side (no HTTP):
 
 ```ts
-await s3.api.download(key, { headers: await headers() });
+await s3.api.download({ query: { key }, headers: await headers() });
 ```
 
 Optional persistence: add `db()` from [`@dimah-s3/db`](../db) to `plugins`.

package/dist/adapters/express.js

@@ -1,50 +1,45 @@
+import { toResponse } from 'better-call';
 import { DimahS3Error, S3_ERROR_CODES } from '@dimah-s3/core';
 
-// src/errors.ts
+// src/adapters/node.ts
 var errors = {
-  notFound: () => new DimahS3Error("Not Found", 404, { code: S3_ERROR_CODES.NOT_FOUND }),
-  invalidJson: () => new DimahS3Error("Invalid JSON payload", 400, {
-    code: S3_ERROR_CODES.INVALID_JSON
-  }),
-  forbidden: () => new DimahS3Error("Forbidden", 403, { code: S3_ERROR_CODES.FORBIDDEN }),
-  internalError: () => new DimahS3Error("Internal server error", 500, {
-    code: S3_ERROR_CODES.INTERNAL_ERROR
-  }),
-  objectNotFound: () => new DimahS3Error("Object not found", 404, {
-    code: S3_ERROR_CODES.OBJECT_NOT_FOUND
-  }),
-  s3NetworkError: (code) => new DimahS3Error(
-    `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,
-    502,
-    { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } }
-  ),
-  fieldRequired: (name) => new DimahS3Error(`${name} is required`, 400, {
-    code: S3_ERROR_CODES.FIELD_REQUIRED,
-    params: { name }
-  }),
-  /** Missing `key` on query-string routes (download / delete / list-parts). */
-  keyRequired: () => new DimahS3Error("key query parameter is required", 400, {
-    code: S3_ERROR_CODES.KEY_REQUIRED
-  }),
-  uploadIdRequired: () => new DimahS3Error("uploadId is required", 400, {
-    code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED
+  notFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.NOT_FOUND),
+  unauthorized: () => DimahS3Error.from("UNAUTHORIZED", S3_ERROR_CODES.UNAUTHORIZED),
+  forbidden: () => DimahS3Error.from("FORBIDDEN", S3_ERROR_CODES.FORBIDDEN),
+  conflict: () => DimahS3Error.from("CONFLICT", S3_ERROR_CODES.CONFLICT),
+  internalError: () => DimahS3Error.from("INTERNAL_SERVER_ERROR", S3_ERROR_CODES.INTERNAL_ERROR),
+  objectNotFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.OBJECT_NOT_FOUND),
+  featureDisabled: (feature) => DimahS3Error.from("NOT_FOUND", {
+    code: S3_ERROR_CODES.FEATURE_DISABLED.code,
+    message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(
+      "{feature}",
+      feature
+    ),
+    params: { feature }
   }),
-  partNumberInvalid: () => new DimahS3Error("partNumber must be a positive integer", 400, {
-    code: S3_ERROR_CODES.PART_NUMBER_INVALID
+  invalidKey: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.INVALID_KEY),
+  invalidBucket: (bucket) => DimahS3Error.from("FORBIDDEN", {
+    code: S3_ERROR_CODES.INVALID_BUCKET.code,
+    message: S3_ERROR_CODES.INVALID_BUCKET.message,
+    params: { bucket }
   }),
-  partsRequired: () => new DimahS3Error("At least one valid part is required", 400, {
-    code: S3_ERROR_CODES.PARTS_REQUIRED
+  s3NetworkError: (code) => DimahS3Error.from("BAD_GATEWAY", {
+    code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,
+    message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(
+      "{code}",
+      code
+    ),
+    params: { code }
   }),
-  fileSizeRequiredUpload: () => new DimahS3Error(
-    "fileSize is required when upload.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD }
+  fileSizeRequiredUpload: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),
+  fileSizeRequiredMultipart: () => DimahS3Error.from(
+    "BAD_REQUEST",
+    S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART
   ),
-  fileSizeRequiredMultipart: () => new DimahS3Error(
-    "fileSize is required when multipart.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART }
-  )
+  validationError: (message) => DimahS3Error.from("BAD_REQUEST", {
+    code: S3_ERROR_CODES.VALIDATION_ERROR.code,
+    message
+  })
 };
 
 // src/adapters/node.ts
@@ -101,15 +96,7 @@ function toNodeHandler(s3) {
     } catch (err) {
       console.error("[S3 API]", err);
       if (!res.headersSent) {
-        const fallback = errors.internalError();
-        res.statusCode = fallback.status;
-        res.setHeader("Content-Type", "application/json");
-        res.end(
-          JSON.stringify({
-            message: fallback.message,
-            code: fallback.code
-          })
-        );
+        await writeWebResponse(res, toResponse(errors.internalError()));
       }
     }
   };

package/dist/adapters/express.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts","../../src/adapters/express.ts"],"names":[],"mappings":"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","file":"express.js","sourcesContent":["import { DimahS3Error, S3_ERROR_CODES, type S3ErrorCode } from \"@dimah-s3/core\";\n\nexport { DimahS3Error };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () =>\n    new DimahS3Error(\"Not Found\", 404, { code: S3_ERROR_CODES.NOT_FOUND }),\n\n  invalidJson: () =>\n    new DimahS3Error(\"Invalid JSON payload\", 400, {\n      code: S3_ERROR_CODES.INVALID_JSON,\n    }),\n\n  forbidden: () =>\n    new DimahS3Error(\"Forbidden\", 403, { code: S3_ERROR_CODES.FORBIDDEN }),\n\n  internalError: () =>\n    new DimahS3Error(\"Internal server error\", 500, {\n      code: S3_ERROR_CODES.INTERNAL_ERROR,\n    }),\n\n  objectNotFound: () =>\n    new DimahS3Error(\"Object not found\", 404, {\n      code: S3_ERROR_CODES.OBJECT_NOT_FOUND,\n    }),\n\n  s3NetworkError: (code: string) =>\n    new DimahS3Error(\n      `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,\n      502,\n      { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } },\n    ),\n\n  fieldRequired: (name: string) =>\n    new DimahS3Error(`${name} is required`, 400, {\n      code: S3_ERROR_CODES.FIELD_REQUIRED,\n      params: { name },\n    }),\n\n  /** Missing `key` on query-string routes (download / delete / list-parts). */\n  keyRequired: () =>\n    new DimahS3Error(\"key query parameter is required\", 400, {\n      code: S3_ERROR_CODES.KEY_REQUIRED,\n    }),\n\n  uploadIdRequired: () =>\n    new DimahS3Error(\"uploadId is required\", 400, {\n      code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED,\n    }),\n\n  partNumberInvalid: () =>\n    new DimahS3Error(\"partNumber must be a positive integer\", 400, {\n      code: S3_ERROR_CODES.PART_NUMBER_INVALID,\n    }),\n\n  partsRequired: () =>\n    new DimahS3Error(\"At least one valid part is required\", 400, {\n      code: S3_ERROR_CODES.PARTS_REQUIRED,\n    }),\n\n  fileSizeRequiredUpload: () =>\n    new DimahS3Error(\n      \"fileSize is required when upload.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD },\n    ),\n\n  fileSizeRequiredMultipart: () =>\n    new DimahS3Error(\n      \"fileSize is required when multipart.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART },\n    ),\n} as const;\n\nexport type ServerErrors = typeof errors;\n\n/** Trim and require a non-empty string; throws {@link errors.fieldRequired}. */\nexport function requireString(value: unknown, name: string): string {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) throw errors.fieldRequired(name);\n  return trimmed;\n}\n\nfunction statusOf(err: unknown, fallback: number): number {\n  return typeof (err as { status?: unknown })?.status === \"number\"\n    ? (err as { status: number }).status\n    : fallback;\n}\n\n/**\n * Convert hook/S3 throws into {@link DimahS3Error}.\n *\n * - Existing {@link DimahS3Error} instances are preserved (including subclasses).\n * - Plain `Error`s keep their message; `code` is only applied when provided\n *   (omit it so clients show the custom English message instead of a mapped\n *   library string).\n */\nexport function toDimahS3Error(\n  err: unknown,\n  fallbackMessage: string,\n  fallbackStatus = 403,\n  options?: { code?: S3ErrorCode | string },\n): DimahS3Error {\n  if (err instanceof DimahS3Error) return err;\n\n  const message =\n    err instanceof Error && err.message.trim() ? err.message : fallbackMessage;\n  const status = statusOf(err, fallbackStatus);\n\n  return new DimahS3Error(message, status, {\n    cause: err instanceof Error ? err : undefined,\n    ...(options?.code !== undefined ? { code: options.code } : {}),\n  });\n}\n","import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download(key, { headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        const fallback = errors.internalError();\n        res.statusCode = fallback.status;\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.end(\n          JSON.stringify({\n            message: fallback.message,\n            code: fallback.code,\n          }),\n        );\n      }\n    }\n  };\n}\n","import { fromNodeHeaders, toNodeHandler } from \"./node\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\nexport { fromNodeHeaders };\n\n/**\n * Adapt a dimah-s3 instance to an Express / Connect handler.\n *\n * Mount **before** `express.json()` so the request body is not consumed early.\n *\n * @example\n * ```ts\n * import express from \"express\";\n * import { toExpressHandler } from \"@dimah-s3/server/express\";\n * import { s3 } from \"./s3\";\n *\n * const app = express();\n * // Express 4\n * app.all(\"/api/s3/*\", toExpressHandler(s3));\n * // Express 5 — named wildcard\n * // app.all(\"/api/s3/*splat\", toExpressHandler(s3));\n * app.use(express.json());\n * ```\n */\nexport function toExpressHandler(s3: DimahS3HandlerSource) {\n  return toNodeHandler(s3);\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts","../../src/adapters/express.ts"],"names":[],"mappings":"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","file":"express.js","sourcesContent":["import {\n  DimahS3Error,\n  S3_ERROR_CODES,\n  isAPIError,\n  isDimahS3Error,\n  isS3ErrorCode,\n} from \"@dimah-s3/core\";\n\nexport { DimahS3Error, isAPIError, isDimahS3Error, isS3ErrorCode };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () => DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.NOT_FOUND),\n\n  unauthorized: () =>\n    DimahS3Error.from(\"UNAUTHORIZED\", S3_ERROR_CODES.UNAUTHORIZED),\n\n  forbidden: () => DimahS3Error.from(\"FORBIDDEN\", S3_ERROR_CODES.FORBIDDEN),\n\n  conflict: () => DimahS3Error.from(\"CONFLICT\", S3_ERROR_CODES.CONFLICT),\n\n  internalError: () =>\n    DimahS3Error.from(\"INTERNAL_SERVER_ERROR\", S3_ERROR_CODES.INTERNAL_ERROR),\n\n  objectNotFound: () =>\n    DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.OBJECT_NOT_FOUND),\n\n  featureDisabled: (feature: string) =>\n    DimahS3Error.from(\"NOT_FOUND\", {\n      code: S3_ERROR_CODES.FEATURE_DISABLED.code,\n      message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(\n        \"{feature}\",\n        feature,\n      ),\n      params: { feature },\n    }),\n\n  invalidKey: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.INVALID_KEY),\n\n  invalidBucket: (bucket: string) =>\n    DimahS3Error.from(\"FORBIDDEN\", {\n      code: S3_ERROR_CODES.INVALID_BUCKET.code,\n      message: S3_ERROR_CODES.INVALID_BUCKET.message,\n      params: { bucket },\n    }),\n\n  s3NetworkError: (code: string) =>\n    DimahS3Error.from(\"BAD_GATEWAY\", {\n      code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,\n      message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(\n        \"{code}\",\n        code,\n      ),\n      params: { code },\n    }),\n\n  fileSizeRequiredUpload: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),\n\n  fileSizeRequiredMultipart: () =>\n    DimahS3Error.from(\n      \"BAD_REQUEST\",\n      S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART,\n    ),\n\n  validationError: (message: string) =>\n    DimahS3Error.from(\"BAD_REQUEST\", {\n      code: S3_ERROR_CODES.VALIDATION_ERROR.code,\n      message,\n    }),\n} as const;\n\nexport type ServerErrors = typeof errors;\n","import { toResponse } from \"better-call\";\nimport type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download({ query: { key }, headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        await writeWebResponse(res, toResponse(errors.internalError()));\n      }\n    }\n  };\n}\n","import { fromNodeHeaders, toNodeHandler } from \"./node\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\nexport { fromNodeHeaders };\n\n/**\n * Adapt a dimah-s3 instance to an Express / Connect handler.\n *\n * Mount **before** `express.json()` so the request body is not consumed early.\n *\n * @example\n * ```ts\n * import express from \"express\";\n * import { toExpressHandler } from \"@dimah-s3/server/express\";\n * import { s3 } from \"./s3\";\n *\n * const app = express();\n * // Express 4\n * app.all(\"/api/s3/*\", toExpressHandler(s3));\n * // Express 5 — named wildcard\n * // app.all(\"/api/s3/*splat\", toExpressHandler(s3));\n * app.use(express.json());\n * ```\n */\nexport function toExpressHandler(s3: DimahS3HandlerSource) {\n  return toNodeHandler(s3);\n}\n"]}

package/dist/adapters/fastify.js

@@ -1,50 +1,45 @@
+import { toResponse } from 'better-call';
 import { DimahS3Error, S3_ERROR_CODES } from '@dimah-s3/core';
 
-// src/errors.ts
+// src/adapters/node.ts
 var errors = {
-  notFound: () => new DimahS3Error("Not Found", 404, { code: S3_ERROR_CODES.NOT_FOUND }),
-  invalidJson: () => new DimahS3Error("Invalid JSON payload", 400, {
-    code: S3_ERROR_CODES.INVALID_JSON
-  }),
-  forbidden: () => new DimahS3Error("Forbidden", 403, { code: S3_ERROR_CODES.FORBIDDEN }),
-  internalError: () => new DimahS3Error("Internal server error", 500, {
-    code: S3_ERROR_CODES.INTERNAL_ERROR
-  }),
-  objectNotFound: () => new DimahS3Error("Object not found", 404, {
-    code: S3_ERROR_CODES.OBJECT_NOT_FOUND
-  }),
-  s3NetworkError: (code) => new DimahS3Error(
-    `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,
-    502,
-    { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } }
-  ),
-  fieldRequired: (name) => new DimahS3Error(`${name} is required`, 400, {
-    code: S3_ERROR_CODES.FIELD_REQUIRED,
-    params: { name }
-  }),
-  /** Missing `key` on query-string routes (download / delete / list-parts). */
-  keyRequired: () => new DimahS3Error("key query parameter is required", 400, {
-    code: S3_ERROR_CODES.KEY_REQUIRED
-  }),
-  uploadIdRequired: () => new DimahS3Error("uploadId is required", 400, {
-    code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED
+  notFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.NOT_FOUND),
+  unauthorized: () => DimahS3Error.from("UNAUTHORIZED", S3_ERROR_CODES.UNAUTHORIZED),
+  forbidden: () => DimahS3Error.from("FORBIDDEN", S3_ERROR_CODES.FORBIDDEN),
+  conflict: () => DimahS3Error.from("CONFLICT", S3_ERROR_CODES.CONFLICT),
+  internalError: () => DimahS3Error.from("INTERNAL_SERVER_ERROR", S3_ERROR_CODES.INTERNAL_ERROR),
+  objectNotFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.OBJECT_NOT_FOUND),
+  featureDisabled: (feature) => DimahS3Error.from("NOT_FOUND", {
+    code: S3_ERROR_CODES.FEATURE_DISABLED.code,
+    message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(
+      "{feature}",
+      feature
+    ),
+    params: { feature }
   }),
-  partNumberInvalid: () => new DimahS3Error("partNumber must be a positive integer", 400, {
-    code: S3_ERROR_CODES.PART_NUMBER_INVALID
+  invalidKey: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.INVALID_KEY),
+  invalidBucket: (bucket) => DimahS3Error.from("FORBIDDEN", {
+    code: S3_ERROR_CODES.INVALID_BUCKET.code,
+    message: S3_ERROR_CODES.INVALID_BUCKET.message,
+    params: { bucket }
   }),
-  partsRequired: () => new DimahS3Error("At least one valid part is required", 400, {
-    code: S3_ERROR_CODES.PARTS_REQUIRED
+  s3NetworkError: (code) => DimahS3Error.from("BAD_GATEWAY", {
+    code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,
+    message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(
+      "{code}",
+      code
+    ),
+    params: { code }
   }),
-  fileSizeRequiredUpload: () => new DimahS3Error(
-    "fileSize is required when upload.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD }
+  fileSizeRequiredUpload: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),
+  fileSizeRequiredMultipart: () => DimahS3Error.from(
+    "BAD_REQUEST",
+    S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART
   ),
-  fileSizeRequiredMultipart: () => new DimahS3Error(
-    "fileSize is required when multipart.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART }
-  )
+  validationError: (message) => DimahS3Error.from("BAD_REQUEST", {
+    code: S3_ERROR_CODES.VALIDATION_ERROR.code,
+    message
+  })
 };
 
 // src/adapters/node.ts
@@ -101,15 +96,7 @@ function toNodeHandler(s3) {
     } catch (err) {
       console.error("[S3 API]", err);
       if (!res.headersSent) {
-        const fallback = errors.internalError();
-        res.statusCode = fallback.status;
-        res.setHeader("Content-Type", "application/json");
-        res.end(
-          JSON.stringify({
-            message: fallback.message,
-            code: fallback.code
-          })
-        );
+        await writeWebResponse(res, toResponse(errors.internalError()));
       }
     }
   };

package/dist/adapters/fastify.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts","../../src/adapters/fastify.ts"],"names":[],"mappings":"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","file":"fastify.js","sourcesContent":["import { DimahS3Error, S3_ERROR_CODES, type S3ErrorCode } from \"@dimah-s3/core\";\n\nexport { DimahS3Error };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () =>\n    new DimahS3Error(\"Not Found\", 404, { code: S3_ERROR_CODES.NOT_FOUND }),\n\n  invalidJson: () =>\n    new DimahS3Error(\"Invalid JSON payload\", 400, {\n      code: S3_ERROR_CODES.INVALID_JSON,\n    }),\n\n  forbidden: () =>\n    new DimahS3Error(\"Forbidden\", 403, { code: S3_ERROR_CODES.FORBIDDEN }),\n\n  internalError: () =>\n    new DimahS3Error(\"Internal server error\", 500, {\n      code: S3_ERROR_CODES.INTERNAL_ERROR,\n    }),\n\n  objectNotFound: () =>\n    new DimahS3Error(\"Object not found\", 404, {\n      code: S3_ERROR_CODES.OBJECT_NOT_FOUND,\n    }),\n\n  s3NetworkError: (code: string) =>\n    new DimahS3Error(\n      `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,\n      502,\n      { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } },\n    ),\n\n  fieldRequired: (name: string) =>\n    new DimahS3Error(`${name} is required`, 400, {\n      code: S3_ERROR_CODES.FIELD_REQUIRED,\n      params: { name },\n    }),\n\n  /** Missing `key` on query-string routes (download / delete / list-parts). */\n  keyRequired: () =>\n    new DimahS3Error(\"key query parameter is required\", 400, {\n      code: S3_ERROR_CODES.KEY_REQUIRED,\n    }),\n\n  uploadIdRequired: () =>\n    new DimahS3Error(\"uploadId is required\", 400, {\n      code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED,\n    }),\n\n  partNumberInvalid: () =>\n    new DimahS3Error(\"partNumber must be a positive integer\", 400, {\n      code: S3_ERROR_CODES.PART_NUMBER_INVALID,\n    }),\n\n  partsRequired: () =>\n    new DimahS3Error(\"At least one valid part is required\", 400, {\n      code: S3_ERROR_CODES.PARTS_REQUIRED,\n    }),\n\n  fileSizeRequiredUpload: () =>\n    new DimahS3Error(\n      \"fileSize is required when upload.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD },\n    ),\n\n  fileSizeRequiredMultipart: () =>\n    new DimahS3Error(\n      \"fileSize is required when multipart.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART },\n    ),\n} as const;\n\nexport type ServerErrors = typeof errors;\n\n/** Trim and require a non-empty string; throws {@link errors.fieldRequired}. */\nexport function requireString(value: unknown, name: string): string {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) throw errors.fieldRequired(name);\n  return trimmed;\n}\n\nfunction statusOf(err: unknown, fallback: number): number {\n  return typeof (err as { status?: unknown })?.status === \"number\"\n    ? (err as { status: number }).status\n    : fallback;\n}\n\n/**\n * Convert hook/S3 throws into {@link DimahS3Error}.\n *\n * - Existing {@link DimahS3Error} instances are preserved (including subclasses).\n * - Plain `Error`s keep their message; `code` is only applied when provided\n *   (omit it so clients show the custom English message instead of a mapped\n *   library string).\n */\nexport function toDimahS3Error(\n  err: unknown,\n  fallbackMessage: string,\n  fallbackStatus = 403,\n  options?: { code?: S3ErrorCode | string },\n): DimahS3Error {\n  if (err instanceof DimahS3Error) return err;\n\n  const message =\n    err instanceof Error && err.message.trim() ? err.message : fallbackMessage;\n  const status = statusOf(err, fallbackStatus);\n\n  return new DimahS3Error(message, status, {\n    cause: err instanceof Error ? err : undefined,\n    ...(options?.code !== undefined ? { code: options.code } : {}),\n  });\n}\n","import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download(key, { headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        const fallback = errors.internalError();\n        res.statusCode = fallback.status;\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.end(\n          JSON.stringify({\n            message: fallback.message,\n            code: fallback.code,\n          }),\n        );\n      }\n    }\n  };\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { toNodeHandler } from \"./node\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/** Structural Fastify request/reply — avoids a hard dependency on `fastify`. */\ntype FastifyRequestLike = {\n  raw: IncomingMessage;\n};\n\ntype FastifyReplyLike = {\n  raw: ServerResponse;\n  hijack: () => void;\n};\n\n/**\n * Adapt a dimah-s3 instance to a Fastify route handler.\n *\n * Uses `reply.hijack()` and the Node adapter so Fastify does not touch the\n * response stream. Mount this route **before** body parsers (or disable JSON\n * parsing for `/api/s3/*`) so the request body stays readable.\n *\n * @example\n * ```ts\n * import Fastify from \"fastify\";\n * import { toFastifyHandler } from \"@dimah-s3/server/fastify\";\n * import { s3 } from \"./s3\";\n *\n * const app = Fastify();\n * app.all(\"/api/s3/*\", toFastifyHandler(s3));\n * ```\n */\nexport function toFastifyHandler(s3: DimahS3HandlerSource) {\n  const handler = toNodeHandler(s3);\n  return async (req: FastifyRequestLike, reply: FastifyReplyLike) => {\n    reply.hijack();\n    await handler(req.raw, reply.raw);\n  };\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts","../../src/adapters/fastify.ts"],"names":[],"mappings":"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","file":"fastify.js","sourcesContent":["import {\n  DimahS3Error,\n  S3_ERROR_CODES,\n  isAPIError,\n  isDimahS3Error,\n  isS3ErrorCode,\n} from \"@dimah-s3/core\";\n\nexport { DimahS3Error, isAPIError, isDimahS3Error, isS3ErrorCode };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () => DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.NOT_FOUND),\n\n  unauthorized: () =>\n    DimahS3Error.from(\"UNAUTHORIZED\", S3_ERROR_CODES.UNAUTHORIZED),\n\n  forbidden: () => DimahS3Error.from(\"FORBIDDEN\", S3_ERROR_CODES.FORBIDDEN),\n\n  conflict: () => DimahS3Error.from(\"CONFLICT\", S3_ERROR_CODES.CONFLICT),\n\n  internalError: () =>\n    DimahS3Error.from(\"INTERNAL_SERVER_ERROR\", S3_ERROR_CODES.INTERNAL_ERROR),\n\n  objectNotFound: () =>\n    DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.OBJECT_NOT_FOUND),\n\n  featureDisabled: (feature: string) =>\n    DimahS3Error.from(\"NOT_FOUND\", {\n      code: S3_ERROR_CODES.FEATURE_DISABLED.code,\n      message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(\n        \"{feature}\",\n        feature,\n      ),\n      params: { feature },\n    }),\n\n  invalidKey: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.INVALID_KEY),\n\n  invalidBucket: (bucket: string) =>\n    DimahS3Error.from(\"FORBIDDEN\", {\n      code: S3_ERROR_CODES.INVALID_BUCKET.code,\n      message: S3_ERROR_CODES.INVALID_BUCKET.message,\n      params: { bucket },\n    }),\n\n  s3NetworkError: (code: string) =>\n    DimahS3Error.from(\"BAD_GATEWAY\", {\n      code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,\n      message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(\n        \"{code}\",\n        code,\n      ),\n      params: { code },\n    }),\n\n  fileSizeRequiredUpload: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),\n\n  fileSizeRequiredMultipart: () =>\n    DimahS3Error.from(\n      \"BAD_REQUEST\",\n      S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART,\n    ),\n\n  validationError: (message: string) =>\n    DimahS3Error.from(\"BAD_REQUEST\", {\n      code: S3_ERROR_CODES.VALIDATION_ERROR.code,\n      message,\n    }),\n} as const;\n\nexport type ServerErrors = typeof errors;\n","import { toResponse } from \"better-call\";\nimport type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download({ query: { key }, headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        await writeWebResponse(res, toResponse(errors.internalError()));\n      }\n    }\n  };\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { toNodeHandler } from \"./node\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/** Structural Fastify request/reply — avoids a hard dependency on `fastify`. */\ntype FastifyRequestLike = {\n  raw: IncomingMessage;\n};\n\ntype FastifyReplyLike = {\n  raw: ServerResponse;\n  hijack: () => void;\n};\n\n/**\n * Adapt a dimah-s3 instance to a Fastify route handler.\n *\n * Uses `reply.hijack()` and the Node adapter so Fastify does not touch the\n * response stream. Mount this route **before** body parsers (or disable JSON\n * parsing for `/api/s3/*`) so the request body stays readable.\n *\n * @example\n * ```ts\n * import Fastify from \"fastify\";\n * import { toFastifyHandler } from \"@dimah-s3/server/fastify\";\n * import { s3 } from \"./s3\";\n *\n * const app = Fastify();\n * app.all(\"/api/s3/*\", toFastifyHandler(s3));\n * ```\n */\nexport function toFastifyHandler(s3: DimahS3HandlerSource) {\n  const handler = toNodeHandler(s3);\n  return async (req: FastifyRequestLike, reply: FastifyReplyLike) => {\n    reply.hijack();\n    await handler(req.raw, reply.raw);\n  };\n}\n"]}

package/dist/adapters/next.d.ts

@@ -7,12 +7,14 @@ import type { DimahS3HandlerSource } from "./types";
  * import { toNextJsHandler } from "@dimah-s3/server/next";
  * import { s3 } from "@/lib/s3";
  *
- * export const { GET, POST, DELETE } = toNextJsHandler(s3);
+ * export const { GET, POST, PUT, PATCH, DELETE } = toNextJsHandler(s3);
  * ```
  */
 export declare function toNextJsHandler(s3: DimahS3HandlerSource): {
     GET: (request: Request) => Promise<Response>;
     POST: (request: Request) => Promise<Response>;
+    PUT: (request: Request) => Promise<Response>;
+    PATCH: (request: Request) => Promise<Response>;
     DELETE: (request: Request) => Promise<Response>;
 };
 //# sourceMappingURL=next.d.ts.map

package/dist/adapters/next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB;IAEpD,GAAG;IACH,IAAI;IACJ,MAAM;EAET"}
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB;IAEpD,GAAG;IACH,IAAI;IACJ,GAAG;IACH,KAAK;IACL,MAAM;EAET"}

package/dist/adapters/next.js

@@ -3,6 +3,8 @@ function toNextJsHandler(s3) {
   return {
     GET: s3.handler,
     POST: s3.handler,
+    PUT: s3.handler,
+    PATCH: s3.handler,
     DELETE: s3.handler
   };
 }

package/dist/adapters/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/next.ts"],"names":[],"mappings":";AAaO,SAAS,gBAAgB,EAAA,EAA0B;AACxD,EAAA,OAAO;AAAA,IACL,KAAK,EAAA,CAAG,OAAA;AAAA,IACR,MAAM,EAAA,CAAG,OAAA;AAAA,IACT,QAAQ,EAAA,CAAG;AAAA,GACb;AACF","file":"next.js","sourcesContent":["import type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Adapt a dimah-s3 instance to Next.js App Router route handlers.\n *\n * @example\n * ```ts\n * import { toNextJsHandler } from \"@dimah-s3/server/next\";\n * import { s3 } from \"@/lib/s3\";\n *\n * export const { GET, POST, DELETE } = toNextJsHandler(s3);\n * ```\n */\nexport function toNextJsHandler(s3: DimahS3HandlerSource) {\n  return {\n    GET: s3.handler,\n    POST: s3.handler,\n    DELETE: s3.handler,\n  };\n}\n"]}
+{"version":3,"sources":["../../src/adapters/next.ts"],"names":[],"mappings":";AAaO,SAAS,gBAAgB,EAAA,EAA0B;AACxD,EAAA,OAAO;AAAA,IACL,KAAK,EAAA,CAAG,OAAA;AAAA,IACR,MAAM,EAAA,CAAG,OAAA;AAAA,IACT,KAAK,EAAA,CAAG,OAAA;AAAA,IACR,OAAO,EAAA,CAAG,OAAA;AAAA,IACV,QAAQ,EAAA,CAAG;AAAA,GACb;AACF","file":"next.js","sourcesContent":["import type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Adapt a dimah-s3 instance to Next.js App Router route handlers.\n *\n * @example\n * ```ts\n * import { toNextJsHandler } from \"@dimah-s3/server/next\";\n * import { s3 } from \"@/lib/s3\";\n *\n * export const { GET, POST, PUT, PATCH, DELETE } = toNextJsHandler(s3);\n * ```\n */\nexport function toNextJsHandler(s3: DimahS3HandlerSource) {\n  return {\n    GET: s3.handler,\n    POST: s3.handler,\n    PUT: s3.handler,\n    PATCH: s3.handler,\n    DELETE: s3.handler,\n  };\n}\n"]}

package/dist/adapters/node.d.ts

@@ -8,7 +8,7 @@ import type { DimahS3HandlerSource } from "./types";
  * ```ts
  * import { fromNodeHeaders } from "@dimah-s3/server/node";
  *
- * await s3.api.download(key, { headers: fromNodeHeaders(req.headers) });
+ * await s3.api.download({ query: { key }, headers: fromNodeHeaders(req.headers) });
  * ```
  */
 export declare function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers;

package/dist/adapters/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/adapters/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAWzE;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,oBAAoB,SACjC,eAAe,OAAO,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAqBxE"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/adapters/node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAWzE;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,oBAAoB,SACjC,eAAe,OAAO,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAaxE"}

package/dist/adapters/node.js

@@ -1,50 +1,45 @@
+import { toResponse } from 'better-call';
 import { DimahS3Error, S3_ERROR_CODES } from '@dimah-s3/core';
 
-// src/errors.ts
+// src/adapters/node.ts
 var errors = {
-  notFound: () => new DimahS3Error("Not Found", 404, { code: S3_ERROR_CODES.NOT_FOUND }),
-  invalidJson: () => new DimahS3Error("Invalid JSON payload", 400, {
-    code: S3_ERROR_CODES.INVALID_JSON
-  }),
-  forbidden: () => new DimahS3Error("Forbidden", 403, { code: S3_ERROR_CODES.FORBIDDEN }),
-  internalError: () => new DimahS3Error("Internal server error", 500, {
-    code: S3_ERROR_CODES.INTERNAL_ERROR
-  }),
-  objectNotFound: () => new DimahS3Error("Object not found", 404, {
-    code: S3_ERROR_CODES.OBJECT_NOT_FOUND
-  }),
-  s3NetworkError: (code) => new DimahS3Error(
-    `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,
-    502,
-    { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } }
-  ),
-  fieldRequired: (name) => new DimahS3Error(`${name} is required`, 400, {
-    code: S3_ERROR_CODES.FIELD_REQUIRED,
-    params: { name }
-  }),
-  /** Missing `key` on query-string routes (download / delete / list-parts). */
-  keyRequired: () => new DimahS3Error("key query parameter is required", 400, {
-    code: S3_ERROR_CODES.KEY_REQUIRED
-  }),
-  uploadIdRequired: () => new DimahS3Error("uploadId is required", 400, {
-    code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED
+  notFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.NOT_FOUND),
+  unauthorized: () => DimahS3Error.from("UNAUTHORIZED", S3_ERROR_CODES.UNAUTHORIZED),
+  forbidden: () => DimahS3Error.from("FORBIDDEN", S3_ERROR_CODES.FORBIDDEN),
+  conflict: () => DimahS3Error.from("CONFLICT", S3_ERROR_CODES.CONFLICT),
+  internalError: () => DimahS3Error.from("INTERNAL_SERVER_ERROR", S3_ERROR_CODES.INTERNAL_ERROR),
+  objectNotFound: () => DimahS3Error.from("NOT_FOUND", S3_ERROR_CODES.OBJECT_NOT_FOUND),
+  featureDisabled: (feature) => DimahS3Error.from("NOT_FOUND", {
+    code: S3_ERROR_CODES.FEATURE_DISABLED.code,
+    message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(
+      "{feature}",
+      feature
+    ),
+    params: { feature }
   }),
-  partNumberInvalid: () => new DimahS3Error("partNumber must be a positive integer", 400, {
-    code: S3_ERROR_CODES.PART_NUMBER_INVALID
+  invalidKey: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.INVALID_KEY),
+  invalidBucket: (bucket) => DimahS3Error.from("FORBIDDEN", {
+    code: S3_ERROR_CODES.INVALID_BUCKET.code,
+    message: S3_ERROR_CODES.INVALID_BUCKET.message,
+    params: { bucket }
   }),
-  partsRequired: () => new DimahS3Error("At least one valid part is required", 400, {
-    code: S3_ERROR_CODES.PARTS_REQUIRED
+  s3NetworkError: (code) => DimahS3Error.from("BAD_GATEWAY", {
+    code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,
+    message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(
+      "{code}",
+      code
+    ),
+    params: { code }
   }),
-  fileSizeRequiredUpload: () => new DimahS3Error(
-    "fileSize is required when upload.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD }
+  fileSizeRequiredUpload: () => DimahS3Error.from("BAD_REQUEST", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),
+  fileSizeRequiredMultipart: () => DimahS3Error.from(
+    "BAD_REQUEST",
+    S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART
   ),
-  fileSizeRequiredMultipart: () => new DimahS3Error(
-    "fileSize is required when multipart.requireFileSize is enabled",
-    400,
-    { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART }
-  )
+  validationError: (message) => DimahS3Error.from("BAD_REQUEST", {
+    code: S3_ERROR_CODES.VALIDATION_ERROR.code,
+    message
+  })
 };
 
 // src/adapters/node.ts
@@ -101,15 +96,7 @@ function toNodeHandler(s3) {
     } catch (err) {
       console.error("[S3 API]", err);
       if (!res.headersSent) {
-        const fallback = errors.internalError();
-        res.statusCode = fallback.status;
-        res.setHeader("Content-Type", "application/json");
-        res.end(
-          JSON.stringify({
-            message: fallback.message,
-            code: fallback.code
-          })
-        );
+        await writeWebResponse(res, toResponse(errors.internalError()));
       }
     }
   };

package/dist/adapters/node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts"],"names":[],"mappings":"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","file":"node.js","sourcesContent":["import { DimahS3Error, S3_ERROR_CODES, type S3ErrorCode } from \"@dimah-s3/core\";\n\nexport { DimahS3Error };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () =>\n    new DimahS3Error(\"Not Found\", 404, { code: S3_ERROR_CODES.NOT_FOUND }),\n\n  invalidJson: () =>\n    new DimahS3Error(\"Invalid JSON payload\", 400, {\n      code: S3_ERROR_CODES.INVALID_JSON,\n    }),\n\n  forbidden: () =>\n    new DimahS3Error(\"Forbidden\", 403, { code: S3_ERROR_CODES.FORBIDDEN }),\n\n  internalError: () =>\n    new DimahS3Error(\"Internal server error\", 500, {\n      code: S3_ERROR_CODES.INTERNAL_ERROR,\n    }),\n\n  objectNotFound: () =>\n    new DimahS3Error(\"Object not found\", 404, {\n      code: S3_ERROR_CODES.OBJECT_NOT_FOUND,\n    }),\n\n  s3NetworkError: (code: string) =>\n    new DimahS3Error(\n      `S3 endpoint unreachable (${code}): check your endpoint URL and network connectivity`,\n      502,\n      { code: S3_ERROR_CODES.S3_NETWORK_ERROR, params: { code } },\n    ),\n\n  fieldRequired: (name: string) =>\n    new DimahS3Error(`${name} is required`, 400, {\n      code: S3_ERROR_CODES.FIELD_REQUIRED,\n      params: { name },\n    }),\n\n  /** Missing `key` on query-string routes (download / delete / list-parts). */\n  keyRequired: () =>\n    new DimahS3Error(\"key query parameter is required\", 400, {\n      code: S3_ERROR_CODES.KEY_REQUIRED,\n    }),\n\n  uploadIdRequired: () =>\n    new DimahS3Error(\"uploadId is required\", 400, {\n      code: S3_ERROR_CODES.UPLOAD_ID_REQUIRED,\n    }),\n\n  partNumberInvalid: () =>\n    new DimahS3Error(\"partNumber must be a positive integer\", 400, {\n      code: S3_ERROR_CODES.PART_NUMBER_INVALID,\n    }),\n\n  partsRequired: () =>\n    new DimahS3Error(\"At least one valid part is required\", 400, {\n      code: S3_ERROR_CODES.PARTS_REQUIRED,\n    }),\n\n  fileSizeRequiredUpload: () =>\n    new DimahS3Error(\n      \"fileSize is required when upload.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD },\n    ),\n\n  fileSizeRequiredMultipart: () =>\n    new DimahS3Error(\n      \"fileSize is required when multipart.requireFileSize is enabled\",\n      400,\n      { code: S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART },\n    ),\n} as const;\n\nexport type ServerErrors = typeof errors;\n\n/** Trim and require a non-empty string; throws {@link errors.fieldRequired}. */\nexport function requireString(value: unknown, name: string): string {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) throw errors.fieldRequired(name);\n  return trimmed;\n}\n\nfunction statusOf(err: unknown, fallback: number): number {\n  return typeof (err as { status?: unknown })?.status === \"number\"\n    ? (err as { status: number }).status\n    : fallback;\n}\n\n/**\n * Convert hook/S3 throws into {@link DimahS3Error}.\n *\n * - Existing {@link DimahS3Error} instances are preserved (including subclasses).\n * - Plain `Error`s keep their message; `code` is only applied when provided\n *   (omit it so clients show the custom English message instead of a mapped\n *   library string).\n */\nexport function toDimahS3Error(\n  err: unknown,\n  fallbackMessage: string,\n  fallbackStatus = 403,\n  options?: { code?: S3ErrorCode | string },\n): DimahS3Error {\n  if (err instanceof DimahS3Error) return err;\n\n  const message =\n    err instanceof Error && err.message.trim() ? err.message : fallbackMessage;\n  const status = statusOf(err, fallbackStatus);\n\n  return new DimahS3Error(message, status, {\n    cause: err instanceof Error ? err : undefined,\n    ...(options?.code !== undefined ? { code: options.code } : {}),\n  });\n}\n","import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download(key, { headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        const fallback = errors.internalError();\n        res.statusCode = fallback.status;\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.end(\n          JSON.stringify({\n            message: fallback.message,\n            code: fallback.code,\n          }),\n        );\n      }\n    }\n  };\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/adapters/node.ts"],"names":[],"mappings":"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","file":"node.js","sourcesContent":["import {\n  DimahS3Error,\n  S3_ERROR_CODES,\n  isAPIError,\n  isDimahS3Error,\n  isS3ErrorCode,\n} from \"@dimah-s3/core\";\n\nexport { DimahS3Error, isAPIError, isDimahS3Error, isS3ErrorCode };\n\n/** English API errors with stable codes for client-side localization. */\nexport const errors = {\n  notFound: () => DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.NOT_FOUND),\n\n  unauthorized: () =>\n    DimahS3Error.from(\"UNAUTHORIZED\", S3_ERROR_CODES.UNAUTHORIZED),\n\n  forbidden: () => DimahS3Error.from(\"FORBIDDEN\", S3_ERROR_CODES.FORBIDDEN),\n\n  conflict: () => DimahS3Error.from(\"CONFLICT\", S3_ERROR_CODES.CONFLICT),\n\n  internalError: () =>\n    DimahS3Error.from(\"INTERNAL_SERVER_ERROR\", S3_ERROR_CODES.INTERNAL_ERROR),\n\n  objectNotFound: () =>\n    DimahS3Error.from(\"NOT_FOUND\", S3_ERROR_CODES.OBJECT_NOT_FOUND),\n\n  featureDisabled: (feature: string) =>\n    DimahS3Error.from(\"NOT_FOUND\", {\n      code: S3_ERROR_CODES.FEATURE_DISABLED.code,\n      message: S3_ERROR_CODES.FEATURE_DISABLED.message.replaceAll(\n        \"{feature}\",\n        feature,\n      ),\n      params: { feature },\n    }),\n\n  invalidKey: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.INVALID_KEY),\n\n  invalidBucket: (bucket: string) =>\n    DimahS3Error.from(\"FORBIDDEN\", {\n      code: S3_ERROR_CODES.INVALID_BUCKET.code,\n      message: S3_ERROR_CODES.INVALID_BUCKET.message,\n      params: { bucket },\n    }),\n\n  s3NetworkError: (code: string) =>\n    DimahS3Error.from(\"BAD_GATEWAY\", {\n      code: S3_ERROR_CODES.S3_NETWORK_ERROR.code,\n      message: S3_ERROR_CODES.S3_NETWORK_ERROR.message.replaceAll(\n        \"{code}\",\n        code,\n      ),\n      params: { code },\n    }),\n\n  fileSizeRequiredUpload: () =>\n    DimahS3Error.from(\"BAD_REQUEST\", S3_ERROR_CODES.FILE_SIZE_REQUIRED_UPLOAD),\n\n  fileSizeRequiredMultipart: () =>\n    DimahS3Error.from(\n      \"BAD_REQUEST\",\n      S3_ERROR_CODES.FILE_SIZE_REQUIRED_MULTIPART,\n    ),\n\n  validationError: (message: string) =>\n    DimahS3Error.from(\"BAD_REQUEST\", {\n      code: S3_ERROR_CODES.VALIDATION_ERROR.code,\n      message,\n    }),\n} as const;\n\nexport type ServerErrors = typeof errors;\n","import { toResponse } from \"better-call\";\nimport type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from \"node:http\";\nimport { errors } from \"../errors\";\nimport type { DimahS3HandlerSource } from \"./types\";\n\n/**\n * Convert Node.js / Express request headers into a Web {@link Headers} object.\n * Useful when calling `s3.api.*` from a Node handler.\n *\n * @example\n * ```ts\n * import { fromNodeHeaders } from \"@dimah-s3/server/node\";\n *\n * await s3.api.download({ query: { key }, headers: fromNodeHeaders(req.headers) });\n * ```\n */\nexport function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  return headers;\n}\n\nfunction collectBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction toWebRequest(req: IncomingMessage, body: Buffer): Request {\n  const host = req.headers.host ?? \"localhost\";\n  const protocol =\n    (req.socket as { encrypted?: boolean }).encrypted === true\n      ? \"https\"\n      : \"http\";\n  const url = new URL(req.url ?? \"/\", `${protocol}://${host}`);\n\n  const headers = fromNodeHeaders(req.headers);\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const init: RequestInit = { method, headers };\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    init.body = new Uint8Array(body);\n    // @ts-expect-error Node fetch duplex for streaming bodies\n    init.duplex = \"half\";\n  }\n\n  return new Request(url, init);\n}\n\nasync function writeWebResponse(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/**\n * Adapt a dimah-s3 instance to Node.js `http` / Express-style handlers.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { toNodeHandler } from \"@dimah-s3/server/node\";\n * import { s3 } from \"./s3\";\n *\n * createServer(toNodeHandler(s3)).listen(3000);\n * ```\n */\nexport function toNodeHandler(s3: DimahS3HandlerSource) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    try {\n      const body = await collectBody(req);\n      const request = toWebRequest(req, body);\n      const response = await s3.handler(request);\n      await writeWebResponse(res, response);\n    } catch (err) {\n      console.error(\"[S3 API]\", err);\n      if (!res.headersSent) {\n        await writeWebResponse(res, toResponse(errors.internalError()));\n      }\n    }\n  };\n}\n"]}

package/dist/adapters/types.d.ts

@@ -1,4 +1,4 @@
 import type { DimahS3 } from "../dimah-s3";
 /** Minimal surface adapters need from a dimah-s3 instance. */
-export type DimahS3HandlerSource = Pick<DimahS3<Record<string, unknown>>, "handler">;
+export type DimahS3HandlerSource = Pick<DimahS3, "handler">;
 //# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAChC,SAAS,CACV,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC"}

package/dist/api/assert-feature-enabled.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedDimahS3Config } from "../types";
+export type FeatureFlag = "upload" | "download" | "delete" | "multipart";
+/** Disabled features respond 404 (`FEATURE_DISABLED`) from both HTTP and `s3.api`. */
+export declare function assertFeatureEnabled(config: ResolvedDimahS3Config, feature: FeatureFlag): void;
+//# sourceMappingURL=assert-feature-enabled.d.ts.map

package/dist/api/assert-feature-enabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-feature-enabled.d.ts","sourceRoot":"","sources":["../../src/api/assert-feature-enabled.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzE,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,WAAW,GACnB,IAAI,CAIN"}

package/dist/api/bind-endpoints.d.ts

@@ -0,0 +1,8 @@
+import { type Endpoint } from "better-call";
+import type { S3EndpointContext } from "./context";
+/**
+ * Wrap better-call endpoints so `s3.api.upload({ body, headers })` injects
+ * `routerContext` the same way HTTP `createRouter` does.
+ */
+export declare function bindEndpoints<E extends Record<string, Endpoint>>(endpoints: E, context: Pick<S3EndpointContext, "config">): E;
+//# sourceMappingURL=bind-endpoints.d.ts.map

package/dist/api/bind-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-endpoints.d.ts","sourceRoot":"","sources":["../../src/api/bind-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9D,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GACzC,CAAC,CA2BH"}