@jmruthers/pace-core 0.4.1 → 0.5.3

package/dist/utils.d.ts

@@ -1,17 +1,94 @@
-export { A as AppConfig, S as SecureDataAccess, a as cn, g as getAppConfig, d as getCurrentAppId, b as getCurrentAppName, s as setAppConfig } from './appConfig-fB1pP_v3.js';
+export { A as AppConfig, S as SecureDataAccess, a as cn, g as getAppConfig, d as getCurrentAppId, b as getCurrentAppName, s as setAppConfig } from './appConfig-BVGyuvI7.js';
 import { z } from 'zod';
-import { RenderResult } from '@testing-library/react';
 export { u as useComponentPerformance } from './useComponentPerformance-DE9l5RkL.js';
 import * as date_fns from 'date-fns';
-import { D as DataTable } from './DataTable-BDBqkU-i.js';
+import { D as DataTable } from './DataTable-ltTFXHS3.js';
 import React__default, { ComponentType } from 'react';
 import { SupabaseClient } from '@supabase/supabase-js';
-import './organisation-DLNNQhPB.js';
+import './organisation-CO3Sh3_D.js';
 import 'clsx';
 import 'react/jsx-runtime';
-import './types-Bavn44NW.js';
+import './types-BRDU7N6w.js';
 import '@tanstack/react-table';
 
+/**
+ * @file Debug Logger Utility
+ * @package @jmruthers/pace-core
+ * @module Utils/DebugLogger
+ * @since 0.4.76
+ */
+/**
+ * Debug logger that respects environment settings
+ * Only logs in development mode to prevent production console spam
+ */
+declare class DebugLogger {
+    private static isDevelopment;
+    /**
+     * Log debug information only in development mode
+     */
+    static log(component: string, message: string, ...args: any[]): void;
+    /**
+     * Log error information (always logged)
+     */
+    static error(component: string, message: string, ...args: any[]): void;
+    /**
+     * Log warning information (always logged)
+     */
+    static warn(component: string, message: string, ...args: any[]): void;
+    /**
+     * Log info information only in development mode
+     */
+    static info(component: string, message: string, ...args: any[]): void;
+}
+
+/**
+ * Utility to resolve the current app name from various sources
+ * Priority: package.json > environment variables > fallback
+ */
+/**
+ * Get the app name from package.json at build time
+ * This works by reading package.json during the build process
+ */
+declare function getAppNameFromPackageJson(): string | null;
+/**
+ * Get the app name from build-time injected variables
+ * This is the preferred method for browser environments
+ */
+declare function getAppNameFromBuildTime(): string | null;
+/**
+ * Get the app name from a global variable set by the consuming app
+ * This is the simplest approach for browser environments
+ */
+declare function getAppNameFromGlobal(): string | null;
+/**
+ * Get the app name from environment variables
+ * Fallback method for when package.json is not available
+ */
+declare function getAppNameFromEnvironment(): string | null;
+/**
+ * Set the app name globally for RBAC resolution
+ * Call this in your app's main entry point (e.g., main.tsx, index.tsx)
+ *
+ * @param appName - The app name from your package.json
+ *
+ * @example
+ * ```tsx
+ * // In your main.tsx or index.tsx
+ * import { setRBACAppName } from '@jmruthers/pace-core/utils';
+ *
+ * // Set the app name from package.json
+ * setRBACAppName('CAKE');
+ *
+ * // Rest of your app setup...
+ * ```
+ */
+declare function setRBACAppName(appName: string): void;
+/**
+ * Get the app name with fallback to a default
+ * Useful when you need a guaranteed app name
+ */
+declare function getCurrentAppNameWithFallback(fallback?: string): string;
+
 /**
  * @file Internal utilities for validation module
  * @internal This file contains implementation details that should not be used directly
@@ -190,60 +267,6 @@ interface SecurityEvent$1 {
 declare function getSecurityHeaders(): Record<string, string>;
 declare function validateSecurityHeaders(headers: Record<string, string>): boolean;
 
-/**
- * Accessibility testing helpers
- */
-
-declare const a11yHelpers: {
-    checkFocus: (element: HTMLElement) => boolean;
-    checkAriaLabel: (element: HTMLElement) => string | null;
-    checkTabIndex: (element: HTMLElement) => number;
-    checkKeyboardNavigation: (element: HTMLElement) => boolean;
-    simulateKeyPress: (element: HTMLElement, key: string) => Promise<void>;
-    /**
-     * Check if element has proper heading hierarchy
-     */
-    checkHeadingHierarchy: (container: HTMLElement) => boolean;
-    /**
-     * Check if form has proper labels
-     */
-    checkFormLabels: (container: HTMLElement) => {
-        valid: boolean;
-        issues: string[];
-    };
-    /**
-     * Test keyboard navigation through focusable elements
-     */
-    testKeyboardNavigation: (container: HTMLElement) => Promise<{
-        success: boolean;
-        focusableElements: number;
-        issues: string[];
-    }>;
-};
-/**
- * Comprehensive accessibility test for any component
- */
-declare function runAccessibilityTests(renderResult: RenderResult, options?: {
-    checkAxe?: boolean;
-    checkKeyboard?: boolean;
-    checkHeadings?: boolean;
-    checkLabels?: boolean;
-}): Promise<{
-    axeResults?: any;
-    keyboardResults?: any;
-    headingResults?: boolean;
-    labelResults?: any;
-    overall: boolean;
-}>;
-/**
- * Screen reader simulation helpers
- */
-declare const screenReaderHelpers: {
-    getAccessibleName: (element: HTMLElement) => string;
-    getAccessibleDescription: (element: HTMLElement) => string;
-    getRoleDescription: (element: HTMLElement) => string;
-};
-
 /**
  * Performance thresholds and constants
  */
