@zappzarapp/browser-utils 1.0.0

package/dist/cache/CacheManager.js

@@ -0,0 +1,429 @@
+import { BrowserUtilsError, Validator, Result } from '../core';
+export class CacheError extends BrowserUtilsError {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause);
+        this.code = code;
+    }
+    static invalidKey(key) {
+        return new CacheError('INVALID_KEY', `Invalid cache key: "${key}"`);
+    }
+    static invalidTtl(ttl) {
+        return new CacheError('INVALID_TTL', `Invalid TTL value: ${ttl}. Must be a positive number.`);
+    }
+    static invalidSize(size) {
+        return new CacheError('INVALID_SIZE', `Invalid max size: ${size}. Must be a positive integer.`);
+    }
+    static storageFailed(operation, cause) {
+        return new CacheError('STORAGE_FAILED', `Cache storage operation "${operation}" failed`, cause);
+    }
+    static revalidationFailed(key, cause) {
+        return new CacheError('REVALIDATION_FAILED', `Revalidation failed for key "${key}"`, cause);
+    }
+    static destroyed() {
+        return new CacheError('DESTROYED', 'Cache manager has been destroyed');
+    }
+}
+function validateKey(key) {
+    const result = Validator.cacheKeyResult(key);
+    if (Result.isErr(result)) {
+        throw CacheError.invalidKey(result.error.message);
+    }
+}
+function validateTtl(ttl) {
+    if (ttl !== undefined && (ttl <= 0 || !Number.isFinite(ttl))) {
+        throw CacheError.invalidTtl(ttl);
+    }
+}
+function validateMaxSize(size) {
+    if (size !== undefined && (size <= 0 || !Number.isInteger(size))) {
+        throw CacheError.invalidSize(size);
+    }
+}
+export const CacheManager = {
+    create(config = {}) {
+        validateMaxSize(config.maxSize);
+        validateTtl(config.defaultTtl);
+        validateTtl(config.defaultStaleAfter);
+        validateTtl(config.cleanupInterval);
+        const maxSize = config.maxSize ?? 1000;
+        const defaultTtl = config.defaultTtl;
+        const defaultStaleAfter = config.defaultStaleAfter;
+        const cache = new Map();
+        const tagIndex = new Map();
+        const revalidating = new Set();
+        let stats = {
+            hits: 0,
+            misses: 0,
+            staleHits: 0,
+            evictions: 0,
+            invalidations: 0,
+        };
+        let destroyed = false;
+        let cleanupTimer;
+        const now = () => Date.now();
+        const isExpired = (entry) => {
+            return entry.meta.expiresAt !== undefined && entry.meta.expiresAt <= now();
+        };
+        const isStale = (entry) => {
+            return entry.meta.staleAt !== undefined && entry.meta.staleAt <= now();
+        };
+        const updateAccessTime = (key, entry) => {
+            cache.set(key, {
+                value: entry.value,
+                meta: {
+                    ...entry.meta,
+                    accessedAt: now(),
+                },
+            });
+        };
+        const addToTagIndex = (key, tags) => {
+            for (const tag of tags) {
+                let keys = tagIndex.get(tag);
+                if (!keys) {
+                    keys = new Set();
+                    tagIndex.set(tag, keys);
+                }
+                keys.add(key);
+            }
+        };
+        const removeFromTagIndex = (key, tags) => {
+            for (const tag of tags) {
+                const keys = tagIndex.get(tag);
+                if (keys) {
+                    keys.delete(key);
+                    if (keys.size === 0) {
+                        tagIndex.delete(tag);
+                    }
+                }
+            }
+        };
+        const evictLru = () => {
+            if (cache.size === 0)
+                return;
+            let lruKey;
+            let lruTime = Infinity;
+            for (const [key, entry] of cache) {
+                if (entry.meta.accessedAt < lruTime) {
+                    lruTime = entry.meta.accessedAt;
+                    lruKey = key;
+                }
+            }
+            if (lruKey !== undefined) {
+                const entry = cache.get(lruKey);
+                if (entry) {
+                    removeFromTagIndex(lruKey, entry.meta.tags);
+                    cache.delete(lruKey);
+                    stats.evictions++;
+                    config.onEvict?.(lruKey, entry.value);
+                }
+            }
+        };
+        const cleanup = () => {
+            if (destroyed)
+                return;
+            const keysToDelete = [];
+            for (const [key, entry] of cache) {
+                if (isExpired(entry)) {
+                    keysToDelete.push(key);
+                }
+            }
+            for (const key of keysToDelete) {
+                const entry = cache.get(key);
+                if (entry) {
+                    removeFromTagIndex(key, entry.meta.tags);
+                    cache.delete(key);
+                }
+            }
+        };
+        if (config.cleanupInterval !== undefined && config.cleanupInterval > 0) {
+            cleanupTimer = setInterval(cleanup, config.cleanupInterval);
+        }
+        const checkDestroyed = () => {
+            if (destroyed) {
+                throw CacheError.destroyed();
+            }
+        };
+        const checkDestroyedAsync = () => {
+            if (destroyed) {
+                return Promise.reject(CacheError.destroyed());
+            }
+            return null;
+        };
+        const instance = {
+            get(key, options) {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                try {
+                    validateKey(key);
+                }
+                catch (e) {
+                    return Promise.reject(e instanceof Error ? e : new Error(String(e)));
+                }
+                const entry = cache.get(key);
+                if (!entry) {
+                    stats.misses++;
+                    return Promise.resolve(undefined);
+                }
+                if (isExpired(entry)) {
+                    removeFromTagIndex(key, entry.meta.tags);
+                    cache.delete(key);
+                    stats.misses++;
+                    return Promise.resolve(undefined);
+                }
+                const stale = isStale(entry);
+                if (stale && options?.staleWhileRevalidate === true && options.revalidate !== undefined) {
+                    stats.staleHits++;
+                    updateAccessTime(key, entry);
+                    if (!revalidating.has(key)) {
+                        revalidating.add(key);
+                        options
+                            .revalidate()
+                            .then((freshValue) => {
+                            if (!destroyed) {
+                                instance.setSync(key, freshValue, options.revalidateOptions);
+                            }
+                        })
+                            .catch(() => {
+                        })
+                            .finally(() => {
+                            revalidating.delete(key);
+                        });
+                    }
+                    return Promise.resolve({
+                        value: entry.value,
+                        isStale: true,
+                        meta: entry.meta,
+                    });
+                }
+                if (stale) {
+                    stats.staleHits++;
+                }
+                else {
+                    stats.hits++;
+                }
+                updateAccessTime(key, entry);
+                return Promise.resolve({
+                    value: entry.value,
+                    isStale: stale,
+                    meta: entry.meta,
+                });
+            },
+            getSync(key) {
+                checkDestroyed();
+                validateKey(key);
+                const entry = cache.get(key);
+                if (!entry) {
+                    stats.misses++;
+                    return undefined;
+                }
+                if (isExpired(entry)) {
+                    removeFromTagIndex(key, entry.meta.tags);
+                    cache.delete(key);
+                    stats.misses++;
+                    return undefined;
+                }
+                const stale = isStale(entry);
+                if (stale) {
+                    stats.staleHits++;
+                }
+                else {
+                    stats.hits++;
+                }
+                updateAccessTime(key, entry);
+                return {
+                    value: entry.value,
+                    isStale: stale,
+                    meta: entry.meta,
+                };
+            },
+            set(key, value, options) {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                try {
+                    this.setSync(key, value, options);
+                    return Promise.resolve();
+                }
+                catch (e) {
+                    return Promise.reject(e instanceof Error ? e : new Error(String(e)));
+                }
+            },
+            setSync(key, value, options) {
+                checkDestroyed();
+                validateKey(key);
+                const ttl = options?.ttl ?? defaultTtl;
+                const staleAfter = options?.staleAfter ?? defaultStaleAfter;
+                const tags = options?.tags ?? [];
+                validateTtl(ttl);
+                validateTtl(staleAfter);
+                const existing = cache.get(key);
+                if (existing) {
+                    removeFromTagIndex(key, existing.meta.tags);
+                }
+                while (cache.size >= maxSize && !cache.has(key)) {
+                    evictLru();
+                }
+                const timestamp = now();
+                const meta = {
+                    createdAt: timestamp,
+                    accessedAt: timestamp,
+                    expiresAt: ttl !== undefined ? timestamp + ttl : undefined,
+                    staleAt: staleAfter !== undefined ? timestamp + staleAfter : undefined,
+                    tags,
+                };
+                cache.set(key, { value, meta });
+                addToTagIndex(key, tags);
+            },
+            has(key) {
+                checkDestroyed();
+                validateKey(key);
+                const entry = cache.get(key);
+                if (!entry)
+                    return false;
+                if (isExpired(entry)) {
+                    removeFromTagIndex(key, entry.meta.tags);
+                    cache.delete(key);
+                    return false;
+                }
+                return true;
+            },
+            delete(key) {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                try {
+                    return Promise.resolve(this.deleteSync(key));
+                }
+                catch (e) {
+                    return Promise.reject(e instanceof Error ? e : new Error(String(e)));
+                }
+            },
+            deleteSync(key) {
+                checkDestroyed();
+                validateKey(key);
+                const entry = cache.get(key);
+                if (!entry)
+                    return false;
+                removeFromTagIndex(key, entry.meta.tags);
+                cache.delete(key);
+                return true;
+            },
+            invalidateByPattern(pattern) {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                let count = 0;
+                const keysToDelete = [];
+                for (const key of cache.keys()) {
+                    if (pattern.test(key)) {
+                        keysToDelete.push(key);
+                    }
+                }
+                for (const key of keysToDelete) {
+                    const entry = cache.get(key);
+                    if (entry) {
+                        removeFromTagIndex(key, entry.meta.tags);
+                        cache.delete(key);
+                        count++;
+                    }
+                }
+                stats.invalidations += count;
+                return Promise.resolve(count);
+            },
+            invalidateByTag(tag) {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                const keys = tagIndex.get(tag);
+                if (keys === undefined || keys.size === 0)
+                    return Promise.resolve(0);
+                let count = 0;
+                const keysToDelete = [...keys];
+                for (const key of keysToDelete) {
+                    const entry = cache.get(key);
+                    if (entry) {
+                        removeFromTagIndex(key, entry.meta.tags);
+                        cache.delete(key);
+                        count++;
+                    }
+                }
+                stats.invalidations += count;
+                return Promise.resolve(count);
+            },
+            clear() {
+                const destroyedCheck = checkDestroyedAsync();
+                if (destroyedCheck !== null)
+                    return destroyedCheck;
+                const count = cache.size;
+                cache.clear();
+                tagIndex.clear();
+                stats.invalidations += count;
+                return Promise.resolve();
+            },
+            getStats() {
+                return {
+                    hits: stats.hits,
+                    misses: stats.misses,
+                    staleHits: stats.staleHits,
+                    size: cache.size,
+                    maxSize,
+                    evictions: stats.evictions,
+                    invalidations: stats.invalidations,
+                };
+            },
+            resetStats() {
+                stats = {
+                    hits: 0,
+                    misses: 0,
+                    staleHits: 0,
+                    evictions: 0,
+                    invalidations: 0,
+                };
+            },
+            keys() {
+                checkDestroyed();
+                return [...cache.keys()];
+            },
+            getMeta(key) {
+                checkDestroyed();
+                validateKey(key);
+                const entry = cache.get(key);
+                if (!entry)
+                    return undefined;
+                if (isExpired(entry)) {
+                    removeFromTagIndex(key, entry.meta.tags);
+                    cache.delete(key);
+                    return undefined;
+                }
+                return entry.meta;
+            },
+            destroy() {
+                if (destroyed)
+                    return;
+                destroyed = true;
+                if (cleanupTimer) {
+                    clearInterval(cleanupTimer);
+                    cleanupTimer = undefined;
+                }
+                cache.clear();
+                tagIndex.clear();
+                revalidating.clear();
+            },
+        };
+        return instance;
+    },
+    createResult(config = {}) {
+        try {
+            return Result.ok(CacheManager.create(config));
+        }
+        catch (e) {
+            if (e instanceof CacheError) {
+                return Result.err(e);
+            }
+            return Result.err(CacheError.storageFailed('create', e));
+        }
+    },
+};
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"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"}

