@playcademy/sdk 0.18.1-beta.2 → 0.18.1-beta.4

package/README.md

@@ -151,6 +151,8 @@ if (attempt.flow !== 'platform-routed-item-submit' || !attempt.routing.next) {
 
 const current = attempt.routing.next
 const committed = await client.timeback.assessments.submitItem(attempt.attemptId, {
+    assessmentToken: attempt.assessmentToken,
+    transcript: attempt.transcript,
     expectedResponseVersion: attempt.responseVersion,
     submissionId: crypto.randomUUID(),
     routingNodeKey: current.nodeKey,
@@ -158,24 +160,28 @@ const committed = await client.timeback.assessments.submitItem(attempt.attemptId
     responses: { RESPONSE: 'A' },
 })
 
-// Repeat with committed.routing.next. When routing is ready, submit() only finalizes.
+// Retain committed.transcript and repeat with committed.routing.next.
+// When routing is ready, submit the complete transcript, then finalize the award.
 ```
 
 `start()` resumes a compatible unfinished attempt or selects content for a fixed test or standards
-review. Save payloads merge at both the item and response levels; omitted values remain unchanged,
-and `null` clears one response. Keep the returned `responseVersion` and send it with the next
-mutation.
+review. Keep the raw `transcript` in storage chosen by your game (renderer memory is sufficient for
+an uninterrupted attempt). The SDK does not automatically store active drafts locally.
+`resume(attemptId, { transcript })` validates a supplied draft; without one, resume uses the saved
+parent checkpoint, or best-effort child progress if no checkpoint exists. Start and resume also
+issue an attempt-scoped `assessmentToken` using the existing JWT infrastructure.
 
 The returned `flow` is authoritative and is derived from the selected assessment; callers do not configure
 navigation, feedback, and submission independently:
 
 - `attempt-submit` is used for end-of-course and mastery attempts. Responses remain editable
-  through `save()` until `submit()` finalizes the whole attempt and returns feedback.
+  in the game until `submit()` validates the complete transcript and returns feedback.
+  Mastery renderers may call `recordProgress()` without awaiting it on navigation to project the
+  current answer as best-effort child progress. It returns no grades and never writes the parent.
 - `item-submit` is used for review attempts. Submit each administered item with `submitItem()`.
-  That operation atomically saves the item's responses, locks them, and returns safe immediate
-  feedback. Give each item request its own stable `submissionId` and reuse that ID for an ambiguous
-  retry; the returned canonical `itemSubmissions` ledger identifies committed items after retry or
-  resume.
+  That operation grades the raw transcript without a parent read or enrollment lookup. Give each
+  administration a stable `submissionId`, retain the returned `transcript`, and reuse both on retry.
+  Child persistence is best-effort and does not block feedback.
 - `platform-routed-item-submit` is used for adaptive diagnostics. Render only
   `routing.next.itemIdentifier`, submit it with `routing.next.nodeKey`, and replace local state with
   the returned canonical routing snapshot. Each receipt includes the trusted item `score` and
@@ -184,9 +190,21 @@ navigation, feedback, and submission independently:
   `ready-to-complete`.
 
 The host rejects the wrong mutation for each flow, rejects premature finalization, and enforces
-`expectedResponseVersion` for every mutation. Hosted and local providers execute the same routing
+`expectedResponseVersion` as the supplied administration count (the prefix count for new item feedback).
+Hosted and local providers execute the same routing
 manifest contract; game code never selects the provider.
 
+Use `save(attemptId, { transcript, expectedResponseVersion })` only for an explicit checkpoint such
+as Save and exit, and await its acknowledgement. Success means the validated draft was saved on the
+existing parent without completing it; late or stale child writes cannot replace that checkpoint.
+Children remain replaceable, best-effort progress and never gate saving or completion. `submit()`
+regrades the full transcript and writes the authoritative score once without waiting for child repair.
+Without a game-supplied draft, a saved checkpoint still takes precedence over newer background
+progress. Background writes are not guaranteed to finish on tab close.
+The existing `awaiting_award` →
+`finalize()` lifecycle is unchanged. Retries must preserve the completion identity, transcript,
+and timing; the SDK keeps an in-flight completion request in memory until its outcome is known.
+
 For local development, import the current ordered catalog before starting the dev host:
 
 ```bash

package/dist/index.d.ts

@@ -1562,7 +1562,11 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
             stop: (attemptId: string) => Promise<{
                 attemptId: string;
             }>;
+            resume: (attemptId: string, input?: _playcademy_types.ResumeAssessmentInput) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
             save: (attemptId: string, input: _playcademy_types.SaveAssessmentInput) => Promise<_playcademy_types.AssessmentSaveResult>;
+            recordProgress: (attemptId: string, input: _playcademy_types.RecordAssessmentProgressInput) => Promise<{
+                attemptId: string;
+            }>;
             submitItem: (attemptId: string, input: _playcademy_types.SubmitAssessmentItemInput) => Promise<_playcademy_types.SubmitAssessmentItemResult>;
             submit: (attemptId: string, input: _playcademy_types.SubmitAssessmentInput) => Promise<_playcademy_types.AssessmentSubmitResult>;
             finalize: (attemptId: string, input: _playcademy_types.FinalizeAssessmentInput) => Promise<_playcademy_types.AssessmentFinalizeResult>;

package/dist/index.js

@@ -3122,7 +3122,7 @@ function createTimebackNamespace(client) {
     console.warn(`[Playcademy SDK] timeback.assessments: active-time tracking was not attached to assessment ${attemptId} (${reason}). ${remedy}`);
   }
   function releasePendingSubmission(attemptId, submissionId) {
-    if (pendingAssessmentSubmissions.get(attemptId)?.submissionId === submissionId) {
+    if (pendingAssessmentSubmissions.get(attemptId)?.request.submissionId === submissionId) {
       pendingAssessmentSubmissions.delete(attemptId);
     }
   }
@@ -3150,7 +3150,7 @@ function createTimebackNamespace(client) {
     return snapshot;
   }
   async function resumeAfterDefinitiveFailure(attemptId, submissionId) {
-    if (pendingAssessmentSubmissions.get(attemptId)?.submissionId !== submissionId) {
+    if (pendingAssessmentSubmissions.get(attemptId)?.request.submissionId !== submissionId) {
       return;
     }
     pendingAssessmentSubmissions.delete(attemptId);
@@ -3158,18 +3158,24 @@ function createTimebackNamespace(client) {
       await syncAssessmentTracking(await loadAttemptSnapshot(attemptId));
     } catch {}
   }
-  async function assessmentSubmissionContext(attemptId, submissionId) {
+  async function assessmentSubmissionContext(attemptId, input) {
+    const { submissionId } = input;
     const pending = pendingAssessmentSubmissions.get(attemptId);
     if (pending) {
-      if (pending.submissionId !== submissionId && !pending.detached) {
+      if (pending.request.submissionId !== submissionId && !pending.detached) {
         throw new Error(`Assessment ${attemptId} already has a pending submission. Retry with the original submissionId.`);
       }
       pending.detached = false;
       return {
-        submissionId: pending.submissionId,
+        request: pending.request,
         session: await pending.session
       };
     }
+    const request = {
+      submissionId,
+      expectedResponseVersion: input.expectedResponseVersion,
+      transcript: structuredClone(input.transcript)
+    };
     const session = engine.activity.finishAssessment(attemptId).then((finished) => finished ? {
       runId: finished.runId,
       resumeId: finished.resumeId,
@@ -3179,11 +3185,11 @@ function createTimebackNamespace(client) {
       throw error;
     });
     pendingAssessmentSubmissions.set(attemptId, {
-      submissionId,
+      request,
       session,
       detached: false
     });
-    return { submissionId, session: await session };
+    return { request, session: await session };
   }
   registerPauseProbe(client, () => engine.activity.isManuallyPaused());
   return {
@@ -3238,6 +3244,14 @@ function createTimebackNamespace(client) {
         clearAssessmentTrackingWarnings(attemptId);
         return { attemptId };
       },
+      resume: async (attemptId, input = {}) => {
+        assertPlatformMode(client, "timeback.assessments.resume()");
+        if (!attemptId?.trim()) {
+          throw new Error("attemptId is required");
+        }
+        const snapshot = await client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/resume`, "POST", input);
+        return syncAssessmentTracking(snapshot);
+      },
       save: async (attemptId, input) => {
         assertPlatformMode(client, "timeback.assessments.save()");
         if (!attemptId?.trim()) {
@@ -3248,6 +3262,22 @@ function createTimebackNamespace(client) {
         }
         return client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/save`, "POST", input);
       },
+      recordProgress: async (attemptId, input) => {
+        assertPlatformMode(client, "timeback.assessments.recordProgress()");
+        if (!attemptId?.trim()) {
+          throw new Error("attemptId is required");
+        }
+        if (!Number.isInteger(input.expectedResponseVersion) || input.expectedResponseVersion < 0) {
+          throw new Error("expectedResponseVersion must be a non-negative integer");
+        }
+        if (!input.assessmentToken?.trim()) {
+          throw new Error("assessmentToken is required");
+        }
+        if (!input.itemIdentifier?.trim()) {
+          throw new Error("itemIdentifier is required");
+        }
+        return client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/progress`, "POST", input);
+      },
       submitItem: async (attemptId, input) => {
         assertPlatformMode(client, "timeback.assessments.submitItem()");
         if (!attemptId?.trim()) {
@@ -3278,12 +3308,11 @@ function createTimebackNamespace(client) {
         if (!input.submissionId?.trim()) {
           throw new Error("submissionId is required");
         }
-        const { expectedResponseVersion } = input;
-        const { submissionId, session } = await assessmentSubmissionContext(attemptId, input.submissionId);
+        const context = await assessmentSubmissionContext(attemptId, input);
+        const { submissionId } = context.request;
         const request = {
-          expectedResponseVersion,
-          submissionId,
-          ...session ? { session } : {}
+          ...context.request,
+          ...context.session ? { session: context.session } : {}
         };
         try {
           const result = await client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/submit`, "POST", request, undefined, { retryPolicy: ASSESSMENT_SUBMIT_RETRY_POLICY });
@@ -3725,7 +3754,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.18.1-beta.2";
+var SDK_VERSION = "0.18.1-beta.4";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
 import { SchemaInfo } from '@playcademy/cloudflare';
 import { GamePermission, AUTH_PROVIDER_IDS } from '@playcademy/constants';
 import { TimebackGrade, TimebackSubject, ELevel, HeartbeatRequest, EndActivityRequest, EndActivityScoreData, EndActivityResponse, TimebackCourseConfig, CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/types/timeback';
-export { AssessmentAttemptSnapshot, AssessmentAwardRecord, AssessmentFinalizeResult, AssessmentFlow, AssessmentItemGrading, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableContentNode, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StartAssessmentInput, StartAssessmentOptions, StartDiagnosticAssessmentInput, SubmitAssessmentInput, SubmitAssessmentItemInput, SubmitAssessmentItemResult, SubmitDiagnosticAssessmentItemInput, SubmitDiagnosticAssessmentItemResult } from '@playcademy/types/timeback';
+export { AssessmentAttemptSnapshot, AssessmentAwardRecord, AssessmentFinalizeResult, AssessmentFlow, AssessmentItemGrading, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, AssessmentTranscript, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableContentNode, RecordAssessmentProgressInput, ResumeAssessmentInput, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StartAssessmentInput, StartAssessmentOptions, StartDiagnosticAssessmentInput, SubmitAssessmentInput, SubmitAssessmentItemInput, SubmitAssessmentItemResult, SubmitDiagnosticAssessmentItemInput, SubmitDiagnosticAssessmentItemResult } from '@playcademy/types/timeback';
 import * as _playcademy_types from '@playcademy/types';
 import { GameManifest, LocalDayContext } from '@playcademy/types';
 export { AuthenticatedUser, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';

package/dist/internal.js

@@ -3122,7 +3122,7 @@ function createTimebackNamespace(client) {
     console.warn(`[Playcademy SDK] timeback.assessments: active-time tracking was not attached to assessment ${attemptId} (${reason}). ${remedy}`);
   }
   function releasePendingSubmission(attemptId, submissionId) {
-    if (pendingAssessmentSubmissions.get(attemptId)?.submissionId === submissionId) {
+    if (pendingAssessmentSubmissions.get(attemptId)?.request.submissionId === submissionId) {
       pendingAssessmentSubmissions.delete(attemptId);
     }
   }
@@ -3150,7 +3150,7 @@ function createTimebackNamespace(client) {
     return snapshot;
   }
   async function resumeAfterDefinitiveFailure(attemptId, submissionId) {
-    if (pendingAssessmentSubmissions.get(attemptId)?.submissionId !== submissionId) {
+    if (pendingAssessmentSubmissions.get(attemptId)?.request.submissionId !== submissionId) {
       return;
     }
     pendingAssessmentSubmissions.delete(attemptId);
@@ -3158,18 +3158,24 @@ function createTimebackNamespace(client) {
       await syncAssessmentTracking(await loadAttemptSnapshot(attemptId));
     } catch {}
   }
-  async function assessmentSubmissionContext(attemptId, submissionId) {
+  async function assessmentSubmissionContext(attemptId, input) {
+    const { submissionId } = input;
     const pending = pendingAssessmentSubmissions.get(attemptId);
     if (pending) {
-      if (pending.submissionId !== submissionId && !pending.detached) {
+      if (pending.request.submissionId !== submissionId && !pending.detached) {
         throw new Error(`Assessment ${attemptId} already has a pending submission. Retry with the original submissionId.`);
       }
       pending.detached = false;
       return {
-        submissionId: pending.submissionId,
+        request: pending.request,
         session: await pending.session
       };
     }
+    const request = {
+      submissionId,
+      expectedResponseVersion: input.expectedResponseVersion,
+      transcript: structuredClone(input.transcript)
+    };
     const session = engine.activity.finishAssessment(attemptId).then((finished) => finished ? {
       runId: finished.runId,
       resumeId: finished.resumeId,
@@ -3179,11 +3185,11 @@ function createTimebackNamespace(client) {
       throw error;
     });
     pendingAssessmentSubmissions.set(attemptId, {
-      submissionId,
+      request,
       session,
       detached: false
     });
-    return { submissionId, session: await session };
+    return { request, session: await session };
   }
   registerPauseProbe(client, () => engine.activity.isManuallyPaused());
   return {
@@ -3238,6 +3244,14 @@ function createTimebackNamespace(client) {
         clearAssessmentTrackingWarnings(attemptId);
         return { attemptId };
       },
+      resume: async (attemptId, input = {}) => {
+        assertPlatformMode(client, "timeback.assessments.resume()");
+        if (!attemptId?.trim()) {
+          throw new Error("attemptId is required");
+        }
+        const snapshot = await client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/resume`, "POST", input);
+        return syncAssessmentTracking(snapshot);
+      },
       save: async (attemptId, input) => {
         assertPlatformMode(client, "timeback.assessments.save()");
         if (!attemptId?.trim()) {
@@ -3248,6 +3262,22 @@ function createTimebackNamespace(client) {
         }
         return client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/save`, "POST", input);
       },
+      recordProgress: async (attemptId, input) => {
+        assertPlatformMode(client, "timeback.assessments.recordProgress()");
+        if (!attemptId?.trim()) {
+          throw new Error("attemptId is required");
+        }
+        if (!Number.isInteger(input.expectedResponseVersion) || input.expectedResponseVersion < 0) {
+          throw new Error("expectedResponseVersion must be a non-negative integer");
+        }
+        if (!input.assessmentToken?.trim()) {
+          throw new Error("assessmentToken is required");
+        }
+        if (!input.itemIdentifier?.trim()) {
+          throw new Error("itemIdentifier is required");
+        }
+        return client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/progress`, "POST", input);
+      },
       submitItem: async (attemptId, input) => {
         assertPlatformMode(client, "timeback.assessments.submitItem()");
         if (!attemptId?.trim()) {
@@ -3278,12 +3308,11 @@ function createTimebackNamespace(client) {
         if (!input.submissionId?.trim()) {
           throw new Error("submissionId is required");
         }
-        const { expectedResponseVersion } = input;
-        const { submissionId, session } = await assessmentSubmissionContext(attemptId, input.submissionId);
+        const context = await assessmentSubmissionContext(attemptId, input);
+        const { submissionId } = context.request;
         const request = {
-          expectedResponseVersion,
-          submissionId,
-          ...session ? { session } : {}
+          ...context.request,
+          ...context.session ? { session: context.session } : {}
         };
         try {
           const result = await client["requestGameBackend"](`${ASSESSMENTS_ROUTE}/${encodeURIComponent(attemptId)}/submit`, "POST", request, undefined, { retryPolicy: ASSESSMENT_SUBMIT_RETRY_POLICY });
@@ -4617,7 +4646,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.18.1-beta.2";
+var SDK_VERSION = "0.18.1-beta.4";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.d.ts

@@ -375,6 +375,10 @@ declare class PlaycademyClient {
             latest: (studentId: string, options: _playcademy_types.GetLatestAssessmentOptions) => Promise<_playcademy_types.LatestAssessmentResult | null>;
             get: (studentId: string, attemptId: string) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
             save: (studentId: string, attemptId: string, input: _playcademy_types.SaveAssessmentInput) => Promise<_playcademy_types.AssessmentSaveResult>;
+            resume: (studentId: string, attemptId: string, input?: _playcademy_types.ResumeAssessmentInput) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
+            recordProgress: (studentId: string, attemptId: string, input: _playcademy_types.RecordAssessmentProgressInput) => Promise<{
+                attemptId: string;
+            }>;
             submitItem: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentItemInput) => Promise<_playcademy_types.SubmitAssessmentItemResult>;
             submit: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentRequest, context: {
                 sensorUrl: string;

package/dist/server/edge.js

@@ -123,6 +123,8 @@ function createTimebackNamespace(client) {
         return client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}?${params.toString()}`, "GET");
       },
       save: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/save`, "POST", { ...input, gameId: client.gameId, studentId }),
+      resume: (studentId, attemptId, input = {}) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/resume`, "POST", { ...input, gameId: client.gameId, studentId }),
+      recordProgress: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/progress`, "POST", { ...input, gameId: client.gameId, studentId }),
       submitItem: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/submit-item`, "POST", { ...input, gameId: client.gameId, studentId }),
       submit: (studentId, attemptId, input, context) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/submit`, "POST", {
         ...input,
@@ -335,7 +337,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.18.1-beta.2";
+var SDK_VERSION = "0.18.1-beta.4";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.d.ts

@@ -375,6 +375,10 @@ declare class PlaycademyClient$1 {
             latest: (studentId: string, options: _playcademy_types.GetLatestAssessmentOptions) => Promise<_playcademy_types.LatestAssessmentResult | null>;
             get: (studentId: string, attemptId: string) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
             save: (studentId: string, attemptId: string, input: _playcademy_types.SaveAssessmentInput) => Promise<_playcademy_types.AssessmentSaveResult>;
+            resume: (studentId: string, attemptId: string, input?: _playcademy_types.ResumeAssessmentInput) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
+            recordProgress: (studentId: string, attemptId: string, input: _playcademy_types.RecordAssessmentProgressInput) => Promise<{
+                attemptId: string;
+            }>;
             submitItem: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentItemInput) => Promise<_playcademy_types.SubmitAssessmentItemResult>;
             submit: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentRequest, context: {
                 sensorUrl: string;

package/dist/server.js

@@ -312,6 +312,8 @@ function createTimebackNamespace(client) {
         return client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}?${params.toString()}`, "GET");
       },
       save: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/save`, "POST", { ...input, gameId: client.gameId, studentId }),
+      resume: (studentId, attemptId, input = {}) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/resume`, "POST", { ...input, gameId: client.gameId, studentId }),
+      recordProgress: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/progress`, "POST", { ...input, gameId: client.gameId, studentId }),
       submitItem: (studentId, attemptId, input) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/submit-item`, "POST", { ...input, gameId: client.gameId, studentId }),
       submit: (studentId, attemptId, input, context) => client["request"](`/api/timeback/assessments/${encodeURIComponent(attemptId)}/submit`, "POST", {
         ...input,
@@ -524,7 +526,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.18.1-beta.2";
+var SDK_VERSION = "0.18.1-beta.4";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -2,7 +2,7 @@ import * as _playcademy_types from '@playcademy/types';
 import { GameManifest, LocalDayContext } from '@playcademy/types';
 export { AuthenticatedUser, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
 import { TimebackCourseConfig, CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig, TimebackGrade, TimebackSubject, ELevel, EndActivityRequest, HeartbeatRequest, EndActivityScoreData, EndActivityResponse } from '@playcademy/types/timeback';
-export { AssessmentAttemptSnapshot, AssessmentAwardRecord, AssessmentFinalizeResult, AssessmentFlow, AssessmentItemGrading, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableContentNode, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StartAssessmentInput, StartAssessmentOptions, StartDiagnosticAssessmentInput, SubmitAssessmentInput, SubmitAssessmentItemInput, SubmitAssessmentItemResult, SubmitDiagnosticAssessmentItemInput, SubmitDiagnosticAssessmentItemResult } from '@playcademy/types/timeback';
+export { AssessmentAttemptSnapshot, AssessmentAwardRecord, AssessmentFinalizeResult, AssessmentFlow, AssessmentItemGrading, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, AssessmentTranscript, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableContentNode, RecordAssessmentProgressInput, ResumeAssessmentInput, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StartAssessmentInput, StartAssessmentOptions, StartDiagnosticAssessmentInput, SubmitAssessmentInput, SubmitAssessmentItemInput, SubmitAssessmentItemResult, SubmitDiagnosticAssessmentItemInput, SubmitDiagnosticAssessmentItemResult } from '@playcademy/types/timeback';
 import { TimebackUserRole, UserEnrollment, UserOrganization, UserInfo } from '@playcademy/types/user';
 import { GamePermission, AUTH_PROVIDER_IDS } from '@playcademy/constants';
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
@@ -2018,7 +2018,11 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
             stop: (attemptId: string) => Promise<{
                 attemptId: string;
             }>;
+            resume: (attemptId: string, input?: _playcademy_types.ResumeAssessmentInput) => Promise<_playcademy_types.AssessmentAttemptSnapshot>;
             save: (attemptId: string, input: _playcademy_types.SaveAssessmentInput) => Promise<_playcademy_types.AssessmentSaveResult>;
+            recordProgress: (attemptId: string, input: _playcademy_types.RecordAssessmentProgressInput) => Promise<{
+                attemptId: string;
+            }>;
             submitItem: (attemptId: string, input: _playcademy_types.SubmitAssessmentItemInput) => Promise<_playcademy_types.SubmitAssessmentItemResult>;
             submit: (attemptId: string, input: _playcademy_types.SubmitAssessmentInput) => Promise<_playcademy_types.AssessmentSubmitResult>;
             finalize: (attemptId: string, input: _playcademy_types.FinalizeAssessmentInput) => Promise<_playcademy_types.AssessmentFinalizeResult>;

package/package.json

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