@donotdev/core 0.0.11 → 0.0.13

package/server.d.ts

@@ -2,6 +2,8 @@ import * as React from 'react';
 import { ReactNode, ComponentType } from 'react';
 export { ReactNode } from 'react';
 import * as v from 'valibot';
+export * from '@donotdev/schemas/server';
+export { global } from '@donotdev/schemas/server';
 
 // Types
 
@@ -2953,6 +2955,7 @@ declare const USER_ROLES: {
     readonly GUEST: "guest";
     readonly USER: "user";
     readonly ADMIN: "admin";
+    readonly SUPER: "super";
 };
 /**
  * Override user roles for custom app needs
@@ -4357,7 +4360,7 @@ type PageAuth = boolean | {
  * // Framework provides: auth=false, title from home.title, entity=home
  * ```
  *
- * @example Dynamic route (just define the path you want):
+ * @example Dynamic route (string format - explicit path):
  * ```tsx
  * export const meta: PageMeta = {
  *   route: '/blog/:slug'  // Creates /blog/:slug
@@ -4365,6 +4368,14 @@ type PageAuth = boolean | {
  * // Framework provides: auth=false, title from blog.title, entity=blog
  * ```
  *
+ * @example Dynamic route (object format - auto-generates base path):
+ * ```tsx
+ * export const meta: PageMeta = {
+ *   route: { params: ['id'] }  // Creates /myRoute/:id (base path from file location)
+ * };
+ * // For file at pages/myRoute/DetailPage.tsx → route becomes /myRoute/:id
+ * ```
+ *
  * @example Auth-required (developer must be explicit):
  * ```tsx
  * export const meta: PageMeta = {
@@ -5609,6 +5620,12 @@ interface BillingAPI {
      */
     status: FeatureStatus;
     error: string | null;
