@dakkitor/api-contracts 1.4.0 → 1.6.0

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

@@ -1 +1 @@
-{"version":3,"file":"outreach.contract.d.ts","sourceRoot":"","sources":["../../contracts/outreach/outreach.contract.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAW,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAIM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYM,CAAC;AAEnD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;EAoBM,CAAC;AAEjD,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;EAOM,CAAC;AAErD,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAUM,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAEF,eAAO,MAAM,kCAAkC;;;;;;EAIM,CAAC;AAEtD,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsE5B,CAAC"}
+{"version":3,"file":"outreach.contract.d.ts","sourceRoot":"","sources":["../../contracts/outreach/outreach.contract.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAW,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAIM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYM,CAAC;AAEnD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;EAoBM,CAAC;AAEjD,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;EAOM,CAAC;AAErD,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAUM,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAEF,eAAO,MAAM,kCAAkC;;;;;;EAIM,CAAC;AAEtD,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyF5B,CAAC"}

package/dist/outreach/outreach.contract.js

@@ -130,6 +130,24 @@ exports.ReleaseOutreachLeaseResponseSchema = zod_1.z
     .openapi({ title: 'ReleaseOutreachLeaseResponse' });
 exports.outreachContract = c.router({
     claimNext: {
+        method: 'POST',
+        path: '/outreach/requests/:requestId/claim-next',
+        pathParams: zod_1.z.object({
+            requestId: zod_1.z
+                .string()
+                .uuid()
+                .describe('Authorized request to claim a candidate for'),
+        }),
+        body: exports.ClaimNextOutreachBodySchema,
+        responses: {
+            200: exports.ClaimNextOutreachResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Claim the next eligible candidate for an outreach request',
+        description: 'Derives the job from the pod-owned request. Idempotent per device: a device that already holds an active lease gets that lease back.',
+        metadata: { tags: ['Outreach'] },
+    },
+    claimNextLegacy: {
         method: 'POST',
         path: '/outreach/jobs/:jobId/claim-next',
         pathParams: zod_1.z.object({

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

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

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

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

package/dist/outreach/outreach.contract.spec.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const outreach_requests_contract_1 = require("./outreach-requests.contract");
+const outreach_contract_1 = require("./outreach.contract");
+(0, bun_test_1.describe)('pod-routed outreach contracts', () => {
+    (0, bun_test_1.it)('uses a request-based primary claim route and retains the legacy route', () => {
+        (0, bun_test_1.expect)(outreach_contract_1.outreachContract.claimNext.path).toBe('/v2/outreach/requests/:requestId/claim-next');
+        (0, bun_test_1.expect)(outreach_contract_1.outreachContract.claimNextLegacy.path).toBe('/v2/outreach/jobs/:jobId/claim-next');
+    });
+    (0, bun_test_1.it)('publishes pending-request reassignment', () => {
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.reassign.path).toBe('/v2/outreach/requests/:id/reassign');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.reassign.method).toBe('POST');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.reassign.body.parse({
+            targetPodId: '22222222-2222-4222-8222-222222222222',
+        }).targetPodId).toBe('22222222-2222-4222-8222-222222222222');
+    });
+    (0, bun_test_1.it)('does not advertise completing a pending request', () => {
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.complete.description).toContain('RUNNING -> COMPLETED');
+        (0, bun_test_1.expect)(outreach_requests_contract_1.outreachRequestsContract.complete.description).not.toContain('PENDING or RUNNING');
+    });
+    bun_test_1.it.each([
+        ['cancel', outreach_requests_contract_1.outreachRequestsContract.cancel],
+        ['reassign', outreach_requests_contract_1.outreachRequestsContract.reassign],
+    ])('%s rejects non-PENDING requests with a conflict response', (_operation, route) => {
+        (0, bun_test_1.expect)(route.responses).toHaveProperty('409');
+        (0, bun_test_1.expect)(route.responses).toHaveProperty('404');
+        (0, bun_test_1.expect)(route.description).toContain('Rejects non-PENDING requests');
+    });
+    (0, bun_test_1.it)('keeps an explicit target optional for ordinary request creation', () => {
+        const jobId = '11111111-1111-4111-8111-111111111111';
+        (0, bun_test_1.expect)(outreach_requests_contract_1.CreateOutreachRequestBodySchema.parse({ jobId }).targetPodId).toBeUndefined();
+        (0, bun_test_1.expect)(outreach_requests_contract_1.CreateOutreachRequestBodySchema.parse({
+            jobId,
+            targetPodId: '22222222-2222-4222-8222-222222222222',
+        }).targetPodId).toBe('22222222-2222-4222-8222-222222222222');
+    });
+    (0, bun_test_1.it)('represents migration-era requests without an assigned pod', () => {
+        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: 12,
+            requestedByName: 'Relay Owner',
+            contactedCount: 0,
+            createdAt: '2026-08-01T09:00:00.000Z',
+            startedAt: null,
+            completedAt: null,
+            assignedPod: null,
+        });
+        (0, bun_test_1.expect)(parsed.assignedPod).toBeNull();
+    });
+});

package/dist/outreach/outreach.schemas.d.ts

@@ -52,11 +52,11 @@ export declare const OutreachLeaseSchema: z.ZodObject<{
     leaseId: z.ZodString;
     expiresAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    leaseId: string;
     expiresAt: string;
-}, {
     leaseId: string;
+}, {
     expiresAt: string;
+    leaseId: string;
 }>;
 export type OutreachLease = z.infer<typeof OutreachLeaseSchema>;
 export declare const OutreachCandidateSchema: z.ZodObject<{
@@ -69,41 +69,46 @@ export declare const OutreachCandidateSchema: z.ZodObject<{
     commuteMinutes: z.ZodNumber;
     transportMode: z.ZodEnum<["DRIVE", "PUBLIC_TRANSPORT"]>;
 }, "strip", z.ZodTypeAny, {
+    phoneNumber: string;
+    name: string;
     subjectKind: "OWNED" | "CURATED";
     subjectId: string;
     canonicalKind: "WORKER" | "CURATED_WORKER";
     canonicalId: string;
-    name: string;
-    phoneNumber: string;
     commuteMinutes: number;
-    transportMode: "DRIVE" | "PUBLIC_TRANSPORT";
+    transportMode: "PUBLIC_TRANSPORT" | "DRIVE";
 }, {
+    phoneNumber: string;
+    name: string;
     subjectKind: "OWNED" | "CURATED";
     subjectId: string;
     canonicalKind: "WORKER" | "CURATED_WORKER";
     canonicalId: string;
-    name: string;
-    phoneNumber: string;
     commuteMinutes: number;
-    transportMode: "DRIVE" | "PUBLIC_TRANSPORT";
+    transportMode: "PUBLIC_TRANSPORT" | "DRIVE";
 }>;
 export type OutreachCandidate = z.infer<typeof OutreachCandidateSchema>;
 /**
  * Enough of the job to compose a message. Everything but the title is nullable
- * because real jobs routinely lack pay or trade text, and a missing field must
- * not make a candidate unclaimable.
+ * because real jobs routinely lack pay, trade text, or a raising agent, and a
+ * missing field must not make a candidate unclaimable — createdByName is
+ * nullable for the same reason: a job with no createdById must not make a
+ * candidate unclaimable.
  */
 export declare const OutreachJobSchema: 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>;
 }, "strip", z.ZodTypeAny, {
+    createdByName: string | null;
     title: string;
     trade: string | null;
     payText: string | null;
     locationText: string | null;
 }, {
+    createdByName: string | null;
     title: string;
     trade: string | null;
     payText: string | null;

package/dist/outreach/outreach.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outreach.schemas.d.ts","sourceRoot":"","sources":["../../contracts/outreach/outreach.schemas.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,iCAEM,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,yCAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,0CAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,aAIkC,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,mFAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;;;;;;;;;EAQM,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCM,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAOM,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"outreach.schemas.d.ts","sourceRoot":"","sources":["../../contracts/outreach/outreach.schemas.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,iCAEM,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,yCAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,0CAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,aAIkC,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,mFAEM,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;;;;;;;;;EAQM,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCM,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAQM,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/outreach/outreach.schemas.js

@@ -119,8 +119,10 @@ exports.OutreachCandidateSchema = zod_1.z
     .openapi({ title: 'OutreachCandidate' });
 /**
  * Enough of the job to compose a message. Everything but the title is nullable
- * because real jobs routinely lack pay or trade text, and a missing field must
- * not make a candidate unclaimable.
+ * because real jobs routinely lack pay, trade text, or a raising agent, and a
+ * missing field must not make a candidate unclaimable — createdByName is
+ * nullable for the same reason: a job with no createdById must not make a
+ * candidate unclaimable.
  */
 exports.OutreachJobSchema = zod_1.z
     .object({
@@ -128,5 +130,6 @@ exports.OutreachJobSchema = zod_1.z
     trade: zod_1.z.string().nullable().describe('Trade label, if known'),
     payText: zod_1.z.string().nullable().describe('Pay as displayed, if known'),
     locationText: zod_1.z.string().nullable().describe('Location as displayed'),
+    createdByName: zod_1.z.string().nullable().describe('Agent who raised the job'),
 })
     .openapi({ title: 'OutreachJob' });