@jmruthers/pace-core 0.5.183 → 0.5.185

package/dist/utils.d.ts

@@ -1,12 +1,12 @@
-export { S as SecureDataAccess, a as cn, l as formatCompactNumber, i as formatCurrency, f as formatDate, h as formatDateTime, m as formatFileSize, j as formatNumber, k as formatPercent, e as formatTime, g as getAppConfig, d as getCurrentAppId, s as setAppConfig, u as useSessionTracking } from './formatting-5wETwiGF.js';
+export { K as DateTimeFormatOptions, j as LogLevel, L as Logger, k as LoggerConfig, S as SecureDataAccess, N as calculatePasswordStrength, d as cn, i as createLogger, M as dateSchema, e as emailSchema, w as formatCompactNumber, r as formatCurrency, m as formatDate, H as formatDateOnlyForDisplay, q as formatDateTime, G as formatDateTimeForDisplay, J as formatDateTimeForMap, I as formatDateTimeForTable, x as formatFileSize, y as formatInTimeZone, t as formatNumber, v as formatPercent, o as formatTime, A as formatTimeInTimeZone, D as fromZonedTime, g as getAppConfig, h as getCurrentAppId, F as getTimeZoneDifference, z as getTimezoneAbbreviation, B as getUserTimeZone, l as logger, n as nameSchema, b as passwordSchema, p as phoneSchema, E as roundToNearestMinutes, s as setAppConfig, C as toZonedTime, a as urlSchema, u as useSessionTracking } from './timezone-_pgH8qrY.js';
 import { SupabaseClient } from '@supabase/supabase-js';
 import { D as Database } from './database.generated-CBmg2950.js';
 export { g as changePasswordSchema, t as combineSchemas, i as contactFormSchema, l as loginSchema, f as passwordResetSchema, q as pickSchema, r as registrationSchema, c as secureLoginSchema, s as securePasswordSchema, h as userProfileSchema } from './validation-643vUDZW.js';
 import { z } from 'zod';
 export { u as useComponentPerformance } from './useComponentPerformance-DE9l5RkL.js';
 import * as date_fns from 'date-fns';
-import { D as DataTable } from './DataTable-Bz8ffqyA.js';
-import './types-_x1f4QBF.js';
+import { D as DataTable } from './DataTable-Z9NLVJh0.js';
+import './types-DUyCRSTj.js';
 import React__default, { ComponentType } from 'react';
 import 'clsx';
 import 'react/jsx-runtime';
@@ -45,109 +45,6 @@ declare class DebugLogger {
     static info(component: string, message: string, ...args: any[]): void;
 }
 
