@axcode/axcloud-sdk 0.1.7-dev.87ea138 → 0.1.7-dev.bf490b9

package/dist/index.d.mts

@@ -93,12 +93,57 @@ declare class AxCloudError extends Error {
 }
 declare function isAxCloudError(error: unknown): error is AxCloudError;
 
+type AnalyticsEventValue = string | number | boolean;
+type AnalyticsEventData = Record<string, AnalyticsEventValue>;
+interface AxCloudAnalyticsOptions {
+    /** Site key configured in AxCloud, for example "public-web". */
+    siteKey: string;
+    /** Analytics is opt-in and disabled unless this is true. */
+    enabled?: boolean;
+    /** Allow local collection for explicit development tests. */
+    trackLocalhost?: boolean;
+    /** Override path normalization. Return null to skip a pageview. */
+    normalizePath?: (pathname: string) => string | null;
+}
+interface AnalyticsPublicConfig {
+    enabled: boolean;
+    provider?: 'umami';
+    websiteId?: string;
+    scriptUrl?: string;
+    hostUrl?: string;
+    domains?: string[];
+    autoTrack?: boolean;
+    respectDoNotTrack?: boolean;
+    excludeSearch?: boolean;
+    excludeHash?: boolean;
+    allowedEvents?: string[];
+}
+interface AnalyticsRuntime {
+    enabled: boolean;
+    ready: boolean;
+    track: (eventName: string, data?: AnalyticsEventData) => boolean;
+    trackPageView: (pathname?: string) => boolean;
+}
+declare function isLocalAnalyticsHostname(hostname: string): boolean;
+declare function sanitizeAnalyticsPath(pathname: string, customNormalizer?: (pathname: string) => string | null): string | null;
+declare function sanitizeAnalyticsEventData(data: AnalyticsEventData | undefined): AnalyticsEventData | undefined;
+declare function isAllowedAnalyticsEvent(eventName: string, allowedEvents: string[] | undefined): boolean;
+declare function fetchAnalyticsPublicConfig(input: {
+    apiUrl: string;
+    orgId: string;
+    siteKey: string;
+    stage: string;
+    hostname: string;
+    signal?: AbortSignal;
+}): Promise<AnalyticsPublicConfig>;
+
 /**
  * AxCloud SDK Types
  *
  * Note: In the future, these types should be auto-generated from the OpenAPI spec.
  * For now, they are manually defined based on the AxCloud API.
  */
+
 type AxCloudModule = 'content' | 'members' | 'sections' | 'training' | 'ai' | 'documents' | 'voting';
 type SystemRole = 'super_admin' | 'org_admin' | 'section_admin' | 'member' | 'viewer';
 type UserRole = SystemRole | 'superadmin' | 'admin' | 'editor';
