node-persist-manager 1.0.7 → 1.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Luligu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2024 Luligu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,124 +1,136 @@
-# NodeStorageManager and NodeStorage
-
-[![npm version](https://img.shields.io/npm/v/node-persist-manager.svg)](https://www.npmjs.com/package/node-persist-manager)
-[![npm downloads](https://img.shields.io/npm/dt/node-persist-manager.svg)](https://www.npmjs.com/package/node-persist-manager)
-![Node.js CI](https://github.com/Luligu/node-persist-manager/actions/workflows/build.yml/badge.svg)
-
----
-
-NodeStorage is a lightweight, file-based storage management system for Node.js, built on top of `node-persist`. It allows for easy and intuitive handling of persistent key-value storage directly within your Node.js applications. This system is ideal for small to medium-sized projects requiring simple data persistence without the overhead of a database system.
-
-## Features
-
-- Simple and intuitive API for data storage and retrieval.
-- Asynchronous data handling.
-- Customizable storage directories for isolated storage contexts.
-- Built-in logging capabilities for monitoring storage initialization and operations.
-- Comprehensive test suite using Jest to ensure reliability and performance.
-- Detailed documentation with JSDoc for better developer experience.
-
-## Getting Started
-
-### Prerequisites
-
-- Node.js installed on your machine.
-- Basic knowledge of TypeScript and Node.js.
-
-### Installation
-
-To get started with NodeStorage in your package
-
-```bash
-npm install node-persist-manager
-```
-
-# Usage
-
-## Initializing NodeStorageManager:
-
-Create an instance of NodeStorageManager to manage your storage instances.
-
-```
-import { NodeStorageManager, NodeStorage } from 'node-persist-manager';
-```
-
-```
-const storageManager = new NodeStorageManager({
-  dir: 'path/to/storage/directory', // Optional: Customize the storage directory.
-  logging: true, // Optional: Enable logging.
-});
-```
-
-## Creating a Storage Instance:
-
-Use the manager to create a new storage context.
-
-```
-const myStorage = await storageManager.createStorage('myStorageName');
-```
-
-Using the Storage:
-
-## Set a value:
-
-```
-await myStorage.set('myKey', 'myValue');
-```
-
-## Get a value:
-
-```
-const value = await myStorage.get('myKey');
-console.log(value); // Outputs: 'myValue'
-```
-
-## Remove a value:
-
-```
-await myStorage.remove('myKey');
-```
-
-## Clear the storage:
-
-```
-await myStorage.clear();
-```
-
-# API Reference
-
-## NodeStorageManager methods:
-
-- async createStorage(storageName: string): Promise<NodeStorage>
-
-- async removeStorage(storageName: string): Promise<boolean>
-
-- async logStorage(): Promise<void>
-
-- async getStorageNames(): Promise<NodeStorageName[]>
-
-- async logStorage(): Promise<void>
-
-
-## NodeStorage methods:
-
-- async set<T = any>(key: NodeStorageKey, value: T): Promise&lt;void&gt;
-
-- async get<T = any>(key: NodeStorageKey, defaultValue?: T): Promise&lt;T&gt;
-
-- async remove(key: NodeStorageKey): Promise&lt;void&gt;
-
-- async clear(): Promise&lt;void&gt;
-
-- async logStorage(): Promise&lt;void&gt;
-
-# Contributing
-
-Contributions to NodeStorage are welcome.
-
-# License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-
-# Acknowledgments
-
-Thanks to node-persist for providing the underlying storage mechanism.
+# NodeStorageManager and NodeStorage
+
+[![npm version](https://img.shields.io/npm/v/node-persist-manager.svg)](https://www.npmjs.com/package/node-persist-manager)
+[![npm downloads](https://img.shields.io/npm/dt/node-persist-manager.svg)](https://www.npmjs.com/package/node-persist-manager)
+![Node.js CI](https://github.com/Luligu/node-persist-manager/actions/workflows/build.yml/badge.svg)
+![CodeQL](https://github.com/Luligu/node-persist-manager/actions/workflows/codeql.yml/badge.svg)
+[![codecov](https://codecov.io/gh/Luligu/node-persist-manager/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/node-persist-manager)
+
+---
+
+NodeStorage is a lightweight, file-based storage management system for Node.js, built on top of `node-persist`. It allows for easy and intuitive handling of persistent key-value storage directly within your Node.js applications. This system is ideal for small to medium-sized projects requiring simple data persistence without the overhead of a database system.
+
+## Features
+
+- Simple and intuitive API for data storage and retrieval.
+- Asynchronous data handling.
+- Customizable storage directories for isolated storage contexts.
+- Built-in logging capabilities for monitoring storage initialization and operations.
+- Comprehensive test suite using Jest to ensure reliability and performance.
+- Detailed documentation with JSDoc for better developer experience.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js installed on your machine.
+- Basic knowledge of TypeScript and Node.js.
+
+### Installation
+
+To get started with NodeStorage in your package
+
+```bash
+npm install node-persist-manager
+```
+
+### TypeScript & ESM Support
+
+This package is written in **TypeScript** and distributed as an **ECMAScript module (ESM)**. You should use `import` statements to use it in your project:
+
+```typescript
+import { NodeStorageManager, NodeStorage } from 'node-persist-manager';
+```
+
+- If you are using CommonJS, consider using dynamic `import()` or transpiling your code to ESM.
+- Type definitions are included out of the box for TypeScript users.
+
+# Usage
+
+## Initializing NodeStorageManager:
+
+Create an instance of NodeStorageManager to manage your storage instances.
+
+```typescript
+import { NodeStorageManager, NodeStorage } from 'node-persist-manager';
+```
+
+```typescript
+const storageManager = new NodeStorageManager({
+  dir: 'path/to/storage/directory', // Optional: Customize the storage directory.
+  logging: true, // Optional: Enable logging.
+});
+```
+
+## Creating a Storage Instance:
+
+Use the manager to create a new storage context.
+
+```typescript
+const myStorage = await storageManager.createStorage('myStorageName');
+```
+
+Using the Storage:
+
+## Set a value:
+
+```typescript
+await myStorage.set('myKey', 'myValue');
+```
+
+## Get a value:
+
+```typescript
+const value = await myStorage.get('myKey');
+console.log(value); // Outputs: 'myValue'
+```
+
+## Remove a value:
+
+```typescript
+await myStorage.remove('myKey');
+```
+
+## Clear the storage:
+
+```typescript
+await myStorage.clear();
+```
+
+# API Reference
+
+## NodeStorageManager methods:
+
+- async createStorage(storageName: string): Promise&lt;NodeStorage&gt;
+
+- async removeStorage(storageName: string): Promise&lt;boolean&gt;
+
+- async logStorage(): Promise&lt;void&gt;
+
+- async getStorageNames(): Promise&lt;NodeStorageName[]&gt;
+
+- async logStorage(): Promise&lt;void&gt;
+
+## NodeStorage methods:
+
+- async set<T = any>(key: NodeStorageKey, value: T): Promise&lt;void&gt;
+
+- async get<T = any>(key: NodeStorageKey, defaultValue?: T): Promise&lt;T&gt;
+
+- async remove(key: NodeStorageKey): Promise&lt;void&gt;
+
+- async clear(): Promise&lt;void&gt;
+
+- async logStorage(): Promise&lt;void&gt;
+
+# Contributing
+
+Contributions to NodeStorage are welcome.
+
+# License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+# Acknowledgments
+
+Thanks to node-persist for providing the underlying storage mechanism.

package/dist/nodeStorage.d.ts

@@ -3,16 +3,29 @@
  *
  * @file nodeStorage.ts
  * @author Luca Liguori
- * @date 2024-02-02
+ * @created 2024-02-02
  * @version 1.0.1
+ * @license Apache-2.0
  *
- * All rights reserved.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
-import NodePersist, { LocalStorage, InitOptions } from 'node-persist';
+import NodePersist, { LocalStorage } from 'node-persist';
+import type { InitOptions } from 'node-persist';
 export type NodeStorageKey = string;
+export type NodeStorageValue = unknown;
 export type NodeStorageName = string;
-export { InitOptions } from 'node-persist';
 /**
  * Class responsible for managing multiple node storages.
  */
@@ -22,6 +35,7 @@ export declare class NodeStorageManager {
     private storageNames;
     /**
      * Initializes a new instance of NodeStorageManager with optional initialization options.
+     *
      * @param {InitOptions} [initOptions] - Optional initialization options to customize the storage.
      */
     constructor(initOptions?: InitOptions);
@@ -31,25 +45,30 @@ export declare class NodeStorageManager {
     close(): Promise<void>;
     /**
      * Creates and initializes a new storage with a given name.
+     *
      * @param {string} storageName - The name of the new storage to create.
      * @returns {Promise<NodeStorage>} A promise that resolves to the newly created NodeStorage instance.
      */
     createStorage(storageName: string): Promise<NodeStorage>;
     /**
      * Removes a storage by its name.
+     *
      * @param {string} storageName - The name of the storage to remove.
      * @returns {Promise<boolean>} A promise that resolves to true if the storage was successfully removed, otherwise false.
      */
     removeStorage(storageName: string): Promise<boolean>;
     /**
      * Retrieves the names of all available storages.
+     *
      * @returns {Promise<NodeStorageName[]>} A promise that resolves to an array of storage names.
      */
     getStorageNames(): Promise<NodeStorageName[]>;
     /**
      * Logs the names of all managed storages to the console.
+     *
+     * @returns {Promise<number>} A promise that resolves to the number of storages managed by this NodeStorageManager.
      */
-    logStorage(): Promise<void>;
+    logStorage(): Promise<number>;
 }
 /**
  * Class representing a storage for nodes.
@@ -59,6 +78,7 @@ export declare class NodeStorage {
     private readonly initOptions;
     /**
      * Creates an instance of NodeStorage.
+     *
      * @param {LocalStorage} storage - The local storage instance.
      * @param {InitOptions} initOptions - The initialization options.
      */
@@ -69,6 +89,7 @@ export declare class NodeStorage {
     close(): Promise<void>;
     /**
      * Sets a value for a given key in the storage.
+     *
      * @template T - The type of the value to be stored.
      * @param {NodeStorageKey} key - The key under which the value is stored.
      * @param {T} value - The value to store.
@@ -78,32 +99,71 @@ export declare class NodeStorage {
     /**
      * Retrieves a value for a given key from the storage.
      * If the key does not exist, returns a default value if provided.
+     *
      * @template T - The type of the value to retrieve.
      * @param {NodeStorageKey} key - The key of the value to retrieve.
      * @param {T} [defaultValue] - The default value to return if the key is not found.
      * @returns {Promise<T>} A promise that resolves with the value.
      */
-    get<T = any>(key: NodeStorageKey, defaultValue?: T): Promise<T>;
+    get<T = any>(key: NodeStorageKey, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Checks if the storage has a given key.
+     *
+     * @param {NodeStorageKey} key - The key to check.
+     * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
+     */
+    has(key: NodeStorageKey): Promise<boolean>;
     /**
      * Checks if the storage includes a given key.
+     *
      * @param {NodeStorageKey} key - The key to check.
      * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
      */
     includes(key: NodeStorageKey): Promise<boolean>;
+    /**
+     * Checks if the storage includes a given key.
+     *
+     * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
+     */
+    size(): Promise<number>;
     /**
      * Removes a value for a given key from the storage.
+     *
      * @param {NodeStorageKey} key - The key of the value to remove.
      * @returns {Promise<NodePersist.DeleteFileResult>} A promise that resolves with the result of deleting the file.
      */
     remove(key: NodeStorageKey): Promise<NodePersist.DeleteFileResult>;
+    /**
+     * Retrieves all data from the storage as a record.
+     *
+     * @returns {Promise<Record<NodeStorageKey, NodeStorageValue>>} A promise that resolves with the data in the storage.
+     */
+    data(): Promise<Record<NodeStorageKey, NodeStorageValue>>;
+    /**
+     * Retrieves the keys of the entries in the storage.
+     *
+     * @returns {Promise<number>} A promise that resolves with the keys of the entries in the storage.
+     */
+    keys(): Promise<NodeStorageKey[]>;
+    /**
+     * Retrieves the values of the entries in the storage.
+     *
+     * @template T - The type of the values to retrieve.
+     * @returns {Promise<T[]>} A promise that resolves with an array of values.
+     */
+    values<T = unknown>(): Promise<T[]>;
+    static healthCheck(storage: NodePersist.LocalStorage): Promise<boolean>;
     /**
      * Clears all entries from the storage.
+     *
      * @returns {Promise<void>} A promise that resolves when the storage is cleared.
      */
     clear(): Promise<void>;
     /**
      * Logs the current storage state to the console.
+     *
+     * @returns {Promise<number>} A promise that resolves with the number of keys in the storage.
      */
-    logStorage(): Promise<void>;
+    logStorage(): Promise<number>;
 }
 //# sourceMappingURL=nodeStorage.d.ts.map

package/dist/nodeStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodeStorage.d.ts","sourceRoot":"","sources":["../src/nodeStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,WAAW,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAItE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAE3C;;;OAGG;gBACS,WAAW,CAAC,EAAE,WAAW;IAoBrC;;OAEG;IACG,KAAK;IAKX;;;;OAIG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoB9D;;;;OAIG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1D;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKnD;;OAEG;IACG,UAAU;CAOjB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW;IAK3D;;OAEG;IACG,KAAK;IAKX;;;;;;OAMG;IAEG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;IAIvF;;;;;;;OAOG;IAEG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAIxE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,UAAU;CAOjB"}
+{"version":3,"file":"nodeStorage.d.ts","sourceRoot":"","sources":["../src/nodeStorage.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACvC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;;OAIG;gBACS,WAAW,CAAC,EAAE,WAAW;IAwBrC;;OAEG;IACG,KAAK;IAOX;;;;;OAKG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqB9D;;;;;OAKG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB1D;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKnD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAQpC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;;OAKG;gBACS,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW;IAK3D;;OAEG;IACG,KAAK;IAOX;;;;;;;OAOG;IAEG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;IAIvF;;;;;;;;OAQG;IAEG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAWjF;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhD;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAIxE;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAS/D;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIvC;;;;;OAKG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC;WAI5B,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB7E;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAQpC"}

package/dist/nodeStorage.js

@@ -1,17 +1,30 @@
+/* eslint-disable no-console */
 /**
  * This file contains the classes NodeStorageManager and NodeStorage
  *
  * @file nodeStorage.ts
  * @author Luca Liguori
- * @date 2024-02-02
+ * @created 2024-02-02
  * @version 1.0.1
+ * @license Apache-2.0
  *
- * All rights reserved.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
 import NodePersist from 'node-persist';
-import { rm } from 'fs/promises';
-import path from 'path';
 /**
  * Class responsible for managing multiple node storages.
  */
@@ -21,97 +34,109 @@ export class NodeStorageManager {
     storageNames = [];
     /**
      * Initializes a new instance of NodeStorageManager with optional initialization options.
+     *
      * @param {InitOptions} [initOptions] - Optional initialization options to customize the storage.
      */
     constructor(initOptions) {
         // Merge initOptions with default initOptions
         this.initOptions = Object.assign({
             dir: path.join(process.cwd(), 'node_storage'),
+            writeQueue: false,
+            expiredInterval: undefined,
             logging: false,
         }, initOptions);
         // Create and initialize a new instace of LocalStorage
         this.storage = NodePersist.create(this.initOptions);
         this.storage.initSync(this.initOptions);
+        if (this.storage.options.writeQueue === false) {
+            clearInterval(this.storage._writeQueueInterval);
+            this.storage._writeQueueInterval = undefined;
+        }
         if (this.initOptions.logging === true) {
             console.log(`Storage manager initialized with options ${JSON.stringify(this.initOptions)}`);
         }
-        /*
-            this.get<Array<NodeStorageName>>('storageNames').then(storageNames => {
-                this.storageNames = storageNames;
-            });
-            */
     }
     /**
      * Closes the node storage manager by stopping the expired keys interval and the write queue interval.
      */
     async close() {
         this.storage.stopExpiredKeysInterval();
+        this.storage._expiredKeysInterval = undefined;
         this.storage.stopWriteQueueInterval();
+        this.storage._writeQueueInterval = undefined;
     }
     /**
      * Creates and initializes a new storage with a given name.
+     *
      * @param {string} storageName - The name of the new storage to create.
      * @returns {Promise<NodeStorage>} A promise that resolves to the newly created NodeStorage instance.
      */
     async createStorage(storageName) {
         const initOptions = {};
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         Object.assign(initOptions, this.initOptions, { dir: path.join(this.initOptions.dir, '.' + storageName) });
         const storage = NodePersist.create(initOptions);
         await storage.init(initOptions);
-        //console.log(`Created storage ${storageName} with options ${JSON.stringify(initOptions)}`);
+        if (storage.options.writeQueue === false) {
+            clearInterval(storage._writeQueueInterval);
+            storage._writeQueueInterval = undefined;
+        }
         // Update storageNames
-        this.storageNames = await this.storage.get('storageNames') ?? [];
-        //console.log('Storage list(1):', this.storageNames);
+        this.storageNames = (await this.storage.get('storageNames')) ?? [];
         if (!this.storageNames.includes(storageName)) {
             this.storageNames.push(storageName);
         }
-        //console.log('Storage list(2):', this.storageNames);
         await this.storage.set('storageNames', this.storageNames);
-        //console.log('Storage list(3):', await this.storage.get('storageNames') );
         return new NodeStorage(storage, initOptions);
     }
     /**
      * Removes a storage by its name.
+     *
      * @param {string} storageName - The name of the storage to remove.
      * @returns {Promise<boolean>} A promise that resolves to true if the storage was successfully removed, otherwise false.
      */
     async removeStorage(storageName) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         const dir = path.join(this.initOptions.dir, '.' + storageName);
         try {
             await rm(dir, { recursive: true });
-            //console.log('Storage removed');
+            // console.log('Storage removed');
             // Update storageNames
-            this.storageNames = await this.storage.get('storageNames') ?? [];
+            this.storageNames = (await this.storage.get('storageNames')) ?? [];
             const index = this.storageNames.indexOf(storageName);
             if (index > -1) {
                 this.storageNames.splice(index, 1);
             }
             await this.storage.set('storageNames', this.storageNames);
-            //console.log('Storage list:', await this.storage.get('storageNames') );
+            // console.log('Storage list:', await this.storage.get('storageNames') );
             return true;
         }
-        catch (err) {
-            //console.error('Error removing storage:', err);
+        catch (_err) {
+            // console.error('Error removing storage:', _err);
             return false;
         }
     }
     /**
      * Retrieves the names of all available storages.
+     *
      * @returns {Promise<NodeStorageName[]>} A promise that resolves to an array of storage names.
      */
     async getStorageNames() {
-        this.storageNames = await this.storage.get('storageNames') ?? [];
+        this.storageNames = (await this.storage.get('storageNames')) ?? [];
         return this.storageNames;
     }
     /**
      * Logs the names of all managed storages to the console.
+     *
+     * @returns {Promise<number>} A promise that resolves to the number of storages managed by this NodeStorageManager.
      */
     async logStorage() {
         console.log('This NodeStorageManager has these storages:');
-        const storageNames = await this.storage.get('storageNames') ?? [];
-        storageNames.forEach(name => {
+        const storageNames = (await this.storage.get('storageNames')) ?? [];
+        storageNames.forEach((name) => {
             console.log(`- ${name}`);
         });
+        return await this.storage.length();
     }
 }
 /**
@@ -122,6 +147,7 @@ export class NodeStorage {
     initOptions;
     /**
      * Creates an instance of NodeStorage.
+     *
      * @param {LocalStorage} storage - The local storage instance.
      * @param {InitOptions} initOptions - The initialization options.
      */
@@ -134,10 +160,13 @@ export class NodeStorage {
      */
     async close() {
         this.storage.stopExpiredKeysInterval();
+        this.storage._expiredKeysInterval = undefined;
         this.storage.stopWriteQueueInterval();
+        this.storage._writeQueueInterval = undefined;
     }
     /**
      * Sets a value for a given key in the storage.
+     *
      * @template T - The type of the value to be stored.
      * @param {NodeStorageKey} key - The key under which the value is stored.
      * @param {T} value - The value to store.
@@ -150,6 +179,7 @@ export class NodeStorage {
     /**
      * Retrieves a value for a given key from the storage.
      * If the key does not exist, returns a default value if provided.
+     *
      * @template T - The type of the value to retrieve.
      * @param {NodeStorageKey} key - The key of the value to retrieve.
      * @param {T} [defaultValue] - The default value to return if the key is not found.
@@ -158,27 +188,109 @@ export class NodeStorage {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async get(key, defaultValue) {
         const value = await this.storage.getItem(key);
-        return value !== undefined ? value : defaultValue;
+        if (value !== undefined) {
+            return value;
+        }
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        return undefined;
     }
     /**
-     * Checks if the storage includes a given key.
+     * Checks if the storage has a given key.
+     *
      * @param {NodeStorageKey} key - The key to check.
      * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
      */
-    async includes(key) {
+    async has(key) {
         const keys = await this.storage.keys();
         return keys.includes(key);
     }
+    /**
+     * Checks if the storage includes a given key.
+     *
+     * @param {NodeStorageKey} key - The key to check.
+     * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
+     */
+    async includes(key) {
+        return this.has(key);
+    }
+    /**
+     * Checks if the storage includes a given key.
+     *
+     * @returns {Promise<boolean>} A promise that resolves with true if the key exists, otherwise false.
+     */
+    async size() {
+        return this.storage.length();
+    }
     /**
      * Removes a value for a given key from the storage.
+     *
      * @param {NodeStorageKey} key - The key of the value to remove.
      * @returns {Promise<NodePersist.DeleteFileResult>} A promise that resolves with the result of deleting the file.
      */
     async remove(key) {
         return await this.storage.removeItem(key);
     }
+    /**
+     * Retrieves all data from the storage as a record.
+     *
+     * @returns {Promise<Record<NodeStorageKey, NodeStorageValue>>} A promise that resolves with the data in the storage.
+     */
+    async data() {
+        const map = new Map();
+        const data = await this.storage.data();
+        for (const datum of data) {
+            map.set(datum.key, datum.value);
+        }
+        return Object.fromEntries(map);
+    }
+    /**
+     * Retrieves the keys of the entries in the storage.
+     *
+     * @returns {Promise<number>} A promise that resolves with the keys of the entries in the storage.
+     */
+    async keys() {
+        return await this.storage.keys();
+    }
+    /**
+     * Retrieves the values of the entries in the storage.
+     *
+     * @template T - The type of the values to retrieve.
+     * @returns {Promise<T[]>} A promise that resolves with an array of values.
+     */
+    async values() {
+        return (await this.storage.values());
+    }
+    static async healthCheck(storage) {
+        try {
+            // Attempt to get data and keys, and access the first key
+            const data = await storage.data();
+            for (const datum of data) {
+                if (!datum || !datum.key) {
+                    if (storage.options.logging)
+                        console.error(`Health check failed for invalid data: ${JSON.stringify(datum)}`);
+                    return false; // Ensure datum is valid
+                }
+                await storage.getItem(datum.key); // Use getItem to ensure we can access the value
+            }
+            const keys = await storage.keys();
+            if (keys.length !== data.length)
+                return false; // Ensure keys match data length
+            const values = await storage.values();
+            if (values.length !== data.length)
+                return false; // Ensure values match data length
+            return true; // Storage is healthy
+        }
+        catch (error) {
+            if (storage.options.logging)
+                console.error('Health check failed:', error);
+            return false; // Storage is not healthy
+        }
+    }
     /**
      * Clears all entries from the storage.
+     *
      * @returns {Promise<void>} A promise that resolves when the storage is cleared.
      */
     async clear() {
@@ -186,6 +298,8 @@ export class NodeStorage {
     }
     /**
      * Logs the current storage state to the console.
+     *
+     * @returns {Promise<number>} A promise that resolves with the number of keys in the storage.
      */
     async logStorage() {
         console.log(`This NodeStorage has ${await this.storage.length()} keys:`);
@@ -193,6 +307,7 @@ export class NodeStorage {
         for (const key of keys) {
             console.log(`- ${key}: ${await this.storage.get(key)}`);
         }
+        return await this.storage.length();
     }
 }
 //# sourceMappingURL=nodeStorage.js.map

package/dist/nodeStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeStorage.js","sourceRoot":"","sources":["../src/nodeStorage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodeStorage.js","sourceRoot":"","sources":["../src/nodeStorage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-persist-manager",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Asyncronous Node.js storage manager in type script",
   "author": "https://github.com/Luligu",
   "license": "MIT",
@@ -11,31 +11,53 @@
   },
   "bugs": {
     "url": "https://github.com/Luligu/node-persist-manager/issues"
-  },  
+  },
   "funding": {
     "type": "buymeacoffee",
     "url": "https://www.buymeacoffee.com/luligugithub"
   },
   "type": "module",
   "main": "dist/nodeStorage.js",
-  "types": "dist/nodeStorage.d.js",
+  "types": "dist/nodeStorage.d.ts",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0 <19.0.0 || >=20.0.0 <21.0.0 || >=22.0.0 <23.0.0 || >=24.0.0 <25.0.0"
   },
   "scripts": {
     "build": "tsc",
     "watch": "tsc --watch",
-    "test": "jest",
-    "test:verbose": "jest --verbose",
-    "test:watch": "jest --watch",
-    "lint": "eslint src/**.ts",
-    "lint:fix": "eslint src/**.ts --fix",
-    "clean": "rimraf tsconfig.tsbuildinfo ./dist",
-    "cleanBuild": "npm run clean && tsc",
-    "deepClean": "rimraf tsconfig.tsbuildinfo package-lock.json ./dist ./node_modules ./node_storage",
+    "test": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:verbose": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --verbose",
+    "test:watch": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --watch -verbose",
+    "test:coverage": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --verbose --coverage",
+    "test:vitest": "vitest run",
+    "test:vitest:watch": "vitest --reporter verbose",
+    "test:vitest:verbose": "vitest run --reporter verbose",
+    "test:vitest:coverage": "vitest run --reporter verbose --coverage",
+    "lint": "eslint --max-warnings=0 .",
+    "lint:fix": "eslint --fix --max-warnings=0 .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "clean": "npx shx rm -rf tsconfig.tsbuildinfo dist",
+    "cleanBuild": "npm run clean && npm run build",
+    "deepClean": "npx shx rm -rf coverage dist jest temp package-lock.json npm-shrinkwrap.json tsconfig.tsbuildinfo node_modules/* node_modules/.[!.]* node_modules/..?*",
+    "deepCleanRebuild": "npm run deepClean && npm install && npm run build",
+    "reset": "npm run deepClean && npm install && npm run build",
+    "runMeBeforePublish": "npm run lint && npm run format && npm run build && npm run test",
     "prepublishOnly": "npm run lint && npm run cleanBuild",
     "checkDependencies": "npx npm-check-updates",
-    "updateDependencies": "npx npm-check-updates -u"
+    "updateDependencies": "npx npm-check-updates -u && npm install & npm run cleanBuild",
+    "preversion": "npm run lint && npm run test && npm run build",
+    "postversion": "git push && git push --tags",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "install:scripts": "npm install --save-dev npm-check-updates rimraf shx",
+    "install:dependencies": "npm install node-persist && npm install --save-dev @types/node-persist",
+    "install:typescript": "npm install --save-dev typescript @types/node",
+    "install:eslint": "npm install --save-dev @eslint/js typescript-eslint eslint-plugin-import eslint-plugin-n eslint-plugin-promise eslint-plugin-jsdoc",
+    "install:jest": "npm install --save-dev jest ts-jest @types/jest @jest/globals eslint-plugin-jest",
+    "install:vitest": "npm install --save-dev vitest @vitest/coverage-v8 @vitest/eslint-plugin",
+    "install:prettier": "npm install --save-dev prettier eslint-config-prettier eslint-plugin-prettier"
   },
   "keywords": [
     "node-persist",
@@ -46,17 +68,31 @@
     "NodeStorage"
   ],
   "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.11.30",
+    "@eslint/js": "^9.29.0",
+    "@jest/globals": "^30.0.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.3",
     "@types/node-persist": "^3.1.8",
-    "@typescript-eslint/eslint-plugin": "^7.4.0",
-    "@typescript-eslint/parser": "^7.4.0",
-    "eslint": "^8.57.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.4.3"
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/eslint-plugin": "^1.2.7",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jest": "^29.0.1",
+    "eslint-plugin-jsdoc": "^51.1.1",
+    "eslint-plugin-n": "^17.20.0",
+    "eslint-plugin-prettier": "^5.5.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "jest": "^30.0.2",
+    "npm-check-updates": "^18.0.1",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "shx": "^0.4.0",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.34.1",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
-    "node-persist": "^4.0.1"
+    "node-persist": "^4.0.4"
   }
 }