⭐ feat(maitred): Update maitred - hookup to the API (#198)

## Description
We are attempting to hookup maitred to the API
Maitred duties will be:
- [ ] Hookup to the API
- [ ]  Wait for signal (from the API) to start Steam
- [ ] Stop signal to stop the gaming session, clean up Steam... and
maybe do the backup

## Summary by CodeRabbit

- **New Features**
- Introduced Docker-based deployment configurations for both the main
and relay applications.
- Added new API endpoints enabling real-time machine messaging and
enhanced IoT operations.
- Expanded database schema and actor types to support improved machine
tracking.

- **Improvements**
- Enhanced real-time communication and relay management with streamlined
room handling.
- Upgraded dependencies, logging, and error handling for greater
stability and performance.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: DatCaptainHorse <DatCaptainHorse@users.noreply.github.com>
Co-authored-by: Kristian Ollikainen <14197772+DatCaptainHorse@users.noreply.github.com>

packages/functions/src/api/auth.ts

@@ -1,15 +1,20 @@
 import { Resource } from "sst";
 import { subjects } from "../subjects";
 import { type MiddlewareHandler } from "hono";
+import { VisibleError } from "@nestri/core/error";
+import { ActorContext } from "@nestri/core/actor";
+import { HTTPException } from "hono/http-exception";
 import { useActor, withActor } from "@nestri/core/actor";
 import { createClient } from "@openauthjs/openauth/client";
 import { ErrorCodes, VisibleError } from "@nestri/core/error";
 
 const client = createClient({
-  issuer: Resource.Urls.auth,
   clientID: "api",
+  issuer: Resource.Urls.auth
 });
 
+
+
 export const notPublic: MiddlewareHandler = async (c, next) => {
   const actor = useActor();
   if (actor.type === "public")
@@ -42,16 +47,22 @@ export const auth: MiddlewareHandler = async (c, next) => {
       "Invalid bearer token",
     );
   }
+    
+    if (result.subject.type === "machine") {
+      console.log("machine detected")
+      return withActor(result.subject, next);
+    }
 
-  if (result.subject.type === "user") {
-    const teamID = c.req.header("x-nestri-team") //|| c.req.query("teamID");
-    if (!teamID) return withActor(result.subject, next);
-    // const email = result.subject.properties.email;
-    return withActor(
-      {
-        type: "system",
-        properties: {
-          teamID,
+    if (result.subject.type === "user") {
+      const teamID = c.req.header("x-nestri-team") //|| c.req.query("teamID");
+      if (!teamID) return withActor(result.subject, next);
+      // const email = result.subject.properties.email;
+      return withActor(
+        {
+          type: "system",
+          properties: {
+            teamID,
+          },
         },
       },
       next
@@ -71,4 +82,5 @@ export const auth: MiddlewareHandler = async (c, next) => {
       //   },
     );
   }
+  return ActorContext.with({ type: "public", properties: {} }, next);
 };

packages/functions/src/api/index.ts

@@ -4,6 +4,7 @@ import { auth } from "./auth";
 import { TeamApi } from "./team";
 import { logger } from "hono/logger";
 import { AccountApi } from "./account";
+import { MachineApi } from "./machine";
 import { openAPISpecs } from "hono-openapi";
 import { HTTPException } from "hono/http-exception";
 import { handle, streamHandle } from "hono/aws-lambda";
@@ -22,6 +23,7 @@ const routes = app
     .get("/", (c) => c.text("Hello World!"))
     .route("/team", TeamApi.route)
     .route("/account", AccountApi.route)
+    .route("/machine", MachineApi.route)
     .onError((error, c) => {
         console.warn(error);
         if (error instanceof VisibleError) {
@@ -38,7 +40,7 @@ const routes = app
                     code: ErrorCodes.Validation.INVALID_PARAMETER,
                     message: "Invalid request",
                 },
-                400,
+                error.status,
             );
         }
         console.error("unhandled error:", error);

packages/functions/src/api/machine.ts

@@ -0,0 +1,224 @@
+import {z} from "zod"
+import {Hono} from "hono";
+import {notPublic} from "./auth";
+import {Result} from "../common";
+import {describeRoute} from "hono-openapi";
+import {assertActor} from "@nestri/core/actor";
+import {Realtime} from "@nestri/core/realtime/index";
+import {validator} from "hono-openapi/zod";
+import {CreateMessageSchema, StartMessageSchema, StopMessageSchema} from "./messages.ts";
+
+export module MachineApi {
+  export const route = new Hono()
+    .use(notPublic)
+    .post("/",
+      describeRoute({
+        tags: ["Machine"],
+        summary: "Send messages to the machine",
+        description: "Send messages directly to the machine",
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.literal("ok")
+                ),
+              },
+            },
+            description: "Successfully sent the message to Maitred"
+          },
+          // 404: {
+          //     content: {
+          //         "application/json": {
+          //             schema: resolver(z.object({ error: z.string() })),
+          //         },
+          //     },
+          //     description: "This account does not exist",
+          // },
+        }
+      }),
+      validator(
+        "json",
+        z.any()
+      ),
+      async (c) => {
+        const actor = assertActor("machine");
+        console.log("actor.id", actor.properties.machineID)
+
+        await Realtime.publish(c.req.valid("json"))
+
+        return c.json({
+          data: "ok"
+        }, 200);
+      },
+    )
+    .post("/:machineID/create",
+      describeRoute({
+        tags: ["Machine"],
+        summary: "Request to create a container for a specific machine",
+        description: "Publishes a message to create a container via MQTT for the given machine ID",
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({
+                    message: z.literal("create request sent"),
+                  })
+                ),
+              },
+            },
+            description: "Create request successfully sent to MQTT",
+          },
+          400: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({error: z.string()})
+                ),
+              },
+            },
+            description: "Failed to publish create request",
+          },
+        },
+      }),
+      validator("json", CreateMessageSchema.shape.payload.optional()), // No payload required for create
+      async (c) => {
+        const actor = assertActor("machine");
+        const body = c.req.valid("json");
+
+        const message = {
+          type: "create" as const,
+          payload: body || {}, // Empty payload if none provided
+        };
+
+        try {
+          await Realtime.publish(message, "create");
+          console.log("Published create request to");
+        } catch (error) {
+          console.error("Failed to publish to MQTT:", error);
+          return c.json({error: "Failed to send create request"}, 400);
+        }
+
+        return c.json({
+          data: {
+            message: "create request sent",
+          },
+        }, 200);
+      }
+    )
+    .post("/:machineID/start",
+      describeRoute({
+        tags: ["Machine"],
+        summary: "Request to start a container for a specific machine",
+        description: "Publishes a message to start a container via MQTT for the given machine ID",
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({
+                    message: z.literal("start request sent"),
+                  })
+                ),
+              },
+            },
+            description: "Start request successfully sent to MQTT",
+          },
+          400: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({error: z.string()})
+                ),
+              },
+            },
+            description: "Failed to publish start request",
+          },
+        },
+      }),
+      validator("json", StartMessageSchema.shape.payload), // Use the payload schema
+      async (c) => {
+        const actor = assertActor("machine");
+        const body = c.req.valid("json");
+
+        const message = {
+          type: "start" as const,
+          payload: {
+            container_id: body.container_id,
+          },
+        };
+
+        try {
+          await Realtime.publish(message, "start");
+          console.log("Published start request");
+        } catch (error) {
+          console.error("Failed to publish to MQTT:", error);
+          return c.json({error: "Failed to send start request"}, 400);
+        }
+
+        return c.json({
+          data: {
+            message: "start request sent",
+          },
+        }, 200);
+      }
+    )
+    .post("/:machineID/stop",
+      describeRoute({
+        tags: ["Machine"],
+        summary: "Request to stop a container for a specific machine",
+        description: "Publishes a message to stop a container via MQTT for the given machine ID",
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({
+                    message: z.literal("stop request sent"),
+                  })
+                ),
+              },
+            },
+            description: "Stop request successfully sent to MQTT",
+          },
+          400: {
+            content: {
+              "application/json": {
+                schema: Result(
+                  z.object({error: z.string()})
+                ),
+              },
+            },
+            description: "Failed to publish start request",
+          },
+        },
+      }),
+      validator("json", StopMessageSchema.shape.payload), // Use the payload schema
+      async (c) => {
+        const actor = assertActor("machine");
+        const body = c.req.valid("json");
+
+        const message = {
+          type: "stop" as const,
+          payload: {
+            container_id: body.container_id,
+          },
+        };
+
+        try {
+          await Realtime.publish(message, "stop");
+          console.log("Published stop request");
+        } catch (error) {
+          console.error("Failed to publish to MQTT:", error);
+          return c.json({error: "Failed to send stop request"}, 400);
+        }
+
+        return c.json({
+          data: {
+            message: "stop request sent",
+          },
+        }, 200);
+      }
+    )
+}

