@dakkitor/api-contracts 1.9.1 → 1.9.3

package/dist/candidate-calling/candidate-calling.contract.spec.js

@@ -1,6 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const candidate_calling_contract_1 = require("./candidate-calling.contract");
+describe('candidate calling ring target', () => {
+    it('accepts only DESKTOP and PHONE', () => {
+        expect(candidate_calling_contract_1.CandidateCallingRingTargetSchema.parse('DESKTOP')).toBe('DESKTOP');
+        expect(candidate_calling_contract_1.CandidateCallingRingTargetSchema.parse('PHONE')).toBe('PHONE');
+        expect(candidate_calling_contract_1.CandidateCallingRingTargetSchema.safeParse('FAX').success).toBe(false);
+    });
+    it('reports the ring target on availability', () => {
+        const parsed = candidate_calling_contract_1.CandidateCallingAvailabilitySchema.parse({
+            enabled: true,
+            reason: null,
+            ringTarget: 'PHONE',
+        });
+        expect(parsed.ringTarget).toBe('PHONE');
+    });
+    it('exposes a route to change the ring target', () => {
+        expect(candidate_calling_contract_1.candidateCallingContract.setRingTarget.method).toBe('PATCH');
+        expect(candidate_calling_contract_1.candidateCallingContract.setRingTarget.path).toBe('/v2/candidate-calling-queues/ring-target');
+    });
+});
 describe('candidate calling contract', () => {
     it('pins the application routes', () => {
         expect(candidate_calling_contract_1.candidateCallingContract.availability).toMatchObject({
@@ -31,6 +50,14 @@ describe('candidate calling contract', () => {
             method: 'GET',
             path: '/v2/candidate-dialpad-calls/:callId/review-artifact',
         });
+        expect(candidate_calling_contract_1.candidateCallingContract.getCallReview).toMatchObject({
+            method: 'GET',
+            path: '/v2/candidate-dialpad-calls/:callId/review',
+        });
+        expect(candidate_calling_contract_1.candidateCallingContract.resolveProfileFact).toMatchObject({
+            method: 'POST',
+            path: '/v2/candidate-dialpad-calls/:callId/profile-facts/:field/resolve',
+        });
     });
     it('validates every route path parameter as a UUID', () => {
         const uuid = '88888888-8888-4888-8888-888888888888';
@@ -77,6 +104,8 @@ describe('candidate calling contract', () => {
         expect(Object.keys(candidate_calling_contract_1.candidateCallingContract.endCall.responses).map(Number)).toEqual([200, 403, 404, 409]);
         expect(Object.keys(candidate_calling_contract_1.candidateCallingContract.stopQueue.responses).map(Number)).toEqual([200, 403, 404, 409]);
         expect(Object.keys(candidate_calling_contract_1.candidateCallingContract.reviewArtifact.responses).map(Number)).toEqual([200, 403, 404, 409, 410]);
+        expect(Object.keys(candidate_calling_contract_1.candidateCallingContract.getCallReview.responses).map(Number)).toEqual([200, 403, 404]);
+        expect(Object.keys(candidate_calling_contract_1.candidateCallingContract.resolveProfileFact.responses).map(Number)).toEqual([200, 403, 404, 409]);
     });
     it('uses strict end intent and complete managed states', () => {
         expect(candidate_calling_contract_1.candidateCallingContract.endCall.body.safeParse({
@@ -97,6 +126,12 @@ describe('candidate calling contract', () => {
             'CANCELLED',
         ]);
     });
+    it('accepts only live queue, historical import, and automatic probe call sources', () => {
+        expect(candidate_calling_contract_1.CandidateDialpadCallSourceSchema.safeParse('LIVE_QUEUE').success).toBe(true);
+        expect(candidate_calling_contract_1.CandidateDialpadCallSourceSchema.safeParse('HISTORICAL_IMPORT').success).toBe(true);
+        expect(candidate_calling_contract_1.CandidateDialpadCallSourceSchema.safeParse('AUTOMATIC_PROBE').success).toBe(true);
+        expect(candidate_calling_contract_1.CandidateDialpadCallSourceSchema.safeParse('MANUAL_IMPORT').success).toBe(false);
+    });
     it('keeps candidate and active-queue wrappers strict', () => {
         const candidate = {
             subjectKind: 'OWNED',
@@ -175,6 +210,135 @@ describe('candidate calling contract', () => {
             modelOutput: { outcome: 'INTERESTED' },
         }).success).toBe(false);
     });
+    it('models the complete profile fact and typed analysis review results', () => {
+        const response = {
+            workerState: { result: { kind: 'ACTIVELY_LOOKING' } },
+            jobs: [{ jobId: '11111111-1111-4111-8111-111111111111' }],
+            profileFacts: [
+                'APPLIED',
+                'CONFLICT',
+                'PENDING',
+                'FAILED',
+                'OVERRIDDEN',
+                'ALREADY_AGREES',
+                'PENDING_REVIEW',
+                'SUPERSEDED',
+            ].map((status) => ({
+                field: 'englishLevel',
+                value: 'ADVANCED',
+                status,
+                agentValue: 'BASIC',
+                evidence: ['She said her English is very good'],
+                evidenceReferences: [
+                    {
+                        quote: 'She said her English is very good',
+                        turnId: null,
+                        startMs: null,
+                        endMs: null,
+                    },
+                ],
+            })),
+            referral: null,
+            callback: null,
+            reviewReason: null,
+            employmentObservation: {
+                status: 'WORKING',
+                elapsedDuration: { value: 2, unit: 'WEEK' },
+                confidence: 0.92,
+                evidence: ['She has worked there for two weeks'],
+            },
+            phoneAssessment: {
+                result: 'CONFIRMED_WORKER',
+                confidence: 0.97,
+                evidence: ['The worker confirmed their identity'],
+            },
+        };
+        expect(candidate_calling_contract_1.CandidateCallReviewResponseSchema.parse(response)).toEqual(response);
+        const legacyProfileFactResponse = {
+            ...response,
+            profileFacts: response.profileFacts.map(({ evidenceReferences: _evidenceReferences, ...fact }) => fact),
+        };
+        expect(candidate_calling_contract_1.CandidateCallReviewResponseSchema.parse(legacyProfileFactResponse)).toEqual(legacyProfileFactResponse);
+        expect(candidate_calling_contract_1.CandidateCallProfileFactStatusSchema.safeParse('SUPERSEDED').success).toBe(true);
+        expect(candidate_calling_contract_1.CandidateCallReviewResponseSchema.safeParse({
+            ...response,
+            extra: true,
+        }).success).toBe(false);
+        expect(candidate_calling_contract_1.CandidateCallReviewResponseSchema.safeParse({
+            ...response,
+            profileFacts: [{ ...response.profileFacts[0], status: 'NOT_A_STATUS' }],
+        }).success).toBe(false);
+    });
+    it('accepts only inbound and outbound Dialpad call directions', () => {
+        expect(candidate_calling_contract_1.CandidateDialpadCallDirectionSchema.parse('INBOUND')).toBe('INBOUND');
+        expect(candidate_calling_contract_1.CandidateDialpadCallDirectionSchema.parse('OUTBOUND')).toBe('OUTBOUND');
+        expect(candidate_calling_contract_1.CandidateDialpadCallDirectionSchema.safeParse('SIDEWAYS').success).toBe(false);
+    });
+    it('parses timed and legacy-normalized transcript rows and rejects invalid timings', () => {
+        const timedTranscript = {
+            outcome: 'TRANSCRIPT',
+            languages: ['en', 'ro'],
+            turns: [
+                {
+                    id: 'turn-0001',
+                    speaker: 'AGENT',
+                    text: 'Hello, this is Lorena.',
+                    startMs: 840,
+                    endMs: 2470,
+                },
+            ],
+        };
+        expect(candidate_calling_contract_1.CandidateDialpadCallTranscriptResponseSchema.parse(timedTranscript)).toEqual(timedTranscript);
+        expect(candidate_calling_contract_1.CandidateDialpadCallTranscriptResponseSchema.parse({
+            ...timedTranscript,
+            turns: [{ ...timedTranscript.turns[0], startMs: null, endMs: null }],
+        })).toBeDefined();
+        expect(() => candidate_calling_contract_1.CandidateDialpadCallTranscriptResponseSchema.parse({
+            ...timedTranscript,
+            turns: [{ ...timedTranscript.turns[0], startMs: -1 }],
+        })).toThrow();
+        expect(() => candidate_calling_contract_1.CandidateDialpadCallTranscriptResponseSchema.parse({
+            ...timedTranscript,
+            turns: [{ ...timedTranscript.turns[0], startMs: 840.5 }],
+        })).toThrow();
+    });
+    it('parses linked and unlinked evidence and rejects incomplete or reversed links', () => {
+        expect(candidate_calling_contract_1.CandidateCallReviewEvidenceSchema.parse({
+            quote: 'I can start on Monday.',
+            turnId: 'turn-0007',
+            startMs: 18200,
+            endMs: 19540,
+        })).toBeDefined();
+        expect(candidate_calling_contract_1.CandidateCallReviewEvidenceSchema.parse({
+            quote: 'I can start on Monday.',
+            turnId: null,
+            startMs: null,
+            endMs: null,
+        })).toBeDefined();
+        expect(() => candidate_calling_contract_1.CandidateCallReviewEvidenceSchema.parse({
+            quote: 'I can start on Monday.',
+            turnId: 'turn-0007',
+            startMs: null,
+            endMs: null,
+        })).toThrow();
+        expect(() => candidate_calling_contract_1.CandidateCallReviewEvidenceSchema.parse({
+            quote: 'I can start on Monday.',
+            turnId: 'turn-0007',
+            startMs: 19540,
+            endMs: 18200,
+        })).toThrow();
+    });
+    it('accepts only KEEP_AGENT or APPLY_AI as a profile-fact resolution', () => {
+        expect(candidate_calling_contract_1.ResolveProfileFactBodySchema.safeParse({ resolution: 'APPLY_AI' })
+            .success).toBe(true);
+        expect(candidate_calling_contract_1.ResolveProfileFactBodySchema.safeParse({ resolution: 'KEEP_AGENT' })
+            .success).toBe(true);
+        expect(candidate_calling_contract_1.ResolveProfileFactBodySchema.safeParse({ resolution: 'DISCARD' }).success).toBe(false);
+        expect(candidate_calling_contract_1.ResolveProfileFactBodySchema.safeParse({
+            resolution: 'APPLY_AI',
+            extra: true,
+        }).success).toBe(false);
+    });
     it('publishes only queue identity and change time', () => {
         const payload = {
             queueSessionId: '55555555-5555-4555-8555-555555555555',

package/dist/candidate-calling/candidate-dialpad-call.schemas.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const CandidateDialpadCallStatusSchema: z.ZodEnum<["CLAIMED", "INITIATING", "INITIATION_UNCERTAIN", "RINGING", "CONNECTED", "ENDING", "PROCESSING", "FEEDBACK_RECORDED", "NEEDS_REVIEW", "INITIATION_FAILED", "CANCELLED"]>;
+export type CandidateDialpadCallStatus = z.infer<typeof CandidateDialpadCallStatusSchema>;
+export declare const CandidateDialpadCallSourceSchema: z.ZodEnum<["LIVE_QUEUE", "HISTORICAL_IMPORT", "AUTOMATIC_PROBE"]>;
+export type CandidateDialpadCallSource = z.infer<typeof CandidateDialpadCallSourceSchema>;
+export declare const CandidateDialpadCallDirectionSchema: z.ZodEnum<["INBOUND", "OUTBOUND"]>;
+export type CandidateDialpadCallDirection = z.infer<typeof CandidateDialpadCallDirectionSchema>;
+export declare const CandidateContactHistoryConnectionSchema: z.ZodEnum<["CONNECTED", "NO_ANSWER", "BUSY", "INVALID_NUMBER", "FAILED"]>;
+export type CandidateContactHistoryConnection = z.infer<typeof CandidateContactHistoryConnectionSchema>;
+//# sourceMappingURL=candidate-dialpad-call.schemas.d.ts.map

package/dist/candidate-calling/candidate-dialpad-call.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-dialpad-call.schemas.d.ts","sourceRoot":"","sources":["../../contracts/candidate-calling/candidate-dialpad-call.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gCAAgC,qLAY3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,eAAO,MAAM,gCAAgC,mEAI3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,eAAO,MAAM,mCAAmC,oCAG9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,mCAAmC,CAC3C,CAAC;AAEF,eAAO,MAAM,uCAAuC,2EAMlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC"}

package/dist/candidate-calling/candidate-dialpad-call.schemas.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CandidateContactHistoryConnectionSchema = exports.CandidateDialpadCallDirectionSchema = exports.CandidateDialpadCallSourceSchema = exports.CandidateDialpadCallStatusSchema = void 0;
+const zod_1 = require("zod");
+exports.CandidateDialpadCallStatusSchema = zod_1.z.enum([
+    'CLAIMED',
+    'INITIATING',
+    'INITIATION_UNCERTAIN',
+    'RINGING',
+    'CONNECTED',
+    'ENDING',
+    'PROCESSING',
+    'FEEDBACK_RECORDED',
+    'NEEDS_REVIEW',
+    'INITIATION_FAILED',
+    'CANCELLED',
+]);
+exports.CandidateDialpadCallSourceSchema = zod_1.z.enum([
+    'LIVE_QUEUE',
+    'HISTORICAL_IMPORT',
+    'AUTOMATIC_PROBE',
+]);
+exports.CandidateDialpadCallDirectionSchema = zod_1.z.enum([
+    'INBOUND',
+    'OUTBOUND',
+]);
+exports.CandidateContactHistoryConnectionSchema = zod_1.z.enum([
+    'CONNECTED',
+    'NO_ANSWER',
+    'BUSY',
+    'INVALID_NUMBER',
+    'FAILED',
+]);