+    /**
+     * Whether a billing operation is in progress.
+     * For redirect operations (checkout, portal), the hook automatically shows
+     * a fullscreen overlay with operation-specific messaging.
+     */
+    loading: boolean;
     checkout: (options: CheckoutOptions) => Promise<StripeCheckoutResponse>;
     cancelSubscription: () => Promise<{
         success: boolean;
@@ -6495,6 +6512,133 @@ interface CanAPI {
     has: (permission: string) => boolean;
 }
 
+/**
+ * @fileoverview Aggregation Types
+ * @description Types for generic entity aggregation/analytics functions
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+/** Supported aggregation operations */
+type AggregateOperation = 'count' | 'sum' | 'avg' | 'min' | 'max';
+/** Filter operators for aggregation */
+type AggregateFilterOperator = '==' | '!=' | '>' | '<' | '>=' | '<=';
+/**
+ * Single metric definition for aggregation
+ *
+ * @example
+ * ```typescript
+ * // Count all documents
+ * { field: '*', operation: 'count', as: 'total' }
+ *
+ * // Sum a numeric field
+ * { field: 'price', operation: 'sum', as: 'totalValue' }
+ *
+ * // Count with filter
+ * {
+ *   field: '*',
+ *   operation: 'count',
+ *   as: 'availableCount',
+ *   filter: { field: 'status', operator: '==', value: 'available' }
+ * }
+ * ```
+ */
+interface MetricDefinition {
+    /** Field to aggregate ('*' for count all) */
+    field: string;
+    /** Aggregation operation */
+    operation: AggregateOperation;
+    /** Output name for this metric */
+    as: string;
+    /** Optional filter for this metric */
+    filter?: {
+        field: string;
+        operator: AggregateFilterOperator;
+        value: any;
+    };
+}
+/**
+ * Group by definition for aggregation
+ *
+ * @example
+ * ```typescript
+ * {
+ *   field: 'status',
+ *   metrics: [
+ *     { field: '*', operation: 'count', as: 'count' },
+ *     { field: 'price', operation: 'sum', as: 'value' },
+ *   ]
+ * }
+ * ```
+ */
+interface GroupByDefinition {
+    /** Field to group by */
+    field: string;
+    /** Metrics to compute per group */
+    metrics: MetricDefinition[];
+}
+/**
+ * Aggregation configuration for entity analytics
+ *
+ * @example
+ * ```typescript
+ * const carsAnalyticsConfig: AggregateConfig = {
+ *   metrics: [
+ *     { field: '*', operation: 'count', as: 'total' },
+ *     { field: 'price', operation: 'sum', as: 'totalValue' },
+ *     { field: 'price', operation: 'avg', as: 'avgPrice' },
+ *   ],
+ *   groupBy: [
+ *     {
+ *       field: 'status',
+ *       metrics: [
+ *         { field: '*', operation: 'count', as: 'count' },
+ *         { field: 'price', operation: 'sum', as: 'value' },
+ *       ],
+ *     },
+ *   ],
+ *   where: [['isActive', '==', true]],
+ * };
+ * ```
+ */
+interface AggregateConfig {
+    /** Top-level metrics (computed on entire collection) */
+    metrics?: MetricDefinition[];
+    /** Group by configurations */
+    groupBy?: GroupByDefinition[];
+    /** Optional global filters */
+    where?: Array<[string, any, any]>;
+}
+/**
+ * Request payload for aggregate function calls
+ */
+interface AggregateRequest {
+    /** Optional runtime filters (merged with config filters) */
+    where?: Array<[string, any, any]>;
+    /** Optional date range filter */
+    dateRange?: {
+        field: string;
+        start?: string;
+        end?: string;
+    };
+}
+/**
+ * Response from aggregate function
+ */
+interface AggregateResponse {
+    /** Computed top-level metrics */
+    metrics: Record<string, number | null>;
+    /** Grouped metrics by field */
+    groups: Record<string, Record<string, Record<string, number | null>>>;
+    /** Metadata about the aggregation */
+    meta: {
+        collection: string;
+        totalDocs: number;
+        computedAt: string;
+    };
+}
+
 /**
  * @fileoverview CRUD Constants
  * @description Constants for CRUD domain. Defines visibility levels for entity fields and supported field types for entities.
@@ -6505,11 +6649,33 @@ interface CanAPI {
  */
 /**
  * Visibility levels for entity fields (runtime constants)
+ * Controls who can SEE this field in responses
+ * - guest: Everyone (even unauthenticated)
+ * - user: Authenticated users (users see both guest and user fields)
+ * - admin: Admins only
+ * - technical: Internal/system fields (shown as read-only in edit forms)
+ * - hidden: Never shown in UI, only exists in DB (passwords, tokens, API keys)
  */
 declare const VISIBILITY: {
+    readonly GUEST: "guest";
     readonly USER: "user";
     readonly ADMIN: "admin";
     readonly TECHNICAL: "technical";
+    readonly HIDDEN: "hidden";
+};
+/**
+ * Editable levels for entity fields (runtime constants)
+ * Controls who can MODIFY this field
+ * - true: Anyone who can see the field
+ * - false: Nobody (read-only)
+ * - 'admin': Only admins
+ * - 'create-only': Editable on create, read-only after
+ */
+declare const EDITABLE: {
+    readonly TRUE: true;
+    readonly FALSE: false;
+    readonly ADMIN: "admin";
+    readonly CREATE_ONLY: "create-only";
 };
 /**
  * Supported field types for entities (runtime constants)
@@ -6519,7 +6685,7 @@ declare const VISIBILITY: {
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-declare const FIELD_TYPES: readonly ["address", "array", "avatar", "badge", "boolean", "checkbox", "color", "date", "datetime-local", "email", "file", "geopoint", "hidden", "image", "map", "month", "multiselect", "number", "password", "radio", "reference", "range", "reset", "select", "submit", "tel", "text", "textarea", "time", "timestamp", "url", "week"];
+declare const FIELD_TYPES: readonly ["address", "array", "avatar", "badge", "boolean", "checkbox", "color", "combobox", "date", "datetime-local", "email", "file", "geopoint", "hidden", "image", "images", "map", "month", "multiselect", "number", "password", "radio", "reference", "range", "reset", "select", "submit", "switch", "tel", "text", "textarea", "time", "timestamp", "toggle", "url", "week"];
 
 /**
  * @fileoverview Schema-Related Type Definitions
@@ -6540,13 +6706,31 @@ declare const FIELD_TYPES: readonly ["address", "array", "avatar", "badge", "boo
 declare const FIRESTORE_ID_PATTERN: RegExp;
 /**
  * Visibility level for entity fields
- * Controls who can see and edit a field
+ * Controls who can SEE a field
+ * - 'guest': Everyone (even unauthenticated)
+ * - 'user': Authenticated users only (users see both guest and user fields)
+ * - 'admin': Admins only
+ * - 'technical': Internal/system fields (shown as read-only in edit forms)
+ * - 'hidden': Never shown in UI, only exists in DB (passwords, tokens, API keys)
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
 type Visibility = (typeof VISIBILITY)[keyof typeof VISIBILITY];
+/**
+ * Editable level for entity fields
+ * Controls who can MODIFY a field
+ * - true: Anyone who can see the field
+ * - false: Nobody (read-only)
+ * - 'admin': Only admins can edit
+ * - 'create-only': Editable on create, read-only after
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type Editable = (typeof EDITABLE)[keyof typeof EDITABLE];
 /**
  * Supported field types for entities
  * These determine the UI components and validation rules used for each field
@@ -6556,6 +6740,14 @@ type Visibility = (typeof VISIBILITY)[keyof typeof VISIBILITY];
  * @author AMBROISE PARK Consulting
  */
 type FieldType = (typeof FIELD_TYPES)[number];
+/**
+ * Picture type for image fields
+ * Represents uploaded image with full and thumbnail URLs
+ */
+interface Picture {
+    fullUrl: string;
+    thumbUrl: string;
+}
 /**
  * Maps field types to their corresponding TypeScript types
  * Used for type-safe form handling
@@ -6576,6 +6768,7 @@ type FieldTypeToValue = {
     badge: string;
     boolean: boolean;
     checkbox: boolean;
+    combobox: string;
     color: string;
     date: string;
     'datetime-local': string;
@@ -6586,7 +6779,8 @@ type FieldTypeToValue = {
         lng: number;
     };
     hidden: string;
-    image: File | null;
+    image: Picture | null;
+    images: Picture[];
     map: Record<string, any>;
     month: string;
     multiselect: string[];
@@ -6603,6 +6797,8 @@ type FieldTypeToValue = {
     textarea: string;
     time: string;
     timestamp: string;
+    toggle: boolean;
+    switch: string | boolean;
     url: string;
     week: string;
 };
@@ -6619,6 +6815,32 @@ type ValueTypeForField<T extends FieldType> = FieldTypeToValue[T];
  * Enhanced validation rules with type checking
  * @template T - The field type
  *
+ * @example
+ * ```typescript
+ * // Select field with dropdown options
+ * validation: {
+ *   required: true,
+ *   options: [
+ *     { value: 'active', label: 'Active' },
+ *     { value: 'inactive', label: 'Inactive' }
+ *   ]
+ * }
+ *
+ * // Text field with length validation
+ * validation: {
+ *   required: true,
+ *   minLength: 3,
+ *   maxLength: 100
+ * }
+ *
+ * // Number field with range validation
+ * validation: {
+ *   required: true,
+ *   min: 0,
+ *   max: 1000
+ * }
+ * ```
+ *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
@@ -6636,11 +6858,48 @@ interface ValidationRules<T extends FieldType = FieldType> {
     maxLength?: T extends 'text' | 'textarea' | 'password' | 'email' | 'url' | 'tel' ? number : never;
     /** Regex pattern (for text fields) */
     pattern?: T extends 'text' | 'textarea' | 'password' | 'email' | 'url' | 'tel' ? string : never;
-    /** Options for select, multiselect, and radio fields */
-    options?: T extends 'select' | 'multiselect' | 'radio' ? Array<{
+    /**
+     * Options for select, multiselect, and radio fields.
+     * Can be:
+     * - An array of option objects
+     * - A function that returns an array (receives form values for dynamic options)
+     * - A range object for numeric sequences (e.g., years)
+     *
+     * @example
+     * ```typescript
+     * // Static array
+     * options: [
+     *   { value: 'active', label: 'Active' },
+     *   { value: 'inactive', label: 'Inactive' }
+     * ]
+     *
+     * // Dynamic function
+     * options: (formValues) => {
+     *   return getModelsForMake(formValues.make);
+     * }
+     *
+     * // Range for years (most common use case)
+     * options: { type: 'range', start: 1995, end: 2024, step: 1, reverse: true }
+     * ```
+     */
+    options?: T extends 'select' | 'multiselect' | 'radio' | 'combobox' ? Array<{
+        value: string;
+        label: string;
+    }> | ((formValues?: Record<string, any>) => Array<{
         value: string;
         label: string;
-    }> : never;
+    }>) | {
+        /** Range type - generates numeric sequence */
+        type: 'range';
+        /** Start value (inclusive) */
+        start: number;
+        /** End value (inclusive) */
+        end: number;
+        /** Step increment (default: 1) */
+        step?: number;
+        /** Reverse order (default: false) - true for years (newest first) */
+        reverse?: boolean;
+    } : never;
     /** Collection name for reference fields */
     reference?: T extends 'reference' ? string : never;
     /** Whether the field is nullable */
@@ -6756,20 +7015,59 @@ interface FormConfig {
 }
 /**
  * Definition of a single entity field
+ * @template T - The field type for type-safe validation and value inference
  *
- * @version 0.0.1
+ * @example
+ * ```typescript
+ * // Text field - TypeScript knows value is string
+ * name: {
+ *   type: 'text',
+ *   visibility: 'user',
+ *   validation: { required: true, minLength: 3 }
+ * }
+ *
+ * // Select field with dropdown options
+ * status: {
+ *   type: 'select',
+ *   visibility: 'user',
+ *   validation: {
+ *     required: true,
+ *     options: [
+ *       { value: 'active', label: 'Active' },
+ *       { value: 'inactive', label: 'Inactive' }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * **Note:** For `select`, `multiselect`, and `radio` fields, dropdown options must be defined in `validation.options` as an array of `{ value: string, label: string }` objects.
+ *
+ * @version 0.0.2
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-interface EntityField {
+interface EntityField<T extends FieldType = FieldType> {
     /** The field type, which determines the UI component and validation */
-    type: FieldType;
-    /** Who can see and edit this field */
+    type: T;
+    /**
+     * Who can SEE this field
+     * - 'guest': Everyone (even unauthenticated)
+     * - 'user': Authenticated users only (users see both guest and user fields)
+     * - 'admin': Admins only
+     * - 'technical': Internal/system fields (shown as read-only in edit forms)
+     * - 'hidden': Never shown in UI, only exists in DB (passwords, tokens, API keys)
+     */
     visibility: Visibility;
-    /** Validation rules for this field */
-    validation?: ValidationRules;
-    /** Whether the field should be hidden in the UI */
-    hidden?: boolean;
+    /**
+     * Who can MODIFY this field
+     * - true: Anyone who can see the field (default)
+     * - false: Nobody (read-only display)
+     * - 'admin': Only admins can edit
+     * - 'create-only': Editable on create, read-only after
+     */
+    editable?: Editable;
+    /** Validation rules for this field. For select/multiselect/radio fields, include `options` array here. */
+    validation?: ValidationRules<T>;
     /** Whether the field is internationalized */
     i18n?: boolean;
     /** Display label for the field */
@@ -6781,9 +7079,9 @@ interface EntityField {
         /** Field name this field depends on */
         field: string;
         /** Value that should trigger this field to show */
-        value?: any;
+        value?: ValueTypeForField<FieldType>;
         /** Custom condition function */
-        condition?: (formData: any) => boolean;
+        condition?: (formData: Record<string, unknown>) => boolean;
     };
     /** Field grouping for layout */
     group?: {
@@ -6798,25 +7096,42 @@ interface EntityField {
         /** Whether group is collapsed by default */
         collapsed?: boolean;
     };
+    /** UI options for field rendering */
+    options?: {
+        /** Placeholder text */
+        placeholder?: string;
+        /** CSS class name */
+        className?: string;
+        /** Field-specific options (e.g., creatable for combobox) */
+        fieldSpecific?: Record<string, unknown>;
+    };
 }
 /**
  * Base fields that all entities should have
  *
- * @version 0.0.1
+ * @version 0.0.3
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
 interface BaseEntityFields {
     /** Unique identifier for the entity */
-    id: EntityField;
+    id: EntityField<'text'>;
     /** When the entity was created */
-    createdAt: EntityField;
+    createdAt: EntityField<'timestamp'>;
     /** When the entity was last updated */
-    updatedAt: EntityField;
+    updatedAt: EntityField<'timestamp'>;
     /** Who created the entity */
-    createdById: EntityField;
+    createdById: EntityField<'reference'>;
     /** Who last updated the entity */
-    updatedById: EntityField;
+    updatedById: EntityField<'reference'>;
+    /**
+     * Publication status for draft/publish/delete workflow
+     * - 'draft': Document is incomplete, hidden from non-admin
+     * - 'available': Document is published and visible (default)
+     * - 'deleted': Soft-deleted, hidden from non-admin
+     * - Consumer can extend with additional statuses (e.g., 'reserved', 'sold')
+     */
+    status: EntityField<'select'>;
 }
 /**
  * Definition of a business entity without base fields
@@ -7088,23 +7403,37 @@ interface ListEntitiesResponse {
 interface CrudAPI<T = unknown> {
     /**
      * Unified feature status - single source of truth for CRUD state.
-     * Replaces deprecated `loading` boolean flag.
      * - `initializing`: CRUD is loading/initializing
      * - `ready`: CRUD fully operational
      * - `degraded`: CRUD unavailable (feature not installed/consent not given)
      * - `error`: CRUD encountered error
      */
     status: FeatureStatus;
