Compare commits

..

22 Commits

Author SHA1 Message Date
d748d740ea bump 0.26.0
Some checks failed
Build / Build NPM Project (push) Successful in 42s
Build / Publish Documentation (push) Failing after 5s
Build / Tag Version (push) Successful in 8s
2025-07-07 10:52:36 -04:00
c8f44584a2 Fixed cache saving with different backends
Some checks failed
Build / Build NPM Project (push) Successful in 43s
Build / Publish Documentation (push) Failing after 5s
Build / Tag Version (push) Successful in 8s
2025-07-07 10:46:54 -04:00
8b84d170a6 Fixed test
Some checks failed
Build / Build NPM Project (push) Successful in 1m11s
Build / Tag Version (push) Successful in 17s
Build / Publish Documentation (push) Failing after 19s
2025-07-07 10:42:40 -04:00
37df7e6090 Fixed an unreliable caching backend check
Some checks failed
Build / Build NPM Project (push) Failing after 45s
Build / Publish Documentation (push) Has been skipped
Build / Tag Version (push) Has been skipped
2025-07-07 10:36:47 -04:00
a8b6fdd5a6 fixed type error in test
Some checks failed
Build / Build NPM Project (push) Successful in 40s
Build / Publish Documentation (push) Failing after 5s
Build / Tag Version (push) Successful in 9s
2025-07-06 22:19:45 -04:00
3e899e6ae4 Clear cache DB correctly
Some checks failed
Build / Build NPM Project (push) Successful in 1m24s
Build / Tag Version (push) Successful in 19s
Build / Publish Documentation (push) Failing after 17s
2025-07-06 20:41:01 -04:00
08fa5b6783 Clear cache DB correctly
Some checks failed
Build / Build NPM Project (push) Successful in 42s
Build / Publish Documentation (push) Failing after 5s
Build / Tag Version (push) Successful in 8s
2025-07-04 01:23:57 -04:00
529f1e2b30 fixed docs submodule
Some checks failed
Build / Build NPM Project (push) Successful in 1m10s
Build / Tag Version (push) Successful in 15s
Build / Publish Documentation (push) Failing after 5s
2025-07-04 00:39:22 -04:00
87ef246760 Indexdb race conditions
Some checks failed
Build / Build NPM Project (push) Failing after 6s
Build / Publish Documentation (push) Has been skipped
Build / Tag Version (push) Has been skipped
2025-07-04 00:34:31 -04:00
10ac6101f4 Fixed cache handling of undefined
All checks were successful
Build / Build NPM Project (push) Successful in 47s
Build / Tag Version (push) Successful in 13s
Build / Publish Documentation (push) Successful in 53s
2025-06-30 11:44:32 -04:00
b5d534dc8c Added hook to wait for cache loading
All checks were successful
Build / Build NPM Project (push) Successful in 39s
Build / Tag Version (push) Successful in 8s
Build / Publish Documentation (push) Successful in 34s
2025-06-29 23:11:21 -04:00
d140b2edd1 Revert: Restoring cache from DB gets complete status
All checks were successful
Build / Build NPM Project (push) Successful in 41s
Build / Tag Version (push) Successful in 8s
Build / Publish Documentation (push) Successful in 32s
2025-06-29 22:41:39 -04:00
56f6681492 Restoring cache from DB gets complete status
All checks were successful
Build / Build NPM Project (push) Successful in 47s
Build / Tag Version (push) Successful in 15s
Build / Publish Documentation (push) Successful in 52s
2025-06-29 22:29:16 -04:00
64945a647c Fixed path-events
All checks were successful
Build / Build NPM Project (push) Successful in 43s
Build / Tag Version (push) Successful in 8s
Build / Publish Documentation (push) Successful in 48s
2025-06-28 22:25:11 -04:00
adafd61c83 Added IPv6 to v4 converter
All checks were successful
Build / Build NPM Project (push) Successful in 1m17s
Build / Tag Version (push) Successful in 14s
Build / Publish Documentation (push) Successful in 52s
2025-06-25 11:48:49 -04:00
7747dc5558 more path event fixes.... i hope...
All checks were successful
Build / Build NPM Project (push) Successful in 43s
Build / Tag Version (push) Successful in 8s
Build / Publish Documentation (push) Successful in 36s
2025-06-24 22:21:34 -04:00
947bdbc6d4 more path event fixes.... i hope...
Some checks failed
Build / Tag Version (push) Has been cancelled
Build / Publish Documentation (push) Has been cancelled
Build / Build NPM Project (push) Has been cancelled
2025-06-24 22:21:30 -04:00
e2b8c35535 more path event fixes.... i hope...
All checks were successful
Build / Build NPM Project (push) Successful in 44s
Build / Tag Version (push) Successful in 7s
Build / Publish Documentation (push) Successful in 37s
2025-06-24 22:05:39 -04:00
3b7d28de4b Fixed test
Some checks failed
Build / Build NPM Project (push) Failing after 39s
Build / Publish Documentation (push) Has been skipped
Build / Tag Version (push) Has been skipped
2025-06-24 20:55:12 -04:00
8f7e816571 path event fixes
Some checks failed
Build / Build NPM Project (push) Failing after 45s
Build / Publish Documentation (push) Has been skipped
Build / Tag Version (push) Has been skipped
2025-06-24 20:52:16 -04:00
8c1fb2d8cb Fixed filename timestamp
All checks were successful
Build / Build NPM Project (push) Successful in 1m20s
Build / Tag Version (push) Successful in 15s
Build / Publish Documentation (push) Successful in 56s
2025-06-23 18:08:25 -04:00
91dc17667e Better cache & database integration
All checks were successful
Build / Build NPM Project (push) Successful in 44s
Build / Tag Version (push) Successful in 13s
Build / Publish Documentation (push) Successful in 51s
2025-06-20 19:41:01 -04:00
9 changed files with 247 additions and 123 deletions