packages/functions/src/api/messages.ts

@@ -0,0 +1,54 @@
+import { z } from "zod"
+
+// Base message interface
+export interface BaseMessage {
+  type: string; // e.g., "start", "stop", "status"
+  payload: Record<string, any>; // Generic payload, refined by specific types
+}
+
+// Specific message types
+export interface StartMessage extends BaseMessage {
+  type: "start";
+  payload: {
+    container_id: string;
+    [key: string]: any; // Allow additional fields for future expansion
+  };
+}
+
+// Example future message type
+export interface StopMessage extends BaseMessage {
+  type: "stop";
+  payload: {
+    container_id: string;
+    [key: string]: any;
+  };
+}
+
+// Union type for all possible messages (expandable)
+export type MachineMessage = StartMessage | StopMessage; // Add more types as needed
+
+// Zod schema for validation
+export const BaseMessageSchema = z.object({
+  type: z.string(),
+  payload: z.record(z.any()),
+});
+
+export const CreateMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("create"),
+});
+
+export const StartMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("start"),
+  payload: z.object({
+    container_id: z.string(),
+  }).passthrough(),
+});
+
+export const StopMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("stop"),
+  payload: z.object({
+    container_id: z.string(),
+  }).passthrough(),
+});
+
+export const MachineMessageSchema = z.union([StartMessageSchema, StopMessageSchema]);