@ludeo/cloud-common 1.2.261 → 1.2.262-beta-yahil-2

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,6 +29,26 @@ 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()
@@ -30,8 +60,8 @@ export class RuntimeArtifactsDownloadUrlsRequestDto {
 
 export class RuntimeArtifactsUploadUrlsRequestDto {
   @IsArray()
-  @ValidateNestedType(() => RuntimeArtifactUploadObjectDto)
-  objects: RuntimeArtifactUploadObjectDto[];
+  @ValidateNestedType(() => RuntimeArtifactUploadPresignSpecDto)
+  objects: RuntimeArtifactUploadPresignSpecDto[];
 }
 
 export class RuntimeArtifactsDownloadUrlsResponseDto {
@@ -44,8 +74,8 @@ export class RuntimeArtifactsDownloadUrlsResponseDto {
   artifactPrefix: string;
 }
 
-export class RuntimeArtifactsUploadUrlsResponseDto {
+export class RuntimeArtifactsUploadsResponseDto {
   @IsArray()
-  @ValidateNestedType(() => ObjectKeyUrlPair)
-  urls: ObjectKeyUrlPair[];
+  @ValidateNestedType(() => RuntimeArtifactPresignedUploadDto)
+  uploads: RuntimeArtifactPresignedUploadDto[];
 }