playcademy 0.14.25 → 0.14.26

package/dist/constants/src/timeback.ts

@@ -30,3 +30,69 @@ export const TIMEBACK_ROUTES = {
  * This is the default organization sourcedId for Playcademy games
  */
 export const TIMEBACK_ORG_SOURCED_ID = 'PLAYCADEMY' as const
+
+/**
+ * Default organization name for Playcademy games
+ */
+export const TIMEBACK_ORG_NAME = 'Playcademy Studios' as const
+
+/**
+ * Default organization type for Playcademy games
+ */
+export const TIMEBACK_ORG_TYPE = 'department' as const
+
+// ============================================================================
+// TimeBack Resource Defaults
+// ============================================================================
+
+/**
+ * Default course configuration values
+ */
+export const TIMEBACK_COURSE_DEFAULTS = {
+    gradingScheme: 'STANDARD',
+    level: {
+        elementary: 'Elementary',
+        middle: 'Middle',
+        high: 'High',
+        ap: 'AP',
+    },
+    goals: {
+        dailyXp: 50,
+        dailyLessons: 3,
+    },
+    metrics: {
+        totalXp: 1000,
+        totalLessons: 50,
+    },
+} as const
+
+/**
+ * Default resource configuration values
+ */
+export const TIMEBACK_RESOURCE_DEFAULTS = {
+    vendorId: 'playcademy',
+    roles: ['primary'] as const,
+    importance: 'primary' as const,
+    metadata: {
+        type: 'interactive' as const,
+        toolProvider: 'Playcademy',
+        instructionalMethod: 'exploratory' as const,
+        language: 'en-US',
+    },
+} as const
+
+/**
+ * Default component configuration values
+ */
+export const TIMEBACK_COMPONENT_DEFAULTS = {
+    sortOrder: 1,
+    prerequisiteCriteria: 'ALL' as const,
+} as const
+
+/**
+ * Default componentResource configuration values
+ */
+export const TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
+    sortOrder: 1,
+    lessonType: 'quiz',
+} as const

package/dist/index.js

@@ -4192,8 +4192,51 @@ var init_overworld2 = __esm2(() => {
     FIRST_GAME: ITEM_SLUGS2.FIRST_GAME_BADGE
   };
 });
