@kevisual/oss 0.0.15 → 0.0.17

package/dist/services.d.ts

@@ -0,0 +1,428 @@
+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 = {
+    etag: string;
+    lastModified?: Date;
+    size?: number;
+    versionId: string;
+    metadata?: ItemBucketMetadata;
+};
+type StatObjectResult$1 = {
+    size: number;
+    etag: string;
+    lastModified: Date;
+    metaData: ItemBucketMetadata;
+    versionId?: string | null;
+};
+type ListFileObject$1 = {
+    name: string;
+    size: number;
+    lastModified: Date;
+    etag: string;
+};
+type ListDirectoryObject$1 = {
+    prefix: string;
+    size: number;
+};
+type ListObjectResult$1 = ListFileObject$1 | ListDirectoryObject$1;
+interface OssBaseOperation$1 {
+    prefix: string;
+    /**
+     * 设置前缀
+     * @param prefix 前缀
+     */
+    setPrefix(prefix: string): void;
+    /**
+     * 获取对象
+     * @param objectName 对象名
+     */
+    getObject(objectName: string): Promise<any>;
+    /**
+     * 获取对象内容为字符串
+     * @param objectName 对象名
+     */
+    getObjectAsString?(objectName: string): Promise<string>;
+    /**
+     * 获取对象内容为 JSON
+     * @param objectName 对象名
+     */
+    getJson?(objectName: string): Promise<Record<string, any>>;
+    /**
+     * 上传对象
+     * @param objectName 对象名
+     * @param data 数据
+     * @param metaData 元数据
+     * @param opts 选项
+     */
+    putObject(objectName: string, data: Buffer | string | Object | Readable, metaData?: ItemBucketMetadata, opts?: {
+        check?: boolean;
+        isStream?: boolean;
+        size?: number;
+        contentType?: string;
+    }): Promise<UploadedObjectInfo$1>;
+    /**
+     * 上传文件
+     * @param objectName 对象名
+     * @param filePath 文件路径
+     * @param metaData 元数据
+     */
+    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo$1>;
+    /**
+     * 获取对象信息
+     * @param objectName 对象名
+     * @param checkFile 是否检查文件存在（不存在返回null而非抛错）
+     */
+    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult$1 | null>;
+    /**
+     * 删除对象
+     * @param objectName 对象名
+     */
+    deleteObject(objectName: string): Promise<any>;
+    /**
+     * 列出对象
+     * @param objectName 前缀
+     * @param opts 选项
+     */
+    listObjects(objectName: string, opts?: {
+        /** 是否递归 */
+        recursive?: boolean;
+        /** 开始位置 */
+        startAfter?: string;
+        /** 最大返回数量 */
+        maxKeys?: number;
+    }): Promise<ListObjectResult$1[]>;
+    /**
+     * 获取完整的对象名称
+     * @param objectName 对象名
+     */
+    getObjectName?(objectName: string): string;
+    /**
+     * 检查文件hash是否一致
+     * @param objectName 对象名
+     * @param hash hash值
+     * @param meta 元数据
+     */
+    checkObjectHash?(objectName: string, hash: string, meta?: ItemBucketMetadata): Promise<{
+        success: boolean;
+        metaData: ItemBucketMetadata | null;
+        obj: StatObjectResult$1 | null;
+        equalMeta?: boolean;
+    }>;
+    /**
+     * 获取元数据
+     * @param pathname 路径名
+     * @param meta 元数据
+     */
+    getMetadata?(pathname: string, meta?: ItemBucketMetadata): ItemBucketMetadata;
+    /**
+     * 复制对象
+     * @param sourceObject 源对象
+     * @param targetObject 目标对象
+     */
+    copyObject(sourceObject: string, targetObject: string): Promise<CopyObjectCommandOutput>;
+    /**
+     * 替换对象元数据
+     * @param objectName 对象名
+     * @param meta 新元数据
+     */
+    replaceObject?(objectName: string, meta: ItemBucketMetadata): Promise<any>;
+}
+interface OssService$1 extends OssBaseOperation$1 {
+    owner: string;
+}
+
+type OssBaseOptions<T = {
+    [key: string]: any;
+}> = {
+    /**
+     * 已经初始化好的 S3Client
+     */
+    client: S3Client;
+    /**
+     * 桶名
+     */
+    bucketName: string;
+    /**
+     * 前缀
+     */
+    prefix?: string;
+} & T;
+declare class OssBase implements OssBaseOperation$1 {
+    client: S3Client;
+    bucketName: string;
+    prefix: string;
+    /**
+     * 计算字符串或者对象的的md5值
+     */
+    hash: (str: string | Buffer | Object) => string;
+    constructor(opts: OssBaseOptions);
+    setPrefix(prefix: string): void;
+    /**
+     * 获取对象
+     * @param objectName 对象名
+     */
+    getObject(objectName: string): Promise<GetObjectCommandOutput>;
+    /**
+     * 获取对象内容为字符串
+     * @param objectName 对象名
+     */
+    getObjectAsString(objectName: string): Promise<string>;
+    /**
+     * 获取对象内容为 JSON
+     * @param objectName 对象名
+     */
+    getJson(objectName: string): Promise<Record<string, any>>;
+    /**
+     * 上传对象
+     * @param objectName 对象名
+     * @param data 数据
+     * @param metaData 元数据
+     * @param opts 选项
+     */
+    putObject(objectName: string, data: Buffer | string | Object | Readable, metaData?: ItemBucketMetadata, opts?: {
+        check?: boolean;
+        isStream?: boolean;
+        size?: number;
+        contentType?: string;
+    }): Promise<UploadedObjectInfo$1>;
+    /**
+     * 上传文件
+     * @param objectName 对象名
+     * @param filePath 文件路径
+     * @param metaData 元数据
+     */
+    fPutObject(objectName: string, filePath: string, metaData?: ItemBucketMetadata): Promise<UploadedObjectInfo$1>;
+    /**
+     * 删除对象
+     * @param objectName 对象名
+     */
+    deleteObject(objectName: string): Promise<void>;
+    deleteObjects(objectNameList: string[]): Promise<void>;
+    /**
+     * 列出对象
+     * @param objectName 前缀
+     * @param opts 选项
+     */
+    listObjects<IS_FILE = false>(objectName: string, opts?: {
+        recursive?: boolean;
+        startAfter?: string;
+        maxKeys?: number;
+    }): Promise<IS_FILE extends true ? ListFileObject$1[] : ListObjectResult$1[]>;
+    /**
+     * 获取对象信息
+     * @param objectName 对象名
+     * @param checkFile 是否检查文件存在（不存在返回null而非抛错）
+     */
+    statObject(objectName: string, checkFile?: boolean): Promise<StatObjectResult$1 | null>;
+    /**
+     * 获取完整的对象名称
+     * @param objectName 对象名
+     */
+    getObjectName(objectName: string): string;
+    /**
+     * 检查文件hash是否一致
+     * @param objectName 对象名
+     * @param hash hash值
+     * @param meta 元数据
+     */
+    checkObjectHash(objectName: string, hash: string, meta?: ItemBucketMetadata): Promise<{
+        success: boolean;
+        metaData: ItemBucketMetadata | null;
+        obj: StatObjectResult$1 | null;
+        equalMeta?: boolean;
+    }>;
+    /**
+     * 获取元数据
+     * @param pathname 路径名
+     * @param meta 元数据
+     */
+    getMetadata(pathname: string, meta?: ItemBucketMetadata): ItemBucketMetadata;
+    /**
+     * 复制对象
+     * @param sourceObject 源对象
+     * @param targetObject 目标对象
+     */
+    copyObject(sourceObject: string, targetObject: string): Promise<any>;
+    /**
+     * 替换对象元数据
+     * @param objectName 对象名
+     * @param meta 新元数据
+     */
+    replaceObject(objectName: string, meta: ItemBucketMetadata): Promise<any>;
+    /**
+     * 创建实例
+     */
+    static create<T extends OssBase, U>(this: new (opts: OssBaseOptions<U>) => T, opts: OssBaseOptions<U>): T;
+    /**
+     * 从已有实例创建
+     */
+    static fromBase<T extends OssBase, U>(this: new (opts: OssBaseOptions<U>) => T, createOpts: {
+        oss: OssBase;
+        opts: Partial<OssBaseOptions<U>>;
+    }): T;
+}
+
+declare class ConfigOssService extends OssBase implements OssService$1 {
+    owner: string;
+    constructor(opts: OssBaseOptions<{
+        owner: string;
+    }>);
+    listAllFile(): Promise<ListFileObject$1[]>;
+    listAll(): Promise<ListObjectResult$1[]>;
+    configMap: Map<string, any>;
+    keys: string[];
+    getAllConfigJson(): Promise<ListFileObject$1[]>;
+    isEndWithJson(string: string): boolean;
+    putJsonObject(key: string, data: any): Promise<UploadedObjectInfo$1>;
+    getObjectList(objectNameList: string[]): Promise<Map<string, Record<string, any>>>;
+    getList(): Promise<{
+        list: {
+            key: string;
+            name: string;
+            size: number;
+            lastModified: Date;
+            etag: string;
+        }[];
+        keys: string[];
+        keyEtagMap: Map<string, string>;
+    }>;
+}
+
+/**
+ * 过滤 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
+ * @returns
+ */
+declare const hash: (str: string | Buffer | Object) => string;
+declare const hashSringify: (str: Object) => string;
+
+declare const getContentType: (filePath: string) => any;
+
+declare const standardHeaderKeys: string[];
+type StandardHeaders = {
+    ContentType?: string;
+    CacheControl?: string;
+    ContentDisposition?: string;
+    ContentEncoding?: string;
+    ContentLanguage?: string;
+    Expires?: Date;
+};
+/**
+ * 从元数据中提取标准头部和自定义元数据
+ * @param metaData 原始元数据
+ * @returns 标准头部和自定义元数据
+ */
+declare function extractStandardHeaders(metaData: Record<string, string>): {
+    standardHeaders: StandardHeaders;
+    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 };