2
.gitmodules vendored
View File

@ -1,5 +1,5 @@
[submodule "docs"] [submodule "docs"]
path = docs path = docs
url = git@git.zakscode.com:ztimson/utils.wiki.git url = ../utils.wiki.git
branch = master branch = master
ignore = all ignore = all

View File

@ -1,6 +1,6 @@
{ {
"name": "@ztimson/utils", "name": "@ztimson/utils",
"version": "0.25.13", "version": "0.26.0",
"description": "Utility library", "description": "Utility library",
"author": "Zak Timson", "author": "Zak Timson",
"license": "MIT", "license": "MIT",

View File

@ -1,13 +1,11 @@
import {Table} from './database.ts'; import {Database, Table} from './database.ts';
import {deepCopy, includes, JSONSanitize} from './objects.ts'; import {deepCopy, includes, JSONSanitize} from './objects.ts';
export type CacheOptions = { export type CacheOptions = {
/** Delete keys automatically after x amount of seconds */ /** Delete keys automatically after x amount of seconds */
ttl?: number; ttl?: number;
/** Storage to persist cache */ /** Storage to persist cache */
storage?: Storage | Table<any, any>; persistentStorage?: {storage: Storage | Database, key: string} | string;
/** Key cache will be stored under */
storageKey?: string;
/** Keep or delete cached items once expired, defaults to delete */ /** Keep or delete cached items once expired, defaults to delete */
expiryPolicy?: 'delete' | 'keep'; expiryPolicy?: 'delete' | 'keep';
} }
@ -24,6 +22,8 @@ export class Cache<K extends string | number | symbol, T> {
[key: string | number | symbol]: CachedValue<T> | any; [key: string | number | symbol]: CachedValue<T> | any;
/** Whether cache is complete */ /** Whether cache is complete */
complete = false; complete = false;
/** Await initial loading */
loading!: Promise<void>;
/** /**
* Create new cache * Create new cache
@ -31,15 +31,30 @@ export class Cache<K extends string | number | symbol, T> {
* @param options * @param options
*/ */
constructor(public readonly key?: keyof T, public readonly options: CacheOptions = {}) { constructor(public readonly key?: keyof T, public readonly options: CacheOptions = {}) {
if(options.storageKey && !options.storage && typeof(Storage) !== 'undefined') options.storage = localStorage; let done!: Function;
if(options.storage) { this.loading = new Promise(r => done = r);
if(options.storage instanceof Table) {
(async () => (await options.storage?.getAll()).forEach((v: any) => this.add(v)))() // Persistent storage
} else if(options.storageKey) { if(this.options.persistentStorage != null) {
const stored = options.storage?.getItem(options.storageKey); if(typeof this.options.persistentStorage == 'string')
this.options.persistentStorage = {storage: localStorage, key: this.options.persistentStorage};
if(this.options.persistentStorage?.storage?.constructor.name == 'Database') {
(async () => {
const persists: any = this.options.persistentStorage;
const table: Table<any, any> = await persists.storage.createTable({name: persists.key, key: this.key});
const rows = await table.getAll();
Object.assign(this.store, rows.reduce((acc, row) => ({...acc, [this.getKey(row)]: row}), {}));
done();
})();
} else if(this.options.persistentStorage?.storage?.constructor.name == 'Storage') {
const stored = (<Storage>this.options.persistentStorage.storage).getItem(this.options.persistentStorage.key);
if(stored != null) try { Object.assign(this.store, JSON.parse(stored)); } catch { } if(stored != null) try { Object.assign(this.store, JSON.parse(stored)); } catch { }
done();
} }
} }
// Handle index lookups
return new Proxy(this, { return new Proxy(this, {
get: (target: this, prop: string | symbol) => { get: (target: this, prop: string | symbol) => {
if(prop in target) return (target as any)[prop]; if(prop in target) return (target as any)[prop];
@ -55,15 +70,24 @@ export class Cache<K extends string | number | symbol, T> {
private getKey(value: T): K { private getKey(value: T): K {
if(!this.key) throw new Error('No key defined'); if(!this.key) throw new Error('No key defined');
if(value[this.key] === undefined) throw new Error(`${this.key.toString()} Doesn't exist on ${JSON.stringify(value, null, 2)}`);
return <K>value[this.key]; return <K>value[this.key];
} }
private save(key: K) { private save(key?: K) {
if(this.options.storage) { const persists: any = this.options.persistentStorage;
if(this.options.storage instanceof Table) { if(!!persists?.storage) {
this.options.storage.put(key, this.store[key]); if(persists.storage?.constructor.name == 'Database') {
} else if(this.options.storageKey) { (<Database>persists.storage).createTable({name: persists.storage.key, key: <string>this.key}).then(table => {
this.options.storage.setItem(this.options.storageKey, JSONSanitize(this.store)); if(key) {
table.set(key, this.get(key));
} else {
table.clear();
this.all().forEach(row => table.add(row));
}
});
} else if(persists.storage?.constructor.name == 'Storage') {
persists.storage.setItem(persists.storage.key, JSONSanitize(this.all(true)));
} }
} }
} }
@ -108,6 +132,7 @@ export class Cache<K extends string | number | symbol, T> {
clear(): this { clear(): this {
this.complete = false; this.complete = false;
this.store = <any>{}; this.store = <any>{};
this.save();
return this; return this;
} }

View File

@ -1,5 +1,6 @@
import {findByProp} from './array.ts'; import {findByProp} from './array.ts';
import {ASet} from './aset.ts'; import {ASet} from './aset.ts';
import {sleepWhile} from './time.ts';
export type TableOptions = { export type TableOptions = {
name: string; name: string;
@ -7,11 +8,24 @@ export type TableOptions = {
autoIncrement?: boolean; autoIncrement?: boolean;
}; };
class AsyncLock {
private p = Promise.resolve();
run<T>(fn: () => Promise<T>): Promise<T> {
const res = this.p.then(fn, fn);
this.p = res.then(() => {}, () => {});
return res;
}
}
export class Database { export class Database {
private schemaLock = new AsyncLock();
private upgrading = false;
connection!: Promise<IDBDatabase>; connection!: Promise<IDBDatabase>;
ready = false;
tables!: TableOptions[]; tables!: TableOptions[];
get ready() { return !this.upgrading; }
constructor(public readonly database: string, tables?: (string | TableOptions)[], public version?: number) { constructor(public readonly database: string, tables?: (string | TableOptions)[], public version?: number) {
this.connection = new Promise((resolve, reject) => { this.connection = new Promise((resolve, reject) => {
const req = indexedDB.open(this.database, this.version); const req = indexedDB.open(this.database, this.version);
@ -26,7 +40,7 @@ export class Database {
const db = req.result; const db = req.result;
const existing = Array.from(db.objectStoreNames); const existing = Array.from(db.objectStoreNames);
if(!tables) this.tables = existing.map(t => { if(!tables) this.tables = existing.map(t => {
const tx = db.transaction(t, 'readonly', ) const tx = db.transaction(t, 'readonly');
const store = tx.objectStore(t); const store = tx.objectStore(t);
return {name: t, key: <string>store.keyPath}; return {name: t, key: <string>store.keyPath};
}); });
@ -39,10 +53,11 @@ export class Database {
this.version = db.version; this.version = db.version;
resolve(db); resolve(db);
} }
this.ready = true; this.upgrading = false;
}; };
req.onupgradeneeded = () => { req.onupgradeneeded = () => {
this.upgrading = true;
const db = req.result; const db = req.result;
const existingTables = new ASet(Array.from(db.objectStoreNames)); const existingTables = new ASet(Array.from(db.objectStoreNames));
if(tables) { if(tables) {
@ -52,7 +67,7 @@ export class Database {
const t = this.tables.find(findByProp('name', name)); const t = this.tables.find(findByProp('name', name));
db.createObjectStore(name, { db.createObjectStore(name, {
keyPath: t?.key, keyPath: t?.key,
autoIncrement: t?.autoIncrement || !t?.key autoIncrement: t?.autoIncrement || !t?.key,
}); });
}); });
} }
@ -60,22 +75,34 @@ export class Database {
}); });
} }
waitForUpgrade = () => sleepWhile(() => this.upgrading);
async createTable<K extends IDBValidKey = any, T = any>(table: string | TableOptions): Promise<Table<K, T>> { async createTable<K extends IDBValidKey = any, T = any>(table: string | TableOptions): Promise<Table<K, T>> {
if(typeof table == 'string') table = {name: table}; return this.schemaLock.run(async () => {
const conn = await this.connection; if (typeof table == 'string') table = { name: table };
if(!this.includes(table.name)) { const conn = await this.connection;
conn.close(); if (!this.includes(table.name)) {
Object.assign(this, new Database(this.database, [...this.tables, table], (this.version ?? 0) + 1)); const newDb = new Database(this.database, [...this.tables, table], (this.version ?? 0) + 1);
} conn.close();
return this.table<K, T>(table.name); Object.assign(this, newDb);
await this.connection;
}
return this.table<K, T>(table.name);
});
} }
async deleteTable(table: string | TableOptions): Promise<void> { async deleteTable(table: string | TableOptions): Promise<void> {
if(typeof table == 'string') table = {name: table}; return this.schemaLock.run(async () => {
if(!this.includes(table.name)) return; if (typeof table == 'string') table = { name: table };
const conn = await this.connection; if (!this.includes(table.name)) return;
conn.close(); const conn = await this.connection;
Object.assign(this, new Database(this.database, this.tables.filter(t => t.name != table.name), (this.version ?? 0) + 1)); const newDb = new Database(this.database, this.tables.filter(t => t.name != (<TableOptions>table).name), (this.version ?? 0) + 1);
conn.close();
Object.assign(this, newDb);
await this.connection;
});
} }
includes(name: any): boolean { includes(name: any): boolean {
@ -96,12 +123,13 @@ export class Table<K extends IDBValidKey = any, T = any> {
} }
async tx<R>(table: string, fn: (store: IDBObjectStore) => IDBRequest, readonly = false): Promise<R> { async tx<R>(table: string, fn: (store: IDBObjectStore) => IDBRequest, readonly = false): Promise<R> {
await this.database.waitForUpgrade();
const db = await this.database.connection; const db = await this.database.connection;
const tx = db.transaction(table, readonly ? 'readonly' : 'readwrite'); const tx = db.transaction(table, readonly ? 'readonly' : 'readwrite');
const store = tx.objectStore(table); const store = tx.objectStore(table);
return new Promise<R>((resolve, reject) => { return new Promise<R>((resolve, reject) => {
const request = fn(store); const request = fn(store);
request.onsuccess = () => resolve(request.result as R); // ✅ explicit cast request.onsuccess = () => resolve(request.result as R);
request.onerror = () => reject(request.error); request.onerror = () => reject(request.error);
}); });
} }

View File

@ -77,7 +77,7 @@ export function fileText(file: any): Promise<string | null> {
*/ */
export function timestampFilename(name?: string, date: Date | number | string = new Date()) { export function timestampFilename(name?: string, date: Date | number | string = new Date()) {
if(typeof date == 'number' || typeof date == 'string') date = new Date(date); if(typeof date == 'number' || typeof date == 'string') date = new Date(date);
const timestamp = formatDate('YYYY-MM-DD_HH:mm:ss', date); const timestamp = formatDate('YYYY-MM-DD_HH-mm', date);
return name ? name.replace('{{TIMESTAMP}}', timestamp) : timestamp; return name ? name.replace('{{TIMESTAMP}}', timestamp) : timestamp;
} }

View File

@ -1,6 +1,16 @@
import {PathEvent} from './path-events.ts'; import {PathEvent} from './path-events.ts';
import {md5} from './string'; import {md5} from './string';
/**
* Escape any regex special characters to avoid misinterpretation during search
*
* @param {string} value String which should be escaped
* @return {string} New escaped sequence
*/
export function escapeRegex(value: string) {
return value.replace(/[.*+?^${}()|\[\]\\]/g, '\\$&');
}
/** /**
* Run a stringified function with arguments asynchronously * Run a stringified function with arguments asynchronously
* @param {object} args Map of key/value arguments * @param {object} args Map of key/value arguments
@ -26,13 +36,15 @@ export function gravatar(email: string, def='mp') {
} }
/** /**
* Escape any regex special characters to avoid misinterpretation during search * Convert IPv6 to v4 because who uses that, NAT4Life
* * @param {string} ip IPv6 address, e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334
* @param {string} value String which should be escaped * @returns {string | null} IPv4 address, e.g. 172.16.58.3
* @return {string} New escaped sequence
*/ */
export function escapeRegex(value: string) { export function ipV6ToV4(ip: string) {
return value.replace(/[.*+?^${}()|\[\]\\]/g, '\\$&'); if(!ip) return null;
const ipv4 = ip.split(':').splice(-1)[0];
if(ipv4 == '1') return '127.0.0.1';
return ipv4;
} }
/** /**

View File

@ -99,7 +99,7 @@ export class PathEvent {
method = '*'; method = '*';
} }
let temp = p.split('/').filter(p => !!p); let temp = p.split('/').filter(p => !!p);
this.module = temp.splice(0, 1)[0]?.toLowerCase() || ''; this.module = temp.splice(0, 1)[0] || '';
this.path = temp.join('/'); this.path = temp.join('/');
this.fullPath = `${this.module}${this.module && this.path ? '/' : ''}${this.path}`; this.fullPath = `${this.module}${this.module && this.path ? '/' : ''}${this.path}`;
this.name = temp.pop() || ''; this.name = temp.pop() || '';
@ -140,13 +140,14 @@ export class PathEvent {
*/ */
static filter(target: string | PathEvent | (string | PathEvent)[], ...filter: (string | PathEvent)[]): PathEvent[] { static filter(target: string | PathEvent | (string | PathEvent)[], ...filter: (string | PathEvent)[]): PathEvent[] {
const parsedTarget = makeArray(target).map(pe => new PathEvent(pe)); const parsedTarget = makeArray(target).map(pe => new PathEvent(pe));
const parsedFind = makeArray(filter).map(pe => new PathEvent(pe)); const parsedFilter = makeArray(filter).map(pe => new PathEvent(pe));
return parsedTarget.filter(t => { return parsedTarget.filter(t => !!parsedFilter.find(r => {
if(!t.fullPath && t.all) return true; const wildcard = r.fullPath == '*' || t.fullPath == '*';
return !!parsedFind.find(f => const p1 = r.fullPath.slice(0, r.fullPath.indexOf('*')), p2 = t.fullPath.slice(0, t.fullPath.indexOf('*'))
(t.fullPath.startsWith(f.fullPath) || f.fullPath.startsWith(t.fullPath)) && const scope = p1.startsWith(p2) || p2.startsWith(p1);
(f.all || t.all || t.methods.intersection(f.methods).length)); const methods = r.all || t.all || r.methods.intersection(t.methods).length;
}); return (wildcard || scope) && methods;
}));
} }
/** /**
@ -157,15 +158,15 @@ export class PathEvent {
* @return {boolean} Whether there is any overlap * @return {boolean} Whether there is any overlap
*/ */
static has(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): boolean { static has(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): boolean {
const parsedRequired = makeArray(has).map(pe => new PathEvent(pe));
const parsedTarget = makeArray(target).map(pe => new PathEvent(pe)); const parsedTarget = makeArray(target).map(pe => new PathEvent(pe));
return !!parsedRequired.find(r => { const parsedRequired = makeArray(has).map(pe => new PathEvent(pe));
if(!r.fullPath && r.all) return true; return !!parsedRequired.find(r => !!parsedTarget.find(t => {
const filtered = parsedTarget.filter(p => r.fullPath.startsWith(p.fullPath)); const wildcard = r.fullPath == '*' || t.fullPath == '*';
if(!filtered.length) return false; const p1 = r.fullPath.slice(0, r.fullPath.indexOf('*')), p2 = t.fullPath.slice(0, t.fullPath.indexOf('*'))
const combined = PathEvent.combine(...filtered); const scope = p1.startsWith(p2);
return (!combined.none && (combined.all || r.all)) || combined.methods.intersection(r.methods).length; const methods = r.all || t.all || r.methods.intersection(t.methods).length;
}); return (wildcard || scope) && methods;
}));
} }
/** /**
@ -213,6 +214,44 @@ export class PathEvent {
return p; return p;
} }
/**
* Squash 2 sets of paths & return true if any overlap is found
*
* @param has Target must have at least one of these path
* @return {boolean} Whether there is any overlap
*/
has(...has: (string | PathEvent)[]): boolean {
return PathEvent.has(this, ...has);
}
/**
* Squash 2 sets of paths & return true if the target has all paths
*
* @param has Target must have all these paths
* @return {boolean} Whether there is any overlap
*/
hasAll(...has: (string | PathEvent)[]): boolean {
return PathEvent.hasAll(this, ...has);
}
/**
* Same as `has` but raises an error if there is no overlap
*
* @param has Target must have at least one of these path
*/
hasFatal(...has: (string | PathEvent)[]): void {
return PathEvent.hasFatal(this, ...has);
}
/**
* Same as `hasAll` but raises an error if the target is missing any paths
*
* @param has Target must have all these paths
*/
hasAllFatal(...has: (string | PathEvent)[]): void {
return PathEvent.hasAllFatal(this, ...has);
}
/** /**
* Filter a set of paths based on this event * Filter a set of paths based on this event
* *
@ -265,7 +304,7 @@ export class PathEventEmitter implements IPathEventEmitter{
on(event: Event | Event[], listener: PathListener): PathUnsubscribe { on(event: Event | Event[], listener: PathListener): PathUnsubscribe {
makeArray(event).forEach(e => this.listeners.push([ makeArray(event).forEach(e => this.listeners.push([
new PathEvent(`${this.prefix}/${new PathEvent(e).toString()}`), new PathEvent(`${this.prefix}/${e}`),
listener listener
])); ]));
return () => this.off(listener); return () => this.off(listener);

View File

@ -1,7 +1,7 @@
import {Cache} from '../src'; import { Cache } from '../src';
describe('Cache', () => { describe('Cache', () => {
type TestItem = { id: string; value: string; }; type TestItem = { id: string; value: string };
let cache: Cache<string, TestItem>; let cache: Cache<string, TestItem>;
let storageMock: Storage; let storageMock: Storage;
@ -10,6 +10,7 @@ describe('Cache', () => {
beforeEach(() => { beforeEach(() => {
storageMock = { storageMock = {
constructor: {name: 'Storage' as any},
getItem: jest.fn(), getItem: jest.fn(),
setItem: jest.fn(), setItem: jest.fn(),
removeItem: jest.fn(), removeItem: jest.fn(),
@ -17,93 +18,114 @@ describe('Cache', () => {
key: jest.fn(), key: jest.fn(),
length: 0, length: 0,
}; };
// Spies
storageGetItemSpy = jest.spyOn(storageMock, 'getItem'); storageGetItemSpy = jest.spyOn(storageMock, 'getItem');
storageSetItemSpy = jest.spyOn(storageMock, 'setItem'); storageSetItemSpy = jest.spyOn(storageMock, 'setItem');
cache = new Cache<string, TestItem>('id', {storage: storageMock, storageKey: 'cache'});
cache = new Cache<string, TestItem>('id', {
persistentStorage: { storage: storageMock, key: 'cache' },
});
jest.clearAllMocks(); jest.clearAllMocks();
jest.useFakeTimers(); jest.useFakeTimers();
}); });
test('should add and get an item', () => { it('adds and gets an item', () => {
const item = {id: '1', value: 'a'}; const item = { id: '1', value: 'a' };
cache.add(item); cache.add(item);
expect(cache.get('1')).toEqual(item); expect(cache.get('1')).toEqual(item);
}); });
test('should not get an expired item when expired option not set', () => { it('skips expired items by default but fetches if requested', () => {
const item = {id: '1', value: 'a'}; const item = { id: '2', value: 'b' };
cache.set('1', item); cache.set('2', item);
cache.options.expiryPolicy = 'keep'; cache.options.expiryPolicy = 'keep';
cache.expire('1'); cache.expire('2');
expect(cache.get('1')).toBeNull(); expect(cache.get('2')).toBeNull();
expect(cache.get('1', true)).toEqual({...item, _expired: true}); expect(cache.get('2', true)).toEqual({ ...item, _expired: true });
}); });
test('should set and get via property access (proxy)', () => { it('supports property access and setting via Proxy', () => {
(cache as any)['2'] = {id: '2', value: 'b'}; (cache as any)['3'] = { id: '3', value: 'c' };
expect((cache as any)['2']).toEqual({id: '2', value: 'b'}); expect((cache as any)['3']).toEqual({ id: '3', value: 'c' });
expect(cache.get('3')).toEqual({ id: '3', value: 'c' });
}); });
test('should remove an item', () => { it('removes an item and persists', () => {
cache.set('1', {id: '1', value: 'a'}); cache.add({ id: '4', value: 'd' });
cache.delete('1'); cache.delete('4');
expect(cache.get('1')).toBeNull(); expect(cache.get('4')).toBeNull();
expect(storageSetItemSpy).toHaveBeenCalled(); expect(storageSetItemSpy).toHaveBeenCalled();
}); });
test('should clear the cache', () => { it('clears the cache', () => {
cache.add({id: '1', value: 'a'}); cache.add({ id: '1', value: 'test' });
cache.clear(); cache.clear();
expect(cache.get('1')).toBeNull(); expect(cache.get('1')).toBeNull();
expect(cache.complete).toBe(false); expect(cache.complete).toBe(false);
}); });
test('should add multiple items and mark complete', () => { it('bulk adds, marks complete', () => {
const rows = [ const items = [
{id: 'a', value: '1'}, { id: 'a', value: '1' },
{id: 'b', value: '2'}, { id: 'b', value: '2' },
]; ];
cache.addAll(rows); cache.addAll(items);
expect(cache.all().length).toBe(2); expect(cache.all().length).toBe(2);
expect(cache.complete).toBe(true); expect(cache.complete).toBe(true);
}); });
test('should return all, keys, entries, and map', () => { it('returns correct keys, entries, and map', () => {
cache.add({id: '1', value: 'a'}); cache.add({ id: 'x', value: 'foo' });
cache.add({id: '2', value: 'b'}); cache.add({ id: 'y', value: 'bar' });
expect(cache.all().length).toBe(2); expect(cache.keys().sort()).toEqual(['x', 'y']);
expect(cache.keys().sort()).toEqual(['1', '2']); expect(cache.entries().map(e => e[0]).sort()).toEqual(['x', 'y']);
expect(cache.entries().length).toBe(2); const m = cache.map();
expect(Object.keys(cache.map())).toContain('1'); expect(Object.keys(m)).toEqual(expect.arrayContaining(['x', 'y']));
expect(Object.keys(cache.map())).toContain('2'); expect(m['x'].value).toBe('foo');
}); });
// test('should expire/delete items after TTL', () => { it('persists and restores from storage', () => {
// jest.useFakeTimers(); (storageMock.getItem as jest.Mock).mockReturnValueOnce(
// cache = new Cache<string, TestItem>('id', {ttl: 0.1}); JSON.stringify({ z: { id: 'z', value: 'from-storage' } }),
// cache.add({id: '3', value: 'x'}); );
// jest.advanceTimersByTime(250); const c = new Cache<string, TestItem>('id', {
// expect(cache.get('3')).toBeNull(); persistentStorage: { storage: storageMock, key: 'cache' },
});
expect(c.get('z')).toEqual({ id: 'z', value: 'from-storage' });
});
it('expiryPolicy "delete" removes expired items completely', () => {
cache.options.expiryPolicy = 'delete';
cache.add({ id: 'del1', value: 'gone' });
cache.expire('del1');
expect(cache.get('del1', true)).toBeNull();
expect(cache.get('del1')).toBeNull();
});
it('expiryPolicy "keep" marks as expired but does not delete', () => {
cache.options.expiryPolicy = 'keep';
cache.add({ id: 'keep1', value: 'kept' });
cache.expire('keep1');
expect(cache.get('keep1')).toBeNull();
const val = cache.get('keep1', true);
expect(val && val._expired).toBe(true);
});
// Uncomment and adapt this test if TTL/expiry timers are supported by your implementation
// it('expires and deletes items after TTL', () => {
// jest.useFakeTimers();
// cache = new Cache<string, TestItem>('id', { ttl: 0.01 });
// cache.add({ id: 'ttl1', value: 'temp' });
// jest.advanceTimersByTime(100);
// expect(cache.get('ttl1')).toBeNull();
// }); // });
test('should persist and restore from storage', () => { // Edge: add error handling test
(storageMock.getItem as jest.Mock).mockReturnValueOnce(JSON.stringify({a: {id: 'a', value: 'from-storage'}})); it('throws if instantiating with invalid key property', () => {
const c = new Cache<string, TestItem>('id', {storage: storageMock, storageKey: 'cache'}); expect(() => {
expect(c.get('a')).toEqual({id: 'a', value: 'from-storage'}); const invalid = new Cache<'string', TestItem>('id');
}); // try invalid.add({id: 'z', value: 'fail'}) if needed
}).not.toThrow();
test('should handle expiryPolicy "delete"', () => {
cache.options.expiryPolicy = 'delete';
cache.add({id: 'k1', value: 'KeepMe'});
cache.expire('k1');
expect(cache.get('k1', true)).toBeNull();
});
test('should handle expiryPolicy "keep"', () => {
cache.options.expiryPolicy = 'keep';
cache.add({id: 'k1', value: 'KeepMe'});
cache.expire('k1');
expect(cache.get('k1')).toBeNull();
expect(cache.get('k1', true)?._expired).toBe(true);
}); });
}); });

View File

@ -27,7 +27,7 @@ describe('Path Events', () => {
describe('PathEvent', () => { describe('PathEvent', () => {
it('parses event string', () => { it('parses event string', () => {
const pe = new PathEvent('Users/system:cr'); const pe = new PathEvent('users/system:cr');
expect(pe.module).toBe('users'); expect(pe.module).toBe('users');
expect(pe.fullPath).toBe('users/system'); expect(pe.fullPath).toBe('users/system');
expect(pe.name).toBe('system'); expect(pe.name).toBe('system');
@ -103,11 +103,9 @@ describe('Path Events', () => {
}); });
it('has returns true for overlapping', () => { it('has returns true for overlapping', () => {
const events = [ const events = [new PathEvent('users/sys:cr')];
new PathEvent('users/sys:cr'), expect(PathEvent.has(events, 'users/sys:r')).toBeTruthy();
]; expect(PathEvent.has(events, 'users/nope:r')).toBeFalsy();
expect(PathEvent.has(events, 'users/sys:r')).toBe(true);
expect(PathEvent.has(events, 'users/nope:r')).toBe(false);
}); });
it('hasAll returns true only if all overlap', () => { it('hasAll returns true only if all overlap', () => {