@oardi/ts-utils 0.0.21 → 0.0.22

package/helpers/download.helper.ts

@@ -1,127 +0,0 @@
-export type SaveSource = Blob | ArrayBuffer | Uint8Array | string;
-
-export interface SaveOptions {
-	mimeType?: string;	/** MIME-Type, falls `source` kein Blob ist (z. B. "application/pdf") */
-	showSaveFilePicker?: boolean;
-}
-
-/**
- * save file on client
- *
- * 1) File System Access API (showSaveFilePicker) – if supported
- * 2) Fallback: <a download> + blob: URL
- * 3) iOS-/Safari-Fallback: open new Tab if download-attribute is being ignored
- */
-export async function saveAs(source: SaveSource, fileName: string, options?: SaveOptions): Promise<void> {
-	const mime: string = options?.mimeType ?? guessMimeFromFilename(fileName);
-	const blob: Blob = ensureBlob(source, mime);
-
-	// 1) experimental - feature check
-	if ('showSaveFilePicker' in window && options?.showSaveFilePicker) {
-		try {
-			const handle: FileSystemFileHandle = await (
-				window as unknown as {
-					showSaveFilePicker: (opts: {
-						suggestedName?: string;
-						types?: { description?: string; accept: Record<string, string[]> }[];
-					}) => Promise<FileSystemFileHandle>;
-				}
-			).showSaveFilePicker({
-				suggestedName: fileName,
-				types: [{ description: 'Datei', accept: { [mime]: [`.${extOf(fileName)}`] } }],
-			});
-
-			const writable: FileSystemWritableFileStream = await handle.createWritable();
-			await writable.write(blob);
-			await writable.close();
-			return;
-		} catch (err) {
-			// Abbruch durch Nutzer oder fehlende Berechtigung -> auf Fallback gehen
-			// (keine Early-Return mitten in der Funktion – wir laufen weiter)
-		}
-	}
-
-	// 2) classic: <a download> + blob: URL
-	const url: string = URL.createObjectURL(blob);
-
-	// In iOS Safari kann `download` für blob:-URLs ignoriert werden.
-	// Wir versuchen es zuerst regulär, und fallbacken dann auf "neuen Tab öffnen".
-	const anchor: HTMLAnchorElement = document.createElement('a');
-	anchor.href = url;
-	anchor.download = fileName;
-	anchor.rel = 'noopener'; // gute Praxis
-	anchor.style.display = 'none';
-	document.body.appendChild(anchor);
-
-	triggerClick(anchor);
-
-	// Kurzer Delay, dann Cleanup + optionaler iOS-Fallback
-	window.setTimeout(() => {
-		document.body.removeChild(anchor);
-		URL.revokeObjectURL(url);
-	}, 0);
-
-	// Heuristik: Wenn Safari das download-Attribut ignoriert, bleibt häufig dieselbe Seite,
-	// ohne dass ein Download-Dialog erscheint. Wir bieten dann eine Sicht-Alternative an.
-	// (Bewusst defensiv: wir öffnen nur, wenn `download` potenziell ignoriert wird.)
-	if (isProbablyIOSorOldSafari()) {
-		// Öffnet die Ressource in einem neuen Tab, damit der Nutzer manuell speichern kann.
-		// (Für PDFs & Bilder oft ausreichend; für Binärdateien hilft korrekter MIME-Type.)
-		window.open(url, '_blank', 'noopener,noreferrer');
-	}
-}
-
-function ensureBlob(source: SaveSource, mime: string): Blob {
-	if (source instanceof Blob) {
-		return source.type ? source : new Blob([source], { type: mime });
-	}
-	if (source instanceof ArrayBuffer || source instanceof Uint8Array) {
-		const buf: Uint8Array<ArrayBufferLike> = source instanceof Uint8Array ? source : new Uint8Array(source);
-		return new Blob([buf as BlobPart], { type: mime });
-	}
-	// string -> als Text-BLOB speichern
-	return new Blob([source], { type: mime || 'text/plain;charset=utf-8' });
-}
-
-function guessMimeFromFilename(filename: string): string {
-	const ext: string = extOf(filename).toLowerCase();
-	switch (ext) {
-		case 'txt':
-			return 'text/plain;charset=utf-8';
-		case 'csv':
-			return 'text/csv;charset=utf-8';
-		case 'json':
-			return 'application/json;charset=utf-8';
-		case 'pdf':
-			return 'application/pdf';
-		case 'png':
-			return 'image/png';
-		case 'jpg':
-		case 'jpeg':
-			return 'image/jpeg';
-		case 'svg':
-			return 'image/svg+xml';
-		case 'zip':
-			return 'application/zip';
-		default:
-			return 'application/octet-stream';
-	}
-}
-
-function extOf(filename: string): string {
-	const idx: number = filename.lastIndexOf('.');
-	return idx >= 0 && idx < filename.length - 1 ? filename.slice(idx + 1) : '';
-}
-
-function triggerClick(el: HTMLElement): void {
-	const evt: MouseEvent = document.createEvent('MouseEvents');
-	evt.initMouseEvent('click', true, true, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null);
-	el.dispatchEvent(evt);
-}
-
-function isProbablyIOSorOldSafari(): boolean {
-	const userAgent: string = navigator.userAgent;
-	const isIOS: boolean = /iPad|iPhone|iPod/.test(userAgent);
-	const isSafari: boolean = /^((?!chrome|android).)*safari/i.test(userAgent);
-	return isIOS || isSafari;
-}

