@ludeo/cloud-common 1.2.260 → 1.2.262-beta-yahil-1

package/src/v4/events/site-controller/save-artifacts.command.ts

@@ -0,0 +1,30 @@
+import { IsArray, IsString, IsUUID } from 'class-validator';
+import { ValidateNestedType } from '../../../decorators';
+import { BaseCommand, BaseCommandPayload } from '../base/base';
+import { RuntimeArtifactPresignedUploadDto } from '../../types/site-controller/runtime-artifacts.dto';
+
+/** Machine-scoped PUT pass: `artifactPrefix` + target `latestVersion` + presigned **`uploads`** per object key. */
+export class SaveArtifactsCommandPayload extends BaseCommandPayload {
+  /** Game session this upload pass belongs to (parity with `{@link DetectArtifactsCommandPayload.gameResourceId}`). */
+  @IsUUID()
+  gameResourceId: string;
+
+  @IsString()
+  artifactPrefix: string;
+
+  @IsString()
+  latestVersion: string;
+
+  @IsArray()
+  @ValidateNestedType(() => RuntimeArtifactPresignedUploadDto)
+  uploads: RuntimeArtifactPresignedUploadDto[];
+}
+
+export class SaveArtifactsCommand extends BaseCommand<SaveArtifactsCommandPayload> {
+  @ValidateNestedType(() => SaveArtifactsCommandPayload)
+  payload: SaveArtifactsCommandPayload;
+
+  constructor(payload: SaveArtifactsCommandPayload) {
+    super(payload.machineResourceId, 'save-artifacts', payload);
+  }
+}

package/src/v4/types/site-controller/runtime-artifacts.dto.ts

@@ -1,16 +1,26 @@
-import { IsArray, IsOptional, IsString } from 'class-validator';
+import { IsArray, IsObject, IsOptional, IsString } from 'class-validator';
 import { ValidateNestedType } from '../../../decorators/validate-nested-type.decorator';
 
-export class RuntimeArtifactUploadObjectDto {
+/**
+ * Single object the client wants PUT URLs for (site-controller → site-adapter HTTP).
+ * No URL yet — only key + headers the signer may bind into the signature.
+ */
+export class RuntimeArtifactUploadPresignSpecDto {
   @IsString()
   key: string;
 
+  /** If set, adapters typically bind this into the presigned PUT; client must repeat on upload. Agent can infer (e.g. `mime`/extension). */
   @IsOptional()
   @IsString()
   contentType?: string;
+
+  /** Optional custom metadata echoed back when adapters sign with it (S3 / GCS). */
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, string>;
 }
 
-/** Full bucket object key paired with a presigned URL (adapter responses and MQTT `runtimeArtifacts.downloads`). */
+/** Full bucket object key paired with a presigned GET URL (`runtimeArtifacts.downloads`). */
 export class ObjectKeyUrlPair {
   @IsString()
   key: string;
@@ -19,15 +29,39 @@ export class ObjectKeyUrlPair {
   url: string;
 }
 
+/**
+ * Presigned PUT target (adapter reply, MQTT `save-artifacts.uploads`): full key, URL, echoed header binding.
+ */
+export class RuntimeArtifactPresignedUploadDto {
+  @IsString()
+  key: string;
+
+  @IsString()
+  url: string;
+
+  /** Echo of spec / signer — agent MUST send matching `Content-Type` on PUT when present. */
+  @IsOptional()
+  @IsString()
+  contentType?: string;
+
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, string>;
+}
+
 export class RuntimeArtifactsDownloadUrlsRequestDto {
+  /** Client-relative parent path inside the artifact root (no trailing `latestVersion`; no artifact-folder prefix — adapters add RUNTIME_ARTIFACTS_FOLDER). */
   @IsString()
-  prefix: string;
+  artifactPrefix: string;
+
+  @IsString()
+  latestVersion: string;
 }
 
 export class RuntimeArtifactsUploadUrlsRequestDto {
   @IsArray()
-  @ValidateNestedType(() => RuntimeArtifactUploadObjectDto)
-  objects: RuntimeArtifactUploadObjectDto[];
+  @ValidateNestedType(() => RuntimeArtifactUploadPresignSpecDto)
+  objects: RuntimeArtifactUploadPresignSpecDto[];
 }
 
 export class RuntimeArtifactsDownloadUrlsResponseDto {
@@ -35,13 +69,13 @@ export class RuntimeArtifactsDownloadUrlsResponseDto {
   @ValidateNestedType(() => ObjectKeyUrlPair)
   objects: ObjectKeyUrlPair[];
 
-  /** Full object key prefix incl. artifact folder, e.g. `shader-cache/<gameVersion>/<gpu>/<driver>/<version>`. */
+  /** Full object key prefix incl. artifact folder, **parent only** (matches request `artifactPrefix` + folder; no `latestVersion` segment). */
   @IsString()
   artifactPrefix: string;
 }
 
-export class RuntimeArtifactsUploadUrlsResponseDto {
+export class RuntimeArtifactsUploadsResponseDto {
   @IsArray()
-  @ValidateNestedType(() => ObjectKeyUrlPair)
-  urls: ObjectKeyUrlPair[];
+  @ValidateNestedType(() => RuntimeArtifactPresignedUploadDto)
+  uploads: RuntimeArtifactPresignedUploadDto[];
 }

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

@@ -21,7 +21,9 @@ export class RuntimeArtifactsPayload {
   @ValidateNestedType(() => ObjectKeyUrlPair)
   downloads: ObjectKeyUrlPair[];
 
-  /** Same as site-adapter `artifactPrefix`: path under bucket (with folder) for this bundle; used for shader cache env on the agent. */
+  /**
+   * Parent prefix under artifact root (**excludes** `latestVersion`; agent joins with {@code latestVersion} for binds / disk layout).
+   */
   @IsString()
   artifactPrefix: string;
 }
@@ -48,6 +50,11 @@ export class ProtonGameCreationPayload {
   @IsOptional()
   @ValidateNestedType(() => RuntimeArtifactsPayload)
   runtimeArtifacts?: RuntimeArtifactsPayload;
+
+  /** Docker bind mounts `{ hostAbsolutePath: containerAbsolutePath }` (site fills for runtime artifacts, etc.). */
+  @IsOptional()
+  @IsObject()
+  additionalMounts?: Record<string, string>;
 }
 
 export class AndroidGameCreationPayload {