@dimah-s3/server 1.0.2 → 1.1.0

package/dist/helpers/finalize-confirmed.d.ts

@@ -0,0 +1,19 @@
+import type { ConfirmedObjectResponse, S3ObjectAcl } from "@dimah-s3/core";
+import type { HeadObjectCommandOutput, S3Client } from "@aws-sdk/client-s3";
+import type { OpenedRoute, ResolvedDimahS3Config, StoredObjectContext } from "../types";
+export type FinalizeConfirmedInput = {
+    config: ResolvedDimahS3Config;
+    route: OpenedRoute<"upload" | "multipart">;
+    stored: StoredObjectContext;
+    head: HeadObjectCommandOutput;
+    uploadId?: string;
+    /** ACL from the upload policy, not GetObjectAcl. */
+    acl?: S3ObjectAcl;
+};
+/**
+ * HeadObject constraints, `onConfirmed`, then compensating `DeleteObject`
+ * (and `previousKey` cleanup) so a thrown lifecycle hook cannot leave an
+ * orphan object.
+ */
+export declare function finalizeConfirmedObject(client: S3Client, bucket: string, key: string, input: FinalizeConfirmedInput): Promise<ConfirmedObjectResponse>;
+//# sourceMappingURL=finalize-confirmed.d.ts.map

package/dist/helpers/finalize-confirmed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-confirmed.d.ts","sourceRoot":"","sources":["../../src/helpers/finalize-confirmed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAU5E,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC;IAC3C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA4DlC"}

package/dist/helpers/head-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head-object.d.ts","sourceRoot":"","sources":["../../src/helpers/head-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAI5B,+DAA+D;AAC/D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC,CAIlC;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAK1E"}
+{"version":3,"file":"head-object.d.ts","sourceRoot":"","sources":["../../src/helpers/head-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAI5B,+DAA+D;AAC/D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC,CAIlC;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC,CAgBlC;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAK1E"}

package/dist/helpers/hooks.d.ts

@@ -1,3 +1,4 @@
+import type { ResolvedDimahS3Config, UploadConfig, UploadObjectContext, UploadObjectInfo } from "../types";
 /**
  * Run a guard hook. {@link isAPIError} values are preserved; plain Errors keep
  * their English message without a library `code` so client
@@ -6,11 +7,16 @@
 export declare function runHook<T extends {
     request: Request;
 }>(hook: ((context: T) => Promise<void> | void) | undefined, context: T): Promise<void>;
+/**
+ * Run `upload.object`. Same rejection mapping as {@link runHook}
+ * (plain `Error` → 403) so auth throws in `object` match `guard`.
+ */
+export declare function runObjectHook(hook: UploadConfig["object"], context: UploadObjectContext): Promise<UploadObjectInfo | void>;
 /**
  * Run a lifecycle `on*` hook. Failures become {@link errors.internalError}
  * (or preserve an existing APIError).
  */
 export declare function runLifecycleHook<T extends {
     request: Request;
-}>(hook: ((context: T) => Promise<void> | void) | undefined, context: T): Promise<void>;
+}>(hook: ((context: T) => Promise<void> | void) | undefined, context: T, config?: Pick<ResolvedDimahS3Config, "logger" | "onError">): Promise<void>;
 //# sourceMappingURL=hooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/helpers/hooks.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,EACxD,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EACnE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,EACxD,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,IAAI,CAAC,CASf"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/helpers/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAajB;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,EACxD,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOlC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EACnE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,EACxD,OAAO,EAAE,CAAC,EACV,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/helpers/index.d.ts

@@ -1,14 +1,17 @@
+export { abortMultipartBestEffort, deleteObjectBestEffort, } from "./best-effort";
 export { isAwsNotFound, sendOrObjectNotFound } from "./is-aws-not-found";
-export { resolveObjectAcl } from "./resolve-object-acl";
-export { resolveRequestAcl } from "./resolve-request-acl";
-export type { AclPolicy } from "./resolve-request-acl";
 export { normalizeExpiresIn } from "./expires";
