@dimah-s3/server 1.0.2 → 1.1.0

package/dist/types/hook-contexts.d.ts

@@ -1,59 +1,117 @@
 import type { MultipartCompletedPartRef, MultipartPartInfo, S3ObjectAcl } from "@dimah-s3/core";
-/** Context for the global `guard` hook. */
+/** Context for the instance `guard` hook. */
 export type GuardContext = {
     /** The incoming HTTP request. */
     request: Request;
 };
-type ObjectContext = GuardContext & {
+/** Context for a route-level `guard` (every operation on that route). */
+export type RouteGuardContext = GuardContext & {
+    /** Named file route. */
+    route: string;
+};
+/**
+ * Shared hook context once an object key is assigned — generated on
+ * upload / multipart init, or supplied on confirm / download / delete /
+ * multipart session ops.
+ */
+export type StoredObjectContext = RouteGuardContext & {
     /** S3 object key. */
     key: string;
     /** Target bucket. */
     bucket: string;
 };
+/** Declared file on upload / multipart init. */
+export type ObjectFile = {
+    name: string;
+    size?: number;
+    type?: string;
+};
 /**
- * Input to `prefix` (string or factory) and `resolveKey` on a feature config.
- * Prefer a `prefix` factory for per-user / per-tenant folders so already-
- * prefixed stored keys stay idempotent.
+ * Input to `upload.object` on presign / multipart init.
+ * `clientMetadata` is what the client sent — it is not written to S3
+ * unless `object` copies it into {@link UploadObjectInfo.metadata}.
  */
-export type ResolveKeyContext = {
+export type UploadObjectContext = {
     request: Request;
-    /** Key the client sent. */
-    proposedKey: string;
-    fileName?: string;
-    contentType?: string;
+    route: string;
+    file: ObjectFile;
     bucket: string;
+    /**
+     * Namespace this route writes under. `false` skips the follow-up
+     * namespace check and generates `{uuid}/{name}` when `object` omits
+     * `folder` / `key`.
+     */
+    keyPrefix: string | false;
+    clientMetadata?: Record<string, string>;
 };
-/** Context for `upload.guard`. Client-declared values are not verified by S3. */
-export type UploadPresignGuardContext = ObjectContext & {
-    /** MIME type the client sent — not verified until `onConfirmed`. */
-    contentType?: string;
-    /** Size the client sent — not verified until `onConfirmed`. */
-    fileSize?: number;
-    /** Custom object metadata. */
+/** Server-owned S3 object identity from `upload.object`. */
+export type UploadObjectInfo = {
+    /**
+     * Extra folder under the route {@link UploadObjectContext.keyPrefix}.
+     * Nested as `{keyPrefix}/{folder}/{uuid}/{name}` unless `keyPrefix` is
+     * `false` (`{folder}/{uuid}/{name}`). Ignored when {@link key} is set.
+     */
+    folder?: string;
+    /**
+     * Object key, nested under {@link UploadObjectContext.keyPrefix} unless
+     * the key is already inside that prefix or `keyPrefix` is `false`.
+     * If omitted, `{keyPrefix}/{folder}/{uuid}/{name}` is used
+     * (`{uuid}/{name}` when `keyPrefix` is `false` and `folder` is omitted).
+     */
+    key?: string;
+    /** S3 user metadata (`x-amz-meta-*`). */
     metadata?: Record<string, string>;
-    /** Requested ACL. */
+    /** Override the route ACL for this object. */
     acl?: S3ObjectAcl;
-    /** Original filename for `Content-Disposition`. */
-    fileName?: string;
+    /**
+     * After confirm succeeds, delete this key (must stay under the route
+     * `keyPrefix`). Use with a new generated key to rotate avatars.
+     */
+    previousKey?: string;
+};
+/**
+ * Context for `upload.guard`.
+ * Runs on single-shot presign and multipart init **after** `upload.object`
+ * so `key` is already assigned (plugins like `db()` check ownership here).
+ * Client-declared values are not verified by S3.
+ */
+export type UploadGuardContext = StoredObjectContext & {
+    /** Declared file from the presign body — same shape as `upload.object`. */
+    file: ObjectFile;
+    /** S3 object metadata from route `object`. */
+    metadata?: Record<string, string>;
+    /** Client extras from the request — not written to S3 automatically. */
+    clientMetadata?: Record<string, string>;
+    /** Resolved ACL. */
+    acl?: S3ObjectAcl;
+    /** Route `upload.replace`. */
+    replace?: "overwrite";
 };
-/** Context for `upload.onPresigned`. */
-export type UploadOnPresignedContext = UploadPresignGuardContext & {
+/** Context for `upload.onPresigned` (single-shot only). */
+export type UploadOnPresignedContext = UploadGuardContext & {
     /** Presigned upload URL. */
     url: string;
     /** Validity in seconds. */
     expiresIn: number;
 };
-/** Context for `upload.confirmGuard`. */
-export type UploadConfirmGuardContext = ObjectContext;
+/**
+ * Context for `upload.confirmGuard`.
+ * Runs on single-shot confirm and multipart complete.
+ */
+export type UploadConfirmGuardContext = StoredObjectContext & {
+    /** Present on multipart complete. */
+    uploadId?: string;
+    /** Parts to assemble. Present on multipart complete. */
+    parts?: MultipartCompletedPartRef[];
+    /** Route `upload.replace`. */
+    replace?: "overwrite";
+};
 /**
  * Context for `upload.onConfirmed`.
  * `contentLength` and `eTag` are verified by S3 via HeadObject.
+ * Runs after single-shot confirm and multipart complete.
  */
-export type UploadOnConfirmedContext = GuardContext & {
-    /** S3 object key. */
-    key: string;
-    /** Target bucket. */
-    bucket: string;
+export type UploadOnConfirmedContext = StoredObjectContext & {
     /** MIME type from HeadObject. */
     contentType?: string;
     /** Size from HeadObject — trust this, not the presign `fileSize`. */
@@ -62,7 +120,7 @@ export type UploadOnConfirmedContext = GuardContext & {
     eTag?: string;
     /** Object metadata. */
     metadata?: Record<string, string>;
-    /** Resolved ACL. Omitted when ACL lookup is disabled or unsupported. */
+    /** ACL from the upload policy (`upload.acl` / `object`). */
     acl?: S3ObjectAcl;
     /** Stored filename. */
     fileName?: string;
@@ -70,87 +128,66 @@ export type UploadOnConfirmedContext = GuardContext & {
     versionId?: string;
     /** Last modified timestamp. */
     lastModified?: string;
+    /** Present after multipart complete. */
+    uploadId?: string;
 };
 /** Context for `download.guard`. */
-export type DownloadPresignGuardContext = ObjectContext & {
+export type DownloadGuardContext = StoredObjectContext & {
     /** Download filename for Content-Disposition. */
     fileName?: string;
+    /** Client-requested or route default disposition. */
+    disposition?: "inline" | "attachment";
+};
+/** Per-request overrides from `download.resolve`. */
+export type DownloadResolveInfo = {
+    disposition?: "inline" | "attachment";
+    expiresIn?: number;
+    fileName?: string;
 };
 /** Context for `download.onPresigned`. */
-export type DownloadOnPresignedContext = DownloadPresignGuardContext & {
+export type DownloadOnPresignedContext = DownloadGuardContext & {
     /** Presigned GET URL. */
     url: string;
     /** Validity in seconds. */
     expiresIn: number;
 };
 /** Context for `delete.guard`. */
-export type DeleteGuardContext = ObjectContext;
+export type DeleteGuardContext = StoredObjectContext;
 /** Context for `delete.onDeleted`. */
-export type DeleteOnDeletedContext = ObjectContext;
+export type DeleteOnDeletedContext = StoredObjectContext;
 /** Shared base for multipart operations that already have an upload id. */
-export type MultipartUploadContext = ObjectContext & {
+export type MultipartUploadContext = StoredObjectContext & {
     /** Multipart upload ID. */
     uploadId: string;
 };
-/** Context for `multipart.initGuard`. */
-export type MultipartInitGuardContext = ObjectContext & {
-    /** Declared byte size of the file — available during init only. */
-    fileSize?: number;
-    /** MIME type the client sent — not verified until `onComplete`. */
-    contentType?: string;
-    /** Custom object metadata. */
-    metadata?: Record<string, string>;
-    /** Resolved ACL that will be applied at init. */
-    acl?: S3ObjectAcl;
-    /** Original filename for `Content-Disposition`. */
-    fileName?: string;
+/** Context for `upload.multipart.onInit`. */
+export type MultipartOnInitContext = UploadGuardContext & {
+    /** Multipart upload ID. */
+    uploadId: string;
 };
-/** Context for `multipart.partGuard`. */
-export type MultipartPartGuardContext = MultipartUploadContext & {
+/**
+ * Context for `upload.multipart.guard`.
+ * Runs on part, list, abort, and complete (init uses `upload.guard`).
+ * Complete also runs `upload.confirmGuard`.
+ */
+export type MultipartGuardContext = (MultipartUploadContext & {
+    action: "part";
     /** 1-based part number. */
     partNumber: number;
     /** Byte size locked into the presigned URL signature. */
-    partSize?: number;
-};
-/** Context for `multipart.completeGuard`. */
-export type MultipartCompleteGuardContext = MultipartUploadContext & {
-    /** Parts to assemble. */
-    parts: MultipartCompletedPartRef[];
-};
-/** Context for `multipart.abortGuard`. */
-export type MultipartAbortGuardContext = MultipartUploadContext;
-/** Context for `multipart.listGuard`. */
-export type MultipartListGuardContext = MultipartUploadContext;
-/** Context for `multipart.onInit`. */
-export type MultipartOnInitContext = MultipartInitGuardContext & {
-    /** Multipart upload ID. */
-    uploadId: string;
-};
-/** Context for `multipart.onComplete`. */
-export type MultipartOnCompleteContext = MultipartUploadContext & {
-    /** Verified size in bytes. */
-    contentLength: number;
-    /** MIME type from HeadObject. */
-    contentType?: string;
-    /** ETag from HeadObject. */
-    eTag?: string;
-    /** Object metadata. */
-    metadata: Record<string, string>;
-    /** Resolved ACL. Omitted when ACL lookup is disabled or unsupported. */
-    acl?: S3ObjectAcl;
-    /** Stored filename. */
-    fileName?: string;
-    /** S3 version ID. */
-    versionId?: string;
-    /** Last modified timestamp. */
-    lastModified?: string;
-};
-/** Context for `multipart.onAbort`. */
+    partSize: number;
+}) | (MultipartUploadContext & {
+    action: "list";
+}) | (MultipartUploadContext & {
+    action: "abort";
+}) | (MultipartUploadContext & {
+    action: "complete";
+});
+/** Context for `upload.multipart.onAbort`. */
 export type MultipartOnAbortContext = MultipartUploadContext;
-/** Context for `multipart.onList`. */
+/** Context for `upload.multipart.onList`. */
 export type MultipartOnListContext = MultipartUploadContext & {
     /** Parts already uploaded to S3. */
     parts: MultipartPartInfo[];
 };
-export {};
 //# sourceMappingURL=hook-contexts.d.ts.map

package/dist/types/hook-contexts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-contexts.d.ts","sourceRoot":"","sources":["../../src/types/hook-contexts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hook-contexts.d.ts","sourceRoot":"","sources":["../../src/types/hook-contexts.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
-export type { GuardContext, ResolveKeyContext, UploadPresignGuardContext, UploadOnPresignedContext, UploadConfirmGuardContext, UploadOnConfirmedContext, DownloadPresignGuardContext, DownloadOnPresignedContext, DeleteGuardContext, DeleteOnDeletedContext, MultipartUploadContext, MultipartInitGuardContext, MultipartPartGuardContext, MultipartCompleteGuardContext, MultipartAbortGuardContext, MultipartListGuardContext, MultipartOnInitContext, MultipartOnCompleteContext, MultipartOnAbortContext, MultipartOnListContext, } from "./hook-contexts";
-export type { AclPolicy, DimahS3Config, DownloadConfig, DeleteConfig, FeatureToggle, KeyPolicy, KeyPrefix, MultipartConfig, ResolvedDimahS3Config, UploadConfig, } from "./config";
+export type { DeleteGuardContext, DeleteOnDeletedContext, DownloadGuardContext, DownloadOnPresignedContext, GuardContext, MultipartOnAbortContext, MultipartOnInitContext, MultipartOnListContext, MultipartGuardContext, MultipartUploadContext, ObjectFile, RouteGuardContext, StoredObjectContext, UploadConfirmGuardContext, UploadGuardContext, UploadObjectContext, UploadObjectInfo, UploadOnConfirmedContext, UploadOnPresignedContext, DownloadResolveInfo, } from "./hook-contexts";
+export type { DeleteConfig, DimahS3Config, DimahS3Logger, DimahS3RouteConfig, DisabledFeature, DownloadConfig, EnabledFeature, EnabledUploadConfig, FeatureToggle, MultipartConfig, OpenedRoute, ResolvedDimahS3Config, ResolvedFeature, ResolvedRoute, ResolvedUploadConfig, RouteFeature, RouteOperation, UploadConfig, } from "./config";
+export { ROUTE_FEATURES, ROUTE_OPERATIONS } from "./config";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,YAAY,GACb,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimah-s3/server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Presigned S3 server — dimahS3() with HTTP handler and direct api for upload, download, delete, and multipart",
   "keywords": [
     "s3",
@@ -78,25 +78,25 @@
     "dist"
   ],
   "dependencies": {
-    "@aws-sdk/s3-presigned-post": "^3.1116.0",
-    "@aws-sdk/s3-request-presigner": "^3.1116.0",
+    "@aws-sdk/s3-presigned-post": "^3.1121.0",
+    "@aws-sdk/s3-request-presigner": "^3.1121.0",
+    "@dimah-s3/core": "1.1.0",
     "better-call": "1.4.0",
-    "zod": "^4.4.3",
-    "@dimah-s3/core": "1.0.2"
+    "zod": "^4.5.4"
   },
   "peerDependencies": {
     "@aws-sdk/client-s3": ">=3"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.1116.0",
-    "@types/node": "^26.2.0",
-    "eslint": "^10.9.0",
+    "@aws-sdk/client-s3": "^3.1121.0",
+    "@types/node": "^26.4.0",
+    "@workspace/eslint-config": "0.0.1",
+    "@workspace/typescript-config": "0.0.1",
+    "eslint": "^10.9.1",
     "tsc-alias": "^1.9.2",
     "tsup": "^8.5.1",
     "typescript": "7.0.2",
-    "vitest": "^4.1.11",
-    "@workspace/eslint-config": "0.0.1",
-    "@workspace/typescript-config": "0.0.1"
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public"

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

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

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

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

package/dist/helpers/resolve-object-acl.d.ts

@@ -1,10 +0,0 @@
-import { type S3Client } from "@aws-sdk/client-s3";
-/**
- * Determines the ACL of an S3 object by querying `GetObjectAcl`.
- *
- * Returns `"public-read"` when the `AllUsers` grantee has `READ` or
- * `FULL_CONTROL` permission, `"private"` when ACL is resolvable but not public,
- * and `undefined` when ACL cannot be resolved (e.g. unsupported providers).
- */
-export declare function resolveObjectAcl(s3: S3Client, bucket: string, key: string, timeoutMs?: number): Promise<"public-read" | "private" | undefined>;
-//# sourceMappingURL=resolve-object-acl.d.ts.map

package/dist/helpers/resolve-object-acl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-object-acl.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-object-acl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIxE;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAsC,GAChD,OAAO,CAAC,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC,CAoBhD"}

package/dist/helpers/resolve-request-acl.d.ts

@@ -1,10 +0,0 @@
-import type { S3ObjectAcl } from "@dimah-s3/core";
-import type { AclPolicy } from "../types/config";
-export type { AclPolicy };
-/**
- * Resolve object ACL. Default is `private`. A server `acl` is forced.
- * Client `acl` is used only when `allowClientAcl` is set and no server ACL
- * is configured.
- */
-export declare function resolveRequestAcl(policy: AclPolicy | undefined, requested?: S3ObjectAcl): S3ObjectAcl;
-//# sourceMappingURL=resolve-request-acl.d.ts.map

package/dist/helpers/resolve-request-acl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-request-acl.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-request-acl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,SAAS,CAAC,EAAE,WAAW,GACtB,WAAW,CAIb"}