Added adjusted interval & set errorFromCode to always return an error even on 200's

PathEvents has none fix
Added filter function to path events
2024-10-29 10:41:25 -04:00 · 2024-10-23 21:39:42 -04:00 · 2024-10-23 14:13:47 -04:00 · 2024-10-17 10:24:18 -04:00 · 2024-10-17 00:36:53 -04:00 · 2024-10-16 20:32:41 -04:00
19 changed files with 584 additions and 5684 deletions
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@ -48,3 +48,13 @@ jobs:
          uses: ztimson/actions/tag@develop
          with:
            tag: ${{env.VERSION}}
  docs:
    name: Publish Documentation
    needs: build
    uses: ztimson/actions/.github/workflows/docker.yaml@develop
    with:
        name: ztimson/utils
        repository: ${{github.server_url}}/${{github.repository}}.git
        pass: ${{secrets.DEPLOY_TOKEN}}
--- a/.npmignore
+++ b/.npmignore
@ -0,0 +1,12 @@
 src
 tests
 .editorconfig
 .gitignore
 .gitmodules
 .npmignore
 CODEOWNERS
 Dockerfile
 index.html
 jest.config.js
 tsconfig.json
 vite.config.js
--- a/13
+++ b/13
@ -0,0 +1,13 @@
 # Build application
 FROM node:alpine as build
 RUN mkdir /app
 WORKDIR /app
 COPY . .
 RUN if [ ! -d "node_modules" ]; then npm i; fi && \
    if [ ! -d "dist" ]; then npm run docs; fi
 # Use Nginx to serve
 FROM nginx:1.23-alpine
 COPY --from=build /app/docs /usr/share/nginx/html
--- a/README.md
+++ b/README.md
@ -20,7 +20,7 @@ Javascript/Typescript Utilities
  ---
  <div>
-    <a href="https://git.zakscode.com/ztimson/utils/wiki" target="_blank">Documentation</a>
+    <a href="https://utils.docs.zakscode.com" target="_blank">Documentation</a>
    • <a href="https://git.zakscode.com/ztimson/utils/releases" target="_blank">Release Notes</a>
    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
