@alwatr/session-storage 1.0.0 → 2.0.0

package/dist/main.js

@@ -0,0 +1,5 @@
+/* 📦 @alwatr/session-storage v2.0.0 */
+import{createLogger as B}from"@alwatr/logger";class z{static version="2.0.0";key__;logger_;constructor(x){this.key__=x.name,this.logger_=B(`session-storage-provider: ${this.key__}`),this.logger_.logMethodArgs?.("constructor",x)}static has(x){return sessionStorage.getItem(x)!==null}has(){return sessionStorage.getItem(this.key__)!==null}read(){let x=null;try{x=sessionStorage.getItem(this.key__)}catch(b){this.logger_.error("read","read_session_storage_error",{err:b})}if(!x)return this.logger_.logMethod?.("read//no_value"),null;try{let b=JSON.parse(x);return this.logger_.logMethodFull?.("read//value",void 0,{parsed:b}),b}catch(b){return this.logger_.error("read","read_parse_error",{err:b}),null}}write(x){this.logger_.logMethodArgs?.("write",{value:x});let b;try{b=JSON.stringify(x)}catch(j){throw this.logger_.error("write","write_stringify_error",{err:j}),Error("write_stringify_error")}try{sessionStorage.setItem(this.key__,b)}catch(j){this.logger_.error("write","write_session_storage_error",{err:j})}}remove(){this.logger_.logMethod?.("remove"),sessionStorage.removeItem(this.key__)}}function I(x){return new z(x)}export{I as createSessionStorageProvider,z as SessionStorageProvider};
+
+//# debugId=CF722D8BCB54E18D64756E2164756E21
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/session-storage.provider.ts", "../src/facade.ts"],
+  "sourcesContent": [
+    "import { createLogger } from '@alwatr/logger';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * A provider class for managing a specific item in sessionStorage.\n * It encapsulates the logic for key generation and serialization.\n *\n * @example\n * ```typescript\n * const formDraft = new SessionStorageProvider<{title: string; body: string}>({\n *   name: 'post-form-draft',\n * });\n *\n * // Write a draft\n * formDraft.write({ title: 'Hello', body: 'World' });\n *\n * // Read the draft\n * const draft = formDraft.read();\n * console.log(draft); // { title: 'Hello', body: 'World' }\n *\n * // Remove the draft\n * formDraft.remove();\n * ```\n */\nexport class SessionStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  constructor(config: SessionStorageProviderConfig) {\n    this.key__ = config.name;\n    this.logger_ = createLogger(`session-storage-provider: ${this.key__}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n  }\n\n  /**\n   * Checks if an item exists in sessionStorage for the given key.\n   * This static method allows checking for existence without instantiating the provider.\n   *\n   * @param key - The storage key.\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const exists = SessionStorageProvider.has('user-form');\n   * ```\n  */\n  public static has(key: string): boolean {\n    return sessionStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Checks if the current item exists in sessionStorage.\n   *\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const provider = new SessionStorageProvider({name: 'profile'});\n   * if (provider.has()) {\n   *   // Item exists\n   * }\n   * ```\n   */\n  public has(): boolean {\n    return sessionStorage.getItem(this.key__) !== null;\n  }\n\n  /**\n   * Reads and parses the value from sessionStorage.\n   * Returns `null` if the item does not exist or contains invalid JSON.\n   *\n   * @returns The parsed value of type `T`, or `null`.\n   *\n   * @example\n   * ```typescript\n   * const value = provider.read();\n   * if (value !== null) {\n   *   console.log('Restored value:', value);\n   * }\n   * ```\n   */\n  public read(): T | null {\n    let raw: string | null = null;\n\n    try {\n      raw = sessionStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_session_storage_error', { err });\n    }\n\n    if (!raw) {\n      this.logger_.logMethod?.('read//no_value');\n      return null;\n    }\n\n    try {\n      const parsed = JSON.parse(raw) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, { parsed });\n      return parsed;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', { err });\n      return null;\n    }\n  }\n\n  /**\n   * Serializes and writes a value to sessionStorage.\n   * Throws if the value cannot be serialized.\n   *\n   * @param value The value to persist.\n   *\n   * @example\n   * ```typescript\n   * provider.write({ step: 3, answers: [true, false, true] });\n   * ```\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', { value });\n\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', { err });\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      sessionStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_session_storage_error', { err });\n    }\n  }\n\n  /**\n   * Removes the item from sessionStorage.\n   *\n   * @example\n   * ```typescript\n   * provider.remove(); // Clears the stored value for this key.\n   * ```\n   */\n  public remove(): void {\n    this.logger_.logMethod?.('remove');\n    sessionStorage.removeItem(this.key__);\n  }\n}\n",
+    "import { SessionStorageProvider } from './session-storage.provider.js';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * Factory function to create a new SessionStorageProvider.\n *\n * @param config - The provider configuration.\n * @returns An instance of SessionStorageProvider.\n *\n * @example\n * ```typescript\n * const formData = createSessionStorageProvider({ name: 'multi-step-form' });\n *\n * // Write new data\n * formData.write({ step: 2, answers: { q1: 'yes' } });\n *\n * // Read the current data\n * const current = formData.read();\n * console.log(current); // { step: 2, answers: { q1: 'yes' } }\n * ```\n */\nexport function createSessionStorageProvider<T extends JsonValue>(config: SessionStorageProviderConfig): SessionStorageProvider<T> {\n  return new SessionStorageProvider<T>(config);\n}\n"
+  ],
+  "mappings": ";AAAA,uBAAS,uBAyBF,MAAM,CAA4C,OAChC,SAAU,QAEhB,MACE,QAEnB,WAAW,CAAC,EAAsC,CAChD,KAAK,MAAQ,EAAO,KACpB,KAAK,QAAU,EAAa,6BAA6B,KAAK,OAAO,EACrE,KAAK,QAAQ,gBAAgB,cAAe,CAAM,QAetC,IAAG,CAAC,EAAsB,CACtC,OAAO,eAAe,QAAQ,CAAG,IAAM,KAgBlC,GAAG,EAAY,CACpB,OAAO,eAAe,QAAQ,KAAK,KAAK,IAAM,KAiBzC,IAAI,EAAa,CACtB,IAAI,EAAqB,KAEzB,GAAI,CACF,EAAM,eAAe,QAAQ,KAAK,KAAK,EAEzC,MAAO,EAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,6BAA8B,CAAE,KAAI,CAAC,EAGlE,GAAI,CAAC,EAEH,OADA,KAAK,QAAQ,YAAY,gBAAgB,EAClC,KAGT,GAAI,CACF,IAAM,EAAS,KAAK,MAAM,CAAG,EAE7B,OADA,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAE,QAAO,CAAC,EAC1D,EAET,MAAO,EAAK,CAEV,OADA,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAE,KAAI,CAAC,EAC/C,MAeJ,KAAK,CAAC,EAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAE,OAAM,CAAC,EAE/C,IAAI,EACJ,GAAI,CACF,EAAW,KAAK,UAAU,CAAK,EAEjC,MAAO,EAAK,CAEV,MADA,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAE,KAAI,CAAC,EAClD,MAAM,uBAAuB,EAGzC,GAAI,CACF,eAAe,QAAQ,KAAK,MAAO,CAAQ,EAE7C,MAAO,EAAK,CACV,KAAK,QAAQ,MAAM,QAAS,8BAA+B,CAAE,KAAI,CAAC,GAY/D,MAAM,EAAS,CACpB,KAAK,QAAQ,YAAY,QAAQ,EACjC,eAAe,WAAW,KAAK,KAAK,EAExC,CCnIO,SAAS,CAAiD,CAAC,EAAiE,CACjI,OAAO,IAAI,EAA0B,CAAM",
+  "debugId": "CF722D8BCB54E18D64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,29 +1,28 @@
 {
   "name": "@alwatr/session-storage",
   "description": "A modern, simple, and robust solution for managing versioned JSON objects in the browser's `sessionStorage`. This package provides a clean, class-based API with a factory function to ensure your application's data persistence is safe, maintainable, and future-proof within a single tab.",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
   "dependencies": {
-    "@alwatr/logger": "6.0.17"
+    "@alwatr/logger": "7.0.0"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "6.4.1",
-    "@alwatr/prettier-config": "6.0.2",
-    "@alwatr/tsconfig-base": "6.0.4",
-    "@alwatr/type-helper": "7.0.1",
-    "@jest/globals": "^30.2.0",
+    "@alwatr/nano-build": "7.0.0",
+    "@alwatr/prettier-config": "7.0.0",
+    "@alwatr/tsconfig-base": "7.0.0",
+    "@alwatr/type-helper": "8.0.0",
     "typescript": "^5.9.3"
   },
   "exports": {
     ".": {
       "types": "./dist/main.d.ts",
-      "import": "./dist/main.mjs",
-      "require": "./dist/main.cjs"
+      "default": "./dist/main.js"
     }
   },
   "files": [
-    "**/*.{js,mjs,cjs,map,d.ts,html,md,LEGAL.txt}",
+    "**/*.{js,mjs,cjs,ts,map,d.ts,html,LEGAL.txt}",
+    "README.md",
     "LICENSE",
     "!demo/**/*",
     "!**/*.test.js"
@@ -48,8 +47,6 @@
     "versioning"
   ],
   "license": "MPL-2.0",
-  "main": "./dist/main.cjs",
-  "module": "./dist/main.mjs",
   "prettier": "@alwatr/prettier-config",
   "publishConfig": {
     "access": "public"
@@ -60,21 +57,21 @@
     "directory": "packages/session-storage"
   },
   "scripts": {
-    "b": "yarn run build",
-    "build": "yarn run build:ts && yarn run build:es",
-    "build:es": "nano-build --preset=module",
+    "b": "bun run build",
+    "build": "bun run build:ts && bun run build:es",
+    "build:es": "nano-build --preset=module src/main.ts",
     "build:ts": "tsc --build",
-    "c": "yarn run clean",
-    "cb": "yarn run clean && yarn run build",
+    "c": "bun run clean",
+    "cb": "bun run clean && bun run build",
     "clean": "rm -rfv dist *.tsbuildinfo",
-    "d": "yarn run build:es && yarn node --enable-source-maps --trace-warnings",
-    "w": "yarn run watch",
-    "watch": "yarn run watch:ts & yarn run watch:es",
-    "watch:es": "yarn run build:es --watch",
-    "watch:ts": "yarn run build:ts --watch --preserveWatchOutput"
+    "d": "bun run build:es && bun",
+    "w": "bun run watch",
+    "watch": "bun run watch:ts & bun run watch:es",
+    "watch:es": "bun run build:es --watch",
+    "watch:ts": "bun run build:ts --watch --preserveWatchOutput"
   },
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "f9f9ba54b319ce8ccc6968059b222e89f4b5d149"
+  "gitHead": "056102a1c8a563bbae8a290b6830450f467322a3"
 }

