@playcademy/sdk 0.14.1-beta.2 → 0.15.1-beta.1

package/dist/index.d.ts

@@ -171,6 +171,7 @@ declare function parseOAuthState(state: string): {
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 interface RetryPolicy {
     retryableMethods?: readonly Method[];
+    retryDelaysMs?: readonly number[];
 }
 
 /**
@@ -1149,6 +1150,12 @@ interface StartActivityOptions {
      * Must be a UUID (the backend validates it as such) and unique per
      * logical run. If omitted, the SDK generates a new UUID on each call,
      * which means every session is treated as its own run.
+     *
+     * The platform records at most one completion per activity per run:
+     * after `endActivity` succeeds for an activity under a given `runId`,
+     * any further `endActivity` for that same activity and `runId` is
+     * skipped as a duplicate (`blockedByDedupeGuard`, zero XP awarded).
+     * Start a new run (new `runId`) for a genuine retake.
      */
     runId?: string;
 }

package/dist/index.js

@@ -1248,6 +1248,10 @@ var DEFAULT_HEARTBEAT_INTERVAL_MS = 15000;
 var DEFAULT_INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var RELAY_INTERVAL_MS = 1000;
 var HEARTBEAT_RETRY_POLICY = { retryableMethods: ["POST"] };
+var END_ACTIVITY_RETRY_POLICY = {
+  retryableMethods: ["POST"],
+  retryDelaysMs: [500, 1500, 5000, 1e4, 20000]
+};
 var USER_ACTIVITY_EVENTS = ["keydown", "pointerdown", "pointermove", "wheel"];
 var USER_ACTIVITY_LISTENER_OPTIONS = { capture: true };
 function normalizeDelayMs(value, defaultValue, allowZero = true) {
@@ -1799,7 +1803,7 @@ function createTimebackActivityTracker(client) {
         extensions: data.extensions
       };
       try {
-        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.END_ACTIVITY, "POST", request);
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.END_ACTIVITY, "POST", request, undefined, { retryPolicy: END_ACTIVITY_RETRY_POLICY });
         if (currentActivity === activity) {
           currentActivity = null;
         }
