iconly 2.0.1 → 3.0.0-dev.1

package/README.md

@@ -3,43 +3,45 @@
 
 <h1>iconly</h1>
 
-<p><sup>Iconly is designed to load and cache SVG icons in the browser, using IndexedDB to store the data. It retrieves the icons from a given SVG file, stores them in IndexedDB, and inserts them into the DOM for easy access and use.</sup></p>
+<p><sup>A lightweight utility to load and cache SVG icons in the browser, using IndexedDB to store the data. It retrieves icons from a given SVG file, stores them in IndexedDB, and inserts them into the DOM for easy access and use.</sup></p>
 
 [![npm](https://img.shields.io/npm/v/iconly.svg?colorB=brightgreen)](https://www.npmjs.com/package/iconly)
 [![GitHub package version](https://img.shields.io/github/package-json/v/ux-ui-pro/iconly.svg)](https://github.com/ux-ui-pro/iconly)
 [![NPM Downloads](https://img.shields.io/npm/dm/iconly.svg?style=flat)](https://www.npmjs.org/package/iconly)
 
-<sup>1.5kB gzipped</sup>
+<sup>~2kB gzipped</sup>
 
 <a href="https://codepen.io/ux-ui/pen/zYmyqWR">Demo</a>
 
 </div>
 <br>
 
-&#10148; **Install**
-
+# Install
 ```console
-$ yarn add iconly
+$ npm install iconly
 ```
 <br>
 
-&#10148; **Import**
-
+# Import
 ```javascript
-import Iconly from 'iconly';
+import { createIconly } from 'iconly';
 ```
 <br>
 
-&#10148; **Usage**
-
+# Usage
 ```javascript
-const iconly = new Iconly({
+const iconLoader = createIconly({
   file: './sprite.svg',
   version: '1.0',
   debug: true,
+  storage: 'indexeddb',
 });
 
-iconly.init().then(() => console.log('Iconly is initialized and icons are loaded.'));
+const result = await iconLoader.init();
+
+if (!result.ok) {
+  console.error(result.error);
+}
 ```
 
 ```HTML
@@ -58,16 +60,28 @@ iconly.init().then(() => console.log('Iconly is initialized and icons are loaded
 ```
 <br>
 
-&#10148; **Options**
-
-|   Option    |          Type           |     Default     | Description                                                                                             |
-|:-----------:|:-----------------------:|:---------------:|:--------------------------------------------------------------------------------------------------------|
-|   `file`    |        `string`         | `'./icons.svg'` | The URL of the SVG file containing the icons.                                                           |
-|  `version`  |        `string`         |     `'1.0'`     | The version of the icon set.                                                                            |
-|   `debug`   |        `boolean`        |     `false`     | If `true`, debug information and errors will be logged to the console.                                  |
-| `container` | `string \| HTMLElement` | `document.body` | The container element where the icons will be injected. Can be a CSS selector string or an HTMLElement. |
+# Options
+|       Option       |                  Type                   |     Default     | Description                                                     |
+|:------------------:|:---------------------------------------:|:---------------:|:----------------------------------------------------------------|
+|       `file`       |                `string`                 | `'./icons.svg'` | The URL of the SVG file containing the icons.                   |
+|     `version`      |                `string`                 |     `'1.0'`     | The version of the icon set.                                    |
+|      `debug`       |                `boolean`                |     `false`     | If `true`, debug callbacks and logger debug output are enabled. |
+|    `container`     |         `string \| HTMLElement`         | `document.body` | The container element where the icons will be injected.         |
+|     `storage`      | `'indexeddb' \| 'memory' \| 'session'`  |  `'indexeddb'`  | Storage strategy used for caching icon data.                    |
+|      `dbName`      |                `string`                 |  `'iconlyDB'`   | IndexedDB database name (only for `indexeddb`).                 |
+|    `storeName`     |                `string`                 |    `'icons'`    | IndexedDB store name (only for `indexeddb`).                    |
+| `sessionKeyPrefix` |                `string`                 |   `'iconly'`    | Prefix for SessionStorage keys (only for `session`).            |
+|      `logger`      |          `{ debug?, error? }`           |   `undefined`   | Optional logger implementation for debug/error output.          |
+|     `onError`      |            `(error) => void`            |   `undefined`   | Optional callback invoked on errors.                            |
+|     `onDebug`      |           `(...args) => void`           |   `undefined`   | Optional callback invoked for debug messages.                   |
 <br>
 
-&#10148; **License**
+# Error handling
+- `init()` never throws; it returns a `Result` with `ok: false` and `error` details.
+- When `debug` is `false`, debug messages are suppressed (no `onDebug` calls and no `logger.debug`).
+- Errors still trigger `onError` and `logger.error` (if provided), even when `debug` is `false`.
+- You can cancel a fetch by calling `iconLoader.abort()`, which results in a `fetch_aborted` error code.
+
+# License
 
-iconly is released under MIT license
+MIT

package/dist/index.cjs.js

@@ -1 +1,2 @@
-"use strict";var g=Object.defineProperty;var h=(d,r,e)=>r in d?g(d,r,{enumerable:!0,configurable:!0,writable:!0,value:e}):d[r]=e;var l=(d,r,e)=>h(d,typeof r!="symbol"?r+"":r,e);const a=class a{constructor(r={}){l(this,"options");l(this,"container");const e={file:"./icons.svg",version:"1.0",debug:!1,container:document.body??document.documentElement,...r};let n;if(typeof e.container=="string"){const i=document.querySelector(e.container);if(!(i&&i instanceof HTMLElement))throw new Error(`Invalid container selector: "${e.container}"`);n=i}else n=e.container;this.container=n,this.options={file:e.file,version:e.version,debug:e.debug},a.dbInstance||(a.dbInstance=this.openDB("iconlyDB",1))}async openDB(r,e){if(!("indexedDB"in window))throw this.logError("This browser does not support IndexedDB"),new Error("IndexedDB not supported");return await new Promise((n,i)=>{const o=indexedDB.open(r,e);o.onerror=()=>{const s=this.createErrorMessage(o.error,"IndexedDB error");i(new Error(s))},o.onupgradeneeded=s=>{const t=s.target.result;t.objectStoreNames.contains("icons")||t.createObjectStore("icons",{keyPath:"version"})},o.onsuccess=()=>{n(o.result)}})}getIconStore(r,e){return r.transaction("icons",e).objectStore("icons")}static async fetchData(r){const e=await fetch(r);if(!e.ok)throw new Error(`Failed to fetch icons from "${r}"`);return e.text()}insert(r){let e=document.getElementById("iconset");e||(e=document.createElement("div"),e.id="iconset",e.setAttribute("aria-hidden","true"),e.style.cssText="width: 0; height: 0; position: absolute; left: -9999px;",this.container.appendChild(e));const n=new DOMParser().parseFromString(r,"image/svg+xml"),i=n.querySelector("parsererror");if(i)return void this.logError("SVG parsing error:",i.textContent??"");e.innerHTML="";const o=n.documentElement;if(o){const s=document.importNode(o,!0);e.appendChild(s)}else this.logError("No valid SVG content found to insert.")}async init(){try{let r=await a.fetchData(this.options.file);const e=await a.dbInstance;if(!e)throw new Error("Failed to open IndexedDB");const n=this.getIconStore(e,"readwrite"),i=await new Promise((o,s)=>{const t=n.get(this.options.version);t.onsuccess=()=>{o(t.result)},t.onerror=()=>{const c=this.createErrorMessage(t.error,"Error getting record from store");s(new Error(c))}});i?r=i.data:await new Promise((o,s)=>{const t=n.put({version:this.options.version,data:r});t.onsuccess=()=>o(),t.onerror=()=>{const c=this.createErrorMessage(t.error,"Error putting record into store");s(new Error(c))}}),await new Promise((o,s)=>{const t=n.transaction;t.oncomplete=()=>o(),t.onerror=()=>{const c=this.createErrorMessage(t.error,"Transaction error");s(new Error(c))},t.onabort=()=>{const c=this.createErrorMessage(t.error,"Transaction aborted");s(new Error(c))}}),this.insert(r),this.logDebug("Iconly has successfully initialized.")}catch(r){const e=r instanceof Error?r:new Error(String(r));this.logError("Error initializing Iconly:",e.message)}}createErrorMessage(r,e){return r&&(r instanceof DOMException||r instanceof Error)&&r.message||e}logDebug(...r){this.options.debug}logError(...r){}};l(a,"dbInstance",null);let u=a;module.exports=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=(e,t,r)=>({code:e,message:t,cause:r}),u=e=>({ok:!0,value:e}),a=e=>({ok:!1,error:e}),w=(e,t)=>{let r=document.getElementById("iconset");r||(r=document.createElement("div"),r.id="iconset",r.setAttribute("aria-hidden","true"),r.style.cssText="width: 0; height: 0; position: absolute; left: -9999px;",e.appendChild(r));const b=new DOMParser().parseFromString(t,"image/svg+xml"),f=b.querySelector("parsererror");if(f)return a(i("parse_error",`SVG parsing error: ${f.textContent??"Unknown error"}`));r.innerHTML="";const c=b.documentElement;if(!c)return a(i("parse_error","No valid SVG content found."));const m=document.importNode(c,!0);return r.appendChild(m),u(void 0)},S=async(e,t)=>{try{const r=await fetch(e,{signal:t});if(!r.ok)return a(i("fetch_failed",`Failed to fetch icons from "${e}".`));const o=await r.text();return u(o)}catch(r){return r instanceof DOMException&&r.name==="AbortError"?a(i("fetch_aborted","Fetch request was aborted.",r)):a(i("fetch_failed","Failed to fetch icons.",r))}},x=(e={})=>{const t=e.dbName??"iconlyDB",r=e.storeName??"icons";let o=null;const b=async()=>{if(o)return o;if(typeof indexedDB>"u")throw i("indexeddb_not_supported","IndexedDB is not supported.");return o=new Promise((d,n)=>{const s=indexedDB.open(t,1);s.onerror=()=>{n(i("indexeddb_open_failed","Failed to open IndexedDB connection.",s.error))},s.onupgradeneeded=g=>{const l=g.target.result;l.objectStoreNames.contains(r)||l.createObjectStore(r,{keyPath:"version"})},s.onsuccess=()=>d(s.result)}),o},f=(d,n)=>d.transaction(r,n).objectStore(r),c=(d,n,s)=>d&&typeof d=="object"&&"code"in d&&"message"in d?d:i(n,s,d);return{get:async d=>{try{const n=await b(),s=f(n,"readonly");return await new Promise(g=>{const l=s.get(d);l.onsuccess=()=>g(u(l.result)),l.onerror=()=>g(a(i("indexeddb_request_failed","Failed to read from IndexedDB.",l.error)))})}catch(n){return a(c(n,"indexeddb_open_failed","Failed to open IndexedDB."))}},set:async d=>{try{const n=await b(),s=f(n,"readwrite");return await new Promise(g=>{const l=s.put(d);l.onsuccess=()=>g(u(void 0)),l.onerror=()=>g(a(i("indexeddb_request_failed","Failed to write to IndexedDB.",l.error)))})}catch(n){return a(i("indexeddb_open_failed","Failed to open IndexedDB.",n))}}}},h=()=>{const e=new Map;return{get:async o=>e.has(o)?u({version:o,data:e.get(o)??""}):u(void 0),set:async o=>(e.set(o.version,o.data),u(void 0))}},_=(e={})=>{const t=e.keyPrefix??"iconly",r=()=>typeof window>"u"||!window.sessionStorage?a(i("storage_unavailable","SessionStorage is not available.")):u(window.sessionStorage);return{get:async f=>{const c=r();if(!c.ok)return c;try{const m=c.value.getItem(`${t}:${f}`);if(!m)return u(void 0);const y=JSON.parse(m);return u(y)}catch(m){return a(i("storage_read_failed","Failed to read from SessionStorage.",m))}},set:async f=>{const c=r();if(!c.ok)return c;try{return c.value.setItem(`${t}:${f.version}`,JSON.stringify(f)),u(void 0)}catch(m){return a(i("storage_write_failed","Failed to write to SessionStorage.",m))}}}},D=(e,t)=>!e||e==="indexeddb"?x({dbName:t.dbName,storeName:t.storeName}):e==="memory"?h():e==="session"?_({keyPrefix:t.sessionKeyPrefix}):e,I=(e={})=>{const t={file:e.file??"./icons.svg",version:e.version??"1.0",debug:e.debug??!1,container:e.container,logger:e.logger,onError:e.onError,onDebug:e.onDebug},r=D(e.storage,{dbName:e.dbName,storeName:e.storeName,sessionKeyPrefix:e.sessionKeyPrefix});let o=null;const b=()=>{o?.abort()},f=()=>{if(typeof document>"u")return a(i("container_invalid","Document is not available in this environment."));if(typeof t.container=="string"){const s=document.querySelector(t.container);return!s||!(s instanceof HTMLElement)?a(i("container_invalid",`Invalid container selector: "${t.container}".`)):u(s)}if(t.container instanceof HTMLElement)return u(t.container);const n=document.body??document.documentElement;return n?u(n):a(i("container_invalid","No valid container element found."))},c=(...n)=>{t.debug&&(t.onDebug?.(...n),t.logger?.debug?.("[Iconly debug]",...n))},m=n=>{t.onError?.(n),t.logger?.error?.("[Iconly error]",n)},y=n=>(m(n),a(n));return{init:async()=>{const n=f();if(!n.ok)return y(n.error);const s=await r.get(t.version);if(!s.ok)return y(s.error);let g=s.value?.data;if(g)c("Using cached icon set",t.version);else{o=new AbortController;const v=await S(t.file,o.signal);if(!v.ok)return y(v.error);g=v.value;const p=await r.set({version:t.version,data:g});if(!p.ok)return y(p.error)}const l=w(n.value,g);return l.ok?(c("Iconly has successfully initialized."),u(void 0)):y(l.error)},abort:b}};exports.createIconly=I;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/errors.ts","../src/result.ts","../src/dom.ts","../src/fetcher.ts","../src/storage/indexeddb.ts","../src/storage/memory.ts","../src/storage/session.ts","../src/storage/index.ts","../src/core.ts"],"sourcesContent":["import type { IconlyError, IconlyErrorCode } from './types';\n\nexport const createIconlyError = (\n  code: IconlyErrorCode,\n  message: string,\n  cause?: unknown,\n): IconlyError => ({\n  code,\n  message,\n  cause,\n});\n","import type { IconlyError, Result } from './types';\n\nexport const ok = <T>(value: T): Result<T> => ({ ok: true, value });\n\nexport const err = <T = never>(error: IconlyError): Result<T> => ({ ok: false, error });\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const insertSvg = (container: HTMLElement, data: string): Result<void> => {\n  let iconSetDiv = document.getElementById('iconset');\n\n  if (!iconSetDiv) {\n    iconSetDiv = document.createElement('div');\n    iconSetDiv.id = 'iconset';\n    iconSetDiv.setAttribute('aria-hidden', 'true');\n    iconSetDiv.style.cssText = 'width: 0; height: 0; position: absolute; left: -9999px;';\n    container.appendChild(iconSetDiv);\n  }\n\n  const parser = new DOMParser();\n  const svgDoc = parser.parseFromString(data, 'image/svg+xml');\n  const parserError = svgDoc.querySelector('parsererror');\n\n  if (parserError) {\n    return err(\n      createIconlyError(\n        'parse_error',\n        `SVG parsing error: ${parserError.textContent ?? 'Unknown error'}`,\n      ),\n    );\n  }\n\n  iconSetDiv.innerHTML = '';\n\n  const svgEl = svgDoc.documentElement;\n\n  if (!svgEl) {\n    return err(createIconlyError('parse_error', 'No valid SVG content found.'));\n  }\n\n  const imported = document.importNode(svgEl, true);\n\n  iconSetDiv.appendChild(imported);\n\n  return ok(undefined);\n};\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const fetchSvg = async (file: string, signal?: AbortSignal): Promise<Result<string>> => {\n  try {\n    const response = await fetch(file, { signal });\n\n    if (!response.ok) {\n      return err(createIconlyError('fetch_failed', `Failed to fetch icons from \"${file}\".`));\n    }\n\n    const data = await response.text();\n\n    return ok(data);\n  } catch (error: unknown) {\n    if (error instanceof DOMException && error.name === 'AbortError') {\n      return err(createIconlyError('fetch_aborted', 'Fetch request was aborted.', error));\n    }\n\n    return err(createIconlyError('fetch_failed', 'Failed to fetch icons.', error));\n  }\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconlyError, IconRecord, IconStorage, Result } from '../types';\n\ninterface IndexedDbOptions {\n  dbName?: string;\n  storeName?: string;\n}\n\nexport const createIndexedDbStorage = (options: IndexedDbOptions = {}): IconStorage => {\n  const dbName = options.dbName ?? 'iconlyDB';\n  const storeName = options.storeName ?? 'icons';\n\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  const openDb = async (): Promise<IDBDatabase> => {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    if (typeof indexedDB === 'undefined') {\n      throw createIconlyError('indexeddb_not_supported', 'IndexedDB is not supported.');\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onerror = (): void => {\n        reject(\n          createIconlyError(\n            'indexeddb_open_failed',\n            'Failed to open IndexedDB connection.',\n            request.error,\n          ),\n        );\n      };\n\n      request.onupgradeneeded = (event): void => {\n        const db = (event.target as IDBOpenDBRequest).result;\n\n        if (!db.objectStoreNames.contains(storeName)) {\n          db.createObjectStore(storeName, { keyPath: 'version' });\n        }\n      };\n\n      request.onsuccess = (): void => resolve(request.result);\n    });\n\n    return dbPromise;\n  };\n\n  const getStore = (db: IDBDatabase, mode: IDBTransactionMode): IDBObjectStore =>\n    db.transaction(storeName, mode).objectStore(storeName);\n\n  const toIconlyError = (\n    error: unknown,\n    fallbackCode: IconlyError['code'],\n    message: string,\n  ): IconlyError => {\n    if (error && typeof error === 'object' && 'code' in error && 'message' in error) {\n      return error as IconlyError;\n    }\n\n    return createIconlyError(fallbackCode, message, error);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readonly');\n\n      return await new Promise<Result<IconRecord | undefined>>((resolve) => {\n        const request = store.get(version);\n\n        request.onsuccess = (): void => resolve(ok(request.result as IconRecord | undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to read from IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(toIconlyError(error, 'indexeddb_open_failed', 'Failed to open IndexedDB.'));\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readwrite');\n\n      return await new Promise<Result<void>>((resolve) => {\n        const request = store.put(record);\n\n        request.onsuccess = (): void => resolve(ok(undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to write to IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(createIconlyError('indexeddb_open_failed', 'Failed to open IndexedDB.', error));\n    }\n  };\n\n  return { get, set };\n};\n","import { ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\nexport const createMemoryStorage = (): IconStorage => {\n  const store = new Map<string, string>();\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    if (!store.has(version)) {\n      return ok(undefined);\n    }\n\n    return ok({ version, data: store.get(version) ?? '' });\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    store.set(record.version, record.data);\n\n    return ok(undefined);\n  };\n\n  return { get, set };\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\ninterface SessionStorageOptions {\n  keyPrefix?: string;\n}\n\nexport const createSessionStorage = (options: SessionStorageOptions = {}): IconStorage => {\n  const keyPrefix = options.keyPrefix ?? 'iconly';\n\n  const resolveStorage = (): Result<Storage> => {\n    if (typeof window === 'undefined' || !window.sessionStorage) {\n      return err(createIconlyError('storage_unavailable', 'SessionStorage is not available.'));\n    }\n\n    return ok(window.sessionStorage);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      const raw = storageResult.value.getItem(`${keyPrefix}:${version}`);\n\n      if (!raw) {\n        return ok(undefined);\n      }\n\n      const parsed = JSON.parse(raw) as IconRecord;\n\n      return ok(parsed);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_read_failed', 'Failed to read from SessionStorage.', error),\n      );\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      storageResult.value.setItem(`${keyPrefix}:${record.version}`, JSON.stringify(record));\n\n      return ok(undefined);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_write_failed', 'Failed to write to SessionStorage.', error),\n      );\n    }\n  };\n\n  return { get, set };\n};\n","import type { IconStorage, StorageStrategy } from '../types';\nimport { createIndexedDbStorage } from './indexeddb';\nimport { createMemoryStorage } from './memory';\nimport { createSessionStorage } from './session';\n\nexport interface StorageFactoryOptions {\n  dbName?: string;\n  storeName?: string;\n  sessionKeyPrefix?: string;\n}\n\nexport const resolveStorage = (\n  strategy: StorageStrategy | undefined,\n  options: StorageFactoryOptions,\n): IconStorage => {\n  if (!strategy || strategy === 'indexeddb') {\n    return createIndexedDbStorage({\n      dbName: options.dbName,\n      storeName: options.storeName,\n    });\n  }\n\n  if (strategy === 'memory') {\n    return createMemoryStorage();\n  }\n\n  if (strategy === 'session') {\n    return createSessionStorage({ keyPrefix: options.sessionKeyPrefix });\n  }\n\n  return strategy;\n};\n","import { insertSvg } from './dom';\nimport { createIconlyError } from './errors';\nimport { fetchSvg } from './fetcher';\nimport { err, ok } from './result';\nimport { resolveStorage } from './storage';\nimport type { IconlyConfig, IconlyError, IconlyInstance, IconStorage, Result } from './types';\n\ninterface ResolvedIconlyConfig {\n  file: string;\n  version: string;\n  debug: boolean;\n  container?: string | HTMLElement;\n  logger?: IconlyConfig['logger'];\n  onError?: IconlyConfig['onError'];\n  onDebug?: IconlyConfig['onDebug'];\n}\n\nexport const createIconly = (config: IconlyConfig = {}): IconlyInstance => {\n  const resolved: ResolvedIconlyConfig = {\n    file: config.file ?? './icons.svg',\n    version: config.version ?? '1.0',\n    debug: config.debug ?? false,\n    container: config.container,\n    logger: config.logger,\n    onError: config.onError,\n    onDebug: config.onDebug,\n  };\n\n  const storage: IconStorage = resolveStorage(config.storage, {\n    dbName: config.dbName,\n    storeName: config.storeName,\n    sessionKeyPrefix: config.sessionKeyPrefix,\n  });\n\n  let controller: AbortController | null = null;\n\n  const abort = (): void => {\n    controller?.abort();\n  };\n\n  const resolveContainer = (): Result<HTMLElement> => {\n    if (typeof document === 'undefined') {\n      return err(\n        createIconlyError('container_invalid', 'Document is not available in this environment.'),\n      );\n    }\n\n    if (typeof resolved.container === 'string') {\n      const found = document.querySelector(resolved.container);\n\n      if (!found || !(found instanceof HTMLElement)) {\n        return err(\n          createIconlyError(\n            'container_invalid',\n            `Invalid container selector: \"${resolved.container}\".`,\n          ),\n        );\n      }\n\n      return ok(found);\n    }\n\n    if (resolved.container instanceof HTMLElement) {\n      return ok(resolved.container);\n    }\n\n    const fallback = document.body ?? document.documentElement;\n\n    if (!fallback) {\n      return err(createIconlyError('container_invalid', 'No valid container element found.'));\n    }\n\n    return ok(fallback);\n  };\n\n  const logDebug = (...messages: unknown[]): void => {\n    if (!resolved.debug) {\n      return;\n    }\n\n    resolved.onDebug?.(...messages);\n    resolved.logger?.debug?.('[Iconly debug]', ...messages);\n  };\n\n  const logError = (error: IconlyError): void => {\n    resolved.onError?.(error);\n    resolved.logger?.error?.('[Iconly error]', error);\n  };\n\n  const fail = (error: IconlyError): Result<void> => {\n    logError(error);\n\n    return err(error);\n  };\n\n  const init = async (): Promise<Result<void>> => {\n    const containerResult = resolveContainer();\n\n    if (!containerResult.ok) {\n      return fail(containerResult.error);\n    }\n\n    const cacheResult = await storage.get(resolved.version);\n\n    if (!cacheResult.ok) {\n      return fail(cacheResult.error);\n    }\n\n    let data = cacheResult.value?.data;\n\n    if (!data) {\n      controller = new AbortController();\n\n      const fetchResult = await fetchSvg(resolved.file, controller.signal);\n\n      if (!fetchResult.ok) {\n        return fail(fetchResult.error);\n      }\n\n      data = fetchResult.value;\n\n      const storeResult = await storage.set({\n        version: resolved.version,\n        data,\n      });\n\n      if (!storeResult.ok) {\n        return fail(storeResult.error);\n      }\n    } else {\n      logDebug('Using cached icon set', resolved.version);\n    }\n\n    const insertResult = insertSvg(containerResult.value, data);\n\n    if (!insertResult.ok) {\n      return fail(insertResult.error);\n    }\n\n    logDebug('Iconly has successfully initialized.');\n\n    return ok(undefined);\n  };\n\n  return { init, abort };\n};\n"],"names":["createIconlyError","code","message","cause","ok","value","err","error","insertSvg","container","data","iconSetDiv","svgDoc","parserError","svgEl","imported","fetchSvg","file","signal","response","createIndexedDbStorage","options","dbName","storeName","dbPromise","openDb","resolve","reject","request","event","db","getStore","mode","toIconlyError","fallbackCode","version","store","record","createMemoryStorage","createSessionStorage","keyPrefix","resolveStorage","storageResult","raw","parsed","strategy","createIconly","config","resolved","storage","controller","abort","resolveContainer","found","fallback","logDebug","messages","logError","fail","containerResult","cacheResult","fetchResult","storeResult","insertResult"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,25 +1,55 @@
-export interface IconlyOptions {
-    file?: string;
-    version?: string;
-    debug?: boolean;
-    container?: string | HTMLElement;
-}
-export interface IconRecord {
-    version: string;
-    data: string;
-}
-declare class Iconly {
-    private static dbInstance;
-    private readonly options;
-    private readonly container;
-    constructor(options?: IconlyOptions);
-    private openDB;
-    private getIconStore;
-    private static fetchData;
-    private insert;
-    init(): Promise<void>;
-    private createErrorMessage;
-    private logDebug;
-    private logError;
-}
-export default Iconly;
+export declare const createIconly: (config?: IconlyConfig) => IconlyInstance;
+
+export declare interface IconlyConfig {
+    file?: string;
+    version?: string;
+    debug?: boolean;
+    container?: string | HTMLElement;
+    storage?: StorageStrategy;
+    dbName?: string;
+    storeName?: string;
+    sessionKeyPrefix?: string;
+    logger?: Logger;
+    onError?: (error: IconlyError) => void;
+    onDebug?: (...messages: unknown[]) => void;
+}
+
+export declare interface IconlyError {
+    code: IconlyErrorCode;
+    message: string;
+    cause?: unknown;
+}
+
+export declare type IconlyErrorCode = 'container_invalid' | 'fetch_aborted' | 'fetch_failed' | 'indexeddb_not_supported' | 'indexeddb_open_failed' | 'indexeddb_request_failed' | 'parse_error' | 'storage_read_failed' | 'storage_unavailable' | 'storage_write_failed';
+
+export declare interface IconlyInstance {
+    init: () => Promise<Result<void>>;
+    abort: () => void;
+}
+
+export declare interface IconRecord {
+    version: string;
+    data: string;
+}
+
+export declare interface IconStorage {
+    get(version: string): Promise<Result<IconRecord | undefined>>;
+    set(record: IconRecord): Promise<Result<void>>;
+}
+
+export declare interface Logger {
+    debug?: (...messages: unknown[]) => void;
+    error?: (...messages: unknown[]) => void;
+}
+
+export declare type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: IconlyError;
+};
+
+export declare type StorageStrategy = 'indexeddb' | 'memory' | 'session' | IconStorage;
+
+export { }

package/dist/index.es.js

@@ -1,100 +1,198 @@
-var g = Object.defineProperty;
-var h = (d, r, e) => r in d ? g(d, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : d[r] = e;
-var l = (d, r, e) => h(d, typeof r != "symbol" ? r + "" : r, e);
-const a = class a {
-  constructor(r = {}) {
-    l(this, "options");
-    l(this, "container");
-    const e = { file: "./icons.svg", version: "1.0", debug: !1, container: document.body ?? document.documentElement, ...r };
-    let n;
-    if (typeof e.container == "string") {
-      const i = document.querySelector(e.container);
-      if (!(i && i instanceof HTMLElement)) throw new Error(`Invalid container selector: "${e.container}"`);
-      n = i;
-    } else n = e.container;
-    this.container = n, this.options = { file: e.file, version: e.version, debug: e.debug }, a.dbInstance || (a.dbInstance = this.openDB("iconlyDB", 1));
+const i = (e, t, r) => ({
+  code: e,
+  message: t,
+  cause: r
+}), u = (e) => ({ ok: !0, value: e }), a = (e) => ({ ok: !1, error: e }), w = (e, t) => {
+  let r = document.getElementById("iconset");
+  r || (r = document.createElement("div"), r.id = "iconset", r.setAttribute("aria-hidden", "true"), r.style.cssText = "width: 0; height: 0; position: absolute; left: -9999px;", e.appendChild(r));
+  const b = new DOMParser().parseFromString(t, "image/svg+xml"), f = b.querySelector("parsererror");
+  if (f)
+    return a(
+      i(
+        "parse_error",
+        `SVG parsing error: ${f.textContent ?? "Unknown error"}`
+      )
+    );
+  r.innerHTML = "";
+  const c = b.documentElement;
+  if (!c)
+    return a(i("parse_error", "No valid SVG content found."));
+  const m = document.importNode(c, !0);
+  return r.appendChild(m), u(void 0);
+}, x = async (e, t) => {
+  try {
+    const r = await fetch(e, { signal: t });
+    if (!r.ok)
+      return a(i("fetch_failed", `Failed to fetch icons from "${e}".`));
+    const o = await r.text();
+    return u(o);
+  } catch (r) {
+    return r instanceof DOMException && r.name === "AbortError" ? a(i("fetch_aborted", "Fetch request was aborted.", r)) : a(i("fetch_failed", "Failed to fetch icons.", r));
   }
-  async openDB(r, e) {
-    if (!("indexedDB" in window)) throw this.logError("This browser does not support IndexedDB"), new Error("IndexedDB not supported");
-    return await new Promise((n, i) => {
-      const o = indexedDB.open(r, e);
-      o.onerror = () => {
-        const s = this.createErrorMessage(o.error, "IndexedDB error");
-        i(new Error(s));
-      }, o.onupgradeneeded = (s) => {
-        const t = s.target.result;
-        t.objectStoreNames.contains("icons") || t.createObjectStore("icons", { keyPath: "version" });
-      }, o.onsuccess = () => {
-        n(o.result);
-      };
-    });
-  }
-  getIconStore(r, e) {
-    return r.transaction("icons", e).objectStore("icons");
-  }
-  static async fetchData(r) {
-    const e = await fetch(r);
-    if (!e.ok) throw new Error(`Failed to fetch icons from "${r}"`);
-    return e.text();
-  }
-  insert(r) {
-    let e = document.getElementById("iconset");
-    e || (e = document.createElement("div"), e.id = "iconset", e.setAttribute("aria-hidden", "true"), e.style.cssText = "width: 0; height: 0; position: absolute; left: -9999px;", this.container.appendChild(e));
-    const n = new DOMParser().parseFromString(r, "image/svg+xml"), i = n.querySelector("parsererror");
-    if (i) return void this.logError("SVG parsing error:", i.textContent ?? "");
-    e.innerHTML = "";
-    const o = n.documentElement;
-    if (o) {
-      const s = document.importNode(o, !0);
-      e.appendChild(s);
-    } else this.logError("No valid SVG content found to insert.");
-  }
-  async init() {
+}, S = (e = {}) => {
+  const t = e.dbName ?? "iconlyDB", r = e.storeName ?? "icons";
+  let o = null;
+  const b = async () => {
+    if (o)
+      return o;
+    if (typeof indexedDB > "u")
+      throw i("indexeddb_not_supported", "IndexedDB is not supported.");
+    return o = new Promise((d, n) => {
+      const s = indexedDB.open(t, 1);
+      s.onerror = () => {
+        n(
+          i(
+            "indexeddb_open_failed",
+            "Failed to open IndexedDB connection.",
+            s.error
+          )
+        );
+      }, s.onupgradeneeded = (g) => {
+        const l = g.target.result;
+        l.objectStoreNames.contains(r) || l.createObjectStore(r, { keyPath: "version" });
+      }, s.onsuccess = () => d(s.result);
+    }), o;
+  }, f = (d, n) => d.transaction(r, n).objectStore(r), c = (d, n, s) => d && typeof d == "object" && "code" in d && "message" in d ? d : i(n, s, d);
+  return { get: async (d) => {
     try {
-      let r = await a.fetchData(this.options.file);
-      const e = await a.dbInstance;
-      if (!e) throw new Error("Failed to open IndexedDB");
-      const n = this.getIconStore(e, "readwrite"), i = await new Promise((o, s) => {
-        const t = n.get(this.options.version);
-        t.onsuccess = () => {
-          o(t.result);
-        }, t.onerror = () => {
-          const c = this.createErrorMessage(t.error, "Error getting record from store");
-          s(new Error(c));
-        };
+      const n = await b(), s = f(n, "readonly");
+      return await new Promise((g) => {
+        const l = s.get(d);
+        l.onsuccess = () => g(u(l.result)), l.onerror = () => g(
+          a(
+            i(
+              "indexeddb_request_failed",
+              "Failed to read from IndexedDB.",
+              l.error
+            )
+          )
+        );
       });
-      i ? r = i.data : await new Promise((o, s) => {
-        const t = n.put({ version: this.options.version, data: r });
-        t.onsuccess = () => o(), t.onerror = () => {
-          const c = this.createErrorMessage(t.error, "Error putting record into store");
-          s(new Error(c));
-        };
-      }), await new Promise((o, s) => {
-        const t = n.transaction;
-        t.oncomplete = () => o(), t.onerror = () => {
-          const c = this.createErrorMessage(t.error, "Transaction error");
-          s(new Error(c));
-        }, t.onabort = () => {
-          const c = this.createErrorMessage(t.error, "Transaction aborted");
-          s(new Error(c));
-        };
-      }), this.insert(r), this.logDebug("Iconly has successfully initialized.");
-    } catch (r) {
-      const e = r instanceof Error ? r : new Error(String(r));
-      this.logError("Error initializing Iconly:", e.message);
+    } catch (n) {
+      return a(c(n, "indexeddb_open_failed", "Failed to open IndexedDB."));
     }
-  }
-  createErrorMessage(r, e) {
-    return r && (r instanceof DOMException || r instanceof Error) && r.message || e;
-  }
-  logDebug(...r) {
-    this.options.debug;
-  }
-  logError(...r) {
-  }
+  }, set: async (d) => {
+    try {
+      const n = await b(), s = f(n, "readwrite");
+      return await new Promise((g) => {
+        const l = s.put(d);
+        l.onsuccess = () => g(u(void 0)), l.onerror = () => g(
+          a(
+            i(
+              "indexeddb_request_failed",
+              "Failed to write to IndexedDB.",
+              l.error
+            )
+          )
+        );
+      });
+    } catch (n) {
+      return a(i("indexeddb_open_failed", "Failed to open IndexedDB.", n));
+    }
+  } };
+}, h = () => {
+  const e = /* @__PURE__ */ new Map();
+  return { get: async (o) => e.has(o) ? u({ version: o, data: e.get(o) ?? "" }) : u(void 0), set: async (o) => (e.set(o.version, o.data), u(void 0)) };
+}, _ = (e = {}) => {
+  const t = e.keyPrefix ?? "iconly", r = () => typeof window > "u" || !window.sessionStorage ? a(i("storage_unavailable", "SessionStorage is not available.")) : u(window.sessionStorage);
+  return { get: async (f) => {
+    const c = r();
+    if (!c.ok)
+      return c;
+    try {
+      const m = c.value.getItem(`${t}:${f}`);
+      if (!m)
+        return u(void 0);
+      const y = JSON.parse(m);
+      return u(y);
+    } catch (m) {
+      return a(
+        i("storage_read_failed", "Failed to read from SessionStorage.", m)
+      );
+    }
+  }, set: async (f) => {
+    const c = r();
+    if (!c.ok)
+      return c;
+    try {
+      return c.value.setItem(`${t}:${f.version}`, JSON.stringify(f)), u(void 0);
+    } catch (m) {
+      return a(
+        i("storage_write_failed", "Failed to write to SessionStorage.", m)
+      );
+    }
+  } };
+}, D = (e, t) => !e || e === "indexeddb" ? S({
+  dbName: t.dbName,
+  storeName: t.storeName
+}) : e === "memory" ? h() : e === "session" ? _({ keyPrefix: t.sessionKeyPrefix }) : e, N = (e = {}) => {
+  const t = {
+    file: e.file ?? "./icons.svg",
+    version: e.version ?? "1.0",
+    debug: e.debug ?? !1,
+    container: e.container,
+    logger: e.logger,
+    onError: e.onError,
+    onDebug: e.onDebug
+  }, r = D(e.storage, {
+    dbName: e.dbName,
+    storeName: e.storeName,
+    sessionKeyPrefix: e.sessionKeyPrefix
+  });
+  let o = null;
+  const b = () => {
+    o?.abort();
+  }, f = () => {
+    if (typeof document > "u")
+      return a(
+        i("container_invalid", "Document is not available in this environment.")
+      );
+    if (typeof t.container == "string") {
+      const s = document.querySelector(t.container);
+      return !s || !(s instanceof HTMLElement) ? a(
+        i(
+          "container_invalid",
+          `Invalid container selector: "${t.container}".`
+        )
+      ) : u(s);
+    }
+    if (t.container instanceof HTMLElement)
+      return u(t.container);
+    const n = document.body ?? document.documentElement;
+    return n ? u(n) : a(i("container_invalid", "No valid container element found."));
+  }, c = (...n) => {
+    t.debug && (t.onDebug?.(...n), t.logger?.debug?.("[Iconly debug]", ...n));
+  }, m = (n) => {
+    t.onError?.(n), t.logger?.error?.("[Iconly error]", n);
+  }, y = (n) => (m(n), a(n));
+  return { init: async () => {
+    const n = f();
+    if (!n.ok)
+      return y(n.error);
+    const s = await r.get(t.version);
+    if (!s.ok)
+      return y(s.error);
+    let g = s.value?.data;
+    if (g)
+      c("Using cached icon set", t.version);
+    else {
+      o = new AbortController();
+      const v = await x(t.file, o.signal);
+      if (!v.ok)
+        return y(v.error);
+      g = v.value;
+      const p = await r.set({
+        version: t.version,
+        data: g
+      });
+      if (!p.ok)
+        return y(p.error);
+    }
+    const l = w(n.value, g);
+    return l.ok ? (c("Iconly has successfully initialized."), u(void 0)) : y(l.error);
+  }, abort: b };
 };
-l(a, "dbInstance", null);
-let u = a;
 export {
-  u as default
+  N as createIconly
 };
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../src/errors.ts","../src/result.ts","../src/dom.ts","../src/fetcher.ts","../src/storage/indexeddb.ts","../src/storage/memory.ts","../src/storage/session.ts","../src/storage/index.ts","../src/core.ts"],"sourcesContent":["import type { IconlyError, IconlyErrorCode } from './types';\n\nexport const createIconlyError = (\n  code: IconlyErrorCode,\n  message: string,\n  cause?: unknown,\n): IconlyError => ({\n  code,\n  message,\n  cause,\n});\n","import type { IconlyError, Result } from './types';\n\nexport const ok = <T>(value: T): Result<T> => ({ ok: true, value });\n\nexport const err = <T = never>(error: IconlyError): Result<T> => ({ ok: false, error });\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const insertSvg = (container: HTMLElement, data: string): Result<void> => {\n  let iconSetDiv = document.getElementById('iconset');\n\n  if (!iconSetDiv) {\n    iconSetDiv = document.createElement('div');\n    iconSetDiv.id = 'iconset';\n    iconSetDiv.setAttribute('aria-hidden', 'true');\n    iconSetDiv.style.cssText = 'width: 0; height: 0; position: absolute; left: -9999px;';\n    container.appendChild(iconSetDiv);\n  }\n\n  const parser = new DOMParser();\n  const svgDoc = parser.parseFromString(data, 'image/svg+xml');\n  const parserError = svgDoc.querySelector('parsererror');\n\n  if (parserError) {\n    return err(\n      createIconlyError(\n        'parse_error',\n        `SVG parsing error: ${parserError.textContent ?? 'Unknown error'}`,\n      ),\n    );\n  }\n\n  iconSetDiv.innerHTML = '';\n\n  const svgEl = svgDoc.documentElement;\n\n  if (!svgEl) {\n    return err(createIconlyError('parse_error', 'No valid SVG content found.'));\n  }\n\n  const imported = document.importNode(svgEl, true);\n\n  iconSetDiv.appendChild(imported);\n\n  return ok(undefined);\n};\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const fetchSvg = async (file: string, signal?: AbortSignal): Promise<Result<string>> => {\n  try {\n    const response = await fetch(file, { signal });\n\n    if (!response.ok) {\n      return err(createIconlyError('fetch_failed', `Failed to fetch icons from \"${file}\".`));\n    }\n\n    const data = await response.text();\n\n    return ok(data);\n  } catch (error: unknown) {\n    if (error instanceof DOMException && error.name === 'AbortError') {\n      return err(createIconlyError('fetch_aborted', 'Fetch request was aborted.', error));\n    }\n\n    return err(createIconlyError('fetch_failed', 'Failed to fetch icons.', error));\n  }\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconlyError, IconRecord, IconStorage, Result } from '../types';\n\ninterface IndexedDbOptions {\n  dbName?: string;\n  storeName?: string;\n}\n\nexport const createIndexedDbStorage = (options: IndexedDbOptions = {}): IconStorage => {\n  const dbName = options.dbName ?? 'iconlyDB';\n  const storeName = options.storeName ?? 'icons';\n\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  const openDb = async (): Promise<IDBDatabase> => {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    if (typeof indexedDB === 'undefined') {\n      throw createIconlyError('indexeddb_not_supported', 'IndexedDB is not supported.');\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onerror = (): void => {\n        reject(\n          createIconlyError(\n            'indexeddb_open_failed',\n            'Failed to open IndexedDB connection.',\n            request.error,\n          ),\n        );\n      };\n\n      request.onupgradeneeded = (event): void => {\n        const db = (event.target as IDBOpenDBRequest).result;\n\n        if (!db.objectStoreNames.contains(storeName)) {\n          db.createObjectStore(storeName, { keyPath: 'version' });\n        }\n      };\n\n      request.onsuccess = (): void => resolve(request.result);\n    });\n\n    return dbPromise;\n  };\n\n  const getStore = (db: IDBDatabase, mode: IDBTransactionMode): IDBObjectStore =>\n    db.transaction(storeName, mode).objectStore(storeName);\n\n  const toIconlyError = (\n    error: unknown,\n    fallbackCode: IconlyError['code'],\n    message: string,\n  ): IconlyError => {\n    if (error && typeof error === 'object' && 'code' in error && 'message' in error) {\n      return error as IconlyError;\n    }\n\n    return createIconlyError(fallbackCode, message, error);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readonly');\n\n      return await new Promise<Result<IconRecord | undefined>>((resolve) => {\n        const request = store.get(version);\n\n        request.onsuccess = (): void => resolve(ok(request.result as IconRecord | undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to read from IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(toIconlyError(error, 'indexeddb_open_failed', 'Failed to open IndexedDB.'));\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readwrite');\n\n      return await new Promise<Result<void>>((resolve) => {\n        const request = store.put(record);\n\n        request.onsuccess = (): void => resolve(ok(undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to write to IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(createIconlyError('indexeddb_open_failed', 'Failed to open IndexedDB.', error));\n    }\n  };\n\n  return { get, set };\n};\n","import { ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\nexport const createMemoryStorage = (): IconStorage => {\n  const store = new Map<string, string>();\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    if (!store.has(version)) {\n      return ok(undefined);\n    }\n\n    return ok({ version, data: store.get(version) ?? '' });\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    store.set(record.version, record.data);\n\n    return ok(undefined);\n  };\n\n  return { get, set };\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\ninterface SessionStorageOptions {\n  keyPrefix?: string;\n}\n\nexport const createSessionStorage = (options: SessionStorageOptions = {}): IconStorage => {\n  const keyPrefix = options.keyPrefix ?? 'iconly';\n\n  const resolveStorage = (): Result<Storage> => {\n    if (typeof window === 'undefined' || !window.sessionStorage) {\n      return err(createIconlyError('storage_unavailable', 'SessionStorage is not available.'));\n    }\n\n    return ok(window.sessionStorage);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      const raw = storageResult.value.getItem(`${keyPrefix}:${version}`);\n\n      if (!raw) {\n        return ok(undefined);\n      }\n\n      const parsed = JSON.parse(raw) as IconRecord;\n\n      return ok(parsed);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_read_failed', 'Failed to read from SessionStorage.', error),\n      );\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      storageResult.value.setItem(`${keyPrefix}:${record.version}`, JSON.stringify(record));\n\n      return ok(undefined);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_write_failed', 'Failed to write to SessionStorage.', error),\n      );\n    }\n  };\n\n  return { get, set };\n};\n","import type { IconStorage, StorageStrategy } from '../types';\nimport { createIndexedDbStorage } from './indexeddb';\nimport { createMemoryStorage } from './memory';\nimport { createSessionStorage } from './session';\n\nexport interface StorageFactoryOptions {\n  dbName?: string;\n  storeName?: string;\n  sessionKeyPrefix?: string;\n}\n\nexport const resolveStorage = (\n  strategy: StorageStrategy | undefined,\n  options: StorageFactoryOptions,\n): IconStorage => {\n  if (!strategy || strategy === 'indexeddb') {\n    return createIndexedDbStorage({\n      dbName: options.dbName,\n      storeName: options.storeName,\n    });\n  }\n\n  if (strategy === 'memory') {\n    return createMemoryStorage();\n  }\n\n  if (strategy === 'session') {\n    return createSessionStorage({ keyPrefix: options.sessionKeyPrefix });\n  }\n\n  return strategy;\n};\n","import { insertSvg } from './dom';\nimport { createIconlyError } from './errors';\nimport { fetchSvg } from './fetcher';\nimport { err, ok } from './result';\nimport { resolveStorage } from './storage';\nimport type { IconlyConfig, IconlyError, IconlyInstance, IconStorage, Result } from './types';\n\ninterface ResolvedIconlyConfig {\n  file: string;\n  version: string;\n  debug: boolean;\n  container?: string | HTMLElement;\n  logger?: IconlyConfig['logger'];\n  onError?: IconlyConfig['onError'];\n  onDebug?: IconlyConfig['onDebug'];\n}\n\nexport const createIconly = (config: IconlyConfig = {}): IconlyInstance => {\n  const resolved: ResolvedIconlyConfig = {\n    file: config.file ?? './icons.svg',\n    version: config.version ?? '1.0',\n    debug: config.debug ?? false,\n    container: config.container,\n    logger: config.logger,\n    onError: config.onError,\n    onDebug: config.onDebug,\n  };\n\n  const storage: IconStorage = resolveStorage(config.storage, {\n    dbName: config.dbName,\n    storeName: config.storeName,\n    sessionKeyPrefix: config.sessionKeyPrefix,\n  });\n\n  let controller: AbortController | null = null;\n\n  const abort = (): void => {\n    controller?.abort();\n  };\n\n  const resolveContainer = (): Result<HTMLElement> => {\n    if (typeof document === 'undefined') {\n      return err(\n        createIconlyError('container_invalid', 'Document is not available in this environment.'),\n      );\n    }\n\n    if (typeof resolved.container === 'string') {\n      const found = document.querySelector(resolved.container);\n\n      if (!found || !(found instanceof HTMLElement)) {\n        return err(\n          createIconlyError(\n            'container_invalid',\n            `Invalid container selector: \"${resolved.container}\".`,\n          ),\n        );\n      }\n\n      return ok(found);\n    }\n\n    if (resolved.container instanceof HTMLElement) {\n      return ok(resolved.container);\n    }\n\n    const fallback = document.body ?? document.documentElement;\n\n    if (!fallback) {\n      return err(createIconlyError('container_invalid', 'No valid container element found.'));\n    }\n\n    return ok(fallback);\n  };\n\n  const logDebug = (...messages: unknown[]): void => {\n    if (!resolved.debug) {\n      return;\n    }\n\n    resolved.onDebug?.(...messages);\n    resolved.logger?.debug?.('[Iconly debug]', ...messages);\n  };\n\n  const logError = (error: IconlyError): void => {\n    resolved.onError?.(error);\n    resolved.logger?.error?.('[Iconly error]', error);\n  };\n\n  const fail = (error: IconlyError): Result<void> => {\n    logError(error);\n\n    return err(error);\n  };\n\n  const init = async (): Promise<Result<void>> => {\n    const containerResult = resolveContainer();\n\n    if (!containerResult.ok) {\n      return fail(containerResult.error);\n    }\n\n    const cacheResult = await storage.get(resolved.version);\n\n    if (!cacheResult.ok) {\n      return fail(cacheResult.error);\n    }\n\n    let data = cacheResult.value?.data;\n\n    if (!data) {\n      controller = new AbortController();\n\n      const fetchResult = await fetchSvg(resolved.file, controller.signal);\n\n      if (!fetchResult.ok) {\n        return fail(fetchResult.error);\n      }\n\n      data = fetchResult.value;\n\n      const storeResult = await storage.set({\n        version: resolved.version,\n        data,\n      });\n\n      if (!storeResult.ok) {\n        return fail(storeResult.error);\n      }\n    } else {\n      logDebug('Using cached icon set', resolved.version);\n    }\n\n    const insertResult = insertSvg(containerResult.value, data);\n\n    if (!insertResult.ok) {\n      return fail(insertResult.error);\n    }\n\n    logDebug('Iconly has successfully initialized.');\n\n    return ok(undefined);\n  };\n\n  return { init, abort };\n};\n"],"names":["createIconlyError","code","message","cause","ok","value","err","error","insertSvg","container","data","iconSetDiv","svgDoc","parserError","svgEl","imported","fetchSvg","file","signal","response","createIndexedDbStorage","options","dbName","storeName","dbPromise","openDb","resolve","reject","request","event","db","getStore","mode","toIconlyError","fallbackCode","version","store","record","createMemoryStorage","createSessionStorage","keyPrefix","resolveStorage","storageResult","raw","parsed","strategy","createIconly","config","resolved","storage","controller","abort","resolveContainer","found","fallback","logDebug","messages","logError","fail","containerResult","cacheResult","fetchResult","storeResult","insertResult"],"mappings":"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"}

package/dist/index.umd.js

@@ -1 +1,2 @@
-(function(s,t){typeof exports=="object"&&typeof module<"u"?module.exports=t():typeof define=="function"&&define.amd?define(t):(s=typeof globalThis<"u"?globalThis:s||self).Iconly=t()})(this,function(){"use strict";var g=Object.defineProperty;var h=(s,t,l)=>t in s?g(s,t,{enumerable:!0,configurable:!0,writable:!0,value:l}):s[t]=l;var u=(s,t,l)=>h(s,typeof t!="symbol"?t+"":t,l);const t=class t{constructor(r={}){u(this,"options");u(this,"container");const e={file:"./icons.svg",version:"1.0",debug:!1,container:document.body??document.documentElement,...r};let i;if(typeof e.container=="string"){const a=document.querySelector(e.container);if(!(a&&a instanceof HTMLElement))throw new Error(`Invalid container selector: "${e.container}"`);i=a}else i=e.container;this.container=i,this.options={file:e.file,version:e.version,debug:e.debug},t.dbInstance||(t.dbInstance=this.openDB("iconlyDB",1))}async openDB(r,e){if(!("indexedDB"in window))throw this.logError("This browser does not support IndexedDB"),new Error("IndexedDB not supported");return await new Promise((i,a)=>{const n=indexedDB.open(r,e);n.onerror=()=>{const c=this.createErrorMessage(n.error,"IndexedDB error");a(new Error(c))},n.onupgradeneeded=c=>{const o=c.target.result;o.objectStoreNames.contains("icons")||o.createObjectStore("icons",{keyPath:"version"})},n.onsuccess=()=>{i(n.result)}})}getIconStore(r,e){return r.transaction("icons",e).objectStore("icons")}static async fetchData(r){const e=await fetch(r);if(!e.ok)throw new Error(`Failed to fetch icons from "${r}"`);return e.text()}insert(r){let e=document.getElementById("iconset");e||(e=document.createElement("div"),e.id="iconset",e.setAttribute("aria-hidden","true"),e.style.cssText="width: 0; height: 0; position: absolute; left: -9999px;",this.container.appendChild(e));const i=new DOMParser().parseFromString(r,"image/svg+xml"),a=i.querySelector("parsererror");if(a)return void this.logError("SVG parsing error:",a.textContent??"");e.innerHTML="";const n=i.documentElement;if(n){const c=document.importNode(n,!0);e.appendChild(c)}else this.logError("No valid SVG content found to insert.")}async init(){try{let r=await t.fetchData(this.options.file);const e=await t.dbInstance;if(!e)throw new Error("Failed to open IndexedDB");const i=this.getIconStore(e,"readwrite"),a=await new Promise((n,c)=>{const o=i.get(this.options.version);o.onsuccess=()=>{n(o.result)},o.onerror=()=>{const d=this.createErrorMessage(o.error,"Error getting record from store");c(new Error(d))}});a?r=a.data:await new Promise((n,c)=>{const o=i.put({version:this.options.version,data:r});o.onsuccess=()=>n(),o.onerror=()=>{const d=this.createErrorMessage(o.error,"Error putting record into store");c(new Error(d))}}),await new Promise((n,c)=>{const o=i.transaction;o.oncomplete=()=>n(),o.onerror=()=>{const d=this.createErrorMessage(o.error,"Transaction error");c(new Error(d))},o.onabort=()=>{const d=this.createErrorMessage(o.error,"Transaction aborted");c(new Error(d))}}),this.insert(r),this.logDebug("Iconly has successfully initialized.")}catch(r){const e=r instanceof Error?r:new Error(String(r));this.logError("Error initializing Iconly:",e.message)}}createErrorMessage(r,e){return r&&(r instanceof DOMException||r instanceof Error)&&r.message||e}logDebug(...r){this.options.debug}logError(...r){}};u(t,"dbInstance",null);let s=t;return s});
+(function(p,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(p=typeof globalThis<"u"?globalThis:p||self,o(p.Iconly={}))})(this,(function(p){"use strict";const o=(e,t,r)=>({code:e,message:t,cause:r}),c=e=>({ok:!0,value:e}),a=e=>({ok:!1,error:e}),w=(e,t)=>{let r=document.getElementById("iconset");r||(r=document.createElement("div"),r.id="iconset",r.setAttribute("aria-hidden","true"),r.style.cssText="width: 0; height: 0; position: absolute; left: -9999px;",e.appendChild(r));const b=new DOMParser().parseFromString(t,"image/svg+xml"),f=b.querySelector("parsererror");if(f)return a(o("parse_error",`SVG parsing error: ${f.textContent??"Unknown error"}`));r.innerHTML="";const d=b.documentElement;if(!d)return a(o("parse_error","No valid SVG content found."));const m=document.importNode(d,!0);return r.appendChild(m),c(void 0)},x=async(e,t)=>{try{const r=await fetch(e,{signal:t});if(!r.ok)return a(o("fetch_failed",`Failed to fetch icons from "${e}".`));const s=await r.text();return c(s)}catch(r){return r instanceof DOMException&&r.name==="AbortError"?a(o("fetch_aborted","Fetch request was aborted.",r)):a(o("fetch_failed","Failed to fetch icons.",r))}},S=(e={})=>{const t=e.dbName??"iconlyDB",r=e.storeName??"icons";let s=null;const b=async()=>{if(s)return s;if(typeof indexedDB>"u")throw o("indexeddb_not_supported","IndexedDB is not supported.");return s=new Promise((u,n)=>{const i=indexedDB.open(t,1);i.onerror=()=>{n(o("indexeddb_open_failed","Failed to open IndexedDB connection.",i.error))},i.onupgradeneeded=g=>{const l=g.target.result;l.objectStoreNames.contains(r)||l.createObjectStore(r,{keyPath:"version"})},i.onsuccess=()=>u(i.result)}),s},f=(u,n)=>u.transaction(r,n).objectStore(r),d=(u,n,i)=>u&&typeof u=="object"&&"code"in u&&"message"in u?u:o(n,i,u);return{get:async u=>{try{const n=await b(),i=f(n,"readonly");return await new Promise(g=>{const l=i.get(u);l.onsuccess=()=>g(c(l.result)),l.onerror=()=>g(a(o("indexeddb_request_failed","Failed to read from IndexedDB.",l.error)))})}catch(n){return a(d(n,"indexeddb_open_failed","Failed to open IndexedDB."))}},set:async u=>{try{const n=await b(),i=f(n,"readwrite");return await new Promise(g=>{const l=i.put(u);l.onsuccess=()=>g(c(void 0)),l.onerror=()=>g(a(o("indexeddb_request_failed","Failed to write to IndexedDB.",l.error)))})}catch(n){return a(o("indexeddb_open_failed","Failed to open IndexedDB.",n))}}}},_=()=>{const e=new Map;return{get:async s=>e.has(s)?c({version:s,data:e.get(s)??""}):c(void 0),set:async s=>(e.set(s.version,s.data),c(void 0))}},D=(e={})=>{const t=e.keyPrefix??"iconly",r=()=>typeof window>"u"||!window.sessionStorage?a(o("storage_unavailable","SessionStorage is not available.")):c(window.sessionStorage);return{get:async f=>{const d=r();if(!d.ok)return d;try{const m=d.value.getItem(`${t}:${f}`);if(!m)return c(void 0);const y=JSON.parse(m);return c(y)}catch(m){return a(o("storage_read_failed","Failed to read from SessionStorage.",m))}},set:async f=>{const d=r();if(!d.ok)return d;try{return d.value.setItem(`${t}:${f.version}`,JSON.stringify(f)),c(void 0)}catch(m){return a(o("storage_write_failed","Failed to write to SessionStorage.",m))}}}},I=(e,t)=>!e||e==="indexeddb"?S({dbName:t.dbName,storeName:t.storeName}):e==="memory"?_():e==="session"?D({keyPrefix:t.sessionKeyPrefix}):e,N=(e={})=>{const t={file:e.file??"./icons.svg",version:e.version??"1.0",debug:e.debug??!1,container:e.container,logger:e.logger,onError:e.onError,onDebug:e.onDebug},r=I(e.storage,{dbName:e.dbName,storeName:e.storeName,sessionKeyPrefix:e.sessionKeyPrefix});let s=null;const b=()=>{s?.abort()},f=()=>{if(typeof document>"u")return a(o("container_invalid","Document is not available in this environment."));if(typeof t.container=="string"){const i=document.querySelector(t.container);return!i||!(i instanceof HTMLElement)?a(o("container_invalid",`Invalid container selector: "${t.container}".`)):c(i)}if(t.container instanceof HTMLElement)return c(t.container);const n=document.body??document.documentElement;return n?c(n):a(o("container_invalid","No valid container element found."))},d=(...n)=>{t.debug&&(t.onDebug?.(...n),t.logger?.debug?.("[Iconly debug]",...n))},m=n=>{t.onError?.(n),t.logger?.error?.("[Iconly error]",n)},y=n=>(m(n),a(n));return{init:async()=>{const n=f();if(!n.ok)return y(n.error);const i=await r.get(t.version);if(!i.ok)return y(i.error);let g=i.value?.data;if(g)d("Using cached icon set",t.version);else{s=new AbortController;const v=await x(t.file,s.signal);if(!v.ok)return y(v.error);g=v.value;const h=await r.set({version:t.version,data:g});if(!h.ok)return y(h.error)}const l=w(n.value,g);return l.ok?(d("Iconly has successfully initialized."),c(void 0)):y(l.error)},abort:b}};p.createIconly=N,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/errors.ts","../src/result.ts","../src/dom.ts","../src/fetcher.ts","../src/storage/indexeddb.ts","../src/storage/memory.ts","../src/storage/session.ts","../src/storage/index.ts","../src/core.ts"],"sourcesContent":["import type { IconlyError, IconlyErrorCode } from './types';\n\nexport const createIconlyError = (\n  code: IconlyErrorCode,\n  message: string,\n  cause?: unknown,\n): IconlyError => ({\n  code,\n  message,\n  cause,\n});\n","import type { IconlyError, Result } from './types';\n\nexport const ok = <T>(value: T): Result<T> => ({ ok: true, value });\n\nexport const err = <T = never>(error: IconlyError): Result<T> => ({ ok: false, error });\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const insertSvg = (container: HTMLElement, data: string): Result<void> => {\n  let iconSetDiv = document.getElementById('iconset');\n\n  if (!iconSetDiv) {\n    iconSetDiv = document.createElement('div');\n    iconSetDiv.id = 'iconset';\n    iconSetDiv.setAttribute('aria-hidden', 'true');\n    iconSetDiv.style.cssText = 'width: 0; height: 0; position: absolute; left: -9999px;';\n    container.appendChild(iconSetDiv);\n  }\n\n  const parser = new DOMParser();\n  const svgDoc = parser.parseFromString(data, 'image/svg+xml');\n  const parserError = svgDoc.querySelector('parsererror');\n\n  if (parserError) {\n    return err(\n      createIconlyError(\n        'parse_error',\n        `SVG parsing error: ${parserError.textContent ?? 'Unknown error'}`,\n      ),\n    );\n  }\n\n  iconSetDiv.innerHTML = '';\n\n  const svgEl = svgDoc.documentElement;\n\n  if (!svgEl) {\n    return err(createIconlyError('parse_error', 'No valid SVG content found.'));\n  }\n\n  const imported = document.importNode(svgEl, true);\n\n  iconSetDiv.appendChild(imported);\n\n  return ok(undefined);\n};\n","import { createIconlyError } from './errors';\nimport { err, ok } from './result';\nimport type { Result } from './types';\n\nexport const fetchSvg = async (file: string, signal?: AbortSignal): Promise<Result<string>> => {\n  try {\n    const response = await fetch(file, { signal });\n\n    if (!response.ok) {\n      return err(createIconlyError('fetch_failed', `Failed to fetch icons from \"${file}\".`));\n    }\n\n    const data = await response.text();\n\n    return ok(data);\n  } catch (error: unknown) {\n    if (error instanceof DOMException && error.name === 'AbortError') {\n      return err(createIconlyError('fetch_aborted', 'Fetch request was aborted.', error));\n    }\n\n    return err(createIconlyError('fetch_failed', 'Failed to fetch icons.', error));\n  }\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconlyError, IconRecord, IconStorage, Result } from '../types';\n\ninterface IndexedDbOptions {\n  dbName?: string;\n  storeName?: string;\n}\n\nexport const createIndexedDbStorage = (options: IndexedDbOptions = {}): IconStorage => {\n  const dbName = options.dbName ?? 'iconlyDB';\n  const storeName = options.storeName ?? 'icons';\n\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  const openDb = async (): Promise<IDBDatabase> => {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    if (typeof indexedDB === 'undefined') {\n      throw createIconlyError('indexeddb_not_supported', 'IndexedDB is not supported.');\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onerror = (): void => {\n        reject(\n          createIconlyError(\n            'indexeddb_open_failed',\n            'Failed to open IndexedDB connection.',\n            request.error,\n          ),\n        );\n      };\n\n      request.onupgradeneeded = (event): void => {\n        const db = (event.target as IDBOpenDBRequest).result;\n\n        if (!db.objectStoreNames.contains(storeName)) {\n          db.createObjectStore(storeName, { keyPath: 'version' });\n        }\n      };\n\n      request.onsuccess = (): void => resolve(request.result);\n    });\n\n    return dbPromise;\n  };\n\n  const getStore = (db: IDBDatabase, mode: IDBTransactionMode): IDBObjectStore =>\n    db.transaction(storeName, mode).objectStore(storeName);\n\n  const toIconlyError = (\n    error: unknown,\n    fallbackCode: IconlyError['code'],\n    message: string,\n  ): IconlyError => {\n    if (error && typeof error === 'object' && 'code' in error && 'message' in error) {\n      return error as IconlyError;\n    }\n\n    return createIconlyError(fallbackCode, message, error);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readonly');\n\n      return await new Promise<Result<IconRecord | undefined>>((resolve) => {\n        const request = store.get(version);\n\n        request.onsuccess = (): void => resolve(ok(request.result as IconRecord | undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to read from IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(toIconlyError(error, 'indexeddb_open_failed', 'Failed to open IndexedDB.'));\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    try {\n      const db = await openDb();\n      const store = getStore(db, 'readwrite');\n\n      return await new Promise<Result<void>>((resolve) => {\n        const request = store.put(record);\n\n        request.onsuccess = (): void => resolve(ok(undefined));\n        request.onerror = (): void =>\n          resolve(\n            err(\n              createIconlyError(\n                'indexeddb_request_failed',\n                'Failed to write to IndexedDB.',\n                request.error,\n              ),\n            ),\n          );\n      });\n    } catch (error: unknown) {\n      return err(createIconlyError('indexeddb_open_failed', 'Failed to open IndexedDB.', error));\n    }\n  };\n\n  return { get, set };\n};\n","import { ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\nexport const createMemoryStorage = (): IconStorage => {\n  const store = new Map<string, string>();\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    if (!store.has(version)) {\n      return ok(undefined);\n    }\n\n    return ok({ version, data: store.get(version) ?? '' });\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    store.set(record.version, record.data);\n\n    return ok(undefined);\n  };\n\n  return { get, set };\n};\n","import { createIconlyError } from '../errors';\nimport { err, ok } from '../result';\nimport type { IconRecord, IconStorage, Result } from '../types';\n\ninterface SessionStorageOptions {\n  keyPrefix?: string;\n}\n\nexport const createSessionStorage = (options: SessionStorageOptions = {}): IconStorage => {\n  const keyPrefix = options.keyPrefix ?? 'iconly';\n\n  const resolveStorage = (): Result<Storage> => {\n    if (typeof window === 'undefined' || !window.sessionStorage) {\n      return err(createIconlyError('storage_unavailable', 'SessionStorage is not available.'));\n    }\n\n    return ok(window.sessionStorage);\n  };\n\n  const get = async (version: string): Promise<Result<IconRecord | undefined>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      const raw = storageResult.value.getItem(`${keyPrefix}:${version}`);\n\n      if (!raw) {\n        return ok(undefined);\n      }\n\n      const parsed = JSON.parse(raw) as IconRecord;\n\n      return ok(parsed);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_read_failed', 'Failed to read from SessionStorage.', error),\n      );\n    }\n  };\n\n  const set = async (record: IconRecord): Promise<Result<void>> => {\n    const storageResult = resolveStorage();\n\n    if (!storageResult.ok) {\n      return storageResult;\n    }\n\n    try {\n      storageResult.value.setItem(`${keyPrefix}:${record.version}`, JSON.stringify(record));\n\n      return ok(undefined);\n    } catch (error: unknown) {\n      return err(\n        createIconlyError('storage_write_failed', 'Failed to write to SessionStorage.', error),\n      );\n    }\n  };\n\n  return { get, set };\n};\n","import type { IconStorage, StorageStrategy } from '../types';\nimport { createIndexedDbStorage } from './indexeddb';\nimport { createMemoryStorage } from './memory';\nimport { createSessionStorage } from './session';\n\nexport interface StorageFactoryOptions {\n  dbName?: string;\n  storeName?: string;\n  sessionKeyPrefix?: string;\n}\n\nexport const resolveStorage = (\n  strategy: StorageStrategy | undefined,\n  options: StorageFactoryOptions,\n): IconStorage => {\n  if (!strategy || strategy === 'indexeddb') {\n    return createIndexedDbStorage({\n      dbName: options.dbName,\n      storeName: options.storeName,\n    });\n  }\n\n  if (strategy === 'memory') {\n    return createMemoryStorage();\n  }\n\n  if (strategy === 'session') {\n    return createSessionStorage({ keyPrefix: options.sessionKeyPrefix });\n  }\n\n  return strategy;\n};\n","import { insertSvg } from './dom';\nimport { createIconlyError } from './errors';\nimport { fetchSvg } from './fetcher';\nimport { err, ok } from './result';\nimport { resolveStorage } from './storage';\nimport type { IconlyConfig, IconlyError, IconlyInstance, IconStorage, Result } from './types';\n\ninterface ResolvedIconlyConfig {\n  file: string;\n  version: string;\n  debug: boolean;\n  container?: string | HTMLElement;\n  logger?: IconlyConfig['logger'];\n  onError?: IconlyConfig['onError'];\n  onDebug?: IconlyConfig['onDebug'];\n}\n\nexport const createIconly = (config: IconlyConfig = {}): IconlyInstance => {\n  const resolved: ResolvedIconlyConfig = {\n    file: config.file ?? './icons.svg',\n    version: config.version ?? '1.0',\n    debug: config.debug ?? false,\n    container: config.container,\n    logger: config.logger,\n    onError: config.onError,\n    onDebug: config.onDebug,\n  };\n\n  const storage: IconStorage = resolveStorage(config.storage, {\n    dbName: config.dbName,\n    storeName: config.storeName,\n    sessionKeyPrefix: config.sessionKeyPrefix,\n  });\n\n  let controller: AbortController | null = null;\n\n  const abort = (): void => {\n    controller?.abort();\n  };\n\n  const resolveContainer = (): Result<HTMLElement> => {\n    if (typeof document === 'undefined') {\n      return err(\n        createIconlyError('container_invalid', 'Document is not available in this environment.'),\n      );\n    }\n\n    if (typeof resolved.container === 'string') {\n      const found = document.querySelector(resolved.container);\n\n      if (!found || !(found instanceof HTMLElement)) {\n        return err(\n          createIconlyError(\n            'container_invalid',\n            `Invalid container selector: \"${resolved.container}\".`,\n          ),\n        );\n      }\n\n      return ok(found);\n    }\n\n    if (resolved.container instanceof HTMLElement) {\n      return ok(resolved.container);\n    }\n\n    const fallback = document.body ?? document.documentElement;\n\n    if (!fallback) {\n      return err(createIconlyError('container_invalid', 'No valid container element found.'));\n    }\n\n    return ok(fallback);\n  };\n\n  const logDebug = (...messages: unknown[]): void => {\n    if (!resolved.debug) {\n      return;\n    }\n\n    resolved.onDebug?.(...messages);\n    resolved.logger?.debug?.('[Iconly debug]', ...messages);\n  };\n\n  const logError = (error: IconlyError): void => {\n    resolved.onError?.(error);\n    resolved.logger?.error?.('[Iconly error]', error);\n  };\n\n  const fail = (error: IconlyError): Result<void> => {\n    logError(error);\n\n    return err(error);\n  };\n\n  const init = async (): Promise<Result<void>> => {\n    const containerResult = resolveContainer();\n\n    if (!containerResult.ok) {\n      return fail(containerResult.error);\n    }\n\n    const cacheResult = await storage.get(resolved.version);\n\n    if (!cacheResult.ok) {\n      return fail(cacheResult.error);\n    }\n\n    let data = cacheResult.value?.data;\n\n    if (!data) {\n      controller = new AbortController();\n\n      const fetchResult = await fetchSvg(resolved.file, controller.signal);\n\n      if (!fetchResult.ok) {\n        return fail(fetchResult.error);\n      }\n\n      data = fetchResult.value;\n\n      const storeResult = await storage.set({\n        version: resolved.version,\n        data,\n      });\n\n      if (!storeResult.ok) {\n        return fail(storeResult.error);\n      }\n    } else {\n      logDebug('Using cached icon set', resolved.version);\n    }\n\n    const insertResult = insertSvg(containerResult.value, data);\n\n    if (!insertResult.ok) {\n      return fail(insertResult.error);\n    }\n\n    logDebug('Iconly has successfully initialized.');\n\n    return ok(undefined);\n  };\n\n  return { init, abort };\n};\n"],"names":["createIconlyError","code","message","cause","ok","value","err","error","insertSvg","container","data","iconSetDiv","svgDoc","parserError","svgEl","imported","fetchSvg","file","signal","response","createIndexedDbStorage","options","dbName","storeName","dbPromise","openDb","resolve","reject","request","event","db","getStore","mode","toIconlyError","fallbackCode","version","store","record","createMemoryStorage","createSessionStorage","keyPrefix","resolveStorage","storageResult","raw","parsed","strategy","createIconly","config","resolved","storage","controller","abort","resolveContainer","found","fallback","logDebug","messages","logError","fail","containerResult","cacheResult","fetchResult","storeResult","insertResult"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iconly",
-  "version": "2.0.1",
+  "version": "3.0.0-dev.1",
   "description": "Iconly is designed to load and cache SVG icons in the browser, using IndexedDB to store the data. It retrieves the icons from a given SVG file, stores them in IndexedDB, and inserts them into the DOM for easy access and use.",
   "author": "ux-ui.pro",
   "license": "MIT",
@@ -13,13 +13,20 @@
   },
   "homepage": "https://github.com/ux-ui-pro/iconly",
   "sideEffects": false,
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "clean": "rimraf dist",
     "build": "vite build",
-    "lint:js": "eslint src/**/*.{ts,js}",
-    "lint:fix:js": "eslint src/**/*.{ts,js} --fix",
-    "format:js": "prettier --write src/**/*.{ts,js}",
-    "lint:fix": "yarn lint:fix:js && yarn format:js"
+    "verify": "yarn lint && yarn typecheck && yarn test",
+    "lint": "biome check src tests",
+    "lint:fix": "biome check --write src tests",
+    "format": "biome format --write src tests",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "source": "src/index.ts",
   "main": "dist/index.cjs.js",
@@ -28,31 +35,27 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "require": "./dist/index.cjs.js",
       "import": "./dist/index.es.js",
       "default": "./dist/index.umd.js"
-    },
-    "./dist/*": "./dist/*"
+    }
   },
   "files": [
-    "dist/"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "devDependencies": {
-    "@eslint/js": "9.22.0",
-    "@rollup/plugin-terser": "0.4.4",
-    "@types/node": "22.13.10",
-    "@typescript-eslint/eslint-plugin": "8.26.0",
-    "@typescript-eslint/parser": "8.26.0",
-    "eslint": "9.22.0",
-    "eslint-config-prettier": "10.1.1",
-    "eslint-import-resolver-typescript": "3.8.3",
-    "eslint-plugin-import": "2.31.0",
-    "globals": "16.0.0",
-    "prettier": "3.5.3",
-    "rimraf": "6.0.1",
-    "typescript": "5.8.2",
-    "vite": "6.2.1",
-    "vite-plugin-dts": "4.5.3"
+    "@biomejs/biome": "2.3.12",
+    "@types/node": "25.0.10",
+    "fake-indexeddb": "6.2.5",
+    "jsdom": "27.4.0",
+    "rimraf": "6.1.2",
+    "typescript": "5.9.3",
+    "vite": "7.3.1",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "4.0.18"
   },
   "keywords": [
     "icon",
@@ -71,7 +74,6 @@
     "sprites",
     "typescript",
     "utility",
-    "javascript",
-    "es6"
+    "javascript"
   ]
 }