@dakkitor/api-contracts 1.4.0 → 1.6.0

package/dist/offices/offices.contract.d.ts

@@ -8,28 +8,28 @@ export declare const OfficeSchema: z.ZodObject<{
         lastName: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }, {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
     managers?: {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }[] | undefined;
 }, {
     id: string;
     name: string;
     managers?: {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }[] | undefined;
 }>;
 export declare const CreateOfficeSchema: z.ZodObject<{
@@ -61,28 +61,28 @@ export declare const OfficeArraySchema: z.ZodArray<z.ZodObject<{
         lastName: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }, {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
     managers?: {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }[] | undefined;
 }, {
     id: string;
     name: string;
     managers?: {
         id: string;
-        lastName: string;
         firstName: string;
+        lastName: string;
     }[] | undefined;
 }>, "many">;
 export type Office = z.infer<typeof OfficeSchema>;
@@ -108,7 +108,7 @@ export declare const officesContract: {
         }>;
         path: "/v2/offices";
         responses: {
-            401: z.ZodObject<{
+            400: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -133,7 +133,7 @@ export declare const officesContract: {
                 details?: unknown;
                 correlationId?: string | undefined;
             }>;
-            400: z.ZodObject<{
+            401: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -217,28 +217,28 @@ export declare const officesContract: {
                     lastName: z.ZodString;
                 }, "strip", z.ZodTypeAny, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }>, "many">>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }>;
             409: z.ZodObject<{
@@ -276,7 +276,7 @@ export declare const officesContract: {
         method: "GET";
         path: "/v2/offices";
         responses: {
-            401: z.ZodObject<{
+            400: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -301,7 +301,7 @@ export declare const officesContract: {
                 details?: unknown;
                 correlationId?: string | undefined;
             }>;
-            400: z.ZodObject<{
+            401: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -385,28 +385,28 @@ export declare const officesContract: {
                     lastName: z.ZodString;
                 }, "strip", z.ZodTypeAny, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }>, "many">>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }>, "many">;
         };
@@ -426,7 +426,7 @@ export declare const officesContract: {
         method: "GET";
         path: "/v2/offices/:id";
         responses: {
-            401: z.ZodObject<{
+            400: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -451,7 +451,7 @@ export declare const officesContract: {
                 details?: unknown;
                 correlationId?: string | undefined;
             }>;
-            400: z.ZodObject<{
+            401: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -535,28 +535,28 @@ export declare const officesContract: {
                     lastName: z.ZodString;
                 }, "strip", z.ZodTypeAny, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }>, "many">>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }>;
             404: z.ZodObject<{
@@ -611,7 +611,7 @@ export declare const officesContract: {
         }>;
         path: "/v2/offices/:id";
         responses: {
-            401: z.ZodObject<{
+            400: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -636,7 +636,7 @@ export declare const officesContract: {
                 details?: unknown;
                 correlationId?: string | undefined;
             }>;
-            400: z.ZodObject<{
+            401: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -720,28 +720,28 @@ export declare const officesContract: {
                     lastName: z.ZodString;
                 }, "strip", z.ZodTypeAny, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }, {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }>, "many">>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }, {
                 id: string;
                 name: string;
                 managers?: {
                     id: string;
-                    lastName: string;
                     firstName: string;
+                    lastName: string;
                 }[] | undefined;
             }>;
             404: z.ZodObject<{
@@ -787,7 +787,7 @@ export declare const officesContract: {
         body: typeof import("@ts-rest/core").ContractNoBody;
         path: "/v2/offices/:id";
         responses: {
-            401: z.ZodObject<{
+            400: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;
@@ -812,7 +812,7 @@ export declare const officesContract: {
                 details?: unknown;
                 correlationId?: string | undefined;
             }>;
-            400: z.ZodObject<{
+            401: z.ZodObject<{
                 statusCode: z.ZodNumber;
                 message: z.ZodString;
                 code: z.ZodString;

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

@@ -41,6 +41,7 @@ const CLAIMED_PAYLOAD = {
         trade: 'CARPENTER',
         payText: '£180/day',
         locationText: 'Croydon, CR0',
+        createdByName: 'Sam Okoro',
     },
 };
 const claimed = outreach_contract_1.ClaimNextOutreachResponseSchema.safeParse(CLAIMED_PAYLOAD);

package/dist/outreach/__tests__/outreach-contract-additions.spec.d.ts

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

package/dist/outreach/__tests__/outreach-contract-additions.spec.d.ts.map

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

package/dist/outreach/__tests__/outreach-contract-additions.spec.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const outreach_schemas_1 = require("../outreach.schemas");
+const jobs_tab_contract_1 = require("../../curated-worker-leads/jobs-tab.contract");
+(0, bun_test_1.describe)('1.5.0 additions stay backward compatible', () => {
+    (0, bun_test_1.it)('OutreachJobSchema carries createdByName, nullable', () => {
+        (0, bun_test_1.expect)(outreach_schemas_1.OutreachJobSchema.parse({
+            title: 'Need 1 x bricklayer',
+            trade: 'Bricklayer',
+            payText: null,
+            locationText: 'SW1A 1AA',
+            createdByName: null,
+        }).createdByName).toBeNull();
+    });
+    (0, bun_test_1.it)('JobFeedMatchCountSchema still parses a 1.4.0-shaped payload', () => {
+        // The whole point of `.optional()`: an API that has not deployed the new
+        // CTE yet, and a 1.4.0 consumer, both keep working.
+        const parsed = jobs_tab_contract_1.JobFeedMatchCountSchema.parse({
+            owned: 3,
+            curated: 4,
+            workersContactedByViewerCount: 1,
+            workersContactedByOthersCount: 2,
+            pendingEnrichmentCount: 0,
+        });
+        (0, bun_test_1.expect)(parsed.outreachRequest).toBeUndefined();
+    });
+    (0, bun_test_1.it)('JobFeedMatchCountSchema carries an outreach request when there is one', () => {
+        const parsed = jobs_tab_contract_1.JobFeedMatchCountSchema.parse({
+            owned: 3,
+            curated: 4,
+            workersContactedByViewerCount: 1,
+            workersContactedByOthersCount: 2,
+            pendingEnrichmentCount: 0,
+            outreachRequest: {
+                id: '22222222-2222-4222-8222-222222222222',
+                status: 'RUNNING',
+                requestedByUserId: '33333333-3333-4333-8333-333333333333',
+                requestedByName: 'Priya Shah',
+                contactedCount: 142,
+                assignedPod: {
+                    id: '44444444-4444-4444-8444-444444444444',
+                    slug: 'north-pod',
+                    displayName: 'North Pod',
+                    ownerUserId: '55555555-5555-4555-8555-555555555555',
+                    ownerName: 'Relay Owner',
+                    publicBaseUrl: 'https://north.example.test',
+                    status: 'ACTIVE',
+                },
+            },
+        });
+        (0, bun_test_1.expect)(parsed.outreachRequest?.contactedCount).toBe(142);
+        (0, bun_test_1.expect)(parsed.outreachRequest?.id).toBe('22222222-2222-4222-8222-222222222222');
+        (0, bun_test_1.expect)(parsed.outreachRequest?.requestedByUserId).toBe('33333333-3333-4333-8333-333333333333');
+    });
+    (0, bun_test_1.it)('rejects an open request without an id', () => {
+        // The id is REQUIRED inside the object (the object itself stays nullable
+        // and optional). It is the only route a browser has to the request id:
+        // cancel is agent-lane while the queue list route is service-key only, so
+        // omitting it would leave the cancel route unreachable.
+        (0, bun_test_1.expect)(() => jobs_tab_contract_1.JobFeedMatchCountSchema.parse({
+            owned: 0,
+            curated: 0,
+            workersContactedByViewerCount: 0,
+            workersContactedByOthersCount: 0,
+            pendingEnrichmentCount: 0,
+            outreachRequest: {
+                status: 'PENDING',
+                requestedByName: null,
+                contactedCount: 0,
+            },
+        })).toThrow();
+    });
+    (0, bun_test_1.it)('null means "no open request", distinct from "not computed"', () => {
+        (0, bun_test_1.expect)(jobs_tab_contract_1.JobFeedMatchCountSchema.parse({
+            owned: 0,
+            curated: 0,
+            workersContactedByViewerCount: 0,
+            workersContactedByOthersCount: 0,
+            pendingEnrichmentCount: 0,
+            outreachRequest: null,
+        }).outreachRequest).toBeNull();
+    });
+    (0, bun_test_1.it)('the candidates query takes outreachEligible as a coerced boolean', () => {
+        const query = jobs_tab_contract_1.jobsTabContract.candidates.query;
+        (0, bun_test_1.expect)(query.parse({ outreachEligible: 'true' }).outreachEligible).toBe(true);
+        (0, bun_test_1.expect)(query.parse({}).outreachEligible).toBeUndefined();
+    });
+});

package/dist/outreach/__tests__/outreach-requests.contract.spec.d.ts

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

package/dist/outreach/__tests__/outreach-requests.contract.spec.d.ts.map

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

package/dist/outreach/__tests__/outreach-requests.contract.spec.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const outreach_requests_contract_1 = require("../outreach-requests.contract");
+(0, bun_test_1.describe)('outreachRequestsContract', () => {
+    (0, bun_test_1.it)('enumerates exactly the four request states', () => {
+        (0, bun_test_1.expect)(outreach_requests_contract_1.OutreachRequestStatusSchema.options).toEqual([
+            'PENDING',
+            'RUNNING',
+            'COMPLETED',
+            'CANCELLED',
+        ]);
+    });
+    (0, bun_test_1.it)('parses a request row', () => {
+        const parsed = outreach_requests_contract_1.OutreachRequestSchema.parse({
+            id: '11111111-1111-4111-8111-111111111111',
+            jobId: '22222222-2222-4222-8222-222222222222',
+            requestedByUserId: '33333333-3333-4333-8333-333333333333',
+            status: 'PENDING',
+            eligibleAtRequest: 214,
+            requestedByName: 'Priya Shah',
+            contactedCount: 0,
+            createdAt: '2026-07-29T09:00:00.000Z',
+            startedAt: null,
+            completedAt: null,
+            assignedPod: null,
+        });
+        (0, bun_test_1.expect)(parsed.status).toBe('PENDING');
+        (0, bun_test_1.expect)(parsed.requestedByUserId).toBe('33333333-3333-4333-8333-333333333333');
+    });
+    (0, bun_test_1.it)('carries job facts on a queue item so the rack can label a campaign', () => {
+        const item = outreach_requests_contract_1.OutreachRequestQueueItemSchema.parse({
+            id: '11111111-1111-4111-8111-111111111111',
+            jobId: '22222222-2222-4222-8222-222222222222',
+            requestedByUserId: '33333333-3333-4333-8333-333333333333',
+            status: 'RUNNING',
+            eligibleAtRequest: 12,
+            requestedByName: null,
+            contactedCount: 3,
+            createdAt: '2026-07-29T09:00:00.000Z',
+            startedAt: '2026-07-29T09:05:00.000Z',
+            completedAt: null,
+            assignedPod: {
+                id: '33333333-3333-4333-8333-333333333333',
+                slug: 'pod-01',
+                displayName: 'Pod 01',
+                ownerUserId: '44444444-4444-4444-8444-444444444444',
+                ownerName: 'Relay Owner',
+                publicBaseUrl: 'https://pod.test',
+                status: 'ACTIVE',
+            },
+            job: {
+                title: 'Need 1 x bricklayer',
+                trade: 'Bricklayer',
+                payText: '£20 per hour',
+                locationText: 'SW1A 1AA',
+                createdByName: 'Sam Okoro',
+            },
+        });
+        // `trade` is the label Relay Lab shows: `title` is j.description, the raw
+        // ad text. `locationText` is the job postcode, carried since 1.4.0.
+        (0, bun_test_1.expect)(item.job.trade).toBe('Bricklayer');
+        (0, bun_test_1.expect)(item.job.locationText).toBe('SW1A 1AA');
+    });
+    (0, bun_test_1.it)('routes both lanes under /v2', () => {
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.create.path).toBe('/v2/outreach/requests');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.list.path).toBe('/v2/outreach/requests');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.list.method).toBe('GET');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.cancel.path).toBe('/v2/outreach/requests/:id/cancel');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.start.path).toBe('/v2/outreach/requests/:id/start');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.complete.path).toBe('/v2/outreach/requests/:id/complete');
+    });
+    (0, bun_test_1.it)('declares 200 on create, because a second click returns the open request', () => {
+        (0, bun_test_1.expect)(Object.keys(outreach_requests_contract_1.outreachRequestsContract.create.responses)).toContain('200');
+        (0, bun_test_1.expect)(Object.keys(outreach_requests_contract_1.outreachRequestsContract.create.responses)).not.toContain('409');
+    });
+});

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

@@ -8,7 +8,9 @@ const index_1 = require("../../index");
 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/jobs/:jobId/claim-next');
+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.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');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.confirmSent.path, '/v2/outreach/leases/:leaseId/sent');
 node_assert_1.default.equal(outreach_contract_1.outreachContract.release.method, 'POST');
@@ -17,12 +19,16 @@ node_assert_1.default.equal(outreach_contract_1.outreachContract.release.path, '
 // 410 is not used anywhere: a late confirm succeeds. `commonResponses` are
 // merged into every route's `responses` by c.router, so 400, 401, 403 and 500
 // appear here.
-const declared = (route) => Object.keys(route.responses).map(Number).sort((a, b) => a - b);
+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.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.claimNextLegacy,
     outreach_contract_1.outreachContract.confirmSent,
     outreach_contract_1.outreachContract.release,
 ]) {
@@ -30,9 +36,13 @@ for (const route of [
 }
 // Path params are validated as uuids.
 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.claimNext.pathParams.safeParse({ requestId: 'nope' })
+    .success);
+node_assert_1.default.ok(outreach_contract_1.outreachContract.claimNextLegacy.pathParams.safeParse({
     jobId: '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
 }).success);
-node_assert_1.default.ok(!outreach_contract_1.outreachContract.claimNext.pathParams.safeParse({ jobId: 'nope' }).success);
 node_assert_1.default.ok(outreach_contract_1.outreachContract.confirmSent.pathParams.safeParse({
     leaseId: '3f2504e0-4f89-41d3-9a0c-0305e82c3301',
 }).success);
@@ -46,6 +56,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.claimNextLegacy,
     outreach_contract_1.outreachContract.confirmSent,
     outreach_contract_1.outreachContract.release,
 ]) {

package/dist/outreach/__tests__/outreach.schemas.test.js

@@ -121,14 +121,17 @@ const job = outreach_schemas_1.OutreachJobSchema.safeParse({
     trade: 'CARPENTER',
     payText: '£180/day',
     locationText: 'Croydon, CR0',
+    createdByName: 'Sam Okoro',
 });
 node_assert_1.default.ok(job.success);
-// Real jobs routinely lack pay or trade text; those fields are nullable.
+// Real jobs routinely lack pay, trade text, or a raising agent; those fields
+// are nullable.
 const sparseJob = outreach_schemas_1.OutreachJobSchema.safeParse({
     title: 'Carpenter needed',
     trade: null,
     payText: null,
     locationText: null,
+    createdByName: null,
 });
 node_assert_1.default.ok(sparseJob.success);
 // title is not.
@@ -136,5 +139,6 @@ node_assert_1.default.ok(!outreach_schemas_1.OutreachJobSchema.safeParse({
     trade: null,
     payText: null,
     locationText: null,
+    createdByName: null,
 }).success);
 console.log('outreach.schemas OK');