@jobsearch-works/firestore-models 2.0.5 → 2.1.0

package/dist/index.d.mts

@@ -643,14 +643,118 @@ interface VacancySuggestion {
     createdAt?: Date | string;
 }
 
-type ClientStatus = "active" | "inactive";
+/**
+ * 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;
+    lastName: string;
+    middleName?: string;
+    preferredName?: string;
+    email: string;
+    phone: string;
+    address: string;
+    city: string;
+    suburb: string;
+    state: string;
+    zip: string;
+    country: string;
+    linkedIn?: string;
+    countryPhoneCode: string;
+    nationality: string;
+    dateOfBirth?: Date | string;
+    createdAt?: Date | string;
+    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;
@@ -677,6 +781,11 @@ interface ClientEmail {
     updatedAt?: Date | string;
 }
 
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/gmailTokens/{docId}
+ * @see Client - Parent document
+ */
 interface ClientGmailToken {
     readonly id?: string;
     accessToken: string;
@@ -685,12 +794,23 @@ interface ClientGmailToken {
     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;
@@ -702,55 +822,11 @@ interface ClientInterview {
     summary: 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"];
-};
-
-type JobCategory = keyof typeof jobClassifications;
-type JobTitle = (typeof jobClassifications)[JobCategory][number];
-type LocationId = (typeof locations)[number]["id"];
-interface ClientJobPreferences {
-    readonly id?: string;
-    clientId: string;
-    desiredPositions: JobTitle[];
-    categories: JobCategory[];
-    locations: LocationId[];
-    minSalary: number;
-    maxSalary?: number;
-    currency: string;
-    industries: string[];
-    createdAt: Date;
-    updatedAt: Date;
-}
-
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/logins/{docId}
+ * @see Client - Parent document
+ */
 interface ClientLogin {
     readonly id?: string;
     userId: string;
@@ -763,28 +839,11 @@ interface ClientLogin {
     updatedAt?: Date | string;
 }
 
-interface ClientPersonalData {
-    id?: string;
-    firstName: string;
-    lastName: string;
-    middleName?: string;
-    preferredName?: string;
-    email: string;
-    phone: string;
-    address: string;
-    city: string;
-    suburb: string;
-    state: string;
-    zip: string;
-    country: string;
-    linkedIn?: string;
-    countryPhoneCode: string;
-    nationality: string;
-    dateOfBirth?: Date | 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;
@@ -795,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;
@@ -823,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;

package/dist/index.d.ts

@@ -643,14 +643,118 @@ interface VacancySuggestion {
     createdAt?: Date | string;
 }
 
-type ClientStatus = "active" | "inactive";
+/**
+ * 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;
+    lastName: string;
+    middleName?: string;
+    preferredName?: string;
+    email: string;
+    phone: string;
+    address: string;
+    city: string;
+    suburb: string;
+    state: string;
+    zip: string;
+    country: string;
+    linkedIn?: string;
+    countryPhoneCode: string;
+    nationality: string;
+    dateOfBirth?: Date | string;
+    createdAt?: Date | string;
+    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;
@@ -677,6 +781,11 @@ interface ClientEmail {
     updatedAt?: Date | string;
 }
 
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/gmailTokens/{docId}
+ * @see Client - Parent document
+ */
 interface ClientGmailToken {
     readonly id?: string;
     accessToken: string;
@@ -685,12 +794,23 @@ interface ClientGmailToken {
     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;
@@ -702,55 +822,11 @@ interface ClientInterview {
     summary: 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"];
-};
-
-type JobCategory = keyof typeof jobClassifications;
-type JobTitle = (typeof jobClassifications)[JobCategory][number];
-type LocationId = (typeof locations)[number]["id"];
-interface ClientJobPreferences {
-    readonly id?: string;
-    clientId: string;
-    desiredPositions: JobTitle[];
-    categories: JobCategory[];
-    locations: LocationId[];
-    minSalary: number;
-    maxSalary?: number;
-    currency: string;
-    industries: string[];
-    createdAt: Date;
-    updatedAt: Date;
-}
-
+/**
+ * Subcollection document under Client
+ * Path: clients/{clientId}/logins/{docId}
+ * @see Client - Parent document
+ */
 interface ClientLogin {
     readonly id?: string;
     userId: string;
@@ -763,28 +839,11 @@ interface ClientLogin {
     updatedAt?: Date | string;
 }
 
-interface ClientPersonalData {
-    id?: string;
-    firstName: string;
-    lastName: string;
-    middleName?: string;
-    preferredName?: string;
-    email: string;
-    phone: string;
-    address: string;
-    city: string;
-    suburb: string;
-    state: string;
-    zip: string;
-    country: string;
-    linkedIn?: string;
-    countryPhoneCode: string;
-    nationality: string;
-    dateOfBirth?: Date | 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;
@@ -795,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;
@@ -823,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;

package/dist/index.js

@@ -687,9 +687,6 @@ var firestorePaths = {
   clients: {
     collection: () => "clients",
     doc: (id) => `clients/${id}`,
-    personalData: (id) => `clients/${id}/personalData`,
-    jobPreferences: (id) => `clients/${id}/jobPreferences`,
-    websitePreferences: (id) => `clients/${id}/websitePreferences`,
     gmailTokens: (id) => `clients/${id}/gmailTokens`,
     emails: {
       collection: (clientId) => `clients/${clientId}/emails`,

package/dist/index.mjs

@@ -656,9 +656,6 @@ var firestorePaths = {
   clients: {
     collection: () => "clients",
     doc: (id) => `clients/${id}`,
-    personalData: (id) => `clients/${id}/personalData`,
-    jobPreferences: (id) => `clients/${id}/jobPreferences`,
-    websitePreferences: (id) => `clients/${id}/websitePreferences`,
     gmailTokens: (id) => `clients/${id}/gmailTokens`,
     emails: {
       collection: (clientId) => `clients/${clientId}/emails`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jobsearch-works/firestore-models",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "A shared library for standardizing Firestore document schemas and paths across multiple projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",