@playcademy/sdk 0.20.1-beta.1 → 0.20.1-beta.2

package/dist/index.js

@@ -802,6 +802,8 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
 var ASSESSMENT_ASSET_MAX_BYTES = 4 * 1024 * 1024;
+// ../constants/src/skills.ts
+var SKILL_STATUS_MAX_SKILLS = 50;
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
@@ -3760,7 +3762,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.20.1-beta.1";
+var SDK_VERSION = "0.20.1-beta.2";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -4,7 +4,7 @@ import { TimebackGrade, TimebackSubject, ELevel, HeartbeatRequest, EndActivityRe
 export { AssessmentAttemptSnapshot, AssessmentAwardRecord, AssessmentFinalizeResult, AssessmentFlow, AssessmentItemGrading, AssessmentItemOutcome, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentReviewStandard, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, AssessmentTranscript, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, MasteryAssessmentSubmitResult, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableChoiceInteraction, PlayableContentNode, PlayableGapMatchChoice, PlayableGapMatchInteraction, PlayableInlineChoiceInteraction, PlayableMatchChoice, PlayableMatchInteraction, PlayableOrderInteraction, RecordAssessmentProgressInput, ResumeAssessmentInput, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StandardsReviewSelectionContext, 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, DeploySource, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameReleaseResponse, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, Release, ReleasesResponse, SkillMasterySource, SkillStatus, SkillStatusRequestingGame, SkillStatusResponse, SkillStatusResult, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
+export { AuthenticatedUser, DeploySource, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameReleaseResponse, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, Release, ReleasesResponse, SkillMasterySource, SkillStatus, SkillStatusLookupResult, SkillStatusRequest, SkillStatusRequestingGame, SkillStatusResponse, SkillStatusResult, SkillStatusUnsupportedReason, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { DomainValidationRecords } from '@playcademy/types/game';
 import { z } from 'zod';

package/dist/internal.js

@@ -802,6 +802,8 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
 var ASSESSMENT_ASSET_MAX_BYTES = 4 * 1024 * 1024;
+// ../constants/src/skills.ts
+var SKILL_STATUS_MAX_SKILLS = 50;
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
@@ -4670,7 +4672,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.20.1-beta.1";
+var SDK_VERSION = "0.20.1-beta.2";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.d.ts

@@ -402,6 +402,10 @@ declare class PlaycademyClient {
             subject: string;
         }) => Promise<_playcademy_types.StudentHighestGradeMasteredResponse>;
     };
+    /** Cross-game skill status (getStatus) */
+    skills: {
+        getStatus: (request: _playcademy_types.SkillStatusRequest) => Promise<_playcademy_types.SkillStatusLookupResult>;
+    };
 }
 
 /**

package/dist/server/edge.js

@@ -10,13 +10,6 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
-// src/core/timeback/assessment-request.ts
-function canonicalAssessmentInput(input) {
-  const request = { ...input };
-  delete request.preparationReceipt;
-  return request;
-}
-
 // ../constants/src/auth.ts
 var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   games: ["read", "write", "delete"],
@@ -27,6 +20,8 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
 var ASSESSMENT_ASSET_MAX_BYTES = 4 * 1024 * 1024;
+// ../constants/src/skills.ts
+var SKILL_STATUS_MAX_SKILLS = 50;
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
@@ -68,6 +63,44 @@ var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
   time: 60,
   score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
 };
+// ../utils/src/skills.ts
+function normalizeSkillId(skill) {
+  return skill.trim().toLowerCase();
+}
+function normalizeSkillIds(skills2, max) {
+  const normalized = [...new Set(skills2.map(normalizeSkillId).filter((skill) => skill.length > 0))];
+  if (normalized.length === 0) {
+    return { ok: false, error: "At least one skill is required" };
+  }
+  if (normalized.length > max) {
+    return { ok: false, error: `At most ${max} skills can be requested at once` };
+  }
+  return { ok: true, skills: normalized };
+}
+
+// src/server/namespaces/skills.ts
+function createSkillsNamespace(client) {
+  return {
+    getStatus: (request) => {
+      const normalized = normalizeSkillIds(request.skills, SKILL_STATUS_MAX_SKILLS);
+      if (!normalized.ok) {
+        throw new Error(normalized.error);
+      }
+      return client["request"]("/api/skills/status", "POST", {
+        game: request.game,
+        studentId: request.studentId,
+        skills: normalized.skills
+      });
+    }
+  };
+}
+// src/core/timeback/assessment-request.ts
+function canonicalAssessmentInput(input) {
+  const request = { ...input };
+  delete request.preparationReceipt;
+  return request;
+}
+
 // src/core/guards.ts
 var VALID_GRADES = TIMEBACK_GRADES;
 var VALID_SUBJECTS = TIMEBACK_SUBJECTS;
@@ -337,7 +370,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.20.1-beta.1";
+var SDK_VERSION = "0.20.1-beta.2";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {
@@ -429,6 +462,7 @@ class PlaycademyClient {
     return this.state.config;
   }
   timeback = createTimebackNamespace(this);
+  skills = createSkillsNamespace(this);
 }
 // src/server/utils/verify-game-token.ts
 async function verifyGameToken(gameToken, options) {

package/dist/server.d.ts

@@ -402,6 +402,10 @@ declare class PlaycademyClient$1 {
             subject: string;
         }) => Promise<_playcademy_types.StudentHighestGradeMasteredResponse>;
     };
+    /** Cross-game skill status (getStatus) */
+    skills: {
+        getStatus: (request: _playcademy_types.SkillStatusRequest) => Promise<_playcademy_types.SkillStatusLookupResult>;
+    };
 }
 
 /**

package/dist/server.js

@@ -199,13 +199,6 @@ var init_config_loader = __esm(() => {
   init_file_loader();
 });
 
-// src/core/timeback/assessment-request.ts
-function canonicalAssessmentInput(input) {
-  const request = { ...input };
-  delete request.preparationReceipt;
-  return request;
-}
-
 // ../constants/src/auth.ts
 var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
   games: ["read", "write", "delete"],
@@ -216,6 +209,8 @@ var DEFAULT_PERSONAL_API_KEY_PERMISSIONS = {
 var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 var PLAYCADEMY_ASSESSMENT_ASSET_SHA256_HEADER = "x-playcademy-content-sha256";
 var ASSESSMENT_ASSET_MAX_BYTES = 4 * 1024 * 1024;
+// ../constants/src/skills.ts
+var SKILL_STATUS_MAX_SKILLS = 50;
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
@@ -257,6 +252,44 @@ var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
   time: 60,
   score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
 };
+// ../utils/src/skills.ts
+function normalizeSkillId(skill) {
+  return skill.trim().toLowerCase();
+}
+function normalizeSkillIds(skills2, max) {
+  const normalized = [...new Set(skills2.map(normalizeSkillId).filter((skill) => skill.length > 0))];
+  if (normalized.length === 0) {
+    return { ok: false, error: "At least one skill is required" };
+  }
+  if (normalized.length > max) {
+    return { ok: false, error: `At most ${max} skills can be requested at once` };
+  }
+  return { ok: true, skills: normalized };
+}
+
+// src/server/namespaces/skills.ts
+function createSkillsNamespace(client) {
+  return {
+    getStatus: (request) => {
+      const normalized = normalizeSkillIds(request.skills, SKILL_STATUS_MAX_SKILLS);
+      if (!normalized.ok) {
+        throw new Error(normalized.error);
+      }
+      return client["request"]("/api/skills/status", "POST", {
+        game: request.game,
+        studentId: request.studentId,
+        skills: normalized.skills
+      });
+    }
+  };
+}
+// src/core/timeback/assessment-request.ts
+function canonicalAssessmentInput(input) {
+  const request = { ...input };
+  delete request.preparationReceipt;
+  return request;
+}
+
 // src/core/guards.ts
 var VALID_GRADES = TIMEBACK_GRADES;
 var VALID_SUBJECTS = TIMEBACK_SUBJECTS;
@@ -526,7 +559,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.20.1-beta.1";
+var SDK_VERSION = "0.20.1-beta.2";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {
@@ -618,6 +651,7 @@ class PlaycademyClient {
     return this.state.config;
   }
   timeback = createTimebackNamespace(this);
+  skills = createSkillsNamespace(this);
 }
 
 // src/server/client.ts

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import * as _playcademy_types from '@playcademy/types';
 import { GameManifest, LocalDayContext } from '@playcademy/types';
-export { AuthenticatedUser, DeploySource, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameReleaseResponse, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, Release, ReleasesResponse, SkillMasterySource, SkillStatus, SkillStatusRequestingGame, SkillStatusResponse, SkillStatusResult, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
+export { AuthenticatedUser, DeploySource, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameReleaseResponse, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, Release, ReleasesResponse, SkillMasterySource, SkillStatus, SkillStatusLookupResult, SkillStatusRequest, SkillStatusRequestingGame, SkillStatusResponse, SkillStatusResult, SkillStatusUnsupportedReason, 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, AssessmentItemOutcome, AssessmentItemSubmission, AssessmentMasteryAward, AssessmentPreparationResult, AssessmentResponseUpdate, AssessmentResponseValue, AssessmentResponses, AssessmentReviewStandard, AssessmentSaveResult, AssessmentScore, AssessmentStandardRef, AssessmentSubmitResult, AssessmentTranscript, ConventionalAssessmentAttemptSnapshot, ConventionalAssessmentSubmitResult, DiagnosticAssessmentItemReceipt, DiagnosticAssessmentSubmitResult, DiagnosticRoutingSnapshot, DiagnosticRoutingTrackSnapshot, ELevel, FinalizeAssessmentInput, MasteryAssessmentSubmitResult, PlatformRoutedDiagnosticAttemptSnapshot, PlatformRoutedDiagnosticSelectionContext, PlayableAssessment, PlayableAssessmentAttemptSnapshot, PlayableAssessmentChoice, PlayableAssessmentGraphic, PlayableAssessmentHotspot, PlayableAssessmentInteraction, PlayableAssessmentItem, PlayableChoiceInteraction, PlayableContentNode, PlayableGapMatchChoice, PlayableGapMatchInteraction, PlayableInlineChoiceInteraction, PlayableMatchChoice, PlayableMatchInteraction, PlayableOrderInteraction, RecordAssessmentProgressInput, ResumeAssessmentInput, SaveAssessmentInput, SettledAssessmentAttemptSnapshot, StandardsReviewSelectionContext, StartAssessmentInput, StartAssessmentOptions, StartDiagnosticAssessmentInput, SubmitAssessmentInput, SubmitAssessmentItemInput, SubmitAssessmentItemResult, SubmitDiagnosticAssessmentItemInput, SubmitDiagnosticAssessmentItemResult } from '@playcademy/types/timeback';
 import { TimebackUserRole, UserEnrollment, UserOrganization, UserInfo } from '@playcademy/types/user';

package/package.json

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