@timeback/powerpath 0.1.1 → 0.1.2

package/dist/constants.d.ts

@@ -6,12 +6,13 @@
 import type { ClientUrlMaps, Platform } from '@timeback/internal-client-infra';
 /**
  * Environment variable names for PowerPath configuration fallback.
+ * Priority: TIMEBACK_API_* > TIMEBACK_* > POWERPATH_* (legacy)
  */
 export declare const POWERPATH_ENV_VARS: {
-    readonly baseUrl: "POWERPATH_BASE_URL";
-    readonly clientId: "POWERPATH_CLIENT_ID";
-    readonly clientSecret: "POWERPATH_CLIENT_SECRET";
-    readonly authUrl: "POWERPATH_TOKEN_URL";
+    readonly baseUrl: readonly ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "POWERPATH_BASE_URL"];
+    readonly clientId: readonly ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "POWERPATH_CLIENT_ID"];
+    readonly clientSecret: readonly ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "POWERPATH_CLIENT_SECRET"];
+    readonly authUrl: readonly ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "POWERPATH_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,kBAAkB;;;;;CAKrB,CAAA;AAMV;;;;;;;GAOG;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;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CASrB,CAAA;AAMV;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,QAA2B,GAAG,aAAa,CAM1F"}

package/dist/errors.js

@@ -704,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;
   }
@@ -738,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"`);
@@ -748,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 };
 }
@@ -767,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(", ")}`;
 }

package/dist/index.js

@@ -704,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;
   }
@@ -738,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"`);
@@ -748,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 };
 }
