@playcademy/sdk 0.0.1-beta.18 → 0.0.1-beta.19

package/dist/index.js

@@ -106,7 +106,11 @@ function createAuthNamespace(client) {
 // src/messaging.ts
 class PlaycademyMessaging {
   listeners = new Map;
-  send(type, payload) {
+  send(type, payload, options) {
+    if (options?.target) {
+      this.sendViaPostMessage(type, payload, options.target, options.origin || "*");
+      return;
+    }
     const context = this.getMessagingContext(type);
     if (context.shouldUsePostMessage) {
       this.sendViaPostMessage(type, payload, context.target, context.origin);

package/dist/messaging.d.ts

@@ -198,12 +198,13 @@ declare class PlaycademyMessaging {
      * This is the main public API for sending messages in the Playcademy system.
      *
      * **How It Works**:
-     * 1. Analyzes the message type and current runtime context
-     * 2. Determines if we're in an iframe and if this message should use postMessage
-     * 3. Routes to the appropriate transport method (postMessage or CustomEvent)
+     * 1. If options.target is provided, always use postMessage to that target
+     * 2. Otherwise, analyzes the message type and current runtime context
+     * 3. Determines if we're in an iframe and if this message should use postMessage
+     * 4. Routes to the appropriate transport method (postMessage or CustomEvent)
      *
      * **Transport Selection Logic**:
-     * - **postMessage**: Used when game is in iframe and sending to parent
+     * - **postMessage**: Used when target is specified OR when game is in iframe sending to parent
      * - **CustomEvent**: Used for local/same-context communication
      *
      * **Type Safety**:
@@ -213,20 +214,27 @@ declare class PlaycademyMessaging {
      * @template K - The message event type (ensures type safety)
      * @param type - The message event type to send
      * @param payload - The data to send with the message (type-checked)
+     * @param options - Optional configuration for target window and origin
      *
      * @example
      * ```typescript
-     * // Send game ready signal (no payload)
+     * // Send game ready signal (auto-detected transport)
      * messaging.send(MessageEvents.READY, undefined)
      *
-     * // Send telemetry data (typed payload)
-     * messaging.send(MessageEvents.TELEMETRY, { fps: 60, mem: 128 })
+     * // Send to specific iframe (parent → game)
+     * messaging.send(MessageEvents.INIT, { baseUrl, token, gameId }, {
+     *   target: iframe.contentWindow,
+     *   origin: 'https://game.example.com'
+     * })
      *
-     * // TypeScript will error if payload type is wrong
-     * messaging.send(MessageEvents.INIT, "wrong type") // ❌ Error
+     * // Send telemetry data (auto-detected transport)
+     * messaging.send(MessageEvents.TELEMETRY, { fps: 60, mem: 128 })
      * ```
      */
-    send<K extends MessageEvents>(type: K, payload: MessageEventMap[K]): void;
+    send<K extends MessageEvents>(type: K, payload: MessageEventMap[K], options?: {
+        target?: Window;
+        origin?: string;
+    }): void;
     /**
      * **Listen for Messages Method**
      *
@@ -325,6 +333,12 @@ declare class PlaycademyMessaging {
      * - **Game → Parent**: READY, EXIT, TELEMETRY (use postMessage when in iframe)
      * - **Parent → Game**: INIT, TOKEN_REFRESH, PAUSE, etc. (use CustomEvent in local dev)
      *
+     * **Cross-Context Communication**:
+     * This messaging system now handles ALL communication patterns:
+     * - Game → Parent: Automatic detection and postMessage
+     * - Parent → Game: Use options.target to specify the iframe window
+     * - Local development: Automatic CustomEvent fallback
+     *
      * **Transport Selection Logic**:
      * - **postMessage**: Used when game is in iframe AND sending to parent
      * - **CustomEvent**: Used for all other cases (local development, parent-to-game)

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@playcademy/sdk",
     "type": "module",
-    "version": "0.0.1-beta.18",
+    "version": "0.0.1-beta.19",
     "exports": {
         ".": {
             "import": "./dist/index.js",