@vercube/storage 0.0.33 → 0.0.35

package/README.md

@@ -1,34 +1,40 @@
 <div align="center">
-  <a href="https://vercube.dev/"><img src="https://github.com/OskarLebuda/vue-lazy-hydration/raw/main/.github/assets/logo.png?raw=true" alt="Vite logo" width="200"></a>
+  <img src="https://raw.githubusercontent.com/vercube/vercube/refs/heads/main/.github/assets/cover.png" width="100%" alt="Vercube - Unleash your server development." />
   <br>
   <br>
 
-# Vercube
-
-Next generation HTTP framework
-
-  <a href="https://www.npmjs.com/package/@vercube/storage">
-    <img src="https://img.shields.io/npm/v/%40vercube%2Fstorage?style=for-the-badge&logo=npm&color=%23767eff" alt="npm"/>
-  </a>
-  <a href="https://www.npmjs.com/package/@vercube/storage">
-    <img src="https://img.shields.io/npm/dm/%40vercube%2Fstorage?style=for-the-badge&logo=npm&color=%23767eff" alt="npm"/>
-  </a>
-  <a href="https://github.com/vercube/vercube/blob/main/LICENSE" target="_blank">
-    <img src="https://img.shields.io/npm/l/%40vercube%2Fstorage?style=for-the-badge&color=%23767eff" alt="License"/>
-  </a>
-  <a href="https://codecov.io/gh/vercube/vercube" target="_blank">
-    <img src="https://img.shields.io/codecov/c/github/vercube/vercube?style=for-the-badge&color=%23767eff" alt="Coverage"/>
-  </a>
-  <br/>
-  <br/>
+# @vercube/storage
+
+### Key-value storage for Vercube apps
+
+[![Ask DeepWiki](<https://img.shields.io/badge/ask-deepwiki-%20blue?style=for-the-badge&logo=bookstack&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)](https://deepwiki.com/vercube/vercube)
+![NPM Version](<https://img.shields.io/npm/v/%40vercube%2Fstorage?style=for-the-badge&logo=npm&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232e2e2e&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40vercube%2Fstorage>)
+![GitHub License](<https://img.shields.io/github/license/vercube/vercube?style=for-the-badge&logo=gitbook&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)
+![Codecov](<https://img.shields.io/codecov/c/github/vercube/vercube?style=for-the-badge&logo=vitest&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)
+
+**Simple storage abstraction - cache data, manage sessions, whatever you need. Mount different backends, use them through one API.**
+
+[Website](https://vercube.dev) • [Documentation](https://vercube.dev/docs/getting-started)
+
 </div>
 
-An ultra-efficient JavaScript server framework that runs anywhere - Node.js, Bun, or Deno - with unmatched flexibility and complete configurability for developers who refuse to sacrifice speed or control.
+## ✨ Features
+
+- **Unified API** - `getItem`, `setItem`, `deleteItem` - same interface everywhere
+- **Multiple backends** - memory, filesystem, or plug in your own
+- **Named instances** - mount as many storages as you need
+- **Type-safe** - generic types for stored values
+
+## 📦 Installation
+
+```bash
+pnpm add @vercube/storage
+```
 
-## <a name="module">Storage Module</a>
+## 📖 Usage
 
-The Storage module provides a unified interface for managing file storage across different storage providers. It offers a flexible and provider-agnostic approach to handling file uploads, downloads, and management operations. The module supports various storage backends including local filesystem, Amazon S3, Google Cloud Storage, and Azure Blob Storage, all accessible through a consistent API. This abstraction allows developers to easily switch between storage providers without changing application code, while maintaining optimal performance and reliability.
+Check out the full [documentation](https://vercube.dev/docs/modules/storage/overview)
 
-## <a name="documentation">📖 Documentation</a>
+## 📜 License
 
-Comprehensive documentation is available at [vercube.dev](https://vercube.dev). There you'll find detailed module descriptions, project information, guides, and everything else you need to know about Vercube.
+[MIT](https://github.com/vercube/vercube/blob/main/LICENSE)

package/dist/Drivers/MemoryStorage.d.mts

@@ -1,7 +1,6 @@
-import { t as Storage } from "../Storage-DeF_6O7t.mjs";
+import { t as Storage } from "../Storage-LzARx0pF.mjs";
 
 //#region src/Drivers/MemoryStorage.d.ts
-
 /**
  * In-memory storage implementation of the Storage interface
  * Provides a simple key-value store that persists only for the duration of the application runtime
@@ -24,6 +23,13 @@ declare class MemoryStorage implements Storage {
    * @returns {T} The stored value cast to type T
    */
   getItem<T = unknown>(key: string): T;
+  /**
+   * Retrieves multiple items from memory storage by their keys
+   * @template T - Type of the stored value
+   * @param {string[]} keys - The keys to retrieve the values for
+   * @returns {T[]} Array of stored values, with undefined for missing keys
+   */
+  getItems<T = unknown>(keys: string[]): T[];
   /**
    * Stores a value in memory storage with the specified key
    * @template T - Type of the value to store

package/dist/Drivers/MemoryStorage.mjs

@@ -1,5 +1,3 @@
-import "../Storage-Yj1niSzz.mjs";
-
 //#region src/Drivers/MemoryStorage.ts
 /**
 * In-memory storage implementation of the Storage interface
@@ -26,6 +24,15 @@ var MemoryStorage = class {
 		return this.storage.get(key);
 	}
 	/**
+	* Retrieves multiple items from memory storage by their keys
+	* @template T - Type of the stored value
+	* @param {string[]} keys - The keys to retrieve the values for
+	* @returns {T[]} Array of stored values, with undefined for missing keys
+	*/
+	getItems(keys) {
+		return keys.map((key) => this.storage.get(key));
+	}
+	/**
 	* Stores a value in memory storage with the specified key
 	* @template T - Type of the value to store
 	* @template U - Type of the options object

package/dist/Drivers/S3Storage.d.mts

@@ -1,17 +1,100 @@
-import { t as Storage } from "../Storage-DeF_6O7t.mjs";
+import { t as Storage } from "../Storage-LzARx0pF.mjs";
+import { Logger } from "@vercube/logger";
 import { S3ClientConfig } from "@aws-sdk/client-s3";
 
 //#region src/Drivers/S3Storage.d.ts
+/**
+ * Configuration options for S3 storage.
+ * Extends AWS S3ClientConfig with required bucket name.
+ *
+ * @property {string} bucket - The S3 bucket name (required)
+ * @property {string} region - AWS region (e.g., 'us-east-1') (required)
+ * @property {object} credentials - AWS credentials (optional)
+ *
+ * @remarks
+ * **Authentication Methods:**
+ *
+ * 1. **IAM Roles (Recommended for AWS environments):**
+ *    Omit the credentials field to use IAM roles automatically.
+ *    This is the most secure method for Lambda, EC2, ECS, etc.
+ *    ```ts
+ *    { bucket: 'my-bucket', region: 'us-east-1' }
+ *    ```
+ *
+ * 2. **Explicit Credentials:**
+ *    Provide credentials explicitly (use with AWS Secrets Manager for security).
+ *    ```ts
+ *    {
+ *      bucket: 'my-bucket',
+ *      region: 'us-east-1',
+ *      credentials: {
+ *        accessKeyId: 'YOUR_ACCESS_KEY',
+ *        secretAccessKey: 'YOUR_SECRET_KEY'
+ *      }
+ *    }
+ *    ```
+ *
+ * 3. **STS Temporary Credentials:**
+ *    Use temporary credentials from AWS STS AssumeRole.
+ *    ```ts
+ *    {
+ *      bucket: 'my-bucket',
+ *      region: 'us-east-1',
+ *      credentials: {
+ *        accessKeyId: tempCreds.AccessKeyId,
+ *        secretAccessKey: tempCreds.SecretAccessKey,
+ *        sessionToken: tempCreds.SessionToken
+ *      }
+ *    }
+ *    ```
+ *
+ * When credentials are not provided, AWS SDK uses the default credential provider chain:
+ * - IAM roles (Lambda execution role, EC2 instance profile, ECS task role)
+ * - Environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
+ * - Shared credentials file (~/.aws/credentials)
+ * - ECS container credentials
+ * - EC2 instance metadata service
+ */
 interface S3BaseOptions extends S3ClientConfig {
   bucket: string;
+  logger?: Logger;
 }
 /**
  * S3 storage implementation of the Storage interface.
  * Provides key-value operations backed by AWS S3.
  *
+ * @remarks
+ * **Security Best Practices:**
+ * - Use IAM roles in AWS environments (Lambda, EC2, ECS) instead of explicit credentials
+ * - Store credentials in AWS Secrets Manager if explicit credentials are required
+ * - Never hardcode credentials in source code
+ * - Use environment-specific configurations (IAM roles for production, credentials for local dev)
+ * - Grant minimum required S3 permissions (principle of least privilege)
+ *
+ * @example
+ * ```ts
+ * // Recommended: Using IAM roles (no credentials)
+ * const storage = new S3Storage();
+ * await storage.initialize({
+ *   bucket: 'my-app-bucket',
+ *   region: 'us-east-1'
+ * });
+ *
+ * // Alternative: Using explicit credentials from environment
+ * await storage.initialize({
+ *   bucket: 'my-app-bucket',
+ *   region: 'us-east-1',
+ *   credentials: {
+ *     accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+ *     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+ *   }
+ * });
+ * ```
+ *
  * @implements {Storage}
  */
 declare class S3Storage implements Storage<S3BaseOptions> {
+  private logger?;
   private s3;
   private bucket;
   /**
@@ -19,6 +102,20 @@ declare class S3Storage implements Storage<S3BaseOptions> {
    *
    * @param {S3BaseOptions} options - Configuration options for the S3 client.
    * @returns {Promise<void>} A promise that resolves when initialization is complete.
+   *
+   * @remarks
+   * The AWS SDK automatically handles credential resolution when credentials are not explicitly provided.
+   * In AWS environments (Lambda, EC2, ECS), IAM roles are used automatically, providing enhanced security
+   * without manual credential management.
+   *
+   * Priority of credential sources (when credentials field is omitted):
+   * 1. IAM roles (Lambda execution role, EC2 instance profile, ECS task role)
+   * 2. Environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
+   * 3. Shared credentials file (~/.aws/credentials)
+   * 4. ECS container credentials
+   * 5. EC2 instance metadata service
+   *
+   * When credentials are explicitly provided in options, they take precedence over all other sources.
    */
   initialize(options: S3BaseOptions): Promise<void>;
   /**
@@ -27,9 +124,18 @@ declare class S3Storage implements Storage<S3BaseOptions> {
    * @template T
    * @param {string} key - The key whose value should be retrieved.
    * @returns {Promise<T | undefined>} The stored value parsed as type T, or undefined if the key does not exist.
-   * @throws Will rethrow any S3 error except for missing key (`NoSuchKey`).
+   * @throws {StorageError} Wraps any S3 error except for missing key (`NoSuchKey`) with sanitized error information.
    */
   getItem<T = unknown>(key: string): Promise<T>;
+  /**
+   * Retrieves and parses multiple values from S3 storage by their keys.
+   *
+   * @template T
+   * @param {string[]} keys - The keys whose values should be retrieved.
+   * @returns {Promise<T[]>} An array of stored values parsed as type T, with undefined for missing keys.
+   * @throws {StorageError} Wraps any S3 error except for missing keys (`NoSuchKey`) with sanitized error information.
+   */
+  getItems<T = unknown>(keys: string[]): Promise<T[]>;
   /**
    * Stores a value in S3 storage under the specified key.
    *
@@ -53,7 +159,7 @@ declare class S3Storage implements Storage<S3BaseOptions> {
    *
    * @param {string} key - The key to check.
    * @returns {Promise<boolean>} True if the key exists, false otherwise.
-   * @throws Will rethrow any S3 error except for missing key (`NoSuchKey`).
+   * @throws {StorageError} Wraps any S3 error except for missing key (`NoSuchKey`) with sanitized error information.
    */
   hasItem(key: string): Promise<boolean>;
   /**

package/dist/Drivers/S3Storage.mjs

@@ -1,3 +1,4 @@
+import { t as StorageError } from "../StorageError-Dl7jGeVM.mjs";
 import { DeleteObjectCommand, GetObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
 
 //#region src/Drivers/S3Storage.ts
@@ -5,9 +6,38 @@ import { DeleteObjectCommand, GetObjectCommand, ListObjectsV2Command, PutObjectC
 * S3 storage implementation of the Storage interface.
 * Provides key-value operations backed by AWS S3.
 *
+* @remarks
+* **Security Best Practices:**
+* - Use IAM roles in AWS environments (Lambda, EC2, ECS) instead of explicit credentials
+* - Store credentials in AWS Secrets Manager if explicit credentials are required
+* - Never hardcode credentials in source code
+* - Use environment-specific configurations (IAM roles for production, credentials for local dev)
+* - Grant minimum required S3 permissions (principle of least privilege)
+*
+* @example
+* ```ts
+* // Recommended: Using IAM roles (no credentials)
+* const storage = new S3Storage();
+* await storage.initialize({
+*   bucket: 'my-app-bucket',
+*   region: 'us-east-1'
+* });
+*
+* // Alternative: Using explicit credentials from environment
+* await storage.initialize({
+*   bucket: 'my-app-bucket',
+*   region: 'us-east-1',
+*   credentials: {
+*     accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+*     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+*   }
+* });
+* ```
+*
 * @implements {Storage}
 */
 var S3Storage = class {
+	logger;
 	s3;
 	bucket;
 	/**
@@ -15,10 +45,26 @@ var S3Storage = class {
 	*
 	* @param {S3BaseOptions} options - Configuration options for the S3 client.
 	* @returns {Promise<void>} A promise that resolves when initialization is complete.
+	*
+	* @remarks
+	* The AWS SDK automatically handles credential resolution when credentials are not explicitly provided.
+	* In AWS environments (Lambda, EC2, ECS), IAM roles are used automatically, providing enhanced security
+	* without manual credential management.
+	*
+	* Priority of credential sources (when credentials field is omitted):
+	* 1. IAM roles (Lambda execution role, EC2 instance profile, ECS task role)
+	* 2. Environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
+	* 3. Shared credentials file (~/.aws/credentials)
+	* 4. ECS container credentials
+	* 5. EC2 instance metadata service
+	*
+	* When credentials are explicitly provided in options, they take precedence over all other sources.
 	*/
 	async initialize(options) {
-		this.s3 = new S3Client({ ...options });
-		this.bucket = options.bucket;
+		const { bucket, logger, ...s3Options } = options;
+		this.s3 = new S3Client(s3Options);
+		this.bucket = bucket;
+		this.logger = logger;
 	}
 	/**
 	* Retrieves and parses a value from S3 storage by its key.
@@ -26,7 +72,7 @@ var S3Storage = class {
 	* @template T
 	* @param {string} key - The key whose value should be retrieved.
 	* @returns {Promise<T | undefined>} The stored value parsed as type T, or undefined if the key does not exist.
-	* @throws Will rethrow any S3 error except for missing key (`NoSuchKey`).
+	* @throws {StorageError} Wraps any S3 error except for missing key (`NoSuchKey`) with sanitized error information.
 	*/
 	async getItem(key) {
 		try {
@@ -39,10 +85,32 @@ var S3Storage = class {
 			return JSON.parse(body);
 		} catch (error) {
 			if (error.name === "NoSuchKey") return;
-			throw error;
+			this.logger?.error("S3Storage::getItem failed", {
+				operation: "getItem",
+				errorName: error.name,
+				bucket: this.bucket,
+				statusCode: error.$metadata?.httpStatusCode
+			});
+			throw new StorageError(`Failed to retrieve item from S3: ${error.name}`, "getItem", error, {
+				bucket: this.bucket,
+				errorName: error.name,
+				statusCode: error.$metadata?.httpStatusCode
+			});
 		}
 	}
 	/**
+	* Retrieves and parses multiple values from S3 storage by their keys.
+	*
+	* @template T
+	* @param {string[]} keys - The keys whose values should be retrieved.
+	* @returns {Promise<T[]>} An array of stored values parsed as type T, with undefined for missing keys.
+	* @throws {StorageError} Wraps any S3 error except for missing keys (`NoSuchKey`) with sanitized error information.
+	*/
+	async getItems(keys) {
+		if (keys.length === 0) return [];
+		return await Promise.all(keys.map((key) => this.getItem(key)));
+	}
+	/**
 	* Stores a value in S3 storage under the specified key.
 	*
 	* @template T
@@ -77,7 +145,7 @@ var S3Storage = class {
 	*
 	* @param {string} key - The key to check.
 	* @returns {Promise<boolean>} True if the key exists, false otherwise.
-	* @throws Will rethrow any S3 error except for missing key (`NoSuchKey`).
+	* @throws {StorageError} Wraps any S3 error except for missing key (`NoSuchKey`) with sanitized error information.
 	*/
 	async hasItem(key) {
 		try {
@@ -88,7 +156,17 @@ var S3Storage = class {
 			return true;
 		} catch (error) {
 			if (error.name === "NoSuchKey") return false;
-			throw error;
+			this.logger?.error("S3Storage::hasItem failed", {
+				operation: "hasItem",
+				errorName: error.name,
+				bucket: this.bucket,
+				statusCode: error.$metadata?.httpStatusCode
+			});
+			throw new StorageError(`Failed to check item existence in S3: ${error.name}`, "hasItem", error, {
+				bucket: this.bucket,
+				errorName: error.name,
+				statusCode: error.$metadata?.httpStatusCode
+			});
 		}
 	}
 	/**

package/dist/{Storage-DeF_6O7t.d.mts → Storage-LzARx0pF.d.mts}

@@ -10,15 +10,15 @@
  * It supports basic operations like get, set, delete, and querying storage state.
  * Concrete implementations must provide the actual storage mechanism.
  */
-declare abstract class Storage<T = undefined> {
+declare abstract class Storage<InitOptions = undefined> {
   /**
    * Initializes the storage implementation.
    * Must be called before using any other storage operations.
    *
-   * @param {T} options - Initialization parameters. May be omitted if not required by the storage implementation.
+   * @param {InitOptions} options - Initialization parameters. May be omitted if not required by the storage implementation.
    * @returns {Promise<void>} A promise that resolves when initialization is complete.
    */
-  abstract initialize(options: T): void | Promise<void>;
+  abstract initialize(options: InitOptions): void | Promise<void>;
   /**
    * Retrieves a value from storage by its key
    * @template T - The type of the stored value
@@ -26,6 +26,13 @@ declare abstract class Storage<T = undefined> {
    * @returns {Promise<T>} A promise that resolves with the stored value
    */
   abstract getItem<T = unknown>(key: string): T | Promise<T>;
+  /**
+   * Retrieves multiple items from storage by their keys
+   * @template T - The type of the stored value
+   * @param {string[]} keys - The keys to retrieve the values for
+   * @returns {Promise<T[]>} A promise that resolves with the stored values or empty array if not found
+   */
+  abstract getItems<T = unknown>(keys: string[]): T[] | Promise<T[]>;
   /**
    * Stores a value in storage with the specified key
    * @template T - The type of the value to store

package/dist/StorageError-Dl7jGeVM.mjs

@@ -0,0 +1,30 @@
+//#region src/Errors/StorageError.ts
+/**
+* Custom error class for storage-related errors.
+* Wraps underlying storage driver errors with standardized error messages.
+*/
+var StorageError = class StorageError extends Error {
+	/**
+	* The original error that caused this storage error
+	*/
+	cause;
+	/**
+	* The storage operation that failed
+	*/
+	operation;
+	/**
+	* Additional metadata about the error (non-sensitive)
+	*/
+	metadata;
+	constructor(message, operation, cause, metadata) {
+		super(message);
+		this.name = "StorageError";
+		this.operation = operation;
+		this.cause = cause;
+		this.metadata = metadata;
+		if (Error.captureStackTrace) Error.captureStackTrace(this, StorageError);
+	}
+};
+
+//#endregion
+export { StorageError as t };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { t as Storage } from "./Storage-DeF_6O7t.mjs";
+import { t as Storage } from "./Storage-LzARx0pF.mjs";
 import { IOC } from "@vercube/di";
 
 //#region src/Types/StorageTypes.d.ts
@@ -21,6 +21,9 @@ declare namespace StorageTypes {
   interface GetItem extends BaseOptions {
     key: string;
   }
+  interface GetItems extends BaseOptions {
+    keys: string[];
+  }
   interface SetItem<T = unknown, U = unknown> extends BaseOptions {
     key: string;
     value: T;
@@ -80,6 +83,18 @@ declare class StorageManager {
     storage,
     key
   }: StorageTypes.GetItem): Promise<T | null>;
+  /**
+   * Retrieves multiple items from the specified storage
+   * @template T - Type of the stored value
+   * @param {StorageTypes.GetItems} params - Parameters for retrieving multiple items
+   * @param {string} [params.storage] - Name of the storage to retrieve from, defaults to 'default'
+   * @param {string[]} params.keys - Keys of the items to retrieve
+   * @returns {Promise<T[]>} A promise that resolves with the stored values or empty array if not found
+   */
+  getItems<T = unknown>({
+    storage,
+    keys
+  }: StorageTypes.GetItems): Promise<T[]>;
   /**
    * Stores an item in the specified storage
    * @template T - Type of the value to store
@@ -152,4 +167,25 @@ declare class StorageManager {
   private init;
 }
 //#endregion
-export { Storage, StorageManager, StorageTypes };
+//#region src/Errors/StorageError.d.ts
+/**
+ * Custom error class for storage-related errors.
+ * Wraps underlying storage driver errors with standardized error messages.
+ */
+declare class StorageError extends Error {
+  /**
+   * The original error that caused this storage error
+   */
+  readonly cause?: Error;
+  /**
+   * The storage operation that failed
+   */
+  readonly operation: string;
+  /**
+   * Additional metadata about the error (non-sensitive)
+   */
+  readonly metadata?: Record<string, unknown>;
+  constructor(message: string, operation: string, cause?: Error, metadata?: Record<string, unknown>);
+}
+//#endregion
+export { Storage, StorageError, StorageManager, StorageTypes };

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { t as Storage } from "./Storage-Yj1niSzz.mjs";
+import { t as StorageError } from "./StorageError-Dl7jGeVM.mjs";
 import { Container, Init, Inject, InjectOptional } from "@vercube/di";
 import { Logger } from "@vercube/logger";
 
-//#region \0@oxc-project+runtime@0.95.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.110.0/helpers/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -57,6 +58,17 @@ var StorageManager = class {
 		return this.getStorage(storage)?.getItem(key) ?? null;
 	}
 	/**
+	* Retrieves multiple items from the specified storage
+	* @template T - Type of the stored value
+	* @param {StorageTypes.GetItems} params - Parameters for retrieving multiple items
+	* @param {string} [params.storage] - Name of the storage to retrieve from, defaults to 'default'
+	* @param {string[]} params.keys - Keys of the items to retrieve
+	* @returns {Promise<T[]>} A promise that resolves with the stored values or empty array if not found
+	*/
+	async getItems({ storage, keys }) {
+		return this.getStorage(storage)?.getItems(keys) ?? [];
+	}
+	/**
 	* Stores an item in the specified storage
 	* @template T - Type of the value to store
 	* @param {StorageTypes.SetItem<T>} params - Parameters for storing an item
@@ -133,4 +145,4 @@ __decorate([InjectOptional(Logger)], StorageManager.prototype, "gLogger", void 0
 __decorate([Init()], StorageManager.prototype, "init", null);
 
 //#endregion
-export { Storage, StorageManager };
+export { Storage, StorageError, StorageManager };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercube/storage",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "Storage module for Vercube framework",
   "repository": {
     "type": "git",
@@ -24,16 +24,16 @@
     "README.md"
   ],
   "dependencies": {
-    "@vercube/di": "0.0.33",
-    "@vercube/logger": "0.0.33"
+    "@vercube/logger": "0.0.35",
+    "@vercube/di": "0.0.35"
   },
   "optionalDependencies": {
-    "@aws-sdk/client-s3": "3.921.0"
+    "@aws-sdk/client-s3": "3.975.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsdown --config tsdown.config.ts"
+    "build": "tsdown --config tsdown.config.ts --config-loader=unrun"
   }
 }