@@ -2256,8 +2260,9 @@ function isRetryableStatus(status) {
 }
 async function fetchWithRetry(url, init2) {
   const startedAt = Date.now();
-  for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
-    const retryDelayMs = RETRY_DELAYS_MS[attempt];
+  const retryDelaysMs = init2.retryPolicy?.retryDelaysMs ?? RETRY_DELAYS_MS;
+  for (let attempt = 0;attempt <= retryDelaysMs.length; attempt++) {
+    const retryDelayMs = retryDelaysMs[attempt];
     const retryableMethods = init2.retryPolicy?.retryableMethods ?? ["GET"];
     const canRetry = retryDelayMs !== undefined && retryableMethods.includes(init2.method);
     try {
@@ -2277,7 +2282,7 @@ async function fetchWithRetry(url, init2) {
   }
   return {
     error: new PlaycademyError("Request failed after exhausting retries"),
-    retryCount: RETRY_DELAYS_MS.length,
+    retryCount: retryDelaysMs.length,
     durationMs: Date.now() - startedAt
   };
 }
@@ -2386,7 +2391,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.14.1-beta.2";
+var SDK_VERSION = "0.15.1-beta.1";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -14,6 +14,7 @@ import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 interface RetryPolicy {
     retryableMethods?: readonly Method[];
+    retryDelaysMs?: readonly number[];
 }
 
 /**
@@ -1917,6 +1918,12 @@ interface StartActivityOptions {
      * Must be a UUID (the backend validates it as such) and unique per
      * logical run. If omitted, the SDK generates a new UUID on each call,
      * which means every session is treated as its own run.
+     *
+     * The platform records at most one completion per activity per run:
+     * after `endActivity` succeeds for an activity under a given `runId`,
+     * any further `endActivity` for that same activity and `runId` is
+     * skipped as a duplicate (`blockedByDedupeGuard`, zero XP awarded).
+     * Start a new run (new `runId`) for a genuine retake.
      */
     runId?: string;
 }

package/dist/internal.js

@@ -1248,6 +1248,10 @@ var DEFAULT_HEARTBEAT_INTERVAL_MS = 15000;
 var DEFAULT_INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var RELAY_INTERVAL_MS = 1000;
 var HEARTBEAT_RETRY_POLICY = { retryableMethods: ["POST"] };
+var END_ACTIVITY_RETRY_POLICY = {
+  retryableMethods: ["POST"],
+  retryDelaysMs: [500, 1500, 5000, 1e4, 20000]
+};
 var USER_ACTIVITY_EVENTS = ["keydown", "pointerdown", "pointermove", "wheel"];
 var USER_ACTIVITY_LISTENER_OPTIONS = { capture: true };
 function normalizeDelayMs(value, defaultValue, allowZero = true) {
@@ -1799,7 +1803,7 @@ function createTimebackActivityTracker(client) {
         extensions: data.extensions
       };
       try {
-        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.END_ACTIVITY, "POST", request);
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.END_ACTIVITY, "POST", request, undefined, { retryPolicy: END_ACTIVITY_RETRY_POLICY });
         if (currentActivity === activity) {
           currentActivity = null;
         }
@@ -2959,8 +2963,9 @@ function isRetryableStatus(status) {
 }
 async function fetchWithRetry(url, init2) {
   const startedAt = Date.now();
-  for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
-    const retryDelayMs = RETRY_DELAYS_MS[attempt];
+  const retryDelaysMs = init2.retryPolicy?.retryDelaysMs ?? RETRY_DELAYS_MS;
+  for (let attempt = 0;attempt <= retryDelaysMs.length; attempt++) {
+    const retryDelayMs = retryDelaysMs[attempt];
     const retryableMethods = init2.retryPolicy?.retryableMethods ?? ["GET"];
     const canRetry = retryDelayMs !== undefined && retryableMethods.includes(init2.method);
     try {
@@ -2980,7 +2985,7 @@ async function fetchWithRetry(url, init2) {
   }
   return {
     error: new PlaycademyError("Request failed after exhausting retries"),
-    retryCount: RETRY_DELAYS_MS.length,
+    retryCount: retryDelaysMs.length,
     durationMs: Date.now() - startedAt
   };
 }
@@ -3089,7 +3094,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.14.1-beta.2";
+var SDK_VERSION = "0.15.1-beta.1";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.js

@@ -49,6 +49,7 @@ function createTimebackNamespace(client) {
       return client["request"]("/api/timeback/end-activity", "POST", {
         gameId: client.gameId,
         studentId,
+        ...payload.runId ? { runId: payload.runId } : {},
         activityData: enrichedActivityData,
         scoreData: payload.scoreData,
         timingData: payload.timingData,
@@ -233,7 +234,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.14.1-beta.2";
+var SDK_VERSION = "0.15.1-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -238,6 +238,7 @@ function createTimebackNamespace(client) {
       return client["request"]("/api/timeback/end-activity", "POST", {
         gameId: client.gameId,
         studentId,
+        ...payload.runId ? { runId: payload.runId } : {},
         activityData: enrichedActivityData,
         scoreData: payload.scoreData,
         timingData: payload.timingData,
@@ -422,7 +423,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.14.1-beta.2";
+var SDK_VERSION = "0.15.1-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -28,6 +28,7 @@ declare function parseOAuthState(state: string): {
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 interface RetryPolicy {
     retryableMethods?: readonly Method[];
+    retryDelaysMs?: readonly number[];
 }
 
 /**
@@ -1548,6 +1549,12 @@ interface StartActivityOptions {
      * Must be a UUID (the backend validates it as such) and unique per
      * logical run. If omitted, the SDK generates a new UUID on each call,
      * which means every session is treated as its own run.
+     *
+     * The platform records at most one completion per activity per run:
+     * after `endActivity` succeeds for an activity under a given `runId`,
+     * any further `endActivity` for that same activity and `runId` is
+     * skipped as a duplicate (`blockedByDedupeGuard`, zero XP awarded).
+     * Start a new run (new `runId`) for a genuine retake.
      */
     runId?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.14.1-beta.2",
+    "version": "0.15.1-beta.1",
     "type": "module",
     "exports": {
         ".": {