@dimah-s3/server 0.1.0

package/dist/procedures/multipart/part.d.ts

@@ -0,0 +1,12 @@
+import type { MultipartPartResponse } from "@dimah-s3/core";
+import type { DimahS3Config } from "../../types";
+export type MultipartSignPartInput = {
+    key: string;
+    uploadId: string;
+    partNumber: number;
+    partSize?: number;
+    bucket?: string;
+    expiresIn?: number;
+};
+export declare function multipartSignPart(config: DimahS3Config, input: MultipartSignPartInput, request: Request): Promise<MultipartPartResponse>;
+//# sourceMappingURL=part.d.ts.map

package/dist/procedures/multipart/part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../src/procedures/multipart/part.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,qBAAqB,CAAC,CAiDhC"}

package/dist/procedures/registry.d.ts

@@ -0,0 +1,78 @@
+import type { DimahS3Config } from "../types";
+/**
+ * Single source of truth for core procedures shared by the HTTP handler and
+ * direct `createServerApi`. Keys match {@link S3_API_ROUTES}.
+ */
+export type ProcedureEntry = {
+    /** Relative path under `basePath` (same as `S3_API_ROUTES` values). */
+    path: string;
+    method: "GET" | "POST" | "DELETE";
+    /** Optional HTTP status for successful JSON responses. */
+    status?: number;
+    /** Feature flag — disabled → 404 from both handler and `api`. */
+    isEnabled: (config: DimahS3Config) => boolean | undefined;
+    run: (config: DimahS3Config, input: unknown, request: Request) => Promise<unknown>;
+};
+export declare const PROCEDURE_REGISTRY: {
+    readonly upload: {
+        readonly path: "presign/upload";
+        readonly method: "POST";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").UploadPresignResponse>;
+    };
+    readonly uploadConfirm: {
+        readonly path: "presign/upload/confirm";
+        readonly method: "POST";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").UploadConfirmResponse>;
+    };
+    readonly download: {
+        readonly path: "presign/download";
+        readonly method: "GET";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").PresignResponse>;
+    };
+    readonly delete: {
+        readonly path: "delete";
+        readonly method: "DELETE";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").DeleteResponse>;
+    };
+    readonly multipartInit: {
+        readonly path: "presign/multipart/init";
+        readonly method: "POST";
+        readonly status: 201;
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").MultipartInitResponse>;
+    };
+    readonly multipartPart: {
+        readonly path: "presign/multipart/part";
+        readonly method: "POST";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").MultipartPartResponse>;
+    };
+    readonly multipartComplete: {
+        readonly path: "presign/multipart/complete";
+        readonly method: "POST";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").MultipartCompleteResponse>;
+    };
+    readonly multipartAbort: {
+        readonly path: "presign/multipart/abort";
+        readonly method: "POST";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").MultipartAbortResponse & {
+            bucket: string;
+            key: string;
+            uploadId: string;
+        }>;
+    };
+    readonly multipartListParts: {
+        readonly path: "presign/multipart/parts";
+        readonly method: "GET";
+        readonly isEnabled: (c: DimahS3Config) => boolean | undefined;
+        readonly run: (config: DimahS3Config, input: unknown, request: Request) => Promise<import("@dimah-s3/core").MultipartListPartsResponse>;
+    };
+};
+export type ProcedureKey = keyof typeof PROCEDURE_REGISTRY;
+//# sourceMappingURL=registry.d.ts.map

package/dist/procedures/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/procedures/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAW9C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,GAAG,SAAS,CAAC;IAC1D,GAAG,EAAE,CACH,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;yBAGnB,MAAM;;;;;;yBAON,MAAM;;;;;;yBAON,KAAK;;;;;;yBAOL,QAAQ;;;;;;yBAWR,MAAM;yBACN,GAAG;;;;;;yBAWH,MAAM;;;;;;yBAWN,MAAM;;;;;;yBAWN,MAAM;;;;;;;;;;yBAWN,KAAK;;;;CASsD,CAAC;AAExE,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/procedures/upload.d.ts

@@ -0,0 +1,14 @@
+import type { UploadPresignResponse } from "@dimah-s3/core";
+import type { DimahS3Config } from "../types";
+export type UploadInput = {
+    key: string;
+    contentType?: string;
+    fileSize?: number;
+    metadata?: Record<string, string>;
+    bucket?: string;
+    expiresIn?: number;
+    acl?: "private" | "public-read";
+    fileName?: string;
+};
+export declare function upload(config: DimahS3Config, input: UploadInput, request: Request): Promise<UploadPresignResponse>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/procedures/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/procedures/upload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAQ5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,qBAAqB,CAAC,CAgIhC"}