package/helpers/enum.helper.ts

@@ -1,20 +0,0 @@
-import { IKeyValue } from '../interfaces/keyvalue.interface';
-
-export class EnumHelper {
-	static getEnumValue<T extends object>(enumObj: T, key: string): T[keyof T] {
-		if (!(key in enumObj)) {
-			throw Error(`${key} not found in ${enumObj}`);
-		} else {
-			return enumObj[key as keyof T];
-		}
-	}
-
-	static getKeyValues<T extends object>(enumObj: T): IKeyValue<string>[] {
-		return Object.keys(enumObj)
-			.filter(key => !isNaN(Number(key)))
-			.map(key => ({
-				key: Number(key),
-				value: enumObj[key as unknown as keyof T] as string,
-			}));
-	}
-}

package/helpers/file.helper.ts

@@ -1,105 +0,0 @@
-import { saveAs } from './download.helper';
-
-export class FileHelper {
-	static getFileExtension(filename: string): string {
-		let result: string = '';
-		const index: number = filename.lastIndexOf('.');
-		const hasExtension: boolean = index > 0 && index < filename.length - 1; // index > 0 verhindert z.B.: ".bashrc" als Extension
-		if (hasExtension) {
-			const ext: string = filename.substring(index + 1);
-			result = `.${ext.toLowerCase()}`;
-		}
-		return result;
-	}
-
-	/**
-	 * read content from a file or blob
-	 */
-	static readAsText(file: File): Promise<string> {
-		const fileReader: FileReader = new FileReader();
-		return new Promise((resolve, reject) => {
-			fileReader.onload = (): void => {
-				fileReader.onload = null;
-				fileReader.onerror = null;
-				if (typeof fileReader.result === 'string') {
-					resolve(fileReader.result);
-				} else {
-					reject(new Error('Unexpected result type'));
-				}
-			};
-			fileReader.onerror = (): void => {
-				const error = fileReader.error ?? new Error('FileReader error');
-				fileReader.onload = null;
-				fileReader.onerror = null;
-				reject(error);
-			};
-			fileReader.readAsText(file);
-		});
-	}
-
-	static readAsArrayBuffer(file: File): Promise<ArrayBuffer> {
-		const fileReader: FileReader = new FileReader();
-		return new Promise((resolve, reject) => {
-			fileReader.onload = (): void => {
-				fileReader.onload = null;
-				fileReader.onerror = null;
-				if (fileReader.result instanceof ArrayBuffer) {
-					resolve(fileReader.result);
-				} else {
-					reject(new Error('Unexpected result type'));
-				}
-			};
-			fileReader.onerror = (): void => {
-				const error = fileReader.error ?? new Error('FileReader error');
-				fileReader.onload = null;
-				fileReader.onerror = null;
-				reject(error);
-			};
-			fileReader.readAsArrayBuffer(file);
-		});
-	}
-
-	static readAsDataUrl(file: File): Promise<ProgressEvent<FileReader>> {
-		const reader: FileReader = new FileReader();
-		return new Promise((resolve, reject) => {
-			reader.onload = (event: ProgressEvent<FileReader>): void => {
-				resolve(event);
-			};
-			reader.onerror = (error): void => reject(error);
-			reader.readAsDataURL(file);
-		});
-	}
-
-	/** usage:
-	 * const file = new File(['Hello'], 'test.txt');
-	 * FileHelper.formatFileSize(file.size);
-	 * */
-	static formatFileSize(bytes: number, decimals: number = 2, unit?: 'Bytes' | 'KB' | 'MB' | 'GB' | 'TB'): string {
-		if (bytes === 0) {
-			return '0 Bytes';
-		}
-
-		const k = 1024;
-		const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-
-		let i = Math.floor(Math.log(bytes) / Math.log(k));
-
-		if (unit && sizes.includes(unit)) {
-			i = sizes.indexOf(unit);
-		}
-
-		const value = bytes / Math.pow(k, i);
-		const fixed = parseFloat(value.toFixed(decimals));
-
-		return `${fixed} ${sizes[i]}`;
-	}
-
-	static save(content: BlobPart, fileName: string, fileType: string): void {
-		const blob: Blob = new Blob([content], { type: fileType });
-		saveAs(blob, fileName);
-	}
-}
-
-// usage
-// const extension: string = FileHelper.getFileExtension('asdf.txt');
-// -> .txt

