@jmruthers/pace-core 0.5.86 → 0.5.88

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { a as UnifiedAuthContextType, c as UnifiedAuthProvider, b as UnifiedAuthProviderProps, U as UserEventAccess, u as useUnifiedAuth } from './UnifiedAuthProvider-B391Aqum.js';
-import { m as InactivityService, n as EventService, o as OrganisationService, A as AuthService } from './AuthService-Df3IozMG.js';
-export { d as EventProvider, k as InactivityProvider, g as OrganisationProvider } from './AuthService-Df3IozMG.js';
+export { a as UnifiedAuthContextType, c as UnifiedAuthProvider, b as UnifiedAuthProviderProps, U as UserEventAccess, u as useUnifiedAuth } from './UnifiedAuthProvider-BVKmQd9u.js';
+import { m as InactivityService, n as EventService, o as OrganisationService, A as AuthService } from './AuthService-DcTI5Ov4.js';
+export { d as EventProvider, k as InactivityProvider, g as OrganisationProvider } from './AuthService-DcTI5Ov4.js';
 import { e as OrganisationContextType } from './organisation-D6qRDtbF.js';
 export { O as Organisation, a as OrganisationMembership, f as OrganisationProviderProps, g as OrganisationSecurityError, U as UserProfile } from './organisation-D6qRDtbF.js';
 import { E as Event } from './unified-DQ4VcT7H.js';