@@ -767,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(", ")}`;
 }
@@ -1472,10 +1494,14 @@ function validateNonEmptyString(value, name) {
 }
 // src/constants.ts
 var POWERPATH_ENV_VARS = {
-  baseUrl: "POWERPATH_BASE_URL",
-  clientId: "POWERPATH_CLIENT_ID",
-  clientSecret: "POWERPATH_CLIENT_SECRET",
-  authUrl: "POWERPATH_TOKEN_URL"
+  baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "POWERPATH_BASE_URL"],
+  clientId: ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "POWERPATH_CLIENT_ID"],
+  clientSecret: [
+    "TIMEBACK_API_CLIENT_SECRET",
+    "TIMEBACK_CLIENT_SECRET",
+    "POWERPATH_CLIENT_SECRET"
+  ],
+  authUrl: ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "POWERPATH_TOKEN_URL"]
 };
 
 // src/lib/resolve.ts
@@ -1500,7 +1526,7 @@ class Transport extends BaseTransport {
   }
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/external.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
   xor: () => xor,
@@ -1741,7 +1767,7 @@ __export(exports_external, {
   $brand: () => $brand
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/index.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/index.js
 var exports_core2 = {};
 __export(exports_core2, {
   version: () => version,
@@ -2019,7 +2045,7 @@ __export(exports_core2, {
   $ZodAny: () => $ZodAny
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/core.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/core.js
 var NEVER = Object.freeze({
   status: "aborted"
 });
@@ -2095,7 +2121,7 @@ function config(newConfig) {
     Object.assign(globalConfig, newConfig);
   return globalConfig;
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/util.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/util.js
 var exports_util = {};
 __export(exports_util, {
   unwrapMessage: () => unwrapMessage,
@@ -2769,7 +2795,7 @@ class Class {
   constructor(..._args) {}
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/errors.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/errors.js
 var initializer = (inst, def) => {
   inst.name = "$ZodError";
   Object.defineProperty(inst, "_zod", {
@@ -2906,7 +2932,7 @@ function prettifyError(error) {
 `);
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/parse.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/parse.js
 var _parse = (_Err) => (schema, value, _ctx, _params) => {
   const ctx = _ctx ? Object.assign(_ctx, { async: false }) : { async: false };
   const result = schema._zod.run({ value, issues: [] }, ctx);
@@ -2993,7 +3019,7 @@ var _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
   return _safeParseAsync(_Err)(schema, value, _ctx);
 };
 var safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync($ZodRealError);
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/regexes.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/regexes.js
 var exports_regexes = {};
 __export(exports_regexes, {
   xid: () => xid,
@@ -3150,7 +3176,7 @@ var sha512_hex = /^[0-9a-fA-F]{128}$/;
 var sha512_base64 = /* @__PURE__ */ fixedBase64(86, "==");
 var sha512_base64url = /* @__PURE__ */ fixedBase64url(86);
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/checks.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/checks.js
 var $ZodCheck = /* @__PURE__ */ $constructor("$ZodCheck", (inst, def) => {
   var _a;
   inst._zod ?? (inst._zod = {});
@@ -3697,7 +3723,7 @@ var $ZodCheckOverwrite = /* @__PURE__ */ $constructor("$ZodCheckOverwrite", (ins
   };
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/doc.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/doc.js
 class Doc {
   constructor(args = []) {
     this.content = [];
@@ -3735,14 +3761,14 @@ class Doc {
   }
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/versions.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/versions.js
 var version = {
   major: 4,
   minor: 3,
-  patch: 5
+  patch: 6
 };
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/schemas.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/schemas.js
 var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
   var _a;
   inst ?? (inst = {});
@@ -5025,7 +5051,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) {
@@ -5704,7 +5730,7 @@ function handleRefineResult(result, payload, input, inst) {
     payload.issues.push(issue2(_iss));
   }
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/index.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/index.js
 var exports_locales = {};
 __export(exports_locales, {
   zhTW: () => zh_TW_default,
@@ -5758,7 +5784,7 @@ __export(exports_locales, {
   ar: () => ar_default
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ar.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ar.js
 var error = () => {
   const Sizable = {
     string: { unit: "حرف", verb: "أن يحوي" },
@@ -5864,7 +5890,7 @@ function ar_default() {
     localeError: error()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/az.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/az.js
 var error2 = () => {
   const Sizable = {
     string: { unit: "simvol", verb: "olmalıdır" },
@@ -5969,7 +5995,7 @@ function az_default() {
     localeError: error2()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/be.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/be.js
 function getBelarusianPlural(count, one, few, many) {
   const absCount = Math.abs(count);
   const lastDigit = absCount % 10;
@@ -6125,7 +6151,7 @@ function be_default() {
     localeError: error3()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/bg.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/bg.js
 var error4 = () => {
   const Sizable = {
     string: { unit: "символа", verb: "да съдържа" },
@@ -6245,7 +6271,7 @@ function bg_default() {
     localeError: error4()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ca.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ca.js
 var error5 = () => {
   const Sizable = {
     string: { unit: "caràcters", verb: "contenir" },
@@ -6352,7 +6378,7 @@ function ca_default() {
     localeError: error5()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/cs.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/cs.js
 var error6 = () => {
   const Sizable = {
     string: { unit: "znaků", verb: "mít" },
@@ -6463,7 +6489,7 @@ function cs_default() {
     localeError: error6()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/da.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/da.js
 var error7 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "havde" },
@@ -6578,7 +6604,7 @@ function da_default() {
     localeError: error7()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/de.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/de.js
 var error8 = () => {
   const Sizable = {
     string: { unit: "Zeichen", verb: "zu haben" },
@@ -6686,7 +6712,7 @@ function de_default() {
     localeError: error8()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/en.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/en.js
 var error9 = () => {
   const Sizable = {
     string: { unit: "characters", verb: "to have" },
@@ -6792,7 +6818,7 @@ function en_default() {
     localeError: error9()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/eo.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/eo.js
 var error10 = () => {
   const Sizable = {
     string: { unit: "karaktrojn", verb: "havi" },
@@ -6901,7 +6927,7 @@ function eo_default() {
     localeError: error10()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/es.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/es.js
 var error11 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "tener" },
@@ -7033,7 +7059,7 @@ function es_default() {
     localeError: error11()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/fa.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/fa.js
 var error12 = () => {
   const Sizable = {
     string: { unit: "کاراکتر", verb: "داشته باشد" },
@@ -7147,7 +7173,7 @@ function fa_default() {
     localeError: error12()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/fi.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/fi.js
 var error13 = () => {
   const Sizable = {
     string: { unit: "merkkiä", subject: "merkkijonon" },
@@ -7259,7 +7285,7 @@ function fi_default() {
     localeError: error13()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/fr.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/fr.js
 var error14 = () => {
   const Sizable = {
     string: { unit: "caractères", verb: "avoir" },
@@ -7367,7 +7393,7 @@ function fr_default() {
     localeError: error14()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/fr-CA.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/fr-CA.js
 var error15 = () => {
   const Sizable = {
     string: { unit: "caractères", verb: "avoir" },
@@ -7474,7 +7500,7 @@ function fr_CA_default() {
     localeError: error15()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/he.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/he.js
 var error16 = () => {
   const TypeNames = {
     string: { label: "מחרוזת", gender: "f" },
@@ -7667,7 +7693,7 @@ function he_default() {
     localeError: error16()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/hu.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/hu.js
 var error17 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "legyen" },
@@ -7775,7 +7801,7 @@ function hu_default() {
     localeError: error17()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/hy.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/hy.js
 function getArmenianPlural(count, one, many) {
   return Math.abs(count) === 1 ? one : many;
 }
@@ -7922,7 +7948,7 @@ function hy_default() {
     localeError: error18()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/id.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/id.js
 var error19 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "memiliki" },
@@ -8028,7 +8054,7 @@ function id_default() {
     localeError: error19()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/is.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/is.js
 var error20 = () => {
   const Sizable = {
     string: { unit: "stafi", verb: "að hafa" },
@@ -8137,7 +8163,7 @@ function is_default() {
     localeError: error20()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/it.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/it.js
 var error21 = () => {
   const Sizable = {
     string: { unit: "caratteri", verb: "avere" },
@@ -8245,7 +8271,7 @@ function it_default() {
     localeError: error21()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ja.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ja.js
 var error22 = () => {
   const Sizable = {
     string: { unit: "文字", verb: "である" },
@@ -8352,7 +8378,7 @@ function ja_default() {
     localeError: error22()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ka.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ka.js
 var error23 = () => {
   const Sizable = {
     string: { unit: "სიმბოლო", verb: "უნდა შეიცავდეს" },
@@ -8464,7 +8490,7 @@ function ka_default() {
     localeError: error23()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/km.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/km.js
 var error24 = () => {
   const Sizable = {
     string: { unit: "តួអក្សរ", verb: "គួរមាន" },
@@ -8575,11 +8601,11 @@ function km_default() {
   };
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/kh.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/kh.js
 function kh_default() {
   return km_default();
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ko.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ko.js
 var error25 = () => {
   const Sizable = {
     string: { unit: "문자", verb: "to have" },
@@ -8690,7 +8716,7 @@ function ko_default() {
     localeError: error25()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/lt.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/lt.js
 var capitalizeFirstCharacter = (text) => {
   return text.charAt(0).toUpperCase() + text.slice(1);
 };
@@ -8893,7 +8919,7 @@ function lt_default() {
     localeError: error26()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/mk.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/mk.js
 var error27 = () => {
   const Sizable = {
     string: { unit: "знаци", verb: "да имаат" },
@@ -9002,7 +9028,7 @@ function mk_default() {
     localeError: error27()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ms.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ms.js
 var error28 = () => {
   const Sizable = {
     string: { unit: "aksara", verb: "mempunyai" },
@@ -9109,7 +9135,7 @@ function ms_default() {
     localeError: error28()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/nl.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/nl.js
 var error29 = () => {
   const Sizable = {
     string: { unit: "tekens", verb: "heeft" },
@@ -9219,7 +9245,7 @@ function nl_default() {
     localeError: error29()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/no.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/no.js
 var error30 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "å ha" },
@@ -9327,7 +9353,7 @@ function no_default() {
     localeError: error30()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ota.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ota.js
 var error31 = () => {
   const Sizable = {
     string: { unit: "harf", verb: "olmalıdır" },
@@ -9436,7 +9462,7 @@ function ota_default() {
     localeError: error31()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ps.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ps.js
 var error32 = () => {
   const Sizable = {
     string: { unit: "توکي", verb: "ولري" },
@@ -9550,7 +9576,7 @@ function ps_default() {
     localeError: error32()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/pl.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/pl.js
 var error33 = () => {
   const Sizable = {
     string: { unit: "znaków", verb: "mieć" },
@@ -9659,7 +9685,7 @@ function pl_default() {
     localeError: error33()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/pt.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/pt.js
 var error34 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "ter" },
@@ -9767,7 +9793,7 @@ function pt_default() {
     localeError: error34()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ru.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ru.js
 function getRussianPlural(count, one, few, many) {
   const absCount = Math.abs(count);
   const lastDigit = absCount % 10;
@@ -9923,7 +9949,7 @@ function ru_default() {
     localeError: error35()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/sl.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/sl.js
 var error36 = () => {
   const Sizable = {
     string: { unit: "znakov", verb: "imeti" },
@@ -10032,7 +10058,7 @@ function sl_default() {
     localeError: error36()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/sv.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/sv.js
 var error37 = () => {
   const Sizable = {
     string: { unit: "tecken", verb: "att ha" },
@@ -10142,7 +10168,7 @@ function sv_default() {
     localeError: error37()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ta.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ta.js
 var error38 = () => {
   const Sizable = {
     string: { unit: "எழுத்துக்கள்", verb: "கொண்டிருக்க வேண்டும்" },
@@ -10252,7 +10278,7 @@ function ta_default() {
     localeError: error38()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/th.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/th.js
 var error39 = () => {
   const Sizable = {
     string: { unit: "ตัวอักษร", verb: "ควรมี" },
@@ -10362,7 +10388,7 @@ function th_default() {
     localeError: error39()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/tr.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/tr.js
 var error40 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "olmalı" },
@@ -10467,7 +10493,7 @@ function tr_default() {
     localeError: error40()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/uk.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/uk.js
 var error41 = () => {
   const Sizable = {
     string: { unit: "символів", verb: "матиме" },
@@ -10576,11 +10602,11 @@ function uk_default() {
   };
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ua.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ua.js
 function ua_default() {
   return uk_default();
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/ur.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/ur.js
 var error42 = () => {
   const Sizable = {
     string: { unit: "حروف", verb: "ہونا" },
@@ -10690,7 +10716,7 @@ function ur_default() {
     localeError: error42()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/uz.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/uz.js
 var error43 = () => {
   const Sizable = {
     string: { unit: "belgi", verb: "bo‘lishi kerak" },
@@ -10799,7 +10825,7 @@ function uz_default() {
     localeError: error43()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/vi.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/vi.js
 var error44 = () => {
   const Sizable = {
     string: { unit: "ký tự", verb: "có" },
@@ -10907,7 +10933,7 @@ function vi_default() {
     localeError: error44()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/zh-CN.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/zh-CN.js
 var error45 = () => {
   const Sizable = {
     string: { unit: "字符", verb: "包含" },
@@ -11016,7 +11042,7 @@ function zh_CN_default() {
     localeError: error45()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/zh-TW.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/zh-TW.js
 var error46 = () => {
   const Sizable = {
     string: { unit: "字元", verb: "擁有" },
@@ -11123,7 +11149,7 @@ function zh_TW_default() {
     localeError: error46()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/locales/yo.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/locales/yo.js
 var error47 = () => {
   const Sizable = {
     string: { unit: "àmi", verb: "ní" },
@@ -11230,7 +11256,7 @@ function yo_default() {
     localeError: error47()
   };
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/registries.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/registries.js
 var _a;
 var $output = Symbol("ZodOutput");
 var $input = Symbol("ZodInput");
@@ -11280,7 +11306,7 @@ function registry() {
 }
 (_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
 var globalRegistry = globalThis.__zod_globalRegistry;
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/api.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/api.js
 function _string(Class2, params) {
   return new Class2({
     type: "string",
@@ -12200,7 +12226,7 @@ function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
   const inst = new Class2(def);
   return inst;
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/to-json-schema.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/to-json-schema.js
 function initializeContext(params) {
   let target = params?.target ?? "draft-2020-12";
   if (target === "draft-4")
@@ -12396,7 +12422,7 @@ function finalize(ctx, schema) {
           }
         }
       }
-      if (refSchema.$ref) {
+      if (refSchema.$ref && refSeen.def) {
         for (const key in schema2) {
           if (key === "$ref" || key === "allOf")
             continue;
@@ -12545,7 +12571,7 @@ var createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params) =
   extractDefs(ctx, schema);
   return finalize(ctx, schema);
 };
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/json-schema-processors.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/json-schema-processors.js
 var formatMap = {
   guid: "uuid",
   url: "uri",
@@ -13090,7 +13116,7 @@ function toJSONSchema(input, params) {
   extractDefs(ctx, input);
   return finalize(ctx, input);
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/json-schema-generator.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/json-schema-generator.js
 class JSONSchemaGenerator {
   get metadataRegistry() {
     return this.ctx.metadataRegistry;
@@ -13149,9 +13175,9 @@ class JSONSchemaGenerator {
     return plainResult;
   }
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/json-schema.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/json-schema.js
 var exports_json_schema = {};
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/schemas.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/schemas.js
 var exports_schemas2 = {};
 __export(exports_schemas2, {
   xor: () => xor,
@@ -13320,7 +13346,7 @@ __export(exports_schemas2, {
   ZodAny: () => ZodAny
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/checks.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/checks.js
 var exports_checks2 = {};
 __export(exports_checks2, {
   uppercase: () => _uppercase,
@@ -13354,7 +13380,7 @@ __export(exports_checks2, {
   endsWith: () => _endsWith
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/iso.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/iso.js
 var exports_iso = {};
 __export(exports_iso, {
   time: () => time2,
@@ -13395,7 +13421,7 @@ function duration2(params) {
   return _isoDuration(ZodISODuration, params);
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/errors.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/errors.js
 var initializer2 = (inst, issues) => {
   $ZodError.init(inst, issues);
   inst.name = "ZodError";
@@ -13430,7 +13456,7 @@ var ZodRealError = $constructor("ZodError", initializer2, {
   Parent: Error
 });
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/parse.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/parse.js
 var parse3 = /* @__PURE__ */ _parse(ZodRealError);
 var parseAsync2 = /* @__PURE__ */ _parseAsync(ZodRealError);
 var safeParse2 = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -13444,7 +13470,7 @@ var safeDecode2 = /* @__PURE__ */ _safeDecode(ZodRealError);
 var safeEncodeAsync2 = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 var safeDecodeAsync2 = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/schemas.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/schemas.js
 var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   $ZodType.init(inst, def);
   Object.assign(inst["~standard"], {
@@ -14520,7 +14546,7 @@ function json(params) {
 function preprocess(fn, schema) {
   return pipe(transform(fn), schema);
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/compat.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/compat.js
 var ZodIssueCode = {
   invalid_type: "invalid_type",
   too_big: "too_big",
@@ -14544,7 +14570,7 @@ function getErrorMap() {
 }
 var ZodFirstPartyTypeKind;
 (function(ZodFirstPartyTypeKind2) {})(ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {}));
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/from-json-schema.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/from-json-schema.js
 var z = {
   ...exports_schemas2,
   ...exports_checks2,
@@ -15005,7 +15031,7 @@ function fromJSONSchema(schema, params) {
   };
   return convertSchema(schema, ctx);
 }
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/coerce.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/coerce.js
 var exports_coerce = {};
 __export(exports_coerce, {
   string: () => string3,
@@ -15030,7 +15056,7 @@ function date4(params) {
   return _coercedDate(ZodDate, params);
 }
 
-// ../../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/external.js
+// ../../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 config(en_default());
 // ../../types/src/zod/primitives.ts
 var IsoDateTimeRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
@@ -15047,7 +15073,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),
@@ -15064,7 +15090,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",
@@ -15296,62 +15325,84 @@ var CaliperListEventsParams = exports_external.object({
 }).strict();
 // ../../types/src/zod/config.ts
 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);
 }, {
@@ -15372,18 +15423,24 @@ 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"]
 });
 // ../../types/src/zod/edubridge.ts
-var EdubridgeDateString = exports_external.union([IsoDateString, IsoDateTimeString]);
+var EdubridgeDateString = IsoDateTimeString;
 var EduBridgeEnrollment = exports_external.object({
   id: exports_external.string(),
   role: exports_external.string(),
@@ -15447,12 +15504,9 @@ 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 EdubridgeListEnrollmentsParams = exports_external.object({
   userId: NonEmptyString

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/powerpath",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "PowerPath client SDK for Timeback",
 	"type": "module",
 	"exports": {