+    /** Current data (from get/subscribe) */
     data: T | null;
+    /** Loading state for async operations */
+    loading: boolean;
+    /** Last error encountered */
     error: Error | null;
+    /** Fetch single document by ID */
     get: (id: string) => Promise<T | null>;
+    /** Set/replace document by ID */
     set: (id: string, data: T) => Promise<void>;
+    /** Partial update document by ID */
     update: (id: string, data: Partial<T>) => Promise<void>;
+    /** Delete document by ID */
     delete: (id: string) => Promise<void>;
+    /** Add new document (auto-generated ID) */
     add: (data: T) => Promise<string>;
+    /** Query collection with filters */
     query: (options: any) => Promise<T[]>;
+    /** Subscribe to document changes */
     subscribe: (id: string, callback: (data: T | null, error?: Error) => void) => () => void;
+    /** Subscribe to collection changes */
     subscribeToCollection: (options: any, callback: (data: T[], error?: Error) => void) => () => void;
+    /** Invalidate cache for this collection (TanStack Query) */
+    invalidate: () => Promise<void>;
+    /** Whether CRUD is available and operational */
     isAvailable: boolean;
 }
 
@@ -8853,6 +9182,10 @@ interface UIFieldOptions<T extends FieldType = FieldType> {
         defaultCountry?: string;
         /** Whether to show country flags */
         showFlags?: boolean;
+        /** Preferred country codes to show at the top of the list (e.g., ['FR', 'US', 'GB']) */
+        preferredCountries?: string[];
+        /** Custom list of country codes to show (if provided, only these countries are shown) */
+        countries?: string[];
     } : T extends 'address' ? {
         /**
          * Whether to enable Google Maps autocomplete (default: false)
@@ -8861,32 +9194,37 @@ interface UIFieldOptions<T extends FieldType = FieldType> {
         enableGoogleMaps?: boolean;
         /** Whether to extract district code for Paris addresses */
         extractDistrictCode?: boolean;
-    } : never;
-}
-/**
- * Complete field configuration combining schema definition with UI options
+    } : T extends 'combobox' ? {
+        /** Enable creating new values by typing */
+        creatable?: boolean;
+    } : T extends 'switch' ? {
+        /** Label shown when switch is off/unchecked */
+        uncheckedLabel?: string;
+        /** Label shown when switch is on/checked */
+        checkedLabel?: string;
+        /** Value stored when switch is off (default: false) */
+        uncheckedValue?: string | boolean;
+        /** Value stored when switch is on (default: true) */
+        checkedValue?: string | boolean;
+    } : Record<string, unknown>;
+}
+/**
+ * Complete field configuration for form rendering
+ * Extends EntityField with runtime properties (name, value, defaultValue)
  * @template T - The field type
  *
- * @version 0.0.1
+ * @version 0.0.2
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-interface FieldConfig<T extends FieldType = FieldType> {
-    /** Field identifier - required business logic */
+interface FieldConfig<T extends FieldType = FieldType> extends Omit<EntityField<T>, 'options'> {
+    /** Field identifier - required for form binding */
     name: string;
-    /** Field type - required business logic */
-    type: T;
-    /** Field label - required business logic */
+    /** Field label - auto-generated from name if not provided in EntityField */
     label: string;
-    /** Whether field is required - smart default: false */
+    /** Whether field is required - convenience prop extracted from validation.required */
     required?: boolean;
-    /** Field visibility - smart default: 'user' */
-    visibility?: 'user' | 'admin' | 'technical';
-    /** Whether the field should be hidden in the UI - smart default: false */
-    hidden?: boolean;
-    /** Field validation rules - smart default: schemas package handles it */
-    validation?: ValidationRules<T>;
-    /** UI-specific configuration */
+    /** UI-specific configuration - extends EntityField.options with UI features */
     options?: UIFieldOptions<T>;
     /** Current field value */
     value?: ValueTypeForField<T>;
@@ -9048,6 +9386,108 @@ interface ModalActions {
     /** Close the modal */
     closeModal: () => void;
 }
+/**
+ * Phase of the redirect overlay progression
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type RedirectOverlayPhase = 'connecting' | 'preparing' | 'redirecting' | 'timeout';
+/**
+ * Billing-specific redirect operations
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type BillingRedirectOperation = 'stripe-checkout' | 'stripe-portal';
+/**
+ * Auth partner redirect operations - DRY derived from AUTH_PARTNERS schema
+ * Format: `oauth-${partnerId}` for OAuth partners, `auth-${partnerId}` for auth-only
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type AuthRedirectOperation = `oauth-${AuthPartnerId}` | `auth-${AuthPartnerId}`;
+/**
+ * OAuth partner redirect operations - DRY derived from OAUTH_PARTNERS schema
+ * Format: `oauth-api-${partnerId}` for API-only OAuth partners
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type OAuthRedirectOperation = `oauth-api-${OAuthPartnerId}`;
+/**
+ * All redirect operations - Union of billing, auth, and OAuth operations
+ * Extensible via string intersection for custom operations
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type RedirectOperation = BillingRedirectOperation | AuthRedirectOperation | OAuthRedirectOperation | (string & {});
+/**
+ * Configuration for redirect overlay (optional overrides)
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+interface RedirectOverlayConfig {
+    /** i18n namespace to use (default: inferred from operation) */
+    namespace?: string;
+    /** Custom title (overrides i18n) */
+    title?: string;
+    /** Custom message (overrides i18n) */
+    message?: string;
+    /** Custom subtitle (overrides i18n) */
+    subtitle?: string;
+    /** Icon type: 'lock' for payments, 'shield' for auth (default: inferred) */
+    icon?: 'lock' | 'shield' | 'none';
+    /** Timeout in ms before showing cancel button (default: 10000) */
+    cancelTimeout?: number;
+}
+/**
+ * Redirect overlay state
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+interface RedirectOverlayState {
+    /** Whether the redirect overlay is visible */
+    isRedirectOverlayOpen: boolean;
+    /** Current operation being performed */
+    redirectOperation: RedirectOperation | null;
+    /** Current phase of the redirect */
+    redirectPhase: RedirectOverlayPhase;
+    /** Whether cancel button should be shown */
+    showCancelButton: boolean;
+    /** Configuration overrides */
+    redirectConfig: RedirectOverlayConfig | null;
+    /** Timestamp when overlay was shown (for phase progression) */
+    redirectStartTime: number | null;
+}
+/**
+ * Redirect overlay actions
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+interface RedirectOverlayActions {
+    /** Show the redirect overlay */
+    showRedirectOverlay: (operation: RedirectOperation, config?: RedirectOverlayConfig) => void;
+    /** Hide the redirect overlay */
+    hideRedirectOverlay: () => void;
+    /** Update the current phase (internal use) */
+    setRedirectPhase: (phase: RedirectOverlayPhase) => void;
+    /** Show/hide cancel button (internal use) */
+    setShowCancelButton: (show: boolean) => void;
+}
 /**
  * Loading state
  *
@@ -11646,141 +12086,301 @@ declare function parseDateToNoonUTC(dateString: string): string | undefined;
  */
 declare function toDateOnly(date: DateValue | number | string | null | undefined): string;
 