-export { runHook, runLifecycleHook } from "./hooks";
+export { runHook, runLifecycleHook, runObjectHook } from "./hooks";
+export { isEnabled, isFeatureOn, normalizeFeature, normalizeRoute, normalizeRoutes, } from "./features";
 export { requestFromHeaders } from "./request";
-export { assertSafeObjectKey, resolveBucket, resolveObjectKey, resolveRequestTarget, } from "./resolve-target";
-export type { KeyPolicy } from "./resolve-target";
+export { assertSafeObjectKey, assertStoredKey, generateObjectKey, nestKeyUnderPrefix, normalizeObjectKey, resolveStoredTarget, resolveUploadTarget, } from "./resolve-target";
+export type { ResolvedObject } from "./resolve-target";
+export { assertFeatureEnabled, getResolvedRoute, openRoute, openStoredTarget, openUploadTarget, storedObjectContext, } from "./resolve-route";
+export type { OpenedTarget, OpenedUploadTarget, OpenUploadInput, } from "./resolve-route";
+export { assertDeclaredConstraints, assertVerifiedConstraints, assertWithinMaxFileSize, } from "./constraints";
 export { headObjectAfterMultipartComplete, headObjectOrNotFound, requireContentLength, } from "./head-object";
-export { listAllParts } from "./list-parts";
-export { applyMultipartDefault, assertExclusiveBucketFlags, isFeatureEnabled, normalizeFeature, normalizeFeatures, } from "./features";
-export type { NormalizedFeatures } from "./features";
+export { listAllParts, listedPartsByteSize } from "./list-parts";
+export { resolveLogger, defaultLogger } from "./logger";
+export { finalizeConfirmedObject } from "./finalize-confirmed";
+export { DIMAH_PREVIOUS_KEY_META, previousKeyFromMetadata, stripPreviousKeyMeta, } from "./previous-key";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EACL,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/helpers/list-parts.d.ts

@@ -5,4 +5,9 @@ export declare function listAllParts(client: S3Client, input: {
     key: string;
     uploadId: string;
 }): Promise<Part[]>;
+/** Sum `Size` on listed parts. Pass `excludePartNumber` when replacing a part. */
+export declare function listedPartsByteSize(parts: readonly {
+    PartNumber?: number;
+    Size?: number;
+}[], excludePartNumber?: number): number;
 //# sourceMappingURL=list-parts.d.ts.map

