@powly/sdk 0.8.0 → 0.9.0

package/README.md

@@ -31,7 +31,7 @@ await powly.leaderboards.submit("high-score", 1200);
 Without a bundler, load the classic script instead; it defines `window.Powly`:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@powly/sdk@0.8.0/dist/powly.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@powly/sdk@0.9.0/dist/powly.js"></script>
 ```
 
 ## Testing
@@ -58,7 +58,7 @@ your backend verifies session tokens or exchanges them for an access token.
 ## This repository
 
 The SDK is developed in Powly's main repository and mirrored here with each release; this is
-`@powly/sdk` 0.8.0. Issues are welcome; changes land through the main repository.
+`@powly/sdk` 0.9.0. Issues are welcome; changes land through the main repository.
 
 To build it yourself (Node.js 24 or newer):
 

package/dist/powly.d.ts

@@ -1,6 +1,6 @@
-/* Powly SDK 0.8.0: types for powly.js and powly.mjs */
+/* Powly SDK 0.9.0: types for powly.js and powly.mjs */
 /** This SDK's version; Powly's Studio shows it next to the downloads. */
-export declare const SDK_VERSION = "0.8.0";
+export declare const SDK_VERSION = "0.9.0";
 
 export declare const PROTOCOL = "powly-sdk";
 export declare const PROTOCOL_VERSION = 1;
@@ -102,7 +102,7 @@ export type FailedMessage = {
     error: string;
 };
 /** What a game may ask the Powly page for. */
-export declare const HOST_METHODS: readonly ["getSessionToken", "purchases.open", "fullscreen.toggle", "invites.open", "players.open", "twitch.connect", "audio.set", "audio.channels", "quit"];
+export declare const HOST_METHODS: readonly ["getSessionToken", "purchases.open", "fullscreen.toggle", "invites.open", "players.open", "twitch.connect", "audio.set", "audio.channels", "audio.open", "quit"];
 export type HostMethod = (typeof HOST_METHODS)[number];
 /** "players.open": what Powly's player dialog opens on. */
 export declare const PLAYER_VIEWS: readonly ["profile", "report"];
@@ -645,6 +645,11 @@ export type AudioApi = {
      * channels are ignored.
      */
     set(changes: AudioChanges): Promise<void>;
+    /**
+     * Opens Powly's sound menu over the game (in its options bar), e.g. from a Sound button in
+     * the game's own menu. Resolves when the player closes it; "change" tells what they set.
+     */
+    open(): Promise<void>;
     /** The settings changed (in Powly's sound menu, or with `set`). */
     on(event: "change", listener: (audio: AudioState) => void): () => void;
 };

package/dist/powly.js

@@ -1,8 +1,8 @@
-/* Powly SDK 0.8.0: defines window.Powly */
+/* Powly SDK 0.9.0: defines window.Powly */
 (function () {
 "use strict";
 /** This SDK's version; Powly's Studio shows it next to the downloads. */
-const SDK_VERSION = "0.8.0";
+const SDK_VERSION = "0.9.0";
 
 // The messages between a game (this SDK, inside Powly's iframe) and the Powly page that framed it.
 // Shared with the host side (apps/web/components/player/sdk-host.ts).
@@ -61,6 +61,7 @@ const HOST_METHODS = [
     "twitch.connect",
     "audio.set",
     "audio.channels",
+    "audio.open",
     "quit",
 ];
 /** "players.open": what Powly's player dialog opens on. */
@@ -1668,6 +1669,9 @@ function createSession(port, ready, sound) {
                 const result = await call("audio.set", { audio: changes });
                 setAudio(audioStateOf(result, channels));
             },
+            async open() {
+                await call("audio.open");
+            },
             on(_event, listener) {
                 audioListeners.add(listener);
                 return () => audioListeners.delete(listener);

package/dist/powly.mjs

@@ -1,6 +1,6 @@
-/* Powly SDK 0.8.0: ES module */
+/* Powly SDK 0.9.0: ES module */
 /** This SDK's version; Powly's Studio shows it next to the downloads. */
-const SDK_VERSION = "0.8.0";
+const SDK_VERSION = "0.9.0";
 
 // The messages between a game (this SDK, inside Powly's iframe) and the Powly page that framed it.
 // Shared with the host side (apps/web/components/player/sdk-host.ts).
@@ -59,6 +59,7 @@ const HOST_METHODS = [
     "twitch.connect",
     "audio.set",
     "audio.channels",
+    "audio.open",
     "quit",
 ];
 /** "players.open": what Powly's player dialog opens on. */
@@ -1666,6 +1667,9 @@ function createSession(port, ready, sound) {
                 const result = await call("audio.set", { audio: changes });
                 setAudio(audioStateOf(result, channels));
             },
+            async open() {
+                await call("audio.open");
+            },
             on(_event, listener) {
                 audioListeners.add(listener);
                 return () => audioListeners.delete(listener);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powly/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Powly game SDK: launch handshake, session tokens and platform services.",
   "license": "MIT",