-var init_timeback2 = () => {
-};
+var TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY";
+var TIMEBACK_ORG_NAME = "Playcademy Studios";
+var TIMEBACK_ORG_TYPE = "department";
+var TIMEBACK_COURSE_DEFAULTS;
+var TIMEBACK_RESOURCE_DEFAULTS;
+var TIMEBACK_COMPONENT_DEFAULTS;
+var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS;
+var init_timeback2 = __esm2(() => {
+  TIMEBACK_COURSE_DEFAULTS = {
+    gradingScheme: "STANDARD",
+    level: {
+      elementary: "Elementary",
+      middle: "Middle",
+      high: "High",
+      ap: "AP"
+    },
+    goals: {
+      dailyXp: 50,
+      dailyLessons: 3
+    },
+    metrics: {
+      totalXp: 1e3,
+      totalLessons: 50
+    }
+  };
+  TIMEBACK_RESOURCE_DEFAULTS = {
+    vendorId: "playcademy",
+    roles: ["primary"],
+    importance: "primary",
+    metadata: {
+      type: "interactive",
+      toolProvider: "Playcademy",
+      instructionalMethod: "exploratory",
+      language: "en-US"
+    }
+  };
+  TIMEBACK_COMPONENT_DEFAULTS = {
+    sortOrder: 1,
+    prerequisiteCriteria: "ALL"
+  };
+  TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
+    sortOrder: 1,
+    lessonType: "quiz"
+  };
+});
 var init_workers2 = () => {
 };
 var init_src2 = __esm2(() => {
@@ -4226,7 +4269,6 @@ var HTTP_DEFAULTS;
 var AUTH_DEFAULTS;
 var CACHE_DEFAULTS;
 var CONFIG_DEFAULTS;
-var DEFAULT_PLAYCADEMY_ORGANIZATION_ID;
 var PLAYCADEMY_DEFAULTS;
 var RESOURCE_DEFAULTS;
 var HTTP_STATUS;
@@ -4373,54 +4415,26 @@ var init_constants = __esm2(() => {
   CONFIG_DEFAULTS = {
     fileNames: ["timeback.config.js", "timeback.config.json"]
   };
-  DEFAULT_PLAYCADEMY_ORGANIZATION_ID = process.env.TIMEBACK_ORG_SOURCE_ID || "PLAYCADEMY";
   PLAYCADEMY_DEFAULTS = {
-    organization: DEFAULT_PLAYCADEMY_ORGANIZATION_ID,
+    organization: TIMEBACK_ORG_SOURCED_ID,
     launchBaseUrls: PLAYCADEMY_BASE_URLS2
   };
   RESOURCE_DEFAULTS = {
     organization: {
-      name: "Playcademy Studios",
-      type: "department"
+      name: TIMEBACK_ORG_NAME,
+      type: TIMEBACK_ORG_TYPE
     },
     course: {
-      gradingScheme: "STANDARD",
-      level: {
-        elementary: "Elementary",
-        middle: "Middle",
-        high: "High",
-        ap: "AP"
-      },
-      metadata: {
-        goals: {
-          dailyXp: 50,
-          dailyLessons: 3
-        },
-        metrics: {
-          totalXp: 1e3,
-          totalLessons: 50
-        }
-      }
-    },
-    component: {
-      sortOrder: 1,
-      prerequisiteCriteria: "ALL"
-    },
-    resource: {
-      vendorId: "playcademy",
-      roles: ["primary"],
-      importance: "primary",
+      gradingScheme: TIMEBACK_COURSE_DEFAULTS.gradingScheme,
+      level: TIMEBACK_COURSE_DEFAULTS.level,
       metadata: {
-        type: "interactive",
-        toolProvider: "Playcademy",
-        instructionalMethod: "exploratory",
-        language: "en-US"
+        goals: TIMEBACK_COURSE_DEFAULTS.goals,
+        metrics: TIMEBACK_COURSE_DEFAULTS.metrics
       }
     },
-    componentResource: {
-      sortOrder: 1,
-      lessonType: "quiz"
-    }
+    component: TIMEBACK_COMPONENT_DEFAULTS,
+    resource: TIMEBACK_RESOURCE_DEFAULTS,
+    componentResource: TIMEBACK_COMPONENT_RESOURCE_DEFAULTS
   };
   HTTP_STATUS = {
     CLIENT_ERROR_MIN: 400,
@@ -4476,8 +4490,51 @@ var init_overworld3 = __esm3(() => {
     FIRST_GAME: ITEM_SLUGS3.FIRST_GAME_BADGE
   };
 });
-var init_timeback3 = () => {
-};
+var TIMEBACK_ORG_SOURCED_ID2 = "PLAYCADEMY";
+var TIMEBACK_ORG_NAME2 = "Playcademy Studios";
+var TIMEBACK_ORG_TYPE2 = "department";
+var TIMEBACK_COURSE_DEFAULTS2;
+var TIMEBACK_RESOURCE_DEFAULTS2;
+var TIMEBACK_COMPONENT_DEFAULTS2;
+var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2;
+var init_timeback3 = __esm3(() => {
+  TIMEBACK_COURSE_DEFAULTS2 = {
+    gradingScheme: "STANDARD",
+    level: {
+      elementary: "Elementary",
+      middle: "Middle",
+      high: "High",
+      ap: "AP"
+    },
+    goals: {
+      dailyXp: 50,
+      dailyLessons: 3
+    },
+    metrics: {
+      totalXp: 1e3,
+      totalLessons: 50
+    }
+  };
+  TIMEBACK_RESOURCE_DEFAULTS2 = {
+    vendorId: "playcademy",
+    roles: ["primary"],
+    importance: "primary",
+    metadata: {
+      type: "interactive",
+      toolProvider: "Playcademy",
+      instructionalMethod: "exploratory",
+      language: "en-US"
+    }
+  };
+  TIMEBACK_COMPONENT_DEFAULTS2 = {
+    sortOrder: 1,
+    prerequisiteCriteria: "ALL"
+  };
+  TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2 = {
+    sortOrder: 1,
+    lessonType: "quiz"
+  };
+});
 var init_workers3 = () => {
 };
 var init_src3 = __esm3(() => {
@@ -4510,7 +4567,6 @@ var HTTP_DEFAULTS2;
 var AUTH_DEFAULTS2;
 var CACHE_DEFAULTS2;
 var CONFIG_DEFAULTS2;
-var DEFAULT_PLAYCADEMY_ORGANIZATION_ID2;
 var PLAYCADEMY_DEFAULTS2;
 var RESOURCE_DEFAULTS2;
 var HTTP_STATUS2;
@@ -4657,54 +4713,26 @@ var init_constants2 = __esm3(() => {
   CONFIG_DEFAULTS2 = {
     fileNames: ["timeback.config.js", "timeback.config.json"]
   };
-  DEFAULT_PLAYCADEMY_ORGANIZATION_ID2 = process.env.TIMEBACK_ORG_SOURCE_ID || "PLAYCADEMY";
   PLAYCADEMY_DEFAULTS2 = {
-    organization: DEFAULT_PLAYCADEMY_ORGANIZATION_ID2,
+    organization: TIMEBACK_ORG_SOURCED_ID2,
     launchBaseUrls: PLAYCADEMY_BASE_URLS3
   };
   RESOURCE_DEFAULTS2 = {
     organization: {
-      name: "Playcademy Studios",
-      type: "department"
+      name: TIMEBACK_ORG_NAME2,
+      type: TIMEBACK_ORG_TYPE2
     },
     course: {
-      gradingScheme: "STANDARD",
-      level: {
-        elementary: "Elementary",
-        middle: "Middle",
-        high: "High",
-        ap: "AP"
-      },
-      metadata: {
-        goals: {
-          dailyXp: 50,
-          dailyLessons: 3
-        },
-        metrics: {
-          totalXp: 1e3,
-          totalLessons: 50
-        }
-      }
-    },
-    component: {
-      sortOrder: 1,
-      prerequisiteCriteria: "ALL"
-    },
-    resource: {
-      vendorId: "playcademy",
-      roles: ["primary"],
-      importance: "primary",
+      gradingScheme: TIMEBACK_COURSE_DEFAULTS2.gradingScheme,
+      level: TIMEBACK_COURSE_DEFAULTS2.level,
       metadata: {
-        type: "interactive",
-        toolProvider: "Playcademy",
-        instructionalMethod: "exploratory",
-        language: "en-US"
+        goals: TIMEBACK_COURSE_DEFAULTS2.goals,
+        metrics: TIMEBACK_COURSE_DEFAULTS2.metrics
       }
     },
-    componentResource: {
-      sortOrder: 1,
-      lessonType: "quiz"
-    }
+    component: TIMEBACK_COMPONENT_DEFAULTS2,
+    resource: TIMEBACK_RESOURCE_DEFAULTS2,
+    componentResource: TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2
   };
   HTTP_STATUS2 = {
     CLIENT_ERROR_MIN: 400,
@@ -4744,7 +4772,7 @@ function deriveLevelFromGrades(grades) {
 }
 function deriveSourcedIds(courseId) {
   return {
-    organization: PLAYCADEMY_DEFAULTS.organization,
+    organization: process.env.TIMEBACK_ORG_SOURCED_ID || PLAYCADEMY_DEFAULTS.organization,
     course: courseId,
     component: `${courseId}-component`,
     resource: `${courseId}-resource`,
@@ -4814,7 +4842,7 @@ function derivePlatformTimebackSetupRequest(config) {
   const defaultOrganization = {
     name: RESOURCE_DEFAULTS.organization.name,
     type: RESOURCE_DEFAULTS.organization.type,
-    identifier: PLAYCADEMY_DEFAULTS.organization
+    identifier: process.env.TIMEBACK_ORG_SOURCED_ID || PLAYCADEMY_DEFAULTS.organization
   };
   const defaultComponent = {
     title: "",
@@ -5577,7 +5605,7 @@ import { join as join12 } from "path";
 // package.json
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.24",
+  version: "0.14.25",
   type: "module",
   exports: {
     ".": {
@@ -7010,42 +7038,6 @@ import { existsSync as existsSync16, mkdirSync as mkdirSync4, readFileSync as re
 import { createServer } from "node:net";
 import { homedir as homedir3 } from "node:os";
 import { join as join22 } from "node:path";
-async function isPortAvailableOnHost(port, host) {
-  return new Promise((resolve11) => {
-    const server = createServer();
-    let resolved = false;
-    const cleanup = (result) => {
-      if (resolved) return;
-      resolved = true;
-      try {
-        server.close();
-      } catch {
-      }
-      resolve11(result);
-    };
-    const timeout = setTimeout(() => cleanup(true), 100);
-    server.once("error", (err) => {
-      clearTimeout(timeout);
-      if (err.code === "EAFNOSUPPORT" || err.code === "EADDRNOTAVAIL") {
-        cleanup(true);
-      } else {
-        cleanup(false);
-      }
-    });
-    server.once("listening", () => {
-      clearTimeout(timeout);
-      cleanup(true);
-    });
-    server.listen(port, host).unref();
-  });
-}
-async function findAvailablePort(startPort = 4321) {
-  if (await isPortAvailableOnHost(startPort, "0.0.0.0")) {
-    return startPort;
-  } else {
-    return findAvailablePort(startPort + 1);
-  }
-}
 function getRegistryPath() {
   const home = homedir3();
   const dir = join22(home, ".playcademy");
@@ -7140,6 +7132,31 @@ function cleanupServerInfo(type, projectRoot, pid) {
     writeRegistry(registry);
   }
 }
+async function isPortInUse(port) {
+  return new Promise((resolve11) => {
+    const server = createServer();
+    server.once("error", () => {
+      resolve11(true);
+    });
+    server.once("listening", () => {
+      server.close();
+      resolve11(false);
+    });
+    server.listen(port);
+  });
+}
+async function waitForPort(port, timeoutMs = 5e3) {
+  const start = Date.now();
+  while (await isPortInUse(port)) {
+    if (Date.now() - start > timeoutMs) {
+      throw new Error(
+        `Port ${port} is already in use.
+Stop the other server or specify a different port with --port <number>.`
+      );
+    }
+    await new Promise((resolve11) => setTimeout(resolve11, 100));
+  }
+}
 
 // src/lib/deploy/bundle.ts
 import { existsSync as existsSync17 } from "fs";
@@ -7614,15 +7631,9 @@ var FilteredLog = class extends Log {
   }
 };
 async function startDevServer(options) {
-  const {
-    port: preferredPort,
-    config: providedConfig,
-    platformUrl,
-    logger: logger2 = true,
-    customLogger
-  } = options;
-  const port = await findAvailablePort(preferredPort);
-  const config = providedConfig ?? await loadConfig();
+  const { port, config: _config, platformUrl, logger: logger2 = true, customLogger } = options;
+  await waitForPort(port);
+  const config = _config ?? await loadConfig();
   await ensurePlaycademyTypes();
   const hasSandboxTimebackCreds = !!process.env.TIMEBACK_API_CLIENT_ID;
   const devConfig = config.integrations?.timeback && !hasSandboxTimebackCreds ? { ...config, integrations: { ...config.integrations, timeback: null } } : config;
@@ -7638,7 +7649,7 @@ async function startDevServer(options) {
   const bucketDir = hasBucket ? await ensureBucketDirectory() : void 0;
   const workspace = getWorkspace();
   const envSecrets = await readEnvFile(workspace);
-  const log2 = logger2 ? new FilteredLog(LogLevel.INFO, customLogger) : new Log(LogLevel.NONE);
+  const filteredLog = logger2 ? new FilteredLog(LogLevel.INFO, customLogger) : new Log(LogLevel.NONE);
   const sandboxInfo = readServerInfo("sandbox", workspace);
   const baseUrl = platformUrl ?? sandboxInfo?.url ?? process.env.PLAYCADEMY_BASE_URL ?? `http://localhost:${DEFAULT_PORTS.SANDBOX}`;
   const bindings = {
@@ -7651,7 +7662,7 @@ async function startDevServer(options) {
   }
   const mf = new Miniflare({
     port,
-    log: log2,
+    log: filteredLog,
     modules: [
       {
         type: "ESModule",

package/dist/templates/config/integrations-config.js.template

@@ -1,7 +1,7 @@
 
 
     // External integrations
-    // See https://docs.playcademy.net/integrations/overview.html for more details
+    // See https://docs.playcademy.net/platform/vite-plugin for more details
     integrations: {
 {{INTEGRATIONS_CONTENT}}
     },

package/dist/utils.js

@@ -3214,42 +3214,6 @@ import { existsSync as existsSync3, mkdirSync, readFileSync, writeFileSync } fro
 import { createServer } from "node:net";
 import { homedir } from "node:os";
 import { join as join7 } from "node:path";
-async function isPortAvailableOnHost(port, host) {
-  return new Promise((resolve4) => {
-    const server = createServer();
-    let resolved = false;
-    const cleanup = (result) => {
-      if (resolved) return;
-      resolved = true;
-      try {
-        server.close();
-      } catch {
-      }
-      resolve4(result);
-    };
-    const timeout = setTimeout(() => cleanup(true), 100);
-    server.once("error", (err) => {
-      clearTimeout(timeout);
-      if (err.code === "EAFNOSUPPORT" || err.code === "EADDRNOTAVAIL") {
-        cleanup(true);
-      } else {
-        cleanup(false);
-      }
-    });
-    server.once("listening", () => {
-      clearTimeout(timeout);
-      cleanup(true);
-    });
-    server.listen(port, host).unref();
-  });
-}
-async function findAvailablePort(startPort = 4321) {
-  if (await isPortAvailableOnHost(startPort, "0.0.0.0")) {
-    return startPort;
-  } else {
-    return findAvailablePort(startPort + 1);
-  }
-}
 function getRegistryPath() {
   const home = homedir();
   const dir = join7(home, ".playcademy");
@@ -3295,6 +3259,31 @@ function readServerInfo(type, projectRoot) {
   }
   return servers[0] || null;
 }
+async function isPortInUse(port) {
+  return new Promise((resolve4) => {
+    const server = createServer();
+    server.once("error", () => {
+      resolve4(true);
+    });
+    server.once("listening", () => {
+      server.close();
+      resolve4(false);
+    });
+    server.listen(port);
+  });
+}
+async function waitForPort(port, timeoutMs = 5e3) {
+  const start = Date.now();
+  while (await isPortInUse(port)) {
+    if (Date.now() - start > timeoutMs) {
+      throw new Error(
+        `Port ${port} is already in use.
+Stop the other server or specify a different port with --port <number>.`
+      );
+    }
+    await new Promise((resolve4) => setTimeout(resolve4, 100));
+  }
+}
 
 // src/lib/core/client.ts
 import { PlaycademyClient } from "@playcademy/sdk/internal";
@@ -4003,7 +3992,7 @@ import { join as join12 } from "path";
 // package.json
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.24",
+  version: "0.14.25",
   type: "module",
   exports: {
     ".": {
@@ -4386,15 +4375,9 @@ var FilteredLog = class extends Log {
   }
 };
 async function startDevServer(options) {
-  const {
-    port: preferredPort,
-    config: providedConfig,
-    platformUrl,
-    logger: logger2 = true,
-    customLogger
-  } = options;
-  const port = await findAvailablePort(preferredPort);
-  const config = providedConfig ?? await loadConfig();
+  const { port, config: _config, platformUrl, logger: logger2 = true, customLogger } = options;
+  await waitForPort(port);
+  const config = _config ?? await loadConfig();
   await ensurePlaycademyTypes();
   const hasSandboxTimebackCreds = !!process.env.TIMEBACK_API_CLIENT_ID;
   const devConfig = config.integrations?.timeback && !hasSandboxTimebackCreds ? { ...config, integrations: { ...config.integrations, timeback: null } } : config;
@@ -4410,7 +4393,7 @@ async function startDevServer(options) {
   const bucketDir = hasBucket ? await ensureBucketDirectory() : void 0;
   const workspace = getWorkspace();
   const envSecrets = await readEnvFile(workspace);
-  const log2 = logger2 ? new FilteredLog(LogLevel.INFO, customLogger) : new Log(LogLevel.NONE);
+  const filteredLog = logger2 ? new FilteredLog(LogLevel.INFO, customLogger) : new Log(LogLevel.NONE);
   const sandboxInfo = readServerInfo("sandbox", workspace);
   const baseUrl = platformUrl ?? sandboxInfo?.url ?? process.env.PLAYCADEMY_BASE_URL ?? `http://localhost:${DEFAULT_PORTS.SANDBOX}`;
   const bindings = {
@@ -4423,7 +4406,7 @@ async function startDevServer(options) {
   }
   const mf = new Miniflare({
     port,
-    log: log2,
+    log: filteredLog,
     modules: [
       {
         type: "ESModule",

package/dist/version.js

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "playcademy",
-  version: "0.14.24",
+  version: "0.14.25",
   type: "module",
   exports: {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.14.25",
+    "version": "0.14.26",
     "type": "module",
     "exports": {
         ".": {