gymmonk-schema 0.6.0 → 0.8.0

package/dist/add-person-form.d.ts

@@ -0,0 +1,212 @@
+/**
+ * gymmonk-schema — "Add member" / "Add staff" FORM schemas
+ * ========================================================
+ * The client-side validation contract for the owner's desk-entry forms, and the
+ * mappers that turn a filled form into the `createMember` / `createStaff` API
+ * bodies.
+ *
+ * Why these live here rather than in the client, and why they are distinct from
+ * `createMemberBodySchema`: the form's working shape is not the wire shape. It
+ * holds ONE "name" field the API splits in two, `null` for a choice not yet
+ * made, and `''` for an optional value left blank. Those are legitimate mid-edit
+ * states that the API body must never see. Expressing the same rules over the
+ * form shape here keeps
+ * every message, bound and regex defined once — the client cannot drift from
+ * what the server will accept, and the coercion from one shape to the other is
+ * part of the contract instead of ad-hoc code in a component.
+ *
+ * Mirrors `onboarding-form.ts`, which does the same job for the wizards.
+ *
+ * @module gymmonk-schema/add-person-form
+ */
+import { z } from 'zod';
+import type { CreateMemberBody } from './member.js';
+import type { AssignMembershipBody } from './membership.js';
+import { type Address, bloodGroupSchema, genderSchema } from './shared.js';
+import type { CreateStaffBody } from './staff.js';
+import { staffRoleSchema } from './staff.js';
+/**
+ * Age bounds for someone signed up at the desk. Wider than the member wizard's
+ * because a gym also enrols juniors with a guardian present, and the date is
+ * typed by staff rather than by the person themselves.
+ */
+export declare const ADD_PERSON_MIN_AGE_YEARS = 5;
+export declare const ADD_PERSON_MAX_AGE_YEARS = 100;
+/** Matches `createMemberBodySchema.emergencyContacts`. */
+export declare const MAX_EMERGENCY_CONTACTS = 5;
+/**
+ * The design collects a RELATIONSHIP and a phone, not a name — so a row is
+ * either wholly blank (ignored) or has both. `name` is synthesised from the
+ * relationship in the mapper, since `emergencyContactSchema` requires one.
+ */
+export declare const emergencyContactRowSchema: z.ZodObject<{
+    relationship: z.ZodString;
+    phone: z.ZodString;
+}, z.core.$strip>;
+export interface EmergencyContactRow {
+    relationship: string;
+    phone: string;
+}
+export declare const addMemberFormSchema: z.ZodObject<{
+    trainerId: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodEmail;
+    phone: z.ZodString;
+    dob: z.ZodString;
+    gender: z.ZodNullable<z.ZodEnum<{
+        male: "male";
+        female: "female";
+        other: "other";
+    }>> & z.ZodType<{} | undefined, "male" | "female" | "other" | null, z.core.$ZodTypeInternals<{} | undefined, "male" | "female" | "other" | null>>;
+    address: z.ZodNullable<z.ZodObject<{
+        country: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        state: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        district: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        locality: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                SUB_DISTRICT: "SUB_DISTRICT";
+                BLOCK: "BLOCK";
+                GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+                VILLAGE: "VILLAGE";
+                HAMLET: "HAMLET";
+                URBAN_BODY: "URBAN_BODY";
+                URBAN_WARD: "URBAN_WARD";
+                LOCALITY: "LOCALITY";
+            }>;
+        }, z.core.$strip>>;
+        line1: z.ZodString;
+        landmark: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+        pincode: z.ZodString;
+        ancestry: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        coords: z.ZodOptional<z.ZodObject<{
+            lat: z.ZodNumber;
+            lng: z.ZodNumber;
+            source: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    bloodGroup: z.ZodUnion<[z.ZodEnum<{
+        "A+": "A+";
+        "A-": "A-";
+        "B+": "B+";
+        "B-": "B-";
+        "O+": "O+";
+        "O-": "O-";
+        "AB+": "AB+";
+        "AB-": "AB-";
+    }>, z.ZodLiteral<"">]>;
+    idProofUrl: z.ZodString;
+    avatarUrl: z.ZodString;
+    contacts: z.ZodArray<z.ZodObject<{
+        relationship: z.ZodString;
+        phone: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddMemberFormValues = {
+    name: string;
+    email: string;
+    phone: string;
+    dob: string;
+    gender: z.infer<typeof genderSchema> | null;
+    address: Address | null;
+    bloodGroup: z.infer<typeof bloodGroupSchema> | '';
+    idProofUrl: string;
+    avatarUrl: string;
+    contacts: EmergencyContactRow[];
+    trainerId: string;
+};
+export declare const addStaffFormSchema: z.ZodObject<{
+    role: z.ZodNullable<z.ZodEnum<{
+        trainer: "trainer";
+        manager: "manager";
+        cleaning: "cleaning";
+        reception: "reception";
+    }>> & z.ZodType<{} | undefined, "trainer" | "manager" | "cleaning" | "reception" | null, z.core.$ZodTypeInternals<{} | undefined, "trainer" | "manager" | "cleaning" | "reception" | null>>;
+    name: z.ZodString;
+    email: z.ZodEmail;
+    phone: z.ZodString;
+    dob: z.ZodString;
+    gender: z.ZodNullable<z.ZodEnum<{
+        male: "male";
+        female: "female";
+        other: "other";
+    }>> & z.ZodType<{} | undefined, "male" | "female" | "other" | null, z.core.$ZodTypeInternals<{} | undefined, "male" | "female" | "other" | null>>;
+    address: z.ZodNullable<z.ZodObject<{
+        country: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        state: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        district: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        locality: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                SUB_DISTRICT: "SUB_DISTRICT";
+                BLOCK: "BLOCK";
+                GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+                VILLAGE: "VILLAGE";
+                HAMLET: "HAMLET";
+                URBAN_BODY: "URBAN_BODY";
+                URBAN_WARD: "URBAN_WARD";
+                LOCALITY: "LOCALITY";
+            }>;
+        }, z.core.$strip>>;
+        line1: z.ZodString;
+        landmark: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+        pincode: z.ZodString;
+        ancestry: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        coords: z.ZodOptional<z.ZodObject<{
+            lat: z.ZodNumber;
+            lng: z.ZodNumber;
+            source: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    bloodGroup: z.ZodUnion<[z.ZodEnum<{
+        "A+": "A+";
+        "A-": "A-";
+        "B+": "B+";
+        "B-": "B-";
+        "O+": "O+";
+        "O-": "O-";
+        "AB+": "AB+";
+        "AB-": "AB-";
+    }>, z.ZodLiteral<"">]>;
+    idProofUrl: z.ZodString;
+    avatarUrl: z.ZodString;
+    contacts: z.ZodArray<z.ZodObject<{
+        relationship: z.ZodString;
+        phone: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AddStaffFormValues = Omit<AddMemberFormValues, 'trainerId'> & {
+    role: z.infer<typeof staffRoleSchema> | null;
+};
+/** One blank row so the section renders with a contact to fill. */
+export declare const EMPTY_EMERGENCY_CONTACT: EmergencyContactRow;
+export declare const EMPTY_ADD_MEMBER_FORM: AddMemberFormValues;
+export declare const EMPTY_ADD_STAFF_FORM: AddStaffFormValues;
+/**
+ * Validated member form → `POST /members` body. `initialPlan` comes from the
+ * membership step, which the form itself knows nothing about.
+ */
+export declare function toCreateMemberBody(values: AddMemberFormValues, initialPlan?: AssignMembershipBody): CreateMemberBody;
+/** Validated staff form → `POST /staff` body. */
+export declare function toCreateStaffBody(values: AddStaffFormValues): CreateStaffBody;
+//# sourceMappingURL=add-person-form.d.ts.map

package/dist/add-person-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-person-form.d.ts","sourceRoot":"","sources":["../src/add-person-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,KAAK,OAAO,EAAiB,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AASxC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;iBAkBlC,CAAC;AAEL,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AA+DD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY5B,CAAC;AAEL,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GAAG,EAAE,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3B,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,GAAG;IACxE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAAC;CAC9C,CAAC;AAgBF,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,EAAE,mBAAqD,CAAC;AAE5F,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,kBAIlC,CAAC;AAsDF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,CAAC,EAAE,oBAAoB,GACjC,gBAAgB,CAMlB;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAM7E"}

package/dist/add-person-form.js

@@ -0,0 +1,227 @@
+/**
+ * gymmonk-schema — "Add member" / "Add staff" FORM schemas
+ * ========================================================
+ * The client-side validation contract for the owner's desk-entry forms, and the
+ * mappers that turn a filled form into the `createMember` / `createStaff` API
+ * bodies.
+ *
+ * Why these live here rather than in the client, and why they are distinct from
+ * `createMemberBodySchema`: the form's working shape is not the wire shape. It
+ * holds ONE "name" field the API splits in two, `null` for a choice not yet
+ * made, and `''` for an optional value left blank. Those are legitimate mid-edit
+ * states that the API body must never see. Expressing the same rules over the
+ * form shape here keeps
+ * every message, bound and regex defined once — the client cannot drift from
+ * what the server will accept, and the coercion from one shape to the other is
+ * part of the contract instead of ad-hoc code in a component.
+ *
+ * Mirrors `onboarding-form.ts`, which does the same job for the wizards.
+ *
+ * @module gymmonk-schema/add-person-form
+ */
+import { z } from 'zod';
+import { ageInYears, isRealDate, PHONE_REGEX } from './common.js';
+import { emergencyContactSchema } from './member-profile.js';
+import { addressSchema, bloodGroupSchema, genderSchema } from './shared.js';
+import { staffRoleSchema } from './staff.js';
+// ─── Bounds ──────────────────────────────────────────────────────────────────
+/**
+ * Age bounds for someone signed up at the desk. Wider than the member wizard's
+ * because a gym also enrols juniors with a guardian present, and the date is
+ * typed by staff rather than by the person themselves.
+ */
+export const ADD_PERSON_MIN_AGE_YEARS = 5;
+export const ADD_PERSON_MAX_AGE_YEARS = 100;
+/** Matches `createMemberBodySchema.emergencyContacts`. */
+export const MAX_EMERGENCY_CONTACTS = 5;
+// ─── Field-level rules ───────────────────────────────────────────────────────
+const requiredChoice = (inner, message) => inner.nullable().refine((v) => v !== null, { message });
+// ─── One emergency-contact row ───────────────────────────────────────────────
+/**
+ * The design collects a RELATIONSHIP and a phone, not a name — so a row is
+ * either wholly blank (ignored) or has both. `name` is synthesised from the
+ * relationship in the mapper, since `emergencyContactSchema` requires one.
+ */
+export const emergencyContactRowSchema = z
+    .object({
+    relationship: z.string().trim().max(60),
+    phone: z.string().trim(),
+})
+    .superRefine((v, ctx) => {
+    const blank = v.relationship === '' && v.phone === '';
+    if (blank)
+        return;
+    if (v.relationship === '') {
+        ctx.addIssue({ code: 'custom', path: ['relationship'], message: 'Add the relationship' });
+    }
+    if (!PHONE_REGEX.test(v.phone)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['phone'],
+            message: 'Enter a valid 10-digit mobile number',
+        });
+    }
+});
+// ─── Shared base ─────────────────────────────────────────────────────────────
+const addPersonBaseShape = {
+    /** One field on screen; split into `firstName` / `lastName` on the wire. */
+    name: z.string().trim().min(1, 'Name is required').max(160),
+    email: z.email('Enter a valid email'),
+    phone: z.string().regex(PHONE_REGEX, 'Enter a valid 10-digit mobile number'),
+    /** `YYYY-MM-DD` from a native date input; blank when not recorded. */
+    dob: z.string(),
+    gender: requiredChoice(genderSchema, 'Select a gender'),
+    /**
+     * The whole address, or null. Picked through the location drawer, which
+     * hands back a complete `Address` — area chain, ids, names, ancestry,
+     * coordinates — or nothing. It is therefore atomic: the "half-filled
+     * address" this schema used to guard against can no longer be expressed.
+     */
+    address: addressSchema.nullable(),
+    /** Blank when not recorded. */
+    bloodGroup: bloodGroupSchema.or(z.literal('')),
+    /** GCS URLs — both upload on pick, so these are never files. */
+    idProofUrl: z.string(),
+    avatarUrl: z.string(),
+    contacts: z.array(emergencyContactRowSchema).max(MAX_EMERGENCY_CONTACTS),
+};
+/**
+ * Date of birth is optional, but a typed one has to be real and plausible —
+ * a mis-keyed year is the single most common desk-entry slip.
+ */
+function refineDob(v, ctx) {
+    if (v.dob === '')
+        return;
+    const parts = v.dob.split('-');
+    const year = Number(parts[0]);
+    const month = Number(parts[1]);
+    const day = Number(parts[2]);
+    if (parts.length !== 3 || !isRealDate(year, month, day)) {
+        ctx.addIssue({ code: 'custom', path: ['dob'], message: 'That date does not exist' });
+        return;
+    }
+    const age = ageInYears(year, month, day);
+    if (age < 0) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['dob'],
+            message: 'Date of birth cannot be in the future',
+        });
+    }
+    else if (age < ADD_PERSON_MIN_AGE_YEARS) {
+        ctx.addIssue({ code: 'custom', path: ['dob'], message: 'Check the year of birth' });
+    }
+    else if (age > ADD_PERSON_MAX_AGE_YEARS) {
+        ctx.addIssue({ code: 'custom', path: ['dob'], message: 'Check the year of birth' });
+    }
+}
+// ─── Member form ─────────────────────────────────────────────────────────────
+export const addMemberFormSchema = z
+    .object({
+    ...addPersonBaseShape,
+    /**
+     * Central-auth user id of the trainer, or `''` for none. Only trainers who
+     * have CLAIMED their invite can be assigned — an unclaimed staff record has
+     * no user to point at (`MemberProfile.assignedTrainerId` refs `User`).
+     */
+    trainerId: z.string(),
+})
+    .superRefine((v, ctx) => {
+    refineDob(v, ctx);
+});
+// ─── Staff form ──────────────────────────────────────────────────────────────
+export const addStaffFormSchema = z
+    .object({
+    ...addPersonBaseShape,
+    role: requiredChoice(staffRoleSchema, 'Select a staff role'),
+})
+    .superRefine((v, ctx) => {
+    refineDob(v, ctx);
+});
+// ─── Empty states ────────────────────────────────────────────────────────────
+const EMPTY_BASE = {
+    name: '',
+    email: '',
+    phone: '',
+    dob: '',
+    gender: null,
+    address: null,
+    bloodGroup: '',
+    idProofUrl: '',
+    avatarUrl: '',
+};
+/** One blank row so the section renders with a contact to fill. */
+export const EMPTY_EMERGENCY_CONTACT = { relationship: '', phone: '' };
+export const EMPTY_ADD_MEMBER_FORM = {
+    ...EMPTY_BASE,
+    contacts: [{ ...EMPTY_EMERGENCY_CONTACT }],
+    trainerId: '',
+};
+export const EMPTY_ADD_STAFF_FORM = {
+    ...EMPTY_BASE,
+    contacts: [{ ...EMPTY_EMERGENCY_CONTACT }],
+    role: null,
+};
+// ─── Form → API body ─────────────────────────────────────────────────────────
+/** One "Name" field on screen, `firstName` + `lastName` on the wire. */
+function splitName(value) {
+    const parts = value.trim().split(/\s+/).filter(Boolean);
+    const lastName = parts.slice(1).join(' ');
+    return { firstName: parts[0] ?? '', ...(lastName ? { lastName } : {}) };
+}
+/** Drop a blank optional so it reads as "not provided" rather than `''`. */
+function orUndefined(value) {
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/** Phones are STORED raw — strip any display formatting back to 10 digits. */
+function asPhone(value) {
+    return value.replace(/\D/g, '').slice(-10);
+}
+function sharedBody(v) {
+    // Already a complete `Address` or null — the drawer cannot produce anything
+    // in between, so there is nothing to assemble or re-check here.
+    const address = v.address ?? undefined;
+    const emergencyContacts = v.contacts
+        .filter((c) => c.relationship !== '' || c.phone !== '')
+        .map((c) => emergencyContactSchema.parse({
+        // The form captures a relationship, not a name; it doubles as the label.
+        name: c.relationship.trim(),
+        phone: asPhone(c.phone),
+        relationship: c.relationship.trim(),
+    }))
+        .slice(0, MAX_EMERGENCY_CONTACTS);
+    return {
+        ...splitName(v.name),
+        email: v.email.trim(),
+        phone: asPhone(v.phone),
+        // The form schema guarantees a choice was made before we get here.
+        gender: v.gender ?? 'other',
+        dob: orUndefined(v.dob),
+        bloodGroup: v.bloodGroup === '' ? undefined : v.bloodGroup,
+        address,
+        emergencyContacts,
+        idProofUrl: orUndefined(v.idProofUrl),
+        avatarUrl: orUndefined(v.avatarUrl),
+    };
+}
+/**
+ * Validated member form → `POST /members` body. `initialPlan` comes from the
+ * membership step, which the form itself knows nothing about.
+ */
+export function toCreateMemberBody(values, initialPlan) {
+    return {
+        ...sharedBody(values),
+        assignedTrainerId: orUndefined(values.trainerId),
+        ...(initialPlan ? { initialPlan } : {}),
+    };
+}
+/** Validated staff form → `POST /staff` body. */
+export function toCreateStaffBody(values) {
+    return {
+        ...sharedBody(values),
+        // The form schema guarantees a role was chosen.
+        role: values.role ?? 'trainer',
+    };
+}
+//# sourceMappingURL=add-person-form.js.map

package/dist/add-person-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-person-form.js","sourceRoot":"","sources":["../src/add-person-form.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * gymmonk-schema — \"Add member\" / \"Add staff\" FORM schemas\n * ========================================================\n * The client-side validation contract for the owner's desk-entry forms, and the\n * mappers that turn a filled form into the `createMember` / `createStaff` API\n * bodies.\n *\n * Why these live here rather than in the client, and why they are distinct from\n * `createMemberBodySchema`: the form's working shape is not the wire shape. It\n * holds ONE \"name\" field the API splits in two, `null` for a choice not yet\n * made, and `''` for an optional value left blank. Those are legitimate mid-edit\n * states that the API body must never see. Expressing the same rules over the\n * form shape here keeps\n * every message, bound and regex defined once — the client cannot drift from\n * what the server will accept, and the coercion from one shape to the other is\n * part of the contract instead of ad-hoc code in a component.\n *\n * Mirrors `onboarding-form.ts`, which does the same job for the wizards.\n *\n * @module gymmonk-schema/add-person-form\n */\n\nimport { z } from 'zod';\nimport { ageInYears, isRealDate, PHONE_REGEX } from './common.js';\nimport type { CreateMemberBody } from './member.js';\nimport { emergencyContactSchema } from './member-profile.js';\nimport type { AssignMembershipBody } from './membership.js';\nimport { type Address, addressSchema, bloodGroupSchema, genderSchema } from './shared.js';\nimport type { CreateStaffBody } from './staff.js';\nimport { staffRoleSchema } from './staff.js';\n\n// ─── Bounds ──────────────────────────────────────────────────────────────────\n\n/**\n * Age bounds for someone signed up at the desk. Wider than the member wizard's\n * because a gym also enrols juniors with a guardian present, and the date is\n * typed by staff rather than by the person themselves.\n */\nexport const ADD_PERSON_MIN_AGE_YEARS = 5;\nexport const ADD_PERSON_MAX_AGE_YEARS = 100;\n\n/** Matches `createMemberBodySchema.emergencyContacts`. */\nexport const MAX_EMERGENCY_CONTACTS = 5;\n\n// ─── Field-level rules ───────────────────────────────────────────────────────\n\nconst requiredChoice = <T extends z.ZodTypeAny>(inner: T, message: string) =>\n  inner.nullable().refine((v: unknown) => v !== null, { message });\n\n// ─── One emergency-contact row ───────────────────────────────────────────────\n\n/**\n * The design collects a RELATIONSHIP and a phone, not a name — so a row is\n * either wholly blank (ignored) or has both. `name` is synthesised from the\n * relationship in the mapper, since `emergencyContactSchema` requires one.\n */\nexport const emergencyContactRowSchema = z\n  .object({\n    relationship: z.string().trim().max(60),\n    phone: z.string().trim(),\n  })\n  .superRefine((v, ctx) => {\n    const blank = v.relationship === '' && v.phone === '';\n    if (blank) return;\n    if (v.relationship === '') {\n      ctx.addIssue({ code: 'custom', path: ['relationship'], message: 'Add the relationship' });\n    }\n    if (!PHONE_REGEX.test(v.phone)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['phone'],\n        message: 'Enter a valid 10-digit mobile number',\n      });\n    }\n  });\n\nexport interface EmergencyContactRow {\n  relationship: string;\n  phone: string;\n}\n\n// ─── Shared base ─────────────────────────────────────────────────────────────\n\nconst addPersonBaseShape = {\n  /** One field on screen; split into `firstName` / `lastName` on the wire. */\n  name: z.string().trim().min(1, 'Name is required').max(160),\n  email: z.email('Enter a valid email'),\n  phone: z.string().regex(PHONE_REGEX, 'Enter a valid 10-digit mobile number'),\n  /** `YYYY-MM-DD` from a native date input; blank when not recorded. */\n  dob: z.string(),\n  gender: requiredChoice(genderSchema, 'Select a gender'),\n\n  /**\n   * The whole address, or null. Picked through the location drawer, which\n   * hands back a complete `Address` — area chain, ids, names, ancestry,\n   * coordinates — or nothing. It is therefore atomic: the \"half-filled\n   * address\" this schema used to guard against can no longer be expressed.\n   */\n  address: addressSchema.nullable(),\n\n  /** Blank when not recorded. */\n  bloodGroup: bloodGroupSchema.or(z.literal('')),\n  /** GCS URLs — both upload on pick, so these are never files. */\n  idProofUrl: z.string(),\n  avatarUrl: z.string(),\n\n  contacts: z.array(emergencyContactRowSchema).max(MAX_EMERGENCY_CONTACTS),\n};\n\n/**\n * Date of birth is optional, but a typed one has to be real and plausible —\n * a mis-keyed year is the single most common desk-entry slip.\n */\nfunction refineDob(v: { dob: string }, ctx: z.RefinementCtx): void {\n  if (v.dob === '') return;\n\n  const parts = v.dob.split('-');\n  const year = Number(parts[0]);\n  const month = Number(parts[1]);\n  const day = Number(parts[2]);\n\n  if (parts.length !== 3 || !isRealDate(year, month, day)) {\n    ctx.addIssue({ code: 'custom', path: ['dob'], message: 'That date does not exist' });\n    return;\n  }\n\n  const age = ageInYears(year, month, day);\n  if (age < 0) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['dob'],\n      message: 'Date of birth cannot be in the future',\n    });\n  } else if (age < ADD_PERSON_MIN_AGE_YEARS) {\n    ctx.addIssue({ code: 'custom', path: ['dob'], message: 'Check the year of birth' });\n  } else if (age > ADD_PERSON_MAX_AGE_YEARS) {\n    ctx.addIssue({ code: 'custom', path: ['dob'], message: 'Check the year of birth' });\n  }\n}\n\n// ─── Member form ─────────────────────────────────────────────────────────────\n\nexport const addMemberFormSchema = z\n  .object({\n    ...addPersonBaseShape,\n    /**\n     * Central-auth user id of the trainer, or `''` for none. Only trainers who\n     * have CLAIMED their invite can be assigned — an unclaimed staff record has\n     * no user to point at (`MemberProfile.assignedTrainerId` refs `User`).\n     */\n    trainerId: z.string(),\n  })\n  .superRefine((v, ctx) => {\n    refineDob(v, ctx);\n  });\n\nexport type AddMemberFormValues = {\n  name: string;\n  email: string;\n  phone: string;\n  dob: string;\n  gender: z.infer<typeof genderSchema> | null;\n  address: Address | null;\n  bloodGroup: z.infer<typeof bloodGroupSchema> | '';\n  idProofUrl: string;\n  avatarUrl: string;\n  contacts: EmergencyContactRow[];\n  trainerId: string;\n};\n\n// ─── Staff form ──────────────────────────────────────────────────────────────\n\nexport const addStaffFormSchema = z\n  .object({\n    ...addPersonBaseShape,\n    role: requiredChoice(staffRoleSchema, 'Select a staff role'),\n  })\n  .superRefine((v, ctx) => {\n    refineDob(v, ctx);\n  });\n\nexport type AddStaffFormValues = Omit<AddMemberFormValues, 'trainerId'> & {\n  role: z.infer<typeof staffRoleSchema> | null;\n};\n\n// ─── Empty states ────────────────────────────────────────────────────────────\n\nconst EMPTY_BASE = {\n  name: '',\n  email: '',\n  phone: '',\n  dob: '',\n  gender: null,\n  address: null,\n  bloodGroup: '' as const,\n  idProofUrl: '',\n  avatarUrl: '',\n} satisfies Omit<AddMemberFormValues, 'contacts' | 'trainerId'>;\n\n/** One blank row so the section renders with a contact to fill. */\nexport const EMPTY_EMERGENCY_CONTACT: EmergencyContactRow = { relationship: '', phone: '' };\n\nexport const EMPTY_ADD_MEMBER_FORM: AddMemberFormValues = {\n  ...EMPTY_BASE,\n  contacts: [{ ...EMPTY_EMERGENCY_CONTACT }],\n  trainerId: '',\n};\n\nexport const EMPTY_ADD_STAFF_FORM: AddStaffFormValues = {\n  ...EMPTY_BASE,\n  contacts: [{ ...EMPTY_EMERGENCY_CONTACT }],\n  role: null,\n};\n\n// ─── Form → API body ─────────────────────────────────────────────────────────\n\n/** One \"Name\" field on screen, `firstName` + `lastName` on the wire. */\nfunction splitName(value: string): { firstName: string; lastName?: string } {\n  const parts = value.trim().split(/\\s+/).filter(Boolean);\n  const lastName = parts.slice(1).join(' ');\n  return { firstName: parts[0] ?? '', ...(lastName ? { lastName } : {}) };\n}\n\n/** Drop a blank optional so it reads as \"not provided\" rather than `''`. */\nfunction orUndefined(value: string): string | undefined {\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed;\n}\n\n/** Phones are STORED raw — strip any display formatting back to 10 digits. */\nfunction asPhone(value: string): string {\n  return value.replace(/\\D/g, '').slice(-10);\n}\n\nfunction sharedBody(v: Omit<AddMemberFormValues, 'trainerId'>) {\n  // Already a complete `Address` or null — the drawer cannot produce anything\n  // in between, so there is nothing to assemble or re-check here.\n  const address = v.address ?? undefined;\n\n  const emergencyContacts = v.contacts\n    .filter((c) => c.relationship !== '' || c.phone !== '')\n    .map((c) =>\n      emergencyContactSchema.parse({\n        // The form captures a relationship, not a name; it doubles as the label.\n        name: c.relationship.trim(),\n        phone: asPhone(c.phone),\n        relationship: c.relationship.trim(),\n      }),\n    )\n    .slice(0, MAX_EMERGENCY_CONTACTS);\n\n  return {\n    ...splitName(v.name),\n    email: v.email.trim(),\n    phone: asPhone(v.phone),\n    // The form schema guarantees a choice was made before we get here.\n    gender: v.gender ?? 'other',\n    dob: orUndefined(v.dob),\n    bloodGroup: v.bloodGroup === '' ? undefined : v.bloodGroup,\n    address,\n    emergencyContacts,\n    idProofUrl: orUndefined(v.idProofUrl),\n    avatarUrl: orUndefined(v.avatarUrl),\n  };\n}\n\n/**\n * Validated member form → `POST /members` body. `initialPlan` comes from the\n * membership step, which the form itself knows nothing about.\n */\nexport function toCreateMemberBody(\n  values: AddMemberFormValues,\n  initialPlan?: AssignMembershipBody,\n): CreateMemberBody {\n  return {\n    ...sharedBody(values),\n    assignedTrainerId: orUndefined(values.trainerId),\n    ...(initialPlan ? { initialPlan } : {}),\n  };\n}\n\n/** Validated staff form → `POST /staff` body. */\nexport function toCreateStaffBody(values: AddStaffFormValues): CreateStaffBody {\n  return {\n    ...sharedBody(values),\n    // The form schema guarantees a role was chosen.\n    role: values.role ?? 'trainer',\n  };\n}\n"]}

