@timeback/caliper 0.2.2-beta.20260401223329 → 0.2.2-beta.20260409195426

package/dist/{chunk-3bz9d5vy.js → chunk-0drvsw3w.js}

@@ -147,6 +147,17 @@ var TYPESCRIPT_RUNNER = {
 var patterns = null;
 var debugAll = false;
 var debugEnvSet = false;
+function hasDebugOptIn() {
+  try {
+    const debugValue = process.env.DEBUG?.trim();
+    if (!debugValue) {
+      return false;
+    }
+    return debugValue.split(",").some((part) => part.trim().length > 0);
+  } catch {
+    return false;
+  }
+}
 function patternToRegex(pattern) {
   const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
   const regexStr = escaped.replace(/\*/g, ".*");
@@ -156,7 +167,7 @@ function parseDebugEnv() {
   if (patterns !== null)
     return;
   patterns = [];
-  if (typeof process === "undefined" || !process.env?.DEBUG) {
+  if (!hasDebugOptIn()) {
     debugEnvSet = false;
     return;
   }
@@ -378,6 +389,19 @@ var browserFormatter = (entry) => {
 };
 // ../../internal/logger/src/logger.ts
 var LOG_LEVELS = ["debug", "info", "warn", "error"];
+var GLOBAL_LOGGING_CONFIG_KEY = Symbol.for("@timeback/internal-logger/config");
+function shouldUseSilentFormatter() {
+  try {
+    return process.env["TIMEBACK_INTERNAL_LOGGER"] === "silent";
+  } catch {
+    return false;
+  }
+}
+function getGlobalLoggingConfig() {
+  const globalState = globalThis;
+  globalState[GLOBAL_LOGGING_CONFIG_KEY] ??= {};
+  return globalState[GLOBAL_LOGGING_CONFIG_KEY];
+}
 function getFormatter(env) {
   switch (env) {
     case "terminal":
@@ -393,11 +417,14 @@ function getFormatter(env) {
   }
 }
 function getDefaultMinLevel() {
-  if (typeof process !== "undefined" && process.env?.DEBUG) {
+  if (hasDebugOptIn()) {
     return "debug";
   }
   return "info";
 }
+function getConfiguredFormatter(env, formatter) {
+  return formatter ?? getGlobalLoggingConfig().formatter ?? (shouldUseSilentFormatter() ? () => {} : getFormatter(env));
+}
 function shouldLog(level, minLevel) {
   return LOG_LEVELS.indexOf(level) >= LOG_LEVELS.indexOf(minLevel);
 }
@@ -406,14 +433,14 @@ class Logger {
   scope;
   minLevel;
   environment;
-  formatter;
+  explicitFormatter;
   defaultContext;
   constructor(options = {}) {
     this.scope = options.scope;
     this.minLevel = options.minLevel ?? getDefaultMinLevel();
     this.defaultContext = options.defaultContext ?? {};
     this.environment = options.environment ?? detectEnvironment();
-    this.formatter = getFormatter(this.environment);
+    this.explicitFormatter = options.formatter;
   }
   child(scope) {
     const childScope = this.scope ? `${this.scope}:${scope}` : scope;
@@ -421,7 +448,8 @@ class Logger {
       scope: childScope,
       minLevel: this.minLevel,
       environment: this.environment,
-      defaultContext: { ...this.defaultContext }
+      defaultContext: { ...this.defaultContext },
+      formatter: this.explicitFormatter
     });
   }
   withContext(context) {
@@ -429,7 +457,8 @@ class Logger {
       scope: this.scope,
       minLevel: this.minLevel,
       environment: this.environment,
-      defaultContext: { ...this.defaultContext, ...context }
+      defaultContext: { ...this.defaultContext, ...context },
+      formatter: this.explicitFormatter
     });
   }
   debug(message, context) {
@@ -458,7 +487,7 @@ class Logger {
       context: context || Object.keys(this.defaultContext).length > 0 ? { ...this.defaultContext, ...context } : undefined,
       timestamp: new Date
     };
-    this.formatter(entry);
+    getConfiguredFormatter(this.environment, this.explicitFormatter)(entry);
   }
 }
 function createLogger(options = {}) {
@@ -473,7 +502,6 @@ function isDebug() {
     return false;
   }
 }
-var log = createLogger({ scope: "auth", minLevel: isDebug() ? "debug" : "warn" });
 
 class TokenManager {
   config;
@@ -481,17 +509,22 @@ class TokenManager {
   tokenExpiry = 0;
   pendingRequest = null;
   fetchFn;
+  log;
   constructor(config) {
     this.config = config;
     this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
+    this.log = config.logger ?? createLogger({
+      scope: "auth",
+      minLevel: isDebug() ? "debug" : "warn"
+    });
   }
   async getToken() {
     if (this.accessToken && Date.now() < this.tokenExpiry) {
-      log.debug("Using cached token");
+      this.log.debug("Using cached token");
       return this.accessToken;
     }
     if (this.pendingRequest) {
-      log.debug("Waiting for in-flight token request");
+      this.log.debug("Waiting for in-flight token request");
       return this.pendingRequest;
     }
     this.pendingRequest = this.fetchToken();
@@ -502,7 +535,7 @@ class TokenManager {
     }
   }
   async fetchToken() {
-    log.debug("Fetching new access token...");
+    this.log.debug("Fetching new access token...");
     const { clientId, clientSecret } = this.config.credentials;
     const credentials = btoa(`${clientId}:${clientSecret}`);
     const start = performance.now();
@@ -516,17 +549,17 @@ class TokenManager {
     });
     const duration = Math.round(performance.now() - start);
     if (!response.ok) {
-      log.error(`Token request failed: ${response.status} ${response.statusText}`);
+      this.log.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)`);
+    this.log.debug(`Token acquired (${duration}ms, expires in ${data.expires_in}s)`);
     return this.accessToken;
   }
   invalidate() {
-    log.debug("Token invalidated");
+    this.log.debug("Token invalidated");
     this.accessToken = null;
     this.tokenExpiry = 0;
   }

package/dist/errors.js

@@ -5,7 +5,7 @@ import {
   NotFoundError,
   UnauthorizedError,
   ValidationError
-} from "./chunk-3bz9d5vy.js";
+} from "./chunk-0drvsw3w.js";
 import"./chunk-6jf1natv.js";
 export {
   ValidationError,

package/dist/index.d.ts

@@ -3,37 +3,6 @@ export { ActivityCompletedEvent, ActivityMetricType, AssessmentItemEvent, Calipe
 import { ActivityCompletedInput, QuestionAnsweredInput, QuestionGradedInput, QuestionSeenInput, TimeSpentInput, CaliperListEventsParams } from '@timeback/types/zod';
 export { ActivityCompletedInput, CaliperListEventsParams as ListEventsParams, QuestionAnsweredInput, QuestionGradedInput, QuestionSeenInput, TimeSpentInput } from '@timeback/types/zod';
 
-/**
- * Interface for obtaining OAuth2 access tokens.
- *
- * Implementations handle token caching and refresh automatically.
- */
-interface TokenProvider {
-    /**
-     * Get a valid access token.
-     *
-     * Returns a cached token if still valid, otherwise fetches a new one.
-     *
-     * @returns A valid access token string
-     * @throws {Error} If token acquisition fails
-     */
-    getToken(): Promise<string>;
-    /**
-     * Invalidate the cached token.
-     *
-     * Forces the next getToken() call to fetch a fresh token.
-     * Should be called when a request fails with 401 Unauthorized.
-     *
-     * Optional - not all implementations may support invalidation.
-     */
-    invalidate?(): void;
-}
-
-/**
- * All supported platforms.
- */
-declare const PLATFORMS: readonly ["BEYOND_AI", "LEARNWITH_AI"];
-
 /**
  * Type Definitions for `@timeback/internal-logger`
  *
@@ -69,6 +38,24 @@ type Environment$2 = 'terminal' | 'ci' | 'production' | 'browser' | 'test';
  * log.info('User created', { userId: 123, email: 'foo@bar.com' })
  */
 type LogContext = Record<string, unknown>;
+/**
+ * A single log entry before it's formatted for output.
+ *
+ * This is the internal representation passed to formatters.
+ * Formatters transform this into environment-specific output.
+ */
+interface LogEntry {
+    /** Severity level of this log entry */
+    level: LogLevel;
+    /** Human-readable log message */
+    message: string;
+    /** Optional namespace/category (e.g., "api", "db", "auth") */
+    scope?: string;
+    /** Optional structured data attached to this entry */
+    context?: LogContext;
+    /** When this log entry was created */
+    timestamp: Date;
+}
 /**
  * Configuration options for creating a logger instance.
  */
@@ -94,7 +81,21 @@ interface LoggerOptions {
      * Useful for request IDs, user IDs, etc.
      */
     defaultContext?: LogContext;
+    /**
+     * Custom formatter override for this logger instance.
+     *
+     * When provided, this takes precedence over environment-based formatting.
+     * Useful for tests, custom sinks, or temporarily suppressing output.
+     */
+    formatter?: Formatter;
 }
+/**
+ * Function that outputs a log entry in a specific format.
+ *
+ * Each environment has its own formatter. Formatters are responsible
+ * for the actual console.log/write calls.
+ */
+type Formatter = (entry: LogEntry) => void;
 
 /**
  * Logger instance with environment-aware formatting.
@@ -109,8 +110,8 @@ declare class Logger {
     private minLevel;
     /** The detected or configured environment */
     private environment;
-    /** Function that formats and outputs log entries */
-    private formatter;
+    /** Optional explicit formatter override for this logger instance */
+    private explicitFormatter?;
     /** Context added to every log entry from this logger */
     private defaultContext;
     /**
@@ -200,6 +201,37 @@ declare class Logger {
     private log;
 }
 
+/**
+ * Interface for obtaining OAuth2 access tokens.
+ *
+ * Implementations handle token caching and refresh automatically.
+ */
+interface TokenProvider {
+    /**
+     * Get a valid access token.
+     *
+     * Returns a cached token if still valid, otherwise fetches a new one.
+     *
+     * @returns A valid access token string
+     * @throws {Error} If token acquisition fails
+     */
+    getToken(): Promise<string>;
+    /**
+     * Invalidate the cached token.
+     *
+     * Forces the next getToken() call to fetch a fresh token.
+     * Should be called when a request fails with 401 Unauthorized.
+     *
+     * Optional - not all implementations may support invalidation.
+     */
+    invalidate?(): void;
+}
+
+/**
+ * All supported platforms.
+ */
+declare const PLATFORMS: readonly ["BEYOND_AI", "LEARNWITH_AI"];
+
 /**
  * Where Clause Types
  *

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   validateNonEmptyString,
   validateOffsetListParams,
   validateWithSchema
-} from "./chunk-3bz9d5vy.js";
+} from "./chunk-0drvsw3w.js";
 import {
   CALIPER_DATA_VERSION,
   CALIPER_ENV_VARS,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/caliper",
-	"version": "0.2.2-beta.20260401223329",
+	"version": "0.2.2-beta.20260409195426",
 	"description": "Caliper Analytics client SDK for Timeback",
 	"type": "module",
 	"exports": {
@@ -42,6 +42,6 @@
 		"esbuild": "^0.27.3"
 	},
 	"peerDependencies": {
-		"typescript": "^5"
+		"typescript": "^5 || ^6"
 	}
 }