@dimah-s3/server 0.7.3 → 0.8.0

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,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,OAAO,CACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,gEAAgE;IAChE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,wFAAwF;IACxF,GAAG,EAAE,KAAK,CAAC;IACX,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,wCAAwC;IACxC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CACtD,GAAG,CAAC,CAAC;AAEN;;;;;;;;;;;;;;;;;;GAkBG;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,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAgB9B"}
+{"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"}

package/dist/errors.d.ts

@@ -1,34 +1,20 @@
-import { DimahS3Error, type S3ErrorCode } from "@dimah-s3/core";
-export { DimahS3Error };
+import { DimahS3Error, isAPIError, isDimahS3Error, isS3ErrorCode } from "@dimah-s3/core";
+export { DimahS3Error, isAPIError, isDimahS3Error, isS3ErrorCode };
 /** English API errors with stable codes for client-side localization. */
 export declare const errors: {
     readonly notFound: () => DimahS3Error;
-    readonly invalidJson: () => DimahS3Error;
+    readonly unauthorized: () => DimahS3Error;
     readonly forbidden: () => DimahS3Error;
+    readonly conflict: () => DimahS3Error;
     readonly internalError: () => DimahS3Error;
     readonly objectNotFound: () => DimahS3Error;
+    readonly featureDisabled: (feature: string) => DimahS3Error;
+    readonly invalidKey: () => DimahS3Error;
+    readonly invalidBucket: (bucket: string) => DimahS3Error;
     readonly s3NetworkError: (code: string) => DimahS3Error;
-    readonly fieldRequired: (name: string) => DimahS3Error;
-    /** Missing `key` on query-string routes (download / delete / list-parts). */
-    readonly keyRequired: () => DimahS3Error;
-    readonly uploadIdRequired: () => DimahS3Error;
-    readonly partNumberInvalid: () => DimahS3Error;
-    readonly partsRequired: () => DimahS3Error;
     readonly fileSizeRequiredUpload: () => DimahS3Error;
     readonly fileSizeRequiredMultipart: () => DimahS3Error;
+    readonly validationError: (message: string) => DimahS3Error;
 };
 export type ServerErrors = typeof errors;
-/** Trim and require a non-empty string; throws {@link errors.fieldRequired}. */
-export declare function requireString(value: unknown, name: string): string;
-/**
- * Convert hook/S3 throws into {@link DimahS3Error}.
- *
- * - Existing {@link DimahS3Error} instances are preserved (including subclasses).
- * - Plain `Error`s keep their message; `code` is only applied when provided
- *   (omit it so clients show the custom English message instead of a mapped
- *   library string).
- */
-export declare function toDimahS3Error(err: unknown, fallbackMessage: string, fallbackStatus?: number, options?: {
-    code?: S3ErrorCode | string;
-}): DimahS3Error;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,yEAAyE;AACzE,eAAO,MAAM,MAAM;aACjB,QAAQ;aAGR,WAAW;aAKX,SAAS;aAGT,aAAa;aAKb,cAAc;aAKd,cAAc,SAAS,MAAM;aAO7B,aAAa,SAAS,MAAM;IAM5B,6EAA6E;aAC7E,WAAW;aAKX,gBAAgB;aAKhB,iBAAiB;aAKjB,aAAa;aAKb,sBAAsB;aAOtB,yBAAyB;CAMjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC;AAEzC,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlE;AAQD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,MAAM,EACvB,cAAc,SAAM,EACpB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,GACxC,YAAY,CAWd"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,UAAU,EACV,cAAc,EACd,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAEnE,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,eAAe,YAAY,MAAM;CAKzB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC"}

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

@@ -0,0 +1,51 @@
+import type { DownloadConfig, DeleteConfig, FeatureToggle, KeyPrefix, MultipartConfig, ResolvedDimahS3Config, ResolveKeyContext, UploadConfig } from "../types";
+type KeyPolicy = {
+    prefix?: KeyPrefix;
+    resolveKey?: (context: ResolveKeyContext) => string | Promise<string>;
+};
+/**
+ * Normalize a client-proposed 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<{
+    key: string;
+    bucket: string;
+}>;
+export declare function normalizeFeature<T extends {
+    enabled?: boolean;
+}>(value: FeatureToggle<T> | undefined): (T & {
+    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;
+    };
+};
+export declare function normalizeFeatures(config: {
+    upload?: FeatureToggle<UploadConfig>;
+    download?: FeatureToggle<DownloadConfig>;
+    delete?: FeatureToggle<DeleteConfig>;
+    multipart?: FeatureToggle<MultipartConfig>;
+}): NormalizedFeatures;
+export {};
+//# sourceMappingURL=resolve-target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target.d.ts","sourceRoot":"","sources":["../../src/helpers/resolve-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,KAAK,SAAS,GAAG;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE,CAAC;AAEF;;;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;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9D,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,CAmBvB;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"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export { dimahS3 } from "./dimah-s3";
-export type { DimahS3 } from "./dimah-s3";
-export { DimahS3Error, errors } from "./errors";
+export type { DimahS3, DimahS3Api, MultipartAliasApi } from "./dimah-s3";
+export { DimahS3Error, errors, isAPIError, isDimahS3Error, isS3ErrorCode, } from "./errors";
 export type { ServerErrors } from "./errors";
 export { resolveObjectAcl } from "./helpers/resolve-object-acl";
-export { applyPlugins, chainHooks, createEndpoint, definePlugin, FEATURE_HOOK_KEYS, RESERVED_PLUGIN_IDS, } from "./plugin";
-export type { AppliedPlugins, DimahS3Plugin, DimahS3PluginHooks, FeatureName, PluginContextMap, PluginEndpoint, PluginEndpointContext, PluginInitEnv, ReservedPluginId, ResolvedPluginEndpoint, } from "./plugin";
-export type { DimahS3Config, UploadConfig, DownloadConfig, DeleteConfig, MultipartConfig, GuardContext, UploadPresignGuardContext, UploadOnPresignedContext, UploadConfirmGuardContext, UploadOnConfirmedContext, UploadOnUploadConfirmedContext, DownloadPresignGuardContext, DownloadOnPresignedContext, DeleteGuardContext, DeleteOnDeletedContext, MultipartUploadContext, MultipartInitGuardContext, MultipartGuardContext, MultipartPartGuardContext, MultipartCompleteGuardContext, MultipartAbortGuardContext, MultipartListGuardContext, MultipartOnInitContext, MultipartOnCompleteContext, MultipartOnAbortContext, MultipartOnListContext, } from "./types";
+export { createS3Endpoint, createS3Middleware } from "./api";
+export type { S3EndpointContext } from "./api";
+export { definePlugin } from "./plugin";
+export type { DimahS3Plugin, DimahS3PluginHooks, PluginContextMap, PluginEndpointMap, PluginInitEnv, } from "./plugin";
+export type { DimahS3Config, DownloadConfig, DeleteConfig, FeatureToggle, KeyPrefix, MultipartConfig, ResolvedDimahS3Config, UploadConfig, } 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,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GACvB,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,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACL,YAAY,EACZ,MAAM,EACN,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,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,eAAe,EACf,qBAAqB,EACrB,YAAY,GACb,MAAM,SAAS,CAAC"}