@timeback/qti 0.1.0 → 0.1.2

package/dist/constants.d.ts

@@ -6,12 +6,17 @@
 import type { ClientUrlMaps, Platform } from '@timeback/internal-client-infra';
 /**
  * Environment variable names for fallback config.
+ *
+ * Supports fallback chains - tries each env var in order until one is defined:
+ * - `TIMEBACK_API_*` (canonical/preferred)
+ * - `TIMEBACK_*` (unified Timeback shorthand)
+ * - `QTI_*` (service-specific legacy)
  */
 export declare const QTI_ENV_VARS: {
-    readonly baseUrl: "QTI_BASE_URL";
-    readonly clientId: "QTI_CLIENT_ID";
-    readonly clientSecret: "QTI_CLIENT_SECRET";
-    readonly authUrl: "QTI_TOKEN_URL";
+    readonly baseUrl: readonly ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "QTI_BASE_URL"];
+    readonly clientId: readonly ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "QTI_CLIENT_ID"];
+    readonly clientSecret: readonly ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "QTI_CLIENT_SECRET"];
+    readonly authUrl: readonly ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "QTI_TOKEN_URL"];
 };
 /**
  * Get URL maps for a specific platform.

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAM9E;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAA;AAMV;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,QAA2B,GAAG,aAAa,CAM1F"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAM9E;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAA;AAMV;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,QAA2B,GAAG,aAAa,CAM1F"}

package/dist/errors.js

@@ -15,6 +15,15 @@ var __toESM = (mod, isNodeMode, target) => {
       });
   return to;
 };
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../internal/constants/src/endpoints.ts
@@ -68,9 +77,12 @@ var PLATFORM_ENDPOINTS = {
 // ../../internal/constants/src/typescript.ts
 var TypeScriptPackages = {
   tsc: "tsc",
-  nativePreview: "@typescript/native-preview@7.0.0-dev.20251217.1"
+  nativePreview: "@typescript/native-preview"
+};
+var TYPESCRIPT_RUNNER = {
+  package: TypeScriptPackages.nativePreview,
+  bin: "tsgo"
 };
-var TYPESCRIPT_PACKAGE = TypeScriptPackages.nativePreview;
 // ../../internal/logger/src/debug.ts
 var patterns = null;
 var debugAll = false;
@@ -475,6 +487,9 @@ var BEYONDAI_PATHS = {
   },
   edubridge: {
     base: "/edubridge"
+  },
+  powerpath: {
+    base: "/powerpath"
   }
 };
 var LEARNWITHAI_PATHS = {
@@ -490,7 +505,8 @@ var LEARNWITHAI_PATHS = {
     gradebook: "/gradebook/1.0",
     resources: "/resources/1.0"
   },
-  edubridge: null
+  edubridge: null,
+  powerpath: null
 };
 var PLATFORM_PATHS = {
   BEYOND_AI: BEYONDAI_PATHS,
@@ -512,7 +528,8 @@ function resolvePathProfiles(pathProfile, customPaths) {
   return {
     caliper: customPaths?.caliper ?? basePaths.caliper,
     oneroster: customPaths?.oneroster ?? basePaths.oneroster,
-    edubridge: customPaths?.edubridge ?? basePaths.edubridge
+    edubridge: customPaths?.edubridge ?? basePaths.edubridge,
+    powerpath: customPaths?.powerpath ?? basePaths.powerpath
   };
 }
 
@@ -548,6 +565,10 @@ class TimebackProvider {
           baseUrl: platformEndpoints.api[env],
           authUrl: this.authUrl
         },
+        powerpath: {
+          baseUrl: platformEndpoints.api[env],
+          authUrl: this.authUrl
+        },
         caliper: {
           baseUrl: platformEndpoints.caliper[env],
           authUrl: this.authUrl
@@ -564,6 +585,7 @@ class TimebackProvider {
       this.endpoints = {
         oneroster: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         edubridge: { baseUrl: config.baseUrl, authUrl: this.authUrl },
+        powerpath: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         caliper: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         qti: { baseUrl: config.baseUrl, authUrl: this.authUrl }
       };
@@ -682,7 +704,17 @@ class TimebackProvider {
 // ../../internal/client-infra/src/utils/utils.ts
 function getEnv(key) {
   try {
-    return typeof process === "undefined" ? undefined : process.env[key];
+    if (typeof process === "undefined")
+      return;
+    if (typeof key === "string") {
+      return process.env[key];
+    }
+    for (const k of key) {
+      const value = process.env[k];
+      if (value !== undefined)
+        return value;
+    }
+    return;
   } catch {
     return;
   }
@@ -716,6 +748,18 @@ var DEFAULT_PROVIDER_REGISTRY = {
 };
 
 // ../../internal/client-infra/src/config/resolve.ts
+function primaryEnvVar(key) {
+  if (typeof key === "string") {
+    return key;
+  }
+  if (key.length === 0) {
+    throw new Error(`Missing env var key: ${key}`);
+  }
+  return key[0];
+}
+function formatEnvVarKey(key) {
+  return primaryEnvVar(key);
+}
 function validateEnv(env) {
   if (env !== "staging" && env !== "production") {
     throw new Error(`Invalid env "${env}": must be "staging" or "production"`);
@@ -726,10 +770,10 @@ function validateAuth(auth, envVars) {
   const clientId = auth?.clientId ?? getEnv(envVars.clientId);
   const clientSecret = auth?.clientSecret ?? getEnv(envVars.clientSecret);
   if (!clientId) {
-    throw new Error(`Missing clientId: provide in config or set ${envVars.clientId}`);
+    throw new Error(`Missing clientId: provide in config or set ${formatEnvVarKey(envVars.clientId)}`);
   }
   if (!clientSecret) {
-    throw new Error(`Missing clientSecret: provide in config or set ${envVars.clientSecret}`);
+    throw new Error(`Missing clientSecret: provide in config or set ${formatEnvVarKey(envVars.clientSecret)}`);
   }
   return { clientId, clientSecret };
 }
@@ -745,21 +789,21 @@ function buildMissingEnvError(envVars) {
   const clientId = getEnv(envVars.clientId);
   const clientSecret = getEnv(envVars.clientSecret);
   if (baseUrl === undefined && clientId === undefined) {
-    const hint = envVars.env ?? envVars.baseUrl;
+    const hint = formatEnvVarKey(envVars.env ?? envVars.baseUrl);
     return `Missing env: provide in config or set ${hint}`;
   }
   const missing = [];
   if (baseUrl === undefined) {
-    missing.push(envVars.env ?? envVars.baseUrl);
+    missing.push(formatEnvVarKey(envVars.env ?? envVars.baseUrl));
   }
   if (baseUrl !== undefined && authUrl === undefined) {
-    missing.push(envVars.authUrl);
+    missing.push(formatEnvVarKey(envVars.authUrl));
   }
   if (clientId === undefined) {
-    missing.push(envVars.clientId);
+    missing.push(formatEnvVarKey(envVars.clientId));
   }
   if (clientSecret === undefined) {
-    missing.push(envVars.clientSecret);
+    missing.push(formatEnvVarKey(envVars.clientSecret));
   }
   return `Missing environment variables: ${missing.join(", ")}`;
 }
@@ -971,6 +1015,27 @@ class ValidationError extends ApiError {
     super(message, 422, response);
   }
 }
+
+class InputValidationError extends ApiError {
+  name = "InputValidationError";
+  issues;
+  constructor(message, issues) {
+    const response = {
+      imsx_codeMajor: "failure",
+      imsx_severity: "error",
+      imsx_description: message,
+      imsx_error_details: issues.map((issue) => ({
+        path: issue.path,
+        message: issue.message
+      }))
+    };
+    super(message, 400, response);
+    this.issues = issues;
+  }
+}
+function createInputValidationError(message, issues) {
+  return new InputValidationError(message, issues);
+}
 // ../../internal/client-infra/src/transport/constants.ts
 var MAX_RETRIES = 3;
 var RETRY_STATUS_CODES = [429, 503];
@@ -1396,10 +1461,57 @@ class Paginator {
     };
   }
 }
+// ../../internal/client-infra/src/validation/index.ts
+function issue(path, message) {
+  return { path, message };
+}
+function validateWithSchema(schema, data, context) {
+  const result = schema.safeParse(data);
+  if (result.success) {
+    return;
+  }
+  const issues = result.error.issues.map((errorIssue) => ({
+    path: errorIssue.path.join(".") || "(root)",
+    message: errorIssue.message
+  }));
+  throw createInputValidationError(`Invalid ${context} data`, issues);
+}
+function validateNonEmptyString(value, name) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw createInputValidationError(`Invalid ${name}`, [
+      issue(name, "Must be a non-empty string")
+    ]);
+  }
+}
+function validatePageListParams(params) {
+  if (!params) {
+    return;
+  }
+  const issues = [];
+  if (params.page !== undefined) {
+    if (!Number.isInteger(params.page) || params.page <= 0) {
+      issues.push(issue("page", "Must be a positive integer"));
+    }
+  }
+  if (params.limit !== undefined) {
+    if (!Number.isInteger(params.limit) || params.limit <= 0) {
+      issues.push(issue("limit", "Must be a positive integer"));
+    }
+  }
+  if (params.max !== undefined) {
+    if (!Number.isInteger(params.max) || params.max <= 0) {
+      issues.push(issue("max", "Must be a positive integer"));
+    }
+  }
+  if (issues.length > 0) {
+    throw createInputValidationError("Invalid list parameters", issues);
+  }
+}
 export {
   ValidationError,
   UnauthorizedError,
   ApiError as QtiError,
   NotFoundError,
+  InputValidationError,
   ForbiddenError
 };