package/helpers/local-storage.helper.ts

@@ -1,30 +0,0 @@
-export class LocalStorageHelper {
-	static set<T>(key: string, value: T): void {
-		localStorage.setItem(key, JSON.stringify(value));
-	}
-
-	static get<T>(key: string): Nullable<T> {
-		let result: Nullable<T> = null;
-		const local: Nullable<string> = localStorage.getItem(key);
-		if (local) {
-			result = JSON.parse(local);
-		}
-		return result;
-	}
-
-	static remove(key: string): boolean {
-		let result: boolean = !!LocalStorageHelper.get(key);
-		if (result) {
-			localStorage.removeItem(key);
-		}
-		return result;
-	}
-
-	static removeAll(): void {
-		localStorage.clear();
-	}
-
-	static getKeysBy(key: string): string[] {
-		return Object.keys(localStorage).filter(k => k.startsWith(key));
-	}
-}

package/helpers/logger/index.ts

@@ -1 +0,0 @@
-export * from './logger.helper';

package/helpers/logger/logger-type.enum.ts

@@ -1,7 +0,0 @@
-export enum LoggerType {
-	log = 'log',
-	info = 'info',
-	warn = 'warn',
-	debug = 'debug',
-	error = 'error',
-}

package/helpers/logger/logger.helper.ts

@@ -1,63 +0,0 @@
-import { LoggerType } from './logger-type.enum';
-import { LoggerListener, LoggerPayload } from './logger.types';
-
-export class LoggerHelper {
-	private static listeners: Set<LoggerListener> = new Set();
-
-	public static log(...args: unknown[]): void {
-		LoggerHelper.doLog(LoggerType.log, args);
-	}
-
-	public static info(...args: unknown[]): void {
-		LoggerHelper.doLog(LoggerType.info, args);
-	}
-
-	public static warn(...args: unknown[]): void {
-		LoggerHelper.doLog(LoggerType.warn, args);
-	}
-
-	public static debug(...args: unknown[]): void {
-		LoggerHelper.doLog(LoggerType.debug, args);
-	}
-
-	public static error(...args: unknown[]): void {
-		LoggerHelper.doLog(LoggerType.error, args);
-	}
-
-	private static doLog(level: LoggerType, args: unknown[]): void {
-		const payload: LoggerPayload = {
-			type: level,
-			args,
-			timestamp: new Date().toISOString(),
-		};
-		for (const listener of LoggerHelper.listeners) {
-			try {
-				const res = listener(payload);
-				if (res === false) {
-					return; // cancelled by listener
-				}
-			} catch {
-				// swallow listener errors so logging never breaks the app
-			}
-		}
-
-		(console as Console)[level].apply(console, args);
-	}
-
-	public static onLog(listener: LoggerListener, once = false): () => void {
-		if (once) {
-			const wrapper: LoggerListener = (payload) => {
-				try {
-					return listener(payload);
-				} finally {
-					LoggerHelper.listeners.delete(wrapper);
-				}
-			};
-			LoggerHelper.listeners.add(wrapper);
-			return () => LoggerHelper.listeners.delete(wrapper);
-		}
-
-		LoggerHelper.listeners.add(listener);
-		return () => LoggerHelper.listeners.delete(listener);
-	}
-}

package/helpers/sort.helper.ts

