@plyaz/api 1.0.1 → 1.1.0

package/dist/api/utils/math.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Math Utilities
+ * Common mathematical operations and calculations
+ */
+import type { RangeMapping } from '@plyaz/types/api';
+/**
+ * Clamp a number between min and max values
+ *
+ * @param value - Value to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped value
+ *
+ * @example
+ * ```typescript
+ * clamp(15, 0, 10); // Returns 10
+ * clamp(-5, 0, 10); // Returns 0
+ * clamp(5, 0, 10);  // Returns 5
+ * ```
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Calculate percentage of value relative to max
+ *
+ * @param value - Current value
+ * @param max - Maximum value
+ * @returns Percentage (0-100)
+ *
+ * @example
+ * ```typescript
+ * percentage(25, 100); // Returns 25
+ * percentage(150, 100); // Returns 150 (can exceed 100)
+ * ```
+ */
+export declare function percentage(value: number, max: number): number;
+/**
+ * Calculate percentage and clamp to 0-100 range
+ *
+ * @param value - Current value
+ * @param max - Maximum value
+ * @returns Percentage clamped to 0-100
+ */
+export declare function clampedPercentage(value: number, max: number): number;
+/**
+ * Round number to specified decimal places
+ *
+ * @param value - Number to round
+ * @param decimals - Number of decimal places
+ * @returns Rounded number
+ *
+ * @example
+ * ```typescript
+ * round(3.14159, 2); // Returns 3.14
+ * round(1.005, 2);   // Returns 1.01
+ * ```
+ */
+export declare function round(value: number, decimals?: 0): number;
+/**
+ * Calculate average of array of numbers
+ *
+ * @param numbers - Array of numbers
+ * @returns Average value
+ *
+ * @example
+ * ```typescript
+ * average([1, 2, 3, 4, 5]); // Returns 3
+ * average([]);              // Returns 0
+ * ```
+ */
+export declare function average(numbers: number[]): number;
+/**
+ * Find median value in array of numbers
+ *
+ * @param numbers - Array of numbers
+ * @returns Median value
+ *
+ * @example
+ * ```typescript
+ * median([1, 2, 3, 4, 5]); // Returns 3
+ * median([1, 2, 3, 4]);    // Returns 2.5
+ * ```
+ */
+export declare function median(numbers: number[]): number;
+/**
+ * Calculate sum of array of numbers
+ *
+ * @param numbers - Array of numbers
+ * @returns Sum of all numbers
+ */
+export declare function sum(numbers: number[]): number;
+/**
+ * Find minimum value in array
+ *
+ * @param numbers - Array of numbers
+ * @returns Minimum value or undefined if empty
+ */
+export declare function min(numbers: number[]): number | undefined;
+/**
+ * Find maximum value in array
+ *
+ * @param numbers - Array of numbers
+ * @returns Maximum value or undefined if empty
+ */
+export declare function max(numbers: number[]): number | undefined;
+/**
+ * Linear interpolation between two values
+ *
+ * @param start - Start value
+ * @param end - End value
+ * @param progress - Progress (0-1)
+ * @returns Interpolated value
+ *
+ * @example
+ * ```typescript
+ * lerp(0, 100, 0.5);   // Returns 50
+ * lerp(10, 20, 0.25);  // Returns 12.5
+ * ```
+ */
+export declare function lerp(start: number, end: number, progress: number): number;
+/**
+ * Inverse linear interpolation - find progress given start, end, and current value
+ *
+ * @param start - Start value
+ * @param end - End value
+ * @param value - Current value
+ * @returns Progress (0-1)
+ */
+export declare function inverseLerp(start: number, end: number, value: number): number;
+/**
+ * Map a value from one range to another
+ *
+ * @param value - Input value
+ * @param mapping - Range mapping configuration
+ * @returns Mapped value
+ *
+ * @example
+ * ```typescript
+ * mapRange(5, { input: { min: 0, max: 10 }, output: { min: 0, max: 100 } }); // Returns 50
+ * mapRange(2, { input: { min: 0, max: 4 }, output: { min: 10, max: 20 } });  // Returns 15
+ * ```
+ */
+export declare function mapRange(value: number, mapping: RangeMapping): number;
+/**
+ * Generate random number between min and max (inclusive)
+ *
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Random number in range
+ */
+export declare function randomBetween(min: number, max: number): number;
+/**
+ * Generate random integer between min and max (inclusive)
+ *
+ * @param min - Minimum integer
+ * @param max - Maximum integer
+ * @returns Random integer in range
+ */
+export declare function randomInt(min: number, max: number): number;
+/**
+ * Check if number is within range (inclusive)
+ *
+ * @param value - Value to check
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns True if value is in range
+ */
+export declare function inRange(value: number, min: number, max: number): boolean;
+//# sourceMappingURL=math.d.ts.map