package/src/facade.ts

@@ -0,0 +1,25 @@
+import { SessionStorageProvider } from './session-storage.provider.js';
+
+import type { SessionStorageProviderConfig } from './type.js';
+
+/**
+ * Factory function to create a new SessionStorageProvider.
+ *
+ * @param config - The provider configuration.
+ * @returns An instance of SessionStorageProvider.
+ *
+ * @example
+ * ```typescript
+ * const formData = createSessionStorageProvider({ name: 'multi-step-form' });
+ *
+ * // Write new data
+ * formData.write({ step: 2, answers: { q1: 'yes' } });
+ *
+ * // Read the current data
+ * const current = formData.read();
+ * console.log(current); // { step: 2, answers: { q1: 'yes' } }
+ * ```
+ */
+export function createSessionStorageProvider<T extends JsonValue>(config: SessionStorageProviderConfig): SessionStorageProvider<T> {
+  return new SessionStorageProvider<T>(config);
+}

package/src/main.ts

@@ -0,0 +1,3 @@
+export * from './session-storage.provider.js';
+export * from './facade.js';
+export type * from './type.js';

package/src/session-storage.provider.ts

@@ -0,0 +1,154 @@
+import { createLogger } from '@alwatr/logger';
+
+import type { SessionStorageProviderConfig } from './type.js';
+
+/**
+ * A provider class for managing a specific item in sessionStorage.
+ * It encapsulates the logic for key generation and serialization.
+ *
+ * @example
+ * ```typescript
+ * const formDraft = new SessionStorageProvider<{title: string; body: string}>({
+ *   name: 'post-form-draft',
+ * });
+ *
+ * // Write a draft
+ * formDraft.write({ title: 'Hello', body: 'World' });
+ *
+ * // Read the draft
+ * const draft = formDraft.read();
+ * console.log(draft); // { title: 'Hello', body: 'World' }
+ *
+ * // Remove the draft
+ * formDraft.remove();
+ * ```
+ */
+export class SessionStorageProvider<T extends JsonValue> {
+  public static readonly version = __package_version__;
+
+  private readonly key__: string;
+  protected readonly logger_;
+
+  constructor(config: SessionStorageProviderConfig) {
+    this.key__ = config.name;
+    this.logger_ = createLogger(`session-storage-provider: ${this.key__}`);
+    this.logger_.logMethodArgs?.('constructor', config);
+  }
+
+  /**
+   * Checks if an item exists in sessionStorage for the given key.
+   * This static method allows checking for existence without instantiating the provider.
+   *
+   * @param key - The storage key.
+   * @returns `true` if the item exists in sessionStorage, otherwise `false`.
+   *
+   * @example
+   * ```typescript
+   * const exists = SessionStorageProvider.has('user-form');
+   * ```
+  */
+  public static has(key: string): boolean {
+    return sessionStorage.getItem(key) !== null;
+  }
+
+  /**
+   * Checks if the current item exists in sessionStorage.
+   *
+   * @returns `true` if the item exists in sessionStorage, otherwise `false`.
+   *
+   * @example
+   * ```typescript
+   * const provider = new SessionStorageProvider({name: 'profile'});
+   * if (provider.has()) {
+   *   // Item exists
+   * }
+   * ```
+   */
+  public has(): boolean {
+    return sessionStorage.getItem(this.key__) !== null;
+  }
+
+  /**
+   * Reads and parses the value from sessionStorage.
+   * Returns `null` if the item does not exist or contains invalid JSON.
+   *
+   * @returns The parsed value of type `T`, or `null`.
+   *
+   * @example
+   * ```typescript
+   * const value = provider.read();
+   * if (value !== null) {
+   *   console.log('Restored value:', value);
+   * }
+   * ```
+   */
+  public read(): T | null {
+    let raw: string | null = null;
+
+    try {
+      raw = sessionStorage.getItem(this.key__);
+    }
+    catch (err) {
+      this.logger_.error('read', 'read_session_storage_error', { err });
+    }
+
+    if (!raw) {
+      this.logger_.logMethod?.('read//no_value');
+      return null;
+    }
+
+    try {
+      const parsed = JSON.parse(raw) as T;
+      this.logger_.logMethodFull?.('read//value', undefined, { parsed });
+      return parsed;
+    }
+    catch (err) {
+      this.logger_.error('read', 'read_parse_error', { err });
+      return null;
+    }
+  }
+
+  /**
+   * Serializes and writes a value to sessionStorage.
+   * Throws if the value cannot be serialized.
+   *
+   * @param value The value to persist.
+   *
+   * @example
+   * ```typescript
+   * provider.write({ step: 3, answers: [true, false, true] });
+   * ```
+   */
+  public write(value: T): void {
+    this.logger_.logMethodArgs?.('write', { value });
+
+    let valueStr: string;
+    try {
+      valueStr = JSON.stringify(value);
+    }
+    catch (err) {
+      this.logger_.error('write', 'write_stringify_error', { err });
+      throw new Error('write_stringify_error');
+    }
+
+    try {
+      sessionStorage.setItem(this.key__, valueStr);
+    }
+    catch (err) {
+      this.logger_.error('write', 'write_session_storage_error', { err });
+    }
+  }
+
+  /**
+   * Removes the item from sessionStorage.
+   *
+   * @example
+   * ```typescript
+   * provider.remove(); // Clears the stored value for this key.
+   * ```
+   */
+  public remove(): void {
+    this.logger_.logMethod?.('remove');
+    sessionStorage.removeItem(this.key__);
+  }
+}

