@kevisual/oss 0.0.17 → 0.0.18

package/dist/index.d.ts

@@ -15,6 +15,13 @@ type StatObjectResult = {
     lastModified: Date;
     metaData: ItemBucketMetadata;
     versionId?: string | null;
+    standardHeaders: {
+        contentType?: string;
+        cacheControl?: string;
+        contentDisposition?: string;
+        contentEncoding?: string;
+        contentLanguage?: string;
+    };
 };
 type ListFileObject = {
     name: string;
@@ -129,6 +136,9 @@ interface OssBaseOperation {
      */
     replaceObject?(objectName: string, meta: ItemBucketMetadata): Promise<any>;
 }
+interface OssService extends OssBaseOperation {
+    owner: string;
+}
 
 type OssBaseOptions<T = {
     [key: string]: any;
@@ -260,6 +270,7 @@ declare class OssBase implements OssBaseOperation {
         opts: Partial<OssBaseOptions<U>>;
     }): T;
 }
+declare const getStram: (data: GetObjectCommandOutput) => Readable;
 
-export { OssBase };
-export type { OssBaseOptions };
+export { OssBase, getStram };
+export type { ItemBucketMetadata, ListDirectoryObject, ListFileObject, ListObjectResult, OssBaseOperation, OssBaseOptions, OssService, StatObjectResult, UploadedObjectInfo };

package/dist/index.js

@@ -36452,15 +36452,21 @@ class OssBase {
         contentLength = Buffer.byteLength(putData);
       }
     } else {
-      putData = data;
       if (!contentLength) {
-        throw new Error("Stream upload requires size parameter");
+        const chunks = [];
+        for await (const chunk of data) {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        putData = Buffer.concat(chunks);
+        contentLength = putData.length;
+      } else {
+        putData = data;
       }
     }
     if (opts?.check) {
       const obj = await this.statObject(objectName, true);
       if (obj) {
-        const omitMeta = ["size", "Content-Type", "Cache-Control", "app-source"];
+        const omitMeta = ["size", "content-type", "cache-control", "app-source"];
         const objMeta = JSON.parse(JSON.stringify(omit(obj.metaData, omitMeta)));
         metaData = {
           ...objMeta,
@@ -36489,22 +36495,41 @@ class OssBase {
     };
   }
   async fPutObject(objectName, filePath, metaData) {
-    const fileStream = fs.createReadStream(filePath);
     const stat = fs.statSync(filePath);
     const { standardHeaders, customMetadata } = extractStandardHeaders(metaData || {});
-    const command = new import_client_s3.PutObjectCommand({
-      Bucket: this.bucketName,
-      Key: `${this.prefix}${objectName}`,
-      Body: fileStream,
-      ContentLength: stat.size,
-      ContentType: standardHeaders.ContentType || getContentType(filePath),
-      CacheControl: standardHeaders.CacheControl,
-      ContentDisposition: standardHeaders.ContentDisposition,
-      ContentEncoding: standardHeaders.ContentEncoding,
-      ContentLanguage: standardHeaders.ContentLanguage,
-      Expires: standardHeaders.Expires,
-      Metadata: customMetadata
-    });
+    const THRESHOLD = 5 * 1024 * 1024;
+    let command;
+    if (stat.size < THRESHOLD) {
+      const fileBuffer = await fs.promises.readFile(filePath);
+      command = new import_client_s3.PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileBuffer,
+        ContentLength: fileBuffer.length,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata
+      });
+    } else {
+      const fileStream = fs.createReadStream(filePath);
+      command = new import_client_s3.PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileStream,
+        ContentLength: stat.size,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata
+      });
+    }
     const response = await this.client.send(command);
     return {
       etag: response.ETag?.replace(/"/g, "") || "",
@@ -36567,6 +36592,13 @@ class OssBase {
       });
       const response = await this.client.send(command);
       return {
+        standardHeaders: {
+          contentType: response.ContentType,
+          cacheControl: response.CacheControl,
+          contentDisposition: response.ContentDisposition,
+          contentEncoding: response.ContentEncoding,
+          contentLanguage: response.ContentLanguage
+        },
         size: response.ContentLength || 0,
         etag: response.ETag?.replace?.(/"/g, "") || "",
         lastModified: response.LastModified || new Date,
@@ -36574,11 +36606,11 @@ class OssBase {
         versionId: response.VersionId || null
       };
     } catch (e) {
-      console.error("statObject error", e);
       const isNotFound = e.name === "NotFound" || e.name === "NoSuchBucket" || e.name === "NoSuchKey" || e.code === "NotFound" || e.code === "NoSuchBucket" || e.code === "NoSuchKey" || e.$metadata?.httpStatusCode === 404;
       if (checkFile && isNotFound) {
         return null;
       }
+      console.error("statObject error", e);
       throw e;
     }
   }
@@ -36659,6 +36691,13 @@ class OssBase {
     });
   }
 }
+var getStram = (data) => {
+  if (data.Body) {
+    return data.Body;
+  }
+  throw new Error("Object body is empty");
+};
 export {
+  getStram,
   OssBase
 };

package/dist/services.d.ts

@@ -1,36 +1,40 @@
-import * as _aws_sdk_client_s3 from '@aws-sdk/client-s3';
 import { CopyObjectCommandOutput, S3Client, GetObjectCommandOutput } from '@aws-sdk/client-s3';
 import { Readable } from 'node:stream';
-import { ServerResponse } from 'node:http';
-import { ItemBucketMetadata as ItemBucketMetadata$1, Client } from 'minio';
 
 type ItemBucketMetadata = Record<string, string>;