+interface HandleErrorOptions {
+    userMessage?: string;
+    context?: Record<string, any>;
+    log?: boolean;
+    reportToSentry?: boolean;
+    showNotification?: boolean;
+    severity?: 'error' | 'warning' | 'info' | 'success';
+    notificationTimeout?: number;
+}
 /**
- * Check if email verification should be shown to users
+ * Universal error handler for DoNotDev applications
+ *
+ * Handles errors from any source, converting them to standardized DoNotDevError
+ * objects, logging appropriately, and optionally adding to UI notification system.
  *
- * Email verification is only relevant when:
- * 1. Email authentication is enabled (user can sign up with email/password)
- * 2. Firebase email verification is enabled in the project settings
+ * @param error - The original error from any source
+ * @param optionsOrMessage - Optional configuration or user-friendly message
+ * @returns Standardized DoNotDevError
  *
- * @returns boolean - true if email verification should be shown
+ * @example
+ * try {
+ *   await fetchData();
+ * } catch (error) {
+ *   throw handleError(error, 'Failed to fetch data');
+ * }
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-declare function shouldShowEmailVerification(): boolean;
+declare function handleError(error: unknown, optionsOrMessage?: HandleErrorOptions | string): DoNotDevError;
 /**
- * Check if email verification is required for the current user
+ * Creates a wrapped function that handles errors automatically
+ *
+ * @param fn - Function to wrap with error handling
+ * @param options - Error handling options or user message
+ * @returns Wrapped function with error handling
  *
- * @param user - The current user object
- * @returns boolean - true if email verification is required
+ * @example
+ * const safeFetchData = withErrorHandling(fetchData, 'Failed to fetch data');
+ * await safeFetchData();
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-declare function isEmailVerificationRequired(user: any): boolean;
-
+declare function withErrorHandling<T extends (...args: any[]) => any>(fn: T, options?: HandleErrorOptions | string): (...args: Parameters<T>) => Promise<ReturnType<T>>;
 /**
- * @fileoverview Smart translation helper
- * @description Auto-detects translation keys vs raw strings
+ * Display a notification message (client-only)
+ * This is a stub - actual implementation should be in client-side code
+ * that imports toast directly from @donotdev/components
+ *
+ * @param message Message to display
+ * @param severity Severity level
+ * @param timeout Optional timeout in milliseconds
+ * @returns ID of the notification
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
+declare function showNotification(message: string, severity?: 'error' | 'warning' | 'info' | 'success', timeout?: number): string;
+
 /**
- * Smart translation helper - auto-detects translation keys vs raw strings
- *
- * **How it works:**
- * - If string has no dots/colons → return as-is (plain string)
- * - If string has namespace prefix (e.g. "purchase:products.x") → try to translate
- * - If string has dots but no namespace → try to translate (i18next fallback returns original if missing)
- *
- * **Namespace handling:**
- * - "purchase:products.earlyBird.name" → translates from purchase namespace
- * - "products.earlyBird.name" → translates from current namespace
- * - "Early Bird Lifetime" → returns as-is
- *
- * **Use cases:**
- * 1. Simple apps: Pass plain strings, they render as-is
- * 2. i18n apps: Pass translation keys with namespace prefix
- * 3. Edge cases: "Dr. Smith" with dot → tries t(), fallback returns original ✅
+ * @fileoverview Error source detection module
+ * @description Automatically detects the source of errors to apply appropriate handling
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
- *
- * @example
- * ```tsx
- * // Simple app
- * maybeTranslate(t, "Early Bird Lifetime") // → "Early Bird Lifetime"
- *
- * // i18n app with namespace
- * maybeTranslate(t, "purchase:products.earlyBird.name") // → "Accès Anticipé à Vie" (if FR)
- *
- * // i18n app without namespace
- * maybeTranslate(t, "products.earlyBird.name") // → "Accès Anticipé à Vie" (if FR)
- *
- * // Missing translation
- * maybeTranslate(t, "products.missing.key") // → "products.missing.key" (debug!)
- * ```
  */
-declare function maybeTranslate(t: any, value?: string): string;
 
 /**
- * @fileoverview PKCE (Proof Key for Code Exchange) utilities
- * @description Implements PKCE for OAuth 2.0 flows to enhance security
+ * Detects the source of an error based on its properties and structure
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
+ * @param error - The error to analyze
+ * @returns The detected error source
  */
+declare function detectErrorSource(error: unknown): ErrorSource;
+
 /**
- * Generate a cryptographically random code verifier
+ * Default error messages for standard error codes
+ * These provide a fallback when no specific message is available
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
- * @returns Base64URL-encoded code verifier
  */
-declare function generateCodeVerifier(): string;
+declare const DEFAULT_ERROR_MESSAGES: Record<ErrorCode, string>;
 /**
- * Generate a code challenge from a code verifier
+ * Maps an error from any source to a standardized DoNotDevError
+ *
+ * This is the central error mapping function that routes errors to the appropriate
+ * handler based on the detected source.
+ *
+ * @param error - The original error
+ * @param source - The detected error source
+ * @param userMessage - Optional user-friendly message
+ * @returns A standardized DoNotDevError
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
- * @param verifier The code verifier
- * @returns Promise resolving to Base64URL-encoded code challenge
  */
-declare function generateCodeChallenge(verifier: string): Promise<string>;
+declare function mapToDoNotDevError(error: unknown, source: ErrorSource, userMessage?: string): DoNotDevError;
+
 /**
- * Generate a PKCE pair (code verifier and challenge)
+ * @fileoverview Sentry integration module
+ * @description Handles capturing errors to Sentry with appropriate context.
+ * Works universally on both client and server - uses globalThis.Sentry which
+ * is set by both @sentry/react and @sentry/node when initialized.
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
- * @returns Promise resolving to PKCE pair
  */
-declare function generatePKCEPair(): Promise<{
-    codeVerifier: string;
-    codeChallenge: string;
-}>;
+
 /**
- * Check if PKCE is supported by the current environment
- * @returns True if PKCE is supported
+ * Captures an error to Sentry with additional context
+ * Works on both client (@sentry/react) and server (@sentry/node)
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
+ * @param error - The error to capture
+ * @param source - The detected error source
+ * @param context - Additional context to include
  */