package/src/type.ts

@@ -0,0 +1,12 @@
+import type {} from '@alwatr/nano-build';
+import type {} from '@alwatr/type-helper';
+
+/**
+ * Configuration options for a session storage provider.
+ */
+export interface SessionStorageProviderConfig {
+  /**
+   * The unique name for the storage item.
+   */
+  name: string;
+}

package/CHANGELOG.md

@@ -1,23 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## 1.0.0 (2026-02-18)
-
-### ✨ Features
-
-* **session-storage:** add new package for managing sessionStorage with versioning ([55b1a28](https://github.com/Alwatr/nanolib/commit/55b1a280f3534aea6a2a1ab857327d3f020eaf1b))
-* **session-storage:** export types from type.js in main.ts ([db0c040](https://github.com/Alwatr/nanolib/commit/db0c0400d267df28fd5ea8beda42e332bcd45f87))
-* **session-storage:** update createSessionStorageProvider to accept config object ([c80f057](https://github.com/Alwatr/nanolib/commit/c80f0575f74c98ff910e96af49e1d68728856f05))
-
-### 🐛 Bug Fixes
-
-* **session-storage:** rename key_ to key__ for consistency and update logging ([6ac3820](https://github.com/Alwatr/nanolib/commit/6ac3820fd5d810e742c3b490f22fec67ee1b77ca))
-
-### 🧹 Miscellaneous Chores
-
-* fix pre version ([d9c8b97](https://github.com/Alwatr/nanolib/commit/d9c8b97eaaa9388d843d0ed24c426be68248972f))
-* remove CHANGELOG.md as it is no longer needed ([94219bf](https://github.com/Alwatr/nanolib/commit/94219bf23309e6d05d5d57aca95ac01d8cdde46f))
-* update keywords in package.json files for better categorization ([cf0ddb6](https://github.com/Alwatr/nanolib/commit/cf0ddb66eab7e2a87158279e455d71c495b30834))
-* update LICENSE file with complete text of Mozilla Public License v2.0 ([23815d3](https://github.com/Alwatr/nanolib/commit/23815d3bc29545996385f4702166df9a080504de))

package/dist/main.cjs

@@ -1,4 +0,0 @@
-/** 📦 @alwatr/session-storage v1.0.0 */
-__dev_mode__: console.debug("📦 @alwatr/session-storage v1.0.0");
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;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 __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{SessionStorageProvider:()=>SessionStorageProvider,createSessionStorageProvider:()=>createSessionStorageProvider});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var SessionStorageProvider=class{static{this.version="1.0.0"}constructor(config){this.key__=config.name;this.logger_=(0,import_logger.createLogger)(`session-storage-provider: ${this.key__}`);this.logger_.logMethodArgs?.("constructor",config)}static has(key){return sessionStorage.getItem(key)!==null}has(){return sessionStorage.getItem(this.key__)!==null}read(){let raw=null;try{raw=sessionStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_session_storage_error",{err})}if(!raw){this.logger_.logMethod?.("read//no_value");return null}try{const parsed=JSON.parse(raw);this.logger_.logMethodFull?.("read//value",void 0,{parsed});return parsed}catch(err){this.logger_.error("read","read_parse_error",{err});return null}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{sessionStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_session_storage_error",{err})}}remove(){this.logger_.logMethod?.("remove");sessionStorage.removeItem(this.key__)}};function createSessionStorageProvider(config){return new SessionStorageProvider(config)}0&&(module.exports={SessionStorageProvider,createSessionStorageProvider});
-//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/main.ts", "../src/session-storage.provider.ts", "../src/facade.ts"],
-  "sourcesContent": ["export * from './session-storage.provider.js';\nexport * from './facade.js';\nexport type * from './type.js';\n", "import { createLogger } from '@alwatr/logger';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * A provider class for managing a specific item in sessionStorage.\n * It encapsulates the logic for key generation and serialization.\n *\n * @example\n * ```typescript\n * const formDraft = new SessionStorageProvider<{title: string; body: string}>({\n *   name: 'post-form-draft',\n * });\n *\n * // Write a draft\n * formDraft.write({ title: 'Hello', body: 'World' });\n *\n * // Read the draft\n * const draft = formDraft.read();\n * console.log(draft); // { title: 'Hello', body: 'World' }\n *\n * // Remove the draft\n * formDraft.remove();\n * ```\n */\nexport class SessionStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  constructor(config: SessionStorageProviderConfig) {\n    this.key__ = config.name;\n    this.logger_ = createLogger(`session-storage-provider: ${this.key__}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n  }\n\n  /**\n   * Checks if an item exists in sessionStorage for the given key.\n   * This static method allows checking for existence without instantiating the provider.\n   *\n   * @param key - The storage key.\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const exists = SessionStorageProvider.has('user-form');\n   * ```\n  */\n  public static has(key: string): boolean {\n    return sessionStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Checks if the current item exists in sessionStorage.\n   *\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const provider = new SessionStorageProvider({name: 'profile'});\n   * if (provider.has()) {\n   *   // Item exists\n   * }\n   * ```\n   */\n  public has(): boolean {\n    return sessionStorage.getItem(this.key__) !== null;\n  }\n\n  /**\n   * Reads and parses the value from sessionStorage.\n   * Returns `null` if the item does not exist or contains invalid JSON.\n   *\n   * @returns The parsed value of type `T`, or `null`.\n   *\n   * @example\n   * ```typescript\n   * const value = provider.read();\n   * if (value !== null) {\n   *   console.log('Restored value:', value);\n   * }\n   * ```\n   */\n  public read(): T | null {\n    let raw: string | null = null;\n\n    try {\n      raw = sessionStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_session_storage_error', { err });\n    }\n\n    if (!raw) {\n      this.logger_.logMethod?.('read//no_value');\n      return null;\n    }\n\n    try {\n      const parsed = JSON.parse(raw) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, { parsed });\n      return parsed;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', { err });\n      return null;\n    }\n  }\n\n  /**\n   * Serializes and writes a value to sessionStorage.\n   * Throws if the value cannot be serialized.\n   *\n   * @param value The value to persist.\n   *\n   * @example\n   * ```typescript\n   * provider.write({ step: 3, answers: [true, false, true] });\n   * ```\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', { value });\n\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', { err });\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      sessionStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_session_storage_error', { err });\n    }\n  }\n\n  /**\n   * Removes the item from sessionStorage.\n   *\n   * @example\n   * ```typescript\n   * provider.remove(); // Clears the stored value for this key.\n   * ```\n   */\n  public remove(): void {\n    this.logger_.logMethod?.('remove');\n    sessionStorage.removeItem(this.key__);\n  }\n}\n", "import { SessionStorageProvider } from './session-storage.provider.js';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * Factory function to create a new SessionStorageProvider.\n *\n * @param config - The provider configuration.\n * @returns An instance of SessionStorageProvider.\n *\n * @example\n * ```typescript\n * const formData = createSessionStorageProvider({ name: 'multi-step-form' });\n *\n * // Write new data\n * formData.write({ step: 2, answers: { q1: 'yes' } });\n *\n * // Read the current data\n * const current = formData.read();\n * console.log(current); // { step: 2, answers: { q1: 'yes' } }\n * ```\n */\nexport function createSessionStorageProvider<T extends JsonValue>(config: SessionStorageProviderConfig): SessionStorageProvider<T> {\n  return new SessionStorageProvider<T>(config);\n}\n"],
-  "mappings": ";;qqBAAA,uMCAA,kBAA6B,0BAyBtB,IAAM,uBAAN,KAAkD,CACvD,YAAuB,QAAU,QAKjC,YAAY,OAAsC,CAChD,KAAK,MAAQ,OAAO,KACpB,KAAK,WAAU,4BAAa,6BAA6B,KAAK,KAAK,EAAE,EACrE,KAAK,QAAQ,gBAAgB,cAAe,MAAM,CACpD,CAcA,OAAc,IAAI,IAAsB,CACtC,OAAO,eAAe,QAAQ,GAAG,IAAM,IACzC,CAeO,KAAe,CACpB,OAAO,eAAe,QAAQ,KAAK,KAAK,IAAM,IAChD,CAgBO,MAAiB,CACtB,IAAI,IAAqB,KAEzB,GAAI,CACF,IAAM,eAAe,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,6BAA8B,CAAE,GAAI,CAAC,CAClE,CAEA,GAAI,CAAC,IAAK,CACR,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,IACT,CAEA,GAAI,CACF,MAAM,OAAS,KAAK,MAAM,GAAG,EAC7B,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAE,MAAO,CAAC,EACjE,OAAO,MACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAE,GAAI,CAAC,EACtD,OAAO,IACT,CACF,CAaO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAE,KAAM,CAAC,EAE/C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAE,GAAI,CAAC,EAC5D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,eAAe,QAAQ,KAAK,MAAO,QAAQ,CAC7C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,8BAA+B,CAAE,GAAI,CAAC,CACpE,CACF,CAUO,QAAe,CACpB,KAAK,QAAQ,YAAY,QAAQ,EACjC,eAAe,WAAW,KAAK,KAAK,CACtC,CACF,ECnIO,SAAS,6BAAkD,OAAiE,CACjI,OAAO,IAAI,uBAA0B,MAAM,CAC7C",
-  "names": []
-}

package/dist/main.mjs

@@ -1,4 +0,0 @@
-/** 📦 @alwatr/session-storage v1.0.0 */
-__dev_mode__: console.debug("📦 @alwatr/session-storage v1.0.0");
-import{createLogger}from"@alwatr/logger";var SessionStorageProvider=class{static{this.version="1.0.0"}constructor(config){this.key__=config.name;this.logger_=createLogger(`session-storage-provider: ${this.key__}`);this.logger_.logMethodArgs?.("constructor",config)}static has(key){return sessionStorage.getItem(key)!==null}has(){return sessionStorage.getItem(this.key__)!==null}read(){let raw=null;try{raw=sessionStorage.getItem(this.key__)}catch(err){this.logger_.error("read","read_session_storage_error",{err})}if(!raw){this.logger_.logMethod?.("read//no_value");return null}try{const parsed=JSON.parse(raw);this.logger_.logMethodFull?.("read//value",void 0,{parsed});return parsed}catch(err){this.logger_.error("read","read_parse_error",{err});return null}}write(value){this.logger_.logMethodArgs?.("write",{value});let valueStr;try{valueStr=JSON.stringify(value)}catch(err){this.logger_.error("write","write_stringify_error",{err});throw new Error("write_stringify_error")}try{sessionStorage.setItem(this.key__,valueStr)}catch(err){this.logger_.error("write","write_session_storage_error",{err})}}remove(){this.logger_.logMethod?.("remove");sessionStorage.removeItem(this.key__)}};function createSessionStorageProvider(config){return new SessionStorageProvider(config)}export{SessionStorageProvider,createSessionStorageProvider};
-//# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/session-storage.provider.ts", "../src/facade.ts"],
-  "sourcesContent": ["import { createLogger } from '@alwatr/logger';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * A provider class for managing a specific item in sessionStorage.\n * It encapsulates the logic for key generation and serialization.\n *\n * @example\n * ```typescript\n * const formDraft = new SessionStorageProvider<{title: string; body: string}>({\n *   name: 'post-form-draft',\n * });\n *\n * // Write a draft\n * formDraft.write({ title: 'Hello', body: 'World' });\n *\n * // Read the draft\n * const draft = formDraft.read();\n * console.log(draft); // { title: 'Hello', body: 'World' }\n *\n * // Remove the draft\n * formDraft.remove();\n * ```\n */\nexport class SessionStorageProvider<T extends JsonValue> {\n  public static readonly version = __package_version__;\n\n  private readonly key__: string;\n  protected readonly logger_;\n\n  constructor(config: SessionStorageProviderConfig) {\n    this.key__ = config.name;\n    this.logger_ = createLogger(`session-storage-provider: ${this.key__}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n  }\n\n  /**\n   * Checks if an item exists in sessionStorage for the given key.\n   * This static method allows checking for existence without instantiating the provider.\n   *\n   * @param key - The storage key.\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const exists = SessionStorageProvider.has('user-form');\n   * ```\n  */\n  public static has(key: string): boolean {\n    return sessionStorage.getItem(key) !== null;\n  }\n\n  /**\n   * Checks if the current item exists in sessionStorage.\n   *\n   * @returns `true` if the item exists in sessionStorage, otherwise `false`.\n   *\n   * @example\n   * ```typescript\n   * const provider = new SessionStorageProvider({name: 'profile'});\n   * if (provider.has()) {\n   *   // Item exists\n   * }\n   * ```\n   */\n  public has(): boolean {\n    return sessionStorage.getItem(this.key__) !== null;\n  }\n\n  /**\n   * Reads and parses the value from sessionStorage.\n   * Returns `null` if the item does not exist or contains invalid JSON.\n   *\n   * @returns The parsed value of type `T`, or `null`.\n   *\n   * @example\n   * ```typescript\n   * const value = provider.read();\n   * if (value !== null) {\n   *   console.log('Restored value:', value);\n   * }\n   * ```\n   */\n  public read(): T | null {\n    let raw: string | null = null;\n\n    try {\n      raw = sessionStorage.getItem(this.key__);\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_session_storage_error', { err });\n    }\n\n    if (!raw) {\n      this.logger_.logMethod?.('read//no_value');\n      return null;\n    }\n\n    try {\n      const parsed = JSON.parse(raw) as T;\n      this.logger_.logMethodFull?.('read//value', undefined, { parsed });\n      return parsed;\n    }\n    catch (err) {\n      this.logger_.error('read', 'read_parse_error', { err });\n      return null;\n    }\n  }\n\n  /**\n   * Serializes and writes a value to sessionStorage.\n   * Throws if the value cannot be serialized.\n   *\n   * @param value The value to persist.\n   *\n   * @example\n   * ```typescript\n   * provider.write({ step: 3, answers: [true, false, true] });\n   * ```\n   */\n  public write(value: T): void {\n    this.logger_.logMethodArgs?.('write', { value });\n\n    let valueStr: string;\n    try {\n      valueStr = JSON.stringify(value);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_stringify_error', { err });\n      throw new Error('write_stringify_error');\n    }\n\n    try {\n      sessionStorage.setItem(this.key__, valueStr);\n    }\n    catch (err) {\n      this.logger_.error('write', 'write_session_storage_error', { err });\n    }\n  }\n\n  /**\n   * Removes the item from sessionStorage.\n   *\n   * @example\n   * ```typescript\n   * provider.remove(); // Clears the stored value for this key.\n   * ```\n   */\n  public remove(): void {\n    this.logger_.logMethod?.('remove');\n    sessionStorage.removeItem(this.key__);\n  }\n}\n", "import { SessionStorageProvider } from './session-storage.provider.js';\n\nimport type { SessionStorageProviderConfig } from './type.js';\n\n/**\n * Factory function to create a new SessionStorageProvider.\n *\n * @param config - The provider configuration.\n * @returns An instance of SessionStorageProvider.\n *\n * @example\n * ```typescript\n * const formData = createSessionStorageProvider({ name: 'multi-step-form' });\n *\n * // Write new data\n * formData.write({ step: 2, answers: { q1: 'yes' } });\n *\n * // Read the current data\n * const current = formData.read();\n * console.log(current); // { step: 2, answers: { q1: 'yes' } }\n * ```\n */\nexport function createSessionStorageProvider<T extends JsonValue>(config: SessionStorageProviderConfig): SessionStorageProvider<T> {\n  return new SessionStorageProvider<T>(config);\n}\n"],
-  "mappings": ";;AAAA,OAAS,iBAAoB,iBAyBtB,IAAM,uBAAN,KAAkD,CACvD,YAAuB,QAAU,QAKjC,YAAY,OAAsC,CAChD,KAAK,MAAQ,OAAO,KACpB,KAAK,QAAU,aAAa,6BAA6B,KAAK,KAAK,EAAE,EACrE,KAAK,QAAQ,gBAAgB,cAAe,MAAM,CACpD,CAcA,OAAc,IAAI,IAAsB,CACtC,OAAO,eAAe,QAAQ,GAAG,IAAM,IACzC,CAeO,KAAe,CACpB,OAAO,eAAe,QAAQ,KAAK,KAAK,IAAM,IAChD,CAgBO,MAAiB,CACtB,IAAI,IAAqB,KAEzB,GAAI,CACF,IAAM,eAAe,QAAQ,KAAK,KAAK,CACzC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,6BAA8B,CAAE,GAAI,CAAC,CAClE,CAEA,GAAI,CAAC,IAAK,CACR,KAAK,QAAQ,YAAY,gBAAgB,EACzC,OAAO,IACT,CAEA,GAAI,CACF,MAAM,OAAS,KAAK,MAAM,GAAG,EAC7B,KAAK,QAAQ,gBAAgB,cAAe,OAAW,CAAE,MAAO,CAAC,EACjE,OAAO,MACT,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,OAAQ,mBAAoB,CAAE,GAAI,CAAC,EACtD,OAAO,IACT,CACF,CAaO,MAAM,MAAgB,CAC3B,KAAK,QAAQ,gBAAgB,QAAS,CAAE,KAAM,CAAC,EAE/C,IAAI,SACJ,GAAI,CACF,SAAW,KAAK,UAAU,KAAK,CACjC,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,wBAAyB,CAAE,GAAI,CAAC,EAC5D,MAAM,IAAI,MAAM,uBAAuB,CACzC,CAEA,GAAI,CACF,eAAe,QAAQ,KAAK,MAAO,QAAQ,CAC7C,OACO,IAAK,CACV,KAAK,QAAQ,MAAM,QAAS,8BAA+B,CAAE,GAAI,CAAC,CACpE,CACF,CAUO,QAAe,CACpB,KAAK,QAAQ,YAAY,QAAQ,EACjC,eAAe,WAAW,KAAK,KAAK,CACtC,CACF,ECnIO,SAAS,6BAAkD,OAAiE,CACjI,OAAO,IAAI,uBAA0B,MAAM,CAC7C",
-  "names": []
-}