+import { S as SessionRestorationState } from './auth-DReDSLq9.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 export { ALL_PERMISSIONS, AccessLevel, AccessLevelGuard, AllPermissions, CACHE_PATTERNS, DataAccessRecord, EVENT_APP_PERMISSIONS, EnhancedNavigationMenu, EnhancedNavigationMenuProps, EventAppRole, GLOBAL_PERMISSIONS, GlobalRole, InvalidScopeError, LogLevel, MissingUserContextError, NavigationAccessRecord, NavigationContextType, NavigationGuard, NavigationGuardProps, NavigationProvider, NavigationProviderProps, ORGANISATION_PERMISSIONS, Operation, OrganisationContextRequiredError, OrganisationRole, PAGE_PERMISSIONS, PageAccessRecord, PagePermissionContextType, PagePermissionGuard, PagePermissionGuardProps, PagePermissionProvider, PagePermissionProviderProps, Permission, PermissionCheck, PermissionDeniedError, PermissionEnforcer, PermissionEnforcerProps, PermissionGuard, PermissionMap, RBACAuditManager, RBACCache, RBACConfig, RBACEngine, RBACError, RBACLogger, RBACNotInitializedError, RoleBasedRouter, RoleBasedRouterContextType, RoleBasedRouterProps, RouteAccessRecord, RouteConfig, Scope, SecureDataContextType, SecureDataProvider, SecureDataProviderProps, SecureSupabaseClient, UUID, UseResolvedScopeOptions, UseResolvedScopeReturn, createAuditManager, createRBACConfig, createRBACEngine, createRBACExpressMiddleware, createRBACMiddleware, createSecureClient, emitAuditEvent, fromSupabaseClient, getAccessLevel, getGlobalAuditManager, getPermissionMap, getPermissionsForRole, getRBACConfig, getRBACLogger, getRoleContext, hasAllPermissions, hasAnyPermission, hasAnyPermissionCached, hasPermission, hasPermissionCached, isDebugMode, isDevelopmentMode, isPermitted, isPermittedCached, isValidPermission, rbacCache, resolveAppContext, setGlobalAuditManager, setupRBAC, useAccessLevel, useCachedPermissions, useCan, useHasAllPermissions, useHasAnyPermission, useMultiplePermissions, useNavigationPermissions, usePagePermissions, usePermissions, useRBAC, useResolvedScope, useRoleBasedRouter, useSecureData, withAccessLevelGuard, withPermissionGuard, withRoleGuard } from './rbac/index.js';
-import { bi as FileSizeLimits, bj as StorageConfig, bk as StorageUploadOptions, bl as StorageFileMetadata, bm as StorageUploadResult, bn as StorageUrlOptions, bo as StorageListOptions, bp as StorageListResult } from './PublicLoadingSpinner-CnUaz0vG.js';
-export { A as Alert, m as AlertDescription, l as AlertTitle, n as Avatar, p as AvatarFallback, o as AvatarImage, B as Button, a as ButtonProps, C as Card, g as CardActions, f as CardContent, e as CardDescription, c as CardFooter, b as CardHeader, h as CardProps, d as CardTitle, q as Checkbox, b3 as DefaultPublicErrorFallback, D as Dialog, K as DialogBody, G as DialogClose, H as DialogContent, O as DialogDescription, M as DialogFooter, J as DialogHeader, E as DialogOverlay, z as DialogPortal, N as DialogTitle, F as DialogTrigger, az as ErrorBoundary, a_ as EventLogo, a$ as EventLogoCompact, b0 as EventLogoLarge, ba as EventLogoProps, aD as EventSelector, aF as FileDisplay, aG as FileDisplayProps, ar as Footer, as as FooterProps, am as Form, aq as Header, I as Input, j as InputProps, L as Label, k as LabelProps, aC as LoadingSpinner, ao as LoginForm, ap as LoginFormProps, av as NavigationItem, at as NavigationMenu, au as NavigationMenuProps, aw as OrganisationSelector, bf as PaceAppLayout, be as PaceAppLayoutProps, bh as PaceLoginPage, bg as PaceLoginPageProps, aE as PasswordResetForm, P as Progress, b1 as PublicErrorBoundary, bb as PublicErrorBoundaryProps, bc as PublicErrorBoundaryState, b6 as PublicLoadingSkeleton, b4 as PublicLoadingSpinner, b5 as PublicLoadingSpinnerFullPage, bd as PublicLoadingSpinnerProps, aZ as PublicPageContextChecker, aX as PublicPageDebugger, aY as PublicPageDiagnostic, aW as PublicPageFooter, b9 as PublicPageFooterProps, aS as PublicPageHeader, b8 as PublicPageHeaderProps, aQ as PublicPageLayout, b7 as PublicPageLayoutProps, aT as PublicPageProvider, $ as Select, a3 as SelectContent, a0 as SelectGroup, a5 as SelectItem, a4 as SelectLabel, a6 as SelectSeparator, a2 as SelectTrigger, a1 as SelectValue, br as StorageFileInfo, S as Switch, r as SwitchProps, T as Table, t as TableBody, u as TableCaption, v as TableCell, w as TableFooter, x as TableHead, s as TableHeader, y as TableRow, a7 as Toast, a9 as ToastAction, af as ToastActionElement, ae as ToastClose, ad as ToastDescription, ag as ToastProps, aa as ToastProvider, ac as ToastTitle, ab as ToastViewport, a8 as Toaster, ah as Tooltip, aj as TooltipContent, ak as TooltipProvider, al as TooltipRoot, ai as TooltipTrigger, aP as UseFileReferenceForRecordReturn, aN as UseFileReferenceOptions, aO as UseFileReferenceReturn, ay as UserMenu, bq as UserMenuProps, b2 as useErrorBoundary, aL as useFileReference, aM as useFileReferenceForRecord, aI as useFileUpload, aV as useIsPublicPage, aR as usePublicPageContext, aU as usePublicPageProviderContext, aH as useStorage } from './PublicLoadingSpinner-CnUaz0vG.js';
+export { A as Alert, m as AlertDescription, l as AlertTitle, n as Avatar, p as AvatarFallback, o as AvatarImage, B as Button, a as ButtonProps, C as Card, g as CardActions, f as CardContent, e as CardDescription, c as CardFooter, b as CardHeader, h as CardProps, d as CardTitle, q as Checkbox, b9 as DefaultPublicErrorFallback, D as Dialog, K as DialogBody, G as DialogClose, H as DialogContent, O as DialogDescription, M as DialogFooter, J as DialogHeader, E as DialogOverlay, z as DialogPortal, N as DialogTitle, F as DialogTrigger, az as ErrorBoundary, b4 as EventLogo, b5 as EventLogoCompact, b6 as EventLogoLarge, bg as EventLogoProps, aE as EventSelector, aI as FileDisplay, aJ as FileDisplayProps, aG as FileUpload, aH as FileUploadProps, ar as Footer, as as FooterProps, am as Form, aq as Header, I as Input, j as InputProps, L as Label, k as LabelProps, aC as LoadingSpinner, ao as LoginForm, ap as LoginFormProps, av as NavigationItem, at as NavigationMenu, au as NavigationMenuProps, aw as OrganisationSelector, bl as PaceAppLayout, bk as PaceAppLayoutProps, bn as PaceLoginPage, bm as PaceLoginPageProps, aF as PasswordResetForm, P as Progress, b7 as PublicErrorBoundary, bh as PublicErrorBoundaryProps, bi as PublicErrorBoundaryState, bc as PublicLoadingSkeleton, ba as PublicLoadingSpinner, bb as PublicLoadingSpinnerFullPage, bj as PublicLoadingSpinnerProps, b3 as PublicPageContextChecker, b1 as PublicPageDebugger, b2 as PublicPageDiagnostic, b0 as PublicPageFooter, bf as PublicPageFooterProps, aY as PublicPageHeader, be as PublicPageHeaderProps, aW as PublicPageLayout, bd as PublicPageLayoutProps, aZ as PublicPageProvider, $ as Select, a3 as SelectContent, a0 as SelectGroup, a5 as SelectItem, a4 as SelectLabel, a6 as SelectSeparator, a2 as SelectTrigger, a1 as SelectValue, aD as SessionRestorationLoader, S as Switch, r as SwitchProps, T as Table, t as TableBody, u as TableCaption, v as TableCell, w as TableFooter, x as TableHead, s as TableHeader, y as TableRow, a7 as Toast, a9 as ToastAction, af as ToastActionElement, ae as ToastClose, ad as ToastDescription, ag as ToastProps, aa as ToastProvider, ac as ToastTitle, ab as ToastViewport, a8 as Toaster, ah as Tooltip, aj as TooltipContent, ak as TooltipProvider, al as TooltipRoot, ai as TooltipTrigger, aV as UseEventLogoOptions, aU as UseEventLogoReturn, aQ as UseFileReferenceForRecordReturn, aO as UseFileReferenceOptions, aP as UseFileReferenceReturn, ay as UserMenu, bo as UserMenuProps, aS as clearEventLogoCache, aT as getEventLogoCacheStats, b8 as useErrorBoundary, aR as useEventLogo, aK as useFileReference, aM as useFileReferenceById, aL as useFileReferenceForRecord, aN as useFilesByCategory, a$ as useIsPublicPage, aX as usePublicPageContext, a_ as usePublicPageProviderContext } from './PublicLoadingSpinner-BQXD1fbO.js';
 export { u as useToast } from './useToast-Bm6TnSK-.js';
 export { D as DataTable, a as DataTableProps } from './DataTable-BE0OXZKQ.js';
 import { D as DataRecord, f as DataTableAction } from './types-BDg1mAGG.js';