package/dist/area.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Area lookup API — the contract behind the location picker
+ * =========================================================
+ * `/api/v1/areas/*` reads reform-owned master data (countries, states,
+ * districts, and the eight sub-district types) so a GymMonk address can be
+ * PICKED rather than typed.
+ *
+ * These shapes live here, not in either app, for the reason the whole package
+ * exists: the backend and the web client were each declaring their own
+ * `AreaOption` and `LocalityOption`, which is two definitions of one wire
+ * format and therefore a drift waiting to happen — the backend adding a field
+ * or renaming one could not fail the client's build. Declared once, both sides
+ * import it and a change breaks loudly at compile time.
+ *
+ * Everything here is READ-ONLY. Master data is owned by reform-backend;
+ * GymMonk never writes to it.
+ *
+ * @module area
+ */
+import { z } from 'zod';
+/** One pickable area: the master_db id, and the name to show for it. */
+export declare const areaOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type AreaOption = z.infer<typeof areaOptionSchema>;
+/**
+ * A locality result also carries its area TYPE.
+ *
+ * That is not decoration. One district holds rows of eight different types, and
+ * names repeat across them — reform's master data has "Nakraunda" as both a
+ * Village and a Hamlet under Dehradun. Merged into one alphabetical list, the
+ * type is the only thing that tells the two apart.
+ */
+export declare const localityOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        SUB_DISTRICT: "SUB_DISTRICT";
+        BLOCK: "BLOCK";
+        GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+        VILLAGE: "VILLAGE";
+        HAMLET: "HAMLET";
+        URBAN_BODY: "URBAN_BODY";
+        URBAN_WARD: "URBAN_WARD";
+        LOCALITY: "LOCALITY";
+    }>;
+}, z.core.$strip>;
+export type LocalityOption = z.infer<typeof localityOptionSchema>;
+/**
+ * One page of localities.
+ *
+ * `hasMore` rather than a total count: a large district holds thousands of
+ * rows, and an infinite-scrolling list only ever needs to know whether to keep
+ * going. The server derives it by fetching one row beyond the page, which
+ * avoids a second `countDocuments` over the same filter.
+ */
+export declare const localityPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            SUB_DISTRICT: "SUB_DISTRICT";
+            BLOCK: "BLOCK";
+            GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+            VILLAGE: "VILLAGE";
+            HAMLET: "HAMLET";
+            URBAN_BODY: "URBAN_BODY";
+            URBAN_WARD: "URBAN_WARD";
+            LOCALITY: "LOCALITY";
+        }>;
+    }, z.core.$strip>>;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+export type LocalityPage = z.infer<typeof localityPageSchema>;
+/**
+ * Ancestor ids and coordinates for one area, resolved once when an address is
+ * saved and then denormalized onto it — so reading an address never touches
+ * master data again.
+ *
+ * `coords` is nullable, not optional: "we looked and this chain has no
+ * coordinates" is a real answer, and collapsing it to a missing field would
+ * make it indistinguishable from a response that failed to include it.
+ */
+export declare const areaLineageSchema: z.ZodObject<{
+    ancestry: z.ZodArray<z.ZodString>;
+    coords: z.ZodNullable<z.ZodObject<{
+        lat: z.ZodNumber;
+        lng: z.ZodNumber;
+        source: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AreaLineage = z.infer<typeof areaLineageSchema>;
+/** GET /areas/districts */
+export declare const districtsQuerySchema: z.ZodObject<{
+    stateId: z.ZodString;
+    q: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DistrictsQuery = z.infer<typeof districtsQuerySchema>;
+/** Rows per locality page. Mirrored by the client's infinite-scroll hook. */
+export declare const LOCALITY_PAGE_SIZE = 50;
+/** Ceiling on a caller-supplied `limit`, so one request cannot pull a district. */
+export declare const LOCALITY_MAX_LIMIT = 100;
+/**
+ * GET /areas/localities
+ *
+ * `page`/`limit` are coerced because they arrive as query strings, and clamped
+ * here rather than in the handler so the frontend sees the same bounds it will
+ * be held to.
+ */
+export declare const localitiesQuerySchema: z.ZodObject<{
+    districtId: z.ZodString;
+    q: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type LocalitiesQuery = z.infer<typeof localitiesQuerySchema>;
+/** GET /areas/lineage/:areaId */
+export declare const areaLineageParamsSchema: z.ZodObject<{
+    areaId: z.ZodString;
+}, z.core.$strip>;
+export type AreaLineageParams = z.infer<typeof areaLineageParamsSchema>;
+//# sourceMappingURL=area.d.ts.map

package/dist/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../src/area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAE/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;iBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;iBAI5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO5D,2BAA2B;AAC3B,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,iCAAiC;AACjC,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}