@playcademy/sdk 0.16.1-beta.2 → 0.16.1-beta.21

package/dist/server/edge.d.ts

@@ -1,4 +1,5 @@
 import { SchemaInfo } from '@playcademy/cloudflare';
+import { GamePermission } from '@playcademy/constants';
 import { TimebackCourseConfig, CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/types/timeback';
 export { ActivityData, ComponentConfig, ComponentResourceConfig, EndActivityPayload, OrganizationConfig, ResourceConfig, TimebackGrade, TimebackSubject } from '@playcademy/types/timeback';
 import { UserInfo } from '@playcademy/types/user';
@@ -141,6 +142,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -152,6 +166,13 @@ interface PlaycademyConfig {
     description?: string;
     /** Game emoji icon */
     emoji?: string;
+    /**
+     * Browser permissions to request for the game's iframe (e.g.
+     * `['microphone']`). Opt-in per game; only `microphone` and `camera` are
+     * delegated this way. Fullscreen, autoplay, and gamepad are granted to
+     * every game automatically.
+     */
+    permissions?: GamePermission[];
     /** Build command to run before deployment */
     buildCommand?: string[];
     /** Path to build output */
@@ -166,6 +187,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**
@@ -351,7 +374,8 @@ 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>;
-            submit: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentInput, context: {
+            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;
             }) => Promise<_playcademy_types.AssessmentSubmitResult>;
         };

package/dist/server/edge.js

@@ -41,7 +41,13 @@ var TIMEBACK_SUBJECTS = [
   "Math",
   "None"
 ];
-var ASSESSMENT_PURPOSES = ["end_of_course", "diagnostic"];
+var ASSESSMENT_PURPOSES = ["end_of_course", "diagnostic", "review", "mastery"];
+var TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS = {
+  standards: 20,
+  candidateItemsPerStandard: 2,
+  standardFieldLength: 128
+};
+var VALID_E_LEVELS = ["E1", "E2", "E3", "E4"];
 var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
   xp: 1,
   mastery: 0,
@@ -65,6 +71,9 @@ function isValidSubject(value) {
 function isAssessmentPurpose(value) {
   return typeof value === "string" && ASSESSMENT_PURPOSES.includes(value);
 }
+function isValidELevel(value) {
+  return typeof value === "string" && VALID_E_LEVELS.includes(value);
+}
 // src/server/namespaces/timeback.ts
 function createTimebackNamespace(client) {
   function enrichActivityData(data) {
@@ -88,6 +97,10 @@ function createTimebackNamespace(client) {
         if (options.grade !== undefined) {
           params.set("grade", String(options.grade));
         }
+        if (options.purpose === "mastery") {
+          params.set("standardFramework", options.standard.framework);
+          params.set("standardIdentifier", options.standard.identifier);
+        }
         return client["request"](`/api/timeback/assessments/latest?${params.toString()}`, "GET");
       },
       get: (studentId, attemptId) => {
@@ -95,6 +108,7 @@ 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 }),
+      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,
         gameId: client.gameId,
@@ -299,7 +313,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.2";
+var SDK_VERSION = "0.16.1-beta.21";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.d.ts

@@ -1,4 +1,5 @@
 import { SchemaInfo } from '@playcademy/cloudflare';
+import { GamePermission } from '@playcademy/constants';
 import { TimebackCourseConfig, CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/types/timeback';
 export { ActivityData, ComponentConfig, ComponentResourceConfig, EndActivityPayload, OrganizationConfig, ResourceConfig, TimebackGrade, TimebackSubject } from '@playcademy/types/timeback';
 import { UserInfo } from '@playcademy/types/user';
@@ -141,6 +142,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -152,6 +166,13 @@ interface PlaycademyConfig {
     description?: string;
     /** Game emoji icon */
     emoji?: string;
+    /**
+     * Browser permissions to request for the game's iframe (e.g.
+     * `['microphone']`). Opt-in per game; only `microphone` and `camera` are
+     * delegated this way. Fullscreen, autoplay, and gamepad are granted to
+     * every game automatically.
+     */
+    permissions?: GamePermission[];
     /** Build command to run before deployment */
     buildCommand?: string[];
     /** Path to build output */
@@ -166,6 +187,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**
@@ -351,7 +374,8 @@ 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>;
-            submit: (studentId: string, attemptId: string, input: _playcademy_types.SubmitAssessmentInput, context: {
+            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;
             }) => Promise<_playcademy_types.AssessmentSubmitResult>;
         };

package/dist/server.js

@@ -230,7 +230,13 @@ var TIMEBACK_SUBJECTS = [
   "Math",
   "None"
 ];
-var ASSESSMENT_PURPOSES = ["end_of_course", "diagnostic"];
+var ASSESSMENT_PURPOSES = ["end_of_course", "diagnostic", "review", "mastery"];
+var TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS = {
+  standards: 20,
+  candidateItemsPerStandard: 2,
+  standardFieldLength: 128
+};
+var VALID_E_LEVELS = ["E1", "E2", "E3", "E4"];
 var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
   xp: 1,
   mastery: 0,
@@ -254,6 +260,9 @@ function isValidSubject(value) {
 function isAssessmentPurpose(value) {
   return typeof value === "string" && ASSESSMENT_PURPOSES.includes(value);
 }
+function isValidELevel(value) {
+  return typeof value === "string" && VALID_E_LEVELS.includes(value);
+}
 // src/server/namespaces/timeback.ts
 function createTimebackNamespace(client) {
   function enrichActivityData(data) {
@@ -277,6 +286,10 @@ function createTimebackNamespace(client) {
         if (options.grade !== undefined) {
           params.set("grade", String(options.grade));
         }
+        if (options.purpose === "mastery") {
+          params.set("standardFramework", options.standard.framework);
+          params.set("standardIdentifier", options.standard.identifier);
+        }
         return client["request"](`/api/timeback/assessments/latest?${params.toString()}`, "GET");
       },
       get: (studentId, attemptId) => {
@@ -284,6 +297,7 @@ 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 }),
+      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,
         gameId: client.gameId,
@@ -488,7 +502,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.2";
+var SDK_VERSION = "0.16.1-beta.21";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {