@m5kdev/backend 0.7.0 → 0.8.2

package/dist/src/modules/file/file.service.d.mts

@@ -0,0 +1,30 @@
+import { ServerResult, ServerResultAsync } from "../base/base.dto.mjs";
+import { BaseService } from "../base/base.service.mjs";
+import { FileRepository } from "./file.repository.mjs";
+import * as _$_aws_sdk_client_s30 from "@aws-sdk/client-s3";
+import { fileTypes } from "@m5kdev/commons/modules/file/file.constants";
+
+//#region src/modules/file/file.service.d.ts
+declare class FileService extends BaseService<{
+  file: FileRepository;
+}, never> {
+  isS3Path(path: string): boolean;
+  parseS3Path(S3Path: string): ServerResult<{
+    bucket: string;
+    path: string;
+  }>;
+  wrapS3Path(path: string, bucket: string): string;
+  getS3UploadUrl(filename: string, filetype: string, expiresIn?: number): ServerResultAsync<string>;
+  getS3DownloadUrl(path: string, expiresIn?: number): ServerResultAsync<string>;
+  getS3Object(path: string): ServerResultAsync<_$_aws_sdk_client_s30.GetObjectCommandOutput>;
+  deleteS3Object(path: string): ServerResultAsync<void>;
+  uploadFileToS3(localPath: string, returnDownloadUrl?: boolean): ServerResultAsync<string>;
+  downloadS3ToFile(s3Path: string): ServerResultAsync<string>;
+  getFileType(path: string): {
+    fileType: keyof typeof fileTypes;
+    extension: string;
+  } | undefined;
+}
+//#endregion
+export { FileService };
+//# sourceMappingURL=file.service.d.mts.map

package/dist/src/modules/file/file.service.mjs

@@ -0,0 +1,117 @@
+import { BaseService } from "../base/base.service.mjs";
+import { err, ok } from "neverthrow";
+import { v4 } from "uuid";
+import path, { dirname } from "node:path";
+import { fileTypes } from "@m5kdev/commons/modules/file/file.constants";
+import { createWriteStream } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+//#region src/modules/file/file.service.ts
+var FileService = class extends BaseService {
+	isS3Path(path) {
+		return path.startsWith("s3::");
+	}
+	parseS3Path(S3Path) {
+		if (!this.isS3Path(S3Path)) return this.error("BAD_REQUEST", "Invalid S3 path");
+		const [bucket, path] = S3Path.split("s3::")[1].split("//");
+		return ok({
+			bucket,
+			path
+		});
+	}
+	wrapS3Path(path, bucket) {
+		return `s3::${bucket}//${path}`;
+	}
+	getS3UploadUrl(filename, filetype, expiresIn = 300) {
+		return this.repository.file.getS3UploadUrl(filename, filetype, expiresIn);
+	}
+	getS3DownloadUrl(path, expiresIn = 300) {
+		return this.repository.file.getS3DownloadUrl(path, expiresIn);
+	}
+	getS3Object(path) {
+		return this.repository.file.getS3Object(path);
+	}
+	deleteS3Object(path) {
+		return this.repository.file.deleteS3Object(path);
+	}
+	async uploadFileToS3(localPath, returnDownloadUrl = false) {
+		return this.throwableAsync(async () => {
+			const extension = localPath.split(".").pop()?.toLowerCase();
+			const filename = `${v4()}${extension ? `.${extension}` : ""}`;
+			const filetype = extension && {
+				jpg: "image/jpeg",
+				jpeg: "image/jpeg",
+				png: "image/png",
+				webp: "image/webp",
+				mp4: "video/mp4",
+				mov: "video/mov",
+				avi: "video/avi",
+				mkv: "video/mkv",
+				webm: "video/webm",
+				mp3: "audio/mp3",
+				wav: "audio/wav",
+				m4a: "audio/m4a"
+			}[extension] || "application/octet-stream";
+			const presigned = await this.getS3UploadUrl(filename, filetype);
+			if (presigned.isErr()) return err(presigned.error);
+			const file = await readFile(localPath);
+			const res = await fetch(presigned.value, {
+				method: "PUT",
+				body: file,
+				headers: { "Content-Type": filetype }
+			});
+			if (!res.ok) return this.error("INTERNAL_SERVER_ERROR", `Failed to upload to S3: ${res.status}`);
+			if (returnDownloadUrl) {
+				const downloadUrl = await this.getS3DownloadUrl(filename);
+				if (downloadUrl.isErr()) return err(downloadUrl.error);
+				return ok(downloadUrl.value);
+			}
+			return ok(filename);
+		});
+	}
+	async downloadS3ToFile(s3Path) {
+		return this.throwableAsync(async () => {
+			const extension = s3Path.split(".").pop();
+			const destinationPath = path.join(tmpdir(), "s3-downloads", `${v4()}${extension ? `.${extension}` : ""}`);
+			const result = await this.repository.file.getS3Object(s3Path);
+			if (result.isErr()) return err(result.error);
+			const body = result.value.Body;
+			if (!body) return this.error("NOT_FOUND", "S3 object body is empty");
+			await mkdir(dirname(destinationPath), { recursive: true });
+			if (typeof body === "object" && "transformToByteArray" in body && typeof body.transformToByteArray === "function") {
+				await writeFile(destinationPath, await body.transformToByteArray());
+				return ok(destinationPath);
+			}
+			const writeStream = createWriteStream(destinationPath);
+			let input = null;
+			const unknownBody = body;
+			if (typeof unknownBody === "object" && unknownBody !== null && "pipe" in unknownBody && typeof unknownBody.pipe === "function") input = unknownBody;
+			else if (typeof unknownBody === "object" && unknownBody !== null && "getReader" in unknownBody && typeof unknownBody.getReader === "function") input = Readable.fromWeb(unknownBody);
+			else if (typeof unknownBody === "object" && unknownBody !== null && "stream" in unknownBody && typeof unknownBody.stream === "function") input = Readable.fromWeb(unknownBody.stream());
+			if (input) {
+				await pipeline(input, writeStream);
+				return ok(destinationPath);
+			}
+			if (typeof unknownBody === "object" && unknownBody !== null && "arrayBuffer" in unknownBody && typeof unknownBody.arrayBuffer === "function") {
+				const buffer = Buffer.from(await unknownBody.arrayBuffer());
+				await pipeline(Readable.from(buffer), writeStream);
+				return ok(destinationPath);
+			}
+			return this.error("INTERNAL_SERVER_ERROR", "Unsupported S3 body type");
+		});
+	}
+	getFileType(path) {
+		const extension = path.split(".").pop();
+		if (!extension) return void 0;
+		for (const [key, value] of Object.entries(fileTypes)) if (value.extensions.includes(extension)) return {
+			fileType: key,
+			extension
+		};
+	}
+};
+//#endregion
+export { FileService };
+
+//# sourceMappingURL=file.service.mjs.map

