@dakkitor/api-contracts 1.7.0 → 1.8.0

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

@@ -0,0 +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"}

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

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relayHubOutreachContract = void 0;
+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 c = (0, core_1.initContract)();
+const RelayHubOutreachPathParamsSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+})
+    .strict();
+const RelayHubOutreachProgressMutationSchema = relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema.extend({
+    progress: zod_1.z.number().min(0).max(1).optional(),
+}).strict();
+const RelayHubOutreachFailureMutationSchema = relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema.extend({
+    reason: zod_1.z.string().min(1),
+}).strict();
+exports.relayHubOutreachContract = c.router({
+    list: {
+        method: 'GET',
+        path: '',
+        responses: {
+            200: zod_1.z.array(relay_hub_schemas_1.RelayHubOutreachQueueItemSchema),
+        },
+        summary: 'List Relay Hub outreach work assigned to a pod',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+    claim: {
+        method: 'POST',
+        path: '/:id/claim',
+        pathParams: RelayHubOutreachPathParamsSchema,
+        body: relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema,
+        responses: {
+            200: relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Claim immutable Relay Hub outreach work',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+    accept: {
+        method: 'POST',
+        path: '/:id/accept',
+        pathParams: RelayHubOutreachPathParamsSchema,
+        body: relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema,
+        responses: {
+            200: relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Accept immutable Relay Hub outreach work',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+    progress: {
+        method: 'POST',
+        path: '/:id/progress',
+        pathParams: RelayHubOutreachPathParamsSchema,
+        body: RelayHubOutreachProgressMutationSchema,
+        responses: {
+            200: relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Record Relay Hub outreach progress',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+    complete: {
+        method: 'POST',
+        path: '/:id/complete',
+        pathParams: RelayHubOutreachPathParamsSchema,
+        body: relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema,
+        responses: {
+            200: relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Complete immutable Relay Hub outreach work',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+    fail: {
+        method: 'POST',
+        path: '/:id/fail',
+        pathParams: RelayHubOutreachPathParamsSchema,
+        body: RelayHubOutreachFailureMutationSchema,
+        responses: {
+            200: relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+            409: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Fail immutable Relay Hub outreach work',
+        metadata: { tags: ['Relay Hub Outreach'] },
+    },
+}, {
+    pathPrefix: '/v3/relay-hub/outreach',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

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

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

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

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

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

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 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';
+(0, bun_test_1.describe)('Relay Hub outreach schemas', () => {
+    (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,
+            assignedPodId: podId,
+            lifecycle: 'QUEUED',
+            lifecycleVersion: 0,
+            requestedAt: '2026-08-16T10:00:00.000Z',
+        }).assignedPodId).toBe(podId);
+        (0, bun_test_1.expect)(() => relay_hub_schemas_1.RelayHubOutreachQueueItemSchema.parse({
+            id: requestId,
+            assignedPodId: null,
+            lifecycle: 'QUEUED',
+            lifecycleVersion: 0,
+            requestedAt: '2026-08-16T10:00:00.000Z',
+        })).toThrow();
+    });
+    (0, bun_test_1.it)('composes immutable assignment with shared mutation metadata for lifecycle writes', () => {
+        (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema.safeParse({
+            assignedPodId: podId,
+            idempotencyKey,
+            correlationId,
+            expectedVersion: 0,
+        }).success).toBe(true);
+        (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema.safeParse({
+            idempotencyKey,
+            correlationId,
+            expectedVersion: 0,
+        }).success).toBe(false);
+        (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachLifecycleMutationSchema.safeParse({
+            assignedPodId: null,
+            idempotencyKey,
+            correlationId,
+            expectedVersion: 0,
+        }).success).toBe(false);
+    });
+    (0, bun_test_1.it)('requires the committed lifecycle version in lifecycle responses', () => {
+        const response = {
+            id: requestId,
+            assignedPodId: podId,
+            lifecycle: 'CLAIMED',
+            lifecycleVersion: 1,
+            committedAt: '2026-08-16T10:05:00.000Z',
+        };
+        (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema.parse(response).lifecycleVersion).toBe(1);
+        (0, bun_test_1.expect)(relay_hub_schemas_1.RelayHubOutreachLifecycleResponseSchema.safeParse({
+            id: response.id,
+            assignedPodId: response.assignedPodId,
+            lifecycle: response.lifecycle,
+            committedAt: response.committedAt,
+        }).success).toBe(false);
+    });
+});
+(0, bun_test_1.describe)('relayHubOutreachContract routes', () => {
+    for (const [routeName, bodySchema, routeFields] of [
+        ['claim', relay_hub_outreach_contract_1.relayHubOutreachContract.claim.body, {}],
+        ['accept', relay_hub_outreach_contract_1.relayHubOutreachContract.accept.body, {}],
+        ['progress', relay_hub_outreach_contract_1.relayHubOutreachContract.progress.body, { progress: 0.5 }],
+        ['complete', relay_hub_outreach_contract_1.relayHubOutreachContract.complete.body, {}],
+        ['fail', relay_hub_outreach_contract_1.relayHubOutreachContract.fail.body, { reason: 'delivery failed' }],
+    ]) {
+        (0, bun_test_1.it)(`${routeName} requires one non-null assigned pod`, () => {
+            const mutation = {
+                idempotencyKey,
+                correlationId,
+                expectedVersion: 0,
+                ...routeFields,
+            };
+            (0, bun_test_1.expect)(bodySchema.safeParse(mutation).success).toBe(false);
+            (0, bun_test_1.expect)(bodySchema.safeParse({ ...mutation, assignedPodId: null }).success).toBe(false);
+            (0, bun_test_1.expect)(bodySchema.safeParse({ ...mutation, assignedPodId: podId }).success).toBe(true);
+        });
+    }
+    (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',
+            'claim',
+            'accept',
+            'progress',
+            'complete',
+            'fail',
+        ]);
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.list).toMatchObject({
+            method: 'GET',
+            path: '/v3/relay-hub/outreach',
+        });
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.claim).toMatchObject({
+            method: 'POST',
+            path: '/v3/relay-hub/outreach/:id/claim',
+        });
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.accept).toMatchObject({
+            method: 'POST',
+            path: '/v3/relay-hub/outreach/:id/accept',
+        });
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.progress).toMatchObject({
+            method: 'POST',
+            path: '/v3/relay-hub/outreach/:id/progress',
+        });
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.complete).toMatchObject({
+            method: 'POST',
+            path: '/v3/relay-hub/outreach/:id/complete',
+        });
+        (0, bun_test_1.expect)(relay_hub_outreach_contract_1.relayHubOutreachContract.fail).toMatchObject({
+            method: 'POST',
+            path: '/v3/relay-hub/outreach/:id/fail',
+        });
+        (0, bun_test_1.expect)(index_1.apiContractRouter.RelayHubOutreach.claim.path).toBe('/v3/relay-hub/outreach/:id/claim');
+    });
+});