@dimah-s3/server 1.0.2 → 1.1.0

package/dist/api/routes/index.d.ts

@@ -5,23 +5,19 @@ export declare const coreEndpoints: {
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
-            key: string;
-            contentType?: string | undefined;
-            fileSize?: number | undefined;
+            route: string;
+            fileName: string;
+            fileSize: number;
+            contentType?: unknown;
             metadata?: Record<string, string> | undefined;
-            bucket?: string | undefined;
-            expiresIn?: number | undefined;
-            acl?: "private" | "public-read" | undefined;
-            fileName?: string | undefined;
+            checksum?: unknown;
         }, {
-            key: string;
-            contentType?: string | undefined;
-            fileSize?: number | undefined;
+            route: string;
+            fileName: string;
+            fileSize: number;
+            contentType?: unknown;
             metadata?: Record<string, string> | undefined;
-            bucket?: string | undefined;
-            expiresIn?: number | undefined;
-            acl?: "private" | "public-read" | undefined;
-            fileName?: string | undefined;
+            checksum?: unknown;
         }>;
     }, import("@dimah-s3/core").UploadPresignResponse>;
     confirm: import("better-call").StrictEndpoint<"/presign/upload/confirm", {
@@ -29,30 +25,52 @@ export declare const coreEndpoints: {
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
-            bucket?: string | undefined;
         }, {
+            route: string;
             key: string;
-            bucket?: string | undefined;
         }>;
-    }, import("@dimah-s3/core").UploadConfirmResponse>;
+    }, import("@dimah-s3/core").ConfirmedObjectResponse>;
     download: import("better-call").StrictEndpoint<"/presign/download", {
         use: import("better-call").MiddlewareHandler[];
     } & {
         method: "GET";
     } & {
         query: import("better-call").StandardSchemaV1<{
+            route: string;
+            key: string;
+            fileName?: unknown;
+            disposition?: "attachment" | "inline" | undefined;
+        }, {
+            route: string;
+            key: string;
+            fileName?: unknown;
+            disposition?: "attachment" | "inline" | undefined;
+        }>;
+    }, import("@dimah-s3/core").DownloadPresignResponse>;
+    catalog: import("better-call").StrictEndpoint<"/routes", {
+        use: import("better-call").MiddlewareHandler[];
+    } & {
+        method: "GET";
+    }, import("@dimah-s3/core").RouteCatalogResponse>;
+    file: import("better-call").StrictEndpoint<"/file", {
+        use: import("better-call").MiddlewareHandler[];
+    } & {
+        method: "GET";
+    } & {
+        query: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
-            bucket?: string | undefined;
-            fileName?: string | undefined;
-            expiresIn?: unknown;
+            fileName?: unknown;
+            disposition?: "attachment" | "inline" | undefined;
         }, {
+            route: string;
             key: string;
-            bucket?: string | undefined;
-            fileName?: string | undefined;
-            expiresIn?: unknown;
+            fileName?: unknown;
+            disposition?: "attachment" | "inline" | undefined;
         }>;
-    }, import("@dimah-s3/core").PresignResponse>;
+    }, Response>;
     delete: import("better-call").StrictEndpoint<"/delete", {
         use: import("better-call").MiddlewareHandler[];
     } & {
@@ -60,33 +78,43 @@ export declare const coreEndpoints: {
         body: import("better-call").StandardSchemaV1<unknown, unknown>;
     } & {
         query: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
-            bucket?: string | undefined;
         }, {
+            route: string;
             key: string;
-            bucket?: string | undefined;
         }>;
     }, import("@dimah-s3/core").DeleteResponse>;
