@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/curated-worker-leads/consent-queue.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-queue.contract.d.ts","sourceRoot":"","sources":["../../contracts/curated-worker-leads/consent-queue.contract.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHhC,CAAC"}

package/dist/curated-worker-leads/consent-queue.contract.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consentQueueContract = exports.ReSnoozeSchema = exports.ConsentAndApplySchema = exports.ConsentApplyItemSchema = exports.ConsentApplyOutcomeSchema = exports.ConsentAndOfferSchema = exports.ConsentJobsResponseSchema = exports.MarkPhoneInvalidSchema = exports.ContactChannelSchema = exports.ConsentAdvanceResponseSchema = exports.ConsentQueueStatusSchema = exports.DeclineConsentSchema = exports.ConsentLeadSchema = void 0;
+const zod_openapi_1 = require("@anatine/zod-openapi");
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const curated_worker_lead_config_contract_1 = require("./curated-worker-lead-config.contract");
+const jobs_contract_1 = require("../jobs/jobs.contract");
+const curated_workers_contract_1 = require("../curated-workers/curated-workers.contract");
+const do_not_contact_contract_1 = require("../workers/do-not-contact.contract");
+const jobs_tab_contract_1 = require("./jobs-tab.contract");
+(0, zod_openapi_1.extendZodWithOpenApi)(zod_1.z);
+const c = (0, core_1.initContract)();
+exports.ConsentLeadSchema = zod_1.z
+    .object({
+    assignmentId: zod_1.z.string().uuid(),
+    curatedWorkerId: zod_1.z.string().uuid(),
+    workerName: zod_1.z.string(),
+    phoneNumber: zod_1.z.string().nullable(),
+    phoneId: zod_1.z.string().uuid().nullable(),
+    postcode: zod_1.z.string().nullable(),
+    matchingJobCount: zod_1.z.number().int(),
+    nearestJobDistanceKm: zod_1.z.number().nullable(),
+    assignedAt: zod_1.z.string(),
+})
+    .openapi({ title: 'ConsentLead' });
+exports.DeclineConsentSchema = zod_1.z
+    .object({
+    reason: curated_worker_lead_config_contract_1.DeclineReasonSchema,
+    doNotContactDays: zod_1.z.number().int().min(0).max(do_not_contact_contract_1.DNC_MAX_DAYS),
+})
+    .openapi({ title: 'DeclineConsent' });
+exports.ConsentQueueStatusSchema = zod_1.z
+    .object({
+    agentId: zod_1.z.string().uuid(),
+    nextAvailable: zod_1.z.boolean(),
+})
+    .openapi({ title: 'ConsentQueueStatus' });
+exports.ConsentAdvanceResponseSchema = zod_1.z
+    .object({ next: exports.ConsentLeadSchema.nullable() })
+    .openapi({ title: 'ConsentAdvanceResponse' });
+exports.ContactChannelSchema = zod_1.z
+    .enum(['WHATSAPP', 'PHONE_CALL'])
+    .openapi({ title: 'ContactChannel' });
+exports.MarkPhoneInvalidSchema = zod_1.z
+    .object({
+    channel: exports.ContactChannelSchema,
+    curatedWorkerPhoneId: zod_1.z.string().uuid().nullable().optional(),
+})
+    .openapi({ title: 'MarkPhoneInvalid' });
+exports.ConsentJobsResponseSchema = zod_1.z
+    .object({
+    worker: curated_workers_contract_1.CuratedWorkerResponseSchema,
+    matches: zod_1.z.array(jobs_tab_contract_1.WorkerJobMatchItemSchema),
+    jobCards: zod_1.z.array(jobs_contract_1.JobListItemSchema),
+})
+    .openapi({ title: 'ConsentJobsResponse' });
+exports.ConsentAndOfferSchema = zod_1.z
+    .object({
+    tuples: zod_1.z.array(jobs_tab_contract_1.MatchTupleSchema).min(1).max(50),
+    channel: jobs_tab_contract_1.OfferChannelSchema.optional(),
+})
+    .openapi({ title: 'ConsentAndOffer' });
+/**
+ * The per-job outcomes an agent stages while reviewing a CONSENT_PENDING
+ * worker's matches. Mirrors the job-match dispositions plus BOOKED — `channel`
+ * only carries meaning for OFFER_SENT. The subject is always the consenting
+ * worker, so items carry just the jobId; the server fills in the tuple.
+ */
+exports.ConsentApplyOutcomeSchema = zod_1.z
+    .enum(['OFFER_SENT', 'TOO_FAR', 'NOT_INTERESTED', 'BOOKED'])
+    .openapi({ title: 'ConsentApplyOutcome' });
+exports.ConsentApplyItemSchema = zod_1.z
+    .object({
+    jobId: zod_1.z.string().uuid(),
+    outcome: exports.ConsentApplyOutcomeSchema,
+    channel: jobs_tab_contract_1.OfferChannelSchema.optional(),
+})
+    .openapi({ title: 'ConsentApplyItem' });
+exports.ConsentAndApplySchema = zod_1.z
+    .object({
+    // May be empty — committing with no staged outcomes is a plain consent.
+    items: zod_1.z.array(exports.ConsentApplyItemSchema).max(50),
+})
+    .strict()
+    .openapi({ title: 'ConsentAndApply' });
+exports.ReSnoozeSchema = zod_1.z
+    .object({ days: zod_1.z.number().int().min(1).max(365) })
+    .openapi({ title: 'ReSnooze' });
+exports.consentQueueContract = c.router({
+    getNext: {
+        method: 'GET',
+        path: '/curated-worker-leads/consent-queue/next',
+        responses: { 200: exports.ConsentLeadSchema.nullable(), 403: error_schemas_1.ErrorResponseSchema },
+        summary: 'Next consent lead for the current agent (triggers refill if empty)',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    getQueueStatus: {
+        method: 'GET',
+        path: '/curated-worker-leads/consent-queue/status',
+        responses: { 200: exports.ConsentQueueStatusSchema, 403: error_schemas_1.ErrorResponseSchema },
+        summary: 'Consent queue status for the current agent',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    consent: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/:id/consent',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: zod_1.z.object({}).strict(),
+        responses: { 200: exports.ConsentAdvanceResponseSchema, 403: error_schemas_1.ErrorResponseSchema, 404: error_schemas_1.ErrorResponseSchema },
+        summary: 'Record worker consent; advance to next',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    decline: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/:id/decline',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: exports.DeclineConsentSchema,
+        responses: { 200: exports.ConsentAdvanceResponseSchema, 403: error_schemas_1.ErrorResponseSchema, 404: error_schemas_1.ErrorResponseSchema },
+        summary: 'Record decline (reason + do-not-contact days); advance to next',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    markPhoneInvalid: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/:id/mark-phone-invalid',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: exports.MarkPhoneInvalidSchema,
+        responses: { 200: exports.ConsentAdvanceResponseSchema, 403: error_schemas_1.ErrorResponseSchema, 404: error_schemas_1.ErrorResponseSchema },
+        summary: 'Flag the worker phone number invalid (channel tried); release + advance',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    getConsentJobs: {
+        method: 'GET',
+        path: '/curated-worker-leads/consent-queue/jobs',
+        query: zod_1.z.object({ curatedWorkerId: zod_1.z.string().uuid() }),
+        responses: {
+            200: exports.ConsentJobsResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: "A CONSENT_PENDING worker's matching jobs (pitch ammo; ungated read)",
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    consentAndOffer: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/:id/consent-and-offer',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: exports.ConsentAndOfferSchema,
+        responses: {
+            200: exports.ConsentAdvanceResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Consent the worker AND record the selected offers atomically; advance',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    consentAndApply: {
+        // Partial-success compatibility semantics: consent and non-booking
+        // outcomes commit first. BOOKED items then commit one transaction at a
+        // time in input order; a failure leaves that earlier work (including
+        // earlier successful bookings) committed and stops later bookings.
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/:id/consent-and-apply',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }),
+        body: exports.ConsentAndApplySchema,
+        responses: {
+            200: exports.ConsentAdvanceResponseSchema,
+            403: error_schemas_1.ErrorResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Commit consent and non-booking outcomes, then process staged bookings sequentially; advance',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    bringBackCurated: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/worker/:curatedWorkerId/bring-back',
+        pathParams: zod_1.z.object({ curatedWorkerId: zod_1.z.string().uuid() }),
+        body: zod_1.z.object({}).strict(),
+        responses: { 200: zod_1.z.object({ ok: zod_1.z.literal(true) }), 403: error_schemas_1.ErrorResponseSchema, 404: error_schemas_1.ErrorResponseSchema },
+        summary: 'Clear a curated worker snooze + revive the parking agent lead now',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+    reSnoozeCurated: {
+        method: 'POST',
+        path: '/curated-worker-leads/consent-queue/worker/:curatedWorkerId/re-snooze',
+        pathParams: zod_1.z.object({ curatedWorkerId: zod_1.z.string().uuid() }),
+        body: exports.ReSnoozeSchema,
+        responses: { 200: zod_1.z.object({ ok: zod_1.z.literal(true) }), 403: error_schemas_1.ErrorResponseSchema, 404: error_schemas_1.ErrorResponseSchema },
+        summary: 'Extend a curated worker snooze',
+        metadata: { tags: ['Curated Worker Lead Consent'] },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

package/dist/curated-worker-leads/contact-history.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contact-history.spec.d.ts.map

package/dist/curated-worker-leads/contact-history.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-history.spec.d.ts","sourceRoot":"","sources":["../../contracts/curated-worker-leads/contact-history.spec.ts"],"names":[],"mappings":""}

package/dist/curated-worker-leads/contact-history.spec.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const candidate_coordination_contract_1 = require("./candidate-coordination.contract");
+const ID = '7d5c0f4e-8f60-4bff-b544-000000000001';
+const JOB_ID = '7d5c0f4e-8f60-4bff-b544-000000000002';
+const SUBJECT_ID = '7d5c0f4e-8f60-4bff-b544-000000000003';
+describe('candidate contact history contract', () => {
+    it('parses structured worker and job filters', () => {
+        expect(candidate_coordination_contract_1.CandidateContactHistoryQuerySchema.parse({
+            contactedById: ID,
+            worker: {
+                name: { value: 'Jamie Taylor', exact: 'true' },
+                phone: '07700900123',
+                postcode: 'BT2',
+            },
+            job: {
+                location: { postcode: 'BT1 1AA', radius: '25' },
+                tradeId: SUBJECT_ID,
+                userId: ID,
+            },
+        })).toEqual({
+            contactedById: ID,
+            worker: {
+                name: { value: 'Jamie Taylor', exact: true },
+                phone: '07700900123',
+                postcode: 'BT2',
+            },
+            job: {
+                location: { postcode: 'BT1 1AA', radius: 25 },
+                tradeId: SUBJECT_ID,
+                userId: ID,
+            },
+        });
+    });
+    it('parses a pending WhatsApp contact', () => {
+        const response = candidate_coordination_contract_1.CandidateContactHistoryResponseSchema.parse({
+            items: [
+                {
+                    id: ID,
+                    agentId: ID,
+                    agent: {
+                        id: ID,
+                        firstName: 'Alex',
+                        lastName: 'Agent',
+                    },
+                    subjectKind: 'CURATED',
+                    subjectId: SUBJECT_ID,
+                    worker: {
+                        firstName: 'Jamie',
+                        lastName: 'Taylor',
+                        postcode: 'BT2 2BB',
+                    },
+                    job: {
+                        id: JOB_ID,
+                        tradeName: 'Labourer',
+                        postcode: 'BT1 1AA',
+                        firstAgent: {
+                            id: ID,
+                            firstName: 'Alex',
+                            lastName: 'Agent',
+                        },
+                    },
+                    channel: 'WHATSAPP',
+                    contactedAt: '2026-07-17T09:00:00.000Z',
+                    outcome: 'AWAITING_FEEDBACK',
+                    feedbackAt: null,
+                    feedback: null,
+                    canRecordFeedback: true,
+                },
+            ],
+            total: 1,
+            hasMore: false,
+            totalPages: 1,
+        });
+        expect(response.items[0]?.outcome).toBe('AWAITING_FEEDBACK');
+        expect(response.items[0]?.canRecordFeedback).toBe(true);
+    });
+    it('reuses the detailed call outcome body for delayed WhatsApp feedback', () => {
+        expect(candidate_coordination_contract_1.CompletePhoneCallBodySchema.safeParse({
+            outcome: 'NOT_INTERESTED',
+            scope: 'THIS_JOB',
+            reason: 'DISTANCE',
+        }).success).toBe(true);
+        expect(candidate_coordination_contract_1.candidateCoordinationContract.contactHistory.method).toBe('GET');
+        expect(candidate_coordination_contract_1.candidateCoordinationContract.recordWhatsAppFeedback.method).toBe('POST');
+        expect(candidate_coordination_contract_1.candidateCoordinationContract.recordContactFeedback.path).toBe('/v2/candidate-contacts/:contactEventId/feedback');
+    });
+});

package/dist/curated-worker-leads/contact-session.contract.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contact-session.contract.spec.d.ts.map

package/dist/curated-worker-leads/contact-session.contract.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-session.contract.spec.d.ts","sourceRoot":"","sources":["../../contracts/curated-worker-leads/contact-session.contract.spec.ts"],"names":[],"mappings":""}

package/dist/curated-worker-leads/contact-session.contract.spec.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const candidate_coordination_contract_1 = require("./candidate-coordination.contract");
+const jobs_tab_contract_1 = require("./jobs-tab.contract");
+const JOB_A = '11111111-1111-4111-8111-111111111111';
+const JOB_B = '22222222-2222-4222-8222-222222222222';
+const SUBJECT_ID = '33333333-3333-4333-8333-333333333333';
+const jobIds = (count) => Array.from({ length: count }, (_, index) => `${(index + 1).toString(16).padStart(8, '0')}-0000-4000-8000-000000000000`);
+const job = (jobId, result) => ({ jobId, result });
+describe('multi-job contact completion contracts', () => {
+    it.each([
+        {
+            name: 'non-connected results with worker and job data',
+            value: {
+                connection: 'NO_ANSWER',
+                workerState: { kind: 'OPEN_TO_OFFERS' },
+                jobs: [],
+            },
+        },
+        {
+            name: 'review-only NOT_DISCUSSED job results',
+            value: {
+                connection: 'CONNECTED',
+                workerState: { kind: 'NOT_CONFIRMED' },
+                jobs: [job(JOB_A, { kind: 'NOT_DISCUSSED' })],
+            },
+        },
+        {
+            name: 'duplicate job IDs',
+            value: {
+                connection: 'CONNECTED',
+                workerState: { kind: 'OPEN_TO_OFFERS' },
+                jobs: [
+                    job(JOB_A, { kind: 'DISCUSSED', channel: 'PHONE' }),
+                    job(JOB_A, { kind: 'OFFER_SENT', channel: 'PHONE' }),
+                ],
+            },
+        },
+        {
+            name: 'a too-short permanent suppression reason',
+            value: {
+                connection: 'CONNECTED',
+                workerState: { kind: 'DO_NOT_CONTACT', reason: 'too short' },
+                jobs: [],
+            },
+        },
+        {
+            name: 'OTHER without a note',
+            value: {
+                connection: 'CONNECTED',
+                workerState: { kind: 'OPEN_TO_OFFERS' },
+                jobs: [
+                    job(JOB_A, {
+                        kind: 'NOT_INTERESTED',
+                        channel: 'PHONE',
+                        reason: 'OTHER',
+                    }),
+                ],
+            },
+        },
+        {
+            name: 'more than 20 jobs',
+            value: {
+                connection: 'CONNECTED',
+                workerState: { kind: 'OPEN_TO_OFFERS' },
+                jobs: jobIds(21).map((jobId) => job(jobId, { kind: 'DISCUSSED', channel: 'PHONE' })),
+            },
+        },
+    ])('rejects $name', ({ value }) => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse(value).success).toBe(false);
+    });
+    it.each(['NO_ANSWER', 'BUSY', 'INVALID_NUMBER'])('accepts only connection for %s', (connection) => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({ connection }).success).toBe(true);
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection,
+            note: 'unexpected',
+        }).success).toBe(false);
+    });
+    it('accepts a rejected primary and an offered alternative', () => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'CONNECTED',
+            workerState: { kind: 'OPEN_TO_OFFERS', note: null },
+            jobs: [
+                job(JOB_A, {
+                    kind: 'NOT_INTERESTED',
+                    channel: 'PHONE',
+                    reason: 'DISTANCE',
+                }),
+                job(JOB_B, { kind: 'OFFER_SENT', channel: 'PHONE' }),
+            ],
+        }).success).toBe(true);
+    });
+    it('requires a note for OTHER and accepts one when supplied', () => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'CONNECTED',
+            workerState: { kind: 'ACTIVELY_LOOKING' },
+            jobs: [
+                job(JOB_A, {
+                    kind: 'NOT_INTERESTED',
+                    channel: 'PHONE',
+                    reason: 'OTHER',
+                    note: 'The site pattern is unsuitable',
+                }),
+            ],
+        }).success).toBe(true);
+    });
+    it('accepts NO_ANSWER/BUSY completions with WhatsApp follow-up jobs', () => {
+        for (const connection of ['NO_ANSWER', 'BUSY']) {
+            const parsed = candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+                connection,
+                jobs: [job(JOB_A, { kind: 'OFFER_SENT', channel: 'WHATSAPP' })],
+            });
+            expect(parsed.success).toBe(true);
+        }
+    });
+    it('still accepts bare non-connected completions (jobs optional)', () => {
+        for (const connection of ['NO_ANSWER', 'BUSY', 'INVALID_NUMBER']) {
+            expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({ connection }).success).toBe(true);
+        }
+    });
+    it('rejects non-WhatsApp or non-OFFER_SENT follow-up results and jobs on INVALID_NUMBER', () => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'NO_ANSWER',
+            jobs: [job(JOB_A, { kind: 'OFFER_SENT', channel: 'PHONE' })],
+        }).success).toBe(false);
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'BUSY',
+            jobs: [job(JOB_A, { kind: 'DISCUSSED', channel: 'WHATSAPP' })],
+        }).success).toBe(false);
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'INVALID_NUMBER',
+            jobs: [job(JOB_A, { kind: 'OFFER_SENT', channel: 'WHATSAPP' })],
+        }).success).toBe(false);
+    });
+    it('rejects duplicate follow-up job ids', () => {
+        expect(candidate_coordination_contract_1.MultiJobContactCompletionSchema.safeParse({
+            connection: 'BUSY',
+            jobs: [
+                job(JOB_A, { kind: 'OFFER_SENT', channel: 'WHATSAPP' }),
+                job(JOB_A, { kind: 'OFFER_SENT', channel: 'WHATSAPP' }),
+            ],
+        }).success).toBe(false);
+    });
+});
+describe('WhatsApp confirmation contracts', () => {
+    it('accepts one to 20 unique job IDs', () => {
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse({ jobIds: [JOB_A] }).success).toBe(true);
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse({ jobIds: jobIds(20) }).success).toBe(true);
+    });
+    it.each([
+        { jobIds: [] },
+        { jobIds: jobIds(21) },
+        { jobIds: [JOB_A, JOB_A] },
+        { jobIds: [JOB_A], connection: 'CONNECTED' },
+        { jobIds: [JOB_A], workerState: { kind: 'OPEN_TO_OFFERS' } },
+        {
+            jobIds: [JOB_A],
+            jobs: [job(JOB_A, { kind: 'OFFER_SENT', channel: 'WHATSAPP' })],
+        },
+    ])('rejects invalid or outcome-bearing input %#', (value) => {
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse(value).success).toBe(false);
+    });
+    it('waives the duplicate guard only for jobs it is also recording', () => {
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse({
+            jobIds: [JOB_A, JOB_B],
+            allowDuplicateJobIds: [JOB_B],
+        }).success).toBe(true);
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse({
+            jobIds: [JOB_A],
+            allowDuplicateJobIds: [],
+        }).success).toBe(true);
+    });
+    it.each([
+        { jobIds: [JOB_A], allowDuplicateJobIds: [JOB_B] },
+        { jobIds: [JOB_A], allowDuplicateJobIds: [JOB_A, JOB_A] },
+    ])('rejects a waiver wider than the recorded jobs %#', (value) => {
+        expect(candidate_coordination_contract_1.ConfirmWhatsAppSentBodySchema.safeParse(value).success).toBe(false);
+    });
+});
+describe('contact session projections and rolling history', () => {
+    it('keeps contact jobs and worker cards explicitly phone-free', () => {
+        const summary = candidate_coordination_contract_1.ContactSessionSummarySchema.safeParse({
+            revealSessionId: JOB_A,
+            channel: 'PHONE',
+            status: 'ACTIVE',
+            candidate: {
+                subjectKind: 'CURATED',
+                subjectId: SUBJECT_ID,
+                canonicalWorker: { kind: 'CURATED_WORKER', id: SUBJECT_ID },
+                firstName: 'Ada',
+                lastName: null,
+            },
+            jobs: [
+                {
+                    jobId: JOB_A,
+                    subjectKind: 'CURATED',
+                    subjectId: SUBJECT_ID,
+                    isPrimary: true,
+                    attachedAt: '2026-07-19T12:00:00.000Z',
+                    job: {
+                        id: JOB_A,
+                        description: 'One role',
+                        tradeName: 'Carpenter',
+                        postcode: 'N1',
+                        distanceKm: 3,
+                        driveMinutes: 12,
+                        transitMinutes: 20,
+                        pay: {
+                            rateUnit: 'DAILY',
+                            isNegotiable: false,
+                            rate: 200,
+                            receivedRate: 180,
+                        },
+                        hours: 8,
+                        positionsAvailable: 2,
+                        startDate: '2026-07-21',
+                        previousContact: {
+                            phone: null,
+                            whatsapp: null,
+                        },
+                    },
+                },
+            ],
+            startedAt: '2026-07-19T12:00:00.000Z',
+            expiresAt: '2026-07-19T12:30:00.000Z',
+        });
+        expect(summary.success).toBe(true);
+        expect(JSON.stringify(summary.success ? summary.data : null)).not.toContain('phoneNumber');
+        expect(Object.keys(jobs_tab_contract_1.OwnedJobMatchWorkerCardSchema.shape)).not.toContain('phoneNumbers');
+        expect(Object.keys(jobs_tab_contract_1.CuratedJobMatchWorkerCardSchema.shape)).not.toContain('phoneNumbers');
+        expect(Object.keys(jobs_tab_contract_1.jobsTabContract.getWorkerCards.query.shape)).not.toContain('redactPhones');
+    });
+    it('accepts separate viewer-phone and team-WhatsApp context', () => {
+        expect(candidate_coordination_contract_1.ContactJobPreviousContextSchema.parse({
+            phone: {
+                contactedAt: '2026-07-23T12:00:00.000Z',
+                result: {
+                    kind: 'NOT_INTERESTED',
+                    channel: 'PHONE',
+                    reason: 'DISTANCE',
+                },
+            },
+            whatsapp: {
+                contactedAt: '2026-07-23T11:00:00.000Z',
+                agent: {
+                    id: SUBJECT_ID,
+                    firstName: 'Lorena',
+                    lastName: 'Constantin',
+                },
+            },
+        })).toMatchObject({
+            phone: { result: { kind: 'NOT_INTERESTED', reason: 'DISTANCE' } },
+            whatsapp: { agent: { firstName: 'Lorena' } },
+        });
+    });
+    it('rejects WhatsApp-channel phone history and historical notes', () => {
+        expect(candidate_coordination_contract_1.ContactJobPreviousContextSchema.safeParse({
+            phone: {
+                contactedAt: '2026-07-23T12:00:00.000Z',
+                result: { kind: 'DISCUSSED', channel: 'WHATSAPP' },
+            },
+            whatsapp: null,
+        }).success).toBe(false);
+        expect(candidate_coordination_contract_1.ContactJobPreviousContextSchema.safeParse({
+            phone: {
+                contactedAt: '2026-07-23T12:00:00.000Z',
+                result: {
+                    kind: 'NOT_INTERESTED',
+                    channel: 'PHONE',
+                    reason: 'OTHER',
+                    note: 'Private historical note',
+                },
+            },
+            whatsapp: null,
+        }).success).toBe(false);
+    });
+    it('requires both nullable channel members', () => {
+        expect(candidate_coordination_contract_1.ContactJobPreviousContextSchema.safeParse({
+            phone: null,
+        }).success).toBe(false);
+        expect(candidate_coordination_contract_1.ContactJobPreviousContextSchema.safeParse({
+            whatsapp: null,
+        }).success).toBe(false);
+    });
+    it('accepts both legacy and layered history feedback during rollout', () => {
+        expect(candidate_coordination_contract_1.ContactFeedbackDataSchema.safeParse({ outcome: 'NO_ANSWER' }).success).toBe(true);
+        const layered = {
+            connection: 'CONNECTED',
+            workerState: { kind: 'OPEN_TO_OFFERS' },
+            jobs: [job(JOB_A, { kind: 'OFFER_SENT', channel: 'PHONE' })],
+        };
+        expect(candidate_coordination_contract_1.ContactFeedbackDataSchema.safeParse(layered).success).toBe(true);
+        expect(candidate_coordination_contract_1.CandidateContactHistoryItemSchema.shape.contactSessionId.safeParse(JOB_A)
+            .success).toBe(true);
+        expect(candidate_coordination_contract_1.CandidateContactHistoryItemSchema.shape.connection.safeParse('CONNECTED')
+            .success).toBe(true);
+        expect(candidate_coordination_contract_1.CandidateContactHistoryItemSchema.shape.workerState.safeParse(layered.workerState).success).toBe(true);
+        expect(candidate_coordination_contract_1.CandidateContactHistoryItemSchema.shape.jobResult.safeParse(layered.jobs[0]?.result).success).toBe(true);
+    });
+    it('accepts up to 19 selected jobs on reveal', () => {
+        const selectedJobs = jobIds(19).map((jobId) => ({
+            jobId,
+            subjectKind: 'CURATED',
+            subjectId: SUBJECT_ID,
+        }));
+        expect(candidate_coordination_contract_1.candidateCoordinationContract.revealPhone.body.safeParse({
+            channel: 'PHONE',
+            selectedJobs,
+        }).success).toBe(true);
+        expect(candidate_coordination_contract_1.candidateCoordinationContract.revealPhone.body.safeParse({
+            channel: 'PHONE',
+            selectedJobs: [...selectedJobs, selectedJobs[0]],
+        }).success).toBe(false);
+    });
+});