@dakkitor/api-contracts 1.8.0 → 1.9.2

package/dist/notifications/notifications.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.contract.d.ts","sourceRoot":"","sources":["../../contracts/notifications/notifications.contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;mDAGmD;AACnD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAKvC,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOM,CAAC;AAEzD,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;EAKM,CAAC;AAC5D,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wCAAwC,CAAC,CAAC;AAE1G,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;EAKM,CAAC;AAC3D,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,sBAAsB,uEAA4G,CAAC;AAEhJ,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBM,CAAC;AAEtC,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGM,CAAC;AAIlD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC"}
+{"version":3,"file":"notifications.contract.d.ts","sourceRoot":"","sources":["../../contracts/notifications/notifications.contract.ts"],"names":[],"mappings":"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"}

package/dist/notifications/notifications.contract.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.notificationsContract = exports.NotificationListResponseSchema = exports.NotificationSchema = exports.NotificationKindSchema = exports.AiMergeAppliedNotificationPayloadSchema = exports.AiMergeMismatchNotificationPayloadSchema = exports.ActiveStatusNotificationPayloadSchema = exports.ActiveStatusBatchEntrySchema = void 0;
+exports.notificationsContract = exports.NotificationListResponseSchema = exports.NotificationSchema = exports.NotificationKindSchema = exports.LeadCallbackDueNotificationPayloadSchema = exports.CandidateCallCallbackNotificationPayloadSchema = exports.AiMergeAppliedNotificationPayloadSchema = exports.AiMergeMismatchNotificationPayloadSchema = exports.ActiveStatusNotificationPayloadSchema = exports.ActiveStatusBatchEntrySchema = void 0;
 const zod_openapi_1 = require("@anatine/zod-openapi");
 const core_1 = require("@ts-rest/core");
 const zod_1 = require("zod");
@@ -38,7 +38,27 @@ exports.AiMergeAppliedNotificationPayloadSchema = zod_1.z.object({
     workerNames: zod_1.z.array(zod_1.z.string()),
     createdAt: zod_1.z.string(),
 }).openapi({ title: 'AiMergeAppliedNotificationPayload' });
