@ludeo/cloud-common 1.2.273 → 1.2.274

package/dist/v4/events/allocate-cloud-session-failed.d.ts

@@ -1,7 +1,18 @@
 import { CloudSessionContext } from "../contexts/cloud-session-context";
 import { LudeoEvent } from "../../infra/ludeo-event";
+export declare enum AllocateCloudSessionFailureCode {
+    NOT_AVAILABLE_ERROR = "NOT_AVAILABLE_ERROR",
+    QUEUE_TIMEOUT_ERROR = "QUEUE_TIMEOUT_ERROR",
+    NO_AVAILABLE_POOLS_REGION_ERROR = "NO_AVAILABLE_POOLS_REGION_ERROR",
+    NO_AVAILABLE_POOLS_HARDWARE_ERROR = "NO_AVAILABLE_POOLS_HARDWARE_ERROR",
+    INVALID_REQUEST_ERROR = "INVALID_REQUEST_ERROR",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR"
+}
 export declare class AllocateCloudSessionFailedPayload {
-    error: string;
+    code?: AllocateCloudSessionFailureCode;
+    description: string;
+    stack?: string;
+    isRetryable?: boolean;
 }
 export declare class AllocateCloudSessionFailed extends LudeoEvent {
     static readonly EVENT_NAME = "cloud-session-allocator.allocate-cloud-session-failed";

package/dist/v4/events/allocate-cloud-session-failed.js

@@ -9,18 +9,42 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AllocateCloudSessionFailed = exports.AllocateCloudSessionFailedPayload = void 0;
+exports.AllocateCloudSessionFailed = exports.AllocateCloudSessionFailedPayload = exports.AllocateCloudSessionFailureCode = void 0;
 const class_validator_1 = require("class-validator");
 const cloud_session_context_1 = require("../contexts/cloud-session-context");
 const validate_nested_type_decorator_1 = require("../../decorators/validate-nested-type.decorator");
 const ludeo_event_1 = require("../../infra/ludeo-event");
+var AllocateCloudSessionFailureCode;
+(function (AllocateCloudSessionFailureCode) {
+    AllocateCloudSessionFailureCode["NOT_AVAILABLE_ERROR"] = "NOT_AVAILABLE_ERROR";
+    AllocateCloudSessionFailureCode["QUEUE_TIMEOUT_ERROR"] = "QUEUE_TIMEOUT_ERROR";
+    AllocateCloudSessionFailureCode["NO_AVAILABLE_POOLS_REGION_ERROR"] = "NO_AVAILABLE_POOLS_REGION_ERROR";
+    AllocateCloudSessionFailureCode["NO_AVAILABLE_POOLS_HARDWARE_ERROR"] = "NO_AVAILABLE_POOLS_HARDWARE_ERROR";
+    AllocateCloudSessionFailureCode["INVALID_REQUEST_ERROR"] = "INVALID_REQUEST_ERROR";
+    AllocateCloudSessionFailureCode["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+})(AllocateCloudSessionFailureCode || (exports.AllocateCloudSessionFailureCode = AllocateCloudSessionFailureCode = {}));
 class AllocateCloudSessionFailedPayload {
 }
 exports.AllocateCloudSessionFailedPayload = AllocateCloudSessionFailedPayload;
 __decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AllocateCloudSessionFailureCode),
+    __metadata("design:type", String)
+], AllocateCloudSessionFailedPayload.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AllocateCloudSessionFailedPayload.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], AllocateCloudSessionFailedPayload.prototype, "error", void 0);
+], AllocateCloudSessionFailedPayload.prototype, "stack", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AllocateCloudSessionFailedPayload.prototype, "isRetryable", void 0);
 class AllocateCloudSessionFailed extends ludeo_event_1.LudeoEvent {
     constructor(payload, context) {
         super(AllocateCloudSessionFailed.EVENT_NAME);

package/dist/v4/events/allocate-cloud-session-failed.js.map

@@ -1 +1 @@
-{"version":3,"file":"allocate-cloud-session-failed.js","sourceRoot":"","sources":["../../../src/v4/events/allocate-cloud-session-failed.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA2C;AAC3C,6EAAwE;AACxE,oGAAqF;AACrF,yDAAqD;AAErD,MAAa,iCAAiC;CAG7C;AAHD,8EAGC;AADC;IADC,IAAA,0BAAQ,GAAE;;gEACG;AAEhB,MAAa,0BAA2B,SAAQ,wBAAU;IAIxD,YACE,OAA0C,EAC1C,OAA4B;QAE5B,KAAK,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;;AAXH,gEAkBC;AAjBiB,qCAAU,GACxB,uDAAuD,CAAC;AAY1D;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,iCAAiC,CAAC;8BACnD,iCAAiC;2DAAC;AAG3C;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;8BACrC,2CAAmB;2DAAC"}
+{"version":3,"file":"allocate-cloud-session-failed.js","sourceRoot":"","sources":["../../../src/v4/events/allocate-cloud-session-failed.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA0E;AAC1E,6EAAwE;AACxE,oGAAqF;AACrF,yDAAqD;AAErD,IAAY,+BAaX;AAbD,WAAY,+BAA+B;IAEzC,8EAA2C,CAAA;IAE3C,8EAA2C,CAAA;IAE3C,sGAAmE,CAAA;IAEnE,0GAAuE,CAAA;IAEvE,kFAA+C,CAAA;IAE/C,kFAA+C,CAAA;AACjD,CAAC,EAbW,+BAA+B,+CAA/B,+BAA+B,QAa1C;AAED,MAAa,iCAAiC;CAmB7C;AAnBD,8EAmBC;AAfC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,+BAA+B,CAAC;;+DACD;AAIvC;IADC,IAAA,0BAAQ,GAAE;;sEACS;AAKpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;gEACI;AAKf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;sEACU;AAExB,MAAa,0BAA2B,SAAQ,wBAAU;IAIxD,YACE,OAA0C,EAC1C,OAA4B;QAE5B,KAAK,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;;AAXH,gEAkBC;AAjBiB,qCAAU,GACxB,uDAAuD,CAAC;AAY1D;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,iCAAiC,CAAC;8BACnD,iCAAiC;2DAAC;AAG3C;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;8BACrC,2CAAmB;2DAAC"}

package/dist/v4/events/cloud-session-allocator/cloud-session-queued.d.ts

@@ -0,0 +1,13 @@
+import { LudeoEvent } from "../../../infra";
+import { CloudSessionContext } from "../../contexts";
+export declare class CloudSessionQueuedPayload {
+    cloudSessionId: string;
+    estimatedWaitTimeMs: number;
+    position: number;
+}
+export declare class CloudSessionQueued extends LudeoEvent {
+    static readonly EVENT_NAME = "cloud-session-allocator.cloud-session-queued";
+    constructor(payload: CloudSessionQueuedPayload, context: CloudSessionContext);
+    payload: CloudSessionQueuedPayload;
+    context: CloudSessionContext;
+}

package/dist/v4/events/cloud-session-allocator/cloud-session-queued.js

@@ -0,0 +1,49 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudSessionQueued = exports.CloudSessionQueuedPayload = void 0;
+const class_validator_1 = require("class-validator");
+const decorators_1 = require("../../../decorators");
+const infra_1 = require("../../../infra");
+const contexts_1 = require("../../contexts");
+class CloudSessionQueuedPayload {
+}
+exports.CloudSessionQueuedPayload = CloudSessionQueuedPayload;
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CloudSessionQueuedPayload.prototype, "cloudSessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CloudSessionQueuedPayload.prototype, "estimatedWaitTimeMs", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CloudSessionQueuedPayload.prototype, "position", void 0);
+class CloudSessionQueued extends infra_1.LudeoEvent {
+    constructor(payload, context) {
+        super(CloudSessionQueued.EVENT_NAME);
+        this.payload = payload;
+        this.context = context;
+    }
+}
+exports.CloudSessionQueued = CloudSessionQueued;
+CloudSessionQueued.EVENT_NAME = "cloud-session-allocator.cloud-session-queued";
+__decorate([
+    (0, decorators_1.ValidateNestedType)(() => CloudSessionQueuedPayload),
+    __metadata("design:type", CloudSessionQueuedPayload)
+], CloudSessionQueued.prototype, "payload", void 0);
+__decorate([
+    (0, decorators_1.ValidateNestedType)(() => contexts_1.CloudSessionContext),
+    __metadata("design:type", contexts_1.CloudSessionContext)
+], CloudSessionQueued.prototype, "context", void 0);
+//# sourceMappingURL=cloud-session-queued.js.map

package/dist/v4/events/cloud-session-allocator/cloud-session-queued.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-session-queued.js","sourceRoot":"","sources":["../../../../src/v4/events/cloud-session-allocator/cloud-session-queued.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAgD;AAEhD,oDAAyD;AACzD,0CAA4C;AAC5C,6CAAqD;AAIrD,MAAa,yBAAyB;CAYrC;AAZD,8DAYC;AATC;IADC,IAAA,wBAAM,GAAE;;iEACc;AAIvB;IADC,IAAA,uBAAK,GAAE;;sEACoB;AAI5B;IADC,IAAA,uBAAK,GAAE;;2DACS;AAGnB,MAAa,kBAAmB,SAAQ,kBAAU;IAGhD,YAAY,OAAkC,EAAE,OAA4B;QAC1E,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;;AAPH,gDAcC;AAbiB,6BAAU,GAAG,8CAA8C,CAAC;AAS5E;IADC,IAAA,+BAAkB,EAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC;8BAC3C,yBAAyB;mDAAC;AAGnC;IADC,IAAA,+BAAkB,EAAC,GAAG,EAAE,CAAC,8BAAmB,CAAC;8BACrC,8BAAmB;mDAAC"}

package/dist/v4/events/cloud-session-allocator/index.d.ts

@@ -1 +1,2 @@
 export * from "./allocate-cloud-session-requested";
+export * from "./cloud-session-queued";

package/dist/v4/events/cloud-session-allocator/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./allocate-cloud-session-requested"), exports);
+__exportStar(require("./cloud-session-queued"), exports);
 //# sourceMappingURL=index.js.map

package/dist/v4/events/cloud-session-allocator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v4/events/cloud-session-allocator/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v4/events/cloud-session-allocator/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD;AACnD,yDAAuC"}

package/dist/v4/events/ludeo-available.d.ts

@@ -2,6 +2,8 @@ import { LudeoEvent } from "../../infra/ludeo-event";
 import { CloudPoolContext } from "../contexts";
 export declare class LudeoAvailablePayload {
     ludeoPoolId: string;
+    gamePoolId: string;
+    ludeoId: string;
 }
 export declare class LudeoAvailable extends LudeoEvent {
     static readonly EVENT_NAME = "cloud-pools.ludeo-available";

package/dist/v4/events/ludeo-available.js

@@ -21,6 +21,14 @@ __decorate([
     (0, class_validator_1.IsUUID)(),
     __metadata("design:type", String)
 ], LudeoAvailablePayload.prototype, "ludeoPoolId", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], LudeoAvailablePayload.prototype, "gamePoolId", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], LudeoAvailablePayload.prototype, "ludeoId", void 0);
 class LudeoAvailable extends ludeo_event_1.LudeoEvent {
     constructor(payload, context) {
         super(LudeoAvailable.EVENT_NAME);

package/dist/v4/events/ludeo-available.js.map

@@ -1 +1 @@
-{"version":3,"file":"ludeo-available.js","sourceRoot":"","sources":["../../../src/v4/events/ludeo-available.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmD;AAEnD,oGAAqF;AACrF,yDAAqD;AACrD,0CAA+C;AAE/C,MAAa,qBAAqB;CAGjC;AAHD,sDAGC;AADC;IADC,IAAA,wBAAM,GAAE;;0DACW;AAGtB,MAAa,cAAe,SAAQ,wBAAU;IAG5C,YAAY,OAA8B,EAAE,OAAyB;QACnE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;;AAPH,wCAcC;AAbiB,yBAAU,GAAG,6BAA6B,CAAC;AAS3D;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,2BAAgB,CAAC;8BAClC,2BAAgB;+CAAC;AAG1B;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC;8BACvC,qBAAqB;+CAAC"}
+{"version":3,"file":"ludeo-available.js","sourceRoot":"","sources":["../../../src/v4/events/ludeo-available.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAyC;AAEzC,oGAAqF;AACrF,yDAAqD;AACrD,0CAA+C;AAE/C,MAAa,qBAAqB;CAWjC;AAXD,sDAWC;AATC;IADC,IAAA,wBAAM,GAAE;;0DACW;AAIpB;IADC,IAAA,wBAAM,GAAE;;yDACU;AAInB;IADC,IAAA,wBAAM,GAAE;;sDACO;AAGlB,MAAa,cAAe,SAAQ,wBAAU;IAG5C,YAAY,OAA8B,EAAE,OAAyB;QACnE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;;AAPH,wCAcC;AAbiB,yBAAU,GAAG,6BAA6B,CAAC;AAS3D;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,2BAAgB,CAAC;8BAClC,2BAAgB;+CAAC;AAG1B;IADC,IAAA,mDAAkB,EAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC;8BACvC,qBAAqB;+CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ludeo/cloud-common",
-  "version": "1.2.273",
+  "version": "1.2.274",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "Yahil Didi",

package/src/v4/events/allocate-cloud-session-failed.ts

@@ -1,11 +1,42 @@
-import { IsString } from "class-validator";
+import { IsBoolean, IsEnum, IsOptional, IsString } from "class-validator";
 import { CloudSessionContext } from "../contexts/cloud-session-context";
 import { ValidateNestedType } from "../../decorators/validate-nested-type.decorator";
 import { LudeoEvent } from "../../infra/ludeo-event";
 
+export enum AllocateCloudSessionFailureCode {
+  // No machines and autoscale is off — nothing can ever serve this request.
+  NOT_AVAILABLE_ERROR = "NOT_AVAILABLE_ERROR",
+  // Held in the queue past QUEUE_MAX_WAIT_MS.
+  QUEUE_TIMEOUT_ERROR = "QUEUE_TIMEOUT_ERROR",
+  // No eligible pools matched the requested region.
+  NO_AVAILABLE_POOLS_REGION_ERROR = "NO_AVAILABLE_POOLS_REGION_ERROR",
+  // No eligible pools matched the requested hardware.
+  NO_AVAILABLE_POOLS_HARDWARE_ERROR = "NO_AVAILABLE_POOLS_HARDWARE_ERROR",
+  // Bad request payload.
+  INVALID_REQUEST_ERROR = "INVALID_REQUEST_ERROR",
+  // Unexpected failure.
+  INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+}
+
 export class AllocateCloudSessionFailedPayload {
+  // Structured failure code (queue V2). Omitted on the legacy path.
+  @IsOptional()
+  @IsEnum(AllocateCloudSessionFailureCode)
+  code?: AllocateCloudSessionFailureCode;
+
+  // Human-readable failure message.
   @IsString()
-  error: string;
+  description: string;
+
+  // Optional error stack for debugging (not shown to the player).
+  @IsOptional()
+  @IsString()
+  stack?: string;
+
+  // Whether retrying could plausibly succeed. NOT_AVAILABLE/INVALID_REQUEST are false.
+  @IsOptional()
+  @IsBoolean()
+  isRetryable?: boolean;
 }
 export class AllocateCloudSessionFailed extends LudeoEvent {
   static readonly EVENT_NAME =

package/src/v4/events/cloud-session-allocator/cloud-session-queued.ts

@@ -0,0 +1,37 @@
+import { IsInt, IsUUID } from "class-validator";
+
+import { ValidateNestedType } from "../../../decorators";
+import { LudeoEvent } from "../../../infra";
+import { CloudSessionContext } from "../../contexts";
+
+// Emitted when a request enters the waiting queues (push once on enqueue). Tells the client
+// "you're in line" with the initial position + estimated wait; subsequent updates are polled.
+export class CloudSessionQueuedPayload {
+  // System-wide correlation id (also present on the context).
+  @IsUUID()
+  cloudSessionId: string;
+
+  // Best-effort estimated wait, in ms (min of the vacate vs new-machine paths).
+  @IsInt()
+  estimatedWaitTimeMs: number;
+
+  // peopleAhead — fewest waiters ahead across the request's eligible game-pool queues.
+  @IsInt()
+  position: number;
+}
+
+export class CloudSessionQueued extends LudeoEvent {
+  static readonly EVENT_NAME = "cloud-session-allocator.cloud-session-queued";
+
+  constructor(payload: CloudSessionQueuedPayload, context: CloudSessionContext) {
+    super(CloudSessionQueued.EVENT_NAME);
+    this.payload = payload;
+    this.context = context;
+  }
+
+  @ValidateNestedType(() => CloudSessionQueuedPayload)
+  payload: CloudSessionQueuedPayload;
+
+  @ValidateNestedType(() => CloudSessionContext)
+  context: CloudSessionContext;
+}

package/src/v4/events/cloud-session-allocator/index.ts

@@ -1 +1,2 @@
-export * from "./allocate-cloud-session-requested";
+export * from "./allocate-cloud-session-requested";
+export * from "./cloud-session-queued";

package/src/v4/events/ludeo-available.ts

@@ -1,4 +1,4 @@
-import { IsString, IsUUID } from "class-validator";
+import { IsUUID } from "class-validator";
 
 import { ValidateNestedType } from "../../decorators/validate-nested-type.decorator";
 import { LudeoEvent } from "../../infra/ludeo-event";
@@ -7,6 +7,14 @@ import { CloudPoolContext } from "../contexts";
 export class LudeoAvailablePayload {
   @IsUUID()
   ludeoPoolId: string;
+
+  // Parent game pool — the waiting queue this freed slot pops.
+  @IsUUID()
+  gamePoolId: string;
+
+  // The ludeo this freed slot is for.
+  @IsUUID()
+  ludeoId: string;
 }
 
 export class LudeoAvailable extends LudeoEvent {