@playcademy/sdk 0.23.0 → 0.24.0

package/README.md

@@ -22,7 +22,6 @@ The SDK is the interface between your game and the Playcademy platform. It provi
 | `@playcademy/sdk/internal` | Platform SDK — used by CLI, admin tools, and platform internals                          |
 | `@playcademy/sdk/server`   | Server SDK — used by game backends (token verification, server-side activity submission) |
 | `@playcademy/sdk/types`    | Type-only imports                                                                        |
-| `@playcademy/sdk/test`     | Test utilities                                                                           |
 
 ## Installation
 

package/dist/index.js

@@ -798,6 +798,9 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   users: ["read:self", "write:self"],
   dev: ["read", "write"]
 };
+// ../constants/src/embed.ts
+var EMBED_PASS_TTL_MS = 60 * 1000;
+var EMBED_LAUNCH_TTL_MS = 12 * 60 * 60 * 1000;
 // ../constants/src/platform.ts
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
@@ -3762,7 +3765,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.23.0";
+var SDK_VERSION = "0.24.0";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -3116,6 +3116,41 @@ interface AssessmentAssetUploadResponse {
     height: number;
 }
 
+/** A game token for a launch. `POST /api/embed/launches/:launchId/token`. */
+interface EmbedGameToken {
+    token: string
+    /** Expiry in milliseconds since epoch. */
+    exp: number
+    /** The Hub's public tunnel URL, in local development only. */
+    baseUrl?: string
+}
+
+/**
+ * Embed Types
+ *
+ * What the Hub's embed page receives from the Hub. The shapes a partner's
+ * server sends and receives live in `@playcademy/embed-sdk`.
+ *
+ * @module types/embed
+ */
+
+/**
+ * What a redeemed pass hands the embed page: the launch, its first game
+ * token, and the student's context. Later tokens come through the partner.
+ * `POST /api/embed/launches/redeem`.
+ *
+ * @typeParam TGame - The game record (the Hub's `FetchedGame`).
+ */
+interface EmbedRedeemResponse<TGame = unknown> {
+    launchId: string;
+    token: EmbedGameToken;
+    userId: string;
+    game: TGame;
+    timebackCourseId: string | null;
+    localDay: LocalDayContext;
+    timeback?: UserTimebackData;
+}
+
 /**
  * Base error class for Cademy SDK specific errors.
  */
@@ -6999,6 +7034,16 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             };
         };
     };
+    /**
+     * The Hub embed page's calls for a game a partner site launched.
+     * - `redeem({ pass, parentOrigin })` - Trade the one-time pass for the launch and its first token
+     */
+    embedLaunches: {
+        redeem: (input: {
+            pass: string;
+            parentOrigin: string;
+        }) => Promise<EmbedRedeemResponse<FetchedGame>>;
+    };
     /**
      * Game directory and game tokens.
      * - `list()` - Get all games

package/dist/internal.js

@@ -798,6 +798,9 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   users: ["read:self", "write:self"],
   dev: ["read", "write"]
 };
+// ../constants/src/embed.ts
+var EMBED_PASS_TTL_MS = 60 * 1000;
+var EMBED_LAUNCH_TTL_MS = 12 * 60 * 60 * 1000;
 // ../constants/src/platform.ts
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
@@ -4052,6 +4055,14 @@ function createDevNamespace(client) {
     }
   };
 }
+// src/namespaces/platform/embed-launches.ts
+function createEmbedLaunchesNamespace(client) {
+  return {
+    redeem: (input) => client["request"]("/embed/launches/redeem", "POST", {
+      body: input
+    })
+  };
+}
 // src/namespaces/platform/games.ts
 function createGamesNamespace(client) {
   const gamesListCache = createTTLCache({
@@ -4672,7 +4683,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.23.0";
+var SDK_VERSION = "0.24.0";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {
@@ -4858,6 +4869,7 @@ class PlaycademyInternalClient extends PlaycademyBaseClient {
   auth = createAuthNamespace(this);
   admin = createAdminNamespace(this);
   dev = createDevNamespace(this);
+  embedLaunches = createEmbedLaunchesNamespace(this);
   games = createGamesNamespace(this);
   leaderboard = createLeaderboardNamespace(this);
   releases = createReleasesNamespace(this);

package/dist/server/edge.js

@@ -4,6 +4,9 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   users: ["read:self", "write:self"],
   dev: ["read", "write"]
 };
+// ../constants/src/embed.ts
+var EMBED_PASS_TTL_MS = 60 * 1000;
+var EMBED_LAUNCH_TTL_MS = 12 * 60 * 60 * 1000;
 // ../constants/src/platform.ts
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
@@ -358,7 +361,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.23.0";
+var SDK_VERSION = "0.24.0";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -200,6 +200,9 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   users: ["read:self", "write:self"],
   dev: ["read", "write"]
 };
+// ../constants/src/embed.ts
+var EMBED_PASS_TTL_MS = 60 * 1000;
+var EMBED_LAUNCH_TTL_MS = 12 * 60 * 60 * 1000;
 // ../constants/src/platform.ts
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
@@ -554,7 +557,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.23.0";
+var SDK_VERSION = "0.24.0";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.23.0",
+    "version": "0.24.0",
     "type": "module",
     "exports": {
         ".": {