@jmruthers/pace-core 0.5.86 → 0.5.88

package/dist/rbac/index.js

@@ -30,7 +30,7 @@ import {
   withAccessLevelGuard,
   withPermissionGuard,
   withRoleGuard
-} from "../chunk-NTW3KGS4.js";
+} from "../chunk-6UHXQH7P.js";
 import {
   useAccessLevel,
   useCachedPermissions,
@@ -41,7 +41,7 @@ import {
   usePermissions,
   useRBAC,
   useResolvedScope
-} from "../chunk-YVUZWLQG.js";
+} from "../chunk-AQGF5OG7.js";
 import {
   CACHE_PATTERNS,
   RBACCache,
@@ -71,13 +71,13 @@ import {
   getGlobalAuditManager,
   setGlobalAuditManager
 } from "../chunk-Q7APDV6H.js";
-import "../chunk-S3JKDMD5.js";
-import "../chunk-CBSD3BZ3.js";
-import "../chunk-RIXPZJUB.js";
-import "../chunk-I2VVV5PQ.js";
-import "../chunk-5BN3YGNK.js";
+import "../chunk-CXKMRKRF.js";
+import "../chunk-3RZBKQ5Y.js";
+import "../chunk-KTPG5VCH.js";
+import "../chunk-YY4YYM3E.js";
+import "../chunk-DP5X5ORK.js";
 import "../chunk-JCQZ6LA7.js";
-import "../chunk-CVMVPYAL.js";
+import "../chunk-BDZUMRBD.js";
 import "../chunk-PLDDJCW6.js";
 export {
   ALL_PERMISSIONS,

package/dist/types.d.ts

@@ -3,7 +3,8 @@ export { D as DataRecord, t as DataTableAction, u as DataTableColumn, E as Event
 import { SupabaseClient } from '@supabase/supabase-js';
 export { D as Database } from './database-BXAfr2Y_.js';
 export { C as ChangePasswordFormValues, t as ContactFormData, F as FormData, m as LoginFormData, L as LoginFormValues, P as PasswordResetFormValues, q as ProfileFormData, o as RegistrationFormData, R as RegistrationFormValues, S as SecureLoginFormValues, k as SecurePasswordResetFormValues, j as SecureRegistrationFormValues, U as UserProfileFormValues, V as ValidationError, a as ValidationResult, g as changePasswordSchema, w as combineSchemas, i as contactFormSchema, d as dateSchema, e as emailSchema, l as loginSchema, n as nameSchema, f as passwordResetSchema, b as passwordSchema, p as phoneSchema, v as pickSchema, r as registrationSchema, c as secureLoginSchema, s as securePasswordSchema, u as urlSchema, h as userProfileSchema } from './validation-D8VcbTzC.js';
-export { b as FileCategory, a as FileMetadata, F as FileReference, d as FileReferenceService, c as FileUploadOptions, e as FileUploadResult, S as StorageUploadOptions } from './file-reference-9xUOnwyt.js';
+export { S as SessionRestorationState } from './auth-DReDSLq9.js';
+export { g as BucketInfo, B as BulkUploadResult, b as FileCategory, a as FileMetadata, F as FileReference, d as FileReferenceService, f as FileReferenceWithUrl, c as FileUploadOptions, e as FileUploadResult, h as FileUrlInfo, S as StorageUploadOptions, U as UploadProgress } from './file-reference-C9isKNPn.js';
 import 'zod';
 
 /**

package/dist/types.js

@@ -1,6 +1,3 @@
-import {
-  FileCategory
-} from "./chunk-WUXCWRL6.js";
 import {
   changePasswordSchema,
   combineSchemas,
@@ -19,6 +16,9 @@ import {
   urlSchema,
   userProfileSchema
 } from "./chunk-24MKLB7U.js";
+import {
+  FileCategory
+} from "./chunk-XJ2HZOBU.js";
 import "./chunk-PLDDJCW6.js";
 
 // src/types/unified.ts

package/dist/utils.js

@@ -40,7 +40,7 @@ import {
   init_organisationContext,
   isOrganisationContextAvailable,
   setOrganisationContext
-} from "./chunk-CVMVPYAL.js";
+} from "./chunk-BDZUMRBD.js";
 import "./chunk-PLDDJCW6.js";
 
 // src/utils/debugLogger.ts
@@ -594,7 +594,7 @@ function createLazyComponent(importFn, componentName, options = {}) {
   return WrappedComponent;
 }
 var LazyDataTable = createLazyComponent(
-  () => import("./DataTable-DKGTBLWT.js").then((module) => ({ default: module.DataTable })),
+  () => import("./DataTable-PWBMKMOG.js").then((module) => ({ default: module.DataTable })),
   "DataTable"
 );
 

package/docs/DOCUMENTATION_AUDIT.md

@@ -6,9 +6,9 @@ reviewedBy: content-audit
 
 # 📘 PACE Core Documentation Audit Tracker
 
-> Progressively aligning all docs with the [PACE Core Documentation Style Guide](./STYLE_GUIDE.md)
+> Progressively aligning all docs with the [PACE Core Documentation Standard](./DOCUMENTATION_STANDARD.md)
 
-This file tracks compliance with the PACE Core Documentation Style Guide across all documentation files.
+This file tracks compliance with the PACE Core Documentation Standard across all documentation files.
 
 ---
 
@@ -26,7 +26,7 @@ All Markdown (`.md`) files within:
 | File | Status | Writing Principles | Structure | Formatting | Accessibility | Notes |
 |------|---------|-------------------|-----------|------------|---------------|--------|
 | README.md | ✅ Compliant | ✅ Clear, active voice | ✅ Proper H2/H3 hierarchy | ✅ Good formatting | ✅ Descriptive links | Main entry point |
-| STYLE_GUIDE.md | ✅ Compliant | ✅ Clear, active voice | ✅ Proper hierarchy | ✅ Consistent formatting | ✅ Good accessibility | Official standard |
+| DOCUMENTATION_STANDARD.md | ✅ Compliant | ✅ Clear, active voice | ✅ Proper hierarchy | ✅ Consistent formatting | ✅ Good accessibility | Official standard |
 | DOCUMENTATION_AUDIT.md | ✅ Compliant | ✅ Clear, active voice | ✅ Proper hierarchy | ✅ Good formatting | ✅ Descriptive links | This file |
 
 ### Getting Started Guides
@@ -134,7 +134,7 @@ All Markdown (`.md`) files within:
 ## 🎯 Key Findings
 
 ### ✅ **Strengths**
-1. **Excellent Structure**: All files follow the style guide structure perfectly
+1. **Excellent Structure**: All files follow the documentation standard structure perfectly
 2. **Complete Examples**: All code examples are runnable and include proper imports
 3. **Clear Navigation**: Consistent breadcrumb navigation across all files
 4. **Active Voice**: Consistent use of active voice throughout
@@ -153,7 +153,7 @@ All Markdown (`.md`) files within:
 ## 🚀 Recommendations
 
 ### ✅ **Maintain Current Standards**
-1. **Continue quarterly reviews** as specified in style guide
+1. **Continue quarterly reviews** as specified in documentation standard
 2. **Verify links monthly** to prevent broken references
 3. **Update examples** when new features are released
 4. **Peer review** all new documentation before publishing
@@ -163,7 +163,7 @@ All Markdown (`.md`) files within:
 - ✅ **Runnable examples**: 100%
 - ✅ **Broken links**: 0
 - ✅ **Terminology consistency**: 100%
-- ✅ **Style guide compliance**: 100%
+- ✅ **Documentation standard compliance**: 100%
 
 ---
 

package/docs/DOCUMENTATION_STANDARD.md

@@ -0,0 +1,137 @@
+# Documentation Standard
+
+Use this guide to ensure consistent, high-quality documentation across the pace-core project. Every documentation contribution should follow these standards.
+
+## Voice & Tone
+
+- [ ] **Write clearly and directly**: Use active voice and present tense where possible
+- [ ] **Know your audience**: Assume readers are React developers comfortable with TypeScript
+- [ ] **Lead with purpose**: Explain *why* a step matters before diving into *how* to do it
+- [ ] **Be inclusive**: Use "you" instead of "we" when addressing the reader
+- [ ] **Stay professional but approachable**: Avoid jargon without explanation, but don't oversimplify
+
+## Content Structure
+
+### Page Organization
+- [ ] **Single H1**: Use `#` for the page title once per file, then start sections at `##`
+- [ ] **Logical hierarchy**: Don't skip heading levels (no jumping from `##` to `####`)
+- [ ] **Consistent sections**: Include these sections where relevant:
+  - Overview/Introduction
+  - Prerequisites
+  - Quick Start/Getting Started
+  - Detailed Usage
+  - Examples
+  - API Reference
+  - Troubleshooting
+  - Next Steps/Related Links
+
+### Content Flow
+- [ ] **Context first**: Open with goal, prerequisites, or summary before diving into implementation
+- [ ] **Progressive disclosure**: Start simple, then add complexity
+- [ ] **Clear endings**: End with next steps, validation checks, or related links
+- [ ] **Logical grouping**: Place new pages in directories that match their topic (e.g., RBAC docs in `docs/rbac/`)
+
+## Code & Examples
+
+### Code Blocks
+- [ ] **Use fenced code blocks** with appropriate language tags (`ts`, `tsx`, `bash`, `json`, `sql`)
+- [ ] **Include complete examples**: Add all necessary imports so code can be copied directly
+- [ ] **Show realistic usage**: Use meaningful variable names and realistic data
+- [ ] **Highlight key parts**: Use comments to explain important sections
+
+### Code Quality
+- [ ] **Follow project conventions**: Match the codebase's TypeScript and React patterns
+- [ ] **Test your examples**: Ensure all code samples actually work
+- [ ] **Keep examples focused**: Show one concept at a time unless demonstrating integration
+
+## Formatting Standards
+
+### Lists & Tables
+- [ ] **Parallel structure**: Keep bullet points grammatically consistent
+- [ ] **Reasonable length**: Limit lists to 7 items; use tables for structured data
+- [ ] **Proper nesting**: Use consistent indentation for nested lists
+- [ ] **Table headers**: Always include headers for tables with meaningful column names
+
+### Links & References
+- [ ] **Relative paths**: Link to other docs using relative paths (e.g., `../rbac/quick-start.md`)
+- [ ] **Descriptive text**: Use meaningful link text, not "click here" or raw URLs
+- [ ] **External links**: Open external links in new tabs when appropriate
+- [ ] **API references**: Link to relevant API documentation and source code
+
+### Visual Elements
+- [ ] **Screenshots**: Include when they add value, especially for UI components
+- [ ] **Alt text**: Provide descriptive alt text for all images
+- [ ] **Consistent styling**: Use the same formatting for similar elements across docs
+
+## Terminology & Language
+
+### Project-Specific Terms
+- [ ] **Use "organisation"** (Australian spelling) consistently throughout
+- [ ] **Capitalize properly**: "pace-core" (lowercase), "Supabase" (proper case)
+- [ ] **Define acronyms**: Spell out abbreviations on first use (e.g., "Role-Based Access Control (RBAC)")
+
+### Technical Writing
+- [ ] **Be specific**: Use precise technical terms rather than vague language
+- [ ] **Explain assumptions**: Don't assume knowledge of internal implementation details
+- [ ] **Use consistent naming**: Stick to the same terms for the same concepts throughout
+
+## Quality Assurance
+
+### Pre-Publication Checks
+- [ ] **Spell check**: Run automated spell check and manual review
+- [ ] **Grammar check**: Read aloud or use grammar tools to catch awkward phrasing
+- [ ] **Link validation**: Verify all internal and external links work
+- [ ] **Code testing**: Run and test all code examples
+
+### Technical Accuracy
+- [ ] **API alignment**: Check referenced APIs against current implementation in `packages/core/src/`
+- [ ] **Command verification**: Test all CLI commands and scripts in a clean environment
+- [ ] **Version compatibility**: Ensure examples work with current dependency versions
+
+### Maintenance
+- [ ] **Index updates**: Update [documentation-index.md](./documentation-index.md) for new, moved, or removed pages
+- [ ] **Gap tracking**: Note follow-up work in the "Known gaps" section of [README.md](./README.md)
+- [ ] **Regular review**: Schedule periodic reviews to keep content current
+
+## Accessibility & Inclusion
+
+- [ ] **Screen reader friendly**: Use proper heading hierarchy and alt text
+- [ ] **Color independence**: Don't rely solely on color to convey information
+- [ ] **Clear language**: Write for non-native English speakers when possible
+- [ ] **Multiple learning styles**: Include both conceptual explanations and practical examples
+
+## Review Process
+
+### Self-Review Checklist
+- [ ] **Content accuracy**: Verify all technical details are correct
+- [ ] **Completeness**: Ensure the document achieves its stated purpose
+- [ ] **Clarity**: Check that a new team member could follow the instructions
+- [ ] **Consistency**: Confirm formatting and terminology align with other docs
+
+### Peer Review
+- [ ] **Fresh eyes**: Have someone unfamiliar with the topic review for clarity
+- [ ] **Technical review**: Get approval from subject matter experts
+- [ ] **Editorial review**: Check for grammar, style, and formatting consistency
+
+## Documentation Types
+
+### Quick Reference
+For API docs, component props, and CLI commands:
+- [ ] **Tabular format**: Use tables for parameter lists and return values
+- [ ] **Required vs optional**: Clearly mark required parameters
+- [ ] **Default values**: Include default values where applicable
+- [ ] **Type information**: Show TypeScript types for all parameters
+
+### Tutorials
+For step-by-step guides:
+- [ ] **Clear objectives**: State what the reader will accomplish
+- [ ] **Prerequisites**: List required knowledge and setup
+- [ ] **Numbered steps**: Use ordered lists for sequential processes
+- [ ] **Validation points**: Include checkpoints to verify progress
+
+### Conceptual Guides
+For explaining how things work:
+- [ ] **Big picture first**: Start with high-level concepts
+- [ ] **Visual aids**: Use diagrams or flowcharts where helpful
+- [ ] **Real-world context**: Explain when and why to use features
+- [ ] **Common patterns**: Show typical usage scenarios

package/docs/README.md

@@ -168,4 +168,4 @@ Track outstanding items in the docs backlog so the index remains trustworthy.
 
 - Keep navigation links in sync with the directory structure—update [`documentation-index.md`](./documentation-index.md) whenever a new page lands.
 - Prefer task-based guides that start with runnable code and finish with validation steps.
-- Use the [Documentation style checklist](./STYLE_GUIDE.md) before publishing to guarantee tone, formatting, and linking conventions stay consistent.
+- Use the [Documentation Standard](./DOCUMENTATION_STANDARD.md) before publishing to guarantee tone, formatting, and linking conventions stay consistent.

package/docs/api/classes/ColumnFactory.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / ColumnFactory
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / ColumnFactory
 
 # Class: ColumnFactory\<TData\>
 

package/docs/api/classes/ErrorBoundary.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / ErrorBoundary
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / ErrorBoundary
 
 # Class: ErrorBoundary
 

package/docs/api/classes/InvalidScopeError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / InvalidScopeError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / InvalidScopeError
 
 # Class: InvalidScopeError
 

package/docs/api/classes/MissingUserContextError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / MissingUserContextError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / MissingUserContextError
 
 # Class: MissingUserContextError
 

package/docs/api/classes/OrganisationContextRequiredError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / OrganisationContextRequiredError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / OrganisationContextRequiredError
 
 # Class: OrganisationContextRequiredError
 

package/docs/api/classes/PermissionDeniedError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / PermissionDeniedError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / PermissionDeniedError
 
 # Class: PermissionDeniedError
 

package/docs/api/classes/PublicErrorBoundary.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / PublicErrorBoundary
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / PublicErrorBoundary
 
 # Class: PublicErrorBoundary
 

package/docs/api/classes/RBACAuditManager.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / RBACAuditManager
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / RBACAuditManager
 
 # Class: RBACAuditManager
 

package/docs/api/classes/RBACCache.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / RBACCache
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / RBACCache
 
 # Class: RBACCache
 

package/docs/api/classes/RBACEngine.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / RBACEngine
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / RBACEngine
 
 # Class: RBACEngine
 

package/docs/api/classes/RBACError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / RBACError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / RBACError
 
 # Class: RBACError
 

package/docs/api/classes/RBACNotInitializedError.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / RBACNotInitializedError
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / RBACNotInitializedError
 
 # Class: RBACNotInitializedError
 

package/docs/api/classes/SecureSupabaseClient.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / SecureSupabaseClient
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / SecureSupabaseClient
 
 # Class: SecureSupabaseClient
 

package/docs/api/classes/StorageUtils.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.86](../README.md) / [Exports](../modules.md) / StorageUtils
+[@jmruthers/pace-core - v0.5.88](../README.md) / [Exports](../modules.md) / StorageUtils
 
 # Class: StorageUtils
 
@@ -19,6 +19,7 @@ StorageUtils class for convenient access to storage functions
 - [getPublicUrl](StorageUtils.md#getpublicurl)
 - [getSignedUrl](StorageUtils.md#getsignedurl)
 - [deleteFile](StorageUtils.md#deletefile)
+- [downloadFile](StorageUtils.md#downloadfile)
 - [listFiles](StorageUtils.md#listfiles)
 - [archiveFile](StorageUtils.md#archivefile)
 
@@ -57,7 +58,7 @@ Generate a file path based on organization-first structure
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L55)
+[packages/core/src/utils/storage/index.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L57)
 
 ___
 
@@ -83,7 +84,7 @@ Generate a unique filename with timestamp and UUID
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L56)
+[packages/core/src/utils/storage/index.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L58)
 
 ___
 
@@ -111,7 +112,7 @@ Extract file metadata from a File object
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L57)
+[packages/core/src/utils/storage/index.ts:59](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L59)
 
 ___
 
@@ -139,34 +140,37 @@ Upload a file to Supabase storage with app segregation
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L58)
+[packages/core/src/utils/storage/index.ts:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L60)
 
 ___
 
 ### getPublicUrl
 
-▪ `Static` **getPublicUrl**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`) => `string` = `getPublicUrl`
+▪ `Static` **getPublicUrl**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`, `isPublic`: `boolean`) => `string` = `getPublicUrl`
 
 #### Type declaration
 
-▸ (`supabase`, `path`): `string`
+▸ (`supabase`, `path`, `isPublic?`): `string`
 
 Get a public URL for a file
 
 ##### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
+| `path` | `string` | `undefined` | File path within the bucket |
+| `isPublic` | `boolean` | `true` | Whether the file is in the public-files bucket (default: true) |
 
 ##### Returns
 
 `string`
 
+Public URL for the file
+
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:59](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L59)
+[packages/core/src/utils/storage/index.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L61)
 
 ___
 
@@ -179,55 +183,91 @@ ___
 ▸ (`supabase`, `path`, `options`): `Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
 
 Get a signed URL for a protected file
+Private files are always in the 'files' bucket, so this always uses 'files' bucket
 
 ##### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-| `options` | [`StorageUrlOptions`](../interfaces/StorageUrlOptions.md) |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | Supabase client instance |
+| `path` | `string` | File path within the bucket |
+| `options` | [`StorageUrlOptions`](../interfaces/StorageUrlOptions.md) | URL options including expiry time |
 
 ##### Returns
 
 `Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
 
+Signed URL with expiration timestamp, or null if failed
+
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L60)
+[packages/core/src/utils/storage/index.ts:62](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L62)
 
 ___
 
 ### deleteFile
 
-▪ `Static` **deleteFile**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`) => `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\> = `deleteFile`
+▪ `Static` **deleteFile**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`, `isPublic`: `boolean`) => `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\> = `deleteFile`
 
 #### Type declaration
 
-▸ (`supabase`, `path`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
+▸ (`supabase`, `path`, `isPublic?`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
 
 Delete a file from storage
 
 ##### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
+| `path` | `string` | `undefined` | File path within the bucket |
+| `isPublic` | `boolean` | `false` | Whether the file is in the public-files bucket (default: false) |
 
 ##### Returns
 
 `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
 
+Success status and optional error message
+
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L61)
+[packages/core/src/utils/storage/index.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L63)
+
+___
+
+### downloadFile
+
+▪ `Static` **downloadFile**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`, `isPublic`: `boolean`) => `Promise`\<\{ `blob`: `Blob` ; `metadata`: \{ `name`: `string` ; `size`: `number` ; `type`: `string`  }  } \| ``null``\> = `downloadFile`
+
+#### Type declaration
+
+▸ (`supabase`, `path`, `isPublic?`): `Promise`\<\{ `blob`: `Blob` ; `metadata`: \{ `name`: `string` ; `size`: `number` ; `type`: `string`  }  } \| ``null``\>
+
+Download a file from storage
+
+##### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
+| `path` | `string` | `undefined` | File path within the bucket |
+| `isPublic` | `boolean` | `false` | Whether the file is in the public-files bucket (default: false) |
+
+##### Returns
+
+`Promise`\<\{ `blob`: `Blob` ; `metadata`: \{ `name`: `string` ; `size`: `number` ; `type`: `string`  }  } \| ``null``\>
+
+File blob with metadata, or null if failed
+
+#### Defined in
+
+[packages/core/src/utils/storage/index.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L64)
 
 ___
 
 ### listFiles
 
-▪ `Static` **listFiles**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `options`: [`StorageListOptions`](../interfaces/StorageListOptions.md)) => `Promise`\<[`StorageListResult`](../interfaces/StorageListResult.md)\> = `listFiles`
+▪ `Static` **listFiles**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `options`: [`StorageListOptions`](../interfaces/StorageListOptions.md) & \{ `isPublic?`: `boolean`  }) => `Promise`\<[`StorageListResult`](../interfaces/StorageListResult.md)\> = `listFiles`
 
 #### Type declaration
 
@@ -237,24 +277,26 @@ List files in an organization scope
 
 ##### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `options` | [`StorageListOptions`](../interfaces/StorageListOptions.md) |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | Supabase client instance |
+| `options` | [`StorageListOptions`](../interfaces/StorageListOptions.md) & \{ `isPublic?`: `boolean`  } | List options including bucket selection via isPublic |
 
 ##### Returns
 
 `Promise`\<[`StorageListResult`](../interfaces/StorageListResult.md)\>
 
+List of files with metadata
+
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:62](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L62)
+[packages/core/src/utils/storage/index.ts:65](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L65)
 
 ___
 
 ### archiveFile
 
-▪ `Static` **archiveFile**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`, `options`: \{ `appName`: `string` ; `orgId`: `string`  }) => `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\> = `archiveFile`
+▪ `Static` **archiveFile**: (`supabase`: `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\>, `path`: `string`, `options`: \{ `appName`: `string` ; `orgId`: `string` ; `isPublic?`: `boolean`  }) => `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\> = `archiveFile`
 
 #### Type declaration
 
@@ -264,13 +306,14 @@ Move a file to archived location (soft delete)
 
 ##### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
-| `path` | `string` |
-| `options` | `Object` |
-| `options.appName` | `string` |
-| `options.orgId` | `string` |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | Supabase client instance |
+| `path` | `string` | File path within the bucket |
+| `options` | `Object` | Archive options including bucket selection via isPublic |
+| `options.appName` | `string` | - |
+| `options.orgId` | `string` | - |
+| `options.isPublic?` | `boolean` | - |
 
 ##### Returns
 
@@ -278,4 +321,4 @@ Move a file to archived location (soft delete)
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L63)
+[packages/core/src/utils/storage/index.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L66)