-exports.NotificationKindSchema = zod_1.z.enum(['ACTIVE_STATUS', 'AI_MERGE_MISMATCH', 'AI_MERGE_APPLIED']).openapi({ title: 'NotificationKind' });
+/** Emitted by CandidateCallCallbackService.sweep() when a candidate asked to
+ *  be called back and the requested (or fallback) time has arrived.
+ *  `requestedAt` mirrors pass 2's raw extraction — null means the candidate
+ *  asked for a callback without naming a specific time. */
+exports.CandidateCallCallbackNotificationPayloadSchema = zod_1.z.object({
+    callId: zod_1.z.string().uuid(),
+    candidateName: zod_1.z.string(),
+    requestedAt: zod_1.z.string().nullable(),
+    jobId: zod_1.z.string().uuid(),
+}).openapi({ title: 'CandidateCallCallbackNotificationPayload' });
+exports.LeadCallbackDueNotificationPayloadSchema = zod_1.z.object({
+    callbackId: zod_1.z.string().uuid(),
+    leadId: zod_1.z.string().uuid(),
+    leadName: zod_1.z.string(),
+    companyName: zod_1.z.string().nullable(),
+    phoneNumber: zod_1.z.string(),
+    dueAt: zod_1.z.string(),
+    originRating: zod_1.z.number(),
+    originNotes: zod_1.z.string().nullable(),
+}).openapi({ title: 'LeadCallbackDueNotificationPayload' });
+exports.NotificationKindSchema = zod_1.z.enum(['ACTIVE_STATUS', 'AI_MERGE_MISMATCH', 'AI_MERGE_APPLIED', 'CANDIDATE_CALL_CALLBACK', 'LEAD_CALLBACK_DUE']).openapi({ title: 'NotificationKind' });
 /** Discriminated union on `kind`; new kinds extend the union. */
 exports.NotificationSchema = zod_1.z.discriminatedUnion('kind', [
     zod_1.z.object({
@@ -62,6 +82,20 @@ exports.NotificationSchema = zod_1.z.discriminatedUnion('kind', [
         payload: exports.AiMergeAppliedNotificationPayloadSchema,
         createdAt: zod_1.z.string(),
     }),
+    zod_1.z.object({
+        id: zod_1.z.string().uuid(),
+        kind: zod_1.z.literal('CANDIDATE_CALL_CALLBACK'),
+        refId: zod_1.z.string(),
+        payload: exports.CandidateCallCallbackNotificationPayloadSchema,
+        createdAt: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        id: zod_1.z.string().uuid(),
+        kind: zod_1.z.literal('LEAD_CALLBACK_DUE'),
+        refId: zod_1.z.string(),
+        payload: exports.LeadCallbackDueNotificationPayloadSchema,
+        createdAt: zod_1.z.string(),
+    }),
 ]).openapi({ title: 'Notification' });
 exports.NotificationListResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.NotificationSchema),

package/dist/notifications/notifications.contract.spec.d.ts

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

package/dist/notifications/notifications.contract.spec.d.ts.map

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

package/dist/notifications/notifications.contract.spec.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const notifications_contract_1 = require("./notifications.contract");
+const payload = {
+    callbackId: '11111111-1111-4111-8111-111111111111',
+    leadId: '22222222-2222-4222-8222-222222222222',
+    leadName: 'J Carolan Plastering Services',
+    companyName: 'BRIXWELL GROUP LTD',
+    phoneNumber: '+447307201875',
+    dueAt: '2026-09-01T13:15:00.000Z',
+    originRating: 6,
+    originNotes: 'Asked for a call back Tuesday afternoon',
+};
+(0, bun_test_1.describe)('LEAD_CALLBACK_DUE notification', () => {
+    (0, bun_test_1.it)('is a known kind', () => {
+        (0, bun_test_1.expect)(notifications_contract_1.NotificationKindSchema.safeParse('LEAD_CALLBACK_DUE').success).toBe(true);
+    });
+    (0, bun_test_1.it)('parses a full notification', () => {
+        const parsed = notifications_contract_1.NotificationSchema.safeParse({
+            id: '33333333-3333-4333-8333-333333333333',
+            kind: 'LEAD_CALLBACK_DUE',
+            refId: payload.callbackId,
+            payload,
+            createdAt: '2026-09-01T13:05:00.000Z',
+        });
+        (0, bun_test_1.expect)(parsed.success).toBe(true);
+    });
+    (0, bun_test_1.it)('allows a null company and null notes', () => {
+        const parsed = notifications_contract_1.NotificationSchema.safeParse({
+            id: '33333333-3333-4333-8333-333333333333',
+            kind: 'LEAD_CALLBACK_DUE',
+            refId: payload.callbackId,
+            payload: { ...payload, companyName: null, originNotes: null },
+            createdAt: '2026-09-01T13:05:00.000Z',
+        });
+        (0, bun_test_1.expect)(parsed.success).toBe(true);
+    });
+});

package/dist/outreach/__tests__/outreach-claim.test.js

@@ -17,6 +17,39 @@ const widened = outreach_contract_1.ClaimNextOutreachBodySchema.safeParse({
 node_assert_1.default.ok(widened.success);
 node_assert_1.default.equal(Object.prototype.hasOwnProperty.call(widened.data, 'maxCommuteMinutes'), false);
 node_assert_1.default.ok(!outreach_contract_1.ClaimNextOutreachBodySchema.safeParse({}).success);
+// The agent lane is a separate, strict envelope. These fields are the frozen
+// proof of the exact Hub reservation that authorized this launch; ordinary
+// legacy claim callers never need (and cannot accidentally acquire) it.
+const AGENT_CLAIM_BODY = {
+    deviceId: 'rack-01',
+    authority: {
+        launchId: '0ce54488-598f-49a9-8c1a-ff843799c206',
+        campaignId: '0ce54488-598f-49a9-8c1a-ff843799c206',
+        jobId: 'b683831e-c98c-44c0-b75d-bd0356713f4e',
+        claimedLifecycleVersion: 7,
+        reservationCorrelationId: '9d84efb7-1ef1-4450-ad4d-22297806781f',
+        assignedPodId: '771db561-0701-4469-9e49-de618a07f8ac',
+    },
+};
+node_assert_1.default.ok(outreach_contract_1.AgentClaimNextOutreachBodySchema.safeParse(AGENT_CLAIM_BODY).success);
+node_assert_1.default.ok(!outreach_contract_1.AgentClaimNextOutreachBodySchema.safeParse({
+    ...AGENT_CLAIM_BODY,
+    authority: {
+        ...AGENT_CLAIM_BODY.authority,
+        campaignId: 'bb49aedf-e17b-45bf-9087-5bf18ec7e2f0',
+    },
+}).success, 'campaign and launch identities are one stable authority');
+node_assert_1.default.ok(!outreach_contract_1.AgentClaimNextOutreachBodySchema.safeParse({
+    ...AGENT_CLAIM_BODY,
+    maxCommuteMinutes: 240,
+}).success, 'agent authority rejects rather than strips unexpected widening fields');
+node_assert_1.default.ok(!outreach_contract_1.AgentClaimNextOutreachBodySchema.safeParse({
+    deviceId: AGENT_CLAIM_BODY.deviceId,
+    authority: {
+        ...AGENT_CLAIM_BODY.authority,
+        claimedLifecycleVersion: -1,
+    },
+}).success);
 // --- TTL -------------------------------------------------------------------
 node_assert_1.default.equal(outreach_contract_1.OUTREACH_LEASE_TTL_MINUTES, 15);
 // --- CLAIMED ---------------------------------------------------------------

package/dist/outreach/__tests__/outreach-routes.test.js

@@ -9,6 +9,8 @@ const outreach_contract_1 = require("../outreach.contract");
 // `pathPrefix: '/v2'` is applied by c.router, so the runtime paths are absolute.
 node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNext.method, 'POST');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNext.path, '/v2/outreach/requests/:requestId/claim-next');
+node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNextAgent.method, 'POST');
+node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNextAgent.path, '/v2/outreach/requests/:requestId/agent-claim-next');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNextLegacy.method, 'POST');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.claimNextLegacy.path, '/v2/outreach/jobs/:jobId/claim-next');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.confirmSent.method, 'POST');
@@ -23,11 +25,13 @@ const declared = (route) => Object.keys(route.responses)
     .map(Number)
     .sort((a, b) => a - b);
 node_assert_1.default.deepStrictEqual(declared(outreach_contract_1.outreachContract.claimNext), [200, 400, 401, 403, 409, 500]);