package/dist/src/modules/file/file.service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.service.mjs","names":["uuidv4"],"sources":["../../../../src/modules/file/file.service.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\r\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\r\nimport { tmpdir } from \"node:os\";\r\nimport path, { dirname } from \"node:path\";\r\nimport { Readable } from \"node:stream\";\r\nimport { pipeline } from \"node:stream/promises\";\r\nimport { fileTypes } from \"@m5kdev/commons/modules/file/file.constants\";\r\nimport { err, ok } from \"neverthrow\";\r\nimport { v4 as uuidv4 } from \"uuid\";\r\nimport type { ServerResult, ServerResultAsync } from \"../base/base.dto\";\r\nimport { BaseService } from \"../base/base.service\";\r\nimport type { FileRepository } from \"./file.repository\";\r\n\r\nexport class FileService extends BaseService<{ file: FileRepository }, never> {\r\n  isS3Path(path: string): boolean {\r\n    return path.startsWith(\"s3::\");\r\n  }\r\n\r\n  parseS3Path(S3Path: string): ServerResult<{ bucket: string; path: string }> {\r\n    if (!this.isS3Path(S3Path)) {\r\n      return this.error(\"BAD_REQUEST\", \"Invalid S3 path\");\r\n    }\r\n    const [bucket, path] = S3Path.split(\"s3::\")[1].split(\"//\");\r\n    return ok({ bucket, path });\r\n  }\r\n\r\n  wrapS3Path(path: string, bucket: string): string {\r\n    return `s3::${bucket}//${path}`;\r\n  }\r\n\r\n  getS3UploadUrl(\r\n    filename: string,\r\n    filetype: string,\r\n    expiresIn = 60 * 5\r\n  ): ServerResultAsync<string> {\r\n    return this.repository.file.getS3UploadUrl(filename, filetype, expiresIn);\r\n  }\r\n\r\n  getS3DownloadUrl(path: string, expiresIn = 60 * 5): ServerResultAsync<string> {\r\n    return this.repository.file.getS3DownloadUrl(path, expiresIn);\r\n  }\r\n\r\n  getS3Object(path: string) {\r\n    return this.repository.file.getS3Object(path);\r\n  }\r\n\r\n  deleteS3Object(path: string) {\r\n    return this.repository.file.deleteS3Object(path);\r\n  }\r\n\r\n  async uploadFileToS3(localPath: string, returnDownloadUrl = false): ServerResultAsync<string> {\r\n    return this.throwableAsync(async () => {\r\n      const extension = localPath.split(\".\").pop()?.toLowerCase();\r\n      const filename = `${uuidv4()}${extension ? `.${extension}` : \"\"}`;\r\n\r\n      const mimeByExt: Record<string, string> = {\r\n        jpg: \"image/jpeg\",\r\n        jpeg: \"image/jpeg\",\r\n        png: \"image/png\",\r\n        webp: \"image/webp\",\r\n        mp4: \"video/mp4\",\r\n        mov: \"video/mov\",\r\n        avi: \"video/avi\",\r\n        mkv: \"video/mkv\",\r\n        webm: \"video/webm\",\r\n        mp3: \"audio/mp3\",\r\n        wav: \"audio/wav\",\r\n        m4a: \"audio/m4a\",\r\n      };\r\n      const filetype = (extension && mimeByExt[extension]) || \"application/octet-stream\";\r\n\r\n      const presigned = await this.getS3UploadUrl(filename, filetype);\r\n      if (presigned.isErr()) return err(presigned.error);\r\n\r\n      const file = await readFile(localPath);\r\n      const res = await fetch(presigned.value, {\r\n        method: \"PUT\",\r\n        body: file,\r\n        headers: { \"Content-Type\": filetype },\r\n      });\r\n      if (!res.ok) {\r\n        return this.error(\"INTERNAL_SERVER_ERROR\", `Failed to upload to S3: ${res.status}`);\r\n      }\r\n      if (returnDownloadUrl) {\r\n        const downloadUrl = await this.getS3DownloadUrl(filename);\r\n        if (downloadUrl.isErr()) return err(downloadUrl.error);\r\n        return ok(downloadUrl.value);\r\n      }\r\n\r\n      return ok(filename);\r\n    });\r\n  }\r\n\r\n  async downloadS3ToFile(s3Path: string): ServerResultAsync<string> {\r\n    return this.throwableAsync(async () => {\r\n      const extension = s3Path.split(\".\").pop();\r\n      const destinationPath = path.join(\r\n        tmpdir(),\r\n        \"s3-downloads\",\r\n        `${uuidv4()}${extension ? `.${extension}` : \"\"}`\r\n      );\r\n\r\n      const result = await this.repository.file.getS3Object(s3Path);\r\n      if (result.isErr()) return err(result.error);\r\n\r\n      const body = result.value.Body;\r\n      if (!body) return this.error(\"NOT_FOUND\", \"S3 object body is empty\");\r\n\r\n      await mkdir(dirname(destinationPath), { recursive: true });\r\n\r\n      // AWS SDK v3 SdkStream has transformToByteArray method - use it for reliable handling\r\n      if (\r\n        typeof body === \"object\" &&\r\n        \"transformToByteArray\" in body &&\r\n        typeof body.transformToByteArray === \"function\"\r\n      ) {\r\n        const bytes = await body.transformToByteArray();\r\n        await writeFile(destinationPath, bytes);\r\n        return ok(destinationPath);\r\n      }\r\n\r\n      // Fallback: try streaming approaches\r\n      const writeStream = createWriteStream(destinationPath);\r\n      let input: NodeJS.ReadableStream | null = null;\r\n      const unknownBody: unknown = body;\r\n\r\n      if (\r\n        typeof unknownBody === \"object\" &&\r\n        unknownBody !== null &&\r\n        \"pipe\" in unknownBody &&\r\n        typeof (unknownBody as { pipe?: unknown }).pipe === \"function\"\r\n      ) {\r\n        input = unknownBody as NodeJS.ReadableStream;\r\n      } else if (\r\n        typeof unknownBody === \"object\" &&\r\n        unknownBody !== null &&\r\n        \"getReader\" in unknownBody &&\r\n        typeof (unknownBody as { getReader?: unknown }).getReader === \"function\"\r\n      ) {\r\n        input = Readable.fromWeb(unknownBody as unknown as globalThis.ReadableStream);\r\n      } else if (\r\n        typeof unknownBody === \"object\" &&\r\n        unknownBody !== null &&\r\n        \"stream\" in unknownBody &&\r\n        typeof (unknownBody as { stream?: unknown }).stream === \"function\"\r\n      ) {\r\n        input = Readable.fromWeb(\r\n          (unknownBody as { stream: () => globalThis.ReadableStream }).stream()\r\n        );\r\n      }\r\n\r\n      if (input) {\r\n        await pipeline(input, writeStream);\r\n        return ok(destinationPath);\r\n      }\r\n\r\n      if (\r\n        typeof unknownBody === \"object\" &&\r\n        unknownBody !== null &&\r\n        \"arrayBuffer\" in unknownBody &&\r\n        typeof (unknownBody as { arrayBuffer?: unknown }).arrayBuffer === \"function\"\r\n      ) {\r\n        const buffer = Buffer.from(\r\n          await (unknownBody as { arrayBuffer: () => Promise<ArrayBuffer> }).arrayBuffer()\r\n        );\r\n        await pipeline(Readable.from(buffer), writeStream);\r\n        return ok(destinationPath);\r\n      }\r\n\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Unsupported S3 body type\");\r\n    });\r\n  }\r\n\r\n  getFileType(path: string): { fileType: keyof typeof fileTypes; extension: string } | undefined {\r\n    // determine the type of the file\r\n    const extension = path.split(\".\").pop();\r\n    if (!extension) return undefined;\r\n\r\n    for (const [key, value] of Object.entries(fileTypes)) {\r\n      if (value.extensions.includes(extension)) {\r\n        return { fileType: key, extension };\r\n      }\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n"],"mappings":"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"}