opendb-store 1.1.1 → 1.2.0

package/README.md

@@ -142,3 +142,34 @@ Empty the entire storage.
 // Clears all data from local storage
 db.local.clear();
 ```
+
+### size(key: string, options={ format?: "B" | "KB" | "MB"; unit?: boolean }): string | number
+Get the size of the value for a specific key.
+
+```javascript
+const sizeInBytes = 2 * 1024 * 1024; // 2 MB
+const largeString = "A".repeat(sizeInBytes); // Create a 2MB string
+const largeObject = { data: largeString };
+
+db.local.set('largeObj', largeObject);
+console.log(db.local.size('largeObj')); // 2097163 (raw bytes)
+console.log(db.local.size('largeObj', { format: 'KB', unit: true })); // 2.00 MB
+```
+
+### free(options={ format?: "B" | "KB" | "MB"; unit?: boolean }): string | number
+Get the remaining free space in local or session storage.
+
+```javascript
+
+console.log(db.local.free()); // raw bytes
+console.log(db.local.free({ format: 'mb', unit: true })); // e.g., "3.00 MB"
+```
+
+### capacity(options={ format?: "B" | "KB" | "MB"; unit?: boolean }): string | number
+Get the total capacityof local or session storage.
+
+```javascript
+
+console.log(db.local.capacity()); // raw bytes
+console.log(db.local.capacity({ format: 'mb', unit: true })); // e.g., "5.00 MB"
+```

package/dist/opendb-esm.js

@@ -33,7 +33,7 @@ function generateKey(key) {
   return `${config$1.namespace}${config$1.separator}${key}`;
 }
 
-const version = '1.1.1';
+const version = '1.2.0';
 
 var config = {
   version,
@@ -89,10 +89,43 @@ function isNull(obj) {
   return obj === null || obj === 'null';
 }
 
-var util = {
+function auto(bytes, unit) {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return (bytes / Math.pow(k, i)).toFixed(2) + ' ' + (unit ? sizes[i] : '');
+}
+
+function units(bytes, format, unit) {
+  format = format.toUpperCase();
+  let formatted = '';
+
+  switch (format) {
+    case 'B':
+      formatted = bytes.toFixed(2);
+      break;
+    case 'KB':
+      formatted = (bytes / 1024).toFixed(2);
+      break;
+    case 'MB':
+      formatted = (bytes / (1024 * 1024)).toFixed(2);
+      break;
+    default:
+      console.warn(
+        `Unsupported format "${format}" provided. Falling back to auto-formatting.`
+      );
+      return auto(bytes, unit);
+  }
+
+  return unit ? `${formatted} ${format}` : formatted;
+}
+
+var utils = {
   parse,
   isUndefined,
   isNull,
+  units,
 };
 
 function isInvalidArg(key) {
@@ -115,12 +148,12 @@ function get(key, defaultValue = null) {
   const namespacedKey = config.generateKey(key);
   const value = this.storage.getItem(namespacedKey);
 
-  if (util.isNull(value)) {
+  if (utils.isNull(value)) {
     return defaultValue;
   }
 
   try {
-    let parsedData = util.parse(value);
+    let parsedData = utils.parse(value);
 
     if (parsedData.expire && Date.now() > parsedData.expire) {
       this.remove(key);
@@ -220,6 +253,23 @@ function trim(key) {
   return this.storage.get(key).trim();
 }
 
+function size(key, options = {}) {
+  const value = this.get(key);
+
+  if (value === null) {
+    return 0;
+  }
+
+  const bytes = new Blob([JSON.stringify(value)]).size;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return utils.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}
+
 function setFormattedData(key, obj) {
   const seprator = getSeparator();
 
@@ -246,7 +296,56 @@ function getFormattedData(key) {
   return result;
 }
 
+const DEFAULT_CAPACITY$1 = 5 * 1024 * 1024; // 5 MB
+
+function free(options = {}) {
+  const capacity = options.capacity || DEFAULT_CAPACITY$1;
+  const total = this.used();
+  const remaining = capacity - total;
+  const bytes = remaining > 0 ? remaining : 0;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return utils.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}
+
+function used() {
+  let totalBytes = 0;
+  const seprator = getSeparator();
+
+  for (let i = 0; i < this.count; i++) {
+    const completkey = this.key(i);
+    const [, currentkey] = completkey.split(`${seprator}`, 2);
+
+    const value = this.get(currentkey);
+    totalBytes += new Blob([JSON.stringify(completkey)]).size;
+    totalBytes += new Blob([JSON.stringify(value)]).size;
+  }
+
+  return totalBytes;
+}
+
+const DEFAULT_CAPACITY = 5 * 1024 * 1024; // 5 MB
+
+function capacity(options = {}) {
+  const bytes = options.capacity || DEFAULT_CAPACITY;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return utils.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}
+
 var storageMethods = {
+  size,
+  free,
+  used,
+  capacity,
   from,
   get,
   set,

package/dist/opendb-esm.min.js

@@ -1 +1 @@
-const config$1={namespace:"app",separator:".",trimKeys:!0,expiry:!0};function createNamespace(e){config$1.namespace=e}function switchNamespace(e){config$1.namespace=e}function getCurrentNamespace(){return config$1.namespace}function get$1(){return config$1}function setSeparator(e){config$1.separator=e}function getSeparator(){return config$1.separator}function generateKey(e){return`${config$1.namespace}${config$1.separator}${e}`}const version="1.1.1";var config={version:"1.1.1",createNamespace:createNamespace,getCurrentNamespace:getCurrentNamespace,switchNamespace:switchNamespace,get:get$1,setSeparator:setSeparator,getSeparator:getSeparator,generateKey:generateKey};function from(e){e&&switchNamespace(e)}function parse(e){try{return JSON.parse(e)}catch{return e}}function isUndefined(e){return void 0===e}function isNull(e){return null===e||"null"===e}var util={parse:parse,isUndefined:isUndefined,isNull:isNull};function isInvalidArg(e){return isUndefined(e)||isNull(e)}function get(e,t=null){if(isInvalidArg(e))return null;const r=config.generateKey(e),n=this.storage.getItem(r);if(util.isNull(n))return t;try{let r=util.parse(n);return r.expire&&Date.now()>r.expire?(this.remove(e),t):r.value}catch{return t}}function set(e,t,r={}){if(isInvalidArg(e))return null;const n=config.generateKey(e),{expire:a}=r;let o={value:t,...a?{expire:Date.now()+a}:{}};this.storage.setItem(n,JSON.stringify(o))}function has(e){return!!this.get(e)}function remove(e){const t=this.get(e),r=config.generateKey(e);return this.storage.removeItem(r),t}function clear(){return this.storage.clear()}function key(e){return this.storage.key(e)}function keys(){const e=[];for(let t=0;t<this.storage.length;t++)e.push(this.storage.key(t));return e}function trim(e){return this.storage.get(e).trim()}function setFormattedData(e,t){const r=getSeparator();for(let n in t)n in t&&this.set(`${e}${r}${n}`,t[n])}function getFormattedData(e){const t={},r=getSeparator();for(let n=0,a=this.storage.length;n<a;n++){const a=this.key(n),[,o,s]=a.split(`${r}`,3);o===e&&s&&(t[s]=this.get(`${o}${r}${s}`))}return t}var storageMethods={from:from,get:get,set:set,has:has,remove:remove,clear:clear,key:key,keys:keys,trim:trim,getFormattedData:getFormattedData,setFormattedData:setFormattedData};function storageoperations(e){return{storage:e,get count(){return e.length},...storageMethods}}function ensureSupport(e){if(!e)throw new Error("Storage is not supported in this environment.");return e}const db={config:config,local:storageoperations(ensureSupport(window.localStorage)),session:storageoperations(ensureSupport(window.sessionStorage))};export{db as default};
+const config$1={namespace:"app",separator:".",trimKeys:!0,expiry:!0};function createNamespace(t){config$1.namespace=t}function switchNamespace(t){config$1.namespace=t}function getCurrentNamespace(){return config$1.namespace}function get$1(){return config$1}function setSeparator(t){config$1.separator=t}function getSeparator(){return config$1.separator}function generateKey(t){return`${config$1.namespace}${config$1.separator}${t}`}const version="1.2.0";var config={version:"1.2.0",createNamespace:createNamespace,getCurrentNamespace:getCurrentNamespace,switchNamespace:switchNamespace,get:get$1,setSeparator:setSeparator,getSeparator:getSeparator,generateKey:generateKey};function from(t){t&&switchNamespace(t)}function parse(t){try{return JSON.parse(t)}catch{return t}}function isUndefined(t){return void 0===t}function isNull(t){return null===t||"null"===t}function auto(t,e){if(0===t)return"0 B";const r=Math.floor(Math.log(t)/Math.log(1024));return(t/Math.pow(1024,r)).toFixed(2)+" "+(e?["B","KB","MB"][r]:"")}function units(t,e,r){let n="";switch(e=e.toUpperCase()){case"B":n=t.toFixed(2);break;case"KB":n=(t/1024).toFixed(2);break;case"MB":n=(t/1048576).toFixed(2);break;default:return console.warn(`Unsupported format "${e}" provided. Falling back to auto-formatting.`),auto(t,r)}return r?`${n} ${e}`:n}var utils={parse:parse,isUndefined:isUndefined,isNull:isNull,units:units};function isInvalidArg(t){return isUndefined(t)||isNull(t)}function get(t,e=null){if(isInvalidArg(t))return null;const r=config.generateKey(t),n=this.storage.getItem(r);if(utils.isNull(n))return e;try{let r=utils.parse(n);return r.expire&&Date.now()>r.expire?(this.remove(t),e):r.value}catch{return e}}function set(t,e,r={}){if(isInvalidArg(t))return null;const n=config.generateKey(t),{expire:i}=r;let o={value:e,...i?{expire:Date.now()+i}:{}};this.storage.setItem(n,JSON.stringify(o))}function has(t){return!!this.get(t)}function remove(t){const e=this.get(t),r=config.generateKey(t);return this.storage.removeItem(r),e}function clear(){return this.storage.clear()}function key(t){return this.storage.key(t)}function keys(){const t=[];for(let e=0;e<this.storage.length;e++)t.push(this.storage.key(e));return t}function trim(t){return this.storage.get(t).trim()}function size(t,e={}){const r=this.get(t);if(null===r)return 0;const n=new Blob([JSON.stringify(r)]).size;if(e.format){let t=!("unit"in e)||e.unit;return utils.units(n,e.format,t)}return n}function setFormattedData(t,e){const r=getSeparator();for(let n in e)n in e&&this.set(`${t}${r}${n}`,e[n])}function getFormattedData(t){const e={},r=getSeparator();for(let n=0,i=this.storage.length;n<i;n++){const i=this.key(n),[,o,a]=i.split(`${r}`,3);o===t&&a&&(e[a]=this.get(`${o}${r}${a}`))}return e}const DEFAULT_CAPACITY$1=5242880;function free(t={}){const e=(t.capacity||5242880)-this.used(),r=e>0?e:0;if(t.format){let e=!("unit"in t)||t.unit;return utils.units(r,t.format,e)}return r}function used(){let t=0;const e=getSeparator();for(let r=0;r<this.count;r++){const n=this.key(r),[,i]=n.split(`${e}`,2),o=this.get(i);t+=new Blob([JSON.stringify(n)]).size,t+=new Blob([JSON.stringify(o)]).size}return t}const DEFAULT_CAPACITY=5242880;function capacity(t={}){const e=t.capacity||5242880;if(t.format){let r=!("unit"in t)||t.unit;return utils.units(e,t.format,r)}return e}var storageMethods={size:size,free:free,used:used,capacity:capacity,from:from,get:get,set:set,has:has,remove:remove,clear:clear,key:key,keys:keys,trim:trim,getFormattedData:getFormattedData,setFormattedData:setFormattedData};function storageoperations(t){return{storage:t,get count(){return t.length},...storageMethods}}function ensureSupport(t){if(!t)throw new Error("Storage is not supported in this environment.");return t}const db={config:config,local:storageoperations(ensureSupport(window.localStorage)),session:storageoperations(ensureSupport(window.sessionStorage))};export{db as default};

package/dist/opendb-umd.js

@@ -42,7 +42,7 @@
     return `${config$1.namespace}${config$1.separator}${key}`;
   }
 
-  const version = '1.1.1';
+  const version = '1.2.0';
 
   var config = {
     version,
@@ -98,10 +98,43 @@
     return obj === null || obj === 'null';
   }
 
-  var util = {
+  function auto(bytes, unit) {
+    if (bytes === 0) return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return (bytes / Math.pow(k, i)).toFixed(2) + ' ' + (unit ? sizes[i] : '');
+  }
+
+  function units(bytes, format, unit) {
+    format = format.toUpperCase();
+    let formatted = '';
+
+    switch (format) {
+      case 'B':
+        formatted = bytes.toFixed(2);
+        break;
+      case 'KB':
+        formatted = (bytes / 1024).toFixed(2);
+        break;
+      case 'MB':
+        formatted = (bytes / (1024 * 1024)).toFixed(2);
+        break;
+      default:
+        console.warn(
+          `Unsupported format "${format}" provided. Falling back to auto-formatting.`
+        );
+        return auto(bytes, unit);
+    }
+
+    return unit ? `${formatted} ${format}` : formatted;
+  }
+
+  var utils = {
     parse,
     isUndefined,
     isNull,
+    units,
   };
 
   function isInvalidArg(key) {
@@ -124,12 +157,12 @@
     const namespacedKey = config.generateKey(key);
     const value = this.storage.getItem(namespacedKey);
 
-    if (util.isNull(value)) {
+    if (utils.isNull(value)) {
       return defaultValue;
     }
 
     try {
-      let parsedData = util.parse(value);
+      let parsedData = utils.parse(value);
 
       if (parsedData.expire && Date.now() > parsedData.expire) {
         this.remove(key);
@@ -229,6 +262,23 @@
     return this.storage.get(key).trim();
   }
 
+  function size(key, options = {}) {
+    const value = this.get(key);
+
+    if (value === null) {
+      return 0;
+    }
+
+    const bytes = new Blob([JSON.stringify(value)]).size;
+
+    if (options.format) {
+      let unit = 'unit' in options ? options.unit : true;
+      return utils.units(bytes, options.format, unit);
+    }
+
+    return bytes;
+  }
+
   function setFormattedData(key, obj) {
     const seprator = getSeparator();
 
@@ -255,7 +305,56 @@
     return result;
   }
 
+  const DEFAULT_CAPACITY$1 = 5 * 1024 * 1024; // 5 MB
+
+  function free(options = {}) {
+    const capacity = options.capacity || DEFAULT_CAPACITY$1;
+    const total = this.used();
+    const remaining = capacity - total;
+    const bytes = remaining > 0 ? remaining : 0;
+
+    if (options.format) {
+      let unit = 'unit' in options ? options.unit : true;
+      return utils.units(bytes, options.format, unit);
+    }
+
+    return bytes;
+  }
+
+  function used() {
+    let totalBytes = 0;
+    const seprator = getSeparator();
+
+    for (let i = 0; i < this.count; i++) {
+      const completkey = this.key(i);
+      const [, currentkey] = completkey.split(`${seprator}`, 2);
+
+      const value = this.get(currentkey);
+      totalBytes += new Blob([JSON.stringify(completkey)]).size;
+      totalBytes += new Blob([JSON.stringify(value)]).size;
+    }
+
+    return totalBytes;
+  }
+
+  const DEFAULT_CAPACITY = 5 * 1024 * 1024; // 5 MB
+
+  function capacity(options = {}) {
+    const bytes = options.capacity || DEFAULT_CAPACITY;
+
+    if (options.format) {
+      let unit = 'unit' in options ? options.unit : true;
+      return utils.units(bytes, options.format, unit);
+    }
+
+    return bytes;
+  }
+
   var storageMethods = {
+    size,
+    free,
+    used,
+    capacity,
     from,
     get,
     set,

package/dist/opendb-umd.min.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define("db",t):(e="undefined"!=typeof globalThis?globalThis:e||self,function(){var n=e.db,r=e.db=t();r.noConflict=function(){return e.db=n,r}}())}(this,(function(){const e={namespace:"app",separator:".",trimKeys:!0,expiry:!0};function t(t){e.namespace=t}function n(){return e.separator}var r={version:"1.1.1",createNamespace:function(t){e.namespace=t},getCurrentNamespace:function(){return e.namespace},switchNamespace:t,get:function(){return e},setSeparator:function(t){e.separator=t},getSeparator:n,generateKey:function(t){return`${e.namespace}${e.separator}${t}`}};function o(e){return void 0===e}function i(e){return null===e||"null"===e}var s={parse:function(e){try{return JSON.parse(e)}catch{return e}},isUndefined:o,isNull:i};function a(e){return o(e)||i(e)}var u={from:function(e){e&&t(e)},get:function(e,t=null){if(a(e))return null;const n=r.generateKey(e),o=this.storage.getItem(n);if(s.isNull(o))return t;try{let n=s.parse(o);return n.expire&&Date.now()>n.expire?(this.remove(e),t):n.value}catch{return t}},set:function(e,t,n={}){if(a(e))return null;const o=r.generateKey(e),{expire:i}=n;let s={value:t,...i?{expire:Date.now()+i}:{}};this.storage.setItem(o,JSON.stringify(s))},has:function(e){return!!this.get(e)},remove:function(e){const t=this.get(e),n=r.generateKey(e);return this.storage.removeItem(n),t},clear:function(){return this.storage.clear()},key:function(e){return this.storage.key(e)},keys:function(){const e=[];for(let t=0;t<this.storage.length;t++)e.push(this.storage.key(t));return e},trim:function(e){return this.storage.get(e).trim()},getFormattedData:function(e){const t={},r=n();for(let n=0,o=this.storage.length;n<o;n++){const o=this.key(n),[,i,s]=o.split(`${r}`,3);i===e&&s&&(t[s]=this.get(`${i}${r}${s}`))}return t},setFormattedData:function(e,t){const r=n();for(let n in t)n in t&&this.set(`${e}${r}${n}`,t[n])}};function c(e){return{storage:e,get count(){return e.length},...u}}function f(e){if(!e)throw new Error("Storage is not supported in this environment.");return e}return{config:r,local:c(f(window.localStorage)),session:c(f(window.sessionStorage))}}));
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define("db",e):(t="undefined"!=typeof globalThis?globalThis:t||self,function(){var n=t.db,r=t.db=e();r.noConflict=function(){return t.db=n,r}}())}(this,(function(){const t={namespace:"app",separator:".",trimKeys:!0,expiry:!0};function e(e){t.namespace=e}function n(){return t.separator}var r={version:"1.2.0",createNamespace:function(e){t.namespace=e},getCurrentNamespace:function(){return t.namespace},switchNamespace:e,get:function(){return t},setSeparator:function(e){t.separator=e},getSeparator:n,generateKey:function(e){return`${t.namespace}${t.separator}${e}`}};function i(t){return void 0===t}function o(t){return null===t||"null"===t}var s={parse:function(t){try{return JSON.parse(t)}catch{return t}},isUndefined:i,isNull:o,units:function(t,e,n){let r="";switch(e=e.toUpperCase()){case"B":r=t.toFixed(2);break;case"KB":r=(t/1024).toFixed(2);break;case"MB":r=(t/1048576).toFixed(2);break;default:return console.warn(`Unsupported format "${e}" provided. Falling back to auto-formatting.`),function(t,e){if(0===t)return"0 B";const n=Math.floor(Math.log(t)/Math.log(1024));return(t/Math.pow(1024,n)).toFixed(2)+" "+(e?["B","KB","MB"][n]:"")}(t,n)}return n?`${r} ${e}`:r}};function u(t){return i(t)||o(t)}var a={size:function(t,e={}){const n=this.get(t);if(null===n)return 0;const r=new Blob([JSON.stringify(n)]).size;if(e.format){let t=!("unit"in e)||e.unit;return s.units(r,e.format,t)}return r},free:function(t={}){const e=(t.capacity||5242880)-this.used(),n=e>0?e:0;if(t.format){let e=!("unit"in t)||t.unit;return s.units(n,t.format,e)}return n},used:function(){let t=0;const e=n();for(let n=0;n<this.count;n++){const r=this.key(n),[,i]=r.split(`${e}`,2),o=this.get(i);t+=new Blob([JSON.stringify(r)]).size,t+=new Blob([JSON.stringify(o)]).size}return t},capacity:function(t={}){const e=t.capacity||5242880;if(t.format){let n=!("unit"in t)||t.unit;return s.units(e,t.format,n)}return e},from:function(t){t&&e(t)},get:function(t,e=null){if(u(t))return null;const n=r.generateKey(t),i=this.storage.getItem(n);if(s.isNull(i))return e;try{let n=s.parse(i);return n.expire&&Date.now()>n.expire?(this.remove(t),e):n.value}catch{return e}},set:function(t,e,n={}){if(u(t))return null;const i=r.generateKey(t),{expire:o}=n;let s={value:e,...o?{expire:Date.now()+o}:{}};this.storage.setItem(i,JSON.stringify(s))},has:function(t){return!!this.get(t)},remove:function(t){const e=this.get(t),n=r.generateKey(t);return this.storage.removeItem(n),e},clear:function(){return this.storage.clear()},key:function(t){return this.storage.key(t)},keys:function(){const t=[];for(let e=0;e<this.storage.length;e++)t.push(this.storage.key(e));return t},trim:function(t){return this.storage.get(t).trim()},getFormattedData:function(t){const e={},r=n();for(let n=0,i=this.storage.length;n<i;n++){const i=this.key(n),[,o,s]=i.split(`${r}`,3);o===t&&s&&(e[s]=this.get(`${o}${r}${s}`))}return e},setFormattedData:function(t,e){const r=n();for(let n in e)n in e&&this.set(`${t}${r}${n}`,e[n])}};function c(t){return{storage:t,get count(){return t.length},...a}}function f(t){if(!t)throw new Error("Storage is not supported in this environment.");return t}return{config:r,local:c(f(window.localStorage)),session:c(f(window.sessionStorage))}}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opendb-store",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "A lightweight utility to manage browser storage (localStorage, sessionStorage, and cookies) with advanced features. Easily configure namespaces, key trimming, and data expiry.",
   "main": "./dist/opendb-umd.js",
   "module": "./dist/opendb-esm.js",

package/src/config/version.js

@@ -1 +1 @@
-export const version = '1.1.1';
+export const version = '1.2.0';

package/src/modules/capacity.js

@@ -0,0 +1,14 @@
+import utils from '../utils/index.js';
+
+const DEFAULT_CAPACITY = 5 * 1024 * 1024; // 5 MB
+
+export default function capacity(options = {}) {
+  const bytes = options.capacity || DEFAULT_CAPACITY;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return utils.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}

package/src/modules/free.js

@@ -0,0 +1,17 @@
+import util from '../utils/index.js';
+
+const DEFAULT_CAPACITY = 5 * 1024 * 1024; // 5 MB
+
+export default function free(options = {}) {
+  const capacity = options.capacity || DEFAULT_CAPACITY;
+  const total = this.used();
+  const remaining = capacity - total;
+  const bytes = remaining > 0 ? remaining : 0;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return util.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}

package/src/modules/index.js

@@ -7,10 +7,18 @@ import clear from './clear.js';
 import key from './key.js';
 import keys from './keys.js';
 import trim from './trim.js';
+import size from './size.js';
 import setFormattedData from './setFormattedData.js';
 import getFormattedData from './getFormattedData.js';
+import free from './free.js';
+import used from './used.js';
+import capacity from './capacity.js';
 
 export default {
+  size,
+  free,
+  used,
+  capacity,
   from,
   get,
   set,

package/src/modules/size.js

@@ -0,0 +1,18 @@
+import util from '../utils/index.js';
+
+export default function size(key, options = {}) {
+  const value = this.get(key);
+
+  if (value === null) {
+    return 0;
+  }
+
+  const bytes = new Blob([JSON.stringify(value)]).size;
+
+  if (options.format) {
+    let unit = 'unit' in options ? options.unit : true;
+    return util.units(bytes, options.format, unit);
+  }
+
+  return bytes;
+}

package/src/modules/used.js

@@ -0,0 +1,17 @@
+import { getSeparator } from '../config/config.js';
+
+export default function used() {
+  let totalBytes = 0;
+  const seprator = getSeparator();
+
+  for (let i = 0; i < this.count; i++) {
+    const completkey = this.key(i);
+    const [, currentkey] = completkey.split(`${seprator}`, 2);
+
+    const value = this.get(currentkey);
+    totalBytes += new Blob([JSON.stringify(completkey)]).size;
+    totalBytes += new Blob([JSON.stringify(value)]).size;
+  }
+
+  return totalBytes;
+}

package/src/utils/index.js

@@ -1,9 +1,11 @@
 import parse from './parse.js';
 import isUndefined from './isUndefined.js';
 import isNull from './isNull.js';
+import units from './units.js';
 
 export default {
   parse,
   isUndefined,
   isNull,
+  units,
 };

package/src/utils/units.js

@@ -0,0 +1,31 @@
+function auto(bytes, unit) {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return (bytes / Math.pow(k, i)).toFixed(2) + ' ' + (unit ? sizes[i] : '');
+}
+
+export default function units(bytes, format, unit) {
+  format = format.toUpperCase();
+  let formatted = '';
+
+  switch (format) {
+    case 'B':
+      formatted = bytes.toFixed(2);
+      break;
+    case 'KB':
+      formatted = (bytes / 1024).toFixed(2);
+      break;
+    case 'MB':
+      formatted = (bytes / (1024 * 1024)).toFixed(2);
+      break;
+    default:
+      console.warn(
+        `Unsupported format "${format}" provided. Falling back to auto-formatting.`
+      );
+      return auto(bytes, unit);
+  }
+
+  return unit ? `${formatted} ${format}` : formatted;
+}