+    deleteBatch: import("better-call").StrictEndpoint<"/delete/batch", {
+        use: import("better-call").MiddlewareHandler[];
+    } & {
+        method: "POST";
+        body: import("better-call").StandardSchemaV1<{
+            route: string;
+            keys: string[];
+        }, {
+            route: string;
+            keys: string[];
+        }>;
+    }, import("@dimah-s3/core").DeleteBatchResponse>;
     multipartInit: import("better-call").StrictEndpoint<"/presign/multipart/init", {
         use: import("better-call").MiddlewareHandler[];
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
-            key: string;
-            contentType?: string | undefined;
-            fileSize?: number | undefined;
+            route: string;
+            fileName: string;
+            fileSize: number;
+            contentType?: unknown;
             metadata?: Record<string, string> | undefined;
-            bucket?: string | undefined;
-            acl?: "private" | "public-read" | undefined;
-            fileName?: string | undefined;
+            checksum?: unknown;
         }, {
-            key: string;
-            contentType?: string | undefined;
-            fileSize?: number | undefined;
+            route: string;
+            fileName: string;
+            fileSize: number;
+            contentType?: unknown;
             metadata?: Record<string, string> | undefined;
-            bucket?: string | undefined;
-            acl?: "private" | "public-read" | undefined;
-            fileName?: string | undefined;
+            checksum?: unknown;
         }>;
     }, import("@dimah-s3/core").MultipartInitResponse>;
     multipartPart: import("better-call").StrictEndpoint<"/presign/multipart/part", {
@@ -94,19 +122,17 @@ export declare const coreEndpoints: {
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
             uploadId: string;
             partNumber: number;
-            partSize?: number | undefined;
-            bucket?: string | undefined;
-            expiresIn?: number | undefined;
+            partSize: number;
         }, {
+            route: string;
             key: string;
             uploadId: string;
             partNumber: number;
-            partSize?: number | undefined;
-            bucket?: string | undefined;
-            expiresIn?: number | undefined;
+            partSize: number;
         }>;
     }, import("@dimah-s3/core").MultipartPartResponse>;
     multipartListParts: import("better-call").StrictEndpoint<"/presign/multipart/parts", {
@@ -115,13 +141,13 @@ export declare const coreEndpoints: {
         method: "GET";
     } & {
         query: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
             uploadId: string;
-            bucket?: string | undefined;
         }, {
+            route: string;
             key: string;
             uploadId: string;
-            bucket?: string | undefined;
         }>;
     }, import("@dimah-s3/core").MultipartListPartsResponse>;
     multipartComplete: import("better-call").StrictEndpoint<"/presign/multipart/complete", {
@@ -129,19 +155,19 @@ export declare const coreEndpoints: {
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
             uploadId: string;
             parts: {
                 partNumber: number;
             }[];
-            bucket?: string | undefined;
         }, {
+            route: string;
             key: string;
             uploadId: string;
             parts: {
                 partNumber: number;
             }[];
-            bucket?: string | undefined;
         }>;
     }, import("@dimah-s3/core").MultipartCompleteResponse>;
     multipartAbort: import("better-call").StrictEndpoint<"/presign/multipart/abort", {
@@ -149,13 +175,13 @@ export declare const coreEndpoints: {
     } & {
         method: "POST";
         body: import("better-call").StandardSchemaV1<{
+            route: string;
             key: string;
             uploadId: string;
-            bucket?: string | undefined;
         }, {
+            route: string;
             key: string;
             uploadId: string;
-            bucket?: string | undefined;
         }>;
     }, import("@dimah-s3/core").MultipartAbortResponse>;
 };

package/dist/api/routes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAUA,2DAA2D;AAC3D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD,eAAO,MAAM,mBAAmB,EAE3B,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAaA,2DAA2D;AAC3D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAazB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD,eAAO,MAAM,mBAAmB,EAE3B,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC"}

package/dist/api/routes/multipart/abort.d.ts

@@ -4,13 +4,13 @@ export declare const multipartAbort: import("better-call").StrictEndpoint<"/pres
 } & {
     method: "POST";
     body: import("better-call").StandardSchemaV1<{
+        route: string;
         key: string;
         uploadId: string;
-        bucket?: string | undefined;
     }, {
+        route: string;
         key: string;
         uploadId: string;
-        bucket?: string | undefined;
     }>;
 }, MultipartAbortResponse>;
 //# sourceMappingURL=abort.d.ts.map

package/dist/api/routes/multipart/abort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/abort.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAkDxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;0BAO1B,CAAC"}
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/abort.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAmDxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;0BAM1B,CAAC"}