@@ -292,11 +337,15 @@ interface AxCloudConfig {
     stage: string;
     /** API key for public content endpoints (optional - required for public API access) */
     apiKey?: string;
+    /** Optional privacy-safe web analytics collection. */
+    analytics?: AxCloudAnalyticsOptions;
     auth0: {
         domain: string;
         clientId: string;
         redirectUri: string;
         audience?: string;
+        /** Auth0 Organization ID. Use this for invite-only member sites. */
+        organization?: string;
         /** Database connection name for password operations. Defaults to 'Username-Password-Authentication' */
         connection?: string;
     };
@@ -387,11 +436,35 @@ interface DocumentItem {
     created_at: string;
     updated_at: string;
     published_at?: string;
+    /** Section IDs this document is scoped to (member endpoint only). */
+    section_ids?: string[];
+    /** Display name of the member who uploaded the document (member endpoint only). */
+    uploaded_by_name?: string;
+    /** Folder IDs this document belongs to (member endpoint only). */
+    folder_ids?: string[];
 }
 interface DocumentListResponse {
     items: DocumentItem[];
     count: number;
 }
+/**
+ * A document folder the current member is allowed to see.
+ *
+ * Members receive folders for their own sections plus org-level folders
+ * (`section_id === null`). Returned by the member document-folders endpoint.
+ */
+interface DocumentFolder {
+    id: string;
+    /** Section this folder belongs to, or `null` for org-level folders. */
+    section_id: string | null;
+    /** Parent folder for nesting, or `null` for a top-level folder. */
+    parent_folder_id: string | null;
+    name: string;
+    sort_order: number;
+}
+interface DocumentFolderListResponse {
+    folders: DocumentFolder[];
+}
 interface SignedDocumentUrl {
     documentId: string;
     url: string;
@@ -403,6 +476,8 @@ interface DocumentQueryOptions {
     search?: string;
     tags?: string[];
     limit?: number;
+    /** Restrict results to documents belonging to this folder (member endpoint only). */
+    folderId?: string;
 }
 
 interface BarnsportMunicipality {
@@ -416,12 +491,29 @@ interface BarnsportMunicipality {
         bounds?: [number, number, number, number];
     };
 }
+interface BarnsportSportArticle {
+    short_description?: string;
+    what_is_it?: string;
+    why_fun?: string;
+    good_to_know?: {
+        age?: string;
+        equipment?: string;
+        cost?: string;
+    };
+    fun_facts?: string[];
+}
 interface BarnsportSport {
     id: string;
     slug: string;
     name: string;
     icon?: string;
     color?: string;
+    category?: string;
+    is_featured?: boolean;
+    hero_image_url?: string;
+    short_description?: string;
+    /** Present on the single-sport endpoint (GET /public/{orgId}/sports/{slug}). */
+    article?: BarnsportSportArticle;
 }
 interface BarnsportActivitySchedule {
     weekday?: number;
@@ -881,11 +973,15 @@ interface AxCloudProviderProps {
     stage?: string;
     /** API key for public content endpoints */
     apiKey?: string;
+    /** Optional privacy-safe analytics collection through AxCloud. */
+    analytics?: AxCloudAnalyticsOptions;
     auth0: {
         domain: string;
         clientId: string;
         redirectUri: string;
         audience?: string;
+        /** Auth0 Organization ID. Use this for invite-only member sites. */
+        organization?: string;
         /** Database connection name for password operations. Defaults to 'Username-Password-Authentication' */
         connection?: string;
     };
@@ -907,14 +1003,15 @@ interface AxCloudProviderProps {
  *   auth0={{
  *     domain: "auth.axcloud.app",
  *     clientId: "xxx",
- *     redirectUri: window.location.origin
+ *     redirectUri: window.location.origin,
+ *     organization: "org_abc123" // Optional Auth0 Organization ID for invite-only member sites
  *   }}
  * >
  *   <App />
  * </AxCloudProvider>
  * ```
  */
-declare function AxCloudProvider({ children, orgId, apiUrl, stage, apiKey, auth0, queryClient, timeout, }: AxCloudProviderProps): react_jsx_runtime.JSX.Element;
+declare function AxCloudProvider({ children, orgId, apiUrl, stage, apiKey, analytics, auth0, queryClient, timeout, }: AxCloudProviderProps): react_jsx_runtime.JSX.Element;
 
 interface AxCloudContextValue {
     config: AxCloudConfig;
@@ -924,20 +1021,35 @@ interface AxCloudContextValue {
     stage: string;
     /** Whether using public API mode (API key, no auth) */
     isPublicMode: boolean;
+    analytics: AnalyticsRuntime;
 }
 declare function useAxCloudContext(): AxCloudContextValue;
 
+type AnalyticsRuntimeConfig = Pick<AxCloudConfig, 'analytics' | 'apiUrl' | 'orgId' | 'stage'>;
+declare function useAnalyticsRuntime(config: AnalyticsRuntimeConfig): AnalyticsRuntime;
+declare function useAnalytics(): AnalyticsRuntime;
+
 interface AuthUser {
     id: string;
     email: string;
     name: string;
     avatar?: string;
+    /** Auth0's authoritative email verification claim. */
+    emailVerified?: boolean;
+}
+interface EmailVerificationResult {
+    success: boolean;
+    status: 'sent' | 'already_verified' | 'rate_limited' | 'failed';
+    message: string;
+    retryAfterSeconds?: number;
 }
 interface UseAuthReturn {
     isAuthenticated: boolean;
     isLoading: boolean;
     error: Error | undefined;
     user: AuthUser | null;
+    /** True only when Auth0 explicitly reports email_verified=false. */
+    needsEmailVerification: boolean;
     login: (options?: {
         returnTo?: string;
     }) => Promise<void>;
@@ -946,6 +1058,12 @@ interface UseAuthReturn {
     }) => Promise<void>;
     getAccessToken: () => Promise<string | undefined>;
     getAuth0Client: () => Auth0ClientState;
+    /** Refresh Auth0 tokens/profile and return the latest email verification state. */
+    refreshUser: () => Promise<boolean>;
+    /** Send a branded verification email that returns to the current product site. */
+    requestEmailVerification: (options?: {
+        returnTo?: string;
+    }) => Promise<EmailVerificationResult>;
     /** Request a password reset email for the current user or specified email */
     requestPasswordReset: (email?: string) => Promise<{
         success: boolean;
@@ -1711,6 +1829,58 @@ declare function useDocumentDownload(documentId: string | undefined): {
     error: Error | null;
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<SignedDocumentUrl, Error>>;
 };
+/**
+ * List documents the current member is allowed to see.
+ *
+ * Hits the member endpoint (`/documents/members/...`) which is NOT a
+ * `/public/` path, so the core client automatically attaches the member's
+ * `Authorization: Bearer <JWT>` header instead of the public API key.
+ *
+ * Returns public documents plus members/internal documents and section
+ * documents for the member's sections. Items include `section_ids` and
+ * uploader metadata (`uploaded_by_name`, `created_at`).
+ */
+declare function useMemberDocuments(options?: DocumentQueryOptions): {
+    documents: DocumentItem[];
+    items: DocumentItem[];
+    count: number;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<DocumentListResponse, Error>>;
+};
+/**
+ * List the document folders the current member is allowed to see.
+ *
+ * Hits the member endpoint (`/documents/members/${orgId}/document-folders`),
+ * which is NOT a `/public/` path, so the core client attaches the member's
+ * `Authorization: Bearer <JWT>` header instead of the public API key.
+ *
+ * Returns the member's section folders plus org-level folders
+ * (`section_id === null`). Use the returned folder ids with
+ * `useMemberDocuments({ folderId })` to scope a document list.
+ */
+declare function useMemberDocumentFolders(): {
+    folders: DocumentFolder[];
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<DocumentFolderListResponse, Error>>;
+};
+/**
+ * Fetch a short-lived signed download URL for a member-accessible document.
+ */
+declare function useMemberDocumentDownload(documentId: string | undefined): {
+    url: string | null;
+    documentUrl: string | null;
+    filename: string | null;
+    mimeType: string | null;
+    expiresIn: number | null;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<SignedDocumentUrl, Error>>;
+};
 
 declare function useBarnsportMunicipalities(): {
     municipalities: BarnsportMunicipality[];
@@ -1728,6 +1898,15 @@ declare function useBarnsportSports(): {
     error: Error | null;
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<BarnsportListResponse<BarnsportSport>, Error>>;
 };
+declare function useBarnsportSport(slug: string | undefined): {
+    sport: BarnsportSport | null;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<{
+        sport: BarnsportSport;
+    }, Error>>;
+};
 declare function useBarnsportActivities(filters?: BarnsportActivitiesFilter): {
     activities: BarnsportActivityListItem[];
     count: number;
@@ -1979,4 +2158,4 @@ interface LinkedAccountsListProps {
  */
 declare function LinkedAccountsList({ providers, showConnectButtons, className, onUnlink, onLinkInitiated, renderIdentity, renderAvailableProvider, }: LinkedAccountsListProps): react_jsx_runtime.JSX.Element;
 
-export { type AvailableProvider, AxCloudClient, type AxCloudConfig, AxCloudError, type AxCloudErrorCode, type AxCloudModule, AxCloudProvider, type Ballot, type BallotCandidate, type BallotOption, type BallotSeat, type BarnsportActivitiesFilter, type BarnsportActivity, type BarnsportActivityListItem, type BarnsportActivityLocation, type BarnsportActivityResponse, type BarnsportActivitySchedule, type BarnsportInterestSubmissionRequest, type BarnsportInterestSubmissionResponse, type BarnsportListResponse, type BarnsportMunicipality, type BarnsportRegistrationMethod, type BarnsportSitemapResponse, type BarnsportSitemapUrl, type BarnsportSport, type BaseRole, type CastVoteResult, type CodeEligibility, type ContentItem, type ContentQueryOptions, type ContentSlotImage, type ContentSlotMap, type ContentSlotReader, type ContentSlotValue, type CustomRole, type DocumentAudience, type DocumentItem, type DocumentListResponse, type DocumentQueryOptions, type DocumentSourceProvider, type DocumentStatus, type FormStatsResponse, type FormSubmission, type FormSubmissionRecord, type FormSubmissionResponse, type FormSubmissionsResponse, LinkedAccountsList, type LinkedAccountsListProps, type LinkedIdentity, LoginButton, LogoutButton, type MediaItem, type MediaListResponse, type Membership, ModuleGate, type NewsItem, type Organization, type OrganizationBranding, type OrganizationSettings, type Page, type PageContentState, type PaginatedResponse, ProtectedRoute, type Section, type SectionPermissions, type SignedDocumentUrl, type SignedMediaUrl, type SystemRole, type UseLinkedAccountsReturn, type User, type UserRole, type VoteReceipt, castVote, castVoteWithCode, checkEligibility, checkVotingCode, createClient, createContentSlotReader, createFormHelper, getBallot, getClient, getContentSlotMap, getVotingReceipt, isAxCloudError, submitForm, useAuth, useAvatar, useAxCloudContext, useBarnsportActivities, useBarnsportActivity, useBarnsportMunicipalities, useBarnsportSitemap, useBarnsportSports, useBranding, useCodeBallot, useContent, useContentItem, useDocumentDownload, useDocuments, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useSubmitBarnsportInterest, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };
+export { type AnalyticsEventData, type AnalyticsEventValue, type AnalyticsPublicConfig, type AnalyticsRuntime, type AnalyticsRuntimeConfig, type Auth0ClientState, type AuthUser, type AvailableProvider, type AxCloudAnalyticsOptions, AxCloudClient, type AxCloudConfig, AxCloudError, type AxCloudErrorCode, type AxCloudModule, AxCloudProvider, type Ballot, type BallotCandidate, type BallotOption, type BallotSeat, type BarnsportActivitiesFilter, type BarnsportActivity, type BarnsportActivityListItem, type BarnsportActivityLocation, type BarnsportActivityResponse, type BarnsportActivitySchedule, type BarnsportInterestSubmissionRequest, type BarnsportInterestSubmissionResponse, type BarnsportListResponse, type BarnsportMunicipality, type BarnsportRegistrationMethod, type BarnsportSitemapResponse, type BarnsportSitemapUrl, type BarnsportSport, type BaseRole, type CastVoteResult, type CodeEligibility, type ContentItem, type ContentQueryOptions, type ContentSlotImage, type ContentSlotMap, type ContentSlotReader, type ContentSlotValue, type CustomRole, type DocumentAudience, type DocumentFolder, type DocumentFolderListResponse, type DocumentItem, type DocumentListResponse, type DocumentQueryOptions, type DocumentSourceProvider, type DocumentStatus, type EmailVerificationResult, type FormStatsResponse, type FormSubmission, type FormSubmissionRecord, type FormSubmissionResponse, type FormSubmissionsResponse, LinkedAccountsList, type LinkedAccountsListProps, type LinkedIdentity, LoginButton, LogoutButton, type MediaItem, type MediaListResponse, type Membership, ModuleGate, type NewsItem, type Organization, type OrganizationBranding, type OrganizationSettings, type Page, type PageContentState, type PaginatedResponse, ProtectedRoute, type Section, type SectionPermissions, type SignedDocumentUrl, type SignedMediaUrl, type SystemRole, type UseAuthReturn, type UseLinkedAccountsReturn, type User, type UserRole, type VoteReceipt, castVote, castVoteWithCode, checkEligibility, checkVotingCode, createClient, createContentSlotReader, createFormHelper, fetchAnalyticsPublicConfig, getBallot, getClient, getContentSlotMap, getVotingReceipt, isAllowedAnalyticsEvent, isAxCloudError, isLocalAnalyticsHostname, sanitizeAnalyticsEventData, sanitizeAnalyticsPath, submitForm, useAnalytics, useAnalyticsRuntime, useAuth, useAvatar, useAxCloudContext, useBarnsportActivities, useBarnsportActivity, useBarnsportMunicipalities, useBarnsportSitemap, useBarnsportSport, useBarnsportSports, useBranding, useCodeBallot, useContent, useContentItem, useDocumentDownload, useDocuments, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useMemberDocumentDownload, useMemberDocumentFolders, useMemberDocuments, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useSubmitBarnsportInterest, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };

package/dist/index.d.ts

@@ -93,12 +93,57 @@ declare class AxCloudError extends Error {
 }
 declare function isAxCloudError(error: unknown): error is AxCloudError;
 
+type AnalyticsEventValue = string | number | boolean;
+type AnalyticsEventData = Record<string, AnalyticsEventValue>;
+interface AxCloudAnalyticsOptions {
+    /** Site key configured in AxCloud, for example "public-web". */
+    siteKey: string;
+    /** Analytics is opt-in and disabled unless this is true. */
+    enabled?: boolean;
+    /** Allow local collection for explicit development tests. */
+    trackLocalhost?: boolean;
+    /** Override path normalization. Return null to skip a pageview. */
+    normalizePath?: (pathname: string) => string | null;
+}
+interface AnalyticsPublicConfig {
+    enabled: boolean;
+    provider?: 'umami';
+    websiteId?: string;
+    scriptUrl?: string;
+    hostUrl?: string;
+    domains?: string[];
+    autoTrack?: boolean;
+    respectDoNotTrack?: boolean;
+    excludeSearch?: boolean;
+    excludeHash?: boolean;
+    allowedEvents?: string[];
+}
+interface AnalyticsRuntime {
+    enabled: boolean;
+    ready: boolean;
+    track: (eventName: string, data?: AnalyticsEventData) => boolean;
+    trackPageView: (pathname?: string) => boolean;
+}
+declare function isLocalAnalyticsHostname(hostname: string): boolean;
+declare function sanitizeAnalyticsPath(pathname: string, customNormalizer?: (pathname: string) => string | null): string | null;
+declare function sanitizeAnalyticsEventData(data: AnalyticsEventData | undefined): AnalyticsEventData | undefined;
+declare function isAllowedAnalyticsEvent(eventName: string, allowedEvents: string[] | undefined): boolean;
+declare function fetchAnalyticsPublicConfig(input: {
+    apiUrl: string;
+    orgId: string;
+    siteKey: string;
+    stage: string;
+    hostname: string;
+    signal?: AbortSignal;
+}): Promise<AnalyticsPublicConfig>;
+
 /**
  * AxCloud SDK Types
  *
  * Note: In the future, these types should be auto-generated from the OpenAPI spec.
  * For now, they are manually defined based on the AxCloud API.
  */
+
 type AxCloudModule = 'content' | 'members' | 'sections' | 'training' | 'ai' | 'documents' | 'voting';
 type SystemRole = 'super_admin' | 'org_admin' | 'section_admin' | 'member' | 'viewer';
 type UserRole = SystemRole | 'superadmin' | 'admin' | 'editor';
@@ -292,11 +337,15 @@ interface AxCloudConfig {
     stage: string;
     /** API key for public content endpoints (optional - required for public API access) */
     apiKey?: string;
+    /** Optional privacy-safe web analytics collection. */
+    analytics?: AxCloudAnalyticsOptions;
     auth0: {
         domain: string;
         clientId: string;
         redirectUri: string;
         audience?: string;
+        /** Auth0 Organization ID. Use this for invite-only member sites. */
+        organization?: string;
         /** Database connection name for password operations. Defaults to 'Username-Password-Authentication' */
         connection?: string;
     };
@@ -387,11 +436,35 @@ interface DocumentItem {
     created_at: string;
     updated_at: string;
     published_at?: string;
+    /** Section IDs this document is scoped to (member endpoint only). */
+    section_ids?: string[];
+    /** Display name of the member who uploaded the document (member endpoint only). */
+    uploaded_by_name?: string;
+    /** Folder IDs this document belongs to (member endpoint only). */
+    folder_ids?: string[];
 }
 interface DocumentListResponse {
     items: DocumentItem[];
     count: number;
 }
+/**
+ * A document folder the current member is allowed to see.
+ *
+ * Members receive folders for their own sections plus org-level folders
+ * (`section_id === null`). Returned by the member document-folders endpoint.
+ */
+interface DocumentFolder {
+    id: string;
+    /** Section this folder belongs to, or `null` for org-level folders. */
+    section_id: string | null;
+    /** Parent folder for nesting, or `null` for a top-level folder. */
+    parent_folder_id: string | null;
+    name: string;
+    sort_order: number;
+}
+interface DocumentFolderListResponse {
+    folders: DocumentFolder[];
+}
 interface SignedDocumentUrl {
     documentId: string;
     url: string;
@@ -403,6 +476,8 @@ interface DocumentQueryOptions {
     search?: string;
     tags?: string[];
     limit?: number;
+    /** Restrict results to documents belonging to this folder (member endpoint only). */
+    folderId?: string;
 }
 
 interface BarnsportMunicipality {
@@ -416,12 +491,29 @@ interface BarnsportMunicipality {
         bounds?: [number, number, number, number];
     };
 }
+interface BarnsportSportArticle {
+    short_description?: string;
+    what_is_it?: string;
+    why_fun?: string;
+    good_to_know?: {
+        age?: string;
+        equipment?: string;
+        cost?: string;
+    };
+    fun_facts?: string[];
+}
 interface BarnsportSport {
     id: string;
     slug: string;
     name: string;
     icon?: string;
     color?: string;
+    category?: string;
+    is_featured?: boolean;
+    hero_image_url?: string;
+    short_description?: string;
+    /** Present on the single-sport endpoint (GET /public/{orgId}/sports/{slug}). */
+    article?: BarnsportSportArticle;
 }
 interface BarnsportActivitySchedule {
     weekday?: number;
@@ -881,11 +973,15 @@ interface AxCloudProviderProps {
     stage?: string;
     /** API key for public content endpoints */
     apiKey?: string;
+    /** Optional privacy-safe analytics collection through AxCloud. */
+    analytics?: AxCloudAnalyticsOptions;
     auth0: {
         domain: string;
         clientId: string;
         redirectUri: string;
         audience?: string;
+        /** Auth0 Organization ID. Use this for invite-only member sites. */
+        organization?: string;
         /** Database connection name for password operations. Defaults to 'Username-Password-Authentication' */
         connection?: string;
     };
@@ -907,14 +1003,15 @@ interface AxCloudProviderProps {
  *   auth0={{
  *     domain: "auth.axcloud.app",
  *     clientId: "xxx",
- *     redirectUri: window.location.origin
+ *     redirectUri: window.location.origin,
+ *     organization: "org_abc123" // Optional Auth0 Organization ID for invite-only member sites
  *   }}
  * >
  *   <App />
  * </AxCloudProvider>
  * ```
  */
-declare function AxCloudProvider({ children, orgId, apiUrl, stage, apiKey, auth0, queryClient, timeout, }: AxCloudProviderProps): react_jsx_runtime.JSX.Element;
+declare function AxCloudProvider({ children, orgId, apiUrl, stage, apiKey, analytics, auth0, queryClient, timeout, }: AxCloudProviderProps): react_jsx_runtime.JSX.Element;
 
 interface AxCloudContextValue {
     config: AxCloudConfig;
@@ -924,20 +1021,35 @@ interface AxCloudContextValue {
     stage: string;
     /** Whether using public API mode (API key, no auth) */
     isPublicMode: boolean;
+    analytics: AnalyticsRuntime;
 }
 declare function useAxCloudContext(): AxCloudContextValue;
 
+type AnalyticsRuntimeConfig = Pick<AxCloudConfig, 'analytics' | 'apiUrl' | 'orgId' | 'stage'>;
+declare function useAnalyticsRuntime(config: AnalyticsRuntimeConfig): AnalyticsRuntime;
+declare function useAnalytics(): AnalyticsRuntime;
+
 interface AuthUser {
     id: string;
     email: string;
     name: string;
     avatar?: string;
+    /** Auth0's authoritative email verification claim. */
+    emailVerified?: boolean;
+}
+interface EmailVerificationResult {
+    success: boolean;
+    status: 'sent' | 'already_verified' | 'rate_limited' | 'failed';
+    message: string;
+    retryAfterSeconds?: number;
 }
 interface UseAuthReturn {
     isAuthenticated: boolean;
     isLoading: boolean;
     error: Error | undefined;
     user: AuthUser | null;
+    /** True only when Auth0 explicitly reports email_verified=false. */
+    needsEmailVerification: boolean;
     login: (options?: {
         returnTo?: string;
     }) => Promise<void>;
@@ -946,6 +1058,12 @@ interface UseAuthReturn {
     }) => Promise<void>;
     getAccessToken: () => Promise<string | undefined>;
     getAuth0Client: () => Auth0ClientState;
+    /** Refresh Auth0 tokens/profile and return the latest email verification state. */
+    refreshUser: () => Promise<boolean>;
+    /** Send a branded verification email that returns to the current product site. */
+    requestEmailVerification: (options?: {
+        returnTo?: string;
+    }) => Promise<EmailVerificationResult>;
     /** Request a password reset email for the current user or specified email */
     requestPasswordReset: (email?: string) => Promise<{
         success: boolean;
@@ -1711,6 +1829,58 @@ declare function useDocumentDownload(documentId: string | undefined): {
     error: Error | null;
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<SignedDocumentUrl, Error>>;
 };
+/**
+ * List documents the current member is allowed to see.
+ *
+ * Hits the member endpoint (`/documents/members/...`) which is NOT a
+ * `/public/` path, so the core client automatically attaches the member's
+ * `Authorization: Bearer <JWT>` header instead of the public API key.
+ *
+ * Returns public documents plus members/internal documents and section
+ * documents for the member's sections. Items include `section_ids` and
+ * uploader metadata (`uploaded_by_name`, `created_at`).
+ */
+declare function useMemberDocuments(options?: DocumentQueryOptions): {
+    documents: DocumentItem[];
+    items: DocumentItem[];
+    count: number;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<DocumentListResponse, Error>>;
+};
+/**
+ * List the document folders the current member is allowed to see.
+ *
+ * Hits the member endpoint (`/documents/members/${orgId}/document-folders`),
+ * which is NOT a `/public/` path, so the core client attaches the member's
+ * `Authorization: Bearer <JWT>` header instead of the public API key.
+ *
+ * Returns the member's section folders plus org-level folders
+ * (`section_id === null`). Use the returned folder ids with
+ * `useMemberDocuments({ folderId })` to scope a document list.
+ */
+declare function useMemberDocumentFolders(): {
+    folders: DocumentFolder[];
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<DocumentFolderListResponse, Error>>;
+};
+/**
+ * Fetch a short-lived signed download URL for a member-accessible document.
+ */
+declare function useMemberDocumentDownload(documentId: string | undefined): {
+    url: string | null;
+    documentUrl: string | null;
+    filename: string | null;
+    mimeType: string | null;
+    expiresIn: number | null;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<SignedDocumentUrl, Error>>;
+};
 
 declare function useBarnsportMunicipalities(): {
     municipalities: BarnsportMunicipality[];
@@ -1728,6 +1898,15 @@ declare function useBarnsportSports(): {
     error: Error | null;
     refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<BarnsportListResponse<BarnsportSport>, Error>>;
 };
+declare function useBarnsportSport(slug: string | undefined): {
+    sport: BarnsportSport | null;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<{
+        sport: BarnsportSport;
+    }, Error>>;
+};
 declare function useBarnsportActivities(filters?: BarnsportActivitiesFilter): {
     activities: BarnsportActivityListItem[];
     count: number;
@@ -1979,4 +2158,4 @@ interface LinkedAccountsListProps {
  */
 declare function LinkedAccountsList({ providers, showConnectButtons, className, onUnlink, onLinkInitiated, renderIdentity, renderAvailableProvider, }: LinkedAccountsListProps): react_jsx_runtime.JSX.Element;
 
-export { type AvailableProvider, AxCloudClient, type AxCloudConfig, AxCloudError, type AxCloudErrorCode, type AxCloudModule, AxCloudProvider, type Ballot, type BallotCandidate, type BallotOption, type BallotSeat, type BarnsportActivitiesFilter, type BarnsportActivity, type BarnsportActivityListItem, type BarnsportActivityLocation, type BarnsportActivityResponse, type BarnsportActivitySchedule, type BarnsportInterestSubmissionRequest, type BarnsportInterestSubmissionResponse, type BarnsportListResponse, type BarnsportMunicipality, type BarnsportRegistrationMethod, type BarnsportSitemapResponse, type BarnsportSitemapUrl, type BarnsportSport, type BaseRole, type CastVoteResult, type CodeEligibility, type ContentItem, type ContentQueryOptions, type ContentSlotImage, type ContentSlotMap, type ContentSlotReader, type ContentSlotValue, type CustomRole, type DocumentAudience, type DocumentItem, type DocumentListResponse, type DocumentQueryOptions, type DocumentSourceProvider, type DocumentStatus, type FormStatsResponse, type FormSubmission, type FormSubmissionRecord, type FormSubmissionResponse, type FormSubmissionsResponse, LinkedAccountsList, type LinkedAccountsListProps, type LinkedIdentity, LoginButton, LogoutButton, type MediaItem, type MediaListResponse, type Membership, ModuleGate, type NewsItem, type Organization, type OrganizationBranding, type OrganizationSettings, type Page, type PageContentState, type PaginatedResponse, ProtectedRoute, type Section, type SectionPermissions, type SignedDocumentUrl, type SignedMediaUrl, type SystemRole, type UseLinkedAccountsReturn, type User, type UserRole, type VoteReceipt, castVote, castVoteWithCode, checkEligibility, checkVotingCode, createClient, createContentSlotReader, createFormHelper, getBallot, getClient, getContentSlotMap, getVotingReceipt, isAxCloudError, submitForm, useAuth, useAvatar, useAxCloudContext, useBarnsportActivities, useBarnsportActivity, useBarnsportMunicipalities, useBarnsportSitemap, useBarnsportSports, useBranding, useCodeBallot, useContent, useContentItem, useDocumentDownload, useDocuments, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useSubmitBarnsportInterest, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };
+export { type AnalyticsEventData, type AnalyticsEventValue, type AnalyticsPublicConfig, type AnalyticsRuntime, type AnalyticsRuntimeConfig, type Auth0ClientState, type AuthUser, type AvailableProvider, type AxCloudAnalyticsOptions, AxCloudClient, type AxCloudConfig, AxCloudError, type AxCloudErrorCode, type AxCloudModule, AxCloudProvider, type Ballot, type BallotCandidate, type BallotOption, type BallotSeat, type BarnsportActivitiesFilter, type BarnsportActivity, type BarnsportActivityListItem, type BarnsportActivityLocation, type BarnsportActivityResponse, type BarnsportActivitySchedule, type BarnsportInterestSubmissionRequest, type BarnsportInterestSubmissionResponse, type BarnsportListResponse, type BarnsportMunicipality, type BarnsportRegistrationMethod, type BarnsportSitemapResponse, type BarnsportSitemapUrl, type BarnsportSport, type BaseRole, type CastVoteResult, type CodeEligibility, type ContentItem, type ContentQueryOptions, type ContentSlotImage, type ContentSlotMap, type ContentSlotReader, type ContentSlotValue, type CustomRole, type DocumentAudience, type DocumentFolder, type DocumentFolderListResponse, type DocumentItem, type DocumentListResponse, type DocumentQueryOptions, type DocumentSourceProvider, type DocumentStatus, type EmailVerificationResult, type FormStatsResponse, type FormSubmission, type FormSubmissionRecord, type FormSubmissionResponse, type FormSubmissionsResponse, LinkedAccountsList, type LinkedAccountsListProps, type LinkedIdentity, LoginButton, LogoutButton, type MediaItem, type MediaListResponse, type Membership, ModuleGate, type NewsItem, type Organization, type OrganizationBranding, type OrganizationSettings, type Page, type PageContentState, type PaginatedResponse, ProtectedRoute, type Section, type SectionPermissions, type SignedDocumentUrl, type SignedMediaUrl, type SystemRole, type UseAuthReturn, type UseLinkedAccountsReturn, type User, type UserRole, type VoteReceipt, castVote, castVoteWithCode, checkEligibility, checkVotingCode, createClient, createContentSlotReader, createFormHelper, fetchAnalyticsPublicConfig, getBallot, getClient, getContentSlotMap, getVotingReceipt, isAllowedAnalyticsEvent, isAxCloudError, isLocalAnalyticsHostname, sanitizeAnalyticsEventData, sanitizeAnalyticsPath, submitForm, useAnalytics, useAnalyticsRuntime, useAuth, useAvatar, useAxCloudContext, useBarnsportActivities, useBarnsportActivity, useBarnsportMunicipalities, useBarnsportSitemap, useBarnsportSport, useBarnsportSports, useBranding, useCodeBallot, useContent, useContentItem, useDocumentDownload, useDocuments, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useMemberDocumentDownload, useMemberDocumentFolders, useMemberDocuments, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useSubmitBarnsportInterest, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };