bytekit 0.1.12

package/dist/utils/core/ResponseValidator.d.ts

@@ -0,0 +1,26 @@
+export interface ValidationSchema {
+    type?: "object" | "array" | "string" | "number" | "boolean";
+    required?: boolean;
+    properties?: Record<string, ValidationSchema>;
+    items?: ValidationSchema;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    pattern?: RegExp | string;
+    enum?: unknown[];
+    custom?: (value: unknown) => boolean | string;
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    value?: unknown;
+}
+export declare class ResponseValidator {
+    static validate(data: unknown, schema: ValidationSchema, path?: string): ValidationError[];
+    private static validateObject;
+    private static validateArray;
+    private static validateString;
+    private static validateNumber;
+}
+//# sourceMappingURL=ResponseValidator.d.ts.map

package/dist/utils/core/ResponseValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseValidator.d.ts","sourceRoot":"","sources":["../../../src/utils/core/ResponseValidator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC1B,MAAM,CAAC,QAAQ,CACX,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,gBAAgB,EACxB,IAAI,SAAS,GACd,eAAe,EAAE;IA0DpB,OAAO,CAAC,MAAM,CAAC,cAAc;IAkB7B,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B,OAAO,CAAC,MAAM,CAAC,cAAc;IAgD7B,OAAO,CAAC,MAAM,CAAC,cAAc;CAiChC"}

package/dist/utils/core/ResponseValidator.js

