twin-db 1.0.2 → 1.1.0

package/README.md

@@ -0,0 +1,88 @@
+### Before All
+Make sure you're using `"type": "module"` in package.json.<br>
+Make sure to pass just values that JSON accepts, if not, the values will be changed to `null`.
+# How to Use?
+To create a new database make the following step:
+```js
+import TwinDB from 'twin-db';
+const database = new TwinDB('db');
+```
+And your database is done.
+### You can make various databases too:
+```js
+import TwinDB from 'twin-db';
+const database = new TwinDB('db');
+const coolDatabase = new TwinDB('cool');
+```
+# Database Methods
+Now we going to explain you the database methods.<br>
+Imagine the following data from a random database:
+```json
+{
+  "name": "Daniel",
+  "surname": "Costa",
+  "age": 60,
+  "cool": false,
+  "hobbies": ["cs", "pizza"],
+  "address": {
+    "city": "I dont",
+    "state": "ES",
+    "country": "Brazil"
+  }
+}
+```
+### 1. Set Method
+This one changes the value of a path to the value you passed.
+```js
+database.set('name', 'De'); // now the name is "De".
+database.set('age', 50); // now the age is 50.
+```
+- To go through the object, make sure to use ".", like `address.city`.
+### 2. Get Method
+Get a value from a given path.
+```js
+database.get('surname'); // returns "Costa".
+```
+###  3. Delete Method
+Deletes a value from data.
+```js
+database.delete('cool') // now the cool value no longer exists.
+database.delete('address.country') // now the country no longer exists too.
+```
+### 4. Sum Method
+Sum the current value of the given path with the given value.
+```js
+database.sum('age', 30); // now the age is 80.
+```
+### 5. Sub Method
+Subtract the current value of the given path with the given value.
+```js
+database.sub('age', 10); // now the age is 70.
+```
+### 6. Concat Method
+Concatenate the current value of the given path with the given value.
+```js
+database.concat('address.city', ' know'); // now the city is "I dont know".
+```
+### 7. Push Method
+Push the given values into the current value array.
+```js
+database.push('hobbies', 'sleep', 'valorant'); // now the hobbies is ["cs", "pizza", "sleep", "valorant"].
+```
+### 8. Pull Method
+```js
+database.pull('hobbies', 'cs', 'sleep') // now the hobbies is ["pizza", "valorant"].
+```
+### Now the data object will looks like that:
+```json
+{
+  "name": "De",
+  "surname": "Costa",
+  "age": 70,
+  "hobbies": ["pizza", "valorant"],
+  "address": {
+    "city": "I dont know",
+    "state": "ES"
+  }
+}
+```

package/dist/index.js

@@ -1,2 +1,2 @@
-import { TwinDB } from './structures/database.js';
+import { TwinDB } from './structures/database';
 export default TwinDB;

package/dist/structures/database.js

@@ -33,7 +33,7 @@ export class TwinDB {
                 if (typeof searchedValue !== 'object')
                     await eval('this.data' + mappedKeys.join('') + ' = {}');
             } // percorre todos os objetos definindo eles como {} para não dar erro abaixo
-        await eval(`this.data` +
+        await eval('this.data' +
             keys.map((key) => `['${key}']`).join('') +
             ` = ${JSON.stringify(value)}`);
         writeFileSync(this.path, JSON.stringify(this.data, null, 2), 'utf8');
@@ -82,9 +82,9 @@ export class TwinDB {
         const isSum = type === 'sum';
         if (!value || typeof value !== 'number')
             throw new Error(`The value to ${isSum ? 'sum' : 'sub'} must be a number`);
-        const currentValue = this.get(path);
+        let currentValue = (this.get(path) || 0);
         if (typeof currentValue !== 'number')
-            throw new Error(`The value to ${isSum ? 'sum' : 'sub'} is not a number or the path does not exists`);
+            currentValue = 0;
         return this.update(path, isSum ? currentValue + value : currentValue - value);
     }
     sum(path, value) {
@@ -108,9 +108,9 @@ export class TwinDB {
             throw new Error(pathErrorMessage);
         if (!values || values.length === 0)
             throw new Error('You must provide a value to update');
-        const currentValue = this.get(path);
+        let currentValue = (this.get(path) || []);
         if (!Array.isArray(currentValue))
-            throw new Error('The current value of this path is not an array or the path does not exists');
+            currentValue = [];
         currentValue.push(...values);
         return this.update(path, currentValue);
     }
@@ -121,7 +121,7 @@ export class TwinDB {
             throw new Error('You must provide a value to update');
         const currentValue = this.get(path);
         if (!Array.isArray(currentValue))
-            throw new Error('The current value of this path is not an array or the path does not exists');
+            throw new Error('The value to pull is not an array or the path does not exists');
         for (const value of values) {
             const index = currentValue.indexOf(value);
             if (index < 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twin-db",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "A usefully local database.",
   "main": "dist/index.js",
   "module": "dist/index.js",