-type UploadedObjectInfo$1 = {
+type UploadedObjectInfo = {
     etag: string;
     lastModified?: Date;
     size?: number;
     versionId: string;
     metadata?: ItemBucketMetadata;
 };
-type StatObjectResult$1 = {
+type StatObjectResult = {
     size: number;
     etag: string;
     lastModified: Date;
     metaData: ItemBucketMetadata;
     versionId?: string | null;
+    standardHeaders: {
+        contentType?: string;
+        cacheControl?: string;
+        contentDisposition?: string;
+        contentEncoding?: string;
+        contentLanguage?: string;
+    };
 };
-type ListFileObject$1 = {
+type ListFileObject = {
     name: string;
     size: number;
     lastModified: Date;
     etag: string;
 };
-type ListDirectoryObject$1 = {
+type ListDirectoryObject = {
     prefix: string;
     size: number;
 };
-type ListObjectResult$1 = ListFileObject$1 | ListDirectoryObject$1;
-interface OssBaseOperation$1 {
+type ListObjectResult = ListFileObject | ListDirectoryObject;
+interface OssBaseOperation {
     prefix: string;
     /**
      * 设置前缀
@@ -64,20 +68,20 @@ interface OssBaseOperation$1 {
         isStream?: boolean;
         size?: number;
         contentType?: string;
-    }): Promise<UploadedObjectInfo$1>;
+    }): Promise<UploadedObjectInfo>;
     /**
      * 上传文件
      * @param objectName 对象名
      * @param filePath 文件路径
      * @param metaData 元数据
      */
-    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo$1>;
+    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo>;
     /**
      * 获取对象信息
      * @param objectName 对象名
      * @param checkFile 是否检查文件存在（不存在返回null而非抛错）
      */
-    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult$1 | null>;
+    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult | null>;
     /**
      * 删除对象
      * @param objectName 对象名
@@ -95,7 +99,7 @@ interface OssBaseOperation$1 {
         startAfter?: string;
         /** 最大返回数量 */
         maxKeys?: number;
-    }): Promise<ListObjectResult$1[]>;
+    }): Promise<ListObjectResult[]>;
     /**
      * 获取完整的对象名称
      * @param objectName 对象名
@@ -110,7 +114,7 @@ interface OssBaseOperation$1 {
     checkObjectHash?(objectName: string, hash: string, meta?: ItemBucketMetadata): Promise<{
         success: boolean;
         metaData: ItemBucketMetadata | null;
-        obj: StatObjectResult$1 | null;
+        obj: StatObjectResult | null;
         equalMeta?: boolean;
     }>;
     /**
@@ -132,7 +136,7 @@ interface OssBaseOperation$1 {
      */
     replaceObject?(objectName: string, meta: ItemBucketMetadata): Promise<any>;
 }
-interface OssService$1 extends OssBaseOperation$1 {
+interface OssService extends OssBaseOperation {
     owner: string;
 }
 
@@ -152,7 +156,7 @@ type OssBaseOptions<T = {
      */
     prefix?: string;
 } & T;
-declare class OssBase implements OssBaseOperation$1 {
+declare class OssBase implements OssBaseOperation {
     client: S3Client;
     bucketName: string;
     prefix: string;
@@ -189,14 +193,14 @@ declare class OssBase implements OssBaseOperation$1 {
         isStream?: boolean;
         size?: number;
         contentType?: string;
-    }): Promise<UploadedObjectInfo$1>;
+    }): Promise<UploadedObjectInfo>;
     /**
      * 上传文件
      * @param objectName 对象名
      * @param filePath 文件路径
      * @param metaData 元数据
      */
-    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo$1>;
+    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo>;
     /**
      * 删除对象
      * @param objectName 对象名
@@ -212,13 +216,13 @@ declare class OssBase implements OssBaseOperation$1 {
         recursive?: boolean;
         startAfter?: string;
         maxKeys?: number;
-    }): Promise<IS_FILE extends true ? ListFileObject$1[] : ListObjectResult$1[]>;
+    }): Promise<IS_FILE extends true ? ListFileObject[] : ListObjectResult[]>;
     /**
      * 获取对象信息
      * @param objectName 对象名
      * @param checkFile 是否检查文件存在（不存在返回null而非抛错）
      */
-    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult$1 | null>;
+    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult | null>;
     /**
      * 获取完整的对象名称
      * @param objectName 对象名
@@ -233,7 +237,7 @@ declare class OssBase implements OssBaseOperation$1 {
     checkObjectHash(objectName: string, hash: string, meta?: ItemBucketMetadata): Promise<{
         success: boolean;
         metaData: ItemBucketMetadata | null;
-        obj: StatObjectResult$1 | null;
+        obj: StatObjectResult | null;
         equalMeta?: boolean;
     }>;
     /**
@@ -267,18 +271,18 @@ declare class OssBase implements OssBaseOperation$1 {
     }): T;
 }
 
-declare class ConfigOssService extends OssBase implements OssService$1 {
+declare class ConfigOssService extends OssBase implements OssService {
     owner: string;
     constructor(opts: OssBaseOptions<{
         owner: string;
     }>);
-    listAllFile(): Promise<ListFileObject$1[]>;
-    listAll(): Promise<ListObjectResult$1[]>;
+    listAllFile(): Promise<ListFileObject[]>;
+    listAll(): Promise<ListObjectResult[]>;
     configMap: Map<string, any>;
     keys: string[];
-    getAllConfigJson(): Promise<ListFileObject$1[]>;
+    getAllConfigJson(): Promise<ListFileObject[]>;
     isEndWithJson(string: string): boolean;
-    putJsonObject(key: string, data: any): Promise<UploadedObjectInfo$1>;
+    putJsonObject(key: string, data: any): Promise<UploadedObjectInfo>;
     getObjectList(objectNameList: string[]): Promise<Map<string, Record<string, any>>>;
     getList(): Promise<{
         list: {
@@ -293,25 +297,6 @@ declare class ConfigOssService extends OssBase implements OssService$1 {
     }>;
 }
 
-/**
- * 过滤 metaData 中的 key, 去除 password, accesskey, secretkey，
- * 并返回过滤后的 metaData
- * @param metaData
- * @returns
- */
-declare const filterMetaDataKeys: (metaData: Record<string, string>, clearKeys?: string[]) => Record<string, string>;
-type SendObjectOptions = {
-    res: ServerResponse;
-    client: OssBase;
-    objectName: string;
-    isDownload?: boolean;
-};
-declare const NotFoundFile: (res: ServerResponse, msg?: string, code?: number) => void;
-declare const sendObject: ({ res, objectName, client, isDownload }: SendObjectOptions) => Promise<void>;
-declare const downloadObject: ({ objectName, client, filePath }: Pick<SendObjectOptions, "objectName" | "client"> & {
-    filePath: string;
-}) => Promise<_aws_sdk_client_s3.GetObjectCommandOutput>;
-
 /**
  * 计算字符串的md5值
  * @param str
@@ -341,88 +326,5 @@ declare function extractStandardHeaders(metaData: Record<string, string>): {
     customMetadata: Record<string, string>;
 };
 
-type UploadedObjectInfo = {
-    etag: string;
-    lastModified?: Date;
-    size?: number;
-    versionId: string;
-    metadata?: ItemBucketMetadata$1;
-};
-type StatObjectResult = {
-    size: number;
-    etag: string;
-    lastModified: Date;
-    metaData: ItemBucketMetadata$1;
-    versionId?: string | null;
-};
-type ListFileObject = {
-    name: string;
-    size: number;
-    lastModified: Date;
-    etag: string;
-};
-type ListDirectoryObject = {
-    prefix: string;
-    size: number;
-};
-type ListObjectResult = ListFileObject | ListDirectoryObject;
-interface OssBaseOperation {
-    prefix: string;
-    setPrefix(prefix: string): void;
-    /**
-     * 获取对象
-     * @param objectName 对象名
-     */
-    getObject(objectName: string): Promise<any>;
-    /**
-     * 上传对象
-     * @param objectName 对象名
-     * @param data 数据
-     */
-    putObject(objectName: string, data: Buffer | string, metaData?: ItemBucketMetadata$1): Promise<UploadedObjectInfo>;
-    /**
-     * 上传文件
-     * @param objectName 对象名
-     * @param filePath 文件路径
-     */
-    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata$1): Promise<UploadedObjectInfo>;
-    /**
-     * 获取对象信息
-     * @param objectName 对象名
-     */
-    statObject(objectName: string): Promise<StatObjectResult>;
-    /**
-     * 删除对象
-     * @param objectName 对象名
-     */
-    deleteObject(objectName: string): Promise<any>;
-    /**
-     * 列出对象
-     * @param objectName 对象名
-     * @param opts 选项
-     * @param opts.recursive 是否递归
-     * @param opts.startAfter 开始位置
-     */
-    listObjects(objectName: string, opts?: {
-        /**
-         * 是否递归
-         */
-        recursive?: boolean;
-        /**
-         * 开始位置
-         */
-        startAfter?: string;
-    }): Promise<ListObjectResult[]>;
-    /**
-     * 复制对象
-     * @param sourceObject 源对象
-     * @param targetObject 目标对象
-     */
-    copyObject: Client['copyObject'];
-}
-interface OssService extends OssBaseOperation {
-    owner: string;
-}
-
-export { ConfigOssService, NotFoundFile, OssBase, downloadObject, extractStandardHeaders, filterMetaDataKeys, getContentType, hash, hashSringify, sendObject, standardHeaderKeys };
-export type { ListDirectoryObject, ListFileObject, ListObjectResult, OssBaseOperation, OssBaseOptions, OssService, StandardHeaders, StatObjectResult, UploadedObjectInfo };
+export { ConfigOssService, OssBase, extractStandardHeaders, getContentType, hash, hashSringify, standardHeaderKeys };
+export type { ItemBucketMetadata, ListDirectoryObject, ListFileObject, ListObjectResult, OssBaseOperation, OssBaseOptions, OssService, StandardHeaders, StatObjectResult, UploadedObjectInfo };

