@carbonorm/carbonnode 6.0.6 → 6.0.8

package/dist/index.cjs.js

@@ -331,6 +331,210 @@ var C6Constants = {
 };
 var C6C = C6Constants;
 
+/** biome-ignore-all lint/suspicious/noExplicitAny: working with global browser objects */
+function getRuntimeEnv(key) {
+    var _a;
+    return typeof window !== "undefined" && ((_a = window.__ENV__) === null || _a === void 0 ? void 0 : _a[key]);
+}
+// Do not import anything here
+function getViteEnv(key) {
+    var _a;
+    // @ts-expect-error
+    return typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs.js', document.baseURI).href)) }) !== "undefined" && ((_a = undefined) === null || _a === void 0 ? void 0 : _a[key]);
+}
+function getEnv(key, fallback) {
+    var _a;
+    try {
+        if (typeof process !== "undefined" && ((_a = process.env) === null || _a === void 0 ? void 0 : _a[key]) !== undefined) {
+            return process.env[key];
+        }
+    }
+    catch (_b) { }
+    try {
+        var viteEnv = getViteEnv(key);
+        if (viteEnv !== undefined)
+            return viteEnv;
+    }
+    catch (_c) { }
+    var runtimeEnv = getRuntimeEnv(key);
+    if (runtimeEnv !== undefined)
+        return runtimeEnv;
+    if (fallback !== undefined)
+        return fallback;
+    throw new Error("Missing environment variable: ".concat(key));
+}
+function getEnvBool(key, fallback) {
+    if (fallback === void 0) { fallback = false; }
+    var raw = getEnv(key, fallback);
+    var v = String(raw).trim().toLowerCase();
+    return (v === "true" ||
+        v === "1" ||
+        v === "yes" ||
+        v === "y" ||
+        v === "on" ||
+        v === "enabled");
+}
+function getEnvDebug(key, fallback) {
+    var _a;
+    try {
+        var viteEnv = getViteEnv(key);
+        if (viteEnv !== undefined) {
+            return { key: key, value: viteEnv, source: "vite" };
+        }
+    }
+    catch (_b) { }
+    var runtimeEnv = getRuntimeEnv(key);
+    if (runtimeEnv !== undefined) {
+        return { key: key, value: runtimeEnv, source: "runtime" };
+    }
+    if (typeof process !== "undefined" && ((_a = process.env) === null || _a === void 0 ? void 0 : _a[key]) !== undefined) {
+        return { key: key, value: process.env[key], source: "process" };
+    }
+    if (fallback !== undefined) {
+        return { key: key, value: fallback, source: "fallback" };
+    }
+    return { key: key, value: undefined, source: "missing" };
+}
+
+exports.LogLevel = void 0;
+(function (LogLevel) {
+    LogLevel[LogLevel["NONE"] = 0] = "NONE";
+    LogLevel[LogLevel["ERROR"] = 1] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["INFO"] = 3] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 4] = "DEBUG";
+    LogLevel[LogLevel["TRACE"] = 5] = "TRACE";
+})(exports.LogLevel || (exports.LogLevel = {}));
+var LOG_LEVEL_KEYS = ["LOG_LEVEL", "REACT_APP_LOG_LEVEL", "VITE_LOG_LEVEL"];
+var VERBOSE_KEYS = ["VERBOSE", "REACT_APP_VERBOSE", "VITE_VERBOSE"];
+var TRUE_VALUES = new Set(["true", "1", "yes", "y", "on", "enabled"]);
+var FALSE_VALUES = new Set(["false", "0", "no", "n", "off", "disabled"]);
+var clampLevel = function (level) {
+    if (level <= exports.LogLevel.NONE)
+        return exports.LogLevel.NONE;
+    if (level >= exports.LogLevel.TRACE)
+        return exports.LogLevel.TRACE;
+    return level;
+};
+var parseBoolean = function (value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value !== 0;
+    if (typeof value !== "string")
+        return undefined;
+    var normalized = value.trim().toLowerCase();
+    if (TRUE_VALUES.has(normalized))
+        return true;
+    if (FALSE_VALUES.has(normalized))
+        return false;
+    return undefined;
+};
+var parseLogLevel = function (value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return clampLevel(Math.round(value));
+    }
+    if (typeof value !== "string")
+        return undefined;
+    var raw = value.trim();
+    if (!raw)
+        return undefined;
+    if (/^-?\d+(\.\d+)?$/.test(raw)) {
+        return clampLevel(Math.round(Number(raw)));
+    }
+    switch (raw.toUpperCase()) {
+        case "NONE":
+        case "OFF":
+        case "SILENT":
+            return exports.LogLevel.NONE;
+        case "ERROR":
+        case "ERR":
+            return exports.LogLevel.ERROR;
+        case "WARN":
+        case "WARNING":
+            return exports.LogLevel.WARN;
+        case "INFO":
+            return exports.LogLevel.INFO;
+        case "DEBUG":
+            return exports.LogLevel.DEBUG;
+        case "TRACE":
+            return exports.LogLevel.TRACE;
+        default:
+            return undefined;
+    }
+};
+var getEnvLogLevel = function () {
+    for (var _i = 0, LOG_LEVEL_KEYS_1 = LOG_LEVEL_KEYS; _i < LOG_LEVEL_KEYS_1.length; _i++) {
+        var key = LOG_LEVEL_KEYS_1[_i];
+        var _a = getEnvDebug(key), value = _a.value, source = _a.source;
+        if (source !== "missing") {
+            var parsed = parseLogLevel(value);
+            if (parsed !== undefined)
+                return parsed;
+        }
+    }
+    for (var _b = 0, VERBOSE_KEYS_1 = VERBOSE_KEYS; _b < VERBOSE_KEYS_1.length; _b++) {
+        var key = VERBOSE_KEYS_1[_b];
+        var _c = getEnvDebug(key), value = _c.value, source = _c.source;
+        if (source !== "missing") {
+            var parsed = parseBoolean(value);
+            if (parsed !== undefined) {
+                return parsed ? exports.LogLevel.DEBUG : exports.LogLevel.WARN;
+            }
+        }
+    }
+    return undefined;
+};
+var resolveLogLevel = function (context) {
+    var _a, _b, _c;
+    var configured = parseLogLevel(context === null || context === void 0 ? void 0 : context.logLevel);
+    var verbose = context === null || context === void 0 ? void 0 : context.verbose;
+    var base = (_b = (_a = configured !== null && configured !== void 0 ? configured : (verbose !== undefined && verbose !== null
+        ? (verbose ? exports.LogLevel.DEBUG : exports.LogLevel.WARN)
+        : undefined)) !== null && _a !== void 0 ? _a : getEnvLogLevel()) !== null && _b !== void 0 ? _b : exports.LogLevel.WARN;
+    if (((_c = context === null || context === void 0 ? void 0 : context.request) === null || _c === void 0 ? void 0 : _c.debug) && base < exports.LogLevel.DEBUG) {
+        return exports.LogLevel.DEBUG;
+    }
+    return base;
+};
+var shouldLog = function (requiredLevel, context) {
+    return resolveLogLevel(context) >= requiredLevel;
+};
+var applyLogLevelDefaults = function (config, request) {
+    var _a;
+    if (config.logLevel === null || config.logLevel === undefined) {
+        var resolved = resolveLogLevel({
+            logLevel: config.logLevel,
+            verbose: config.verbose,
+            request: request !== null && request !== void 0 ? request : undefined,
+        });
+        config.logLevel = resolved;
+        return resolved;
+    }
+    return (_a = parseLogLevel(config.logLevel)) !== null && _a !== void 0 ? _a : exports.LogLevel.WARN;
+};
+var getLogContext = function (config, request) {
+    var _a, _b;
+    if (!config && !request)
+        return undefined;
+    return {
+        logLevel: (_a = config === null || config === void 0 ? void 0 : config.logLevel) !== null && _a !== void 0 ? _a : undefined,
+        verbose: (_b = config === null || config === void 0 ? void 0 : config.verbose) !== null && _b !== void 0 ? _b : undefined,
+        request: request !== null && request !== void 0 ? request : undefined,
+    };
+};
+var logWithLevel = function (requiredLevel, context, logger) {
+    var args = [];
+    for (var _i = 3; _i < arguments.length; _i++) {
+        args[_i - 3] = arguments[_i];
+    }
+    if (shouldLog(requiredLevel, context)) {
+        logger.apply(void 0, args);
+    }
+};
+
 function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler) {
     if (regexErrorHandler === void 0) { regexErrorHandler = alert; }
     var payload = {};
@@ -338,7 +542,7 @@ function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler)
     var tableDefinitions = tableNames.map(function (name) {
         var tableDefinition = Object.values(C6.TABLES).find(function (t) { return t.TABLE_NAME === name; });
         if (!tableDefinition) {
-            console.error("Table name (".concat(name, ") is not found in the C6.TABLES object."), C6.TABLES);
+            logWithLevel(exports.LogLevel.ERROR, undefined, console.error, "Table name (".concat(name, ") is not found in the C6.TABLES object."), C6.TABLES);
             throw new Error("Table name (".concat(name, ") is not found in the C6.TABLES object."));
         }
         return tableDefinition;
@@ -434,58 +638,36 @@ var isNode = function () {
     return typeof process !== 'undefined' && !!((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node);
 };
 
-function getEnvVar(key, fallback) {
-    if (fallback === void 0) { fallback = ''; }
-    // Vite-style injection
-    // @ts-ignore
-    if (typeof ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs.js', document.baseURI).href)) }) !== 'undefined' && undefined && key in undefined) {
-        // @ts-ignore
-        return undefined[key];
-    }
-    // Node or SSR
-    if (typeof process !== 'undefined' && process.env && key in process.env) {
-        return process.env[key];
-    }
-    return fallback;
-}
-
-function isVerbose () {
-    var envVerbose = getEnvVar('VERBOSE') || getEnvVar('REACT_APP_VERBOSE') || getEnvVar('VITE_VERBOSE') || '';
-    return ['true', '1', 'yes', 'on'].includes(envVerbose.toLowerCase());
-}
-
 /**
  * Facade: routes API calls to SQL or HTTP executors based on runtime context.
  */
 function restRequest(configX) {
     var _this = this;
     return function (request) { return tslib.__awaiter(_this, void 0, void 0, function () {
-        var config, SqlExecutor, executor, HttpExecutor, http;
-        var _a;
-        return tslib.__generator(this, function (_b) {
-            switch (_b.label) {
+        var config, logContext, SqlExecutor, executor, HttpExecutor, http;
+        return tslib.__generator(this, function (_a) {
+            switch (_a.label) {
                 case 0:
                     config = typeof configX === "function" ? configX() : configX;
-                    (_a = config.verbose) !== null && _a !== void 0 ? _a : (config.verbose = isVerbose()); // Default to env-driven verbosity if not set
-                    if (!(isNode() && config.mysqlPool)) return [3 /*break*/, 2];
-                    if (config.verbose) {
-                        console.log("Using SQL Executor");
+                    applyLogLevelDefaults(config, request);
+                    logContext = getLogContext(config, request);
+                    if (!config.mysqlPool && !config.axios) {
+                        throw new Error("No execution method available: neither mysqlPool nor axios instance provided in config.");
                     }
+                    if (!config.mysqlPool) return [3 /*break*/, 2];
+                    logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "Using SQL Executor");
                     return [4 /*yield*/, Promise.resolve().then(function () { return SqlExecutor$1; })];
                 case 1:
-                    SqlExecutor = (_b.sent()).SqlExecutor;
+                    SqlExecutor = (_a.sent()).SqlExecutor;
                     executor = new SqlExecutor(config, request);
                     return [2 /*return*/, executor.execute()];
                 case 2:
-                    if (config.verbose) {
-                        console.log("Using HTTP Executor", {
-                            isNode: isNode(),
-                            hasPool: !!config.mysqlPool
-                        });
-                    }
+                    logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "Using HTTP Executor", {
+                        isNode: isNode(),
+                    });
                     return [4 /*yield*/, Promise.resolve().then(function () { return HttpExecutor$1; })];
                 case 3:
-                    HttpExecutor = (_b.sent()).HttpExecutor;
+                    HttpExecutor = (_a.sent()).HttpExecutor;
                     http = new HttpExecutor(config, request);
                     return [2 /*return*/, http.execute()];
             }
@@ -522,10 +704,11 @@ var Executor = /** @class */ (function () {
         this.config = config;
         this.request = request;
         this.useNamedParams = useNamedParams;
+        applyLogLevelDefaults(this.config, this.request);
     }
     Executor.prototype.runLifecycleHooks = function (phase, args) {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var lifecycleGroup, _i, _a, _b, key, fn, err_1;
+            var lifecycleGroup, logContext, _i, _a, _b, key, fn, err_1;
             var _c;
             return tslib.__generator(this, function (_d) {
                 switch (_d.label) {
@@ -533,13 +716,14 @@ var Executor = /** @class */ (function () {
                         lifecycleGroup = (_c = this.config.restModel.LIFECYCLE_HOOKS[this.config.requestMethod]) === null || _c === void 0 ? void 0 : _c[phase];
                         if (!lifecycleGroup)
                             return [2 /*return*/];
+                        logContext = getLogContext(this.config, args.request);
                         _i = 0, _a = Object.entries(lifecycleGroup);
                         _d.label = 1;
                     case 1:
                         if (!(_i < _a.length)) return [3 /*break*/, 6];
                         _b = _a[_i], key = _b[0], fn = _b[1];
                         if (!(typeof fn === "function")) return [3 /*break*/, 5];
-                        if (this.config.verbose || args.request.debug) {
+                        if (shouldLog(exports.LogLevel.DEBUG, logContext)) {
                             console.groupCollapsed("[LIFECYCLE] ".concat(this.config.requestMethod, ".").concat(String(phase), ":").concat(key));
                             console.log("config:", args.config);
                             console.log("request:", args.request);
@@ -559,7 +743,7 @@ var Executor = /** @class */ (function () {
                         return [3 /*break*/, 5];
                     case 4:
                         err_1 = _d.sent();
-                        console.error("[LIFECYCLE ERROR] ".concat(this.config.requestMethod, ".").concat(String(phase), ":").concat(key), err_1);
+                        logWithLevel(exports.LogLevel.ERROR, logContext, console.error, "[LIFECYCLE ERROR] ".concat(this.config.requestMethod, ".").concat(String(phase), ":").concat(key), err_1);
                         throw err_1;
                     case 5:
                         _i++;
@@ -573,13 +757,13 @@ var Executor = /** @class */ (function () {
 }());
 
 function isLocal () {
-    return getEnvVar('NODE_ENV', '') === 'development';
+    return getEnv('NODE_ENV', '') === 'development';
 }
 
 function isTest () {
-    return getEnvVar('JEST_WORKER_ID') || getEnvVar('NODE_ENV') === 'test'
-        || getEnvVar('REACT_APP_TEST') === 'true' || getEnvVar('VITE_TEST') === 'true'
-        || getEnvVar('MODE') === 'test' || getEnvVar('VITE_TEST_MODE') === 'true';
+    return getEnv('JEST_WORKER_ID', null) || getEnv('NODE_ENV', "") === 'test'
+        || getEnvBool('REACT_APP_TEST', false) || getEnvBool('VITE_TEST', false)
+        || getEnv('MODE', '') === 'test' || getEnvBool('VITE_TEST_MODE', false);
 }
 
 exports.eFetchDependencies = void 0;
@@ -667,7 +851,9 @@ function removeInvalidKeys(request, c6Tables) {
             intersection[key] = request[key];
         }
     });
-    isTest() || console.log('intersection', intersection);
+    if (!isTest()) {
+        logWithLevel(exports.LogLevel.DEBUG, undefined, console.log, 'intersection', intersection);
+    }
     return intersection;
 }
 
@@ -699,7 +885,7 @@ function makeCacheKey(method, tableName, requestData) {
 // -----------------------------------------------------------------------------
 function clearCache(props) {
     if (!(props === null || props === void 0 ? void 0 : props.ignoreWarning)) {
-        console.warn("The REST API clearCache should only be used with extreme care!");
+        logWithLevel(exports.LogLevel.WARN, undefined, console.warn, "The REST API clearCache should only be used with extreme care!");
     }
     for (var _i = 0, userCustomClearCache_1 = userCustomClearCache; _i < userCustomClearCache_1.length; _i++) {
         var fn = userCustomClearCache_1[_i];
@@ -718,9 +904,11 @@ function checkCache(method, tableName, requestData) {
     var cached = apiRequestCache.get(key);
     if (!cached)
         return false;
-    console.groupCollapsed("%c API cache hit for ".concat(method, " ").concat(tableName), "color:#0c0");
-    console.log("Request Data:", requestData);
-    console.groupEnd();
+    if (shouldLog(exports.LogLevel.DEBUG, undefined)) {
+        console.groupCollapsed("%c API cache hit for ".concat(method, " ").concat(tableName), "color:#0c0");
+        console.log("Request Data:", requestData);
+        console.groupEnd();
+    }
     return cached.request;
 }
 // -----------------------------------------------------------------------------
@@ -785,7 +973,7 @@ var HttpExecutor = /** @class */ (function (_super) {
             catch ( /* best-effort */_d) { /* best-effort */ }
         }
         else if (isLocal()) {
-            console.error("C6 received unexpected results given the primary key length");
+            logWithLevel(exports.LogLevel.ERROR, getLogContext(this.config, this.request), console.error, "C6 received unexpected results given the primary key length");
         }
         (_b = this.config.reactBootstrap) === null || _b === void 0 ? void 0 : _b.updateRestfulObjectArrays({
             callback: callback,
@@ -816,11 +1004,10 @@ var HttpExecutor = /** @class */ (function (_super) {
     };
     HttpExecutor.prototype.execute = function () {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var _a, C6, axios, restURL, withCredentials, restModel, reactBootstrap, requestMethod, skipPrimaryCheck, clearCache, tableName, fullTableList, operatingTableFullName, operatingTable, tables, query, apiRequest;
+            var _a, C6, axios, restURL, withCredentials, restModel, reactBootstrap, requestMethod, skipPrimaryCheck, clearCache, tableName, fullTableList, operatingTableFullName, operatingTable, tables, logContext, debugEnabled, traceEnabled, query, apiRequest;
             var _this = this;
-            var _b;
-            return tslib.__generator(this, function (_c) {
-                switch (_c.label) {
+            return tslib.__generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         _a = this.config, C6 = _a.C6, axios = _a.axios, restURL = _a.restURL, withCredentials = _a.withCredentials, restModel = _a.restModel, reactBootstrap = _a.reactBootstrap, requestMethod = _a.requestMethod, skipPrimaryCheck = _a.skipPrimaryCheck, clearCache = _a.clearCache;
                         return [4 /*yield*/, this.runLifecycleHooks("beforeProcessing", {
@@ -828,7 +1015,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                 request: this.request,
                             })];
                     case 1:
-                        _c.sent();
+                        _b.sent();
                         tableName = restModel.TABLE_NAME;
                         fullTableList = Array.isArray(tableName) ? tableName : [tableName];
                         operatingTableFullName = fullTableList[0];
@@ -846,7 +1033,10 @@ var HttpExecutor = /** @class */ (function (_super) {
                         if (clearCache != null) {
                             userCustomClearCache.push(clearCache);
                         }
-                        if (isLocal() && (this.config.verbose || ((_b = this.request) === null || _b === void 0 ? void 0 : _b.debug))) {
+                        logContext = getLogContext(this.config, this.request);
+                        debugEnabled = shouldLog(exports.LogLevel.DEBUG, logContext);
+                        traceEnabled = shouldLog(exports.LogLevel.TRACE, logContext);
+                        if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                             console.groupCollapsed('%c API:', 'color: #0c0', "(".concat(requestMethod, ") Request for (").concat(tableName, ")"));
                             console.log('request', this.request);
                             console.groupEnd();
@@ -856,15 +1046,16 @@ var HttpExecutor = /** @class */ (function (_super) {
                             var _a, debug, _b, cacheResults, dataInsertMultipleRows, success, _c, fetchDependencies, _d, error, cachingConfirmed, cacheRequestData, querySerialized, cachedRequest, apiResponse, restRequestUri, needsConditionOrPrimaryCheck, TABLES, primaryKeyList, primaryKeyFullyQualified, primaryKey, whereVal, whereIsEmpty, providedPrimary, primaryVal, axiosActiveRequest_1;
                             var _e;
                             var _this = this;
-                            var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
-                            return tslib.__generator(this, function (_r) {
-                                switch (_r.label) {
+                            var _f, _g, _h, _j, _k, _l;
+                            return tslib.__generator(this, function (_m) {
+                                switch (_m.label) {
                                     case 0:
                                         _a = this.request, debug = _a.debug, _b = _a.cacheResults, cacheResults = _b === void 0 ? (C6.GET === requestMethod) : _b, dataInsertMultipleRows = _a.dataInsertMultipleRows, success = _a.success, _c = _a.fetchDependencies, fetchDependencies = _c === void 0 ? exports.eFetchDependencies.NONE : _c, _d = _a.error, error = _d === void 0 ? "An unexpected API error occurred!" : _d;
                                         if (C6.GET === requestMethod
                                             && undefined !== ((_f = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _f === void 0 ? void 0 : _f[C6.PAGE])
                                             && 1 !== query[C6.PAGINATION][C6.PAGE]
-                                            && isLocal()) {
+                                            && isLocal()
+                                            && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                             console.groupCollapsed("Request (".concat(tableName, ") page (").concat(query[C6.PAGINATION][C6.PAGE], ")"));
                                             console.log('request', this.request);
                                             console.groupEnd();
@@ -889,7 +1080,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                         }
                                         if (!cachedRequest) return [3 /*break*/, 2];
                                         return [4 /*yield*/, cachedRequest];
-                                    case 1: return [2 /*return*/, (_r.sent()).data];
+                                    case 1: return [2 /*return*/, (_m.sent()).data];
                                     case 2:
                                         if (cacheResults) {
                                             cachingConfirmed = true;
@@ -914,7 +1105,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                     (Array.isArray(whereVal) && whereVal.length === 0) ||
                                                     (typeof whereVal === 'object' && !Array.isArray(whereVal) && Object.keys(whereVal).length === 0);
                                                 if (whereIsEmpty) {
-                                                    console.error(query);
+                                                    logWithLevel(exports.LogLevel.ERROR, logContext, console.error, query);
                                                     throw Error('Failed to parse primary key information. Query: (' + JSON.stringify(query) + ') Primary Key: (' + JSON.stringify(primaryKey) + ') TABLES[operatingTable]?.PRIMARY: (' + JSON.stringify((_j = TABLES[operatingTable]) === null || _j === void 0 ? void 0 : _j.PRIMARY) + ') for operatingTable (' + operatingTable + ').');
                                                 }
                                             }
@@ -944,23 +1135,23 @@ var HttpExecutor = /** @class */ (function (_super) {
                                             primaryVal = (_l = query[primaryKey]) !== null && _l !== void 0 ? _l : (primaryKeyFullyQualified ? query[primaryKeyFullyQualified] : undefined);
                                             if (undefined !== primaryVal) {
                                                 restRequestUri += primaryVal + '/';
-                                                if (isLocal() && (this.config.verbose || ((_m = this.request) === null || _m === void 0 ? void 0 : _m.debug))) {
+                                                if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                                     console.log('query', query, 'primaryKey', primaryKey);
                                                 }
                                             }
                                             else {
-                                                if (isLocal() && (this.config.verbose || ((_o = this.request) === null || _o === void 0 ? void 0 : _o.debug))) {
+                                                if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                                     console.log('query', query);
                                                 }
                                             }
                                         }
                                         else {
-                                            if (isLocal() && (this.config.verbose || ((_p = this.request) === null || _p === void 0 ? void 0 : _p.debug))) {
+                                            if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                                 console.log('query', query);
                                             }
                                         }
                                         try {
-                                            if (isLocal() && (this.config.verbose || ((_q = this.request) === null || _q === void 0 ? void 0 : _q.debug))) {
+                                            if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                                 console.groupCollapsed('%c API:', 'color: #A020F0', "(".concat(requestMethod, ") (").concat(operatingTable, ") firing"));
                                                 console.log(this.request);
                                                 console.groupEnd();
@@ -1021,7 +1212,9 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                         });
                                                                     }
                                                                     if (isTest()) {
-                                                                        console.trace();
+                                                                        if (shouldLog(exports.LogLevel.TRACE, logContext)) {
+                                                                            console.trace();
+                                                                        }
                                                                         throw new Error('The response data was a string this typically indicated html was sent. Make sure all cookies (' + JSON.stringify(response.config.headers) + ') needed are present! (' + response.data + ')');
                                                                     }
                                                                     return [2 /*return*/, Promise.reject(response)];
@@ -1095,7 +1288,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                         final: !hasNext,
                                                                     });
                                                                 }
-                                                                if ((this.config.verbose || debug) && isLocal()) {
+                                                                if (isLocal() && shouldLog(exports.LogLevel.DEBUG, logContext)) {
                                                                     console.groupCollapsed("API: Response (".concat(requestMethod, " ").concat(tableName, ") len (").concat((_b = responseData_1.rest) === null || _b === void 0 ? void 0 : _b.length, ") of (").concat((_c = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _c === void 0 ? void 0 : _c[C6.LIMIT], ")"));
                                                                     console.log('request', this.request);
                                                                     console.log('response.rest', responseData_1.rest);
@@ -1104,14 +1297,18 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 if (!(fetchDependencies
                                                                     && 'number' === typeof fetchDependencies
                                                                     && ((_d = responseData_1.rest) === null || _d === void 0 ? void 0 : _d.length) > 0)) return [3 /*break*/, 2];
-                                                                console.groupCollapsed('%c API: Fetch Dependencies segment (' + requestMethod + ' ' + tableName + ')'
-                                                                    + (fetchDependencies & exports.eFetchDependencies.CHILDREN ? ' | (CHILDREN|REFERENCED) ' : '')
-                                                                    + (fetchDependencies & exports.eFetchDependencies.PARENTS ? ' | (PARENTS|REFERENCED_BY)' : '')
-                                                                    + (fetchDependencies & exports.eFetchDependencies.C6ENTITY ? ' | (C6ENTITY)' : '')
-                                                                    + (fetchDependencies & exports.eFetchDependencies.RECURSIVE ? ' | (RECURSIVE)' : ''), 'color: #33ccff');
-                                                                console.groupCollapsed('Collapsed JS Trace');
-                                                                console.trace(); // hidden in collapsed group
-                                                                console.groupEnd();
+                                                                if (debugEnabled) {
+                                                                    console.groupCollapsed('%c API: Fetch Dependencies segment (' + requestMethod + ' ' + tableName + ')'
+                                                                        + (fetchDependencies & exports.eFetchDependencies.CHILDREN ? ' | (CHILDREN|REFERENCED) ' : '')
+                                                                        + (fetchDependencies & exports.eFetchDependencies.PARENTS ? ' | (PARENTS|REFERENCED_BY)' : '')
+                                                                        + (fetchDependencies & exports.eFetchDependencies.C6ENTITY ? ' | (C6ENTITY)' : '')
+                                                                        + (fetchDependencies & exports.eFetchDependencies.RECURSIVE ? ' | (RECURSIVE)' : ''), 'color: #33ccff');
+                                                                    if (traceEnabled) {
+                                                                        console.groupCollapsed('Collapsed JS Trace');
+                                                                        console.trace(); // hidden in collapsed group
+                                                                        console.groupEnd();
+                                                                    }
+                                                                }
                                                                 dependencies_1 = {};
                                                                 // Remember this is a binary bitwise operation, so we can check for multiple dependencies at once
                                                                 if (fetchDependencies & exports.eFetchDependencies.C6ENTITY) {
@@ -1146,7 +1343,9 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 }
                                                                 fetchReferences_1 = {};
                                                                 apiRequestPromises = [];
-                                                                console.log('%c Dependencies', 'color: #005555', dependencies_1);
+                                                                if (debugEnabled) {
+                                                                    console.log('%c Dependencies', 'color: #005555', dependencies_1);
+                                                                }
                                                                 Object.keys(dependencies_1)
                                                                     .forEach(function (column) { return dependencies_1[column]
                                                                     .forEach(function (constraint) {
@@ -1172,7 +1371,9 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                     (_d = (_f = fetchReferences_1[constraint.TABLE])[_g = constraint.COLUMN]) !== null && _d !== void 0 ? _d : (_f[_g] = []);
                                                                     fetchReferences_1[constraint.TABLE][constraint.COLUMN].push(columnValues);
                                                                 }); });
-                                                                console.log('fetchReferences', fetchReferences_1);
+                                                                if (debugEnabled) {
+                                                                    console.log('fetchReferences', fetchReferences_1);
+                                                                }
                                                                 _loop_1 = function (tableToFetch) {
                                                                     var _g;
                                                                     if (fetchDependencies & exports.eFetchDependencies.C6ENTITY
@@ -1188,17 +1389,23 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                         }, []).map(function (entityTag) { var _a, _b; return (_b = (_a = entityTag.split('\\')) === null || _a === void 0 ? void 0 : _a.pop()) === null || _b === void 0 ? void 0 : _b.toLowerCase(); });
                                                                         var shouldContinue = referencesTables.find(function (referencesTable) { return tableToFetch.endsWith(referencesTable); });
                                                                         if (!shouldContinue) {
-                                                                            console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') did not end with any value in referencesTables', 'color: #c00', referencesTables);
+                                                                            if (debugEnabled) {
+                                                                                console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') did not end with any value in referencesTables', 'color: #c00', referencesTables);
+                                                                            }
                                                                             return "continue";
                                                                         }
-                                                                        console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') will be fetched.', 'color: #0c0');
+                                                                        if (debugEnabled) {
+                                                                            console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') will be fetched.', 'color: #0c0');
+                                                                        }
                                                                     }
                                                                     var ormKey = tableToFetch
                                                                         .split('_')
                                                                         .map(function (part) { return part.charAt(0).toUpperCase() + part.slice(1); })
                                                                         .join('_');
                                                                     var RestApi = (_e = C6.ORM[ormKey]) !== null && _e !== void 0 ? _e : new Error("Fetch Dependencies could not find table (".concat(ormKey, ") in the set \u2209 [ ").concat(Object.keys(C6.ORM).join(', '), " ]"));
-                                                                    console.log('%c Fetch Dependencies will select (' + tableToFetch + ') using GET request', 'color: #33ccff');
+                                                                    if (debugEnabled) {
+                                                                        console.log('%c Fetch Dependencies will select (' + tableToFetch + ') using GET request', 'color: #33ccff');
+                                                                    }
                                                                     var nextFetchDependencies = exports.eFetchDependencies.NONE;
                                                                     if (fetchDependencies & exports.eFetchDependencies.RECURSIVE) {
                                                                         var hasParents = !!(fetchDependencies & exports.eFetchDependencies.PARENTS);
@@ -1217,17 +1424,21 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                             nextFetchDependencies = fetchDependencies ^ exports.eFetchDependencies.C6ENTITY;
                                                                         }
                                                                     }
-                                                                    console.log('fetchReferences', fetchReferences_1[tableToFetch], "Current fetchDependencies for (" + operatingTable + "):", fetchDependencies, "New fetchDependencies for (" + tableToFetch + "): ", nextFetchDependencies);
+                                                                    if (debugEnabled) {
+                                                                        console.log('fetchReferences', fetchReferences_1[tableToFetch], "Current fetchDependencies for (" + operatingTable + "):", fetchDependencies, "New fetchDependencies for (" + tableToFetch + "): ", nextFetchDependencies);
+                                                                    }
                                                                     // todo - filter out ids that exist in state?!? note - remember that this does not necessarily mean the pk, but only known is its an FK to somewhere
                                                                     // it not certain that they are using carbons' entities either
-                                                                    console.log('RestApi object', RestApi);
+                                                                    if (debugEnabled) {
+                                                                        console.log('RestApi object', RestApi);
+                                                                    }
                                                                     // this is a dynamic call to the rest api, any generated table may resolve with (RestApi)
                                                                     // todo - using value to avoid joins.... but. maybe this should be a parameterizable option -- think race conditions; its safer to join
                                                                     apiRequestPromises.push(RestApi.Get((_g = {},
                                                                         _g[C6.WHERE] = Object.keys(fetchReferences_1[tableToFetch]).reduce(function (sum, column) {
                                                                             fetchReferences_1[tableToFetch][column] = fetchReferences_1[tableToFetch][column].flat(Infinity);
                                                                             if (0 === fetchReferences_1[tableToFetch][column].length) {
-                                                                                console.warn('The column (' + column + ') was not found in the response data. We will not fetch.', responseData_1);
+                                                                                logWithLevel(exports.LogLevel.WARN, logContext, console.warn, 'The column (' + column + ') was not found in the response data. We will not fetch.', responseData_1);
                                                                                 return false;
                                                                             }
                                                                             sum["".concat(tableToFetch, ".").concat(column)] = fetchReferences_1[tableToFetch][column].length === 1
@@ -1243,7 +1454,9 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 for (tableToFetch in fetchReferences_1) {
                                                                     _loop_1(tableToFetch);
                                                                 }
-                                                                console.groupEnd();
+                                                                if (debugEnabled) {
+                                                                    console.groupEnd();
+                                                                }
                                                                 return [4 /*yield*/, Promise.all(apiRequestPromises)];
                                                             case 1:
                                                                 _f.sent();
@@ -1284,19 +1497,23 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                 }); }).then(function (response) { return response.data; })]; // this escapes from axios context
                                         }
                                         catch (throwableError) {
-                                            console.groupCollapsed('%c API: An error occurred in the try catch block. returning null!', 'color: #ff0000');
-                                            console.log('%c ' + requestMethod + ' ' + tableName, 'color: #A020F0');
-                                            console.error(throwableError);
-                                            console.trace();
-                                            console.groupEnd();
-                                            throw new Error(JSON.stringify(throwableError));
+                                            if (shouldLog(exports.LogLevel.ERROR, logContext)) {
+                                                console.groupCollapsed('%c API: An error occurred in the try catch block. returning null!', 'color: #ff0000');
+                                                console.log('%c ' + requestMethod + ' ' + tableName, 'color: #A020F0');
+                                                console.error(throwableError);
+                                                if (traceEnabled) {
+                                                    console.trace();
+                                                }
+                                                console.groupEnd();
+                                            }
+                                            throw throwableError;
                                         }
                                         return [2 /*return*/];
                                 }
                             });
                         }); };
                         return [4 /*yield*/, apiRequest()];
-                    case 2: return [2 /*return*/, _c.sent()];
+                    case 2: return [2 /*return*/, _b.sent()];
                 }
             });
         });
@@ -1389,7 +1606,7 @@ var AggregateBuilder = /** @class */ (function (_super) {
                 this.selectAliases.add(alias);
                 expr_1 += " AS ".concat(alias);
             }
-            this.config.verbose && console.log("[SELECT] ".concat(expr_1));
+            logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[SELECT] ".concat(expr_1));
             return expr_1;
         }
         var identifierPathRegex = /^[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*$/;
@@ -1430,7 +1647,7 @@ var AggregateBuilder = /** @class */ (function (_super) {
             this.selectAliases.add(alias);
             expr += " AS ".concat(alias);
         }
-        this.config.verbose && console.log("[SELECT] ".concat(expr));
+        logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[SELECT] ".concat(expr));
         return expr;
     };
     return AggregateBuilder;
@@ -2079,7 +2296,7 @@ var ConditionBuilder = /** @class */ (function (_super) {
                     break;
             }
             var clause = "(MATCH(".concat(leftInfo_1.sql, ") ").concat(againstClause, ")");
-            this.config.verbose && console.log("[MATCH_AGAINST] ".concat(clause));
+            logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[MATCH_AGAINST] ".concat(clause));
             return clause;
         }
         var operands = Array.isArray(rawOperands) ? rawOperands : [rawOperands];
@@ -2328,7 +2545,7 @@ var ConditionBuilder = /** @class */ (function (_super) {
                 }
             }
         }
-        this.config.verbose && console.log("[WHERE] ".concat(trimmed));
+        logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[WHERE] ".concat(trimmed));
         return " WHERE ".concat(trimmed);
     };
     return ConditionBuilder;
@@ -2558,7 +2775,7 @@ var JoinBuilder = /** @class */ (function (_super) {
             var _a = joinTypeEntries_1[_i], joinTypeRaw = _a[0], joinSection = _a[1];
             _loop_1(joinTypeRaw, joinSection);
         }
-        this.config.verbose && console.log("[JOIN] ".concat(sql.trim()));
+        logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[JOIN] ".concat(sql.trim()));
         return sql;
     };
     JoinBuilder.prototype.integrateSubSelectParams = function (subSql, subParams, target) {
@@ -2675,12 +2892,176 @@ var PaginationBuilder = /** @class */ (function (_super) {
                 sql += " LIMIT ".concat(offset, ", ").concat(lim);
             }
         }
-        this.config.verbose && console.log("[PAGINATION] ".concat(sql.trim()));
+        logWithLevel(exports.LogLevel.DEBUG, getLogContext(this.config, this.request), console.log, "[PAGINATION] ".concat(sql.trim()));
         return sql;
     };
     return PaginationBuilder;
 }(JoinBuilder));
 
+/* eslint-disable no-control-regex */
+var RESET = "\x1b[0m";
+var C$1 = {
+    KEYWORD: "\x1b[94m", // blue
+    LIMIT: "\x1b[93m", // yellow
+    NUMBER: "\x1b[92m", // green
+    DIM: "\x1b[90m", // gray
+};
+/* ---------- ANSI helpers ---------- */
+var ansi256 = function (n) { return "\u001B[38;5;".concat(n, "m"); };
+/* ---------- hashing ---------- */
+function hashString$1(str) {
+    var hash = 0;
+    for (var i = 0; i < str.length; i++) {
+        hash = (hash * 31 + str.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash);
+}
+/* ---------- table color ---------- */
+function tableRGB(tableName) {
+    var name = tableName.replace(/[`"]/g, "").toLowerCase();
+    var hash = hashString$1(name);
+    // Stable hue bucket by first letter
+    var first = name.charCodeAt(0) || 97;
+    var hueBase = (first - 97) % 6;
+    var r = (hueBase + (hash % 3)) % 6;
+    var g = (hash >> 3) % 6;
+    var b = (hash >> 6) % 6;
+    return [r, g, Math.max(2, b)]; // avoid muddy dark blues
+}
+function tableColor(table) {
+    var _a = tableRGB(table), r = _a[0], g = _a[1], b = _a[2];
+    return ansi256(16 + 36 * r + 6 * g + b);
+}
+/* ---------- column color (same hue, lighter) ---------- */
+function columnColorFromTable(table) {
+    var _a = tableRGB(table), r = _a[0], g = _a[1], b = _a[2];
+    // Lift toward white, preserve hue
+    var lr = Math.min(5, r + 1);
+    var lg = Math.min(5, g + 1);
+    var lb = Math.min(5, b + 2);
+    return ansi256(16 + 36 * lr + 6 * lg + lb);
+}
+/* ---------- bind collapsing ---------- */
+/**
+ * ?, ?, ?, ?, ?, ?  →  ? ×6
+ * triggers at 4+
+ */
+function collapseBinds(sql) {
+    return sql.replace(/(\?\s*,\s*){3,}\?/g, function (match) {
+        var count = match.split("?").length - 1;
+        return "".concat(C$1.DIM, "? \u00D7").concat(count).concat(RESET);
+    });
+}
+/* ---------- main formatter ---------- */
+function colorSql(sql) {
+    var s = sql.trim();
+    /* 1️⃣ collapse bind noise */
+    s = collapseBinds(s);
+    /* 2️⃣ table.column coloring (core visual grouping) */
+    s = s.replace(/\b(`?\w+`?)\.(\w+)\b/g, function (_, table, column) {
+        return "".concat(tableColor(table)).concat(table).concat(RESET, ".") +
+            "".concat(columnColorFromTable(table)).concat(column).concat(RESET);
+    });
+    /* 3️⃣ FROM / JOIN tables */
+    s = s.replace(/\b(FROM|JOIN|UPDATE|INTO)\s+(`[^`]+`|\w+)/gi, function (_, kw, table) {
+        return "".concat(C$1.KEYWORD).concat(kw).concat(RESET, " ").concat(tableColor(table)).concat(table).concat(RESET);
+    });
+    /* 4️⃣ SQL keywords */
+    s = s.replace(/\b(SELECT|WHERE|AND|OR|ON|IN|BETWEEN|EXISTS|ORDER BY|GROUP BY|HAVING|SET|VALUES|INSERT|REPLACE|DELETE|UPDATE|DUPLICATE|KEY)\b/gi, "".concat(C$1.KEYWORD, "$1").concat(RESET));
+    /* 5️⃣ LIMIT */
+    s = s.replace(/\bLIMIT\s+(\d+)/gi, "".concat(C$1.LIMIT, "LIMIT").concat(RESET, " ").concat(C$1.NUMBER, "$1").concat(RESET));
+    return s;
+}
+
+var version = "6.0.8";
+
+var DEFAULT_STEP = 8;
+function parseSemver(version) {
+    var _a = version.trim().split("-"), core = _a[0], prerelease = _a[1];
+    var _b = core.split("."), majorRaw = _b[0], minorRaw = _b[1], patchRaw = _b[2];
+    var major = Number.parseInt(majorRaw !== null && majorRaw !== void 0 ? majorRaw : "0", 10);
+    var minor = Number.parseInt(minorRaw !== null && minorRaw !== void 0 ? minorRaw : "0", 10);
+    var patch = Number.parseInt(patchRaw !== null && patchRaw !== void 0 ? patchRaw : "0", 10);
+    var prereleaseParts = prerelease ? prerelease.split(".").filter(Boolean).length : 0;
+    return {
+        major: Number.isFinite(major) ? major : 0,
+        minor: Number.isFinite(minor) ? minor : 0,
+        patch: Number.isFinite(patch) ? patch : 0,
+        prereleaseParts: prereleaseParts,
+    };
+}
+function channelValue(n, step) {
+    var value = 255 - ((n * step) % 256);
+    return (value + 256) % 256;
+}
+function versionToRgb(version, step) {
+    if (step === void 0) { step = DEFAULT_STEP; }
+    var safeStep = Number.isFinite(step) && step > 0 ? Math.floor(step) : DEFAULT_STEP;
+    var _a = parseSemver(version), major = _a.major, minor = _a.minor, patch = _a.patch, prereleaseParts = _a.prereleaseParts;
+    var rotation = (major + minor + patch + prereleaseParts) % 3;
+    var base = [major, minor, patch];
+    var rotated = rotation === 1
+        ? [base[2], base[0], base[1]]
+        : rotation === 2
+            ? [base[1], base[2], base[0]]
+            : base;
+    return {
+        r: channelValue(rotated[0], safeStep),
+        g: channelValue(rotated[1], safeStep),
+        b: channelValue(rotated[2], safeStep),
+    };
+}
+
+var C = {
+    SSR: "\x1b[95m", // bright magenta
+    HTTP: "\x1b[94m", // bright blue
+    METHOD_COLORS: {
+        SELECT: "\x1b[92m", // green
+        INSERT: "\x1b[96m", // cyan
+        REPLACE: "\x1b[96m", // cyan
+        UPDATE: "\x1b[95m", // magenta
+        DELETE: "\x1b[91m", // red
+    },
+    METHOD_FALLBACK: [
+        "\x1b[92m", // green
+        "\x1b[93m", // yellow
+        "\x1b[95m", // magenta
+        "\x1b[96m", // cyan
+        "\x1b[94m", // blue
+        "\x1b[97m", // white
+    ],
+    RESET: "\x1b[0m",
+};
+var rgbAnsi = function (_a) {
+    var r = _a.r, g = _a.g, b = _a.b;
+    return "\u001B[38;2;".concat(r, ";").concat(g, ";").concat(b, "m");
+};
+function hashString(value) {
+    var hash = 0;
+    for (var i = 0; i < value.length; i++) {
+        hash = (hash * 31 + value.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash);
+}
+function methodColor(method) {
+    var key = method.toUpperCase();
+    if (key in C.METHOD_COLORS) {
+        return C.METHOD_COLORS[key];
+    }
+    var idx = hashString(key) % C.METHOD_FALLBACK.length;
+    return C.METHOD_FALLBACK[idx];
+}
+function logSql(method, sql, context) {
+    if (!shouldLog(exports.LogLevel.DEBUG, context))
+        return;
+    var preText = getEnvBool("SSR", false)
+        ? "".concat(C.SSR, "[SSR]").concat(C.RESET, " ")
+        : "".concat(C.HTTP, "[API]").concat(C.RESET, " ");
+    var labelColor = methodColor(method);
+    var versionColor = rgbAnsi(versionToRgb(version));
+    console.log("".concat(versionColor, "[").concat(version, "]").concat(C.RESET, " ").concat(preText).concat(labelColor, "[").concat(method, "]").concat(C.RESET, " ").concat(colorSql(sql)));
+}
+
 var SelectQueryBuilder = /** @class */ (function (_super) {
     tslib.__extends(SelectQueryBuilder, _super);
     function SelectQueryBuilder() {
@@ -2732,7 +3113,7 @@ var SelectQueryBuilder = /** @class */ (function (_super) {
         else if (!isSubSelect) {
             sql += " LIMIT 100";
         }
-        console.log("[SELECT] ".concat(sql.trim()));
+        logSql("SELECT", sql, getLogContext(this.config, this.request));
         return { sql: sql, params: params };
     };
     return SelectQueryBuilder;
@@ -2757,6 +3138,7 @@ var DeleteQueryBuilder = /** @class */ (function (_super) {
         if (this.request.WHERE) {
             sql += this.buildWhereClause(this.request.WHERE, params);
         }
+        logSql("DELETE", sql, getLogContext(this.config, this.request));
         return { sql: sql, params: params };
     };
     return DeleteQueryBuilder;
@@ -2801,6 +3183,7 @@ var PostQueryBuilder = /** @class */ (function (_super) {
             var updateClause = updateData.map(function (k) { return "`".concat(k, "` = VALUES(`").concat(k, "`)"); }).join(', ');
             sql += " ON DUPLICATE KEY UPDATE ".concat(updateClause);
         }
+        logSql(verb, sql, getLogContext(this.config, this.request));
         return { sql: sql, params: params };
     };
     return PostQueryBuilder;
@@ -2852,6 +3235,7 @@ var UpdateQueryBuilder = /** @class */ (function (_super) {
         if (args.PAGINATION) {
             sql += this.buildPaginationClause(args.PAGINATION, params);
         }
+        logSql("UPDATE", sql, getLogContext(this.config, this.request));
         return { sql: sql, params: params };
     };
     return UpdateQueryBuilder;
@@ -3110,7 +3494,7 @@ var SqlExecutor = /** @class */ (function (_super) {
     }
     SqlExecutor.prototype.execute = function () {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var TABLE_NAME, method, _a, rest, result, result, result;
+            var TABLE_NAME, method, logContext, _a, rest, result, result, result;
             return tslib.__generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
@@ -3124,8 +3508,9 @@ var SqlExecutor = /** @class */ (function (_super) {
                             // Surface normalization errors early
                             throw e;
                         }
-                        this.config.verbose && console.log("[SQL EXECUTOR] \u25B6\uFE0F Executing ".concat(method, " on table \"").concat(TABLE_NAME, "\""));
-                        this.config.verbose && console.log("[SQL EXECUTOR] \uD83E\uDDE9 Request:", this.request);
+                        logContext = getLogContext(this.config, this.request);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \u25B6\uFE0F Executing ".concat(method, " on table \"").concat(TABLE_NAME, "\""));
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \uD83E\uDDE9 Request:", this.request);
                         _a = method;
                         switch (_a) {
                             case 'GET': return [3 /*break*/, 1];
@@ -3173,22 +3558,23 @@ var SqlExecutor = /** @class */ (function (_super) {
     };
     SqlExecutor.prototype.withConnection = function (cb) {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var conn;
+            var logContext, conn;
             return tslib.__generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        this.config.verbose && console.log("[SQL EXECUTOR] \uD83D\uDCE1 Getting DB connection");
+                        logContext = getLogContext(this.config, this.request);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \uD83D\uDCE1 Getting DB connection");
                         return [4 /*yield*/, this.config.mysqlPool.getConnection()];
                     case 1:
                         conn = _a.sent();
                         _a.label = 2;
                     case 2:
                         _a.trys.push([2, , 4, 5]);
-                        this.config.verbose && console.log("[SQL EXECUTOR] \u2705 Connection acquired");
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \u2705 Connection acquired");
                         return [4 /*yield*/, cb(conn)];
                     case 3: return [2 /*return*/, _a.sent()];
                     case 4:
-                        this.config.verbose && console.log("[SQL EXECUTOR] \uD83D\uDD0C Releasing DB connection");
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \uD83D\uDD0C Releasing DB connection");
                         conn.release();
                         return [7 /*endfinally*/];
                     case 5: return [2 /*return*/];
@@ -3364,19 +3750,20 @@ var SqlExecutor = /** @class */ (function (_super) {
     };
     SqlExecutor.prototype.broadcastWebsocketIfConfigured = function (response) {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var broadcast, normalizedRequest, pkShorts, columns, validColumns, responseRest, responsePrimaryKey, insertId, synthesizedRequest, now, synthesized, payload, error_1;
+            var broadcast, logContext, normalizedRequest, pkShorts, columns, validColumns, responseRest, responsePrimaryKey, insertId, synthesizedRequest, now, synthesized, payload, error_1;
             var _a, _b;
             var _c, _d, _e;
             return tslib.__generator(this, function (_f) {
                 switch (_f.label) {
                     case 0:
                         broadcast = this.config.websocketBroadcast;
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 broadcastWebsocketIfConfigured start", {
+                        logContext = getLogContext(this.config, this.request);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 broadcastWebsocketIfConfigured start", {
                             method: this.config.requestMethod,
                             hasBroadcast: Boolean(broadcast),
                         });
                         if (!broadcast || this.config.requestMethod === C6Constants.GET) {
-                            this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket broadcast skipped", {
+                            logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket broadcast skipped", {
                                 reason: !broadcast ? "no broadcast configured" : "GET request",
                             });
                             return [2 /*return*/];
@@ -3387,22 +3774,22 @@ var SqlExecutor = /** @class */ (function (_super) {
                         validColumns = new Set(Object.values(columns));
                         responseRest = response === null || response === void 0 ? void 0 : response.rest;
                         responsePrimaryKey = this.extractPrimaryKeyValuesFromData(responseRest);
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket request payload", {
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket request payload", {
                             normalizedRequest: normalizedRequest,
                             requestPrimaryKey: this.extractPrimaryKeyValues(),
                             pkShorts: pkShorts,
                         });
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket response payload", {
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket response payload", {
                             responseRest: responseRest,
                             responsePrimaryKey: responsePrimaryKey,
                         });
                         if ((responseRest === null || (Array.isArray(responseRest) && responseRest.length === 0))
                             && this.config.requestMethod === C6Constants.POST) {
-                            this.config.verbose && console.log("[SQL EXECUTOR] 📣 response rest empty, attempting synthesize", {
+                            logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 response rest empty, attempting synthesize", {
                                 responseRest: responseRest,
                             });
                             insertId = response === null || response === void 0 ? void 0 : response.insertId;
-                            this.config.verbose && console.log("[SQL EXECUTOR] 📣 POST insertId lookup", {
+                            logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 POST insertId lookup", {
                                 insertId: insertId,
                             });
                             if (insertId !== undefined && pkShorts.length === 1) {
@@ -3423,7 +3810,7 @@ var SqlExecutor = /** @class */ (function (_super) {
                                 responsePrimaryKey = (_b = {},
                                     _b[pkShorts[0]] = insertId,
                                     _b);
-                                this.config.verbose && console.log("[SQL EXECUTOR] 📣 synthesized response payload", {
+                                logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 synthesized response payload", {
                                     synthesized: synthesized,
                                     responsePrimaryKey: responsePrimaryKey,
                                 });
@@ -3440,21 +3827,19 @@ var SqlExecutor = /** @class */ (function (_super) {
                                 RESPONSE_PRIMARY_KEY: responsePrimaryKey,
                             },
                         };
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket payload ready", payload);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket payload ready", payload);
                         _f.label = 1;
                     case 1:
                         _f.trys.push([1, 3, , 4]);
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket broadcast dispatch start");
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket broadcast dispatch start");
                         return [4 /*yield*/, broadcast(payload)];
                     case 2:
                         _f.sent();
-                        this.config.verbose && console.log("[SQL EXECUTOR] 📣 websocket broadcast dispatch complete");
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] 📣 websocket broadcast dispatch complete");
                         return [3 /*break*/, 4];
                     case 3:
                         error_1 = _f.sent();
-                        if (this.config.verbose) {
-                            console.error("[SQL EXECUTOR] websocketBroadcast failed", error_1);
-                        }
+                        logWithLevel(exports.LogLevel.ERROR, logContext, console.error, "[SQL EXECUTOR] websocketBroadcast failed", error_1);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }
@@ -3463,7 +3848,7 @@ var SqlExecutor = /** @class */ (function (_super) {
     };
     SqlExecutor.prototype.runQuery = function () {
         return tslib.__awaiter(this, void 0, void 0, function () {
-            var TABLE_NAME, method, builder, QueryResult, formatted, toUnnamed, _a, sql, values;
+            var TABLE_NAME, method, builder, QueryResult, logContext, formatted, toUnnamed, _a, sql, values;
             var _this = this;
             return tslib.__generator(this, function (_b) {
                 switch (_b.label) {
@@ -3487,9 +3872,10 @@ var SqlExecutor = /** @class */ (function (_super) {
                                 throw new Error("Unsupported query method: ".concat(method));
                         }
                         QueryResult = builder.build(TABLE_NAME);
-                        this.config.verbose && console.log("[SQL EXECUTOR] \uD83E\uDDE0 Generated ".concat(method.toUpperCase(), " SQL:"), QueryResult);
+                        logContext = getLogContext(this.config, this.request);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \uD83E\uDDE0 Generated ".concat(method.toUpperCase(), " SQL:"), QueryResult);
                         formatted = this.formatSQLWithParams(QueryResult.sql, QueryResult.params);
-                        this.config.verbose && console.log("[SQL EXECUTOR] \uD83E\uDDE0 Formatted ".concat(method.toUpperCase(), " SQL:"), formatted);
+                        logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \uD83E\uDDE0 Formatted ".concat(method.toUpperCase(), " SQL:"), formatted);
                         toUnnamed = namedPlaceholders();
                         _a = toUnnamed(QueryResult.sql, QueryResult.params), sql = _a[0], values = _a[1];
                         return [4 /*yield*/, this.validateSqlAllowList(sql)];
@@ -3509,7 +3895,7 @@ var SqlExecutor = /** @class */ (function (_super) {
                                                     }];
                                             }
                                             else {
-                                                this.config.verbose && console.log("[SQL EXECUTOR] \u270F\uFE0F Rows affected:", result.affectedRows);
+                                                logWithLevel(exports.LogLevel.DEBUG, logContext, console.log, "[SQL EXECUTOR] \u270F\uFE0F Rows affected:", result.affectedRows);
                                                 return [2 /*return*/, {
                                                         affected: result.affectedRows,
                                                         insertId: result.insertId,
@@ -3584,7 +3970,7 @@ function ExpressHandler(_a) {
                     }
                     // Warn for unsupported overrides but continue normally
                     if (incomingMethod !== 'GET' && methodOverride && methodOverride !== 'GET') {
-                        console.warn("Ignoring unsupported METHOD override: ".concat(methodOverride));
+                        logWithLevel(exports.LogLevel.WARN, undefined, console.warn, "Ignoring unsupported METHOD override: ".concat(methodOverride));
                     }
                     if (!(table in C6.TABLES)) {
                         res.status(400).json({ error: "Invalid table: ".concat(table) });
@@ -3708,10 +4094,9 @@ function getPrimaryKeyTypes(table) {
     return result;
 }
 
-/**
- * Conditionally group a log if verbose.
- */
 function group(title, data) {
+    if (!shouldLog(exports.LogLevel.DEBUG))
+        return;
     console.groupCollapsed("%c".concat(title), "color: #007acc");
     if (data !== undefined)
         console.log(data);
@@ -3722,6 +4107,8 @@ function info(message) {
     for (var _i = 1; _i < arguments.length; _i++) {
         optional[_i - 1] = arguments[_i];
     }
+    if (!shouldLog(exports.LogLevel.INFO))
+        return;
     console.info.apply(console, tslib.__spreadArray(["%cINFO: ".concat(message), "color: #0a0"], optional, false));
 }
 function warn(message) {
@@ -3729,6 +4116,8 @@ function warn(message) {
     for (var _i = 1; _i < arguments.length; _i++) {
         optional[_i - 1] = arguments[_i];
     }
+    if (!shouldLog(exports.LogLevel.WARN))
+        return;
     console.warn.apply(console, tslib.__spreadArray(["%cWARN: ".concat(message), "color: #e90"], optional, false));
 }
 function error(message) {
@@ -3736,6 +4125,8 @@ function error(message) {
     for (var _i = 1; _i < arguments.length; _i++) {
         optional[_i - 1] = arguments[_i];
     }
+    if (!shouldLog(exports.LogLevel.ERROR))
+        return;
     console.error.apply(console, tslib.__spreadArray(["%cERROR: ".concat(message), "color: #c00"], optional, false));
 }
 
@@ -3747,7 +4138,7 @@ function checkAllRequestsComplete() {
             throw new Error('document is undefined while waiting for API requests to complete (' + JSON.stringify(cacheEntries) + ')');
         }
         // when requests return emtpy sets in full renders, it may not be possible to track their progress.
-        console.warn('stillRunning...', stillRunning);
+        logWithLevel(exports.LogLevel.WARN, undefined, console.warn, 'stillRunning...', stillRunning);
         return stillRunning.map(function (cache) { return cache.requestArgumentsSerialized; });
     }
     return true;
@@ -3760,6 +4151,10 @@ function onError(message) {
     notifyToast("error", message, isLocal() ? toastOptionsDevs : toastOptions);
 }
 
+function isVerbose() {
+    return resolveLogLevel() >= exports.LogLevel.DEBUG;
+}
+
 exports.A = A;
 exports.AggregateBuilder = AggregateBuilder;
 exports.C6C = C6C;
@@ -3782,6 +4177,7 @@ exports.SqlExecutor = SqlExecutor;
 exports.TestRestfulResponse = TestRestfulResponse;
 exports.UpdateQueryBuilder = UpdateQueryBuilder;
 exports.apiRequestCache = apiRequestCache;
+exports.applyLogLevelDefaults = applyLogLevelDefaults;
 exports.axiosInstance = axiosInstance;
 exports.bbox = bbox;
 exports.carbonNodeQsStringify = carbonNodeQsStringify;
@@ -3789,6 +4185,7 @@ exports.checkAllRequestsComplete = checkAllRequestsComplete;
 exports.checkCache = checkCache;
 exports.clearCache = clearCache;
 exports.collectSqlAllowListEntries = collectSqlAllowListEntries;
+exports.colorSql = colorSql;
 exports.compileSqlAllowList = compileSqlAllowList;
 exports.convertForRequestBody = convertForRequestBody;
 exports.convertHexIfBinary = convertHexIfBinary;
@@ -3798,7 +4195,11 @@ exports.distSphere = distSphere;
 exports.error = error;
 exports.extractSqlEntries = extractSqlEntries;
 exports.fieldEq = fieldEq;
-exports.getEnvVar = getEnvVar;
+exports.getEnv = getEnv;
+exports.getEnvBool = getEnvBool;
+exports.getEnvDebug = getEnvDebug;
+exports.getEnvLogLevel = getEnvLogLevel;
+exports.getLogContext = getLogContext;
 exports.getPrimaryKeyTypes = getPrimaryKeyTypes;
 exports.group = group;
 exports.info = info;
@@ -3808,23 +4209,29 @@ exports.isNode = isNode;
 exports.isTest = isTest;
 exports.isVerbose = isVerbose;
 exports.loadSqlAllowList = loadSqlAllowList;
+exports.logSql = logSql;
+exports.logWithLevel = logWithLevel;
 exports.normalizeSingularRequest = normalizeSingularRequest;
 exports.normalizeSql = normalizeSql;
 exports.notifyToast = notifyToast;
 exports.onError = onError;
 exports.onSuccess = onSuccess;
+exports.parseLogLevel = parseLogLevel;
 exports.removeInvalidKeys = removeInvalidKeys;
 exports.removePrefixIfExists = removePrefixIfExists;
 exports.resolveDerivedTable = resolveDerivedTable;
+exports.resolveLogLevel = resolveLogLevel;
 exports.restOrm = restOrm;
 exports.restRequest = restRequest;
 exports.setCache = setCache;
 exports.setToastHandler = setToastHandler;
+exports.shouldLog = shouldLog;
 exports.sortAndSerializeQueryObject = sortAndSerializeQueryObject;
 exports.stContains = stContains;
 exports.timeout = timeout;
 exports.toastOptions = toastOptions;
 exports.toastOptionsDevs = toastOptionsDevs;
 exports.userCustomClearCache = userCustomClearCache;
+exports.versionColor = versionToRgb;
 exports.warn = warn;
 //# sourceMappingURL=index.cjs.js.map