@thejob/schema 2.1.6 → 2.1.8

package/dist/index.cjs

@@ -32,8 +32,16 @@ var index_exports = {};
 __export(index_exports, {
   AnswerChoiceType: () => AnswerChoiceType,
   ApplicationReceivePreference: () => ApplicationReceivePreference,
+  BindingKind: () => BindingKind,
+  BindingSchema: () => BindingSchema,
+  CAMPAIGN_MAX_RECIPIENTS_CEILING: () => CAMPAIGN_MAX_RECIPIENTS_CEILING,
+  CampaignAnchorField: () => CampaignAnchorField,
+  CampaignEndKind: () => CampaignEndKind,
+  CampaignIntervalUnit: () => CampaignIntervalUnit,
   CampaignSchema: () => CampaignSchema,
   CampaignStatus: () => CampaignStatus,
+  CampaignTriggerKind: () => CampaignTriggerKind,
+  CampaignTriggerSchema: () => CampaignTriggerSchema,
   ChoiceQuestionSchema: () => ChoiceQuestionSchema,
   Common: () => Common,
   CompensationType: () => CompensationType,
@@ -75,12 +83,15 @@ __export(index_exports, {
   JobSearchUrgency: () => JobSearchUrgency,
   JobStatus: () => JobStatus,
   JobSubCategory: () => JobSubCategory,
+  ListFilterBranch: () => ListFilterBranch,
+  ListFilterBranchSchema: () => ListFilterBranchSchema,
   ListFilterSchema: () => ListFilterSchema,
   LocationSchema: () => LocationSchema,
   MIN_SALARY_LOWER_BOUND: () => MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND: () => MIN_SALARY_UPPER_BOUND,
   MailingListSchema: () => MailingListSchema,
   NotificationChannel: () => NotificationChannel,
+  OccurrenceStatus: () => OccurrenceStatus,
   PREFILL_MIRRORED_KEYS: () => PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS: () => PRIVATE_PROFILE_FIELDS,
   PageSchema: () => PageSchema,
@@ -110,7 +121,12 @@ __export(index_exports, {
   StudyType: () => StudyType,
   SupportedAnswerChoiceTypes: () => SupportedAnswerChoiceTypes,
   SupportedApplicationReceivePreferences: () => SupportedApplicationReceivePreferences,
+  SupportedBindingKinds: () => SupportedBindingKinds,
+  SupportedCampaignAnchorFields: () => SupportedCampaignAnchorFields,
+  SupportedCampaignEndKinds: () => SupportedCampaignEndKinds,
+  SupportedCampaignIntervalUnits: () => SupportedCampaignIntervalUnits,
   SupportedCampaignStatuses: () => SupportedCampaignStatuses,
+  SupportedCampaignTriggerKinds: () => SupportedCampaignTriggerKinds,
   SupportedCompensationTypes: () => SupportedCompensationTypes,
   SupportedContactTypes: () => SupportedContactTypes,
   SupportedEducationLevels: () => SupportedEducationLevels,
@@ -126,6 +142,7 @@ __export(index_exports, {
   SupportedJobStatuses: () => SupportedJobStatuses,
   SupportedJobSubCategories: () => SupportedJobSubCategories,
   SupportedNotificationChannels: () => SupportedNotificationChannels,
+  SupportedOccurrenceStatuses: () => SupportedOccurrenceStatuses,
   SupportedPageStatuses: () => SupportedPageStatuses,
   SupportedPageTypes: () => SupportedPageTypes,
   SupportedPostStatuses: () => SupportedPostStatuses,
@@ -2225,10 +2242,79 @@ var PRIVATE_PROFILE_FIELDS = [
   "additionalInfo"
 ];
 
+// src/marketing/marketing.constant.ts
+var CampaignStatus = /* @__PURE__ */ ((CampaignStatus2) => {
+  CampaignStatus2["Draft"] = "draft";
+  CampaignStatus2["Sending"] = "sending";
+  CampaignStatus2["Sent"] = "sent";
+  CampaignStatus2["Failed"] = "failed";
+  return CampaignStatus2;
+})(CampaignStatus || {});
+var SupportedCampaignStatuses = Object.values(CampaignStatus);
+var CampaignTriggerKind = /* @__PURE__ */ ((CampaignTriggerKind2) => {
+  CampaignTriggerKind2["Manual"] = "manual";
+  CampaignTriggerKind2["Once"] = "once";
+  CampaignTriggerKind2["Schedule"] = "schedule";
+  CampaignTriggerKind2["Lifecycle"] = "lifecycle";
+  return CampaignTriggerKind2;
+})(CampaignTriggerKind || {});
+var SupportedCampaignTriggerKinds = Object.values(CampaignTriggerKind);
+var CampaignIntervalUnit = /* @__PURE__ */ ((CampaignIntervalUnit2) => {
+  CampaignIntervalUnit2["Day"] = "day";
+  CampaignIntervalUnit2["Week"] = "week";
+  CampaignIntervalUnit2["Month"] = "month";
+  return CampaignIntervalUnit2;
+})(CampaignIntervalUnit || {});
+var SupportedCampaignIntervalUnits = Object.values(CampaignIntervalUnit);
+var CampaignEndKind = /* @__PURE__ */ ((CampaignEndKind2) => {
+  CampaignEndKind2["Never"] = "never";
+  CampaignEndKind2["AfterOccurrences"] = "afterOccurrences";
+  CampaignEndKind2["OnDate"] = "onDate";
+  return CampaignEndKind2;
+})(CampaignEndKind || {});
+var SupportedCampaignEndKinds = Object.values(CampaignEndKind);
+var CampaignAnchorField = /* @__PURE__ */ ((CampaignAnchorField2) => {
+  CampaignAnchorField2["CreatedAt"] = "createdAt";
+  CampaignAnchorField2["OnboardingCompletedAt"] = "onboardingCompletedAt";
+  CampaignAnchorField2["MarketingConsentUpdatedAt"] = "marketingConsent.updatedAt";
+  return CampaignAnchorField2;
+})(CampaignAnchorField || {});
+var SupportedCampaignAnchorFields = Object.values(CampaignAnchorField);
+var BindingKind = /* @__PURE__ */ ((BindingKind2) => {
+  BindingKind2["Static"] = "static";
+  BindingKind2["Recipient"] = "recipient";
+  BindingKind2["Url"] = "url";
+  BindingKind2["Source"] = "source";
+  return BindingKind2;
+})(BindingKind || {});
+var SupportedBindingKinds = Object.values(BindingKind);
+var OccurrenceStatus = /* @__PURE__ */ ((OccurrenceStatus2) => {
+  OccurrenceStatus2["Pending"] = "pending";
+  OccurrenceStatus2["Running"] = "running";
+  OccurrenceStatus2["Sent"] = "sent";
+  OccurrenceStatus2["Skipped"] = "skipped";
+  OccurrenceStatus2["Failed"] = "failed";
+  return OccurrenceStatus2;
+})(OccurrenceStatus || {});
+var SupportedOccurrenceStatuses = Object.values(OccurrenceStatus);
+var CAMPAIGN_MAX_RECIPIENTS_CEILING = 5e3;
+
 // src/marketing/marketing.schema.ts
 var tokens = (label) => (0, import_yup20.array)().of((0, import_yup20.string)().trim().required()).optional().default([]).label(label);
 var enumFacet = (values, label) => (0, import_yup20.array)().of((0, import_yup20.string)().oneOf(values).required()).optional().default([]).label(label);
-var ListFilterSchema = (0, import_yup20.object)({
+var days = (label) => (0, import_yup20.number)().integer().min(0).max(3650).optional().default(void 0).label(label);
+var months = (label) => (0, import_yup20.number)().integer().min(0).max(1200).optional().default(void 0).label(label);
+var percent = (label) => (0, import_yup20.number)().integer().min(0).max(100).optional().default(void 0).label(label);
+var epoch = (label) => (0, import_yup20.number)().integer().min(0).optional().default(void 0).label(label);
+var salaryBound = (label) => (0, import_yup20.number)().integer().min(0).optional().default(void 0).label(label).when("salaryCurrencies", {
+  is: (v) => !Array.isArray(v) || v.length !== 1,
+  then: (s) => s.test(
+    "requires-single-currency",
+    "Pick exactly one salary currency to filter by salary",
+    (value) => value === void 0 || value === null
+  )
+});
+var ListFilterBranchSchema = (0, import_yup20.object)({
   // ── Enum facets (closed vocabularies, chip pickers) ─────────────────────────
   countries: (0, import_yup20.array)().of((0, import_yup20.string)().required()).optional().default([]).label("Countries"),
   roles: enumFacet(SupportedUserRoles, "Roles"),
@@ -2283,39 +2369,285 @@ var ListFilterSchema = (0, import_yup20.object)({
   // Case-insensitive keyword match against headline + aboutMe.
   keywords: tokens("Profile Keywords"),
   // ── Range / boolean facets ──────────────────────────────────────────────────
-  minSalaryFloor: (0, import_yup20.number)().integer().min(0).optional().label("Min Salary \u2265"),
-  minSalaryCeil: (0, import_yup20.number)().integer().min(0).optional().label("Min Salary \u2264"),
+  // A salary bound is meaningless without a currency: `minSalary` is a raw
+  // integer and 50000 SEK is not 50000 USD, so an un-currencied range matches
+  // across currencies and quietly means nothing. Requiring exactly one currency
+  // alongside a bound is what makes the comparison sound.
+  minSalaryFloor: salaryBound("Min Salary \u2265"),
+  minSalaryCeil: salaryBound("Min Salary \u2264"),
   openToWorkOnly: (0, import_yup20.boolean)().optional().default(false).label("Open to Work Only"),
   remoteExperienceOnly: (0, import_yup20.boolean)().optional().default(false).label("Has Remote Experience"),
   hasResumeOnly: (0, import_yup20.boolean)().optional().default(false).label("Has Resume"),
   onboardingCompletedOnly: (0, import_yup20.boolean)().optional().default(false).label("Onboarding Completed"),
   emailVerifiedOnly: (0, import_yup20.boolean)().optional().default(false).label("Email Verified Only"),
-  mobileVerifiedOnly: (0, import_yup20.boolean)().optional().default(false).label("Mobile Verified Only")
-}).label("Audience Filter");
+  mobileVerifiedOnly: (0, import_yup20.boolean)().optional().default(false).label("Mobile Verified Only"),
+  // ── Lifecycle windows ───────────────────────────────────────────────────────
+  // Relative, because a saved list is resolved fresh on every send: a stored
+  // absolute epoch would freeze at authoring time and the audience would decay
+  // to nothing. The absolute forms below exist for one-shot sends; when both are
+  // present the relative form wins.
+  lastSeenBeforeDays: days("Inactive For (days) \u2265"),
+  lastSeenAfterDays: days("Active Within (days)"),
+  createdAtWithinDays: days("Signed Up Within (days)"),
+  createdAtOlderThanDays: days("Signed Up Before (days ago)"),
+  completenessMin: percent("Profile Completeness \u2265"),
+  completenessMax: percent("Profile Completeness \u2264"),
+  // Absolute epoch-ms forms. Prefer the relative fields above for anything that
+  // repeats.
+  lastSeenBefore: epoch("Last Seen Before"),
+  lastSeenAfter: epoch("Last Seen After"),
+  createdAtFrom: epoch("Signed Up After"),
+  createdAtBefore: epoch("Signed Up Before"),
+  // ── Geography ───────────────────────────────────────────────────────────────
+  // `countries` above matches location.countryCode. These narrow within it.
+  // NOTE: stateCodes are stored bare (`KA`, not `IN-KA`) — see the pending
+  // @todo STATE-CODE-ISO-PREFIX migration. Match the stored form, do not prefix.
+  states: tokens("States"),
+  stateCodes: tokens("State Codes"),
+  cities: tokens("Cities"),
+  // Radius search around a point, against location.geo. All three required
+  // together; validated as a group rather than field-by-field so a half-filled
+  // radius cannot silently match everyone.
+  withinRadius: (0, import_yup20.object)({
+    lat: (0, import_yup20.number)().min(-90).max(90).required().label("Latitude"),
+    lng: (0, import_yup20.number)().min(-180).max(180).required().label("Longitude"),
+    km: (0, import_yup20.number)().moreThan(0).max(2e4).required().label("Radius (km)")
+  }).optional().default(void 0).label("Within Radius"),
+  // ── Signup context (immutable market / locale) ──────────────────────────────
+  signupCountries: tokens("Signup Countries"),
+  signupLocales: tokens("Signup Locales"),
+  signupSources: enumFacet(SupportedSignupContextSources, "Signup Source"),
+  // ── Attainment ──────────────────────────────────────────────────────────────
+  // Absent on users who predate the field. Absent means "unknown", never a
+  // match — filtering on this necessarily excludes them.
+  educationLevels: enumFacet(SupportedEducationLevels, "Education Level"),
+  // ── Consent metadata ────────────────────────────────────────────────────────
+  // `marketingConsent.subscribed` is NOT a facet: it is a hard opt-in gate
+  // applied unconditionally by user-service and is not relaxable from here.
+  jobAlertFrequencies: enumFacet(
+    SupportedJobAlertFrequencies,
+    "Job Alert Frequency"
+  ),
+  consentSources: tokens("Consent Source"),
+  consentUpdatedWithinDays: days("Consent Updated Within (days)"),
+  // ── Notification preferences ────────────────────────────────────────────────
+  // Read as opt-IN (`=== true`), matching marketingConsent and NOT the `!== false`
+  // reading used for transactional notification routing. A campaign is bulk mail,
+  // so a channel the user never affirmatively enabled does not count as consent.
+  // `productUpdates` defaults to false on the user document, so targeting it
+  // selects only people who deliberately turned it on.
+  notificationChannelsEnabled: enumFacet(
+    SupportedNotificationChannels,
+    "Notification Channels Enabled"
+  ),
+  // ── Tenure / recency ────────────────────────────────────────────────────────
+  // Against workExperiences[].duration and educations[].duration ("YYYY-MM").
+  currentlyEmployed: (0, import_yup20.boolean)().optional().default(false).label("Currently Employed"),
+  graduatedWithinMonths: months("Graduated Within (months)"),
+  skillUsedWithinMonths: months("Skill Used Within (months)"),
+  // ── Profile richness ────────────────────────────────────────────────────────
+  hasImage: (0, import_yup20.boolean)().optional().default(false).label("Has Photo"),
+  hasHeadline: (0, import_yup20.boolean)().optional().default(false).label("Has Headline"),
+  hasAboutMe: (0, import_yup20.boolean)().optional().default(false).label("Has About Me"),
+  hasMobile: (0, import_yup20.boolean)().optional().default(false).label("Has Mobile Number"),
+  // Segment by WHICH profile section is missing (profileCompleteness.missing[]),
+  // rather than only by the overall percentage.
+  missingSections: tokens("Missing Profile Sections"),
+  // ── Employer / institute taxonomy ───────────────────────────────────────────
+  companyTypes: enumFacet(SupportedPageTypes, "Company Type"),
+  instituteTypes: enumFacet(SupportedPageTypes, "Institute Type"),
+  // ── Activity ────────────────────────────────────────────────────────────────
+  // Backed by denormalised counters on the user document, because the source
+  // data lives in other services' collections. Tri-state: `false` is a real
+  // filter ("has NO job alert"), which is the audience an alert nudge wants, so
+  // these are `undefined` when unset rather than defaulting to false.
+  hasJobAlert: (0, import_yup20.boolean)().optional().default(void 0).label("Has a Job Alert"),
+  hasApplied: (0, import_yup20.boolean)().optional().default(void 0).label("Has Applied"),
+  appliedWithinDays: days("Applied Within (days)"),
+  // ── Free-text search (name / email) ─────────────────────────────────────────
+  search: (0, import_yup20.string)().trim().optional().label("Search")
+}).label("Audience Filter Branch");
+var rejectUnknownKeys = (schema, allowed) => schema.test(
+  "no-unknown-filter-keys",
+  ({ value, label }) => {
+    const known = new Set(allowed());
+    const bad = Object.keys(value ?? {}).filter(
+      (k) => !known.has(k)
+    );
+    return `${label} has unsupported keys: ${bad.join(", ")}`;
+  },
+  (value) => {
+    if (value == null) return true;
+    const known = new Set(allowed());
+    return Object.keys(value).every(
+      (k) => known.has(k)
+    );
+  }
+);
+var BRANCH_KEYS = Object.keys(ListFilterBranchSchema.fields);
+var ListFilterBranch = rejectUnknownKeys(
+  ListFilterBranchSchema,
+  () => BRANCH_KEYS
+);
+var ListFilterSchema = rejectUnknownKeys(
+  ListFilterBranchSchema.shape({
+    or: (0, import_yup20.array)().of(ListFilterBranch).optional().default([]).label("Or Any Of")
+  }).label("Audience Filter"),
+  () => [...BRANCH_KEYS, "or"]
+);
 var MailingListSchema = (0, import_yup20.object)({
   name: (0, import_yup20.string)().required().min(1).max(120).label("Name"),
   description: (0, import_yup20.string)().optional().max(500).label("Description"),
   filter: ListFilterSchema.default(() => ListFilterSchema.getDefault())
 }).label("Mailing List");
+var CampaignTriggerSchema = (0, import_yup20.object)({
+  kind: (0, import_yup20.string)().oneOf(SupportedCampaignTriggerKinds).required().default("manual" /* Manual */).label("Trigger"),
+  // IANA zone, e.g. "Asia/Kolkata". Local wall-clock times are interpreted in it,
+  // so occurrences land at the intended hour across DST rather than drifting.
+  timezone: (0, import_yup20.string)().optional().default("UTC").label("Timezone").when("kind", {
+    is: (k) => k !== "manual" /* Manual */,
+    then: (s) => s.required()
+  }),
+  // kind: once
+  runAt: epoch("Send At").when("kind", {
+    is: "once" /* Once */,
+    then: (s) => s.required()
+  }),
+  // kind: schedule
+  startAt: epoch("Starts").when("kind", {
+    is: "schedule" /* Schedule */,
+    then: (s) => s.required()
+  }),
+  interval: (0, import_yup20.object)({
+    every: (0, import_yup20.number)().integer().min(1).max(365).required().label("Every"),
+    unit: (0, import_yup20.string)().oneOf(SupportedCampaignIntervalUnits).required().label("Unit")
+  }).optional().default(void 0).label("Repeats").when("kind", {
+    is: "schedule" /* Schedule */,
+    then: (s) => s.required()
+  }),
+  /** Local wall-clock send time, "HH:mm" in `timezone`. */
+  timeOfDay: (0, import_yup20.string)().matches(/^([01]\d|2[0-3]):[0-5]\d$/, "Use HH:mm").optional().default("09:00").label("Time of Day"),
+  /** For weekly intervals: ISO weekdays, 1 = Monday .. 7 = Sunday. */
+  byWeekday: (0, import_yup20.array)().of((0, import_yup20.number)().integer().min(1).max(7).required()).optional().default([]).label("On Days"),
+  /**
+   * For monthly intervals: 1-31, or -1 meaning "last day of the month". A month
+   * shorter than the chosen day is clamped to its last day, so 31 in February
+   * fires on the 28th/29th rather than being skipped.
+   */
+  byMonthday: (0, import_yup20.number)().integer().min(-1).max(31).notOneOf([0]).optional().default(void 0).label("Day of Month"),
+  end: (0, import_yup20.object)({
+    kind: (0, import_yup20.string)().oneOf(SupportedCampaignEndKinds).required().label("Ends"),
+    occurrences: (0, import_yup20.number)().integer().min(1).max(1e4).optional().default(void 0).label("After N Sends").when("kind", {
+      is: "afterOccurrences" /* AfterOccurrences */,
+      then: (s) => s.required()
+    }),
+    date: epoch("End Date").when("kind", {
+      is: "onDate" /* OnDate */,
+      then: (s) => s.required()
+    })
+  }).optional().default(() => ({ kind: "never" /* Never */ })).label("End Condition"),
+  // kind: lifecycle
+  anchorField: (0, import_yup20.string)().oneOf(SupportedCampaignAnchorFields).optional().default(void 0).label("Anchor Date").when("kind", {
+    is: "lifecycle" /* Lifecycle */,
+    then: (s) => s.required()
+  }),
+  /** Days after the anchor at which this user becomes eligible. */
+  offsetDays: (0, import_yup20.number)().integer().min(0).max(3650).optional().default(void 0).label("Days After Anchor").when("kind", {
+    is: "lifecycle" /* Lifecycle */,
+    then: (s) => s.required()
+  }),
+  /**
+   * How long a user stays eligible after crossing the offset. Needed because the
+   * scheduler samples periodically and a zero-width window would miss anyone not
+   * observed on the exact day. A user inside the window on several ticks is still
+   * mailed once: the permanent idempotency key, not this value, guarantees that.
+   */
+  windowDays: (0, import_yup20.number)().integer().min(1).max(90).optional().default(2).label("Eligibility Window (days)")
+}).label("Trigger");
+var BindingSchema = (0, import_yup20.object)({
+  kind: (0, import_yup20.string)().oneOf(SupportedBindingKinds).required().label("Source"),
+  value: (0, import_yup20.string)().required().min(1).max(2e3).label("Value")
+}).label("Binding");
 var CampaignSchema = (0, import_yup20.object)({
   name: (0, import_yup20.string)().required().min(1).max(200).label("Campaign Name"),
-  subject: (0, import_yup20.string)().required().min(1).max(255).label("Subject"),
-  // HTML body; may contain a {{unsubscribe_url}} placeholder.
-  html: (0, import_yup20.string)().required().min(1).label("HTML Body"),
+  // The template renders its own subject; an override is only needed for the
+  // inline-HTML path, hence not required when a template is chosen.
+  subject: (0, import_yup20.string)().optional().max(255).label("Subject").when("templateKey", {
+    is: (v) => !v,
+    then: (s) => s.required().min(1)
+  }),
+  /**
+   * Inline HTML body; may contain {{unsubscribe_url}}. Optional now that a
+   * campaign can instead name a registry template — exactly one of the two is
+   * required. Scheduled and lifecycle campaigns must use a template: the
+   * registry path is the one with a compliance-checked footer and a render test,
+   * and hand-pasted HTML that repeats forever is a mistake that repeats forever.
+   */
+  html: (0, import_yup20.string)().optional().label("HTML Body").when("templateKey", {
+    is: (v) => !v,
+    then: (s) => s.required().min(1)
+  }),
   text: (0, import_yup20.string)().optional().label("Plain-text Body"),
-  listId: (0, import_yup20.string)().required().label("Mailing List")
+  listId: (0, import_yup20.string)().required().label("Mailing List"),
+  /** Key from email-service's template registry. Mutually exclusive with `html`. */
+  templateKey: (0, import_yup20.string)().optional().label("Email Template"),
+  /**
+   * One entry per variable the chosen template declares. Validated at save time
+   * against the template's own `variables`, so a missing required binding is a
+   * rejected save rather than a broken send.
+   */
+  /**
+   * A DICTIONARY keyed by template variable name, which Yup has no native type
+   * for. It must be built with `lazy` from the keys actually present: a bare
+   * `object()` has no known keys, so under `stripUnknown: true` (which the
+   * consumers' validate helper passes) every binding is "unknown" and the whole
+   * map arrives as `{}` — silently turning a fully-configured campaign into one
+   * whose required variables all appear unbound. Shaping each entry also means a
+   * malformed binding is rejected here rather than at send time.
+   */
+  bindings: (0, import_yup20.lazy)((value) => {
+    const keys = value && typeof value === "object" ? Object.keys(value) : [];
+    return (0, import_yup20.object)(
+      Object.fromEntries(keys.map((k) => [k, BindingSchema.required()]))
+    ).optional().default(() => ({})).label("Template Data");
+  }),
+  /** Registered data source supplying per-recipient content, plus its params. */
+  dataSource: (0, import_yup20.object)({
+    id: (0, import_yup20.string)().required().label("Data Source"),
+    /**
+     * A free-form bag whose keys are defined by the chosen source's OWN
+     * `paramsSchema`, which this package cannot see. Same `lazy` treatment as
+     * `bindings` above, and for the same reason: a bare `object()` has no known
+     * keys, so under `stripUnknown: true` every param is "unknown" and the bag
+     * arrives as `{}` — a campaign configured to mail remote Python roles in
+     * Bangalore silently saves as an unfiltered platform-wide digest.
+     *
+     * Values stay unvalidated here on purpose; the marketing service validates
+     * them against the real source schema in `checkCampaignConfig`, which is the
+     * only place that knows what a given source accepts.
+     */
+    params: (0, import_yup20.lazy)((value) => {
+      const keys = value && typeof value === "object" ? Object.keys(value) : [];
+      return (0, import_yup20.object)(
+        Object.fromEntries(keys.map((k) => [k, (0, import_yup20.mixed)().optional()]))
+      ).optional().default(() => ({})).label("Parameters");
+    })
+  }).optional().default(void 0).label("Data Source"),
+  trigger: CampaignTriggerSchema.default(
+    () => CampaignTriggerSchema.getDefault()
+  ),
+  // ── Safety ──────────────────────────────────────────────────────────────────
+  // Both default to the safe position: a new campaign neither runs nor sends
+  // until someone deliberately says so, and says so twice.
+  enabled: (0, import_yup20.boolean)().optional().default(false).label("Enabled"),
+  dryRun: (0, import_yup20.boolean)().optional().default(true).label("Dry Run"),
+  maxRecipients: (0, import_yup20.number)().integer().min(1).max(CAMPAIGN_MAX_RECIPIENTS_CEILING).optional().default(void 0).label("Max Recipients"),
+  utm: (0, import_yup20.object)({
+    campaign: (0, import_yup20.string)().optional().max(120).label("utm_campaign"),
+    content: (0, import_yup20.string)().optional().max(120).label("utm_content")
+  }).optional().default(void 0).label("Link Tagging")
 }).label("Campaign");
 
-// src/marketing/marketing.constant.ts
-var CampaignStatus = /* @__PURE__ */ ((CampaignStatus2) => {
-  CampaignStatus2["Draft"] = "draft";
-  CampaignStatus2["Sending"] = "sending";
-  CampaignStatus2["Sent"] = "sent";
-  CampaignStatus2["Failed"] = "failed";
-  return CampaignStatus2;
-})(CampaignStatus || {});
-var SupportedCampaignStatuses = Object.values(CampaignStatus);
-
 // src/pagination/pagination.schema.ts
 var import_yup21 = require("yup");
 var PaginationSchema = (0, import_yup21.object)().shape({
@@ -2569,6 +2901,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.
@@ -2871,8 +3222,16 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
 0 && (module.exports = {
   AnswerChoiceType,
   ApplicationReceivePreference,
+  BindingKind,
+  BindingSchema,
+  CAMPAIGN_MAX_RECIPIENTS_CEILING,
+  CampaignAnchorField,
+  CampaignEndKind,
+  CampaignIntervalUnit,
   CampaignSchema,
   CampaignStatus,
+  CampaignTriggerKind,
+  CampaignTriggerSchema,
   ChoiceQuestionSchema,
   Common,
   CompensationType,
@@ -2914,12 +3273,15 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   JobSearchUrgency,
   JobStatus,
   JobSubCategory,
+  ListFilterBranch,
+  ListFilterBranchSchema,
   ListFilterSchema,
   LocationSchema,
   MIN_SALARY_LOWER_BOUND,
   MIN_SALARY_UPPER_BOUND,
   MailingListSchema,
   NotificationChannel,
+  OccurrenceStatus,
   PREFILL_MIRRORED_KEYS,
   PRIVATE_PROFILE_FIELDS,
   PageSchema,
@@ -2949,7 +3311,12 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   StudyType,
   SupportedAnswerChoiceTypes,
   SupportedApplicationReceivePreferences,
+  SupportedBindingKinds,
+  SupportedCampaignAnchorFields,
+  SupportedCampaignEndKinds,
+  SupportedCampaignIntervalUnits,
   SupportedCampaignStatuses,
+  SupportedCampaignTriggerKinds,
   SupportedCompensationTypes,
   SupportedContactTypes,
   SupportedEducationLevels,
@@ -2965,6 +3332,7 @@ var StudentCompletenessSchema = UserCompletenessSchema.omit([
   SupportedJobStatuses,
   SupportedJobSubCategories,
   SupportedNotificationChannels,
+  SupportedOccurrenceStatuses,
   SupportedPageStatuses,
   SupportedPageTypes,
   SupportedPostStatuses,