@vercube/storage 0.0.14 → 0.0.16

package/dist/Storage-DZ-jzAK_.d.mts

@@ -0,0 +1,67 @@
+//#region src/Service/Storage.d.ts
+/**
+ * Abstract base class for storage implementations
+ * Provides a common interface for different storage providers
+ *
+ * @abstract
+ * @class Storage
+ * @description
+ * The Storage class defines a standard interface for storing and retrieving data.
+ * 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> {
+  /**
+   * 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.
+   * @returns {Promise<void>} A promise that resolves when initialization is complete.
+   */
+  abstract initialize(options: T): void | Promise<void>;
+  /**
+   * Retrieves a value from storage by its key
+   * @template T - The type of the stored value
+   * @param {string} key - The key to retrieve the value for
+   * @returns {Promise<T>} A promise that resolves with the stored value
+   */
+  abstract getItem<T = unknown>(key: string): T | Promise<T>;
+  /**
+   * Stores a value in storage with the specified key
+   * @template T - The type of the value to store
+   * @template U - The type of the optional options object
+   * @param {string} key - The key under which to store the value
+   * @param {T} value - The value to store
+   * @returns {Promise<void>} A promise that resolves when the value is stored
+   */
+  abstract setItem<T = unknown, U = unknown>(key: string, value: T, options?: U): void | Promise<void>;
+  /**
+   * Removes a value from storage by its key
+   * @param {string} key - The key of the value to delete
+   * @returns {Promise<void>} A promise that resolves when the value is deleted
+   */
+  abstract deleteItem(key: string): void | Promise<void>;
+  /**
+   * Checks if a value exists in storage for the given key
+   * @param {string} key - The key to check
+   * @returns {Promise<boolean>} A promise that resolves to true if the key exists, false otherwise
+   */
+  abstract hasItem(key: string): boolean | Promise<boolean>;
+  /**
+   * Retrieves all keys currently stored in storage
+   * @returns {Promise<string[]>} A promise that resolves with an array of all stored keys
+   */
+  abstract getKeys(): string[] | Promise<string[]>;
+  /**
+   * Removes all stored values from storage
+   * @returns {Promise<void>} A promise that resolves when all values are cleared
+   */
+  abstract clear(): void | Promise<void>;
+  /**
+   * Gets the number of key-value pairs stored in storage
+   * @returns {Promise<number>} A promise that resolves with the number of stored items
+   */
+  abstract size(): number | Promise<number>;
+}
+//#endregion
+export { Storage };

package/dist/chunk-UoOzN6Vc.mjs

@@ -0,0 +1,40 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function() {
+	return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __commonJS, __esm, __export, __require, __toCommonJS, __toESM };

package/dist/index.d.mts

@@ -1,83 +1,21 @@
+import { Storage } from "./Storage-DZ-jzAK_.mjs";
 import { IOC } from "@vercube/di";
 
