@better-s3/server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hamidreza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapters/next.d.ts

@@ -0,0 +1,13 @@
+import type { S3RouteHandlerConfig } from "../types";
+/**
+ * Creates a Next.js App Router catch-all route handler.
+ *
+ * Usage in `app/api/s3/[...s3]/route.ts`:
+ * ```ts
+ * import { createRouteHandler } from "@better-s3/server/next";
+ *
+ * const handler = createRouteHandler({ s3, defaultBucket: "my-bucket", basePath: "/api/s3" });
+ * export { handler as GET, handler as POST, handler as DELETE };
+ * ```
+ */
+export declare function createRouteHandler(config: S3RouteHandlerConfig): (request: Request) => Promise<Response>;

package/dist/adapters/next.js

@@ -0,0 +1,3 @@
+import {PutObjectCommand,GetObjectCommand,HeadObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';async function u(r){try{let n=await r.json();return n&&typeof n=="object"?n:null}catch{return null}}function p(r,n){let e=typeof r=="string"?r.trim():"";return e||Response.json({message:`${n} is required`},{status:400})}function m(r){let n=Number(r);return Number.isFinite(n)&&n>0?Math.floor(n):600}function i(r){return async n=>{try{return await r(n)}catch(e){let t=e instanceof Error?e.message:"Internal server error";return console.error("[S3 API]",t),Response.json({message:t},{status:500})}}}function f(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=e.bucket?.trim()||r.defaultBucket,a=m(e.expiresIn),s=await getSignedUrl(r.s3,new PutObjectCommand({Bucket:o,Key:t,ContentType:e.contentType,Metadata:e.metadata}),{expiresIn:a});return Response.json({bucket:o,key:t,url:s,expiresIn:a})})}function g(r){return i(async n=>{let{searchParams:e}=new URL(n.url),t=e.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=e.get("bucket")?.trim()||r.defaultBucket,a=m(e.get("expiresIn")),s=e.get("fileName")?.trim(),d=await getSignedUrl(r.s3,new GetObjectCommand({Bucket:o,Key:t,ResponseContentDisposition:`attachment${s?`; filename="${s}"`:""}`}),{expiresIn:a});return Response.json({bucket:o,key:t,url:d,expiresIn:a})})}function b(r){return i(async n=>{let{searchParams:e}=new URL(n.url),t=e.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=e.get("bucket")?.trim()||r.defaultBucket;try{await r.s3.send(new HeadObjectCommand({Bucket:o,Key:t}));}catch{return Response.json({message:`Object "${t}" not found`},{status:404})}return await r.s3.send(new DeleteObjectCommand({Bucket:o,Key:t})),Response.json({success:!0,bucket:o,key:t})})}function k(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=e.bucket?.trim()||r.defaultBucket,{UploadId:a}=await r.s3.send(new CreateMultipartUploadCommand({Bucket:o,Key:t,ContentType:e.contentType,Metadata:e.metadata}));return Response.json({bucket:o,key:t,uploadId:a},{status:201})})}function R(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=Number(e.partNumber);if(!Number.isInteger(a)||a<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let s=e.bucket?.trim()||r.defaultBucket,d=m(e.expiresIn),c=await getSignedUrl(r.s3,new UploadPartCommand({Bucket:s,Key:t,UploadId:o,PartNumber:a}),{expiresIn:d});return Response.json({presignedUrl:c,partNumber:a,uploadId:o,bucket:s,expiresIn:d})})}function S(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=(Array.isArray(e.parts)?e.parts:[]).map(({partNumber:l,eTag:y})=>({PartNumber:Number(l),ETag:String(y)})).filter(l=>Number.isInteger(l.PartNumber)&&l.ETag).sort((l,y)=>l.PartNumber-y.PartNumber);if(!a.length)return Response.json({message:"At least one valid part is required"},{status:400});let s=e.bucket?.trim()||r.defaultBucket,{Location:d,ETag:c}=await r.s3.send(new CompleteMultipartUploadCommand({Bucket:s,Key:t,UploadId:o,MultipartUpload:{Parts:a}}));return Response.json({bucket:s,key:t,uploadId:o,location:d,eTag:c})})}function H(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=e.bucket?.trim()||r.defaultBucket;return await r.s3.send(new AbortMultipartUploadCommand({Bucket:a,Key:t,UploadId:o})),Response.json({bucket:a,key:t,uploadId:o,aborted:!0})})}function w(r){return {presign:{upload:f(r),download:g(r)},multipart:{init:k(r),part:R(r),complete:S(r),abort:H(r)},delete:b(r)}}function I(r){let n=w(r),e=r.basePath.replace(/\/$/,"");return async t=>{let a=new URL(t.url).pathname.slice(e.length).replace(/^\//,""),s=t.method;return s==="POST"&&a==="presign/upload"?n.presign.upload(t):s==="GET"&&a==="presign/download"?n.presign.download(t):s==="DELETE"&&a==="delete"?n.delete(t):s==="POST"&&a==="presign/multipart/init"?n.multipart.init(t):s==="POST"&&a==="presign/multipart/part"?n.multipart.part(t):s==="POST"&&a==="presign/multipart/complete"?n.multipart.complete(t):s==="POST"&&a==="presign/multipart/abort"?n.multipart.abort(t):Response.json({message:"Not Found"},{status:404})}}function be(r){return I(r)}
+export{be as createRouteHandler};//# sourceMappingURL=next.js.map
+//# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers.ts","../../src/handlers/presign/upload.ts","../../src/handlers/presign/download.ts","../../src/handlers/delete.ts","../../src/handlers/multipart/init.ts","../../src/handlers/multipart/part.ts","../../src/handlers/multipart/complete.ts","../../src/handlers/multipart/abort.ts","../../src/create-handlers.ts","../../src/router.ts","../../src/adapters/next.ts"],"names":["parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","createUploadHandler","config","key","bucket","expiresIn","url","getSignedUrl","PutObjectCommand","createDownloadHandler","searchParams","fileName","GetObjectCommand","createDeleteHandler","HeadObjectCommand","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","Location","ETag","CompleteMultipartUploadCommand","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","createRouter","handlers","base","subpath","method","createRouteHandler"],"mappings":"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","file":"next.js","sourcesContent":["export async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n","import { PutObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const url = await getSignedUrl(\n      config.s3,\n      new PutObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        Metadata: body.metadata,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ResponseContentDisposition: `attachment${fileName ? `; filename=\"${fileName}\"` : \"\"}`,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  metadata?: Record<string, string>;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        Metadata: body.metadata,\n      }),\n    );\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const { Location, ETag } = await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    return Response.json({\n      bucket,\n      key,\n      uploadId,\n      location: Location,\n      eTag: ETag,\n    });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n\n  return async (request: Request): Promise<Response> => {\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return handlers.presign.upload(request);\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return handlers.presign.download(request);\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return handlers.delete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return handlers.multipart.init(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return handlers.multipart.part(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return handlers.multipart.complete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return handlers.multipart.abort(request);\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n","import { createRouter } from \"../router\";\nimport type { S3RouteHandlerConfig } from \"../types\";\n\n/**\n * Creates a Next.js App Router catch-all route handler.\n *\n * Usage in `app/api/s3/[...s3]/route.ts`:\n * ```ts\n * import { createRouteHandler } from \"@better-s3/server/next\";\n *\n * const handler = createRouteHandler({ s3, defaultBucket: \"my-bucket\", basePath: \"/api/s3\" });\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function createRouteHandler(config: S3RouteHandlerConfig) {\n  return createRouter(config);\n}\n"]}

package/dist/create-handlers.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig, S3Handlers } from "./types";
+export declare function createHandlers(config: S3HandlerConfig): S3Handlers;

