@thejob/schema 2.0.5 → 2.0.6

package/dist/index.d.cts

@@ -698,6 +698,368 @@ declare const JobSchema: ObjectSchema<{
 }, "">;
 type TJobSchema = InferType<typeof JobSchema>;
 
+/**
+ * Job classification taxonomy: category -> industry -> subCategory.
+ *
+ * Edit this file directly to change the taxonomy. The three views below cannot drift
+ * apart silently: JOB_TAXONOMY is typed against the enums, and TAXONOMY_LABELS is keyed
+ * by them, so adding a value without wiring it into both is a compile error.
+ *
+ * Values are lowercase snake_case constants, like every other enum in this package
+ * (EmploymentType, WorkMode, ExperienceLevel). They are what gets STORED and what the
+ * LLM must emit; the human-readable English label lives in TAXONOMY_LABELS, and each
+ * UI translates the constant for display rather than showing the stored string.
+ *
+ * Why constants and not the free text they replace: these are enforced as an `enum`
+ * in the Gemini response schema, which is structural. The previous free-text taxonomy
+ * relied on a prompt rule ("COPIED VERBATIM ... do NOT invent") and drifted anyway —
+ * production accumulated 115 distinct categories against 8 defined, and 848
+ * subCategories against 147.
+ */
+declare enum JobCategory {
+    TechnologyDataAndDigital = "technology_data_and_digital",
+    HealthcareAndLifeSciences = "healthcare_and_life_sciences",
+    AgricultureEnergyAndEnvironment = "agriculture_energy_and_environment",
+    FinanceBankingAndLegal = "finance_banking_and_legal",
+    ConstructionEngineeringAndTrades = "construction_engineering_and_trades",
+    MarketingMediaAndCreative = "marketing_media_and_creative",
+    LogisticsSalesAndOperations = "logistics_sales_and_operations",
+    EducationAndPublicService = "education_and_public_service",
+    HospitalityFoodAndTourism = "hospitality_food_and_tourism",
+    ManufacturingAndProduction = "manufacturing_and_production",
+    RetailAndConsumerServices = "retail_and_consumer_services",
+    AutomotiveAndTransportServices = "automotive_and_transport_services"
+}
+declare const SupportedJobCategories: JobCategory[];
+declare enum JobIndustry {
+    SoftwareAndWebDevelopment = "software_and_web_development",
+    DataAIAndAnalytics = "data_ai_and_analytics",
+    ITInfrastructureAndSecurity = "it_infrastructure_and_security",
+    ProductAndDesign = "product_and_design",
+    MedicalPractice = "medical_practice",
+    TherapyAndRehabilitation = "therapy_and_rehabilitation",
+    BioTechAndPharmaceuticals = "biotech_and_pharmaceuticals",
+    MentalHealth = "mental_health",
+    RenewableEnergy = "renewable_energy",
+    NaturalResourcesAndUtilities = "natural_resources_and_utilities",
+    AgricultureAndForestry = "agriculture_and_forestry",
+    EnvironmentalServices = "environmental_services",
+    BankingAndInvestments = "banking_and_investments",
+    FinTechAndInsurance = "fintech_and_insurance",
+    AccountingAndAudit = "accounting_and_audit",
+    LegalServices = "legal_services",
+    ArchitectureAndPlanning = "architecture_and_planning",
+    CivilAndIndustrialEngineering = "civil_and_industrial_engineering",
+    SkilledTrades = "skilled_trades",
+    MarketingAndAdvertising = "marketing_and_advertising",
+    MediaAndEntertainment = "media_and_entertainment",
+    CreativeArtsAndFashion = "creative_arts_and_fashion",
+    SupplyChainAndTransport = "supply_chain_and_transport",
+    SalesAndBusinessDevelopment = "sales_and_business_development",
+    HRAndAdmin = "hr_and_admin",
+    EducationAndTraining = "education_and_training",
+    GovernmentAndNonProfit = "government_and_non_profit",
+    FoodAndBeverageService = "food_and_beverage_service",
+    AccommodationAndTravel = "accommodation_and_travel",
+    ProductionAndAssembly = "production_and_assembly",
+    QualityAndProcess = "quality_and_process",
+    RetailOperations = "retail_operations",
+    CustomerService = "customer_service",
+    VehicleServiceAndRepair = "vehicle_service_and_repair",
+    DrivingAndTransport = "driving_and_transport"
+}
+declare const SupportedJobIndustries: JobIndustry[];
+declare enum JobSubCategory {
+    Frontend = "frontend",
+    Backend = "backend",
+    FullStack = "full_stack",
+    MobileAppDev = "mobile_app_dev",
+    GameDevelopment = "game_development",
+    EmbeddedSystems = "embedded_systems",
+    QAAndTesting = "qa_and_testing",
+    SoftwareEngineering = "software_engineering",
+    WebDevelopment = "web_development",
+    SoftwareArchitecture = "software_architecture",
+    DataScience = "data_science",
+    MachineLearning = "machine_learning",
+    ArtificialIntelligence = "artificial_intelligence",
+    BusinessIntelligence = "business_intelligence",
+    DataEngineering = "data_engineering",
+    DataVisualization = "data_visualization",
+    DataAnalysis = "data_analysis",
+    DeepLearning = "deep_learning",
+    Cybersecurity = "cybersecurity",
+    CloudEngineering = "cloud_engineering",
+    DevOps = "devops",
+    NetworkAdministration = "network_administration",
+    SystemsEngineering = "systems_engineering",
+    DatabaseAdministration = "database_administration",
+    ITSupport = "it_support",
+    TechnicalSupport = "technical_support",
+    SiteReliabilityEngineering = "site_reliability_engineering",
+    ProductManagement = "product_management",
+    UIUXDesign = "ui_ux_design",
+    UserResearch = "user_research",
+    InteractionDesign = "interaction_design",
+    TechnicalWriting = "technical_writing",
+    ProductMarketing = "product_marketing",
+    BusinessAnalysis = "business_analysis",
+    ProjectManagement = "project_management",
+    ProgramManagement = "program_management",
+    Nursing = "nursing",
+    GeneralPractice = "general_practice",
+    Surgery = "surgery",
+    Pediatrics = "pediatrics",
+    EmergencyMedicine = "emergency_medicine",
+    Radiology = "radiology",
+    Anesthesiology = "anesthesiology",
+    Geriatrics = "geriatrics",
+    Oncology = "oncology",
+    Dentistry = "dentistry",
+    DentalHygiene = "dental_hygiene",
+    MedicalSecretary = "medical_secretary",
+    Veterinary = "veterinary",
+    PhysicalTherapy = "physical_therapy",
+    OccupationalTherapy = "occupational_therapy",
+    SpeechPathology = "speech_pathology",
+    RespiratoryTherapy = "respiratory_therapy",
+    ElderlyCare = "elderly_care",
+    DisabilitySupport = "disability_support",
+    ClinicalResearch = "clinical_research",
+    DrugDevelopment = "drug_development",
+    Bioinformatics = "bioinformatics",
+    Microbiology = "microbiology",
+    Pharmacology = "pharmacology",
+    LaboratoryTech = "laboratory_tech",
+    Psychology = "psychology",
+    Counseling = "counseling",
+    Psychiatry = "psychiatry",
+    SocialWork = "social_work",
+    AddictionRecovery = "addiction_recovery",
+    ChildWelfare = "child_welfare",
+    SolarEnergy = "solar_energy",
+    WindPower = "wind_power",
+    Hydroelectric = "hydroelectric",
+    BatteryAndStorageTech = "battery_and_storage_tech",
+    Geothermal = "geothermal",
+    Biofuels = "biofuels",
+    OilAndGas = "oil_and_gas",
+    MiningAndGeology = "mining_and_geology",
+    NuclearEnergy = "nuclear_energy",
+    WaterManagement = "water_management",
+    ElectricalGridOperations = "electrical_grid_operations",
+    AgriTech = "agri_tech",
+    Horticulture = "horticulture",
+    LivestockManagement = "livestock_management",
+    Forestry = "forestry",
+    FisheriesAndAquaculture = "fisheries_and_aquaculture",
+    SoilScience = "soil_science",
+    SustainabilityConsulting = "sustainability_consulting",
+    WasteManagement = "waste_management",
+    WildlifeConservation = "wildlife_conservation",
+    CarbonAccounting = "carbon_accounting",
+    Ecology = "ecology",
+    OccupationalHealthAndSafety = "occupational_health_and_safety",
+    Sustainability = "sustainability",
+    InvestmentBanking = "investment_banking",
+    CorporateFinance = "corporate_finance",
+    WealthManagement = "wealth_management",
+    VentureCapital = "venture_capital",
+    AssetManagement = "asset_management",
+    FinancialAnalysis = "financial_analysis",
+    FinancialPlanning = "financial_planning",
+    RiskManagement = "risk_management",
+    CreditAnalysis = "credit_analysis",
+    CryptocurrencyAndWeb3 = "cryptocurrency_and_web3",
+    DigitalPayments = "digital_payments",
+    ActuarialScience = "actuarial_science",
+    InsuranceUnderwriting = "insurance_underwriting",
+    ClaimsAdjustment = "claims_adjustment",
+    PublicAccounting = "public_accounting",
+    Taxation = "taxation",
+    ForensicAccounting = "forensic_accounting",
+    AuditAndAssurance = "audit_and_assurance",
+    Bookkeeping = "bookkeeping",
+    AccountsPayable = "accounts_payable",
+    AccountsReceivable = "accounts_receivable",
+    Payroll = "payroll",
+    Collections = "collections",
+    CorporateLaw = "corporate_law",
+    Litigation = "litigation",
+    IntellectualProperty = "intellectual_property",
+    ComplianceAndRegulatory = "compliance_and_regulatory",
+    ParalegalServices = "paralegal_services",
+    Paralegal = "paralegal",
+    UrbanPlanning = "urban_planning",
+    InteriorDesign = "interior_design",
+    LandscapeArchitecture = "landscape_architecture",
+    CADBIMManagement = "cad_bim_management",
+    ConstructionManagement = "construction_management",
+    SiteSupervision = "site_supervision",
+    StructuralEngineering = "structural_engineering",
+    MechanicalEngineering = "mechanical_engineering",
+    ElectricalEngineering = "electrical_engineering",
+    RoboticsAndAutomation = "robotics_and_automation",
+    ChemicalEngineering = "chemical_engineering",
+    IndustrialEngineering = "industrial_engineering",
+    ProcessEngineering = "process_engineering",
+    Mechatronics = "mechatronics",
+    Electrician = "electrician",
+    PlumbingAndHVAC = "plumbing_and_hvac",
+    Carpentry = "carpentry",
+    Welding = "welding",
+    HeavyEquipmentOperation = "heavy_equipment_operation",
+    Masonry = "masonry",
+    Machining = "machining",
+    FacilitiesMaintenance = "facilities_maintenance",
+    DigitalMarketing = "digital_marketing",
+    SEOSEM = "seo_sem",
+    ContentStrategy = "content_strategy",
+    SocialMediaManagement = "social_media_management",
+    BrandManagement = "brand_management",
+    MarketResearch = "market_research",
+    MarketingStrategy = "marketing_strategy",
+    Journalism = "journalism",
+    VideoProduction = "video_production",
+    AnimationAndVFX = "animation_and_vfx",
+    AudioEngineering = "audio_engineering",
+    Photography = "photography",
+    Broadcasting = "broadcasting",
+    GraphicDesign = "graphic_design",
+    FineArts = "fine_arts",
+    FashionDesign = "fashion_design",
+    ApparelManufacturing = "apparel_manufacturing",
+    TextileDesign = "textile_design",
+    LogisticsManagement = "logistics_management",
+    Warehousing = "warehousing",
+    FleetOperations = "fleet_operations",
+    FreightForwarding = "freight_forwarding",
+    Procurement = "procurement",
+    Purchasing = "purchasing",
+    WarehouseOperations = "warehouse_operations",
+    FreightAndShipping = "freight_and_shipping",
+    EnterpriseSales = "enterprise_sales",
+    AccountManagement = "account_management",
+    RetailManagement = "retail_management",
+    RealEstateSales = "real_estate_sales",
+    CustomerSuccess = "customer_success",
+    SalesManagement = "sales_management",
+    SalesOperations = "sales_operations",
+    SalesSupport = "sales_support",
+    TechnicalSales = "technical_sales",
+    Recruiting = "recruiting",
+    CompensationAndBenefits = "compensation_and_benefits",
+    OfficeAdministration = "office_administration",
+    ExecutiveAssistance = "executive_assistance",
+    OrganizationalDevelopment = "organizational_development",
+    HROperations = "hr_operations",
+    TalentAcquisition = "talent_acquisition",
+    LearningAndDevelopment = "learning_and_development",
+    AdministrativeSupport = "administrative_support",
+    OfficeManagement = "office_management",
+    K12Teaching = "k_12_teaching",
+    HigherEducation = "higher_education",
+    SpecialEducation = "special_education",
+    ESLInstruction = "esl_instruction",
+    EdTech = "edtech",
+    CorporateTraining = "corporate_training",
+    PublicPolicy = "public_policy",
+    SocialServices = "social_services",
+    FundraisingAndGrants = "fundraising_and_grants",
+    LawEnforcement = "law_enforcement",
+    Military = "military",
+    Diplomacy = "diplomacy",
+    PublicAdministration = "public_administration",
+    RestaurantOperations = "restaurant_operations",
+    FoodPreparation = "food_preparation",
+    CulinaryArts = "culinary_arts",
+    BaristaAndBar = "barista_and_bar",
+    Catering = "catering",
+    FoodService = "food_service",
+    HotelOperations = "hotel_operations",
+    FrontDeskAndReception = "front_desk_and_reception",
+    Housekeeping = "housekeeping",
+    TravelAndTourism = "travel_and_tourism",
+    EventsAndConferences = "events_and_conferences",
+    Assembly = "assembly",
+    MachineOperation = "machine_operation",
+    ProductionManagement = "production_management",
+    ManufacturingEngineering = "manufacturing_engineering",
+    FoodProduction = "food_production",
+    Packaging = "packaging",
+    QualityAssurance = "quality_assurance",
+    QualityControl = "quality_control",
+    ProcessImprovement = "process_improvement",
+    MaintenanceAndReliability = "maintenance_and_reliability",
+    IndustrialSafety = "industrial_safety",
+    StoreManagement = "store_management",
+    SalesAssociate = "sales_associate",
+    VisualMerchandising = "visual_merchandising",
+    CashierAndCheckout = "cashier_and_checkout",
+    InventoryAndStock = "inventory_and_stock",
+    CustomerSupport = "customer_support",
+    CallCentre = "call_centre",
+    ClientAdvisory = "client_advisory",
+    ComplaintsAndEscalations = "complaints_and_escalations",
+    AutomotiveTechnician = "automotive_technician",
+    AutomotiveRepair = "automotive_repair",
+    HeavyVehicleMechanic = "heavy_vehicle_mechanic",
+    VehicleInspection = "vehicle_inspection",
+    AutoBodyAndPaint = "auto_body_and_paint",
+    TruckDriving = "truck_driving",
+    DeliveryAndCourier = "delivery_and_courier",
+    PublicTransport = "public_transport",
+    FleetManagement = "fleet_management"
+}
+declare const SupportedJobSubCategories: JobSubCategory[];
+/**
+ * The hierarchy: which industries belong to a category, and which subCategories to an
+ * industry. Consumers use it to render dependent pickers and to validate that a job's
+ * industry actually sits under its category.
+ */
+declare const JOB_TAXONOMY: ReadonlyArray<{
+    category: JobCategory;
+    industries: ReadonlyArray<{
+        industry: JobIndustry;
+        subCategories: readonly JobSubCategory[];
+    }>;
+}>;
+/**
+ * English display labels for every taxonomy constant. This is the source text the
+ * taxonomy was defined in; it is ALSO what the enrichment prompt renders, so the model
+ * still classifies against readable names while emitting the constant. UIs should
+ * translate the constant (tEnum-style) rather than use these directly.
+ */
+declare const TAXONOMY_LABELS: Readonly<Record<JobCategory | JobIndustry | JobSubCategory, string>>;
+
+/** The industry a subCategory belongs to, or undefined if it is not a known subCategory. */
+declare function industryOfSubCategory(sub: string): JobIndustry | undefined;
+/** The category a subCategory belongs to, or undefined if unknown. */
+declare function categoryOfSubCategory(sub: string): JobCategory | undefined;
+/** The category an industry belongs to, or undefined if unknown. */
+declare function categoryOfIndustry(industry: string): JobCategory | undefined;
+/** The industries under a category (empty if the category is unknown). */
+declare function industriesOfCategory(category: string): readonly JobIndustry[];
+/** The subCategories under an industry (empty if the industry is unknown). */
+declare function subCategoriesOfIndustry(industry: string): readonly JobSubCategory[];
+/**
+ * Derive a job's industry from its category + subCategories. This is the function that
+ * replaces asking the model for `industry`.
+ *
+ * Rule: the first subCategory that sits INSIDE the given category wins. Preferring the
+ * category keeps the model's judgement about what the job is (see the file header) while
+ * still deriving a structurally coherent industry; measured on ~57k jobs, 98.7% of those
+ * with a real category and real subCategories have at least one subCategory inside it.
+ *
+ * Falls back, in order:
+ *  1. no category given -> the first known subCategory's own industry;
+ *  2. no subCategory sits in the category -> undefined (caller keeps whatever it had,
+ *     or stores null; we never drop a posting over this).
+ *
+ * Order matters: `subCategories` is the model's own ranking, most relevant first.
+ */
+declare function deriveIndustry(category: string | null | undefined, subCategories: readonly string[] | null | undefined): JobIndustry | undefined;
+
 declare enum PostStatus {
     Draft = "draft",
     Published = "published",
@@ -2278,4 +2640,4 @@ declare const StudentCompletenessSchema: yup.ObjectSchema<{
     };
 }, "">;
 
