Align SCUM operations with reference tools

platform_web/api/client.ts

@@ -47,6 +47,14 @@ import type {
   GameClientBridgeSnapshotListResponse,
   GameClientBridgeSnapshotQuery,
   GameClientBridgeStatusResponse,
+  GameGiftCatalogListResponse,
+  GameGiftCatalogRequest,
+  GameGiftCatalogResponse,
+  GameGiftGrantListResponse,
+  GameGiftGrantRequest,
+  GameGiftGrantResponse,
+  GameGiftRevisionListResponse,
+  GameGiftRevisionResponse,
   GamePluginListResponse,
   HealthResponse,
   JobCreateRequest,
@@ -628,6 +636,34 @@ export class PlatformApiClient {
     return this.request<SCUMListResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/scum/positions`);
   }
 
+  async listGameGiftCatalogs(serverInstanceId: string): Promise<GameGiftCatalogListResponse> {
+    return this.request<GameGiftCatalogListResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gifts`);
+  }
+
+  async saveGameGiftCatalog(serverInstanceId: string, request: GameGiftCatalogRequest): Promise<GameGiftCatalogResponse> {
+    return this.request<GameGiftCatalogResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gifts`, { method: "POST", body: request });
+  }
+
+  async publishGameGiftCatalog(serverInstanceId: string, catalogId: string): Promise<GameGiftRevisionResponse> {
+    return this.request<GameGiftRevisionResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gifts/${encodeURIComponent(catalogId)}/publish`, { method: "POST", body: {} });
+  }
+
+  async listGameGiftRevisions(serverInstanceId: string, catalogId: string): Promise<GameGiftRevisionListResponse> {
+    return this.request<GameGiftRevisionListResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gifts/${encodeURIComponent(catalogId)}/revisions`);
+  }
+
+  async listGameGiftGrants(serverInstanceId: string): Promise<GameGiftGrantListResponse> {
+    return this.request<GameGiftGrantListResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gift-grants`);
+  }
+
+  async requestGameGiftGrant(serverInstanceId: string, request: GameGiftGrantRequest): Promise<GameGiftGrantResponse> {
+    return this.request<GameGiftGrantResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gift-grants`, { method: "POST", body: request });
+  }
+
+  async approveGameGiftGrant(serverInstanceId: string, grantId: string): Promise<GameGiftGrantResponse> {
+    return this.request<GameGiftGrantResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/game-gift-grants/${encodeURIComponent(grantId)}/approve`, { method: "POST", body: {} });
+  }
+
   async listSCUMOperations(serverInstanceId: string): Promise<SCUMOperationListResponse> {
     return this.request<SCUMOperationListResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/scum/operations`);
   }

platform_web/api/types.ts

@@ -388,9 +388,12 @@ export interface GamePluginResponse {
   validationViolations?: string[];
   runtimeProfiles?: GamePluginRuntimeProfilesResponse;
   gameClientBridge?: GameClientBridgeManifestResponse;
+  mapTrajectories?: GameMapGeometryResponse;
   status: GamePluginStatus;
 }
 
+export interface GameMapGeometryResponse { mapId: string; mapVersion: string; worldMinX: number; worldMinY: number; worldMaxX: number; worldMaxY: number; imageWidth: number; imageHeight: number; precision: number; sampleDistance: number; sampleIntervalSeconds: number; retentionSeconds: number; }
+
 export type PluginCreateFieldType = "text" | "number" | "boolean" | "select" | "port";
 
 export interface PluginCreateFieldResponse {
@@ -1386,6 +1389,15 @@ export type SCUMSquadsListResponse = SCUMListResponse<SCUMSquadRecord>;
 export type SCUMActivityListResponse = SCUMListResponse<SCUMActivityEventRecord>;
 export type SCUMGiftsListResponse = SCUMListResponse<SCUMGiftRecord>;
 export type SCUMMapPointsListResponse = SCUMListResponse<SCUMMapPointRecord>;
+export interface GameGiftItemResponse { catalogItemKey: string; label: string; quantity: number; }
+export interface GameGiftCatalogResponse { id: string; name: string; gameVersion: string; draftItems: GameGiftItemResponse[]; latestRevisionId?: string; updatedAt: string; }
+export interface GameGiftCatalogListResponse { items: GameGiftCatalogResponse[]; }
+export interface GameGiftRevisionResponse { id: string; catalogId: string; revision: number; gameVersion: string; items: GameGiftItemResponse[]; publishedBy: string; publishedAt: string; }
+export interface GameGiftRevisionListResponse { items: GameGiftRevisionResponse[]; }
+export interface GameGiftGrantResponse { id: string; revisionId: string; revisionNumber: number; gameVersion: string; items: GameGiftItemResponse[]; gamePlayerRecordId: string; playerDisplayName: string; notice: string; requesterId: string; approverId?: string; status: string; deliverySummary?: string; notificationSummary?: string; createdAt: string; approvedAt?: string; completedAt?: string; }
+export interface GameGiftGrantListResponse { items: GameGiftGrantResponse[]; }
+export interface GameGiftCatalogRequest { id?: string; name: string; gameVersion: string; items: Array<{ catalogItemKey: string; quantity: number }>; }
+export interface GameGiftGrantRequest { revisionId: string; gamePlayerRecordId: string; notice: string; idempotencyKey: string; }
 export interface SCUMWorkflowCreateRequest { templateKey: string; idempotencyKey: string; input?: SCUMJsonRecord; }
 export interface SCUMOperationRequest { templateKey: string; playerId?: string; payload?: SCUMJsonRecord; guard?: SCUMJsonRecord; reason: string; idempotencyKey: string; }
 export interface SCUMWorkflowResponse { id: string; serverInstanceId: string; pluginId: string; templateKey: string; requestedBy?: string; idempotencyKey?: string; status: string; currentStepKey?: string; input?: SCUMJsonRecord; safeSummary?: SCUMJsonRecord; blockerReason?: string; auditReferences?: string[]; createdAt: string; updatedAt: string; completedAt?: string; }