@bquery/bquery 1.4.0 → 1.5.0

package/dist/watch-DXXv3iAI.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch-DXXv3iAI.js","sources":["../src/reactive/persisted.ts","../src/reactive/readonly.ts","../src/reactive/watch.ts"],"sourcesContent":["/**\n * LocalStorage-backed signals.\n */\n\nimport { signal, Signal } from './core';\nimport { effect } from './effect';\n\n/**\n * Creates a signal that persists to localStorage.\n *\n * @template T - The type of the signal value\n * @param key - The localStorage key\n * @param initialValue - The initial value if not found in storage\n * @returns A Signal that syncs with localStorage (falls back to in-memory if unavailable)\n */\nexport const persistedSignal = <T>(key: string, initialValue: T): Signal<T> => {\n  // Check if localStorage is available and accessible\n  let hasLocalStorage = false;\n  let storage: Storage | null = null;\n\n  try {\n    // In Safari private mode, accessing localStorage can throw SecurityError\n    storage = globalThis.localStorage;\n    if (storage) {\n      // Test actual access to ensure it's not just present but usable\n      // Use a randomized test key to avoid overwriting real user data\n      const testKey = `__bquery_test_${Math.random().toString(36).slice(2, 9)}__`;\n      const testValue = '__test__';\n      try {\n        storage.setItem(testKey, testValue);\n        storage.getItem(testKey);\n        hasLocalStorage = true;\n      } finally {\n        // Ensure we don't leave any test data behind\n        try {\n          storage.removeItem(testKey);\n        } catch {\n          // Ignore cleanup errors (e.g., storage becoming unavailable)\n        }\n      }\n    }\n  } catch {\n    // localStorage unavailable or access denied (Safari private mode, sandboxed iframes, etc.)\n    hasLocalStorage = false;\n  }\n\n  let stored: T = initialValue;\n\n  if (hasLocalStorage && storage) {\n    try {\n      const raw = storage.getItem(key);\n      if (raw !== null) {\n        stored = JSON.parse(raw) as T;\n      }\n    } catch {\n      // Use initial value on parse error or access denial\n    }\n  }\n\n  const sig = signal(stored);\n\n  // Only set up persistence effect if localStorage is available\n  if (hasLocalStorage && storage) {\n    effect(() => {\n      try {\n        storage!.setItem(key, JSON.stringify(sig.value));\n      } catch {\n        // Ignore storage errors (quota exceeded, sandboxed iframes, etc.)\n      }\n    });\n  }\n\n  return sig;\n};\n","/**\n * Read-only signal wrappers.\n */\n\nimport type { Signal } from './core';\n\n/**\n * A readonly wrapper around a signal that prevents writes.\n * Provides read-only access to a signal's value while maintaining reactivity.\n *\n * @template T - The type of the wrapped value\n */\nexport interface ReadonlySignal<T> {\n  /** Gets the current value with dependency tracking. */\n  readonly value: T;\n  /** Gets the current value without dependency tracking. */\n  peek(): T;\n}\n\n/**\n * Creates a read-only view of a signal.\n * Useful for exposing reactive state without allowing modifications.\n *\n * @template T - The type of the signal value\n * @param sig - The signal to wrap\n * @returns A readonly signal wrapper\n */\nexport const readonly = <T>(sig: Signal<T>): ReadonlySignal<T> => ({\n  get value(): T {\n    return sig.value;\n  },\n  peek(): T {\n    return sig.peek();\n  },\n});\n","/**\n * Value watching helpers.\n */\n\nimport type { Computed } from './computed';\nimport type { Signal } from './core';\nimport type { CleanupFn } from './internals';\n\nimport { effect } from './effect';\n\n/**\n * Options for the watch function.\n */\nexport interface WatchOptions<T> {\n  /** If true, the callback is invoked immediately with the current value. */\n  immediate?: boolean;\n  /** Custom equality function. Defaults to Object.is. */\n  equals?: (a: T, b: T | undefined) => boolean;\n}\n\n/**\n * Watches a signal or computed value and calls a callback with old and new values.\n * Unlike effect, watch provides access to the previous value.\n * The callback is only invoked when the value actually changes (compared via Object.is or custom equals).\n *\n * @template T - The type of the watched value\n * @param source - The signal or computed to watch\n * @param callback - Function called with (newValue, oldValue) on changes\n * @param options - Watch options\n * @returns A cleanup function to stop watching\n *\n * @example\n * ```ts\n * const count = signal(0);\n * watch(count, (newVal, oldVal) => {\n *   console.log(`Changed from ${oldVal} to ${newVal}`);\n * });\n *\n * // With custom equality for objects\n * const user = signal({ id: 1, name: 'Alice' });\n * watch(user, (newVal, oldVal) => { ... }, {\n *   equals: (a, b) => a?.id === b?.id\n * });\n * ```\n */\nexport const watch = <T>(\n  source: Signal<T> | Computed<T>,\n  callback: (newValue: T, oldValue: T | undefined) => void,\n  options: WatchOptions<T> = {}\n): CleanupFn => {\n  const { immediate = false, equals = Object.is } = options;\n  let oldValue: T | undefined;\n  let isFirst = true;\n\n  return effect(() => {\n    const newValue = source.value;\n\n    if (isFirst) {\n      isFirst = false;\n      oldValue = newValue;\n      if (immediate) {\n        callback(newValue, undefined);\n      }\n      return;\n    }\n\n    // Only call callback if value actually changed\n    if (!equals(newValue, oldValue)) {\n      callback(newValue, oldValue);\n      oldValue = newValue;\n    }\n  });\n};\n"],"names":["persistedSignal","key","initialValue","hasLocalStorage","storage","testKey","testValue","stored","raw","sig","signal","effect","readonly","watch","source","callback","options","immediate","equals","oldValue","isFirst","newValue"],"mappings":";;AAeO,MAAMA,IAAkB,CAAIC,GAAaC,MAA+B;AAE7E,MAAIC,IAAkB,IAClBC,IAA0B;AAE9B,MAAI;AAGF,QADAA,IAAU,WAAW,cACjBA,GAAS;AAGX,YAAMC,IAAU,iBAAiB,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,MACjEC,IAAY;AAClB,UAAI;AACF,QAAAF,EAAQ,QAAQC,GAASC,CAAS,GAClCF,EAAQ,QAAQC,CAAO,GACvBF,IAAkB;AAAA,MACpB,UAAA;AAEE,YAAI;AACF,UAAAC,EAAQ,WAAWC,CAAO;AAAA,QAC5B,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AAEN,IAAAF,IAAkB;AAAA,EACpB;AAEA,MAAII,IAAYL;AAEhB,MAAIC,KAAmBC;AACrB,QAAI;AACF,YAAMI,IAAMJ,EAAQ,QAAQH,CAAG;AAC/B,MAAIO,MAAQ,SACVD,IAAS,KAAK,MAAMC,CAAG;AAAA,IAE3B,QAAQ;AAAA,IAER;AAGF,QAAMC,IAAMC,EAAOH,CAAM;AAGzB,SAAIJ,KAAmBC,KACrBO,EAAO,MAAM;AACX,QAAI;AACF,MAAAP,EAAS,QAAQH,GAAK,KAAK,UAAUQ,EAAI,KAAK,CAAC;AAAA,IACjD,QAAQ;AAAA,IAER;AAAA,EACF,CAAC,GAGIA;AACT,GC9CaG,IAAW,CAAIH,OAAuC;AAAA,EACjE,IAAI,QAAW;AACb,WAAOA,EAAI;AAAA,EACb;AAAA,EACA,OAAU;AACR,WAAOA,EAAI,KAAA;AAAA,EACb;AACF,ICWaI,IAAQ,CACnBC,GACAC,GACAC,IAA2B,CAAA,MACb;AACd,QAAM,EAAE,WAAAC,IAAY,IAAO,QAAAC,IAAS,OAAO,OAAOF;AAClD,MAAIG,GACAC,IAAU;AAEd,SAAOT,EAAO,MAAM;AAClB,UAAMU,IAAWP,EAAO;AAExB,QAAIM,GAAS;AACX,MAAAA,IAAU,IACVD,IAAWE,GACPJ,KACFF,EAASM,GAAU,MAAS;AAE9B;AAAA,IACF;AAGA,IAAKH,EAAOG,GAAUF,CAAQ,MAC5BJ,EAASM,GAAUF,CAAQ,GAC3BA,IAAWE;AAAA,EAEf,CAAC;AACH;"}