sonamu 0.4.13 → 0.5.0

package/src/file-storage/file-storage.ts

@@ -0,0 +1,100 @@
+import type { MultipartFile } from "@fastify/multipart";
+import mime from "mime-types";
+import { createHash } from "crypto";
+import type { Driver } from "./driver";
+
+/**
+ * @fastify/multipart의 MultipartFile 래퍼
+ */
+export class FileStorage {
+  private _file: MultipartFile;
+  private _buffer?: Buffer;
+  private _driver: Driver;
+
+  constructor(file: MultipartFile, driver: Driver) {
+    this._file = file;
+    this._driver = driver;
+  }
+
+  /**
+   * 사용자 컴퓨터의 원본 파일명
+   */
+  get clientName(): string {
+    return this._file.filename;
+  }
+
+  /**
+   * 파일명 (clientName의 별칭)
+   */
+  get filename(): string {
+    return this._file.filename;
+  }
+
+  /**
+   * HTML input 필드명
+   */
+  get fieldName(): string {
+    return this._file.fieldname;
+  }
+
+  /**
+   * 파일 크기 (바이트)
+   */
+  get size(): number {
+    return this._file.file.bytesRead;
+  }
+
+  /**
+   * 파일 확장자 (점 제외)
+   */
+  get extname(): string | false {
+    return mime.extension(this._file.mimetype);
+  }
+
+  get mimetype(): string {
+    return this._file.mimetype;
+  }
+
+  get encoding(): string {
+    return this._file.encoding;
+  }
+
+  async toBuffer(): Promise<Buffer> {
+    if (!this._buffer) {
+      this._buffer = await this._file.toBuffer();
+    }
+    return this._buffer;
+  }
+
+  async md5(): Promise<string> {
+    const buffer = await this.toBuffer();
+    return createHash("md5").update(buffer).digest("hex");
+  }
+
+  /**
+   * 파일을 저장소에 저장
+   *
+   * @example
+   * ```typescript
+   * const { file } = Sonamu.getUploadContext();
+   * const url = await file.saveToDisk('uploads/avatar.png');
+   * ```
+   */
+  async saveToDisk(
+    key: string,
+    options?: { contentType?: string; visibility?: "public" | "private" }
+  ): Promise<string> {
+    const buffer = await this.toBuffer();
+
+    await this._driver.put(key, buffer, {
+      contentType: options?.contentType ?? this.mimetype,
+      visibility: options?.visibility,
+    });
+
+    return this._driver.getSignedUrl(key);
+  }
+
+  get raw(): MultipartFile {
+    return this._file;
+  }
+}

package/src/index.ts

@@ -1,22 +1,25 @@
-export * from "./api/code-converters";
-export * from "./api/context";
+export type * from "./api/context";
 export * from "./api/decorators";
 export * from "./api/sonamu";
+export * from "./database/base-model";
 export * from "./api/base-frame";
 export * from "./database/db";
 export * from "./database/upsert-builder";
-export * from "./database/types";
+export * from "./database/puri";
+export * from "./database/puri-wrapper";
+export * from "./database/puri.types";
 export * from "./exceptions/error-handler";
 export * from "./exceptions/so-exceptions";
-export * from "./entity/entity";
-export * from "./entity/entity-manager";
-export * from "./entity/entity-utils";
-export * from "./entity/migrator";
-export * from "./syncer/syncer";
-export * from "./testing/fixture-manager";
 export * from "./types/types";
 export * from "./utils/controller";
 export * from "./utils/model";
 export * from "./utils/utils";
-export { DBKnexClass } from "./database/drivers/knex/db";
-export { DBKyselyClass } from "./database/drivers/kysely/db";
+export * from "./testing/fixture-manager";
+export * from "./migration/migrator";
+export * from "./entity/entity-manager";
+export * from "./entity/entity";
+export * from "./file-storage/driver";
+
+// export * from "./api/code-converters";
+// export * from "./entity/entity-utils";
+// export * from "./syncer/syncer";