package/dist/types/config.d.ts

@@ -0,0 +1,87 @@
+import type { S3Client } from "@aws-sdk/client-s3";
+import type { UploadPresignMethod } from "@dimah-s3/core";
+import type { DeleteGuardContext, DeleteOnDeletedContext, DownloadOnPresignedContext, DownloadPresignGuardContext, GuardContext, MultipartAbortGuardContext, MultipartCompleteGuardContext, MultipartInitGuardContext, MultipartListGuardContext, MultipartOnAbortContext, MultipartOnCompleteContext, MultipartOnInitContext, MultipartOnListContext, MultipartPartGuardContext, UploadConfirmGuardContext, UploadOnConfirmedContext, UploadOnPresignedContext, UploadPresignGuardContext } from "./hook-contexts";
+import type { DimahS3Plugin } from "../plugin/types";
+/** Upload feature. Set `enabled: true` to activate. */
+export type UploadConfig = {
+    enabled?: boolean;
+    method?: UploadPresignMethod;
+    requireFileSize?: boolean;
+    presignGuard?: (context: UploadPresignGuardContext) => Promise<void> | void;
+    onPresigned?: (context: UploadOnPresignedContext) => Promise<void> | void;
+    confirmGuard?: (context: UploadConfirmGuardContext) => Promise<void> | void;
+    onConfirmed?: (context: UploadOnConfirmedContext) => Promise<void> | void;
+};
+/** Download feature. Set `enabled: true` to activate. */
+export type DownloadConfig = {
+    enabled?: boolean;
+    presignGuard?: (context: DownloadPresignGuardContext) => Promise<void> | void;
+    onPresigned?: (context: DownloadOnPresignedContext) => Promise<void> | void;
+};
+/** Delete feature. Set `enabled: true` to activate. */
+export type DeleteConfig = {
+    enabled?: boolean;
+    guard?: (context: DeleteGuardContext) => Promise<void> | void;
+    onDeleted?: (context: DeleteOnDeletedContext) => Promise<void> | void;
+};
+/** Multipart feature. Off unless you need large files. */
+export type MultipartConfig = {
+    enabled?: boolean;
+    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;
+};
+/**
+ * Options for {@link dimahS3}.
+ *
+ * @example
+ * ```ts
+ * export const s3 = dimahS3({
+ *   s3: s3Client,
+ *   defaultBucket: "my-bucket",
+ *   upload: { enabled: true },
+ * });
+ * ```
+ */
+export type DimahS3Config = {
+    /** AWS SDK v3 S3Client. */
+    s3: S3Client;
+    /** Bucket when the request omits one. */
+    defaultBucket: string;
+    /**
+     * API path prefix for the HTTP `handler`.
+     * Must match `createS3Client({ basePath })` on the client.
+     * @default "/api/s3"
+     */
+    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;
+    /** Runs before every operation. Throw to reject. */
+    guard?: (context: GuardContext) => Promise<void> | void;
+    upload?: UploadConfig;
+    download?: DownloadConfig;
+    delete?: DeleteConfig;
+    multipart?: 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]`).
+     */
+    plugins?: readonly DimahS3Plugin[];
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,147 @@
+import type { MultipartCompletedPartRef, MultipartPartInfo, S3ObjectAcl } from "@dimah-s3/core";
+/** Context for the global `guard` hook. */
+export type GuardContext = {
+    /** The incoming HTTP request. */
+    request: Request;
+};
+type ObjectContext = GuardContext & {
+    /** S3 object key. */
+    key: string;
+    /** Target bucket. */
+    bucket: string;
+};
+/** Context for `upload.presignGuard`. Client-declared values are not verified by S3. */
+export type UploadPresignGuardContext = ObjectContext & {
+    /** Declared MIME type. */
+    contentType?: string;
+    /** Declared size in bytes. */
+    fileSize?: number;
+    /** Custom object metadata. */
+    metadata?: Record<string, string>;
+    /** Requested ACL. */
+    acl?: S3ObjectAcl;
+    /** Original filename for `Content-Disposition`. */
+    fileName?: string;
+};
+/** Context for `upload.onPresigned`. */
+export type UploadOnPresignedContext = UploadPresignGuardContext & {
+    /** Presigned upload URL. */
+    url: string;
+    /** Validity in seconds. */
+    expiresIn: number;
+};
+/** Context for `upload.confirmGuard`. */
+export type UploadConfirmGuardContext = ObjectContext;
+/**
+ * Context for `upload.onConfirmed`.
+ * `contentLength` and `eTag` are verified by S3 via HeadObject.
+ */
+export type UploadOnConfirmedContext = GuardContext & {
+    /** S3 object key. */
+    key: string;
+    /** Target bucket. */
+    bucket: string;
+    /** MIME type from HeadObject. */
+    contentType?: string;
+    /** Verified size in bytes. */
+    contentLength: number;
+    /** 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;
+};
+/** @deprecated Use {@link UploadOnConfirmedContext}. */
+export type UploadOnUploadConfirmedContext = UploadOnConfirmedContext;
+/** Context for `download.presignGuard`. */
+export type DownloadPresignGuardContext = ObjectContext & {
+    /** Download filename for Content-Disposition. */
+    fileName?: string;
+};
+/** Context for `download.onPresigned`. */
+export type DownloadOnPresignedContext = DownloadPresignGuardContext & {
+    /** Presigned GET URL. */
+    url: string;
+    /** Validity in seconds. */
+    expiresIn: number;
+};
+/** Context for `delete.guard`. */
+export type DeleteGuardContext = ObjectContext;
+/** Context for `delete.onDeleted`. */
+export type DeleteOnDeletedContext = ObjectContext;
+/** Shared base for multipart operations that already have an upload id. */
+export type MultipartUploadContext = ObjectContext & {
+    /** 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;
+};
+/** @deprecated Use {@link MultipartInitGuardContext}. */
+export type MultipartGuardContext = MultipartInitGuardContext;
+/** Context for `multipart.partGuard`. */
+export type MultipartPartGuardContext = MultipartUploadContext & {
+    /** 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;
+    /** Declared MIME type. */
+    contentType?: string;
+    /** Custom object metadata. */
+    metadata?: Record<string, string>;
+    /** Requested ACL. */
+    acl?: S3ObjectAcl;
+    /** Original filename for `Content-Disposition`. */
+    fileName?: 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`. */
+export type MultipartOnAbortContext = MultipartUploadContext;
+/** Context for `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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,3 @@
+export type { GuardContext, UploadPresignGuardContext, UploadOnPresignedContext, UploadConfirmGuardContext, UploadOnConfirmedContext, UploadOnUploadConfirmedContext, DownloadPresignGuardContext, DownloadOnPresignedContext, DeleteGuardContext, DeleteOnDeletedContext, MultipartUploadContext, MultipartInitGuardContext, MultipartGuardContext, MultipartPartGuardContext, MultipartCompleteGuardContext, MultipartAbortGuardContext, MultipartListGuardContext, MultipartOnInitContext, MultipartOnCompleteContext, MultipartOnAbortContext, MultipartOnListContext, } from "./hook-contexts";
+export type { DimahS3Config, UploadConfig, DownloadConfig, DeleteConfig, MultipartConfig, } from "./config";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,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,iBAAiB,CAAC;AACzB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@dimah-s3/server",
+  "version": "0.1.0",
+  "description": "Presigned S3 server — dimahS3() with HTTP handler and direct api for upload, download, delete, and multipart",
+  "keywords": [
+    "s3",
+    "server",
+    "presigned-url",
+    "upload",
+    "download",
+    "multipart",
+    "framework-agnostic"
+  ],
+  "author": "Hamidrezakz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dimah-kz/dimah-s3.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/dimah-kz/dimah-s3/tree/main/packages/server",
+  "bugs": {
+    "url": "https://github.com/dimah-kz/dimah-s3/issues"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/adapters/next.d.ts",
+      "default": "./dist/adapters/next.js"
+    },
+    "./node": {
+      "types": "./dist/adapters/node.d.ts",
+      "default": "./dist/adapters/node.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aws-sdk/s3-presigned-post": "^3.1101.0",
+    "@aws-sdk/s3-request-presigner": "^3.1101.0",
+    "@dimah-s3/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": ">=3"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1101.0",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.0",
+    "tsc-alias": "^1.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "7.0.2",
+    "vitest": "^4.1.10",
+    "@workspace/typescript-config": "0.0.1",
+    "@workspace/eslint-config": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && tsc --emitDeclarationOnly && tsc-alias",
+    "lint": "eslint",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}