@timeback/oneroster 0.2.2-beta.20260401223329 → 0.2.2-beta.20260403024308

package/dist/{chunk-bnh0e9yt.js → chunk-482xgqsm.js}

@@ -218,6 +218,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, ".*");
@@ -227,7 +238,7 @@ function parseDebugEnv() {
   if (patterns !== null)
     return;
   patterns = [];
-  if (typeof process === "undefined" || !process.env?.DEBUG) {
+  if (!hasDebugOptIn()) {
     debugEnvSet = false;
     return;
   }
@@ -449,6 +460,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":
@@ -464,11 +488,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);
 }
@@ -477,14 +504,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;
@@ -492,7 +519,8 @@ class Logger {
       scope: childScope,
       minLevel: this.minLevel,
       environment: this.environment,
-      defaultContext: { ...this.defaultContext }
+      defaultContext: { ...this.defaultContext },
+      formatter: this.explicitFormatter
     });
   }
   withContext(context) {
@@ -500,7 +528,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) {
@@ -529,7 +558,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 = {}) {
@@ -544,7 +573,6 @@ function isDebug() {
     return false;
   }
 }
-var log = createLogger({ scope: "auth", minLevel: isDebug() ? "debug" : "warn" });
 
 class TokenManager {
   config;
@@ -552,17 +580,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();
@@ -573,7 +606,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();
@@ -587,17 +620,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-bnh0e9yt.js";
+} from "./chunk-482xgqsm.js";
 import"./chunk-6jf1natv.js";
 export {
   ValidationError,

package/dist/index.d.ts

@@ -2,37 +2,6 @@ import { AcademicSessionCreateInput, EnrollInput, LineItemCreateInput, ResultCre
 import { LineItem, Result, CreateResponse, Resource, Base, ResourceType, AcademicSession, AcademicSessionFilterFields, ClassFilterFields, Class, GradingPeriod, UserFilterFields, User, LineItemFilterFields, ResultFilterFields, ResourceFilterFields, ScoreScaleFilterFields, ScoreScale, CategoryFilterFields, Category, Course, CourseComponentFilterFields, CourseComponent, Organization, EnrollmentFilterFields, Enrollment, CourseFilterFields, CredentialCreateResponse, DecryptedCredential, OrganizationFilterFields, ComponentResourceFilterFields, ComponentResource, AssessmentLineItem, AssessmentLineItemFilterFields, AssessmentResult, AssessmentResultFilterFields, Demographics, DemographicsFilterFields } from '@timeback/types/protocols/oneroster';
 import { z } from 'zod/v4';
 
-/**
- * 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`
  *
@@ -68,6 +37,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.
  */
@@ -93,7 +80,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.
@@ -108,8 +109,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;
     /**
@@ -199,6 +200,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

@@ -12,7 +12,7 @@ import {
   validateSourcedId,
   validateWithSchema,
   whereToFilter
-} from "./chunk-bnh0e9yt.js";
+} from "./chunk-482xgqsm.js";
 import"./chunk-6jf1natv.js";
 
 // src/constants.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/oneroster",
-	"version": "0.2.2-beta.20260401223329",
+	"version": "0.2.2-beta.20260403024308",
 	"type": "module",
 	"exports": {
 		".": {