@dakkitor/api-contracts 1.8.0 → 1.9.1

package/dist/outreach/relay-hub-outreach.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-hub-outreach.contract.d.ts","sourceRoot":"","sources":["../../contracts/outreach/relay-hub-outreach.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFpC,CAAC"}
+{"version":3,"file":"relay-hub-outreach.contract.d.ts","sourceRoot":"","sources":["../../contracts/outreach/relay-hub-outreach.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGpC,CAAC"}

package/dist/outreach/relay-hub-outreach.contract.js

@@ -5,6 +5,7 @@ const core_1 = require("@ts-rest/core");
 const zod_1 = require("zod");
 const error_schemas_1 = require("../common/error-schemas");
 const relay_hub_schemas_1 = require("../relay-pods/relay-hub.schemas");
+const relay_hub_outreach_schemas_1 = require("./relay-hub-outreach.schemas");
 const c = (0, core_1.initContract)();
 const RelayHubOutreachPathParamsSchema = zod_1.z
     .object({
@@ -27,6 +28,15 @@ exports.relayHubOutreachContract = c.router({
         summary: 'List Relay Hub outreach work assigned to a pod',
         metadata: { tags: ['Relay Hub Outreach'] },
     },
+    listAuthoring: {
+        method: 'GET',
+        path: '/authoring',
+        responses: {
+            200: zod_1.z.array(relay_hub_outreach_schemas_1.RelayHubOutreachAuthoringItemSchema),
+        },
+        summary: 'List Hub outreach requests with bounded campaign-authoring context',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
     claim: {
         method: 'POST',
         path: '/:id/claim',

package/dist/outreach/relay-hub-outreach.contract.spec.js

@@ -4,11 +4,36 @@ const bun_test_1 = require("bun:test");
 const index_1 = require("../index");
 const relay_hub_schemas_1 = require("../relay-pods/relay-hub.schemas");
 const relay_hub_outreach_contract_1 = require("./relay-hub-outreach.contract");
+const relay_hub_outreach_schemas_1 = require("./relay-hub-outreach.schemas");
 const requestId = '11111111-1111-4111-8111-111111111111';
 const podId = '22222222-2222-4222-8222-222222222222';
 const idempotencyKey = '33333333-3333-4333-8333-333333333333';
 const correlationId = '44444444-4444-4444-8444-444444444444';
+const jobId = '55555555-5555-4555-8555-555555555555';
+const authoringFixture = {
+    id: requestId,
+    assignedPodId: podId,
+    lifecycle: 'QUEUED',
+    lifecycleVersion: 0,
+    requestedAt: '2026-08-16T10:00:00.000Z',
+    jobId,
+    eligibleAtRequest: 4,
+    requestedByName: 'Outreach Agent',
+    job: {
+        id: jobId,
+        title: 'Electrician',
+        trade: 'Electrical',
+        payText: '£22 per hour',
+        locationText: 'SW1A 1AA',
+        createdByName: 'Recruitment Agent',
+    },
+};
 (0, bun_test_1.describe)('Relay Hub outreach schemas', () => {
+    (0, bun_test_1.it)('adds a separate strict authoring view without widening the old queue item', () => {
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.listAuthoring.path).toBe('/v3/relay-hub/outreach/authoring');
+        (0, bun_test_1.expect)(relay_hub_outreach_schemas_1.RelayHubOutreachAuthoringItemSchema.parse(authoringFixture).job.title).toBe('Electrician');
+        (0, bun_test_1.expect)(() => relay_hub_schemas_1.RelayHubOutreachQueueItemSchema.parse(authoringFixture)).toThrow();
+    });
     (0, bun_test_1.it)('requires every queue item to remain assigned to one concrete pod', () => {
         (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachQueueItemSchema.parse({
             id: requestId,
@@ -84,6 +109,7 @@ const correlationId = '44444444-4444-4444-8444-444444444444';
     (0, bun_test_1.it)('publishes the immutable single-pod lifecycle without reassignment or Lab route arrays', () => {
         (0, bun_test_1.expect)(Object.keys(relay_hub_outreach_contract_1.relayHubOutreachContract)).toEqual([
             'list',
+            'listAuthoring',
             'claim',
             'accept',
             'progress',

package/dist/outreach/relay-hub-outreach.schemas.d.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+export declare const RelayHubOutreachAuthoringJobSchema: z.ZodObject<{
+    title: z.ZodString;
+    trade: z.ZodNullable<z.ZodString>;
+    payText: z.ZodNullable<z.ZodString>;
+    locationText: z.ZodNullable<z.ZodString>;
+    createdByName: z.ZodNullable<z.ZodString>;
+} & {
+    id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    trade: string | null;
+    payText: string | null;
+    locationText: string | null;
+    createdByName: string | null;
+    id: string;
+}, {
+    title: string;
+    trade: string | null;
+    payText: string | null;
+    locationText: string | null;
+    createdByName: string | null;
+    id: string;
+}>;
+export declare const RelayHubOutreachAuthoringItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    assignedPodId: z.ZodString;
+    lifecycle: z.ZodEnum<["QUEUED", "CLAIMED", "ACCEPTED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"]>;
+    lifecycleVersion: z.ZodNumber;
+    requestedAt: z.ZodString;
+} & {
+    jobId: z.ZodString;
+    eligibleAtRequest: z.ZodNumber;
+    requestedByName: z.ZodNullable<z.ZodString>;
+    job: z.ZodObject<{
+        title: z.ZodString;
+        trade: z.ZodNullable<z.ZodString>;
+        payText: z.ZodNullable<z.ZodString>;
+        locationText: z.ZodNullable<z.ZodString>;
+        createdByName: z.ZodNullable<z.ZodString>;
+    } & {
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        trade: string | null;
+        payText: string | null;
+        locationText: string | null;
+        createdByName: string | null;
+        id: string;
+    }, {
+        title: string;
+        trade: string | null;
+        payText: string | null;
+        locationText: string | null;
+        createdByName: string | null;
+        id: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    jobId: string;
+    assignedPodId: string;
+    job: {
+        title: string;
+        trade: string | null;
+        payText: string | null;
+        locationText: string | null;
+        createdByName: string | null;
+        id: string;
+    };
+    id: string;
+    eligibleAtRequest: number;
+    requestedByName: string | null;
+    requestedAt: string;
+    lifecycle: "CLAIMED" | "RUNNING" | "CANCELLED" | "FAILED" | "QUEUED" | "ACCEPTED" | "SUCCEEDED";
+    lifecycleVersion: number;
+}, {
+    jobId: string;
+    assignedPodId: string;
+    job: {
+        title: string;
+        trade: string | null;
+        payText: string | null;
+        locationText: string | null;
+        createdByName: string | null;
+        id: string;
+    };
+    id: string;
+    eligibleAtRequest: number;
+    requestedByName: string | null;
+    requestedAt: string;
+    lifecycle: "CLAIMED" | "RUNNING" | "CANCELLED" | "FAILED" | "QUEUED" | "ACCEPTED" | "SUCCEEDED";
+    lifecycleVersion: number;
+}>;
+export type RelayHubOutreachAuthoringItem = z.infer<typeof RelayHubOutreachAuthoringItemSchema>;
+//# sourceMappingURL=relay-hub-outreach.schemas.d.ts.map

package/dist/outreach/relay-hub-outreach.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-hub-outreach.schemas.d.ts","sourceRoot":"","sources":["../../contracts/outreach/relay-hub-outreach.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEd,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,mCAAmC,CAC3C,CAAC"}

package/dist/outreach/relay-hub-outreach.schemas.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayHubOutreachAuthoringItemSchema = exports.RelayHubOutreachAuthoringJobSchema = void 0;
+const zod_1 = require("zod");
+const relay_hub_schemas_1 = require("../relay-pods/relay-hub.schemas");
+const outreach_schemas_1 = require("./outreach.schemas");
+exports.RelayHubOutreachAuthoringJobSchema = outreach_schemas_1.OutreachJobSchema.extend({
+    id: zod_1.z.string().uuid(),
+}).strict();
+exports.RelayHubOutreachAuthoringItemSchema = relay_hub_schemas_1.RelayHubOutreachQueueItemSchema.extend({
+    jobId: zod_1.z.string().uuid(),
+    eligibleAtRequest: zod_1.z.number().int().nonnegative(),
+    requestedByName: zod_1.z.string().min(1).max(256).nullable(),
+    job: exports.RelayHubOutreachAuthoringJobSchema,
+}).strict();

package/dist/own-research/check-phone-response.spec.d.ts

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

package/dist/own-research/check-phone-response.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-phone-response.spec.d.ts","sourceRoot":"","sources":["../../contracts/own-research/check-phone-response.spec.ts"],"names":[],"mappings":""}

package/dist/own-research/check-phone-response.spec.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const own_research_contract_1 = require("./own-research.contract");
+const BASE_RESPONSE = {
+    existsInLeads: true,
+    existsInOwnResearch: false,
+    ownResearchLead: null,
+    isOnCooldown: false,
+    cooldownUntil: null,
+};
+(0, bun_test_1.describe)('CheckPhoneResponseSchema', () => {
+    (0, bun_test_1.test)("preserves a matching lead's typed status and status reason", () => {
+        const parsed = own_research_contract_1.CheckPhoneResponseSchema.parse({
+            ...BASE_RESPONSE,
+            lead: {
+                id: '11111111-1111-4111-8111-111111111111',
+                name: 'Acme Roofing',
+                phoneNumber: '+447911123456',
+                status: 'PARKED',
+                cooldownUntil: null,
+                blacklistReason: "Auto-parked after 7 consecutive 'No Answer' calls.",
+            },
+        });
+        (0, bun_test_1.expect)(parsed.lead?.status).toBe('PARKED');
+        (0, bun_test_1.expect)(parsed.lead?.blacklistReason).toBe("Auto-parked after 7 consecutive 'No Answer' calls.");
+    });
+    (0, bun_test_1.test)('accepts legacy matching leads without a reason', () => {
+        const parsed = own_research_contract_1.CheckPhoneResponseSchema.parse({
+            ...BASE_RESPONSE,
+            lead: {
+                id: '11111111-1111-4111-8111-111111111111',
+                name: 'Acme Roofing',
+                phoneNumber: '+447911123456',
+                status: 'AVAILABLE',
+                cooldownUntil: null,
+            },
+        });
+        (0, bun_test_1.expect)(parsed.lead?.blacklistReason).toBeUndefined();
+    });
+    (0, bun_test_1.test)('rejects a status outside LeadStatusSchema', () => {
+        const result = own_research_contract_1.CheckPhoneResponseSchema.safeParse({
+            ...BASE_RESPONSE,
+            lead: {
+                id: '11111111-1111-4111-8111-111111111111',
+                name: 'Acme Roofing',
+                phoneNumber: '+447911123456',
+                status: 'COOLDOWN',
+                cooldownUntil: null,
+            },
+        });
+        (0, bun_test_1.expect)(result.success).toBe(false);
+    });
+});