@@ -15,11 +15,11 @@ export { A as AggregateConfig, a as DataTableColumn, g as DataTableToolbarButton
 import { ColumnDef } from '@tanstack/react-table';
 export { r as UsePublicEventLogoOptions, q as UsePublicEventLogoReturn, p as UsePublicEventOptions, o as UsePublicEventReturn, s as UsePublicRouteParamsReturn, f as clearPublicEventCache, i as clearPublicLogoCache, n as extractEventCodeFromPath, m as generatePublicRoutePath, g as getPublicEventCacheStats, j as getPublicLogoCacheStats, c as useAppConfig, u as useEventTheme, a as useOrganisationPermissions, b as useOrganisationSecurity, e as usePublicEvent, l as usePublicEventCode, h as usePublicEventLogo, k as usePublicRouteParams } from './usePublicRouteParams-BlgwXweB.js';
 export { a as cn, c as createSecureDataAccess, j as formatCompactNumber, e as formatCurrency, f as formatDate, k as formatFileSize, h as formatNumber, i as formatPercent, g as getAppConfig, d as getCurrentAppId, b as getCurrentAppName, s as setAppConfig } from './formatting-BfDeV-ja.js';
-import React__default from 'react';
+export { b as FileCategory, a as FileMetadata, F as FileReference, c as FileUploadOptions } from './file-reference-C9isKNPn.js';
 import { SupabaseClient } from '@supabase/supabase-js';
-export { b as FileCategory, a as FileMetadata, F as FileReference, c as FileUploadOptions } from './file-reference-9xUOnwyt.js';
 export { StyleImport, getAllStylePaths, getStylePath, styleConfig } from './styles/index.js';
 export { ColorPalette, ColorShade, PaletteData, applyPalette, clearPalette, generateSSRThemeCSS, getCurrentThemeData, isDynamicThemingActive } from './theming/runtime.js';
+import 'react';
 import './database-BXAfr2Y_.js';
 import '@radix-ui/react-label';
 import '@radix-ui/react-avatar';
@@ -166,6 +166,25 @@ declare function useOrganisationService(): OrganisationService;
 
 declare function useAuthService(): AuthService;
 
+/**
+ * @file useSessionRestoration Hook
+ * @package @jmruthers/pace-core
+ * @module Hooks
+ * @since 0.1.0
+ *
+ * Provides reactive session restoration state from the AuthService.
+ * Handles timeout detection to prevent infinite loading loops when
+ * Supabase session hydration from localStorage takes too long.
+ */
+
+interface UseSessionRestorationResult extends SessionRestorationState {
+    /** Indicates whether the restoration process exceeded the timeout window */
+    hasTimedOut: boolean;
+    /** Timeout duration in milliseconds */
+    timeoutMs: number;
+}
+declare function useSessionRestoration(): UseSessionRestorationResult;
+
 /**
  * @file Inactivity Warning Modal
  * @package @jmruthers/pace-core
@@ -521,24 +540,87 @@ interface PasswordChangeFormProps {
 }
 declare function PasswordChangeForm({ onSubmit, className }: PasswordChangeFormProps): react_jsx_runtime.JSX.Element;
 
-interface FileUploadProps {
-    supabase: SupabaseClient;
+/**
+ * Storage utility types for pace-core
+ */
+interface StorageUploadOptions {
+    /** The app name from rbac_apps */
     appName: string;
+    /** Organisation ID for scoping */
     orgId: string;
-    onUploadComplete?: (result: {
-        success: boolean;
-        path?: string;
-        error?: string;
-    }) => void;
-    onUploadStart?: () => void;
-    accept?: string;
-    maxSize?: number;
-    multiple?: boolean;
-    disabled?: boolean;
-    className?: string;
-    children?: React__default.ReactNode;
+    /** Whether the file should be publicly accessible */
+    isPublic?: boolean;
+    /** Optional tags for categorisation */
+    tags?: string[];
+    /** Optional custom path within the app/org structure */
+    customPath?: string;
+    /** Optional metadata to store with the file */
+    metadata?: Record<string, any>;
+}
+interface StorageFileMetadata {
+    mimeType: string;
+    size: number;
+    width?: number;
+    height?: number;
+    hash?: string;
+    orgId: string;
+    appName: string;
+    uploadedBy: string;
+    uploadedAt: string;
+    tags?: string[];
+    isPublic: boolean;
+    customMetadata?: Record<string, any>;
+}
+interface StorageUploadResult {
+    success: boolean;
+    path?: string;
+    publicUrl?: string;
+    metadata?: StorageFileMetadata;
+    error?: string;
+}
+interface StorageUrlOptions {
+    /** The app name from rbac_apps */
+    appName: string;
+    /** Organisation ID for scoping */
+    orgId: string;
+    /** Expiry time in seconds for signed URLs (default: 3600) */
+    expiresIn?: number;
+}
+interface StorageListOptions {
+    /** The app name from rbac_apps */
+    appName: string;
+    /** Organisation ID for scoping */
+    orgId: string;
+    /** Optional path prefix to filter by */
+    pathPrefix?: string;
+    /** Optional tags to filter by */
+    tags?: string[];
+    /** Maximum number of files to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+interface StorageFileInfo {
+    name: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    lastModified: string;
+    metadata: StorageFileMetadata;
+}
+interface StorageListResult {
+    files: StorageFileInfo[];
+    totalCount: number;
+    hasMore: boolean;
+}
+interface FileSizeLimits {
+    [mimeType: string]: number;
+}
+interface StorageConfig {
+    bucketName: string;
+    fileSizeLimits: FileSizeLimits;
+    defaultFileSizeLimit: number;
 }
-declare function FileUpload({ supabase, appName, orgId, onUploadComplete, onUploadStart, accept, maxSize, multiple, disabled, className, children }: FileUploadProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Storage configuration for pace-core
@@ -565,6 +647,12 @@ declare const STORAGE_CONFIG: StorageConfig;
  * Get the file size limit for a given MIME type
  */
 declare function getFileSizeLimit(mimeType: string): number;
+/**
+ * Get the bucket name based on whether the file is public or private
+ * @param isPublic - Whether the file should be publicly accessible
+ * @returns The bucket name: 'public-files' for public files, 'files' for private files
+ */
+declare function getBucketName(isPublic: boolean): 'files' | 'public-files';
 /**
  * Validate file size against limits
  */
@@ -595,10 +683,19 @@ declare function extractFileMetadata(file: File, options: StorageUploadOptions,
 declare function uploadFile(supabase: SupabaseClient, file: File, options: StorageUploadOptions): Promise<StorageUploadResult>;
 /**
  * Get a public URL for a file
+ * @param supabase - Supabase client instance
+ * @param path - File path within the bucket
+ * @param isPublic - Whether the file is in the public-files bucket (default: true)
+ * @returns Public URL for the file
  */
-declare function getPublicUrl(supabase: SupabaseClient, path: string): string;
+declare function getPublicUrl(supabase: SupabaseClient, path: string, isPublic?: boolean): string;
 /**
  * Get a signed URL for a protected file
+ * Private files are always in the 'files' bucket, so this always uses 'files' bucket
+ * @param supabase - Supabase client instance
+ * @param path - File path within the bucket
+ * @param options - URL options including expiry time
+ * @returns Signed URL with expiration timestamp, or null if failed
  */
 declare function getSignedUrl(supabase: SupabaseClient, path: string, options: StorageUrlOptions): Promise<{
     url: string;
@@ -606,21 +703,49 @@ declare function getSignedUrl(supabase: SupabaseClient, path: string, options: S
 } | null>;
 /**
  * Delete a file from storage
+ * @param supabase - Supabase client instance
+ * @param path - File path within the bucket
+ * @param isPublic - Whether the file is in the public-files bucket (default: false)
+ * @returns Success status and optional error message
  */
-declare function deleteFile(supabase: SupabaseClient, path: string): Promise<{
+declare function deleteFile(supabase: SupabaseClient, path: string, isPublic?: boolean): Promise<{
     success: boolean;
     error?: string;
 }>;
 /**
  * List files in an organization scope
+ * @param supabase - Supabase client instance
+ * @param options - List options including bucket selection via isPublic
+ * @returns List of files with metadata
  */
-declare function listFiles(supabase: SupabaseClient, options: StorageListOptions): Promise<StorageListResult>;
+declare function listFiles(supabase: SupabaseClient, options: StorageListOptions & {
+    isPublic?: boolean;
+}): Promise<StorageListResult>;
+/**
+ * Download a file from storage
+ * @param supabase - Supabase client instance
+ * @param path - File path within the bucket
+ * @param isPublic - Whether the file is in the public-files bucket (default: false)
+ * @returns File blob with metadata, or null if failed
+ */
+declare function downloadFile(supabase: SupabaseClient, path: string, isPublic?: boolean): Promise<{
+    blob: Blob;
+    metadata: {
+        name: string;
+        size: number;
+        type: string;
+    };
+} | null>;
 /**
  * Move a file to archived location (soft delete)
+ * @param supabase - Supabase client instance
+ * @param path - File path within the bucket
+ * @param options - Archive options including bucket selection via isPublic
  */
 declare function archiveFile(supabase: SupabaseClient, path: string, options: {
     appName: string;
     orgId: string;
+    isPublic?: boolean;
 }): Promise<{
     success: boolean;
     error?: string;
@@ -643,8 +768,9 @@ declare class StorageUtils {
     static getPublicUrl: typeof getPublicUrl;
     static getSignedUrl: typeof getSignedUrl;
     static deleteFile: typeof deleteFile;
+    static downloadFile: typeof downloadFile;
     static listFiles: typeof listFiles;
     static archiveFile: typeof archiveFile;
 }
 
-export { APP_PATH_MAPPING, ColumnFactory, DEFAULT_FILE_SIZE_LIMIT, DataRecord, DataTableAction, FILE_SIZE_LIMITS, FileSizeLimits, FileUpload, type FileUploadProps, InactivityWarningModal, type InactivityWarningModalProps, OrganisationContextType, PasswordChangeForm, STORAGE_CONFIG, StorageConfig, StorageFileMetadata, StorageListOptions, StorageListResult, StorageUploadOptions, StorageUploadResult, StorageUrlOptions, StorageUtils, type UseInactivityTrackerOptions, type UseInactivityTrackerReturn, archiveFile, deleteFile, extractFileMetadata, generateFilePath, generateUniqueFileName, getFileSizeLimit, getPublicUrl, getSignedUrl, listFiles, uploadFile, useAuthService, useEventService, useEvents, useInactivityService, useInactivityTracker, useOrganisationService, useOrganisations, validateFileSize };
+export { APP_PATH_MAPPING, ColumnFactory, DEFAULT_FILE_SIZE_LIMIT, DataRecord, DataTableAction, FILE_SIZE_LIMITS, type FileSizeLimits, InactivityWarningModal, type InactivityWarningModalProps, OrganisationContextType, PasswordChangeForm, STORAGE_CONFIG, type StorageConfig, type StorageFileInfo, type StorageFileMetadata, type StorageListOptions, type StorageListResult, type StorageUploadOptions, type StorageUploadResult, type StorageUrlOptions, StorageUtils, type UseInactivityTrackerOptions, type UseInactivityTrackerReturn, archiveFile, deleteFile, downloadFile, extractFileMetadata, generateFilePath, generateUniqueFileName, getBucketName, getFileSizeLimit, getPublicUrl, getSignedUrl, listFiles, uploadFile, useAuthService, useEventService, useEvents, useInactivityService, useInactivityTracker, useOrganisationService, useOrganisations, useSessionRestoration, validateFileSize };