@@ -1,33 +0,0 @@
-enum SortOrder {
-	NONE = 0,
-	ASC = 1,
-	DESC = -1,
-}
-
-const compareString = (valA: string, valB: string, ascending: boolean | undefined): number => {
-	return valA.localeCompare(valB) * (ascending ? SortOrder.ASC : SortOrder.DESC);
-};
-
-const getSortOrder = <T>(valA: T, valB: T): SortOrder => {
-	return valA < valB ? SortOrder.DESC : valA === valB ? SortOrder.NONE : SortOrder.ASC;
-};
-
-const compareNonString = <T>(valA: T, valB: T, ascending: boolean | undefined): number => {
-	return getSortOrder(valA, valB) * (ascending ? SortOrder.ASC : SortOrder.DESC);
-};
-
-const getValue = <T>(valA: T, valB: T, ascending: boolean | undefined): number => {
-	let result: number = 0;
-	if (typeof valA === 'string' && typeof valB === 'string') {
-		result = compareString(valA, valB, ascending);
-	} else {
-		result = compareNonString(valA, valB, ascending);
-	}
-	return result;
-};
-
-export const sortHelper = <T, G>(a: T, b: T, valueGetter: (a: T) => G, ascending?: boolean): number => {
-	const valA: G = valueGetter(a);
-	const valB: G = valueGetter(b);
-	return getValue(valA, valB, ascending);
-};

package/helpers/token/token.helper.ts

@@ -1,16 +0,0 @@
-import { LocalStorageHelper } from '../local-storage.helper';
-import { TokenType } from './token-type.enum';
-
-export class TokenHelper {
-	static get(key: TokenType): string | null {
-		return LocalStorageHelper.get<string>(key);
-	}
-
-	static set(key: TokenType, token: string): void {
-		LocalStorageHelper.set(key, token);
-	}
-
-	static remove(key: TokenType): void {
-		LocalStorageHelper.remove(key);
-	}
-}

package/interfaces/keyvalue.interface.ts

@@ -1,7 +0,0 @@
-export interface IKeyValue<T> {
-	key: number | string;
-	value: T;
-}
-
-// refactor?
-// export type KeyValue<T> = Record<string | number, T>;

package/services/browser/browser.consts.ts

@@ -1,11 +0,0 @@
-import { Size } from '../../types';
-
-export const ScreenBreakpoints: Record<Size, number> = {
-	xs: 0,
-	sm: 576,
-	md: 768,
-	lg: 992,
-	xl: 1200,
-	xxl: 1400,
-	xxxl: 1600,
-};

package/services/browser/browser.interface.ts

@@ -1,6 +0,0 @@
-import { Size } from '../../types';
-
-export interface IScreenBreakpoint {
-	breakpoint: Size;
-	screenWidth: number;
-}

package/services/browser/browser.service.ts