package/dist/api/routes/multipart/complete.d.ts

@@ -4,19 +4,19 @@ export declare const multipartComplete: import("better-call").StrictEndpoint<"/p
 } & {
     method: "POST";
     body: import("better-call").StandardSchemaV1<{
+        route: string;
         key: string;
         uploadId: string;
         parts: {
             partNumber: number;
         }[];
-        bucket?: string | undefined;
     }, {
+        route: string;
         key: string;
         uploadId: string;
         parts: {
             partNumber: number;
         }[];
-        bucket?: string | undefined;
     }>;
 }, MultipartCompleteResponse>;
 //# sourceMappingURL=complete.d.ts.map

package/dist/api/routes/multipart/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/complete.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAgHxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;6BAO7B,CAAC"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/complete.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAmGxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;6BAM7B,CAAC"}

package/dist/api/routes/multipart/init.d.ts

@@ -4,21 +4,19 @@ export declare const multipartInit: import("better-call").StrictEndpoint<"/presi
 } & {
     method: "POST";
     body: import("better-call").StandardSchemaV1<{
-        key: string;
-        contentType?: string | undefined;
-        fileSize?: number | undefined;
+        route: string;
+        fileName: string;
+        fileSize: number;
+        contentType?: unknown;
         metadata?: Record<string, string> | undefined;
-        bucket?: string | undefined;
-        acl?: "private" | "public-read" | undefined;
-        fileName?: string | undefined;
+        checksum?: unknown;
     }, {
-        key: string;
-        contentType?: string | undefined;
-        fileSize?: number | undefined;
+        route: string;
+        fileName: string;
+        fileSize: number;
+        contentType?: unknown;
         metadata?: Record<string, string> | undefined;
-        bucket?: string | undefined;
-        acl?: "private" | "public-read" | undefined;
-        fileName?: string | undefined;
+        checksum?: unknown;
     }>;
 }, MultipartInitResponse>;
 //# sourceMappingURL=init.d.ts.map

package/dist/api/routes/multipart/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/init.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AA6ExB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;yBAYzB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AA2ExB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;yBAYzB,CAAC"}

package/dist/api/routes/multipart/list-parts.d.ts

@@ -5,13 +5,13 @@ export declare const multipartListParts: import("better-call").StrictEndpoint<"/
     method: "GET";
 } & {
     query: import("better-call").StandardSchemaV1<{
+        route: string;
         key: string;
         uploadId: string;
-        bucket?: string | undefined;
     }, {
+        route: string;
         key: string;
         uploadId: string;
-        bucket?: string | undefined;
     }>;
 }, MultipartListPartsResponse>;
 //# sourceMappingURL=list-parts.d.ts.map

package/dist/api/routes/multipart/list-parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-parts.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/list-parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,gBAAgB,CAAC;AAiDxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;8BAO9B,CAAC"}
+{"version":3,"file":"list-parts.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/list-parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,gBAAgB,CAAC;AAuDxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;8BAM9B,CAAC"}

package/dist/api/routes/multipart/part.d.ts

@@ -4,19 +4,17 @@ export declare const multipartPart: import("better-call").StrictEndpoint<"/presi
 } & {
     method: "POST";
     body: import("better-call").StandardSchemaV1<{
+        route: string;
         key: string;
         uploadId: string;
         partNumber: number;
-        partSize?: number | undefined;
-        bucket?: string | undefined;
-        expiresIn?: number | undefined;
+        partSize: number;
     }, {
+        route: string;
         key: string;
         uploadId: string;
         partNumber: number;
-        partSize?: number | undefined;
-        bucket?: string | undefined;
-        expiresIn?: number | undefined;
+        partSize: number;
     }>;
 }, MultipartPartResponse>;
 //# sourceMappingURL=part.d.ts.map

package/dist/api/routes/multipart/part.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/part.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AA4DxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;yBAOzB,CAAC"}
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/multipart/part.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AA0ExB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;yBAMzB,CAAC"}

package/dist/api/routes/upload.d.ts

