@jmruthers/pace-core 0.5.183 → 0.5.185

package/dist/chunk-UHNYIBXL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/file-reference.ts"],"sourcesContent":["// File Reference System Types\n// These types define the structure for the centralized file reference system\n\nimport type { AppId } from './core';\n\nexport interface FileReference {\n  id: string;\n  table_name: string;\n  record_id: string;\n  file_path: string;\n  file_metadata: FileMetadata;\n  organisation_id: string;\n  app_id: AppId;\n  is_public: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface FileMetadata {\n  fileName: string;\n  fileType: string;\n  fileSize?: number;\n  width?: number;\n  height?: number;\n  category: FileCategory;\n  hash?: string;\n  uploadedBy?: string;\n  uploadedAt?: string;\n  tags?: string[];\n  customMetadata?: Record<string, unknown>;\n}\n\nexport enum FileCategory {\n  PROFILE_PHOTOS = 'profile_photos',\n  ID_DOCUMENTS = 'id_documents',\n  QUALIFICATIONS = 'qualifications',\n  MEDICAL_DOCUMENTS = 'medical_documents',\n  DISH_IMAGES = 'dish_images',\n  EVENT_LOGOS = 'event_logos',\n  GENERAL_DOCUMENTS = 'general_documents',\n  IMAGES = 'images',\n  AUDIO = 'audio',\n  VIDEO = 'video',\n  ARCHIVES = 'archives',\n  // CAKE-specific categories\n  CAKE_DISH = 'cake_dish',\n  // TRAC-specific categories\n  TRAC_ACCOMMODATION = 'trac_accommodation',\n  TRAC_ACTIVITY = 'trac_activity',\n  TRAC_JOURNAL = 'trac_journal',\n  TRAC_TRANSPORT = 'trac_transport'\n}\n\nexport interface FileUploadOptions {\n  table_name: string;\n  record_id: string;\n  organisation_id: string;\n  app_id: AppId;\n  category: FileCategory;\n  is_public?: boolean;\n  custom_metadata?: Record<string, unknown>;\n}\n\n\nexport interface FileReferenceService {\n  createFileReference(options: FileUploadOptions, file: File): Promise<FileReference>;\n  getFileReference(table_name: string, record_id: string, organisation_id: string): Promise<FileReference | null>;\n  getFileReferenceById(id: string, organisation_id: string): Promise<FileReference | null>;\n  getFileUrl(table_name: string, record_id: string, organisation_id: string): Promise<string | null>;\n  getSignedUrl(table_name: string, record_id: string, organisation_id: string, expires_in?: number): Promise<string | null>;\n  updateFileReference(id: string, updates: Partial<FileReference>): Promise<FileReference>;\n  deleteFileReference(table_name: string, record_id: string, organisation_id: string, delete_file?: boolean): Promise<boolean>;\n  listFileReferences(table_name: string, record_id: string, organisation_id: string): Promise<FileReference[]>;\n  getFilesByCategory(table_name: string, record_id: string, category: FileCategory, organisation_id: string): Promise<FileReference[]>;\n  getFileCount(table_name: string, record_id: string, organisation_id: string): Promise<number>;\n  uploadMultipleFiles(options: FileUploadOptions, files: File[]): Promise<BulkUploadResult>;\n}\n\nexport interface StorageUploadOptions {\n  orgId: string;\n  category: FileCategory;\n  isPublic?: boolean;\n  customPath?: string;\n}\n\nexport interface FileUploadResult {\n  file_reference: FileReference;\n  file_url: string;\n  signed_url?: string;\n}\n\n/**\n * File reference with pre-fetched URL\n * Useful for display components that need both metadata and URL\n */\nexport interface FileReferenceWithUrl extends FileReference {\n  url: string;\n  isSignedUrl: boolean;\n  expiresAt?: Date;\n}\n\n/**\n * Upload progress information\n */\nexport interface UploadProgress {\n  loaded: number;\n  total: number;\n  percentage: number;\n  fileName: string;\n  status: 'idle' | 'uploading' | 'processing' | 'completed' | 'error';\n  error?: string;\n}\n\n/**\n * Bulk upload result\n */\nexport interface BulkUploadResult {\n  /** Successfully created file references */\n  success: FileReference[];\n  /** Per-file failures with associated errors */\n  failed: { file: File; error: string }[];\n\n  // Optional aggregate fields for consumers that need totals\n  total?: number;\n  successful?: number;\n  results?: Array<{\n    file: File;\n    result: FileUploadResult | null;\n    error?: string;\n  }>;\n}\n\n/**\n * Bucket information for file storage\n */\nexport interface BucketInfo {\n  name: 'files' | 'public-files';\n  isPublic: boolean;\n  description: string;\n}\n\n/**\n * File URL information (public or signed)\n */\nexport interface FileUrlInfo {\n  url: string;\n  isPublic: boolean;\n  isSignedUrl: boolean;\n  expiresAt?: Date;\n  bucket: BucketInfo;\n}\n"],"mappings":";AAgCO,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,kBAAe;AACf,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,uBAAoB;AACpB,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,uBAAoB;AACpB,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,cAAW;AAEX,EAAAA,cAAA,eAAY;AAEZ,EAAAA,cAAA,wBAAqB;AACrB,EAAAA,cAAA,mBAAgB;AAChB,EAAAA,cAAA,kBAAe;AACf,EAAAA,cAAA,oBAAiB;AAlBP,SAAAA;AAAA,GAAA;","names":["FileCategory"]}

