docs: registrar fluxo do updater e atualizar chaves

src/app/api/machines/register/route.ts

@@ -23,6 +23,13 @@ const registerSchema = z
     serialNumbers: z.array(z.string()).default([]),
     metadata: z.record(z.string(), z.unknown()).optional(),
     registeredBy: z.string().optional(),
+    accessRole: z.enum(["collaborator", "manager"]).optional(),
+    collaborator: z
+      .object({
+        email: z.string().email(),
+        name: z.string().optional(),
+      })
+      .optional(),
   })
   .refine(
     (data) => (data.macAddresses && data.macAddresses.length > 0) || (data.serialNumbers && data.serialNumbers.length > 0),
@@ -61,15 +68,43 @@ export async function POST(request: Request) {
   const client = new ConvexHttpClient(convexUrl)
 
   try {
+    const tenantId = payload.tenantId ?? DEFAULT_TENANT_ID
+    const persona = payload.accessRole ?? undefined
+    const collaborator = payload.collaborator ?? null
+
+    if (persona && !collaborator) {
+      return jsonWithCors(
+        { error: "Informe os dados do colaborador/gestor ao definir o perfil de acesso." },
+        400,
+        request.headers.get("origin"),
+        CORS_METHODS
+      )
+    }
+
+    let metadataPayload: Record<string, unknown> | undefined = payload.metadata
+      ? { ...(payload.metadata as Record<string, unknown>) }
+      : undefined
+    if (collaborator) {
+      const collaboratorMeta = {
+        email: collaborator.email,
+        name: collaborator.name ?? null,
+        role: persona ?? "collaborator",
+      }
+      metadataPayload = {
+        ...(metadataPayload ?? {}),
+        collaborator: collaboratorMeta,
+      }
+    }
+
     const registration = await client.mutation(api.machines.register, {
       provisioningSecret: payload.provisioningSecret,
-      tenantId: payload.tenantId ?? DEFAULT_TENANT_ID,
+      tenantId,
       companySlug: payload.companySlug ?? undefined,
       hostname: payload.hostname,
       os: payload.os,
       macAddresses: payload.macAddresses,
       serialNumbers: payload.serialNumbers,
-      metadata: payload.metadata,
+      metadata: metadataPayload,
       registeredBy: payload.registeredBy,
     })
 
@@ -78,6 +113,7 @@ export async function POST(request: Request) {
       tenantId: registration.tenantId ?? DEFAULT_TENANT_ID,
       hostname: payload.hostname,
       machineToken: registration.machineToken,
+      persona,
     })
 
     await client.mutation(api.machines.linkAuthAccount, {
@@ -86,6 +122,34 @@ export async function POST(request: Request) {
       authEmail: account.authEmail,
     })
 
+    let assignedUserId: Id<"users"> | undefined
+    if (persona && collaborator) {
+      const ensuredUser = (await client.mutation(api.users.ensureUser, {
+        tenantId,
+        email: collaborator.email,
+        name: collaborator.name ?? collaborator.email,
+        avatarUrl: undefined,
+        role: persona.toUpperCase(),
+        companyId: registration.companyId ? (registration.companyId as Id<"companies">) : undefined,
+      })) as { _id?: Id<"users"> } | null
+
+      assignedUserId = ensuredUser?._id
+
+      await client.mutation(api.machines.updatePersona, {
+        machineId: registration.machineId as Id<"machines">,
+        persona,
+        ...(assignedUserId ? { assignedUserId } : {}),
+        assignedUserEmail: collaborator.email,
+        assignedUserName: collaborator.name ?? undefined,
+        assignedUserRole: persona === "manager" ? "MANAGER" : "COLLABORATOR",
+      })
+    } else {
+      await client.mutation(api.machines.updatePersona, {
+        machineId: registration.machineId as Id<"machines">,
+        persona: "",
+      })
+    }
+
     return jsonWithCors(
       {
         machineId: registration.machineId,
@@ -95,6 +159,9 @@ export async function POST(request: Request) {
         machineToken: registration.machineToken,
         machineEmail: account.authEmail,
         expiresAt: registration.expiresAt,
+        persona: persona ?? null,
+        assignedUserId: assignedUserId ?? null,
+        collaborator: collaborator ?? null,
       },
       { status: 201 },
       request.headers.get("origin"),