package/dist/api/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/api/utils/math.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,IAAsB,GAAG,MAAM,CAG3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAGjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAWhD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/api/utils/object-merge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Object Merging Utilities
+ * Common utility functions for deep merging objects, arrays, and interceptors
+ */
+/**
+ * Check if value is a mergeable object (not array, not null)
+ */
+export declare function isMergeableObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Handle array merging strategy
+ */
+export declare function handleArrayMerge(key: string, existing: unknown, value: unknown, result: Record<string, unknown>): boolean;
+/**
+ * Handle object merging strategy
+ */
+export declare function handleObjectMerge<T>(key: string, existing: unknown, value: unknown, result: Record<string, unknown>): boolean;
+/**
+ * Deep merge utility for configuration objects
+ * Later values override earlier ones, arrays are concatenated
+ *
+ * @param objects - Objects to merge (later objects override earlier ones)
+ * @returns Merged object
+ *
+ * @example
+ * ```typescript
+ * const result = deepMerge(
+ *   { a: 1, b: { x: 1 } },
+ *   { a: 2, b: { y: 2 } }
+ * );
+ * // Result: { a: 2, b: { x: 1, y: 2 } }
+ * ```
+ */
+export declare function deepMerge<T = Record<string, unknown>>(...objects: Array<Partial<T> | Record<string, unknown>>): T;
+//# sourceMappingURL=object-merge.d.ts.map

package/dist/api/utils/object-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-merge.d.ts","sourceRoot":"","sources":["../../../src/api/utils/object-merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElF;AAuDD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAMT;AA8BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAMT;AAgCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtD,CAAC,CAcH"}

