@thejob/schema 2.1.3 → 2.1.4

package/dist/index.js

@@ -2127,8 +2127,69 @@ var DefaultPaginationOptions = {
   limit: 10
 };
 
+// src/saved-search/saved-search.schema.ts
+import { number as number9, object as object20, string as string17 } from "yup";
+
+// src/saved-search/saved-search.constant.ts
+var SavedSearchStatus = /* @__PURE__ */ ((SavedSearchStatus2) => {
+  SavedSearchStatus2["Active"] = "active";
+  SavedSearchStatus2["Paused"] = "paused";
+  return SavedSearchStatus2;
+})(SavedSearchStatus || {});
+var SupportedSavedSearchStatuses = Object.values(SavedSearchStatus);
+
+// src/saved-search/saved-search.schema.ts
+var SavedSearchSchema = object20({
+  /** Public identifier. Server-assigned. */
+  shortId: string17().trim().label("Short Id"),
+  /**
+   * Owner's Better Auth account id. Server-assigned from the verified token,
+   * never accepted from a request body.
+   */
+  ownerUserId: string17().trim().label("Owner"),
+  /** What the user calls this search, e.g. "Remote React roles". */
+  label: string17().trim().max(120).required().label("Label"),
+  /**
+   * The free-text query. Optional because a search can be filters-only ("all
+   * remote jobs in Sweden"), which is a legitimate alert to want.
+   */
+  search: string17().trim().max(500).optional().label("Search Text"),
+  /**
+   * Field filters, in the same `{ field: values }` shape the search endpoint
+   * parses from `filter[field]=a,b`. Held as a free-form object rather than a
+   * closed schema because the job facets it addresses live in jobs-service and
+   * change independently; validating them here would put this package in the
+   * business of tracking that vocabulary.
+   */
+  filter: object20().optional().default({}).label("Filters"),
+  /**
+   * How often to mail matches. `off` keeps the search saved but silent, which is
+   * the difference between "I don't want mail" and "delete my search".
+   *
+   * Reuses the cadence enum from `marketingConsent.jobAlertFrequency` rather
+   * than defining a second one: two vocabularies for the same concept is how
+   * they drift.
+   */
+  frequency: string17().oneOf(SupportedJobAlertFrequencies).default("off" /* Off */).label("Alert Frequency"),
+  status: string17().oneOf(SupportedSavedSearchStatuses).default("active" /* Active */).label("Status"),
+  /**
+   * Epoch ms of the last alert sent for this search. The matching sweep reads it
+   * to decide whether the cadence is due, and writes it only AFTER a successful
+   * publish, so a failed run retries next tick rather than silently skipping a
+   * period.
+   */
+  lastNotifiedAt: number9().optional().label("Last Notified At"),
+  /**
+   * Epoch ms high-water mark: only jobs created after this are "new" for the
+   * next alert. Kept separate from `lastNotifiedAt` because a run that finds no
+   * matches should still advance what counts as new, without implying mail was
+   * sent.
+   */
+  lastMatchedAt: number9().optional().label("Last Matched At")
+}).noUnknown().strict();
+
 // src/report/report.schema.ts