@ -36,7 +36,7 @@ Javascript/Typescript Utilities
 	- [Setup](#setup)
 		- [Production](#production)
 		- [Development](#development)
-	- [Documentation](https://git.zakscode.com/ztimson/utils/wiki)
+	- [Documentation](https://utils.docs.zakscode.com/)
 	- [License](#license)
 ## About
@ -82,7 +82,7 @@ A collection of utilities to make life a little easier
 ## Documentation
-[Available Here](https://git.zakscode.com/ztimson/utils/wiki)
+[Available Here](https://utils.docs.zakscode.com/)
 ## License
--- a/index.html
+++ b/index.html
@ -0,0 +1,14 @@
 <!Doctype html>
 <html>
 	<head>
 		<title>@ztimson/utils sandbox</title>
 	</head>
 	<body>
 		<script type="module">
 			import {PathEvent} from './dist/index.mjs';
 			console.log(PathEvent.has(['data/Inventory:n', 'logs:c'], `logs/client:n`));
 		</script>
 	</body>
 </html>
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@ -1,6 +1,6 @@
 {
 	"name": "@ztimson/utils",
-	"version": "0.16.3",
+	"version": "0.21.6",
 	"description": "Utility library",
 	"author": "Zak Timson",
 	"license": "MIT",
@ -21,7 +21,7 @@
 	},
 	"scripts": {
 		"build": "npx tsc && npx vite build",
-		"docs": "typedoc --plugin typedoc-plugin-markdown --cleanOutputDir false --outputFileStrategy modules --hidePageHeader --out ./docs --entryPoints src/**/*.ts --readme none --entryFileName Home",
+		"docs": "typedoc --cleanOutputDir false --out ./docs --entryPoints src/**/*.ts --readme none",
 		"test": "npx jest",
 		"test:coverage": "npx jest --coverage",
 		"watch": "npx vite build --watch"
@ -32,7 +32,6 @@
 		"jest-junit": "^16.0.0",
 		"ts-jest": "^29.1.2",
 		"typedoc": "^0.26.7",
 		"typedoc-plugin-markdown": "^4.2.7",
 		"typescript": "^5.3.3",
 		"vite": "^5.0.12",
 		"vite-plugin-dts": "^3.7.2"
--- a/src/aset.ts
+++ b/src/aset.ts
@ -1,3 +1,5 @@
 import {isEqual} from './objects.ts';
 /**
 * An array which functions as a set. It guarantees unique elements
 * and provides set functions for comparisons
@ -19,20 +21,24 @@ export class ASet<T> extends Array {
 	}
 	/**
-	 * Add single element to set if unique
+	 * Add elements to set if unique
-	 * @param {T} el Element to add
+	 * @param items
 	 */
-	add(el: T) {
+	add(...items: T[]) {
-		if(!this.has(el)) this.push(el);
+		items.filter(el => !this.has(el)).forEach(el => this.push(el));
 		return this;
 	}
 	/**
-	 * Delete element from set
+	 * Delete elements from set
-	 * @param {T} el Element that will be deleted
+	 * @param items Elements that will be deleted
 	 */
-	delete(el: T) {
+	delete(...items: T[]) {
 		items.forEach(el => {
 			const index = this.indexOf(el);
-		if(index != -1) this.slice(index, 1);
+			if(index != -1) this.splice(index, 1);
 		})
 		return this;
 	}
 	/**
@ -53,6 +59,17 @@ export class ASet<T> extends Array {
 		return this.indexOf(el) != -1;
 	}
 	/**
 	 * Find index number of element, or -1 if it doesn't exist. Matches by equality not reference
 	 *
 	 * @param {T} search Element to find
 	 * @param {number} fromIndex Starting index position
 	 * @return {number} Element index number or -1 if missing
 	 */
 	indexOf(search: T, fromIndex?: number): number {
 		return super.findIndex((el: T) => isEqual(el, search), fromIndex);
 	}
 	/**
 	 * Create list of elements this set has in common with the comparison set
 	 * @param {ASet<T>} set Set to compare against
--- a/src/cache.ts
+++ b/src/cache.ts
@ -1,8 +1,20 @@
 export type CacheOptions = {
 	/** Delete keys automatically after x amount of seconds */
 	ttl?: number;
 	/** Storage to persist cache */
 	storage?: Storage;
 	/** Key cache will be stored under */
 	storageKey?: string;
 }
 /**
 * Map of data which tracks whether it is a complete collection & offers optional expiry of cached values
 */
-export class Cache<K, T> extends Map<K, T> {
+export class Cache<K extends string | number | symbol, T> {
 	private store = <Record<K, T>>{};
 	/** Support index lookups */
 	[key: string | number | symbol]: T | any;
 	/** Whether cache is complete */
 	complete = false;
@ -10,13 +22,33 @@ export class Cache<K, T> extends Map<K, T> {
 	 * Create new cache
 	 *
 	 * @param {keyof T} key Default property to use as primary key
-	 * @param {number} ttl Default expiry in milliseconds
+	 * @param options
 	 */
-	constructor(public readonly key: keyof T, public ttl?: number) {
+	constructor(public readonly key?: keyof T, public readonly options: CacheOptions = {}) {
-		super();
+		if(options.storageKey && !options.storage && typeof(Storage) !== 'undefined')
 			options.storage = localStorage;
 		if(options.storageKey && options.storage) {
 			const stored = options.storage.getItem(options.storageKey);
 			if(stored) {
 				try { Object.assign(this.store, JSON.parse(stored)); }
 				catch { }
 			}
 		}
 		return new Proxy(this, {
 			get: (target: this, prop: string | symbol) => {
 				if (prop in target) return (target as any)[prop];
 				return target.store[prop as K];
 			},
 			set: (target: this, prop: string | symbol, value: any) => {
 				if (prop in target) (target as any)[prop] = value;
 				else target.store[prop as K] = value;
 				return true;
 			}
 		});
 	}
 	private getKey(value: T): K {
 		if(!this.key) throw new Error('No key defined');
 		return <K>value[this.key];
 	}
@ -25,8 +57,8 @@ export class Cache<K, T> extends Map<K, T> {
 	 *
 	 * @return {T[]} Array of items
 	 */
-	all() {
+	all(): T[] {
-		return Array.from(this.values());
+		return Object.values(this.store);
 	}
 	/**
@ -55,19 +87,82 @@ export class Cache<K, T> extends Map<K, T> {
 		return this;
 	}
 	/**
 	 * Remove all keys from cache
 	 */
 	clear() {
 		this.store = <Record<K, T>>{};
 	}
 	/**
 	 * Delete an item from the cache
 	 *
 	 * @param {K} key Item's primary key
 	 */
 	delete(key: K) {
 		delete this.store[key];
 		if(this.options.storageKey && this.options.storage)
 			this.options.storage.setItem(this.options.storageKey, JSON.stringify(this.store));
 	}
 	/**
 	 * Return cache as an array of key-value pairs
 	 * @return {[K, T][]} Key-value pairs array
 	 */
 	entries(): [K, T][] {
 		return <[K, T][]>Object.entries(this.store);
 	}
 	/**
 	 * Get item from the cache
 	 * @param {K} key Key to lookup
 	 * @return {T} Cached item
 	 */
 	get(key: K): T {
 		return this.store[key];
 	}
 	/**
 	 * Get a list of cached keys
 	 *
 	 * @return {K[]} Array of keys
 	 */
 	keys(): K[] {
 		return <K[]>Object.keys(this.store);
 	}
 	/**
 	 * Get map of cached items
 	 *
 	 * @return {Record<K, T>}
 	 */
 	map(): Record<K, T> {
 		return structuredClone(this.store);
 	}
 	/**
 	 * Add an item to the cache manually specifying the key
 	 *
 	 * @param {K} key Key item will be cached under
 	 * @param {T} value Item to cache
-	 * @param {number | undefined} ttl Override default expiry
+	 * @param {number | undefined} ttl Override default expiry in seconds
 	 * @return {this}
 	 */
-	set(key: K, value: T, ttl = this.ttl): this {
+	set(key: K, value: T, ttl = this.options.ttl): this {
-		super.set(key, value);
+		this.store[key] = value;
 		if(this.options.storageKey && this.options.storage)
 			this.options.storage.setItem(this.options.storageKey, JSON.stringify(this.store));
 		if(ttl) setTimeout(() => {
 			this.complete = false;
-			super.delete(key)
+			this.delete(key);
-		}, ttl);
+		}, ttl * 1000);
 		return this;
 	}
 	/**
 	 * Get all cached items
 	 *
 	 * @return {T[]} Array of items
 	 */
 	values = this.all();
 }
--- a/src/emitter.ts
+++ b/src/emitter.ts
@ -1,29 +1,33 @@
-export type Listener = (...args: any[]) => any;
+export type TypedListener = (...args: any[]) => any;
-export type TypedEvents = {[k in string | symbol]: Listener} & {'*': (event: string, ...args: any[]) => any};
+export type TypedEvents = {[k in string | symbol]: TypedListener} & {'*': (event: string, ...args: any[]) => any};
 export type NamespaceEvents<Namespace extends string, Events extends TypedEvents> = {
 	[K in keyof Events as `${Namespace}:${Extract<K, string>}`]: Events[K];
 };
 export class TypedEmitter<T extends TypedEvents = TypedEvents> {
-	private static listeners: {[key: string]: Listener[]} = {};
+	private static listeners: {[key: string]: TypedListener[]} = {};
-	private listeners: { [key in keyof T]?: Listener[] } = {};
+	private listeners: { [key in keyof T]?: TypedListener[] } = {};
 	static emit(event: any, ...args: any[]) {
 		(this.listeners['*'] || []).forEach(l => l(event, ...args));
 		(this.listeners[event.toString()] || []).forEach(l => l(...args));
 	};
-	static off(event: any, listener: Listener) {
+	static off(event: any, listener: TypedListener) {
 		const e = event.toString();
 		this.listeners[e] = (this.listeners[e] || []).filter(l => l === listener);
 	}
-	static on(event: any, listener: Listener) {
+	static on(event: any, listener: TypedListener) {
 		const e = event.toString();
 		if(!this.listeners[e]) this.listeners[e] = [];
 		this.listeners[e]?.push(listener);
 		return () => this.off(event, listener);
 	}
-	static once(event: any, listener?: Listener): Promise<any> {
+	static once(event: any, listener?: TypedListener): Promise<any> {
 		return new Promise(res => {
 			const unsubscribe = this.on(event, <any>((...args: any) => {
 				res(args.length == 1 ? args[0] : args);
--- a/src/errors.ts
+++ b/src/errors.ts
@ -180,7 +180,6 @@ export class GatewayTimeoutError extends CustomError {
 * @return {CustomError} The proper error type
 */
 export function errorFromCode(code: number, message?: string) {
 	if(code >= 200 && code < 300) return null;
 	switch(code) {
 		case 400:
 			return new BadRequestError(message);
--- a/src/http.ts
+++ b/src/http.ts
@ -75,6 +75,7 @@ export class Http {
 		// Send request
 		return new PromiseProgress((res, rej, prog) => {
 			try {
 				fetch(url, {
 					headers,
 					method: opts.method || (opts.body ? 'POST' : 'GET'),
@ -100,6 +101,7 @@ export class Http {
 									push();
 								}).catch((error: any) => controller.error(error));
 							}
 							push();
 						}
 					});
@ -115,7 +117,10 @@ export class Http {
 					if(resp.ok) res(resp);
 					else rej(resp);
-			})
+				}).catch(err => rej(err));
 			} catch(err) {
 				rej(err);
 			}
 		});
 	}
 }
--- a/src/index.ts
+++ b/src/index.ts
@ -6,10 +6,12 @@ export * from './files';
 export * from './emitter';
 export * from './errors';
 export * from './http';
 export * from './jwt';
 export * from './logger';
 export * from './math';
 export * from './misc';
 export * from './objects';
 export * from './path-events';
 export * from './promise-progress';
 export * from './string';
 export * from './time';
--- a/src/jwt.ts
+++ b/src/jwt.ts
@ -0,0 +1,15 @@
 import {JSONAttemptParse} from './objects.ts';
 /**
 * Decode a JWT payload, this will not check for tampering so be careful
 *
 * @param {string} token JWT to decode
 * @return {unknown} JWT payload
 */
 export function jwtDecode<T>(token: string): T {
 	const base64 = token.split('.')[1]
 		.replace(/-/g, '+').replace(/_/g, '/');
 	return <T>JSONAttemptParse(decodeURIComponent(atob(base64).split('').map(function(c) {
 		return '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2);
 	}).join('')));
 }
--- a/src/logger.ts
+++ b/src/logger.ts
@ -1,4 +1,5 @@
 import {TypedEmitter, TypedEvents} from './emitter';
 import {JSONSanitize} from './objects.ts';
 export const CliEffects = {
 	CLEAR: "\x1b[0m",
@ -64,49 +65,41 @@ export class Logger extends TypedEmitter<LoggerEvents> {
 		super();
 	}
-	private pad(text: any, length: number, char: string, end = false) {
+	protected format(...text: any[]): string {
 		const t = text.toString();
 		const l = length - t.length;
 		if(l <= 0) return t;
 		const padding = Array(~~(l / char.length)).fill(char).join('');
 		return !end ? padding + t : t + padding;
 	}
 	private format(...text: string[]): string {
 		const now = new Date();
-		const timestamp = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ${this.pad(now.getHours().toString(), 2, '0')}:${this.pad(now.getMinutes().toString(), 2, '0')}:${this.pad(now.getSeconds().toString(), 2, '0')}.${this.pad(now.getMilliseconds().toString(), 3, '0', true)}`;
+		const timestamp = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ${now.getHours().toString().padStart(2, '0')}:${now.getMinutes().toString().padStart(2, '0')}:${now.getSeconds().toString().padStart(2, '0')}.${now.getMilliseconds().toString().padEnd(3, '0')}`;
-		return `${timestamp}${this.namespace ? ` [${this.namespace}]` : ''} ${text.join(' ')}`;
+		return `${timestamp}${this.namespace ? ` [${this.namespace}]` : ''} ${text.map(t => typeof t == 'string' ? t : JSONSanitize(t, 2)).join(' ')}`;
 	}
-	debug(...args: string[]) {
+	debug(...args: any[]) {
 		if(Logger.LOG_LEVEL < LOG_LEVEL.DEBUG) return;
 		const str = this.format(...args);
 		Logger.emit(LOG_LEVEL.DEBUG, str);
 		console.debug(CliForeground.LIGHT_GREY + str + CliEffects.CLEAR);
 	}
-	log(...args: string[]) {
+	log(...args: any[]) {
 		if(Logger.LOG_LEVEL < LOG_LEVEL.LOG) return;
 		const str = this.format(...args);
 		Logger.emit(LOG_LEVEL.LOG, str);
 		console.log(CliEffects.CLEAR + str);
 	}
-	info(...args: string[]) {
+	info(...args: any[]) {
 		if(Logger.LOG_LEVEL < LOG_LEVEL.INFO) return;
 		const str = this.format(...args);
 		Logger.emit(LOG_LEVEL.INFO, str);
 		console.info(CliForeground.BLUE + str + CliEffects.CLEAR);
 	}
-	warn(...args: string[]) {
+	warn(...args: any[]) {
 		if(Logger.LOG_LEVEL < LOG_LEVEL.WARN) return;
 		const str = this.format(...args);
 		Logger.emit(LOG_LEVEL.WARN, str);
 		console.warn(CliForeground.YELLOW + str + CliEffects.CLEAR);
 	}
-	error(...args: string[]) {
+	error(...args: any[]) {
 		if(Logger.LOG_LEVEL < LOG_LEVEL.ERROR) return;
 		const str = this.format(...args);
 		Logger.emit(LOG_LEVEL.ERROR, str);
--- a/src/misc.ts
+++ b/src/misc.ts
@ -1,3 +1,4 @@
 import {PathEvent} from './path-events.ts';
 import {md5} from './string';
 /**
@ -11,3 +12,16 @@ export function gravatar(email: string, def='mp') {
 	if(!email) return '';
 	return `https://www.gravatar.com/avatar/${md5(email)}?d=${def}`;
 }
 /**
 * 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, '\\$&');
 }
 export type Listener = (event: PathEvent, ...args: any[]) => any;
 export type Unsubscribe = () => void;
--- a/src/path-events.ts
+++ b/src/path-events.ts
@ -0,0 +1,279 @@
 import {makeArray} from './array.ts';
 import {ASet} from './aset.ts';
 /**
 * Available methods:
 * * - All/Wildcard
 * n - None
 * c - Create
 * r - Read
 * u - Update
 * d - Delete
 * x - Execute
 */
 export type Method = '*' | 'n' | 'c' | 'r' | 'u' | 'd' | 'x';
 /**
 * Shorthand for creating Event from a string
 *
 * @example
 * ```ts
 * const event: Event = PE`users/system:*`;
 * ```
 *
 * @param {TemplateStringsArray} str String that will be parsed into Event
 * @param {string} args
 * @return {PathEvent} Event object
 */
 export function PE(str: TemplateStringsArray, ...args: string[]) {
 	const combined = [];
 	for(let i = 0; i < str.length || i < args.length; i++) {
 		if(str[i]) combined.push(str[i]);
 		if(args[i]) combined.push(args[i]);
 	}
 	return new PathEvent(combined.join(''));
 }
 /**
 * Shorthand for creating Event strings, ensures paths are correct
 *
 * @param {TemplateStringsArray} str
 * @param {string} args
 * @return {string}
 * @constructor
 */
 export function PES(str: TemplateStringsArray, ...args: any[]) {
 	let combined = [];
 	for(let i = 0; i < str.length || i < args.length; i++) {
 		if(str[i]) combined.push(str[i]);
 		if(args[i]) combined.push(args[i]);
 	}
 	const [paths, methods] = combined.join('').split(':');
 	return PathEvent.toString(paths, <any>methods?.split(''));
 }
 export class PathError extends Error { }
 /**
 * A  event broken down into its core components for easy processing
 * Event Structure: `module/path/name:property:method`
 * Example: `users/system:crud` or `storage/some/path/file.txt:r`
 */
 export class PathEvent {
 	/** First directory in path */
 	module!: string;
 	/** Entire path, including the module & name */
 	fullPath!: string;
 	/** Path including the name, excluding the module */
 	path!: string;
 	/** Last sagment of path */
 	name!: string;
 	/** List of methods */
 	methods!: ASet<Method>;
 	/** All/Wildcard specified */
 	get all(): boolean { return this.methods.has('*') }
 	set all(v: boolean) { v ? new ASet<Method>(['*']) : this.methods.delete('*'); }
 	/** None specified */
 	get none(): boolean { return this.methods.has('n') }
 	set none(v: boolean) { v ? this.methods = new ASet<Method>(['n']) : this.methods.delete('n'); }
 	/** Create method specified */
 	get create(): boolean { return !this.methods.has('n') && (this.methods.has('*') || this.methods.has('c')) }
 	set create(v: boolean) { v ? this.methods.delete('n').add('c') : this.methods.delete('c'); }
 	/** Read method specified */
 	get read(): boolean { return !this.methods.has('n') && (this.methods.has('*') || this.methods.has('r')) }
 	set read(v: boolean) { v ? this.methods.delete('n').add('r') : this.methods.delete('r'); }
 	/** Update method specified */
 	get update(): boolean { return !this.methods.has('n') && (this.methods.has('*') || this.methods.has('u')) }
 	set update(v: boolean) { v ? this.methods.delete('n').add('u') : this.methods.delete('u'); }
 	/** Delete method specified */
 	get delete(): boolean { return !this.methods.has('n') && (this.methods.has('*') || this.methods.has('d')) }
 	set delete(v: boolean) { v ? this.methods.delete('n').add('d') : this.methods.delete('d'); }
 	constructor(Event: string | PathEvent) {
 		if(typeof Event == 'object') return Object.assign(this, Event);
 		let [p, scope, method] = Event.split(':');
 		if(!method) method = scope || '*';
 		if(p == '*' || !p && method == '*') {
 			p = '';
 			method = '*';
 		}
 		let temp = p.split('/').filter(p => !!p);
 		this.module = temp.splice(0, 1)[0]?.toLowerCase() || '';
 		this.fullPath = p;
 		this.path = temp.join('/');
 		this.name = temp.pop() || '';
 		this.methods = new ASet(<any>method.split(''));
 	}
 	/**
 	 * Combine multiple  events into one parsed object. Longest path takes precedent, but all subsequent methods are
 	 * combined until a "none" is reached
 	 *
 	 * @param {string | PathEvent} paths Events as strings or pre-parsed
 	 * @return {PathEvent} Final combined permission
 	 */
 	static combine(...paths: (string | PathEvent)[]): PathEvent {
 		let hitNone = false;
 		const combined = paths.map(p => new PathEvent(p))
 			.toSorted((p1, p2) => {
 				const l1 = p1.fullPath.length, l2 = p2.fullPath.length;
 				return l1 < l2 ? 1 : (l1 > l2 ? -1 : 0);
 			}).reduce((acc, p) => {
 				if(p.none) hitNone = true;
 				if(!acc) return p;
 				if(hitNone) return acc;
 				acc.methods = [...acc.methods, ...p.methods];
 				return acc;
 			}, <any>null);
 		combined.methods = new ASet<Method>(combined.methods);
 		return combined;
 	}
 	/**
 	 * Filter a set of paths based on the target
 	 *
 	 * @param {string | PathEvent | (string | PathEvent)[]} target Array of events that will filtered
 	 * @param filter {...PathEvent} Must container one of
 	 * @return {boolean} Whether there is any overlap
 	 */
 	static filter(target: string | PathEvent | (string | PathEvent)[], ...filter: (string | PathEvent)[]): PathEvent[] {
 		const parsedTarget = makeArray(target).map(pe => new PathEvent(pe));
 		const parsedFind = makeArray(filter).map(pe => new PathEvent(pe));
 		return parsedTarget.filter(t => {
 			if(!t.fullPath && t.all) return true;
 			return !!parsedFind.find(f => t.fullPath.startsWith(f.fullPath)
 				&& (f.all || t.all || t.methods.intersection(f.methods).length));
 		});
 	}
 	/**
 	 * Squash 2 sets of paths & return true if any overlap is found
 	 *
 	 * @param {string | PathEvent | (string | PathEvent)[]} target Array of Events as strings or pre-parsed
 	 * @param has Target must have at least one of these path
 	 * @return {boolean} Whether there is any overlap
 	 */
 	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));
 		return !!parsedRequired.find(r => {
 			if(!r.fullPath && r.all) return true;
 			const filtered = parsedTarget.filter(p => r.fullPath.startsWith(p.fullPath));
 			if(!filtered.length) return false;
 			const combined = PathEvent.combine(...filtered);
 			return (!combined.none && (combined.all || r.all)) || combined.methods.intersection(r.methods).length;
 		});
 	}
 	/**
 	 * Squash 2 sets of paths & return true if the target has all paths
 	 *
 	 * @param {string | PathEvent | (string | PathEvent)[]} target Array of Events as strings or pre-parsed
 	 * @param has Target must have all these paths
 	 * @return {boolean} Whether there is any overlap
 	 */
 	static hasAll(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): boolean {
 		return has.filter(h => PathEvent.has(target, h)).length == has.length;
 	}
 	/**
 	 * Same as `has` but raises an error if there is no overlap
 	 *
 	 * @param {string | string[]} target Array of Events as strings or pre-parsed
 	 * @param has Target must have at least one of these path
 	 */
 	static hasFatal(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): void {
 		if(!PathEvent.has(target, ...has)) throw new PathError(`Requires one of: ${makeArray(has).join(', ')}`);
 	}
 	/**
 	 * Same as `hasAll` but raises an error if the target is missing any paths
 	 *
 	 * @param {string | string[]} target Array of Events as strings or pre-parsed
 	 * @param has Target must have all these paths
 	 */
 	static hasAllFatal(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): void {
 		if(!PathEvent.hasAll(target, ...has)) throw new PathError(`Requires all: ${makeArray(has).join(', ')}`);
 	}
 	/**
 	 * Create  event string from its components
 	 *
 	 * @param {string | string[]} path Event path
 	 * @param {Method} methods Event method
 	 * @return {string} String representation of Event
 	 */
 	static toString(path: string | string[], methods: Method | Method[]): string {
 		let p = makeArray(path).filter(p => p != null).join('/');
 		p = p?.trim().replaceAll(/\/{2,}/g, '/').replaceAll(/(^\/|\/$)/g, '');
 		if(methods?.length) p += `:${makeArray(methods).map(m => m.toLowerCase()).join('')}`;
 		return p;
 	}
 	/**
 	 * Filter a set of paths based on this event
 	 *
 	 * @param {string | PathEvent | (string | PathEvent)[]} target Array of events that will filtered
 	 * @return {boolean} Whether there is any overlap
 	 */
 	filter(target: string | PathEvent | (string | PathEvent)[]): PathEvent[] {
 		return PathEvent.filter(target, this);
 	}
 	/**
 	 * Create  event string from its components
 	 *
 	 * @return {string} String representation of Event
 	 */
 	toString() {
 		return PathEvent.toString(this.fullPath, this.methods);
 	}
 }
 export type PathListener = (event: PathEvent, ...args: any[]) => any;
 export type PathUnsubscribe = () => void;
 export interface IPathEventEmitter {
 	emit(event: string, ...args: any[]): void;
 	off(listener: PathListener): void;
 	on(event: string, listener: PathListener): PathUnsubscribe;
 	once(event: string, listener?: PathListener): Promise<any>;
 	relayEvents(emitter: PathEventEmitter): void;
 }
 /**
 * Event emitter that uses paths allowing listeners to listen to different combinations of modules, paths & methods
 */
 export class PathEventEmitter implements IPathEventEmitter{
 	private listeners: [PathEvent, PathListener][] = [];
 	emit(event: string | PathEvent, ...args: any[]) {
 		const parsed = new PathEvent(event);
 		this.listeners.filter(l => PathEvent.has(l[0], event))
 			.forEach(async l => l[1](parsed, ...args));
 	};
 	off(listener: PathListener) {
 		this.listeners = this.listeners.filter(l => l[1] != listener);
 	}
 	on(event: string | string[], listener: PathListener): PathUnsubscribe {
 		makeArray(event).forEach(e => this.listeners.push([new PathEvent(e), listener]));
 		return () => this.off(listener);
 	}
 	once(event: string | string[], listener?: PathListener): Promise<any> {
 		return new Promise(res => {
 			const unsubscribe = this.on(event, (event: PathEvent, ...args: any[]) => {
 				res(args.length < 2 ? args[0] : args);
 				if(listener) listener(event, ...args);
 				unsubscribe();
 			});
 		});
 	}
 	relayEvents(emitter: IPathEventEmitter) {
 		emitter.on('*', (event, ...args) => this.emit(event, ...args));
 	}
 }
--- a/src/time.ts
+++ b/src/time.ts
@ -1,3 +1,25 @@
 /**
 * Like setInterval but will adjust the timeout value to account for runtime
 * @param {Function} cb Callback function that will be ran
 * @param {number} ms Run function ever x seconds
 * @return {() => void}
 */
 export function adjustedInterval(cb: Function, ms: number) {
 	let cancel = false, timeout: any = null;
 	const p = async () => {
 		if (cancel) return;
 		const start = new Date().getTime();
 		await cb();
 		const end = new Date().getTime();
 		timeout = setTimeout(() => p(), ms - (end - start) || 1);
 	};
 	p();
 	return () => {
 		cancel = true;
 		if(timeout) clearTimeout(timeout);
 	}
 }
 /**
 * Return date formated highest to lowest: YYYY-MM-DD H:mm AM
 *
@ -36,14 +58,14 @@ export function sleep(ms: number): Promise<void> {
 * ```js
 * let loading = true;
 * setTimeout(() => wait = false, 1000);
- * await sleepUntil(() => loading); // Won't continue until loading flag is false
+ * await sleepWhile(() => loading); // Won't continue until loading flag is false
 * ```
 *
 * @param {() => boolean | Promise<boolean>} fn Return true to continue
 * @param {number} checkInterval Run function ever x milliseconds
 * @return {Promise<void>} Callback when sleep is over
 */
-export async function sleepUntil(fn : () => boolean | Promise<boolean>, checkInterval = 100): Promise<void> {
+export async function sleepWhile(fn : () => boolean | Promise<boolean>, checkInterval = 100): Promise<void> {
 	while(await fn()) await sleep(checkInterval);
 }
--- a/vite.config.ts
+++ b/vite.config.ts
@ -13,7 +13,7 @@ export default defineConfig({
 			}
 		},
 		emptyOutDir: true,
-		minify: true,
+		minify: false,
 		sourcemap: true
 	},
 	plugins: [dts()],
Author	SHA1	Message	Date
ztimson	db18c010aa	Added adjusted interval & set errorFromCode to always return an error even on 200's All checks were successful Build / Build NPM Project (push) Successful in 1m16s Details Build / Tag Version (push) Successful in 14s Details Build / Publish Documentation (push) Successful in 2m1s Details	2024-10-29 10:41:25 -04:00
ztimson	b292d5ed17	PathEvents has none fix All checks were successful Build / Build NPM Project (push) Successful in 36s Details Build / Tag Version (push) Successful in 10s Details Build / Publish Documentation (push) Successful in 1m47s Details	2024-10-23 21:39:42 -04:00
ztimson	a1ea8cdf67	Added filter function to path events All checks were successful Build / Build NPM Project (push) Successful in 37s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 1m46s Details	2024-10-23 14:13:47 -04:00
ztimson	fbbe3c99ef	Updated ASet & Path Events All checks were successful Build / Build NPM Project (push) Successful in 37s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 1m43s Details	2024-10-17 10:24:18 -04:00
ztimson	1c1a3f6a6e	Updated ASet & Path Events All checks were successful Build / Build NPM Project (push) Successful in 36s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 1m40s Details	2024-10-17 00:36:53 -04:00
ztimson	2dce1ad9ac	Object logging with formatting All checks were successful Build / Build NPM Project (push) Successful in 39s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 35s Details	2024-10-16 20:32:41 -04:00
ztimson	cebfd2c508	Object logging with formatting All checks were successful Build / Build NPM Project (push) Successful in 40s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 35s Details	2024-10-16 20:28:56 -04:00
ztimson	7c5cf3535d	Handle logging objects All checks were successful Build / Build NPM Project (push) Successful in 39s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 35s Details	2024-10-16 20:21:35 -04:00
ztimson	847b493772	Handle logging objects All checks were successful Build / Build NPM Project (push) Successful in 38s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 34s Details	2024-10-16 19:55:35 -04:00
ztimson	b1005227ab	Added PathError for easy detection All checks were successful Build / Build NPM Project (push) Successful in 43s Details Build / Tag Version (push) Successful in 8s Details Build / Publish Documentation (push) Successful in 38s Details	2024-10-16 19:52:47 -04:00
ztimson	3a389de72e	Cache localstorage fix All checks were successful Build / Build NPM Project (push) Successful in 38s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 35s Details	2024-10-15 16:44:23 -04:00
ztimson	151465aa65	Cache localstorage fix All checks were successful Build / Build NPM Project (push) Successful in 39s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 36s Details	2024-10-15 16:39:29 -04:00
ztimson	b103b6f786	Cache localstorage fix All checks were successful Build / Build NPM Project (push) Successful in 38s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 34s Details	2024-10-15 16:35:11 -04:00
ztimson	3b486310de	Deleting lock file, seems to mess up build All checks were successful Build / Build NPM Project (push) Successful in 1m4s Details Build / Tag Version (push) Successful in 11s Details Build / Publish Documentation (push) Successful in 46s Details	2024-10-15 13:51:00 -04:00
ztimson	8699fb49ff	New lock file Some checks failed Build / Build NPM Project (push) Failing after 18s Details Build / Tag Version (push) Has been skipped Details Build / Publish Documentation (push) Has been skipped Details	2024-10-15 13:49:52 -04:00
ztimson	fdb29e7984	New lock file Some checks failed Build / Tag Version (push) Blocked by required conditions Details Build / Publish Documentation (push) Blocked by required conditions Details Build / Build NPM Project (push) Has been cancelled Details	2024-10-15 13:49:17 -04:00
ztimson	274c22bb83	Fixed localStorage access on node environments Some checks failed Build / Build NPM Project (push) Failing after 15s Details Build / Tag Version (push) Has been skipped Details Build / Publish Documentation (push) Has been skipped Details	2024-10-15 13:46:11 -04:00
ztimson	b21f462d35	Added clear function to cache All checks were successful Build / Build NPM Project (push) Successful in 37s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 35s Details	2024-10-14 21:07:59 -04:00
ztimson	0f10aebfd2	bubble up all fetch errors in the http helper All checks were successful Build / Build NPM Project (push) Successful in 40s Details Build / Tag Version (push) Successful in 8s Details Build / Publish Documentation (push) Successful in 36s Details	2024-10-14 20:46:32 -04:00
ztimson	1af23ac544	Fixed cache localstorage All checks were successful Build / Build NPM Project (push) Successful in 37s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 34s Details	2024-10-14 20:04:29 -04:00
ztimson	494cfaaccd	Added localStorage support to cache All checks were successful Build / Build NPM Project (push) Successful in 41s Details Build / Tag Version (push) Successful in 8s Details Build / Publish Documentation (push) Successful in 41s Details	2024-10-14 18:51:24 -04:00
ztimson	23df6ad265	Renamed PathEventEmitter to follow convention All checks were successful Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 27s Details	2024-10-14 14:09:51 -04:00
ztimson	2fda11f3b7	Renamed PathEventEmitter to follow convention All checks were successful Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 26s Details	2024-10-14 14:06:06 -04:00
ztimson	379de273c4	Added path-events All checks were successful Build / Build NPM Project (push) Successful in 31s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 28s Details	2024-10-14 13:52:03 -04:00
ztimson	c51239d12b	Bump 0.18.2 All checks were successful Build / Build NPM Project (push) Successful in 25s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 26s Details	2024-10-12 12:30:23 -04:00
ztimson	e4229296c1	Added escapeRegex All checks were successful Build / Build NPM Project (push) Successful in 59s Details Build / Tag Version (push) Successful in 14s Details Build / Publish Documentation (push) Successful in 42s Details	2024-10-12 12:27:45 -04:00
ztimson	b93ed45521	Renamed sleepUntil to sleepWhile, it was misleading All checks were successful Build / Build NPM Project (push) Successful in 1m5s Details Build / Tag Version (push) Successful in 14s Details Build / Publish Documentation (push) Successful in 39s Details	2024-10-07 15:40:14 -04:00
ztimson	3e8f5cc00b	Add or remove multiple elements from ASet at once All checks were successful Build / Build NPM Project (push) Successful in 30s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 27s Details	2024-10-06 19:14:36 -04:00
ztimson	54a2880391	Updated docs All checks were successful Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 25s Details	2024-10-01 15:44:49 -04:00
ztimson	b7aeee4706	Fixing docker container All checks were successful Build / Build NPM Project (push) Successful in 25s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 25s Details	2024-10-01 15:39:24 -04:00
ztimson	b3eab0d6c9	Created docs docker container All checks were successful Build / Build NPM Project (push) Successful in 26s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Successful in 19s Details	2024-10-01 15:22:48 -04:00
ztimson	ad4194a981	Fixed extracting version number during build Some checks failed Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Failing after 8s Details	2024-10-01 15:13:47 -04:00
ztimson	e1f22a01a6	Added docs container Some checks failed Build / Build NPM Project (push) Successful in 31s Details Build / Tag Version (push) Successful in 7s Details Build / Publish Documentation (push) Failing after 5s Details	2024-10-01 15:08:52 -04:00
ztimson	91c0858d9f	Added var-persist All checks were successful Build / Build NPM Project (push) Successful in 28s Details Build / Tag Version (push) Successful in 6s Details	2024-09-30 21:43:13 -04:00
ztimson	8094b6507f	Updated cache indexing signature All checks were successful Build / Build NPM Project (push) Successful in 26s Details Build / Tag Version (push) Successful in 7s Details	2024-09-30 19:39:06 -04:00
ztimson	e40f410830	Removed window reference from jwtDecode All checks were successful Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details	2024-09-30 16:18:07 -04:00
ztimson	c1043e65e2	Added jwtDecode function All checks were successful Build / Build NPM Project (push) Successful in 27s Details Build / Tag Version (push) Successful in 7s Details	2024-09-30 16:02:21 -04:00
ztimson	67d9928a61	Added jwtDecode function All checks were successful Build / Build NPM Project (push) Successful in 31s Details Build / Tag Version (push) Successful in 6s Details	2024-09-30 15:58:37 -04:00
ztimson	e6636d373b	Updated cache All checks were successful Build / Build NPM Project (push) Successful in 26s Details Build / Tag Version (push) Successful in 6s Details	2024-09-28 14:41:43 -04:00
ztimson	811d797e1b	Updated cache All checks were successful Build / Build NPM Project (push) Successful in 25s Details Build / Tag Version (push) Successful in 6s Details	2024-09-28 10:45:03 -04:00
ztimson	0909c4f648	Updated cache All checks were successful Build / Build NPM Project (push) Successful in 25s Details Build / Tag Version (push) Successful in 6s Details	2024-09-28 10:30:20 -04:00