package/dist/services.js

@@ -36456,15 +36456,21 @@ class OssBase {
         contentLength = Buffer.byteLength(putData);
       }
     } else {
-      putData = data;
       if (!contentLength) {
-        throw new Error("Stream upload requires size parameter");
+        const chunks = [];
+        for await (const chunk of data) {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        putData = Buffer.concat(chunks);
+        contentLength = putData.length;
+      } else {
+        putData = data;
       }
     }
     if (opts?.check) {
       const obj = await this.statObject(objectName, true);
       if (obj) {
-        const omitMeta = ["size", "Content-Type", "Cache-Control", "app-source"];
+        const omitMeta = ["size", "content-type", "cache-control", "app-source"];
         const objMeta = JSON.parse(JSON.stringify(omit(obj.metaData, omitMeta)));
         metaData = {
           ...objMeta,
@@ -36493,22 +36499,41 @@ class OssBase {
     };
   }
   async fPutObject(objectName, filePath, metaData) {
-    const fileStream = fs.createReadStream(filePath);
     const stat = fs.statSync(filePath);
     const { standardHeaders, customMetadata } = extractStandardHeaders(metaData || {});
-    const command = new import_client_s3.PutObjectCommand({
-      Bucket: this.bucketName,
-      Key: `${this.prefix}${objectName}`,
-      Body: fileStream,
-      ContentLength: stat.size,
-      ContentType: standardHeaders.ContentType || getContentType(filePath),
-      CacheControl: standardHeaders.CacheControl,
-      ContentDisposition: standardHeaders.ContentDisposition,
-      ContentEncoding: standardHeaders.ContentEncoding,
-      ContentLanguage: standardHeaders.ContentLanguage,
-      Expires: standardHeaders.Expires,
-      Metadata: customMetadata
-    });
+    const THRESHOLD = 5 * 1024 * 1024;
+    let command;
+    if (stat.size < THRESHOLD) {
+      const fileBuffer = await fs.promises.readFile(filePath);
+      command = new import_client_s3.PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileBuffer,
+        ContentLength: fileBuffer.length,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata
+      });
+    } else {
+      const fileStream = fs.createReadStream(filePath);
+      command = new import_client_s3.PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileStream,
+        ContentLength: stat.size,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata
+      });
+    }
     const response = await this.client.send(command);
     return {
       etag: response.ETag?.replace(/"/g, "") || "",
@@ -36571,6 +36596,13 @@ class OssBase {
       });
       const response = await this.client.send(command);
       return {
+        standardHeaders: {
+          contentType: response.ContentType,
+          cacheControl: response.CacheControl,
+          contentDisposition: response.ContentDisposition,
+          contentEncoding: response.ContentEncoding,
+          contentLanguage: response.ContentLanguage
+        },
         size: response.ContentLength || 0,
         etag: response.ETag?.replace?.(/"/g, "") || "",
         lastModified: response.LastModified || new Date,
@@ -36578,11 +36610,11 @@ class OssBase {
         versionId: response.VersionId || null
       };
     } catch (e) {
-      console.error("statObject error", e);
       const isNotFound = e.name === "NotFound" || e.name === "NoSuchBucket" || e.name === "NoSuchKey" || e.code === "NotFound" || e.code === "NoSuchBucket" || e.code === "NoSuchKey" || e.$metadata?.httpStatusCode === 404;
       if (checkFile && isNotFound) {
         return null;
       }
+      console.error("statObject error", e);
       throw e;
     }
   }
@@ -36723,69 +36755,12 @@ class ConfigOssService extends OssBase {
     return { list: listKeys, keys, keyEtagMap };
   }
 }