package/dist/handlers/delete.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../types";
+export declare function createDeleteHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/multipart/abort.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createMultipartAbortHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/multipart/complete.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createMultipartCompleteHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/multipart/init.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createMultipartInitHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/multipart/part.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createMultipartPartHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/presign/download.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createDownloadHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/handlers/presign/upload.d.ts

@@ -0,0 +1,2 @@
+import type { S3HandlerConfig } from "../../types";
+export declare function createUploadHandler(config: S3HandlerConfig): (request: Request) => Promise<Response>;

package/dist/helpers.d.ts

@@ -0,0 +1,4 @@
+export declare function parseBody<T extends Record<string, unknown>>(request: Request): Promise<T | null>;
+export declare function requireString(value: unknown, name: string): string | Response;
+export declare function normalizeExpiresIn(value: unknown): number;
+export declare function withS3ErrorHandler(handler: (request: Request) => Promise<Response>): (request: Request) => Promise<Response>;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createHandlers } from "./create-handlers";
+export { createRouter } from "./router";
+export { createUploadHandler } from "./handlers/presign/upload";
+export { createDownloadHandler } from "./handlers/presign/download";
+export { createDeleteHandler } from "./handlers/delete";
+export { createMultipartInitHandler } from "./handlers/multipart/init";
+export { createMultipartPartHandler } from "./handlers/multipart/part";
+export { createMultipartCompleteHandler } from "./handlers/multipart/complete";
+export { createMultipartAbortHandler } from "./handlers/multipart/abort";
+export type { S3HandlerConfig, S3RouteHandlerConfig, S3Handler, S3Handlers, } from "./types";
+export { parseBody, requireString, normalizeExpiresIn, withS3ErrorHandler, } from "./helpers";