-declare function isPKCESupported(): boolean;
+declare function captureErrorToSentry(error: DoNotDevError, source: ErrorSource, context?: Record<string, any>): void;
+
 /**
- * Validate a code verifier format
- * @param verifier The code verifier to validate
- * @returns True if the verifier is valid
+ * @fileoverview Standard error handling factory
+ * @description Creates error handlers that map any source error to DoNotDevError format
  *
  * @version 0.0.1
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-declare function validateCodeVerifier(verifier: string): boolean;
+
 /**
- * Validate a code challenge format
- * @param challenge The code challenge to validate
- * @returns True if the challenge is valid
+ * Type for error handler functions
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+type ErrorHandlerFunction = (error: unknown, userMessage?: string) => DoNotDevError;
+/**
+ * Core configuration for error handlers
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+interface ErrorHandlerConfig {
+    errorSource: ErrorSource;
+    defaultErrorCode: ErrorCode;
+    defaultErrorMessage: string;
+    errorCodeMapping?: Record<string, ErrorCode>;
+    friendlyMessageMapping?: Record<string, string>;
+    extractErrorCode?: (error: unknown) => string | undefined;
+    extractErrorMessage?: (error: unknown) => string | undefined;
+    processMetadata?: (error: unknown) => Record<string, any>;
+}
+/**
+ * Creates an error handler that converts any type of error to DoNotDevError format
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ * @param config Configuration for the error handler
+ * @returns A function that converts errors to DoNotDevErrors
+ */
+declare function createErrorHandler(config: ErrorHandlerConfig): ErrorHandlerFunction;
+/**
+ * Common error code mappings for most services
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare const commonErrorCodeMappings: Record<string, ErrorCode>;
+
+/**
+ * @fileoverview Smart translation helper
+ * @description Auto-detects translation keys vs raw strings
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+/**
+ * Smart translation helper - auto-detects translation keys vs raw strings
+ *
+ * **How it works:**
+ * - If string has no dots/colons → return as-is (plain string)
+ * - If string has namespace prefix (e.g. "purchase:products.x") → try to translate
+ * - If string has dots but no namespace → try to translate (i18next fallback returns original if missing)
+ *
+ * **Namespace handling:**
+ * - "purchase:products.earlyBird.name" → translates from purchase namespace
+ * - "products.earlyBird.name" → translates from current namespace
+ * - "Early Bird Lifetime" → returns as-is
+ *
+ * **Use cases:**
+ * 1. Simple apps: Pass plain strings, they render as-is
+ * 2. i18n apps: Pass translation keys with namespace prefix
+ * 3. Edge cases: "Dr. Smith" with dot → tries t(), fallback returns original ✅
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ *
+ * @example
+ * ```tsx
+ * // Simple app
+ * maybeTranslate(t, "Early Bird Lifetime") // → "Early Bird Lifetime"
+ *
+ * // i18n app with namespace
+ * maybeTranslate(t, "purchase:products.earlyBird.name") // → "Accès Anticipé à Vie" (if FR)
+ *
+ * // i18n app without namespace
+ * maybeTranslate(t, "products.earlyBird.name") // → "Accès Anticipé à Vie" (if FR)
+ *
+ * // Missing translation
+ * maybeTranslate(t, "products.missing.key") // → "products.missing.key" (debug!)
+ * ```
+ */
+declare function maybeTranslate(t: any, value?: string): string;
+
+/**
+ * @fileoverview PKCE (Proof Key for Code Exchange) utilities
+ * @description Implements PKCE for OAuth 2.0 flows to enhance security
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+/**
+ * Generate a cryptographically random code verifier
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ * @returns Base64URL-encoded code verifier
+ */
+declare function generateCodeVerifier(): string;
+/**
+ * Generate a code challenge from a code verifier
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ * @param verifier The code verifier
+ * @returns Promise resolving to Base64URL-encoded code challenge
+ */
+declare function generateCodeChallenge(verifier: string): Promise<string>;
+/**
+ * Generate a PKCE pair (code verifier and challenge)
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ * @returns Promise resolving to PKCE pair
+ */
+declare function generatePKCEPair(): Promise<{
+    codeVerifier: string;
+    codeChallenge: string;
+}>;
+/**
+ * Check if PKCE is supported by the current environment
+ * @returns True if PKCE is supported
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function isPKCESupported(): boolean;
+/**
+ * Validate a code verifier format
+ * @param verifier The code verifier to validate
+ * @returns True if the verifier is valid
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function validateCodeVerifier(verifier: string): boolean;
+/**
+ * Validate a code challenge format
+ * @param challenge The code challenge to validate
+ * @returns True if the challenge is valid
  *
  * @version 0.0.1
  * @since 0.0.1
@@ -11809,17 +12409,222 @@ declare function validateCodeChallenge(challenge: string): boolean;
  */
 declare function withGracefulDegradation<T>(init: () => Promise<T>, fallback: () => void, featureName: string): Promise<T | false>;
 
-/**
- * Lazy import with caching
+/**
+ * Lazy import with caching
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ * @param importFn - Dynamic import function
+ * @param cacheKey - Cache key for this import
+ * @returns Cached or fresh import result
+ */
+declare function lazyImport<T>(importFn: () => Promise<T>, cacheKey: string): Promise<T>;
+
+/**
+
+ * @fileoverview Role Hierarchy Utilities
+
+ * @description Provides role-based access control with hierarchical permissions.
+
+ * Implements a 4-level hierarchy: guest (0) < user (1) < admin (2) < super (3).
+
+ *
+
+ * **Hierarchy Rules:**
+
+ * - Super can access: super, admin, user, and guest routes
+
+ * - Admin can access: admin, user, and guest routes
+
+ * - User can access: user and guest routes
+
+ * - Guest can access: guest routes only
+
+ *
+
+ * **CSR/SSR/Server Safe:**
+
+ * Pure function with no browser APIs or React dependencies.
+
+ * Safe for use in Firebase Functions, API routes, and server-side rendering.
+
+ *
+
+ * @version 0.0.1
+
+ * @since 0.0.1
+
+ * @author AMBROISE PARK Consulting
+
+ */
+/**
+
+ * Check if a user role has access to a required role based on hierarchy.
+
+ *
+
+ * Uses a 4-level hierarchy where higher roles inherit access to lower roles:
+
+ * - Super (level 3) can access super, admin, user, and guest routes
+
+ * - Admin (level 2) can access admin, user, and guest routes
+
+ * - User (level 1) can access user and guest routes
+
+ * - Guest (level 0) can access guest routes only
+
+ *
+
+ * Unknown roles default to level -1 (denied) for security.
+
+ * Unknown required roles default to Infinity (always denied).
+
+ *
+
+ * @param userRole - The user's current role (e.g., 'super', 'admin', 'user', 'guest')
+
+ * @param requiredRole - The role required to access the resource
+
+ * @returns True if user has sufficient role level, false otherwise
+
+ *
+
+ * @example
+
+ * ```typescript
+
+ * // Admin accessing user route
+
+ * hasRoleAccess('admin', 'user') // true
+
+ *
+
+ * // User accessing admin route
+
+ * hasRoleAccess('user', 'admin') // false
+
+ *
+
+ * // Super accessing admin route
+
+ * hasRoleAccess('super', 'admin') // true
+
+ * ```
+
+ *
+
+ * @version 0.0.1
+
+ * @since 0.0.1
+
+ */
+declare function hasRoleAccess(userRole: string | undefined, requiredRole: string): boolean;
+
+/**
+
+ * @fileoverview Tier Hierarchy Utilities
+
+ * @description Provides subscription tier-based access control with hierarchical permissions.
+
+ * Uses tier levels from SubscriptionConfig (apps define their own) with COMMON_TIER_CONFIGS as fallback.
+
+ *
+
+ * **Hierarchy Rules:**
+
+ * Higher tier levels inherit access to lower tier levels:
+
+ * - Tier with level 2 can access tiers with level 2, 1, and 0
+
+ * - Tier with level 1 can access tiers with level 1 and 0
+
+ * - Tier with level 0 can access tier with level 0 only
+
+ *
+
+ * **CSR/SSR/Server Safe:**
+
+ * Pure function with no browser APIs or React dependencies.
+
+ * Safe for use in Firebase Functions, API routes, and server-side rendering.
+
+ *
+
+ * @version 0.0.1
+
+ * @since 0.0.1
+
+ * @author AMBROISE PARK Consulting
+
+ */
+
+/**
+
+ * Check if a user tier has access to a required tier based on hierarchy.
+
+ *
+
+ * Uses tier levels from the provided config (or COMMON_TIER_CONFIGS as fallback).
+
+ * Higher tier levels inherit access to lower tier levels.
+
+ *
+
+ * Unknown tiers default to level -1 (denied) for security.
+
+ * Unknown required tiers default to Infinity (always denied).
+
+ *
+
+ * @param userTier - The user's current tier (e.g., 'pro', 'free', 'ai')
+
+ * @param requiredTier - The tier required to access the resource
+
+ * @param tierConfig - Optional custom tier configuration. If not provided, uses COMMON_TIER_CONFIGS
+
+ * @returns True if user has sufficient tier level, false otherwise
+
+ *
+
+ * @example
+
+ * ```typescript
+
+ * // Pro accessing free route
+
+ * hasTierAccess('pro', 'free') // true
+
+ *
+
+ * // Free accessing pro route
+
+ * hasTierAccess('free', 'pro') // false
+
+ *
+
+ * // With custom config
+
+ * const customConfig = {
+
+ *   basic: { features: [], level: 0 },
+
+ *   premium: { features: [], level: 1 }
+
+ * };
+
+ * hasTierAccess('premium', 'basic', customConfig) // true
+
+ * ```
+
  *
+
  * @version 0.0.1
+
  * @since 0.0.1
- * @author AMBROISE PARK Consulting
- * @param importFn - Dynamic import function
- * @param cacheKey - Cache key for this import
- * @returns Cached or fresh import result
+
  */
