@playcademy/sdk 0.16.1-beta.11 → 0.16.1-beta.12

package/dist/index.d.ts

@@ -1911,6 +1911,15 @@ type EmbedActivity = EmbedActivityCompleted | EmbedActivityAbandoned | EmbedActi
 /** The child called `endActivity()` and its report was relayed. */
 interface EmbedActivityCompleted {
     status: 'completed';
+    /**
+     * The platform run this completion records under. One run ends in at
+     * most one completion (the server dedupes on it), and a resumed launch
+     * keeps the interrupted run's id — so this doubles as the completion's
+     * attempt identity: feed it to whatever consumes the result and drop
+     * anything you have seen before. Absent only for pure UX embeds
+     * (launched without `timeback`), which record nothing.
+     */
+    runId?: string;
     /** Correct answers, from the child's report. */
     correct: number;
     /** Total questions, from the child's report. */
@@ -1939,6 +1948,12 @@ interface EmbedActivityCompleted {
  */
 interface EmbedActivityAbandoned {
     status: 'abandoned';
+    /**
+     * The platform run the launch was recording under, when one had
+     * opened. Absent when the child never started an activity or the
+     * launch was a pure UX embed.
+     */
+    runId?: string;
     timing: EmbedSessionTiming;
     /**
      * The final resume envelope, when the child checkpointed during the
@@ -1960,6 +1975,13 @@ interface EmbedActivityFailed {
 interface EmbedSession {
     /** The mounted child iframe. Useful for focus management. */
     readonly iframe: HTMLIFrameElement;
+    /**
+     * The platform run this launch records under, or null before the run
+     * opens (the child's first activity) and for pure UX embeds. Stable
+     * once set; also echoed on the finished record, which is where most
+     * callers should read it.
+     */
+    readonly runId: string | null;
     /**
      * The latest resume envelope, live during play; null until the child
      * first checkpoints. Read it on your own cadence to persist

package/dist/index.js

@@ -1119,6 +1119,9 @@ class ChildSession {
     this.#abandon();
     this.#teardown();
   }
+  get runId() {
+    return this.#parentRunId;
+  }
   get checkpoint() {
     if (!this.#hasCheckpoint) {
       return null;
@@ -1227,6 +1230,9 @@ class ChildSession {
       status: "abandoned",
       timing: this.#relayedTiming()
     };
+    if (this.#parentRunId) {
+      activity.runId = this.#parentRunId;
+    }
     const resume = this.checkpoint;
     if (resume) {
       activity.resume = resume;
@@ -1251,9 +1257,11 @@ class ChildSession {
     }
     this.#settled = true;
     this.#clearResume();
+    this.#ensureBridgeRun();
     let endMemo = null;
     this.#resolveFinished({
       status: "completed",
+      runId: this.#parentRunId ?? undefined,
       correct: childReport.scoreData.correctQuestions,
       total: childReport.scoreData.totalQuestions,
       timing: this.#completedTiming(childReport),
@@ -3476,7 +3484,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.11";
+var SDK_VERSION = "0.16.1-beta.12";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -2977,6 +2977,15 @@ type EmbedActivity = EmbedActivityCompleted | EmbedActivityAbandoned | EmbedActi
 /** The child called `endActivity()` and its report was relayed. */
 interface EmbedActivityCompleted {
     status: 'completed';
+    /**
+     * The platform run this completion records under. One run ends in at
+     * most one completion (the server dedupes on it), and a resumed launch
+     * keeps the interrupted run's id — so this doubles as the completion's
+     * attempt identity: feed it to whatever consumes the result and drop
+     * anything you have seen before. Absent only for pure UX embeds
+     * (launched without `timeback`), which record nothing.
+     */
+    runId?: string;
     /** Correct answers, from the child's report. */
     correct: number;
     /** Total questions, from the child's report. */
@@ -3005,6 +3014,12 @@ interface EmbedActivityCompleted {
  */
 interface EmbedActivityAbandoned {
     status: 'abandoned';
+    /**
+     * The platform run the launch was recording under, when one had
+     * opened. Absent when the child never started an activity or the
+     * launch was a pure UX embed.
+     */
+    runId?: string;
     timing: EmbedSessionTiming;
     /**
      * The final resume envelope, when the child checkpointed during the
@@ -3026,6 +3041,13 @@ interface EmbedActivityFailed {
 interface EmbedSession {
     /** The mounted child iframe. Useful for focus management. */
     readonly iframe: HTMLIFrameElement;
+    /**
+     * The platform run this launch records under, or null before the run
+     * opens (the child's first activity) and for pure UX embeds. Stable
+     * once set; also echoed on the finished record, which is where most
+     * callers should read it.
+     */
+    readonly runId: string | null;
     /**
      * The latest resume envelope, live during play; null until the child
      * first checkpoints. Read it on your own cadence to persist

package/dist/internal.js

@@ -1119,6 +1119,9 @@ class ChildSession {
     this.#abandon();
     this.#teardown();
   }
+  get runId() {
+    return this.#parentRunId;
+  }
   get checkpoint() {
     if (!this.#hasCheckpoint) {
       return null;
@@ -1227,6 +1230,9 @@ class ChildSession {
       status: "abandoned",
       timing: this.#relayedTiming()
     };
+    if (this.#parentRunId) {
+      activity.runId = this.#parentRunId;
+    }
     const resume = this.checkpoint;
     if (resume) {
       activity.resume = resume;
@@ -1251,9 +1257,11 @@ class ChildSession {
     }
     this.#settled = true;
     this.#clearResume();
+    this.#ensureBridgeRun();
     let endMemo = null;
     this.#resolveFinished({
       status: "completed",
+      runId: this.#parentRunId ?? undefined,
       correct: childReport.scoreData.correctQuestions,
       total: childReport.scoreData.totalQuestions,
       timing: this.#completedTiming(childReport),
@@ -4352,7 +4360,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.11";
+var SDK_VERSION = "0.16.1-beta.12";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.js

@@ -313,7 +313,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.11";
+var SDK_VERSION = "0.16.1-beta.12";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -502,7 +502,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.11";
+var SDK_VERSION = "0.16.1-beta.12";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -2340,6 +2340,15 @@ type EmbedActivity = EmbedActivityCompleted | EmbedActivityAbandoned | EmbedActi
 /** The child called `endActivity()` and its report was relayed. */
 interface EmbedActivityCompleted {
     status: 'completed';
+    /**
+     * The platform run this completion records under. One run ends in at
+     * most one completion (the server dedupes on it), and a resumed launch
+     * keeps the interrupted run's id — so this doubles as the completion's
+     * attempt identity: feed it to whatever consumes the result and drop
+     * anything you have seen before. Absent only for pure UX embeds
+     * (launched without `timeback`), which record nothing.
+     */
+    runId?: string;
     /** Correct answers, from the child's report. */
     correct: number;
     /** Total questions, from the child's report. */
@@ -2368,6 +2377,12 @@ interface EmbedActivityCompleted {
  */
 interface EmbedActivityAbandoned {
     status: 'abandoned';
+    /**
+     * The platform run the launch was recording under, when one had
+     * opened. Absent when the child never started an activity or the
+     * launch was a pure UX embed.
+     */
+    runId?: string;
     timing: EmbedSessionTiming;
     /**
      * The final resume envelope, when the child checkpointed during the
@@ -2389,6 +2404,13 @@ interface EmbedActivityFailed {
 interface EmbedSession {
     /** The mounted child iframe. Useful for focus management. */
     readonly iframe: HTMLIFrameElement;
+    /**
+     * The platform run this launch records under, or null before the run
+     * opens (the child's first activity) and for pure UX embeds. Stable
+     * once set; also echoed on the finished record, which is where most
+     * callers should read it.
+     */
+    readonly runId: string | null;
     /**
      * The latest resume envelope, live during play; null until the child
      * first checkpoints. Read it on your own cadence to persist

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.16.1-beta.11",
+    "version": "0.16.1-beta.12",
     "type": "module",
     "exports": {
         ".": {