@playcademy/sandbox 0.3.4 → 0.3.6

package/README.md

@@ -199,17 +199,17 @@ bunx @playcademy/sandbox \
   --timeback-student-id your-student-sourcedId
 ```
 
-| Option                           | Description                                               |
-| :------------------------------- | :-------------------------------------------------------- |
-| `--timeback-local`               | Enable local TimeBack mode (Docker)                       |
-| `--timeback-oneroster-url <url>` | OneRoster API URL                                         |
-| `--timeback-caliper-url <url>`   | Caliper API URL                                           |
-| `--timeback-course-id <id>`      | Course ID for enrollments                                 |
-| `--timeback-student-id <id>`     | Student ID to link to demo user                           |
-| `--timeback-role <role>`         | User role (student, parent, teacher, administrator)       |
-| `--timeback-org-id <id>`         | Organization ID                                           |
-| `--timeback-org-name <name>`     | Organization display name                                 |
-| `--timeback-org-type <type>`     | Organization type (school, district, department, etc.)    |
+| Option                           | Description                                            |
+| :------------------------------- | :----------------------------------------------------- |
+| `--timeback-local`               | Enable local TimeBack mode (Docker)                    |
+| `--timeback-oneroster-url <url>` | OneRoster API URL                                      |
+| `--timeback-caliper-url <url>`   | Caliper API URL                                        |
+| `--timeback-course-id <id>`      | Course ID for enrollments                              |
+| `--timeback-student-id <id>`     | Student ID to link to demo user                        |
+| `--timeback-role <role>`         | User role (student, parent, teacher, administrator)    |
+| `--timeback-org-id <id>`         | Organization ID                                        |
+| `--timeback-org-name <name>`     | Organization display name                              |
+| `--timeback-org-type <type>`     | Organization type (school, district, department, etc.) |
 
 ### Environment Variables
 

package/dist/cli.js

@@ -120609,6 +120609,9 @@ function configureTimeback(options) {
     config.timeback.role = options.role;
     process.env.SANDBOX_TIMEBACK_ROLE = options.role;
   }
+  if (options.courseOverrides) {
+    config.timeback.courseOverrides = options.courseOverrides;
+  }
 }
 function getTimebackDisplayMode() {
   const { timebackId, mode } = config.timeback;
@@ -121478,7 +121481,7 @@ async function requirePortAvailable(port, timeoutMs = 100) {
 // package.json
 var package_default = {
   name: "@playcademy/sandbox",
-  version: "0.3.4",
+  version: "0.3.6",
   description: "Local development server for Playcademy game development",
   type: "module",
   exports: {
@@ -152337,7 +152340,14 @@ function getMockStudentProfile() {
 }
 async function getMockEnrollments(db) {
   const allIntegrations = await db.query.gameTimebackIntegrations.findMany();
-  return allIntegrations.map((i4) => ({
+  const overrides = config.timeback.courseOverrides;
+  return allIntegrations.filter((i4) => {
+    if (!overrides)
+      return true;
+    const key = `${i4.subject}:${i4.grade}`;
+    const override = overrides[key];
+    return override !== null && override !== false;
+  }).map((i4) => ({
     gameId: i4.gameId,
     grade: i4.grade,
     subject: i4.subject,
@@ -158314,14 +158324,16 @@ var {
 // src/cli/display.ts
 var import_picocolors = __toESM(require_picocolors(), 1);
 function printBanner(options) {
-  const { version: version4, port, startupTimeMs, timebackCourseCount, quiet } = options;
+  const { version: version4, port, startupTimeMs, timebackCourseCount, timebackEnrolledCount, quiet } = options;
   console.log("");
   console.log(`  ${import_picocolors.default.green(import_picocolors.default.bold("PLAYCADEMY SANDBOX"))} ${import_picocolors.default.green(`v${version4}`)} ${import_picocolors.default.dim("ready in")} ${import_picocolors.default.bold(startupTimeMs.toString())} ms`);
   console.log("");
-  console.log(`  ${import_picocolors.default.green("➜")}  ${import_picocolors.default.bold("Local:")}    ${import_picocolors.default.cyan(`http://localhost:${import_picocolors.default.bold(port.toString())}/api`)}`);
+  console.log(`  ${import_picocolors.default.green("➜")}  ${import_picocolors.default.bold("Local:")}     ${import_picocolors.default.cyan(`http://localhost:${import_picocolors.default.bold(port.toString())}/api`)}`);
   if (timebackCourseCount && timebackCourseCount > 0) {
     const courseText = timebackCourseCount === 1 ? "course" : "courses";
-    console.log(`  ${import_picocolors.default.green("➜")}  ${import_picocolors.default.bold("Timeback:")}  ${import_picocolors.default.cyan(`${timebackCourseCount} ${courseText}`)}`);
+    const enrolled = timebackEnrolledCount ?? timebackCourseCount;
+    const enrollmentInfo = enrolled !== timebackCourseCount ? ` / ${enrolled} enrolled` : "";
+    console.log(`  ${import_picocolors.default.green("➜")}  ${import_picocolors.default.bold("Timeback:")}  ${import_picocolors.default.cyan(`${timebackCourseCount} ${courseText}${enrollmentInfo}`)}`);
   }
   console.log("");
   if (!quiet) {
@@ -158530,9 +158542,20 @@ function parseOrganization(options) {
     type: options.timebackOrgType
   };
 }
+function parseExcludedCourses(excludedCourses) {
+  if (!excludedCourses)
+    return;
+  const overrides = {};
+  const courses = excludedCourses.split(",").map((c3) => c3.trim()).filter(Boolean);
+  for (const course of courses) {
+    overrides[course] = false;
+  }
+  return Object.keys(overrides).length > 0 ? overrides : undefined;
+}
 function parseTimebackOptions(options) {
   const organization = parseOrganization(options);
   const role = options.timebackRole;
+  const courseOverrides = parseExcludedCourses(options.timebackExcludedCourses);
   if (options.timebackLocal) {
     return {
       mode: "local",
@@ -158541,7 +158564,8 @@ function parseTimebackOptions(options) {
       courseId: options.timebackCourseId,
       timebackId: options.timebackStudentId,
       role,
-      organization
+      organization,
+      courseOverrides
     };
   }
   if (options.timebackOnerosterUrl) {
@@ -158552,14 +158576,16 @@ function parseTimebackOptions(options) {
       courseId: options.timebackCourseId,
       timebackId: options.timebackStudentId,
       role,
-      organization
+      organization,
+      courseOverrides
     };
   }
-  if (role || organization || options.timebackStudentId) {
+  if (role || organization || options.timebackStudentId || courseOverrides) {
     return {
       timebackId: options.timebackStudentId,
       role,
-      organization
+      organization,
+      courseOverrides
     };
   }
   return;
@@ -158567,7 +158593,7 @@ function parseTimebackOptions(options) {
 
 // src/cli/index.ts
 var program2 = new Command;
-program2.name("playcademy-sandbox").description("Local development server for Playcademy game development").version(version3).option("-p, --port <number>", "Port to run the server on", "4321").option("-v, --verbose", "Enable verbose logging", false).option("--project-name <name>", "Name of the current project").option("--project-slug <slug>", "Slug of the current project").option("--no-seed", "Do not seed the database with demo data").option("--recreate-db", "Recreate the on-disk database on start", false).option("--memory", "Use in-memory database (no persistence)", false).option("--db-path <path>", "Custom path for the database file (relative to cwd or absolute)").option("--config-path <path>", "Path to playcademy.config.json (defaults to cwd)").option("--timeback-local", "Use local TimeBack instance").option("--timeback-oneroster-url <url>", "TimeBack OneRoster API URL").option("--timeback-caliper-url <url>", "TimeBack Caliper API URL").option("--timeback-course-id <id>", "TimeBack course ID for seeding").option("--timeback-student-id <id>", "TimeBack student ID for demo user").option("--timeback-role <role>", "TimeBack user role (student, parent, teacher, administrator)").option("--timeback-org-id <id>", "TimeBack organization ID").option("--timeback-org-name <name>", "TimeBack organization name").option("--timeback-org-type <type>", "TimeBack organization type (school, district, department)").option("-q, --quiet", "Quiet mode (suppress interactive messages)", false).action(async (options) => {
+program2.name("playcademy-sandbox").description("Local development server for Playcademy game development").version(version3).option("-p, --port <number>", "Port to run the server on", "4321").option("-v, --verbose", "Enable verbose logging", false).option("--project-name <name>", "Name of the current project").option("--project-slug <slug>", "Slug of the current project").option("--no-seed", "Do not seed the database with demo data").option("--recreate-db", "Recreate the on-disk database on start", false).option("--memory", "Use in-memory database (no persistence)", false).option("--db-path <path>", "Custom path for the database file (relative to cwd or absolute)").option("--config-path <path>", "Path to playcademy.config.json (defaults to cwd)").option("--timeback-local", "Use local TimeBack instance").option("--timeback-oneroster-url <url>", "TimeBack OneRoster API URL").option("--timeback-caliper-url <url>", "TimeBack Caliper API URL").option("--timeback-course-id <id>", "TimeBack course ID for seeding").option("--timeback-student-id <id>", "TimeBack student ID for demo user").option("--timeback-role <role>", "TimeBack user role (student, parent, teacher, administrator)").option("--timeback-org-id <id>", "TimeBack organization ID").option("--timeback-org-name <name>", "TimeBack organization name").option("--timeback-org-type <type>", "TimeBack organization type (school, district, department)").option("--timeback-excluded-courses <courses>", 'Comma-separated courses to exclude from enrollment (e.g. "FastMath:3,FastMath:4")').option("-q, --quiet", "Quiet mode (suppress interactive messages)", false).action(async (options) => {
   try {
     const startTime = Date.now();
     const port = parseInt(options.port);
@@ -158589,11 +158615,15 @@ program2.name("playcademy-sandbox").description("Local development server for Pl
       startedAt: Date.now(),
       projectRoot: process.cwd()
     });
+    const totalCourses = project?.timebackCourses?.length ?? 0;
+    const excludedCount = options.timebackExcludedCourses ? options.timebackExcludedCourses.split(",").filter(Boolean).length : 0;
+    const enrolledCount = Math.max(0, totalCourses - excludedCount);
     printBanner({
       version: version3,
       port,
       startupTimeMs: Date.now() - startTime,
-      timebackCourseCount: project?.timebackCourses?.length,
+      timebackCourseCount: totalCourses,
+      timebackEnrolledCount: enrolledCount,
       quiet: options.quiet
     });
     const cleanup = () => {

package/dist/config.d.ts

@@ -14,6 +14,13 @@ interface TimebackOrganizationInput {
     name?: string;
     type?: TimebackOrgType;
 }
+/**
+ * Course enrollment overrides.
+ * - `'mock'` or omit: Use mock ID
+ * - Real string: Use that course ID
+ * - `null` or `false`: Exclude from enrollment
+ */
+type CourseEnrollmentOverrides = Record<string, 'mock' | string | null | false>;
 /**
  * Timeback configuration input for sandbox.
  * All fields optional since they can be derived from defaults.
@@ -29,6 +36,7 @@ interface TimebackConfig {
     timebackId?: string;
     organization?: TimebackOrganizationInput;
     role?: TimebackUserRole;
+    courseOverrides?: CourseEnrollmentOverrides;
 }
 /**
  * Authentication configuration input for sandbox.
@@ -76,4 +84,4 @@ declare function getTimebackDisplayMode(): 'mock' | 'remote' | 'local' | null;
 declare const config: SandboxConfig;
 
 export { config, configureTimeback, getTimebackDisplayMode, hasTimebackCredentials, hasTimebackFullConfig, isTimebackEnabled, requireTimebackCredentials, setEmbeddedMode };
-export type { AuthConfig, SandboxConfig, TimebackConfig, TimebackMode };
+export type { AuthConfig, CourseEnrollmentOverrides, SandboxConfig, TimebackConfig, TimebackMode };

package/dist/config.js

@@ -127,6 +127,9 @@ function configureTimeback(options) {
     config.timeback.role = options.role;
     process.env.SANDBOX_TIMEBACK_ROLE = options.role;
   }
+  if (options.courseOverrides) {
+    config.timeback.courseOverrides = options.courseOverrides;
+  }
 }
 function getTimebackDisplayMode() {
   const { timebackId, mode } = config.timeback;

package/dist/mocks/timeback.d.ts

@@ -17,6 +17,7 @@ export declare function shouldMockTimeback(): boolean;
 export declare function getMockStudentProfile(): TimebackStudentProfile;
 /**
  * Generate mock enrollments from seeded game integrations.
+ * Respects courseOverrides from config - null/false excludes the course.
  */
 export declare function getMockEnrollments(db: DatabaseInstance): Promise<UserEnrollment[]>;
 /**

package/dist/server.d.ts

@@ -15,6 +15,13 @@ interface TimebackOrganizationInput {
     name?: string;
     type?: TimebackOrgType;
 }
+/**
+ * Course enrollment overrides.
+ * - `'mock'` or omit: Use mock ID
+ * - Real string: Use that course ID
+ * - `null` or `false`: Exclude from enrollment
+ */
+type CourseEnrollmentOverrides = Record<string, 'mock' | string | null | false>;
 /**
  * Timeback configuration input for sandbox.
  * All fields optional since they can be derived from defaults.
@@ -30,6 +37,7 @@ interface TimebackConfig {
     timebackId?: string;
     organization?: TimebackOrganizationInput;
     role?: TimebackUserRole;
+    courseOverrides?: CourseEnrollmentOverrides;
 }
 
 /**

package/dist/server.js

@@ -118699,6 +118699,9 @@ function configureTimeback(options) {
     config.timeback.role = options.role;
     process.env.SANDBOX_TIMEBACK_ROLE = options.role;
   }
+  if (options.courseOverrides) {
+    config.timeback.courseOverrides = options.courseOverrides;
+  }
 }
 function getTimebackDisplayMode() {
   const { timebackId, mode } = config.timeback;
@@ -119568,7 +119571,7 @@ async function requirePortAvailable(port, timeoutMs = 100) {
 // package.json
 var package_default = {
   name: "@playcademy/sandbox",
-  version: "0.3.4",
+  version: "0.3.6",
   description: "Local development server for Playcademy game development",
   type: "module",
   exports: {
@@ -150427,7 +150430,14 @@ function getMockStudentProfile() {
 }
 async function getMockEnrollments(db) {
   const allIntegrations = await db.query.gameTimebackIntegrations.findMany();
-  return allIntegrations.map((i4) => ({
+  const overrides = config.timeback.courseOverrides;
+  return allIntegrations.filter((i4) => {
+    if (!overrides)
+      return true;
+    const key = `${i4.subject}:${i4.grade}`;
+    const override = overrides[key];
+    return override !== null && override !== false;
+  }).map((i4) => ({
     gameId: i4.gameId,
     grade: i4.grade,
     subject: i4.subject,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.3.4",
+    "version": "0.3.6",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {