mulink 1.1.8 → 1.2.0

package/dist/lib/index.d.cts

@@ -1,5 +1,5 @@
-import { B as BridgeConfiguration, G as GenerationContext, a as GeneratedFile } from './version-checker-uF6o5ziX.cjs';
-export { A as ApiConfiguration, l as ApiEndpointDefinition, n as ApiResponseDefinition, g as AuthConfiguration, b as BridgeCore, x as BridgeError, c as BridgeLogger, v as BridgePlugin, h as CacheConfiguration, s as CacheStrategy, C as ConfigurationLoader, D as DevelopmentConfiguration, E as EndpointMetadata, u as FileMetadata, F as FileSystemManager, f as FrameworkConfiguration, i as GenerationConfiguration, I as GenerationError, H as HttpMethod, L as LogLevel, j as OpenApiDocument, O as OpenApiSchemaParser, m as ParameterDefinition, k as ParsedApiSchema, P as PluginConfiguration, t as RateLimit, R as RequestBodyDefinition, S as SchemaDefinition, q as SchemaMetadata, z as SchemaParseError, r as SecurityRequirement, o as SecuritySchemeDefinition, p as ServerDefinition, y as ValidationError, V as VersionChecker, w as VersionInfo, e as checkAndNotifyUpdates, d as createBridgeVersionChecker } from './version-checker-uF6o5ziX.cjs';
+import { B as BridgeConfiguration, s as GenerationContext, t as GeneratedFile } from './version-checker-DU88tpi8.cjs';
+export { A as ApiConfiguration, j as ApiEndpointDefinition, l as ApiResponseDefinition, f as AuthConfiguration, a as BridgeCore, I as BridgeError, b as BridgeLogger, v as BridgePlugin, g as CacheConfiguration, q as CacheStrategy, C as ConfigurationLoader, D as DevelopmentConfiguration, E as EndpointMetadata, u as FileMetadata, F as FileSystemManager, e as FrameworkConfiguration, G as GenerationConfiguration, M as GenerationError, H as HttpMethod, L as LogLevel, h as OpenApiDocument, O as OpenApiSchemaParser, k as ParameterDefinition, i as ParsedApiSchema, P as PluginConfiguration, r as RateLimit, R as RequestBodyDefinition, S as SchemaDefinition, o as SchemaMetadata, K as SchemaParseError, p as SecurityRequirement, m as SecuritySchemeDefinition, n as ServerDefinition, J as ValidationError, V as VersionChecker, N as VersionInfo, d as checkAndNotifyUpdates, c as createBridgeVersionChecker } from './version-checker-DU88tpi8.cjs';
 import 'openapi-types';
 import 'zod';
 
@@ -12,4 +12,212 @@ declare class NextJsCodeGenerator {
     private generateSafeActionClient;
 }
 
