@timeback/core 0.1.3 → 0.1.5

package/dist/utils.js

@@ -1,20 +1,4 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -24,7 +8,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // ../edubridge/dist/index.js
 var __defProp2 = Object.defineProperty;
@@ -37,6 +21,423 @@ var __export2 = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var exports_util = {};
+__export2(exports_util, {
+  types: () => types,
+  promisify: () => promisify,
+  log: () => log,
+  isUndefined: () => isUndefined,
+  isSymbol: () => isSymbol,
+  isString: () => isString,
+  isRegExp: () => isRegExp,
+  isPrimitive: () => isPrimitive,
+  isObject: () => isObject,
+  isNumber: () => isNumber,
+  isNullOrUndefined: () => isNullOrUndefined,
+  isNull: () => isNull,
+  isFunction: () => isFunction,
+  isError: () => isError,
+  isDate: () => isDate,
+  isBuffer: () => isBuffer,
+  isBoolean: () => isBoolean,
+  isArray: () => isArray,
+  inspect: () => inspect,
+  inherits: () => inherits,
+  format: () => format,
+  deprecate: () => deprecate,
+  default: () => util_default,
+  debuglog: () => debuglog,
+  callbackifyOnRejected: () => callbackifyOnRejected,
+  callbackify: () => callbackify,
+  _extend: () => _extend,
+  TextEncoder: () => TextEncoder,
+  TextDecoder: () => TextDecoder
+});
+function format(f, ...args) {
+  if (!isString(f)) {
+    var objects = [f];
+    for (var i = 0;i < args.length; i++)
+      objects.push(inspect(args[i]));
+    return objects.join(" ");
+  }
+  var i = 0, len = args.length, str = String(f).replace(formatRegExp, function(x2) {
+    if (x2 === "%%")
+      return "%";
+    if (i >= len)
+      return x2;
+    switch (x2) {
+      case "%s":
+        return String(args[i++]);
+      case "%d":
+        return Number(args[i++]);
+      case "%j":
+        try {
+          return JSON.stringify(args[i++]);
+        } catch (_) {
+          return "[Circular]";
+        }
+      default:
+        return x2;
+    }
+  });
+  for (var x = args[i];i < len; x = args[++i])
+    if (isNull(x) || !isObject(x))
+      str += " " + x;
+    else
+      str += " " + inspect(x);
+  return str;
+}
+function deprecate(fn, msg) {
+  if (typeof process > "u" || process?.noDeprecation === true)
+    return fn;
+  var warned = false;
+  function deprecated(...args) {
+    if (!warned) {
+      if (process.throwDeprecation)
+        throw Error(msg);
+      else if (process.traceDeprecation)
+        console.trace(msg);
+      else
+        console.error(msg);
+      warned = true;
+    }
+    return fn.apply(this, ...args);
+  }
+  return deprecated;
+}
+function stylizeWithColor(str, styleType) {
+  var style = inspect.styles[styleType];
+  if (style)
+    return "\x1B[" + inspect.colors[style][0] + "m" + str + "\x1B[" + inspect.colors[style][1] + "m";
+  else
+    return str;
+}
+function stylizeNoColor(str, styleType) {
+  return str;
+}
+function arrayToHash(array) {
+  var hash = {};
+  return array.forEach(function(val, idx) {
+    hash[val] = true;
+  }), hash;
+}
+function formatValue(ctx, value, recurseTimes) {
+  if (ctx.customInspect && value && isFunction(value.inspect) && value.inspect !== inspect && !(value.constructor && value.constructor.prototype === value)) {
+    var ret = value.inspect(recurseTimes, ctx);
+    if (!isString(ret))
+      ret = formatValue(ctx, ret, recurseTimes);
+    return ret;
+  }
+  var primitive = formatPrimitive(ctx, value);
+  if (primitive)
+    return primitive;
+  var keys = Object.keys(value), visibleKeys = arrayToHash(keys);
+  if (ctx.showHidden)
+    keys = Object.getOwnPropertyNames(value);
+  if (isError(value) && (keys.indexOf("message") >= 0 || keys.indexOf("description") >= 0))
+    return formatError(value);
+  if (keys.length === 0) {
+    if (isFunction(value)) {
+      var name = value.name ? ": " + value.name : "";
+      return ctx.stylize("[Function" + name + "]", "special");
+    }
+    if (isRegExp(value))
+      return ctx.stylize(RegExp.prototype.toString.call(value), "regexp");
+    if (isDate(value))
+      return ctx.stylize(Date.prototype.toString.call(value), "date");
+    if (isError(value))
+      return formatError(value);
+  }
+  var base = "", array = false, braces = ["{", "}"];
+  if (isArray(value))
+    array = true, braces = ["[", "]"];
+  if (isFunction(value)) {
+    var n = value.name ? ": " + value.name : "";
+    base = " [Function" + n + "]";
+  }
+  if (isRegExp(value))
+    base = " " + RegExp.prototype.toString.call(value);
+  if (isDate(value))
+    base = " " + Date.prototype.toUTCString.call(value);
+  if (isError(value))
+    base = " " + formatError(value);
+  if (keys.length === 0 && (!array || value.length == 0))
+    return braces[0] + base + braces[1];
+  if (recurseTimes < 0)
+    if (isRegExp(value))
+      return ctx.stylize(RegExp.prototype.toString.call(value), "regexp");
+    else
+      return ctx.stylize("[Object]", "special");
+  ctx.seen.push(value);
+  var output;
+  if (array)
+    output = formatArray(ctx, value, recurseTimes, visibleKeys, keys);
+  else
+    output = keys.map(function(key) {
+      return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array);
+    });
+  return ctx.seen.pop(), reduceToSingleString(output, base, braces);
+}
+function formatPrimitive(ctx, value) {
+  if (isUndefined(value))
+    return ctx.stylize("undefined", "undefined");
+  if (isString(value)) {
+    var simple = "'" + JSON.stringify(value).replace(/^"|"$/g, "").replace(/'/g, "\\'").replace(/\\"/g, '"') + "'";
+    return ctx.stylize(simple, "string");
+  }
+  if (isNumber(value))
+    return ctx.stylize("" + value, "number");
+  if (isBoolean(value))
+    return ctx.stylize("" + value, "boolean");
+  if (isNull(value))
+    return ctx.stylize("null", "null");
+}
+function formatError(value) {
+  return "[" + Error.prototype.toString.call(value) + "]";
+}
+function formatArray(ctx, value, recurseTimes, visibleKeys, keys) {
+  var output = [];
+  for (var i = 0, l = value.length;i < l; ++i)
+    if (hasOwnProperty(value, String(i)))
+      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, String(i), true));
+    else
+      output.push("");
+  return keys.forEach(function(key) {
+    if (!key.match(/^\d+$/))
+      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, key, true));
+  }), output;
+}
+function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) {
+  var name, str, desc;
+  if (desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] }, desc.get)
+    if (desc.set)
+      str = ctx.stylize("[Getter/Setter]", "special");
+    else
+      str = ctx.stylize("[Getter]", "special");
+  else if (desc.set)
+    str = ctx.stylize("[Setter]", "special");
+  if (!hasOwnProperty(visibleKeys, key))
+    name = "[" + key + "]";
+  if (!str)
+    if (ctx.seen.indexOf(desc.value) < 0) {
+      if (isNull(recurseTimes))
+        str = formatValue(ctx, desc.value, null);
+      else
+        str = formatValue(ctx, desc.value, recurseTimes - 1);
+      if (str.indexOf(`
+`) > -1)
+        if (array)
+          str = str.split(`
+`).map(function(line) {
+            return "  " + line;
+          }).join(`
+`).slice(2);
+        else
+          str = `
+` + str.split(`
+`).map(function(line) {
+            return "   " + line;
+          }).join(`
+`);
+    } else
+      str = ctx.stylize("[Circular]", "special");
+  if (isUndefined(name)) {
+    if (array && key.match(/^\d+$/))
+      return str;
+    if (name = JSON.stringify("" + key), name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/))
+      name = name.slice(1, -1), name = ctx.stylize(name, "name");
+    else
+      name = name.replace(/'/g, "\\'").replace(/\\"/g, '"').replace(/(^"|"$)/g, "'"), name = ctx.stylize(name, "string");
+  }
+  return name + ": " + str;
+}
+function reduceToSingleString(output, base, braces) {
+  var numLinesEst = 0, length = output.reduce(function(prev, cur) {
+    if (numLinesEst++, cur.indexOf(`
+`) >= 0)
+      numLinesEst++;
+    return prev + cur.replace(/\u001b\[\d\d?m/g, "").length + 1;
+  }, 0);
+  if (length > 60)
+    return braces[0] + (base === "" ? "" : base + `
+ `) + " " + output.join(`,
+  `) + " " + braces[1];
+  return braces[0] + base + " " + output.join(", ") + " " + braces[1];
+}
+function isArray(ar) {
+  return Array.isArray(ar);
+}
+function isBoolean(arg) {
+  return typeof arg === "boolean";
+}
+function isNull(arg) {
+  return arg === null;
+}
+function isNullOrUndefined(arg) {
+  return arg == null;
+}
+function isNumber(arg) {
+  return typeof arg === "number";
+}
+function isString(arg) {
+  return typeof arg === "string";
+}
+function isSymbol(arg) {
+  return typeof arg === "symbol";
+}
+function isUndefined(arg) {
+  return arg === undefined;
+}
+function isRegExp(re) {
+  return isObject(re) && objectToString(re) === "[object RegExp]";
+}
+function isObject(arg) {
+  return typeof arg === "object" && arg !== null;
+}
+function isDate(d) {
+  return isObject(d) && objectToString(d) === "[object Date]";
+}
+function isError(e) {
+  return isObject(e) && (objectToString(e) === "[object Error]" || e instanceof Error);
+}
+function isFunction(arg) {
+  return typeof arg === "function";
+}
+function isPrimitive(arg) {
+  return arg === null || typeof arg === "boolean" || typeof arg === "number" || typeof arg === "string" || typeof arg === "symbol" || typeof arg > "u";
+}
+function isBuffer(arg) {
+  return arg instanceof Buffer;
+}
+function objectToString(o) {
+  return Object.prototype.toString.call(o);
+}
+function pad(n) {
+  return n < 10 ? "0" + n.toString(10) : n.toString(10);
+}
+function timestamp() {
+  var d = new Date, time = [pad(d.getHours()), pad(d.getMinutes()), pad(d.getSeconds())].join(":");
+  return [d.getDate(), months[d.getMonth()], time].join(" ");
+}
+function log(...args) {
+  console.log("%s - %s", timestamp(), format.apply(null, args));
+}
+function inherits(ctor, superCtor) {
+  if (superCtor)
+    ctor.super_ = superCtor, ctor.prototype = Object.create(superCtor.prototype, { constructor: { value: ctor, enumerable: false, writable: true, configurable: true } });
+}
+function _extend(origin, add) {
+  if (!add || !isObject(add))
+    return origin;
+  var keys = Object.keys(add), i = keys.length;
+  while (i--)
+    origin[keys[i]] = add[keys[i]];
+  return origin;
+}
+function hasOwnProperty(obj, prop) {
+  return Object.prototype.hasOwnProperty.call(obj, prop);
+}
+function callbackifyOnRejected(reason, cb) {
+  if (!reason) {
+    var newReason = Error("Promise was rejected with a falsy value");
+    newReason.reason = reason, reason = newReason;
+  }
+  return cb(reason);
+}
+function callbackify(original) {
+  if (typeof original !== "function")
+    throw TypeError('The "original" argument must be of type Function');
+  function callbackified(...args) {
+    var maybeCb = args.pop();
+    if (typeof maybeCb !== "function")
+      throw TypeError("The last argument must be of type Function");
+    var self = this, cb = function(...args2) {
+      return maybeCb.apply(self, ...args2);
+    };
+    original.apply(this, args).then(function(ret) {
+      process.nextTick(cb.bind(null, null, ret));
+    }, function(rej) {
+      process.nextTick(callbackifyOnRejected.bind(null, rej, cb));
+    });
+  }
+  return Object.setPrototypeOf(callbackified, Object.getPrototypeOf(original)), Object.defineProperties(callbackified, Object.getOwnPropertyDescriptors(original)), callbackified;
+}
+var formatRegExp;
+var debuglog;
+var inspect;
+var types = () => {};
+var months;
+var promisify;
+var TextEncoder;
+var TextDecoder;
+var util_default;
+var init_util = __esm2(() => {
+  formatRegExp = /%[sdj%]/g;
+  debuglog = ((debugs = {}, debugEnvRegex = {}, debugEnv) => ((debugEnv = typeof process < "u" && false) && (debugEnv = debugEnv.replace(/[|\\{}()[\]^$+?.]/g, "\\$&").replace(/\*/g, ".*").replace(/,/g, "$|^").toUpperCase()), debugEnvRegex = new RegExp("^" + debugEnv + "$", "i"), (set) => {
+    if (set = set.toUpperCase(), !debugs[set])
+      if (debugEnvRegex.test(set))
+        debugs[set] = function(...args) {
+          console.error("%s: %s", set, pid, format.apply(null, ...args));
+        };
+      else
+        debugs[set] = function() {};
+    return debugs[set];
+  }))();
+  inspect = ((i) => (i.colors = { bold: [1, 22], italic: [3, 23], underline: [4, 24], inverse: [7, 27], white: [37, 39], grey: [90, 39], black: [30, 39], blue: [34, 39], cyan: [36, 39], green: [32, 39], magenta: [35, 39], red: [31, 39], yellow: [33, 39] }, i.styles = { special: "cyan", number: "yellow", boolean: "yellow", undefined: "grey", null: "bold", string: "green", date: "magenta", regexp: "red" }, i.custom = Symbol.for("nodejs.util.inspect.custom"), i))(function(obj, opts, ...rest) {
+    var ctx = { seen: [], stylize: stylizeNoColor };
+    if (rest.length >= 1)
+      ctx.depth = rest[0];
+    if (rest.length >= 2)
+      ctx.colors = rest[1];
+    if (isBoolean(opts))
+      ctx.showHidden = opts;
+    else if (opts)
+      _extend(ctx, opts);
+    if (isUndefined(ctx.showHidden))
+      ctx.showHidden = false;
+    if (isUndefined(ctx.depth))
+      ctx.depth = 2;
+    if (isUndefined(ctx.colors))
+      ctx.colors = false;
+    if (ctx.colors)
+      ctx.stylize = stylizeWithColor;
+    return formatValue(ctx, obj, ctx.depth);
+  });
+  months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+  promisify = ((x) => (x.custom = Symbol.for("nodejs.util.promisify.custom"), x))(function(original) {
+    if (typeof original !== "function")
+      throw TypeError('The "original" argument must be of type Function');
+    if (kCustomPromisifiedSymbol && original[kCustomPromisifiedSymbol]) {
+      var fn = original[kCustomPromisifiedSymbol];
+      if (typeof fn !== "function")
+        throw TypeError('The "nodejs.util.promisify.custom" argument must be of type Function');
+      return Object.defineProperty(fn, kCustomPromisifiedSymbol, { value: fn, enumerable: false, writable: false, configurable: true }), fn;
+    }
+    function fn(...args) {
+      var promiseResolve, promiseReject, promise = new Promise(function(resolve, reject) {
+        promiseResolve = resolve, promiseReject = reject;
+      });
+      args.push(function(err, value) {
+        if (err)
+          promiseReject(err);
+        else
+          promiseResolve(value);
+      });
+      try {
+        original.apply(this, args);
+      } catch (err) {
+        promiseReject(err);
+      }
+      return promise;
+    }
+    if (Object.setPrototypeOf(fn, Object.getPrototypeOf(original)), kCustomPromisifiedSymbol)
+      Object.defineProperty(fn, kCustomPromisifiedSymbol, { value: fn, enumerable: false, writable: false, configurable: true });
+    return Object.defineProperties(fn, Object.getOwnPropertyDescriptors(original));
+  });
+  ({ TextEncoder, TextDecoder } = globalThis);
+  util_default = { TextEncoder, TextDecoder, promisify, log, inherits, _extend, callbackifyOnRejected, callbackify };
+});
 var DEFAULT_PLATFORM = "BEYOND_AI";
 var BEYONDAI_TOKEN_URLS = {
   staging: "https://staging-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token",
@@ -184,7 +585,7 @@ function detectEnvironment() {
 var nodeInspect;
 if (!isBrowser()) {
   try {
-    const util = await import("node:util");
+    const util = await Promise.resolve().then(() => (init_util(), exports_util));
     nodeInspect = util.inspect;
   } catch {}
 }
@@ -237,10 +638,10 @@ var terminalFormatter = (entry) => {
   const consoleMethod = getConsoleMethod(entry.level);
   const levelUpper = entry.level.toUpperCase().padEnd(5);
   const isoString = entry.timestamp.toISOString().replace(/\.\d{3}Z$/, "");
-  const timestamp = `${colors.dim}[${isoString}]${colors.reset}`;
+  const timestamp2 = `${colors.dim}[${isoString}]${colors.reset}`;
   const level = `${levelColor}${levelUpper}${colors.reset}`;
   const scope = entry.scope ? `${colors.bold}[${entry.scope}]${colors.reset} ` : "";
-  const prefix = `${timestamp} ${level} ${scope}${entry.message}`;
+  const prefix = `${timestamp2} ${level} ${scope}${entry.message}`;
   if (entry.context && Object.keys(entry.context).length > 0) {
     consoleMethod(prefix, formatContext(entry.context));
   } else {
@@ -254,9 +655,9 @@ var LEVEL_PREFIX = {
   error: "[ERROR]"
 };
 function formatContext2(context) {
-  return Object.entries(context).map(([key, value]) => `${key}=${formatValue(value)}`).join(" ");
+  return Object.entries(context).map(([key, value]) => `${key}=${formatValue2(value)}`).join(" ");
 }
-function formatValue(value) {
+function formatValue2(value) {
   if (typeof value === "string")
     return value;
   if (typeof value === "number")
@@ -412,7 +813,7 @@ function isDebug() {
     return false;
   }
 }
-var log = createLogger({ scope: "auth", minLevel: isDebug() ? "debug" : "warn" });
+var log2 = createLogger({ scope: "auth", minLevel: isDebug() ? "debug" : "warn" });
 
 class TokenManager {
   config;
@@ -426,11 +827,11 @@ class TokenManager {
   }
   async getToken() {
     if (this.accessToken && Date.now() < this.tokenExpiry) {
-      log.debug("Using cached token");
+      log2.debug("Using cached token");
       return this.accessToken;
     }
     if (this.pendingRequest) {
-      log.debug("Waiting for in-flight token request");
+      log2.debug("Waiting for in-flight token request");
       return this.pendingRequest;
     }
     this.pendingRequest = this.fetchToken();
@@ -441,7 +842,7 @@ class TokenManager {
     }
   }
   async fetchToken() {
-    log.debug("Fetching new access token...");
+    log2.debug("Fetching new access token...");
     const { clientId, clientSecret } = this.config.credentials;
     const credentials = btoa(`${clientId}:${clientSecret}`);
     const start = performance.now();
@@ -455,17 +856,17 @@ class TokenManager {
     });
     const duration = Math.round(performance.now() - start);
     if (!response.ok) {
-      log.error(`Token request failed: ${response.status} ${response.statusText}`);
+      log2.error(`Token request failed: ${response.status} ${response.statusText}`);
       throw new Error(`Failed to obtain access token: ${response.status} ${response.statusText}`);
     }
     const data = await response.json();
     this.accessToken = data.access_token;
     this.tokenExpiry = Date.now() + (data.expires_in - 60) * 1000;
-    log.debug(`Token acquired (${duration}ms, expires in ${data.expires_in}s)`);
+    log2.debug(`Token acquired (${duration}ms, expires in ${data.expires_in}s)`);
     return this.accessToken;
   }
   invalidate() {
-    log.debug("Token invalidated");
+    log2.debug("Token invalidated");
     this.accessToken = null;
     this.tokenExpiry = 0;
   }
@@ -699,7 +1100,17 @@ class TimebackProvider {
 }
 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;
   }
@@ -730,6 +1141,18 @@ var DEFAULT_PROVIDER_REGISTRY = {
     }
   }
 };
+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"`);
@@ -740,10 +1163,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 };
 }
@@ -759,21 +1182,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(", ")}`;
 }
@@ -912,7 +1335,7 @@ var MODE_TOKEN_PROVIDER = {
     return "tokenProvider" in config;
   },
   resolve() {
-    throw new Error("TokenProvider mode is not supported with provider pattern. Use { provider: TimebackProvider } or { env, auth } instead.");
+    throw new Error("TokenProvider mode is not supported with provider pattern. " + "Use { provider: TimebackProvider } or { env, auth } instead.");
   }
 };
 var MODES = [
@@ -1264,15 +1687,15 @@ function validateNonEmptyString(value, name) {
   }
 }
 var EDUBRIDGE_ENV_VARS = {
-  baseUrl: "EDUBRIDGE_BASE_URL",
-  clientId: "EDUBRIDGE_CLIENT_ID",
-  clientSecret: "EDUBRIDGE_CLIENT_SECRET",
-  authUrl: "EDUBRIDGE_TOKEN_URL"
+  baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "EDUBRIDGE_BASE_URL"],
+  clientId: ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "EDUBRIDGE_CLIENT_ID"],
+  clientSecret: ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "EDUBRIDGE_CLIENT_SECRET"],
+  authUrl: ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "EDUBRIDGE_TOKEN_URL"]
 };
 function resolveToProvider2(config, registry = DEFAULT_PROVIDER_REGISTRY) {
   return resolveToProvider(config, EDUBRIDGE_ENV_VARS, registry);
 }
-var log2 = createScopedLogger("edubridge");
+var log3 = createScopedLogger("edubridge");
 function normalizeBoolean(value) {
   if (typeof value === "boolean")
     return value;
@@ -1337,7 +1760,7 @@ function aggregateActivityMetrics(data) {
 class Transport extends BaseTransport {
   paths;
   constructor(config) {
-    super({ config, logger: log2 });
+    super({ config, logger: log3 });
     this.paths = config.paths;
   }
   async requestPaginated(path, options = {}) {
@@ -1381,7 +1804,7 @@ __export2(exports_external, {
   uuidv6: () => uuidv6,
   uuidv4: () => uuidv4,
   uuid: () => uuid2,
-  util: () => exports_util,
+  util: () => exports_util2,
   url: () => url,
   uppercase: () => _uppercase,
   unknown: () => unknown,
@@ -1490,7 +1913,7 @@ __export2(exports_external, {
   getErrorMap: () => getErrorMap,
   function: () => _function,
   fromJSONSchema: () => fromJSONSchema,
-  formatError: () => formatError,
+  formatError: () => formatError2,
   float64: () => float64,
   float32: () => float32,
   flattenError: () => flattenError,
@@ -1614,7 +2037,7 @@ __export2(exports_external, {
 var exports_core2 = {};
 __export2(exports_core2, {
   version: () => version,
-  util: () => exports_util,
+  util: () => exports_util2,
   treeifyError: () => treeifyError,
   toJSONSchema: () => toJSONSchema,
   toDotPath: () => toDotPath,
@@ -1638,7 +2061,7 @@ __export2(exports_core2, {
   initializeContext: () => initializeContext,
   globalRegistry: () => globalRegistry,
   globalConfig: () => globalConfig,
-  formatError: () => formatError,
+  formatError: () => formatError2,
   flattenError: () => flattenError,
   finalize: () => finalize,
   extractDefs: () => extractDefs,
@@ -1962,8 +2385,8 @@ function config(newConfig) {
     Object.assign(globalConfig, newConfig);
   return globalConfig;
 }
-var exports_util = {};
-__export2(exports_util, {
+var exports_util2 = {};
+__export2(exports_util2, {
   unwrapMessage: () => unwrapMessage,
   uint8ArrayToHex: () => uint8ArrayToHex,
   uint8ArrayToBase64url: () => uint8ArrayToBase64url,
@@ -1993,7 +2416,7 @@ __export2(exports_util, {
   joinValues: () => joinValues,
   issue: () => issue2,
   isPlainObject: () => isPlainObject,
-  isObject: () => isObject,
+  isObject: () => isObject2,
   hexToUint8Array: () => hexToUint8Array,
   getSizableOrigin: () => getSizableOrigin,
   getParsedType: () => getParsedType,
@@ -2162,7 +2585,7 @@ function slugify(input) {
   return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
 }
 var captureStackTrace = "captureStackTrace" in Error ? Error.captureStackTrace : (..._args) => {};
-function isObject(data) {
+function isObject2(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 var allowsEval = cached(() => {
@@ -2178,7 +2601,7 @@ var allowsEval = cached(() => {
   }
 });
 function isPlainObject(o) {
-  if (isObject(o) === false)
+  if (isObject2(o) === false)
     return false;
   const ctor = o.constructor;
   if (ctor === undefined)
@@ -2186,7 +2609,7 @@ function isPlainObject(o) {
   if (typeof ctor !== "function")
     return true;
   const prot = ctor.prototype;
-  if (isObject(prot) === false)
+  if (isObject2(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;
@@ -2665,7 +3088,7 @@ function flattenError(error, mapper = (issue3) => issue3.message) {
   }
   return { formErrors, fieldErrors };
 }
-function formatError(error, mapper = (issue3) => issue3.message) {
+function formatError2(error, mapper = (issue3) => issue3.message) {
   const fieldErrors = { _errors: [] };
   const processError = (error2) => {
     for (const issue3 of error2.issues) {
@@ -3595,7 +4018,7 @@ class Doc {
 var version = {
   major: 4,
   minor: 3,
-  patch: 5
+  patch: 6
 };
 var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
   var _a;
@@ -4180,15 +4603,15 @@ var $ZodDate = /* @__PURE__ */ $constructor("$ZodDate", (inst, def) => {
       } catch (_err) {}
     }
     const input = payload.value;
-    const isDate = input instanceof Date;
-    const isValidDate = isDate && !Number.isNaN(input.getTime());
+    const isDate2 = input instanceof Date;
+    const isValidDate = isDate2 && !Number.isNaN(input.getTime());
     if (isValidDate)
       return payload;
     payload.issues.push({
       expected: "date",
       code: "invalid_type",
       input,
-      ...isDate ? { received: "Invalid Date" } : {},
+      ...isDate2 ? { received: "Invalid Date" } : {},
       inst
     });
     return payload;
@@ -4327,13 +4750,13 @@ var $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
     }
     return propValues;
   });
-  const isObject2 = isObject;
+  const isObject3 = isObject2;
   const catchall = def.catchall;
   let value;
   inst._zod.parse = (payload, ctx) => {
     value ?? (value = _normalized.value);
     const input = payload.value;
-    if (!isObject2(input)) {
+    if (!isObject3(input)) {
       payload.issues.push({
         expected: "object",
         code: "invalid_type",
@@ -4431,7 +4854,7 @@ var $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def) =>
     return (payload, ctx) => fn(shape, payload, ctx);
   };
   let fastpass;
-  const isObject2 = isObject;
+  const isObject3 = isObject2;
   const jit = !globalConfig.jitless;
   const allowsEval2 = allowsEval;
   const fastEnabled = jit && allowsEval2.value;
@@ -4440,7 +4863,7 @@ var $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def) =>
   inst._zod.parse = (payload, ctx) => {
     value ?? (value = _normalized.value);
     const input = payload.value;
-    if (!isObject2(input)) {
+    if (!isObject3(input)) {
       payload.issues.push({
         expected: "object",
         code: "invalid_type",
@@ -4618,7 +5041,7 @@ var $ZodDiscriminatedUnion = /* @__PURE__ */ $constructor("$ZodDiscriminatedUnio
   });
   inst._zod.parse = (payload, ctx) => {
     const input = payload.value;
-    if (!isObject(input)) {
+    if (!isObject2(input)) {
       payload.issues.push({
         code: "invalid_type",
         expected: "object",
@@ -4739,7 +5162,7 @@ function handleIntersectionResults(result, left, right) {
     return result;
   const merged = mergeValues(left.value, right.value);
   if (!merged.valid) {
-    throw new Error(`Unmergable intersection. Error path: ${JSON.stringify(merged.mergeErrorPath)}`);
+    throw new Error(`Unmergable intersection. Error path: ` + `${JSON.stringify(merged.mergeErrorPath)}`);
   }
   result.value = merged.data;
   return result;
@@ -4879,7 +5302,7 @@ var $ZodRecord = /* @__PURE__ */ $constructor("$ZodRecord", (inst, def) => {
         if (keyResult instanceof Promise) {
           throw new Error("Async schemas not supported in object keys currently");
         }
-        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length && keyResult.issues.some((iss) => iss.code === "invalid_type" && iss.expected === "number");
+        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length;
         if (checkNumericKey) {
           const retryResult = def.keyType._zod.run({ value: Number(key), issues: [] }, ctx);
           if (retryResult instanceof Promise) {
@@ -11657,10 +12080,10 @@ function _property(property, schema, params) {
     ...normalizeParams(params)
   });
 }
-function _mime(types, params) {
+function _mime(types2, params) {
   return new $ZodCheckMimeType({
     check: "mime_type",
-    mime: types,
+    mime: types2,
     ...normalizeParams(params)
   });
 }
@@ -11983,13 +12406,13 @@ function _stringbool(Classes, _params) {
   });
   return codec;
 }
-function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
+function _stringFormat(Class2, format2, fnOrRegex, _params = {}) {
   const params = normalizeParams(_params);
   const def = {
     ...normalizeParams(_params),
     check: "string_format",
     type: "string",
-    format,
+    format: format2,
     fn: typeof fnOrRegex === "function" ? fnOrRegex : (val) => fnOrRegex.test(val),
     ...params
   };
@@ -12127,9 +12550,7 @@ function extractDefs(ctx, schema) {
     for (const entry of ctx.seen.entries()) {
       const seen = entry[1];
       if (seen.cycle) {
-        throw new Error(`Cycle detected: #/${seen.cycle?.join("/")}/<root>
-
-Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.`);
+        throw new Error("Cycle detected: " + `#/${seen.cycle?.join("/")}/<root>` + '\n\nSet the `cycles` parameter to `"ref"` to resolve cyclical schemas with defs.');
       }
     }
   }
