@dakkitor/api-contracts 1.6.0 → 1.7.1

package/dist/relay-pods/relay-lab-fleet.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-lab-fleet.contract.d.ts","sourceRoot":"","sources":["../../contracts/relay-pods/relay-lab-fleet.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,cAAc,2BAA2B,CAAC;AAU1C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDjC,CAAC"}

package/dist/relay-pods/relay-lab-fleet.contract.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relayLabFleetContract = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const error_schemas_1 = require("../common/error-schemas");
+const relay_lab_fleet_schemas_1 = require("./relay-lab-fleet.schemas");
+__exportStar(require("./relay-lab-fleet.schemas"), exports);
+const c = (0, core_1.initContract)();
+const enrollmentPathParams = zod_1.z
+    .object({
+    localDeviceKey: zod_1.z.string().min(1),
+})
+    .strict();
+exports.relayLabFleetContract = c.router({
+    publishSnapshot: {
+        method: 'PUT',
+        path: '/relay-pods/me/lab-devices/snapshot',
+        body: relay_lab_fleet_schemas_1.PublishRelayLabSnapshotBodySchema,
+        responses: {
+            200: relay_lab_fleet_schemas_1.PublishRelayLabSnapshotResponseSchema,
+        },
+        summary: 'Publish a Relay pod Lab-device snapshot',
+        metadata: { tags: ['Relay Lab Fleet'] },
+    },
+    readFleet: {
+        method: 'GET',
+        path: '/relay-pods/lab-fleet',
+        responses: {
+            200: relay_lab_fleet_schemas_1.RelayLabFleetSnapshotSchema,
+        },
+        summary: 'Read the current multi-pod Relay Lab fleet',
+        metadata: { tags: ['Relay Lab Fleet'] },
+    },
+    reportReadiness: {
+        method: 'PUT',
+        path: '/relay-pods/me/lab-readiness',
+        body: relay_lab_fleet_schemas_1.ReportRelayLabReadinessBodySchema,
+        responses: {
+            200: relay_lab_fleet_schemas_1.RelayLabReadinessSchema,
+        },
+        summary: 'Report pod-local Relay Lab readiness',
+        metadata: { tags: ['Relay Lab Fleet'] },
+    },
+    updateEnrollment: {
+        method: 'PATCH',
+        path: '/relay-pods/me/lab-devices/:localDeviceKey/enrollment',
+        pathParams: enrollmentPathParams,
+        body: relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema,
+        responses: {
+            200: relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentResponseSchema,
+            404: error_schemas_1.ErrorResponseSchema,
+        },
+        summary: 'Update a local Relay Lab device enrollment state',
+        metadata: { tags: ['Relay Lab Fleet'] },
+    },
+}, {
+    pathPrefix: '/v2',
+    commonResponses: {
+        400: error_schemas_1.ErrorResponseSchema,
+        401: error_schemas_1.ErrorResponseSchema,
+        403: error_schemas_1.ErrorResponseSchema,
+        500: error_schemas_1.ErrorResponseSchema,
+    },
+});

package/dist/relay-pods/relay-lab-fleet.contract.spec.d.ts

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

package/dist/relay-pods/relay-lab-fleet.contract.spec.d.ts.map

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

