placementt-core 11.0.533 → 11.0.892

package/lib/hooks.d.ts

@@ -1,6 +1,5 @@
-import { DocumentData, QueryConstraint, QueryDocumentSnapshot } from "firebase/firestore";
-import { ApplicantStage, ApplicantWorkflow, Application, ArrowObject, CohortData, FileItem, FlagCodes, InstituteData, OnboardingDocs, PlacementListing, Products, ProviderData, QueryObject, SavedPlacement, StudentPlacementData, UserData, UserGroupData, WorkflowStage } from "./typeDefinitions";
-import { OrganisationAddress } from "placementt-core";
+import { DocumentData, QueryConstraint, QueryDocumentSnapshot, QueryFieldFilterConstraint } from "firebase/firestore";
+import { AlumniConvoUser, ApplicantStage, Application, ArrowObject, CohortData, CustomFormSchema, FileItem, FlagCodes, InstituteData, OnboardingDocs, PlacementListing, Products, ProviderData, QueryObject, QueryObjectConstraint, Sorts, StudentPlacementData, UserData, UserGroupData, WorkflowStage } from "./typeDefinitions";
 type StudentPlacementListParams = {
     user: UserData;
     student?: UserData;
@@ -26,7 +25,17 @@ type InstitutePlacementParams = {
     ql?: number;
     inProgress?: boolean;
 };
-export declare function useNewInstitutePlacementList({ id, user, cohort, queryConstraint, ql, inProgress }: InstitutePlacementParams): {
+type NewInstitutePlacementParams = {
+    id?: string;
+    user: UserData;
+    cohort?: string;
+    queryConstraints?: QueryObjectConstraint;
+    ql?: number;
+    inProgress?: boolean;
+    view: "list" | "table";
+    filters?: FilterObject;
+};
+export declare function useOldInstitutePlacementList({ id, user, cohort, queryConstraint, ql, inProgress }: InstitutePlacementParams): {
     placements: {
         [key: string]: StudentPlacementData & {
             student: UserData;
@@ -39,7 +48,60 @@ export declare function useNewInstitutePlacementList({ id, user, cohort, queryCo
     reset: () => void;
     changeQueryConstraints: (e: QueryConstraint[]) => void;
 };
-export declare function useOldInstitutePlacementList({ user, cohort, queryConstraint, ql }: InstitutePlacementParams): {
+export declare function useNewInstitutePlacementList({ id, user, filters, view, cohort, queryConstraints, ql, inProgress }: NewInstitutePlacementParams): {
+    tableData: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
+    page: number;
+    loading: boolean | "loaded";
+    updateSearch: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
+    setFilters: import("react").Dispatch<import("react").SetStateAction<FilterObject | undefined>>;
+    setView: import("react").Dispatch<import("react").SetStateAction<"table" | "list">>;
+    pageUp: () => void;
+    pageDown: () => void;
+    sorts: {
+        [label: string]: {
+            value: string;
+            direction: "asc" | "desc";
+        };
+    };
+    updateSort: (sortLabel: string) => void;
+    sort: [string, {
+        value: string;
+        direction: "asc" | "desc";
+    }] | undefined;
+};
+type AlumniPaginatorParams = {
+    user?: UserData;
+    alumniConvoUser?: AlumniConvoUser;
+    school?: string;
+    queryConstraints?: QueryObjectConstraint;
+    ql?: number;
+    view: "list" | "table";
+    filters?: FilterObject;
+};
+export declare function useAlumniPaginator({ user, alumniConvoUser, filters, view, school, queryConstraints, ql }: AlumniPaginatorParams): {
+    tableData: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
+    page: number;
+    loading: boolean | "loaded";
+    setFilters: import("react").Dispatch<import("react").SetStateAction<FilterObject | undefined>>;
+    setView: import("react").Dispatch<import("react").SetStateAction<"table" | "list">>;
+    pageUp: () => void;
+    pageDown: () => void;
+    sorts: {
+        [label: string]: {
+            value: string;
+            direction: "asc" | "desc";
+        };
+    };
+};
+export declare function useVeryOldInstitutePlacementList({ user, cohort, queryConstraint, ql }: InstitutePlacementParams): {
     placements: {
         [key: string]: StudentPlacementData & {
             student: UserData;
@@ -70,20 +132,23 @@ export declare function useFilterTablePaginator({ data }: {
     } | undefined>>;
     page: number[];
 };
-export declare function usePlacementListingPaginator({ data, user }: {
+export declare function useProviderContactPaginator({ data, user, view, filters }: {
     data: QueryObject[];
     user: UserData;
+    view: "list" | "table";
+    filters?: FilterObject;
 }): {
     tableData: {
-        [key: string]: PlacementListing & {
-            savedPlacement: SavedPlacement;
+        [key: string]: {
+            [key: string]: unknown;
         };
     };
-    setPage: import("react").Dispatch<import("react").SetStateAction<number[]>>;
-    setFilters: import("react").Dispatch<import("react").SetStateAction<{
-        [key: string]: unknown;
-    } | undefined>>;
-    page: number[];
+    pageUp: () => void;
+    pageDown: () => void;
+    setFilters: import("react").Dispatch<import("react").SetStateAction<FilterObject | undefined>>;
+    page: number;
+    setView: import("react").Dispatch<import("react").SetStateAction<"table" | "list">>;
+    loading: boolean | "loaded";
 };
 type UserPaginatorParams = {
     user: UserData;
@@ -91,8 +156,9 @@ type UserPaginatorParams = {
     data: QueryObject[];
     search?: string;
     userType: "Staff" | "Students";
+    sort?: string;
 };
-export declare function useCohortUserPaginator({ user, cohort, data, search, userType }: UserPaginatorParams): {
+export declare function useCohortUserPaginator({ user, cohort, data, search, userType, sort }: UserPaginatorParams): {
     tableData: {
         [key: string]: {
             [key: string]: unknown;
@@ -103,6 +169,9 @@ export declare function useCohortUserPaginator({ user, cohort, data, search, use
     setFilters: import("react").Dispatch<import("react").SetStateAction<{
         [key: string]: unknown;
     } | undefined>>;
+    setSort: (s: string) => void;
+    sortOptions: string[];
+    sortBy: string | undefined;
 };
 export declare function useAdmissionsPaginator({ data }: {
     data: {
@@ -141,162 +210,6 @@ export declare function useLazyLoadQueryList({ path, constraints, number, onItem
     loadMoreIcon: boolean;
     reset: () => void;
 };
-type PublicPlacementListingLoaderParams = {
-    providerId?: string;
-    number: number;
-};
-export declare function usePublicPlacementListingLoader({ providerId, number }: PublicPlacementListingLoaderParams): {
-    items: {
-        [key: string]: {
-            [key: string]: unknown;
-        };
-    };
-    loadMore: () => Promise<void>;
-    loadMoreIcon: boolean;
-    reset: () => void;
-};
-export type ApplicationHookParams = {
-    successText: {
-        submitted: {
-            title: string;
-            desc: string;
-        };
-        draftSaved: {
-            title: string;
-            desc: string;
-        };
-        stageComplete: {
-            title: string;
-            desc: string;
-        };
-        outcome: {
-            title: string;
-            desc: string;
-        };
-    };
-    setSuccessPopup: import("react").Dispatch<import("react").SetStateAction<"submitted" | "draftSaved" | "stageComplete" | "outcome" | undefined>>;
-    openSuccessPopup: (type: "submitted" | "draftSaved" | "stageComplete" | "outcome") => void;
-    setFApplication: import("react").Dispatch<import("react").SetStateAction<Partial<Application>>>;
-    fApplication: Partial<Application>;
-    draftSaved: boolean;
-    profileUrl: string | undefined;
-    successPopup: "submitted" | "draftSaved" | "stageComplete" | "outcome" | undefined;
-    fApplicationId: string | undefined;
-    fListing: PlacementListing | undefined;
-    student: UserData | undefined;
-    fProvider: {
-        details?: ProviderData;
-        profile?: string;
-        id?: string;
-    } | undefined;
-    onFApply: (draft?: boolean) => Promise<void>;
-    setFormComplete: (formId: string, e: {
-        [key: string]: unknown;
-    }) => void;
-    viewFile: (file: string, onOpen: (url: string) => void) => void;
-    addFile: (files: string[], fileId: number) => void;
-    uploadedFiles?: {
-        [key: string]: FileItem;
-    };
-    getCurrentStage: (stage: number) => Promise<{
-        stage: ApplicantStage;
-        completedSections: {
-            submitted?: string | undefined;
-            filesViewed?: string[] | undefined;
-            formsCompleted?: {
-                [key: string]: unknown;
-            } | undefined;
-            filesUploaded?: {
-                [key: number]: string[];
-            } | undefined;
-        };
-    }>;
-    currentStageComplete?: boolean;
-    progressStage: (type: number | "accept" | "reject", e?: {
-        feedback?: string;
-    }) => Promise<void>;
-};
-export declare function useCreateApplicationRenderer({ user, listingId, listing, provider, application, applicationId, orgContext }: {
-    user: UserData;
-    listingId: string;
-    applicationId?: string;
-    listing?: PlacementListing;
-    application?: Partial<Application>;
-    orgContext?: {
-        details: ProviderData;
-        addresses: {
-            [key: string]: OrganisationAddress;
-        };
-        applicantWorkflows: {
-            [key: string]: ApplicantWorkflow;
-        };
-    };
-    provider?: {
-        details?: ProviderData;
-        profile?: string;
-        id?: string;
-    };
-}): {
-    successText: {
-        submitted: {
-            title: string;
-            desc: string;
-        };
-        draftSaved: {
-            title: string;
-            desc: string;
-        };
-        stageComplete: {
-            title: string;
-            desc: string;
-        };
-        outcome: {
-            title: string;
-            desc: string;
-        };
-    };
-    onFApply: (draft?: boolean) => Promise<void>;
-    progressStage: (type: number | "accept" | "reject", e?: {
-        feedback?: string;
-    }) => Promise<void>;
-    currentStageComplete: boolean | undefined;
-    uploadedFiles: {
-        [key: string]: FileItem;
-    } | undefined;
-    getCurrentStage: (stage: number) => Promise<{
-        stage: ApplicantStage;
-        completedSections: {
-            submitted?: string | undefined;
-            filesViewed?: string[] | undefined;
-            formsCompleted?: {
-                [key: string]: unknown;
-            } | undefined;
-            filesUploaded?: {
-                [key: number]: string[];
-            } | undefined;
-        };
-    }>;
-    setFormComplete: (formId: string, e: {
-        [key: string]: unknown;
-    }) => void;
-    viewFile: (file: string, onOpen: (url: string) => void) => void;
-    addFile: (files: string[], fileId: number) => void;
-    setSuccessPopup: import("react").Dispatch<import("react").SetStateAction<"submitted" | "draftSaved" | "stageComplete" | "outcome" | undefined>>;
-    openSuccessPopup: (type: "submitted" | "draftSaved" | "stageComplete" | "outcome") => void;
-    setFApplication: import("react").Dispatch<import("react").SetStateAction<Partial<Application>>>;
-    fApplication: Partial<Application>;
-    draftSaved: boolean;
-    profileUrl: string | undefined;
-    successPopup: "submitted" | "draftSaved" | "stageComplete" | "outcome" | undefined;
-    fApplicationId: string | undefined;
-    fListing: PlacementListing | undefined;
-    student: UserData | undefined;
-    fProvider: {
-        details?: ProviderData;
-        profile?: string;
-        id?: string;
-    } | undefined;
-};
 export declare function useProposePlacementRenderer({ user, orgContext, placement }: {
     user: UserData;
     orgContext?: {
@@ -325,7 +238,13 @@ export declare function useProposePlacementRenderer({ user, orgContext, placemen
     setBusinessSectionComplete: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setAddressSectionComplete: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setPlacementSectionComplete: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    proposePlacement: (draft?: boolean) => Promise<any>;
+    proposePlacement: (draft?: boolean) => Promise<{
+        status: {
+            active: boolean;
+            inProgress: boolean;
+            completed: boolean;
+        };
+    }>;
     deletePlacement: (id: string) => Promise<void>;
     setStudent: import("react").Dispatch<import("react").SetStateAction<UserData | undefined>>;
     submitSection: (type: "dates" | "provider" | "address", data: {
@@ -363,7 +282,7 @@ export declare function useCreateCohortRenderer({ oId, product, initialData }: C
 type UserUploadParams = {
     userType: "Staff" | "Students";
     user: UserData;
-    onComplete?: () => void;
+    onComplete?: (e: string) => void;
     cohortId?: string;
     userGroupId?: string;
     shareNameWithReferralLeaderboardConsent?: string;
@@ -433,7 +352,7 @@ export declare function useWorkflowEditor({ user, initialData, onSubmit, cohortI
     containerRef: import("react").RefObject<HTMLFormElement>;
     setError: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
     setArrows: import("react").Dispatch<import("react").SetStateAction<ArrowObject[]>>;
-    setWorkflowNodes: import("react").Dispatch<import("react").SetStateAction<ApplicantStage[] | WorkflowStage[]>>;
+    setWorkflowNodes: import("react").Dispatch<import("react").SetStateAction<WorkflowStage[] | ApplicantStage[]>>;
 };
 type ApplicantWorkflowEditorParams = {
     user: UserData;
@@ -483,23 +402,24 @@ export declare function useApplicantWorkflowEditor({ user, initialData, onSubmit
     setArrows: import("react").Dispatch<import("react").SetStateAction<ArrowObject[]>>;
     setWorkflowNodes: import("react").Dispatch<import("react").SetStateAction<ApplicantStage[]>>;
 };
-type InstitutePlacementListingUploadParams = {
+type InstituteProviderContactUploadParams = {
     user: UserData;
     onComplete?: () => void;
 };
-export type InstitutePlacementListingUpload = {
-    provider: string;
-    jobTitle: string;
+export type InstituteProviderContactUpload = {
+    business: string;
+    forename?: string;
+    surname?: string;
     email: string;
     phone?: string;
-    addressOne: string;
-    addressTwo: string;
-    city: string;
-    postcode: string;
-    country: string;
-};
-export declare function useInstitutePlacementListingHandler({ user }: InstitutePlacementListingUploadParams): {
-    uploadPlacements: (placements: InstitutePlacementListingUpload[]) => Promise<boolean>;
+    addressOne?: string;
+    addressTwo?: string;
+    city?: string;
+    postcode?: string;
+    country?: string;
+};
+export declare function useInstituteProviderContactsHandler({ user }: InstituteProviderContactUploadParams): {
+    uploadProviderContacts: (providers: InstituteProviderContactUpload[], schoolId?: string) => Promise<boolean>;
     alert: {
         severity: "warning" | "error" | "success" | "info";
         msg: string;
@@ -517,14 +437,25 @@ export declare function useGetIndividualPlacementForPlacementPage({ user, placem
     };
 }): {
     placement: StudentPlacementData | undefined;
-    wStage: WorkflowStage | undefined;
+    wStage: (WorkflowStage & {
+        files: {
+            [fileId: string]: {
+                name: string;
+                url: string;
+            };
+        };
+    }) | undefined;
     student: UserData | undefined;
     workflow: WorkflowStage[] | undefined;
     editable: boolean;
     withdrawFromPlacementPopup: boolean;
+    addOnboardingDocsPopup: boolean;
+    setAddOnboardingDocsPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    dismissOnboardingPopup: boolean;
+    setDismissOnboardingPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setWithdrawFromPlacementPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     withdrawFromPlacement: () => Promise<void>;
-    onFlagClick: (e: FlagCodes) => Promise<void>;
+    onFlagClick: (e: FlagCodes, onClose?: boolean) => Promise<void>;
     setUploadInsurance: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setUploadProviderDocPopup: import("react").Dispatch<import("react").SetStateAction<"insurance" | "riskAssessment" | "DbsCheck" | undefined>>;
     setUploadRA: import("react").Dispatch<import("react").SetStateAction<boolean>>;
@@ -535,7 +466,7 @@ export declare function useGetIndividualPlacementForPlacementPage({ user, placem
     setViewExternalLinkPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setOnboardingPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setRejectELIPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    eliURL: string;
+    eliData: string | undefined;
     riskAssessmentURL: string;
     dbsCheckURL: string;
     setExternalLinkCopied: import("react").Dispatch<import("react").SetStateAction<boolean>>;
@@ -579,11 +510,14 @@ export declare function useGetIndividualPlacementForPlacementPage({ user, placem
     }, type: "riskAssessment" | "dbsCheck") => Promise<void>;
     manuallyConfigureProvider: () => Promise<void>;
     institute: InstituteData | undefined;
+    shareStudentRequestPopup: boolean;
+    setShareStudentRequestPopup: import("react").Dispatch<import("react").SetStateAction<boolean>>;
 };
-export declare function useOnboardingPopup({ onboarding, placementId, user, onClose }: {
+export declare function useOnboardingPopup({ onboarding, providerId, placementId, user, onClose }: {
     onboarding: (OnboardingDocs & {
         completed: {
-            submitted: string | false;
+            submitted: boolean;
+            submittedDate?: string;
             accepted?: boolean;
             filesViewed?: string[];
             formsCompleted?: {
@@ -596,6 +530,7 @@ export declare function useOnboardingPopup({ onboarding, placementId, user, onCl
     });
     placementId: string;
     user: UserData;
+    providerId: string;
     onClose: () => void;
 }): {
     addFile: (files: string[]) => void;
@@ -615,7 +550,8 @@ export declare function useOnboardingPopup({ onboarding, placementId, user, onCl
     } | undefined>>;
     mOnboarding: OnboardingDocs & {
         completed: {
-            submitted: string | false;
+            submitted: boolean;
+            submittedDate?: string;
             accepted?: boolean;
             filesViewed?: string[];
             formsCompleted?: {
@@ -638,7 +574,8 @@ export declare function useOnboardingPopup({ onboarding, placementId, user, onCl
     }) => Promise<void>;
     rejectPopup: boolean;
     completedSections: {
-        submitted: string | false;
+        submitted: boolean;
+        submittedDate?: string;
         filesViewed?: string[] | undefined;
         formsCompleted?: {
             [key: string]: unknown;
@@ -649,5 +586,153 @@ export declare function useOnboardingPopup({ onboarding, placementId, user, onCl
     } | undefined;
     fileUploadPopup: number | false;
     setFileUploadPopup: import("react").Dispatch<import("react").SetStateAction<number | false>>;
+    viewableFiles: {
+        [key: string]: FileItem;
+    } | undefined;
+    formDetails: {
+        [key: string]: {
+            name: string;
+            id: string;
+            description?: string;
+            product: Products;
+            oId: string;
+            form: CustomFormSchema;
+        };
+    };
+};
+export declare function useLoadAddresses(user: UserData, limitItems?: number, queryConstraint?: QueryConstraint[], request?: boolean): {
+    addresses: {
+        [key: string]: import("placementt-core").Address & {
+            name?: string;
+            savedBy?: string[];
+            product: import("placementt-core").Products;
+            oId: string;
+            stage: import("placementt-core").OrganisationAddressStages;
+            additionalQuestions?: {
+                bikeStorage?: boolean;
+                kitchen?: boolean;
+                parking?: boolean;
+                disabledAccess?: boolean;
+            };
+            contacts?: {
+                firstAid?: {
+                    name?: string;
+                    phone?: string;
+                    email?: string;
+                    location?: string;
+                }[];
+                security?: {
+                    name?: string;
+                    phone?: string;
+                    email?: string;
+                    location?: string;
+                }[];
+                reception?: {
+                    name?: string;
+                    phone?: string;
+                    email?: string;
+                    location?: string;
+                }[];
+            };
+            primaryContactId?: string;
+            default?: boolean;
+            flags?: ("addressMissing" | "noPrimaryContact")[];
+        } & {
+            listings: number;
+        };
+    };
+    onScrollBottom: () => void;
+    loading: boolean;
+    changeQueryConstraints: (e: QueryConstraint[]) => void;
+};
+export declare function useLoadListings(user: UserData, queryConstraint?: QueryConstraint[], request?: boolean): {
+    listings: [string, PlacementListing & {
+        applicants?: number;
+        scheduled?: number;
+        active?: number;
+    }][];
+    onScrollBottom: () => void;
+    loading: boolean;
+    changeQueryConstraints: (e: QueryConstraint[]) => void;
+};
+export declare function useLoadProviderPlacements(user: UserData, queryConstraint?: QueryConstraint[], placementId?: string): {
+    placements: {
+        [k: string]: never;
+    };
+    onScrollBottom: () => void;
+    loading: boolean;
+    changeQueryConstraints: (e: QueryConstraint[]) => void;
+};
+export declare function useLoadApplications({ user, applicationType, listingId, queryConstraint }: {
+    user: UserData;
+    applicationType?: "all" | "actionRequired" | "awaitingStudent" | "closed";
+    listingId?: string;
+    queryConstraint?: QueryConstraint[];
+}): {
+    applications: [string, Application][];
+    type: "all" | "closed" | "actionRequired" | "awaitingStudent";
+    setType: import("react").Dispatch<import("react").SetStateAction<"all" | "closed" | "actionRequired" | "awaitingStudent">>;
+    onScrollBottom: () => void;
+    loading: boolean;
+    changeQueryConstraints: (e: QueryConstraint[]) => void;
+};
+export type FilterObject = {
+    [key: string]: {
+        label: string;
+        value?: unknown;
+        values?: {
+            [key: string | number]: string | {
+                label: string;
+                test: QueryFieldFilterConstraint;
+            };
+        };
+        type: "dropdown" | "string" | "number";
+    };
+};
+export type DataViewerPaginater = {
+    view: "list" | "table";
+    queryLimit?: number;
+    formatItems?: (key: string, item: any) => Promise<{
+        key: string;
+        item: any;
+    }> | {
+        key: string;
+        item: any;
+    };
+    snapshot?: boolean;
+    filters?: FilterObject;
+    onSearch?: boolean | ((search?: string, sort?: [string, {
+        value: string;
+        direction: "asc" | "desc";
+    }], page?: number, filters?: FilterObject, limit?: number) => Promise<{
+        [key: string]: any;
+    }>);
+    data?: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    } | QueryObject[];
+    additionalEntryProcessing?: (k: string, v: any) => Promise<any> | any;
+    sorts?: Sorts;
+};
+export declare function useDataViewerPaginator({ view: initialView, sorts, queryLimit, additionalEntryProcessing, formatItems, snapshot, filters: initialFilters, onSearch, data }: DataViewerPaginater): {
+    tableData: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
+    pageUp: () => void;
+    pageDown: () => void;
+    setFilters: import("react").Dispatch<import("react").SetStateAction<FilterObject | undefined>>;
+    page: number;
+    sorts: Sorts;
+    loading: boolean | "loaded";
+    sort: [string, {
+        value: string;
+        direction: "asc" | "desc";
+    }] | undefined;
+    updateSort: (sortLabel: string) => void;
+    setView: import("react").Dispatch<import("react").SetStateAction<"table" | "list">>;
+    updateSearch: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
 };
 export {};