@dakkitor/api-contracts 1.6.0 → 1.7.0

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

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LabFleetSsePayloadSchema = exports.UpdateRelayLabEnrollmentResponseSchema = exports.UpdateRelayLabEnrollmentBodySchema = exports.ReportRelayLabReadinessBodySchema = exports.PublishRelayLabSnapshotResponseSchema = exports.PublishRelayLabSnapshotBodySchema = exports.RelayLabFleetSnapshotSchema = exports.RelayLabReadinessSchema = exports.RelayLabDeviceSchema = exports.RelayLabReadinessErrorCodeSchema = exports.RELAY_LAB_READINESS_ERROR_CODES = exports.RelayLabIdentityStatusSchema = exports.RelayLabEnrollmentSchema = exports.RelayLabLifecycleSchema = void 0;
+const zod_1 = require("zod");
+exports.RelayLabLifecycleSchema = zod_1.z.enum(['ACTIVE', 'RETIRED']);
+exports.RelayLabEnrollmentSchema = zod_1.z.enum([
+    'UNENROLLED',
+    'ENROLLED',
+    'REVOKED',
+]);
+exports.RelayLabIdentityStatusSchema = zod_1.z.enum([
+    'INCOMPLETE',
+    'VALID',
+    'CONFLICT',
+]);
+/**
+ * Closed v1 vocabulary emitted by Relay contact reconciliation. Keep this
+ * list free of device identifiers, phone numbers, and raw error text.
+ */
+exports.RELAY_LAB_READINESS_ERROR_CODES = [
+    'OWNER_OFFLINE',
+    'CONTACT_WRITE_FAILED',
+];
+exports.RelayLabReadinessErrorCodeSchema = zod_1.z.enum(exports.RELAY_LAB_READINESS_ERROR_CODES);
+exports.RelayLabDeviceSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    podId: zod_1.z.string().uuid(),
+    podSlug: zod_1.z.string().min(1),
+    podDisplayName: zod_1.z.string().min(1),
+    localDeviceKey: zod_1.z.string().min(1),
+    label: zod_1.z.string().min(1).nullable(),
+    phoneE164: zod_1.z
+        .string()
+        .regex(/^\+[1-9]\d{7,14}$/)
+        .nullable(),
+    identityVersion: zod_1.z.number().int().positive(),
+    lifecycleStatus: exports.RelayLabLifecycleSchema,
+    enrollmentStatus: exports.RelayLabEnrollmentSchema,
+    connectionStatus: zod_1.z.enum(['ONLINE', 'OFFLINE']),
+    restrictionStatus: zod_1.z.enum(['NONE', 'RECOVERING', 'RESTRICTED']),
+    identityStatus: exports.RelayLabIdentityStatusSchema,
+    lastSeenAt: zod_1.z.string().datetime(),
+})
+    .strict();
+exports.RelayLabReadinessSchema = zod_1.z
+    .object({
+    podId: zod_1.z.string().uuid(),
+    podDisplayName: zod_1.z.string().min(1),
+    revision: zod_1.z.number().int().nonnegative(),
+    requiredPairCount: zod_1.z.number().int().nonnegative(),
+    savedPairCount: zod_1.z.number().int().nonnegative(),
+    failedPairCount: zod_1.z.number().int().nonnegative(),
+    missingPairs: zod_1.z
+        .array(zod_1.z
+        .object({
+        ownerLocalDeviceKey: zod_1.z.string().min(1),
+        contactLabDeviceId: zod_1.z.string().uuid(),
+        errorCode: exports.RelayLabReadinessErrorCodeSchema,
+    })
+        .strict())
+        .max(100),
+    reportedAt: zod_1.z.string().datetime(),
+    expiresAt: zod_1.z.string().datetime(),
+    ready: zod_1.z.boolean(),
+})
+    .strict();
+exports.RelayLabFleetSnapshotSchema = zod_1.z
+    .object({
+    revision: zod_1.z.number().int().nonnegative(),
+    devices: zod_1.z.array(exports.RelayLabDeviceSchema),
+    readiness: zod_1.z.array(exports.RelayLabReadinessSchema),
+})
+    .strict();
+/**
+ * A pod can publish only its local observations. Recruitment derives pod
+ * ownership and enrollment state from the authenticated machine principal.
+ */
+exports.PublishRelayLabSnapshotBodySchema = zod_1.z
+    .object({
+    generation: zod_1.z.number().int().positive(),
+    observedAt: zod_1.z.string().datetime(),
+    devices: zod_1.z.array(zod_1.z
+        .object({
+        localDeviceKey: zod_1.z.string().min(1),
+        label: zod_1.z.string().min(1).nullable(),
+        phoneE164: zod_1.z
+            .string()
+            .regex(/^\+[1-9]\d{7,14}$/)
+            .nullable(),
+        lifecycleStatus: exports.RelayLabLifecycleSchema,
+        connectionStatus: zod_1.z.enum(['ONLINE', 'OFFLINE']),
+        restrictionStatus: zod_1.z.enum(['NONE', 'RECOVERING', 'RESTRICTED']),
+        lastSeenAt: zod_1.z.string().datetime(),
+    })
+        .strict()),
+})
+    .strict();
+exports.PublishRelayLabSnapshotResponseSchema = zod_1.z
+    .object({
+    acceptedGeneration: zod_1.z.number().int().positive(),
+    revision: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+/** The pod supplies readiness facts; timestamps and readiness are server-owned. */
+exports.ReportRelayLabReadinessBodySchema = exports.RelayLabReadinessSchema.omit({
+    podId: true,
+    podDisplayName: true,
+    reportedAt: true,
+    expiresAt: true,
+    ready: true,
+});
+exports.UpdateRelayLabEnrollmentBodySchema = zod_1.z
+    .object({
+    enrollmentStatus: zod_1.z.enum(['ENROLLED', 'REVOKED']),
+})
+    .strict();
+exports.UpdateRelayLabEnrollmentResponseSchema = zod_1.z
+    .object({
+    localDeviceKey: zod_1.z.string().min(1),
+    enrollmentStatus: exports.RelayLabEnrollmentSchema,
+    revision: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+exports.LabFleetSsePayloadSchema = zod_1.z
+    .object({
+    revision: zod_1.z.number().int().nonnegative(),
+    changeType: zod_1.z.enum([
+        'DEVICE_ADDED',
+        'IDENTITY_CHANGED',
+        'AVAILABILITY_CHANGED',
+        'ENROLLMENT_CHANGED',
+        'DEVICE_RETIRED',
+    ]),
+    sourcePodId: zod_1.z.string().uuid(),
+    affectedDeviceIds: zod_1.z.array(zod_1.z.string().uuid()),
+})
+    .strict();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakkitor/api-contracts",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "TypeScript API contracts using ts-rest and Zod",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",