-//#region src/Service/Storage.d.ts
-
-/**
- * Abstract base class for storage implementations
- * Provides a common interface for different storage providers
- *
- * @abstract
- * @class Storage
- * @description
- * The Storage class defines a standard interface for storing and retrieving data.
- * It supports basic operations like get, set, delete, and querying storage state.
- * Concrete implementations must provide the actual storage mechanism.
- */
-declare abstract class Storage {
-  /**
-   * Initializes the storage implementation
-   * Must be called before using any other storage operations
-   * @param {unknown} [options] - Optional initialization parameters
-   * @returns {Promise<void>} A promise that resolves when initialization is complete
-   */
-  abstract initialize(options?: unknown): void | Promise<void>;
-  /**
-   * Retrieves a value from storage by its key
-   * @template T - The type of the stored value
-   * @param {string} key - The key to retrieve the value for
-   * @returns {Promise<T>} A promise that resolves with the stored value
-   */
-  abstract getItem<T = unknown>(key: string): T | Promise<T>;
-  /**
-   * Stores a value in storage with the specified key
-   * @template T - The type of the value to store
-   * @template U - The type of the optional options object
-   * @param {string} key - The key under which to store the value
-   * @param {T} value - The value to store
-   * @returns {Promise<void>} A promise that resolves when the value is stored
-   */
-  abstract setItem<T = unknown, U = unknown>(key: string, value: T, options?: U): void | Promise<void>;
-  /**
-   * Removes a value from storage by its key
-   * @param {string} key - The key of the value to delete
-   * @returns {Promise<void>} A promise that resolves when the value is deleted
-   */
-  abstract deleteItem(key: string): void | Promise<void>;
-  /**
-   * Checks if a value exists in storage for the given key
-   * @param {string} key - The key to check
-   * @returns {Promise<boolean>} A promise that resolves to true if the key exists, false otherwise
-   */
-  abstract hasItem(key: string): boolean | Promise<boolean>;
-  /**
-   * Retrieves all keys currently stored in storage
-   * @returns {Promise<string[]>} A promise that resolves with an array of all stored keys
-   */
-  abstract getKeys(): string[] | Promise<string[]>;
-  /**
-   * Removes all stored values from storage
-   * @returns {Promise<void>} A promise that resolves when all values are cleared
-   */
-  abstract clear(): void | Promise<void>;
-  /**
-   * Gets the number of key-value pairs stored in storage
-   * @returns {Promise<number>} A promise that resolves with the number of stored items
-   */
-  abstract size(): number | Promise<number>;
-}
-//#endregion
 //#region src/Types/StorageTypes.d.ts
 declare namespace StorageTypes {
   interface BaseOptions {
     storage?: string;
   }
-  interface Mount {
+  type Mount<T extends Storage<unknown>> = {
     name?: string;
-    storage: IOC.Newable<Storage>;
+    storage: IOC.Newable<T>;
+  } & (T extends Storage<undefined> ? {
     initOptions?: unknown;
-  }
+  } : T extends Storage<infer U> ? {
+    initOptions: U;
+  } : never);
   interface Storages<T = unknown> {
-    storage: Storage;
+    storage: Storage<T>;
     initOptions?: T;
   }
   interface GetItem extends BaseOptions {
@@ -119,11 +57,11 @@ declare class StorageManager {
    * @param {IOC.Newable<Storage>} params.storage - Storage implementation to mount
    * @returns {Promise<void>} A promise that resolves when mounting is complete
    */
-  mount({
+  mount<T extends Storage<unknown>>({
     name,
     storage,
     initOptions
-  }: StorageTypes.Mount): Promise<void>;
+  }: StorageTypes.Mount<T>): Promise<void>;
   /**
    * Retrieves a registered storage instance by name
    * @param {string} name - Name of the storage instance to retrieve
@@ -214,62 +152,4 @@ declare class StorageManager {
   private init;
 }
 //#endregion
-//#region src/Storages/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
- * Useful for testing, caching, and scenarios where temporary storage is needed
- *
- * @implements {Storage}
- */
-declare class MemoryStorage implements Storage {
-  /** Internal storage map to hold key-value pairs */
-  private storage;
-  /**
-   * Initializes the memory storage
-   * No initialization is needed for in-memory storage as the Map is created on instantiation
-   */
-  initialize(): void;
-  /**
-   * Retrieves a value from memory storage by its key
-   * @template T - Type of the stored value
-   * @param {string} key - The key to retrieve the value for
-   * @returns {T} The stored value cast to type T
-   */
-  getItem<T = unknown>(key: string): T;
-  /**
-   * 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
-   * @param {string} key - The key under which to store the value
-   * @param {T} value - The value to store
-   */
-  setItem<T = unknown, U = unknown>(key: string, value: T, options?: U): void;
-  /**
-   * Removes a value from memory storage by its key
-   * @param {string} key - The key of the value to delete
-   */
-  deleteItem(key: string): void;
-  /**
-   * Checks if a value exists in memory storage for the given key
-   * @param {string} key - The key to check
-   * @returns {boolean} True if the key exists, false otherwise
-   */
-  hasItem(key: string): boolean;
-  /**
-   * Retrieves all keys currently stored in memory storage
-   * @returns {string[]} Array of all stored keys
-   */
-  getKeys(): string[];
-  /**
-   * Removes all stored values from memory storage
-   */
-  clear(): void;
-  /**
-   * Gets the number of key-value pairs stored in memory storage
-   * @returns {number} The number of stored items
-   */
-  size(): number;
-}
-//#endregion
-export { MemoryStorage, Storage, StorageManager, StorageTypes };
+export { Storage, StorageManager, StorageTypes };

package/dist/index.mjs

@@ -1,35 +1,9 @@
-import "node:module";
+import { __commonJS, __toESM } from "./chunk-UoOzN6Vc.mjs";
 import { Container, Init, Inject, InjectOptional } from "@vercube/di";
 import { Logger } from "@vercube/logger";
 
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-//#region ../../node_modules/.pnpm/@oxc-project+runtime@0.75.0/node_modules/@oxc-project/runtime/src/helpers/decorate.js
-var require_decorate = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.75.0/node_modules/@oxc-project/runtime/src/helpers/decorate.js"(exports, module) {
+//#region ../../node_modules/.pnpm/@oxc-project+runtime@0.75.1/node_modules/@oxc-project/runtime/src/helpers/decorate.js
+var require_decorate = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.75.1/node_modules/@oxc-project/runtime/src/helpers/decorate.js"(exports, module) {
 	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);
@@ -41,7 +15,7 @@ var require_decorate = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runti
 
 //#endregion
 //#region src/Service/StorageManager.ts
-var import_decorate = __toESM(require_decorate());
+var import_decorate = __toESM(require_decorate(), 1);
 /**
 * Manages multiple storage instances and provides a unified interface for storage operations.
 * Each storage instance is identified by a unique name and implements the Storage interface.
@@ -185,77 +159,4 @@ var StorageManager = class {
 var Storage = class {};
 
 //#endregion
-//#region src/Storages/MemoryStorage.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
-* Useful for testing, caching, and scenarios where temporary storage is needed
-* 
-* @implements {Storage}
-*/
-var MemoryStorage = class {
-	/** Internal storage map to hold key-value pairs */
-	storage = /* @__PURE__ */ new Map();
-	/**
-	* Initializes the memory storage
-	* No initialization is needed for in-memory storage as the Map is created on instantiation
-	*/
-	initialize() {}
-	/**
-	* Retrieves a value from memory storage by its key
-	* @template T - Type of the stored value
-	* @param {string} key - The key to retrieve the value for
-	* @returns {T} The stored value cast to type T
-	*/
-	getItem(key) {
-		return 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
-	* @param {string} key - The key under which to store the value
-	* @param {T} value - The value to store
-	*/
-	setItem(key, value, options) {
-		this.storage.set(key, value);
-	}
-	/**
-	* Removes a value from memory storage by its key
-	* @param {string} key - The key of the value to delete
-	*/
-	deleteItem(key) {
-		this.storage.delete(key);
-	}
-	/**
-	* Checks if a value exists in memory storage for the given key
-	* @param {string} key - The key to check
-	* @returns {boolean} True if the key exists, false otherwise
-	*/
-	hasItem(key) {
-		return this.storage.has(key);
-	}
-	/**
-	* Retrieves all keys currently stored in memory storage
-	* @returns {string[]} Array of all stored keys
-	*/
-	getKeys() {
-		return [...this.storage.keys()];
-	}
-	/**
-	* Removes all stored values from memory storage
-	*/
-	clear() {
-		this.storage.clear();
-	}
-	/**
-	* Gets the number of key-value pairs stored in memory storage
-	* @returns {number} The number of stored items
-	*/
-	size() {
-		return this.storage.size;
-	}
-};
-
-//#endregion
-export { MemoryStorage, Storage, StorageManager };
+export { Storage, StorageManager };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercube/storage",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Storage module for Vercube framework",
   "repository": "@vercube/storage",
   "license": "MIT",
@@ -10,6 +10,8 @@
   "module": "./dist/index.mjs",
   "exports": {
     ".": "./dist/index.mjs",
+    "./drivers/MemoryStorage": "./dist/Drivers/MemoryStorage.mjs",
+    "./drivers/S3Storage": "./dist/Drivers/S3Storage.mjs",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.mts",
@@ -18,10 +20,19 @@
     "README.md"
   ],
   "dependencies": {
-    "@vercube/di": "0.0.14",
-    "@vercube/logger": "0.0.14"
+    "@vercube/di": "0.0.16",
+    "@vercube/logger": "0.0.16"
+  },
+  "optionalDependencies": {
+    "@aws-sdk/client-s3": "3.842.0"
+  },
+  "resolutions": {
+    "@vercube/storage": "workspace:*"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts"
   }
 }