package/dist/formatting-5wETwiGF.d.ts

@@ -1,162 +0,0 @@
-import { SupabaseClient } from '@supabase/supabase-js';
-import { ClassValue } from 'clsx';
-
-/**
- * Hook for manual session tracking (event switches and session expiration).
- *
- * Note: Login and logout tracking is automatically handled by UnifiedAuthProvider.
- * You should only use this hook for tracking event switches or session expirations.
- *
- * @param supabaseClient - Supabase client instance
- * @param appName - Optional application name for tracking
- * @returns Object containing tracking functions for event switches and session expiration
- */
-declare function useSessionTracking(supabaseClient: SupabaseClient, appName?: string): {
-    trackEventSwitch: (eventId: string) => Promise<void>;
-    trackSessionExpired: () => Promise<void>;
-};
-
-/**
- * @file Secure Data Access Utility
- * @package @jmruthers/pace-core
- * @module Utils/SecureDataAccess
- * @since 0.4.0
- *
- * Secure data access utilities that enforce organisation context for all database operations.
- * Prevents data leakage between organisations and ensures proper access validation.
- */
-
-interface DatabaseRecord {
-    id: string;
-    organisation_id: string;
-    [key: string]: unknown;
-}
-interface DatabaseData {
-    [key: string]: unknown;
-}
-interface DatabaseFilters {
-    [key: string]: unknown;
-}
-interface SecureQueryOptions {
-    table: string;
-    select: string;
-    organisationId: string;
-    filters?: DatabaseFilters;
-    orderBy?: string;
-    limit?: number;
-    offset?: number;
-}
-interface SecureDataAccess {
-    secureQuery: <T extends DatabaseRecord = DatabaseRecord>(options: SecureQueryOptions) => Promise<T[]>;
-    secureSingleQuery: <T extends DatabaseRecord = DatabaseRecord>(options: SecureQueryOptions) => Promise<T | null>;
-    secureInsert: <T extends DatabaseRecord = DatabaseRecord>(table: string, data: DatabaseData, organisationId: string) => Promise<T | null>;
-    secureUpdate: <T extends DatabaseRecord = DatabaseRecord>(table: string, data: DatabaseData, filters: DatabaseFilters, organisationId: string) => Promise<T | null>;
-    secureDelete: (table: string, filters: DatabaseFilters, organisationId: string) => Promise<boolean>;
-    queryByOrganisation: <T extends DatabaseRecord = DatabaseRecord>(table: string, select: string, organisationId: string, filters?: DatabaseFilters) => Promise<T[]>;
-    validateOrganisationContext: (organisationId: string) => void;
-    ensureOrganisationColumn: (table: string) => boolean;
-}
-/**
- * Create a secure data access instance
- * @param supabase - Supabase client instance
- * @param organisationId - Current organisation context
- * @param isSuperAdmin - Whether user has super admin privileges
- * @returns Secure data access utilities
- */
-declare const createSecureDataAccess: (supabase: SupabaseClient, organisationId: string, isSuperAdmin?: boolean) => SecureDataAccess;
-
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * Application configuration utilities
- */
-interface AppConfig {
-    appName: string;
-    appId: string;
-}
-/**
- * Set the current application configuration
- */
-declare function setAppConfig(config: AppConfig): void;
-/**
- * Get the current application configuration
- */
-declare function getAppConfig(): AppConfig;
-/**
- * Get the current app name
- */
-declare function getCurrentAppName(): string;
-/**
- * Get the current app ID
- */
-declare function getCurrentAppId(): string;
-
-/**
- * Utility functions for formatting data in the application
- */
-/**
- * Format a date as a readable string in "dd mmm yyyy" format (e.g., "15 Jun 2024")
- */
-declare function formatDate(date: Date | string | number): string;
-/**
- * Format a time as a readable string in "HH:mm" format (e.g., "14:30")
- * Uses 24-hour format for consistency across pace apps
- */
-declare function formatTime(date: Date | string | number): string;
-/**
- * Format a date and time as a readable string in "dd mmm yyyy, HH:mm" format (e.g., "15 Jun 2024, 14:30")
- * Uses 24-hour format for consistency across pace apps
- */
-declare function formatDateTime(date: Date | string | number): string;
-/**
- * Format a number as a currency
- */
-declare function formatCurrency(value: number, currencyCode?: string, locale?: string): string;
-/**
- * Format a number with custom options
- */
-declare function formatNumber(value: number, options?: Intl.NumberFormatOptions, locale?: string): string;
-/**
- * Format a number as a percentage.
- *
- * The third parameter can be either:
- * - A number for fixed decimal places (backward compatible): `formatPercent(0.81, 'en-US', 2)`
- * - An options object with:
- *   - `decimals`: Fixed number of decimal places (default: 1)
- *   - `preserveDecimals`: Auto-detect and preserve decimal places from the input value
- *   - `maxDecimals`: Maximum decimal places when preserving (default: 10)
- *
- * @param value - The percentage value as a decimal (e.g., 0.81 for 0.81%)
- * @param locale - The locale string (default: 'en-US')
- * @param decimalsOrOptions - Either a number for fixed decimals, or an options object with:
- *   - `decimals` - Fixed number of decimal places (default: 1)
- *   - `preserveDecimals` - Auto-detect and preserve decimal places from the input value
- *   - `maxDecimals` - Maximum decimal places when preserving (default: 10)
- * @returns Formatted percentage string (e.g., "0.81%", "81%")
- *
- * @example
- * ```ts
- * // Fixed decimals (default behavior)
- * formatPercent(0.5) // '0.5%'
- * formatPercent(0.81, 'en-US', 1) // '0.8%' (loses precision)
- *
- * // Preserve decimal places dynamically
- * formatPercent(0.81, 'en-US', { preserveDecimals: true }) // '0.81%'
- * formatPercent(0.8123, 'en-US', { preserveDecimals: true, maxDecimals: 2 }) // '0.81%'
- * ```
- */
-declare function formatPercent(value: number, locale?: string, decimalsOrOptions?: number | {
-    decimals?: number;
-    preserveDecimals?: boolean;
-    maxDecimals?: number;
-}): string;
-/**
- * Format a large number with abbreviations (K, M, B)
- */
-declare function formatCompactNumber(value: number, locale?: string): string;
-/**
- * Format a file size in bytes to a human-readable string
- */
-declare function formatFileSize(bytes: number): string;
-
-export { type SecureDataAccess as S, cn as a, getCurrentAppName as b, createSecureDataAccess as c, getCurrentAppId as d, formatTime as e, formatDate as f, getAppConfig as g, formatDateTime as h, formatCurrency as i, formatNumber as j, formatPercent as k, formatCompactNumber as l, formatFileSize as m, setAppConfig as s, useSessionTracking as u };