react-smart-storage/dist/index.js

A lightweight React library to simplify localStorage and sessionStorage operations using TypeScript.

"use strict";
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 __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 (let key of __getOwnPropNames(from))
      if (!__hasOwnProp.call(to, key) && key !== except)
        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  }
  return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
  // If the importer is in node compatibility mode or this is not an ESM
  // file that has been converted to a CommonJS file using a Babel-
  // compatible transform (i.e. "__esModule" has not been set), then set
  // "default" to the CommonJS "module.exports" for node compatibility.
  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
  mod
));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);

// src/index.ts
var index_exports = {};
__export(index_exports, {
  clearStorage: () => clearStorage,
  getItem: () => getItem,
  getStorageUsage: () => getStorageUsage,
  getStorageUsageSummary: () => getStorageUsageSummary,
  removeItem: () => removeItem,
  removeItems: () => removeItems,
  setItem: () => setItem
});
module.exports = __toCommonJS(index_exports);

// src/useStorage.ts
var import_crypto_js = __toESM(require("crypto-js"));
var getStorage = (type) => {
  return type === "local" ? localStorage : sessionStorage;
};
var getHashedKey = (key) => {
  return import_crypto_js.default.SHA256(key).toString();
};
var encryptData = (value, hashKey) => {
  const hashedKey = getHashedKey(hashKey);
  return import_crypto_js.default.AES.encrypt(JSON.stringify(value), hashedKey).toString();
};
var decryptData = (encryptedValue, hashKey) => {
  const hashedKey = getHashedKey(hashKey);
  const bytes = import_crypto_js.default.AES.decrypt(encryptedValue, hashedKey);
  const decryptedData = bytes.toString(import_crypto_js.default.enc.Utf8);
  return decryptedData ? JSON.parse(decryptedData) : null;
};
var setItem = (key, value, options) => {
  const {
    type = "local",
    encrypt = false,
    hashKey,
    expiresIn
  } = options || {};
  const storage = getStorage(type);
  const storedValue = {
    value,
    expiresAt: expiresIn ? Date.now() + expiresIn * 1e3 : void 0
  };
  if (encrypt) {
    if (!hashKey) {
      throw new Error("hashKey is required for encryption");
    }
    const encryptedValue = encryptData(storedValue, hashKey);
    storage.setItem(key, encryptedValue);
  } else {
    storage.setItem(key, JSON.stringify(storedValue));
  }
};
var getItem = (key, options) => {
  const {
    type = "local",
    encrypt = false,
    hashKey
  } = options || {};
  const storage = getStorage(type);
  const storedValue = storage.getItem(key);
  if (!storedValue) return null;
  let parsed = null;
  try {
    parsed = encrypt ? decryptData(storedValue, hashKey) : JSON.parse(storedValue);
  } catch (e) {
    return null;
  }
  if (!parsed) return null;
  if (parsed.expiresAt && parsed.expiresAt < Date.now()) {
    storage.removeItem(key);
    return null;
  }
  return parsed.value;
};
var removeItem = (key, type = "local") => {
  const storage = getStorage(type);
  storage.removeItem(key);
};
var removeItems = (keys, type = "local") => {
  const storage = getStorage(type);
  keys.forEach((key) => {
    storage.removeItem(key);
  });
};
var clearStorage = (type = "local") => {
  const storage = getStorage(type);
  storage.clear();
};
var getStorageUsage = (type = "local") => {
  const storage = getStorage(type);
  let usedBytes = 0;
  for (let i = 0; i < storage.length; i++) {
    const key = storage.key(i);
    if (key) {
      const value = storage.getItem(key);
      if (value) {
        usedBytes += key.length + value.length;
      }
    }
  }
  const maxBytes = 5 * 1024 * 1024;
  const freeBytes = Math.max(0, maxBytes - usedBytes);
  return {
    usedBytes,
    freeBytes,
    maxBytes,
    usedMB: (usedBytes / (1024 * 1024)).toFixed(2),
    freeMB: (freeBytes / (1024 * 1024)).toFixed(2),
    maxMB: (maxBytes / (1024 * 1024)).toFixed(2)
  };
};
var getStorageUsageSummary = (type = "local") => {
  const { usedMB, maxMB } = getStorageUsage(type);
  const percentage = (parseFloat(usedMB) / parseFloat(maxMB) * 100).toFixed(2);
  return `Used ${usedMB}MB of ${maxMB}MB (${percentage}%)`;
};
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
  clearStorage,
  getItem,
  getStorageUsage,
  getStorageUsageSummary,
  removeItem,
  removeItems,
  setItem
});