udp-schema 2.6.0 → 2.7.0

package/dist/progress-fields.d.ts

@@ -10,6 +10,14 @@
 export declare const UDP_PROGRESS_FIELDS: Record<number, readonly string[]>;
 /** Total number of UDP steps */
 export declare const UDP_TOTAL_STEPS = 12;
+/**
+ * Synthetic progress keys — keys that aren't real fields but represent
+ * a group of underlying fields. Counted as "filled" if ANY underlying
+ * field is filled. Used for UI sub-steps that collect multiple fields
+ * at once (e.g. the fullName sub-step that saves firstName, middleName,
+ * and lastName).
+ */
+export declare const UDP_PROGRESS_SYNTHETIC: Record<string, readonly string[]>;
 /**
  * Resolve a dot-path (e.g., "currentAddress.state") against a data object.
  * Works with both plain objects and Mongoose subdocuments.

package/dist/progress-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress-fields.d.ts","sourceRoot":"","sources":["../src/progress-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAoHxD,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAenC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GACnE;IACD,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAeA"}
+{"version":3,"file":"progress-fields.d.ts","sourceRoot":"","sources":["../src/progress-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAoHxD,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAE3D,CAAC;AAEX;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuBnC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GACnE;IACD,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAeA"}

package/dist/progress-fields.js

@@ -9,9 +9,9 @@
  */
 export const UDP_PROGRESS_FIELDS = {
     1: [
-        'firstName',
-        'middleName',
-        'lastName',
+        // 'fullName' is a synthetic key — counts as filled if ANY of
+        // firstName / middleName / lastName is set. See UDP_PROGRESS_SYNTHETIC.
+        'fullName',
         'gender',
         'dateOfBirth',
         'whatsappNumber',
@@ -126,6 +126,16 @@ export const UDP_PROGRESS_FIELDS = {
 };
 /** Total number of UDP steps */
 export const UDP_TOTAL_STEPS = 12;
+/**
+ * Synthetic progress keys — keys that aren't real fields but represent
+ * a group of underlying fields. Counted as "filled" if ANY underlying
+ * field is filled. Used for UI sub-steps that collect multiple fields
+ * at once (e.g. the fullName sub-step that saves firstName, middleName,
+ * and lastName).
+ */
+export const UDP_PROGRESS_SYNTHETIC = {
+    fullName: ['firstName', 'middleName', 'lastName'],
+};
 /**
  * Resolve a dot-path (e.g., "currentAddress.state") against a data object.
  * Works with both plain objects and Mongoose subdocuments.
@@ -175,6 +185,14 @@ export function calculateStepProgress(stepNumber, formData) {
         return { filled: 0, total };
     let filled = 0;
     for (const fieldPath of fields) {
+        // Synthetic keys (e.g., "fullName") — filled if ANY underlying field is filled.
+        const syntheticPaths = UDP_PROGRESS_SYNTHETIC[fieldPath];
+        if (syntheticPaths) {
+            if (syntheticPaths.some((p) => isFieldFilled(getNestedValue(formData, p)))) {
+                filled++;
+            }
+            continue;
+        }
         if (isFieldFilled(getNestedValue(formData, fieldPath))) {
             filled++;
         }

package/dist/progress-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress-fields.js","sourceRoot":"","sources":["../src/progress-fields.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UDP Progress Fields — Single source of truth for step progress counting.\n *\n * Used by both frontend (stepper UI) and backend (computeStepProgressCounts).\n * Each step lists the curated fields that determine filled/total progress.\n *\n * Dot-paths (e.g., \"currentAddress.state\") resolve nested subdocument fields.\n * Only these fields count toward progress — extra fields in the schema are ignored.\n */\n\nexport const UDP_PROGRESS_FIELDS: Record<number, readonly string[]> = {\n  1: [\n    'firstName',\n    'middleName',\n    'lastName',\n    'gender',\n    'dateOfBirth',\n    'whatsappNumber',\n    'primaryLanguage',\n    'secondaryLanguages',\n    'familyReligion',\n    'personalReligion',\n    'reservationStatus',\n    'minorityStatus',\n  ],\n  2: [\n    'politicalSpectrum',\n    'selfPartyAssociation',\n    'familyPartyAssociation',\n    'publicOfficeAndElections',\n    'networkAndCivicEngagement',\n  ],\n  3: [\n    'epicNumber',\n    'willVoteThisTime',\n    'didVoteLastTime',\n    'votingFrequency',\n    'primaryVotingIssues',\n  ],\n  4: [\n    'participateInRevolution',\n    'desiredPoliticalPosition',\n    'leadershipSkillset',\n    'politicalExposure',\n    'comfortWithVisibility',\n    'socialInfluenceLevel',\n    'pastExperience',\n    'changesYouWantToBring',\n  ],\n  5: ['mbtiType', 'oceanScores'],\n  6: [\n    'highestQualification',\n    'education10th.board',\n    'education10th.schoolName',\n    'education10th.yearOfPassing',\n    'education12th.institutionName',\n    'education12th.yearOfPassing',\n    'diplomas',\n    'graduations',\n    'postGraduations',\n    'doctorates',\n    'postDoctorates',\n    'otherCertificates',\n    'educationNotes',\n  ],\n  7: [\n    'employmentStatus',\n    'occupation',\n    'workShift',\n    'comfortableWithShift',\n    'desiredShift',\n    'incomeRange',\n    'dreamOccupation',\n  ],\n  8: [\n    'neurodiverseIdentity',\n    'conditions',\n    'sensoryPreferences',\n    'learningStyle',\n    'communicationPreference',\n    'supportNeeds',\n  ],\n  9: [\n    'disabilityStatus',\n    'generalHealth',\n    'healthInsurance',\n    'diet',\n    'physicalActivity',\n    'sleepQuality',\n    'substanceUse',\n    'stressLevel',\n  ],\n  10: [\n    'viewOnAnimalCruelty',\n    'viewOnLgbtqStatements',\n    'viewOnLgbtqOpinion',\n    'viewOnTransgenderInclusion',\n    'viewOnTransgenderOpinion',\n    'facingCasteDiscrimination',\n    'casteDiscriminationPlaces',\n    'viewOnGenderEquality',\n  ],\n  11: [\n    'currentAddress.state',\n    'currentAddress.district',\n    'currentAddress.village',\n    'permanentAddress.state',\n    'permanentAddress.district',\n    'permanentAddress.village',\n    'homeNativePlace.state',\n    'homeNativePlace.district',\n    'ancestralPlace.state',\n    'ancestralPlace.district',\n  ],\n  12: [\n    'maritalStatus',\n    'familyMembers',\n    'numberOfDependents',\n    'housingType',\n    'householdIncome',\n    'bplCard',\n    'digitalAccess',\n    'migrationStatus',\n    'landOwnership',\n    'primaryIncomeSource',\n  ],\n} as const;\n\n/** Total number of UDP steps */\nexport const UDP_TOTAL_STEPS = 12;\n\n/**\n * Resolve a dot-path (e.g., \"currentAddress.state\") against a data object.\n * Works with both plain objects and Mongoose subdocuments.\n */\nexport function getNestedValue(obj: Record<string, unknown>, path: string): unknown {\n  const parts = path.split('.');\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (current === null || current === undefined || typeof current !== 'object') {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current;\n}\n\n/** Determine if a field value counts as \"filled\" for progress */\nexport function isFieldFilled(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n  if (typeof value === 'string') return value.trim().length > 0;\n  if (typeof value === 'number') return true;\n  if (typeof value === 'boolean') return true;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') {\n    // Area entity ref - check for name\n    if ('name' in value && typeof (value as Record<string, unknown>).name === 'string') {\n      return (value as Record<string, unknown>).name !== '';\n    }\n    return Object.keys(value).length > 0;\n  }\n  return false;\n}\n\n/**\n * Calculate progress for a single step.\n * Shared between frontend (stepper UI) and backend (API response).\n */\nexport function calculateStepProgress(\n  stepNumber: number,\n  formData: Record<string, unknown> | undefined | null,\n): { filled: number; total: number } {\n  const fields = UDP_PROGRESS_FIELDS[stepNumber];\n  if (!fields) return { filled: 0, total: 0 };\n\n  const total = fields.length;\n  if (!formData || total === 0) return { filled: 0, total };\n\n  let filled = 0;\n  for (const fieldPath of fields) {\n    if (isFieldFilled(getNestedValue(formData, fieldPath))) {\n      filled++;\n    }\n  }\n\n  return { filled, total };\n}\n\n/**\n * Calculate overall progress across all steps.\n * Returns per-step breakdown + overall percentage.\n *\n * Mirrors dating-schema's calculateDatingOverallProgress().\n *\n * @param stepData - Map of step number → form data (e.g., { 1: {...}, 2: {...} })\n */\nexport function calculateOverallProgress(\n  stepData: Record<number, Record<string, unknown> | undefined | null>,\n): {\n  steps: { stepNumber: number; filled: number; total: number }[];\n  totalFilled: number;\n  totalFields: number;\n  percent: number;\n} {\n  const steps: { stepNumber: number; filled: number; total: number }[] = [];\n  let totalFilled = 0;\n  let totalFields = 0;\n\n  for (let stepNumber = 1; stepNumber <= UDP_TOTAL_STEPS; stepNumber++) {\n    const { filled, total } = calculateStepProgress(stepNumber, stepData[stepNumber]);\n    steps.push({ stepNumber, filled, total });\n    totalFilled += filled;\n    totalFields += total;\n  }\n\n  const percent = totalFields > 0 ? Math.round((totalFilled / totalFields) * 100) : 0;\n\n  return { steps, totalFilled, totalFields, percent };\n}\n"]}
+{"version":3,"file":"progress-fields.js","sourceRoot":"","sources":["../src/progress-fields.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UDP Progress Fields — Single source of truth for step progress counting.\n *\n * Used by both frontend (stepper UI) and backend (computeStepProgressCounts).\n * Each step lists the curated fields that determine filled/total progress.\n *\n * Dot-paths (e.g., \"currentAddress.state\") resolve nested subdocument fields.\n * Only these fields count toward progress — extra fields in the schema are ignored.\n */\n\nexport const UDP_PROGRESS_FIELDS: Record<number, readonly string[]> = {\n  1: [\n    // 'fullName' is a synthetic key — counts as filled if ANY of\n    // firstName / middleName / lastName is set. See UDP_PROGRESS_SYNTHETIC.\n    'fullName',\n    'gender',\n    'dateOfBirth',\n    'whatsappNumber',\n    'primaryLanguage',\n    'secondaryLanguages',\n    'familyReligion',\n    'personalReligion',\n    'reservationStatus',\n    'minorityStatus',\n  ],\n  2: [\n    'politicalSpectrum',\n    'selfPartyAssociation',\n    'familyPartyAssociation',\n    'publicOfficeAndElections',\n    'networkAndCivicEngagement',\n  ],\n  3: [\n    'epicNumber',\n    'willVoteThisTime',\n    'didVoteLastTime',\n    'votingFrequency',\n    'primaryVotingIssues',\n  ],\n  4: [\n    'participateInRevolution',\n    'desiredPoliticalPosition',\n    'leadershipSkillset',\n    'politicalExposure',\n    'comfortWithVisibility',\n    'socialInfluenceLevel',\n    'pastExperience',\n    'changesYouWantToBring',\n  ],\n  5: ['mbtiType', 'oceanScores'],\n  6: [\n    'highestQualification',\n    'education10th.board',\n    'education10th.schoolName',\n    'education10th.yearOfPassing',\n    'education12th.institutionName',\n    'education12th.yearOfPassing',\n    'diplomas',\n    'graduations',\n    'postGraduations',\n    'doctorates',\n    'postDoctorates',\n    'otherCertificates',\n    'educationNotes',\n  ],\n  7: [\n    'employmentStatus',\n    'occupation',\n    'workShift',\n    'comfortableWithShift',\n    'desiredShift',\n    'incomeRange',\n    'dreamOccupation',\n  ],\n  8: [\n    'neurodiverseIdentity',\n    'conditions',\n    'sensoryPreferences',\n    'learningStyle',\n    'communicationPreference',\n    'supportNeeds',\n  ],\n  9: [\n    'disabilityStatus',\n    'generalHealth',\n    'healthInsurance',\n    'diet',\n    'physicalActivity',\n    'sleepQuality',\n    'substanceUse',\n    'stressLevel',\n  ],\n  10: [\n    'viewOnAnimalCruelty',\n    'viewOnLgbtqStatements',\n    'viewOnLgbtqOpinion',\n    'viewOnTransgenderInclusion',\n    'viewOnTransgenderOpinion',\n    'facingCasteDiscrimination',\n    'casteDiscriminationPlaces',\n    'viewOnGenderEquality',\n  ],\n  11: [\n    'currentAddress.state',\n    'currentAddress.district',\n    'currentAddress.village',\n    'permanentAddress.state',\n    'permanentAddress.district',\n    'permanentAddress.village',\n    'homeNativePlace.state',\n    'homeNativePlace.district',\n    'ancestralPlace.state',\n    'ancestralPlace.district',\n  ],\n  12: [\n    'maritalStatus',\n    'familyMembers',\n    'numberOfDependents',\n    'housingType',\n    'householdIncome',\n    'bplCard',\n    'digitalAccess',\n    'migrationStatus',\n    'landOwnership',\n    'primaryIncomeSource',\n  ],\n} as const;\n\n/** Total number of UDP steps */\nexport const UDP_TOTAL_STEPS = 12;\n\n/**\n * Synthetic progress keys — keys that aren't real fields but represent\n * a group of underlying fields. Counted as \"filled\" if ANY underlying\n * field is filled. Used for UI sub-steps that collect multiple fields\n * at once (e.g. the fullName sub-step that saves firstName, middleName,\n * and lastName).\n */\nexport const UDP_PROGRESS_SYNTHETIC: Record<string, readonly string[]> = {\n  fullName: ['firstName', 'middleName', 'lastName'],\n} as const;\n\n/**\n * Resolve a dot-path (e.g., \"currentAddress.state\") against a data object.\n * Works with both plain objects and Mongoose subdocuments.\n */\nexport function getNestedValue(obj: Record<string, unknown>, path: string): unknown {\n  const parts = path.split('.');\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (current === null || current === undefined || typeof current !== 'object') {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current;\n}\n\n/** Determine if a field value counts as \"filled\" for progress */\nexport function isFieldFilled(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n  if (typeof value === 'string') return value.trim().length > 0;\n  if (typeof value === 'number') return true;\n  if (typeof value === 'boolean') return true;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') {\n    // Area entity ref - check for name\n    if ('name' in value && typeof (value as Record<string, unknown>).name === 'string') {\n      return (value as Record<string, unknown>).name !== '';\n    }\n    return Object.keys(value).length > 0;\n  }\n  return false;\n}\n\n/**\n * Calculate progress for a single step.\n * Shared between frontend (stepper UI) and backend (API response).\n */\nexport function calculateStepProgress(\n  stepNumber: number,\n  formData: Record<string, unknown> | undefined | null,\n): { filled: number; total: number } {\n  const fields = UDP_PROGRESS_FIELDS[stepNumber];\n  if (!fields) return { filled: 0, total: 0 };\n\n  const total = fields.length;\n  if (!formData || total === 0) return { filled: 0, total };\n\n  let filled = 0;\n  for (const fieldPath of fields) {\n    // Synthetic keys (e.g., \"fullName\") — filled if ANY underlying field is filled.\n    const syntheticPaths = UDP_PROGRESS_SYNTHETIC[fieldPath];\n    if (syntheticPaths) {\n      if (syntheticPaths.some((p) => isFieldFilled(getNestedValue(formData, p)))) {\n        filled++;\n      }\n      continue;\n    }\n    if (isFieldFilled(getNestedValue(formData, fieldPath))) {\n      filled++;\n    }\n  }\n\n  return { filled, total };\n}\n\n/**\n * Calculate overall progress across all steps.\n * Returns per-step breakdown + overall percentage.\n *\n * Mirrors dating-schema's calculateDatingOverallProgress().\n *\n * @param stepData - Map of step number → form data (e.g., { 1: {...}, 2: {...} })\n */\nexport function calculateOverallProgress(\n  stepData: Record<number, Record<string, unknown> | undefined | null>,\n): {\n  steps: { stepNumber: number; filled: number; total: number }[];\n  totalFilled: number;\n  totalFields: number;\n  percent: number;\n} {\n  const steps: { stepNumber: number; filled: number; total: number }[] = [];\n  let totalFilled = 0;\n  let totalFields = 0;\n\n  for (let stepNumber = 1; stepNumber <= UDP_TOTAL_STEPS; stepNumber++) {\n    const { filled, total } = calculateStepProgress(stepNumber, stepData[stepNumber]);\n    steps.push({ stepNumber, filled, total });\n    totalFilled += filled;\n    totalFields += total;\n  }\n\n  const percent = totalFields > 0 ? Math.round((totalFilled / totalFields) * 100) : 0;\n\n  return { steps, totalFilled, totalFields, percent };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "udp-schema",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Shared Zod schemas for User Detailed Profile (frontend + backend).",
   "type": "module",
   "main": "./dist/index.js",