@devbro/neko-storage 0.1.2 → 0.1.4

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/Storage.mts","../src/AWSS3Storage.mts","../src/LocalStorage.mts","../src/StorageFactory.mts"],"sourcesContent":["export * from './types.mjs';\nexport * from './Storage.mjs';\nexport * from './AWSS3Storage.mjs';\nexport * from './LocalStorage.mjs';\nexport * from './StorageFactory.mjs';\n","import { ReadStream } from 'fs';\nimport { Stream } from 'stream';\nimport { Metadata } from './types.mjs';\nimport { StorageConfig } from './types.mjs';\n\nexport abstract class Storage {\n  constructor(protected config: StorageConfig) {}\n\n  static canHandle(config: StorageConfig): boolean {\n    throw new Error('Method not implemented.');\n  }\n\n  abstract exists(path: string): Promise<boolean>;\n  abstract put(path: string, content: string | object | Stream | Buffer): Promise<boolean>;\n  abstract getJson(path: string): Promise<object>;\n  abstract getString(path: string): Promise<string>;\n  abstract getBuffer(path: string): Promise<Buffer>;\n  abstract getStream(path: string): Promise<ReadStream>;\n  abstract delete(path: string): Promise<boolean>;\n  abstract metadata(path: string): Promise<Metadata>;\n}\n","import { Metadata, StorageConfig } from './types.mjs';\nimport { Storage } from './Storage.mjs';\nimport {\n  S3Client,\n  HeadObjectCommand,\n  PutObjectCommand,\n  GetObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectOutput,\n} from '@aws-sdk/client-s3';\nimport { ReadStream } from 'fs';\nimport Stream, { Readable } from 'stream';\n\nexport class AWSS3Storage extends Storage {\n  private s3: S3Client;\n\n  constructor(protected config: StorageConfig) {\n    super(config);\n\n    if (!AWSS3Storage.canHandle(config)) {\n      throw new Error(`storage engine cannot handle this config.`);\n    }\n\n    this.s3 = new S3Client(this.config?.s3Config || {});\n  }\n\n  static canHandle(config: StorageConfig): boolean {\n    return config.engine === 's3';\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await this.s3.send(new HeadObjectCommand({ Bucket: this.config?.bucket, Key: path }));\n      return true;\n    } catch (error: any) {\n      if (error.name === 'NotFound') {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  async put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    let body: any;\n    if (typeof content === 'string' || content instanceof Buffer) {\n      body = content;\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      body = JSON.stringify(content);\n    } else if (content instanceof Stream) {\n      body = content;\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    await this.s3.send(\n      new PutObjectCommand({\n        Bucket: this.config.bucket,\n        Key: path,\n        Body: body,\n      })\n    );\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const body = await this.streamToString(data.Body as Stream);\n    return JSON.parse(body);\n  }\n\n  async getString(path: string): Promise<string> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return await this.streamToString(data.Body as Stream);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    await this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));\n    return true;\n  }\n\n  private async streamToString(stream: Stream): Promise<string> {\n    return new Promise((resolve, reject) => {\n      const chunks: Uint8Array[] = [];\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));\n      stream.on('error', reject);\n    });\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const chunks: Uint8Array[] = [];\n    const stream = data.Body as Readable;\n\n    return new Promise((resolve, reject) => {\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks)));\n      stream.on('error', reject);\n    });\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return data.Body as unknown as ReadStream;\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const metadata = await this.s3.send(\n      new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return {\n      size: metadata.ContentLength || 0,\n      mimeType: metadata.ContentType || 'unknown',\n      lastModifiedDate: (metadata.LastModified || new Date(0)).toISOString(),\n    };\n  }\n}\n","import Stream from 'stream';\nimport * as fs from 'fs/promises';\nimport { createWriteStream, createReadStream, ReadStream } from 'fs';\nimport * as path from 'path';\nimport * as mime from 'mime-types';\nimport { Metadata, StorageConfig } from './types.mjs';\nimport { Storage } from './Storage.mjs';\n\nexport class LocalStorage extends Storage {\n  constructor(config: StorageConfig) {\n    super(config);\n\n    if (!LocalStorage.canHandle(config)) {\n      throw new Error(`storage engine cannot handle this config.`);\n    }\n    // Ensure the base folder exists\n    fs.mkdir(this.config.basePath, { recursive: true }).catch((error) => {\n      throw error;\n    });\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const fullPath = this.getFullPath(path);\n    const stats = await fs.stat(fullPath);\n    return {\n      size: stats.size,\n      mimeType: mime.lookup(fullPath) || 'unknown',\n      lastModifiedDate: stats.mtime.toISOString(),\n    };\n  }\n\n  static canHandle(config: StorageConfig) {\n    if (config.engine === 'local') {\n      return true;\n    }\n    return false;\n  }\n\n  getFullPath(filePath: string) {\n    return path.join(this.config.basePath, filePath);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await fs.access(this.getFullPath(path));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    const fullPath = this.getFullPath(path);\n\n    if (typeof content === 'string' || content instanceof Buffer) {\n      await fs.writeFile(fullPath, content);\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      await fs.writeFile(fullPath, JSON.stringify(content, null, 2));\n    } else if (typeof content === 'object' && content instanceof Stream) {\n      const writeStream = createWriteStream(fullPath);\n      await new Promise((resolve, reject) => {\n        (content as Stream).pipe(writeStream);\n        (content as Stream).on('end', resolve);\n        (content as Stream).on('error', reject);\n      });\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const fullPath = this.getFullPath(path);\n    const content = await fs.readFile(fullPath, 'utf-8');\n    return JSON.parse(content);\n  }\n\n  async getString(path: string, encoding: BufferEncoding = 'utf-8'): Promise<string> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath, encoding);\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath);\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const fullPath = this.getFullPath(path);\n    return createReadStream(fullPath);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    const fullPath = this.getFullPath(path);\n    await fs.unlink(fullPath);\n    return true;\n  }\n}\n","import { AWSS3Storage } from './AWSS3Storage.mjs';\nimport { LocalStorage } from './LocalStorage.mjs';\nimport { Storage } from './Storage.mjs';\nimport { StorageConfig } from './types.mjs';\n\nexport class StorageFactory {\n  public static storageEngines: (typeof Storage)[] = [LocalStorage, AWSS3Storage];\n\n  registerStorageEngine(engine: typeof Storage) {\n    StorageFactory.storageEngines.push(engine);\n  }\n\n  public static create(config: StorageConfig): Storage {\n    for (const engine of StorageFactory.storageEngines) {\n      if (engine.canHandle(config)) {\n        // @ts-ignore\n        return new engine(config);\n      }\n    }\n    throw new Error('No matchin storage engine found');\n  }\n}\n"],"mappings":"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","names":["path","Stream","import_stream","path","Stream"]}
+{"version":3,"sources":["../src/index.ts","../src/Storage.mts","../src/providers/AWSS3StorageProvider.mts","../src/providers/LocalStorageProvider.mts","../src/StorageProviderFactory.mts"],"sourcesContent":["export * from './types.mjs';\nexport * from './Storage.mjs';\nexport * from './providers/AWSS3StorageProvider.mjs';\nexport * from './providers/LocalStorageProvider.mjs';\nexport * from './StorageProviderFactory.mjs';\nexport * from './StorageProviderInterface.mjs';","import { ReadStream } from 'fs';\nimport { Stream } from 'stream';\nimport { Metadata } from './types.mjs';\nimport { StorageConfig } from './types.mjs';\nimport { StorageProviderInterface } from './StorageProviderInterface.mjs';\n\nexport class Storage {\n  constructor(protected provider: StorageProviderInterface) {}\n\n  exists(path: string): Promise<boolean> {\n    return this.provider.exists(path);\n  }\n  \n  put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    return this.provider.put(path, content);\n  }\n  \n  getJson(path: string): Promise<object> {\n    return this.provider.getJson(path);\n  }\n  \n  getString(path: string): Promise<string> {\n    return this.provider.getString(path);\n  }\n  \n  getBuffer(path: string): Promise<Buffer> {\n    return this.provider.getBuffer(path);\n  }\n  \n  getStream(path: string): Promise<ReadStream> {\n    return this.provider.getStream(path);\n  }\n  \n  delete(path: string): Promise<boolean> {\n    return this.provider.delete(path);\n  }\n  \n  metadata(path: string): Promise<Metadata> {\n    return this.provider.metadata(path);\n  }\n}\n","import { Metadata, StorageConfig } from '../types.mjs';\nimport { Storage } from '../Storage.mjs';\nimport {\n  S3Client,\n  HeadObjectCommand,\n  PutObjectCommand,\n  GetObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectOutput,\n} from '@aws-sdk/client-s3';\nimport { ReadStream } from 'fs';\nimport Stream, { Readable } from 'stream';\nimport { StorageProviderInterface } from '../StorageProviderInterface.mjs';\n\nexport class AWSS3StorageProvider implements StorageProviderInterface {\n  private s3: S3Client;\n\n  constructor(protected config: StorageConfig) {\n    this.s3 = new S3Client(this.config?.s3Config || {});\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await this.s3.send(new HeadObjectCommand({ Bucket: this.config?.bucket, Key: path }));\n      return true;\n    } catch (error: any) {\n      if (error.name === 'NotFound') {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  async put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    let body: any;\n    if (typeof content === 'string' || content instanceof Buffer) {\n      body = content;\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      body = JSON.stringify(content);\n    } else if (content instanceof Stream) {\n      body = content;\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    await this.s3.send(\n      new PutObjectCommand({\n        Bucket: this.config.bucket,\n        Key: path,\n        Body: body,\n      })\n    );\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const body = await this.streamToString(data.Body as Stream);\n    return JSON.parse(body);\n  }\n\n  async getString(path: string): Promise<string> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return await this.streamToString(data.Body as Stream);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    await this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));\n    return true;\n  }\n\n  private async streamToString(stream: Stream): Promise<string> {\n    return new Promise((resolve, reject) => {\n      const chunks: Uint8Array[] = [];\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));\n      stream.on('error', reject);\n    });\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const chunks: Uint8Array[] = [];\n    const stream = data.Body as Readable;\n\n    return new Promise((resolve, reject) => {\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks)));\n      stream.on('error', reject);\n    });\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return data.Body as unknown as ReadStream;\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const metadata = await this.s3.send(\n      new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return {\n      size: metadata.ContentLength || 0,\n      mimeType: metadata.ContentType || 'unknown',\n      lastModifiedDate: (metadata.LastModified || new Date(0)).toISOString(),\n    };\n  }\n}\n","import Stream from 'stream';\nimport * as fs from 'fs/promises';\nimport { createWriteStream, createReadStream, ReadStream } from 'fs';\nimport * as path from 'path';\nimport * as mime from 'mime-types';\nimport { Metadata, StorageConfig } from '../types.mjs';\nimport { Storage } from '../Storage.mjs';\nimport { StorageProviderInterface } from '../StorageProviderInterface.mjs';\n\nexport class LocalStorageProvider implements StorageProviderInterface {\n  constructor(private config: StorageConfig) {\n    // Ensure the base folder exists\n    fs.mkdir(this.config.basePath, { recursive: true }).catch((error) => {\n      throw error;\n    });\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const fullPath = this.getFullPath(path);\n    const stats = await fs.stat(fullPath);\n    return {\n      size: stats.size,\n      mimeType: mime.lookup(fullPath) || 'unknown',\n      lastModifiedDate: stats.mtime.toISOString(),\n    };\n  }\n\n  getFullPath(filePath: string) {\n    return path.join(this.config.basePath, filePath);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await fs.access(this.getFullPath(path));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async put(filepath: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    const fullPath = this.getFullPath(filepath);\n\n    const dir = path.dirname(fullPath);\n    await fs.mkdir(dir, { recursive: true });\n\n    if (typeof content === 'string' || content instanceof Buffer) {\n      await fs.writeFile(fullPath, content);\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      await fs.writeFile(fullPath, JSON.stringify(content, null, 2));\n    } else if (typeof content === 'object' && content instanceof Stream) {\n      const writeStream = createWriteStream(fullPath);\n      await new Promise((resolve, reject) => {\n        (content as Stream).pipe(writeStream);\n        (content as Stream).on('end', resolve);\n        (content as Stream).on('error', reject);\n      });\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const fullPath = this.getFullPath(path);\n    const content = await fs.readFile(fullPath, 'utf-8');\n    return JSON.parse(content);\n  }\n\n  async getString(path: string, encoding: BufferEncoding = 'utf-8'): Promise<string> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath, encoding);\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath);\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const fullPath = this.getFullPath(path);\n    return createReadStream(fullPath);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    const fullPath = this.getFullPath(path);\n    await fs.unlink(fullPath);\n    return true;\n  }\n}\n","import { Storage } from './Storage.mjs';\nimport { FlexibleFactory } from '@devbro/neko-helper';\nimport { StorageProviderInterface } from './StorageProviderInterface.mjs';\n\nexport class StorageProviderFactory {\n  static instance: FlexibleFactory<StorageProviderInterface> = new FlexibleFactory<StorageProviderInterface>();\n\n  static register(key: string, factory: (...args: any[]) => StorageProviderInterface): void {\n    StorageProviderFactory.instance.register(key, factory);\n  }\n\n  static create<T>(key: string, ...args: any[]): StorageProviderInterface {\n    return StorageProviderFactory.instance.create(key, ...args);\n  }\n}\n"],"mappings":"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","names":["path","path","Stream","import_stream","path","Stream"]}

package/dist/index.mjs

@@ -1,6 +1,7 @@
 export * from "./types.mjs";
 export * from "./Storage.mjs";
-export * from "./AWSS3Storage.mjs";
-export * from "./LocalStorage.mjs";
-export * from "./StorageFactory.mjs";
+export * from "./providers/AWSS3StorageProvider.mjs";
+export * from "./providers/LocalStorageProvider.mjs";
+export * from "./StorageProviderFactory.mjs";
+export * from "./StorageProviderInterface.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types.mjs';\nexport * from './Storage.mjs';\nexport * from './AWSS3Storage.mjs';\nexport * from './LocalStorage.mjs';\nexport * from './StorageFactory.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types.mjs';\nexport * from './Storage.mjs';\nexport * from './providers/AWSS3StorageProvider.mjs';\nexport * from './providers/LocalStorageProvider.mjs';\nexport * from './StorageProviderFactory.mjs';\nexport * from './StorageProviderInterface.mjs';"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/{AWSS3Storage.d.mts → providers/AWSS3StorageProvider.d.mts}

@@ -1,14 +1,13 @@
-import { StorageConfig, Metadata } from './types.mjs';
-import { Storage } from './Storage.mjs';
+import { StorageConfig, Metadata } from '../types.mjs';
 import { ReadStream } from 'fs';
 import Stream from 'stream';
+import { StorageProviderInterface } from '../StorageProviderInterface.mjs';
 import '@aws-sdk/client-s3';
 
-declare class AWSS3Storage extends Storage {
+declare class AWSS3StorageProvider implements StorageProviderInterface {
     protected config: StorageConfig;
     private s3;
     constructor(config: StorageConfig);
-    static canHandle(config: StorageConfig): boolean;
     exists(path: string): Promise<boolean>;
     put(path: string, content: string | object | Stream | Buffer): Promise<boolean>;
     getJson(path: string): Promise<object>;
@@ -20,4 +19,4 @@ declare class AWSS3Storage extends Storage {
     metadata(path: string): Promise<Metadata>;
 }
 
-export { AWSS3Storage };
+export { AWSS3StorageProvider };

package/dist/providers/AWSS3StorageProvider.mjs

@@ -0,0 +1,108 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import {
+  S3Client,
+  HeadObjectCommand,
+  PutObjectCommand,
+  GetObjectCommand,
+  DeleteObjectCommand
+} from "@aws-sdk/client-s3";
+import Stream from "stream";
+class AWSS3StorageProvider {
+  constructor(config) {
+    this.config = config;
+    this.s3 = new S3Client(this.config?.s3Config || {});
+  }
+  static {
+    __name(this, "AWSS3StorageProvider");
+  }
+  s3;
+  async exists(path) {
+    try {
+      await this.s3.send(new HeadObjectCommand({ Bucket: this.config?.bucket, Key: path }));
+      return true;
+    } catch (error) {
+      if (error.name === "NotFound") {
+        return false;
+      }
+      throw error;
+    }
+  }
+  async put(path, content) {
+    let body;
+    if (typeof content === "string" || content instanceof Buffer) {
+      body = content;
+    } else if (typeof content === "object" && !(content instanceof Stream)) {
+      body = JSON.stringify(content);
+    } else if (content instanceof Stream) {
+      body = content;
+    } else {
+      throw new Error("Unsupported content type");
+    }
+    await this.s3.send(
+      new PutObjectCommand({
+        Bucket: this.config.bucket,
+        Key: path,
+        Body: body
+      })
+    );
+    return true;
+  }
+  async getJson(path) {
+    const data = await this.s3.send(
+      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
+    );
+    const body = await this.streamToString(data.Body);
+    return JSON.parse(body);
+  }
+  async getString(path) {
+    const data = await this.s3.send(
+      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
+    );
+    return await this.streamToString(data.Body);
+  }
+  async delete(path) {
+    await this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));
+    return true;
+  }
+  async streamToString(stream) {
+    return new Promise((resolve, reject) => {
+      const chunks = [];
+      stream.on("data", (chunk) => chunks.push(chunk));
+      stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+      stream.on("error", reject);
+    });
+  }
+  async getBuffer(path) {
+    const data = await this.s3.send(
+      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
+    );
+    const chunks = [];
+    const stream = data.Body;
+    return new Promise((resolve, reject) => {
+      stream.on("data", (chunk) => chunks.push(chunk));
+      stream.on("end", () => resolve(Buffer.concat(chunks)));
+      stream.on("error", reject);
+    });
+  }
+  async getStream(path) {
+    const data = await this.s3.send(
+      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
+    );
+    return data.Body;
+  }
+  async metadata(path) {
+    const metadata = await this.s3.send(
+      new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })
+    );
+    return {
+      size: metadata.ContentLength || 0,
+      mimeType: metadata.ContentType || "unknown",
+      lastModifiedDate: (metadata.LastModified || /* @__PURE__ */ new Date(0)).toISOString()
+    };
+  }
+}
+export {
+  AWSS3StorageProvider
+};
+//# sourceMappingURL=AWSS3StorageProvider.mjs.map