package/dist/cache/index.d.ts

@@ -0,0 +1,3 @@
+export { CacheManager, CacheError } from './CacheManager.js';
+export type { CacheErrorCode, CacheEntryMeta, CacheSetOptions, CacheGetOptions, CacheGetResult, CacheStats, CacheConfig, CacheManagerInstance, } from './CacheManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,2 @@
+export { CacheManager, CacheError } from './CacheManager.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/clipboard/ClipboardManager.d.ts

@@ -0,0 +1,14 @@
+import { Result, ClipboardError, ValidationError } from '../core';
+export declare const ClipboardManager: {
+    readonly writeText: (text: string) => Promise<Result<void, ClipboardError | ValidationError>>;
+    readonly write: (data: ClipboardItem | ClipboardItem[]) => Promise<Result<void, ClipboardError>>;
+    readonly readText: () => Promise<Result<string, ClipboardError>>;
+    readonly read: () => Promise<Result<ClipboardItems, ClipboardError>>;
+    readonly isSupported: () => boolean;
+    readonly isWriteSupported: () => boolean;
+    readonly isReadSupported: () => boolean;
+    readonly checkWritePermission: () => Promise<"granted" | "denied" | "prompt" | "unsupported">;
+    readonly checkReadPermission: () => Promise<"granted" | "denied" | "prompt" | "unsupported">;
+    readonly writeTextFallback: (text: string) => Result<void, ClipboardError>;
+};
+//# sourceMappingURL=ClipboardManager.d.ts.map