+node_assert_1.default.deepStrictEqual(declared(outreach_contract_1.outreachContract.claimNextAgent), [200, 400, 401, 403, 409, 500]);
 node_assert_1.default.deepStrictEqual(declared(outreach_contract_1.outreachContract.claimNextLegacy), [200, 400, 401, 403, 409, 500]);
 node_assert_1.default.deepStrictEqual(declared(outreach_contract_1.outreachContract.confirmSent), [200, 400, 401, 403, 404, 500]);
 node_assert_1.default.deepStrictEqual(declared(outreach_contract_1.outreachContract.release), [200, 400, 401, 403, 404, 500]);
 for (const route of [
     outreach_contract_1.outreachContract.claimNext,
+    outreach_contract_1.outreachContract.claimNextAgent,
     outreach_contract_1.outreachContract.claimNextLegacy,
     outreach_contract_1.outreachContract.confirmSent,
     outreach_contract_1.outreachContract.release,
@@ -38,6 +42,9 @@ for (const route of [
 node_assert_1.default.ok(outreach_contract_1.outreachContract.claimNext.pathParams.safeParse({
     requestId: '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
 }).success);
+node_assert_1.default.ok(outreach_contract_1.outreachContract.claimNextAgent.pathParams.safeParse({
+    requestId: '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
+}).success);
 node_assert_1.default.ok(!outreach_contract_1.outreachContract.claimNext.pathParams.safeParse({ requestId: 'nope' })
     .success);
 node_assert_1.default.ok(outreach_contract_1.outreachContract.claimNextLegacy.pathParams.safeParse({
@@ -56,6 +63,7 @@ node_assert_1.default.ok(outreach_contract_1.outreachContract.confirmSent.pathPa
 const headersOf = (route) => route.headers;
 for (const route of [
     outreach_contract_1.outreachContract.claimNext,
+    outreach_contract_1.outreachContract.claimNextAgent,
     outreach_contract_1.outreachContract.claimNextLegacy,
     outreach_contract_1.outreachContract.confirmSent,
     outreach_contract_1.outreachContract.release,