@dimah-s3/server 1.0.1 → 1.1.0

package/dist/types/config.d.ts

@@ -1,87 +1,181 @@
 import type { S3Client } from "@aws-sdk/client-s3";
 import type { S3ObjectAcl, UploadPresignMethod } from "@dimah-s3/core";
-import type { DeleteGuardContext, DeleteOnDeletedContext, DownloadOnPresignedContext, DownloadPresignGuardContext, GuardContext, MultipartAbortGuardContext, MultipartCompleteGuardContext, MultipartInitGuardContext, MultipartListGuardContext, MultipartOnAbortContext, MultipartOnCompleteContext, MultipartOnInitContext, MultipartOnListContext, MultipartPartGuardContext, ResolveKeyContext, UploadConfirmGuardContext, UploadOnConfirmedContext, UploadOnPresignedContext, UploadPresignGuardContext } from "./hook-contexts";
+import type { DeleteGuardContext, DeleteOnDeletedContext, DownloadGuardContext, DownloadOnPresignedContext, DownloadResolveInfo, GuardContext, MultipartGuardContext, MultipartOnAbortContext, MultipartOnInitContext, MultipartOnListContext, RouteGuardContext, UploadConfirmGuardContext, UploadGuardContext, UploadObjectContext, UploadObjectInfo, UploadOnConfirmedContext, UploadOnPresignedContext } from "./hook-contexts";
 import type { DimahS3Plugin } from "../plugin/types";