package/dist/providers/AWSS3StorageProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/AWSS3StorageProvider.mts"],"sourcesContent":["import { Metadata, StorageConfig } from '../types.mjs';\nimport { Storage } from '../Storage.mjs';\nimport {\n  S3Client,\n  HeadObjectCommand,\n  PutObjectCommand,\n  GetObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectOutput,\n} from '@aws-sdk/client-s3';\nimport { ReadStream } from 'fs';\nimport Stream, { Readable } from 'stream';\nimport { StorageProviderInterface } from '../StorageProviderInterface.mjs';\n\nexport class AWSS3StorageProvider implements StorageProviderInterface {\n  private s3: S3Client;\n\n  constructor(protected config: StorageConfig) {\n    this.s3 = new S3Client(this.config?.s3Config || {});\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await this.s3.send(new HeadObjectCommand({ Bucket: this.config?.bucket, Key: path }));\n      return true;\n    } catch (error: any) {\n      if (error.name === 'NotFound') {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  async put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    let body: any;\n    if (typeof content === 'string' || content instanceof Buffer) {\n      body = content;\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      body = JSON.stringify(content);\n    } else if (content instanceof Stream) {\n      body = content;\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    await this.s3.send(\n      new PutObjectCommand({\n        Bucket: this.config.bucket,\n        Key: path,\n        Body: body,\n      })\n    );\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const body = await this.streamToString(data.Body as Stream);\n    return JSON.parse(body);\n  }\n\n  async getString(path: string): Promise<string> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return await this.streamToString(data.Body as Stream);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    await this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));\n    return true;\n  }\n\n  private async streamToString(stream: Stream): Promise<string> {\n    return new Promise((resolve, reject) => {\n      const chunks: Uint8Array[] = [];\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));\n      stream.on('error', reject);\n    });\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const chunks: Uint8Array[] = [];\n    const stream = data.Body as Readable;\n\n    return new Promise((resolve, reject) => {\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks)));\n      stream.on('error', reject);\n    });\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return data.Body as unknown as ReadStream;\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const metadata = await this.s3.send(\n      new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return {\n      size: metadata.ContentLength || 0,\n      mimeType: metadata.ContentType || 'unknown',\n      lastModifiedDate: (metadata.LastModified || new Date(0)).toISOString(),\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{LocalStorage.d.mts → providers/LocalStorageProvider.d.mts}

@@ -1,16 +1,16 @@
 import Stream from 'stream';
 import { ReadStream } from 'fs';
-import { StorageConfig, Metadata } from './types.mjs';
-import { Storage } from './Storage.mjs';
+import { StorageConfig, Metadata } from '../types.mjs';
+import { StorageProviderInterface } from '../StorageProviderInterface.mjs';
 import '@aws-sdk/client-s3';
 
-declare class LocalStorage extends Storage {
+declare class LocalStorageProvider implements StorageProviderInterface {
+    private config;
     constructor(config: StorageConfig);
     metadata(path: string): Promise<Metadata>;
-    static canHandle(config: StorageConfig): boolean;
     getFullPath(filePath: string): string;
     exists(path: string): Promise<boolean>;
-    put(path: string, content: string | object | Stream | Buffer): Promise<boolean>;
+    put(filepath: string, content: string | object | Stream | Buffer): Promise<boolean>;
     getJson(path: string): Promise<object>;
     getString(path: string, encoding?: BufferEncoding): Promise<string>;
     getBuffer(path: string): Promise<Buffer>;
@@ -18,4 +18,4 @@ declare class LocalStorage extends Storage {
     delete(path: string): Promise<boolean>;
 }
 
-export { LocalStorage };
+export { LocalStorageProvider };

package/dist/providers/LocalStorageProvider.mjs

@@ -0,0 +1,84 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import Stream from "stream";
+import * as fs from "fs/promises";
+import { createWriteStream, createReadStream } from "fs";
+import * as path from "path";
+import * as mime from "mime-types";
+class LocalStorageProvider {
+  constructor(config) {
+    this.config = config;
+    fs.mkdir(this.config.basePath, { recursive: true }).catch((error) => {
+      throw error;
+    });
+  }
+  static {
+    __name(this, "LocalStorageProvider");
+  }
+  async metadata(path2) {
+    const fullPath = this.getFullPath(path2);
+    const stats = await fs.stat(fullPath);
+    return {
+      size: stats.size,
+      mimeType: mime.lookup(fullPath) || "unknown",
+      lastModifiedDate: stats.mtime.toISOString()
+    };
+  }
+  getFullPath(filePath) {
+    return path.join(this.config.basePath, filePath);
+  }
+  async exists(path2) {
+    try {
+      await fs.access(this.getFullPath(path2));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async put(filepath, content) {
+    const fullPath = this.getFullPath(filepath);
+    const dir = path.dirname(fullPath);
+    await fs.mkdir(dir, { recursive: true });
+    if (typeof content === "string" || content instanceof Buffer) {
+      await fs.writeFile(fullPath, content);
+    } else if (typeof content === "object" && !(content instanceof Stream)) {
+      await fs.writeFile(fullPath, JSON.stringify(content, null, 2));
+    } else if (typeof content === "object" && content instanceof Stream) {
+      const writeStream = createWriteStream(fullPath);
+      await new Promise((resolve, reject) => {
+        content.pipe(writeStream);
+        content.on("end", resolve);
+        content.on("error", reject);
+      });
+    } else {
+      throw new Error("Unsupported content type");
+    }
+    return true;
+  }
+  async getJson(path2) {
+    const fullPath = this.getFullPath(path2);
+    const content = await fs.readFile(fullPath, "utf-8");
+    return JSON.parse(content);
+  }
+  async getString(path2, encoding = "utf-8") {
+    const fullPath = this.getFullPath(path2);
+    return await fs.readFile(fullPath, encoding);
+  }
+  async getBuffer(path2) {
+    const fullPath = this.getFullPath(path2);
+    return await fs.readFile(fullPath);
+  }
+  async getStream(path2) {
+    const fullPath = this.getFullPath(path2);
+    return createReadStream(fullPath);
+  }
+  async delete(path2) {
+    const fullPath = this.getFullPath(path2);
+    await fs.unlink(fullPath);
+    return true;
+  }
+}
+export {
+  LocalStorageProvider
+};
+//# sourceMappingURL=LocalStorageProvider.mjs.map

package/dist/providers/LocalStorageProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/LocalStorageProvider.mts"],"sourcesContent":["import Stream from 'stream';\nimport * as fs from 'fs/promises';\nimport { createWriteStream, createReadStream, ReadStream } from 'fs';\nimport * as path from 'path';\nimport * as mime from 'mime-types';\nimport { Metadata, StorageConfig } from '../types.mjs';\nimport { Storage } from '../Storage.mjs';\nimport { StorageProviderInterface } from '../StorageProviderInterface.mjs';\n\nexport class LocalStorageProvider implements StorageProviderInterface {\n  constructor(private config: StorageConfig) {\n    // Ensure the base folder exists\n    fs.mkdir(this.config.basePath, { recursive: true }).catch((error) => {\n      throw error;\n    });\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const fullPath = this.getFullPath(path);\n    const stats = await fs.stat(fullPath);\n    return {\n      size: stats.size,\n      mimeType: mime.lookup(fullPath) || 'unknown',\n      lastModifiedDate: stats.mtime.toISOString(),\n    };\n  }\n\n  getFullPath(filePath: string) {\n    return path.join(this.config.basePath, filePath);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await fs.access(this.getFullPath(path));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async put(filepath: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    const fullPath = this.getFullPath(filepath);\n\n    const dir = path.dirname(fullPath);\n    await fs.mkdir(dir, { recursive: true });\n\n    if (typeof content === 'string' || content instanceof Buffer) {\n      await fs.writeFile(fullPath, content);\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      await fs.writeFile(fullPath, JSON.stringify(content, null, 2));\n    } else if (typeof content === 'object' && content instanceof Stream) {\n      const writeStream = createWriteStream(fullPath);\n      await new Promise((resolve, reject) => {\n        (content as Stream).pipe(writeStream);\n        (content as Stream).on('end', resolve);\n        (content as Stream).on('error', reject);\n      });\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const fullPath = this.getFullPath(path);\n    const content = await fs.readFile(fullPath, 'utf-8');\n    return JSON.parse(content);\n  }\n\n  async getString(path: string, encoding: BufferEncoding = 'utf-8'): Promise<string> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath, encoding);\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const fullPath = this.getFullPath(path);\n    return await fs.readFile(fullPath);\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const fullPath = this.getFullPath(path);\n    return createReadStream(fullPath);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    const fullPath = this.getFullPath(path);\n    await fs.unlink(fullPath);\n    return true;\n  }\n}\n"],"mappings":";;AAAA,OAAO,YAAY;AACnB,YAAY,QAAQ;AACpB,SAAS,mBAAmB,wBAAoC;AAChE,YAAY,UAAU;AACtB,YAAY,UAAU;AAKf,MAAM,qBAAyD;AAAA,EACpE,YAAoB,QAAuB;AAAvB;AAElB,OAAG,MAAM,KAAK,OAAO,UAAU,EAAE,WAAW,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU;AACnE,YAAM;AAAA,IACR,CAAC;AAAA,EACH;AAAA,EAfF,OASsE;AAAA;AAAA;AAAA,EAQpE,MAAM,SAASA,OAAiC;AAC9C,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,UAAM,QAAQ,MAAM,GAAG,KAAK,QAAQ;AACpC,WAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,UAAU,KAAK,OAAO,QAAQ,KAAK;AAAA,MACnC,kBAAkB,MAAM,MAAM,YAAY;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,YAAY,UAAkB;AAC5B,WAAO,KAAK,KAAK,KAAK,OAAO,UAAU,QAAQ;AAAA,EACjD;AAAA,EAEA,MAAM,OAAOA,OAAgC;AAC3C,QAAI;AACF,YAAM,GAAG,OAAO,KAAK,YAAYA,KAAI,CAAC;AACtC,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,UAAkB,SAA8D;AACxF,UAAM,WAAW,KAAK,YAAY,QAAQ;AAE1C,UAAM,MAAM,KAAK,QAAQ,QAAQ;AACjC,UAAM,GAAG,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AAEvC,QAAI,OAAO,YAAY,YAAY,mBAAmB,QAAQ;AAC5D,YAAM,GAAG,UAAU,UAAU,OAAO;AAAA,IACtC,WAAW,OAAO,YAAY,YAAY,EAAE,mBAAmB,SAAS;AACtE,YAAM,GAAG,UAAU,UAAU,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,IAC/D,WAAW,OAAO,YAAY,YAAY,mBAAmB,QAAQ;AACnE,YAAM,cAAc,kBAAkB,QAAQ;AAC9C,YAAM,IAAI,QAAQ,CAAC,SAAS,WAAW;AACrC,QAAC,QAAmB,KAAK,WAAW;AACpC,QAAC,QAAmB,GAAG,OAAO,OAAO;AACrC,QAAC,QAAmB,GAAG,SAAS,MAAM;AAAA,MACxC,CAAC;AAAA,IACH,OAAO;AACL,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,QAAQA,OAA+B;AAC3C,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,UAAM,UAAU,MAAM,GAAG,SAAS,UAAU,OAAO;AACnD,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B;AAAA,EAEA,MAAM,UAAUA,OAAc,WAA2B,SAA0B;AACjF,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,WAAO,MAAM,GAAG,SAAS,UAAU,QAAQ;AAAA,EAC7C;AAAA,EAEA,MAAM,UAAUA,OAA+B;AAC7C,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,WAAO,MAAM,GAAG,SAAS,QAAQ;AAAA,EACnC;AAAA,EAEA,MAAM,UAAUA,OAAmC;AACjD,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,WAAO,iBAAiB,QAAQ;AAAA,EAClC;AAAA,EAEA,MAAM,OAAOA,OAAgC;AAC3C,UAAM,WAAW,KAAK,YAAYA,KAAI;AACtC,UAAM,GAAG,OAAO,QAAQ;AACxB,WAAO;AAAA,EACT;AACF;","names":["path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devbro/neko-storage",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "abstracted file storage implementation",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,13 +28,11 @@
   "author": "Farzad Meow Khalafi",
   "license": "MIT",
   "devDependencies": {
-    "@types/jest": "^29.5.12",
     "@types/node": "^22.14.1",
     "@typescript-eslint/eslint-plugin": "^7.1.1",
     "@typescript-eslint/parser": "^7.1.1",
     "eslint": "8.57.0",
     "husky": "^9.1.7",
-    "jest": "^29.7.0",
     "pinst": "^3.0.0",
     "prettier": "^3.5.3",
     "ts-jest": "^29.1.2",
@@ -45,7 +43,8 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.817.0",
-    "mime-types": "^3.0.1"
+    "mime-types": "^3.0.1",
+    "@devbro/neko-helper": "0.1.*"
   },
   "directories": {
     "doc": "docs",

package/dist/AWSS3Storage.mjs

@@ -1,154 +0,0 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
-import { Storage } from "./Storage.mjs";
-import {
-  S3Client,
-  HeadObjectCommand,
-  PutObjectCommand,
-  GetObjectCommand,
-  DeleteObjectCommand
-} from "@aws-sdk/client-s3";
-import Stream from "stream";
-const _AWSS3Storage = class _AWSS3Storage extends Storage {
-  constructor(config) {
-    var _a;
-    super(config);
-    this.config = config;
-    if (!_AWSS3Storage.canHandle(config)) {
-      throw new Error(`storage engine cannot handle this config.`);
-    }
-    this.s3 = new S3Client(((_a = this.config) == null ? void 0 : _a.s3Config) || {});
-  }
-  static canHandle(config) {
-    return config.engine === "s3";
-  }
-  exists(path) {
-    return __async(this, null, function* () {
-      var _a;
-      try {
-        yield this.s3.send(new HeadObjectCommand({ Bucket: (_a = this.config) == null ? void 0 : _a.bucket, Key: path }));
-        return true;
-      } catch (error) {
-        if (error.name === "NotFound") {
-          return false;
-        }
-        throw error;
-      }
-    });
-  }
-  put(path, content) {
-    return __async(this, null, function* () {
-      let body;
-      if (typeof content === "string" || content instanceof Buffer) {
-        body = content;
-      } else if (typeof content === "object" && !(content instanceof Stream)) {
-        body = JSON.stringify(content);
-      } else if (content instanceof Stream) {
-        body = content;
-      } else {
-        throw new Error("Unsupported content type");
-      }
-      yield this.s3.send(
-        new PutObjectCommand({
-          Bucket: this.config.bucket,
-          Key: path,
-          Body: body
-        })
-      );
-      return true;
-    });
-  }
-  getJson(path) {
-    return __async(this, null, function* () {
-      const data = yield this.s3.send(
-        new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
-      );
-      const body = yield this.streamToString(data.Body);
-      return JSON.parse(body);
-    });
-  }
-  getString(path) {
-    return __async(this, null, function* () {
-      const data = yield this.s3.send(
-        new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
-      );
-      return yield this.streamToString(data.Body);
-    });
-  }
-  delete(path) {
-    return __async(this, null, function* () {
-      yield this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));
-      return true;
-    });
-  }
-  streamToString(stream) {
-    return __async(this, null, function* () {
-      return new Promise((resolve, reject) => {
-        const chunks = [];
-        stream.on("data", (chunk) => chunks.push(chunk));
-        stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
-        stream.on("error", reject);
-      });
-    });
-  }
-  getBuffer(path) {
-    return __async(this, null, function* () {
-      const data = yield this.s3.send(
-        new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
-      );
-      const chunks = [];
-      const stream = data.Body;
-      return new Promise((resolve, reject) => {
-        stream.on("data", (chunk) => chunks.push(chunk));
-        stream.on("end", () => resolve(Buffer.concat(chunks)));
-        stream.on("error", reject);
-      });
-    });
-  }
-  getStream(path) {
-    return __async(this, null, function* () {
-      const data = yield this.s3.send(
-        new GetObjectCommand({ Bucket: this.config.bucket, Key: path })
-      );
-      return data.Body;
-    });
-  }
-  metadata(path) {
-    return __async(this, null, function* () {
-      const metadata = yield this.s3.send(
-        new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })
-      );
-      return {
-        size: metadata.ContentLength || 0,
-        mimeType: metadata.ContentType || "unknown",
-        lastModifiedDate: (metadata.LastModified || /* @__PURE__ */ new Date(0)).toISOString()
-      };
-    });
-  }
-};
-__name(_AWSS3Storage, "AWSS3Storage");
-let AWSS3Storage = _AWSS3Storage;
-export {
-  AWSS3Storage
-};
-//# sourceMappingURL=AWSS3Storage.mjs.map

package/dist/AWSS3Storage.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/AWSS3Storage.mts"],"sourcesContent":["import { Metadata, StorageConfig } from './types.mjs';\nimport { Storage } from './Storage.mjs';\nimport {\n  S3Client,\n  HeadObjectCommand,\n  PutObjectCommand,\n  GetObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectOutput,\n} from '@aws-sdk/client-s3';\nimport { ReadStream } from 'fs';\nimport Stream, { Readable } from 'stream';\n\nexport class AWSS3Storage extends Storage {\n  private s3: S3Client;\n\n  constructor(protected config: StorageConfig) {\n    super(config);\n\n    if (!AWSS3Storage.canHandle(config)) {\n      throw new Error(`storage engine cannot handle this config.`);\n    }\n\n    this.s3 = new S3Client(this.config?.s3Config || {});\n  }\n\n  static canHandle(config: StorageConfig): boolean {\n    return config.engine === 's3';\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await this.s3.send(new HeadObjectCommand({ Bucket: this.config?.bucket, Key: path }));\n      return true;\n    } catch (error: any) {\n      if (error.name === 'NotFound') {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  async put(path: string, content: string | object | Stream | Buffer): Promise<boolean> {\n    let body: any;\n    if (typeof content === 'string' || content instanceof Buffer) {\n      body = content;\n    } else if (typeof content === 'object' && !(content instanceof Stream)) {\n      body = JSON.stringify(content);\n    } else if (content instanceof Stream) {\n      body = content;\n    } else {\n      throw new Error('Unsupported content type');\n    }\n\n    await this.s3.send(\n      new PutObjectCommand({\n        Bucket: this.config.bucket,\n        Key: path,\n        Body: body,\n      })\n    );\n\n    return true;\n  }\n\n  async getJson(path: string): Promise<object> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const body = await this.streamToString(data.Body as Stream);\n    return JSON.parse(body);\n  }\n\n  async getString(path: string): Promise<string> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return await this.streamToString(data.Body as Stream);\n  }\n\n  async delete(path: string): Promise<boolean> {\n    await this.s3.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: path }));\n    return true;\n  }\n\n  private async streamToString(stream: Stream): Promise<string> {\n    return new Promise((resolve, reject) => {\n      const chunks: Uint8Array[] = [];\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));\n      stream.on('error', reject);\n    });\n  }\n\n  async getBuffer(path: string): Promise<Buffer> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    const chunks: Uint8Array[] = [];\n    const stream = data.Body as Readable;\n\n    return new Promise((resolve, reject) => {\n      stream.on('data', (chunk) => chunks.push(chunk));\n      stream.on('end', () => resolve(Buffer.concat(chunks)));\n      stream.on('error', reject);\n    });\n  }\n\n  async getStream(path: string): Promise<ReadStream> {\n    const data = await this.s3.send(\n      new GetObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return data.Body as unknown as ReadStream;\n  }\n\n  async metadata(path: string): Promise<Metadata> {\n    const metadata = await this.s3.send(\n      new HeadObjectCommand({ Bucket: this.config.bucket, Key: path })\n    );\n    return {\n      size: metadata.ContentLength || 0,\n      mimeType: metadata.ContentType || 'unknown',\n      lastModifiedDate: (metadata.LastModified || new Date(0)).toISOString(),\n    };\n  }\n}\n"],"mappings":"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","names":[]}