package/dist/clipboard/ClipboardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardManager.d.ts","sourceRoot":"","sources":["../../src/clipboard/ClipboardManager.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAa,eAAe,EAAE,MAAM,SAAS,CAAC;AAE7E,eAAO,MAAM,gBAAgB;+BASL,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,CAAC,CAAC;2BA6BpE,aAAa,GAAG,aAAa,EAAE,KAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;6BAyBvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;yBAoB3C,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;gCAuB9C,OAAO;qCAOF,OAAO;oCAOR,OAAO;yCAQI,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;wCAqBzD,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;uCAuB7D,MAAM,KAAG,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC;CAsCrD,CAAC"}

package/dist/clipboard/ClipboardManager.js

@@ -0,0 +1,136 @@
+import { Result, ClipboardError, Validator } from '../core';
+export const ClipboardManager = {
+    async writeText(text) {
+        const textResult = Validator.clipboardTextResult(text);
+        if (Result.isErr(textResult)) {
+            return textResult;
+        }
+        if (ClipboardManager.isWriteSupported()) {
+            try {
+                await navigator.clipboard.writeText(text);
+                return Result.ok(undefined);
+            }
+            catch (e) {
+                if (e instanceof Error && e.name === 'NotAllowedError') {
+                    return Result.err(ClipboardError.permissionDenied('writeText'));
+                }
+                return Result.err(ClipboardError.writeFailed(e));
+            }
+        }
+        return ClipboardManager.writeTextFallback(text);
+    },
+    async write(data) {
+        if (!ClipboardManager.isWriteSupported()) {
+            return Result.err(ClipboardError.notSupported('write'));
+        }
+        try {
+            const items = Array.isArray(data) ? data : [data];
+            await navigator.clipboard.write(items);
+            return Result.ok(undefined);
+        }
+        catch (e) {
+            if (e instanceof Error && e.name === 'NotAllowedError') {
+                return Result.err(ClipboardError.permissionDenied('write'));
+            }
+            return Result.err(ClipboardError.writeFailed(e));
+        }
+    },
+    async readText() {
+        if (!ClipboardManager.isReadSupported()) {
+            return Result.err(ClipboardError.notSupported('readText'));
+        }
+        try {
+            const text = await navigator.clipboard.readText();
+            return Result.ok(text);
+        }
+        catch (e) {
+            if (e instanceof Error && e.name === 'NotAllowedError') {
+                return Result.err(ClipboardError.permissionDenied('readText'));
+            }
+            return Result.err(ClipboardError.readFailed(e));
+        }
+    },
+    async read() {
+        if (!ClipboardManager.isReadSupported()) {
+            return Result.err(ClipboardError.notSupported('read'));
+        }
+        try {
+            const items = await navigator.clipboard.read();
+            return Result.ok(items);
+        }
+        catch (e) {
+            if (e instanceof Error && e.name === 'NotAllowedError') {
+                return Result.err(ClipboardError.permissionDenied('read'));
+            }
+            return Result.err(ClipboardError.readFailed(e));
+        }
+    },
+    isSupported() {
+        return typeof navigator !== 'undefined' && typeof navigator.clipboard !== 'undefined';
+    },
+    isWriteSupported() {
+        return ClipboardManager.isSupported() && typeof navigator.clipboard.writeText === 'function';
+    },
+    isReadSupported() {
+        return ClipboardManager.isSupported() && typeof navigator.clipboard.readText === 'function';
+    },
+    async checkWritePermission() {
+        if (typeof navigator === 'undefined' || typeof navigator.permissions === 'undefined') {
+            return 'unsupported';
+        }
+        try {
+            const result = await navigator.permissions.query({
+                name: 'clipboard-write',
+            });
+            return result.state;
+        }
+        catch {
+            return 'unsupported';
+        }
+    },
+    async checkReadPermission() {
+        if (typeof navigator === 'undefined' || typeof navigator.permissions === 'undefined') {
+            return 'unsupported';
+        }
+        try {
+            const result = await navigator.permissions.query({
+                name: 'clipboard-read',
+            });
+            return result.state;
+        }
+        catch {
+            return 'unsupported';
+        }
+    },
+    writeTextFallback(text) {
+        if (typeof document === 'undefined') {
+            return Result.err(ClipboardError.notSupported('writeText'));
+        }
+        try {
+            const textarea = document.createElement('textarea');
+            textarea.value = text;
+            textarea.style.top = '0';
+            textarea.style.left = '0';
+            textarea.style.position = 'fixed';
+            textarea.style.opacity = '0';
+            textarea.style.pointerEvents = 'none';
+            document.body.appendChild(textarea);
+            try {
+                textarea.focus();
+                textarea.select();
+                const success = document.execCommand('copy');
+                if (!success) {
+                    return Result.err(ClipboardError.writeFailed(new Error('execCommand returned false')));
+                }
+                return Result.ok(undefined);
+            }
+            finally {
+                document.body.removeChild(textarea);
+            }
+        }
+        catch (e) {
+            return Result.err(ClipboardError.writeFailed(e));
+        }
+    },
+};
+//# sourceMappingURL=ClipboardManager.js.map