-export type { ResolveKeyContext };
-/** String prefix or async factory used by {@link resolveObjectKey}. */
-export type KeyPrefix = string | ((context: ResolveKeyContext) => string | Promise<string>);
-export type KeyPolicy = {
+export type { UploadObjectContext, UploadObjectInfo, DownloadResolveInfo };
+/** The three nested features on a named route. */
+export declare const ROUTE_FEATURES: readonly ["upload", "download", "delete"];
+export type RouteFeature = (typeof ROUTE_FEATURES)[number];
+/**
+ * Endpoint operations. Multipart is nested under upload — it is not a
+ * fourth route feature.
+ */
+export declare const ROUTE_OPERATIONS: readonly ["upload", "download", "delete", "multipart"];
+export type RouteOperation = (typeof ROUTE_OPERATIONS)[number];
+/** `true` or an options object enables the feature; omit or `false` disables it. */
+export type FeatureToggle<T> = boolean | T;
+/** Optional structured logger on {@link DimahS3Config}. */
+export type DimahS3Logger = {
+    debug?: (message: string, ...args: unknown[]) => void;
+    info?: (message: string, ...args: unknown[]) => void;
+    warn?: (message: string, ...args: unknown[]) => void;
+    error?: (message: string, ...args: unknown[]) => void;
+};
+export type DisabledFeature = {
+    enabled: false;
+};
+export type EnabledFeature<T extends object> = T & {
+    enabled: true;
+};
+export type ResolvedFeature<T extends object> = EnabledFeature<T> | DisabledFeature;
+/**
+ * Multipart-only hooks. Init shares `upload.guard` / `onInit`. Complete
+ * runs `guard` (`action: "complete"`) then `upload.confirmGuard` /
+ * `upload.onConfirmed`.
+ */
+export type MultipartConfig = {
+    /** After `CreateMultipartUpload` — persist `uploadId` for resume. */
+    onInit?: (context: MultipartOnInitContext) => Promise<void> | void;
+    /** Authorize part, list, abort, and complete. Branch on `action` if needed. */
+    guard?: (context: MultipartGuardContext) => Promise<void> | void;
+    onAbort?: (context: MultipartOnAbortContext) => Promise<void> | void;
+    onList?: (context: MultipartOnListContext) => Promise<void> | void;
+};
+/** Upload feature: constraints, object identity, and lifecycle hooks. */
+export type UploadConfig = {
+    /** HTML `accept` tokens (`image/*`, `.pdf`, `application/pdf`). */
+    fileTypes?: string[];
     /**
-     * Prepended to the client-proposed key. Already-prefixed keys are left
-     * unchanged so confirm / download of the stored key still work.
+     * Max declared size, signed part size, listed multipart total, and
+     * HeadObject size in bytes.
      */
-    prefix?: KeyPrefix;
-    /** Full control over the object key. Wins over {@link prefix}. */
-    resolveKey?: (context: ResolveKeyContext) => string | Promise<string>;
-};
-export type AclPolicy = {
+    maxFileSize?: number;
     /**
-     * Server-forced ACL. When set, the client `acl` is ignored.
-     * @default "private" (when omitted)
+     * Server-owned object identity. Return `folder` for a directory under
+     * the route `keyPrefix`, `key` for the rest of the key (also nested
+     * under `keyPrefix`), plus optional S3 `metadata` and `acl`.
+     * Runs on upload / multipart init only. Default key is
+     * `{keyPrefix}/{uuid}/{name}` (`keyPrefix` defaults to the route name).
+     * `keyPrefix: false` generates `{uuid}/{name}` and skips the follow-up
+     * namespace check.
      */
-    acl?: S3ObjectAcl;
+    object?: (context: UploadObjectContext) => UploadObjectInfo | void | Promise<UploadObjectInfo | void>;
     /**
-     * Honor a client-sent `acl` (`private` | `public-read`). Off by default —
-     * uploads are `private` unless {@link acl} is set.
+     * Server-forced ACL when `object` does not return one.
+     * @default "private"
      */
-    allowClientAcl?: boolean;
-};
-/** Upload feature. A config object (or `true`) enables the feature. */
-export type UploadConfig = KeyPolicy & AclPolicy & {
+    acl?: S3ObjectAcl;
+    /** Presign verb. Use `"PUT"` on R2 (no Presigned POST). @default "POST" */
     method?: UploadPresignMethod;
-    requireFileSize?: boolean;
-    guard?: (context: UploadPresignGuardContext) => Promise<void> | void;
+    /** Presign TTL in seconds. Clamped by instance `maxExpiresIn`. */
+    expiresIn?: number;
+    /**
+     * Require a SHA-256 `checksum` on the presign body and lock it into the
+     * signed PUT/POST.
+     */
+    checksum?: boolean;
+    /**
+     * Overwrite an existing object at the resolved key without flipping a
+     * `db()` row from `active` to `pending` during the new upload.
+     */
+    replace?: "overwrite";
+    /** Presign and multipart init. */
+    guard?: (context: UploadGuardContext) => Promise<void> | void;
+    /** After a single-shot URL is signed. Multipart uses `multipart.onInit`. */
     onPresigned?: (context: UploadOnPresignedContext) => Promise<void> | void;
+    /** Confirm and multipart complete. */
     confirmGuard?: (context: UploadConfirmGuardContext) => Promise<void> | void;
+    /** After HeadObject on confirm and multipart complete. */
     onConfirmed?: (context: UploadOnConfirmedContext) => Promise<void> | void;
+    /** Opt-in multipart. Default off. */
+    multipart?: FeatureToggle<MultipartConfig>;
 };
 /** Download feature. A config object (or `true`) enables the feature. */
-export type DownloadConfig = KeyPolicy & {
-    guard?: (context: DownloadPresignGuardContext) => Promise<void> | void;
+export type DownloadConfig = {
+    /**
+     * Presign TTL in seconds. Defaults to `S3_DEFAULT_EXPIRES_IN` (600).
+     * Independent of {@link UploadConfig.expiresIn}.
+     */
+    expiresIn?: number;
+    /**
+     * Default Content-Disposition. @default "attachment"
+     */
+    disposition?: "inline" | "attachment";
+    /**
+     * `"presign"` (default) returns an S3 URL. `"proxy"` returns a
+     * same-origin `/file` URL that streams through the server.
+     */
+    mode?: "presign" | "proxy";
+    /**
+     * Per-request download options. Return values override route defaults.
+     * The client `disposition` / `fileName` query is a fallback.
+     */
+    resolve?: (context: DownloadGuardContext) => DownloadResolveInfo | void | Promise<DownloadResolveInfo | void>;
+    guard?: (context: DownloadGuardContext) => Promise<void> | void;
     onPresigned?: (context: DownloadOnPresignedContext) => Promise<void> | void;
 };
 /** Delete feature. A config object (or `true`) enables the feature. */
-export type DeleteConfig = KeyPolicy & {
+export type DeleteConfig = {
     guard?: (context: DeleteGuardContext) => Promise<void> | void;
     onDeleted?: (context: DeleteOnDeletedContext) => Promise<void> | void;
 };
-/** Multipart feature. On automatically when upload is on, unless set to `false`. */
-export type MultipartConfig = KeyPolicy & AclPolicy & {
-    requireFileSize?: boolean;
-    initGuard?: (context: MultipartInitGuardContext) => Promise<void> | void;
-    partGuard?: (context: MultipartPartGuardContext) => Promise<void> | void;
-    completeGuard?: (context: MultipartCompleteGuardContext) => Promise<void> | void;
-    abortGuard?: (context: MultipartAbortGuardContext) => Promise<void> | void;
-    listGuard?: (context: MultipartListGuardContext) => Promise<void> | void;
-    onInit?: (context: MultipartOnInitContext) => Promise<void> | void;
-    onComplete?: (context: MultipartOnCompleteContext) => Promise<void> | void;
-    onAbort?: (context: MultipartOnAbortContext) => Promise<void> | void;
-    onList?: (context: MultipartOnListContext) => Promise<void> | void;
+/**
+ * Named file route — a mini {@link DimahS3Config} under `routes`.
+ * Upload, download, delete, and `upload.multipart` are off until set.
+ * Prefer one feature per route; combine only when those callers share
+ * the key namespace.
+ */
+export type DimahS3RouteConfig = {
+    /** Override the instance S3 client for this route. */
+    client?: S3Client;
+    /** Override the instance bucket for this route. */
+    bucket?: string;
+    /**
+     * Object-key namespace. Generated keys and follow-up ops (confirm,
+     * download, delete, multipart) must stay under it.
+     * Defaults to the route name. `false` disables the bound.
+     */
+    keyPrefix?: string | false;
+    /** Runs before every operation on this route. */
+    guard?: (context: RouteGuardContext) => Promise<void> | void;
+    /**
+     * Opt out of instance plugins by id (`{ db: false }`).
+     * Hooks from opted-out plugins are not merged onto this route.
+     */
+    plugins?: {
+        readonly [pluginId: string]: false;
+    };
+    upload?: FeatureToggle<UploadConfig>;
+    download?: FeatureToggle<DownloadConfig>;
+    delete?: FeatureToggle<DeleteConfig>;
 };
-/** `true` or an options object enables the feature; omit or `false` disables it. */
-export type FeatureToggle<T> = boolean | T;
 /**
  * Options for {@link dimahS3}.
  *
  * @example
  * ```ts
- * export const awsS3 = new S3Client({ ... });
  * export const s3 = dimahS3({
  *   client: awsS3,
  *   bucket: "my-bucket",
- *   upload: true,
+ *   routes: {
+ *     uploads: route({
+ *       upload: { fileTypes: ["image/*"], multipart: true },
+ *     }),
+ *   },
  * });
  * ```
  */
 export type DimahS3Config = {
-    /** AWS SDK v3 `S3Client`. Export it as `awsS3` so scripts and a custom backend can reuse it. */
-    client: S3Client;
     /**
-     * Default bucket. Used when the request omits `bucket`, and whenever a
-     * client-sent bucket is ignored (the default). Hooks may still send
-     * `bucket`; it only wins with {@link allowClientBucket} or {@link buckets}.
+     * Default AWS SDK v3 `S3Client`. Required unless every route sets
+     * {@link DimahS3RouteConfig.client}.
      */
-    bucket: string;
+    client?: S3Client;
+    /**
+     * Default bucket. Required unless every route sets
+     * {@link DimahS3RouteConfig.bucket}.
+     */
+    bucket?: string;
     /**
      * API path prefix for the HTTP `handler`.
      * Must match `createS3Client({ basePath })` on the client.
@@ -89,56 +183,67 @@ export type DimahS3Config = {
      */
     basePath?: string;
     /**
-     * When enabled, confirmation procedures call GetObjectAcl to infer whether
-     * the object is public-read or private.
-     *
-     * Keep disabled unless you need ACL inference in responses/hooks —
-     * it adds one extra S3 request per upload confirmation.
-     *
-     * @default false
-     */
-    resolveObjectAcl?: boolean;
-    /**
-     * Allow the client to pick any bucket. Off by default — the request `bucket`
-     * is ignored and {@link bucket} is used.
-     *
-     * Mutually exclusive with {@link buckets}.
-     */
-    allowClientBucket?: boolean;
-    /**
-     * Allowlist of buckets the client may send. When set, a request bucket
-     * outside this list is rejected. {@link bucket} should be included.
-     *
-     * Mutually exclusive with {@link allowClientBucket}.
-     */
-    buckets?: string[];
-    /**
-     * Upper bound for client `expiresIn` (seconds). Requests above this are
-     * clamped. The protocol maximum is 7 days (604800).
+     * Upper bound for `upload.expiresIn` and `download.expiresIn` (seconds).
+     * The protocol maximum is 7 days (604800).
      * @default 604800
      */
     maxExpiresIn?: number;
-    /** Runs before every operation. Throw to reject. */
+    /**
+     * Structured logs for lifecycle failures and unmatched router errors.
+     * `false` silences the default `console.error`.
+     */
+    logger?: DimahS3Logger | false;
+    /** Called after an unexpected throw is mapped to `INTERNAL_ERROR`. */
+    onError?: (error: unknown, context: {
+        request?: Request;
+    }) => void;
+    /** Runs before every operation, before route lookup. Throw to reject. */
     guard?: (context: GuardContext) => Promise<void> | void;
-    upload?: FeatureToggle<UploadConfig>;
-    download?: FeatureToggle<DownloadConfig>;
-    delete?: FeatureToggle<DeleteConfig>;
-    multipart?: FeatureToggle<MultipartConfig>;
     /**
      * Optional server plugins (e.g. `db()` from `@dimah-s3/db`).
-     * Plugin hooks merge ahead of user hooks; contexts land on `s3.context[id]`
-     * and are flattened onto the instance (`s3[id]`).
+     * Plugin hooks merge onto each route unless the route opts out.
      */
     plugins?: readonly DimahS3Plugin[];
+    /** Named file routes. At least one is required. */
+    routes: Record<string, DimahS3RouteConfig>;
+};
+type UploadFields = Omit<UploadConfig, "multipart">;
+export type EnabledUploadConfig = EnabledFeature<UploadFields> & {
+    multipart: ResolvedFeature<MultipartConfig>;
 };
-type ResolvedFeature<T> = T & {
-    enabled: boolean;
+export type ResolvedUploadConfig = EnabledUploadConfig | (DisabledFeature & {
+    multipart: DisabledFeature;
+});
+/** One named route after {@link dimahS3} normalizes toggles and plugin hooks. */
+export type ResolvedRoute = {
+    name: string;
+    client: S3Client;
+    bucket: string;
+    /** `false` means follow-up keys are not namespace-checked. */
+    keyPrefix: string | false;
+    guard?: DimahS3RouteConfig["guard"];
+    skippedPluginIds: ReadonlySet<string>;
+    upload: ResolvedUploadConfig;
+    download: ResolvedFeature<DownloadConfig>;
+    delete: ResolvedFeature<DeleteConfig>;
 };
-/** Feature flags after {@link dimahS3} normalizes booleans and defaults. */
-export type ResolvedDimahS3Config = Omit<DimahS3Config, "upload" | "download" | "delete" | "multipart" | "plugins"> & {
-    upload?: ResolvedFeature<UploadConfig>;
-    download?: ResolvedFeature<DownloadConfig>;
-    delete?: ResolvedFeature<DeleteConfig>;
-    multipart?: ResolvedFeature<MultipartConfig>;
+/**
+ * A {@link ResolvedRoute} after the named operation has been asserted on.
+ * `route.upload.fileTypes` is typed as present only after opening `"upload"`.
+ */
+export type OpenedRoute<F extends RouteOperation> = F extends "multipart" ? ResolvedRoute & {
+    upload: EnabledUploadConfig & {
+        multipart: EnabledFeature<MultipartConfig>;
+    };
+} : F extends "upload" ? ResolvedRoute & {
+    upload: EnabledUploadConfig;
+} : F extends "download" ? ResolvedRoute & {
+    download: EnabledFeature<DownloadConfig>;
+} : F extends "delete" ? ResolvedRoute & {
+    delete: EnabledFeature<DeleteConfig>;
+} : never;
+/** Instance config after {@link dimahS3} normalizes routes and plugins. */
+export type ResolvedDimahS3Config = Omit<DimahS3Config, "routes" | "plugins"> & {
+    routes: Record<string, ResolvedRoute>;
 };
 //# sourceMappingURL=config.d.ts.map

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

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

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

@@ -1,55 +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;
 };
-/** Input to `prefix` / `resolveKey` on a feature config. */
-export type ResolveKeyContext = {
+/** Declared file on upload / multipart init. */
+export type ObjectFile = {
+    name: string;
+    size?: number;
+    type?: string;
+};
+/**
+ * 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 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.onPresigned`. */
-export type UploadOnPresignedContext = UploadPresignGuardContext & {
+/**
+ * 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` (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`. */
@@ -58,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;
@@ -66,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