-// src/util/download.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
-var viewableExtensions = ["jpg", "jpeg", "png", "gif", "svg", "webp", "mp4", "webm", "mp3", "wav", "ogg", "pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx"];
-var filterMetaDataKeys = (metaData, clearKeys = []) => {
-  const keys = Object.keys(metaData);
-  const removeKeys = ["password", "accesskey", "secretkey", ...clearKeys];
-  const filteredKeys = keys.filter((key) => !removeKeys.includes(key));
-  return filteredKeys.reduce((acc, key) => {
-    acc[key] = metaData[key];
-    return acc;
-  }, {});
-};
-var NotFoundFile = (res, msg, code = 404) => {
-  res.writeHead(code, { "Content-Type": "text/plain" });
-  res.end(msg || "Not Found File");
-  return;
-};
-var sendObject = async ({ res, objectName, client, isDownload = false }) => {
-  let stat;
-  try {
-    stat = await client.statObject(objectName);
-  } catch (e) {} finally {
-    if (!stat || stat.size === 0) {
-      return NotFoundFile(res);
-    }
-    const contentLength = stat.size;
-    const etag = stat.etag;
-    const lastModified = stat.lastModified.toISOString();
-    const filename = objectName.split("/").pop() || "no-file-name-download";
-    const fileExtension = filename.split(".").pop()?.toLowerCase() || "";
-    const filteredMetaData = filterMetaDataKeys(stat.metaData, ["size", "etag", "last-modified"]);
-    const contentDisposition = viewableExtensions.includes(fileExtension) && !isDownload ? "inline" : `attachment; filename="${filename}"`;
-    res.writeHead(200, {
-      "Content-Length": contentLength,
-      etag,
-      "last-modified": lastModified,
-      "Content-Disposition": contentDisposition,
-      ...filteredMetaData
-    });
-    const objectStream = await client.getObject(objectName);
-    objectStream.pipe(res, { end: true });
-  }
-};
-var downloadObject = async ({ objectName, client, filePath }) => {
-  const objectStream = await client.getObject(objectName);
-  const dir = path2.dirname(filePath);
-  if (!fs2.existsSync(dir)) {
-    fs2.mkdirSync(dir, { recursive: true });
-  }
-  objectStream.pipe(fs2.createWriteStream(filePath));
-  return objectStream;
-};
 export {
   standardHeaderKeys,
-  sendObject,
   hashSringify,
   hash,
   getContentType,
-  filterMetaDataKeys,
   extractStandardHeaders,
-  downloadObject,
   OssBase,
-  NotFoundFile,
   ConfigOssService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevisual/oss",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "main": "dist/index.js",
   "scripts": {
     "build": "bun run bun.config.ts"
@@ -21,8 +21,7 @@
     "bun-plugin-dts": "^0.3.0",
     "dotenv": "^17.2.3",
     "es-toolkit": "^1.44.0",
-    "fast-glob": "^3.3.3",
-    "minio": "^8.0.6"
+    "fast-glob": "^3.3.3"
   },
   "exports": {
     ".": {

package/src/index.ts

@@ -1 +1,3 @@
-export * from './s3/core.ts'
+export * from './s3/core.ts'
+
+export * from './s3/type.ts'

package/src/s3/core.ts

@@ -127,9 +127,16 @@ export class OssBase implements OssBaseOperation {
         contentLength = Buffer.byteLength(putData);
       }
     } else {
-      putData = data as Readable;
+      // Stream 上传：自动读取到 Buffer 以获取 contentLength
       if (!contentLength) {
-        throw new Error('Stream upload requires size parameter');
+        const chunks: Buffer[] = [];
+        for await (const chunk of data as Readable) {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        putData = Buffer.concat(chunks);
+        contentLength = putData.length;
+      } else {
+        putData = data as Readable;
       }
     }
 
@@ -137,7 +144,7 @@ export class OssBase implements OssBaseOperation {
     if (opts?.check) {
       const obj = await this.statObject(objectName, true);
       if (obj) {
-        const omitMeta = ['size', 'Content-Type', 'Cache-Control', 'app-source'];
+        const omitMeta = ['size', 'content-type', 'cache-control', 'app-source'];
         const objMeta = JSON.parse(JSON.stringify(omit(obj.metaData, omitMeta)));
         metaData = {
           ...objMeta,
@@ -180,24 +187,45 @@ export class OssBase implements OssBaseOperation {
     filePath: string,
     metaData?: ItemBucketMetadata,
   ): Promise<UploadedObjectInfo> {
-    const fileStream = fs.createReadStream(filePath);
     const stat = fs.statSync(filePath);
-
     const { standardHeaders, customMetadata } = extractStandardHeaders(metaData || {});
 
-    const command = new PutObjectCommand({
-      Bucket: this.bucketName,
-      Key: `${this.prefix}${objectName}`,
-      Body: fileStream,
-      ContentLength: stat.size,
-      ContentType: standardHeaders.ContentType || getContentType(filePath),
-      CacheControl: standardHeaders.CacheControl,
-      ContentDisposition: standardHeaders.ContentDisposition,
-      ContentEncoding: standardHeaders.ContentEncoding,
-      ContentLanguage: standardHeaders.ContentLanguage,
-      Expires: standardHeaders.Expires,
-      Metadata: customMetadata,
-    });
+    const THRESHOLD = 5 * 1024 * 1024; // 5MB
+    let command: PutObjectCommand;
+
+    if (stat.size < THRESHOLD) {
+      // 小文件：读取到内存再上传，避免流式传输导致的 IncompleteBody 错误
+      const fileBuffer = await fs.promises.readFile(filePath);
+      command = new PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileBuffer,
+        ContentLength: fileBuffer.length,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata,
+      });
+    } else {
+      // 大文件：使用流式上传
+      const fileStream = fs.createReadStream(filePath);
+      command = new PutObjectCommand({
+        Bucket: this.bucketName,
+        Key: `${this.prefix}${objectName}`,
+        Body: fileStream,
+        ContentLength: stat.size,
+        ContentType: standardHeaders.ContentType || getContentType(filePath),
+        CacheControl: standardHeaders.CacheControl,
+        ContentDisposition: standardHeaders.ContentDisposition,
+        ContentEncoding: standardHeaders.ContentEncoding,
+        ContentLanguage: standardHeaders.ContentLanguage,
+        Expires: standardHeaders.Expires,
+        Metadata: customMetadata,
+      });
+    }
 
     const response = await this.client.send(command);
     return {
@@ -290,6 +318,13 @@ export class OssBase implements OssBaseOperation {
       const response = await this.client.send(command);
 
       return {
+        standardHeaders: {
+          contentType: response.ContentType,
+          cacheControl: response.CacheControl,
+          contentDisposition: response.ContentDisposition,
+          contentEncoding: response.ContentEncoding,
+          contentLanguage: response.ContentLanguage,
+        },
         size: response.ContentLength || 0,
         etag: response.ETag?.replace?.(/"/g, '') || '',
         lastModified: response.LastModified || new Date(),
@@ -297,7 +332,6 @@ export class OssBase implements OssBaseOperation {
         versionId: response.VersionId || null,
       };
     } catch (e: any) {
-      console.error('statObject error', e);
       // 检查是否是 404 错误 - 支持多种 S3 兼容存储的错误格式
       const isNotFound =
         e.name === 'NotFound' ||
@@ -311,6 +345,7 @@ export class OssBase implements OssBaseOperation {
       if (checkFile && isNotFound) {
         return null;
       }
+      console.error('statObject error', e);
       throw e;
     }
   }
@@ -438,4 +473,11 @@ export class OssBase implements OssBaseOperation {
       ...opts,
     });
   }
+}
+
+export const getStram = (data: GetObjectCommandOutput) => {
+  if (data.Body) {
+    return data.Body as Readable;
+  }
+  throw new Error('Object body is empty');
 }

package/src/s3/type.ts

@@ -17,6 +17,13 @@ export type StatObjectResult = {
   lastModified: Date;
   metaData: ItemBucketMetadata;
   versionId?: string | null;
+  standardHeaders: {
+    contentType?: string;
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    contentLanguage?: string;
+  }
 };
 
 export type ListFileObject = {

package/src/services/index.ts

@@ -6,4 +6,4 @@ export * from '../util/download.ts';
 
 export * from '../util/index.ts';
 
-export * from '../core/type.ts';
+export * from '../s3/type.ts';

package/src/util/download.ts

@@ -1,73 +1,73 @@
-import { ServerResponse } from 'node:http';
-import { BucketItemStat } from 'minio';
-import fs from 'node:fs';
-import path from 'node:path';
+// import { ServerResponse } from 'node:http';
+// import { BucketItemStat } from 'minio';
+// import fs from 'node:fs';
+// import path from 'node:path';
 
-const viewableExtensions = ['jpg', 'jpeg', 'png', 'gif', 'svg', 'webp', 'mp4', 'webm', 'mp3', 'wav', 'ogg', 'pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx'];
-import { OssBase } from '../index.ts';
-/**
- * 过滤 metaData 中的 key, 去除 password, accesskey, secretkey，
- * 并返回过滤后的 metaData
- * @param metaData
- * @returns
- */
-export const filterMetaDataKeys = (metaData: Record<string, string>, clearKeys: string[] = []) => {
-  const keys = Object.keys(metaData);
-  // remove X-Amz- meta data
-  const removeKeys = ['password', 'accesskey', 'secretkey', ...clearKeys];
-  const filteredKeys = keys.filter((key) => !removeKeys.includes(key));
-  return filteredKeys.reduce((acc, key) => {
-    acc[key] = metaData[key];
-    return acc;
-  }, {} as Record<string, string>);
-};
-type SendObjectOptions = {
-  res: ServerResponse;
-  client: OssBase;
-  objectName: string;
-  isDownload?: boolean;
-};
-export const NotFoundFile = (res: ServerResponse, msg?: string, code = 404) => {
-  res.writeHead(code, { 'Content-Type': 'text/plain' });
-  res.end(msg || 'Not Found File');
-  return;
-};
-export const sendObject = async ({ res, objectName, client, isDownload = false }: SendObjectOptions) => {
-  let stat: BucketItemStat;
-  try {
-    stat = await client.statObject(objectName);
-  } catch (e) {
-  } finally {
-    if (!stat || stat.size === 0) {
-      return NotFoundFile(res);
-    }
-    const contentLength = stat.size;
-    const etag = stat.etag;
-    const lastModified = stat.lastModified.toISOString();
-    const filename = objectName.split('/').pop() || 'no-file-name-download'; // Extract filename from objectName
-    const fileExtension = filename.split('.').pop()?.toLowerCase() || '';
-    const filteredMetaData = filterMetaDataKeys(stat.metaData, ['size', 'etag', 'last-modified']);
-    const contentDisposition = viewableExtensions.includes(fileExtension) && !isDownload ? 'inline' : `attachment; filename="${filename}"`;
+// const viewableExtensions = ['jpg', 'jpeg', 'png', 'gif', 'svg', 'webp', 'mp4', 'webm', 'mp3', 'wav', 'ogg', 'pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx'];
+// import { OssBase } from '../index.ts';
+// /**
+//  * 过滤 metaData 中的 key, 去除 password, accesskey, secretkey，
+//  * 并返回过滤后的 metaData
+//  * @param metaData
+//  * @returns
+//  */
+// export const filterMetaDataKeys = (metaData: Record<string, string>, clearKeys: string[] = []) => {
+//   const keys = Object.keys(metaData);
+//   // remove X-Amz- meta data
+//   const removeKeys = ['password', 'accesskey', 'secretkey', ...clearKeys];
+//   const filteredKeys = keys.filter((key) => !removeKeys.includes(key));
+//   return filteredKeys.reduce((acc, key) => {
+//     acc[key] = metaData[key];
+//     return acc;
+//   }, {} as Record<string, string>);
+// };
+// type SendObjectOptions = {
+//   res: ServerResponse;
+//   client: OssBase;
+//   objectName: string;
+//   isDownload?: boolean;
+// };
+// export const NotFoundFile = (res: ServerResponse, msg?: string, code = 404) => {
+//   res.writeHead(code, { 'Content-Type': 'text/plain' });
+//   res.end(msg || 'Not Found File');
+//   return;
+// };
+// export const sendObject = async ({ res, objectName, client, isDownload = false }: SendObjectOptions) => {
+//   let stat: BucketItemStat;
+//   try {
+//     stat = await client.statObject(objectName);
+//   } catch (e) {
+//   } finally {
+//     if (!stat || stat.size === 0) {
+//       return NotFoundFile(res);
+//     }
+//     const contentLength = stat.size;
+//     const etag = stat.etag;
+//     const lastModified = stat.lastModified.toISOString();
+//     const filename = objectName.split('/').pop() || 'no-file-name-download'; // Extract filename from objectName
+//     const fileExtension = filename.split('.').pop()?.toLowerCase() || '';
+//     const filteredMetaData = filterMetaDataKeys(stat.metaData, ['size', 'etag', 'last-modified']);
+//     const contentDisposition = viewableExtensions.includes(fileExtension) && !isDownload ? 'inline' : `attachment; filename="${filename}"`;
 
-    res.writeHead(200, {
-      'Content-Length': contentLength,
-      etag,
-      'last-modified': lastModified,
-      'Content-Disposition': contentDisposition,
-      ...filteredMetaData,
-    });
-    const objectStream = await client.getObject(objectName);
+//     res.writeHead(200, {
+//       'Content-Length': contentLength,
+//       etag,
+//       'last-modified': lastModified,
+//       'Content-Disposition': contentDisposition,
+//       ...filteredMetaData,
+//     });
+//     const objectStream = await client.getObject(objectName);
 
-    objectStream.pipe(res, { end: true });
-  }
-};
+//     objectStream.pipe(res, { end: true });
+//   }
+// };
 
-export const downloadObject = async ({ objectName, client, filePath }: Pick<SendObjectOptions, 'objectName' | 'client'> & { filePath: string }) => {
-  const objectStream = await client.getObject(objectName);
-  const dir = path.dirname(filePath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  objectStream.pipe(fs.createWriteStream(filePath));
-  return objectStream;
-};
+// export const downloadObject = async ({ objectName, client, filePath }: Pick<SendObjectOptions, 'objectName' | 'client'> & { filePath: string }) => {
+//   const objectStream = await client.getObject(objectName);
+//   const dir = path.dirname(filePath);
+//   if (!fs.existsSync(dir)) {
+//     fs.mkdirSync(dir, { recursive: true });
+//   }
+//   objectStream.pipe(fs.createWriteStream(filePath));
+//   return objectStream;
+// };

package/src/core/copy-object.ts

@@ -1,26 +0,0 @@
-import { Client, CopyDestinationOptions, CopySourceOptions } from 'minio';
-
-type CopyObjectOpts = {
-  bucketName: string;
-  newMetadata: Record<string, string>;
-  objectName: string;
-  client: Client;
-};
-/**
- * 复制对象 REPLACE 替换
- * @param param0
- * @returns
- */
-export const copyObject = async ({ bucketName, newMetadata, objectName, client }: CopyObjectOpts) => {
-  const source = new CopySourceOptions({ Bucket: bucketName, Object: objectName });
-  const stat = await client.statObject(bucketName, objectName);
-  const sourceMetadata = stat.metaData;
-  const destination = new CopyDestinationOptions({
-    Bucket: bucketName,
-    Object: objectName,
-    UserMetadata: { ...sourceMetadata, ...newMetadata },
-    MetadataDirective: 'REPLACE',
-  });
-  const copyResult = await client.copyObject(source, destination);
-  return copyResult;
-};

package/src/core/core.ts

@@ -1,244 +0,0 @@
-import { Client, ItemBucketMetadata } from 'minio';
-import { ListFileObject, ListObjectResult, OssBaseOperation } from './type.ts';
-import { hash } from '../util/hash.ts';
-import { copyObject } from './copy-object.ts';
-import { getContentType } from '../util/get-content-type.ts';
-import { omit } from 'es-toolkit'
-export type OssBaseOptions<T = { [key: string]: any }> = {
-  /**
-   * 已经初始化好的minio client
-   */
-  client: Client;
-  /**
-   * 桶名
-   */
-  bucketName: string;
-  /**
-   * 前缀
-   */
-  prefix?: string;
-} & T;
-
-export class OssBase implements OssBaseOperation {
-  client?: Client;
-  bucketName: string;
-  prefix = '';
-  /**
-   * 计算字符串或者对象的的md5值
-   */
-  hash = hash;
-  constructor(opts: OssBaseOptions) {
-    if (!opts.client) {
-      throw new Error('client is required');
-    }
-    this.bucketName = opts.bucketName;
-    this.client = opts.client;
-    this.prefix = opts?.prefix ?? '';
-  }
-
-  setPrefix(prefix: string) {
-    this.prefix = prefix;
-  }
-
-  async getObject(objectName: string) {
-    const bucketName = this.bucketName;
-    const obj = await this.client.getObject(bucketName, `${this.prefix}${objectName}`);
-    return obj;
-  }
-
-  async getJson(objectName: string): Promise<Record<string, any>> {
-    const obj = await this.getObject(objectName);
-    return new Promise((resolve, reject) => {
-      let data = '';
-      obj.on('data', (chunk) => {
-        data += chunk;
-      });
-      obj.on('end', () => {
-        try {
-          const jsonData = JSON.parse(data);
-          resolve(jsonData);
-        } catch (error) {
-          reject(new Error('Failed to parse JSON'));
-        }
-      });
-      obj.on('error', (err) => {
-        reject(err);
-      });
-    });
-  }
-  /**
-   * 上传文件, 当是流的时候，中断之后的etag会变，所以传递的时候不要嵌套async await，例如 busboy 监听文件流内部的时候，不要用check
-   * @param objectName
-   * @param data
-   * @param metaData
-   * @param options 如果文件本身存在，则复制原有的meta的内容
-   * @returns
-   */
-  async putObject(
-    objectName: string,
-    data: Buffer | string | Object,
-    metaData: ItemBucketMetadata = {},
-    opts?: { check?: boolean; isStream?: boolean; size?: number },
-  ) {
-    let putData: Buffer | string;
-    let size: number = opts?.size;
-    const isStream = opts?.isStream;
-    if (!isStream) {
-      if (typeof data === 'string') {
-        putData = data;
-        size = putData.length;
-      } else {
-        putData = JSON.stringify(data);
-        size = putData.length;
-      }
-    } else {
-      putData = data as any;
-      // 对于流式上传，如果没有提供 size，会导致多部分上传，ETag 会是 ****-1 格式
-      // 必须提供准确的 size 才能得到标准的 MD5 格式 ETag
-      if (!size) {
-        throw new Error('Stream upload requires size parameter to avoid multipart upload and get standard MD5 ETag');
-      }
-    }
-    if (opts?.check) {
-      const obj = await this.statObject(objectName, true);
-      if (obj) {
-        const omitMeda = ['size', 'content-type', 'cache-control', 'app-source'];
-        const objMeta = JSON.parse(JSON.stringify(omit(obj.metaData, omitMeda)));
-        metaData = {
-          ...objMeta,
-          ...metaData,
-        };
-      }
-    }
-
-    const bucketName = this.bucketName;
-    const obj = await this.client.putObject(bucketName, `${this.prefix}${objectName}`, putData, size, metaData);
-    return obj;
-  }
-
-  async deleteObject(objectName: string) {
-    const bucketName = this.bucketName;
-    const obj = await this.client.removeObject(bucketName, `${this.prefix}${objectName}`);
-    return obj;
-  }
-
-  async listObjects<IS_FILE = false>(objectName: string, opts?: { recursive?: boolean; startAfter?: string }) {
-    const bucketName = this.bucketName;
-    const prefix = `${this.prefix}${objectName}`;
-    const res = await new Promise((resolve, reject) => {
-      let res: any[] = [];
-      let hasError = false;
-      this.client
-        .listObjectsV2(bucketName, prefix, opts?.recursive ?? false, opts?.startAfter)
-        .on('data', (data) => {
-          res.push(data);
-        })
-        .on('error', (err) => {
-          console.error('minio error', prefix, err);
-          hasError = true;
-        })
-        .on('end', () => {
-          if (hasError) {
-            reject();
-            return;
-          } else {
-            resolve(res);
-          }
-        });
-    });
-    return res as IS_FILE extends true ? ListFileObject[] : ListObjectResult[];
-  }
-
-  async fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata) {
-    const bucketName = this.bucketName;
-    const obj = await this.client.fPutObject(bucketName, `${this.prefix}${objectName}`, filePath, metaData);
-    return obj as any;
-  }
-  /**
-   * 获取完整的对象名称
-   * @param objectName
-   * @returns
-   */
-  async getObjectName(objectName: string) {
-    return `${this.prefix}${objectName}`;
-  }
-  async statObject(objectName: string, checkFile = true) {
-    const bucketName = this.bucketName;
-    try {
-      const obj = await this.client.statObject(bucketName, `${this.prefix}${objectName}`);
-      return obj;
-    } catch (e) {
-      if (e.code === 'NotFound') {
-        return null;
-      }
-      throw e;
-    }
-  }
-  /**
-   * 检查文件hash是否一致
-   * @param objectName
-   * @param hash
-   * @returns
-   */
-  async checkObjectHash(
-    objectName: string,
-    hash: string,
-    meta?: ItemBucketMetadata,
-  ): Promise<{ success: boolean; metaData: ItemBucketMetadata | null; obj: any; equalMeta?: boolean }> {
-    const obj = await this.statObject(`${this.prefix}${objectName}`, true);
-    if (!obj) {
-      return { success: false, metaData: null, obj: null, equalMeta: false };
-    }
-    let metaData: ItemBucketMetadata = {};
-    const omitMeda = ['content-type', 'cache-control', 'app-source'];
-    const objMeta = omit(obj.metaData, omitMeda);
-    metaData = {
-      ...objMeta,
-    };
-    let equalMeta = false;
-    if (meta) {
-      equalMeta = JSON.stringify(metaData) === JSON.stringify(meta);
-    }
-    return { success: obj.etag === hash, metaData, obj, equalMeta };
-  }
-  getMetadata(pathname: string, meta: ItemBucketMetadata = { 'app-source': 'user-app' }) {
-    const isHtml = pathname.endsWith('.html');
-    if (isHtml) {
-      meta = {
-        ...meta,
-        'content-type': 'text/html; charset=utf-8',
-        'cache-control': 'no-cache',
-      };
-    } else {
-      meta = {
-        ...meta,
-        'content-type': getContentType(pathname),
-        'cache-control': 'max-age=31536000, immutable',
-      };
-    }
-    return meta;
-  }
-
-  async copyObject(sourceObject: any, targetObject: any) {
-    const bucketName = this.bucketName;
-    const obj = await this.client.copyObject(bucketName, sourceObject, targetObject);
-    return obj;
-  }
-  async replaceObject(objectName: string, meta: { [key: string]: string }) {
-    const { bucketName, client } = this;
-    return copyObject({ bucketName, client, objectName: `${this.prefix}${objectName}`, newMetadata: meta });
-  }
-  static create<T extends OssBase, U>(this: new (opts: OssBaseOptions<U>) => T, opts: OssBaseOptions<U>): T {
-    return new this(opts);
-  }
-
-  static fromBase<T extends OssBase, U>(this: new (opts: OssBaseOptions<U>) => T, createOpts: { oss: OssBase; opts: Partial<OssBaseOptions<U>> }): T {
-    const base = createOpts.oss;
-    const opts = createOpts.opts as any;
-    return new this({
-      client: base.client,
-      bucketName: base.bucketName,
-      ...opts,
-    });
-  }
-}

package/src/core/type.ts

@@ -1,87 +0,0 @@
-import { ItemBucketMetadata, Client } from 'minio';
-export type UploadedObjectInfo = {
-  etag: string;
-  lastModified?: Date;
-  size?: number;
-  versionId: string;
-  metadata?: ItemBucketMetadata;
-};
-export type StatObjectResult = {
-  size: number;
-  etag: string;
-  lastModified: Date;
-  metaData: ItemBucketMetadata;
-  versionId?: string | null;
-};
-export type ListFileObject = {
-  name: string;
-  size: number;
-  lastModified: Date;
-  etag: string;
-};
-export type ListDirectoryObject = {
-  prefix: string;
-  size: number;
-};
-export type ListObjectResult = ListFileObject | ListDirectoryObject;
-export interface OssBaseOperation {
-  prefix: string;
-  setPrefix(prefix: string): void;
-  /**
-   * 获取对象
-   * @param objectName 对象名
-   */
-  getObject(objectName: string): Promise<any>;
-  /**
-   * 上传对象
-   * @param objectName 对象名
-   * @param data 数据
-   */
-  putObject(objectName: string, data: Buffer | string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo>;
-  /**
-   * 上传文件
-   * @param objectName 对象名
-   * @param filePath 文件路径
-   */
-  fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo>;
-  /**
-   * 获取对象信息
-   * @param objectName 对象名
-   */
-  statObject(objectName: string): Promise<StatObjectResult>;
-  /**
-   * 删除对象
-   * @param objectName 对象名
-   */
-  deleteObject(objectName: string): Promise<any>;
-  /**
-   * 列出对象
-   * @param objectName 对象名
-   * @param opts 选项
-   * @param opts.recursive 是否递归
-   * @param opts.startAfter 开始位置
-   */
-  listObjects(
-    objectName: string,
-    opts?: {
-      /**
-       * 是否递归
-       */
-      recursive?: boolean;
-      /**
-       * 开始位置
-       */
-      startAfter?: string;
-    },
-  ): Promise<ListObjectResult[]>;
-  /**
-   * 复制对象
-   * @param sourceObject 源对象
-   * @param targetObject 目标对象
-   */
-  copyObject: Client['copyObject'];
-}
-
-export interface OssService extends OssBaseOperation {
-  owner: string;
-}