@m5kdev/backend 0.8.6 → 0.8.8

package/dist/src/modules/email/email.service.cjs

@@ -0,0 +1,107 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+const require_src_modules_base_base_service = require("../base/base.service.cjs");
+let neverthrow = require("neverthrow");
+let react = require("react");
+let resend = require("resend");
+//#region src/modules/email/email.service.ts
+var EmailService = class extends require_src_modules_base_base_service.BaseService {
+	client;
+	brand;
+	noReplyFrom;
+	templates;
+	systemNotificationEmail;
+	constructor(props) {
+		super(void 0, void 0);
+		this.client = new resend.Resend(props.resendApiKey || process.env.RESEND_API_KEY);
+		this.brand = props.brand;
+		this.noReplyFrom = props.noReplyFrom;
+		this.templates = props.templates;
+		this.systemNotificationEmail = props.systemNotificationEmail;
+	}
+	async sendTemplate(to, templateKey, templateProps, options) {
+		const template = this.templates[templateKey];
+		if (!template) return this.error("NOT_FOUND", `Email template not found: ${String(templateKey)}`);
+		const from = options?.from || this.noReplyFrom;
+		const subject = options?.subject || template.subject || String(templateKey);
+		const previewText = options?.previewText || template.previewText || subject;
+		const { error } = await this.client.emails.send({
+			to,
+			subject,
+			from,
+			react: (0, react.createElement)(template.react, {
+				...templateProps,
+				previewText
+			})
+		});
+		if (error) return this.error("INTERNAL_SERVER_ERROR", `Failed to send email: ${templateKey}`, { cause: error });
+		return (0, neverthrow.ok)();
+	}
+	async sendBrandTemplate(to, templateKey, templateProps, options) {
+		return this.sendTemplate(to, templateKey, {
+			brand: this.brand,
+			...templateProps
+		}, options);
+	}
+	async sendWaitlistConfirmation(email, overrideOptions) {
+		return this.sendTemplate(email, "waitlistConfirmation", {
+			email,
+			brand: this.brand
+		}, overrideOptions);
+	}
+	async sendWaitlistInvite(email, code, overrideOptions) {
+		const url = `${process.env.VITE_APP_URL}/signup?code=${code}&email=${email}`;
+		return this.sendTemplate(email, "waitlistInvite", {
+			url,
+			brand: this.brand
+		}, overrideOptions);
+	}
+	async sendWaitlistUserInvite(email, code, inviter, name, overrideOptions) {
+		const url = `${process.env.VITE_APP_URL}/signup?code=${code}&email=${email}`;
+		return this.sendTemplate(email, "waitlistUserInvite", {
+			url,
+			brand: this.brand,
+			inviter,
+			name
+		}, {
+			previewText: `Create your ${this.brand.name} account today!`,
+			subject: `${inviter} has invited you to join ${this.brand.name}!`,
+			...overrideOptions
+		});
+	}
+	async sendOrganizationInvite(email, organizationName, inviterName, role, url, overrideOptions) {
+		return this.sendTemplate(email, "organizationInvite", {
+			url,
+			brand: this.brand,
+			organizationName,
+			inviterName,
+			role
+		}, {
+			previewText: `${inviterName} invited you to ${organizationName}`,
+			subject: `${inviterName} invited you to join ${organizationName}`,
+			...overrideOptions
+		});
+	}
+	async sendVerification(email, url, overrideOptions) {
+		return this.sendTemplate(email, "verification", {
+			url,
+			brand: this.brand
+		}, overrideOptions);
+	}
+	async sendResetPassword(email, url, overrideOptions) {
+		return this.sendTemplate(email, "passwordReset", {
+			url,
+			brand: this.brand
+		}, overrideOptions);
+	}
+	async sendDeleteAccountVerification(email, url, overrideOptions) {
+		return this.sendTemplate(email, "accountDeletion", {
+			url,
+			brand: this.brand
+		}, overrideOptions);
+	}
+};
+//#endregion
+exports.EmailService = EmailService;
+
+//# sourceMappingURL=email.service.cjs.map