-declare function lazyImport<T>(importFn: () => Promise<T>, cacheKey: string): Promise<T>;
+declare function hasTierAccess(userTier: string | undefined, requiredTier: string, tierConfig?: SubscriptionConfig['tiers']): boolean;
 
 /**
  * @fileoverview Singleton utility functions
@@ -11981,125 +12786,6 @@ declare function updateMetadata(userId: string): {
     _updatedBy: string;
 };
 
-/**
- * @fileoverview Server-side error handler for DoNotDev applications
- * @description Centralized error handling for server environments with logging and reporting
- *
- * This module provides comprehensive error handling specifically designed for server
- * environments. It handles error detection, mapping, logging, and reporting without
- * any client-side dependencies like UI notifications.
- *
- * **Key Features:**
- * - Universal error handling for any error type
- * - Automatic error source detection and mapping
- * - Centralized logging with structured context
- * - Server-safe error reporting (no UI dependencies)
- * - Context preservation and debugging information
- * - Configurable error handling behavior
- *
- * **Error Flow:**
- * 1. Detect error source and type
- * 2. Map to standardized DoNotDevError
- * 3. Log error with structured context information
- * 4. Report to external services (server-safe)
- * 5. Return standardized error object
- *
- * **Usage Pattern:**
- * ```typescript
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   throw handleServerError(error, {
- *     userMessage: 'Operation failed',
- *     context: { operation: 'riskyOperation' },
- *     severity: 'error'
- *   });
- * }
- * ```
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Error handling options for server environments
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-interface HandleServerErrorOptions {
-    /** User-friendly error message */
-    userMessage?: string;
-    /** Additional context information */
-    context?: Record<string, any>;
-    /** Error severity level for logging */
-    severity?: 'error' | 'warning' | 'info' | 'success';
-    /** Whether to report to external services */
-    reportToExternal?: boolean;
-    /** Custom error code */
-    code?: ErrorCode;
-    /** Error source */
-    source?: ErrorSource;
-    /** Whether to include stack trace in logs */
-    includeStackTrace?: boolean;
-    /** Whether this error should be displayed to the user */
-    displayable?: boolean;
-}
-/**
- * Universal error handler for server environments
- *
- * @param error - The error to handle
- * @param optionsOrMessage - Error handling options or simple message string
- * @returns Standardized DoNotDevError
- *
- * @example
- * ```typescript
- * // Simple usage
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   throw handleServerError(error, 'Operation failed');
- * }
- *
- * // Advanced usage
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   throw handleServerError(error, {
- *     userMessage: 'Failed to process user data',
- *     context: { userId: '123', operation: 'processUser' },
- *     severity: 'error',
- *     code: 'USER_PROCESSING_FAILED'
- *   });
- * }
- * ```
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function handleServerError(error: unknown, optionsOrMessage?: HandleServerErrorOptions | string): DoNotDevError;
-/**
- * Convenience function for logging errors without throwing
- * Useful for non-critical errors that should be logged but not propagated
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function logServerErrorOnly(error: unknown, optionsOrMessage?: HandleServerErrorOptions | string): void;
-/**
- * Convenience function for creating server-safe error messages
- * Returns a user-friendly message without throwing
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function createServerErrorMessage(error: unknown, fallbackMessage?: string): string;
-
 /**
  * @fileoverview Server-side date utilities
  * @description Robust date calculation utilities for server environments
@@ -12185,134 +12871,6 @@ declare function validateMetadata(metadata: Record<string, any>): Record<string,
  */
 declare function validateEnvVar(name: string, required?: boolean): string;
 
-/**
- * Log levels for structured logging
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    FATAL = 4
-}
-/**
- * Log entry interface for structured logging
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-interface LogEntry {
-    level: LogLevel;
-    message: string;
-    timestamp: string;
-    context?: Record<string, any>;
-    error?: Error;
-    metadata?: Record<string, any>;
-}
-/**
- * Server-side logger (client-safe, no Sentry)
- *
- * Features:
- * - Structured logging with context
- * - Basic console output
- * - Performance monitoring
- * - Request correlation
- *
- * Note: For Sentry integration, use the logger from functions/shared/logger.ts
- *
- * @example
- * ```typescript
- * import { logger } from '@donotdev/utils/server';
- *
- * // Basic logging
- * logger.info('Server started', { port: 3000 });
- *
- * // Error logging
- * logger.error('Database error', { error: err, query: 'SELECT * FROM users' });
- *
- * // Performance logging
- * logger.info('Request completed', {
- *   duration: 150,
- *   status: 200,
- *   path: '/api/users'
- * });
- * ```
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare const logger: {
-    /**
-     * Log debug information
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    debug(message: string, context?: Record<string, any>): void;
-    /**
-     * Log informational messages
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    info(message: string, context?: Record<string, any>): void;
-    /**
-     * Log warning messages
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    warn(message: string, context?: Record<string, any>): void;
-    /**
-     * Log error messages
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    error(message: string, context?: Record<string, any>): void;
-    /**
-     * Log fatal errors
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    fatal(message: string, context?: Record<string, any>): void;
-    /**
-     * Core logging method
-     * @param level - Log level
-     * @param message - Log message
-     * @param context - Additional context data
-     */
-    log(level: LogLevel, message: string, context?: Record<string, any>): void;
-    /**
-     * Check if Sentry is enabled (always false for client-safe version)
-     * @returns False - this version doesn't support Sentry
-     */
-    isSentryEnabled(): boolean;
-    /**
-     * Get current log level (always DEBUG for server)
-     * @returns Current log level
-     */
-    getLevel(): LogLevel;
-};
-/**
- * Create a child logger with additional context
- * @param context - Additional context to include in all logs
- * @returns Child logger instance
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function createChildLogger(context: Record<string, any>): {
-    debug: (message: string, additionalContext?: Record<string, any>) => void;
-    info: (message: string, additionalContext?: Record<string, any>) => void;
-    warn: (message: string, additionalContext?: Record<string, any>) => void;
-    error: (message: string, additionalContext?: Record<string, any>) => void;
-    fatal: (message: string, additionalContext?: Record<string, any>) => void;
-};
-
 /**
  * @fileoverview Server-side cookie utilities
  * @description Cookie parsing for SSR environments (Next.js, etc.)
@@ -12355,25 +12913,29 @@ declare function parseServerCookie(cookieHeader: string | undefined, name: strin
  */
 //# sourceMappingURL=index.d.ts.map
 
+declare const index_d_DEFAULT_ERROR_MESSAGES: typeof DEFAULT_ERROR_MESSAGES;
 type index_d_DateFormatOptions = DateFormatOptions;
 type index_d_DateFormatPreset = DateFormatPreset;
-type index_d_HandleServerErrorOptions = HandleServerErrorOptions;
-type index_d_LogEntry = LogEntry;
-type index_d_LogLevel = LogLevel;
-declare const index_d_LogLevel: typeof LogLevel;
+type index_d_DoNotDevError = DoNotDevError;
+declare const index_d_DoNotDevError: typeof DoNotDevError;
+type index_d_ErrorHandlerConfig = ErrorHandlerConfig;
+type index_d_ErrorHandlerFunction = ErrorHandlerFunction;
+type index_d_HandleErrorOptions = HandleErrorOptions;
 type index_d_SingletonManager = SingletonManager;
 declare const index_d_SingletonManager: typeof SingletonManager;
 declare const index_d_addMonths: typeof addMonths;
 declare const index_d_addYears: typeof addYears;
 declare const index_d_calculateSubscriptionEndDate: typeof calculateSubscriptionEndDate;
+declare const index_d_captureErrorToSentry: typeof captureErrorToSentry;
+declare const index_d_commonErrorCodeMappings: typeof commonErrorCodeMappings;
 declare const index_d_compactToISOString: typeof compactToISOString;
 declare const index_d_createAsyncSingleton: typeof createAsyncSingleton;