-/**
- * @file Production-Safe Logger Utility
- * @package @jmruthers/pace-core
- * @module Utils/Logger
- * @since 0.4.76
- */
-/**
- * Logger levels for different types of messages
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3
-}
-/**
- * Logger configuration interface
- */
-interface LoggerConfig {
-    /** Minimum log level to output */
-    level: LogLevel;
-    /** Whether to include timestamps */
-    includeTimestamp: boolean;
-    /** Whether to include component names */
-    includeComponent: boolean;
-    /** Custom prefix for all log messages */
-    prefix?: string;
-}
-/**
- * Production-safe logger that no-ops in production builds
- * Only outputs logs in development mode to prevent production console spam
- */
-declare class Logger {
-    private static config;
-    /**
-     * Check if we're in development or test mode
-     * Allows logging in both development and test environments
-     */
-    private static get isDevelopment();
-    /**
-     * Configure the logger
-     */
-    static configure(config: Partial<LoggerConfig>): void;
-    /**
-     * Format a log message with optional timestamp and component
-     */
-    private static formatMessage;
-    /**
-     * Check if a log level should be output
-     */
-    private static shouldLog;
-    /**
-     * Log debug information (development only)
-     */
-    static debug(component: string, message: string, ...args: any[]): void;
-    /**
-     * Log info information (development only)
-     */
-    static info(component: string, message: string, ...args: any[]): void;
-    /**
-     * Log warning information (development only)
-     */
-    static warn(component: string, message: string, ...args: any[]): void;
-    /**
-     * Log error information (development only)
-     */
-    static error(component: string, message: string, ...args: any[]): void;
-    /**
-     * Create a scoped logger for a specific component
-     */
-    static createScopedLogger(component: string): {
-        debug: (message: string, ...args: any[]) => void;
-        info: (message: string, ...args: any[]) => void;
-        warn: (message: string, ...args: any[]) => void;
-        error: (message: string, ...args: any[]) => void;
-    };
-}
-/**
- * Default logger instance for convenience
- */
-declare const logger: {
-    debug: (component: string, message: string, ...args: any[]) => void;
-    info: (component: string, message: string, ...args: any[]) => void;
-    warn: (component: string, message: string, ...args: any[]) => void;
-    error: (component: string, message: string, ...args: any[]) => void;
-    createScopedLogger: (component: string) => {
-        debug: (message: string, ...args: any[]) => void;
-        info: (message: string, ...args: any[]) => void;
-        warn: (message: string, ...args: any[]) => void;
-        error: (message: string, ...args: any[]) => void;
-    };
-    configure: (config: Partial<LoggerConfig>) => void;
-};
-/**
- * Convenience function to create a scoped logger
- */
-declare function createLogger(component: string): {
-    debug: (message: string, ...args: any[]) => void;
-    info: (message: string, ...args: any[]) => void;
-    warn: (message: string, ...args: any[]) => void;
-    error: (message: string, ...args: any[]) => void;
-};
-
 /**
  * Utility to resolve the current app name from various sources
  * Priority: package.json > environment variables > fallback
@@ -404,32 +301,6 @@ declare function validateUserInput<T>(schema: z.ZodSchema<T>, data: unknown, san
  */
 declare const usernameSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
 
-/**
- * @file Common validation schemas
- * @description Reusable validation schemas for common data types
- */
-
-/**
- * Email validation schema
- */
-declare const emailSchema: z.ZodString;
-/**
- * Name validation schema
- */
-declare const nameSchema: z.ZodString;
-/**
- * Phone number validation schema
- */
-declare const phoneSchema: z.ZodString;
-/**
- * URL validation schema
- */
-declare const urlSchema: z.ZodString;
-/**
- * Date validation schema
- */
-declare const dateSchema: z.ZodEffects<z.ZodString, string, string>;
-
 /**
  * @file CSRF Protection Implementation
  * @description Session-based CSRF token management with security enhancements
@@ -532,24 +403,6 @@ declare function detectSQLInjection(input: string): {
     riskLevel: 'low' | 'medium' | 'high' | 'critical';
 };
 
-/**
- * @file Enhanced Password Schema with Security Validations
- * @description Comprehensive password validation with security checks
- */
-
-/**
- * Basic password schema for less strict requirements
- */
-declare const passwordSchema: z.ZodString;
-/**
- * Password strength calculator
- */
-declare function calculatePasswordStrength(password: string): {
-    score: number;
-    feedback: string[];
-    level: 'very-weak' | 'weak' | 'fair' | 'good' | 'strong';
-};
-
 /**
  * Schema for user settings
  */
@@ -931,4 +784,109 @@ declare function getOrganisationContext(supabase: SupabaseClient): Promise<strin
  */
 declare function isOrganisationContextAvailable(supabase: SupabaseClient): Promise<boolean>;
 