package/dist/clipboard/ClipboardManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardManager.js","sourceRoot":"","sources":["../../src/clipboard/ClipboardManager.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAmB,MAAM,SAAS,CAAC;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAS9B,KAAK,CAAC,SAAS,CAAC,IAAY;QAE1B,MAAM,UAAU,GAAG,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC;QACpB,CAAC;QAGD,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC1C,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBAEX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBACvD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAGD,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAMD,KAAK,CAAC,KAAK,CAAC,IAAqC;QAC/C,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAUD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YAClD,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IASD,WAAW;QACT,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,SAAS,KAAK,WAAW,CAAC;IACxF,CAAC;IAKD,gBAAgB;QACd,OAAO,gBAAgB,CAAC,WAAW,EAAE,IAAI,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,KAAK,UAAU,CAAC;IAC/F,CAAC;IAKD,eAAe;QACb,OAAO,gBAAgB,CAAC,WAAW,EAAE,IAAI,OAAO,SAAS,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU,CAAC;IAC9F,CAAC;IAMD,KAAK,CAAC,oBAAoB;QACxB,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YACrF,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;gBAC/C,IAAI,EAAE,iBAAmC;aAC1C,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YAEP,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,mBAAmB;QACvB,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YACrF,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;gBAC/C,IAAI,EAAE,gBAAkC;aACzC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAUD,iBAAiB,CAAC,IAAY;QAC5B,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACpD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;YAGtB,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;YACzB,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;YAC1B,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;YAClC,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;YAC7B,QAAQ,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;YAEtC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAEpC,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACjB,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAGlB,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC;gBACzF,CAAC;gBAED,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/clipboard/index.d.ts