package/dist/relay-pods/relay-lab-fleet.contract.spec.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const relay_lab_fleet_schemas_1 = require("./relay-lab-fleet.schemas");
+const relay_lab_fleet_contract_1 = require("./relay-lab-fleet.contract");
+const index_1 = require("../index");
+const podId = '11111111-1111-4111-8111-111111111111';
+const labDeviceId = '22222222-2222-4222-8222-222222222222';
+const now = '2026-08-02T09:00:00.000Z';
+const device = {
+    id: labDeviceId,
+    podId,
+    podSlug: 'pod-01',
+    podDisplayName: 'Pod 01',
+    localDeviceKey: 'phone-01',
+    label: 'Primary phone',
+    phoneE164: '+447700900123',
+    identityVersion: 1,
+    lifecycleStatus: 'ACTIVE',
+    enrollmentStatus: 'ENROLLED',
+    connectionStatus: 'ONLINE',
+    restrictionStatus: 'NONE',
+    identityStatus: 'VALID',
+    lastSeenAt: now,
+};
+(0, bun_test_1.describe)('relay Lab fleet schemas', () => {
+    (0, bun_test_1.it)('keeps the canonical fleet device strict', () => {
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.RelayLabDeviceSchema.parse(device)).toMatchObject({
+            id: labDeviceId,
+            podId,
+            phoneE164: '+447700900123',
+        });
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.RelayLabDeviceSchema.safeParse({ ...device, workerId: podId }).success).toBe(false);
+    });
+    (0, bun_test_1.it)('accepts pod-local snapshot rows without caller-supplied pod scope', () => {
+        const body = {
+            generation: 7,
+            observedAt: now,
+            devices: [
+                {
+                    localDeviceKey: 'phone-01',
+                    label: 'Primary phone',
+                    phoneE164: '+447700900123',
+                    lifecycleStatus: 'ACTIVE',
+                    connectionStatus: 'ONLINE',
+                    restrictionStatus: 'NONE',
+                    lastSeenAt: now,
+                },
+            ],
+        };
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.PublishRelayLabSnapshotBodySchema.parse(body)).toEqual(body);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.PublishRelayLabSnapshotBodySchema.safeParse({ ...body, podId }).success).toBe(false);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.PublishRelayLabSnapshotBodySchema.safeParse({
+            ...body,
+            devices: [{ ...body.devices[0], enrollmentStatus: 'ENROLLED' }],
+        }).success).toBe(false);
+    });
+    (0, bun_test_1.it)('accepts only server-scoped readiness facts', () => {
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.ReportRelayLabReadinessBodySchema.safeParse({
+            revision: 43,
+            requiredPairCount: 2,
+            savedPairCount: 2,
+            failedPairCount: 0,
+            missingPairs: [],
+        }).success).toBe(true);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.ReportRelayLabReadinessBodySchema.safeParse({
+            podId,
+            revision: 43,
+            requiredPairCount: 2,
+            savedPairCount: 2,
+            failedPairCount: 0,
+            missingPairs: [],
+        }).success).toBe(false);
+    });
+    (0, bun_test_1.it)('accepts only the exported contact-reconciliation readiness error codes', () => {
+        const readiness = {
+            revision: 43,
+            requiredPairCount: 1,
+            savedPairCount: 0,
+            failedPairCount: 1,
+            missingPairs: [
+                {
+                    ownerLocalDeviceKey: 'phone-01',
+                    contactLabDeviceId: labDeviceId,
+                    errorCode: 'CONTACT_WRITE_FAILED',
+                },
+            ],
+        };
+        for (const errorCode of relay_lab_fleet_schemas_1.RELAY_LAB_READINESS_ERROR_CODES) {
+            (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.ReportRelayLabReadinessBodySchema.safeParse({
+                ...readiness,
+                missingPairs: [{ ...readiness.missingPairs[0], errorCode }],
+            }).success).toBe(true);
+        }
+        for (const errorCode of [
+            'failed for +447700900123',
+            'contact_write_failed',
+            `X_${'A'.repeat(64)}`,
+            'PHONE_447700900123',
+            'CONTACT_447700900123',
+        ]) {
+            (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.ReportRelayLabReadinessBodySchema.safeParse({
+                ...readiness,
+                missingPairs: [{ ...readiness.missingPairs[0], errorCode }],
+            }).success).toBe(false);
+        }
+    });
+    (0, bun_test_1.it)('emits compact SSE payloads without phone numbers', () => {
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.LabFleetSsePayloadSchema.parse({
+            revision: 43,
+            changeType: 'IDENTITY_CHANGED',
+            sourcePodId: podId,
+            affectedDeviceIds: [labDeviceId],
+        })).not.toHaveProperty('phoneNumber');
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.LabFleetSsePayloadSchema.safeParse({
+            revision: 43,
+            changeType: 'IDENTITY_CHANGED',
+            sourcePodId: podId,
+            affectedDeviceIds: [labDeviceId],
+            phoneNumber: '+447700900123',
+        }).success).toBe(false);
+    });
+    (0, bun_test_1.it)('accepts only enroll and revoke as human enrollment commands', () => {
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema.safeParse({
+            enrollmentStatus: 'ENROLLED',
+            expectedIdentity: {
+                identityVersion: 3,
+                label: 'Alice Lab',
+                phoneE164: '+447700900123',
+            },
+        }).success).toBe(true);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema.safeParse({
+            enrollmentStatus: 'ENROLLED',
+        }).success).toBe(false);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema.safeParse({
+            enrollmentStatus: 'REVOKED',
+        }).success).toBe(true);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema.safeParse({
+            enrollmentStatus: 'UNENROLLED',
+        }).success).toBe(false);
+        (0, bun_test_1.expect)(relay_lab_fleet_schemas_1.UpdateRelayLabEnrollmentBodySchema.safeParse({
+            enrollmentStatus: 'REVOKED',
+            expectedIdentity: {
+                identityVersion: 3,
+                label: 'Alice Lab',
+                phoneE164: '+447700900123',
+            },
+        }).success).toBe(false);
+    });
+});
+(0, bun_test_1.describe)('relayLabFleetContract routes', () => {
+    (0, bun_test_1.it)('publishes the pod and fleet lifecycle endpoints under /v2', () => {
+        (0, bun_test_1.expect)(relay_lab_fleet_contract_1.relayLabFleetContract.publishSnapshot.path).toBe('/v2/relay-pods/me/lab-devices/snapshot');
+        (0, bun_test_1.expect)(relay_lab_fleet_contract_1.relayLabFleetContract.readFleet.path).toBe('/v2/relay-pods/lab-fleet');
+        (0, bun_test_1.expect)(relay_lab_fleet_contract_1.relayLabFleetContract.reportReadiness.path).toBe('/v2/relay-pods/me/lab-readiness');
+        (0, bun_test_1.expect)(relay_lab_fleet_contract_1.relayLabFleetContract.updateEnrollment).toMatchObject({
+            method: 'PATCH',
+            path: '/v2/relay-pods/me/lab-devices/:localDeviceKey/enrollment',
+        });
+        (0, bun_test_1.expect)(index_1.apiContractRouter.RelayLabFleet.readFleet.path).toBe('/v2/relay-pods/lab-fleet');
+    });
+});