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

package/dist/server.js

@@ -1,3 +1,204 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+// ../utils/src/file-loader.ts
+import { existsSync, readdirSync, statSync } from "fs";
+import { readFile } from "fs/promises";
+import { dirname, parse, resolve } from "path";
+function findFilePath(filename, startDir, maxLevels = 3) {
+  const filenames = Array.isArray(filename) ? filename : [filename];
+  let currentDir = resolve(startDir);
+  let levelsSearched = 0;
+  while (levelsSearched <= maxLevels) {
+    for (const fname of filenames) {
+      const filePath = resolve(currentDir, fname);
+      if (existsSync(filePath)) {
+        return {
+          path: filePath,
+          dir: currentDir,
+          filename: fname
+        };
+      }
+    }
+    if (levelsSearched >= maxLevels) {
+      break;
+    }
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      break;
+    }
+    const parsed = parse(currentDir);
+    if (parsed.root === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+    levelsSearched++;
+  }
+  return null;
+}
+async function loadFile(filename, options = {}) {
+  const {
+    cwd = process.cwd(),
+    required = false,
+    searchUp = false,
+    maxLevels = 3,
+    parseJson = false,
+    stripComments = false
+  } = options;
+  let fileResult;
+  if (searchUp) {
+    fileResult = findFilePath(filename, cwd, maxLevels);
+  } else {
+    const filenames = Array.isArray(filename) ? filename : [filename];
+    fileResult = null;
+    for (const fname of filenames) {
+      const filePath = resolve(cwd, fname);
+      if (existsSync(filePath)) {
+        fileResult = {
+          path: filePath,
+          dir: cwd,
+          filename: fname
+        };
+        break;
+      }
+    }
+  }
+  if (!fileResult) {
+    if (required) {
+      const fileList = Array.isArray(filename) ? filename.join(" or ") : filename;
+      const message = searchUp ? `${fileList} not found in ${cwd} or up to ${maxLevels} parent directories` : `${fileList} not found at ${cwd}`;
+      throw new Error(message);
+    }
+    return null;
+  }
+  try {
+    let content = await readFile(fileResult.path, "utf8");
+    if (parseJson) {
+      if (stripComments) {
+        content = stripJsonComments(content);
+      }
+      return JSON.parse(content);
+    }
+    return content;
+  } catch (error) {
+    throw new Error(`Failed to load ${fileResult.filename} from ${fileResult.path}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+  }
+}
+async function findFile(filename, options = {}) {
+  const { cwd = process.cwd(), searchUp = false, maxLevels = 3 } = options;
+  if (searchUp) {
+    return findFilePath(filename, cwd, maxLevels);
+  }
+  const filenames = Array.isArray(filename) ? filename : [filename];
+  for (const fname of filenames) {
+    const filePath = resolve(cwd, fname);
+    if (existsSync(filePath)) {
+      return {
+        path: filePath,
+        dir: cwd,
+        filename: fname
+      };
+    }
+  }
+  return null;
+}
+function stripJsonComments(jsonc) {
+  let result = jsonc.replace(/\/\*[\s\S]*?\*\//g, "");
+  result = result.replace(/\/\/.*/g, "");
+  return result;
+}
+var init_file_loader = () => {};
+
+// src/server/utils/config-loader.ts
+var exports_config_loader = {};
+__export(exports_config_loader, {
+  loadConfig: () => loadConfig,
+  findConfigPath: () => findConfigPath
+});
+import { resolve as resolve2 } from "path";
+async function findConfigPath(configPath) {
+  if (configPath) {
+    return resolve2(configPath);
+  }
+  const result = await findFile(["playcademy.config.js", "playcademy.config.mjs", "playcademy.config.json"], {
+    searchUp: true,
+    maxLevels: 3
+  });
+  if (!result) {
+    throw new Error("playcademy.config.js not found. Please create a playcademy.config.js file or specify the config path.");
+  }
+  return result.path;
+}
+async function loadConfig(configPath) {
+  try {
+    let config;
+    let actualPath;
+    if (configPath) {
+      actualPath = resolve2(configPath);
+      if (actualPath.endsWith(".json")) {
+        config = await loadFile(actualPath, { required: true, parseJson: true });
+      } else {
+        const module = await import(actualPath);
+        config = module.default || module;
+      }
+    } else {
+      actualPath = await findConfigPath();
+      if (actualPath.endsWith(".json")) {
+        config = await loadFile(actualPath, { required: true, parseJson: true });
+      } else {
+        const module = await import(actualPath);
+        config = module.default || module;
+      }
+    }
+    if (!config || typeof config !== "object") {
+      throw new Error("Config file must export/contain an object");
+    }
+    validateConfig(config);
+    return config;
+  } catch (error) {
+    throw new Error(`Failed to load config file: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+  }
+}
+function validateConfig(config) {
+  if (!config || typeof config !== "object") {
+    throw new Error("Configuration must be an object");
+  }
+  const cfg = config;
+  if (!cfg.name || typeof cfg.name !== "string") {
+    throw new Error("Missing required field: name");
+  }
+  if (cfg.timeback) {
+    if (typeof cfg.timeback !== "object") {
+      throw new Error("timeback must be an object if provided");
+    }
+    const tb = cfg.timeback;
+    if (!tb.course) {
+      throw new Error("timeback.course is required for TimeBack integration");
+    }
+    if (typeof tb.course !== "object") {
+      throw new Error("timeback.course must be an object");
+    }
+    const course = tb.course;
+    if (!course.subjects || !Array.isArray(course.subjects) || course.subjects.length === 0) {
+      throw new Error("timeback.course.subjects is required (array of subjects)");
+    }
+    if (!course.grades || !Array.isArray(course.grades) || course.grades.length === 0) {
+      throw new Error("timeback.course.grades is required (array of grade levels)");
+    }
+  }
+}
+var init_config_loader = __esm(() => {
+  init_file_loader();
+});
+
 // src/core/guards.ts
 var VALID_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
 var VALID_SUBJECTS = [
@@ -211,207 +412,27 @@ async function makeApiRequest(baseUrl, apiToken, endpoint, method = "GET", body)
   return await response.json();
 }
 
-// src/server/utils/config-loader.ts
-import { resolve as resolve2 } from "path";
-
-// ../utils/src/file-loader.ts
-import { existsSync, readdirSync, statSync } from "fs";
-import { readFile } from "fs/promises";
-import { dirname, parse, resolve } from "path";
-function findFilePath(filename, startDir, maxLevels = 3) {
-  const filenames = Array.isArray(filename) ? filename : [filename];
-  let currentDir = resolve(startDir);
-  let levelsSearched = 0;
-  while (levelsSearched <= maxLevels) {
-    for (const fname of filenames) {
-      const filePath = resolve(currentDir, fname);
-      if (existsSync(filePath)) {
-        return {
-          path: filePath,
-          dir: currentDir,
-          filename: fname
-        };
-      }
-    }
-    if (levelsSearched >= maxLevels) {
-      break;
-    }
-    const parentDir = dirname(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    const parsed = parse(currentDir);
-    if (parsed.root === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-    levelsSearched++;
-  }
-  return null;
-}
-async function loadFile(filename, options = {}) {
-  const {
-    cwd = process.cwd(),
-    required = false,
-    searchUp = false,
-    maxLevels = 3,
-    parseJson = false,
-    stripComments = false
-  } = options;
-  let fileResult;
-  if (searchUp) {
-    fileResult = findFilePath(filename, cwd, maxLevels);
-  } else {
-    const filenames = Array.isArray(filename) ? filename : [filename];
-    fileResult = null;
-    for (const fname of filenames) {
-      const filePath = resolve(cwd, fname);
-      if (existsSync(filePath)) {
-        fileResult = {
-          path: filePath,
-          dir: cwd,
-          filename: fname
-        };
-        break;
-      }
-    }
-  }
-  if (!fileResult) {
-    if (required) {
-      const fileList = Array.isArray(filename) ? filename.join(" or ") : filename;
-      const message = searchUp ? `${fileList} not found in ${cwd} or up to ${maxLevels} parent directories` : `${fileList} not found at ${cwd}`;
-      throw new Error(message);
-    }
-    return null;
-  }
-  try {
-    let content = await readFile(fileResult.path, "utf8");
-    if (parseJson) {
-      if (stripComments) {
-        content = stripJsonComments(content);
-      }
-      return JSON.parse(content);
-    }
-    return content;
-  } catch (error) {
-    throw new Error(`Failed to load ${fileResult.filename} from ${fileResult.path}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-  }
-}
-async function findFile(filename, options = {}) {
-  const { cwd = process.cwd(), searchUp = false, maxLevels = 3 } = options;
-  if (searchUp) {
-    return findFilePath(filename, cwd, maxLevels);
-  }
-  const filenames = Array.isArray(filename) ? filename : [filename];
-  for (const fname of filenames) {
-    const filePath = resolve(cwd, fname);
-    if (existsSync(filePath)) {
-      return {
-        path: filePath,
-        dir: cwd,
-        filename: fname
-      };
-    }
-  }
-  return null;
-}
-function stripJsonComments(jsonc) {
-  let result = jsonc.replace(/\/\*[\s\S]*?\*\//g, "");
-  result = result.replace(/\/\/.*/g, "");
-  return result;
-}
-
-// src/server/utils/config-loader.ts
-async function findConfigPath(configPath) {
-  if (configPath) {
-    return resolve2(configPath);
-  }
-  const result = await findFile(["playcademy.config.js", "playcademy.config.mjs", "playcademy.config.json"], {
-    searchUp: true,
-    maxLevels: 3
-  });
-  if (!result) {
-    throw new Error("playcademy.config.js not found. Please create a playcademy.config.js file or specify the config path.");
-  }
-  return result.path;
-}
-async function loadConfig(configPath) {
-  try {
-    let config;
-    let actualPath;
-    if (configPath) {
-      actualPath = resolve2(configPath);
-      if (actualPath.endsWith(".json")) {
-        config = await loadFile(actualPath, { required: true, parseJson: true });
-      } else {
-        const module = await import(actualPath);
-        config = module.default || module;
-      }
-    } else {
-      actualPath = await findConfigPath();
-      if (actualPath.endsWith(".json")) {
-        config = await loadFile(actualPath, { required: true, parseJson: true });
-      } else {
-        const module = await import(actualPath);
-        config = module.default || module;
-      }
-    }
-    if (!config || typeof config !== "object") {
-      throw new Error("Config file must export/contain an object");
-    }
-    validateConfig(config);
-    return config;
-  } catch (error) {
-    throw new Error(`Failed to load config file: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-  }
-}
-function validateConfig(config) {
-  if (!config || typeof config !== "object") {
-    throw new Error("Configuration must be an object");
-  }
-  const cfg = config;
-  if (!cfg.name || typeof cfg.name !== "string") {
-    throw new Error("Missing required field: name");
-  }
-  if (cfg.timeback) {
-    if (typeof cfg.timeback !== "object") {
-      throw new Error("timeback must be an object if provided");
-    }
-    const tb = cfg.timeback;
-    if (!tb.course) {
-      throw new Error("timeback.course is required for TimeBack integration");
-    }
-    if (typeof tb.course !== "object") {
-      throw new Error("timeback.course must be an object");
-    }
-    const course = tb.course;
-    if (!course.subjects || !Array.isArray(course.subjects) || course.subjects.length === 0) {
-      throw new Error("timeback.course.subjects is required (array of subjects)");
-    }
-    if (!course.grades || !Array.isArray(course.grades) || course.grades.length === 0) {
-      throw new Error("timeback.course.grades is required (array of grade levels)");
-    }
-  }
-}
-
-// src/server/client.ts
+// src/server/client-base.ts
 class PlaycademyClient {
   state;
   constructor(state) {
     this.state = state;
   }
   static async init(config) {
-    const { apiKey, configPath, baseUrl, gameId } = config;
+    const { apiKey, baseUrl, gameId } = config;
     if (!apiKey || typeof apiKey !== "string") {
       throw new Error("[Playcademy SDK] apiKey is required");
     }
-    const finalBaseUrl = baseUrl || process.env.PLAYCADEMY_BASE_URL || "https://hub.playcademy.net";
-    const loadedConfig = config.config || await loadConfig(configPath);
+    if (!config.config) {
+      throw new Error("[Playcademy SDK] config is required in edge environments. " + "Pass config directly, or use PlaycademyClient from @playcademy/sdk/server " + "for filesystem-based config loading.");
+    }
+    const envBaseUrl = typeof process !== "undefined" ? process.env?.PLAYCADEMY_BASE_URL : undefined;
+    const finalBaseUrl = baseUrl || envBaseUrl || "https://hub.playcademy.net";
     const state = {
       apiKey,
       baseUrl: finalBaseUrl,
       gameId: gameId || "",
-      config: loadedConfig
+      config: config.config
     };
     const client = new PlaycademyClient(state);
     if (!gameId) {
@@ -433,6 +454,18 @@ class PlaycademyClient {
   }
   timeback = createTimebackNamespace(this);
 }
+
+// src/server/client.ts
+class PlaycademyClient2 extends PlaycademyClient {
+  static async init(config) {
+    if (config.config) {
+      return super.init(config);
+    }
+    const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config_loader(), exports_config_loader));
+    const loadedConfig = await loadConfig2(config.configPath);
+    return super.init({ ...config, config: loadedConfig });
+  }
+}
 // src/server/utils/verify-game-token.ts
 async function verifyGameToken(gameToken, options) {
   if (!gameToken || typeof gameToken !== "string") {
@@ -487,5 +520,5 @@ Please set the PLAYCADEMY_BASE_URL environment variable`);
 }
 export {
   verifyGameToken,
-  PlaycademyClient
+  PlaycademyClient2 as PlaycademyClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.3.7-beta.1",
+    "version": "0.3.7-beta.2",
     "type": "module",
     "exports": {
         ".": {
@@ -23,6 +23,11 @@
             "import": "./dist/internal.js",
             "require": "./dist/internal.js"
         },
+        "./server/edge": {
+            "types": "./dist/server/edge.d.ts",
+            "import": "./dist/server/edge.js",
+            "require": "./dist/server/edge.js"
+        },
         "./test": {
             "import": "./src/test.ts",
             "types": "./src/test.ts"