-declare const index_d_createChildLogger: typeof createChildLogger;
+declare const index_d_createErrorHandler: typeof createErrorHandler;
 declare const index_d_createMetadata: typeof createMetadata;
 declare const index_d_createMethodProxy: typeof createMethodProxy;
-declare const index_d_createServerErrorMessage: typeof createServerErrorMessage;
 declare const index_d_createSingleton: typeof createSingleton;
 declare const index_d_createSingletonWithParams: typeof createSingletonWithParams;
+declare const index_d_detectErrorSource: typeof detectErrorSource;
 declare const index_d_formatDate: typeof formatDate;
 declare const index_d_formatRelativeTime: typeof formatRelativeTime;
 declare const index_d_generateCodeChallenge: typeof generateCodeChallenge;
@@ -12381,21 +12943,21 @@ declare const index_d_generateCodeVerifier: typeof generateCodeVerifier;
 declare const index_d_generatePKCEPair: typeof generatePKCEPair;
 declare const index_d_getCurrentTimestamp: typeof getCurrentTimestamp;
 declare const index_d_getWeekFromISOString: typeof getWeekFromISOString;
-declare const index_d_handleServerError: typeof handleServerError;
+declare const index_d_handleError: typeof handleError;
+declare const index_d_hasRoleAccess: typeof hasRoleAccess;
+declare const index_d_hasTierAccess: typeof hasTierAccess;
 declare const index_d_isCompactDateString: typeof isCompactDateString;
-declare const index_d_isEmailVerificationRequired: typeof isEmailVerificationRequired;
 declare const index_d_isPKCESupported: typeof isPKCESupported;
 declare const index_d_isoToCompactString: typeof isoToCompactString;
 declare const index_d_lazyImport: typeof lazyImport;
-declare const index_d_logServerErrorOnly: typeof logServerErrorOnly;
-declare const index_d_logger: typeof logger;
+declare const index_d_mapToDoNotDevError: typeof mapToDoNotDevError;
 declare const index_d_maybeTranslate: typeof maybeTranslate;
 declare const index_d_normalizeToISOString: typeof normalizeToISOString;
 declare const index_d_parseDate: typeof parseDate;
 declare const index_d_parseDateToNoonUTC: typeof parseDateToNoonUTC;
 declare const index_d_parseISODate: typeof parseISODate;
 declare const index_d_parseServerCookie: typeof parseServerCookie;
-declare const index_d_shouldShowEmailVerification: typeof shouldShowEmailVerification;
+declare const index_d_showNotification: typeof showNotification;
 declare const index_d_timestampToISOString: typeof timestampToISOString;
 declare const index_d_toDateOnly: typeof toDateOnly;
 declare const index_d_toISOString: typeof toISOString;
@@ -12409,210 +12971,12 @@ declare const index_d_validateCodeVerifier: typeof validateCodeVerifier;
 declare const index_d_validateEnvVar: typeof validateEnvVar;
 declare const index_d_validateMetadata: typeof validateMetadata;
 declare const index_d_validateUrl: typeof validateUrl;
+declare const index_d_withErrorHandling: typeof withErrorHandling;
 declare const index_d_withGracefulDegradation: typeof withGracefulDegradation;
 declare namespace index_d {
-  export { index_d_LogLevel as LogLevel, index_d_SingletonManager as SingletonManager, index_d_addMonths as addMonths, index_d_addYears as addYears, index_d_calculateSubscriptionEndDate as calculateSubscriptionEndDate, index_d_compactToISOString as compactToISOString, index_d_createAsyncSingleton as createAsyncSingleton, index_d_createChildLogger as createChildLogger, index_d_createMetadata as createMetadata, index_d_createMethodProxy as createMethodProxy, index_d_createServerErrorMessage as createServerErrorMessage, index_d_createSingleton as createSingleton, index_d_createSingletonWithParams as createSingletonWithParams, index_d_formatDate as formatDate, index_d_formatRelativeTime as formatRelativeTime, index_d_generateCodeChallenge as generateCodeChallenge, index_d_generateCodeVerifier as generateCodeVerifier, index_d_generatePKCEPair as generatePKCEPair, index_d_getCurrentTimestamp as getCurrentTimestamp, index_d_getWeekFromISOString as getWeekFromISOString, index_d_handleServerError as handleServerError, index_d_isCompactDateString as isCompactDateString, index_d_isEmailVerificationRequired as isEmailVerificationRequired, index_d_isPKCESupported as isPKCESupported, index_d_isoToCompactString as isoToCompactString, index_d_lazyImport as lazyImport, index_d_logServerErrorOnly as logServerErrorOnly, index_d_logger as logger, index_d_maybeTranslate as maybeTranslate, index_d_normalizeToISOString as normalizeToISOString, index_d_parseDate as parseDate, index_d_parseDateToNoonUTC as parseDateToNoonUTC, index_d_parseISODate as parseISODate, index_d_parseServerCookie as parseServerCookie, index_d_shouldShowEmailVerification as shouldShowEmailVerification, index_d_timestampToISOString as timestampToISOString, index_d_toDateOnly as toDateOnly, index_d_toISOString as toISOString, index_d_translateArray as translateArray, index_d_translateArrayRange as translateArrayRange, index_d_translateArrayWithIndices as translateArrayWithIndices, index_d_translateObjectArray as translateObjectArray, index_d_updateMetadata as updateMetadata, index_d_validateCodeChallenge as validateCodeChallenge, index_d_validateCodeVerifier as validateCodeVerifier, index_d_validateEnvVar as validateEnvVar, index_d_validateMetadata as validateMetadata, index_d_validateUrl as validateUrl, index_d_withGracefulDegradation as withGracefulDegradation };
-  export type { index_d_DateFormatOptions as DateFormatOptions, index_d_DateFormatPreset as DateFormatPreset, index_d_HandleServerErrorOptions as HandleServerErrorOptions, index_d_LogEntry as LogEntry };
-}
-
-/**
- * The standard schema types that are generated for each entity
- */
-interface EntitySchemas {
-    [key: string]: dndevSchema<unknown>;
+  export { index_d_DEFAULT_ERROR_MESSAGES as DEFAULT_ERROR_MESSAGES, index_d_DoNotDevError as DoNotDevError, index_d_SingletonManager as SingletonManager, index_d_addMonths as addMonths, index_d_addYears as addYears, index_d_calculateSubscriptionEndDate as calculateSubscriptionEndDate, index_d_captureErrorToSentry as captureErrorToSentry, index_d_commonErrorCodeMappings as commonErrorCodeMappings, index_d_compactToISOString as compactToISOString, index_d_createAsyncSingleton as createAsyncSingleton, index_d_createErrorHandler as createErrorHandler, index_d_createMetadata as createMetadata, index_d_createMethodProxy as createMethodProxy, index_d_createSingleton as createSingleton, index_d_createSingletonWithParams as createSingletonWithParams, index_d_detectErrorSource as detectErrorSource, index_d_formatDate as formatDate, index_d_formatRelativeTime as formatRelativeTime, index_d_generateCodeChallenge as generateCodeChallenge, index_d_generateCodeVerifier as generateCodeVerifier, index_d_generatePKCEPair as generatePKCEPair, index_d_getCurrentTimestamp as getCurrentTimestamp, index_d_getWeekFromISOString as getWeekFromISOString, index_d_handleError as handleError, index_d_hasRoleAccess as hasRoleAccess, index_d_hasTierAccess as hasTierAccess, index_d_isCompactDateString as isCompactDateString, index_d_isPKCESupported as isPKCESupported, index_d_isoToCompactString as isoToCompactString, index_d_lazyImport as lazyImport, index_d_mapToDoNotDevError as mapToDoNotDevError, index_d_maybeTranslate as maybeTranslate, index_d_normalizeToISOString as normalizeToISOString, index_d_parseDate as parseDate, index_d_parseDateToNoonUTC as parseDateToNoonUTC, index_d_parseISODate as parseISODate, index_d_parseServerCookie as parseServerCookie, index_d_showNotification as showNotification, index_d_timestampToISOString as timestampToISOString, index_d_toDateOnly as toDateOnly, index_d_toISOString as toISOString, index_d_translateArray as translateArray, index_d_translateArrayRange as translateArrayRange, index_d_translateArrayWithIndices as translateArrayWithIndices, index_d_translateObjectArray as translateObjectArray, index_d_updateMetadata as updateMetadata, index_d_validateCodeChallenge as validateCodeChallenge, index_d_validateCodeVerifier as validateCodeVerifier, index_d_validateEnvVar as validateEnvVar, index_d_validateMetadata as validateMetadata, index_d_validateUrl as validateUrl, index_d_withErrorHandling as withErrorHandling, index_d_withGracefulDegradation as withGracefulDegradation };
+  export type { index_d_DateFormatOptions as DateFormatOptions, index_d_DateFormatPreset as DateFormatPreset, index_d_ErrorHandlerConfig as ErrorHandlerConfig, index_d_ErrorHandlerFunction as ErrorHandlerFunction, index_d_HandleErrorOptions as HandleErrorOptions };
 }