@@ -4,23 +4,19 @@ export declare const upload: import("better-call").StrictEndpoint<"/presign/uplo
 } & {
     method: "POST";
     body: import("better-call").StandardSchemaV1<{
-        key: string;
-        contentType?: string | undefined;
-        fileSize?: number | undefined;
+        route: string;
+        fileName: string;
+        fileSize: number;
+        contentType?: unknown;
         metadata?: Record<string, string> | undefined;
-        bucket?: string | undefined;
-        expiresIn?: number | undefined;
-        acl?: "private" | "public-read" | undefined;
-        fileName?: string | undefined;
+        checksum?: unknown;
     }, {
-        key: string;
-        contentType?: string | undefined;
-        fileSize?: number | undefined;
+        route: string;
+        fileName: string;
+        fileSize: number;
+        contentType?: unknown;
         metadata?: Record<string, string> | undefined;
-        bucket?: string | undefined;
-        expiresIn?: number | undefined;
-        acl?: "private" | "public-read" | undefined;
-        fileName?: string | undefined;
+        checksum?: unknown;
     }>;
 }, UploadPresignResponse>;
 //# sourceMappingURL=upload.d.ts.map

package/dist/api/routes/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/api/routes/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAwKxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;yBAOlB,CAAC"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/api/routes/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAiKxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;yBAMlB,CAAC"}

package/dist/dimah-s3.d.ts

@@ -1,7 +1,8 @@
 import { S3_ERROR_CODES } from "@dimah-s3/core";
+import { type PutObjectInput } from "./put";
 import { type DimahS3Plugin, type PluginContextMap, type PluginEndpointMap } from "./plugin";
 import { type CoreEndpoints } from "./api/routes";
