opendb-store/src/modules/free.js

A lightweight utility to manage browser storage (localStorage, sessionStorage, and cookies) with advanced features. Easily configure namespaces, key trimming, and data expiry.

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;
}