@@ -0,0 +1,140 @@
+export class ResponseValidator {
+    static validate(data, schema, path = "root") {
+        const errors = [];
+        // Check required
+        if (schema.required && (data === null || data === undefined)) {
+            errors.push({
+                path,
+                message: "Value is required",
+                value: data,
+            });
+            return errors;
+        }
+        if (data === null || data === undefined) {
+            return errors;
+        }
+        // Check type
+        if (schema.type) {
+            const actualType = Array.isArray(data)
+                ? "array"
+                : typeof data;
+            if (actualType !== schema.type) {
+                errors.push({
+                    path,
+                    message: `Expected type ${schema.type}, got ${actualType}`,
+                    value: data,
+                });
+                return errors;
+            }
+        }
+        // Validate based on type
+        if (schema.type === "object" && typeof data === "object" && !Array.isArray(data)) {
+            errors.push(...this.validateObject(data, schema, path));
+        }
+        else if (schema.type === "array" && Array.isArray(data)) {
+            errors.push(...this.validateArray(data, schema, path));
+        }
+        else if (schema.type === "string" && typeof data === "string") {
+            errors.push(...this.validateString(data, schema, path));
+        }
+        else if (schema.type === "number" && typeof data === "number") {
+            errors.push(...this.validateNumber(data, schema, path));
+        }
+        // Custom validation
+        if (schema.custom) {
+            const result = schema.custom(data);
+            if (result !== true) {
+                errors.push({
+                    path,
+                    message: typeof result === "string" ? result : "Custom validation failed",
+                    value: data,
+                });
+            }
+        }
+        return errors;
+    }
+    static validateObject(obj, schema, path) {
+        const errors = [];
+        if (schema.properties) {
+            for (const [key, propSchema] of Object.entries(schema.properties)) {
+                const value = obj[key];
+                const propPath = `${path}.${key}`;
+                errors.push(...this.validate(value, propSchema, propPath));
+            }
+        }
+        return errors;
+    }
+    static validateArray(arr, schema, path) {
+        const errors = [];
+        if (schema.items) {
+            arr.forEach((item, index) => {
+                const itemPath = `${path}[${index}]`;
+                errors.push(...this.validate(item, schema.items, itemPath));
+            });
+        }
+        return errors;
+    }
+    static validateString(str, schema, path) {
+        const errors = [];
+        if (schema.minLength !== undefined && str.length < schema.minLength) {
+            errors.push({
+                path,
+                message: `String length must be at least ${schema.minLength}`,
+                value: str,
+            });
+        }
+        if (schema.maxLength !== undefined && str.length > schema.maxLength) {
+            errors.push({
+                path,
+                message: `String length must be at most ${schema.maxLength}`,
+                value: str,
+            });
+        }
+        if (schema.pattern) {
+            const regex = schema.pattern instanceof RegExp
+                ? schema.pattern
+                : new RegExp(schema.pattern);
+            if (!regex.test(str)) {
+                errors.push({
+                    path,
+                    message: `String does not match pattern ${schema.pattern}`,
+                    value: str,
+                });
+            }
+        }
+        if (schema.enum && !schema.enum.includes(str)) {
+            errors.push({
+                path,
+                message: `Value must be one of: ${schema.enum.join(", ")}`,
+                value: str,
+            });
+        }
+        return errors;
+    }
+    static validateNumber(num, schema, path) {
+        const errors = [];
+        if (schema.minimum !== undefined && num < schema.minimum) {
+            errors.push({
+                path,
+                message: `Number must be at least ${schema.minimum}`,
+                value: num,
+            });
+        }
+        if (schema.maximum !== undefined && num > schema.maximum) {
+            errors.push({
+                path,
+                message: `Number must be at most ${schema.maximum}`,
+                value: num,
+            });
+        }
+        if (schema.enum && !schema.enum.includes(num)) {
+            errors.push({
+                path,
+                message: `Value must be one of: ${schema.enum.join(", ")}`,
+                value: num,
+            });
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=ResponseValidator.js.map

package/dist/utils/core/ResponseValidator.js.map

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

package/dist/utils/core/RetryPolicy.d.ts

@@ -0,0 +1,43 @@
+export interface RetryConfig {
+    maxAttempts?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold?: number;
+    successThreshold?: number;
+    timeoutMs?: number;
+}
+export type CircuitBreakerState = "closed" | "open" | "half-open";
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime?;
+    private readonly failureThreshold;
+    private readonly successThreshold;
+    private readonly timeoutMs;
+    constructor(config?: CircuitBreakerConfig);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    private shouldAttemptReset;
+    private getRetryAfterMs;
+    getState(): CircuitBreakerState;
+    reset(): void;
+}
+export declare class RetryPolicy {
+    private readonly maxAttempts;
+    private readonly initialDelayMs;
+    private readonly maxDelayMs;
+    private readonly backoffMultiplier;
+    private readonly shouldRetry;
+    constructor(config?: RetryConfig);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private calculateDelay;
+    private sleep;
+    private isRetryableError;
+}
+//# sourceMappingURL=RetryPolicy.d.ts.map

package/dist/utils/core/RetryPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryPolicy.d.ts","sourceRoot":"","sources":["../../../src/utils/core/RetryPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAElE,qBAAa,cAAc;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,oBAAyB;IAMvC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBlD,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAMvB,QAAQ,IAAI,mBAAmB;IAI/B,KAAK,IAAI,IAAI;CAMhB;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6C;gBAE7D,MAAM,GAAE,WAAgB;IAS9B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBlD,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,gBAAgB;CAU3B"}

package/dist/utils/core/RetryPolicy.js

@@ -0,0 +1,119 @@
+export class CircuitBreaker {
+    state = "closed";
+    failureCount = 0;
+    successCount = 0;
+    lastFailureTime;
+    failureThreshold;
+    successThreshold;
+    timeoutMs;
+    constructor(config = {}) {
+        this.failureThreshold = config.failureThreshold ?? 5;
+        this.successThreshold = config.successThreshold ?? 2;
+        this.timeoutMs = config.timeoutMs ?? 60000;
+    }
+    async execute(fn) {
+        if (this.state === "open") {
+            if (this.shouldAttemptReset()) {
+                this.state = "half-open";
+            }
+            else {
+                throw new Error(`Circuit breaker is open. Retry after ${this.getRetryAfterMs()}ms`);
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        if (this.state === "half-open") {
+            this.successCount++;
+            if (this.successCount >= this.successThreshold) {
+                this.state = "closed";
+                this.successCount = 0;
+            }
+        }
+    }
+    onFailure() {
+        this.lastFailureTime = Date.now();
+        this.failureCount++;
+        this.successCount = 0;
+        if (this.failureCount >= this.failureThreshold) {
+            this.state = "open";
+        }
+    }
+    shouldAttemptReset() {
+        return (this.lastFailureTime !== undefined &&
+            Date.now() - this.lastFailureTime >= this.timeoutMs);
+    }
+    getRetryAfterMs() {
+        if (this.lastFailureTime === undefined)
+            return 0;
+        const elapsed = Date.now() - this.lastFailureTime;
+        return Math.max(0, this.timeoutMs - elapsed);
+    }
+    getState() {
+        return this.state;
+    }
+    reset() {
+        this.state = "closed";
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = undefined;
+    }
+}
+export class RetryPolicy {
+    maxAttempts;
+    initialDelayMs;
+    maxDelayMs;
+    backoffMultiplier;
+    shouldRetry;
+    constructor(config = {}) {
+        this.maxAttempts = config.maxAttempts ?? 3;
+        this.initialDelayMs = config.initialDelayMs ?? 100;
+        this.maxDelayMs = config.maxDelayMs ?? 10000;
+        this.backoffMultiplier = config.backoffMultiplier ?? 2;
+        this.shouldRetry =
+            config.shouldRetry ?? ((error) => this.isRetryableError(error));
+    }
+    async execute(fn) {
+        let lastError;
+        for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt === this.maxAttempts || !this.shouldRetry(lastError, attempt)) {
+                    throw lastError;
+                }
+                const delayMs = this.calculateDelay(attempt);
+                await this.sleep(delayMs);
+            }
+        }
+        throw lastError ?? new Error("Retry policy failed");
+    }
+    calculateDelay(attempt) {
+        const exponentialDelay = this.initialDelayMs * Math.pow(this.backoffMultiplier, attempt - 1);
+        const jitter = Math.random() * 0.1 * exponentialDelay;
+        return Math.min(exponentialDelay + jitter, this.maxDelayMs);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    isRetryableError(error) {
+        // Retry on network errors, timeouts, and 5xx errors
+        const message = error.message.toLowerCase();
+        return (message.includes("timeout") ||
+            message.includes("network") ||
+            message.includes("econnrefused") ||
+            message.includes("econnreset"));
+    }
+}
+//# sourceMappingURL=RetryPolicy.js.map

package/dist/utils/core/RetryPolicy.js.map

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

package/dist/utils/core/debug.d.ts

@@ -0,0 +1,46 @@
+import { Logger } from "./Logger.js";
+/**
+ * Opciones configurables para medir tiempos de ejecución.
+ */
+export interface StopwatchOptions {
+    label?: string;
+    logger?: Logger;
+    precision?: number;
+    autoLog?: boolean;
+    namespace?: string;
+}
+/**
+ * Representa un cronómetro utilitario.
+ */
+export interface Stopwatch {
+    stop: () => number;
+    elapsed: () => number;
+    log: (context?: Record<string, unknown>) => number;
+}
+/**
+ * Crea un cronómetro para medir duración de operaciones.
+ */
+export declare const createStopwatch: ({ label, logger, precision, autoLog, namespace, }?: StopwatchOptions) => Stopwatch;
+/**
+ * Ejecuta una función (sync o async) midiendo su tiempo total.
+ */
+export declare const withTiming: <T>(label: string, fn: () => Promise<T> | T, options?: StopwatchOptions) => Promise<T>;
+/**
+ * Versión síncrona de withTiming para funciones normales.
+ */
+export declare const measureSync: <T>(label: string, fn: () => T, options?: StopwatchOptions) => T;
+/**
+ * Versión asíncrona de withTiming con resultado enriquecido.
+ */
+export declare const measureAsync: <T>(label: string, fn: () => Promise<T> | T, options?: StopwatchOptions) => Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Captura una función sin logger, útil para medir internamente y devolver datos crudos.
+ */
+export declare const captureDebug: <T>(fn: () => Promise<T> | T) => Promise<{
+    result: T;
+    durationMs: number;
+}>;
+//# sourceMappingURL=debug.d.ts.map

package/dist/utils/core/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/utils/core/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,oDAM7B,gBAAqB,KAAG,SA6B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,CAAC,EAC9B,OAAO,MAAM,EACb,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,UAAS,gBAAqB,KAC/B,OAAO,CAAC,CAAC,CAOX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EACzB,OAAO,MAAM,EACb,IAAI,MAAM,CAAC,EACX,UAAS,gBAAqB,KAC/B,CAOF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,EAChC,OAAO,MAAM,EACb,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,UAAS,gBAAqB,KAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAiB3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,EAChC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KACzB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAK3C,CAAC"}

package/dist/utils/core/debug.js

@@ -0,0 +1,83 @@
+/**
+ * Obtiene el timestamp actual con la mejor precisión disponible (browser o Node).
+ */
+const now = () => typeof performance !== "undefined" && typeof performance.now === "function"
+    ? performance.now()
+    : Date.now();
+/**
+ * Crea un cronómetro para medir duración de operaciones.
+ */
+export const createStopwatch = ({ label = "stopwatch", logger, precision = 2, autoLog = false, namespace, } = {}) => {
+    const start = now();
+    const logInstance = namespace && logger ? logger.child(namespace) : logger;
+    const elapsed = () => now() - start;
+    const stop = () => {
+        const duration = elapsed();
+        if (autoLog && logInstance) {
+            logInstance.debug(`${label} took ${duration.toFixed(precision)}ms`, {
+                duration,
+            });
+        }
+        return duration;
+    };
+    const log = (context) => {
+        const duration = stop();
+        logInstance?.debug(`${label} took ${duration.toFixed(precision)}ms`, {
+            ...context,
+            duration,
+        });
+        return duration;
+    };
+    return { stop, elapsed, log };
+};
+/**
+ * Ejecuta una función (sync o async) midiendo su tiempo total.
+ */
+export const withTiming = async (label, fn, options = {}) => {
+    const stopwatch = createStopwatch({ ...options, label });
+    try {
+        return await fn();
+    }
+    finally {
+        stopwatch.log();
+    }
+};
+/**
+ * Versión síncrona de withTiming para funciones normales.
+ */
+export const measureSync = (label, fn, options = {}) => {
+    const stopwatch = createStopwatch({ ...options, label });
+    try {
+        return fn();
+    }
+    finally {
+        stopwatch.log();
+    }
+};
+/**
+ * Versión asíncrona de withTiming con resultado enriquecido.
+ */
+export const measureAsync = async (label, fn, options = {}) => {
+    const stopwatch = createStopwatch({ ...options, label });
+    const result = await fn();
+    const durationMs = stopwatch.stop();
+    if (options.logger) {
+        const logInstance = options.namespace && options.logger
+            ? options.logger.child(options.namespace)
+            : options.logger;
+        logInstance.debug(`${label} completed in ${durationMs.toFixed(2)}ms`, {
+            durationMs,
+        });
+    }
+    return { result, durationMs };
+};
+/**
+ * Captura una función sin logger, útil para medir internamente y devolver datos crudos.
+ */
+export const captureDebug = async (fn) => {
+    const start = now();
+    const result = await fn();
+    const durationMs = now() - start;
+    return { result, durationMs };
+};
+//# sourceMappingURL=debug.js.map

package/dist/utils/core/debug.js.map

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

package/dist/utils/core/index.d.ts

@@ -0,0 +1,11 @@
+export * from "#core/ApiClient.js";
+export * from "#core/Logger.js";
+export * from "#core/Profiler.js";
+export * from "#core/debug.js";
+export * from "#core/RetryPolicy.js";
+export * from "#core/ResponseValidator.js";
+export * from "#core/RequestCache.js";
+export * from "#core/RateLimiter.js";
+export * from "#core/RequestDeduplicator.js";
+export * from "#core/ErrorBoundary.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC"}

package/dist/utils/core/index.js

@@ -0,0 +1,11 @@
+export * from "#core/ApiClient.js";
+export * from "#core/Logger.js";
+export * from "#core/Profiler.js";
+export * from "#core/debug.js";
+export * from "#core/RetryPolicy.js";
+export * from "#core/ResponseValidator.js";
+export * from "#core/RequestCache.js";
+export * from "#core/RateLimiter.js";
+export * from "#core/RequestDeduplicator.js";
+export * from "#core/ErrorBoundary.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC"}

