@indiegems/gem-web-sdk 11.0.0 → 11.1.1

package/CHANGELOG.md

@@ -16,6 +16,21 @@ Its entries are grouped under up to five headings:
 - **Rebuild**: a type changed. Recompile against the new version; code that compiles today keeps compiling unless the entry says otherwise.
 - **New capability**: something a game can now do. Nothing changes unless you use it.
 
+## 11.1.1
+
+Upgrading from 11.1.0. Impact: none.
+
+Nothing in this release asks anything of a game.
+
+## 11.1.0
+
+Upgrading from 11.0.0. Impact: none.
+
+### New capability
+
+- Quick join options now accept templateSlugs, a list of one to eight templates. Open rooms of every listed template are candidates together, and if a room has to be created it is made from the first template in the list. Do not pass the list together with a single template, and do not pass an empty list or more than eight, because those calls are refused locally. When a local tool hosts your game's server, only the first template is sent and the room is always created from it. Games that pass a single template keep working unchanged.
+- A room now reports which template it was made from through Room.templateSlug. Use it to tell which mode a player landed in, especially when you offer several templates at once.
+
 ## 11.0.0
 
 Upgrading from 10.4.0. Impact: required.

package/dist/game.d.ts

@@ -175,6 +175,9 @@ type CountSpec = {
         "min": number;
     };
 };
+type DefaultTask = {
+    "template": string;
+};
 type EntityType = "player" | "character";
 type EntriesPerEntity = "all" | "best";
 type EventSource = "client" | "server";
@@ -275,8 +278,11 @@ type PlatformPrice = {
 };
 type PrerequisiteType = "owns_item" | "progression_complete" | "min_progression_value" | "progression_level";
 type ProgressionConfig = {
+    "assignment"?: TaskAssignment;
     "client_writable"?: boolean;
     "completion_threshold"?: number | null;
+    "completion_threshold_range"?: null | ThresholdRange;
+    "default_task"?: null | DefaultTask;
     "function_may_grant"?: boolean;
     "label"?: string | null;
     "max_completions"?: number | null;
@@ -284,6 +290,7 @@ type ProgressionConfig = {
     "platform_grants"?: PlatformGrant[];
     "reset_schedule"?: null | ResetSchedule;
     "rewards_on_complete"?: RecipeOperation[];
+    "templates"?: TemplateDefinition[];
     "tracks"?: TrackDefinition[];
 };
 type RecipeOperation = {
@@ -532,6 +539,7 @@ type SnapshotProgression = {
     "progression_type": string;
     "slug"?: string | null;
     "sort_order": number;
+    "template_hashes"?: Record<string, unknown>;
 };
 type SnapshotRecipe = {
     "availability_end"?: string | null;
@@ -585,6 +593,18 @@ type SnapshotRunType = {
     "properties_schema"?: Record<string, unknown>;
 };
 type SortDirection = "asc" | "desc";
+type TaskAssignment = "none" | "per_period" | "per_player";
+type TemplateDefinition = {
+    "description"?: string | null;
+    "display_name": string;
+    "key": string;
+    "localized"?: Record<string, unknown>;
+    "params"?: Record<string, unknown>;
+};
+type ThresholdRange = {
+    "max": number;
+    "min": number;
+};
 type TrackDefinition = {
     "levels": LevelDefinition[];
     "requires_item_id"?: string | null;
@@ -1724,6 +1744,7 @@ interface Room {
     readonly matchId?: string;
     readonly version: number;
     readonly templateId?: string;
+    readonly templateSlug?: string;
     readonly roomType: string;
     readonly transports?: readonly TransportKind[];
     readonly createdAt: number;
@@ -1809,6 +1830,7 @@ interface JoinRoomOptions {
 }
 interface QuickJoinOptions extends JoinRoomOptions {
     readonly templateSlug?: string;
+    readonly templateSlugs?: readonly string[];
     readonly templateId?: string;
     readonly region?: string;
     readonly name?: string;