-export { type CSRFTokenData, CachedAppIdResolver, DebugLogger, LazyDataTable, LogLevel, Logger, type LoggerConfig, PERFORMANCE_BUDGETS, PERFORMANCE_THRESHOLDS, type PerformanceMetrics$1 as PerformanceMetrics, PermissionType, type SafeQueryParams, type SanitizationOptions, type SecurityEvent$1 as SecurityEvent, auditLog, auditLogger, buildSafeQueryParams, bundleAnalyzer, cachedAppIdResolver, calculatePasswordStrength, clearOrganisationContext, createLazyComponent, createLazyUtility, createLogger, createPerformanceBenchmark, csrfManager, dateSchema, deepMerge, detectSQLInjection, emailSchema, escapeLikeQuery, generateCSRFToken, generateDeviceFingerprint, getAppId, getAppIds, getAppNameFromBuildTime, getAppNameFromEnvironment, getAppNameFromGlobal, getAppNameFromPackageJson, getCSRFToken, getCurrentAppName, getCurrentAppNameWithFallback, getOrganisationContext, getSecurityHeaders, hasAllPermissions, hasAnyPermission, hasPermission, isEmpty, isObject, isOrganisationContextAvailable, isStrongPassword, isValidDate, isValidEmail, isValidUrl, isWithinRange, lazyCSVUtils, lazyChartUtils, lazyDateUtils, lazyFormUtils, lazyLodash, limitOffsetSchema, loadCSVUtils, loadChartUtils, loadDateUtils, loadFormUtils, loadLodash, logAuditEvent, logAuthEvent, logPermissionEvent, logSecurityEvent, logger, matchesPattern, measureRenderPerformance, nameSchema, orderBySchema, parsePermission, passwordSchema, performanceBudgetMonitor, phoneSchema, renderSafeHtml, sanitizeFilters, sanitizeFormData, sanitizeHtml, sanitizeSearchQuery, sanitizeUserInput, searchQuerySchema, securityMonitor, setOrganisationContext, setRBACAppName, sqlIdentifierSchema, trackDynamicImport, transformPermissionMapToBoolean, urlSchema, userPreferencesSchema, userSettingsSchema, usernameSchema, validateCSRFToken, validateDeviceFingerprint, validateHtml, validateImportPattern, validateSecurityHeaders, validateUserInput };
+/**
+ * @file Location Utilities
+ * @package @jmruthers/pace-core
+ * @module Utils/Location
+ * @since 0.1.0
+ *
+ * Utility functions for working with geographic coordinates.
+ * Provides functions for formatting, validating, comparing, and generating URLs for coordinates.
+ *
+ * Features:
+ * - Format coordinates for display
+ * - Validate coordinate objects
+ * - Compare coordinates with tolerance
+ * - Generate Google Maps URLs
+ *
+ * @example
+ * ```ts
+ * import { formatCoordinates, hasValidCoordinates, areCoordinatesEqual, getGoogleMapsUrl } from '@jmruthers/pace-core/utils/location';
+ *
+ * const coords = { lat: -37.8136, lng: 144.9631 };
+ *
+ * // Format for display
+ * formatCoordinates(coords); // "-37.813600, 144.963100"
+ *
+ * // Validate
+ * hasValidCoordinates(coords); // true
+ *
+ * // Compare
+ * areCoordinatesEqual(coords, { lat: -37.8137, lng: 144.9632 }); // true (within tolerance)
+ *
+ * // Generate Google Maps URL
+ * getGoogleMapsUrl(coords); // "https://www.google.com/maps/search/?api=1&query=-37.8136,144.9631"
+ * ```
+ */
+/**
+ * Coordinate interface for latitude and longitude
+ */
+interface Coordinates {
+    lat: number;
+    lng: number;
+}
+/**
+ * Format coordinates as a string with 6 decimal places
+ *
+ * @param coords - Coordinate object with lat and lng
+ * @returns Formatted string "lat, lng" or "N/A" if invalid
+ *
+ * @example
+ * ```ts
+ * formatCoordinates({ lat: -37.8136, lng: 144.9631 });
+ * // "-37.813600, 144.963100"
+ *
+ * formatCoordinates(undefined);
+ * // "N/A"
+ * ```
+ */
+declare function formatCoordinates(coords?: Coordinates): string;
+/**
+ * Check if coordinates are valid
+ *
+ * @param coords - Coordinate object to validate
+ * @returns true if coordinates are valid, false otherwise
+ *
+ * @example
+ * ```ts
+ * hasValidCoordinates({ lat: -37.8136, lng: 144.9631 }); // true
+ * hasValidCoordinates({ lat: 91, lng: 0 }); // false (lat out of range)
+ * hasValidCoordinates(undefined); // false
+ * ```
+ */
+declare function hasValidCoordinates(coords?: {
+    lat?: number;
+    lng?: number;
+}): boolean;
+/**
+ * Check if two coordinates are equal within a tolerance
+ *
+ * @param coords1 - First coordinate object
+ * @param coords2 - Second coordinate object
+ * @param tolerance - Tolerance in degrees (default: 0.0001° ≈ 11 meters)
+ * @returns true if coordinates are within tolerance, false otherwise
+ *
+ * @example
+ * ```ts
+ * const coords1 = { lat: -37.8136, lng: 144.9631 };
+ * const coords2 = { lat: -37.8137, lng: 144.9632 };
+ * areCoordinatesEqual(coords1, coords2); // true (within default tolerance)
+ * areCoordinatesEqual(coords1, coords2, 0.00001); // false (stricter tolerance)
+ * ```
+ */
+declare function areCoordinatesEqual(coords1: Coordinates | null | undefined, coords2: Coordinates | null | undefined, tolerance?: number): boolean;
+/**
+ * Generate a Google Maps search URL for coordinates
+ *
+ * @param coords - Coordinate object with lat and lng
+ * @returns Google Maps search URL or empty string if invalid
+ *
+ * @example
+ * ```ts
+ * getGoogleMapsUrl({ lat: -37.8136, lng: 144.9631 });
+ * // "https://www.google.com/maps/search/?api=1&query=-37.8136,144.9631"
+ * ```
+ */
+declare function getGoogleMapsUrl(coords?: Coordinates): string;
+
+export { type CSRFTokenData, CachedAppIdResolver, type Coordinates, DebugLogger, LazyDataTable, PERFORMANCE_BUDGETS, PERFORMANCE_THRESHOLDS, type PerformanceMetrics$1 as PerformanceMetrics, PermissionType, type SafeQueryParams, type SanitizationOptions, type SecurityEvent$1 as SecurityEvent, areCoordinatesEqual, auditLog, auditLogger, buildSafeQueryParams, bundleAnalyzer, cachedAppIdResolver, clearOrganisationContext, createLazyComponent, createLazyUtility, createPerformanceBenchmark, csrfManager, deepMerge, detectSQLInjection, escapeLikeQuery, formatCoordinates, generateCSRFToken, generateDeviceFingerprint, getAppId, getAppIds, getAppNameFromBuildTime, getAppNameFromEnvironment, getAppNameFromGlobal, getAppNameFromPackageJson, getCSRFToken, getCurrentAppName, getCurrentAppNameWithFallback, getGoogleMapsUrl, getOrganisationContext, getSecurityHeaders, hasAllPermissions, hasAnyPermission, hasPermission, hasValidCoordinates, isEmpty, isObject, isOrganisationContextAvailable, isStrongPassword, isValidDate, isValidEmail, isValidUrl, isWithinRange, lazyCSVUtils, lazyChartUtils, lazyDateUtils, lazyFormUtils, lazyLodash, limitOffsetSchema, loadCSVUtils, loadChartUtils, loadDateUtils, loadFormUtils, loadLodash, logAuditEvent, logAuthEvent, logPermissionEvent, logSecurityEvent, matchesPattern, measureRenderPerformance, orderBySchema, parsePermission, performanceBudgetMonitor, renderSafeHtml, sanitizeFilters, sanitizeFormData, sanitizeHtml, sanitizeSearchQuery, sanitizeUserInput, searchQuerySchema, securityMonitor, setOrganisationContext, setRBACAppName, sqlIdentifierSchema, trackDynamicImport, transformPermissionMapToBoolean, userPreferencesSchema, userSettingsSchema, usernameSchema, validateCSRFToken, validateDeviceFingerprint, validateHtml, validateImportPattern, validateSecurityHeaders, validateUserInput };