@@ -1,119 +0,0 @@
-import { Size } from '../../types';
-import { ScreenBreakpoints } from './browser.consts';
-import { IScreenBreakpoint } from './browser.interface';
-import { OnResizeCallback, ResizeCallback } from './browser.types';
-
-// TODO - extract into Resize and breakpoint separated?
-
-export class BrowserService {
-	private screenBreakpoints!: Record<Size, number>;
-	private screenWidth: number = 0;
-	private lastBreakpoint!: IScreenBreakpoint;
-	private resizeListener!: (event: UIEvent) => void;
-	private breakpointChangeCallbacks: Set<ResizeCallback> = new Set(); // feuert nur bei Breakpoint-Änderung
-	private onResizeCallbacks: Set<OnResizeCallback> = new Set(); // feuert bei jedem throttled Resize
-	private rafId: number | null = null;
-	private emitTimeoutId: number | null = null; // für debounce der onResizeCallbacks
-	private pendingWidth?: number;
-	private pendingBreakpoint?: IScreenBreakpoint;
-	private duplicateThresholdMs = 60;
-
-	constructor(screenBreakpoints?: Record<Size, number>) {
-		if (typeof window !== 'undefined') {
-			this.screenBreakpoints = screenBreakpoints || ScreenBreakpoints;
-
-			this.screenWidth = window.innerWidth;
-			this.resizeListener = this.onResize.bind(this);
-
-			window.addEventListener('resize', this.resizeListener, { passive: true }); // passive: true für bessere Scroll/Resize-Performance
-			this.lastBreakpoint = this.getBreakpointByScreenWidth(this.screenWidth);
-		}
-	}
-
-	public destroy(): void {
-		if (typeof window !== 'undefined') {
-			window.removeEventListener('resize', this.resizeListener);
-		}
-		this.breakpointChangeCallbacks.clear();
-		this.onResizeCallbacks.clear();
-		if (this.rafId !== null) {
-			cancelAnimationFrame(this.rafId);
-			this.rafId = null;
-		}
-	}
-
-	public getCurrentScreenWidth(): number {
-		return this.screenWidth;
-	}
-
-	public getCurrentBreakpoint(): IScreenBreakpoint {
-		return this.lastBreakpoint;
-	}
-
-	public onBreakpointChange(callback: ResizeCallback): void {
-		this.breakpointChangeCallbacks.add(callback);
-	}
-
-	public offBreakpointChange(callback: ResizeCallback): void {
-		this.breakpointChangeCallbacks.delete(callback);
-	}
-
-	public onResizeChange(callback: OnResizeCallback): void {
-		this.onResizeCallbacks.add(callback);
-	}
-
-	public offResizeChange(callback: OnResizeCallback): void {
-		this.onResizeCallbacks.delete(callback);
-	}
-
-	public getBreakpointByScreenWidth(width: number = this.screenWidth): IScreenBreakpoint {
-		let result: Size = 'xs';
-		for (const key of Object.keys(this.screenBreakpoints) as Size[]) {
-			if (this.screenBreakpoints[key] <= width) {
-				result = key;
-			}
-		}
-		return { breakpoint: result, screenWidth: this.screenBreakpoints[result] };
-	}
-
-	public isScreenGreaterThan(size: Size): boolean {
-		return this.screenWidth > this.screenBreakpoints[size];
-	}
-
-	public isScreenSmallerThan(size: Size): boolean {
-		return this.screenWidth < this.screenBreakpoints[size];
-	}
-
-	public getBreakpoint(size: Size): IScreenBreakpoint {
-		return {
-			breakpoint: size,
-			screenWidth: this.screenBreakpoints[size],
-		};
-	}
-
-	private onResize = (): void => {
-		if (typeof window === 'undefined') return;
-
-		const width: number = window.innerWidth;
-		const breakpoint: IScreenBreakpoint = this.getBreakpointByScreenWidth(width);
-
-		if (this.lastBreakpoint?.breakpoint !== breakpoint?.breakpoint) {
-			this.lastBreakpoint = breakpoint;
-			breakpoint && this.breakpointChangeCallbacks.forEach((cb) => cb(breakpoint));
-		}
-
-		this.pendingWidth = width;
-		this.pendingBreakpoint = breakpoint;
-
-		if (this.emitTimeoutId) clearTimeout(this.emitTimeoutId);
-
-		this.emitTimeoutId = window.setTimeout(() => {
-			if (this.pendingBreakpoint) {
-				this.onResizeCallbacks.forEach((cb) => cb(this.pendingWidth!, this.pendingBreakpoint!));
-			}
-			this.pendingWidth = undefined;
-			this.pendingBreakpoint = undefined;
-			this.emitTimeoutId = null;
-		}, this.duplicateThresholdMs);
-	};
-}

package/services/index.ts

@@ -1 +0,0 @@
-export * from './browser';

package/tsconfig.json

@@ -1,33 +0,0 @@
-{
-	"compilerOptions": {
-		"declaration": true,
-		"declarationMap": true,
-		"emitDeclarationOnly": true,
-		"outDir": "dist",
-
-		"target": "ES2022",
-		"useDefineForClassFields": true,
-		"module": "ESNext",
-		"lib": ["ES2022", "DOM", "DOM.Iterable"],
-		"skipLibCheck": true,
-
-		/* Bundler mode */
-		"moduleResolution": "bundler",
-		"allowImportingTsExtensions": true,
-		"isolatedModules": true,
-		"moduleDetection": "force",
-		"noEmit": true,
-
-		/* Linting */
-		"strict": true,
-		"noImplicitAny": true,
-		"noImplicitOverride": true,
-		"noPropertyAccessFromIndexSignature": true,
-		"noImplicitReturns": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUnusedLocals": true,
-		"noUnusedParameters": true
-	},
-	"include": ["**/*"],
-	"exclude": ["node_modules", "dist"]
-}

package/types/index.ts

@@ -1,11 +0,0 @@
-export type Dictionary<T> = Record<string, T>;
-
-export type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | 'xxxl';
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	export type UnknownObject = any;
-	export type Nullable<T> = T | null;
-	export type Optional<T> = T | undefined;
-	export const InstallTrigger: unknown;
-}

package/vite.config.ts

@@ -1,21 +0,0 @@
-import { defineConfig } from 'vite';
-import dts from 'vite-plugin-dts';
-
-export default defineConfig({
-	root: './lib',
-	build: {
-		lib: {
-			entry: 'index.ts',
-			name: 'ts-utils',
-			fileName: (format) => `index.${format}.js`,
-			formats: ['es', 'cjs', 'umd'],
-		},
-		outDir: '../dist/lib',
-		emptyOutDir: true,
-	},
-	plugins: [
-		dts({
-			insertTypesEntry: true,
-		}),
-	],
-});