package/dist/index.js

@@ -0,0 +1,3 @@
+import {PutObjectCommand,GetObjectCommand,HeadObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';async function u(r){try{let n=await r.json();return n&&typeof n=="object"?n:null}catch{return null}}function p(r,n){let e=typeof r=="string"?r.trim():"";return e||Response.json({message:`${n} is required`},{status:400})}function d(r){let n=Number(r);return Number.isFinite(n)&&n>0?Math.floor(n):600}function i(r){return async n=>{try{return await r(n)}catch(e){let t=e instanceof Error?e.message:"Internal server error";return console.error("[S3 API]",t),Response.json({message:t},{status:500})}}}function f(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=e.bucket?.trim()||r.defaultBucket,a=d(e.expiresIn),s=await getSignedUrl(r.s3,new PutObjectCommand({Bucket:o,Key:t,ContentType:e.contentType,Metadata:e.metadata}),{expiresIn:a});return Response.json({bucket:o,key:t,url:s,expiresIn:a})})}function g(r){return i(async n=>{let{searchParams:e}=new URL(n.url),t=e.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=e.get("bucket")?.trim()||r.defaultBucket,a=d(e.get("expiresIn")),s=e.get("fileName")?.trim(),l=await getSignedUrl(r.s3,new GetObjectCommand({Bucket:o,Key:t,ResponseContentDisposition:`attachment${s?`; filename="${s}"`:""}`}),{expiresIn:a});return Response.json({bucket:o,key:t,url:l,expiresIn:a})})}function b(r){return i(async n=>{let{searchParams:e}=new URL(n.url),t=e.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=e.get("bucket")?.trim()||r.defaultBucket;try{await r.s3.send(new HeadObjectCommand({Bucket:o,Key:t}));}catch{return Response.json({message:`Object "${t}" not found`},{status:404})}return await r.s3.send(new DeleteObjectCommand({Bucket:o,Key:t})),Response.json({success:!0,bucket:o,key:t})})}function k(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=e.bucket?.trim()||r.defaultBucket,{UploadId:a}=await r.s3.send(new CreateMultipartUploadCommand({Bucket:o,Key:t,ContentType:e.contentType,Metadata:e.metadata}));return Response.json({bucket:o,key:t,uploadId:a},{status:201})})}function H(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=Number(e.partNumber);if(!Number.isInteger(a)||a<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let s=e.bucket?.trim()||r.defaultBucket,l=d(e.expiresIn),c=await getSignedUrl(r.s3,new UploadPartCommand({Bucket:s,Key:t,UploadId:o,PartNumber:a}),{expiresIn:l});return Response.json({presignedUrl:c,partNumber:a,uploadId:o,bucket:s,expiresIn:l})})}function S(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=(Array.isArray(e.parts)?e.parts:[]).map(({partNumber:m,eTag:y})=>({PartNumber:Number(m),ETag:String(y)})).filter(m=>Number.isInteger(m.PartNumber)&&m.ETag).sort((m,y)=>m.PartNumber-y.PartNumber);if(!a.length)return Response.json({message:"At least one valid part is required"},{status:400});let s=e.bucket?.trim()||r.defaultBucket,{Location:l,ETag:c}=await r.s3.send(new CompleteMultipartUploadCommand({Bucket:s,Key:t,UploadId:o,MultipartUpload:{Parts:a}}));return Response.json({bucket:s,key:t,uploadId:o,location:l,eTag:c})})}function R(r){return i(async n=>{let e=await u(n);if(!e)return Response.json({message:"Invalid JSON payload"},{status:400});let t=p(e.key,"key");if(t instanceof Response)return t;let o=p(e.uploadId,"uploadId");if(o instanceof Response)return o;let a=e.bucket?.trim()||r.defaultBucket;return await r.s3.send(new AbortMultipartUploadCommand({Bucket:a,Key:t,UploadId:o})),Response.json({bucket:a,key:t,uploadId:o,aborted:!0})})}function w(r){return {presign:{upload:f(r),download:g(r)},multipart:{init:k(r),part:H(r),complete:S(r),abort:R(r)},delete:b(r)}}function U(r){let n=w(r),e=r.basePath.replace(/\/$/,"");return async t=>{let a=new URL(t.url).pathname.slice(e.length).replace(/^\//,""),s=t.method;return s==="POST"&&a==="presign/upload"?n.presign.upload(t):s==="GET"&&a==="presign/download"?n.presign.download(t):s==="DELETE"&&a==="delete"?n.delete(t):s==="POST"&&a==="presign/multipart/init"?n.multipart.init(t):s==="POST"&&a==="presign/multipart/part"?n.multipart.part(t):s==="POST"&&a==="presign/multipart/complete"?n.multipart.complete(t):s==="POST"&&a==="presign/multipart/abort"?n.multipart.abort(t):Response.json({message:"Not Found"},{status:404})}}
+export{b as createDeleteHandler,g as createDownloadHandler,w as createHandlers,R as createMultipartAbortHandler,S as createMultipartCompleteHandler,k as createMultipartInitHandler,H as createMultipartPartHandler,U as createRouter,f as createUploadHandler,d as normalizeExpiresIn,u as parseBody,p as requireString,i as withS3ErrorHandler};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers.ts","../src/handlers/presign/upload.ts","../src/handlers/presign/download.ts","../src/handlers/delete.ts","../src/handlers/multipart/init.ts","../src/handlers/multipart/part.ts","../src/handlers/multipart/complete.ts","../src/handlers/multipart/abort.ts","../src/create-handlers.ts","../src/router.ts"],"names":["parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","createUploadHandler","config","key","bucket","expiresIn","url","getSignedUrl","PutObjectCommand","createDownloadHandler","searchParams","fileName","GetObjectCommand","createDeleteHandler","HeadObjectCommand","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","Location","ETag","CompleteMultipartUploadCommand","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","createRouter","handlers","base","subpath","method"],"mappings":"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","file":"index.js","sourcesContent":["export async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n","import { PutObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const url = await getSignedUrl(\n      config.s3,\n      new PutObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        Metadata: body.metadata,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ResponseContentDisposition: `attachment${fileName ? `; filename=\"${fileName}\"` : \"\"}`,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  metadata?: Record<string, string>;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        Metadata: body.metadata,\n      }),\n    );\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const { Location, ETag } = await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    return Response.json({\n      bucket,\n      key,\n      uploadId,\n      location: Location,\n      eTag: ETag,\n    });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { parseBody, requireString, withS3ErrorHandler } from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n\n  return async (request: Request): Promise<Response> => {\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return handlers.presign.upload(request);\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return handlers.presign.download(request);\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return handlers.delete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return handlers.multipart.init(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return handlers.multipart.part(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return handlers.multipart.complete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return handlers.multipart.abort(request);\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n"]}

package/dist/router.d.ts

@@ -0,0 +1,2 @@
+import type { S3RouteHandlerConfig } from "./types";
+export declare function createRouter(config: S3RouteHandlerConfig): (request: Request) => Promise<Response>;

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import type { S3Client } from "@better-s3/core";
+export type S3HandlerConfig = {
+    s3: S3Client;
+    defaultBucket: string;
+};
+export type S3RouteHandlerConfig = S3HandlerConfig & {
+    basePath: string;
+};
+export type S3Handler = (request: Request) => Promise<Response>;
+export type S3Handlers = {
+    presign: {
+        upload: S3Handler;
+        download: S3Handler;
+    };
+    multipart: {
+        init: S3Handler;
+        part: S3Handler;
+        complete: S3Handler;
+        abort: S3Handler;
+    };
+    delete: S3Handler;
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@better-s3/server",
+  "version": "1.0.0",
+  "description": "Framework-agnostic S3 server handlers — presigned uploads, downloads, deletes, and multipart operations",
+  "keywords": [
+    "s3",
+    "server",
+    "presigned-url",
+    "upload",
+    "download",
+    "multipart",
+    "framework-agnostic"
+  ],
+  "author": "Hamidrezakz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hamidrezakz/better-s3.git",
+    "directory": "packages/better-s3-server"
+  },
+  "homepage": "https://github.com/hamidrezakz/better-s3/tree/master/packages/better-s3-server",
+  "bugs": {
+    "url": "https://github.com/hamidrezakz/better-s3/issues"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/adapters/next.d.ts",
+      "default": "./dist/adapters/next.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aws-sdk/s3-request-presigner": ">=3",
+    "@better-s3/core": "1.0.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": ">=3"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1029.0",
+    "@aws-sdk/s3-request-presigner": "^3.1029.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && tsc --emitDeclarationOnly",
+    "check-types": "tsc --noEmit"
+  }
+}