package/dist/utils/helpers/ArrayUtils.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Array manipulation utilities for everyday development tasks
+ */
+export declare class ArrayUtils {
+    /**
+     * Split array into chunks of specified size
+     */
+    static chunk<T>(arr: T[], size: number): T[][];
+    /**
+     * Flatten nested arrays
+     */
+    static flatten<T>(arr: Array<T | T[]>, depth?: number): T[];
+    /**
+     * Get unique values from array
+     */
+    static unique<T>(arr: T[], by?: (item: T) => unknown): T[];
+    /**
+     * Remove duplicates and return unique array
+     */
+    static deduplicate<T>(arr: T[]): T[];
+    /**
+     * Compact array (remove falsy values)
+     */
+    static compact<T>(arr: Array<T | null | undefined | false | 0 | "">): T[];
+    /**
+     * Flatten one level deep
+     */
+    static flat<T>(arr: Array<T | T[]>): T[];
+    /**
+     * Get first element
+     */
+    static first<T>(arr: T[]): T | undefined;
+    /**
+     * Get last element
+     */
+    static last<T>(arr: T[]): T | undefined;
+    /**
+     * Get element at index (supports negative indices)
+     */
+    static at<T>(arr: T[], index: number): T | undefined;
+    /**
+     * Shuffle array (Fisher-Yates)
+     */
+    static shuffle<T>(arr: T[]): T[];
+    /**
+     * Get random element
+     */
+    static random<T>(arr: T[]): T | undefined;
+    /**
+     * Get N random elements
+     */
+    static randomN<T>(arr: T[], n: number): T[];
+    /**
+     * Reverse array
+     */
+    static reverse<T>(arr: T[]): T[];
+    /**
+     * Rotate array
+     */
+    static rotate<T>(arr: T[], steps: number): T[];
+    /**
+     * Zip arrays together
+     */
+    static zip<T>(...arrays: T[][]): T[][];
+    /**
+     * Unzip array of tuples
+     */
+    static unzip<T>(arr: T[][]): T[][];
+    /**
+     * Find differences between two arrays
+     */
+    static difference<T>(arr1: T[], arr2: T[]): T[];
+    /**
+     * Find intersection of two arrays
+     */
+    static intersection<T>(arr1: T[], arr2: T[]): T[];
+    /**
+     * Find union of two arrays
+     */
+    static union<T>(arr1: T[], arr2: T[]): T[];
+    /**
+     * Check if array includes all elements from another array
+     */
+    static includesAll<T>(arr: T[], items: T[]): boolean;
+    /**
+     * Check if array includes any element from another array
+     */
+    static includesAny<T>(arr: T[], items: T[]): boolean;
+    /**
+     * Sum array of numbers
+     */
+    static sum(arr: number[]): number;
+    /**
+     * Average of array of numbers
+     */
+    static average(arr: number[]): number;
+    /**
+     * Min value in array
+     */
+    static min(arr: number[]): number | undefined;
+    /**
+     * Max value in array
+     */
+    static max(arr: number[]): number | undefined;
+    /**
+     * Range of numbers
+     */
+    static range(start: number, end: number, step?: number): number[];
+    /**
+     * Repeat array N times
+     */
+    static repeat<T>(arr: T[], times: number): T[];
+    /**
+     * Fill array with value
+     */
+    static fill<T>(length: number, value: T): T[];
+    /**
+     * Transpose 2D array
+     */
+    static transpose<T>(arr: T[][]): T[][];
+    /**
+     * Find index of element matching predicate
+     */
+    static findIndex<T>(arr: T[], predicate: (item: T, index: number) => boolean): number;
+    /**
+     * Find last index of element matching predicate
+     */
+    static findLastIndex<T>(arr: T[], predicate: (item: T, index: number) => boolean): number;
+    /**
+     * Partition array into two based on predicate
+     */
+    static partition<T>(arr: T[], predicate: (item: T) => boolean): [T[], T[]];
+}
+//# sourceMappingURL=ArrayUtils.d.ts.map