-import { mixed as mixed4, object as object20, string as string17 } from "yup";
+import { mixed as mixed4, object as object21, string as string18 } from "yup";
 
 // src/report/report.constant.ts
 var ResourceType = /* @__PURE__ */ ((ResourceType3) => {
@@ -2152,15 +2213,15 @@ var ReportReason = /* @__PURE__ */ ((ReportReason3) => {
 var SupportedReportReasons = Object.values(ReportReason);
 
 // src/report/report.schema.ts
-var ReportSchema = object20({
+var ReportSchema = object21({
   type: mixed4().oneOf(SupportedResourceTypes).required().label("Type"),
-  resourceId: string17().required().label("Resource ID"),
+  resourceId: string18().required().label("Resource ID"),
   reason: mixed4().oneOf(SupportedReportReasons).required("Please choose a reason").label("Reason"),
-  comment: string17().max(1e3).optional().label("Comment")
+  comment: string18().max(1e3).optional().label("Comment")
 }).label("Report Schema");
 
 // src/feedback/feedback.schema.ts
-import { mixed as mixed5, object as object21, string as string18 } from "yup";
+import { mixed as mixed5, object as object22, string as string19 } from "yup";
 
 // src/feedback/feedback.constant.ts
 var FeedbackType = /* @__PURE__ */ ((FeedbackType3) => {
@@ -2183,63 +2244,63 @@ var SupportedFeedbackStatuses = Object.values(FeedbackStatus);
 var FEEDBACK_MESSAGE_MAX = 4e3;
 
 // src/feedback/feedback.schema.ts
-var FeedbackSchema = object21({
+var FeedbackSchema = object22({
   type: mixed5().oneOf(SupportedFeedbackTypes).required().label("Type"),
-  message: string18().trim().required("Please enter a message").max(FEEDBACK_MESSAGE_MAX).label("Message"),
-  email: string18().email().optional().label("Email"),
-  pageUrl: string18().optional().label("Page URL"),
+  message: string19().trim().required("Please enter a message").max(FEEDBACK_MESSAGE_MAX).label("Message"),
+  email: string19().email().optional().label("Email"),
+  pageUrl: string19().optional().label("Page URL"),
   status: mixed5().oneOf(SupportedFeedbackStatuses).optional().label("Status")
 }).label("Feedback Schema");
 
 // src/user/user.schema.ts
-import { array as array14, boolean as boolean15, number as number10, object as object33, string as string31 } from "yup";
+import { array as array14, boolean as boolean15, number as number11, object as object34, string as string32 } from "yup";
 
 // src/user/work-experience.schema.ts
-import { boolean as boolean12, object as object22, string as string19 } from "yup";
-var WorkExperienceSchema = object22().shape({
+import { boolean as boolean12, object as object23, string as string20 } from "yup";
+var WorkExperienceSchema = object23().shape({
   company: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Company"),
-  designation: string19().trim().required().label("Designation"),
+  designation: string20().trim().required().label("Designation"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).required().label("Duration"),
-  description: string19().trim().max(3e3).optional().label("Description"),
+  description: string20().trim().max(3e3).optional().label("Description"),
   location: LocationSchema.required().label("Location"),
   isRemote: boolean12().oneOf([true, false]).default(false).label("Is Remote")
 }).noUnknown().strict().label("Work Experience");
 
 // src/user/education.schema.ts
-import { boolean as boolean13, object as object23, string as string20 } from "yup";
-var EducationSchema = object23({
+import { boolean as boolean13, object as object24, string as string21 } from "yup";
+var EducationSchema = object24({
   institute: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Institute"),
-  course: string20().trim().required().label("Course"),
-  fieldOfStudy: string20().trim().required().label("Field of Study"),
+  course: string21().trim().required().label("Course"),
+  fieldOfStudy: string21().trim().required().label("Field of Study"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).required().label("Duration"),
-  description: string20().trim().max(3e3).optional().label("Description"),
+  description: string21().trim().max(3e3).optional().label("Description"),
   isDistanceLearning: boolean13().default(false).label("Is Distance Learning"),
   location: LocationSchema.required().label("Location"),
-  studyType: string20().oneOf(SupportedStudyTypes).trim().max(50).required().label("Study Type")
+  studyType: string21().oneOf(SupportedStudyTypes).trim().max(50).required().label("Study Type")
 }).noUnknown().strict().label("Education");
 
 // src/user/user-skill.schema.ts
-import { object as object24, string as string21 } from "yup";
-var UserSkillSchema = object24({
-  name: string21().required().label("Name"),
-  proficiencyLevel: string21().oneOf(SupportedProficiencyLevels).required().label("Proficiency Level"),
+import { object as object25, string as string22 } from "yup";
+var UserSkillSchema = object25({
+  name: string22().required().label("Name"),
+  proficiencyLevel: string22().oneOf(SupportedProficiencyLevels).required().label("Proficiency Level"),
   lastUsed: dateString().format("YYYY-MM").nullable().optional().label("Last Used")
 }).noUnknown().strict().label("Skill");
 
 // src/user/project.schema.ts
-import { object as object25, string as string22 } from "yup";
-var UserProjectSchema = object25({
-  name: string22().trim().max(50).required().label("Name"),
-  url: string22().optional().label("URL"),
-  description: string22().trim().min(100).max(3e3).required().label("Description"),
+import { object as object26, string as string23 } from "yup";
+var UserProjectSchema = object26({
+  name: string23().trim().max(50).required().label("Name"),
+  url: string23().optional().label("URL"),
+  description: string23().trim().min(100).max(3e3).required().label("Description"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
@@ -2248,65 +2309,65 @@ var UserProjectSchema = object25({
 }).noUnknown().strict().label("Project");
 
 // src/user/user-certification.schema.ts
-import { object as object26, string as string23 } from "yup";
-var UserCertificationSchema = object26({
-  name: string23().trim().max(100).required().label("Name"),
+import { object as object27, string as string24 } from "yup";
+var UserCertificationSchema = object27({
+  name: string24().trim().max(100).required().label("Name"),
   // TODO: Add validation for authority
-  authority: string23().trim().max(100).required().label("Authority"),
-  licenseNumber: string23().trim().max(50).optional().label("License Number"),
+  authority: string24().trim().max(100).required().label("Authority"),
+  licenseNumber: string24().trim().max(50).optional().label("License Number"),
   duration: DurationSchema({
     format: "YYYY-MM",
     startLabel: "Start Date",
     endLabel: "End Date"
   }).optional().nullable().label("Duration"),
-  url: string23().optional().label("URL")
+  url: string24().optional().label("URL")
 }).noUnknown().strict().label("Certification");
 
 // src/user/user-interest.schema.ts
-import { string as string24 } from "yup";
-var UserInterestSchema = string24().trim().required().label("Interest");
+import { string as string25 } from "yup";
+var UserInterestSchema = string25().trim().required().label("Interest");
 
 // src/user/user-language.schema.ts
-import { object as object27, string as string25 } from "yup";
-var UserLanguageSchema = object27({
-  name: string25().trim().required().label("Name"),
-  proficiencyLevel: string25().oneOf(SupportedProficiencyLevels).trim().max(50).required().label("Proficiency Level")
+import { object as object28, string as string26 } from "yup";
+var UserLanguageSchema = object28({
+  name: string26().trim().required().label("Name"),
+  proficiencyLevel: string26().oneOf(SupportedProficiencyLevels).trim().max(50).required().label("Proficiency Level")
 }).noUnknown().strict().label("Language");
 
 // src/user/user-additional-info.schema.ts
-import { object as object28, string as string26 } from "yup";
-var UserAdditionalInfoSchema = object28({
-  title: string26().trim().max(60).required().label("Title"),
-  description: string26().trim().max(1e3).required().label("Description")
+import { object as object29, string as string27 } from "yup";
+var UserAdditionalInfoSchema = object29({
+  title: string27().trim().max(60).required().label("Title"),
+  description: string27().trim().max(1e3).required().label("Description")
 }).noUnknown().strict().label("User Additional Info");
 
 // src/user/general-detail.schema.ts
-import { object as object29, string as string27 } from "yup";
-var UserGeneralDetailSchema = object29({
-  id: string27().optional().label("ID"),
-  name: object29().shape({
-    first: string27().trim().max(50).required().label("First Name"),
-    last: string27().trim().max(50).optional().label("Last Name")
+import { object as object30, string as string28 } from "yup";
+var UserGeneralDetailSchema = object30({
+  id: string28().optional().label("ID"),
+  name: object30().shape({
+    first: string28().trim().max(50).required().label("First Name"),
+    last: string28().trim().max(50).optional().label("Last Name")
   }).required().label("Name"),
-  headline: string27().trim().max(200).optional().label("Headline"),
-  image: string27().optional().label("Image"),
-  aboutMe: string27().trim().max(3e3).optional().label("About Me"),
-  email: string27().required().label("Email"),
-  mobile: string27().nullable().optional().label("Mobile"),
-  emailVerified: string27().nullable().optional().label("Email Verified"),
-  mobileVerified: string27().nullable().optional().label("Mobile Verified"),
-  experienceLevel: string27().oneOf(SupportedExperienceLevels).required().label("Experience level"),
+  headline: string28().trim().max(200).optional().label("Headline"),
+  image: string28().optional().label("Image"),
+  aboutMe: string28().trim().max(3e3).optional().label("About Me"),
+  email: string28().required().label("Email"),
+  mobile: string28().nullable().optional().label("Mobile"),
+  emailVerified: string28().nullable().optional().label("Email Verified"),
+  mobileVerified: string28().nullable().optional().label("Mobile Verified"),
+  experienceLevel: string28().oneOf(SupportedExperienceLevels).required().label("Experience level"),
   location: LocationSchema.required().label("Location"),
-  region: object29().shape({
-    country: string27().trim().required().label("Region Country"),
-    lang: string27().trim().required().label("Region Language")
+  region: object30().shape({
+    country: string28().trim().required().label("Region Country"),
+    lang: string28().trim().required().label("Region Language")
   }).optional().default(void 0).label("Region"),
-  profileVisibility: string27().oneOf(SupportedUserProfileVisibilities).default("public" /* Public */).label("Profile Visibility")
+  profileVisibility: string28().oneOf(SupportedUserProfileVisibilities).default("public" /* Public */).label("Profile Visibility")
 }).noUnknown().strict().label("General Detail");
 
 // src/user/user-job-preferences.schema.ts
-import { array as array11, boolean as boolean14, date as date2, number as number9, object as object30, string as string28 } from "yup";
-var UserJobPreferencesSchema = object30({
+import { array as array11, boolean as boolean14, date as date2, number as number10, object as object31, string as string29 } from "yup";
+var UserJobPreferencesSchema = object31({
   /**
    * Whether the job seeker is openly signalling availability. Surfaces the
    * "Open to work" badge on the public profile and boosts visibility in
@@ -2318,7 +2379,7 @@ var UserJobPreferencesSchema = object30({
    * and can downgrade the visibility of expired or low-relevance postings for
    * users in `passively_browsing` mode.
    */
-  jobSearchUrgency: string28().oneOf(SupportedJobSearchUrgencies).required().label("Job Search Urgency"),
+  jobSearchUrgency: string29().oneOf(SupportedJobSearchUrgencies).required().label("Job Search Urgency"),
   /**
    * Locations the user wants to work in. Stores the full `LocationSchema`
    * shape (country, city, state, geo, etc.) as returned by the locations
@@ -2335,7 +2396,7 @@ var UserJobPreferencesSchema = object30({
    * Both reuse the same `ExperienceLevel` taxonomy from `common.constant.ts`
    * so search/match logic doesn't have to translate between two vocabularies.
    */
-  targetExperienceLevels: array11().of(string28().oneOf(SupportedExperienceLevels).required()).min(1, "Pick at least one experience level.").max(2, "You can select at most 2 experience levels.").required().label("Target Experience Levels"),
+  targetExperienceLevels: array11().of(string29().oneOf(SupportedExperienceLevels).required()).min(1, "Pick at least one experience level.").max(2, "You can select at most 2 experience levels.").required().label("Target Experience Levels"),
   /**
    * Specializations the user is searching for - free-form titles.
    *
@@ -2344,19 +2405,19 @@ var UserJobPreferencesSchema = object30({
    * surfaces a curated "Popular Roles" picker for discovery, but the user
    * can ultimately add any title; matching/normalization happens downstream.
    */
-  jobRoles: array11().of(string28().trim().max(120).required()).min(1, "Pick at least one role.").required().label("Job Roles"),
+  jobRoles: array11().of(string29().trim().max(120).required()).min(1, "Pick at least one role.").required().label("Job Roles"),
   /**
    * Minimum acceptable annual base salary, in `minSalaryCurrency`.
    * Stored as an integer in the currency's major unit (e.g. dollars, not cents).
    * Defaults to 0 ("any salary") rather than being optional - every job-seeker
    * has a floor, even if it's zero.
    */
-  minSalary: number9().integer().min(MIN_SALARY_LOWER_BOUND).max(MIN_SALARY_UPPER_BOUND).default(0).required().label("Minimum Salary"),
-  minSalaryCurrency: string28().oneOf(SupportedSalaryCurrencies).default("USD").required().label("Minimum Salary Currency"),
+  minSalary: number10().integer().min(MIN_SALARY_LOWER_BOUND).max(MIN_SALARY_UPPER_BOUND).default(0).required().label("Minimum Salary"),
+  minSalaryCurrency: string29().oneOf(SupportedSalaryCurrencies).default("USD").required().label("Minimum Salary Currency"),
   /**
    * Marketing-attribution capture from the final onboarding step.
    */
-  referralSource: string28().oneOf(SupportedReferralSources).required().label("Referral Source"),
+  referralSource: string29().oneOf(SupportedReferralSources).required().label("Referral Source"),
   /**
    * Resumes the user has uploaded. Embedded directly on the user document
    * (capped at 5) - they're cheap to denormalize, every wizard step that
@@ -2371,15 +2432,15 @@ var UserJobPreferencesSchema = object30({
    * live in their own collection.
    */
   resumes: array11().of(
-    object30({
+    object31({
       // Stable id assigned on upload - used to address a specific entry
       // for delete / set-primary operations without exposing the GCS URL
       // as a route key.
-      id: string28().required().label("ID"),
-      url: string28().required().label("Resume URL"),
-      filename: string28().trim().max(255).optional().label("Filename"),
-      sizeBytes: number9().integer().min(0).optional().label("Size (bytes)"),
-      mimeType: string28().trim().max(120).optional().label("MIME Type"),
+      id: string29().required().label("ID"),
+      url: string29().required().label("Resume URL"),
+      filename: string29().trim().max(255).optional().label("Filename"),
+      sizeBytes: number10().integer().min(0).optional().label("Size (bytes)"),
+      mimeType: string29().trim().max(120).optional().label("MIME Type"),
       uploadedAt: date2().required().label("Uploaded At"),
       isPrimary: boolean14().default(false).label("Is Primary")
     }).noUnknown().strict().label("Resume")
@@ -2408,12 +2469,12 @@ var UserJobPreferencesSchema = object30({
    *   APIs. If `user.<field>` is empty there, the correct behavior is empty,
    *   because the user has not confirmed it yet.
    */
-  pendingPrefill: object30({
-    headline: string28().trim().optional().label("Pending Headline"),
-    aboutMe: string28().trim().optional().label("Pending About Me"),
-    mobile: string28().trim().optional().label("Pending Mobile"),
+  pendingPrefill: object31({
+    headline: string29().trim().optional().label("Pending Headline"),
+    aboutMe: string29().trim().optional().label("Pending About Me"),
+    mobile: string29().trim().optional().label("Pending Mobile"),
     location: LocationSchema.optional().default(void 0).label("Pending Location"),
-    experienceLevel: string28().oneOf(SupportedExperienceLevels).optional().label("Pending Experience Level"),
+    experienceLevel: string29().oneOf(SupportedExperienceLevels).optional().label("Pending Experience Level"),
     socialAccounts: array11().of(SocialAccountSchema.required()).optional().label("Pending Social Accounts"),
     workExperiences: array11().of(WorkExperienceSchema.required()).optional().label("Pending Work Experiences"),
     educations: array11().of(EducationSchema.required()).optional().label("Pending Educations")
@@ -2421,35 +2482,35 @@ var UserJobPreferencesSchema = object30({
 }).noUnknown().strict().label("User Job Preferences Schema");
 
 // src/user/user-recruiter-profile.schema.ts
-import { array as array12, object as object31, string as string29 } from "yup";
-var RecruiterPageLinkSchema = object31({
+import { array as array12, object as object32, string as string30 } from "yup";
+var RecruiterPageLinkSchema = object32({
   page: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Company Page"),
-  jobTitle: string29().trim().max(100).optional().label("Job Title")
+  jobTitle: string30().trim().max(100).optional().label("Job Title")
 }).noUnknown().strict().label("Recruiter Page Link");
-var UserRecruiterProfileSchema = object31({
-  recruiterProfile: object31({
+var UserRecruiterProfileSchema = object32({
+  recruiterProfile: object32({
     hiringFor: array12().of(RecruiterPageLinkSchema).default([]).label("Hiring For")
   }).optional().default(void 0).label("Recruiter Profile")
 }).noUnknown().strict().label("User Recruiter Profile");
 
 // src/user/user-coordinator-profile.schema.ts
-import { array as array13, object as object32, string as string30 } from "yup";
-var CoordinatorPageLinkSchema = object32({
+import { array as array13, object as object33, string as string31 } from "yup";
+var CoordinatorPageLinkSchema = object33({
   page: PageSchema.pick(["name", "slug", "type", "logo"]).deepPartial().concat(PageSchema.pick(["name", "type"])).required().label("Institute Page"),
-  jobTitle: string30().trim().max(100).optional().label("Job Title")
+  jobTitle: string31().trim().max(100).optional().label("Job Title")
 }).noUnknown().strict().label("Coordinator Page Link");
-var UserCoordinatorProfileSchema = object32({
-  coordinatorProfile: object32({
+var UserCoordinatorProfileSchema = object33({
+  coordinatorProfile: object33({
     coordinatesAt: array13().of(CoordinatorPageLinkSchema).default([]).label("Coordinates At")
   }).optional().default(void 0).label("Coordinator Profile")
 }).noUnknown().strict().label("User Coordinator Profile");
 
 // src/user/user.schema.ts
-var UserSchema = object33({
+var UserSchema = object34({
   /**
    * Related auth account id from auth Server (e.g. Better auth https://auth.thejob.dev)
    */
-  authAccountId: string31().required().label("Auth Account ID"),
+  authAccountId: string32().required().label("Auth Account ID"),
   /**
    * Social media information about the user (e.g. LinkedIn, GitHub, etc.)
    */
@@ -2489,11 +2550,11 @@ var UserSchema = object33({
   /**
    * Status of the user account
    */
-  status: string31().oneOf(SupportedUserStatuses).required().label("Status"),
+  status: string32().oneOf(SupportedUserStatuses).required().label("Status"),
   /**
    * Roles assigned to the user
    */
-  roles: array14().of(string31().oneOf(SupportedUserRoles)).required().default(DefaultUserRoles).label("Roles"),
+  roles: array14().of(string32().oneOf(SupportedUserRoles)).required().default(DefaultUserRoles).label("Roles"),
   /**
    * Explicit consent to receive marketing email (newsletters, job alerts by
    * broadcast, product updates). Marketing sends are HARD-GATED on
@@ -2505,18 +2566,18 @@ var UserSchema = object33({
    * unsubscribe sets `subscribed=false` so consent and the email-service
    * suppression list stay consistent. Defaults to NOT subscribed (opt-in).
    */
-  marketingConsent: object33({
+  marketingConsent: object34({
     subscribed: boolean15().default(false).label("Subscribed to marketing email"),
     /** Epoch ms of the last consent change (opt-in or opt-out). */
-    updatedAt: number10().optional().label("Consent updated at"),
+    updatedAt: number11().optional().label("Consent updated at"),
     /** Where the consent change originated, e.g. `onboarding`, `unsubscribe`, `settings`. */
-    source: string31().optional().label("Consent source"),
+    source: string32().optional().label("Consent source"),
     /**
      * How often the user receives job-alert emails. `off` disables job alerts
      * only; other marketing stays governed by `subscribed`. Unset means the
      * user has not chosen a cadence yet.
      */
-    jobAlertFrequency: string31().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
+    jobAlertFrequency: string32().oneOf(SupportedJobAlertFrequencies).optional().label("Job alert frequency")
   }).default({ subscribed: false }).label("Marketing Consent"),
   /**
    * Per-channel toggles for NOTIFICATION email — mail about activity on the
@@ -2531,7 +2592,7 @@ var UserSchema = object33({
    *
    * Transactional mail (magic-link, verification) ignores this object entirely.
    */
-  notificationPrefs: object33({
+  notificationPrefs: object34({
     groupActivity: boolean15().default(true).label("Group activity email"),
     jobActivity: boolean15().default(true).label("Job activity email"),
     applicationUpdates: boolean15().default(true).label("Application update email"),
@@ -2547,15 +2608,15 @@ var UserSchema = object33({
    * Generated from a structured summary of skills, experience, education, etc.
    * Only generated for public profiles with sufficient completeness (≥60%).
    */
-  embedding: object33({
-    vector: array14(number10().required()).optional().label("Embedding vector"),
-    model: string31().optional().label("Embedding model")
+  embedding: object34({
+    vector: array14(number11().required()).optional().label("Embedding vector"),
+    model: string32().optional().label("Embedding model")
   }).nullable().optional().label("Embedding")
 }).concat(UserGeneralDetailSchema).concat(UserJobPreferencesSchema).concat(UserRecruiterProfileSchema).concat(UserCoordinatorProfileSchema).noUnknown().strict().label("User Schema");
 
 // src/user/user-completeness.schema.ts
-import { object as object34 } from "yup";
-var UserCompletenessSchema = object34({
+import { object as object35 } from "yup";
+var UserCompletenessSchema = object35({
   additionalInfo: CompletenessScoreSchema(0).label("Additional Info"),
   // Optional
   certifications: CompletenessScoreSchema(0).label("Certifications"),
@@ -2647,6 +2708,8 @@ export {
   ResourceType,
   SITEMAP_FORMAT,
   SYSTEM_DATE_FORMAT,
+  SavedSearchSchema,
+  SavedSearchStatus,
   SkillSchema,
   SocialAccount,
   SocialAccountSchema,
@@ -2679,6 +2742,7 @@ export {
   SupportedReportReasons,
   SupportedResourceTypes,
   SupportedSalaryCurrencies,
+  SupportedSavedSearchStatuses,
   SupportedSocialAccounts,
   SupportedStudyTypes,
   SupportedUserProfileVisibilities,

package/package.json

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

package/src/index.ts

@@ -62,6 +62,12 @@ export * from "./marketing/marketing.constant.js";
 export * from "./pagination/pagination.schema.js";
 export * from "./pagination/pagination.constant.js";
 
+/**
+ * Saved-search schemas and constants (job alerts).
+ */
+export * from "./saved-search/saved-search.schema.js";
+export * from "./saved-search/saved-search.constant.js";
+
 /**
  * Report schemas and constants.
  */

package/src/saved-search/saved-search.constant.ts

@@ -0,0 +1,17 @@
+/**
+ * Lifecycle of a saved search. Lowercase values, like every other enum in this
+ * package: the string is stored in Mongo and compared as a literal across
+ * services, so its casing is data rather than style.
+ */
+export enum SavedSearchStatus {
+  /** Matching runs and alerts may be sent. */
+  Active = "active",
+  /**
+   * Kept for the user to see and re-enable, but skipped by the matching sweep.
+   * Distinct from deleting: a user pausing alerts should not lose the query they
+   * spent time building.
+   */
+  Paused = "paused",
+}
+
+export const SupportedSavedSearchStatuses = Object.values(SavedSearchStatus);

package/src/saved-search/saved-search.schema.ts

@@ -0,0 +1,84 @@
+import { number, object, string } from "yup";
+import { JobAlertFrequency, SupportedJobAlertFrequencies } from "../user/user.constant.js";
+import { SavedSearchStatus, SupportedSavedSearchStatuses } from "./saved-search.constant.js";
+
+/**
+ * A search a user asked to be kept, and optionally to be alerted about.
+ *
+ * Two jobs in one document, deliberately: the query the user built, and the
+ * cadence at which they want it re-run for them. Splitting them would mean a
+ * user with three saved searches and one alert preference has no way to say
+ * which search the alert is for.
+ *
+ * The stored query mirrors what `GET /jobs/search-v3` accepts — a free-text
+ * `search` plus a `filter` map — so replaying a saved search is running the same
+ * search the user originally ran, not a second, subtly different implementation
+ * that drifts from it.
+ */
+export const SavedSearchSchema = object({
+  /** Public identifier. Server-assigned. */
+  shortId: string().trim().label("Short Id"),
+
+  /**
+   * Owner's Better Auth account id. Server-assigned from the verified token,
+   * never accepted from a request body.
+   */
+  ownerUserId: string().trim().label("Owner"),
+
+  /** What the user calls this search, e.g. "Remote React roles". */
+  label: string().trim().max(120).required().label("Label"),
+
+  /**
+   * The free-text query. Optional because a search can be filters-only ("all
+   * remote jobs in Sweden"), which is a legitimate alert to want.
+   */
+  search: string().trim().max(500).optional().label("Search Text"),
+
+  /**
+   * Field filters, in the same `{ field: values }` shape the search endpoint
+   * parses from `filter[field]=a,b`. Held as a free-form object rather than a
+   * closed schema because the job facets it addresses live in jobs-service and
+   * change independently; validating them here would put this package in the
+   * business of tracking that vocabulary.
+   */
+  filter: object().optional().default({}).label("Filters"),
+
+  /**
+   * How often to mail matches. `off` keeps the search saved but silent, which is
+   * the difference between "I don't want mail" and "delete my search".
+   *
+   * Reuses the cadence enum from `marketingConsent.jobAlertFrequency` rather
+   * than defining a second one: two vocabularies for the same concept is how
+   * they drift.
+   */
+  frequency: string()
+    .oneOf(SupportedJobAlertFrequencies)
+    .default(JobAlertFrequency.Off)
+    .label("Alert Frequency"),
+
+  status: string()
+    .oneOf(SupportedSavedSearchStatuses)
+    .default(SavedSearchStatus.Active)
+    .label("Status"),
+
+  /**
+   * Epoch ms of the last alert sent for this search. The matching sweep reads it
+   * to decide whether the cadence is due, and writes it only AFTER a successful
+   * publish, so a failed run retries next tick rather than silently skipping a
+   * period.
+   */
+  lastNotifiedAt: number().optional().label("Last Notified At"),
+
+  /**
+   * Epoch ms high-water mark: only jobs created after this are "new" for the
+   * next alert. Kept separate from `lastNotifiedAt` because a run that finds no
+   * matches should still advance what counts as new, without implying mail was
+   * sent.
+   */
+  lastMatchedAt: number().optional().label("Last Matched At"),
+})
+  // `createdAt`/`updatedAt` are deliberately absent, matching every other schema
+  // here: audit timestamps are the storing service's concern, not part of the
+  // shape a client sends or validates.
+  .noUnknown()
+  .strict();