@dakkitor/api-contracts 1.5.0 → 1.7.0

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,146 @@
+"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',
+        }).success).toBe(true);
+        (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.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');
+    });
+});

package/dist/relay-pods/relay-lab-fleet.schemas.d.ts

@@ -0,0 +1,443 @@
+import { z } from 'zod';
+export declare const RelayLabLifecycleSchema: z.ZodEnum<["ACTIVE", "RETIRED"]>;
+export declare const RelayLabEnrollmentSchema: z.ZodEnum<["UNENROLLED", "ENROLLED", "REVOKED"]>;
+export declare const RelayLabIdentityStatusSchema: z.ZodEnum<["INCOMPLETE", "VALID", "CONFLICT"]>;
+/**
+ * Closed v1 vocabulary emitted by Relay contact reconciliation. Keep this
+ * list free of device identifiers, phone numbers, and raw error text.
+ */
+export declare const RELAY_LAB_READINESS_ERROR_CODES: readonly ["OWNER_OFFLINE", "CONTACT_WRITE_FAILED"];
+export declare const RelayLabReadinessErrorCodeSchema: z.ZodEnum<["OWNER_OFFLINE", "CONTACT_WRITE_FAILED"]>;
+export declare const RelayLabDeviceSchema: z.ZodObject<{
+    id: z.ZodString;
+    podId: z.ZodString;
+    podSlug: z.ZodString;
+    podDisplayName: z.ZodString;
+    localDeviceKey: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    phoneE164: z.ZodNullable<z.ZodString>;
+    identityVersion: z.ZodNumber;
+    lifecycleStatus: z.ZodEnum<["ACTIVE", "RETIRED"]>;
+    enrollmentStatus: z.ZodEnum<["UNENROLLED", "ENROLLED", "REVOKED"]>;
+    connectionStatus: z.ZodEnum<["ONLINE", "OFFLINE"]>;
+    restrictionStatus: z.ZodEnum<["NONE", "RECOVERING", "RESTRICTED"]>;
+    identityStatus: z.ZodEnum<["INCOMPLETE", "VALID", "CONFLICT"]>;
+    lastSeenAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    podId: string;
+    podSlug: string;
+    podDisplayName: string;
+    localDeviceKey: string;
+    label: string | null;
+    phoneE164: string | null;
+    identityVersion: number;
+    lifecycleStatus: "ACTIVE" | "RETIRED";
+    enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+    connectionStatus: "ONLINE" | "OFFLINE";
+    restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+    identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+    lastSeenAt: string;
+}, {
+    id: string;
+    podId: string;
+    podSlug: string;
+    podDisplayName: string;
+    localDeviceKey: string;
+    label: string | null;
+    phoneE164: string | null;
+    identityVersion: number;
+    lifecycleStatus: "ACTIVE" | "RETIRED";
+    enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+    connectionStatus: "ONLINE" | "OFFLINE";
+    restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+    identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+    lastSeenAt: string;
+}>;
+export declare const RelayLabReadinessSchema: z.ZodObject<{
+    podId: z.ZodString;
+    podDisplayName: z.ZodString;
+    revision: z.ZodNumber;
+    requiredPairCount: z.ZodNumber;
+    savedPairCount: z.ZodNumber;
+    failedPairCount: z.ZodNumber;
+    missingPairs: z.ZodArray<z.ZodObject<{
+        ownerLocalDeviceKey: z.ZodString;
+        contactLabDeviceId: z.ZodString;
+        errorCode: z.ZodEnum<["OWNER_OFFLINE", "CONTACT_WRITE_FAILED"]>;
+    }, "strict", z.ZodTypeAny, {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }, {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }>, "many">;
+    reportedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    ready: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    podId: string;
+    podDisplayName: string;
+    revision: number;
+    requiredPairCount: number;
+    savedPairCount: number;
+    failedPairCount: number;
+    missingPairs: {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }[];
+    reportedAt: string;
+    expiresAt: string;
+    ready: boolean;
+}, {
+    podId: string;
+    podDisplayName: string;
+    revision: number;
+    requiredPairCount: number;
+    savedPairCount: number;
+    failedPairCount: number;
+    missingPairs: {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }[];
+    reportedAt: string;
+    expiresAt: string;
+    ready: boolean;
+}>;
+export declare const RelayLabFleetSnapshotSchema: z.ZodObject<{
+    revision: z.ZodNumber;
+    devices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        podId: z.ZodString;
+        podSlug: z.ZodString;
+        podDisplayName: z.ZodString;
+        localDeviceKey: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        phoneE164: z.ZodNullable<z.ZodString>;
+        identityVersion: z.ZodNumber;
+        lifecycleStatus: z.ZodEnum<["ACTIVE", "RETIRED"]>;
+        enrollmentStatus: z.ZodEnum<["UNENROLLED", "ENROLLED", "REVOKED"]>;
+        connectionStatus: z.ZodEnum<["ONLINE", "OFFLINE"]>;
+        restrictionStatus: z.ZodEnum<["NONE", "RECOVERING", "RESTRICTED"]>;
+        identityStatus: z.ZodEnum<["INCOMPLETE", "VALID", "CONFLICT"]>;
+        lastSeenAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        podId: string;
+        podSlug: string;
+        podDisplayName: string;
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        identityVersion: number;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+        lastSeenAt: string;
+    }, {
+        id: string;
+        podId: string;
+        podSlug: string;
+        podDisplayName: string;
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        identityVersion: number;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+        lastSeenAt: string;
+    }>, "many">;
+    readiness: z.ZodArray<z.ZodObject<{
+        podId: z.ZodString;
+        podDisplayName: z.ZodString;
+        revision: z.ZodNumber;
+        requiredPairCount: z.ZodNumber;
+        savedPairCount: z.ZodNumber;
+        failedPairCount: z.ZodNumber;
+        missingPairs: z.ZodArray<z.ZodObject<{
+            ownerLocalDeviceKey: z.ZodString;
+            contactLabDeviceId: z.ZodString;
+            errorCode: z.ZodEnum<["OWNER_OFFLINE", "CONTACT_WRITE_FAILED"]>;
+        }, "strict", z.ZodTypeAny, {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }, {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }>, "many">;
+        reportedAt: z.ZodString;
+        expiresAt: z.ZodString;
+        ready: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        podId: string;
+        podDisplayName: string;
+        revision: number;
+        requiredPairCount: number;
+        savedPairCount: number;
+        failedPairCount: number;
+        missingPairs: {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }[];
+        reportedAt: string;
+        expiresAt: string;
+        ready: boolean;
+    }, {
+        podId: string;
+        podDisplayName: string;
+        revision: number;
+        requiredPairCount: number;
+        savedPairCount: number;
+        failedPairCount: number;
+        missingPairs: {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }[];
+        reportedAt: string;
+        expiresAt: string;
+        ready: boolean;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    revision: number;
+    devices: {
+        id: string;
+        podId: string;
+        podSlug: string;
+        podDisplayName: string;
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        identityVersion: number;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+        lastSeenAt: string;
+    }[];
+    readiness: {
+        podId: string;
+        podDisplayName: string;
+        revision: number;
+        requiredPairCount: number;
+        savedPairCount: number;
+        failedPairCount: number;
+        missingPairs: {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }[];
+        reportedAt: string;
+        expiresAt: string;
+        ready: boolean;
+    }[];
+}, {
+    revision: number;
+    devices: {
+        id: string;
+        podId: string;
+        podSlug: string;
+        podDisplayName: string;
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        identityVersion: number;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        identityStatus: "INCOMPLETE" | "VALID" | "CONFLICT";
+        lastSeenAt: string;
+    }[];
+    readiness: {
+        podId: string;
+        podDisplayName: string;
+        revision: number;
+        requiredPairCount: number;
+        savedPairCount: number;
+        failedPairCount: number;
+        missingPairs: {
+            ownerLocalDeviceKey: string;
+            contactLabDeviceId: string;
+            errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+        }[];
+        reportedAt: string;
+        expiresAt: string;
+        ready: boolean;
+    }[];
+}>;
+/**
+ * A pod can publish only its local observations. Recruitment derives pod
+ * ownership and enrollment state from the authenticated machine principal.
+ */
+export declare const PublishRelayLabSnapshotBodySchema: z.ZodObject<{
+    generation: z.ZodNumber;
+    observedAt: z.ZodString;
+    devices: z.ZodArray<z.ZodObject<{
+        localDeviceKey: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        phoneE164: z.ZodNullable<z.ZodString>;
+        lifecycleStatus: z.ZodEnum<["ACTIVE", "RETIRED"]>;
+        connectionStatus: z.ZodEnum<["ONLINE", "OFFLINE"]>;
+        restrictionStatus: z.ZodEnum<["NONE", "RECOVERING", "RESTRICTED"]>;
+        lastSeenAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        lastSeenAt: string;
+    }, {
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        lastSeenAt: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    devices: {
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        lastSeenAt: string;
+    }[];
+    generation: number;
+    observedAt: string;
+}, {
+    devices: {
+        localDeviceKey: string;
+        label: string | null;
+        phoneE164: string | null;
+        lifecycleStatus: "ACTIVE" | "RETIRED";
+        connectionStatus: "ONLINE" | "OFFLINE";
+        restrictionStatus: "NONE" | "RECOVERING" | "RESTRICTED";
+        lastSeenAt: string;
+    }[];
+    generation: number;
+    observedAt: string;
+}>;
+export declare const PublishRelayLabSnapshotResponseSchema: z.ZodObject<{
+    acceptedGeneration: z.ZodNumber;
+    revision: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    revision: number;
+    acceptedGeneration: number;
+}, {
+    revision: number;
+    acceptedGeneration: number;
+}>;
+/** The pod supplies readiness facts; timestamps and readiness are server-owned. */
+export declare const ReportRelayLabReadinessBodySchema: z.ZodObject<Omit<{
+    podId: z.ZodString;
+    podDisplayName: z.ZodString;
+    revision: z.ZodNumber;
+    requiredPairCount: z.ZodNumber;
+    savedPairCount: z.ZodNumber;
+    failedPairCount: z.ZodNumber;
+    missingPairs: z.ZodArray<z.ZodObject<{
+        ownerLocalDeviceKey: z.ZodString;
+        contactLabDeviceId: z.ZodString;
+        errorCode: z.ZodEnum<["OWNER_OFFLINE", "CONTACT_WRITE_FAILED"]>;
+    }, "strict", z.ZodTypeAny, {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }, {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }>, "many">;
+    reportedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    ready: z.ZodBoolean;
+}, "podId" | "podDisplayName" | "reportedAt" | "expiresAt" | "ready">, "strict", z.ZodTypeAny, {
+    revision: number;
+    requiredPairCount: number;
+    savedPairCount: number;
+    failedPairCount: number;
+    missingPairs: {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }[];
+}, {
+    revision: number;
+    requiredPairCount: number;
+    savedPairCount: number;
+    failedPairCount: number;
+    missingPairs: {
+        ownerLocalDeviceKey: string;
+        contactLabDeviceId: string;
+        errorCode: "OWNER_OFFLINE" | "CONTACT_WRITE_FAILED";
+    }[];
+}>;
+export declare const UpdateRelayLabEnrollmentBodySchema: z.ZodObject<{
+    enrollmentStatus: z.ZodEnum<["ENROLLED", "REVOKED"]>;
+}, "strict", z.ZodTypeAny, {
+    enrollmentStatus: "ENROLLED" | "REVOKED";
+}, {
+    enrollmentStatus: "ENROLLED" | "REVOKED";
+}>;
+export declare const UpdateRelayLabEnrollmentResponseSchema: z.ZodObject<{
+    localDeviceKey: z.ZodString;
+    enrollmentStatus: z.ZodEnum<["UNENROLLED", "ENROLLED", "REVOKED"]>;
+    revision: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    localDeviceKey: string;
+    enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+    revision: number;
+}, {
+    localDeviceKey: string;
+    enrollmentStatus: "UNENROLLED" | "ENROLLED" | "REVOKED";
+    revision: number;
+}>;
+export declare const LabFleetSsePayloadSchema: z.ZodObject<{
+    revision: z.ZodNumber;
+    changeType: z.ZodEnum<["DEVICE_ADDED", "IDENTITY_CHANGED", "AVAILABILITY_CHANGED", "ENROLLMENT_CHANGED", "DEVICE_RETIRED"]>;
+    sourcePodId: z.ZodString;
+    affectedDeviceIds: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    revision: number;
+    changeType: "DEVICE_ADDED" | "IDENTITY_CHANGED" | "AVAILABILITY_CHANGED" | "ENROLLMENT_CHANGED" | "DEVICE_RETIRED";
+    sourcePodId: string;
+    affectedDeviceIds: string[];
+}, {
+    revision: number;
+    changeType: "DEVICE_ADDED" | "IDENTITY_CHANGED" | "AVAILABILITY_CHANGED" | "ENROLLMENT_CHANGED" | "DEVICE_RETIRED";
+    sourcePodId: string;
+    affectedDeviceIds: string[];
+}>;
+export type RelayLabLifecycle = z.infer<typeof RelayLabLifecycleSchema>;
+export type RelayLabEnrollment = z.infer<typeof RelayLabEnrollmentSchema>;
+export type RelayLabIdentityStatus = z.infer<typeof RelayLabIdentityStatusSchema>;
+export type RelayLabReadinessErrorCode = z.infer<typeof RelayLabReadinessErrorCodeSchema>;
+export type RelayLabDevice = z.infer<typeof RelayLabDeviceSchema>;
+export type RelayLabReadiness = z.infer<typeof RelayLabReadinessSchema>;
+export type RelayLabFleetSnapshot = z.infer<typeof RelayLabFleetSnapshotSchema>;
+export type PublishRelayLabSnapshotBody = z.infer<typeof PublishRelayLabSnapshotBodySchema>;
+export type PublishRelayLabSnapshotResponse = z.infer<typeof PublishRelayLabSnapshotResponseSchema>;
+export type ReportRelayLabReadinessBody = z.infer<typeof ReportRelayLabReadinessBodySchema>;
+export type UpdateRelayLabEnrollmentBody = z.infer<typeof UpdateRelayLabEnrollmentBodySchema>;
+export type UpdateRelayLabEnrollmentResponse = z.infer<typeof UpdateRelayLabEnrollmentResponseSchema>;
+export type LabFleetSsePayload = z.infer<typeof LabFleetSsePayloadSchema>;
+//# sourceMappingURL=relay-lab-fleet.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relay-lab-fleet.schemas.d.ts","sourceRoot":"","sources":["../../contracts/relay-pods/relay-lab-fleet.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB,kCAAgC,CAAC;AACrE,eAAO,MAAM,wBAAwB,kDAInC,CAAC;AACH,eAAO,MAAM,4BAA4B,gDAIvC,CAAC;AACH;;;GAGG;AACH,eAAO,MAAM,+BAA+B,oDAGlC,CAAC;AACX,eAAO,MAAM,gCAAgC,sDAE5C,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBtB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBzB,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBnC,CAAC;AAEZ,eAAO,MAAM,qCAAqC;;;;;;;;;EAKvC,CAAC;AAEZ,mFAAmF;AACnF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;EAIpC,CAAC;AAEZ,eAAO,MAAM,sCAAsC;;;;;;;;;;;;EAMxC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAa1B,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}