@thejob/schema 2.1.6 → 2.1.7

package/dist/index.cjs

@@ -2569,6 +2569,25 @@ var UserGeneralDetailSchema = (0, import_yup33.object)({
   emailVerified: (0, import_yup33.string)().nullable().optional().label("Email Verified"),
   mobileVerified: (0, import_yup33.string)().nullable().optional().label("Mobile Verified"),
   experienceLevel: (0, import_yup33.string)().oneOf(SupportedExperienceLevels).required().label("Experience level"),
+  /**
+   * The user's HIGHEST qualification, e.g. `bachelor`.
+   *
+   * The counterpart of `JobSchema.educationLevel` (what a listing requires), so
+   * matching can compare the two directly. Nothing on the user side answered
+   * that question before: `educations[].studyType` is the MODE of study
+   * (`full_time`, `online`) and says nothing about attainment.
+   *
+   * Deliberately top-level and singular, alongside `experienceLevel`, rather
+   * than per `educations` entry: what matching needs is one fact about the
+   * person, and deriving it by ranking every entry would make the answer depend
+   * on how completely a user filled in their history.
+   *
+   * Optional, unlike `experienceLevel`: every existing user predates it. An
+   * absent value means "level unknown", which must leave matching
+   * UNCONSTRAINED on education rather than filtering the user out — the same
+   * opt-out reasoning `notificationPrefs` uses.
+   */
+  educationLevel: (0, import_yup33.string)().oneOf(SupportedEducationLevels).optional().label("Education level"),
   location: LocationSchema.required().label("Location"),
   /**
    * Where the account was created, captured once and never rewritten.

package/dist/index.d.cts

@@ -1943,6 +1943,7 @@ declare const UserSchema: yup.ObjectSchema<{
     emailVerified: string | null | undefined;
     mobileVerified: string | null | undefined;
     experienceLevel: NonNullable<ExperienceLevel | undefined>;
+    educationLevel: EducationLevel | undefined;
     location: {
         placeId?: string | null | undefined;
         state?: string | null | undefined;
@@ -2150,6 +2151,7 @@ declare const UserSchema: yup.ObjectSchema<{
     emailVerified: undefined;
     mobileVerified: undefined;
     experienceLevel: undefined;
+    educationLevel: undefined;
     location: {
         placeId: undefined;
         country: undefined;
@@ -2202,6 +2204,7 @@ declare const UserGeneralDetailSchema: yup.ObjectSchema<{
     emailVerified: string | null | undefined;
     mobileVerified: string | null | undefined;
     experienceLevel: NonNullable<ExperienceLevel | undefined>;
+    educationLevel: EducationLevel | undefined;
     location: {
         placeId?: string | null | undefined;
         state?: string | null | undefined;
@@ -2236,6 +2239,7 @@ declare const UserGeneralDetailSchema: yup.ObjectSchema<{
     emailVerified: undefined;
     mobileVerified: undefined;
     experienceLevel: undefined;
+    educationLevel: undefined;
     location: {
         placeId: undefined;
         country: undefined;

package/dist/index.d.ts

@@ -1943,6 +1943,7 @@ declare const UserSchema: yup.ObjectSchema<{
     emailVerified: string | null | undefined;
     mobileVerified: string | null | undefined;
     experienceLevel: NonNullable<ExperienceLevel | undefined>;
+    educationLevel: EducationLevel | undefined;
     location: {
         placeId?: string | null | undefined;
         state?: string | null | undefined;
@@ -2150,6 +2151,7 @@ declare const UserSchema: yup.ObjectSchema<{
     emailVerified: undefined;
     mobileVerified: undefined;
     experienceLevel: undefined;
+    educationLevel: undefined;
     location: {
         placeId: undefined;
         country: undefined;
@@ -2202,6 +2204,7 @@ declare const UserGeneralDetailSchema: yup.ObjectSchema<{
     emailVerified: string | null | undefined;
     mobileVerified: string | null | undefined;
     experienceLevel: NonNullable<ExperienceLevel | undefined>;
+    educationLevel: EducationLevel | undefined;
     location: {
         placeId?: string | null | undefined;
         state?: string | null | undefined;
@@ -2236,6 +2239,7 @@ declare const UserGeneralDetailSchema: yup.ObjectSchema<{
     emailVerified: undefined;
     mobileVerified: undefined;
     experienceLevel: undefined;
+    educationLevel: undefined;
     location: {
         placeId: undefined;
         country: undefined;

package/dist/index.js

@@ -2392,6 +2392,25 @@ var UserGeneralDetailSchema = object30({
   emailVerified: string28().nullable().optional().label("Email Verified"),
   mobileVerified: string28().nullable().optional().label("Mobile Verified"),
   experienceLevel: string28().oneOf(SupportedExperienceLevels).required().label("Experience level"),
+  /**
+   * The user's HIGHEST qualification, e.g. `bachelor`.
+   *
+   * The counterpart of `JobSchema.educationLevel` (what a listing requires), so
+   * matching can compare the two directly. Nothing on the user side answered
+   * that question before: `educations[].studyType` is the MODE of study
+   * (`full_time`, `online`) and says nothing about attainment.
+   *
+   * Deliberately top-level and singular, alongside `experienceLevel`, rather
+   * than per `educations` entry: what matching needs is one fact about the
+   * person, and deriving it by ranking every entry would make the answer depend
+   * on how completely a user filled in their history.
+   *
+   * Optional, unlike `experienceLevel`: every existing user predates it. An
+   * absent value means "level unknown", which must leave matching
+   * UNCONSTRAINED on education rather than filtering the user out — the same
+   * opt-out reasoning `notificationPrefs` uses.
+   */
+  educationLevel: string28().oneOf(SupportedEducationLevels).optional().label("Education level"),
   location: LocationSchema.required().label("Location"),
   /**
    * Where the account was created, captured once and never rewritten.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thejob/schema",
-  "version": "2.1.6",
+  "version": "2.1.7",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

package/src/user/general-detail.schema.ts

@@ -1,5 +1,8 @@
 import { number, object, string } from "yup";
-import { SupportedExperienceLevels } from "../common/common.constant.js";
+import {
+  SupportedEducationLevels,
+  SupportedExperienceLevels,
+} from "../common/common.constant.js";
 import { LocationSchema } from "../location/location.schema.js";
 import {
   SupportedSignupContextSources,
@@ -30,6 +33,28 @@ export const UserGeneralDetailSchema = object({
     .oneOf(SupportedExperienceLevels)
     .required()
     .label("Experience level"),
+  /**
+   * The user's HIGHEST qualification, e.g. `bachelor`.
+   *
+   * The counterpart of `JobSchema.educationLevel` (what a listing requires), so
+   * matching can compare the two directly. Nothing on the user side answered
+   * that question before: `educations[].studyType` is the MODE of study
+   * (`full_time`, `online`) and says nothing about attainment.
+   *
+   * Deliberately top-level and singular, alongside `experienceLevel`, rather
+   * than per `educations` entry: what matching needs is one fact about the
+   * person, and deriving it by ranking every entry would make the answer depend
+   * on how completely a user filled in their history.
+   *
+   * Optional, unlike `experienceLevel`: every existing user predates it. An
+   * absent value means "level unknown", which must leave matching
+   * UNCONSTRAINED on education rather than filtering the user out — the same
+   * opt-out reasoning `notificationPrefs` uses.
+   */
+  educationLevel: string()
+    .oneOf(SupportedEducationLevels)
+    .optional()
+    .label("Education level"),
   location: LocationSchema.required().label("Location"),
   /**
    * Where the account was created, captured once and never rewritten.