package/dist/api/utils/object.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Object Utilities
+ * Common object manipulation, iteration utilities, and object-related type guards
+ */
+/**
+ * Check if value is an object (not null, not array)
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if value is a plain object (not null, not array, not Headers, not Date, etc.)
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if value is an array
+ */
+export declare function isArray<T = unknown>(value: unknown): value is T[];
+/**
+ * Check if value is null or undefined
+ */
+export declare function isNullish(value: unknown): value is null | undefined;
+/**
+ * Check if value is not null or undefined
+ */
+export declare function isNotNullish<T>(value: T | null | undefined): value is T;
+/**
+ * Check if value is empty (null, undefined, empty string, empty array, empty object)
+ */
+export declare function isEmpty(value: unknown): boolean;
+/**
+ * Check if array is not empty
+ */
+export declare function isNonEmptyArray<T>(value: unknown): value is T[];
+/**
+ * Check if value has a specific property
+ */
+export declare function hasProperty<K extends string>(value: unknown, property: K): value is Record<K, unknown>;
+/**
+ * Get object keys with proper typing
+ */
+export declare function getKeys<T extends Record<string, unknown>>(obj: T): (keyof T)[];
+/**
+ * Get object entries with proper typing
+ */
+export declare function getEntries<T extends Record<string, unknown>>(obj: T): [keyof T, T[keyof T]][];
+/**
+ * Get object values with proper typing
+ */
+export declare function getValues<T extends Record<string, unknown>>(obj: T): T[keyof T][];
+/**
+ * Check if object has no keys (is empty)
+ */
+export declare function isEmptyObject(obj: Record<string, unknown>): boolean;
+/**
+ * Check if object has any keys (is not empty)
+ */
+export declare function isNonEmptyObject(obj: Record<string, unknown>): boolean;
+/**
+ * Pick specific keys from an object
+ */
+export declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ */
+export declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Filter object entries by predicate
+ */
+export declare function filterObject<T extends Record<string, unknown>>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Partial<T>;
+/**
+ * Map object values while keeping keys
+ */
+export declare function mapObject<T extends Record<string, unknown>, R>(obj: T, mapper: (value: T[keyof T], key: keyof T) => R): Record<keyof T, R>;
+/**
+ * Transform object keys
+ */
+export declare function mapKeys<T extends Record<string, unknown>>(obj: T, mapper: (key: keyof T) => string): Record<string, T[keyof T]>;
+/**
+ * Group array of objects by a key
+ */
+export declare function groupBy<T, K extends keyof T>(array: T[], key: K): Record<string, T[]>;
+/**
+ * Create object from array using key and value selectors
+ */
+export declare function keyBy<T>(array: T[], keySelector: (item: T) => string, valueSelector?: (item: T) => unknown): Record<string, unknown>;
+/**
+ * Flatten nested object into dot notation
+ */
+export declare function flattenObject(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
+/**
+ * Remove undefined values from object
+ */
+export declare function removeUndefined<T extends Record<string, unknown>>(obj: T): T;
+/**
+ * Remove null and undefined values from object
+ */
+export declare function removeNullish<T extends Record<string, unknown>>(obj: T): T;
+/**
+ * Remove empty values (null, undefined, empty string, empty array, empty object)
+ */
+export declare function removeEmpty<T extends Record<string, unknown>>(obj: T): T;
+//# sourceMappingURL=object.d.ts.map

package/dist/api/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/api/utils/object.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAWD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa9E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,GACV,KAAK,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAE7B;AAID;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAE9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAE7F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAEjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQvF;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,OAAO,GACtD,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC5D,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAMpB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,MAAM,GAC/B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAO5B;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAUrF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAChC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,SAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAchG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQ5E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQ1E;AA4CD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQxE"}

package/dist/api/utils/string.d.ts

@@ -0,0 +1,41 @@
+/**
+ * String Utilities
+ * Common string manipulation and validation functions
+ */
+/**
+ * Check if a string contains any of the provided substrings
+ */
+export declare function containsAny(str: string, substrings: readonly string[]): boolean;
+/**
+ * Check if string matches any of the provided patterns (case-insensitive regex)
+ */
+export declare function matchesAny(str: string, patterns: readonly string[]): boolean;
+/**
+ * Check if string is one of the provided values (case-insensitive)
+ */
+export declare function isOneOfIgnoreCase(str: string, values: readonly string[]): boolean;
+/**
+ * Get file extension from URL or filename
+ */
+export declare function getFileExtension(url: string): string | null;
+/**
+ * Check if URL/filename has any of the provided extensions
+ */
+export declare function hasAnyExtension(url: string, extensions: readonly string[]): boolean;
+/**
+ * Media file extensions
+ */
+export declare const MEDIA_EXTENSIONS: {
+    readonly IMAGE: readonly ["jpg", "jpeg", "png", "gif", "webp", "svg", "ico", "bmp", "tiff"];
+    readonly VIDEO: readonly ["mp4", "webm", "avi", "mov", "wmv", "flv", "mkv", "3gp"];
+    readonly AUDIO: readonly ["mp3", "wav", "ogg", "aac", "flac", "m4a", "wma"];
+};
+/**
+ * Get all media extensions as a flat array
+ */
+export declare function getAllMediaExtensions(): string[];
+/**
+ * Media MIME type prefixes
+ */
+export declare const MEDIA_MIME_PREFIXES: readonly ["image/", "video/", "audio/"];
+//# sourceMappingURL=string.d.ts.map

package/dist/api/utils/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/api/utils/string.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAK5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAGjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKnF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,yCAA0C,CAAC"}

package/dist/api/utils/time.d.ts

@@ -0,0 +1,233 @@
+/**
+ * Time Utilities
+ * Helper functions for time operations, formatting, and date manipulation
+ * Combines interval-based time operations with convenient date utilities
+ */
+import type { TimeComponents, TimeConfig, TimeInterval } from '@plyaz/types/api';
+/**
+ * Get quarter of the year
+ *
+ * @param date - Date to get quarter for
+ * @returns Quarter number (1-4)
+ */
+export declare function getQuarter(date: Date): number;
+/**
+ * Get ISO week number for a date
+ *
+ * @param date - Date to get week number for
+ * @returns ISO week number (1-53)
+ */
+export declare function getISOWeek(date: Date): number;
+/**
+ * Get time components from a date
+ *
+ * @param config - Time configuration
+ * @returns Time components for formatting
+ */
+export declare function getTimeComponents(config?: TimeConfig): TimeComponents;
+/**
+ * Format time for a specific interval
+ *
+ * @param interval - Time interval to format for
+ * @param config - Configuration options
+ * @param separator - Separator for formatted parts
+ * @returns Formatted time string
+ *
+ * @example
+ * ```typescript
+ * formatTimeForInterval('hour'); // "2024-0-15-14"
+ * formatTimeForInterval('week'); // "2024-W3"
+ * formatTimeForInterval('quarter'); // "2024-Q1"
+ * ```
+ */
+export declare function formatTimeForInterval(interval: TimeInterval, config?: TimeConfig, separator?: string): string;
+/**
+ * Get start of a time interval
+ *
+ * @param interval - Time interval
+ * @param date - Date to get start for
+ * @returns Date at the start of the interval
+ *
+ * @example
+ * ```typescript
+ * const startOfDay = getIntervalStart('day', new Date());
+ * const startOfWeek = getIntervalStart('week', new Date());
+ * ```
+ */
+export declare function getIntervalStart(interval: TimeInterval, date?: Date): Date;
+/**
+ * Get end of a time interval
+ *
+ * @param interval - Time interval
+ * @param date - Date to get end for
+ * @returns Date at the end of the interval
+ *
+ * @example
+ * ```typescript
+ * const endOfDay = getIntervalEnd('day', new Date());
+ * const endOfMonth = getIntervalEnd('month', new Date());
+ * ```
+ */
+export declare function getIntervalEnd(interval: TimeInterval, date?: Date): Date;
+/**
+ * Add intervals to a date
+ *
+ * @param date - Starting date
+ * @param interval - Time interval to add
+ * @param count - Number of intervals to add
+ * @returns New date with intervals added
+ *
+ * @example
+ * ```typescript
+ * const tomorrow = addInterval(new Date(), 'day', 1);
+ * const nextWeek = addInterval(new Date(), 'week', 1);
+ * const nextQuarter = addInterval(new Date(), 'quarter', 1);
+ * ```
+ */
+export declare function addInterval(date: Date, interval: TimeInterval, count: number): Date;
+/**
+ * Get all interval boundaries within a range
+ *
+ * @param interval - Time interval
+ * @param startDate - Start of range
+ * @param endDate - End of range
+ * @returns Array of dates at interval boundaries
+ *
+ * @example
+ * ```typescript
+ * // Get all hour boundaries for today
+ * const hours = getIntervalBoundaries('hour', startOfDay, endOfDay);
+ * ```
+ */
+export declare function getIntervalBoundaries(interval: TimeInterval, startDate: Date, endDate: Date): Date[];
+/**
+ * Check if two dates are in the same interval
+ *
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param interval - Time interval to check
+ * @returns True if dates are in the same interval
+ *
+ * @example
+ * ```typescript
+ * const sameDay = isSameInterval(date1, date2, 'day');
+ * const sameWeek = isSameInterval(date1, date2, 'week');
+ * ```
+ */
+export declare function isSameInterval(date1: Date, date2: Date, interval: TimeInterval): boolean;
+/**
+ * Get the difference between two dates in a specific interval
+ *
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param interval - Time interval for the difference
+ * @returns Number of intervals between dates
+ *
+ * @example
+ * ```typescript
+ * const days = getIntervalDifference(startDate, endDate, 'day');
+ * const weeks = getIntervalDifference(startDate, endDate, 'week');
+ * ```
+ */
+export declare function getIntervalDifference(date1: Date, date2: Date, interval: TimeInterval): number;
+/**
+ * Get a human-readable relative time string
+ *
+ * @param date - Date to format
+ * @param baseDate - Base date to compare against (defaults to now)
+ * @returns Relative time string
+ *
+ * @example
+ * ```typescript
+ * getRelativeTime(yesterday); // "1 day ago"
+ * getRelativeTime(nextWeek); // "in 1 week"
+ * ```
+ */
+export declare function getRelativeTime(date: Date, baseDate?: Date): string;
+export declare function formatDuration(ms: number, options?: {
+    compact?: boolean;
+    units?: number;
+}): string;
+/**
+ * Get current timestamp in milliseconds
+ * Uses globalThis.Date to work with fake timers in tests
+ */
+export declare function now(): number;
+/**
+ * Get current timestamp in seconds
+ */
+export declare function nowInSeconds(): number;
+/**
+ * Create a new Date object (safer than new Date())
+ */
+export declare function createDate(value?: string | number | Date): Date;
+/**
+ * Check if date is valid
+ */
+export declare function isValidDate(date: Date): boolean;
+/**
+ * Format timestamp as relative time (e.g., "2 minutes ago")
+ * Alternative implementation to getRelativeTime with different format
+ */
+export declare function timeAgo(timestamp: number | Date): string;
+/**
+ * Convert milliseconds to seconds
+ */
+export declare function msToSeconds(ms: number): number;
+/**
+ * Convert seconds to milliseconds
+ */
+export declare function secondsToMs(seconds: number): number;
+/**
+ * Add time to date
+ */
+export declare function addTime(date: Date, amount: number, unit: 'ms' | 's' | 'm' | 'h' | 'd'): Date;
+/**
+ * Check if date is in the past
+ */
+export declare function isPast(date: Date): boolean;
+/**
+ * Check if date is in the future
+ */
+export declare function isFuture(date: Date): boolean;
+/**
+ * Check if date is today
+ */
+export declare function isToday(date: Date): boolean;
+/**
+ * Get start of day for a date
+ * Alias for getIntervalStart('day', date)
+ */
+export declare function startOfDay(date: Date): Date;
+/**
+ * Get end of day for a date
+ * Alias for getIntervalEnd('day', date)
+ */
+export declare function endOfDay(date: Date): Date;
+/**
+ * Format date as ISO string
+ */
+export declare function toISOString(date: Date): string;
+/**
+ * Parse ISO string to Date
+ */
+export declare function fromISOString(iso: string): Date;
+/**
+ * Get unix timestamp (seconds)
+ */
+export declare function getUnixTimestamp(date?: Date): number;
+/**
+ * Create Date from unix timestamp (seconds)
+ */
+export declare function fromUnixTimestamp(timestamp: number): Date;
+/**
+ * Get difference between two dates in specified unit
+ * Alternative to getIntervalDifference with different unit types
+ */
+export declare function dateDiff(date1: Date, date2: Date, unit?: 'ms' | 's' | 'm' | 'h' | 'd'): number;
+/**
+ * Check if two dates are on the same day
+ * Alias for isSameInterval(date1, date2, 'day')
+ */
+export declare function isSameDay(date1: Date, date2: Date): boolean;
+//# sourceMappingURL=time.d.ts.map

package/dist/api/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/api/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAY,MAAM,kBAAkB,CAAC;AA6C3F;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ7C;AAwBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,UAAe,GAAG,cAAc,CAgBzE;AAuDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,UAAe,EACvB,SAAS,GAAE,MAAY,GACtB,MAAM,CA2BR;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,GAAE,IAAiB,GAAG,IAAI,CAUtF;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,GAAE,IAAiB,GAAG,IAAI,CAUpF;AA8CD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAgBnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,IAAI,EAAE,CAUR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAIxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAG9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAE,IAAiB,GAAG,MAAM,CAwB/E;AA6DD,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAO5B;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAK/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C;AAiDD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAsB5F;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAO3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,IAAI,EACX,IAAI,GAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAU,GACxC,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAE3D"}

package/dist/api/utils/type-guards.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Type Guard Utilities
+ * Common type checking and validation utilities
+ */
+/**
+ * Check if value is a string
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Check if value is a number
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Check if value is a boolean
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Check if value is a function
+ */
+export declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+/**
+ * Check if string is not empty (not null, undefined, or empty string)
+ */
+export declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Check if value is a valid number (finite and not NaN)
+ */
+export declare function isValidNumber(value: unknown): value is number;
+/**
+ * Check if value is a positive number
+ */
+export declare function isPositiveNumber(value: unknown): value is number;
+/**
+ * Check if value is a non-negative number (>= 0)
+ */
+export declare function isNonNegativeNumber(value: unknown): value is number;
+/**
+ * Check if value is an integer
+ */
+export declare function isInteger(value: unknown): value is number;
+/**
+ * Check if value is a Promise
+ */
+export declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+/**
+ * Type guard to check if an error is an Error instance
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Check if all values in array pass a type guard
+ */
+export declare function arrayOf<T>(typeGuard: (value: unknown) => value is T): (value: unknown) => value is T[];
+/**
+ * Create a union type guard from multiple type guards
+ */
+export declare function oneOf<T extends readonly unknown[]>(...typeGuards: {
+    [K in keyof T]: (value: unknown) => value is T[K];
+}): (value: unknown) => value is T[number];
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/api/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/api/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAEnF;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAS1E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAID;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACxC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EAAE,CAIlC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAChD,GAAG,UAAU,EAAE;KACZ,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;CAClD,GACA,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAIxC"}