-/**
- * Creates all necessary schemas for an entity
- *
- * @param entity The entity to create schemas for
- * @returns An object containing all generated schemas with proper typing
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function createSchemas(entity: Entity): EntitySchemas;
-
-/**
- * @fileoverview Schema enhancement utility
- * @description Enhances a Valibot schema with additional metadata
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Enhances a Valibot schema with additional metadata.
- *
- * @param schema - The base Valibot schema
- * @param metadata - The metadata to attach
- * @returns The enhanced schema
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function enhanceSchema<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, metadata: SchemaMetadata): dndevSchema<T>;
-
-/**
- * @fileoverview Schema type generation utility
- * @description Creates Valibot schemas for entity fields
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Extracts a Valibot schema type for a given entity field with validation rules.
- *
- * @param field - The entity field definition
- * @returns A Valibot schema corresponding to the field definition
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function getSchemaType(field: EntityField): v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>;
-
-/**
- * Recursively validates that all string values that look like potential dates
- * within an object adhere to the ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ).
- *
- * @param data - The object or data structure to validate
- * @param {string} [currentPath=''] - Internal tracking of the object path for error messages
- * @throws Error if any string resembling a date is not in the correct ISO format
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function validateDates(data: Record<string, any> | any[], currentPath?: string): void;
-
-/**
- * Validates a document against the schema, including uniqueness and custom validations.
- * @param schema - The enhanced schema.
- * @param data - The document data.
- * @param operation - 'create' or 'update'.
- * @param currentDocId - Optional current document ID for update operations.
- * @throws DoNotDevError if validation fails.
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function validateDocument<T>(schema: dndevSchema<T>, data: Record<string, any>, operation: 'create' | 'update', currentDocId?: string): Promise<void>;
-
-/**
- * @fileoverview Unique field validation utility
- * @description Validates uniqueness constraints for schema fields
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Registers a validator for uniqueness constraints
- *
- * @param validator - The validator implementation
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function registerUniqueConstraintValidator(validator: UniqueConstraintValidator): void;
-/**
- * Validates unique fields for a document across environments.
- *
- * @param schema - The Valibot schema with metadata.
- * @param data - The document data.
- * @param currentDocId - Optional ID of the current document (for updates).
- * @throws Error if a unique constraint is violated.
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function validateUniqueFields<T>(schema: dndevSchema<T>, data: Record<string, any>, currentDocId?: string): Promise<void>;
-
-/**
- * @fileoverview Schema Utilities
- * @description Common utility functions for working with schemas. Provides helper functions for schema metadata checking and manipulation.
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Checks if an object has schema metadata (works with Valibot schemas)
- *
- * @param obj - The object to check
- * @returns Whether the object has schema metadata
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function hasMetadata(obj: unknown): obj is dndevSchema<unknown>;
-/**
- * Gets the collection name from a schema
- *
- * @param schema - The schema to get the collection name from
- * @returns The collection name
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function getCollectionName(schema: dndevSchema<unknown>): string;
-
-/**
- * @fileoverview Field Visibility Utilities
- * @description Core visibility logic used by both frontend and backend for field access control
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Core visibility logic used by both frontend and backend
- *
- * @param visibility - The visibility level
- * @param isAdmin - Whether the user is an admin
- * @returns Whether the field should be visible
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function isFieldVisible(visibility: Visibility, isAdmin: boolean): boolean;
-/**
- * Gets visible fields from an entity definition
- *
- * @param fields - The entity fields
- * @param isAdmin - Whether the user is an admin
- * @returns Array of visible field names
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function getVisibleFieldsFromEntity(fields: Record<string, EntityField>, isAdmin: boolean): string[];
-declare const baseFields: Record<string, EntityField>;
-
-/**
- * @fileoverview Entity Definition Utilities
- * @description Utilities for defining and validating entities. Provides functions to define business entities with form configuration, field definitions, and validation rules.
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-
-/**
- * Defines an entity with validation and default configuration
- *
- * @param entity - The business entity definition
- * @returns The validated and configured entity
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare function defineEntity(entity: BusinessEntity): Entity;
 
-export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_LAYOUT_PRESET, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, LAYOUT_PRESET, LogLevel, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, baseFields, calculateSubscriptionEndDate, checkGitHubAccessSchema, compactToISOString, createAsyncSingleton, createChildLogger, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createMetadata, createMethodProxy, createSchemas, createServerErrorMessage, createSingleton, createSingletonWithParams, defineEntity, deleteEntitySchema, disconnectOAuthSchema, enhanceSchema, exchangeTokenSchema, formatDate, formatRelativeTime, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, getBreakpointFromWidth, getBreakpointUtils, getCollectionName, getConnectionsSchema, getCurrentTimestamp, getEntitySchema, getSchemaType, getVisibleFieldsFromEntity, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleServerError, hasMetadata, isAuthPartnerId, isBreakpoint, isCompactDateString, isEmailVerificationRequired, isFieldVisible, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, logServerErrorOnly, logger, maybeTranslate, normalizeToISOString, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, refreshTokenSchema, registerUniqueConstraintValidator, revokeGitHubAccessSchema, shouldShowEmailVerification, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, updateEntitySchema, updateMetadata, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateDates, validateDocument, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUniqueFields, validateUrl, validateUserSubscription, validateWebhookEvent, withGracefulDegradation };
-export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CustomClaims, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevLayoutProps, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityField, EntityHookErrors, EntityMetadata, EntitySchemas, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldConfig, FieldType, FieldTypeToValue, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionError, FunctionLoader, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, HandleServerErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutInput, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, LogEntry, MergedBarConfig, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, UIFieldOptions, UniqueConstraintValidator, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };
+export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_ERROR_MESSAGES, DEFAULT_LAYOUT_PRESET, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, LAYOUT_PRESET, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, calculateSubscriptionEndDate, captureErrorToSentry, checkGitHubAccessSchema, commonErrorCodeMappings, compactToISOString, createAsyncSingleton, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createErrorHandler, createMetadata, createMethodProxy, createSingleton, createSingletonWithParams, deleteEntitySchema, detectErrorSource, disconnectOAuthSchema, exchangeTokenSchema, formatDate, formatRelativeTime, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, getBreakpointFromWidth, getBreakpointUtils, getConnectionsSchema, getCurrentTimestamp, getEntitySchema, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleError, hasRoleAccess, hasTierAccess, isAuthPartnerId, isBreakpoint, isCompactDateString, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, mapToDoNotDevError, maybeTranslate, normalizeToISOString, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, refreshTokenSchema, revokeGitHubAccessSchema, showNotification, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, updateEntitySchema, updateMetadata, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUrl, validateUserSubscription, validateWebhookEvent, withErrorHandling, withGracefulDegradation };
+export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, AggregateConfig, AggregateFilterOperator, AggregateOperation, AggregateRequest, AggregateResponse, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOperation, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, BillingRedirectOperation, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CustomClaims, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevLayoutProps, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, Editable, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityField, EntityHookErrors, EntityMetadata, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorHandlerConfig, ErrorHandlerFunction, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldConfig, FieldType, FieldTypeToValue, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionError, FunctionLoader, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, GroupByDefinition, HandleErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutInput, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, MergedBarConfig, MetricDefinition, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRedirectOperation, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Picture, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, RedirectOperation, RedirectOverlayActions, RedirectOverlayConfig, RedirectOverlayPhase, RedirectOverlayState, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, UIFieldOptions, UniqueConstraintValidator, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };