@dakkitor/api-contracts 1.1.154 → 1.4.0

package/dist/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-source-identity-conflicts.contract.d.ts","sourceRoot":"","sources":["../../contracts/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,cAAc,4CAA4C,CAAC;AAE3D,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnD,CAAC;AAEZ,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAC/D,OAAO,iDAAiD,CACzD,CAAC;AAIF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDjD,CAAC"}

package/dist/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workerSourceIdentityConflictsContract = exports.ResolveWorkerSourceIdentityConflictResponseSchema = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const workers_contract_1 = require("../workers/workers.contract");
+const worker_source_identity_conflicts_schemas_1 = require("./worker-source-identity-conflicts.schemas");
+__exportStar(require("./worker-source-identity-conflicts.schemas"), exports);
+exports.ResolveWorkerSourceIdentityConflictResponseSchema = zod_1.z
+    .object({
+    identityConflict: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictReferenceSchema,
+    challenge: workers_contract_1.WorkerSourceAttributionChallengeSchema,
+    retainedPhoneMasks: zod_1.z.array(worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictPhoneMaskSchema),
+    excludedPhoneMasks: zod_1.z.array(worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictPhoneMaskSchema),
+})
+    .strict();
+const c = (0, core_1.initContract)();
+exports.workerSourceIdentityConflictsContract = c.router({
+    list: {
+        method: 'GET',
+        path: '/v2/workers/source-identity-conflicts',
+        query: worker_source_identity_conflicts_schemas_1.ListWorkerSourceIdentityConflictsQuerySchema,
+        responses: {
+            200: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictListResponseSchema,
+        },
+        summary: 'List worker source identity conflicts for review',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'listWorkerSourceIdentityConflicts' },
+        },
+    },
+    getOne: {
+        method: 'GET',
+        path: '/v2/workers/source-identity-conflicts/:id',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }).strict(),
+        responses: {
+            200: worker_source_identity_conflicts_schemas_1.WorkerSourceIdentityConflictDetailSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Get one worker source identity conflict for review',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'getWorkerSourceIdentityConflict' },
+        },
+    },
+    resolve: {
+        method: 'POST',
+        path: '/v2/workers/source-identity-conflicts/:id/resolve',
+        pathParams: zod_1.z.object({ id: zod_1.z.string().uuid() }).strict(),
+        body: worker_source_identity_conflicts_schemas_1.ResolveWorkerSourceIdentityConflictBodySchema,
+        responses: {
+            200: exports.ResolveWorkerSourceIdentityConflictResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+            422: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Select a curated identity and convert the conflict into an attribution challenge',
+        metadata: {
+            tags: ['Workers'],
+            openApi: { operationId: 'resolveWorkerSourceIdentityConflict' },
+        },
+    },
+}, {
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

package/dist/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-source-identity-conflicts.contract.spec.d.ts.map

package/dist/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-source-identity-conflicts.contract.spec.d.ts","sourceRoot":"","sources":["../../contracts/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.spec.ts"],"names":[],"mappings":""}

package/dist/worker-source-identity-conflicts/worker-source-identity-conflicts.contract.spec.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const workers_contract_1 = require("../workers/workers.contract");
+const worker_source_identity_conflicts_contract_1 = require("./worker-source-identity-conflicts.contract");
+describe('worker source identity conflict contracts', () => {
+    const candidateCuratedWorkerIds = [crypto.randomUUID(), crypto.randomUUID()];
+    const identityConflictReference = {
+        id: crypto.randomUUID(),
+        status: 'OPEN',
+        reviewUrl: '/workers/identity-matches?workerSourceIdentityConflictId=case-id',
+    };
+    const conflictSummary = {
+        ...identityConflictReference,
+        context: 'SINGLE',
+        contextId: null,
+        rowNumber: null,
+        submittedWorkerName: 'Earl Kearney',
+        submittedPhoneMasks: ['+44••••1417', '+44••••2894'],
+        candidateCuratedWorkerIds,
+        selectedCuratedWorkerId: null,
+        createdAt: '2026-07-21T15:35:52.270Z',
+        expiresAt: '2026-07-28T15:35:52.270Z',
+        reviewedAt: null,
+        terminalAt: null,
+    };
+    const candidateEvidence = [
+        {
+            phoneMasked: '+44••••1417',
+            curatedWorker: {
+                id: candidateCuratedWorkerIds[0],
+                firstName: 'Earl',
+                lastName: 'Kearney',
+            },
+            contactedAt: '2026-07-17T15:35:52.270Z',
+            channel: 'PHONE',
+            outcome: 'INTERESTED',
+            qualifyingContactCount: 1,
+            revealIds: [crypto.randomUUID()],
+            contactEventIds: [crypto.randomUUID()],
+            callIds: [crypto.randomUUID()],
+        },
+        {
+            phoneMasked: '+44••••2894',
+            curatedWorker: {
+                id: candidateCuratedWorkerIds[1],
+                firstName: 'Errol',
+                lastName: 'Kearney',
+            },
+            contactedAt: '2026-07-18T15:35:52.270Z',
+            channel: 'WHATSAPP',
+            outcome: 'OFFER_SENT',
+            qualifyingContactCount: 1,
+            revealIds: [crypto.randomUUID()],
+            contactEventIds: [crypto.randomUUID()],
+            callIds: [],
+        },
+    ];
+    it('accepts an OPEN display-safe summary', () => {
+        expect(worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictSummarySchema.parse(conflictSummary)).not.toHaveProperty('pendingPayload');
+    });
+    it('rejects private and raw-phone fields at every public detail boundary', () => {
+        expect(() => worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictSummarySchema.parse({
+            ...conflictSummary,
+            pendingPayload: { firstName: 'Earl' },
+        })).toThrow();
+        expect(() => worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictDetailSchema.parse({
+            ...conflictSummary,
+            candidateEvidence: [
+                {
+                    ...candidateEvidence[0],
+                    phoneE164: '+447700901417',
+                },
+                candidateEvidence[1],
+            ],
+            retainedPhoneMasks: [],
+            excludedPhoneMasks: [],
+        })).toThrow();
+        expect(() => worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictDetailSchema.parse({
+            ...conflictSummary,
+            candidateEvidence: [
+                {
+                    ...candidateEvidence[0],
+                    phoneMasked: '+447700901417',
+                },
+                candidateEvidence[1],
+            ],
+            retainedPhoneMasks: [],
+            excludedPhoneMasks: [],
+        })).toThrow();
+    });
+    it('keeps conflict references owner-safe and strict', () => {
+        expect(worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictReferenceSchema.parse(identityConflictReference)).toEqual(identityConflictReference);
+        expect(() => worker_source_identity_conflicts_contract_1.WorkerSourceIdentityConflictReferenceSchema.parse({
+            ...identityConflictReference,
+            candidateCuratedWorkerIds,
+        })).toThrow();
+    });
+    it('requires a UUID curated-worker selection', () => {
+        expect(worker_source_identity_conflicts_contract_1.ResolveWorkerSourceIdentityConflictBodySchema.parse({
+            selectedCuratedWorkerId: candidateCuratedWorkerIds[0],
+        }).selectedCuratedWorkerId).toBe(candidateCuratedWorkerIds[0]);
+        expect(() => worker_source_identity_conflicts_contract_1.ResolveWorkerSourceIdentityConflictBodySchema.parse({
+            selectedCuratedWorkerId: 'not-a-uuid',
+        })).toThrow();
+    });
+    it('uses strict discriminated batch creation results', () => {
+        expect(() => workers_contract_1.BatchCreateWorkerResultSchema.parse({ index: 0, status: 'SUCCESS' })).toThrow();
+        expect(() => workers_contract_1.BatchCreateWorkerResultSchema.parse({
+            index: 0,
+            status: 'IDENTITY_CONFLICT',
+            workerId: crypto.randomUUID(),
+        })).toThrow();
+        const parsedConflictResult = workers_contract_1.BatchCreateWorkerResultSchema.parse({
+            index: 0,
+            status: 'IDENTITY_CONFLICT',
+            identityConflict: identityConflictReference,
+        });
+        expect(parsedConflictResult.status).toBe('IDENTITY_CONFLICT');
+        if (parsedConflictResult.status !== 'IDENTITY_CONFLICT') {
+            throw new Error('Expected an identity conflict result');
+        }
+        expect(parsedConflictResult.identityConflict).toEqual(identityConflictReference);
+        expect(() => workers_contract_1.BatchCreateWorkerResultSchema.parse({
+            index: 0,
+            status: 'IDENTITY_CONFLICT',
+            identityConflict: identityConflictReference,
+            challenge: { id: crypto.randomUUID() },
+        })).toThrow();
+    });
+    it('defines a typed single-create identity conflict response', () => {
+        const createConflictSchema = workers_contract_1.workersContractRouter.create.responses[409];
+        expect(createConflictSchema.parse({
+            message: 'Identity review is required before this worker can be created',
+            code: 'WORKER_IDENTITY_CONFLICT',
+            statusCode: 409,
+            details: { identityConflict: identityConflictReference },
+        }).code).toBe('WORKER_IDENTITY_CONFLICT');
+    });
+    it('adds identity conflict review references to import progress', () => {
+        const identityConflictCaseIds = [identityConflictReference.id];
+        const importJobId = crypto.randomUUID();
+        expect(workers_contract_1.WorkerImportJobSchema.parse({
+            id: importJobId,
+            status: 'COMPLETED',
+            totalRows: 2,
+            successCount: 1,
+            failedCount: 0,
+            skippedCount: 0,
+            awaitingAttributionCount: 0,
+            identityConflictCount: 1,
+            identityConflictReviewUrl: `/workers/identity-matches?workerSourceIdentityConflictContext=IMPORT&workerSourceIdentityConflictContextId=${importJobId}`,
+            identityConflictCaseIds,
+            sourceFileId: crypto.randomUUID(),
+            createdByUserId: crypto.randomUUID(),
+            createdAt: '2026-07-21T15:35:52.270Z',
+        }).identityConflictCaseIds).toEqual(identityConflictCaseIds);
+    });
+    it('defines reviewer list, detail, and resolution routes', () => {
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.method).toBe('GET');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.path).toBe('/v2/workers/source-identity-conflicts');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.query.parse({})).toEqual({
+            page: 1,
+            limit: 50,
+            status: 'OPEN',
+        });
+        expect(() => worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.query.parse({ limit: 201 })).toThrow();
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.responses[200].parse({
+            cases: [conflictSummary],
+            totalCount: 1,
+            totalPages: 1,
+            page: 1,
+            limit: 50,
+        }).cases).toHaveLength(1);
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.getOne.method).toBe('GET');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.getOne.path).toBe('/v2/workers/source-identity-conflicts/:id');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.getOne.responses[200].parse({
+            ...conflictSummary,
+            candidateEvidence,
+            retainedPhoneMasks: [],
+            excludedPhoneMasks: [],
+        }).candidateEvidence).toHaveLength(2);
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.resolve.method).toBe('POST');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.resolve.path).toBe('/v2/workers/source-identity-conflicts/:id/resolve');
+        expect(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.resolve.responses[200].parse({
+            identityConflict: {
+                ...identityConflictReference,
+                status: 'RESOLVED',
+            },
+            challenge: {
+                id: crypto.randomUUID(),
+                context: 'SINGLE',
+                status: 'PENDING',
+                submittedWorkerName: 'Earl Kearney',
+                match: {
+                    curatedWorker: candidateEvidence[0].curatedWorker,
+                    phoneMasked: candidateEvidence[0].phoneMasked,
+                    contactedAt: candidateEvidence[0].contactedAt,
+                    channel: candidateEvidence[0].channel,
+                    outcome: candidateEvidence[0].outcome,
+                    qualifyingContactCount: 1,
+                },
+                expiresAt: '2026-07-29T15:35:52.270Z',
+                createdAt: '2026-07-22T15:35:52.270Z',
+                identityReviewAdjustment: {
+                    caseId: identityConflictReference.id,
+                    retainedPhoneMasks: ['+44••••1417'],
+                    excludedPhoneMasks: ['+44••••2894'],
+                },
+            },
+            retainedPhoneMasks: ['+44••••1417'],
+            excludedPhoneMasks: ['+44••••2894'],
+        }).excludedPhoneMasks).toEqual(['+44••••2894']);
+        expect(index_1.apiContractRouter.WorkerSourceIdentityConflicts.list.path).toBe(worker_source_identity_conflicts_contract_1.workerSourceIdentityConflictsContract.list.path);
+    });
+});