@ludeo/cloud-common 1.2.174-beta-yahil-3 → 1.2.174-beta-yahil-5

package/src/v4/types/mqtt/types.ts

@@ -1,219 +0,0 @@
-/**
- * MQTT Types for site-controller <-> ludeocast-agent communication
- *
- * Architecture:
- * - Ludeocast agent runs on a VM identified by MACHINE_RESOURCE_ID (env var)
- * - Agent publishes ALL status updates to: agent/status-updates/{machineResourceId}
- * - This includes both machine updates and game updates running on that machine
- *
- * Message Flow:
- * - Site-Controller → Agent: Commands (init, start-game, terminate-game, etc.)
- *   Published to: agent/{machineResourceId}/command/{commandName}
- *
- * - Agent → Site-Controller: Status Updates (machine + game status changes)
- *   Published to: agent/status-updates/{machineResourceId}
- *   Site-Controller subscribes to: agent/status-updates/+ (all agents)
- *   Routes by resourceType (machine/game) to appropriate service
- */
-
-import { IsEnum, IsString, IsUUID, IsOptional } from 'class-validator';
-import { ValidateNestedType } from '../../../decorators';
-import { MachineMode, GameCreationPayload } from '../site-controller/types';
-import { CloudResourceStatus } from '../pools/resource/status';
-import { CloudPoolType } from '../pools/type';
-
-// ==========================================================================
-// SITE-CONTROLLER → AGENT (Commands)
-// ==========================================================================
-
-// ========== Command Payloads ==========
-
-export const AGENT_STRING = 'agent';
-export const COMMAND_STRING = 'command'
-export const WILDCARD_MQTT_STRING = '#';
-
-export class BaseCommandPayload {
-  @IsUUID()
-  machineResourceId: string;
-}
-
-export class InitCommandPayload extends BaseCommandPayload {
-  @IsEnum(MachineMode)
-  mode: MachineMode;
-}
-
-export class StartGameCommandPayload extends BaseCommandPayload {
-  payload: GameCreationPayload;
-}
-
-export class ExportLogsCommandPayload extends BaseCommandPayload {
-  @IsUUID()
-  gameResourceId: string;
-
-  @IsString()
-  uploadURL: string;
-}
-
-export class ResourceStatusUpdatePayload extends BaseCommandPayload {
-  @IsOptional()
-  @IsUUID()
-  gameResourceId?: string; // Present for game status updates, absent for machine status
-
-  @IsEnum(CloudResourceStatus)
-  status: CloudResourceStatus;
-
-  @IsOptional()
-  meta?: Record<string, any>;
-}
-
-export class ShutdownCommandPayload extends BaseCommandPayload {}
-
-export class TerminateGameCommandPayload extends BaseCommandPayload {
-  @IsUUID()
-  gameResourceId: string;
-}
-
-// ========== Command Classes ==========
-
-/**
- * Init command - Initialize the agent with a specific mode
- * Topic: agent/{machineResourceId}/command/init
- */
-export class InitCommand {
-  static readonly COMMAND_NAME = 'init';
-
-  @ValidateNestedType(() => InitCommandPayload)
-  payload: InitCommandPayload;
-
-  constructor(payload: InitCommandPayload) {
-    this.payload = payload;
-  }
-    
-  /** Get topic for publishing this command */
-  getTopic(): string {
-    return `${AGENT_STRING}/${this.payload.machineResourceId}/${COMMAND_STRING}/${InitCommand.COMMAND_NAME}`;
-  }
-}
-
-/**
- * Start game command - Start a game instance on the agent
- * Topic: agent/{machineResourceId}/command/start-game
- */
-export class StartGameCommand {
-  static readonly COMMAND_NAME = 'start-game';
-
-
-  @ValidateNestedType(() => StartGameCommandPayload)
-  payload: StartGameCommandPayload;
-
-  constructor(payload: StartGameCommandPayload) {
-    this.payload = payload;
-  }
-
-  getTopic(): string {
-    return `${AGENT_STRING}/${this.payload.machineResourceId}/${COMMAND_STRING}/${StartGameCommand.COMMAND_NAME}`;
-  }
-}
-
-/**
- * Terminate game command - Stop a running game instance
- * Topic: agent/{machineResourceId}/command/terminate-game
- */
-export class TerminateGameCommand {
-  static readonly COMMAND_NAME = 'terminate-game';
-
-  @ValidateNestedType(() => TerminateGameCommandPayload)
-  payload: TerminateGameCommandPayload;
-
-  constructor(payload: TerminateGameCommandPayload) {
-    this.payload = payload;
-  }
-
-  getTopic(): string {
-    return `${AGENT_STRING}/${this.payload.machineResourceId}/${COMMAND_STRING}/${TerminateGameCommand.COMMAND_NAME}`;
-  }
-}
-
-/**
- * Export logs command - Export logs to a specified URL
- * Topic: agent/{machineResourceId}/command/export-logs
- */
-export class ExportLogsCommand  {
-  static readonly COMMAND_NAME = 'export-logs';
-
-  @ValidateNestedType(() => ExportLogsCommandPayload)
-  payload: ExportLogsCommandPayload;
-
-  constructor(payload: ExportLogsCommandPayload) {
-    this.payload = payload;
-  }
-
-  getTopic(): string {
-    return `${AGENT_STRING}/${this.payload.machineResourceId}/${COMMAND_STRING}/${ExportLogsCommand.COMMAND_NAME}`;
-  }
-}
-
-/**
- * Shutdown command - Gracefully shutdown the agent
- * Topic: agent/{machineResourceId}/command/shutdown
- */
-export class ShutdownCommand  {
-  static readonly COMMAND_NAME = 'shutdown';
-
-  @ValidateNestedType(() => ShutdownCommandPayload)
-  payload: ShutdownCommandPayload;
-
-
-  constructor(payload: ShutdownCommandPayload) {
-    this.payload = payload;
-  }
-
-  getTopic(): string {
-    return `${AGENT_STRING}/${this.payload.machineResourceId}/${COMMAND_STRING}/${ShutdownCommand.COMMAND_NAME}`;
-  }
-}
-
-/**
- * Resource status update command - Update the status of a resource
- * Topic: agent/{machineResourceId}/command/resource-status-update
- */
-export class ResourceStatusUpdateCommand {
-    static readonly COMMAND_NAME = 'resource-status-update';
-
-
-    @ValidateNestedType(() => ResourceStatusUpdatePayload)
-    payload: ResourceStatusUpdatePayload;
-
-    constructor(payload: ResourceStatusUpdatePayload) {
-        this.payload = payload;
-    }
-    
-    getTopic(): string {
-        return `${AGENT_STRING}/${ResourceStatusUpdateCommand.COMMAND_NAME}/${this.payload.machineResourceId}`;
-    }
-}
-
-// ==========================================================================
-// AGENT → SITE-CONTROLLER (Status Updates)
-// ==========================================================================
-
-/**
- * Status update from agent to site-controller
- * Topic: agent/status-updates/{machineResourceId}
- *
- * Agent always includes machineResourceId (since it's running on that machine).
- * Optionally includes gameResourceId when reporting game status.
- *
- * Status types:
- * - Machine status: { machineResourceId, status, ... } (no gameResourceId)
- * - Game status: { machineResourceId, gameResourceId, status, ... }
- *
- * Site-controller subscribes to agent/status-updates/+ and routes based on gameResourceId presence.
- */
-
-
-/** Pattern for site-controller to subscribe to ALL status updates from ALL agents */
-export const RESOURCE_STATUS_SUBSCRIBE_PATTERN = `${AGENT_STRING}/${ResourceStatusUpdateCommand.COMMAND_NAME}/${WILDCARD_MQTT_STRING}`;
-
-export const AGENT_COMMAND_SUBSCRIBE_PATTERN = `${AGENT_STRING}/${COMMAND_STRING}/${WILDCARD_MQTT_STRING}`;
-