package/dist/src/modules/email/email.service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.cjs","names":["BaseService","Resend"],"sources":["../../../../src/modules/email/email.service.ts"],"sourcesContent":["import { ok } from \"neverthrow\";\r\nimport { createElement, type FunctionComponent } from \"react\";\r\nimport { Resend } from \"resend\";\r\nimport { BaseService } from \"../base/base.service\";\r\n\r\ntype Brand = {\r\n  name: string;\r\n  logo: string;\r\n  tagline: string;\r\n};\r\n\r\ntype OverrideOptions = {\r\n  from?: string;\r\n  subject?: string;\r\n  previewText?: string;\r\n};\r\n\r\ntype EmailTemplate = {\r\n  id: string;\r\n  subject?: string;\r\n  previewText?: string;\r\n  from?: string;\r\n  react: FunctionComponent<Record<string, unknown>>;\r\n};\r\n\r\ntype EmailTemplates = {\r\n  accountDeletion: EmailTemplate;\r\n  verification: EmailTemplate;\r\n  waitlistConfirmation: EmailTemplate;\r\n  passwordReset: EmailTemplate;\r\n  systemWaitlistNotification: EmailTemplate;\r\n  waitlistInvite: EmailTemplate;\r\n  waitlistUserInvite: EmailTemplate;\r\n  organizationInvite: EmailTemplate;\r\n  [key: string]: EmailTemplate;\r\n};\r\n\r\ntype EmailServiceProps = {\r\n  resendApiKey?: string;\r\n  brand: Brand;\r\n  noReplyFrom: string;\r\n  systemNotificationEmail: string;\r\n  templates: EmailTemplates;\r\n};\r\n\r\nexport class EmailService extends BaseService<never, never> {\r\n  public client: Resend;\r\n  public brand: Brand;\r\n  public noReplyFrom: string;\r\n  public templates: EmailTemplates;\r\n  public systemNotificationEmail: string;\r\n\r\n  constructor(props: EmailServiceProps) {\r\n    super(undefined, undefined);\r\n    this.client = new Resend(props.resendApiKey || process.env.RESEND_API_KEY);\r\n    this.brand = props.brand;\r\n    this.noReplyFrom = props.noReplyFrom;\r\n    this.templates = props.templates;\r\n    this.systemNotificationEmail = props.systemNotificationEmail;\r\n  }\r\n\r\n  async sendTemplate(\r\n    to: string | string[],\r\n    templateKey: keyof EmailTemplates,\r\n    templateProps: Record<string, unknown>,\r\n    options?: OverrideOptions\r\n  ) {\r\n    const template = this.templates[templateKey];\r\n    if (!template) {\r\n      return this.error(\"NOT_FOUND\", `Email template not found: ${String(templateKey)}`);\r\n    }\r\n    const from = options?.from || this.noReplyFrom;\r\n    const subject = options?.subject || template.subject || String(templateKey);\r\n    const previewText = options?.previewText || template.previewText || subject;\r\n\r\n    const { error } = await this.client.emails.send({\r\n      to,\r\n      subject,\r\n      from,\r\n      react: createElement(template.react, { ...templateProps, previewText }),\r\n    });\r\n    if (error)\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", `Failed to send email: ${templateKey}`, {\r\n        cause: error,\r\n      });\r\n    return ok();\r\n  }\r\n\r\n  async sendBrandTemplate(\r\n    to: string | string[],\r\n    templateKey: keyof EmailTemplates,\r\n    templateProps: Record<string, unknown>,\r\n    options?: OverrideOptions\r\n  ) {\r\n    return this.sendTemplate(\r\n      to,\r\n      templateKey,\r\n      {\r\n        brand: this.brand,\r\n        ...templateProps,\r\n      },\r\n      options\r\n    );\r\n  }\r\n\r\n  async sendWaitlistConfirmation(email: string, overrideOptions?: OverrideOptions) {\r\n    return this.sendTemplate(\r\n      email,\r\n      \"waitlistConfirmation\",\r\n      {\r\n        email,\r\n        brand: this.brand,\r\n      },\r\n      overrideOptions\r\n    );\r\n  }\r\n\r\n  async sendWaitlistInvite(email: string, code: string, overrideOptions?: OverrideOptions) {\r\n    const url = `${process.env.VITE_APP_URL}/signup?code=${code}&email=${email}`;\r\n    return this.sendTemplate(\r\n      email,\r\n      \"waitlistInvite\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n      },\r\n      overrideOptions\r\n    );\r\n  }\r\n\r\n  async sendWaitlistUserInvite(\r\n    email: string,\r\n    code: string,\r\n    inviter: string,\r\n    name?: string,\r\n    overrideOptions?: OverrideOptions\r\n  ) {\r\n    const url = `${process.env.VITE_APP_URL}/signup?code=${code}&email=${email}`;\r\n    return this.sendTemplate(\r\n      email,\r\n      \"waitlistUserInvite\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n        inviter,\r\n        name,\r\n      },\r\n      {\r\n        previewText: `Create your ${this.brand.name} account today!`,\r\n        subject: `${inviter} has invited you to join ${this.brand.name}!`,\r\n        ...overrideOptions,\r\n      }\r\n    );\r\n  }\r\n\r\n  async sendOrganizationInvite(\r\n    email: string,\r\n    organizationName: string,\r\n    inviterName: string,\r\n    role: string,\r\n    url: string,\r\n    overrideOptions?: OverrideOptions\r\n  ) {\r\n    return this.sendTemplate(\r\n      email,\r\n      \"organizationInvite\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n        organizationName,\r\n        inviterName,\r\n        role,\r\n      },\r\n      {\r\n        previewText: `${inviterName} invited you to ${organizationName}`,\r\n        subject: `${inviterName} invited you to join ${organizationName}`,\r\n        ...overrideOptions,\r\n      }\r\n    );\r\n  }\r\n\r\n  async sendVerification(email: string, url: string, overrideOptions?: OverrideOptions) {\r\n    return this.sendTemplate(\r\n      email,\r\n      \"verification\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n      },\r\n      overrideOptions\r\n    );\r\n  }\r\n\r\n  async sendResetPassword(email: string, url: string, overrideOptions?: OverrideOptions) {\r\n    return this.sendTemplate(\r\n      email,\r\n      \"passwordReset\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n      },\r\n      overrideOptions\r\n    );\r\n  }\r\n\r\n  async sendDeleteAccountVerification(\r\n    email: string,\r\n    url: string,\r\n    overrideOptions?: OverrideOptions\r\n  ) {\r\n    return this.sendTemplate(\r\n      email,\r\n      \"accountDeletion\",\r\n      {\r\n        url,\r\n        brand: this.brand,\r\n      },\r\n      overrideOptions\r\n    );\r\n  }\r\n}\r\n"],"mappings":";;;;;;;AA6CA,IAAa,eAAb,cAAkCA,sCAAAA,YAA0B;CAC1D;CACA;CACA;CACA;CACA;CAEA,YAAY,OAA0B;AACpC,QAAM,KAAA,GAAW,KAAA,EAAU;AAC3B,OAAK,SAAS,IAAIC,OAAAA,OAAO,MAAM,gBAAgB,QAAQ,IAAI,eAAe;AAC1E,OAAK,QAAQ,MAAM;AACnB,OAAK,cAAc,MAAM;AACzB,OAAK,YAAY,MAAM;AACvB,OAAK,0BAA0B,MAAM;;CAGvC,MAAM,aACJ,IACA,aACA,eACA,SACA;EACA,MAAM,WAAW,KAAK,UAAU;AAChC,MAAI,CAAC,SACH,QAAO,KAAK,MAAM,aAAa,6BAA6B,OAAO,YAAY,GAAG;EAEpF,MAAM,OAAO,SAAS,QAAQ,KAAK;EACnC,MAAM,UAAU,SAAS,WAAW,SAAS,WAAW,OAAO,YAAY;EAC3E,MAAM,cAAc,SAAS,eAAe,SAAS,eAAe;EAEpE,MAAM,EAAE,UAAU,MAAM,KAAK,OAAO,OAAO,KAAK;GAC9C;GACA;GACA;GACA,QAAA,GAAA,MAAA,eAAqB,SAAS,OAAO;IAAE,GAAG;IAAe;IAAa,CAAC;GACxE,CAAC;AACF,MAAI,MACF,QAAO,KAAK,MAAM,yBAAyB,yBAAyB,eAAe,EACjF,OAAO,OACR,CAAC;AACJ,UAAA,GAAA,WAAA,KAAW;;CAGb,MAAM,kBACJ,IACA,aACA,eACA,SACA;AACA,SAAO,KAAK,aACV,IACA,aACA;GACE,OAAO,KAAK;GACZ,GAAG;GACJ,EACD,QACD;;CAGH,MAAM,yBAAyB,OAAe,iBAAmC;AAC/E,SAAO,KAAK,aACV,OACA,wBACA;GACE;GACA,OAAO,KAAK;GACb,EACD,gBACD;;CAGH,MAAM,mBAAmB,OAAe,MAAc,iBAAmC;EACvF,MAAM,MAAM,GAAG,QAAQ,IAAI,aAAa,eAAe,KAAK,SAAS;AACrE,SAAO,KAAK,aACV,OACA,kBACA;GACE;GACA,OAAO,KAAK;GACb,EACD,gBACD;;CAGH,MAAM,uBACJ,OACA,MACA,SACA,MACA,iBACA;EACA,MAAM,MAAM,GAAG,QAAQ,IAAI,aAAa,eAAe,KAAK,SAAS;AACrE,SAAO,KAAK,aACV,OACA,sBACA;GACE;GACA,OAAO,KAAK;GACZ;GACA;GACD,EACD;GACE,aAAa,eAAe,KAAK,MAAM,KAAK;GAC5C,SAAS,GAAG,QAAQ,2BAA2B,KAAK,MAAM,KAAK;GAC/D,GAAG;GACJ,CACF;;CAGH,MAAM,uBACJ,OACA,kBACA,aACA,MACA,KACA,iBACA;AACA,SAAO,KAAK,aACV,OACA,sBACA;GACE;GACA,OAAO,KAAK;GACZ;GACA;GACA;GACD,EACD;GACE,aAAa,GAAG,YAAY,kBAAkB;GAC9C,SAAS,GAAG,YAAY,uBAAuB;GAC/C,GAAG;GACJ,CACF;;CAGH,MAAM,iBAAiB,OAAe,KAAa,iBAAmC;AACpF,SAAO,KAAK,aACV,OACA,gBACA;GACE;GACA,OAAO,KAAK;GACb,EACD,gBACD;;CAGH,MAAM,kBAAkB,OAAe,KAAa,iBAAmC;AACrF,SAAO,KAAK,aACV,OACA,iBACA;GACE;GACA,OAAO,KAAK;GACb,EACD,gBACD;;CAGH,MAAM,8BACJ,OACA,KACA,iBACA;AACA,SAAO,KAAK,aACV,OACA,mBACA;GACE;GACA,OAAO,KAAK;GACb,EACD,gBACD"}

