@bquery/bquery 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +586 -546
- package/dist/component/component.d.ts +13 -5
- package/dist/component/component.d.ts.map +1 -1
- package/dist/component/html.d.ts +40 -3
- package/dist/component/html.d.ts.map +1 -1
- package/dist/component/index.d.ts +2 -2
- package/dist/component/index.d.ts.map +1 -1
- package/dist/component/library.d.ts.map +1 -1
- package/dist/component/types.d.ts +131 -16
- package/dist/component/types.d.ts.map +1 -1
- package/dist/component-BEQgt5hl.js +600 -0
- package/dist/component-BEQgt5hl.js.map +1 -0
- package/dist/component.es.mjs +7 -6
- package/dist/config-DRmZZno3.js.map +1 -1
- package/dist/core-BGQJVw0-.js +35 -0
- package/dist/core-BGQJVw0-.js.map +1 -0
- package/dist/{core-CK2Mfpf4.js → core-CCEabVHl.js} +2 -2
- package/dist/{core-CK2Mfpf4.js.map → core-CCEabVHl.js.map} +1 -1
- package/dist/core.es.mjs +1 -1
- package/dist/effect-AFRW_Plg.js +84 -0
- package/dist/effect-AFRW_Plg.js.map +1 -0
- package/dist/full.d.ts +4 -4
- package/dist/full.d.ts.map +1 -1
- package/dist/full.es.mjs +98 -94
- package/dist/full.iife.js +14 -14
- package/dist/full.iife.js.map +1 -1
- package/dist/full.umd.js +14 -14
- package/dist/full.umd.js.map +1 -1
- package/dist/index.es.mjs +143 -139
- package/dist/{motion-C5DRdPnO.js → motion-D9TcHxOF.js} +1 -1
- package/dist/{motion-C5DRdPnO.js.map → motion-D9TcHxOF.js.map} +1 -1
- package/dist/motion.es.mjs +1 -1
- package/dist/{platform-B7JhGBc7.js → platform-Dr9b6fsq.js} +21 -20
- package/dist/platform-Dr9b6fsq.js.map +1 -0
- package/dist/platform.es.mjs +1 -1
- package/dist/{reactive-BDya-ia8.js → reactive-DSkct0dO.js} +51 -50
- package/dist/reactive-DSkct0dO.js.map +1 -0
- package/dist/reactive.es.mjs +19 -17
- package/dist/{router-CijiICxt.js → router-CbDhl8rS.js} +3 -3
- package/dist/{router-CijiICxt.js.map → router-CbDhl8rS.js.map} +1 -1
- package/dist/router.es.mjs +1 -1
- package/dist/{sanitize-jyJ2ryE2.js → sanitize-Bs2dkMby.js} +94 -83
- package/dist/sanitize-Bs2dkMby.js.map +1 -0
- package/dist/security/index.d.ts +4 -2
- package/dist/security/index.d.ts.map +1 -1
- package/dist/security/sanitize.d.ts +4 -1
- package/dist/security/sanitize.d.ts.map +1 -1
- package/dist/security/trusted-html.d.ts +53 -0
- package/dist/security/trusted-html.d.ts.map +1 -0
- package/dist/security.es.mjs +10 -9
- package/dist/store/define-store.d.ts +1 -1
- package/dist/store/define-store.d.ts.map +1 -1
- package/dist/store/mapping.d.ts +1 -1
- package/dist/store/mapping.d.ts.map +1 -1
- package/dist/store/persisted.d.ts +1 -1
- package/dist/store/persisted.d.ts.map +1 -1
- package/dist/store/types.d.ts +2 -2
- package/dist/store/types.d.ts.map +1 -1
- package/dist/store/watch.d.ts +1 -1
- package/dist/store/watch.d.ts.map +1 -1
- package/dist/{store-CPK9E62U.js → store-BwDvI45q.js} +49 -48
- package/dist/{store-CPK9E62U.js.map → store-BwDvI45q.js.map} +1 -1
- package/dist/store.es.mjs +1 -1
- package/dist/storybook/index.d.ts +37 -0
- package/dist/storybook/index.d.ts.map +1 -0
- package/dist/storybook.es.mjs +151 -0
- package/dist/storybook.es.mjs.map +1 -0
- package/dist/untrack-B0rVscTc.js +7 -0
- package/dist/untrack-B0rVscTc.js.map +1 -0
- package/dist/{view-Cdi0g-qo.js → view-C70lA3vf.js} +29 -28
- package/dist/{view-Cdi0g-qo.js.map → view-C70lA3vf.js.map} +1 -1
- package/dist/view.es.mjs +9 -8
- package/package.json +141 -136
- package/src/component/component.ts +259 -54
- package/src/component/html.ts +153 -53
- package/src/component/index.ts +10 -2
- package/src/component/library.ts +42 -28
- package/src/component/types.ts +184 -19
- package/src/full.ts +8 -2
- package/src/motion/transition.ts +97 -97
- package/src/motion/types.ts +208 -208
- package/src/platform/announcer.ts +208 -208
- package/src/platform/config.ts +163 -163
- package/src/platform/cookies.ts +165 -165
- package/src/platform/index.ts +39 -39
- package/src/platform/meta.ts +168 -168
- package/src/reactive/async-data.ts +486 -486
- package/src/reactive/index.ts +37 -37
- package/src/reactive/signal.ts +29 -29
- package/src/security/constants.ts +211 -211
- package/src/security/index.ts +17 -10
- package/src/security/sanitize.ts +70 -66
- package/src/security/trusted-html.ts +71 -0
- package/src/store/define-store.ts +49 -48
- package/src/store/mapping.ts +74 -73
- package/src/store/persisted.ts +62 -61
- package/src/store/types.ts +92 -94
- package/src/store/watch.ts +53 -52
- package/src/storybook/index.ts +479 -0
- package/dist/component-CY5MVoYN.js +0 -531
- package/dist/component-CY5MVoYN.js.map +0 -1
- package/dist/core-DPdbItcq.js +0 -112
- package/dist/core-DPdbItcq.js.map +0 -1
- package/dist/platform-B7JhGBc7.js.map +0 -1
- package/dist/reactive-BDya-ia8.js.map +0 -1
- package/dist/sanitize-jyJ2ryE2.js.map +0 -1
package/dist/core-DPdbItcq.js
DELETED
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
var t = [], a = 0, u = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new WeakMap(), l = (e, r) => {
|
|
2
|
-
t.push(e);
|
|
3
|
-
try {
|
|
4
|
-
return r();
|
|
5
|
-
} finally {
|
|
6
|
-
t.pop();
|
|
7
|
-
}
|
|
8
|
-
}, b = () => t[t.length - 1], g = (e) => {
|
|
9
|
-
t.push(void 0);
|
|
10
|
-
try {
|
|
11
|
-
return e();
|
|
12
|
-
} finally {
|
|
13
|
-
t.pop();
|
|
14
|
-
}
|
|
15
|
-
}, f = (e) => {
|
|
16
|
-
if (a > 0) {
|
|
17
|
-
u.add(e);
|
|
18
|
-
return;
|
|
19
|
-
}
|
|
20
|
-
e();
|
|
21
|
-
}, h = () => {
|
|
22
|
-
for (const e of Array.from(u)) {
|
|
23
|
-
u.delete(e);
|
|
24
|
-
try {
|
|
25
|
-
e();
|
|
26
|
-
} catch (r) {
|
|
27
|
-
console.error("bQuery reactive: Error in observer during batch flush", r);
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
}, w = () => {
|
|
31
|
-
a += 1;
|
|
32
|
-
}, D = () => {
|
|
33
|
-
a <= 0 || (a -= 1, a === 0 && h());
|
|
34
|
-
}, d = (e, r) => {
|
|
35
|
-
let s = n.get(e);
|
|
36
|
-
s || (s = /* @__PURE__ */ new Set(), n.set(e, s)), s.add(r);
|
|
37
|
-
}, p = (e, r) => {
|
|
38
|
-
const s = n.get(e);
|
|
39
|
-
s && s.delete(r);
|
|
40
|
-
}, v = (e) => {
|
|
41
|
-
const r = n.get(e);
|
|
42
|
-
if (r) {
|
|
43
|
-
for (const s of r) s.unsubscribe(e);
|
|
44
|
-
r.clear();
|
|
45
|
-
}
|
|
46
|
-
}, O = (e) => {
|
|
47
|
-
let r, s = !1;
|
|
48
|
-
const o = () => {
|
|
49
|
-
if (r) {
|
|
50
|
-
try {
|
|
51
|
-
r();
|
|
52
|
-
} catch (c) {
|
|
53
|
-
console.error("bQuery reactive: Error in effect cleanup", c);
|
|
54
|
-
}
|
|
55
|
-
r = void 0;
|
|
56
|
-
}
|
|
57
|
-
}, i = () => {
|
|
58
|
-
if (!s) {
|
|
59
|
-
o(), v(i);
|
|
60
|
-
try {
|
|
61
|
-
r = l(i, e);
|
|
62
|
-
} catch (c) {
|
|
63
|
-
console.error("bQuery reactive: Error in effect", c);
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
};
|
|
67
|
-
return i(), () => {
|
|
68
|
-
s = !0, o(), v(i);
|
|
69
|
-
};
|
|
70
|
-
}, y = class {
|
|
71
|
-
constructor(e) {
|
|
72
|
-
this._value = e, this.subscribers = /* @__PURE__ */ new Set();
|
|
73
|
-
}
|
|
74
|
-
get value() {
|
|
75
|
-
const e = b();
|
|
76
|
-
return e && (this.subscribers.add(e), d(e, this)), this._value;
|
|
77
|
-
}
|
|
78
|
-
set value(e) {
|
|
79
|
-
if (Object.is(this._value, e)) return;
|
|
80
|
-
this._value = e;
|
|
81
|
-
const r = Array.from(this.subscribers);
|
|
82
|
-
for (const s of r) f(s);
|
|
83
|
-
}
|
|
84
|
-
peek() {
|
|
85
|
-
return this._value;
|
|
86
|
-
}
|
|
87
|
-
update(e) {
|
|
88
|
-
this.value = e(this._value);
|
|
89
|
-
}
|
|
90
|
-
dispose() {
|
|
91
|
-
for (const e of this.subscribers) p(e, this);
|
|
92
|
-
this.subscribers.clear();
|
|
93
|
-
}
|
|
94
|
-
unsubscribe(e) {
|
|
95
|
-
this.subscribers.delete(e);
|
|
96
|
-
}
|
|
97
|
-
}, S = (e) => new y(e);
|
|
98
|
-
export {
|
|
99
|
-
v as a,
|
|
100
|
-
d as c,
|
|
101
|
-
g as d,
|
|
102
|
-
w as i,
|
|
103
|
-
f as l,
|
|
104
|
-
S as n,
|
|
105
|
-
D as o,
|
|
106
|
-
O as r,
|
|
107
|
-
b as s,
|
|
108
|
-
y as t,
|
|
109
|
-
l as u
|
|
110
|
-
};
|
|
111
|
-
|
|
112
|
-
//# sourceMappingURL=core-DPdbItcq.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"core-DPdbItcq.js","names":[],"sources":["../src/reactive/internals.ts","../src/reactive/effect.ts","../src/reactive/core.ts"],"sourcesContent":["/**\n * Internal reactive plumbing shared across primitives.\n * @internal\n */\n\nexport type Observer = () => void;\nexport type CleanupFn = () => void;\n\n/**\n * Interface for reactive sources (Signals, Computed) that can unsubscribe observers.\n * @internal\n */\nexport interface ReactiveSource {\n unsubscribe(observer: Observer): void;\n}\n\nconst observerStack: Observer[] = [];\nlet batchDepth = 0;\nconst pendingObservers = new Set<Observer>();\n\n// Track dependencies for each observer to enable cleanup\nconst observerDependencies = new WeakMap<Observer, Set<ReactiveSource>>();\n\nexport const track = <T>(observer: Observer, fn: () => T): T => {\n observerStack.push(observer);\n try {\n return fn();\n } finally {\n observerStack.pop();\n }\n};\n\nexport const getCurrentObserver = (): Observer | undefined =>\n observerStack[observerStack.length - 1];\n\n/**\n * Executes a function without exposing the current observer to dependencies.\n * Unlike disabling tracking globally, this still allows nested reactive internals\n * (e.g., computed recomputation) to track their own dependencies.\n * @internal\n */\nexport const withoutCurrentObserver = <T>(fn: () => T): T => {\n // Push undefined to temporarily \"hide\" the current observer\n // This way, Signal.value reads won't link to the previous observer,\n // but nested track() calls (e.g., computed recompute) still work normally.\n observerStack.push(undefined as unknown as Observer);\n try {\n return fn();\n } finally {\n observerStack.pop();\n }\n};\n\nexport const scheduleObserver = (observer: Observer): void => {\n if (batchDepth > 0) {\n pendingObservers.add(observer);\n return;\n }\n observer();\n};\n\nconst flushObservers = (): void => {\n for (const observer of Array.from(pendingObservers)) {\n pendingObservers.delete(observer);\n try {\n observer();\n } catch (error) {\n console.error('bQuery reactive: Error in observer during batch flush', error);\n }\n }\n};\n\nexport const beginBatch = (): void => {\n batchDepth += 1;\n};\n\nexport const endBatch = (): void => {\n if (batchDepth <= 0) return;\n batchDepth -= 1;\n if (batchDepth === 0) {\n flushObservers();\n }\n};\n\n/**\n * Registers a dependency between an observer and a reactive source.\n * @internal\n */\nexport const registerDependency = (observer: Observer, source: ReactiveSource): void => {\n let deps = observerDependencies.get(observer);\n if (!deps) {\n deps = new Set();\n observerDependencies.set(observer, deps);\n }\n deps.add(source);\n};\n\n/**\n * Removes a specific source from an observer's dependency set.\n * Used when a source (e.g. Signal) is disposed to prevent stale references.\n * @internal\n */\nexport const removeDependency = (observer: Observer, source: ReactiveSource): void => {\n const deps = observerDependencies.get(observer);\n if (deps) {\n deps.delete(source);\n }\n};\n\n/**\n * Clears all dependencies for an observer, unsubscribing from all sources.\n * @internal\n */\nexport const clearDependencies = (observer: Observer): void => {\n const deps = observerDependencies.get(observer);\n if (deps) {\n for (const source of deps) {\n source.unsubscribe(observer);\n }\n deps.clear();\n }\n};\n","/**\n * Reactive effects.\n */\n\nimport { CleanupFn, Observer, track, clearDependencies } from './internals';\n\n/**\n * Creates a side effect that automatically re-runs when dependencies change.\n *\n * The effect runs immediately upon creation and then re-runs whenever\n * any signal or computed value read inside it changes.\n *\n * @param fn - The effect function to run\n * @returns A cleanup function to stop the effect\n */\nexport const effect = (fn: () => void | CleanupFn): CleanupFn => {\n let cleanupFn: CleanupFn | void;\n let isDisposed = false;\n\n const runCleanup = (): void => {\n if (cleanupFn) {\n try {\n cleanupFn();\n } catch (error) {\n console.error('bQuery reactive: Error in effect cleanup', error);\n }\n cleanupFn = undefined;\n }\n };\n\n const observer: Observer = () => {\n if (isDisposed) return;\n\n runCleanup();\n\n // Clear old dependencies before running to avoid stale subscriptions\n clearDependencies(observer);\n\n try {\n cleanupFn = track(observer, fn);\n } catch (error) {\n console.error('bQuery reactive: Error in effect', error);\n }\n };\n\n observer();\n\n return () => {\n isDisposed = true;\n runCleanup();\n // Clean up all dependencies when effect is disposed\n clearDependencies(observer);\n };\n};\n","/**\n * Core reactive signals.\n */\n\nimport {\n getCurrentObserver,\n registerDependency,\n removeDependency,\n scheduleObserver,\n type ReactiveSource,\n} from './internals';\n\n/**\n * A reactive value container that notifies subscribers on change.\n *\n * Signals are the foundational primitive of the reactive system.\n * Reading a signal's value inside an effect or computed automatically\n * establishes a reactive dependency.\n *\n * @template T - The type of the stored value\n */\nexport class Signal<T> implements ReactiveSource {\n private subscribers = new Set<() => void>();\n\n /**\n * Creates a new signal with an initial value.\n * @param _value - The initial value\n */\n constructor(private _value: T) {}\n\n /**\n * Gets the current value and tracks the read if inside an observer.\n * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.\n */\n get value(): T {\n const current = getCurrentObserver();\n if (current) {\n this.subscribers.add(current);\n registerDependency(current, this);\n }\n return this._value;\n }\n\n /**\n * Sets a new value and notifies all subscribers if the value changed.\n * Uses Object.is for equality comparison.\n */\n set value(next: T) {\n if (Object.is(this._value, next)) return;\n this._value = next;\n // Create snapshot to avoid issues with subscribers modifying the set during iteration\n const subscribersSnapshot = Array.from(this.subscribers);\n for (const subscriber of subscribersSnapshot) {\n scheduleObserver(subscriber);\n }\n }\n\n /**\n * Reads the current value without tracking.\n * Useful when you need the value but don't want to create a dependency.\n *\n * @returns The current value\n */\n peek(): T {\n return this._value;\n }\n\n /**\n * Updates the value using a function.\n * Useful for updates based on the current value.\n *\n * @param updater - Function that receives current value and returns new value\n */\n update(updater: (current: T) => T): void {\n this.value = updater(this._value);\n }\n\n /**\n * Removes all subscribers from this signal.\n * Use this when a signal is no longer needed to prevent memory leaks.\n *\n * @example\n * ```ts\n * const count = signal(0);\n * effect(() => console.log(count.value));\n * count.dispose(); // All subscribers removed\n * ```\n */\n dispose(): void {\n // Remove this signal from each subscriber's dependency set\n // so the observer no longer holds a strong reference to it\n for (const subscriber of this.subscribers) {\n removeDependency(subscriber, this);\n }\n this.subscribers.clear();\n }\n\n /**\n * Removes an observer from this signal's subscriber set.\n * @internal\n */\n unsubscribe(observer: () => void): void {\n this.subscribers.delete(observer);\n }\n}\n\n/**\n * Creates a new reactive signal.\n *\n * @template T - The type of the signal value\n * @param value - The initial value\n * @returns A new Signal instance\n */\nexport const signal = <T>(value: T): Signal<T> => new Signal(value);\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"platform-B7JhGBc7.js","names":[],"sources":["../src/platform/buckets.ts","../src/platform/cache.ts","../src/platform/cookies.ts","../src/platform/notifications.ts","../src/platform/announcer.ts","../src/platform/meta.ts","../src/platform/storage.ts"],"sourcesContent":["/**\n * Storage Buckets API wrapper.\n * Provides a simplified interface for storing blobs and binary data.\n * Falls back to IndexedDB when Storage Buckets API is not available.\n */\n\n/**\n * Bucket interface for blob storage operations.\n */\nexport interface Bucket {\n /**\n * Store a blob in the bucket.\n * @param key - Unique identifier for the blob\n * @param data - Blob data to store\n */\n put(key: string, data: Blob): Promise<void>;\n\n /**\n * Retrieve a blob from the bucket.\n * @param key - Blob identifier\n * @returns The stored blob or null if not found\n */\n get(key: string): Promise<Blob | null>;\n\n /**\n * Remove a blob from the bucket.\n * @param key - Blob identifier\n */\n remove(key: string): Promise<void>;\n\n /**\n * List all keys in the bucket.\n * @returns Array of blob keys\n */\n keys(): Promise<string[]>;\n}\n\n/**\n * IndexedDB-based bucket implementation.\n * Used as fallback when Storage Buckets API is unavailable.\n */\nclass IndexedDBBucket implements Bucket {\n private dbPromise: Promise<IDBDatabase> | null = null;\n private readonly storeName = 'blobs';\n\n constructor(private readonly bucketName: string) {}\n\n private openDB(): Promise<IDBDatabase> {\n if (this.dbPromise) return this.dbPromise;\n\n const dbName = `bquery-bucket-${this.bucketName}`;\n this.dbPromise = new Promise((resolve, reject) => {\n const request = indexedDB.open(dbName, 1);\n\n request.onupgradeneeded = () => {\n const db = request.result;\n if (!db.objectStoreNames.contains(this.storeName)) {\n db.createObjectStore(this.storeName);\n }\n };\n\n request.onsuccess = () => resolve(request.result);\n request.onerror = () => reject(request.error);\n });\n\n return this.dbPromise;\n }\n\n private async withStore<T>(\n mode: IDBTransactionMode,\n operation: (store: IDBObjectStore) => IDBRequest<T>\n ): Promise<T> {\n const db = await this.openDB();\n return new Promise((resolve, reject) => {\n const tx = db.transaction(this.storeName, mode);\n const store = tx.objectStore(this.storeName);\n const request = operation(store);\n request.onsuccess = () => resolve(request.result);\n request.onerror = () => reject(request.error);\n });\n }\n\n async put(key: string, data: Blob): Promise<void> {\n await this.withStore('readwrite', (store) => store.put(data, key));\n }\n\n async get(key: string): Promise<Blob | null> {\n const result = await this.withStore<Blob | undefined>('readonly', (store) => store.get(key));\n return result ?? null;\n }\n\n async remove(key: string): Promise<void> {\n await this.withStore('readwrite', (store) => store.delete(key));\n }\n\n async keys(): Promise<string[]> {\n const result = await this.withStore<IDBValidKey[]>('readonly', (store) => store.getAllKeys());\n return result.map((key) => String(key));\n }\n}\n\n/**\n * Bucket manager for creating and accessing storage buckets.\n */\nexport const buckets = {\n /**\n * Open or create a storage bucket.\n * @param name - Bucket name\n * @returns Bucket instance for blob operations\n */\n async open(name: string): Promise<Bucket> {\n // Storage Buckets API is experimental; use IndexedDB fallback\n return new IndexedDBBucket(name);\n },\n};\n","/**\n * Cache Storage API wrapper.\n * Provides a simplified interface for caching responses and assets.\n */\n\n/**\n * Cache handle interface for managing cached resources.\n */\nexport interface CacheHandle {\n /**\n * Add a resource to the cache by URL.\n * Fetches the resource and stores the response.\n * @param url - URL to fetch and cache\n */\n add(url: string): Promise<void>;\n\n /**\n * Add multiple resources to the cache.\n * @param urls - Array of URLs to fetch and cache\n */\n addAll(urls: string[]): Promise<void>;\n\n /**\n * Store a custom response in the cache.\n * @param url - URL key for the cached response\n * @param response - Response object to cache\n */\n put(url: string, response: Response): Promise<void>;\n\n /**\n * Retrieve a cached response.\n * @param url - URL to look up\n * @returns Cached Response or undefined if not found\n */\n match(url: string): Promise<Response | undefined>;\n\n /**\n * Remove a cached response.\n * @param url - URL to remove from cache\n * @returns True if the entry was deleted\n */\n remove(url: string): Promise<boolean>;\n\n /**\n * Get all cached request URLs.\n * @returns Array of cached URLs\n */\n keys(): Promise<string[]>;\n}\n\n/**\n * Internal cache handle implementation.\n */\nclass CacheHandleImpl implements CacheHandle {\n constructor(private readonly cache: Cache) {}\n\n async add(url: string): Promise<void> {\n await this.cache.add(url);\n }\n\n async addAll(urls: string[]): Promise<void> {\n await this.cache.addAll(urls);\n }\n\n async put(url: string, response: Response): Promise<void> {\n await this.cache.put(url, response);\n }\n\n async match(url: string): Promise<Response | undefined> {\n return this.cache.match(url);\n }\n\n async remove(url: string): Promise<boolean> {\n return this.cache.delete(url);\n }\n\n async keys(): Promise<string[]> {\n const requests = await this.cache.keys();\n return requests.map((req) => req.url);\n }\n}\n\n/**\n * Cache manager for accessing the Cache Storage API.\n */\nexport const cache = {\n /**\n * Check if Cache Storage API is supported.\n * @returns True if caches API is available\n */\n isSupported(): boolean {\n return 'caches' in window;\n },\n\n /**\n * Open or create a named cache.\n * @param name - Cache name\n * @returns CacheHandle for cache operations\n */\n async open(name: string): Promise<CacheHandle> {\n if (!this.isSupported()) {\n throw new Error('bQuery: Cache Storage API not supported');\n }\n const c = await caches.open(name);\n return new CacheHandleImpl(c);\n },\n\n /**\n * Delete a named cache.\n * @param name - Cache name to delete\n * @returns True if the cache was deleted\n */\n async delete(name: string): Promise<boolean> {\n if (!this.isSupported()) {\n return false;\n }\n return caches.delete(name);\n },\n\n /**\n * List all cache names.\n * @returns Array of cache names\n */\n async keys(): Promise<string[]> {\n if (!this.isSupported()) {\n return [];\n }\n return caches.keys();\n },\n};\n","/**\r\n * Reactive cookie helpers.\r\n *\r\n * @module bquery/platform\r\n */\r\n\r\nimport { effect, signal, type Signal } from '../reactive/signal';\r\nimport { getBqueryConfig } from './config';\r\n\r\n/** Options for useCookie(). */\r\nexport interface UseCookieOptions<T> {\r\n /** Default value when the cookie is not present. */\r\n defaultValue?: T;\r\n /** Cookie path. Defaults to the global config or `/`. */\r\n path?: string;\r\n /** Optional cookie domain. */\r\n domain?: string;\r\n /** Cookie SameSite attribute. */\r\n sameSite?: 'Strict' | 'Lax' | 'None';\r\n /** Whether the cookie should be marked secure. */\r\n secure?: boolean;\r\n /** Cookie expiry date. */\r\n expires?: Date;\r\n /** Cookie max-age in seconds. */\r\n maxAge?: number;\r\n /** Automatically persist signal updates back to document.cookie. */\r\n watch?: boolean;\r\n /** Serialize a value before writing it into the cookie. */\r\n serialize?: (value: T) => string;\r\n /** Deserialize a cookie string into a typed value. */\r\n deserialize?: (value: string) => T;\r\n}\r\n\r\nconst readCookie = (name: string): string | null => {\r\n if (typeof document === 'undefined') return null;\r\n\r\n const prefix = `${encodeURIComponent(name)}=`;\r\n const segments = document.cookie ? document.cookie.split(';') : [];\r\n\r\n for (const segment of segments) {\r\n const normalizedSegment = segment.trim();\r\n if (normalizedSegment.startsWith(prefix)) {\r\n const rawValue = normalizedSegment.slice(prefix.length);\r\n try {\r\n return decodeURIComponent(rawValue);\r\n } catch {\r\n return rawValue;\r\n }\r\n }\r\n }\r\n\r\n return null;\r\n};\r\n\r\nconst requiresJsonParsing = (value: string): boolean => {\r\n const normalized = value.trim();\r\n return normalized.startsWith('{') || normalized.startsWith('[') || normalized.startsWith('\"');\r\n};\r\n\r\nconst removeCookie = (\r\n name: string,\r\n options: Pick<UseCookieOptions<unknown>, 'path' | 'domain' | 'sameSite' | 'secure'>\r\n): void => {\r\n if (typeof document === 'undefined') return;\r\n\r\n const segments = [`${encodeURIComponent(name)}=`, 'Expires=Thu, 01 Jan 1970 00:00:00 GMT'];\r\n\r\n if (options.path) segments.push(`Path=${options.path}`);\r\n if (options.domain) segments.push(`Domain=${options.domain}`);\r\n if (options.sameSite) segments.push(`SameSite=${options.sameSite}`);\r\n if (options.secure) segments.push('Secure');\r\n\r\n document.cookie = segments.join('; ');\r\n};\r\n\r\nconst writeCookie = <T>(name: string, value: T, options: UseCookieOptions<T>): void => {\r\n if (typeof document === 'undefined') return;\r\n\r\n const serialized = options.serialize\r\n ? options.serialize(value)\r\n : typeof value === 'string'\r\n ? value\r\n : JSON.stringify(value);\r\n\r\n const segments = [`${encodeURIComponent(name)}=${encodeURIComponent(serialized)}`];\r\n\r\n if (options.path) segments.push(`Path=${options.path}`);\r\n if (options.domain) segments.push(`Domain=${options.domain}`);\r\n if (typeof options.maxAge === 'number') segments.push(`Max-Age=${options.maxAge}`);\r\n if (options.expires) segments.push(`Expires=${options.expires.toUTCString()}`);\r\n if (options.sameSite) segments.push(`SameSite=${options.sameSite}`);\r\n if (options.secure) segments.push('Secure');\r\n\r\n document.cookie = segments.join('; ');\r\n};\r\n\r\n/**\r\n * Create a reactive cookie signal.\r\n *\r\n * @template T - Cookie value type\r\n * @param name - Cookie name\r\n * @param options - Read/write configuration for the cookie\r\n * @returns Reactive signal representing the cookie value\r\n *\r\n * @example\r\n * ```ts\r\n * const theme = useCookie('theme', { defaultValue: 'light' });\r\n * theme.value = 'dark';\r\n * ```\r\n */\r\nexport const useCookie = <T>(name: string, options: UseCookieOptions<T> = {}): Signal<T | null> => {\r\n const cookieConfig = getBqueryConfig().cookies;\r\n const resolvedOptions: UseCookieOptions<T> = {\r\n path: cookieConfig?.path ?? '/',\r\n sameSite: cookieConfig?.sameSite ?? 'Lax',\r\n secure: cookieConfig?.secure ?? false,\r\n watch: true,\r\n ...options,\r\n };\r\n\r\n if (resolvedOptions.sameSite === 'None') {\r\n resolvedOptions.secure = true;\r\n }\r\n\r\n const raw = readCookie(name);\r\n let initialValue = (resolvedOptions.defaultValue ?? null) as T | null;\r\n\r\n if (raw !== null) {\r\n try {\r\n initialValue = resolvedOptions.deserialize\r\n ? resolvedOptions.deserialize(raw)\r\n : requiresJsonParsing(raw)\r\n ? (JSON.parse(raw) as T)\r\n : ((raw as T) ?? initialValue);\r\n } catch (error) {\r\n console.warn(`bQuery: Failed to deserialize cookie \"${name}\", using raw string value`, error);\r\n initialValue = (raw as T) ?? initialValue;\r\n }\r\n }\r\n\r\n const cookie = signal<T | null>(initialValue);\r\n\r\n if (typeof document === 'undefined' || resolvedOptions.watch === false) {\r\n return cookie;\r\n }\r\n\r\n let initialized = false;\r\n effect(() => {\r\n const nextValue = cookie.value;\r\n\r\n if (!initialized) {\r\n initialized = true;\r\n return;\r\n }\r\n\r\n if (nextValue == null) {\r\n removeCookie(name, resolvedOptions);\r\n return;\r\n }\r\n\r\n writeCookie(name, nextValue, resolvedOptions);\r\n });\r\n\r\n return cookie;\r\n};\r\n","/**\n * Web Notifications API wrapper.\n * Provides a simplified interface for browser notifications.\n */\n\n/**\n * Notification options matching the standard NotificationOptions interface.\n */\nexport interface NotificationOptions {\n /** Body text of the notification */\n body?: string;\n /** Icon URL for the notification */\n icon?: string;\n /** Badge icon for mobile devices */\n badge?: string;\n /** Tag for grouping notifications */\n tag?: string;\n /** Whether to require user interaction */\n requireInteraction?: boolean;\n /** Vibration pattern for mobile devices */\n vibrate?: number[];\n /** Additional data attached to the notification */\n data?: unknown;\n}\n\n/**\n * Notifications manager providing a clean interface for web notifications.\n */\nexport const notifications = {\n /**\n * Check if notifications are supported.\n * @returns True if Notification API is available\n */\n isSupported(): boolean {\n return 'Notification' in window;\n },\n\n /**\n * Get current permission status.\n * @returns Current permission state\n */\n getPermission(): NotificationPermission {\n if (!this.isSupported()) return 'denied';\n return Notification.permission;\n },\n\n /**\n * Request notification permission from the user.\n * @returns Promise resolving to the permission result\n */\n async requestPermission(): Promise<NotificationPermission> {\n if (!this.isSupported()) {\n return 'denied';\n }\n\n if (Notification.permission === 'granted') {\n return 'granted';\n }\n\n if (Notification.permission === 'denied') {\n return 'denied';\n }\n\n return Notification.requestPermission();\n },\n\n /**\n * Send a notification.\n * Requires 'granted' permission.\n * @param title - Notification title\n * @param options - Optional notification settings\n * @returns The Notification instance or null if not permitted\n */\n send(title: string, options?: NotificationOptions): Notification | null {\n if (!this.isSupported()) {\n console.warn('bQuery: Notifications not supported in this browser');\n return null;\n }\n\n if (Notification.permission !== 'granted') {\n console.warn('bQuery: Notification permission not granted');\n return null;\n }\n\n return new Notification(title, options);\n },\n};\n","/**\r\n * Accessibility live-region announcer helpers.\r\n *\r\n * @module bquery/platform\r\n */\r\n\r\nimport { effect, signal, type Signal } from '../reactive/signal';\r\nimport { getBqueryConfig } from './config';\r\n\r\n/** Options for creating an announcer. */\r\nexport interface UseAnnouncerOptions {\r\n /** Live region politeness. */\r\n politeness?: 'polite' | 'assertive';\r\n /** Whether the live region should be atomic. */\r\n atomic?: boolean;\r\n /** Delay before applying the message. */\r\n delay?: number;\r\n /** Delay after which the message is cleared automatically. */\r\n clearDelay?: number;\r\n /** Optional element id for the live region. */\r\n id?: string;\r\n /** Optional CSS class name. */\r\n className?: string;\r\n /** Optional container used to append the live region. */\r\n container?: HTMLElement;\r\n}\r\n\r\n/** Runtime options for a single announcement. */\r\nexport interface AnnounceOptions {\r\n /** Override politeness for this specific announcement. */\r\n politeness?: 'polite' | 'assertive';\r\n /** Override the message delay for this specific announcement. */\r\n delay?: number;\r\n /** Override the auto-clear delay for this specific announcement. */\r\n clearDelay?: number;\r\n}\r\n\r\n/** Returned announcer API. */\r\nexport interface AnnouncerHandle {\r\n /** The live region element or null outside the DOM. */\r\n element: HTMLElement | null;\r\n /** Reactive message signal. */\r\n message: Signal<string>;\r\n /** Announce a message to assistive technologies. */\r\n announce: (value: string, options?: AnnounceOptions) => void;\r\n /** Clear the current announcement. */\r\n clear: () => void;\r\n /** Remove the live region if it was created by this announcer. */\r\n destroy: () => void;\r\n}\r\n\r\nconst visuallyHiddenStyle = [\r\n 'position:absolute',\r\n 'width:1px',\r\n 'height:1px',\r\n 'padding:0',\r\n 'margin:-1px',\r\n 'overflow:hidden',\r\n 'clip:rect(0, 0, 0, 0)',\r\n 'white-space:nowrap',\r\n 'border:0',\r\n].join(';');\r\n\r\n/**\r\n * Create or reuse an accessible live region.\r\n *\r\n * @param options - Live region configuration\r\n * @returns An announcer handle with announce(), clear(), and destroy()\r\n *\r\n * @example\r\n * ```ts\r\n * const announcer = useAnnouncer();\r\n * announcer.announce('Saved successfully');\r\n * ```\r\n */\r\nexport const useAnnouncer = (options: UseAnnouncerOptions = {}): AnnouncerHandle => {\r\n const defaults = getBqueryConfig().announcer;\r\n const resolvedOptions: Required<\r\n Pick<UseAnnouncerOptions, 'politeness' | 'atomic' | 'delay' | 'clearDelay'>\r\n > &\r\n UseAnnouncerOptions = {\r\n politeness: defaults?.politeness ?? 'polite',\r\n atomic: defaults?.atomic ?? true,\r\n delay: defaults?.delay ?? 16,\r\n clearDelay: defaults?.clearDelay ?? 1000,\r\n ...options,\r\n };\r\n\r\n const message = signal('');\r\n\r\n if (typeof document === 'undefined') {\r\n return {\r\n element: null,\r\n message,\r\n announce(value: string) {\r\n message.value = value;\r\n },\r\n clear() {\r\n message.value = '';\r\n },\r\n destroy() {\r\n message.value = '';\r\n },\r\n };\r\n }\r\n\r\n const existing = resolvedOptions.id ? document.getElementById(resolvedOptions.id) : null;\r\n const element = (existing ?? document.createElement('div')) as HTMLElement;\r\n const created = !existing;\r\n\r\n if (resolvedOptions.id) {\r\n element.id = resolvedOptions.id;\r\n }\r\n\r\n if (resolvedOptions.className) {\r\n element.className = resolvedOptions.className;\r\n }\r\n\r\n element.setAttribute('aria-live', resolvedOptions.politeness);\r\n element.setAttribute('aria-atomic', String(resolvedOptions.atomic));\r\n element.setAttribute('role', resolvedOptions.politeness === 'assertive' ? 'alert' : 'status');\r\n element.setAttribute('data-bquery-announcer', 'true');\r\n if (!element.getAttribute('style')) {\r\n element.setAttribute('style', visuallyHiddenStyle);\r\n }\r\n\r\n if (created) {\r\n const parent = resolvedOptions.container ?? document.body ?? document.documentElement;\r\n if (!parent) {\r\n return {\r\n element: null,\r\n message,\r\n announce(value: string) {\r\n message.value = value;\r\n },\r\n clear() {\r\n message.value = '';\r\n },\r\n destroy() {\r\n message.value = '';\r\n },\r\n };\r\n }\r\n parent.appendChild(element);\r\n }\r\n\r\n const disposeMessageEffect = effect(() => {\r\n element.textContent = message.value;\r\n });\r\n\r\n let messageTimer: ReturnType<typeof setTimeout> | undefined;\r\n let clearTimer: ReturnType<typeof setTimeout> | undefined;\r\n let destroyed = false;\r\n\r\n const clearTimers = (): void => {\r\n if (messageTimer) {\r\n clearTimeout(messageTimer);\r\n messageTimer = undefined;\r\n }\r\n if (clearTimer) {\r\n clearTimeout(clearTimer);\r\n clearTimer = undefined;\r\n }\r\n };\r\n\r\n const clear = (): void => {\r\n if (destroyed) return;\r\n clearTimers();\r\n message.value = '';\r\n };\r\n\r\n const announce = (value: string, announceOptions: AnnounceOptions = {}): void => {\r\n if (destroyed) return;\r\n const politeness = announceOptions.politeness ?? resolvedOptions.politeness;\r\n const delay = announceOptions.delay ?? resolvedOptions.delay;\r\n const clearDelay = announceOptions.clearDelay ?? resolvedOptions.clearDelay;\r\n\r\n clearTimers();\r\n\r\n element.setAttribute('aria-live', politeness);\r\n element.setAttribute('role', politeness === 'assertive' ? 'alert' : 'status');\r\n message.value = '';\r\n\r\n messageTimer = setTimeout(() => {\r\n if (destroyed) return;\r\n message.value = value;\r\n if (clearDelay > 0) {\r\n clearTimer = setTimeout(() => {\r\n if (destroyed) return;\r\n message.value = '';\r\n }, clearDelay);\r\n }\r\n }, delay);\r\n };\r\n\r\n const destroy = (): void => {\r\n if (destroyed) return;\r\n destroyed = true;\r\n clearTimers();\r\n message.value = '';\r\n disposeMessageEffect();\r\n if (created) {\r\n element.remove();\r\n }\r\n };\r\n\r\n return { element, message, announce, clear, destroy };\r\n};\r\n","/**\r\n * Document title and meta helpers.\r\n *\r\n * @module bquery/platform\r\n */\r\n\r\nimport { getBqueryConfig } from './config';\r\n\r\n/** Meta tag definition. */\r\nexport interface PageMetaTag {\r\n /** Standard meta name attribute. */\r\n name?: string;\r\n /** Open Graph / custom property attribute. */\r\n property?: string;\r\n /** http-equiv attribute. */\r\n httpEquiv?: string;\r\n /** Meta tag content. */\r\n content: string;\r\n}\r\n\r\n/** Link tag definition. */\r\nexport interface PageLinkTag {\r\n /** Link relation. */\r\n rel: string;\r\n /** Link URL. */\r\n href: string;\r\n /** Optional type attribute. */\r\n type?: string;\r\n /** Optional media query. */\r\n media?: string;\r\n /** Optional crossOrigin attribute. */\r\n crossOrigin?: 'anonymous' | 'use-credentials';\r\n}\r\n\r\n/** Page metadata definition. */\r\nexport interface PageMetaDefinition {\r\n /** Document title. */\r\n title?: string;\r\n /** Convenience shortcut for the description meta tag. */\r\n description?: string;\r\n /** Additional meta tags. */\r\n meta?: PageMetaTag[];\r\n /** Additional link tags. */\r\n link?: PageLinkTag[];\r\n /** Attributes applied to the html element. */\r\n htmlAttributes?: Record<string, string>;\r\n /** Attributes applied to the body element. */\r\n bodyAttributes?: Record<string, string>;\r\n}\r\n\r\n/** Cleanup function returned by definePageMeta(). */\r\nexport type PageMetaCleanup = () => void;\r\n\r\nconst setAttributes = (target: HTMLElement, attributes: Record<string, string>): (() => void) => {\r\n const previousValues = new Map<string, string | null>();\r\n\r\n for (const [name, value] of Object.entries(attributes)) {\r\n previousValues.set(name, target.getAttribute(name));\r\n target.setAttribute(name, value);\r\n }\r\n\r\n return () => {\r\n for (const [name, value] of previousValues.entries()) {\r\n if (value == null) {\r\n target.removeAttribute(name);\r\n } else {\r\n target.setAttribute(name, value);\r\n }\r\n }\r\n };\r\n};\r\n\r\nconst createElement = <T extends 'meta' | 'link'>(\r\n tagName: T,\r\n attributes: Record<string, string | undefined>\r\n): HTMLElementTagNameMap[T] => {\r\n const element = document.createElement(tagName);\r\n element.setAttribute('data-bquery-page-meta', 'true');\r\n\r\n for (const [name, value] of Object.entries(attributes)) {\r\n if (value !== undefined) {\r\n element.setAttribute(name, value);\r\n }\r\n }\r\n\r\n return element;\r\n};\r\n\r\n/**\r\n * Apply document metadata for the current page.\r\n *\r\n * @param definition - Title, meta tags, link tags, and document attributes\r\n * @returns Cleanup function that restores the previous document state\r\n *\r\n * @example\r\n * ```ts\r\n * const cleanup = definePageMeta({\r\n * title: 'Dashboard',\r\n * description: 'Overview of your account',\r\n * });\r\n * ```\r\n */\r\nexport const definePageMeta = (definition: PageMetaDefinition): PageMetaCleanup => {\r\n if (typeof document === 'undefined') {\r\n return () => {};\r\n }\r\n\r\n const config = getBqueryConfig().pageMeta;\r\n const title = definition.title\r\n ? config?.titleTemplate\r\n ? config.titleTemplate(definition.title)\r\n : definition.title\r\n : undefined;\r\n\r\n const inserted: HTMLElement[] = [];\r\n const restoreFns: Array<() => void> = [];\r\n const previousTitle = document.title;\r\n\r\n if (title !== undefined) {\r\n document.title = title;\r\n }\r\n\r\n const metaEntries = [...(definition.meta ?? [])];\r\n if (definition.description) {\r\n metaEntries.unshift({ name: 'description', content: definition.description });\r\n }\r\n\r\n for (const entry of metaEntries) {\r\n const meta = createElement('meta', {\r\n name: entry.name,\r\n property: entry.property,\r\n 'http-equiv': entry.httpEquiv,\r\n content: entry.content,\r\n });\r\n document.head.appendChild(meta);\r\n inserted.push(meta);\r\n }\r\n\r\n for (const entry of definition.link ?? []) {\r\n const link = createElement('link', {\r\n rel: entry.rel,\r\n href: entry.href,\r\n type: entry.type,\r\n media: entry.media,\r\n crossorigin: entry.crossOrigin,\r\n });\r\n document.head.appendChild(link);\r\n inserted.push(link);\r\n }\r\n\r\n if (definition.htmlAttributes) {\r\n restoreFns.push(setAttributes(document.documentElement, definition.htmlAttributes));\r\n }\r\n\r\n if (definition.bodyAttributes && document.body) {\r\n restoreFns.push(setAttributes(document.body, definition.bodyAttributes));\r\n }\r\n\r\n return () => {\r\n document.title = previousTitle;\r\n for (const restore of restoreFns.reverse()) {\r\n restore();\r\n }\r\n for (const element of inserted) {\r\n element.remove();\r\n }\r\n };\r\n};\r\n","/**\n * Unified storage adapters for web platform storage APIs.\n * Provides a consistent, promise-based interface with predictable errors.\n */\n\n/**\n * Common interface for all storage adapters.\n * All methods return promises for a unified async API.\n */\nexport interface StorageAdapter {\n /**\n * Retrieve a value by key.\n * @param key - The storage key\n * @returns The stored value or null if not found\n */\n get<T>(key: string): Promise<T | null>;\n\n /**\n * Store a value by key.\n * @param key - The storage key\n * @param value - The value to store\n */\n set<T>(key: string, value: T): Promise<void>;\n\n /**\n * Remove a value by key.\n * @param key - The storage key\n */\n remove(key: string): Promise<void>;\n\n /**\n * Clear all stored values.\n */\n clear(): Promise<void>;\n\n /**\n * Get all storage keys.\n * @returns Array of all keys\n */\n keys(): Promise<string[]>;\n}\n\n/**\n * Abstract base class for web storage adapters (localStorage/sessionStorage).\n * Implements DRY principle by sharing common logic.\n */\nabstract class WebStorageAdapter implements StorageAdapter {\n constructor(protected readonly storage: Storage) {}\n\n async get<T>(key: string): Promise<T | null> {\n const raw = this.storage.getItem(key);\n if (raw === null) return null;\n try {\n return JSON.parse(raw) as T;\n } catch {\n return raw as unknown as T;\n }\n }\n\n async set<T>(key: string, value: T): Promise<void> {\n const serialized = typeof value === 'string' ? value : JSON.stringify(value);\n this.storage.setItem(key, serialized);\n }\n\n async remove(key: string): Promise<void> {\n this.storage.removeItem(key);\n }\n\n async clear(): Promise<void> {\n this.storage.clear();\n }\n\n async keys(): Promise<string[]> {\n const result: string[] = [];\n for (let i = 0; i < this.storage.length; i++) {\n const key = this.storage.key(i);\n if (key !== null) {\n result.push(key);\n }\n }\n return result;\n }\n}\n\n/**\n * localStorage adapter with async interface.\n */\nclass LocalStorageAdapter extends WebStorageAdapter {\n constructor() {\n super(localStorage);\n }\n}\n\n/**\n * sessionStorage adapter with async interface.\n */\nclass SessionStorageAdapter extends WebStorageAdapter {\n constructor() {\n super(sessionStorage);\n }\n}\n\n/**\n * IndexedDB configuration options.\n */\nexport interface IndexedDBOptions {\n /** Database name */\n name: string;\n /** Object store name */\n store: string;\n /** Database version (optional) */\n version?: number;\n}\n\n/**\n * IndexedDB key-value adapter.\n * Wraps IndexedDB with a simple key-value interface.\n */\nclass IndexedDBAdapter implements StorageAdapter {\n private dbPromise: Promise<IDBDatabase> | null = null;\n\n constructor(private readonly options: IndexedDBOptions) {}\n\n /**\n * Opens or creates the IndexedDB database.\n */\n private openDB(): Promise<IDBDatabase> {\n if (this.dbPromise) return this.dbPromise;\n\n this.dbPromise = new Promise((resolve, reject) => {\n const request = indexedDB.open(this.options.name, this.options.version ?? 1);\n\n request.onupgradeneeded = () => {\n const db = request.result;\n if (!db.objectStoreNames.contains(this.options.store)) {\n db.createObjectStore(this.options.store);\n }\n };\n\n request.onsuccess = () => resolve(request.result);\n request.onerror = () => reject(request.error);\n });\n\n return this.dbPromise;\n }\n\n /**\n * Executes a transaction on the object store.\n */\n private async withStore<T>(\n mode: IDBTransactionMode,\n operation: (store: IDBObjectStore) => IDBRequest<T>\n ): Promise<T> {\n const db = await this.openDB();\n return new Promise((resolve, reject) => {\n const tx = db.transaction(this.options.store, mode);\n const store = tx.objectStore(this.options.store);\n const request = operation(store);\n request.onsuccess = () => resolve(request.result);\n request.onerror = () => reject(request.error);\n });\n }\n\n async get<T>(key: string): Promise<T | null> {\n const result = await this.withStore<T | undefined>('readonly', (store) => store.get(key));\n return result ?? null;\n }\n\n async set<T>(key: string, value: T): Promise<void> {\n await this.withStore('readwrite', (store) => store.put(value, key));\n }\n\n async remove(key: string): Promise<void> {\n await this.withStore('readwrite', (store) => store.delete(key));\n }\n\n async clear(): Promise<void> {\n await this.withStore('readwrite', (store) => store.clear());\n }\n\n async keys(): Promise<string[]> {\n const result = await this.withStore<IDBValidKey[]>('readonly', (store) => store.getAllKeys());\n return result.map((key) => String(key));\n }\n}\n\n/**\n * Storage factory providing access to different storage adapters.\n */\nexport const storage = {\n /**\n * Create a localStorage adapter.\n * @returns StorageAdapter wrapping localStorage\n */\n local(): StorageAdapter {\n return new LocalStorageAdapter();\n },\n\n /**\n * Create a sessionStorage adapter.\n * @returns StorageAdapter wrapping sessionStorage\n */\n session(): StorageAdapter {\n return new SessionStorageAdapter();\n },\n\n /**\n * Create an IndexedDB adapter with key-value interface.\n * @param options - Database and store configuration\n * @returns StorageAdapter wrapping IndexedDB\n */\n indexedDB(options: IndexedDBOptions): StorageAdapter {\n return new IndexedDBAdapter(options);\n },\n};\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"reactive-BDya-ia8.js","names":[],"sources":["../src/reactive/batch.ts","../src/reactive/computed.ts","../src/reactive/untrack.ts","../src/reactive/async-data.ts","../src/reactive/linked.ts","../src/reactive/persisted.ts","../src/reactive/readonly.ts","../src/reactive/type-guards.ts","../src/reactive/watch.ts"],"sourcesContent":["/**\n * Batched reactive updates.\n */\n\nimport { beginBatch, endBatch } from './internals';\n\n/**\n * Batches multiple signal updates into a single notification cycle.\n *\n * Updates made inside the batch function are deferred until the batch\n * completes, preventing intermediate re-renders and improving performance.\n *\n * @param fn - Function containing multiple signal updates\n */\nexport const batch = (fn: () => void): void => {\n beginBatch();\n try {\n fn();\n } finally {\n endBatch();\n }\n};\n","/**\n * Computed reactive values.\n */\n\nimport {\n clearDependencies,\n getCurrentObserver,\n registerDependency,\n scheduleObserver,\n track,\n type ReactiveSource,\n} from './internals';\n\n/**\n * A computed value that derives from other reactive sources.\n *\n * Computed values are lazily evaluated and cached. They only\n * recompute when their dependencies change.\n *\n * @template T - The type of the computed value\n */\nexport class Computed<T> implements ReactiveSource {\n private cachedValue!: T;\n private dirty = true;\n private subscribers = new Set<() => void>();\n private readonly markDirty = () => {\n this.dirty = true;\n // Create snapshot to avoid issues with subscribers modifying the set during iteration\n const subscribersSnapshot = Array.from(this.subscribers);\n for (const subscriber of subscribersSnapshot) {\n scheduleObserver(subscriber);\n }\n };\n\n /**\n * Creates a new computed value.\n * @param compute - Function that computes the value\n */\n constructor(private readonly compute: () => T) {}\n\n /**\n * Gets the computed value, recomputing if dependencies changed.\n * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.\n */\n get value(): T {\n const current = getCurrentObserver();\n if (current) {\n this.subscribers.add(current);\n registerDependency(current, this);\n }\n if (this.dirty) {\n this.dirty = false;\n // Clear old dependencies before recomputing\n clearDependencies(this.markDirty);\n this.cachedValue = track(this.markDirty, this.compute);\n }\n return this.cachedValue;\n }\n\n /**\n * Reads the current computed value without tracking.\n * Useful when you need the value but don't want to create a dependency.\n *\n * @returns The current cached value (recomputes if dirty)\n */\n peek(): T {\n if (this.dirty) {\n this.dirty = false;\n // Clear old dependencies before recomputing\n clearDependencies(this.markDirty);\n this.cachedValue = track(this.markDirty, this.compute);\n }\n return this.cachedValue;\n }\n\n /**\n * Removes an observer from this computed's subscriber set.\n * @internal\n */\n unsubscribe(observer: () => void): void {\n this.subscribers.delete(observer);\n }\n}\n\n/**\n * Creates a new computed value.\n *\n * @template T - The type of the computed value\n * @param fn - Function that computes the value from reactive sources\n * @returns A new Computed instance\n */\nexport const computed = <T>(fn: () => T): Computed<T> => new Computed(fn);\n","/**\n * Dependency tracking control helpers.\n */\n\nimport { withoutCurrentObserver } from './internals';\n\n/**\n * Executes a function without tracking any signal dependencies.\n * Useful when reading a signal value without creating a reactive dependency.\n *\n * This implementation temporarily hides the current observer rather than\n * disabling tracking globally. This ensures that nested reactive internals\n * (e.g., computed recomputation triggered during untrack) can still properly\n * track their own dependencies.\n *\n * @template T - The return type of the function\n * @param fn - The function to execute without tracking\n * @returns The result of the function\n *\n * @example\n * ```ts\n * const count = signal(0);\n * effect(() => {\n * // This read creates a dependency\n * console.log(count.value);\n * // This read does not create a dependency\n * const snapshot = untrack(() => count.value);\n * });\n * ```\n */\nexport const untrack = <T>(fn: () => T): T => withoutCurrentObserver(fn);\n","/**\r\n * Async data and fetch composables built on bQuery signals.\r\n *\r\n * @module bquery/reactive\r\n */\r\n\r\nimport { merge } from '../core/utils/object';\r\nimport { getBqueryConfig, type BqueryFetchParseAs } from '../platform/config';\r\nimport { computed } from './computed';\r\nimport { effect } from './effect';\r\nimport { Signal, signal } from './core';\r\nimport { untrack } from './untrack';\r\n\r\n/** Allowed status values for async composables. */\r\nexport type AsyncDataStatus = 'idle' | 'pending' | 'success' | 'error';\r\n\r\n/** Reactive source types that can trigger refreshes. */\r\nexport type AsyncWatchSource = (() => unknown) | { value: unknown };\r\n\r\n/** Options shared by async composables. */\r\nexport interface UseAsyncDataOptions<TResult, TData = TResult> {\r\n /** Run the handler immediately (default: true). */\r\n immediate?: boolean;\r\n /** Default data value before the first successful execution. */\r\n defaultValue?: TData;\r\n /** Optional reactive sources that trigger refreshes when they change. */\r\n watch?: AsyncWatchSource[];\r\n /** Transform the resolved value before storing it. */\r\n transform?: (value: TResult) => TData;\r\n /** Called after a successful execution. */\r\n onSuccess?: (value: TData) => void;\r\n /** Called after a failed execution. */\r\n onError?: (error: Error) => void;\r\n}\r\n\r\n/** Return value of useAsyncData() and useFetch(). */\r\nexport interface AsyncDataState<TData> {\r\n /** Reactive data signal. */\r\n data: Signal<TData | undefined>;\r\n /** Last error encountered by the composable. */\r\n error: Signal<Error | null>;\r\n /** Current lifecycle status. */\r\n status: Signal<AsyncDataStatus>;\r\n /** Computed boolean that mirrors `status === 'pending'`. */\r\n pending: { readonly value: boolean; peek(): boolean };\r\n /** Execute the handler manually. Returns the cached data value when called after dispose(). */\r\n execute: () => Promise<TData | undefined>;\r\n /** Alias for execute(). */\r\n refresh: () => Promise<TData | undefined>;\r\n /** Clear data, error, and status back to the initial state. */\r\n clear: () => void;\r\n /** Dispose reactive watchers and prevent future executions. */\r\n dispose: () => void;\r\n}\r\n\r\n/** Options for useFetch(). */\r\nexport interface UseFetchOptions<TResponse = unknown, TData = TResponse>\r\n extends UseAsyncDataOptions<TResponse, TData>, Omit<RequestInit, 'body' | 'headers'> {\r\n /** Base URL prepended to relative URLs. */\r\n baseUrl?: string;\r\n /** Query parameters appended to the request URL. */\r\n query?: Record<string, unknown>;\r\n /** Request headers. */\r\n headers?: HeadersInit;\r\n /** Request body, including plain objects for JSON requests. */\r\n body?: BodyInit | Record<string, unknown> | unknown[] | null;\r\n /** Override the parser used for the response body. */\r\n parseAs?: BqueryFetchParseAs;\r\n /** Custom fetch implementation for testing or adapters. */\r\n fetcher?: typeof fetch;\r\n}\r\n\r\n/** Input accepted by useFetch(). */\r\nexport type FetchInput = string | URL | Request | (() => string | URL | Request);\r\n\r\nconst normalizeError = (error: unknown): Error => {\r\n if (error instanceof Error) return error;\r\n if (typeof error === 'string') {\r\n return new Error(error);\r\n }\r\n\r\n try {\r\n return new Error(JSON.stringify(error));\r\n } catch {\r\n return new Error(String(error));\r\n }\r\n};\r\n\r\nconst readWatchSource = (source: AsyncWatchSource): unknown => {\r\n if (typeof source === 'function') {\r\n return source();\r\n }\r\n return source.value;\r\n};\r\n\r\nconst toHeaders = (...sources: Array<HeadersInit | undefined>): Headers => {\r\n const headers = new Headers();\r\n for (const source of sources) {\r\n if (!source) continue;\r\n new Headers(source).forEach((value, key) => {\r\n headers.set(key, value);\r\n });\r\n }\r\n return headers;\r\n};\r\n\r\nconst isBodyLike = (value: unknown): value is BodyInit => {\r\n if (typeof value === 'string') return true;\r\n if (value instanceof Blob || value instanceof FormData || value instanceof URLSearchParams) {\r\n return true;\r\n }\r\n if (typeof ArrayBuffer !== 'undefined' && value instanceof ArrayBuffer) return true;\r\n if (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream) return true;\r\n return typeof value === 'object' && value !== null && ArrayBuffer.isView(value);\r\n};\r\n\r\nconst serializeBody = (\r\n body: UseFetchOptions['body'],\r\n headers: Headers\r\n): BodyInit | null | undefined => {\r\n if (body == null) return body;\r\n if (isBodyLike(body)) return body;\r\n\r\n if (!headers.has('content-type')) {\r\n headers.set('content-type', 'application/json');\r\n }\r\n\r\n return JSON.stringify(body);\r\n};\r\n\r\nconst resolveInput = (input: FetchInput): string | URL | Request => {\r\n return typeof input === 'function' ? input() : input;\r\n};\r\n\r\nconst appendQuery = (url: URL, query: Record<string, unknown>): void => {\r\n for (const [key, value] of Object.entries(query)) {\r\n if (value == null) continue;\r\n\r\n if (Array.isArray(value)) {\r\n for (const item of value) {\r\n if (item != null) {\r\n url.searchParams.append(key, String(item));\r\n }\r\n }\r\n continue;\r\n }\r\n\r\n url.searchParams.set(key, String(value));\r\n }\r\n};\r\n\r\nconst toUrl = (input: string | URL, baseUrl?: string): URL => {\r\n const runtimeBase =\r\n typeof window !== 'undefined' && /^https?:/i.test(window.location.href)\r\n ? window.location.href\r\n : 'http://localhost';\r\n const base = baseUrl ? new URL(baseUrl, runtimeBase).toString() : runtimeBase;\r\n return input instanceof URL ? new URL(input.toString(), base) : new URL(input, base);\r\n};\r\n\r\nconst parseResponse = async <TResponse>(\r\n response: Response,\r\n parseAs: BqueryFetchParseAs\r\n): Promise<TResponse> => {\r\n if (parseAs === 'response') return response as TResponse;\r\n if (parseAs === 'text') return (await response.text()) as TResponse;\r\n if (parseAs === 'blob') return (await response.blob()) as TResponse;\r\n if (parseAs === 'arrayBuffer') return (await response.arrayBuffer()) as TResponse;\r\n if (parseAs === 'formData') return (await response.formData()) as TResponse;\r\n\r\n const text = await response.text();\r\n if (!text) {\r\n return undefined as TResponse;\r\n }\r\n\r\n try {\r\n return JSON.parse(text) as TResponse;\r\n } catch (error) {\r\n const detail = response.url ? ` for ${response.url}` : '';\r\n throw new Error(\r\n `Failed to parse JSON response${detail} (status ${response.status}): ${error instanceof Error ? error.message : String(error)}`\r\n );\r\n }\r\n};\r\n\r\nconst normalizeMethod = (method?: string): string | undefined => {\r\n const normalized = method?.trim();\r\n return normalized ? normalized.toUpperCase() : undefined;\r\n};\r\n\r\nconst resolveMethod = (\r\n explicitMethod: string | undefined,\r\n requestInput: string | URL | Request,\r\n bodyProvided: boolean\r\n): string | undefined => {\r\n const requestMethod =\r\n requestInput instanceof Request ? normalizeMethod(requestInput.method) : undefined;\r\n return explicitMethod ?? requestMethod ?? (bodyProvided ? 'POST' : undefined);\r\n};\r\n\r\nconst resolveRequestInitMethod = (\r\n explicitMethod: string | undefined,\r\n requestInput: string | URL | Request,\r\n method: string | undefined\r\n): string | undefined => {\r\n if (explicitMethod) return explicitMethod;\r\n return requestInput instanceof Request ? undefined : method;\r\n};\r\n\r\nconst toRequestInit = (request: Request): RequestInit => {\r\n const requestMethod = normalizeMethod(request.method);\r\n let body: BodyInit | undefined;\r\n if (requestMethod !== 'GET' && requestMethod !== 'HEAD' && !request.bodyUsed) {\r\n try {\r\n body = request.clone().body ?? undefined;\r\n } catch {\r\n body = undefined;\r\n }\r\n }\r\n\r\n return {\r\n method: requestMethod,\r\n headers: request.headers,\r\n body,\r\n cache: request.cache,\r\n credentials: request.credentials,\r\n integrity: request.integrity,\r\n keepalive: request.keepalive,\r\n mode: request.mode,\r\n redirect: request.redirect,\r\n referrer: request.referrer,\r\n referrerPolicy: request.referrerPolicy,\r\n signal: request.signal,\r\n };\r\n};\r\n\r\n/**\r\n * Create a reactive wrapper around an async resolver.\r\n *\r\n * @template TResult - Raw result type returned by the handler\r\n * @template TData - Stored data type after optional transformation\r\n * @param handler - Async function to execute\r\n * @param options - Execution, transform, and refresh options\r\n * @returns Reactive data state with execute(), refresh(), and clear()\r\n *\r\n * @example\r\n * ```ts\r\n * const user = useAsyncData(() => fetch('/api/user').then((res) => res.json()));\r\n * ```\r\n */\r\nexport const useAsyncData = <TResult, TData = TResult>(\r\n handler: () => Promise<TResult>,\r\n options: UseAsyncDataOptions<TResult, TData> = {}\r\n): AsyncDataState<TData> => {\r\n const immediate = options.immediate ?? true;\r\n const data = signal<TData | undefined>(options.defaultValue);\r\n const error = signal<Error | null>(null);\r\n const status = signal<AsyncDataStatus>('idle');\r\n const pending = computed(() => status.value === 'pending');\r\n let executionId = 0;\r\n let disposed = false;\r\n let stopWatching = (): void => {};\r\n\r\n const clear = (): void => {\r\n executionId += 1;\r\n data.value = options.defaultValue;\r\n error.value = null;\r\n status.value = 'idle';\r\n };\r\n\r\n const dispose = (): void => {\r\n if (disposed) return;\r\n disposed = true;\r\n executionId += 1;\r\n stopWatching();\r\n };\r\n\r\n const execute = async (): Promise<TData | undefined> => {\r\n if (disposed) {\r\n return data.peek();\r\n }\r\n\r\n const currentExecution = ++executionId;\r\n status.value = 'pending';\r\n error.value = null;\r\n\r\n try {\r\n const resolved = await handler();\r\n const transformed = options.transform\r\n ? options.transform(resolved)\r\n : (resolved as unknown as TData);\r\n\r\n if (disposed || currentExecution !== executionId) {\r\n return data.peek();\r\n }\r\n\r\n data.value = transformed;\r\n status.value = 'success';\r\n options.onSuccess?.(transformed);\r\n return transformed;\r\n } catch (caught) {\r\n const normalizedError = normalizeError(caught);\r\n\r\n if (disposed || currentExecution !== executionId) {\r\n return data.peek();\r\n }\r\n\r\n error.value = normalizedError;\r\n status.value = 'error';\r\n options.onError?.(normalizedError);\r\n return data.peek();\r\n }\r\n };\r\n\r\n if (options.watch?.length) {\r\n let initialized = false;\r\n stopWatching = effect(() => {\r\n for (const source of options.watch ?? []) {\r\n readWatchSource(source);\r\n }\r\n\r\n if (!initialized) {\r\n initialized = true;\r\n if (immediate) {\r\n void untrack(() => execute());\r\n }\r\n return;\r\n }\r\n\r\n void untrack(() => execute());\r\n });\r\n } else if (immediate) {\r\n void execute();\r\n }\r\n\r\n return {\r\n data,\r\n error,\r\n status,\r\n pending,\r\n execute,\r\n refresh: execute,\r\n clear,\r\n dispose,\r\n };\r\n};\r\n\r\n/**\r\n * Reactive fetch composable using the browser Fetch API.\r\n *\r\n * @template TResponse - Raw parsed response type\r\n * @template TData - Stored response type after optional transformation\r\n * @param input - Request URL, Request object, or lazy input factory\r\n * @param options - Request and reactive state options\r\n * @returns Reactive fetch state with execute(), refresh(), and clear()\r\n *\r\n * @example\r\n * ```ts\r\n * const users = useFetch<{ id: number; name: string }[]>('/api/users');\r\n * ```\r\n */\r\nexport const useFetch = <TResponse = unknown, TData = TResponse>(\r\n input: FetchInput,\r\n options: UseFetchOptions<TResponse, TData> = {}\r\n): AsyncDataState<TData> => {\r\n const fetchConfig = getBqueryConfig().fetch;\r\n const parseAs = options.parseAs ?? fetchConfig?.parseAs ?? 'json';\r\n const fetcher = options.fetcher ?? fetch;\r\n\r\n return useAsyncData<TResponse, TData>(async () => {\r\n const requestInput = resolveInput(input);\r\n const requestUrl =\r\n typeof requestInput === 'string' || requestInput instanceof URL\r\n ? toUrl(requestInput, options.baseUrl ?? fetchConfig?.baseUrl)\r\n : requestInput instanceof Request && options.query\r\n ? new URL(requestInput.url)\r\n : null;\r\n\r\n if (requestUrl && options.query) {\r\n appendQuery(requestUrl, options.query);\r\n }\r\n\r\n const headers = toHeaders(\r\n fetchConfig?.headers,\r\n requestInput instanceof Request ? requestInput.headers : undefined,\r\n options.headers\r\n );\r\n const bodyProvided = options.body != null;\r\n const explicitMethod = normalizeMethod(options.method);\r\n const method = resolveMethod(explicitMethod, requestInput, bodyProvided);\r\n const bodylessMethod = method === 'GET' || method === 'HEAD' ? method : null;\r\n if (bodyProvided && bodylessMethod) {\r\n throw new Error(`Cannot send a request body with ${bodylessMethod} requests`);\r\n }\r\n const requestInitMethod = resolveRequestInitMethod(explicitMethod, requestInput, method);\r\n const requestInit: RequestInit = {\r\n ...options,\r\n method: requestInitMethod,\r\n headers,\r\n body: serializeBody(options.body, headers),\r\n };\r\n\r\n delete (requestInit as Partial<UseFetchOptions>).baseUrl;\r\n delete (requestInit as Partial<UseFetchOptions>).query;\r\n delete (requestInit as Partial<UseFetchOptions>).parseAs;\r\n delete (requestInit as Partial<UseFetchOptions>).fetcher;\r\n delete (requestInit as Partial<UseFetchOptions>).defaultValue;\r\n delete (requestInit as Partial<UseFetchOptions>).immediate;\r\n delete (requestInit as Partial<UseFetchOptions>).watch;\r\n delete (requestInit as Partial<UseFetchOptions>).transform;\r\n delete (requestInit as Partial<UseFetchOptions>).onSuccess;\r\n delete (requestInit as Partial<UseFetchOptions>).onError;\r\n\r\n let requestTarget: Request | string | URL = requestUrl ?? requestInput;\r\n if (\r\n requestInput instanceof Request &&\r\n requestUrl &&\r\n requestUrl.toString() !== requestInput.url\r\n ) {\r\n // Rebuild Request inputs when query params changed so the updated URL is preserved.\r\n // String/URL inputs already use `requestUrl` directly, so only Request objects need rebuilding.\r\n requestTarget = new Request(requestUrl.toString(), toRequestInit(requestInput));\r\n }\r\n const response = await fetcher(requestTarget, requestInit);\r\n\r\n if (!response.ok) {\r\n throw Object.assign(new Error(`Request failed with status ${response.status}`), {\r\n response,\r\n status: response.status,\r\n statusText: response.statusText,\r\n });\r\n }\r\n\r\n return parseResponse<TResponse>(response, parseAs);\r\n }, options);\r\n};\r\n\r\n/**\r\n * Create a preconfigured useFetch() helper.\r\n *\r\n * @param defaults - Default request options merged into every useFetch() call\r\n * @returns A useFetch-compatible function with merged defaults\r\n *\r\n * @example\r\n * ```ts\r\n * const useApiFetch = createUseFetch({ baseUrl: 'https://api.example.com' });\r\n * const profile = useApiFetch('/profile');\r\n * ```\r\n */\r\n/** Overload for factories without a configured transform, preserving per-call `TResponse -> TData` inference. */\r\nexport function createUseFetch<TDefaultResponse = unknown>(\r\n defaults?: UseFetchOptions<TDefaultResponse, TDefaultResponse>\r\n): <TResponse = TDefaultResponse, TData = TResponse>(\r\n input: FetchInput,\r\n options?: UseFetchOptions<TResponse, TData>\r\n) => AsyncDataState<TData>;\r\n\r\n/** Overload for factories with a configured transform, preserving the transformed factory data type by default. */\r\nexport function createUseFetch<TDefaultResponse = unknown, TDefaultData = TDefaultResponse>(\r\n defaults: UseFetchOptions<TDefaultResponse, TDefaultData>\r\n): <TResponse = TDefaultResponse, TData = TDefaultData>(\r\n input: FetchInput,\r\n options?: UseFetchOptions<TResponse, TData>\r\n) => AsyncDataState<TData>;\r\n\r\nexport function createUseFetch<TDefaultResponse = unknown, TDefaultData = TDefaultResponse>(\r\n defaults: UseFetchOptions<TDefaultResponse, TDefaultData> = {}\r\n) {\r\n return <TResponse = TDefaultResponse, TData = TDefaultData>(\r\n input: FetchInput,\r\n options: UseFetchOptions<TResponse, TData> = {}\r\n ): AsyncDataState<TData> => {\r\n const resolvedDefaults = defaults as unknown as UseFetchOptions<TResponse, TData>;\r\n const mergedQuery = merge({}, resolvedDefaults.query ?? {}, options.query ?? {}) as Record<\r\n string,\r\n unknown\r\n >;\r\n\r\n return useFetch<TResponse, TData>(input, {\r\n ...resolvedDefaults,\r\n ...options,\r\n headers: toHeaders(resolvedDefaults.headers, options.headers),\r\n query: Object.keys(mergedQuery).length > 0 ? mergedQuery : undefined,\r\n });\r\n };\r\n}\r\n","/**\n * Linked (writable) computed helpers.\n */\n\nimport { computed, Computed } from './computed';\n\n/**\n * A writable computed-like signal.\n */\nexport interface LinkedSignal<T> {\n /** Gets or sets the current value with dependency tracking. */\n value: T;\n /** Gets the current value without dependency tracking. */\n peek(): T;\n}\n\n/**\n * Creates a writable computed signal by linking a getter and setter.\n *\n * @template T - The derived value type\n * @param getValue - Getter that derives the current value\n * @param setValue - Setter that writes back to underlying signals\n * @returns A writable computed-like signal\n *\n * @example\n * ```ts\n * const first = signal('Ada');\n * const last = signal('Lovelace');\n * const fullName = linkedSignal(\n * () => `${first.value} ${last.value}`,\n * (next) => {\n * const [a, b] = next.split(' ');\n * first.value = a ?? '';\n * last.value = b ?? '';\n * }\n * );\n * ```\n */\nexport const linkedSignal = <T>(\n getValue: () => T,\n setValue: (value: T) => void\n): LinkedSignal<T> => {\n const derived: Computed<T> = computed(getValue);\n\n return {\n get value(): T {\n return derived.value;\n },\n set value(next: T) {\n setValue(next);\n },\n peek(): T {\n return derived.peek();\n },\n };\n};\n","/**\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 * Type guards for reactive primitives.\n */\n\nimport { Computed } from './computed';\nimport { Signal } from './core';\n\n/**\n * Type guard to check if a value is a Signal instance.\n *\n * @param value - The value to check\n * @returns True if the value is a Signal\n */\nexport const isSignal = (value: unknown): value is Signal<unknown> => value instanceof Signal;\n\n/**\n * Type guard to check if a value is a Computed instance.\n *\n * @param value - The value to check\n * @returns True if the value is a Computed\n */\nexport const isComputed = (value: unknown): value is Computed<unknown> => value instanceof Computed;\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"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"sanitize-jyJ2ryE2.js","names":[],"sources":["../src/security/constants.ts","../src/security/sanitize-core.ts","../src/security/csp.ts","../src/security/trusted-types.ts","../src/security/sanitize.ts"],"sourcesContent":["/**\r\n * Security constants and safe lists.\r\n *\r\n * @module bquery/security\r\n */\r\n\r\n/**\r\n * Trusted Types policy name.\r\n */\r\nexport const POLICY_NAME = 'bquery-sanitizer';\r\n\r\n/**\r\n * Default allowed HTML tags considered safe.\r\n */\r\nexport const DEFAULT_ALLOWED_TAGS = new Set([\r\n 'a',\r\n 'abbr',\r\n 'address',\r\n 'article',\r\n 'aside',\r\n 'b',\r\n 'bdi',\r\n 'bdo',\r\n 'blockquote',\r\n 'br',\r\n 'button',\r\n 'caption',\r\n 'cite',\r\n 'code',\r\n 'col',\r\n 'colgroup',\r\n 'data',\r\n 'dd',\r\n 'del',\r\n 'details',\r\n 'dfn',\r\n 'div',\r\n 'dl',\r\n 'dt',\r\n 'em',\r\n 'figcaption',\r\n 'figure',\r\n 'footer',\r\n 'form',\r\n 'h1',\r\n 'h2',\r\n 'h3',\r\n 'h4',\r\n 'h5',\r\n 'h6',\r\n 'header',\r\n 'hgroup',\r\n 'hr',\r\n 'i',\r\n 'img',\r\n 'input',\r\n 'ins',\r\n 'kbd',\r\n 'label',\r\n 'legend',\r\n 'li',\r\n 'main',\r\n 'mark',\r\n 'nav',\r\n 'ol',\r\n 'optgroup',\r\n 'option',\r\n 'p',\r\n 'picture',\r\n 'pre',\r\n 'progress',\r\n 'q',\r\n 'rp',\r\n 'rt',\r\n 'ruby',\r\n 's',\r\n 'samp',\r\n 'section',\r\n 'select',\r\n 'small',\r\n 'source',\r\n 'span',\r\n 'strong',\r\n 'sub',\r\n 'summary',\r\n 'sup',\r\n 'table',\r\n 'tbody',\r\n 'td',\r\n 'textarea',\r\n 'tfoot',\r\n 'th',\r\n 'thead',\r\n 'time',\r\n 'tr',\r\n 'u',\r\n 'ul',\r\n 'var',\r\n 'wbr',\r\n]);\r\n\r\n/**\r\n * Explicitly dangerous tags that should never be allowed.\r\n * These are checked even if somehow added to allowTags.\r\n */\r\nexport const DANGEROUS_TAGS = new Set([\r\n 'script',\r\n 'iframe',\r\n 'frame',\r\n 'frameset',\r\n 'object',\r\n 'embed',\r\n 'applet',\r\n 'link',\r\n 'meta',\r\n 'style',\r\n 'base',\r\n 'template',\r\n // 'slot' is intentionally excluded here so component shadow markup can opt in\r\n // via sanitizeHtml(..., { allowTags: ['slot'] }). It remains disallowed by default\r\n // for general HTML writes, because DEFAULT_ALLOWED_TAGS does not include it.\r\n 'math',\r\n 'svg',\r\n 'foreignobject',\r\n 'noscript',\r\n]);\r\n\r\n/**\r\n * Reserved IDs that could cause DOM clobbering attacks.\r\n * These are prevented to avoid overwriting global browser objects.\r\n */\r\nexport const RESERVED_IDS = new Set([\r\n // Global objects\r\n 'document',\r\n 'window',\r\n 'location',\r\n 'top',\r\n 'self',\r\n 'parent',\r\n 'frames',\r\n 'history',\r\n 'navigator',\r\n 'screen',\r\n // Dangerous functions\r\n 'alert',\r\n 'confirm',\r\n 'prompt',\r\n 'eval',\r\n 'function',\r\n // Document properties\r\n 'cookie',\r\n 'domain',\r\n 'referrer',\r\n 'body',\r\n 'head',\r\n 'forms',\r\n 'images',\r\n 'links',\r\n 'scripts',\r\n // DOM traversal properties\r\n 'children',\r\n 'parentnode',\r\n 'firstchild',\r\n 'lastchild',\r\n // Content manipulation\r\n 'innerhtml',\r\n 'outerhtml',\r\n 'textcontent',\r\n]);\r\n\r\n/**\r\n * Default allowed attributes considered safe.\r\n * Note: 'style' is excluded by default because inline CSS can be abused for:\r\n * - UI redressing attacks\r\n * - Data exfiltration via url() in CSS\r\n * - CSS injection vectors\r\n * If you need to allow inline styles, add 'style' to allowAttributes in your\r\n * sanitizeHtml options, but ensure you implement proper CSS value validation.\r\n */\r\nexport const DEFAULT_ALLOWED_ATTRIBUTES = new Set([\r\n 'alt',\r\n 'class',\r\n 'dir',\r\n 'height',\r\n 'hidden',\r\n 'href',\r\n 'id',\r\n 'lang',\r\n 'loading',\r\n 'name',\r\n 'rel',\r\n 'role',\r\n 'src',\r\n 'srcset',\r\n 'tabindex',\r\n 'target',\r\n 'title',\r\n 'type',\r\n 'width',\r\n 'aria-*',\r\n]);\r\n\r\n/**\r\n * Dangerous attribute prefixes to always remove.\r\n */\r\nexport const DANGEROUS_ATTR_PREFIXES = ['on', 'formaction', 'xlink:', 'xmlns:'];\r\n\r\n/**\r\n * Dangerous URL protocols to block.\r\n */\r\nexport const DANGEROUS_PROTOCOLS = ['javascript:', 'data:', 'vbscript:', 'file:'];\r\n","/**\n * Core HTML sanitization logic.\n *\n * @module bquery/security\n * @internal\n */\n\nimport {\n DANGEROUS_ATTR_PREFIXES,\n DANGEROUS_PROTOCOLS,\n DANGEROUS_TAGS,\n DEFAULT_ALLOWED_ATTRIBUTES,\n DEFAULT_ALLOWED_TAGS,\n RESERVED_IDS,\n} from './constants';\nimport type { SanitizeOptions } from './types';\n\n/**\n * Check if an attribute name is allowed.\n * @internal\n */\nconst isAllowedAttribute = (\n name: string,\n allowedSet: Set<string>,\n allowDataAttrs: boolean\n): boolean => {\n const lowerName = name.toLowerCase();\n\n // Check dangerous prefixes\n for (const prefix of DANGEROUS_ATTR_PREFIXES) {\n if (lowerName.startsWith(prefix)) return false;\n }\n\n // Check data attributes\n if (allowDataAttrs && lowerName.startsWith('data-')) return true;\n\n // Check aria attributes (allowed by default)\n if (lowerName.startsWith('aria-')) return true;\n\n // Check explicit allow list\n return allowedSet.has(lowerName);\n};\n\n/**\n * Check if an ID/name value could cause DOM clobbering.\n * @internal\n */\nconst isSafeIdOrName = (value: string): boolean => {\n const lowerValue = value.toLowerCase().trim();\n return !RESERVED_IDS.has(lowerValue);\n};\n\n/**\n * Normalize URL by removing control characters, whitespace, and Unicode tricks.\n * Enhanced to prevent various bypass techniques.\n * @internal\n */\nconst normalizeUrl = (value: string): string =>\n value\n // Remove null bytes and control characters\n .replace(/[\\u0000-\\u001F\\u007F]+/g, '')\n // Remove zero-width characters that could hide malicious content\n .replace(/[\\u200B-\\u200D\\uFEFF\\u2028\\u2029]+/g, '')\n // Remove escaped Unicode sequences\n .replace(/\\\\u[\\da-fA-F]{4}/g, '')\n // Remove whitespace\n .replace(/\\s+/g, '')\n // Normalize case\n .toLowerCase();\n\n/**\n * Check if a URL value is safe.\n * @internal\n */\nconst isSafeUrl = (value: string): boolean => {\n const normalized = normalizeUrl(value);\n for (const protocol of DANGEROUS_PROTOCOLS) {\n if (normalized.startsWith(protocol)) return false;\n }\n return true;\n};\n\n/**\n * Check if a srcset attribute value is safe.\n * srcset contains comma-separated entries of \"url [descriptor]\".\n * Each individual URL must be validated.\n * @internal\n */\nconst isSafeSrcset = (value: string): boolean => {\n const entries = value.split(',');\n for (const entry of entries) {\n const url = entry.trim().split(/\\s+/)[0];\n if (url && !isSafeUrl(url)) return false;\n }\n return true;\n};\n\n/**\n * Check if a URL is external (different origin).\n * @internal\n */\nconst isExternalUrl = (url: string): boolean => {\n try {\n // Normalize URL by trimming whitespace\n const trimmedUrl = url.trim();\n\n // Protocol-relative URLs (//example.com) are always external.\n // CRITICAL: This check must run before the relative-URL check below;\n // otherwise, a protocol-relative URL like \"//evil.com\" would be treated\n // as a non-http(s) relative URL and incorrectly classified as same-origin.\n // Handling them up front guarantees correct security classification.\n if (trimmedUrl.startsWith('//')) {\n return true;\n }\n\n // Normalize URL for case-insensitive protocol checks\n const lowerUrl = trimmedUrl.toLowerCase();\n\n // Check for non-http(s) protocols which are considered external/special\n // (mailto:, tel:, ftp:, etc.)\n const hasProtocol = /^[a-z][a-z0-9+.-]*:/i.test(trimmedUrl);\n if (hasProtocol && !lowerUrl.startsWith('http://') && !lowerUrl.startsWith('https://')) {\n // These are special protocols, not traditional \"external\" links\n // but we treat them as external for security consistency\n return true;\n }\n\n // Relative URLs are not external\n if (!lowerUrl.startsWith('http://') && !lowerUrl.startsWith('https://')) {\n return false;\n }\n\n // In non-browser environments (e.g., Node.js), treat all absolute URLs as external\n if (typeof window === 'undefined' || !window.location) {\n return true;\n }\n\n const urlObj = new URL(trimmedUrl, window.location.href);\n return urlObj.origin !== window.location.origin;\n } catch {\n // If URL parsing fails, treat as potentially external for safety\n return true;\n }\n};\n\n/**\n * Parse an HTML string into a Document using DOMParser.\n * This helper is intentionally separated to make the control-flow around HTML parsing\n * explicit for static analysis tools. It should ONLY be called when the input is\n * known to contain HTML syntax (angle brackets).\n *\n * DOMParser creates an inert document where scripts don't execute, making it safe\n * for parsing untrusted HTML that will subsequently be sanitized.\n *\n * @param htmlContent - A string that is known to contain HTML markup (has < or >)\n * @returns The parsed Document\n * @internal\n */\nconst parseHtmlDocument = (htmlContent: string): Document => {\n const parser = new DOMParser();\n // Parse as a full HTML document in an inert context; scripts won't execute\n return parser.parseFromString(htmlContent, 'text/html');\n};\n\n/**\n * Safely parse HTML string into a DocumentFragment using DOMParser.\n * DOMParser is preferred over innerHTML for security as it creates an inert document\n * where scripts don't execute and provides better static analysis recognition.\n *\n * This function includes input normalization to satisfy static analysis tools:\n * - Coerces input to string and trims whitespace\n * - For plain text (no HTML tags), creates a Text node directly without parsing\n * - Only invokes DOMParser for actual HTML-like content via parseHtmlDocument\n *\n * The separation between plain text handling and HTML parsing is intentional:\n * DOM text that contains no HTML syntax is never fed into an HTML parser,\n * preventing \"DOM text reinterpreted as HTML\" issues.\n *\n * @internal\n */\nconst parseHtmlSafely = (html: string): DocumentFragment => {\n // Step 1: Normalize input - coerce to string and trim\n // This defensive check handles edge cases even though TypeScript says it's a string\n const normalizedHtml = (typeof html === 'string' ? html : String(html ?? '')).trim();\n\n // Step 2: Create the fragment that will hold our result\n const fragment = document.createDocumentFragment();\n\n // Step 3: Early return for empty input\n if (normalizedHtml.length === 0) {\n return fragment;\n }\n\n // Step 4: If input contains no angle brackets, it's plain text - no HTML parsing needed.\n // Plain text is handled as a Text node, never passed to an HTML parser.\n // This explicitly prevents \"DOM text reinterpreted as HTML\" for purely textual inputs.\n const containsHtmlSyntax = normalizedHtml.includes('<') || normalizedHtml.includes('>');\n if (!containsHtmlSyntax) {\n fragment.appendChild(document.createTextNode(normalizedHtml));\n return fragment;\n }\n\n // Step 5: Input contains HTML syntax - parse it via the dedicated HTML parsing helper.\n // This separation makes the data-flow explicit: only strings with HTML syntax\n // are passed to DOMParser, satisfying static analysis requirements.\n const doc = parseHtmlDocument(normalizedHtml);\n\n // Move all children from the document body into the fragment.\n // This avoids interpolating untrusted HTML into an outer wrapper string.\n const body = doc.body;\n\n if (!body) {\n return fragment;\n }\n\n while (body.firstChild) {\n fragment.appendChild(body.firstChild);\n }\n\n return fragment;\n};\n\n/**\n * Core sanitization logic (without Trusted Types wrapper).\n * @internal\n */\nexport const sanitizeHtmlCore = (html: string, options: SanitizeOptions = {}): string => {\n const {\n allowTags = [],\n allowAttributes = [],\n allowDataAttributes = true,\n stripAllTags = false,\n } = options;\n\n // Build combined allow sets (excluding dangerous tags even if specified)\n const allowedTags = new Set(\n [...DEFAULT_ALLOWED_TAGS, ...allowTags.map((t) => t.toLowerCase())].filter(\n (tag) => !DANGEROUS_TAGS.has(tag)\n )\n );\n const allowedAttrs = new Set([\n ...DEFAULT_ALLOWED_ATTRIBUTES,\n ...allowAttributes.map((a) => a.toLowerCase()),\n ]);\n\n // Use DOMParser for safe HTML parsing (inert context, no script execution)\n const fragment = parseHtmlSafely(html);\n\n if (stripAllTags) {\n return fragment.textContent ?? '';\n }\n\n // Walk the DOM tree\n const walker = document.createTreeWalker(fragment, NodeFilter.SHOW_ELEMENT);\n\n const toRemove: Element[] = [];\n\n while (walker.nextNode()) {\n const el = walker.currentNode as Element;\n const tagName = el.tagName.toLowerCase();\n\n // Remove explicitly dangerous tags even if in allow list\n if (DANGEROUS_TAGS.has(tagName)) {\n toRemove.push(el);\n continue;\n }\n\n // Remove disallowed tags entirely\n if (!allowedTags.has(tagName)) {\n toRemove.push(el);\n continue;\n }\n\n // Process attributes\n const attrsToRemove: string[] = [];\n for (const attr of Array.from(el.attributes)) {\n const attrName = attr.name.toLowerCase();\n\n // Check if attribute is allowed\n if (!isAllowedAttribute(attrName, allowedAttrs, allowDataAttributes)) {\n attrsToRemove.push(attr.name);\n continue;\n }\n\n // Check for DOM clobbering on id and name attributes\n if ((attrName === 'id' || attrName === 'name') && !isSafeIdOrName(attr.value)) {\n attrsToRemove.push(attr.name);\n continue;\n }\n\n // Validate URL attributes\n if (\n (attrName === 'href' || attrName === 'src' || attrName === 'action') &&\n !isSafeUrl(attr.value)\n ) {\n attrsToRemove.push(attr.name);\n continue;\n }\n\n // Validate srcset URLs individually\n if (attrName === 'srcset' && !isSafeSrcset(attr.value)) {\n attrsToRemove.push(attr.name);\n }\n }\n\n // Remove disallowed attributes\n for (const attrName of attrsToRemove) {\n el.removeAttribute(attrName);\n }\n\n // Add rel=\"noopener noreferrer\" to external links for security\n if (tagName === 'a') {\n const href = el.getAttribute('href');\n const target = el.getAttribute('target');\n const hasTargetBlank = target?.toLowerCase() === '_blank';\n const isExternal = href && isExternalUrl(href);\n\n // Add security attributes to links opening in new window or external links\n if (hasTargetBlank || isExternal) {\n const existingRel = el.getAttribute('rel');\n const relValues = new Set(existingRel ? existingRel.split(/\\s+/).filter(Boolean) : []);\n\n // Add noopener and noreferrer\n relValues.add('noopener');\n relValues.add('noreferrer');\n\n el.setAttribute('rel', Array.from(relValues).join(' '));\n }\n }\n }\n\n // Remove disallowed elements\n for (const el of toRemove) {\n el.remove();\n }\n\n // Serialize the sanitized fragment to HTML string.\n // We use a temporary container to get the innerHTML of the fragment.\n const serializeFragment = (frag: DocumentFragment): string => {\n const container = document.createElement('div');\n container.appendChild(frag.cloneNode(true));\n return container.innerHTML;\n };\n\n // Double-parse to prevent mutation XSS (mXSS).\n // Browsers may normalize HTML during serialization in ways that could create\n // new dangerous content when re-parsed. By re-parsing the sanitized output\n // and verifying stability, we ensure the final HTML is safe.\n const firstPass = serializeFragment(fragment);\n\n // Re-parse through DOMParser for mXSS detection.\n // Using DOMParser instead of innerHTML for security.\n const verifyFragment = parseHtmlSafely(firstPass);\n const secondPass = serializeFragment(verifyFragment);\n\n // Verify stability: if content mutates between parses, it indicates mXSS attempt\n if (firstPass !== secondPass) {\n // Content mutated during re-parse - potential mXSS detected.\n // Return safely escaped text content as fallback.\n return fragment.textContent ?? '';\n }\n\n return secondPass;\n};\n","/**\n * Content Security Policy helpers.\n *\n * @module bquery/security\n */\n\n/** Maximum allowed nonce length to prevent memory issues */\nconst MAX_NONCE_LENGTH = 1024;\n\n/** Chunk size for building strings to avoid argument limit in String.fromCharCode */\nconst CHUNK_SIZE = 8192;\n\n/**\n * Generate a nonce for inline scripts/styles.\n * Use with Content-Security-Policy nonce directives.\n *\n * @param length - Nonce length in bytes (default: 16, max: 1024)\n * @returns Cryptographically random nonce string\n * @throws {Error} If crypto.getRandomValues or btoa are not available\n * @throws {RangeError} If length is invalid (negative, non-integer, or exceeds maximum)\n */\nexport const generateNonce = (length: number = 16): string => {\n // Validate length parameter\n if (!Number.isInteger(length) || length < 1) {\n throw new RangeError('generateNonce length must be a positive integer');\n }\n if (length > MAX_NONCE_LENGTH) {\n throw new RangeError(`generateNonce length must not exceed ${MAX_NONCE_LENGTH}`);\n }\n\n // Check for required globals in browser/crypto environments\n if (\n typeof globalThis.crypto === 'undefined' ||\n typeof globalThis.crypto.getRandomValues !== 'function'\n ) {\n throw new Error(\n 'generateNonce requires crypto.getRandomValues (not available in this environment)'\n );\n }\n if (typeof globalThis.btoa !== 'function') {\n throw new Error('generateNonce requires btoa (not available in this environment)');\n }\n\n const array = new Uint8Array(length);\n globalThis.crypto.getRandomValues(array);\n\n // Build string in chunks to avoid argument limit in String.fromCharCode\n let binaryString = '';\n for (let i = 0; i < array.length; i += CHUNK_SIZE) {\n const chunk = array.subarray(i, Math.min(i + CHUNK_SIZE, array.length));\n binaryString += String.fromCharCode(...chunk);\n }\n\n return globalThis.btoa(binaryString).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n};\n\n/**\n * Check if a CSP header is present with specific directive.\n * Useful for feature detection and fallback strategies.\n *\n * @param directive - The CSP directive to check (e.g., 'script-src')\n * @returns True if the directive appears to be enforced\n */\nexport const hasCSPDirective = (directive: string): boolean => {\n // Guard for non-DOM environments (SSR, tests, etc.)\n if (typeof document === 'undefined') {\n return false;\n }\n\n // Check meta tag\n const meta = document.querySelector('meta[http-equiv=\"Content-Security-Policy\"]');\n if (meta) {\n const content = meta.getAttribute('content') ?? '';\n return content.includes(directive);\n }\n return false;\n};\n","/**\n * Trusted Types helpers for CSP compatibility.\n *\n * @module bquery/security\n */\n\nimport { POLICY_NAME } from './constants';\nimport { sanitizeHtmlCore } from './sanitize-core';\nimport type { TrustedHTML, TrustedTypePolicy, TrustedTypesWindow } from './types';\n\n/** Cached Trusted Types policy */\nlet cachedPolicy: TrustedTypePolicy | null = null;\n\n/** Whether policy initialization has been attempted (to avoid retry spam) */\nlet policyInitAttempted = false;\n\n/**\n * Check if Trusted Types API is available.\n * @returns True if Trusted Types are supported\n */\nexport const isTrustedTypesSupported = (): boolean => {\n return (\n typeof window !== 'undefined' &&\n typeof (window as TrustedTypesWindow).trustedTypes !== 'undefined'\n );\n};\n\n/**\n * Get or create the bQuery Trusted Types policy.\n * @returns The Trusted Types policy or null if unsupported\n */\nexport const getTrustedTypesPolicy = (): TrustedTypePolicy | null => {\n if (cachedPolicy) return cachedPolicy;\n if (policyInitAttempted) return null;\n\n if (typeof window === 'undefined') return null;\n\n const win = window as TrustedTypesWindow;\n if (!win.trustedTypes) return null;\n\n policyInitAttempted = true;\n\n try {\n cachedPolicy = win.trustedTypes.createPolicy(POLICY_NAME, {\n createHTML: (input: string) => sanitizeHtmlCore(input),\n });\n return cachedPolicy;\n } catch (error) {\n // Policy may already exist or be blocked by CSP\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.warn(`bQuery: Could not create Trusted Types policy \"${POLICY_NAME}\": ${errorMessage}`);\n return null;\n }\n};\n\n/**\n * Create a Trusted HTML value for use with Trusted Types-enabled sites.\n * Falls back to regular string when Trusted Types are unavailable.\n *\n * @param html - The HTML string to wrap\n * @returns Trusted HTML value or sanitized string\n */\nexport const createTrustedHtml = (html: string): TrustedHTML | string => {\n const policy = getTrustedTypesPolicy();\n if (policy) {\n return policy.createHTML(html);\n }\n return sanitizeHtmlCore(html);\n};\n","/**\n * Security utilities for HTML sanitization.\n * All DOM writes are sanitized by default to prevent XSS attacks.\n *\n * @module bquery/security\n */\n\nimport { sanitizeHtmlCore } from './sanitize-core';\nimport type { SanitizeOptions } from './types';\nexport { generateNonce } from './csp';\nexport { isTrustedTypesSupported } from './trusted-types';\n\n/**\n * Sanitize HTML string, removing dangerous elements and attributes.\n * Uses Trusted Types when available for CSP compliance.\n *\n * @param html - The HTML string to sanitize\n * @param options - Sanitization options\n * @returns Sanitized HTML string\n *\n * @example\n * ```ts\n * const safe = sanitizeHtml('<div onclick=\"alert(1)\">Hello</div>');\n * // Returns: '<div>Hello</div>'\n * ```\n */\nexport const sanitizeHtml = (html: string, options: SanitizeOptions = {}): string => {\n return sanitizeHtmlCore(html, options);\n};\n\n/**\n * Escape HTML entities to prevent XSS.\n * Use this for displaying user content as text.\n *\n * @param text - The text to escape\n * @returns Escaped HTML string\n *\n * @example\n * ```ts\n * escapeHtml('<script>alert(1)</script>');\n * // Returns: '<script>alert(1)</script>'\n * ```\n */\nexport const escapeHtml = (text: string): string => {\n const escapeMap: Record<string, string> = {\n '&': '&',\n '<': '<',\n '>': '>',\n '\"': '"',\n \"'\": ''',\n '`': '`',\n };\n return text.replace(/[&<>\"'`]/g, (char) => escapeMap[char]);\n};\n\n/**\n * Strip all HTML tags and return plain text.\n *\n * @param html - The HTML string to strip\n * @returns Plain text content\n */\nexport const stripTags = (html: string): string => {\n return sanitizeHtmlCore(html, { stripAllTags: true });\n};\n\nexport type { SanitizeOptions } from './types';\n"],"mappings":"AASA,IAAa,IAAc,oBAKd,IAAuB,oBAAI,IAAI;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;CACD,GAMY,IAAiB,oBAAI,IAAI;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AAAA,EACA;CACD,GAMY,IAAe,oBAAI,IAAI;AAAA,EAElC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;CACD,GAWY,IAA6B,oBAAI,IAAI;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;CACD,GAKY,IAA0B;AAAA,EAAC;AAAA,EAAM;AAAA,EAAc;AAAA,EAAU;GAKzD,IAAsB;AAAA,EAAC;AAAA,EAAe;AAAA,EAAS;AAAA,EAAa;GC7LnE,IAAA,CACJ,GACA,GACA,MACY;AACZ,QAAM,IAAY,EAAK,YAAA;AAGvB,aAAW,KAAU,EACnB,KAAI,EAAU,WAAW,CAAA,EAAS,QAAO;AAO3C,SAHI,KAAkB,EAAU,WAAW,OAAA,KAGvC,EAAU,WAAW,OAAA,IAAiB,KAGnC,EAAW,IAAI,CAAA;GAOlB,IAAA,CAAkB,MAA2B;AACjD,QAAM,IAAa,EAAM,YAAA,EAAc,KAAA;AACvC,SAAO,CAAC,EAAa,IAAI,CAAA;GAQrB,IAAA,CAAgB,MACpB,EAEG,QAAQ,2BAA2B,EAAA,EAEnC,QAAQ,uCAAuC,EAAA,EAE/C,QAAQ,qBAAqB,EAAA,EAE7B,QAAQ,QAAQ,EAAA,EAEhB,YAAA,GAMC,IAAA,CAAa,MAA2B;AAC5C,QAAM,IAAa,EAAa,CAAA;AAChC,aAAW,KAAY,EACrB,KAAI,EAAW,WAAW,CAAA,EAAW,QAAO;AAE9C,SAAO;GASH,IAAA,CAAgB,MAA2B;AAC/C,QAAM,IAAU,EAAM,MAAM,GAAA;AAC5B,aAAW,KAAS,GAAS;AAC3B,UAAM,IAAM,EAAM,KAAA,EAAO,MAAM,KAAA,EAAO,CAAA;AACtC,QAAI,KAAO,CAAC,EAAU,CAAA,EAAM,QAAO;AAAA;AAErC,SAAO;GAOH,IAAA,CAAiB,MAAyB;AAC9C,MAAI;AAEF,UAAM,IAAa,EAAI,KAAA;AAOvB,QAAI,EAAW,WAAW,IAAA,EACxB,QAAO;AAIT,UAAM,IAAW,EAAW,YAAA;AAK5B,WADoB,uBAAuB,KAAK,CAAA,KAC7B,CAAC,EAAS,WAAW,SAAA,KAAc,CAAC,EAAS,WAAW,UAAA,IAGlE,KAIL,CAAC,EAAS,WAAW,SAAA,KAAc,CAAC,EAAS,WAAW,UAAA,IACnD,KAIL,OAAO,SAAW,OAAe,CAAC,OAAO,WACpC,KAGM,IAAI,IAAI,GAAY,OAAO,SAAS,IAAA,EACrC,WAAW,OAAO,SAAS;AAAA,UACnC;AAEN,WAAO;AAAA;GAiBL,IAAA,CAAqB,MACV,IAAI,UAAA,EAEL,gBAAgB,GAAa,WAAA,GAmBvC,IAAA,CAAmB,MAAmC;AAG1D,QAAM,KAAkB,OAAO,KAAS,WAAW,IAAO,OAAO,KAAQ,EAAA,GAAK,KAAA,GAGxE,IAAW,SAAS,uBAAA;AAG1B,MAAI,EAAe,WAAW,EAC5B,QAAO;AAOT,MAAI,EADuB,EAAe,SAAS,GAAA,KAAQ,EAAe,SAAS,GAAA;AAEjF,WAAA,EAAS,YAAY,SAAS,eAAe,CAAA,CAAe,GACrD;AAUT,QAAM,IAJM,EAAkB,CAAA,EAIb;AAEjB,MAAI,CAAC,EACH,QAAO;AAGT,SAAO,EAAK,aACV,CAAA,EAAS,YAAY,EAAK,UAAA;AAG5B,SAAO;GAOI,IAAA,CAAoB,GAAc,IAA2B,CAAA,MAAe;AACvF,QAAM,EACJ,WAAA,IAAY,CAAA,GACZ,iBAAA,IAAkB,CAAA,GAClB,qBAAA,IAAsB,IACtB,cAAA,IAAe,GAAA,IACb,GAGE,IAAc,IAAI,IACtB,CAAC,GAAG,GAAsB,GAAG,EAAU,IAAA,CAAK,MAAM,EAAE,YAAA,CAAa,CAAC,EAAE,OAAA,CACjE,MAAQ,CAAC,EAAe,IAAI,CAAA,CAAI,CAClC,GAEG,IAAe,oBAAI,IAAI,CAC3B,GAAG,GACH,GAAG,EAAgB,IAAA,CAAK,MAAM,EAAE,YAAA,CAAa,CAAC,CAC/C,GAGK,IAAW,EAAgB,CAAA;AAEjC,MAAI,EACF,QAAO,EAAS,eAAe;AAIjC,QAAM,IAAS,SAAS,iBAAiB,GAAU,WAAW,YAAA,GAExD,IAAsB,CAAA;AAE5B,SAAO,EAAO,SAAA,KAAY;AACxB,UAAM,IAAK,EAAO,aACZ,IAAU,EAAG,QAAQ,YAAA;AAG3B,QAAI,EAAe,IAAI,CAAA,GAAU;AAC/B,MAAA,EAAS,KAAK,CAAA;AACd;AAAA;AAIF,QAAI,CAAC,EAAY,IAAI,CAAA,GAAU;AAC7B,MAAA,EAAS,KAAK,CAAA;AACd;AAAA;AAIF,UAAM,IAA0B,CAAA;AAChC,eAAW,KAAQ,MAAM,KAAK,EAAG,UAAA,GAAa;AAC5C,YAAM,IAAW,EAAK,KAAK,YAAA;AAG3B,UAAI,CAAC,EAAmB,GAAU,GAAc,CAAA,GAAsB;AACpE,QAAA,EAAc,KAAK,EAAK,IAAA;AACxB;AAAA;AAIF,WAAK,MAAa,QAAQ,MAAa,WAAW,CAAC,EAAe,EAAK,KAAA,GAAQ;AAC7E,QAAA,EAAc,KAAK,EAAK,IAAA;AACxB;AAAA;AAIF,WACG,MAAa,UAAU,MAAa,SAAS,MAAa,aAC3D,CAAC,EAAU,EAAK,KAAA,GAChB;AACA,QAAA,EAAc,KAAK,EAAK,IAAA;AACxB;AAAA;AAIF,MAAI,MAAa,YAAY,CAAC,EAAa,EAAK,KAAA,KAC9C,EAAc,KAAK,EAAK,IAAA;AAAA;AAK5B,eAAW,KAAY,EACrB,CAAA,EAAG,gBAAgB,CAAA;AAIrB,QAAI,MAAY,KAAK;AACnB,YAAM,IAAO,EAAG,aAAa,MAAA,GAEvB,IADS,EAAG,aAAa,QAAA,GACA,YAAA,MAAkB,UAC3C,IAAa,KAAQ,EAAc,CAAA;AAGzC,UAAI,KAAkB,GAAY;AAChC,cAAM,IAAc,EAAG,aAAa,KAAA,GAC9B,IAAY,IAAI,IAAI,IAAc,EAAY,MAAM,KAAA,EAAO,OAAO,OAAA,IAAW,CAAA,CAAE;AAGrF,QAAA,EAAU,IAAI,UAAA,GACd,EAAU,IAAI,YAAA,GAEd,EAAG,aAAa,OAAO,MAAM,KAAK,CAAA,EAAW,KAAK,GAAA,CAAI;AAAA;;;AAM5D,aAAW,KAAM,EACf,CAAA,EAAG,OAAA;AAKL,QAAM,IAAA,CAAqB,MAAmC;AAC5D,UAAM,IAAY,SAAS,cAAc,KAAA;AACzC,WAAA,EAAU,YAAY,EAAK,UAAU,EAAA,CAAK,GACnC,EAAU;AAAA,KAOb,IAAY,EAAkB,CAAA,GAK9B,IAAa,EADI,EAAgB,CAAA,CAAU;AAIjD,SAAI,MAAc,IAGT,EAAS,eAAe,KAG1B;GCnWH,IAAmB,MAGnB,IAAa,MAWN,IAAA,CAAiB,IAAiB,OAAe;AAE5D,MAAI,CAAC,OAAO,UAAU,CAAA,KAAW,IAAS,EACxC,OAAM,IAAI,WAAW,iDAAA;AAEvB,MAAI,IAAS,EACX,OAAM,IAAI,WAAW,wCAAwC,CAAA,EAAA;AAI/D,MACE,OAAO,WAAW,SAAW,OAC7B,OAAO,WAAW,OAAO,mBAAoB,WAE7C,OAAM,IAAI,MACR,mFAAA;AAGJ,MAAI,OAAO,WAAW,QAAS,WAC7B,OAAM,IAAI,MAAM,iEAAA;AAGlB,QAAM,IAAQ,IAAI,WAAW,CAAA;AAC7B,aAAW,OAAO,gBAAgB,CAAA;AAGlC,MAAI,IAAe;AACnB,WAAS,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK,GAAY;AACjD,UAAM,IAAQ,EAAM,SAAS,GAAG,KAAK,IAAI,IAAI,GAAY,EAAM,MAAA,CAAO;AACtE,IAAA,KAAgB,OAAO,aAAa,GAAG,CAAA;AAAA;AAGzC,SAAO,WAAW,KAAK,CAAA,EAAc,QAAQ,OAAO,GAAA,EAAK,QAAQ,OAAO,GAAA,EAAK,QAAQ,MAAM,EAAA;GAUhF,IAAA,CAAmB,MAA+B;AAE7D,MAAI,OAAO,WAAa,IACtB,QAAO;AAIT,QAAM,IAAO,SAAS,cAAc,4CAAA;AACpC,SAAI,KACc,EAAK,aAAa,SAAA,KAAc,IACjC,SAAS,CAAA,IAEnB;GChEL,IAAyC,MAGzC,IAAsB,IAMb,IAAA,MAET,OAAO,SAAW,OAClB,OAAQ,OAA8B,eAAiB,KAQ9C,IAAA,MAAwD;AACnE,MAAI,EAAc,QAAO;AAGzB,MAFI,KAEA,OAAO,SAAW,IAAa,QAAO;AAE1C,QAAM,IAAM;AACZ,MAAI,CAAC,EAAI,aAAc,QAAO;AAE9B,EAAA,IAAsB;AAEtB,MAAI;AACF,WAAA,IAAe,EAAI,aAAa,aAAa,GAAa,EACxD,YAAA,CAAa,MAAkB,EAAiB,CAAA,EAAM,CACvD,GACM;AAAA,WACA,GAAO;AAEd,UAAM,IAAe,aAAiB,QAAQ,EAAM,UAAU,OAAO,CAAA;AACrE,mBAAQ,KAAK,kDAAkD,CAAA,MAAiB,CAAA,EAAA,GACzE;AAAA;GAWE,IAAA,CAAqB,MAAuC;AACvE,QAAM,IAAS,EAAA;AACf,SAAI,IACK,EAAO,WAAW,CAAA,IAEpB,EAAiB,CAAA;GCzCb,IAAA,CAAgB,GAAc,IAA2B,CAAA,MAC7D,EAAiB,GAAM,CAAA,GAgBnB,IAAA,CAAc,MAAyB;AAClD,QAAM,IAAoC;AAAA,IACxC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA;AAEP,SAAO,EAAK,QAAQ,aAAA,CAAc,MAAS,EAAU,CAAA,CAAA;GAS1C,IAAA,CAAa,MACjB,EAAiB,GAAM,EAAE,cAAc,GAAA,CAAM"}
|