@ludeo/cloud-common 1.2.258-ygbeta1 → 1.2.258

package/src/v4/events/swap-cloud-user-gameplay-request-failed.ts

@@ -1,4 +1,4 @@
-import { IsString, IsUUID } from "class-validator";
+import { IsOptional, IsString, IsUUID } from "class-validator";
 
 import { CloudSessionContext } from "../contexts";
 import { LudeoEvent } from "../../infra/ludeo-event";
@@ -17,11 +17,13 @@ export class SwapCloudUserGameplayRequestFailedPayload {
   @IsString()
   errorMessage: string;
 
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
+  @IsOptional()
   @IsUUID()
-  cloudSessionId: string;
+  cloudSessionId?: string;
 }
 
 export class SwapCloudUserGameplayRequestFailed extends LudeoEvent {

package/src/v4/events/swap-cloud-user-gameplay-request.ts

@@ -15,11 +15,13 @@ export class SwapCloudUserGameplayRequestPayload {
   @IsUUID()
   gameplayId: string;
 
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
+  @IsOptional()
   @IsUUID()
-  cloudSessionId: string;
+  cloudSessionId?: string;
 
   @IsString()
   actualUserSessionToken: string;

package/src/v4/events/swap-cloud-user-request-failed.ts

@@ -15,8 +15,9 @@ export class SwapCloudUserRequestFailedPayload {
   @IsOptional()
   actualUserSessionToken?: string;
 
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
   @IsString()
   errorMessage: string;

package/src/v4/events/swap-cloud-user-request.ts

@@ -16,8 +16,9 @@ export class SwapCloudUserRequestPayload {
   @IsString()
   actualUserSessionToken?: string;
 
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
   @IsOptional()
   @IsEnum(CloudProvider)

package/src/v4/events/swap-to-default-user-completed.ts

@@ -5,8 +5,9 @@ import { CloudResourceContext } from "../contexts";
 import { IsUUIDOrEmpty } from "../../decorators/is-uuid-or-empty.decorator";
 
 export class SwapToDefaultUserCompletedPayload {
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
   @IsUUID()
   connectionId: string;

package/src/v4/events/swap-to-default-user-request-failed.ts

@@ -5,8 +5,9 @@ import { ValidateNestedType } from "../../decorators/validate-nested-type.decora
 import { CloudResourceContext } from "../contexts";
 
 export class SwapToDefaultUserRequestFailedPayload {
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
   @IsOptional()
   @IsUUID()

package/src/v4/events/swap-to-default-user.ts

@@ -5,8 +5,9 @@ import { CloudResourceContext } from "../contexts";
 import { IsUUIDOrEmpty } from "../../decorators/is-uuid-or-empty.decorator";
 
 export class SwapToDefaultUserPayload {
+  @IsOptional()
   @IsUUID()
-  ludeoResourceId: string;
+  ludeoResourceId?: string;
 
   @IsUUID()
   connectionId: string;

package/src/v4/types/build.ts

@@ -204,6 +204,10 @@ export class BuildVersionMeta {
 
   @IsString()
   buildVersion: string;
+
+  @IsOptional()
+  @IsString()
+  gameVersionId?: string;
 }
 
 export class RolloutConfig {

package/src/v4/types/cloud/cloud-configuration-settings.spec.ts

@@ -0,0 +1,12 @@
+import type { CloudSettings } from "./cloud-configuration-settings";
+import { CloudSettingsKeys, getCloudSettingsByKey } from "./cloud-configuration-settings";
+
+describe("getCloudSettingsByKey", () => {
+    it("preserves SPOT_ROLLOUT 0 instead of falling back to default (100)", () => {
+        const settings = {
+            [CloudSettingsKeys.SPOT_ROLLOUT]: 0,
+        } as CloudSettings;
+
+        expect(getCloudSettingsByKey(CloudSettingsKeys.SPOT_ROLLOUT, settings)).toBe(0);
+    });
+});

package/src/v4/types/cloud/cloud-configuration-settings.ts

@@ -1,5 +1,11 @@
 import { LudeoCastV2MachineClass } from "./ludeocast-v2";
 
+/** Stored values match UI labels for persistence and APIs. */
+export enum CloudScalingMode {
+  MARKETING = "Marketing",
+  AUTO_SCALING = "Auto Scaling",
+}
+
 export enum CloudSettingsKeys {
   GAME_LOADING_TIME = "gameLoadingTime",
   FIRST_TIME_LUDEO_LOAD = "firstTimeLudeoLoad",
@@ -9,6 +15,7 @@ export enum CloudSettingsKeys {
   ADDITIONAL_ENVIRONMENT_VARIABLES = "additionalEnvironmentVariables",
   MACHINE_CLASS_PRIORITY = "machineClassPriority",
   SPOT_ROLLOUT = "spotRollout",
+  SCALING = "scaling",
 }
 
 // Define the mapping of setting keys to their actual value types
@@ -21,18 +28,25 @@ export interface CloudSettingsTypeMap {
   [CloudSettingsKeys.ADDITIONAL_ENVIRONMENT_VARIABLES]: Record<string, string>;
   [CloudSettingsKeys.MACHINE_CLASS_PRIORITY]: LudeoCastV2MachineClass[];
   [CloudSettingsKeys.SPOT_ROLLOUT]: number;
+  [CloudSettingsKeys.SCALING]: CloudScalingMode;
 }
 
-
 export const MACHINE_CLASS_PRIORITY_DEFAULT_VALUES = [
   LudeoCastV2MachineClass.N1_STANDARD_8,
   LudeoCastV2MachineClass.G4DN_2XLARGE,
   LudeoCastV2MachineClass.N1_STANDARD_16,
-  LudeoCastV2MachineClass.G4DN_2XLARGE,
+  LudeoCastV2MachineClass.G4DN_4XLARGE,
+  LudeoCastV2MachineClass.G5_2XLARGE,
+  LudeoCastV2MachineClass.G5_4XLARGE,
   LudeoCastV2MachineClass.G2_STANDARD_16,
   LudeoCastV2MachineClass.G6_2XLARGE,
   LudeoCastV2MachineClass.G6_4XLARGE,
+  LudeoCastV2MachineClass.G6E_2XLARGE,
+  LudeoCastV2MachineClass.G6E_4XLARGE,
   LudeoCastV2MachineClass.G4_STANDARD_48,
+  LudeoCastV2MachineClass.G7E_2XLARGE,
+  LudeoCastV2MachineClass.G7E_4XLARGE,
+  
 ];
 
 // Create a type-safe CloudSettings type
@@ -41,14 +55,13 @@ export type CloudSettings = {
 };
 
 // Type-safe getter function that returns the specific value type for each key
+/** Uses nullish coalescing so numeric 0 (e.g. SPOT_ROLLOUT) is not replaced by defaults. */
 export const getCloudSettingsByKey = <K extends CloudSettingsKeys>(
   key: K,
-  cloudSettings: CloudSettings
+  cloudSettings: CloudSettings,
 ): CloudSettingsTypeMap[K] => {
-  return (
-    cloudSettings[key] ||
-    (CLOUD_SETTINGS_DEFAULT_VALUES[key].defaultValue as CloudSettingsTypeMap[K])
-  );
+  const raw = cloudSettings[key];
+  return (raw ?? CLOUD_SETTINGS_DEFAULT_VALUES[key].defaultValue) as CloudSettingsTypeMap[K];
 };
 
 // Discriminated union for type-safe configuration
@@ -82,6 +95,12 @@ export type CloudSettingConfig =
       key: CloudSettingsKeys;
       displayKey: string;
       defaultValue: LudeoCastV2MachineClass[];
+    }
+  | {
+      type: "enum";
+      key: CloudSettingsKeys;
+      displayKey: string;
+      defaultValue: CloudScalingMode;
     };
 
 export const CLOUD_SETTINGS_DEFAULT_VALUES: Record<
@@ -128,12 +147,18 @@ export const CLOUD_SETTINGS_DEFAULT_VALUES: Record<
     type: "array",
     key: CloudSettingsKeys.MACHINE_CLASS_PRIORITY,
     displayKey: "Machine Class Priority",
-    defaultValue: MACHINE_CLASS_PRIORITY_DEFAULT_VALUES
+    defaultValue: MACHINE_CLASS_PRIORITY_DEFAULT_VALUES,
   },
   [CloudSettingsKeys.SPOT_ROLLOUT]: {
     type: "number",
     key: CloudSettingsKeys.SPOT_ROLLOUT,
     displayKey: "Spot Rollout (%)",
-    defaultValue: 0,
+    defaultValue: 100,
   },
-};
+  [CloudSettingsKeys.SCALING]: {
+    type: "enum",
+    key: CloudSettingsKeys.SCALING,
+    displayKey: "Scaling",
+    defaultValue: CloudScalingMode.AUTO_SCALING,
+  },
+};

package/src/v4/types/cloud/ludeocast-v2/gpu-type.ts

@@ -0,0 +1,57 @@
+import { LudeoCastV2MachineClass } from "./machine-class";
+
+export enum LudeocastGpuType {
+  AMPERE = "ampere",
+  BOHR = "bohr",
+  T4 = "T4",
+  L4 = "L4",
+  A10G = "A10G",
+  L40S = "L40S",
+  RTXPRO6000 = "RTXPRO6000",
+}
+
+export const SPOT_SUFFIX = "-spot";
+
+export const isSpotMachineClass = (machineClass: string): boolean => machineClass.endsWith(SPOT_SUFFIX);
+
+export const stripSpotSuffix = (value: string): string => (isSpotMachineClass(value) ? value.slice(0, -SPOT_SUFFIX.length) : value);
+
+/** Canonical machine-class → gpu-type map (ludeocast pool agent / site-controller Redis & S3). */
+export const MACHINE_CLASS_TO_GPU_TYPE: Record<LudeoCastV2MachineClass, LudeocastGpuType> = {
+  // NVIDIA T4 (Turing)
+  [LudeoCastV2MachineClass.N1_STANDARD_8]: LudeocastGpuType.T4,
+  [LudeoCastV2MachineClass.N1_STANDARD_16]: LudeocastGpuType.T4,
+  [LudeoCastV2MachineClass.G4DN_2XLARGE]: LudeocastGpuType.T4,
+  [LudeoCastV2MachineClass.G4DN_4XLARGE]: LudeocastGpuType.T4,
+  // NVIDIA A10G (Ampere)
+  [LudeoCastV2MachineClass.G5_2XLARGE]: LudeocastGpuType.A10G,
+  [LudeoCastV2MachineClass.G5_4XLARGE]: LudeocastGpuType.A10G,
+  // NVIDIA L4 (Ada Lovelace)
+  [LudeoCastV2MachineClass.G2_STANDARD_16]: LudeocastGpuType.L4,
+  [LudeoCastV2MachineClass.G6_2XLARGE]: LudeocastGpuType.L4,
+  [LudeoCastV2MachineClass.G6_4XLARGE]: LudeocastGpuType.L4,
+  // NVIDIA L40S (Ada Lovelace)
+  [LudeoCastV2MachineClass.G6E_2XLARGE]: LudeocastGpuType.L40S,
+  [LudeoCastV2MachineClass.G6E_4XLARGE]: LudeocastGpuType.L40S,
+  // NVIDIA RTX PRO 6000 Blackwell Server Edition
+  [LudeoCastV2MachineClass.G7E_2XLARGE]: LudeocastGpuType.RTXPRO6000,
+  [LudeoCastV2MachineClass.G7E_4XLARGE]: LudeocastGpuType.RTXPRO6000,
+  [LudeoCastV2MachineClass.G4_STANDARD_48]: LudeocastGpuType.RTXPRO6000,
+  [LudeoCastV2MachineClass.G4_STANDARD_24]: LudeocastGpuType.RTXPRO6000,
+  [LudeoCastV2MachineClass.G4_STANDARD_12]: LudeocastGpuType.RTXPRO6000,
+  [LudeoCastV2MachineClass.G4_STANDARD_6]: LudeocastGpuType.RTXPRO6000,
+};
+
+export function getGpuTypeByMachineClass(machineClass: string | LudeoCastV2MachineClass): LudeocastGpuType {
+  const baseMachineClass = stripSpotSuffix(machineClass as string) as LudeoCastV2MachineClass;
+  const gpuType = MACHINE_CLASS_TO_GPU_TYPE[baseMachineClass];
+  if (!gpuType) throw new Error(`No GPU type mapping for machine class: ${machineClass}`);
+  return gpuType;
+}
+
+/** For callers using raw pool `machineClass` strings (e.g. site-controller Redis / S3 path segments). */
+export function tryResolveGpuTypeByMachineClass(machineClass: string | undefined): LudeocastGpuType | undefined {
+  if (!machineClass?.trim()) return undefined;
+  const base = stripSpotSuffix(machineClass.trim()) as LudeoCastV2MachineClass;
+  return MACHINE_CLASS_TO_GPU_TYPE[base];
+}

package/src/v4/types/cloud/ludeocast-v2/index.ts

@@ -1,3 +1,4 @@
+export * from "./machine-resource-meta";
 export * from "./resource-provider-settings";
 export * from "./provider-settings";
 export * from "./request-data";
@@ -5,3 +6,4 @@ export * from "./game-creation-response";
 export * from "./allocation-data";
 export * from "./machine-provider-settings";
 export * from "./machine-class";
+export * from "./gpu-type";

package/src/v4/types/cloud/ludeocast-v2/machine-class.ts

@@ -10,6 +10,12 @@ export enum LudeoCastV2MachineClass {
   // AWS
   G4DN_2XLARGE = "g4dn.2xlarge",
   G4DN_4XLARGE = "g4dn.4xlarge",
+  G5_2XLARGE = "g5.2xlarge",
+  G5_4XLARGE = "g5.4xlarge",
   G6_2XLARGE = "g6.2xlarge",
   G6_4XLARGE = "g6.4xlarge",
+  G6E_2XLARGE = "g6e.2xlarge",
+  G6E_4XLARGE = "g6e.4xlarge",
+  G7E_2XLARGE = "g7e.2xlarge",
+  G7E_4XLARGE = "g7e.4xlarge",
 }

package/src/v4/types/cloud/ludeocast-v2/machine-resource-meta.ts

@@ -0,0 +1,10 @@
+/**
+ * Machine facts reported by the ludeocast agent on specific lifecycle milestones (not provisioning /
+ * pool `LudeoCastV2ProviderSettings`). Site-controller persists this shape under the machine resource
+ * field `meta`, merged shallowly when handling the matching MQTT `resource-update`.
+ *
+ * @example AgentReadyForCommands — include `nvidiaDriverVersion` from `nvidia-smi` in payload `meta`.
+ */
+export interface MachineResourceMeta {
+  nvidiaDriverVersion?: string;
+}

package/src/v4/types/site-controller/types.ts

@@ -1,7 +1,8 @@
-import { IsString, IsOptional, IsObject, IsArray } from "class-validator";
+import { IsString, IsOptional, IsObject, IsArray, IsUUID } from "class-validator";
 import { LudeocastV2Distributions } from "../build";
 import { MachineResourceSettings } from "../pools";
 import { LudeoCastV2MachineResourceProviderSettings } from "../cloud";
+import { ValidateNestedType } from "../../../decorators";
 
 export enum MachineMode {
   PROTON = "proton",
@@ -9,6 +10,17 @@ export enum MachineMode {
   PROTON_V2 = "proton-v2",
 }
 
+/** Shader / runtime artifact bundle (site-controller may fill when ENABLE_RUNTIME_ARTIFACTS is true). */
+export class RuntimeArtifactsPayload {
+  @IsString()
+  latestVersion: string;
+
+  /** Presigned GET URLs for artifact objects under this version; agent consumes them in order when non-empty. */
+  @IsArray()
+  @IsString({ each: true })
+  downloadUrls: string[];
+}
+
 export class ProtonGameCreationPayload {
   @IsString()
   exeRelativePath: string;
@@ -21,8 +33,16 @@ export class ProtonGameCreationPayload {
   @IsArray()
   additionalLaunchArgs?: string[];
 
-  @IsString()
+  @IsUUID()
   buildId: string;
+
+  @IsOptional()
+  @IsString()
+  gameVersionId?: string;
+
+  @IsOptional()
+  @ValidateNestedType(() => RuntimeArtifactsPayload)
+  runtimeArtifacts?: RuntimeArtifactsPayload;
 }
 
 export class AndroidGameCreationPayload {