-export { BridgeConfiguration, GeneratedFile, GenerationContext, NextJsCodeGenerator };
+/**
+ * Type guard utilities for runtime type checking
+ *
+ * These utilities provide type-safe runtime checks similar to libraries like Apollo Client.
+ * They ensure type safety at runtime and improve developer experience.
+ */
+/**
+ * Type guard to check if a value is defined (not null or undefined)
+ *
+ * @param value - Value to check
+ * @returns True if value is defined
+ *
+ * @example
+ * ```typescript
+ * const value: string | undefined = getValue();
+ * if (isDefined(value)) {
+ *   // value is now string
+ *   console.log(value.toUpperCase());
+ * }
+ * ```
+ */
+declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Type guard to check if a value is a string
+ *
+ * @param value - Value to check
+ * @returns True if value is a string
+ */
+declare function isString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a number
+ *
+ * @param value - Value to check
+ * @returns True if value is a number
+ */
+declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard to check if a value is an object (and not null)
+ *
+ * @param value - Value to check
+ * @returns True if value is an object
+ */
+declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is an array
+ *
+ * @param value - Value to check
+ * @returns True if value is an array
+ */
+declare function isArray<T>(value: unknown): value is T[];
+/**
+ * Type guard to check if a value is a function
+ *
+ * @param value - Value to check
+ * @returns True if value is a function
+ */
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+/**
+ * Type guard to check if an error is an Error instance
+ *
+ * @param error - Error to check
+ * @returns True if error is an Error instance
+ */
+declare function isError(error: unknown): error is Error;
+/**
+ * Type guard to check if a value is a Promise
+ *
+ * @param value - Value to check
+ * @returns True if value is a Promise
+ */
+declare function isPromise<T>(value: unknown): value is Promise<T>;
+/**
+ * Type guard to check if a value is a non-empty string
+ *
+ * @param value - Value to check
+ * @returns True if value is a non-empty string
+ */
+declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid URL string
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid URL
+ */
+declare function isValidUrl(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid file path
+ *
+ * @param value - Value to check
+ * @returns True if value appears to be a valid file path
+ */
+declare function isValidFilePath(value: unknown): value is string;
+
+/**
+ * Memoization utilities for performance optimization
+ *
+ * Similar to Apollo Client's caching strategies, these utilities provide
+ * efficient memoization for expensive computations.
+ */
+/**
+ * Memoization options
+ */
+interface MemoizeOptions {
+    /**
+     * Time to live in milliseconds
+     * If not provided, cache never expires
+     */
+    ttl?: number;
+    /**
+     * Maximum cache size
+     * If exceeded, oldest entries are removed
+     */
+    maxSize?: number;
+    /**
+     * Custom key generator function
+     */
+    keyGenerator?: (...args: unknown[]) => string;
+}
+/**
+ * Creates a memoized version of a function
+ *
+ * Caches function results based on arguments. Similar to Apollo Client's
+ * caching mechanism but for general-purpose functions.
+ *
+ * @param fn - Function to memoize
+ * @param options - Memoization options
+ * @returns Memoized function
+ *
+ * @example
+ * ```typescript
+ * const expensiveFunction = (x: number, y: number) => {
+ *   // Expensive computation
+ *   return x * y;
+ * };
+ *
+ * const memoized = memoize(expensiveFunction, { ttl: 5000 });
+ * const result1 = memoized(2, 3); // Computes
+ * const result2 = memoized(2, 3); // Returns cached result
+ * ```
+ */
+declare function memoize<T extends (...args: unknown[]) => unknown>(fn: T, options?: MemoizeOptions): T;
+/**
+ * Creates a weak memoized version of a function
+ *
+ * Uses WeakMap for automatic garbage collection. Useful when cache keys
+ * are objects that may be garbage collected.
+ *
+ * @param fn - Function to memoize
+ * @returns Memoized function
+ *
+ * @example
+ * ```typescript
+ * const processObject = (obj: { id: number }) => {
+ *   return obj.id * 2;
+ * };
+ *
+ * const memoized = weakMemoize(processObject);
+ * const result = memoized({ id: 5 });
+ * ```
+ */
+declare function weakMemoize<T extends (arg: object) => unknown>(fn: T): T;
+/**
+ * Debounce utility for rate limiting function calls
+ *
+ * Ensures a function is only called after a specified delay since
+ * the last invocation. Useful for API calls and user input handling.
+ *
+ * @param fn - Function to debounce
+ * @param delay - Delay in milliseconds
+ * @returns Debounced function
+ *
+ * @example
+ * ```typescript
+ * const search = (query: string) => {
+ *   console.log(`Searching for: ${query}`);
+ * };
+ *
+ * const debouncedSearch = debounce(search, 300);
+ * debouncedSearch('a'); // Not called
+ * debouncedSearch('ab'); // Not called
+ * debouncedSearch('abc'); // Called after 300ms
+ * ```
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): T & {
+    cancel: () => void;
+};
+/**
+ * Throttle utility for rate limiting function calls
+ *
+ * Ensures a function is called at most once per specified interval.
+ * Unlike debounce, throttle guarantees execution at regular intervals.
+ *
+ * @param fn - Function to throttle
+ * @param interval - Interval in milliseconds
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const onScroll = () => {
+ *   console.log('Scrolled');
+ * };
+ *
+ * const throttledScroll = throttle(onScroll, 100);
+ * // Will be called at most once every 100ms
+ * ```
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, interval: number): T;
+
+export { BridgeConfiguration, GeneratedFile, GenerationContext, NextJsCodeGenerator, debounce, isArray, isDefined, isError, isFunction, isNonEmptyString, isNumber, isObject, isPromise, isString, isValidFilePath, isValidUrl, memoize, throttle, weakMemoize };

package/dist/lib/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BridgeConfiguration, G as GenerationContext, a as GeneratedFile } from './version-checker-uF6o5ziX.js';
-export { A as ApiConfiguration, l as ApiEndpointDefinition, n as ApiResponseDefinition, g as AuthConfiguration, b as BridgeCore, x as BridgeError, c as BridgeLogger, v as BridgePlugin, h as CacheConfiguration, s as CacheStrategy, C as ConfigurationLoader, D as DevelopmentConfiguration, E as EndpointMetadata, u as FileMetadata, F as FileSystemManager, f as FrameworkConfiguration, i as GenerationConfiguration, I as GenerationError, H as HttpMethod, L as LogLevel, j as OpenApiDocument, O as OpenApiSchemaParser, m as ParameterDefinition, k as ParsedApiSchema, P as PluginConfiguration, t as RateLimit, R as RequestBodyDefinition, S as SchemaDefinition, q as SchemaMetadata, z as SchemaParseError, r as SecurityRequirement, o as SecuritySchemeDefinition, p as ServerDefinition, y as ValidationError, V as VersionChecker, w as VersionInfo, e as checkAndNotifyUpdates, d as createBridgeVersionChecker } from './version-checker-uF6o5ziX.js';
+import { B as BridgeConfiguration, s as GenerationContext, t as GeneratedFile } from './version-checker-DU88tpi8.js';
+export { A as ApiConfiguration, j as ApiEndpointDefinition, l as ApiResponseDefinition, f as AuthConfiguration, a as BridgeCore, I as BridgeError, b as BridgeLogger, v as BridgePlugin, g as CacheConfiguration, q as CacheStrategy, C as ConfigurationLoader, D as DevelopmentConfiguration, E as EndpointMetadata, u as FileMetadata, F as FileSystemManager, e as FrameworkConfiguration, G as GenerationConfiguration, M as GenerationError, H as HttpMethod, L as LogLevel, h as OpenApiDocument, O as OpenApiSchemaParser, k as ParameterDefinition, i as ParsedApiSchema, P as PluginConfiguration, r as RateLimit, R as RequestBodyDefinition, S as SchemaDefinition, o as SchemaMetadata, K as SchemaParseError, p as SecurityRequirement, m as SecuritySchemeDefinition, n as ServerDefinition, J as ValidationError, V as VersionChecker, N as VersionInfo, d as checkAndNotifyUpdates, c as createBridgeVersionChecker } from './version-checker-DU88tpi8.js';
 import 'openapi-types';
 import 'zod';
 
@@ -12,4 +12,212 @@ declare class NextJsCodeGenerator {
     private generateSafeActionClient;
 }
 
-export { BridgeConfiguration, GeneratedFile, GenerationContext, NextJsCodeGenerator };
+/**
+ * Type guard utilities for runtime type checking
+ *
+ * These utilities provide type-safe runtime checks similar to libraries like Apollo Client.
+ * They ensure type safety at runtime and improve developer experience.
+ */
+/**
+ * Type guard to check if a value is defined (not null or undefined)
+ *
+ * @param value - Value to check
+ * @returns True if value is defined
+ *
+ * @example
+ * ```typescript
+ * const value: string | undefined = getValue();
+ * if (isDefined(value)) {
+ *   // value is now string
+ *   console.log(value.toUpperCase());
+ * }
+ * ```
+ */
+declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Type guard to check if a value is a string
+ *
+ * @param value - Value to check
+ * @returns True if value is a string
+ */
+declare function isString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a number
+ *
+ * @param value - Value to check
+ * @returns True if value is a number
+ */
+declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard to check if a value is an object (and not null)
+ *
+ * @param value - Value to check
+ * @returns True if value is an object
+ */
+declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is an array
+ *
+ * @param value - Value to check
+ * @returns True if value is an array
+ */
+declare function isArray<T>(value: unknown): value is T[];
+/**
+ * Type guard to check if a value is a function
+ *
+ * @param value - Value to check
+ * @returns True if value is a function
+ */
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+/**
+ * Type guard to check if an error is an Error instance
+ *
+ * @param error - Error to check
+ * @returns True if error is an Error instance
+ */
+declare function isError(error: unknown): error is Error;
+/**
+ * Type guard to check if a value is a Promise
+ *
+ * @param value - Value to check
+ * @returns True if value is a Promise
+ */
+declare function isPromise<T>(value: unknown): value is Promise<T>;
+/**
+ * Type guard to check if a value is a non-empty string
+ *
+ * @param value - Value to check
+ * @returns True if value is a non-empty string
+ */
+declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid URL string
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid URL
+ */
+declare function isValidUrl(value: unknown): value is string;
+/**
+ * Type guard to check if a value is a valid file path
+ *
+ * @param value - Value to check
+ * @returns True if value appears to be a valid file path
+ */
+declare function isValidFilePath(value: unknown): value is string;
+
+/**
+ * Memoization utilities for performance optimization
+ *
+ * Similar to Apollo Client's caching strategies, these utilities provide
+ * efficient memoization for expensive computations.
+ */
+/**
+ * Memoization options
+ */
+interface MemoizeOptions {
+    /**
+     * Time to live in milliseconds
+     * If not provided, cache never expires
+     */
+    ttl?: number;
+    /**
+     * Maximum cache size
+     * If exceeded, oldest entries are removed
+     */
+    maxSize?: number;
+    /**
+     * Custom key generator function
+     */
+    keyGenerator?: (...args: unknown[]) => string;
+}
+/**
+ * Creates a memoized version of a function
+ *
+ * Caches function results based on arguments. Similar to Apollo Client's
+ * caching mechanism but for general-purpose functions.
+ *
+ * @param fn - Function to memoize
+ * @param options - Memoization options
+ * @returns Memoized function
+ *
+ * @example
+ * ```typescript
+ * const expensiveFunction = (x: number, y: number) => {
+ *   // Expensive computation
+ *   return x * y;
+ * };
+ *
+ * const memoized = memoize(expensiveFunction, { ttl: 5000 });
+ * const result1 = memoized(2, 3); // Computes
+ * const result2 = memoized(2, 3); // Returns cached result
+ * ```
+ */
+declare function memoize<T extends (...args: unknown[]) => unknown>(fn: T, options?: MemoizeOptions): T;
+/**
+ * Creates a weak memoized version of a function
+ *
+ * Uses WeakMap for automatic garbage collection. Useful when cache keys
+ * are objects that may be garbage collected.
+ *
+ * @param fn - Function to memoize
+ * @returns Memoized function
+ *
+ * @example
+ * ```typescript
+ * const processObject = (obj: { id: number }) => {
+ *   return obj.id * 2;
+ * };
+ *
+ * const memoized = weakMemoize(processObject);
+ * const result = memoized({ id: 5 });
+ * ```
+ */
+declare function weakMemoize<T extends (arg: object) => unknown>(fn: T): T;
+/**
+ * Debounce utility for rate limiting function calls
+ *
+ * Ensures a function is only called after a specified delay since
+ * the last invocation. Useful for API calls and user input handling.
+ *
+ * @param fn - Function to debounce
+ * @param delay - Delay in milliseconds
+ * @returns Debounced function
+ *
+ * @example
+ * ```typescript
+ * const search = (query: string) => {
+ *   console.log(`Searching for: ${query}`);
+ * };
+ *
+ * const debouncedSearch = debounce(search, 300);
+ * debouncedSearch('a'); // Not called
+ * debouncedSearch('ab'); // Not called
+ * debouncedSearch('abc'); // Called after 300ms
+ * ```
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): T & {
+    cancel: () => void;
+};
+/**
+ * Throttle utility for rate limiting function calls
+ *
+ * Ensures a function is called at most once per specified interval.
+ * Unlike debounce, throttle guarantees execution at regular intervals.
+ *
+ * @param fn - Function to throttle
+ * @param interval - Interval in milliseconds
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const onScroll = () => {
+ *   console.log('Scrolled');
+ * };
+ *
+ * const throttledScroll = throttle(onScroll, 100);
+ * // Will be called at most once every 100ms
+ * ```
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, interval: number): T;
+
+export { BridgeConfiguration, GeneratedFile, GenerationContext, NextJsCodeGenerator, debounce, isArray, isDefined, isError, isFunction, isNonEmptyString, isNumber, isObject, isPromise, isString, isValidFilePath, isValidUrl, memoize, throttle, weakMemoize };

package/dist/lib/index.js

@@ -1,3 +1,155 @@
-export { BridgeCore, BridgeError, BridgeLogger, ConfigurationLoader, FileSystemManager, GenerationError, LogLevel, NextJsCodeGenerator, OpenApiSchemaParser, SchemaParseError, ValidationError, VersionChecker, checkAndNotifyUpdates, createBridgeVersionChecker } from './chunk-AHGDKSOY.js';
+import { __name } from './chunk-BMHPB646.js';
+export { BridgeCore, BridgeError, BridgeLogger, ConfigurationLoader, FileSystemManager, GenerationError, LogLevel, NextJsCodeGenerator, OpenApiSchemaParser, SchemaParseError, ValidationError, VersionChecker, checkAndNotifyUpdates, createBridgeVersionChecker } from './chunk-BMHPB646.js';
+
+// src/utils/type-guards.ts
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
+__name(isDefined, "isDefined");
+function isString(value) {
+  return typeof value === "string";
+}
+__name(isString, "isString");
+function isNumber(value) {
+  return typeof value === "number" && !Number.isNaN(value);
+}
+__name(isNumber, "isNumber");
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(isObject, "isObject");
+function isArray(value) {
+  return Array.isArray(value);
+}
+__name(isArray, "isArray");
+function isFunction(value) {
+  return typeof value === "function";
+}
+__name(isFunction, "isFunction");
+function isError(error) {
+  return error instanceof Error;
+}
+__name(isError, "isError");
+function isPromise(value) {
+  return value instanceof Promise;
+}
+__name(isPromise, "isPromise");
+function isNonEmptyString(value) {
+  return isString(value) && value.trim().length > 0;
+}
+__name(isNonEmptyString, "isNonEmptyString");
+function isValidUrl(value) {
+  if (!isString(value)) {
+    return false;
+  }
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+__name(isValidUrl, "isValidUrl");
+function isValidFilePath(value) {
+  if (!isString(value)) {
+    return false;
+  }
+  return value.length > 0 && !value.includes("\0");
+}
+__name(isValidFilePath, "isValidFilePath");
+
+// src/utils/memoize.ts
+function memoize(fn, options = {}) {
+  const cache = /* @__PURE__ */ new Map();
+  const { ttl, maxSize = 100, keyGenerator } = options;
+  const memoized = /* @__PURE__ */ __name((...args) => {
+    const key = keyGenerator ? keyGenerator(...args) : JSON.stringify(args);
+    const entry = cache.get(key);
+    const now = Date.now();
+    if (entry) {
+      if (ttl && entry.expiresAt <= now) {
+        cache.delete(key);
+      } else {
+        return entry.value;
+      }
+    }
+    const value = fn(...args);
+    if (cache.size >= maxSize) {
+      const firstKey = cache.keys().next().value;
+      if (firstKey) {
+        cache.delete(firstKey);
+      }
+    }
+    cache.set(key, {
+      value,
+      expiresAt: ttl ? now + ttl : Number.MAX_SAFE_INTEGER
+    });
+    return value;
+  }, "memoized");
+  memoized.clearCache = () => {
+    cache.clear();
+  };
+  memoized.getCacheSize = () => {
+    return cache.size;
+  };
+  return memoized;
+}
+__name(memoize, "memoize");
+function weakMemoize(fn) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  return (arg) => {
+    if (cache.has(arg)) {
+      return cache.get(arg);
+    }
+    const value = fn(arg);
+    cache.set(arg, value);
+    return value;
+  };
+}
+__name(weakMemoize, "weakMemoize");
+function debounce(fn, delay) {
+  let timeoutId = null;
+  const debounced = /* @__PURE__ */ __name((...args) => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      fn(...args);
+      timeoutId = null;
+    }, delay);
+  }, "debounced");
+  debounced.cancel = () => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+      timeoutId = null;
+    }
+  };
+  return debounced;
+}
+__name(debounce, "debounce");
+function throttle(fn, interval) {
+  let lastCall = 0;
+  let timeoutId = null;
+  return (...args) => {
+    const now = Date.now();
+    const timeSinceLastCall = now - lastCall;
+    if (timeSinceLastCall >= interval) {
+      lastCall = now;
+      fn(...args);
+    } else {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+      timeoutId = setTimeout(() => {
+        lastCall = Date.now();
+        fn(...args);
+        timeoutId = null;
+      }, interval - timeSinceLastCall);
+    }
+  };
+}
+__name(throttle, "throttle");
+
+export { debounce, isArray, isDefined, isError, isFunction, isNonEmptyString, isNumber, isObject, isPromise, isString, isValidFilePath, isValidUrl, memoize, throttle, weakMemoize };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/utils/type-guards.ts","../../src/utils/memoize.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Type guard utilities for runtime type checking\r\n * \r\n * These utilities provide type-safe runtime checks similar to libraries like Apollo Client.\r\n * They ensure type safety at runtime and improve developer experience.\r\n */\r\n\r\n/**\r\n * Type guard to check if a value is defined (not null or undefined)\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is defined\r\n * \r\n * @example\r\n * ```typescript\r\n * const value: string | undefined = getValue();\r\n * if (isDefined(value)) {\r\n *   // value is now string\r\n *   console.log(value.toUpperCase());\r\n * }\r\n * ```\r\n */\r\nexport function isDefined<T>(value: T | null | undefined): value is T {\r\n  return value !== null && value !== undefined;\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a string\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a string\r\n */\r\nexport function isString(value: unknown): value is string {\r\n  return typeof value === 'string';\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a number\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a number\r\n */\r\nexport function isNumber(value: unknown): value is number {\r\n  return typeof value === 'number' && !Number.isNaN(value);\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is an object (and not null)\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is an object\r\n */\r\nexport function isObject(value: unknown): value is Record<string, unknown> {\r\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is an array\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is an array\r\n */\r\nexport function isArray<T>(value: unknown): value is T[] {\r\n  return Array.isArray(value);\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a function\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a function\r\n */\r\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\r\n  return typeof value === 'function';\r\n}\r\n\r\n/**\r\n * Type guard to check if an error is an Error instance\r\n * \r\n * @param error - Error to check\r\n * @returns True if error is an Error instance\r\n */\r\nexport function isError(error: unknown): error is Error {\r\n  return error instanceof Error;\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a Promise\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a Promise\r\n */\r\nexport function isPromise<T>(value: unknown): value is Promise<T> {\r\n  return value instanceof Promise;\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a non-empty string\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a non-empty string\r\n */\r\nexport function isNonEmptyString(value: unknown): value is string {\r\n  return isString(value) && value.trim().length > 0;\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a valid URL string\r\n * \r\n * @param value - Value to check\r\n * @returns True if value is a valid URL\r\n */\r\nexport function isValidUrl(value: unknown): value is string {\r\n  if (!isString(value)) {\r\n    return false;\r\n  }\r\n  \r\n  try {\r\n    new URL(value);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Type guard to check if a value is a valid file path\r\n * \r\n * @param value - Value to check\r\n * @returns True if value appears to be a valid file path\r\n */\r\nexport function isValidFilePath(value: unknown): value is string {\r\n  if (!isString(value)) {\r\n    return false;\r\n  }\r\n  \r\n  // Basic validation - can be enhanced based on OS\r\n  return value.length > 0 && !value.includes('\\0');\r\n}\r\n\r\n","/**\r\n * Memoization utilities for performance optimization\r\n * \r\n * Similar to Apollo Client's caching strategies, these utilities provide\r\n * efficient memoization for expensive computations.\r\n */\r\n\r\n/**\r\n * Cache entry with expiration support\r\n */\r\ninterface CacheEntry<T> {\r\n  value: T;\r\n  expiresAt: number;\r\n}\r\n\r\n/**\r\n * Memoization options\r\n */\r\ninterface MemoizeOptions {\r\n  /**\r\n   * Time to live in milliseconds\r\n   * If not provided, cache never expires\r\n   */\r\n  ttl?: number;\r\n  \r\n  /**\r\n   * Maximum cache size\r\n   * If exceeded, oldest entries are removed\r\n   */\r\n  maxSize?: number;\r\n  \r\n  /**\r\n   * Custom key generator function\r\n   */\r\n  keyGenerator?: (...args: unknown[]) => string;\r\n}\r\n\r\n/**\r\n * Creates a memoized version of a function\r\n * \r\n * Caches function results based on arguments. Similar to Apollo Client's\r\n * caching mechanism but for general-purpose functions.\r\n * \r\n * @param fn - Function to memoize\r\n * @param options - Memoization options\r\n * @returns Memoized function\r\n * \r\n * @example\r\n * ```typescript\r\n * const expensiveFunction = (x: number, y: number) => {\r\n *   // Expensive computation\r\n *   return x * y;\r\n * };\r\n * \r\n * const memoized = memoize(expensiveFunction, { ttl: 5000 });\r\n * const result1 = memoized(2, 3); // Computes\r\n * const result2 = memoized(2, 3); // Returns cached result\r\n * ```\r\n */\r\nexport function memoize<T extends (...args: unknown[]) => unknown>(\r\n  fn: T,\r\n  options: MemoizeOptions = {}\r\n): T {\r\n  const cache = new Map<string, CacheEntry<ReturnType<T>>>();\r\n  const { ttl, maxSize = 100, keyGenerator } = options;\r\n\r\n  const memoized = ((...args: Parameters<T>): ReturnType<T> => {\r\n    // Generate cache key\r\n    const key = keyGenerator \r\n      ? keyGenerator(...args)\r\n      : JSON.stringify(args);\r\n\r\n    // Check cache\r\n    const entry = cache.get(key);\r\n    const now = Date.now();\r\n\r\n    if (entry) {\r\n      // Check if expired\r\n      if (ttl && entry.expiresAt <= now) {\r\n        cache.delete(key);\r\n      } else {\r\n        return entry.value;\r\n      }\r\n    }\r\n\r\n    // Compute value\r\n    const value = fn(...args) as ReturnType<T>;\r\n\r\n    // Store in cache\r\n    if (cache.size >= maxSize) {\r\n      // Remove oldest entry (first in Map)\r\n      const firstKey = cache.keys().next().value;\r\n      if (firstKey) {\r\n        cache.delete(firstKey);\r\n      }\r\n    }\r\n\r\n    cache.set(key, {\r\n      value,\r\n      expiresAt: ttl ? now + ttl : Number.MAX_SAFE_INTEGER,\r\n    });\r\n\r\n    return value;\r\n  }) as T;\r\n\r\n  // Add cache management methods\r\n  (memoized as T & { clearCache: () => void }).clearCache = () => {\r\n    cache.clear();\r\n  };\r\n\r\n  (memoized as T & { getCacheSize: () => number }).getCacheSize = () => {\r\n    return cache.size;\r\n  };\r\n\r\n  return memoized;\r\n}\r\n\r\n/**\r\n * Creates a weak memoized version of a function\r\n * \r\n * Uses WeakMap for automatic garbage collection. Useful when cache keys\r\n * are objects that may be garbage collected.\r\n * \r\n * @param fn - Function to memoize\r\n * @returns Memoized function\r\n * \r\n * @example\r\n * ```typescript\r\n * const processObject = (obj: { id: number }) => {\r\n *   return obj.id * 2;\r\n * };\r\n * \r\n * const memoized = weakMemoize(processObject);\r\n * const result = memoized({ id: 5 });\r\n * ```\r\n */\r\nexport function weakMemoize<T extends (arg: object) => unknown>(\r\n  fn: T\r\n): T {\r\n  const cache = new WeakMap<object, ReturnType<T>>();\r\n\r\n  return ((arg: Parameters<T>[0]): ReturnType<T> => {\r\n    if (cache.has(arg)) {\r\n      return cache.get(arg)!;\r\n    }\r\n\r\n    const value = fn(arg) as ReturnType<T>;\r\n    cache.set(arg, value);\r\n    return value;\r\n  }) as T;\r\n}\r\n\r\n/**\r\n * Debounce utility for rate limiting function calls\r\n * \r\n * Ensures a function is only called after a specified delay since\r\n * the last invocation. Useful for API calls and user input handling.\r\n * \r\n * @param fn - Function to debounce\r\n * @param delay - Delay in milliseconds\r\n * @returns Debounced function\r\n * \r\n * @example\r\n * ```typescript\r\n * const search = (query: string) => {\r\n *   console.log(`Searching for: ${query}`);\r\n * };\r\n * \r\n * const debouncedSearch = debounce(search, 300);\r\n * debouncedSearch('a'); // Not called\r\n * debouncedSearch('ab'); // Not called\r\n * debouncedSearch('abc'); // Called after 300ms\r\n * ```\r\n */\r\nexport function debounce<T extends (...args: unknown[]) => unknown>(\r\n  fn: T,\r\n  delay: number\r\n): T & { cancel: () => void } {\r\n  let timeoutId: NodeJS.Timeout | null = null;\r\n\r\n  const debounced = ((...args: Parameters<T>) => {\r\n    if (timeoutId) {\r\n      clearTimeout(timeoutId);\r\n    }\r\n\r\n    timeoutId = setTimeout(() => {\r\n      fn(...args);\r\n      timeoutId = null;\r\n    }, delay);\r\n  }) as T & { cancel: () => void };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) {\r\n      clearTimeout(timeoutId);\r\n      timeoutId = null;\r\n    }\r\n  };\r\n\r\n  return debounced;\r\n}\r\n\r\n/**\r\n * Throttle utility for rate limiting function calls\r\n * \r\n * Ensures a function is called at most once per specified interval.\r\n * Unlike debounce, throttle guarantees execution at regular intervals.\r\n * \r\n * @param fn - Function to throttle\r\n * @param interval - Interval in milliseconds\r\n * @returns Throttled function\r\n * \r\n * @example\r\n * ```typescript\r\n * const onScroll = () => {\r\n *   console.log('Scrolled');\r\n * };\r\n * \r\n * const throttledScroll = throttle(onScroll, 100);\r\n * // Will be called at most once every 100ms\r\n * ```\r\n */\r\nexport function throttle<T extends (...args: unknown[]) => unknown>(\r\n  fn: T,\r\n  interval: number\r\n): T {\r\n  let lastCall = 0;\r\n  let timeoutId: NodeJS.Timeout | null = null;\r\n\r\n  return ((...args: Parameters<T>) => {\r\n    const now = Date.now();\r\n    const timeSinceLastCall = now - lastCall;\r\n\r\n    if (timeSinceLastCall >= interval) {\r\n      lastCall = now;\r\n      fn(...args);\r\n    } else {\r\n      if (timeoutId) {\r\n        clearTimeout(timeoutId);\r\n      }\r\n\r\n      timeoutId = setTimeout(() => {\r\n        lastCall = Date.now();\r\n        fn(...args);\r\n        timeoutId = null;\r\n      }, interval - timeSinceLastCall);\r\n    }\r\n  }) as T;\r\n}\r\n\r\n"]}