package/dist/src/modules/email/email.service.d.cts

@@ -0,0 +1,62 @@
+import { ServerError } from "../../utils/errors.cjs";
+import { BaseService } from "../base/base.service.cjs";
+import * as _$neverthrow from "neverthrow";
+import { FunctionComponent } from "react";
+import { Resend } from "resend";
+
+//#region src/modules/email/email.service.d.ts
+type Brand = {
+  name: string;
+  logo: string;
+  tagline: string;
+};
+type OverrideOptions = {
+  from?: string;
+  subject?: string;
+  previewText?: string;
+};
+type EmailTemplate = {
+  id: string;
+  subject?: string;
+  previewText?: string;
+  from?: string;
+  react: FunctionComponent<Record<string, unknown>>;
+};
+type EmailTemplates = {
+  accountDeletion: EmailTemplate;
+  verification: EmailTemplate;
+  waitlistConfirmation: EmailTemplate;
+  passwordReset: EmailTemplate;
+  systemWaitlistNotification: EmailTemplate;
+  waitlistInvite: EmailTemplate;
+  waitlistUserInvite: EmailTemplate;
+  organizationInvite: EmailTemplate;
+  [key: string]: EmailTemplate;
+};
+type EmailServiceProps = {
+  resendApiKey?: string;
+  brand: Brand;
+  noReplyFrom: string;
+  systemNotificationEmail: string;
+  templates: EmailTemplates;
+};
+declare class EmailService extends BaseService<never, never> {
+  client: Resend;
+  brand: Brand;
+  noReplyFrom: string;
+  templates: EmailTemplates;
+  systemNotificationEmail: string;
+  constructor(props: EmailServiceProps);
+  sendTemplate(to: string | string[], templateKey: keyof EmailTemplates, templateProps: Record<string, unknown>, options?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendBrandTemplate(to: string | string[], templateKey: keyof EmailTemplates, templateProps: Record<string, unknown>, options?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendWaitlistConfirmation(email: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendWaitlistInvite(email: string, code: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendWaitlistUserInvite(email: string, code: string, inviter: string, name?: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendOrganizationInvite(email: string, organizationName: string, inviterName: string, role: string, url: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendVerification(email: string, url: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendResetPassword(email: string, url: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+  sendDeleteAccountVerification(email: string, url: string, overrideOptions?: OverrideOptions): Promise<_$neverthrow.Err<never, ServerError> | _$neverthrow.Ok<void, never>>;
+}
+//#endregion
+export { EmailService };
+//# sourceMappingURL=email.service.d.cts.map

package/dist/src/modules/file/file.repository.cjs

@@ -0,0 +1,74 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+const require_src_modules_base_base_repository = require("../base/base.repository.cjs");
+let neverthrow = require("neverthrow");
+let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
+let _aws_sdk_s3_request_presigner = require("@aws-sdk/s3-request-presigner");
+//#region src/modules/file/file.repository.ts
+var FileRepository = class extends require_src_modules_base_base_repository.BaseExternaRepository {
+	s3;
+	constructor() {
+		super();
+		if (!process.env.AWS_REGION || !process.env.AWS_ACCESS_KEY_ID || !process.env.AWS_SECRET_ACCESS_KEY) throw new Error("Missing AWS environment variables");
+		this.s3 = new _aws_sdk_client_s3.S3Client({
+			region: process.env.AWS_REGION,
+			credentials: {
+				accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+				secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+			},
+			...process.env.AWS_S3_ENDPOINT ? { endpoint: process.env.AWS_S3_ENDPOINT } : {},
+			forcePathStyle: !!process.env.AWS_S3_ENDPOINT
+		});
+	}
+	async getS3UploadUrl(filename, filetype, expiresIn = 300) {
+		return this.throwableAsync(async () => {
+			const command = new _aws_sdk_client_s3.PutObjectCommand({
+				Bucket: process.env.AWS_S3_BUCKET,
+				Key: filename,
+				ContentType: filetype
+			});
+			return (0, neverthrow.ok)(await (0, _aws_sdk_s3_request_presigner.getSignedUrl)(this.s3, command, { expiresIn }));
+		});
+	}
+	async getS3DownloadUrl(path, expiresIn = 300) {
+		return this.throwableAsync(async () => {
+			const command = new _aws_sdk_client_s3.GetObjectCommand({
+				Bucket: process.env.AWS_S3_BUCKET,
+				Key: path
+			});
+			return (0, neverthrow.ok)(await (0, _aws_sdk_s3_request_presigner.getSignedUrl)(this.s3, command, { expiresIn }));
+		});
+	}
+	async getS3Object(path) {
+		return this.throwableAsync(async () => {
+			const command = new _aws_sdk_client_s3.GetObjectCommand({
+				Bucket: process.env.AWS_S3_BUCKET,
+				Key: path
+			});
+			return (0, neverthrow.ok)(await this.s3.send(command));
+		});
+	}
+	async getS3ObjectT(path) {
+		return this.throwableAsync(async () => {
+			const command = new _aws_sdk_client_s3.GetObjectCommand({
+				Bucket: process.env.AWS_S3_BUCKET,
+				Key: path
+			});
+			return (0, neverthrow.ok)(await this.s3.send(command));
+		});
+	}
+	async deleteS3Object(path) {
+		return this.throwableAsync(async () => {
+			const command = new _aws_sdk_client_s3.DeleteObjectCommand({
+				Bucket: process.env.AWS_S3_BUCKET,
+				Key: path
+			});
+			await this.s3.send(command);
+			return (0, neverthrow.ok)(void 0);
+		});
+	}
+};
+//#endregion
+exports.FileRepository = FileRepository;
+
+//# sourceMappingURL=file.repository.cjs.map

package/dist/src/modules/file/file.repository.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.repository.cjs","names":["BaseExternaRepository","S3Client","PutObjectCommand","GetObjectCommand","DeleteObjectCommand"],"sources":["../../../../src/modules/file/file.repository.ts"],"sourcesContent":["import {\r\n  DeleteObjectCommand,\r\n  GetObjectCommand,\r\n  type GetObjectCommandOutput,\r\n  PutObjectCommand,\r\n  S3Client,\r\n} from \"@aws-sdk/client-s3\";\r\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\r\nimport { ok } from \"neverthrow\";\r\nimport type { ServerResultAsync } from \"../base/base.dto\";\r\nimport { BaseExternaRepository } from \"../base/base.repository\";\r\n\r\nexport class FileRepository extends BaseExternaRepository {\r\n  private readonly s3: S3Client;\r\n  constructor() {\r\n    super();\r\n\r\n    if (\r\n      !process.env.AWS_REGION ||\r\n      !process.env.AWS_ACCESS_KEY_ID ||\r\n      !process.env.AWS_SECRET_ACCESS_KEY\r\n    ) {\r\n      throw new Error(\"Missing AWS environment variables\");\r\n    }\r\n\r\n    this.s3 = new S3Client({\r\n      region: process.env.AWS_REGION,\r\n      credentials: {\r\n        accessKeyId: process.env.AWS_ACCESS_KEY_ID,\r\n        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\r\n      },\r\n      ...(process.env.AWS_S3_ENDPOINT ? { endpoint: process.env.AWS_S3_ENDPOINT } : {}),\r\n      forcePathStyle: !!process.env.AWS_S3_ENDPOINT, // Path style is often required for non-AWS S3 providers\r\n    });\r\n  }\r\n  async getS3UploadUrl(\r\n    filename: string,\r\n    filetype: string,\r\n    expiresIn = 60 * 5\r\n  ): ServerResultAsync<string> {\r\n    return this.throwableAsync(async () => {\r\n      const command = new PutObjectCommand({\r\n        Bucket: process.env.AWS_S3_BUCKET,\r\n        Key: filename,\r\n        ContentType: filetype,\r\n      });\r\n      const url = await getSignedUrl(this.s3, command, { expiresIn });\r\n      return ok(url);\r\n    });\r\n  }\r\n\r\n  async getS3DownloadUrl(path: string, expiresIn = 60 * 5): ServerResultAsync<string> {\r\n    return this.throwableAsync(async () => {\r\n      const command = new GetObjectCommand({\r\n        Bucket: process.env.AWS_S3_BUCKET,\r\n        Key: path,\r\n      });\r\n      const url = await getSignedUrl(this.s3, command, { expiresIn });\r\n      return ok(url);\r\n    });\r\n  }\r\n\r\n  async getS3Object(path: string): ServerResultAsync<GetObjectCommandOutput> {\r\n    return this.throwableAsync(async () => {\r\n      const command = new GetObjectCommand({\r\n        Bucket: process.env.AWS_S3_BUCKET,\r\n        Key: path,\r\n      });\r\n      const data = await this.s3.send(command);\r\n      return ok(data);\r\n    });\r\n  }\r\n\r\n  async getS3ObjectT(path: string): ServerResultAsync<GetObjectCommandOutput> {\r\n    return this.throwableAsync(async () => {\r\n      const command = new GetObjectCommand({\r\n        Bucket: process.env.AWS_S3_BUCKET,\r\n        Key: path,\r\n      });\r\n      const data = await this.s3.send(command);\r\n      return ok(data);\r\n    });\r\n  }\r\n\r\n  async deleteS3Object(path: string): ServerResultAsync<void> {\r\n    return this.throwableAsync(async () => {\r\n      const command = new DeleteObjectCommand({\r\n        Bucket: process.env.AWS_S3_BUCKET,\r\n        Key: path,\r\n      });\r\n      await this.s3.send(command);\r\n      return ok(undefined);\r\n    });\r\n  }\r\n}\r\n"],"mappings":";;;;;;;AAYA,IAAa,iBAAb,cAAoCA,yCAAAA,sBAAsB;CACxD;CACA,cAAc;AACZ,SAAO;AAEP,MACE,CAAC,QAAQ,IAAI,cACb,CAAC,QAAQ,IAAI,qBACb,CAAC,QAAQ,IAAI,sBAEb,OAAM,IAAI,MAAM,oCAAoC;AAGtD,OAAK,KAAK,IAAIC,mBAAAA,SAAS;GACrB,QAAQ,QAAQ,IAAI;GACpB,aAAa;IACX,aAAa,QAAQ,IAAI;IACzB,iBAAiB,QAAQ,IAAI;IAC9B;GACD,GAAI,QAAQ,IAAI,kBAAkB,EAAE,UAAU,QAAQ,IAAI,iBAAiB,GAAG,EAAE;GAChF,gBAAgB,CAAC,CAAC,QAAQ,IAAI;GAC/B,CAAC;;CAEJ,MAAM,eACJ,UACA,UACA,YAAY,KACe;AAC3B,SAAO,KAAK,eAAe,YAAY;GACrC,MAAM,UAAU,IAAIC,mBAAAA,iBAAiB;IACnC,QAAQ,QAAQ,IAAI;IACpB,KAAK;IACL,aAAa;IACd,CAAC;AAEF,WAAA,GAAA,WAAA,IADY,OAAA,GAAA,8BAAA,cAAmB,KAAK,IAAI,SAAS,EAAE,WAAW,CAAC,CACjD;IACd;;CAGJ,MAAM,iBAAiB,MAAc,YAAY,KAAmC;AAClF,SAAO,KAAK,eAAe,YAAY;GACrC,MAAM,UAAU,IAAIC,mBAAAA,iBAAiB;IACnC,QAAQ,QAAQ,IAAI;IACpB,KAAK;IACN,CAAC;AAEF,WAAA,GAAA,WAAA,IADY,OAAA,GAAA,8BAAA,cAAmB,KAAK,IAAI,SAAS,EAAE,WAAW,CAAC,CACjD;IACd;;CAGJ,MAAM,YAAY,MAAyD;AACzE,SAAO,KAAK,eAAe,YAAY;GACrC,MAAM,UAAU,IAAIA,mBAAAA,iBAAiB;IACnC,QAAQ,QAAQ,IAAI;IACpB,KAAK;IACN,CAAC;AAEF,WAAA,GAAA,WAAA,IADa,MAAM,KAAK,GAAG,KAAK,QAAQ,CACzB;IACf;;CAGJ,MAAM,aAAa,MAAyD;AAC1E,SAAO,KAAK,eAAe,YAAY;GACrC,MAAM,UAAU,IAAIA,mBAAAA,iBAAiB;IACnC,QAAQ,QAAQ,IAAI;IACpB,KAAK;IACN,CAAC;AAEF,WAAA,GAAA,WAAA,IADa,MAAM,KAAK,GAAG,KAAK,QAAQ,CACzB;IACf;;CAGJ,MAAM,eAAe,MAAuC;AAC1D,SAAO,KAAK,eAAe,YAAY;GACrC,MAAM,UAAU,IAAIC,mBAAAA,oBAAoB;IACtC,QAAQ,QAAQ,IAAI;IACpB,KAAK;IACN,CAAC;AACF,SAAM,KAAK,GAAG,KAAK,QAAQ;AAC3B,WAAA,GAAA,WAAA,IAAU,KAAA,EAAU;IACpB"}

package/dist/src/modules/file/file.repository.d.cts

@@ -0,0 +1,17 @@
+import { ServerResultAsync } from "../base/base.dto.cjs";
+import { BaseExternaRepository } from "../base/base.repository.cjs";
+import { GetObjectCommandOutput } from "@aws-sdk/client-s3";
+
+//#region src/modules/file/file.repository.d.ts
+declare class FileRepository extends BaseExternaRepository {
+  private readonly s3;
+  constructor();
+  getS3UploadUrl(filename: string, filetype: string, expiresIn?: number): ServerResultAsync<string>;
+  getS3DownloadUrl(path: string, expiresIn?: number): ServerResultAsync<string>;
+  getS3Object(path: string): ServerResultAsync<GetObjectCommandOutput>;
+  getS3ObjectT(path: string): ServerResultAsync<GetObjectCommandOutput>;
+  deleteS3Object(path: string): ServerResultAsync<void>;
+}
+//#endregion
+export { FileRepository };
+//# sourceMappingURL=file.repository.d.cts.map

package/dist/src/modules/file/file.router.cjs

@@ -0,0 +1,94 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_src_modules_file_file_repository = require("./file.repository.cjs");
+const require_src_modules_file_file_service = require("./file.service.cjs");
+let uuid = require("uuid");
+let body_parser = require("body-parser");
+body_parser = require_runtime.__toESM(body_parser);
+let express = require("express");
+express = require_runtime.__toESM(express);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let _m5kdev_commons_modules_file_file_constants = require("@m5kdev/commons/modules/file/file.constants");
+let multer = require("multer");
+multer = require_runtime.__toESM(multer);
+//#region src/modules/file/file.router.ts
+const fileService = new require_src_modules_file_file_service.FileService({ file: new require_src_modules_file_file_repository.FileRepository() });
+function validateMimeType(type, file) {
+	return _m5kdev_commons_modules_file_file_constants.fileTypes[type]?.mimetypes.includes(file.mimetype);
+}
+function getFileExtension(file) {
+	return file.originalname.split(".").pop();
+}
+const storage = multer.default.diskStorage({
+	destination: (_req, _file, cb) => {
+		cb(null, node_path.default.join(__dirname, "..", "uploads"));
+	},
+	filename: (_req, file, cb) => {
+		cb(null, `${(0, uuid.v4)()}.${getFileExtension(file)}`);
+	}
+});
+const fileFilter = (req, file, cb) => {
+	const { type } = req.params;
+	if (type && validateMimeType(type, file)) cb(null, true);
+	else cb(/* @__PURE__ */ new Error("Invalid file type"));
+};
+const upload = (0, multer.default)({
+	storage,
+	fileFilter
+});
+const uploadRouter = express.default.Router();
+uploadRouter.post("/file/:type", upload.single("file"), (req, res) => {
+	const { file } = req;
+	if (!file) return res.status(400).json({ error: "No file uploaded" });
+	return res.json({
+		url: `${process.env.VITE_SERVER_URL}/upload/file/${file.filename}`,
+		mimetype: file.mimetype,
+		size: file.size
+	});
+});
+uploadRouter.get("/file/:filename", (req, res) => {
+	res.sendFile(node_path.default.join(__dirname, "..", "uploads", req.params.filename));
+});
+uploadRouter.get("/files/:path", async (req, res) => {
+	try {
+		const url = await fileService.getS3DownloadUrl(req.params.path);
+		if (url.isErr()) {
+			console.error(url.error);
+			return res.status(500).json({ error: url.error.message });
+		}
+		return res.json({ url: url.value });
+	} catch (err) {
+		console.error(err);
+		return res.status(500).json({ error: err.message || "Failed to generate presigned URL" });
+	}
+});
+uploadRouter.post("/s3-presigned-url", body_parser.default.json(), async (req, res) => {
+	const { filename, filetype } = req.body;
+	if (!filename || !filetype) return res.status(400).json({ error: "Missing filename or filetype" });
+	try {
+		const url = await fileService.getS3UploadUrl(filename, filetype);
+		if (url.isErr()) return res.status(500).json({ error: url.error.message });
+		return res.json({ url: url.value });
+	} catch (err) {
+		console.error(err);
+		return res.status(500).json({ error: err.message || "Failed to generate presigned URL" });
+	}
+});
+uploadRouter.delete("/files/:path(*)", async (req, res) => {
+	try {
+		const result = await fileService.deleteS3Object(req.params.path);
+		if (result.isErr()) {
+			console.error(result.error);
+			return res.status(500).json({ error: result.error.message });
+		}
+		return res.json({ success: true });
+	} catch (err) {
+		console.error(err);
+		return res.status(500).json({ error: err.message || "Failed to delete S3 object" });
+	}
+});
+//#endregion
+exports.uploadRouter = uploadRouter;
+
+//# sourceMappingURL=file.router.cjs.map

package/dist/src/modules/file/file.router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.router.cjs","names":["FileService","FileRepository","fileTypes","path","bodyParser"],"sources":["../../../../src/modules/file/file.router.ts"],"sourcesContent":["import path from \"node:path\";\r\nimport { fileTypes } from \"@m5kdev/commons/modules/file/file.constants\";\r\nimport bodyParser from \"body-parser\";\r\nimport express, { type Request, type Response } from \"express\";\r\nimport multer from \"multer\";\r\nimport { v4 as uuidv4 } from \"uuid\";\r\nimport { FileRepository } from \"./file.repository\";\r\nimport { FileService } from \"./file.service\";\r\n\r\nconst fileRepository = new FileRepository();\r\nconst fileService = new FileService({ file: fileRepository });\r\n\r\nfunction validateMimeType(type: string, file: Express.Multer.File): boolean {\r\n  return fileTypes[type]?.mimetypes.includes(file.mimetype);\r\n}\r\n\r\nfunction getFileExtension(file: Express.Multer.File): string | undefined {\r\n  return file.originalname.split(\".\").pop();\r\n}\r\n\r\nconst storage = multer.diskStorage({\r\n  destination: (_req, _file, cb) => {\r\n    cb(null, path.join(__dirname, \"..\", \"uploads\"));\r\n  },\r\n  filename: (_req, file, cb) => {\r\n    cb(null, `${uuidv4()}.${getFileExtension(file)}`);\r\n  },\r\n});\r\n\r\nconst fileFilter = (\r\n  req: Request,\r\n  file: Express.Multer.File,\r\n  cb: multer.FileFilterCallback\r\n): void => {\r\n  const { type } = req.params;\r\n  if (type && validateMimeType(type, file)) {\r\n    cb(null, true);\r\n  } else {\r\n    cb(new Error(\"Invalid file type\"));\r\n  }\r\n};\r\n\r\nconst upload = multer({ storage, fileFilter });\r\nconst uploadRouter: express.Router = express.Router();\r\n\r\nuploadRouter.post(\"/file/:type\", upload.single(\"file\"), (req: Request, res: Response) => {\r\n  const { file } = req;\r\n  if (!file) {\r\n    return res.status(400).json({ error: \"No file uploaded\" });\r\n  }\r\n  return res.json({\r\n    url: `${process.env.VITE_SERVER_URL}/upload/file/${file.filename}`,\r\n    mimetype: file.mimetype,\r\n    size: file.size,\r\n  });\r\n});\r\n\r\nuploadRouter.get(\"/file/:filename\", (req: Request, res: Response) => {\r\n  res.sendFile(path.join(__dirname, \"..\", \"uploads\", req.params.filename!));\r\n});\r\n\r\nuploadRouter.get(\"/files/:path\", async (req: Request, res: Response) => {\r\n  try {\r\n    const url = await fileService.getS3DownloadUrl(req.params.path!);\r\n    if (url.isErr()) {\r\n      console.error(url.error);\r\n      return res.status(500).json({ error: url.error.message });\r\n    }\r\n    return res.json({ url: url.value });\r\n  } catch (err: any) {\r\n    console.error(err);\r\n    return res.status(500).json({ error: err.message || \"Failed to generate presigned URL\" });\r\n  }\r\n});\r\n\r\nuploadRouter.post(\"/s3-presigned-url\", bodyParser.json(), async (req: Request, res: Response) => {\r\n  const { filename, filetype } = req.body;\r\n\r\n  if (!filename || !filetype) {\r\n    return res.status(400).json({ error: \"Missing filename or filetype\" });\r\n  }\r\n  try {\r\n    const url = await fileService.getS3UploadUrl(filename, filetype);\r\n    if (url.isErr()) {\r\n      return res.status(500).json({ error: url.error.message });\r\n    }\r\n    return res.json({ url: url.value });\r\n  } catch (err: any) {\r\n    console.error(err);\r\n    return res.status(500).json({ error: err.message || \"Failed to generate presigned URL\" });\r\n  }\r\n});\r\n\r\nuploadRouter.delete(\"/files/:path(*)\", async (req: Request, res: Response) => {\r\n  try {\r\n    const result = await fileService.deleteS3Object(req.params.path!);\r\n    if (result.isErr()) {\r\n      console.error(result.error);\r\n      return res.status(500).json({ error: result.error.message });\r\n    }\r\n    return res.json({ success: true });\r\n  } catch (err: any) {\r\n    console.error(err);\r\n    return res.status(500).json({ error: err.message || \"Failed to delete S3 object\" });\r\n  }\r\n});\r\n\r\nexport { uploadRouter };\r\n"],"mappings":"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"}

package/dist/src/modules/file/file.router.d.cts

@@ -0,0 +1,7 @@
+import express from "express";
+
+//#region src/modules/file/file.router.d.ts
+declare const uploadRouter: express.Router;
+//#endregion
+export { uploadRouter };
+//# sourceMappingURL=file.router.d.cts.map

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

@@ -0,0 +1,120 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_src_modules_base_base_service = require("../base/base.service.cjs");
+let neverthrow = require("neverthrow");
+let uuid = require("uuid");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let _m5kdev_commons_modules_file_file_constants = require("@m5kdev/commons/modules/file/file.constants");
+let node_fs = require("node:fs");
+let node_fs_promises = require("node:fs/promises");
+let node_os = require("node:os");
+let node_stream = require("node:stream");
+let node_stream_promises = require("node:stream/promises");
+//#region src/modules/file/file.service.ts
+var FileService = class extends require_src_modules_base_base_service.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 (0, neverthrow.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 = `${(0, uuid.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 (0, neverthrow.err)(presigned.error);
+			const file = await (0, node_fs_promises.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 (0, neverthrow.err)(downloadUrl.error);
+				return (0, neverthrow.ok)(downloadUrl.value);
+			}
+			return (0, neverthrow.ok)(filename);
+		});
+	}
+	async downloadS3ToFile(s3Path) {
+		return this.throwableAsync(async () => {
+			const extension = s3Path.split(".").pop();
+			const destinationPath = node_path.default.join((0, node_os.tmpdir)(), "s3-downloads", `${(0, uuid.v4)()}${extension ? `.${extension}` : ""}`);
+			const result = await this.repository.file.getS3Object(s3Path);
+			if (result.isErr()) return (0, neverthrow.err)(result.error);
+			const body = result.value.Body;
+			if (!body) return this.error("NOT_FOUND", "S3 object body is empty");
+			await (0, node_fs_promises.mkdir)((0, node_path.dirname)(destinationPath), { recursive: true });
+			if (typeof body === "object" && "transformToByteArray" in body && typeof body.transformToByteArray === "function") {
+				await (0, node_fs_promises.writeFile)(destinationPath, await body.transformToByteArray());
+				return (0, neverthrow.ok)(destinationPath);
+			}
+			const writeStream = (0, node_fs.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 = node_stream.Readable.fromWeb(unknownBody);
+			else if (typeof unknownBody === "object" && unknownBody !== null && "stream" in unknownBody && typeof unknownBody.stream === "function") input = node_stream.Readable.fromWeb(unknownBody.stream());
+			if (input) {
+				await (0, node_stream_promises.pipeline)(input, writeStream);
+				return (0, neverthrow.ok)(destinationPath);
+			}
+			if (typeof unknownBody === "object" && unknownBody !== null && "arrayBuffer" in unknownBody && typeof unknownBody.arrayBuffer === "function") {
+				const buffer = Buffer.from(await unknownBody.arrayBuffer());
+				await (0, node_stream_promises.pipeline)(node_stream.Readable.from(buffer), writeStream);
+				return (0, neverthrow.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(_m5kdev_commons_modules_file_file_constants.fileTypes)) if (value.extensions.includes(extension)) return {
+			fileType: key,
+			extension
+		};
+	}
+};
+//#endregion
+exports.FileService = FileService;
+
+//# sourceMappingURL=file.service.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.service.cjs","names":["BaseService","path","Readable","fileTypes"],"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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"}

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

@@ -0,0 +1,30 @@
+import { ServerResult, ServerResultAsync } from "../base/base.dto.cjs";
+import { BaseService } from "../base/base.service.cjs";
+import { FileRepository } from "./file.repository.cjs";
+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.cts.map

package/dist/src/modules/recurrence/recurrence.db.cjs

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_src_modules_auth_auth_db = require("../auth/auth.db.cjs");
+let drizzle_orm_sqlite_core = require("drizzle-orm/sqlite-core");
+let uuid = require("uuid");
+//#region src/modules/recurrence/recurrence.db.ts
+var recurrence_db_exports = /* @__PURE__ */ require_runtime.__exportAll({
+	recurrence: () => recurrence,
+	recurrenceRules: () => recurrenceRules
+});
+const recurrence = (0, drizzle_orm_sqlite_core.sqliteTable)("recurrence", {
+	id: (0, drizzle_orm_sqlite_core.text)("id").primaryKey().$default(uuid.v4),
+	userId: (0, drizzle_orm_sqlite_core.text)("user_id").references(() => require_src_modules_auth_auth_db.users.id, { onDelete: "cascade" }),
+	organizationId: (0, drizzle_orm_sqlite_core.text)("organization_id").references(() => require_src_modules_auth_auth_db.organizations.id, { onDelete: "cascade" }),
+	teamId: (0, drizzle_orm_sqlite_core.text)("team_id").references(() => require_src_modules_auth_auth_db.teams.id, { onDelete: "cascade" }),
+	name: (0, drizzle_orm_sqlite_core.text)("name"),
+	kind: (0, drizzle_orm_sqlite_core.text)("kind"),
+	enabled: (0, drizzle_orm_sqlite_core.integer)("enabled", { mode: "boolean" }).notNull().default(true),
+	createdAt: (0, drizzle_orm_sqlite_core.integer)("created_at", { mode: "timestamp" }).notNull().$default(() => /* @__PURE__ */ new Date()),
+	updatedAt: (0, drizzle_orm_sqlite_core.integer)("updated_at", { mode: "timestamp" }).notNull().$default(() => /* @__PURE__ */ new Date()),
+	metadata: (0, drizzle_orm_sqlite_core.text)("metadata", { mode: "json" }).$type()
+});
+const recurrenceRules = (0, drizzle_orm_sqlite_core.sqliteTable)("recurrence_rules", {
+	id: (0, drizzle_orm_sqlite_core.text)("id").primaryKey().$default(uuid.v4),
+	createdAt: (0, drizzle_orm_sqlite_core.integer)("created_at", { mode: "timestamp" }).notNull().$default(() => /* @__PURE__ */ new Date()),
+	updatedAt: (0, drizzle_orm_sqlite_core.integer)("updated_at", { mode: "timestamp" }).notNull().$default(() => /* @__PURE__ */ new Date()),
+	recurrenceId: (0, drizzle_orm_sqlite_core.text)("recurrence_id").references(() => recurrence.id, { onDelete: "cascade" }),
+	freq: (0, drizzle_orm_sqlite_core.integer)("freq").notNull(),
+	dtstart: (0, drizzle_orm_sqlite_core.integer)("dtstart", { mode: "timestamp" }),
+	interval: (0, drizzle_orm_sqlite_core.integer)("interval").notNull().default(1),
+	wkst: (0, drizzle_orm_sqlite_core.integer)("wkst"),
+	count: (0, drizzle_orm_sqlite_core.integer)("count"),
+	until: (0, drizzle_orm_sqlite_core.integer)("until", { mode: "timestamp" }),
+	tzid: (0, drizzle_orm_sqlite_core.text)("tzid"),
+	bysetpos: (0, drizzle_orm_sqlite_core.text)("bysetpos", { mode: "json" }).$type(),
+	bymonth: (0, drizzle_orm_sqlite_core.text)("bymonth", { mode: "json" }).$type(),
+	bymonthday: (0, drizzle_orm_sqlite_core.text)("bymonthday", { mode: "json" }).$type(),
+	byyearday: (0, drizzle_orm_sqlite_core.text)("byyearday", { mode: "json" }).$type(),
+	byweekno: (0, drizzle_orm_sqlite_core.text)("byweekno", { mode: "json" }).$type(),
+	byweekday: (0, drizzle_orm_sqlite_core.text)("byweekday", { mode: "json" }).$type(),
+	byhour: (0, drizzle_orm_sqlite_core.text)("byhour", { mode: "json" }).$type(),
+	byminute: (0, drizzle_orm_sqlite_core.text)("byminute", { mode: "json" }).$type(),
+	bysecond: (0, drizzle_orm_sqlite_core.text)("bysecond", { mode: "json" }).$type()
+});
+//#endregion
+exports.recurrence = recurrence;
+exports.recurrenceRules = recurrenceRules;
+Object.defineProperty(exports, "recurrence_db_exports", {
+	enumerable: true,
+	get: function() {
+		return recurrence_db_exports;
+	}
+});
+
+//# sourceMappingURL=recurrence.db.cjs.map