@timeback/oneroster 0.1.4 → 0.1.5

package/dist/constants.d.ts

@@ -6,12 +6,17 @@
 import type { ClientUrlMaps, Platform } from '@timeback/internal-client-infra';
 /**
  * Environment variable names for OneRoster configuration fallback.
+ *
+ * Supports fallback chains - tries each env var in order until one is defined:
+ * - `TIMEBACK_API_*` (canonical/preferred)
+ * - `TIMEBACK_*` (unified Timeback shorthand)
+ * - `ONEROSTER_*` (service-specific legacy)
  */
 export declare const ONEROSTER_ENV_VARS: {
-    readonly baseUrl: "ONEROSTER_BASE_URL";
-    readonly clientId: "ONEROSTER_CLIENT_ID";
-    readonly clientSecret: "ONEROSTER_CLIENT_SECRET";
-    readonly authUrl: "ONEROSTER_TOKEN_URL";
+    readonly baseUrl: readonly ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "ONEROSTER_BASE_URL"];
+    readonly clientId: readonly ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "ONEROSTER_CLIENT_ID"];
+    readonly clientSecret: readonly ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "ONEROSTER_CLIENT_SECRET"];
+    readonly authUrl: readonly ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "ONEROSTER_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;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,QAA2B,GAAG,aAAa,CAM1F"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAM9E;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAA;AAMV;;;;;GAKG;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(", ")}`;
 }
@@ -1504,10 +1526,10 @@ function validateSourcedId(sourcedId, context) {
 }
 // src/constants.ts
 var ONEROSTER_ENV_VARS = {
-  baseUrl: "ONEROSTER_BASE_URL",
-  clientId: "ONEROSTER_CLIENT_ID",
-  clientSecret: "ONEROSTER_CLIENT_SECRET",
-  authUrl: "ONEROSTER_TOKEN_URL"
+  baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "ONEROSTER_BASE_URL"],
+  clientId: ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "ONEROSTER_CLIENT_ID"],
+  clientSecret: ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "ONEROSTER_CLIENT_SECRET"],
+  authUrl: ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "ONEROSTER_TOKEN_URL"]
 };
 
 // src/lib/resolve.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/oneroster",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"exports": {
 		".": {