@alwatr/local-storage/dist/main.cjs.map

`localJsonStorage` is a utility object in our TypeScript package that provides methods for interacting with the local storage in a structured and versioned manner.

{
  "version": 3,
  "sources": ["../src/main.ts"],
  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Parse json string without throwing error.\n *\n * @param content - json string\n * @returns json object or null if json is invalid\n * @example\n * ```typescript\n * const json = parseJson('{\"a\":1,\"b\":2}');\n * console.log(json.a); // 1\n * ```\n */\nfunction parseJson<T extends JsonValue>(content: string): T | null {\n  try {\n    return JSON.parse(content);\n  }\n  catch (err) {\n    console.error('parseJson', 'invalid_json', err);\n    return null;\n  }\n}\n\n// @TODO: localStorage polyfill (memory fallback)\n\n/**\n * A utility object for working with local storage and JSON data.\n */\nexport const localJsonStorage = {\n  /**\n   * Generate local storage key.\n   *\n   * @param name - Name of the item.\n   * @param version - Version of the item (default: 1).\n   * @returns The generated local storage key.\n   * @example\n   * ```typescript\n   * localJsonStorage.key_('myItem', 1); // myItem.v1\n   * ```\n   */\n  key_(name: string, version = 1): string {\n    return `${name}.v${version}`;\n  },\n\n  /**\n   * Get the local storage item and parse it as JSON.\n   * If the item is not found, return the default value.\n   * If the version is greater than 1, remove the previous version.\n   * If the item is not a valid JSON object, return the default value.\n   *\n   * @param name - The name of the item.\n   * @param defaultValue - The default value of the item.\n   * @param version - The data structure version of the item (default: 1).\n   * @returns The parsed JSON value or the default value if the item is not found.\n   * @example\n   * ```typescript\n   * const value = localJsonStorage.getItem('myItem', {a: 1, b: 2});\n   * ```\n   */\n  getItem<T extends Json>(name: string, defaultValue: T, version = 1): T {\n    if (version > 1) {\n      this.removeItem(name, version - 1);\n    }\n    if (version > 1) {\n      this.removeItem(name, version - 1);\n    }\n    const key = this.key_(name, version);\n    const value = localStorage.getItem(key);\n    if (value === null) {\n      localStorage.setItem(key, JSON.stringify(defaultValue));\n      return defaultValue;\n    }\n    const json = parseJson<T>(value);\n    if (json === null || typeof json !== 'object') return defaultValue;\n    return json;\n  },\n\n  /**\n   * Check if an item exists in local storage.\n   *\n   * @param name - The name of the item.\n   * @param version - The version of the item (default: 1).\n   * @returns True if the item exists, false otherwise.\n   * @example\n   * ```typescript\n   * const exists = localJsonStorage.hasItem('myItem');\n   * ```\n   */\n  hasItem(name: string, version = 1): boolean {\n    const key = this.key_(name, version);\n    return localStorage.getItem(key) !== null;\n  },\n\n  /**\n   * Set local storage item as JSON.\n   *\n   * @param name - Name of the item.\n   * @param value - Value of the item.\n   * @param version - Version of the item.\n   * @example\n   * ```typescript\n   * localJsonStorage.setItem('myItem', {a: 1, b: 2});\n   * ```\n   */\n  setItem<T extends Json>(name: string, value: T, version = 1): void {\n    const key = this.key_(name, version);\n    localStorage.setItem(key, JSON.stringify(value));\n  },\n\n  /**\n   * Removes an item from the local storage.\n   *\n   * @param name - The name of the item to remove.\n   * @param version - The version of the item to remove. Default is 1.\n   * @example\n   * ```typescript\n   * localJsonStorage.removeItem('myItem');\n   * ```\n   */\n  removeItem(name: string, version = 1): void {\n    const key = this.key_(name, version);\n    localStorage.removeItem(key);\n  },\n} as const;\n"],
  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA4B;AAE5B,aAAc,qCAAc,IAAI,yBAAkB,OAAmB;AAarE,SAAS,UAA+B,SAA2B;AACjE,MAAI;AACF,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SACO,KAAK;AACV,YAAQ,MAAM,aAAa,gBAAgB,GAAG;AAC9C,WAAO;AAAA,EACT;AACF;AAOO,IAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY9B,KAAK,MAAc,UAAU,GAAW;AACtC,WAAO,GAAG,IAAI,KAAK,OAAO;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,QAAwB,MAAc,cAAiB,UAAU,GAAM;AACrE,QAAI,UAAU,GAAG;AACf,WAAK,WAAW,MAAM,UAAU,CAAC;AAAA,IACnC;AACA,QAAI,UAAU,GAAG;AACf,WAAK,WAAW,MAAM,UAAU,CAAC;AAAA,IACnC;AACA,UAAM,MAAM,KAAK,KAAK,MAAM,OAAO;AACnC,UAAM,QAAQ,aAAa,QAAQ,GAAG;AACtC,QAAI,UAAU,MAAM;AAClB,mBAAa,QAAQ,KAAK,KAAK,UAAU,YAAY,CAAC;AACtD,aAAO;AAAA,IACT;AACA,UAAM,OAAO,UAAa,KAAK;AAC/B,QAAI,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,QAAQ,MAAc,UAAU,GAAY;AAC1C,UAAM,MAAM,KAAK,KAAK,MAAM,OAAO;AACnC,WAAO,aAAa,QAAQ,GAAG,MAAM;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,QAAwB,MAAc,OAAU,UAAU,GAAS;AACjE,UAAM,MAAM,KAAK,KAAK,MAAM,OAAO;AACnC,iBAAa,QAAQ,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,WAAW,MAAc,UAAU,GAAS;AAC1C,UAAM,MAAM,KAAK,KAAK,MAAM,OAAO;AACnC,iBAAa,WAAW,GAAG;AAAA,EAC7B;AACF;",
  "names": []
}