udp-schema 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# udp-schema
+
+Shared Zod validation schemas for the **User Detailed Profile** feature.
+
+Used by both `survey-frontend` and `survey-backend` so that field names,
+validation rules, and inferred TypeScript types are always in sync.
+
+## Schemas
+
+| Export | Description |
+|--------|-------------|
+| `step01OnboardingSchema` | Step 1 – profile, photo, languages, Aadhaar |
+| `step02ContactDetailsSchema` | Step 2 – WhatsApp, social media, emergency contact |
+| `step03ResidenceSchema` | Step 3 – domicile, current & permanent address |
+
+## Usage
+
+```ts
+import { step01OnboardingSchema, type Step01OnboardingInput } from 'udp-schema';
+
+const parsed = step01OnboardingSchema.parse(reqBody);
+```
+
+## Development
+
+```bash
+npm install
+npm run build     # compiles to dist/
+npm run type-check
+```

package/dist/helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared helper utilities for Zod schema preprocessing.
+ *
+ * @module udp-schema/helpers
+ */
+import { z } from 'zod';
+/**
+ * Converts empty / whitespace-only strings to `undefined`
+ * so Zod `.optional()` treats them as "not provided".
+ */
+export declare const emptyStringToUndefined: (value: unknown) => unknown;
+/**
+ * Optional trimmed string with 100-char max.
+ * Empty strings are coerced to `undefined`.
+ */
+export declare const optionalTrimmedString: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,OAKvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,yEAGjC,CAAC"}

package/dist/helpers.js

@@ -0,0 +1,22 @@
+/**
+ * Shared helper utilities for Zod schema preprocessing.
+ *
+ * @module udp-schema/helpers
+ */
+import { z } from 'zod';
+/**
+ * Converts empty / whitespace-only strings to `undefined`
+ * so Zod `.optional()` treats them as "not provided".
+ */
+export const emptyStringToUndefined = (value) => {
+    if (typeof value === 'string' && value.trim() === '') {
+        return undefined;
+    }
+    return value;
+};
+/**
+ * Optional trimmed string with 100-char max.
+ * Empty strings are coerced to `undefined`.
+ */
+export const optionalTrimmedString = z.preprocess(emptyStringToUndefined, z.string().trim().max(100).optional());
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAW,EAAE;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,UAAU,CAC/C,sBAAsB,EACtB,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CACtC,CAAC","sourcesContent":["/**\n * Shared helper utilities for Zod schema preprocessing.\n *\n * @module udp-schema/helpers\n */\n\nimport { z } from 'zod';\n\n/**\n * Converts empty / whitespace-only strings to `undefined`\n * so Zod `.optional()` treats them as \"not provided\".\n */\nexport const emptyStringToUndefined = (value: unknown): unknown => {\n  if (typeof value === 'string' && value.trim() === '') {\n    return undefined;\n  }\n  return value;\n};\n\n/**\n * Optional trimmed string with 100-char max.\n * Empty strings are coerced to `undefined`.\n */\nexport const optionalTrimmedString = z.preprocess(\n  emptyStringToUndefined,\n  z.string().trim().max(100).optional(),\n);\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * udp-schema — Shared Zod schemas for User Detailed Profile
+ *
+ * Single source of truth consumed by both survey-frontend and survey-backend.
+ *
+ * @module udp-schema
+ */
+export { emptyStringToUndefined, optionalTrimmedString } from './helpers.js';
+export { assistedBySurveyorSchema, languageValueSchema, profilePhotoSchema, type Step01OnboardingFormInput, type Step01OnboardingInput, secondaryLanguageItemSchema, step01OnboardingSchema, } from './step-01.schema.js';
+export { optionalUrlSchema, type Step02ContactDetailsInput, step02ContactDetailsSchema, } from './step-02.schema.js';
+export { type AddressInput, addressSchema, areaRefSchema, type Step03ResidenceInput, step03ResidenceSchema, } from './step-03.schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,KAAK,yBAAyB,EAC9B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,YAAY,EACjB,aAAa,EACb,aAAa,EACb,KAAK,oBAAoB,EACzB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * udp-schema — Shared Zod schemas for User Detailed Profile
+ *
+ * Single source of truth consumed by both survey-frontend and survey-backend.
+ *
+ * @module udp-schema
+ */
+// Helpers
+export { emptyStringToUndefined, optionalTrimmedString } from './helpers.js';
+// Step 01 — Profile Onboarding
+export { assistedBySurveyorSchema, languageValueSchema, profilePhotoSchema, secondaryLanguageItemSchema, step01OnboardingSchema, } from './step-01.schema.js';
+// Step 02 — Contact Details
+export { optionalUrlSchema, step02ContactDetailsSchema, } from './step-02.schema.js';
+// Step 03 — Residence / Address
+export { addressSchema, areaRefSchema, step03ResidenceSchema, } from './step-03.schema.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU;AACV,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE7E,+BAA+B;AAC/B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAGlB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EAEjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,gCAAgC;AAChC,OAAO,EAEL,aAAa,EACb,aAAa,EAEb,qBAAqB,GACtB,MAAM,qBAAqB,CAAC","sourcesContent":["/**\n * udp-schema — Shared Zod schemas for User Detailed Profile\n *\n * Single source of truth consumed by both survey-frontend and survey-backend.\n *\n * @module udp-schema\n */\n\n// Helpers\nexport { emptyStringToUndefined, optionalTrimmedString } from './helpers.js';\n\n// Step 01 — Profile Onboarding\nexport {\n  assistedBySurveyorSchema,\n  languageValueSchema,\n  profilePhotoSchema,\n  type Step01OnboardingFormInput,\n  type Step01OnboardingInput,\n  secondaryLanguageItemSchema,\n  step01OnboardingSchema,\n} from './step-01.schema.js';\n\n// Step 02 — Contact Details\nexport {\n  optionalUrlSchema,\n  type Step02ContactDetailsInput,\n  step02ContactDetailsSchema,\n} from './step-02.schema.js';\n\n// Step 03 — Residence / Address\nexport {\n  type AddressInput,\n  addressSchema,\n  areaRefSchema,\n  type Step03ResidenceInput,\n  step03ResidenceSchema,\n} from './step-03.schema.js';\n"]}