@@ -12196,7 +12617,7 @@ function finalize(ctx, schema) {
           }
         }
       }
-      if (refSchema.$ref) {
+      if (refSchema.$ref && refSeen.def) {
         for (const key in schema2) {
           if (key === "$ref" || key === "allOf")
             continue;
@@ -12355,16 +12776,16 @@ var formatMap = {
 var stringProcessor = (schema, ctx, _json, _params) => {
   const json = _json;
   json.type = "string";
-  const { minimum, maximum, format, patterns: patterns2, contentEncoding } = schema._zod.bag;
+  const { minimum, maximum, format: format2, patterns: patterns2, contentEncoding } = schema._zod.bag;
   if (typeof minimum === "number")
     json.minLength = minimum;
   if (typeof maximum === "number")
     json.maxLength = maximum;
-  if (format) {
-    json.format = formatMap[format] ?? format;
+  if (format2) {
+    json.format = formatMap[format2] ?? format2;
     if (json.format === "")
       delete json.format;
-    if (format === "time") {
+    if (format2 === "time") {
       delete json.format;
     }
   }
@@ -12386,8 +12807,8 @@ var stringProcessor = (schema, ctx, _json, _params) => {
 };
 var numberProcessor = (schema, ctx, _json, _params) => {
   const json = _json;
-  const { minimum, maximum, format, multipleOf, exclusiveMaximum, exclusiveMinimum } = schema._zod.bag;
-  if (typeof format === "string" && format.includes("int"))
+  const { minimum, maximum, format: format2, multipleOf, exclusiveMaximum, exclusiveMinimum } = schema._zod.bag;
+  if (typeof format2 === "string" && format2.includes("int"))
     json.type = "integer";
   else
     json.type = "number";
@@ -13192,7 +13613,7 @@ var initializer2 = (inst, issues) => {
   inst.name = "ZodError";
   Object.defineProperties(inst, {
     format: {
-      value: (mapper) => formatError(inst, mapper)
+      value: (mapper) => formatError2(inst, mapper)
     },
     flatten: {
       value: (mapper) => flattenError(inst, mapper)
@@ -13245,7 +13666,7 @@ var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   inst.type = def.type;
   Object.defineProperty(inst, "_def", { value: def });
   inst.check = (...checks2) => {
-    return inst.clone(exports_util.mergeDefs(def, {
+    return inst.clone(exports_util2.mergeDefs(def, {
       checks: [
         ...def.checks ?? [],
         ...checks2.map((ch) => typeof ch === "function" ? { _zod: { check: ch, def: { check: "custom" }, onattach: [] } } : ch)
@@ -13418,7 +13839,7 @@ function httpUrl(params) {
   return _url(ZodURL, {
     protocol: /^https?$/,
     hostname: exports_regexes.domain,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodEmoji = /* @__PURE__ */ $constructor("ZodEmoji", (inst, def) => {
@@ -13537,8 +13958,8 @@ var ZodCustomStringFormat = /* @__PURE__ */ $constructor("ZodCustomStringFormat"
   $ZodCustomStringFormat.init(inst, def);
   ZodStringFormat.init(inst, def);
 });
-function stringFormat(format, fnOrRegex, _params = {}) {
-  return _stringFormat(ZodCustomStringFormat, format, fnOrRegex, _params);
+function stringFormat(format2, fnOrRegex, _params = {}) {
+  return _stringFormat(ZodCustomStringFormat, format2, fnOrRegex, _params);
 }
 function hostname2(_params) {
   return _stringFormat(ZodCustomStringFormat, "hostname", exports_regexes.hostname, _params);
@@ -13548,11 +13969,11 @@ function hex2(_params) {
 }
 function hash(alg, params) {
   const enc = params?.enc ?? "hex";
-  const format = `${alg}_${enc}`;
-  const regex = exports_regexes[format];
+  const format2 = `${alg}_${enc}`;
+  const regex = exports_regexes[format2];
   if (!regex)
-    throw new Error(`Unrecognized hash format: ${format}`);
-  return _stringFormat(ZodCustomStringFormat, format, regex, params);
+    throw new Error(`Unrecognized hash format: ${format2}`);
+  return _stringFormat(ZodCustomStringFormat, format2, regex, params);
 }
 var ZodNumber = /* @__PURE__ */ $constructor("ZodNumber", (inst, def) => {
   $ZodNumber.init(inst, def);
@@ -13736,7 +14157,7 @@ var ZodObject = /* @__PURE__ */ $constructor("ZodObject", (inst, def) => {
   $ZodObjectJIT.init(inst, def);
   ZodType.init(inst, def);
   inst._zod.processJSONSchema = (ctx, json, params) => objectProcessor(inst, ctx, json, params);
-  exports_util.defineLazy(inst, "shape", () => {
+  exports_util2.defineLazy(inst, "shape", () => {
     return def.shape;
   });
   inst.keyof = () => _enum2(Object.keys(inst._zod.def.shape));
@@ -13746,22 +14167,22 @@ var ZodObject = /* @__PURE__ */ $constructor("ZodObject", (inst, def) => {
   inst.strict = () => inst.clone({ ...inst._zod.def, catchall: never() });
   inst.strip = () => inst.clone({ ...inst._zod.def, catchall: undefined });
   inst.extend = (incoming) => {
-    return exports_util.extend(inst, incoming);
+    return exports_util2.extend(inst, incoming);
   };
   inst.safeExtend = (incoming) => {
-    return exports_util.safeExtend(inst, incoming);
+    return exports_util2.safeExtend(inst, incoming);
   };
-  inst.merge = (other) => exports_util.merge(inst, other);
-  inst.pick = (mask) => exports_util.pick(inst, mask);
-  inst.omit = (mask) => exports_util.omit(inst, mask);
-  inst.partial = (...args) => exports_util.partial(ZodOptional, inst, args[0]);
-  inst.required = (...args) => exports_util.required(ZodNonOptional, inst, args[0]);
+  inst.merge = (other) => exports_util2.merge(inst, other);
+  inst.pick = (mask) => exports_util2.pick(inst, mask);
+  inst.omit = (mask) => exports_util2.omit(inst, mask);
+  inst.partial = (...args) => exports_util2.partial(ZodOptional, inst, args[0]);
+  inst.required = (...args) => exports_util2.required(ZodNonOptional, inst, args[0]);
 });
 function object(shape, params) {
   const def = {
     type: "object",
     shape: shape ?? {},
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   };
   return new ZodObject(def);
 }
@@ -13770,7 +14191,7 @@ function strictObject(shape, params) {
     type: "object",
     shape,
     catchall: never(),
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 function looseObject(shape, params) {
@@ -13778,7 +14199,7 @@ function looseObject(shape, params) {
     type: "object",
     shape,
     catchall: unknown(),
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodUnion = /* @__PURE__ */ $constructor("ZodUnion", (inst, def) => {
@@ -13791,7 +14212,7 @@ function union(options, params) {
   return new ZodUnion({
     type: "union",
     options,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodXor = /* @__PURE__ */ $constructor("ZodXor", (inst, def) => {
@@ -13805,7 +14226,7 @@ function xor(options, params) {
     type: "union",
     options,
     inclusive: false,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodDiscriminatedUnion = /* @__PURE__ */ $constructor("ZodDiscriminatedUnion", (inst, def) => {
@@ -13817,7 +14238,7 @@ function discriminatedUnion(discriminator, options, params) {
     type: "union",
     options,
     discriminator,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodIntersection = /* @__PURE__ */ $constructor("ZodIntersection", (inst, def) => {
@@ -13849,7 +14270,7 @@ function tuple(items, _paramsOrRest, _params) {
     type: "tuple",
     items,
     rest,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodRecord = /* @__PURE__ */ $constructor("ZodRecord", (inst, def) => {
@@ -13864,7 +14285,7 @@ function record(keyType, valueType, params) {
     type: "record",
     keyType,
     valueType,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 function partialRecord(keyType, valueType, params) {
@@ -13874,7 +14295,7 @@ function partialRecord(keyType, valueType, params) {
     type: "record",
     keyType: k,
     valueType,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 function looseRecord(keyType, valueType, params) {
@@ -13883,7 +14304,7 @@ function looseRecord(keyType, valueType, params) {
     keyType,
     valueType,
     mode: "loose",
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodMap = /* @__PURE__ */ $constructor("ZodMap", (inst, def) => {
@@ -13902,7 +14323,7 @@ function map(keyType, valueType, params) {
     type: "map",
     keyType,
     valueType,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodSet = /* @__PURE__ */ $constructor("ZodSet", (inst, def) => {
@@ -13918,7 +14339,7 @@ function set(valueType, params) {
   return new ZodSet({
     type: "set",
     valueType,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodEnum = /* @__PURE__ */ $constructor("ZodEnum", (inst, def) => {
@@ -13939,7 +14360,7 @@ var ZodEnum = /* @__PURE__ */ $constructor("ZodEnum", (inst, def) => {
     return new ZodEnum({
       ...def,
       checks: [],
-      ...exports_util.normalizeParams(params),
+      ...exports_util2.normalizeParams(params),
       entries: newEntries
     });
   };
@@ -13954,7 +14375,7 @@ var ZodEnum = /* @__PURE__ */ $constructor("ZodEnum", (inst, def) => {
     return new ZodEnum({
       ...def,
       checks: [],
-      ...exports_util.normalizeParams(params),
+      ...exports_util2.normalizeParams(params),
       entries: newEntries
     });
   };
@@ -13964,14 +14385,14 @@ function _enum2(values, params) {
   return new ZodEnum({
     type: "enum",
     entries,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 function nativeEnum(entries, params) {
   return new ZodEnum({
     type: "enum",
     entries,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodLiteral = /* @__PURE__ */ $constructor("ZodLiteral", (inst, def) => {
@@ -13992,7 +14413,7 @@ function literal(value, params) {
   return new ZodLiteral({
     type: "literal",
     values: Array.isArray(value) ? value : [value],
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodFile = /* @__PURE__ */ $constructor("ZodFile", (inst, def) => {
@@ -14001,7 +14422,7 @@ var ZodFile = /* @__PURE__ */ $constructor("ZodFile", (inst, def) => {
   inst._zod.processJSONSchema = (ctx, json, params) => fileProcessor(inst, ctx, json, params);
   inst.min = (size, params) => inst.check(_minSize(size, params));
   inst.max = (size, params) => inst.check(_maxSize(size, params));
-  inst.mime = (types, params) => inst.check(_mime(Array.isArray(types) ? types : [types], params));
+  inst.mime = (types2, params) => inst.check(_mime(Array.isArray(types2) ? types2 : [types2], params));
 });
 function file(params) {
   return _file(ZodFile, params);
@@ -14016,7 +14437,7 @@ var ZodTransform = /* @__PURE__ */ $constructor("ZodTransform", (inst, def) => {
     }
     payload.addIssue = (issue3) => {
       if (typeof issue3 === "string") {
-        payload.issues.push(exports_util.issue(issue3, payload.value, def));
+        payload.issues.push(exports_util2.issue(issue3, payload.value, def));
       } else {
         const _issue = issue3;
         if (_issue.fatal)
@@ -14024,7 +14445,7 @@ var ZodTransform = /* @__PURE__ */ $constructor("ZodTransform", (inst, def) => {
         _issue.code ?? (_issue.code = "custom");
         _issue.input ?? (_issue.input = payload.value);
         _issue.inst ?? (_issue.inst = inst);
-        payload.issues.push(exports_util.issue(_issue));
+        payload.issues.push(exports_util2.issue(_issue));
       }
     };
     const output = def.transform(payload.value, payload);
@@ -14095,7 +14516,7 @@ function _default2(innerType, defaultValue) {
     type: "default",
     innerType,
     get defaultValue() {
-      return typeof defaultValue === "function" ? defaultValue() : exports_util.shallowClone(defaultValue);
+      return typeof defaultValue === "function" ? defaultValue() : exports_util2.shallowClone(defaultValue);
     }
   });
 }
@@ -14110,7 +14531,7 @@ function prefault(innerType, defaultValue) {
     type: "prefault",
     innerType,
     get defaultValue() {
-      return typeof defaultValue === "function" ? defaultValue() : exports_util.shallowClone(defaultValue);
+      return typeof defaultValue === "function" ? defaultValue() : exports_util2.shallowClone(defaultValue);
     }
   });
 }
@@ -14124,7 +14545,7 @@ function nonoptional(innerType, params) {
   return new ZodNonOptional({
     type: "nonoptional",
     innerType,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodSuccess = /* @__PURE__ */ $constructor("ZodSuccess", (inst, def) => {
@@ -14209,7 +14630,7 @@ function templateLiteral(parts, params) {
   return new ZodTemplateLiteral({
     type: "template_literal",
     parts,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
 }
 var ZodLazy = /* @__PURE__ */ $constructor("ZodLazy", (inst, def) => {
@@ -14277,7 +14698,7 @@ function _instanceof(cls, params = {}) {
     check: "custom",
     fn: (data) => data instanceof cls,
     abort: true,
-    ...exports_util.normalizeParams(params)
+    ...exports_util2.normalizeParams(params)
   });
   inst._zod.bag.Class = cls;
   inst._zod.check = (payload) => {
@@ -14509,52 +14930,52 @@ function convertBaseSchema(schema, ctx) {
     case "string": {
       let stringSchema = z.string();
       if (schema.format) {
-        const format = schema.format;
-        if (format === "email") {
+        const format2 = schema.format;
+        if (format2 === "email") {
           stringSchema = stringSchema.check(z.email());
-        } else if (format === "uri" || format === "uri-reference") {
+        } else if (format2 === "uri" || format2 === "uri-reference") {
           stringSchema = stringSchema.check(z.url());
-        } else if (format === "uuid" || format === "guid") {
+        } else if (format2 === "uuid" || format2 === "guid") {
           stringSchema = stringSchema.check(z.uuid());
-        } else if (format === "date-time") {
+        } else if (format2 === "date-time") {
           stringSchema = stringSchema.check(z.iso.datetime());
-        } else if (format === "date") {
+        } else if (format2 === "date") {
           stringSchema = stringSchema.check(z.iso.date());
-        } else if (format === "time") {
+        } else if (format2 === "time") {
           stringSchema = stringSchema.check(z.iso.time());
-        } else if (format === "duration") {
+        } else if (format2 === "duration") {
           stringSchema = stringSchema.check(z.iso.duration());
-        } else if (format === "ipv4") {
+        } else if (format2 === "ipv4") {
           stringSchema = stringSchema.check(z.ipv4());
-        } else if (format === "ipv6") {
+        } else if (format2 === "ipv6") {
           stringSchema = stringSchema.check(z.ipv6());
-        } else if (format === "mac") {
+        } else if (format2 === "mac") {
           stringSchema = stringSchema.check(z.mac());
-        } else if (format === "cidr") {
+        } else if (format2 === "cidr") {
           stringSchema = stringSchema.check(z.cidrv4());
-        } else if (format === "cidr-v6") {
+        } else if (format2 === "cidr-v6") {
           stringSchema = stringSchema.check(z.cidrv6());
-        } else if (format === "base64") {
+        } else if (format2 === "base64") {
           stringSchema = stringSchema.check(z.base64());
-        } else if (format === "base64url") {
+        } else if (format2 === "base64url") {
           stringSchema = stringSchema.check(z.base64url());
-        } else if (format === "e164") {
+        } else if (format2 === "e164") {
           stringSchema = stringSchema.check(z.e164());
-        } else if (format === "jwt") {
+        } else if (format2 === "jwt") {
           stringSchema = stringSchema.check(z.jwt());
-        } else if (format === "emoji") {
+        } else if (format2 === "emoji") {
           stringSchema = stringSchema.check(z.emoji());
-        } else if (format === "nanoid") {
+        } else if (format2 === "nanoid") {
           stringSchema = stringSchema.check(z.nanoid());
-        } else if (format === "cuid") {
+        } else if (format2 === "cuid") {
           stringSchema = stringSchema.check(z.cuid());
-        } else if (format === "cuid2") {
+        } else if (format2 === "cuid2") {
           stringSchema = stringSchema.check(z.cuid2());
-        } else if (format === "ulid") {
+        } else if (format2 === "ulid") {
           stringSchema = stringSchema.check(z.ulid());
-        } else if (format === "xid") {
+        } else if (format2 === "xid") {
           stringSchema = stringSchema.check(z.xid());
-        } else if (format === "ksuid") {
+        } else if (format2 === "ksuid") {
           stringSchema = stringSchema.check(z.ksuid());
         }
       }
@@ -14828,7 +15249,7 @@ var TimebackSubject = exports_external.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade = exports_external.union([
   exports_external.literal(-1),
   exports_external.literal(0),
@@ -14845,7 +15266,10 @@ var TimebackGrade = exports_external.union([
   exports_external.literal(11),
   exports_external.literal(12),
   exports_external.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus = exports_external.enum([
   "exempt",
   "fully graded",
@@ -14989,6 +15413,8 @@ var ActivityCompletedInput = exports_external.object({
   metricsId: exports_external.string().optional(),
   id: exports_external.string().optional(),
   extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  edApp: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]).optional(),
+  session: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]).optional(),
   attempt: exports_external.number().int().min(1).optional(),
   generatedExtensions: exports_external.object({
     pctCompleteApp: exports_external.number().optional()
@@ -15001,7 +15427,9 @@ var TimeSpentInput = exports_external.object({
   eventTime: IsoDateTimeString.optional(),
   metricsId: exports_external.string().optional(),
   id: exports_external.string().optional(),
-  extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  edApp: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]).optional(),
+  session: exports_external.union([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]).optional()
 }).strict();
 var TimebackEvent = exports_external.union([TimebackActivityEvent, TimebackTimeSpentEvent]);
 var CaliperEnvelope = exports_external.object({
@@ -15075,62 +15503,84 @@ var CaliperListEventsParams = exports_external.object({
   actorEmail: exports_external.email().optional()
 }).strict();
 var CourseIds = exports_external.object({
-  staging: exports_external.string().optional(),
-  production: exports_external.string().optional()
-});
-var CourseType = exports_external.enum(["base", "hole-filling", "optional"]);
-var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType = exports_external.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals = exports_external.object({
-  dailyXp: exports_external.number().int().positive().optional(),
-  dailyLessons: exports_external.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external.number().int().positive().optional(),
-  dailyAccuracy: exports_external.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external.number().int().positive().optional()
-});
+  dailyXp: exports_external.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics = exports_external.object({
-  totalXp: exports_external.number().int().positive().optional(),
-  totalLessons: exports_external.number().int().positive().optional(),
-  totalGrades: exports_external.number().int().positive().optional()
-});
+  totalXp: exports_external.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata = exports_external.object({
   courseType: CourseType.optional(),
-  isSupplemental: exports_external.boolean().optional(),
-  isCustom: exports_external.boolean().optional(),
+  isSupplemental: exports_external.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus.optional(),
-  contactEmail: exports_external.email().optional(),
-  primaryApp: exports_external.string().optional(),
+  contactEmail: exports_external.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals.optional(),
   metrics: CourseMetrics.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults = exports_external.object({
-  courseCode: exports_external.string().optional(),
-  level: exports_external.string().optional(),
+  courseCode: exports_external.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides = exports_external.object({
-  level: exports_external.string().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  level: exports_external.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides = exports_external.object({
-  staging: CourseEnvOverrides.optional(),
-  production: CourseEnvOverrides.optional()
-});
+  staging: CourseEnvOverrides.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig = CourseDefaults.extend({
-  subject: TimebackSubject,
-  grade: TimebackGrade.optional(),
+  subject: TimebackSubject.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds.nullable().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig = exports_external.object({
-  name: exports_external.string().min(1, "App name is required"),
-  defaults: CourseDefaults.optional(),
-  courses: exports_external.array(CourseConfig).min(1, "At least one course is required"),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional()
+  $schema: exports_external.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external.array(CourseConfig).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config2) => {
   return config2.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -15151,17 +15601,23 @@ var TimebackConfig = exports_external.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config2) => {
-  return config2.courses.every((c) => c.sensor !== undefined || config2.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config2) => {
-  return config2.courses.every((c) => c.launchUrl !== undefined || config2.launchUrl !== undefined);
+  return config2.courses.every((c) => {
+    if (c.sensor !== undefined || config2.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config2.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
-var EdubridgeDateString = exports_external.union([IsoDateString, IsoDateTimeString]);
+var EdubridgeDateString = exports_external.union([IsoDateTimeString, IsoDateString]);
 var EduBridgeEnrollment = exports_external.object({
   id: exports_external.string(),
   role: exports_external.string(),
@@ -15225,13 +15681,11 @@ var EmailOrStudentId = exports_external.object({
 });
 var SubjectTrackInput = exports_external.object({
   subject: NonEmptyString,
-  gradeLevel: NonEmptyString,
-  targetCourseId: NonEmptyString,
-  metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
-});
-var SubjectTrackUpsertInput = SubjectTrackInput.extend({
-  id: NonEmptyString
+  grade: NonEmptyString,
+  courseId: NonEmptyString,
+  orgSourcedId: NonEmptyString.optional()
 });
+var SubjectTrackUpsertInput = SubjectTrackInput;
 var EdubridgeListEnrollmentsParams = exports_external.object({
   userId: NonEmptyString
 });
@@ -16361,7 +16815,7 @@ function createEdubridgeClient(registry2 = DEFAULT_PROVIDER_REGISTRY) {
       const resolved = resolveToProvider2(config3, registry2);
       if (resolved.mode === "transport") {
         this.transport = resolved.transport;
-        log2.info("Client initialized with custom transport");
+        log3.info("Client initialized with custom transport");
       } else {
         const { provider } = resolved;
         const { baseUrl, paths } = provider.getEndpointWithPaths("edubridge");
@@ -16376,7 +16830,7 @@ function createEdubridgeClient(registry2 = DEFAULT_PROVIDER_REGISTRY) {
           timeout: provider.timeout,
           paths
         });
-        log2.info("Client initialized", {
+        log3.info("Client initialized", {
           platform: provider.platform,
           env: provider.env,
           baseUrl