@timeback/powerpath 0.2.3-beta.20260331232130 → 0.2.3-beta.20260403024308

package/dist/{chunk-setst1c6.js → chunk-89bw8av5.js}

@@ -146,6 +146,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, ".*");
@@ -155,7 +166,7 @@ function parseDebugEnv() {
   if (patterns !== null)
     return;
   patterns = [];
-  if (typeof process === "undefined" || !process.env?.DEBUG) {
+  if (!hasDebugOptIn()) {
     debugEnvSet = false;
     return;
   }
@@ -377,6 +388,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":
@@ -392,11 +416,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);
 }
@@ -405,14 +432,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;
@@ -420,7 +447,8 @@ class Logger {
       scope: childScope,
       minLevel: this.minLevel,
       environment: this.environment,
-      defaultContext: { ...this.defaultContext }
+      defaultContext: { ...this.defaultContext },
+      formatter: this.explicitFormatter
     });
   }
   withContext(context) {
@@ -428,7 +456,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) {
@@ -457,7 +486,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 = {}) {
@@ -472,7 +501,6 @@ function isDebug() {
     return false;
   }
 }
-var log = createLogger({ scope: "auth", minLevel: isDebug() ? "debug" : "warn" });
 
 class TokenManager {
   config;
@@ -480,17 +508,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();
@@ -501,7 +534,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();
@@ -515,17 +548,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-setst1c6.js";
+} from "./chunk-89bw8av5.js";
 import"./chunk-6jf1natv.js";
 export {
   ValidationError,

package/dist/index.d.ts

@@ -3,37 +3,6 @@ export { AssignmentResult, Attempt, BulkResult, CourseProgressResponse, CreateAt
 import { CreateExternalPlacementTestInput, CreateExternalTestOutInput, CreateInternalTestInput, CreateNewAttemptInput, FinalStudentAssessmentResponseInput, GetAssessmentProgressParams, GetAttemptsParams, GetNextQuestionParams, ImportExternalTestAssignmentResultsParams, MakeExternalTestAssignmentInput, ResetAttemptInput, TestOutParams, UpdateStudentQuestionResponseInput, LessonPlansCreateInput, LessonPlanOperationsInput, LessonPlanUpdateStudentItemResponseInput, PlacementQueryParams, PlacementResetUserPlacementInput, RenderConfigUpsertInput, ScreeningResetSessionInput, ScreeningAssignTestInput, SyllabusQueryParams, TestAssignmentsListParams, TestAssignmentsCreateInput, TestAssignmentsUpdateInput, TestAssignmentsAdminParams, TestAssignmentsBulkInput, TestAssignmentsImportInput, MakeExternalStudentTestOutAssignmentInput } from '@timeback/types/zod';
 export { CreateExternalPlacementTestInput, CreateExternalTestOutInput, CreateInternalTestInput, CreateNewAttemptInput, FinalStudentAssessmentResponseInput, GetAssessmentProgressParams, GetAttemptsParams, GetNextQuestionParams, ImportExternalTestAssignmentResultsParams, LessonPlanOperationInput, LessonPlanOperationsInput, LessonPlanUpdateStudentItemResponseInput, LessonPlansCreateInput, MakeExternalStudentTestOutAssignmentInput, MakeExternalTestAssignmentInput, PlacementQueryParams, PlacementResetUserPlacementInput, ResetAttemptInput, ScreeningAssignTestInput, ScreeningResetSessionInput, SyllabusQueryParams, TestAssignmentsAdminParams, TestAssignmentsBulkInput, TestAssignmentsCreateInput, TestAssignmentsImportInput, TestAssignmentsListParams, TestAssignmentsUpdateInput, TestOutParams, UpdateStudentQuestionResponseInput } 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

@@ -8,7 +8,7 @@ import {
   resolveToProvider,
   validateNonEmptyString,
   validateWithSchema
-} from "./chunk-setst1c6.js";
+} from "./chunk-89bw8av5.js";
 import"./chunk-6jf1natv.js";
 
 // src/constants.ts
@@ -101,6 +101,13 @@ var StringTimebackGrade = z.string().transform((value, ctx) => {
     return z.NEVER;
   }
   const stripped = raw.replace(/\bgrade\b/g, "").replace(/(\d+)(st|nd|rd|th)\b/g, "$1").trim();
+  if (stripped === "") {
+    ctx.addIssue({
+      code: "custom",
+      message: "must be a valid Timeback grade"
+    });
+    return z.NEVER;
+  }
   if (stripped === "pre-k" || stripped === "pk") {
     return -1;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/powerpath",
-	"version": "0.2.3-beta.20260331232130",
+	"version": "0.2.3-beta.20260403024308",
 	"description": "PowerPath client SDK for Timeback",
 	"type": "module",
 	"exports": {