package/dist/step-01.schema.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Step 01 — Profile Onboarding Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ * Field names match the MongoDB document keys exactly.
+ *
+ * @module udp-schema/step-01
+ */
+import { z } from 'zod';
+/** Language value (code / nativeName / englishName / script). */
+export declare const languageValueSchema: z.ZodObject<{
+    code: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    nativeName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    englishName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    script: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/** One entry in the secondaryLanguages array. */
+export declare const secondaryLanguageItemSchema: z.ZodObject<{
+    language: z.ZodObject<{
+        code: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        nativeName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        englishName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        script: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>;
+    fluency: z.ZodEnum<{
+        basic: "basic";
+        conversational: "conversational";
+        professional: "professional";
+        native: "native";
+    }>;
+    canSpeak: z.ZodOptional<z.ZodBoolean>;
+    canRead: z.ZodOptional<z.ZodBoolean>;
+    canWrite: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Profile photo — accepts either:
+ *   • a plain URL string  (returned by backend on prefill)
+ *   • an upload-result object (sent after fresh upload)
+ */
+export declare const profilePhotoSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    assetId: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>>;
+/** Surveyor who assisted with the form. */
+export declare const assistedBySurveyorSchema: z.ZodOptional<z.ZodObject<{
+    surveyorId: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        selected: "selected";
+        manual: "manual";
+    }>>;
+}, z.core.$strip>>;
+export declare const step01OnboardingSchema: z.ZodObject<{
+    email: z.ZodString;
+    firstName: z.ZodString;
+    middleName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    lastName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    gender: z.ZodOptional<z.ZodEnum<{
+        male: "male";
+        female: "female";
+        other: "other";
+        prefer_not: "prefer_not";
+    }>>;
+    dateOfBirth: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodCoercedDate<unknown>>>;
+    aadhaarNumber: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    profilePhotoUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        assetId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    assistedBySurveyor: z.ZodOptional<z.ZodObject<{
+        surveyorId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            selected: "selected";
+            manual: "manual";
+        }>>;
+    }, z.core.$strip>>;
+    primaryLanguage: z.ZodOptional<z.ZodObject<{
+        code: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        nativeName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        englishName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        script: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    secondaryLanguages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        language: z.ZodObject<{
+            code: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+            nativeName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+            englishName: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+            script: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>;
+        fluency: z.ZodEnum<{
+            basic: "basic";
+            conversational: "conversational";
+            professional: "professional";
+            native: "native";
+        }>;
+        canSpeak: z.ZodOptional<z.ZodBoolean>;
+        canRead: z.ZodOptional<z.ZodBoolean>;
+        canWrite: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Step01OnboardingInput = z.infer<typeof step01OnboardingSchema>;
+export type Step01OnboardingFormInput = z.input<typeof step01OnboardingSchema>;
+//# sourceMappingURL=step-01.schema.d.ts.map

package/dist/step-01.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-01.schema.d.ts","sourceRoot":"","sources":["../src/step-01.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,iEAAiE;AACjE,eAAO,MAAM,mBAAmB;;;;;iBAU7B,CAAC;AAEJ,iDAAiD;AACjD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;iBAMtC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;oBAUlB,CAAC;AAEd,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB;;;;;;;kBAMxB,CAAC;AAId,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDjC,CAAC;AAIH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/step-01.schema.js

@@ -0,0 +1,102 @@
+/**
+ * Step 01 — Profile Onboarding Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ * Field names match the MongoDB document keys exactly.
+ *
+ * @module udp-schema/step-01
+ */
+import { z } from 'zod';
+import { emptyStringToUndefined, optionalTrimmedString } from './helpers.js';
+// ─── Sub-schemas ────────────────────────────────────────
+/** Language value (code / nativeName / englishName / script). */
+export const languageValueSchema = z
+    .object({
+    code: optionalTrimmedString,
+    nativeName: optionalTrimmedString,
+    englishName: optionalTrimmedString,
+    script: optionalTrimmedString,
+})
+    .refine((v) => Boolean(v.code || v.nativeName || v.englishName), 'Language must include at least code, native name, or english name');
+/** One entry in the secondaryLanguages array. */
+export const secondaryLanguageItemSchema = z.object({
+    language: languageValueSchema,
+    fluency: z.enum(['basic', 'conversational', 'professional', 'native']),
+    canSpeak: z.boolean().optional(),
+    canRead: z.boolean().optional(),
+    canWrite: z.boolean().optional(),
+});
+/**
+ * Profile photo — accepts either:
+ *   • a plain URL string  (returned by backend on prefill)
+ *   • an upload-result object (sent after fresh upload)
+ */
+export const profilePhotoSchema = z
+    .union([
+    z.string(),
+    z.object({
+        assetId: z.string().trim().optional(),
+        url: z.string().trim().optional(),
+        mimeType: z.string().trim().optional(),
+        sizeBytes: z.number().min(0).optional(),
+    }),
+])
+    .optional();
+/** Surveyor who assisted with the form. */
+export const assistedBySurveyorSchema = z
+    .object({
+    surveyorId: z.string().optional(),
+    displayName: optionalTrimmedString,
+    source: z.enum(['selected', 'manual']).optional(),
+})
+    .optional();
+// ─── Main step-01 schema ────────────────────────────────
+export const step01OnboardingSchema = z.object({
+    email: z.string().trim().toLowerCase().email('Enter a valid email address'),
+    firstName: z
+        .string()
+        .trim()
+        .min(1, 'First name is required')
+        .max(50, 'First name must be at most 50 characters'),
+    middleName: optionalTrimmedString,
+    lastName: optionalTrimmedString,
+    gender: z.enum(['male', 'female', 'other', 'prefer_not']).optional(),
+    dateOfBirth: z.preprocess(emptyStringToUndefined, z.coerce.date().optional()),
+    aadhaarNumber: z.preprocess((value) => {
+        const normalized = emptyStringToUndefined(value);
+        if (typeof normalized === 'string') {
+            return normalized.replace(/\D/g, '');
+        }
+        return normalized;
+    }, z
+        .string()
+        .regex(/^\d{12}$/, 'Aadhaar must be exactly 12 digits')
+        .optional()),
+    profilePhotoUrl: profilePhotoSchema,
+    assistedBySurveyor: assistedBySurveyorSchema,
+    primaryLanguage: languageValueSchema.optional(),
+    secondaryLanguages: z
+        .array(secondaryLanguageItemSchema)
+        .max(5, 'You can add up to 5 secondary languages')
+        .optional()
+        .superRefine((items, context) => {
+        if (!items)
+            return;
+        const seenCodes = new Map();
+        items.forEach((item, index) => {
+            const code = item.language.code?.toLowerCase();
+            if (!code)
+                return;
+            if (seenCodes.has(code)) {
+                context.addIssue({
+                    code: 'custom',
+                    path: [index, 'language', 'code'],
+                    message: 'Duplicate secondary language is not allowed',
+                });
+                return;
+            }
+            seenCodes.set(code, index);
+        });
+    }),
+});
+//# sourceMappingURL=step-01.schema.js.map

package/dist/step-01.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-01.schema.js","sourceRoot":"","sources":["../src/step-01.schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Step 01 — Profile Onboarding Schema\n *\n * Single source of truth used by both frontend and backend.\n * Field names match the MongoDB document keys exactly.\n *\n * @module udp-schema/step-01\n */\n\nimport { z } from 'zod';\nimport { emptyStringToUndefined, optionalTrimmedString } from './helpers.js';\n\n// ─── Sub-schemas ────────────────────────────────────────\n\n/** Language value (code / nativeName / englishName / script). */\nexport const languageValueSchema = z\n  .object({\n    code: optionalTrimmedString,\n    nativeName: optionalTrimmedString,\n    englishName: optionalTrimmedString,\n    script: optionalTrimmedString,\n  })\n  .refine(\n    (v) => Boolean(v.code || v.nativeName || v.englishName),\n    'Language must include at least code, native name, or english name',\n  );\n\n/** One entry in the secondaryLanguages array. */\nexport const secondaryLanguageItemSchema = z.object({\n  language: languageValueSchema,\n  fluency: z.enum(['basic', 'conversational', 'professional', 'native']),\n  canSpeak: z.boolean().optional(),\n  canRead: z.boolean().optional(),\n  canWrite: z.boolean().optional(),\n});\n\n/**\n * Profile photo — accepts either:\n *   • a plain URL string  (returned by backend on prefill)\n *   • an upload-result object (sent after fresh upload)\n */\nexport const profilePhotoSchema = z\n  .union([\n    z.string(),\n    z.object({\n      assetId: z.string().trim().optional(),\n      url: z.string().trim().optional(),\n      mimeType: z.string().trim().optional(),\n      sizeBytes: z.number().min(0).optional(),\n    }),\n  ])\n  .optional();\n\n/** Surveyor who assisted with the form. */\nexport const assistedBySurveyorSchema = z\n  .object({\n    surveyorId: z.string().optional(),\n    displayName: optionalTrimmedString,\n    source: z.enum(['selected', 'manual']).optional(),\n  })\n  .optional();\n\n// ─── Main step-01 schema ────────────────────────────────\n\nexport const step01OnboardingSchema = z.object({\n  email: z.string().trim().toLowerCase().email('Enter a valid email address'),\n  firstName: z\n    .string()\n    .trim()\n    .min(1, 'First name is required')\n    .max(50, 'First name must be at most 50 characters'),\n  middleName: optionalTrimmedString,\n  lastName: optionalTrimmedString,\n  gender: z.enum(['male', 'female', 'other', 'prefer_not']).optional(),\n  dateOfBirth: z.preprocess(emptyStringToUndefined, z.coerce.date().optional()),\n  aadhaarNumber: z.preprocess(\n    (value) => {\n      const normalized = emptyStringToUndefined(value);\n      if (typeof normalized === 'string') {\n        return normalized.replace(/\\D/g, '');\n      }\n      return normalized;\n    },\n    z\n      .string()\n      .regex(/^\\d{12}$/, 'Aadhaar must be exactly 12 digits')\n      .optional(),\n  ),\n  profilePhotoUrl: profilePhotoSchema,\n  assistedBySurveyor: assistedBySurveyorSchema,\n  primaryLanguage: languageValueSchema.optional(),\n  secondaryLanguages: z\n    .array(secondaryLanguageItemSchema)\n    .max(5, 'You can add up to 5 secondary languages')\n    .optional()\n    .superRefine((items, context) => {\n      if (!items) return;\n      const seenCodes = new Map<string, number>();\n      items.forEach((item, index) => {\n        const code = item.language.code?.toLowerCase();\n        if (!code) return;\n        if (seenCodes.has(code)) {\n          context.addIssue({\n            code: 'custom',\n            path: [index, 'language', 'code'],\n            message: 'Duplicate secondary language is not allowed',\n          });\n          return;\n        }\n        seenCodes.set(code, index);\n      });\n    }),\n});\n\n// ─── Inferred types ─────────────────────────────────────\n\nexport type Step01OnboardingInput = z.infer<typeof step01OnboardingSchema>;\nexport type Step01OnboardingFormInput = z.input<typeof step01OnboardingSchema>;\n"]}

package/dist/step-02.schema.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Step 02 — Contact Details Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ *
+ * @module udp-schema/step-02
+ */
+import { z } from 'zod';
+/** Accepts a valid URL, an empty string, or undefined. */
+export declare const optionalUrlSchema: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+export declare const step02ContactDetailsSchema: z.ZodObject<{
+    whatsappSameAsPrimary: z.ZodOptional<z.ZodBoolean>;
+    whatsappNumber: z.ZodOptional<z.ZodString>;
+    socialMedia: z.ZodObject<{
+        facebook: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+        twitter: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+        instagram: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+        linkedin: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+        youtube: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">, z.ZodUndefined]>;
+    }, z.core.$strip>;
+    emergencyContact: z.ZodObject<{
+        contactName: z.ZodOptional<z.ZodString>;
+        contactRelation: z.ZodOptional<z.ZodString>;
+        contactPhone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Step02ContactDetailsInput = z.infer<typeof step02ContactDetailsSchema>;
+//# sourceMappingURL=step-02.schema.d.ts.map

package/dist/step-02.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-02.schema.d.ts","sourceRoot":"","sources":["../src/step-02.schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,sEAI5B,CAAC;AAIH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;iBAerC,CAAC;AAIH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/step-02.schema.js

@@ -0,0 +1,33 @@
+/**
+ * Step 02 — Contact Details Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ *
+ * @module udp-schema/step-02
+ */
+import { z } from 'zod';
+// ─── Sub-schemas ────────────────────────────────────────
+/** Accepts a valid URL, an empty string, or undefined. */
+export const optionalUrlSchema = z.union([
+    z.string().url('Enter a valid URL'),
+    z.literal(''),
+    z.undefined(),
+]);
+// ─── Main step-02 schema ────────────────────────────────
+export const step02ContactDetailsSchema = z.object({
+    whatsappSameAsPrimary: z.boolean().optional(),
+    whatsappNumber: z.string().trim().optional(),
+    socialMedia: z.object({
+        facebook: optionalUrlSchema,
+        twitter: optionalUrlSchema,
+        instagram: optionalUrlSchema,
+        linkedin: optionalUrlSchema,
+        youtube: optionalUrlSchema,
+    }),
+    emergencyContact: z.object({
+        contactName: z.string().trim().optional(),
+        contactRelation: z.string().trim().optional(),
+        contactPhone: z.string().trim().optional(),
+    }),
+});
+//# sourceMappingURL=step-02.schema.js.map

package/dist/step-02.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-02.schema.js","sourceRoot":"","sources":["../src/step-02.schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2DAA2D;AAE3D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACnC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACb,CAAC,CAAC,SAAS,EAAE;CACd,CAAC,CAAC;AAEH,2DAA2D;AAE3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,iBAAiB;KAC3B,CAAC;IACF,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC;QACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QACzC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QAC7C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;KAC3C,CAAC;CACH,CAAC,CAAC","sourcesContent":["/**\n * Step 02 — Contact Details Schema\n *\n * Single source of truth used by both frontend and backend.\n *\n * @module udp-schema/step-02\n */\n\nimport { z } from 'zod';\n\n// ─── Sub-schemas ────────────────────────────────────────\n\n/** Accepts a valid URL, an empty string, or undefined. */\nexport const optionalUrlSchema = z.union([\n  z.string().url('Enter a valid URL'),\n  z.literal(''),\n  z.undefined(),\n]);\n\n// ─── Main step-02 schema ────────────────────────────────\n\nexport const step02ContactDetailsSchema = z.object({\n  whatsappSameAsPrimary: z.boolean().optional(),\n  whatsappNumber: z.string().trim().optional(),\n  socialMedia: z.object({\n    facebook: optionalUrlSchema,\n    twitter: optionalUrlSchema,\n    instagram: optionalUrlSchema,\n    linkedin: optionalUrlSchema,\n    youtube: optionalUrlSchema,\n  }),\n  emergencyContact: z.object({\n    contactName: z.string().trim().optional(),\n    contactRelation: z.string().trim().optional(),\n    contactPhone: z.string().trim().optional(),\n  }),\n});\n\n// ─── Inferred types ─────────────────────────────────────\n\nexport type Step02ContactDetailsInput = z.infer<typeof step02ContactDetailsSchema>;\n"]}

package/dist/step-03.schema.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Step 03 — Residence / Address Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ *
+ * @module udp-schema/step-03
+ */
+import { z } from 'zod';
+/**
+ * Area entity reference — accepts:
+ *   • `{ _id, name }` — existing area entity selected in frontend
+ *   • `{ name }`      — custom / manually entered
+ *   • raw string      — legacy ObjectId stored in DB
+ */
+export declare const areaRefSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    _id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$loose>, z.ZodString]>>;
+/** Full address block (current or permanent). */
+export declare const addressSchema: z.ZodObject<{
+    country: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    areaType: z.ZodOptional<z.ZodEnum<{
+        RURAL: "RURAL";
+        URBAN: "URBAN";
+    }>>;
+    division: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    district: z.ZodOptional<z.ZodString>;
+    tehsil: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    block: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    gramPanchayat: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    village: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    hamlet: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    ruralWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    urbanBody: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    urbanWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    locality: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        _id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>, z.ZodString]>>;
+    housePlotDetails: z.ZodOptional<z.ZodString>;
+    pincode: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    landmark: z.ZodOptional<z.ZodString>;
+    directions: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    longitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const step03ResidenceSchema: z.ZodObject<{
+    domicileSource: z.ZodOptional<z.ZodEnum<{
+        BIRTH_PLACE: "BIRTH_PLACE";
+        HOME_NATIVE_PLACE: "HOME_NATIVE_PLACE";
+        ANCESTRAL_NATIVE_PLACE: "ANCESTRAL_NATIVE_PLACE";
+    }>>;
+    birthPlace: z.ZodOptional<z.ZodString>;
+    homeNativePlace: z.ZodOptional<z.ZodString>;
+    ancestralNativePlace: z.ZodOptional<z.ZodString>;
+    yearsAtCurrentAddress: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    sameAsCurrentAddress: z.ZodOptional<z.ZodBoolean>;
+    currentAddress: z.ZodObject<{
+        country: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        areaType: z.ZodOptional<z.ZodEnum<{
+            RURAL: "RURAL";
+            URBAN: "URBAN";
+        }>>;
+        division: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        district: z.ZodOptional<z.ZodString>;
+        tehsil: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        block: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        gramPanchayat: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        village: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        hamlet: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        ruralWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        urbanBody: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        urbanWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        locality: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        housePlotDetails: z.ZodOptional<z.ZodString>;
+        pincode: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+        landmark: z.ZodOptional<z.ZodString>;
+        directions: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        longitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+    permanentAddress: z.ZodObject<{
+        country: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        areaType: z.ZodOptional<z.ZodEnum<{
+            RURAL: "RURAL";
+            URBAN: "URBAN";
+        }>>;
+        division: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        district: z.ZodOptional<z.ZodString>;
+        tehsil: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        block: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        gramPanchayat: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        village: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        hamlet: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        ruralWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        urbanBody: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        urbanWard: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        locality: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            _id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$loose>, z.ZodString]>>;
+        housePlotDetails: z.ZodOptional<z.ZodString>;
+        pincode: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+        landmark: z.ZodOptional<z.ZodString>;
+        directions: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        longitude: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+    addressNotes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Step03ResidenceInput = z.infer<typeof step03ResidenceSchema>;
+export type AddressInput = z.infer<typeof addressSchema>;
+//# sourceMappingURL=step-03.schema.d.ts.map

package/dist/step-03.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-03.schema.d.ts","sourceRoot":"","sources":["../src/step-03.schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;iCAMb,CAAC;AAEd,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BxB,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUhC,CAAC;AAIH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/step-03.schema.js

@@ -0,0 +1,66 @@
+/**
+ * Step 03 — Residence / Address Schema
+ *
+ * Single source of truth used by both frontend and backend.
+ *
+ * @module udp-schema/step-03
+ */
+import { z } from 'zod';
+// ─── Sub-schemas ────────────────────────────────────────
+/**
+ * Area entity reference — accepts:
+ *   • `{ _id, name }` — existing area entity selected in frontend
+ *   • `{ name }`      — custom / manually entered
+ *   • raw string      — legacy ObjectId stored in DB
+ */
+export const areaRefSchema = z
+    .union([
+    z.object({ _id: z.string(), name: z.string().trim().min(1) }).passthrough(),
+    z.object({ name: z.string().trim().min(1) }).passthrough(),
+    z.string().trim().min(1),
+])
+    .optional();
+/** Full address block (current or permanent). */
+export const addressSchema = z.object({
+    country: z.string().trim().optional(),
+    state: z.string().trim().optional(),
+    areaType: z.enum(['RURAL', 'URBAN']).optional(),
+    division: areaRefSchema,
+    district: z.string().trim().optional(),
+    tehsil: areaRefSchema,
+    // Rural
+    block: areaRefSchema,
+    gramPanchayat: areaRefSchema,
+    village: areaRefSchema,
+    hamlet: areaRefSchema,
+    ruralWard: areaRefSchema,
+    // Urban
+    urbanBody: areaRefSchema,
+    urbanWard: areaRefSchema,
+    locality: areaRefSchema,
+    // Details
+    housePlotDetails: z.string().trim().optional(),
+    pincode: z
+        .string()
+        .trim()
+        .regex(/^\d{6}$/, 'Pincode must be 6 digits')
+        .optional()
+        .or(z.literal('')),
+    landmark: z.string().trim().optional(),
+    directions: z.string().trim().optional(),
+    latitude: z.coerce.number().min(-90).max(90).optional(),
+    longitude: z.coerce.number().min(-180).max(180).optional(),
+});
+// ─── Main step-03 schema ────────────────────────────────
+export const step03ResidenceSchema = z.object({
+    domicileSource: z.enum(['BIRTH_PLACE', 'HOME_NATIVE_PLACE', 'ANCESTRAL_NATIVE_PLACE']).optional(),
+    birthPlace: z.string().trim().optional(),
+    homeNativePlace: z.string().trim().optional(),
+    ancestralNativePlace: z.string().trim().optional(),
+    yearsAtCurrentAddress: z.coerce.number().min(0).max(120).optional(),
+    sameAsCurrentAddress: z.boolean().optional(),
+    currentAddress: addressSchema,
+    permanentAddress: addressSchema,
+    addressNotes: z.string().trim().optional(),
+});
+//# sourceMappingURL=step-03.schema.js.map

package/dist/step-03.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-03.schema.js","sourceRoot":"","sources":["../src/step-03.schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Step 03 — Residence / Address Schema\n *\n * Single source of truth used by both frontend and backend.\n *\n * @module udp-schema/step-03\n */\n\nimport { z } from 'zod';\n\n// ─── Sub-schemas ────────────────────────────────────────\n\n/**\n * Area entity reference — accepts:\n *   • `{ _id, name }` — existing area entity selected in frontend\n *   • `{ name }`      — custom / manually entered\n *   • raw string      — legacy ObjectId stored in DB\n */\nexport const areaRefSchema = z\n  .union([\n    z.object({ _id: z.string(), name: z.string().trim().min(1) }).passthrough(),\n    z.object({ name: z.string().trim().min(1) }).passthrough(),\n    z.string().trim().min(1),\n  ])\n  .optional();\n\n/** Full address block (current or permanent). */\nexport const addressSchema = z.object({\n  country: z.string().trim().optional(),\n  state: z.string().trim().optional(),\n  areaType: z.enum(['RURAL', 'URBAN']).optional(),\n  division: areaRefSchema,\n  district: z.string().trim().optional(),\n  tehsil: areaRefSchema,\n  // Rural\n  block: areaRefSchema,\n  gramPanchayat: areaRefSchema,\n  village: areaRefSchema,\n  hamlet: areaRefSchema,\n  ruralWard: areaRefSchema,\n  // Urban\n  urbanBody: areaRefSchema,\n  urbanWard: areaRefSchema,\n  locality: areaRefSchema,\n  // Details\n  housePlotDetails: z.string().trim().optional(),\n  pincode: z\n    .string()\n    .trim()\n    .regex(/^\\d{6}$/, 'Pincode must be 6 digits')\n    .optional()\n    .or(z.literal('')),\n  landmark: z.string().trim().optional(),\n  directions: z.string().trim().optional(),\n  latitude: z.coerce.number().min(-90).max(90).optional(),\n  longitude: z.coerce.number().min(-180).max(180).optional(),\n});\n\n// ─── Main step-03 schema ────────────────────────────────\n\nexport const step03ResidenceSchema = z.object({\n  domicileSource: z.enum(['BIRTH_PLACE', 'HOME_NATIVE_PLACE', 'ANCESTRAL_NATIVE_PLACE']).optional(),\n  birthPlace: z.string().trim().optional(),\n  homeNativePlace: z.string().trim().optional(),\n  ancestralNativePlace: z.string().trim().optional(),\n  yearsAtCurrentAddress: z.coerce.number().min(0).max(120).optional(),\n  sameAsCurrentAddress: z.boolean().optional(),\n  currentAddress: addressSchema,\n  permanentAddress: addressSchema,\n  addressNotes: z.string().trim().optional(),\n});\n\n// ─── Inferred types ─────────────────────────────────────\n\nexport type Step03ResidenceInput = z.infer<typeof step03ResidenceSchema>;\nexport type AddressInput = z.infer<typeof addressSchema>;\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "udp-schema",
+  "version": "0.1.0",
+  "description": "Shared Zod schemas for User Detailed Profile (frontend + backend).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "type-check": "tsc --noEmit",
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "check": "npm run type-check && biome check --write .",
+    "check:staged": "biome check --staged --write --no-errors-on-unmatched",
+    "prepublishOnly": "npm run build && npm run check"
+  },
+  "keywords": [
+    "zod",
+    "schema",
+    "user-detailed-profile",
+    "udp",
+    "typescript"
+  ],
+  "author": "Hari",
+  "license": "MIT",
+  "peerDependencies": {
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.2",
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "zod": "^4.1.13"
+  }
+}