-import type { DimahS3Config } from "./types";
+import type { DimahS3Config, DimahS3RouteConfig } from "./types";
 export type MultipartAliasApi = {
     init: CoreEndpoints["multipartInit"];
     signPart: CoreEndpoints["multipartPart"];
@@ -11,16 +12,17 @@ export type MultipartAliasApi = {
 };
 export type DimahS3Api<P extends readonly DimahS3Plugin[] = []> = CoreEndpoints & {
     multipart: MultipartAliasApi;
+    deleteMany: CoreEndpoints["deleteBatch"];
 } & PluginEndpointMap<P>;
-export type DimahS3<P extends readonly DimahS3Plugin[] = [], C extends Record<string, unknown> = PluginContextMap<P>> = {
+export type DimahS3<P extends readonly DimahS3Plugin[] = [], C extends Record<string, unknown> = PluginContextMap<P>, R extends Record<string, DimahS3RouteConfig> = Record<string, DimahS3RouteConfig>> = {
     /** Framework-agnostic HTTP handler (`Request` → `Response`). */
     handler: (request: Request) => Promise<Response>;
     /**
      * better-call endpoints — invoke as functions from Server Actions / RSC.
      *
      * ```ts
-     * await s3.api.download({ query: { key }, headers: await headers() });
-     * await s3.api.multipart.init({ body: { key } });
+     * await s3.api.download({ query: { route, key }, headers: await headers() });
+     * await s3.api.multipart.init({ body: { route, fileName, fileSize } });
      * ```
      */
     api: DimahS3Api<P>;
@@ -37,7 +39,12 @@ export type DimahS3<P extends readonly DimahS3Plugin[] = [], C extends Record<st
     $Infer: {
         api: DimahS3Api<P>;
         context: C;
+        routes: keyof R & string;
     };
+    /**
+     * Server-side upload through the same route policy as presign + confirm.
+     */
+    put: (input: PutObjectInput) => Promise<import("@dimah-s3/core").ConfirmedObjectResponse>;
 } & C;
 /**
  * Create a dimah-s3 server instance.
@@ -51,15 +58,19 @@ export type DimahS3<P extends readonly DimahS3Plugin[] = [], C extends Record<st
  * export const s3 = dimahS3({
  *   client: awsS3,
  *   bucket: "my-bucket",
- *   upload: true,
+ *   routes: {
+ *     uploads: route({ upload: { fileTypes: ["image/*"] } }),
+ *     invoices: route({ download: true }),
+ *   },
  * });
  *
  * export const { GET, POST, PUT, PATCH, DELETE } = toNextJsHandler(s3);
  *
- * await s3.api.download({ query: { key }, headers: await headers() });
+ * await s3.api.download({ query: { route: "invoices", key }, headers: await headers() });
  * ```
  */
-export declare function dimahS3<const P extends readonly DimahS3Plugin[] = []>(config: DimahS3Config & {
+export declare function dimahS3<const P extends readonly DimahS3Plugin[] = [], const R extends Record<string, DimahS3RouteConfig> = Record<string, DimahS3RouteConfig>>(config: DimahS3Config & {
     plugins?: P;
-}): DimahS3<P>;
+    routes: R;
+}): DimahS3<P, PluginContextMap<P>, R>;
 //# sourceMappingURL=dimah-s3.d.ts.map

package/dist/dimah-s3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimah-s3.d.ts","sourceRoot":"","sources":["../src/dimah-s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACrC,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACzC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/C,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC7C,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,IAC5D,aAAa,GAAG;IACd,SAAS,EAAE,iBAAiB,CAAC;CAC9B,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE3B,MAAM,MAAM,OAAO,CACjB,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EACvC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,IACrD;IACF,gEAAgE;IAChE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD;;;;;;;OAOG;IACH,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,wCAAwC;IACxC,SAAS,EAAE;QACT,CAAC,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EACzB,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,EAAE,CAAA;SAAE,CAAC,GAAG,SAAS,CAAC;QAC9C,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,YAAY,EAAE,OAAO,cAAc,CAAC;IACpC,MAAM,EAAE;QACN,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC;KACZ,CAAC;CACH,GAAG,CAAC,CAAC;AAEN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EACnE,MAAM,EAAE,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,GACtC,OAAO,CAAC,CAAC,CAAC,CAgCZ"}
+{"version":3,"file":"dimah-s3.d.ts","sourceRoot":"","sources":["../src/dimah-s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACrC,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACzC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/C,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC7C,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,IAC5D,aAAa,GAAG;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC1C,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE3B,MAAM,MAAM,OAAO,CACjB,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EACvC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EACvD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CACnD,MAAM,EACN,kBAAkB,CACnB,IACC;IACF,gEAAgE;IAChE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD;;;;;;;OAOG;IACH,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,wCAAwC;IACxC,SAAS,EAAE;QACT,CAAC,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EACzB,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,EAAE,CAAA;SAAE,CAAC,GAAG,SAAS,CAAC;QAC9C,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,YAAY,EAAE,OAAO,cAAc,CAAC;IACpC,MAAM,EAAE;QACN,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF;;OAEG;IACH,GAAG,EAAE,CACH,KAAK,EAAE,cAAc,KAClB,OAAO,CAAC,OAAO,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;CAChE,GAAG,CAAC,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EAC7C,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CACzD,MAAM,EACN,kBAAkB,CACnB,EAED,MAAM,EAAE,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACjD,OAAO,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAkCpC"}

package/dist/errors.d.ts

@@ -1,4 +1,5 @@
 import { DimahS3Error, S3_ERROR_CODES, isAPIError, isDimahS3Error, isS3ErrorCode } from "@dimah-s3/core";
+import type { RouteOperation } from "./types/config";
 export { DimahS3Error, S3_ERROR_CODES, isAPIError, isDimahS3Error, isS3ErrorCode, };
 /** English API errors with stable codes for client-side localization. */
 export declare const errors: {
@@ -8,14 +9,14 @@ export declare const errors: {
     readonly conflict: () => DimahS3Error;
     readonly internalError: () => DimahS3Error;
     readonly objectNotFound: () => DimahS3Error;
-    readonly featureDisabled: (feature: string) => DimahS3Error;
+    readonly featureDisabled: (feature: RouteOperation) => DimahS3Error;
     readonly invalidKey: () => DimahS3Error;
-    readonly invalidBucket: (bucket: string) => DimahS3Error;
+    readonly unknownRoute: (route: string) => DimahS3Error;
+    readonly fileTypeNotAllowed: (fileName: string, contentType?: string) => DimahS3Error;
     readonly s3NetworkError: (code: string) => DimahS3Error;
-    readonly fileSizeRequiredUpload: () => DimahS3Error;
-    readonly fileSizeRequiredMultipart: () => DimahS3Error;
     readonly multipartPartMissing: (partNumber: number) => DimahS3Error;
     readonly payloadTooLarge: (message?: string) => DimahS3Error;
+    readonly quotaExceeded: (message?: string) => DimahS3Error;
     readonly validationError: (message: string) => DimahS3Error;
 };
 export type ServerErrors = typeof errors;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,GACd,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,MAAM;aACjB,QAAQ;aAER,YAAY;aAGZ,SAAS;aAET,QAAQ;aAER,aAAa;aAGb,cAAc;aAGd,eAAe,YAAY,MAAM;aAUjC,UAAU;aAGV,aAAa,WAAW,MAAM;aAO9B,cAAc,SAAS,MAAM;aAU7B,sBAAsB;aAGtB,yBAAyB;aAMzB,oBAAoB,eAAe,MAAM;aAUzC,eAAe,aACJ,MAAM;aAOjB,eAAe,YAAY,MAAM;CAKzB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,GACd,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,MAAM;aACjB,QAAQ;aAER,YAAY;aAGZ,SAAS;aAET,QAAQ;aAER,aAAa;aAGb,cAAc;aAGd,eAAe,YAAY,cAAc;aAUzC,UAAU;aAGV,YAAY,UAAU,MAAM;aAO5B,kBAAkB,aAAa,MAAM,gBAAgB,MAAM;aAU3D,cAAc,SAAS,MAAM;aAU7B,oBAAoB,eAAe,MAAM;aAUzC,eAAe,aACJ,MAAM;aAOjB,aAAa,aAAY,MAAM;aAM/B,eAAe,YAAY,MAAM;CAKzB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC"}

package/dist/helpers/best-effort.d.ts

@@ -0,0 +1,6 @@
+import { type S3Client } from "@aws-sdk/client-s3";
+/** Best-effort DeleteObject after a failed constraint check. */
+export declare function deleteObjectBestEffort(client: S3Client, bucket: string, key: string): Promise<void>;
+/** Best-effort AbortMultipartUpload before assembly or after a failed complete. */
+export declare function abortMultipartBestEffort(client: S3Client, bucket: string, key: string, uploadId: string): Promise<void>;
+//# sourceMappingURL=best-effort.d.ts.map

package/dist/helpers/best-effort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-effort.d.ts","sourceRoot":"","sources":["../../src/helpers/best-effort.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAE5B,gEAAgE;AAChE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,mFAAmF;AACnF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/helpers/constraints.d.ts

@@ -0,0 +1,16 @@
+import type { UploadConfig } from "../types";
+/** File limits from `upload` (`fileTypes` / `maxFileSize`). */
+export type FileConstraints = Pick<UploadConfig, "fileTypes" | "maxFileSize">;
+/** Reject when `size` is over the route cap. No-op when `maxFileSize` is unset. */
+export declare function assertWithinMaxFileSize(maxFileSize: number | undefined, size: number): void;
+export declare function assertDeclaredConstraints(constraints: FileConstraints | undefined, input: {
+    fileName: string;
+    fileSize: number;
+    contentType?: string;
+}): void;
+export declare function assertVerifiedConstraints(constraints: FileConstraints | undefined, input: {
+    fileName?: string;
+    contentType?: string;
+    contentLength: number;
+}): void;
+//# sourceMappingURL=constraints.d.ts.map

package/dist/helpers/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../src/helpers/constraints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;AAE9E,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,IAAI,CAIN;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,IAAI,CAQN;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACxE,IAAI,CASN"}

package/dist/helpers/expires.d.ts

@@ -1,6 +1,6 @@
 /**
- * Coerce a client `expiresIn` to a positive integer, then clamp to
- * {@link maxExpiresIn} (SigV4 max by default).
+ * Coerce an upload/download `expiresIn` to a positive integer, then clamp
+ * to {@link maxExpiresIn} (SigV4 max by default).
  */
 export declare function normalizeExpiresIn(value: unknown, maxExpiresIn?: number): number;
 //# sourceMappingURL=expires.d.ts.map

package/dist/helpers/features.d.ts

@@ -1,34 +1,17 @@
-import type { DownloadConfig, DeleteConfig, FeatureToggle, MultipartConfig, ResolvedDimahS3Config, UploadConfig } from "../types";
-export declare function normalizeFeature<T extends object>(value: FeatureToggle<T> | undefined): (T & {
+import type { DimahS3Config, DimahS3RouteConfig, FeatureToggle, ResolvedFeature, ResolvedRoute } from "../types";
+export declare function isEnabled<T extends {
     enabled: boolean;
-}) | undefined;
-export declare function isFeatureEnabled(config: ResolvedDimahS3Config, feature: "upload" | "download" | "delete" | "multipart"): boolean;
-export declare function applyMultipartDefault(config: ResolvedDimahS3Config, multipartInput: FeatureToggle<MultipartConfig> | undefined): ResolvedDimahS3Config;
-export type NormalizedFeatures = {
-    upload?: UploadConfig & {
-        enabled: boolean;
-    };
-    download?: DownloadConfig & {
-        enabled: boolean;
-    };
-    delete?: DeleteConfig & {
-        enabled: boolean;
-    };
-    multipart?: MultipartConfig & {
-        enabled: boolean;
-    };
+}>(feature: T): feature is T & {
+    enabled: true;
 };
-export declare function normalizeFeatures(config: {
-    upload?: FeatureToggle<UploadConfig>;
-    download?: FeatureToggle<DownloadConfig>;
-    delete?: FeatureToggle<DeleteConfig>;
-    multipart?: FeatureToggle<MultipartConfig>;
-}): NormalizedFeatures;
 /**
- * `allowClientBucket` (any bucket) and `buckets` (allowlist) are exclusive.
+ * `true` / options → on; `false` → off.
+ * `undefined` uses {@link defaultOn} (false unless passed).
+ * Resolved `{ enabled }` objects (after `normalizeFeature`) use that flag.
  */
-export declare function assertExclusiveBucketFlags(config: {
-    allowClientBucket?: boolean;
-    buckets?: string[];
-}): void;
+export declare function isFeatureOn<T extends object>(value: FeatureToggle<T> | ResolvedFeature<T> | undefined, defaultOn?: boolean): boolean;
+/** `true` / options → enabled; omit / `false` → disabled. */
+export declare function normalizeFeature<T extends object>(value: FeatureToggle<T> | undefined, defaultOn?: boolean): ResolvedFeature<T>;
+export declare function normalizeRoute(name: string, route: DimahS3RouteConfig, instance: Pick<DimahS3Config, "client" | "bucket">): ResolvedRoute;
+export declare function normalizeRoutes(config: DimahS3Config): Record<string, ResolvedRoute>;
 //# sourceMappingURL=features.d.ts.map

package/dist/helpers/features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/helpers/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,GAClC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,SAAS,CAKxC;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GACtD,OAAO,CAET;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,cAAc,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,SAAS,GACzD,qBAAqB,CAwBvB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,QAAQ,CAAC,EAAE,cAAc,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,MAAM,CAAC,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,eAAe,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAC5C,GAAG,kBAAkB,CAOrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,IAAI,CAMP"}
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/helpers/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,kBAAkB,EAGlB,aAAa,EAEb,eAAe,EACf,aAAa,EAGd,MAAM,SAAS,CAAC;AAIjB,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EACtD,OAAO,EAAE,CAAC,GACT,OAAO,IAAI,CAAC,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAElC;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EACxD,SAAS,UAAQ,GAChB,OAAO,CAQT;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,EACnC,SAAS,UAAQ,GAChB,eAAe,CAAC,CAAC,CAAC,CAQpB;AAsBD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAC,GACjD,aAAa,CAyDf;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAW/B"}