-export { AnswerChoiceType, ApplicationReceivePreference, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JobSchema, JobSearchUrgency, JobStatus, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, dateString, getSchemaByQuestion };
+export { AnswerChoiceType, ApplicationReceivePreference, ChoiceQuestionSchema, Common, CompensationType, CompletenessScoreSchema, ContactTypes, CoordinatorPageLinkSchema, DISPLAY_DATE_FORMAT, DISPLAY_DATE_FORMAT_SHORT, DateStringSchema, DbDefaultSchema, DefaultPaginatedResponse, DefaultPaginationOptions, DefaultUserRoles, DurationSchema, EMPTY_STRING, EducationLevel, EducationSchema, EmployeeCount, EmploymentType, ExperienceLevel, GeneraDetailFields, GroupManagedBy, GroupMembershipSchema, GroupMembershipStatus, GroupSchema, GroupStatus, GroupTranslationSchema, GroupVisibility, InputQuestionSchema, JOB_TAXONOMY, JobCategory, JobIndustry, JobSchema, JobSearchUrgency, JobStatus, JobSubCategory, LocationSchema, MIN_SALARY_LOWER_BOUND, MIN_SALARY_UPPER_BOUND, PageSchema, PageStatus, PageType, type PaginatedResponse, PaginationSchema, PostSchema, PostStatus, ProficiencyLevel, QuestionSchema, QuestionType, ReadAndAcknowledgeQuestionSchema, RecruiterPageLinkSchema, ReferralSource, ReportReason, ReportSchema, ResourceType, SITEMAP_FORMAT, SYSTEM_DATE_FORMAT, SkillSchema, SocialAccount, SocialAccountSchema, StudentCompletenessSchema, StudyType, SupportedAnswerChoiceTypes, SupportedApplicationReceivePreferences, SupportedCompensationTypes, SupportedContactTypes, SupportedEducationLevels, SupportedEmployeeCounts, SupportedEmploymentTypes, SupportedExperienceLevels, SupportedJobCategories, SupportedJobIndustries, SupportedJobSearchUrgencies, SupportedJobStatuses, SupportedJobSubCategories, SupportedPageStatuses, SupportedPageTypes, SupportedPostStatuses, SupportedProficiencyLevels, SupportedQuestionTypes, SupportedReferralSources, SupportedReportReasons, SupportedResourceTypes, SupportedSalaryCurrencies, type SupportedSalaryCurrency, SupportedSocialAccounts, SupportedStudyTypes, SupportedUserProfileVisibilities, SupportedUserRoles, SupportedUserStatuses, SupportedWorkModes, TAXONOMY_LABELS, type TChoiceQuestionSchema, type TDurationSchema, type TInputQuestionSchema, type TJobSchema, type TPostSchema, type TQuestionSchema, type TReadAndAcknowledgeQuestionSchema, type TUserIdAndCreatedAtSchema, TermsAcceptedSchema, UserAdditionalInfoSchema, UserCertificationSchema, UserCompletenessSchema, UserCoordinatorProfileSchema, UserDetailType, UserGeneralDetailSchema, UserIdAndCreatedAtSchema, UserInterestSchema, UserJobPreferencesSchema, UserLanguageSchema, type UserProfileOverview, UserProfileVisibility, UserProjectSchema, UserRecruiterProfileSchema, UserRole, UserSchema, UserSkillSchema, UserStatus, WorkExperienceSchema, WorkMode, categoryOfIndustry, categoryOfSubCategory, dateString, deriveIndustry, getSchemaByQuestion, industriesOfCategory, industryOfSubCategory, subCategoriesOfIndustry };