@@ -613,4 +636,4 @@ declare function getOrganisationContext(supabase: SupabaseClient): Promise<strin
  */
 declare function isOrganisationContextAvailable(supabase: SupabaseClient): Promise<boolean>;
 
-export { CSP_DIRECTIVES, LazyDataTable, PERFORMANCE_BUDGETS, PERFORMANCE_THRESHOLDS, type PerformanceMetrics$1 as PerformanceMetrics, PermissionType, RateLimiter, type SanitizationOptions, type SecurityEvent$1 as SecurityEvent, a11yHelpers, auditLog, auditLogger, bundleAnalyzer, clearOrganisationContext, combineSchemas, createLazyComponent, createLazyUtility, createPerformanceBenchmark, deepMerge, emailSchema, formatCompactNumber, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, generateCSPHeader, generateDeviceFingerprint, getOrganisationContext, getSecurityHeaders, hasAllPermissions, hasAnyPermission, hasPermission, isEmpty, isObject, isOrganisationContextAvailable, isStrongPassword, isValidDate, isValidEmail, isValidUrl, isWithinRange, lazyCSVUtils, lazyChartUtils, lazyDateUtils, lazyFormUtils, lazyLodash, loadCSVUtils, loadChartUtils, loadDateUtils, loadFormUtils, loadLodash, logAuditEvent, logAuthEvent, logPermissionEvent, logSecurityEvent, matchesPattern, measureRenderPerformance, nameSchema, parsePermission, passwordSchema, performanceBudgetMonitor, phoneSchema, pickSchema, runAccessibilityTests, sanitizeEmail, sanitizeFileName, sanitizeFormData, sanitizePhoneNumber, sanitizeSqlInput, sanitizeUrl, sanitizeUserInput, sanitizeUserInput_deprecated, screenReaderHelpers, securityMonitor, setOrganisationContext, trackDynamicImport, transformPermissionMapToBoolean, urlSchema, useSessionTracking, usernameSchema, validateDeviceFingerprint, validateImportPattern, validateSecurityHeaders, validateUserInput };
+export { CSP_DIRECTIVES, DebugLogger, LazyDataTable, PERFORMANCE_BUDGETS, PERFORMANCE_THRESHOLDS, type PerformanceMetrics$1 as PerformanceMetrics, PermissionType, RateLimiter, type SanitizationOptions, type SecurityEvent$1 as SecurityEvent, auditLog, auditLogger, bundleAnalyzer, clearOrganisationContext, combineSchemas, createLazyComponent, createLazyUtility, createPerformanceBenchmark, deepMerge, emailSchema, formatCompactNumber, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, generateCSPHeader, generateDeviceFingerprint, getAppNameFromBuildTime, getAppNameFromEnvironment, getAppNameFromGlobal, getAppNameFromPackageJson, getCurrentAppNameWithFallback, getOrganisationContext, getSecurityHeaders, hasAllPermissions, hasAnyPermission, hasPermission, isEmpty, isObject, isOrganisationContextAvailable, isStrongPassword, isValidDate, isValidEmail, isValidUrl, isWithinRange, lazyCSVUtils, lazyChartUtils, lazyDateUtils, lazyFormUtils, lazyLodash, loadCSVUtils, loadChartUtils, loadDateUtils, loadFormUtils, loadLodash, logAuditEvent, logAuthEvent, logPermissionEvent, logSecurityEvent, matchesPattern, measureRenderPerformance, nameSchema, parsePermission, passwordSchema, performanceBudgetMonitor, phoneSchema, pickSchema, sanitizeEmail, sanitizeFileName, sanitizeFormData, sanitizePhoneNumber, sanitizeSqlInput, sanitizeUrl, sanitizeUserInput, sanitizeUserInput_deprecated, securityMonitor, setOrganisationContext, setRBACAppName, trackDynamicImport, transformPermissionMapToBoolean, urlSchema, useSessionTracking, usernameSchema, validateDeviceFingerprint, validateImportPattern, validateSecurityHeaders, validateUserInput };