package/dist/helpers/list-parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-parts.d.ts","sourceRoot":"","sources":["../../src/helpers/list-parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGhF,6DAA6D;AAC7D,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,EAAE,CAAC,CAsBjB"}
+{"version":3,"file":"list-parts.d.ts","sourceRoot":"","sources":["../../src/helpers/list-parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAG5B,6DAA6D;AAC7D,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,EAAE,CAAC,CAsBjB;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACxD,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAYR"}

package/dist/helpers/logger.d.ts

@@ -0,0 +1,4 @@
+import type { DimahS3Logger } from "../types";
+export declare const defaultLogger: DimahS3Logger;
+export declare function resolveLogger(logger: DimahS3Logger | false | undefined): DimahS3Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/helpers/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,aAO3B,CAAC;AAEF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,GACxC,aAAa,CAIf"}

package/dist/helpers/previous-key.d.ts

@@ -0,0 +1,5 @@
+/** S3 user-metadata key for `upload.object().previousKey`. */
+export declare const DIMAH_PREVIOUS_KEY_META = "dimah-previous-key";
+export declare function stripPreviousKeyMeta(metadata: Record<string, string> | undefined): Record<string, string>;
+export declare function previousKeyFromMetadata(metadata: Record<string, string> | undefined): string | undefined;
+//# sourceMappingURL=previous-key.d.ts.map

package/dist/helpers/previous-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previous-key.d.ts","sourceRoot":"","sources":["../../src/helpers/previous-key.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAGpB"}

package/dist/helpers/resolve-route.d.ts

@@ -0,0 +1,36 @@
+import type { S3ObjectAcl } from "@dimah-s3/core";
+import type { OpenedRoute, ResolvedDimahS3Config, ResolvedRoute, RouteOperation, StoredObjectContext } from "../types";
+export type OpenedTarget<F extends RouteOperation> = {
+    route: OpenedRoute<F>;
+    key: string;
+    bucket: string;
+    stored: StoredObjectContext;
+};
+export type OpenedUploadTarget<F extends "upload" | "multipart"> = OpenedTarget<F> & {
+    metadata?: Record<string, string>;
+    acl: S3ObjectAcl;
+};
+export type OpenUploadInput = {
+    route: string;
+    fileName: string;
+    fileSize: number;
+    contentType?: string;
+    metadata?: Record<string, string>;
+};
+export declare function getResolvedRoute(config: ResolvedDimahS3Config, name: string): ResolvedRoute;
+/** Disabled features respond 404 (`FEATURE_DISABLED`) from both HTTP and `s3.api`. */
+export declare function assertFeatureEnabled<F extends RouteOperation>(route: ResolvedRoute, feature: F): asserts route is OpenedRoute<F>;
+/** Lookup the named route, reject a disabled feature, run the route `guard`. */
+export declare function openRoute<F extends RouteOperation>(config: ResolvedDimahS3Config, name: string, request: Request, feature: F): Promise<OpenedRoute<F>>;
+export declare function storedObjectContext(request: Request, route: Pick<ResolvedRoute, "name" | "bucket">, key: string): StoredObjectContext;
+/**
+ * {@link openRoute} plus file constraints and server-owned key generation.
+ * Used by upload presign and multipart init.
+ */
+export declare function openUploadTarget<F extends "upload" | "multipart">(config: ResolvedDimahS3Config, input: OpenUploadInput, request: Request, feature: F): Promise<OpenedUploadTarget<F>>;
+/** {@link openRoute} plus the stored-key namespace check. */
+export declare function openStoredTarget<F extends RouteOperation>(config: ResolvedDimahS3Config, input: {
+    route: string;
+    key: string;
+}, request: Request, feature: F): Promise<OpenedTarget<F>>;
+//# sourceMappingURL=resolve-route.d.ts.map

package/dist/helpers/resolve-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-route.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQlD,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,cAAc,IAAI;IACnD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,QAAQ,GAAG,WAAW,IAC7D,YAAY,CAAC,CAAC,CAAC,GAAG;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEJ,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,GACX,aAAa,CAMf;AAUD,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAIjC;AAED,gFAAgF;AAChF,wBAAsB,SAAS,CAAC,CAAC,SAAS,cAAc,EACtD,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAKzB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,EAC7C,GAAG,EAAE,MAAM,GACV,mBAAmB,CAErB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,GAAG,WAAW,EACrE,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAwBhC;AAED,6DAA6D;AAC7D,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAC7D,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAQ1B"}

package/dist/helpers/resolve-target.d.ts

@@ -1,20 +1,31 @@
-import type { KeyPolicy, ResolvedDimahS3Config, ResolveKeyContext } from "../types";
-export type { KeyPolicy };
+import { normalizeObjectKey, type S3ObjectAcl } from "@dimah-s3/core";
+import type { OpenedRoute, ResolvedRoute, UploadObjectContext } from "../types";
+export type ResolvedObject = {
+    key: string;
+    bucket: string;
+    metadata?: Record<string, string>;
+    acl: S3ObjectAcl;
+};
+type RouteKeyPrefix = ResolvedRoute["keyPrefix"];
 /**
- * Normalize a client-proposed object key: strip leading slashes, reject
- * `.` / `..` segments, NUL, and backslashes.
+ * Strip leading/trailing slashes and reject `.` / `..` / empty segments,
+ * NUL, and backslashes. Returns `null` when the key is unsafe.
+ */
+export { normalizeObjectKey };
+/**
+ * Normalize an object key: strip leading slashes, reject `.` / `..` segments,
+ * NUL, and backslashes.
  */
 export declare function assertSafeObjectKey(key: string): string;
-export declare function resolveObjectKey(policy: KeyPolicy | undefined, context: ResolveKeyContext): Promise<string>;
-export declare function resolveBucket(config: ResolvedDimahS3Config, requested?: string): string;
-export declare function resolveRequestTarget(config: ResolvedDimahS3Config, policy: KeyPolicy | undefined, input: {
-    request: Request;
-    key: string;
-    bucket?: string;
-    fileName?: string;
-    contentType?: string;
-}): Promise<{
+/** Nest `key` under `keyPrefix`. `false` leaves a safe key unchanged. */
+export declare function nestKeyUnderPrefix(keyPrefix: RouteKeyPrefix, key: string): string;
+/** Confirm / download / delete / multipart follow-ups: stored key + namespace. */
+export declare function assertStoredKey(key: string, keyPrefix: RouteKeyPrefix): string;
+/** `{folder}/{uuid}/{sanitizedName}` — omit `folder` (`false`) for `{uuid}/{name}`. */
+export declare function generateObjectKey(folder: string | false, fileName: string): string;
+export declare function resolveUploadTarget(route: OpenedRoute<"upload" | "multipart">, context: Omit<UploadObjectContext, "bucket" | "keyPrefix">): Promise<ResolvedObject>;
+export declare function resolveStoredTarget(route: ResolvedRoute, key: string): {
     key: string;
     bucket: string;
-}>;
+};
 //# sourceMappingURL=resolve-target.d.ts.map

package/dist/helpers/resolve-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-target.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAavD;AASD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAQR;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,EAAE;IACL,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU1C"}
+{"version":3,"file":"resolve-target.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-target.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,KAAK,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAEjD;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAUD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,CAIR;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,cAAc,GACxB,MAAM,CAMR;AAgBD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AASD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,EAC1C,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,WAAW,CAAC,GACzD,OAAO,CAAC,cAAc,CAAC,CAgCzB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKjC"}

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 export { dimahS3 } from "./dimah-s3";
+export { putObject } from "./put";
+export type { PutObjectInput } from "./put";
 export type { DimahS3, DimahS3Api, MultipartAliasApi } from "./dimah-s3";
+export { route } from "./route";
 export { DimahS3Error, errors, isAPIError, isDimahS3Error, isS3ErrorCode, S3_ERROR_CODES, } from "./errors";
 export type { ServerErrors } from "./errors";
 export { createS3Endpoint, createS3Middleware } from "./api";
 export type { S3EndpointContext } from "./api";
-export { definePlugin } from "./plugin";
+export { chainHooks, definePlugin } from "./plugin";
 export type { DimahS3Plugin, DimahS3PluginHooks, PluginContextMap, PluginEndpointMap, PluginInitEnv, } from "./plugin";
-export type { DimahS3Config, DownloadConfig, DeleteConfig, FeatureToggle, KeyPolicy, KeyPrefix, MultipartConfig, ResolveKeyContext, ResolvedDimahS3Config, UploadConfig, } from "./types";
+export { ROUTE_FEATURES, ROUTE_OPERATIONS } from "./types";
+export { isFeatureOn } from "./helpers";
+export type { DeleteConfig, DeleteGuardContext, DeleteOnDeletedContext, DimahS3Config, DimahS3Logger, DimahS3RouteConfig, DisabledFeature, DownloadConfig, DownloadGuardContext, DownloadOnPresignedContext, DownloadResolveInfo, EnabledFeature, EnabledUploadConfig, FeatureToggle, GuardContext, MultipartConfig, MultipartOnAbortContext, MultipartOnInitContext, MultipartOnListContext, MultipartGuardContext, MultipartUploadContext, ObjectFile, OpenedRoute, ResolvedDimahS3Config, ResolvedFeature, ResolvedRoute, ResolvedUploadConfig, RouteFeature, RouteGuardContext, RouteOperation, StoredObjectContext, UploadConfig, UploadConfirmGuardContext, UploadGuardContext, UploadObjectContext, UploadObjectInfo, UploadOnConfirmedContext, UploadOnPresignedContext, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACL,YAAY,EACZ,MAAM,EACN,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,GACb,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,YAAY,EACZ,MAAM,EACN,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,SAAS,CAAC"}