@jobsearch-works/firestore-models 2.0.4 → 2.1.0

package/dist/index.d.mts

@@ -1,244 +1,10 @@
-type AgentStatus = "active" | "inactive";
-interface Agent {
-    readonly id?: string;
-    readonly name: string;
-    readonly email: string;
-    readonly status: AgentStatus;
-    readonly profilePicture?: string;
-    readonly createdAt?: Date | string;
-    readonly updatedAt?: Date | string;
-}
-
-declare const ApplicationStatus: {
-    readonly New: "new";
-    readonly Submitted: "submitted";
-    readonly Interviewing: "interviewing";
-    readonly Accepted: "accepted";
-    readonly Rejected: "rejected";
-    readonly Withdrawn: "withdrawn";
-    readonly Applying: "applying";
-    readonly Suggested: "suggested";
-    readonly Approved: "approved";
-};
-type ApplicationStatus = (typeof ApplicationStatus)[keyof typeof ApplicationStatus];
-interface Application {
-    id?: string;
-    vacancyId: string;
-    clientId: string;
-    status: ApplicationStatus;
-    assignedTo?: string;
-    coverLetter?: string;
-    resume?: string;
-    submittedAt?: Date | string;
-    interviewingAt?: Date | string;
-    acceptedAt?: Date | string;
-    rejectedAt?: Date | string;
-    withdrawnAt?: Date | string;
-    applyingAt?: Date | string;
-    suggestedAt?: Date | string;
-    approvedAt?: Date | string;
-    company?: string;
-    position?: string;
-    location?: string;
-    jobId?: string;
-    advertisingUrl?: string;
-    applicationUrl?: string;
-    applicationDomain?: string;
-    advertisingDomain?: string;
-    description?: string;
-    fullPageText?: string;
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-type ApplicationQuestionType = "text" | "select";
-declare const ApplicationQuestionTypeOptions: readonly ApplicationQuestionType[];
-interface ApplicationQuestion {
-    id?: string;
-    questionText: string;
-    answerText?: string;
-    type: ApplicationQuestionType;
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-interface AuthUser {
-    id?: string;
-    email: string;
-    displayName?: string;
-    photoURL?: string;
-    lastSignIn?: string;
-    emailVerified?: boolean;
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-interface UserPublic {
-    id?: string;
-    displayName?: string;
-    photoURL?: string;
-    bio?: string;
-    location?: string;
-    website?: string;
-    socialLinks?: {
-        linkedin?: string;
-        github?: string;
-        twitter?: string;
-    };
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-declare const VacancyCategory: {
-    readonly Accounting: "Accounting";
-    readonly AdministrationAndOfficeSupport: "Administration & Office Support";
-    readonly AdvertisingArtsAndMedia: "Advertising, Arts & Media";
-    readonly BankingAndFinancialServices: "Banking & Financial Services";
-    readonly CallCentreAndCustomerService: "Call Centre & Customer Service";
-    readonly CEOAndGeneralManagement: "CEO & General Management";
-    readonly CommunityServicesAndDevelopment: "Community Services & Development";
-    readonly Construction: "Construction";
-    readonly ConsultingAndStrategy: "Consulting & Strategy";
-    readonly DesignAndArchitecture: "Design & Architecture";
-    readonly EducationAndTraining: "Education & Training";
-    readonly Engineering: "Engineering";
-    readonly FarmingAnimalsAndConservation: "Farming, Animals & Conservation";
-    readonly GovernmentAndDefence: "Government & Defence";
-    readonly HealthcareAndMedical: "Healthcare & Medical";
-    readonly HospitalityAndTourism: "Hospitality & Tourism";
-    readonly HumanResourcesAndRecruitment: "Human Resources & Recruitment";
-    readonly InformationAndCommunicationTechnology: "Information & Communication Technology";
-    readonly InsuranceAndSuperannuation: "Insurance & Superannuation";
-    readonly Legal: "Legal";
-    readonly ManufacturingTransportAndLogistics: "Manufacturing, Transport & Logistics";
-    readonly MarketingAndCommunications: "Marketing & Communications";
-    readonly MiningResourcesAndEnergy: "Mining, Resources & Energy";
-    readonly RealEstateAndProperty: "Real Estate & Property";
-    readonly RetailAndConsumerProducts: "Retail & Consumer Products";
-    readonly Sales: "Sales";
-    readonly ScienceAndTechnology: "Science & Technology";
-    readonly SelfEmployment: "Self Employment";
-    readonly SportAndRecreation: "Sport & Recreation";
-    readonly TradesAndServices: "Trades & Services";
-};
-type VacancyCategory = (typeof VacancyCategory)[keyof typeof VacancyCategory];
-interface Vacancy {
-    id?: string;
-    company: string;
-    position: string;
-    location: string;
-    description: string;
-    advertisingUrl: string;
-    applicationUrl: string;
-    applicationDomain: string;
-    advertisingDomain: string;
-    fullPageText: string;
-    jobId: string;
-    category: VacancyCategory;
-    suggestedTo?: string[];
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-interface VacancySuggestion {
-    readonly id?: string;
-    clientId: string;
-    vacancyId: string;
-    status: string;
-    createdAt?: Date | string;
-}
-
-type ClientStatus = "active" | "inactive";
-interface Client {
-    readonly id?: string;
-    readonly name: string;
-    readonly status: ClientStatus;
-    readonly createdAt?: Date | string;
-}
-
-interface ClientEmail {
-    id?: string;
-    messageId: string;
-    threadId?: string;
-    labelIds?: string[];
-    snippet?: string;
-    internalDate?: string;
-    payload?: {
-        headers?: Array<{
-            name: string;
-            value: string;
-        }>;
-        body?: {
-            data?: string;
-        };
-        parts?: Array<{
-            mimeType?: string;
-            body?: {
-                data?: string;
-            };
-        }>;
-    };
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-
-interface ClientGmailToken {
-    readonly id?: string;
-    accessToken: string;
-    refreshToken: string;
-    email: string;
-    useThisEmail: boolean;
-}
-
-interface ClientInitialQuestion {
-    readonly id?: string;
-    questionText: string;
-    answerText: string;
-}
-
-interface ClientInterview {
-    readonly id?: string;
-    company: string;
-    position: string;
-    type: string;
-    status: string;
-    transcript: string;
-    notes: string;
-    summary: string;
+interface Location {
+    id: string;
+    name: string;
+    country: string;
+    region: string;
+    tags: string[];
 }
-
-declare const jobClassifications: {
-    readonly Accounting: readonly ["Accounts Officers/Clerks", "Analysis & Reporting", "Assistant Accountants", "Audit - External", "Audit - Internal", "Bookkeeping & Small Practice Accounting", "Business Services & Corporate Advisory", "Company Secretaries", "Cost Accounting", "Financial Accounting & Reporting", "Financial Managers & Controllers", "Forensic Accounting & Investigation", "Insolvency & Corporate Recovery", "Management Accounting & Budgeting", "Payroll", "Strategy & Planning", "Systems Accounting", "Taxation", "Other"];
-    readonly "Administration & Office Support": readonly ["Administrative Assistants", "Client & Sales Administration", "Contracts Administration", "Data Entry & Word Processing", "Office Management", "PA, EA & Secretarial", "Receptionists", "Records Management & Document Control", "Other"];
-    readonly "Advertising, Arts & Media": readonly ["Agency Account Management", "Art Direction", "Copywriting", "Editing & Publishing", "Event Management", "Journalism & Writing", "Media Buying, Planning & Strategy", "Photography", "Programming & Production", "Promotions", "Sales & Account Management", "Other"];
-    readonly "Banking & Financial Services": readonly ["Analysis & Reporting", "Banking - Business", "Banking - Corporate & Institutional", "Banking - Retail/Branch", "Client Services", "Compliance & Risk", "Corporate Finance & Investment Banking", "Financial Planning", "Funds Management", "Investments", "Mortgages", "Settlements", "Stockbroking & Trading", "Treasury", "Other"];
-    readonly "Call Centre & Customer Service": readonly ["Customer Service - Call Centre", "Customer Service - Customer Facing", "Customer Service - Manager", "Customer Service - Supervisor", "Customer Service - Team Leader", "Other"];
-    readonly "Community Services & Development": readonly ["Aged & Disability Support", "Child Welfare, Youth & Family Services", "Community Development", "Employment Services", "Housing & Homelessness Services", "Indigenous & Multicultural Services", "Management", "Volunteer Coordination & Support", "Other"];
-    readonly Construction: readonly ["Contracts Management", "Estimating", "Foreperson/Supervisors", "Health & Safety", "Project Management", "Site Management", "Surveying", "Other"];
-    readonly "Consulting & Strategy": readonly ["Corporate Development", "Management & Change Consulting", "Policy & Planning", "Strategy & Planning", "Other"];
-    readonly "Design & Architecture": readonly ["Architecture", "Fashion & Textile Design", "Graphic Design", "Illustration & Animation", "Industrial Design", "Interior Design", "Landscape Architecture", "Urban Design & Planning", "Other"];
-    readonly "Education & Training": readonly ["Childcare & Outside School Hours Care", "Library Services & Information Management", "Management - Schools", "Management - Universities", "Management - Vocational", "Research & Fellowships", "Student Services", "Teaching - Early Childhood", "Teaching - Primary", "Teaching - Secondary", "Teaching - Tertiary", "Teaching - Vocational", "Teaching Aides & Special Needs", "Tutoring", "Workplace Training & Assessment", "Other"];
-    readonly Engineering: readonly ["Aerospace Engineering", "Automotive Engineering", "Chemical Engineering", "Civil/Structural Engineering", "Electrical/Electronic Engineering", "Engineering Drafting", "Environmental Engineering", "Field Engineering", "Industrial Engineering", "Maintenance", "Mechanical Engineering", "Mining - Engineering & Maintenance", "Project Engineering", "Systems Engineering", "Other"];
-    readonly "Farming, Animals & Conservation": readonly ["Agronomy & Farm Services", "Animal Welfare", "Conservation, Parks & Wildlife", "Farm Labour", "Fishing & Aquaculture", "Forestry & Logging", "Horticulture", "Veterinary Services & Animal Welfare", "Other"];
-    readonly "Government & Defence": readonly ["Air Force", "Army", "Emergency Services", "Federal Government", "Government - Local", "Government - State", "Navy", "Police & Corrections", "Policy, Planning & Regulation", "Security & Intelligence", "Other"];
-    readonly "Healthcare & Medical": readonly ["Aged Care Nursing", "Ambulance/Paramedics", "Chiropractic & Osteopathic", "Dental", "General Practitioners", "Medical Imaging", "Nursing - Aged Care", "Nursing - General Medical & Surgical", "Nursing - High Acuity", "Nursing - Management", "Nursing - Midwifery, Neo-Natal, SCN & NICU", "Nursing - Paediatric", "Nursing - Psych, Forensic & Correctional Health", "Nursing - Theatre & Recovery", "Nursing - Other", "Pharmacy", "Physiotherapy, OT & Rehabilitation", "Psychology, Counselling & Social Work", "Speech Therapy", "Other"];
-    readonly "Hospitality & Tourism": readonly ["Bar & Beverage Staff", "Chefs/Cooks", "Front Office & Guest Services", "Gaming", "Housekeeping", "Kitchen & Sandwich Hands", "Management", "Reservations", "Tour Guides", "Travel Agents/Consultants", "Waiting Staff", "Other"];
-    readonly "Human Resources & Recruitment": readonly ["Consulting & Generalist HR", "Industrial & Employee Relations", "Management - Agency", "Management - Internal", "Occupational Health & Safety", "Organisational Development", "Recruitment - Agency", "Recruitment - Internal", "Remuneration & Benefits", "Training & Development", "Other"];
-    readonly "Information & Communication Technology": readonly ["Architects", "Business/Systems Analysts", "Consultants", "Database Development & Administration", "Developers/Programmers", "Engineering - Hardware", "Engineering - Network", "Help Desk & IT Support", "Management", "Networks & Systems Administration", "Product Management & Development", "Project Management", "Security", "Software Engineering", "Team Leaders", "Technical Writers", "Testing & Quality Assurance", "Web Development & Production", "Other"];
-    readonly "Insurance & Superannuation": readonly ["Actuarial", "Brokerage", "Claims", "Fund Administration", "Investments", "Risk Consulting", "Superannuation", "Underwriting", "Other"];
-    readonly Legal: readonly ["Generalists - In-house", "Generalists - Private Practice", "Law Clerks & Paralegals", "Legal Secretaries", "Litigation & Dispute Resolution", "Other"];
-    readonly "Manufacturing, Transport & Logistics": readonly ["Assembly & Process Work", "Couriers, Drivers & Postal Services", "Fleet Management", "Import/Export & Customs", "Machine Operators", "Maintenance", "Pickers & Packers", "Plant & Machinery Operators", "Production, Planning & Scheduling", "Purchasing, Procurement & Inventory", "Rail & Maritime Transport", "Road Transport", "Warehousing, Storage & Distribution", "Other"];
-    readonly "Marketing & Communications": readonly ["Brand Management", "Digital & Search Marketing", "Event Management", "Internal Communications", "Market Research & Analysis", "Marketing Assistants/Coordinators", "Marketing Communications", "Marketing Management", "Product Management & Development", "Public Relations & Corporate Affairs", "Other"];
-    readonly "Mining, Resources & Energy": readonly ["Analysis & Reporting", "Engineering", "Health, Safety & Environment", "Maintenance", "Management", "Mining - Operations", "Oil & Gas - Engineering & Maintenance", "Oil & Gas - Operations", "Power Generation & Distribution", "Surveying", "Other"];
-    readonly "Real Estate & Property": readonly ["Analysts", "Body Corporate & Facilities Management", "Commercial Sales, Leasing & Property Mgmt", "Residential Leasing & Property Management", "Residential Sales", "Retail & Property Development", "Valuation", "Other"];
-    readonly "Retail & Consumer Products": readonly ["Buying", "Management - Department/Assistant", "Management - Store", "Merchandisers", "Retail Assistants", "Sales Representatives/Consultants", "Supervisors/Team Leaders", "Other"];
-    readonly Sales: readonly ["Account & Relationship Management", "Business Development", "Direct Sales", "Sales Coordinators", "Sales Management", "Sales Representatives/Consultants", "Telesales & Internal Sales", "Other"];
-    readonly "Science & Technology": readonly ["Biological & Biomedical Sciences", "Chemistry & Physics", "Environmental, Earth & Geosciences", "Food Technology & Safety", "Laboratory & Technical Services", "Mathematics, Statistics & Information Sciences", "Quality Assurance & Control", "Other"];
-    readonly "Self Employment": readonly ["Contract/Temp", "Franchise", "Home Business", "Other"];
-    readonly "Sport & Recreation": readonly ["Coaching & Instruction", "Fitness & Personal Training", "Management", "Other"];
-    readonly "Trades & Services": readonly ["Air Conditioning & Refrigeration", "Automotive Trades", "Bakers & Pastry Chefs", "Building Trades", "Butchers", "Carpentry & Cabinet Making", "Cleaning Services", "Electricians", "Fitters, Turners & Machinists", "Floristry", "Gardening & Landscaping", "Hair & Beauty Services", "Labourers", "Locksmiths", "Maintenance & Handyperson Services", "Nannies & Babysitters", "Painters & Sign Writers", "Plumbers", "Printing & Publishing Services", "Security Services", "Tailors & Dressmakers", "Technicians", "Welders & Boilermakers", "Other"];
-};
-
 declare const locations: readonly [{
     readonly id: "remote-anywhere";
     readonly name: "Remote (Anywhere)";
@@ -727,35 +493,224 @@ declare const locations: readonly [{
     readonly tags: readonly ["major-city", "business-hub", "financial", "expat-friendly"];
 }];
 
-type JobCategory = keyof typeof jobClassifications;
-type JobTitle = (typeof jobClassifications)[JobCategory][number];
-type LocationId = (typeof locations)[number]["id"];
-interface ClientJobPreferences {
+type AgentStatus = "active" | "inactive";
+interface Agent {
     readonly id?: string;
-    clientId: string;
-    desiredPositions: JobTitle[];
-    categories: JobCategory[];
-    locations: LocationId[];
-    minSalary: number;
-    maxSalary?: number;
-    currency: string;
-    industries: string[];
-    createdAt: Date;
-    updatedAt: Date;
+    readonly name: string;
+    readonly email: string;
+    readonly status: AgentStatus;
+    readonly profilePicture?: string;
+    readonly createdAt?: Date | string;
+    readonly updatedAt?: Date | string;
 }
 
-interface ClientLogin {
+declare const ApplicationStatus: {
+    readonly New: "new";
+    readonly Submitted: "submitted";
+    readonly Interviewing: "interviewing";
+    readonly Accepted: "accepted";
+    readonly Rejected: "rejected";
+    readonly Withdrawn: "withdrawn";
+    readonly Applying: "applying";
+    readonly Suggested: "suggested";
+    readonly Approved: "approved";
+};
+type ApplicationStatus = (typeof ApplicationStatus)[keyof typeof ApplicationStatus];
+interface Application {
+    id?: string;
+    vacancyId: string;
+    clientId: string;
+    status: ApplicationStatus;
+    assignedTo?: string;
+    coverLetter?: string;
+    resume?: string;
+    submittedAt?: Date | string;
+    interviewingAt?: Date | string;
+    acceptedAt?: Date | string;
+    rejectedAt?: Date | string;
+    withdrawnAt?: Date | string;
+    applyingAt?: Date | string;
+    suggestedAt?: Date | string;
+    approvedAt?: Date | string;
+    company?: string;
+    position?: string;
+    location?: string;
+    jobId?: string;
+    advertisingUrl?: string;
+    applicationUrl?: string;
+    applicationDomain?: string;
+    advertisingDomain?: string;
+    description?: string;
+    fullPageText?: string;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+type ApplicationQuestionType = "text" | "select";
+declare const ApplicationQuestionTypeOptions: readonly ApplicationQuestionType[];
+interface ApplicationQuestion {
+    id?: string;
+    questionText: string;
+    answerText?: string;
+    type: ApplicationQuestionType;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+interface AuthUser {
+    id?: string;
+    email: string;
+    displayName?: string;
+    photoURL?: string;
+    lastSignIn?: string;
+    emailVerified?: boolean;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+interface UserPublic {
+    id?: string;
+    displayName?: string;
+    photoURL?: string;
+    bio?: string;
+    location?: string;
+    website?: string;
+    socialLinks?: {
+        linkedin?: string;
+        github?: string;
+        twitter?: string;
+    };
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+declare const VacancyCategory: {
+    readonly Accounting: "Accounting";
+    readonly AdministrationAndOfficeSupport: "Administration & Office Support";
+    readonly AdvertisingArtsAndMedia: "Advertising, Arts & Media";
+    readonly BankingAndFinancialServices: "Banking & Financial Services";
+    readonly CallCentreAndCustomerService: "Call Centre & Customer Service";
+    readonly CEOAndGeneralManagement: "CEO & General Management";
+    readonly CommunityServicesAndDevelopment: "Community Services & Development";
+    readonly Construction: "Construction";
+    readonly ConsultingAndStrategy: "Consulting & Strategy";
+    readonly DesignAndArchitecture: "Design & Architecture";
+    readonly EducationAndTraining: "Education & Training";
+    readonly Engineering: "Engineering";
+    readonly FarmingAnimalsAndConservation: "Farming, Animals & Conservation";
+    readonly GovernmentAndDefence: "Government & Defence";
+    readonly HealthcareAndMedical: "Healthcare & Medical";
+    readonly HospitalityAndTourism: "Hospitality & Tourism";
+    readonly HumanResourcesAndRecruitment: "Human Resources & Recruitment";
+    readonly InformationAndCommunicationTechnology: "Information & Communication Technology";
+    readonly InsuranceAndSuperannuation: "Insurance & Superannuation";
+    readonly Legal: "Legal";
+    readonly ManufacturingTransportAndLogistics: "Manufacturing, Transport & Logistics";
+    readonly MarketingAndCommunications: "Marketing & Communications";
+    readonly MiningResourcesAndEnergy: "Mining, Resources & Energy";
+    readonly RealEstateAndProperty: "Real Estate & Property";
+    readonly RetailAndConsumerProducts: "Retail & Consumer Products";
+    readonly Sales: "Sales";
+    readonly ScienceAndTechnology: "Science & Technology";
+    readonly SelfEmployment: "Self Employment";
+    readonly SportAndRecreation: "Sport & Recreation";
+    readonly TradesAndServices: "Trades & Services";
+};
+type VacancyCategory = (typeof VacancyCategory)[keyof typeof VacancyCategory];
+interface Vacancy {
+    id?: string;
+    company: string;
+    position: string;
+    location: string;
+    description: string;
+    advertisingUrl: string;
+    applicationUrl: string;
+    applicationDomain: string;
+    advertisingDomain: string;
+    fullPageText: string;
+    jobId: string;
+    category: VacancyCategory;
+    suggestedTo?: string[];
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+interface VacancySuggestion {
     readonly id?: string;
-    userId: string;
-    url: string;
-    domain: string;
-    username?: string;
-    password: string;
-    email?: string;
+    clientId: string;
+    vacancyId: string;
+    status: string;
+    createdAt?: Date | string;
+}
+
+/**
+ * Embedded sub-object within Client document
+ * @see Client - Parent document interface
+ */
+interface ClientWebsitePreferences {
+    readonly id?: string;
+    theme: string;
+    notifications: string;
+}
+
+declare const jobClassifications: {
+    readonly Accounting: readonly ["Accounts Officers/Clerks", "Analysis & Reporting", "Assistant Accountants", "Audit - External", "Audit - Internal", "Bookkeeping & Small Practice Accounting", "Business Services & Corporate Advisory", "Company Secretaries", "Cost Accounting", "Financial Accounting & Reporting", "Financial Managers & Controllers", "Forensic Accounting & Investigation", "Insolvency & Corporate Recovery", "Management Accounting & Budgeting", "Payroll", "Strategy & Planning", "Systems Accounting", "Taxation", "Other"];
+    readonly "Administration & Office Support": readonly ["Administrative Assistants", "Client & Sales Administration", "Contracts Administration", "Data Entry & Word Processing", "Office Management", "PA, EA & Secretarial", "Receptionists", "Records Management & Document Control", "Other"];
+    readonly "Advertising, Arts & Media": readonly ["Agency Account Management", "Art Direction", "Copywriting", "Editing & Publishing", "Event Management", "Journalism & Writing", "Media Buying, Planning & Strategy", "Photography", "Programming & Production", "Promotions", "Sales & Account Management", "Other"];
+    readonly "Banking & Financial Services": readonly ["Analysis & Reporting", "Banking - Business", "Banking - Corporate & Institutional", "Banking - Retail/Branch", "Client Services", "Compliance & Risk", "Corporate Finance & Investment Banking", "Financial Planning", "Funds Management", "Investments", "Mortgages", "Settlements", "Stockbroking & Trading", "Treasury", "Other"];
+    readonly "Call Centre & Customer Service": readonly ["Customer Service - Call Centre", "Customer Service - Customer Facing", "Customer Service - Manager", "Customer Service - Supervisor", "Customer Service - Team Leader", "Other"];
+    readonly "Community Services & Development": readonly ["Aged & Disability Support", "Child Welfare, Youth & Family Services", "Community Development", "Employment Services", "Housing & Homelessness Services", "Indigenous & Multicultural Services", "Management", "Volunteer Coordination & Support", "Other"];
+    readonly Construction: readonly ["Contracts Management", "Estimating", "Foreperson/Supervisors", "Health & Safety", "Project Management", "Site Management", "Surveying", "Other"];
+    readonly "Consulting & Strategy": readonly ["Corporate Development", "Management & Change Consulting", "Policy & Planning", "Strategy & Planning", "Other"];
+    readonly "Design & Architecture": readonly ["Architecture", "Fashion & Textile Design", "Graphic Design", "Illustration & Animation", "Industrial Design", "Interior Design", "Landscape Architecture", "Urban Design & Planning", "Other"];
+    readonly "Education & Training": readonly ["Childcare & Outside School Hours Care", "Library Services & Information Management", "Management - Schools", "Management - Universities", "Management - Vocational", "Research & Fellowships", "Student Services", "Teaching - Early Childhood", "Teaching - Primary", "Teaching - Secondary", "Teaching - Tertiary", "Teaching - Vocational", "Teaching Aides & Special Needs", "Tutoring", "Workplace Training & Assessment", "Other"];
+    readonly Engineering: readonly ["Aerospace Engineering", "Automotive Engineering", "Chemical Engineering", "Civil/Structural Engineering", "Electrical/Electronic Engineering", "Engineering Drafting", "Environmental Engineering", "Field Engineering", "Industrial Engineering", "Maintenance", "Mechanical Engineering", "Mining - Engineering & Maintenance", "Project Engineering", "Systems Engineering", "Other"];
+    readonly "Farming, Animals & Conservation": readonly ["Agronomy & Farm Services", "Animal Welfare", "Conservation, Parks & Wildlife", "Farm Labour", "Fishing & Aquaculture", "Forestry & Logging", "Horticulture", "Veterinary Services & Animal Welfare", "Other"];
+    readonly "Government & Defence": readonly ["Air Force", "Army", "Emergency Services", "Federal Government", "Government - Local", "Government - State", "Navy", "Police & Corrections", "Policy, Planning & Regulation", "Security & Intelligence", "Other"];
+    readonly "Healthcare & Medical": readonly ["Aged Care Nursing", "Ambulance/Paramedics", "Chiropractic & Osteopathic", "Dental", "General Practitioners", "Medical Imaging", "Nursing - Aged Care", "Nursing - General Medical & Surgical", "Nursing - High Acuity", "Nursing - Management", "Nursing - Midwifery, Neo-Natal, SCN & NICU", "Nursing - Paediatric", "Nursing - Psych, Forensic & Correctional Health", "Nursing - Theatre & Recovery", "Nursing - Other", "Pharmacy", "Physiotherapy, OT & Rehabilitation", "Psychology, Counselling & Social Work", "Speech Therapy", "Other"];
+    readonly "Hospitality & Tourism": readonly ["Bar & Beverage Staff", "Chefs/Cooks", "Front Office & Guest Services", "Gaming", "Housekeeping", "Kitchen & Sandwich Hands", "Management", "Reservations", "Tour Guides", "Travel Agents/Consultants", "Waiting Staff", "Other"];
+    readonly "Human Resources & Recruitment": readonly ["Consulting & Generalist HR", "Industrial & Employee Relations", "Management - Agency", "Management - Internal", "Occupational Health & Safety", "Organisational Development", "Recruitment - Agency", "Recruitment - Internal", "Remuneration & Benefits", "Training & Development", "Other"];
+    readonly "Information & Communication Technology": readonly ["Architects", "Business/Systems Analysts", "Consultants", "Database Development & Administration", "Developers/Programmers", "Engineering - Hardware", "Engineering - Network", "Help Desk & IT Support", "Management", "Networks & Systems Administration", "Product Management & Development", "Project Management", "Security", "Software Engineering", "Team Leaders", "Technical Writers", "Testing & Quality Assurance", "Web Development & Production", "Other"];
+    readonly "Insurance & Superannuation": readonly ["Actuarial", "Brokerage", "Claims", "Fund Administration", "Investments", "Risk Consulting", "Superannuation", "Underwriting", "Other"];
+    readonly Legal: readonly ["Generalists - In-house", "Generalists - Private Practice", "Law Clerks & Paralegals", "Legal Secretaries", "Litigation & Dispute Resolution", "Other"];
+    readonly "Manufacturing, Transport & Logistics": readonly ["Assembly & Process Work", "Couriers, Drivers & Postal Services", "Fleet Management", "Import/Export & Customs", "Machine Operators", "Maintenance", "Pickers & Packers", "Plant & Machinery Operators", "Production, Planning & Scheduling", "Purchasing, Procurement & Inventory", "Rail & Maritime Transport", "Road Transport", "Warehousing, Storage & Distribution", "Other"];
+    readonly "Marketing & Communications": readonly ["Brand Management", "Digital & Search Marketing", "Event Management", "Internal Communications", "Market Research & Analysis", "Marketing Assistants/Coordinators", "Marketing Communications", "Marketing Management", "Product Management & Development", "Public Relations & Corporate Affairs", "Other"];
+    readonly "Mining, Resources & Energy": readonly ["Analysis & Reporting", "Engineering", "Health, Safety & Environment", "Maintenance", "Management", "Mining - Operations", "Oil & Gas - Engineering & Maintenance", "Oil & Gas - Operations", "Power Generation & Distribution", "Surveying", "Other"];
+    readonly "Real Estate & Property": readonly ["Analysts", "Body Corporate & Facilities Management", "Commercial Sales, Leasing & Property Mgmt", "Residential Leasing & Property Management", "Residential Sales", "Retail & Property Development", "Valuation", "Other"];
+    readonly "Retail & Consumer Products": readonly ["Buying", "Management - Department/Assistant", "Management - Store", "Merchandisers", "Retail Assistants", "Sales Representatives/Consultants", "Supervisors/Team Leaders", "Other"];
+    readonly Sales: readonly ["Account & Relationship Management", "Business Development", "Direct Sales", "Sales Coordinators", "Sales Management", "Sales Representatives/Consultants", "Telesales & Internal Sales", "Other"];
+    readonly "Science & Technology": readonly ["Biological & Biomedical Sciences", "Chemistry & Physics", "Environmental, Earth & Geosciences", "Food Technology & Safety", "Laboratory & Technical Services", "Mathematics, Statistics & Information Sciences", "Quality Assurance & Control", "Other"];
+    readonly "Self Employment": readonly ["Contract/Temp", "Franchise", "Home Business", "Other"];
+    readonly "Sport & Recreation": readonly ["Coaching & Instruction", "Fitness & Personal Training", "Management", "Other"];
+    readonly "Trades & Services": readonly ["Air Conditioning & Refrigeration", "Automotive Trades", "Bakers & Pastry Chefs", "Building Trades", "Butchers", "Carpentry & Cabinet Making", "Cleaning Services", "Electricians", "Fitters, Turners & Machinists", "Floristry", "Gardening & Landscaping", "Hair & Beauty Services", "Labourers", "Locksmiths", "Maintenance & Handyperson Services", "Nannies & Babysitters", "Painters & Sign Writers", "Plumbers", "Printing & Publishing Services", "Security Services", "Tailors & Dressmakers", "Technicians", "Welders & Boilermakers", "Other"];
+};
+
+/**
+ * Embedded sub-object within Client document
+ * @see Client - Parent document interface
+ */
+
+type JobCategory = keyof typeof jobClassifications;
+type JobTitle = (typeof jobClassifications)[JobCategory][number];
+type LocationId = (typeof locations)[number]["id"];
+interface ClientJobPreferences {
+    readonly id?: string;
+    clientId: string;
+    jobTitles: JobTitle[];
+    jobCategories: JobCategory[];
+    locations: LocationId[];
+    salaryExpectation?: number;
+    employmentTypes: string[];
+    remotePreference: 'remote' | 'hybrid' | 'office';
+    visaSponsorshipRequired: boolean;
     createdAt?: Date | string;
     updatedAt?: Date | string;
 }
 
+/**
+ * Embedded sub-object within Client document
+ * @see Client - Parent document interface
+ */
 interface ClientPersonalData {
     id?: string;
     firstName: string;
@@ -778,6 +733,117 @@ interface ClientPersonalData {
     updatedAt?: Date | string;
 }
 
+type ClientStatus = 'active' | 'inactive';
+/**
+ * Root Client document
+ * Path: clients/{clientId}
+ * Contains embedded sub-objects and references subcollections
+ * @see MODELS.md for complete relationship diagram
+ */
+interface Client {
+    readonly id?: string;
+    readonly name: string;
+    readonly status: ClientStatus;
+    readonly personalData?: ClientPersonalData;
+    readonly jobPreferences?: ClientJobPreferences;
+    readonly websitePreferences?: ClientWebsitePreferences;
+    readonly createdAt?: Date | string;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/emails/{docId}
+ * @see Client - Parent document
+ */
+interface ClientEmail {
+    id?: string;
+    messageId: string;
+    threadId?: string;
+    labelIds?: string[];
+    snippet?: string;
+    internalDate?: string;
+    payload?: {
+        headers?: Array<{
+            name: string;
+            value: string;
+        }>;
+        body?: {
+            data?: string;
+        };
+        parts?: Array<{
+            mimeType?: string;
+            body?: {
+                data?: string;
+            };
+        }>;
+    };
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/gmailTokens/{docId}
+ * @see Client - Parent document
+ */
+interface ClientGmailToken {
+    readonly id?: string;
+    accessToken: string;
+    refreshToken: string;
+    email: string;
+    useThisEmail: boolean;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/initialQuestions/{docId}
+ * @see Client - Parent document
+ */
+interface ClientInitialQuestion {
+    readonly id?: string;
+    questionText: string;
+    answerText: string;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/interviews/{docId}
+ * @see Client - Parent document
+ * @see Application - Related application
+ */
+interface ClientInterview {
+    readonly id?: string;
+    company: string;
+    position: string;
+    type: string;
+    status: string;
+    transcript: string;
+    notes: string;
+    summary: string;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/logins/{docId}
+ * @see Client - Parent document
+ */
+interface ClientLogin {
+    readonly id?: string;
+    userId: string;
+    url: string;
+    domain: string;
+    username?: string;
+    password: string;
+    email?: string;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+}
+
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/questions/{docId}
+ * @see Client - Parent document
+ */
 interface ClientQuestion {
     id?: string;
     questionText: string;
@@ -788,6 +854,16 @@ interface ClientQuestion {
     updatedAt?: Date | string;
 }
 
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/resumes/{docId}
+ * @see Client - Parent document
+ *
+ * @description Represents a client's resume document.
+ * @author [Your Name]
+ * @version 1.0.0
+ * @since [Date]
+ */
 interface ClientResume {
     readonly id?: string;
     title: string;
@@ -816,19 +892,10 @@ interface ClientResume {
     }>;
 }
 
-interface ClientWebsitePreferences {
-    readonly id?: string;
-    theme: string;
-    notifications: string;
-}
-
 declare const firestorePaths: {
     readonly clients: {
         readonly collection: () => string;
         readonly doc: (id: string) => string;
-        readonly personalData: (id: string) => string;
-        readonly jobPreferences: (id: string) => string;
-        readonly websitePreferences: (id: string) => string;
         readonly gmailTokens: (id: string) => string;
         readonly emails: {
             readonly collection: (clientId: string) => string;
@@ -885,4 +952,4 @@ declare const firestorePaths: {
     };
 };
 
-export { Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationStatus, AuthUser, Client, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientInterview, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientWebsitePreferences, JobCategory, JobTitle, LocationId, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, firestorePaths, jobClassifications, locations };
+export { Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationStatus, AuthUser, Client, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientInterview, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientWebsitePreferences, JobCategory, JobTitle, Location, LocationId, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, firestorePaths, jobClassifications, locations };