@@ -0,0 +1,2 @@
+export { ClipboardManager } from './ClipboardManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/clipboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clipboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/clipboard/index.js

@@ -0,0 +1,2 @@
+export { ClipboardManager } from './ClipboardManager.js';
+//# sourceMappingURL=index.js.map

package/dist/clipboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clipboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cookie/CookieManager.d.ts

@@ -0,0 +1,16 @@
+import { Result, ValidationError, CookieError } from '../core';
+import { CookieOptions, type CookieOptionsInput } from './CookieOptions.js';
+export declare const CookieManager: {
+    readonly set: (name: string, value: string, options?: CookieOptions | CookieOptionsInput) => void;
+    readonly setResult: (name: string, value: string, options?: CookieOptions | CookieOptionsInput) => Result<void, ValidationError | CookieError>;
+    readonly get: (name: string) => string | null;
+    readonly getResult: (name: string) => Result<string | null, ValidationError>;
+    readonly has: (name: string) => boolean;
+    readonly remove: (name: string, options?: Pick<CookieOptionsInput, "path" | "domain">) => void;
+    readonly all: () => Record<string, string>;
+    readonly keys: () => string[];
+    readonly clear: (options?: Pick<CookieOptionsInput, "path" | "domain">) => void;
+    readonly isEnabled: () => boolean;
+    readonly findCookie: (name: string) => string | null;
+};
+//# sourceMappingURL=CookieManager.d.ts.map