@carbonorm/carbonnode 2.0.34 → 3.0.0

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 import axios from 'axios';
 import Qs from 'qs';
-import { __assign, __spreadArray, __awaiter, __generator } from 'tslib';
+import { __awaiter, __generator, __assign, __spreadArray } from 'tslib';
 import { toast } from 'react-toastify';
 
 var C6Constants = {
@@ -232,6 +232,366 @@ var axiosInstance = (axios.create({
     */
 }));
 
+// import { validatePayloadAgainstSchema } from './validator'; // C6 schema validator
+var CarbonSqlExecutor = /** @class */ (function () {
+    function CarbonSqlExecutor(pool, C6) {
+        this.pool = pool;
+        this.C6 = C6;
+    }
+    CarbonSqlExecutor.prototype.withConnection = function (cb) {
+        return __awaiter(this, void 0, void 0, function () {
+            var conn;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.pool.getConnection()];
+                    case 1:
+                        conn = _a.sent();
+                        _a.label = 2;
+                    case 2:
+                        _a.trys.push([2, , 4, 5]);
+                        return [4 /*yield*/, cb(conn)];
+                    case 3: return [2 /*return*/, _a.sent()];
+                    case 4:
+                        conn.release();
+                        return [7 /*endfinally*/];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    CarbonSqlExecutor.prototype.handle = function (req, res, next) {
+        return __awaiter(this, void 0, void 0, function () {
+            var method, table, primary, payload, result, _a, err_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 11, , 12]);
+                        method = req.method.toUpperCase();
+                        table = req.params.table;
+                        primary = req.params.primary;
+                        payload = method === 'GET' ? req.query : req.body;
+                        if (!(table in this.C6.TABLES)) {
+                            res.status(400).json({ error: "Invalid table: ".concat(table) });
+                            return [2 /*return*/];
+                        }
+                        result = void 0;
+                        _a = method;
+                        switch (_a) {
+                            case 'GET': return [3 /*break*/, 1];
+                            case 'OPTIONS': return [3 /*break*/, 1];
+                            case 'POST': return [3 /*break*/, 3];
+                            case 'PUT': return [3 /*break*/, 5];
+                            case 'DELETE': return [3 /*break*/, 7];
+                        }
+                        return [3 /*break*/, 9];
+                    case 1: return [4 /*yield*/, this.select(table, primary, payload)];
+                    case 2:
+                        result = _b.sent();
+                        return [3 /*break*/, 10];
+                    case 3: return [4 /*yield*/, this.insert(table, payload)];
+                    case 4:
+                        result = _b.sent();
+                        return [3 /*break*/, 10];
+                    case 5: return [4 /*yield*/, this.update(table, primary, payload)];
+                    case 6:
+                        result = _b.sent();
+                        return [3 /*break*/, 10];
+                    case 7: return [4 /*yield*/, this.delete(table, primary, payload)];
+                    case 8:
+                        result = _b.sent();
+                        return [3 /*break*/, 10];
+                    case 9: throw new Error("Unsupported method: ".concat(method));
+                    case 10:
+                        res.status(200).json({ success: true, result: result });
+                        return [3 /*break*/, 12];
+                    case 11:
+                        err_1 = _b.sent();
+                        next(err_1);
+                        return [3 /*break*/, 12];
+                    case 12: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    CarbonSqlExecutor.prototype.buildBooleanJoinedConditions = function (set, andMode) {
+        if (andMode === void 0) { andMode = true; }
+        var booleanOperator = andMode ? 'AND' : 'OR';
+        var sql = '';
+        var OPERATORS = ['=', '!=', '<', '<=', '>', '>=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'IS', 'IS NOT'];
+        var isAggregateArray = function (value) { return Array.isArray(value) && typeof value[0] === 'string' && OPERATORS.includes(value[0]); };
+        var isNumericKeyed = function (obj) { return Array.isArray(obj) && Object.keys(obj).every(function (k) { return /^\d+$/.test(k); }); };
+        // todo - we should be doing something with value no????
+        var addCondition = function (column, op, _value) {
+            var paramName = column.replace(/\W+/g, '_');
+            return "(".concat(column, " ").concat(op, " :").concat(paramName, ")");
+        };
+        if (isNumericKeyed(set)) {
+            switch (set.length) {
+                case 2:
+                    sql += addCondition(set[0], '=', set[1]);
+                    break;
+                case 3:
+                    if (!OPERATORS.includes(set[1])) {
+                        throw new Error("Invalid operator: ".concat(set[1]));
+                    }
+                    sql += addCondition(set[0], set[1], set[2]);
+                    break;
+                default:
+                    throw new Error("Invalid array condition: ".concat(JSON.stringify(set)));
+            }
+        }
+        else {
+            var parts = [];
+            for (var _i = 0, _a = Object.entries(set); _i < _a.length; _i++) {
+                var _b = _a[_i], key = _b[0], value = _b[1];
+                if (/^\d+$/.test(key)) {
+                    parts.push(this.buildBooleanJoinedConditions(value, !andMode));
+                    continue;
+                }
+                if (!Array.isArray(value) || isAggregateArray(value)) {
+                    parts.push(addCondition(key, '='));
+                    continue;
+                }
+                if (value.length === 2 && OPERATORS.includes(value[0])) {
+                    parts.push(addCondition(key, value[0], value[1]));
+                }
+                else if (value.length === 1 && isAggregateArray(value[0])) {
+                    parts.push(addCondition(key, '=', value[0]));
+                }
+                else {
+                    throw new Error("Invalid condition for ".concat(key, ": ").concat(JSON.stringify(value)));
+                }
+            }
+            sql = parts.join(" ".concat(booleanOperator, " "));
+        }
+        return "(".concat(sql, ")");
+    };
+    CarbonSqlExecutor.prototype.buildAggregateField = function (field) {
+        if (typeof field === 'string')
+            return field;
+        if (!Array.isArray(field))
+            throw new Error('Invalid SELECT entry: must be string or array');
+        var agg = field[0], args = field.slice(1);
+        switch (agg) {
+            case 'COUNT':
+                return "COUNT(".concat(args[0] || '*', ")");
+            case 'SUM':
+            case 'AVG':
+            case 'MIN':
+            case 'MAX':
+                return "".concat(agg, "(").concat(args[0], ")").concat(args[1] ? " AS ".concat(args[1]) : '');
+            case 'DISTINCT':
+                return "DISTINCT(".concat(args[0], ")").concat(args[1] ? " AS ".concat(args[1]) : '');
+            case 'GROUP_CONCAT': {
+                var col = args[0], alias = args[1], sortCol = args[2], sortType = args[3];
+                var order = sortCol ? " ORDER BY ".concat(sortCol, " ").concat(sortType || 'ASC') : '';
+                return "GROUP_CONCAT(DISTINCT ".concat(col).concat(order, " SEPARATOR ',')").concat(alias ? " AS ".concat(alias) : '');
+            }
+            case 'AS': {
+                var col = args[0], alias = args[1];
+                return "".concat(col, " AS ").concat(alias);
+            }
+            case 'CONVERT_TZ': {
+                var ts = args[0], fromTz = args[1], toTz = args[2];
+                return "CONVERT_TZ(".concat(ts, ", ").concat(fromTz, ", ").concat(toTz, ")");
+            }
+            case 'NOW':
+                return 'NOW()';
+            default:
+                throw new Error("Unsupported aggregate: ".concat(agg));
+        }
+    };
+    CarbonSqlExecutor.prototype.buildSelectQuery = function (table, primary, args, isSubSelect) {
+        var _this = this;
+        var _a, _b, _c, _d;
+        if (isSubSelect === void 0) { isSubSelect = false; }
+        var selectList = (_a = args === null || args === void 0 ? void 0 : args[this.C6.SELECT]) !== null && _a !== void 0 ? _a : ['*'];
+        var selectFields = Array.isArray(selectList)
+            ? selectList.map(function (f) { return _this.buildAggregateField(f); }).join(', ')
+            : '*';
+        var sql = "SELECT ".concat(selectFields, " FROM `").concat(table, "`");
+        if (args === null || args === void 0 ? void 0 : args[this.C6.JOIN]) {
+            var joins = args[this.C6.JOIN];
+            for (var joinType in joins) {
+                var joinKeyword = joinType.replace('_', ' ').toUpperCase();
+                for (var joinTable in joins[joinType]) {
+                    var onClause = this.buildBooleanJoinedConditions(joins[joinType][joinTable]);
+                    sql += " ".concat(joinKeyword, " JOIN `").concat(joinTable, "` ON ").concat(onClause);
+                }
+            }
+        }
+        if (args === null || args === void 0 ? void 0 : args[this.C6.WHERE]) {
+            sql += " WHERE ".concat(this.buildBooleanJoinedConditions(args[this.C6.WHERE]));
+        }
+        if (args === null || args === void 0 ? void 0 : args[this.C6.GROUP_BY]) {
+            var groupByFields = Array.isArray(args[this.C6.GROUP_BY]) ? args[this.C6.GROUP_BY].join(', ') : args[this.C6.GROUP_BY];
+            sql += " GROUP BY ".concat(groupByFields);
+        }
+        if (args === null || args === void 0 ? void 0 : args[this.C6.HAVING]) {
+            sql += " HAVING ".concat(this.buildBooleanJoinedConditions(args[this.C6.HAVING]));
+        }
+        if (args === null || args === void 0 ? void 0 : args[this.C6.PAGINATION]) {
+            var p = args[this.C6.PAGINATION];
+            var limitClause = '';
+            if (p[this.C6.ORDER]) {
+                var orderArray = Object.entries(p[this.C6.ORDER]).map(function (_a) {
+                    var col = _a[0], dir = _a[1];
+                    if (!['ASC', 'DESC'].includes(String(dir).toUpperCase())) {
+                        throw new Error("Invalid order direction: ".concat(dir));
+                    }
+                    return "".concat(col, " ").concat(String(dir).toUpperCase());
+                });
+                sql += " ORDER BY ".concat(orderArray.join(', '));
+            }
+            else if (primary) {
+                sql += " ORDER BY ".concat(primary, " DESC");
+            }
+            else {
+                // todo this is wrong
+                var primaryKey = (_c = (_b = this.C6.TABLES['users'].PRIMARY_SHORT) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : 'user_id';
+                sql += " ORDER BY ".concat(primaryKey, " DESC");
+            }
+            if (p[this.C6.LIMIT] != null) {
+                var limit = parseInt(p[this.C6.LIMIT], 10);
+                if (isNaN(limit) || limit < 0) {
+                    throw new Error("Invalid LIMIT: ".concat(p[this.C6.LIMIT]));
+                }
+                var page = parseInt((_d = p[this.C6.PAGE]) !== null && _d !== void 0 ? _d : 1, 10);
+                if (isNaN(page) || page < 1) {
+                    throw new Error("PAGE must be >= 1 (got ".concat(p[this.C6.PAGE], ")"));
+                }
+                var offset = (page - 1) * limit;
+                limitClause += " LIMIT ".concat(offset, ", ").concat(limit);
+            }
+            sql += limitClause;
+        }
+        else if (!isSubSelect && primary) {
+            sql += " ORDER BY ".concat(primary, " ASC LIMIT 1");
+        }
+        else if (!isSubSelect && !primary) {
+            sql += " ORDER BY id ASC LIMIT 100"; // fallback default limit
+        }
+        return sql;
+    };
+    CarbonSqlExecutor.prototype.select = function (table, primary, args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var sql;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        sql = this.buildSelectQuery(table, primary, args);
+                        return [4 /*yield*/, this.withConnection(function (conn) { return __awaiter(_this, void 0, void 0, function () {
+                                var rows;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0:
+                                            console.log(sql);
+                                            return [4 /*yield*/, conn.query(sql)];
+                                        case 1:
+                                            rows = (_a.sent())[0];
+                                            return [2 /*return*/, rows];
+                                    }
+                                });
+                            }); })];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    CarbonSqlExecutor.prototype.insert = function (table, data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var keys, values, placeholders, sql;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        keys = Object.keys(data);
+                        values = keys.map(function (k) { return data[k]; });
+                        placeholders = keys.map(function () { return '?'; }).join(', ');
+                        sql = "INSERT INTO `".concat(table, "` (").concat(keys.join(', '), ") VALUES (").concat(placeholders, ")");
+                        return [4 /*yield*/, this.withConnection(function (conn) { return __awaiter(_this, void 0, void 0, function () {
+                                var result;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, conn.execute(sql, values)];
+                                        case 1:
+                                            result = (_a.sent())[0];
+                                            return [2 /*return*/, result];
+                                    }
+                                });
+                            }); })];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    CarbonSqlExecutor.prototype.update = function (table, primary, data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var keys, values, updates, sql;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!primary) {
+                            throw new Error('Primary key is required for update');
+                        }
+                        keys = Object.keys(data);
+                        values = keys.map(function (k) { return data[k]; });
+                        updates = keys.map(function (k) { return "`".concat(k, "` = ?"); }).join(', ');
+                        sql = "UPDATE `".concat(table, "` SET ").concat(updates, " WHERE `").concat(primary, "` = ?");
+                        values.push(data[primary]);
+                        return [4 /*yield*/, this.withConnection(function (conn) { return __awaiter(_this, void 0, void 0, function () {
+                                var result;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, conn.execute(sql, values)];
+                                        case 1:
+                                            result = (_a.sent())[0];
+                                            return [2 /*return*/, result];
+                                    }
+                                });
+                            }); })];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    CarbonSqlExecutor.prototype.delete = function (table, primary, args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var sql;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!primary || !(args === null || args === void 0 ? void 0 : args[primary])) {
+                            throw new Error('Primary key and value required for delete');
+                        }
+                        sql = "DELETE FROM `".concat(table, "` WHERE `").concat(primary, "` = ?");
+                        return [4 /*yield*/, this.withConnection(function (conn) { return __awaiter(_this, void 0, void 0, function () {
+                                var result;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, conn.execute(sql, [args[primary]])];
+                                        case 1:
+                                            result = (_a.sent())[0];
+                                            return [2 /*return*/, result];
+                                    }
+                                });
+                            }); })];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    return CarbonSqlExecutor;
+}());
+
+var carbonSqlExecutor = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CarbonSqlExecutor: CarbonSqlExecutor
+});
+
 function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler) {
     if (regexErrorHandler === void 0) { regexErrorHandler = alert; }
     var payload = {};
@@ -303,6 +663,9 @@ function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler)
     }, {});
 }
 
+var _a;
+var isNode = 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
@@ -473,7 +836,8 @@ function extendedTypeHints() {
     return function (argv) { return restRequest(argv); };
 }
 function restRequest(_a) {
-    var C6 = _a.C6, _b = _a.axios, axios = _b === void 0 ? axiosInstance : _b, _c = _a.restURL, restURL = _c === void 0 ? '/rest/' : _c, _d = _a.withCredentials, withCredentials = _d === void 0 ? true : _d, tableName = _a.tableName, _e = _a.requestMethod, requestMethod = _e === void 0 ? GET : _e, _f = _a.queryCallback, queryCallback = _f === void 0 ? {} : _f, responseCallback = _a.responseCallback, _g = _a.skipPrimaryCheck, skipPrimaryCheck = _g === void 0 ? false : _g, _h = _a.clearCache, clearCache = _h === void 0 ? undefined : _h;
+    var _this = this;
+    var C6 = _a.C6, _b = _a.axios, axios = _b === void 0 ? axiosInstance : _b, _c = _a.restURL, restURL = _c === void 0 ? '/rest/' : _c, mysqlPool = _a.mysqlPool, _d = _a.withCredentials, withCredentials = _d === void 0 ? true : _d, tableName = _a.tableName, _e = _a.requestMethod, requestMethod = _e === void 0 ? GET : _e, _f = _a.queryCallback, queryCallback = _f === void 0 ? {} : _f, responseCallback = _a.responseCallback, _g = _a.skipPrimaryCheck, skipPrimaryCheck = _g === void 0 ? false : _g, _h = _a.clearCache, clearCache = _h === void 0 ? undefined : _h;
     var fullTableList = Array.isArray(tableName) ? tableName : [tableName];
     var operatingTableFullName = fullTableList[0];
     var operatingTable = removePrefixIfExists(operatingTableFullName, C6.PREFIX);
@@ -490,483 +854,544 @@ function restRequest(_a) {
     if (null !== clearCache || undefined !== clearCache) {
         userCustomClearCache[tables + requestMethod] = clearCache;
     }
-    return function (request) {
-        if (request === void 0) { request = {}; }
-        console.groupCollapsed('%c API: (' + requestMethod + ') Request for (' + operatingTable + ')', 'color: #0c0');
-        console.log('request', request);
-        console.groupEnd();
-        // an undefined query would indicate queryCallback returned undefined,
-        // thus the request shouldn't fire as is in custom cache
-        var query;
-        if ('function' === typeof queryCallback) {
-            query = queryCallback(request); // obj or obj[]
-        }
-        else {
-            query = queryCallback;
-        }
-        if (undefined === query || null === query) {
-            if (request.debug && isDevelopment) {
-                toast.warning("DEV: queryCallback returned undefined, signaling in Custom Cache. (returning null)", toastOptionsDevs);
-            }
-            console.groupCollapsed('%c API: (' + requestMethod + ') Request Query for (' + operatingTable + ') undefined, returning null (will not fire ajax)!', 'color: #c00');
-            console.log('%c Returning (undefined|null) for a query would indicate a custom cache hit (outside API.tsx), thus the request should not fire.', 'color: #c00');
-            console.trace();
-            console.groupEnd();
-            return null;
-        }
-        if (C6.GET === requestMethod) {
-            if (undefined === query[C6.PAGINATION]) {
-                query[C6.PAGINATION] = {};
-            }
-            query[C6.PAGINATION][C6.PAGE] = query[C6.PAGINATION][C6.PAGE] || 1;
-            query[C6.PAGINATION][C6.LIMIT] = query[C6.PAGINATION][C6.LIMIT] || 100;
+    return function () {
+        var args_1 = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args_1[_i] = arguments[_i];
         }
-        // this could return itself with a new page number, or undefined if the end is reached
-        function apiRequest() {
-            var _this = this;
-            var _a, _b, _c, _d, _e, _f, _g;
-            (_a = request.cacheResults) !== null && _a !== void 0 ? _a : (request.cacheResults = C6.GET === requestMethod);
-            if (C6.GET === requestMethod
-                && undefined !== ((_b = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _b === void 0 ? void 0 : _b[C6.PAGE])
-                && 1 !== query[C6.PAGINATION][C6.PAGE]) {
-                console.groupCollapsed('Request on table (' + tableName + ') is firing for page (' + query[C6.PAGINATION][C6.PAGE] + '), please wait!');
-                console.log('Request Data (note you may see the success and/or error prompt):', request);
-                console.trace();
-                console.groupEnd();
-            }
-            // The problem with creating cache keys with a stringified object is the order of keys matters and it's possible for the same query to be stringified differently.
-            // Here we ensure the key order will be identical between two of the same requests. https://stackoverflow.com/questions/5467129/sort-javascript-object-by-key
-            // literally impossible for query to be undefined or null here but the editor is too busy licking windows to understand that
-            var querySerialized = sortAndSerializeQueryObject(tables, query !== null && query !== void 0 ? query : {});
-            var cacheResult = apiRequestCache.find(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
-            var cachingConfirmed = false;
-            // determine if we need to paginate.
-            if (requestMethod === C6.GET) {
-                if (undefined === (query === null || query === void 0 ? void 0 : query[C6.PAGINATION])) {
-                    if (undefined === query || null === query) {
-                        query = {};
-                    }
-                    query[C6.PAGINATION] = {};
-                }
-                query[C6.PAGINATION][C6.PAGE] = query[C6.PAGINATION][C6.PAGE] || 1;
-                query[C6.PAGINATION][C6.LIMIT] = query[C6.PAGINATION][C6.LIMIT] || 100;
-                // this will evaluate true most the time
-                if (true === request.cacheResults) {
-                    // just find the next, non-fetched, page and return a function to request it
-                    if (undefined !== cacheResult) {
-                        do {
-                            var cacheCheck = checkCache(cacheResult, requestMethod, tableName, request);
-                            if (false !== cacheCheck) {
-                                return cacheCheck;
-                            }
-                            // this line incrementing page is why we return recursively
-                            ++query[C6.PAGINATION][C6.PAGE];
-                            // this json stringify is to capture the new page number
-                            querySerialized = sortAndSerializeQueryObject(tables, query !== null && query !== void 0 ? query : {});
-                            cacheResult = apiRequestCache.find(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
-                        } while (undefined !== cacheResult);
-                        if (request.debug && isDevelopment) {
-                            toast.warning("DEVS: Request in cache. (" + apiRequestCache.findIndex(function (cache) { return cache.requestArgumentsSerialized === querySerialized; }) + "). Returning function to request page (" + query[C6.PAGINATION][C6.PAGE] + ")", toastOptionsDevs);
-                        }
-                        // @ts-ignore - this is an incorrect warning on TS, it's well typed
-                        return apiRequest;
-                    }
-                    cachingConfirmed = true;
-                }
-                else {
-                    if (request.debug && isDevelopment) {
-                        toast.info("DEVS: Ignore cache was set to true.", toastOptionsDevs);
-                    }
-                }
-                if (request.debug && isDevelopment) {
-                    toast.success("DEVS: Request not in cache." + (requestMethod === C6.GET ? "Page (" + query[C6.PAGINATION][C6.PAGE] + ")." : '') + " Logging cache 2 console.", toastOptionsDevs);
-                }
-            }
-            else if (request.cacheResults) { // if we are not getting, we are updating, deleting, or inserting
-                if (cacheResult) {
-                    var cacheCheck = checkCache(cacheResult, requestMethod, tableName, request);
-                    if (false !== cacheCheck) {
-                        return cacheCheck;
-                    }
-                }
-                cachingConfirmed = true;
-                // push to cache so we do not repeat the request
-            }
-            var addBackPK;
-            var apiResponse;
-            var returnGetNextPageFunction = false;
-            var restRequestUri = restURL + operatingTable + '/';
-            var needsConditionOrPrimaryCheck = (PUT === requestMethod || DELETE === requestMethod)
-                && false === skipPrimaryCheck;
-            var TABLES = C6.TABLES;
-            // todo - aggregate primary key check with condition check
-            // check if PK exists in query, clone so pop does not affect the real data
-            var primaryKey = (_f = (_e = (_d = structuredClone((_c = TABLES[operatingTable]) === null || _c === void 0 ? void 0 : _c.PRIMARY)) === null || _d === void 0 ? void 0 : _d.pop()) === null || _e === void 0 ? void 0 : _e.split('.')) === null || _f === void 0 ? void 0 : _f.pop();
-            if (needsConditionOrPrimaryCheck) {
-                if (undefined === primaryKey) {
-                    if (null === query
-                        || undefined === query
-                        || undefined === (query === null || query === void 0 ? void 0 : query[C6.WHERE])
-                        || (true === Array.isArray(query[C6.WHERE])
-                            || query[C6.WHERE].length === 0)
-                        || (Object.keys(query === null || query === void 0 ? void 0 : query[C6.WHERE]).length === 0)) {
-                        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((_g = TABLES[operatingTable]) === null || _g === void 0 ? void 0 : _g.PRIMARY) + ') for operatingTable (' + operatingTable + ').');
-                    }
-                }
-                else {
-                    if (undefined === query
-                        || null === query
-                        || false === primaryKey in query) {
-                        if (true === request.debug && isDevelopment) {
-                            toast.error('DEVS: The primary key (' + primaryKey + ') was not provided!!');
-                        }
-                        throw Error('You must provide the primary key (' + primaryKey + ') for table (' + operatingTable + '). Request (' + JSON.stringify(request, undefined, 4) + ') Query (' + JSON.stringify(query) + ')');
-                    }
-                    if (undefined === (query === null || query === void 0 ? void 0 : query[primaryKey])
-                        || null === (query === null || query === void 0 ? void 0 : query[primaryKey])) {
-                        toast.error('The primary key (' + primaryKey + ') provided is undefined or null explicitly!!');
-                        throw Error('The primary key (' + primaryKey + ') provided in the request was exactly equal to undefined.');
-                    }
-                }
-            }
-            // A part of me exists that wants to remove this, but it's a good feature
-            // this allows developers the ability to cache requests based on primary key
-            // for tables like `photos` this can be a huge performance boost
-            if (undefined !== query
-                && null !== query
-                && undefined !== primaryKey
-                && primaryKey in query) {
-                restRequestUri += query[primaryKey] + '/';
-                var removedPkValue_1 = query[primaryKey];
-                addBackPK = function () {
-                    query !== null && query !== void 0 ? query : (query = {});
-                    query[primaryKey] = removedPkValue_1;
-                };
-                delete query[primaryKey];
-                console.log('query', query, 'primaryKey', primaryKey, 'removedPkValue', removedPkValue_1);
-            }
-            else {
-                console.log('query', query);
-            }
-            try {
-                console.groupCollapsed('%c API: (' + requestMethod + ') Request Query for (' + operatingTable + ') is about to fire, will return with promise!', 'color: #A020F0');
-                console.log(request);
-                console.log('%c If this is the first request for this datatype; thus the value being set is currently undefined, please remember to update the state to null.', 'color: #A020F0');
-                console.log('%c Remember undefined indicated the request has not fired, null indicates the request is firing, an empty array would signal no data was returned for the sql stmt.', 'color: #A020F0');
-                console.trace();
-                console.groupEnd();
-                var axiosActiveRequest = axios[requestMethod.toLowerCase()].apply(axios, __spreadArray([restRequestUri], ((function () {
-                    // @link - https://axios-http.com/docs/instance
-                    // How configuration vs data is passed is variable, use documentation above for reference
-                    if (requestMethod === GET) {
-                        return [{
-                                withCredentials: withCredentials,
-                                params: query
-                            }];
-                    }
-                    else if (requestMethod === POST) {
-                        if (undefined !== (request === null || request === void 0 ? void 0 : request.dataInsertMultipleRows)) {
-                            return [
-                                request.dataInsertMultipleRows.map(function (data) {
-                                    return convertForRequestBody(data, fullTableList, C6, function (message) { return toast.error(message, toastOptions); });
-                                }),
-                                {
-                                    withCredentials: withCredentials,
-                                }
-                            ];
-                        }
-                        return [
-                            convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); }),
-                            {
-                                withCredentials: withCredentials,
-                            }
-                        ];
-                    }
-                    else if (requestMethod === PUT) {
-                        return [
-                            convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); }),
-                            {
-                                withCredentials: withCredentials,
-                            }
-                        ];
-                    }
-                    else if (requestMethod === DELETE) {
-                        return [{
-                                withCredentials: withCredentials,
-                                data: convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); })
-                            }];
-                    }
-                    else {
-                        throw new Error('The request method (' + requestMethod + ') was not recognized.');
-                    }
-                })()), false));
-                if (cachingConfirmed) {
-                    // push to cache so we do not repeat the request
-                    apiRequestCache.push({
-                        requestArgumentsSerialized: querySerialized,
-                        request: axiosActiveRequest
-                    });
-                }
-                // todo - wip verify this works
-                // we had removed the value from the request to add to the URI.
-                addBackPK === null || addBackPK === void 0 ? void 0 : addBackPK(); // adding back so post-processing methods work
-                // returning the promise with this then is important for tests. todo - we could make that optional.
-                // https://rapidapi.com/guides/axios-async-await
-                return axiosActiveRequest.then(function (response) { return __awaiter(_this, void 0, void 0, function () {
-                    var cacheIndex, responseData_1, fetchDependencies, dependencies_1, fetchReferences_1, apiRequestPromises, _loop_1, _a, _b, _c, _i, tableToFetch;
+        return __awaiter(_this, __spreadArray([], args_1, true), void 0, function (request) {
+            // this could return itself with a new page number, or undefined if the end is reached
+            function apiRequest() {
+                return __awaiter(this, void 0, void 0, function () {
+                    var querySerialized, cacheResult, cachingConfirmed, cacheCheck, cacheCheck, addBackPK, apiResponse, returnGetNextPageFunction, restRequestUri, needsConditionOrPrimaryCheck, TABLES, primaryKey, CarbonSqlExecutor, engine, removedPkValue_1, axiosActiveRequest;
                     var _this = this;
-                    var _d, _e, _f, _g, _h, _j, _k, _l, _m;
-                    return __generator(this, function (_o) {
-                        switch (_o.label) {
+                    var _a, _b, _c, _d, _e, _f, _g;
+                    return __generator(this, function (_h) {
+                        switch (_h.label) {
                             case 0:
-                                if (typeof response.data === 'string') {
-                                    if (isTest) {
-                                        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)];
-                                }
-                                if (cachingConfirmed) {
-                                    cacheIndex = apiRequestCache.findIndex(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
-                                    apiRequestCache[cacheIndex].final = false === returnGetNextPageFunction;
-                                    // only cache get method requests
-                                    apiRequestCache[cacheIndex].response = response;
+                                (_a = request.cacheResults) !== null && _a !== void 0 ? _a : (request.cacheResults = C6.GET === requestMethod);
+                                if (C6.GET === requestMethod
+                                    && undefined !== ((_b = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _b === void 0 ? void 0 : _b[C6.PAGE])
+                                    && 1 !== query[C6.PAGINATION][C6.PAGE]) {
+                                    console.groupCollapsed('Request on table (' + tableName + ') is firing for page (' + query[C6.PAGINATION][C6.PAGE] + '), please wait!');
+                                    console.log('Request Data (note you may see the success and/or error prompt):', request);
+                                    console.trace();
+                                    console.groupEnd();
                                 }
-                                apiResponse = TestRestfulResponse(response, request === null || request === void 0 ? void 0 : request.success, (_d = request === null || request === void 0 ? void 0 : request.error) !== null && _d !== void 0 ? _d : "An unexpected API error occurred!");
-                                if (false === apiResponse) {
+                                querySerialized = sortAndSerializeQueryObject(tables, query !== null && query !== void 0 ? query : {});
+                                cacheResult = apiRequestCache.find(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
+                                cachingConfirmed = false;
+                                // determine if we need to paginate.
+                                if (requestMethod === C6.GET) {
+                                    if (undefined === (query === null || query === void 0 ? void 0 : query[C6.PAGINATION])) {
+                                        if (undefined === query || null === query) {
+                                            query = {};
+                                        }
+                                        query[C6.PAGINATION] = {};
+                                    }
+                                    query[C6.PAGINATION][C6.PAGE] = query[C6.PAGINATION][C6.PAGE] || 1;
+                                    query[C6.PAGINATION][C6.LIMIT] = query[C6.PAGINATION][C6.LIMIT] || 100;
+                                    // this will evaluate true most the time
+                                    if (true === request.cacheResults) {
+                                        // just find the next, non-fetched, page and return a function to request it
+                                        if (undefined !== cacheResult) {
+                                            do {
+                                                cacheCheck = checkCache(cacheResult, requestMethod, tableName, request);
+                                                if (false !== cacheCheck) {
+                                                    return [2 /*return*/, cacheCheck];
+                                                }
+                                                // this line incrementing page is why we return recursively
+                                                ++query[C6.PAGINATION][C6.PAGE];
+                                                // this json stringify is to capture the new page number
+                                                querySerialized = sortAndSerializeQueryObject(tables, query !== null && query !== void 0 ? query : {});
+                                                cacheResult = apiRequestCache.find(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
+                                            } while (undefined !== cacheResult);
+                                            if (request.debug && isDevelopment) {
+                                                toast.warning("DEVS: Request in cache. (" + apiRequestCache.findIndex(function (cache) { return cache.requestArgumentsSerialized === querySerialized; }) + "). Returning function to request page (" + query[C6.PAGINATION][C6.PAGE] + ")", toastOptionsDevs);
+                                            }
+                                            // @ts-ignore - this is an incorrect warning on TS, it's well typed
+                                            return [2 /*return*/, apiRequest];
+                                        }
+                                        cachingConfirmed = true;
+                                    }
+                                    else {
+                                        if (request.debug && isDevelopment) {
+                                            toast.info("DEVS: Ignore cache was set to true.", toastOptionsDevs);
+                                        }
+                                    }
                                     if (request.debug && isDevelopment) {
-                                        toast.warning("DEVS: TestRestfulResponse returned false for (" + operatingTable + ").", toastOptionsDevs);
+                                        toast.success("DEVS: Request not in cache." + (requestMethod === C6.GET ? "Page (" + query[C6.PAGINATION][C6.PAGE] + ")." : '') + " Logging cache 2 console.", toastOptionsDevs);
                                     }
-                                    return [2 /*return*/, response];
                                 }
-                                // stateful operations are done in the response callback - its leverages rest generated functions
-                                if (responseCallback) {
-                                    responseCallback(response, request, apiResponse);
+                                else if (request.cacheResults) { // if we are not getting, we are updating, deleting, or inserting
+                                    if (cacheResult) {
+                                        cacheCheck = checkCache(cacheResult, requestMethod, tableName, request);
+                                        if (false !== cacheCheck) {
+                                            return [2 /*return*/, cacheCheck];
+                                        }
+                                    }
+                                    cachingConfirmed = true;
+                                    // push to cache so we do not repeat the request
                                 }
-                                if (!(C6.GET === requestMethod)) return [3 /*break*/, 6];
-                                responseData_1 = response.data;
-                                returnGetNextPageFunction = 1 !== ((_e = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _e === void 0 ? void 0 : _e[C6.LIMIT]) &&
-                                    ((_f = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _f === void 0 ? void 0 : _f[C6.LIMIT]) === responseData_1.rest.length;
-                                if (false === isTest || true === isVerbose) {
-                                    console.groupCollapsed('%c API: Response (' + requestMethod + ' ' + tableName + ') returned length (' + ((_g = responseData_1.rest) === null || _g === void 0 ? void 0 : _g.length) + ') of possible (' + ((_h = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _h === void 0 ? void 0 : _h[C6.LIMIT]) + ') limit!', 'color: #0c0');
-                                    console.log('%c ' + requestMethod + ' ' + tableName, 'color: #0c0');
-                                    console.log('%c Request Data (note you may see the success and/or error prompt):', 'color: #0c0', request);
-                                    console.log('%c Response Data:', 'color: #0c0', responseData_1.rest);
-                                    console.log('%c Will return get next page function:' + (1 !== ((_j = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _j === void 0 ? void 0 : _j[C6.LIMIT]) ? '' : ' (Will not return with explicit limit 1 set)'), 'color: #0c0', true === returnGetNextPageFunction);
-                                    console.trace();
-                                    console.groupEnd();
+                                returnGetNextPageFunction = false;
+                                restRequestUri = restURL + operatingTable + '/';
+                                needsConditionOrPrimaryCheck = (PUT === requestMethod || DELETE === requestMethod)
+                                    && false === skipPrimaryCheck;
+                                TABLES = C6.TABLES;
+                                primaryKey = (_f = (_e = (_d = structuredClone((_c = TABLES[operatingTable]) === null || _c === void 0 ? void 0 : _c.PRIMARY)) === null || _d === void 0 ? void 0 : _d.pop()) === null || _e === void 0 ? void 0 : _e.split('.')) === null || _f === void 0 ? void 0 : _f.pop();
+                                if (needsConditionOrPrimaryCheck) {
+                                    if (undefined === primaryKey) {
+                                        if (null === query
+                                            || undefined === query
+                                            || undefined === (query === null || query === void 0 ? void 0 : query[C6.WHERE])
+                                            || (true === Array.isArray(query[C6.WHERE])
+                                                || query[C6.WHERE].length === 0)
+                                            || (Object.keys(query === null || query === void 0 ? void 0 : query[C6.WHERE]).length === 0)) {
+                                            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((_g = TABLES[operatingTable]) === null || _g === void 0 ? void 0 : _g.PRIMARY) + ') for operatingTable (' + operatingTable + ').');
+                                        }
+                                    }
+                                    else {
+                                        if (undefined === query
+                                            || null === query
+                                            || false === primaryKey in query) {
+                                            if (true === request.debug && isDevelopment) {
+                                                toast.error('DEVS: The primary key (' + primaryKey + ') was not provided!!');
+                                            }
+                                            throw Error('You must provide the primary key (' + primaryKey + ') for table (' + operatingTable + '). Request (' + JSON.stringify(request, undefined, 4) + ') Query (' + JSON.stringify(query) + ')');
+                                        }
+                                        if (undefined === (query === null || query === void 0 ? void 0 : query[primaryKey])
+                                            || null === (query === null || query === void 0 ? void 0 : query[primaryKey])) {
+                                            toast.error('The primary key (' + primaryKey + ') provided is undefined or null explicitly!!');
+                                            throw Error('The primary key (' + primaryKey + ') provided in the request was exactly equal to undefined.');
+                                        }
+                                    }
                                 }
-                                if (false === returnGetNextPageFunction
-                                    && true === request.debug
-                                    && isDevelopment) {
-                                    toast.success("DEVS: Response returned length (" + ((_k = responseData_1.rest) === null || _k === void 0 ? void 0 : _k.length) + ") less than limit (" + ((_l = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _l === void 0 ? void 0 : _l[C6.LIMIT]) + ").", toastOptionsDevs);
+                                if (!(isNode && mysqlPool)) return [3 /*break*/, 2];
+                                return [4 /*yield*/, Promise.resolve().then(function () { return carbonSqlExecutor; })];
+                            case 1:
+                                CarbonSqlExecutor = (_h.sent()).CarbonSqlExecutor;
+                                engine = new CarbonSqlExecutor(mysqlPool, C6);
+                                switch (requestMethod) {
+                                    case GET:
+                                        return [2 /*return*/, engine
+                                                .select(tableName, undefined, request)
+                                                .then(function (rows) {
+                                                // mirror the front‐end shape
+                                                var serverResponse = {
+                                                    rest: rows,
+                                                    session: undefined,
+                                                    sql: true,
+                                                };
+                                                return serverResponse;
+                                            })];
+                                    case POST:
+                                        return [2 /*return*/, engine
+                                                .insert(tableName, request)
+                                                .then(function (created) { return ({
+                                                rest: created,
+                                            }); })];
+                                    case PUT:
+                                        return [2 /*return*/, engine
+                                                .update(tableName, undefined, request)
+                                                .then(function (updatedResult) {
+                                                var _a;
+                                                return ({
+                                                    rest: updatedResult,
+                                                    rowCount: (_a = updatedResult.affectedRows) !== null && _a !== void 0 ? _a : 0,
+                                                });
+                                            })];
+                                    case DELETE:
+                                        return [2 /*return*/, engine
+                                                .delete(tableName, undefined, request)
+                                                .then(function (deletedResult) {
+                                                var _a;
+                                                return ({
+                                                    rest: deletedResult,
+                                                    rowCount: (_a = deletedResult.affectedRows) !== null && _a !== void 0 ? _a : 0,
+                                                    deleted: true,
+                                                });
+                                            })];
+                                    default:
+                                        throw new Error("Unsupported method: ".concat(requestMethod));
                                 }
-                                (_m = request.fetchDependencies) !== null && _m !== void 0 ? _m : (request.fetchDependencies = eFetchDependencies.NONE);
-                                if (!(request.fetchDependencies
-                                    && 'number' === typeof request.fetchDependencies
-                                    && responseData_1.rest.length > 0)) return [3 /*break*/, 6];
-                                fetchDependencies = request.fetchDependencies;
-                                console.groupCollapsed('%c API: Fetch Dependencies segment (' + requestMethod + ' ' + tableName + ')'
-                                    + (fetchDependencies & eFetchDependencies.CHILDREN ? ' | (CHILDREN|REFERENCED) ' : '')
-                                    + (fetchDependencies & eFetchDependencies.PARENTS ? ' | (PARENTS|REFERENCED_BY)' : '')
-                                    + (fetchDependencies & eFetchDependencies.C6ENTITY ? ' | (C6ENTITY)' : '')
-                                    + (fetchDependencies & eFetchDependencies.RECURSIVE ? ' | (RECURSIVE)' : ''), 'color: #33ccff');
-                                console.groupCollapsed('Collapsed JS Trace');
-                                console.trace(); // hidden in collapsed group
-                                console.groupEnd();
-                                dependencies_1 = {};
-                                if (fetchDependencies & eFetchDependencies.C6ENTITY) {
-                                    dependencies_1 = operatingTable.endsWith("carbon_carbons")
-                                        ? __assign(__assign({}, fetchDependencies & eFetchDependencies.CHILDREN // REFERENCED === CHILDREN
-                                            ? C6.TABLES[operatingTable].TABLE_REFERENCED_BY
-                                            : {}), fetchDependencies & eFetchDependencies.PARENTS // REFERENCES === PARENTS
-                                            ? C6.TABLES[operatingTable].TABLE_REFERENCES
-                                            : {}) : __assign(__assign({}, fetchDependencies & eFetchDependencies.CHILDREN // REFERENCED === CHILDREN
-                                        ? __assign(__assign({}, Object.keys(C6.TABLES[operatingTable].TABLE_REFERENCES).reduce(function (accumulator, columnName) {
-                                            if (!C6.TABLES[operatingTable].PRIMARY_SHORT.includes(columnName)) {
-                                                accumulator[columnName] = C6.TABLES[operatingTable].TABLE_REFERENCES[columnName];
-                                            }
-                                            return accumulator;
-                                        }, {})), C6.TABLES[operatingTable].TABLE_REFERENCED_BY // it is unlikely that a C6 table will have any TABLE_REFERENCED_BY
-                                        ) : {}), fetchDependencies & eFetchDependencies.PARENTS // REFERENCES === PARENTS
-                                        ? C6.TABLES[operatingTable].PRIMARY_SHORT.reduce(function (accumulator, primaryKey) {
-                                            if (primaryKey in C6.TABLES[operatingTable].TABLE_REFERENCES) {
-                                                accumulator[primaryKey] = C6.TABLES[operatingTable].TABLE_REFERENCES[primaryKey];
-                                            }
-                                            return accumulator;
-                                        }, {})
-                                        : {});
+                            case 2:
+                                // A part of me exists that wants to remove this, but it's a good feature
+                                // this allows developers the ability to cache requests based on primary key
+                                // for tables like `photos` this can be a huge performance boost
+                                if (undefined !== query
+                                    && null !== query
+                                    && undefined !== primaryKey
+                                    && primaryKey in query) {
+                                    restRequestUri += query[primaryKey] + '/';
+                                    removedPkValue_1 = query[primaryKey];
+                                    addBackPK = function () {
+                                        query !== null && query !== void 0 ? query : (query = {});
+                                        query[primaryKey] = removedPkValue_1;
+                                    };
+                                    delete query[primaryKey];
+                                    console.log('query', query, 'primaryKey', primaryKey, 'removedPkValue', removedPkValue_1);
                                 }
                                 else {
-                                    // this is the natural mysql context
-                                    dependencies_1 = __assign(__assign({}, fetchDependencies & eFetchDependencies.REFERENCED // REFERENCED === CHILDREN
-                                        ? C6.TABLES[operatingTable].TABLE_REFERENCED_BY
-                                        : {}), fetchDependencies & eFetchDependencies.REFERENCES // REFERENCES === PARENTS
-                                        ? C6.TABLES[operatingTable].TABLE_REFERENCES
-                                        : {});
+                                    console.log('query', query);
                                 }
-                                fetchReferences_1 = {};
-                                apiRequestPromises = [];
-                                console.log('%c Dependencies', 'color: #005555', dependencies_1);
-                                Object.keys(dependencies_1)
-                                    .forEach(function (column) { return dependencies_1[column]
-                                    .forEach(function (constraint) {
-                                    var _a, _b, _c, _d;
-                                    var _e, _f, _g;
-                                    var columnValues = (_b = (_a = responseData_1.rest[column]) !== null && _a !== void 0 ? _a : responseData_1.rest.map(function (row) {
-                                        if (operatingTable.endsWith("carbons")
-                                            && 'entity_tag' in row
-                                            && !constraint.TABLE.endsWith(row['entity_tag'].split('\\').pop().toLowerCase())) {
-                                            return false; // map
-                                        }
-                                        if (!(column in row)) {
-                                            return false;
+                                try {
+                                    console.groupCollapsed('%c API: (' + requestMethod + ') Request Query for (' + operatingTable + ') is about to fire, will return with promise!', 'color: #A020F0');
+                                    console.log(request);
+                                    console.log('%c If this is the first request for this datatype; thus the value being set is currently undefined, please remember to update the state to null.', 'color: #A020F0');
+                                    console.log('%c Remember undefined indicated the request has not fired, null indicates the request is firing, an empty array would signal no data was returned for the sql stmt.', 'color: #A020F0');
+                                    console.trace();
+                                    console.groupEnd();
+                                    axiosActiveRequest = axios[requestMethod.toLowerCase()].apply(axios, __spreadArray([restRequestUri], ((function () {
+                                        // @link - https://axios-http.com/docs/instance
+                                        // How configuration vs data is passed is variable, use documentation above for reference
+                                        if (requestMethod === GET) {
+                                            return [{
+                                                    withCredentials: withCredentials,
+                                                    params: query
+                                                }];
                                         }
-                                        // todo - row[column] is a FK value, we should optionally remove values that are already in state
-                                        // this could be any column in the table constraint.TABLE, not just the primary key
-                                        return row[column];
-                                    }).filter(function (n) { return n; })) !== null && _b !== void 0 ? _b : [];
-                                    if (columnValues.length === 0) {
-                                        return; // forEach
-                                    }
-                                    (_c = fetchReferences_1[_e = constraint.TABLE]) !== null && _c !== void 0 ? _c : (fetchReferences_1[_e] = {});
-                                    (_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);
-                                _loop_1 = function (tableToFetch) {
-                                    var referencesTables, shouldContinue, fetchTable, RestApi, nextFetchDependencies;
-                                    var _p;
-                                    return __generator(this, function (_q) {
-                                        switch (_q.label) {
-                                            case 0:
-                                                if (fetchDependencies & eFetchDependencies.C6ENTITY
-                                                    && 'string' === typeof tableName
-                                                    && tableName.endsWith("carbon_carbons")) {
-                                                    referencesTables = responseData_1.rest.reduce(function (accumulator, row) {
-                                                        if ('entity_tag' in row && !accumulator.includes(row['entity_tag'])) {
-                                                            accumulator.push(row['entity_tag']);
-                                                        }
-                                                        return accumulator;
-                                                    }, []).map(function (entityTag) { return entityTag.split('\\').pop().toLowerCase(); });
-                                                    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);
-                                                        return [2 /*return*/, "continue"];
-                                                    }
-                                                    console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') will be fetched.', 'color: #0c0');
-                                                }
-                                                return [4 /*yield*/, C6.IMPORT(tableToFetch)];
-                                            case 1:
-                                                fetchTable = _q.sent();
-                                                RestApi = fetchTable.default;
-                                                console.log('%c Fetch Dependencies will select (' + tableToFetch + ') using GET request', 'color: #33ccff');
-                                                nextFetchDependencies = eFetchDependencies.NONE;
-                                                if (fetchDependencies & eFetchDependencies.RECURSIVE) {
-                                                    if (fetchDependencies & eFetchDependencies.ALL) {
-                                                        throw Error('Recursive fetch dependencies with both PARENT and CHILD reference will result in an infin1ite loop. As there is not real ending condition, this is not supported.');
-                                                    }
-                                                    nextFetchDependencies = fetchDependencies;
-                                                }
-                                                else if (fetchDependencies & eFetchDependencies.C6ENTITY) {
-                                                    if (tableToFetch === "carbon_carbons") {
-                                                        nextFetchDependencies = fetchDependencies;
-                                                    }
-                                                    else {
-                                                        nextFetchDependencies = fetchDependencies ^ eFetchDependencies.C6ENTITY;
+                                        else if (requestMethod === POST) {
+                                            if (undefined !== (request === null || request === void 0 ? void 0 : request.dataInsertMultipleRows)) {
+                                                return [
+                                                    request.dataInsertMultipleRows.map(function (data) {
+                                                        return convertForRequestBody(data, fullTableList, C6, function (message) { return toast.error(message, toastOptions); });
+                                                    }),
+                                                    {
+                                                        withCredentials: withCredentials,
                                                     }
+                                                ];
+                                            }
+                                            return [
+                                                convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); }),
+                                                {
+                                                    withCredentials: withCredentials,
                                                 }
-                                                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
-                                                // 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((_p = {},
-                                                    _p[C6.WHERE] = {
-                                                        0: 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);
-                                                                return false;
-                                                            }
-                                                            sum[column] = fetchReferences_1[tableToFetch][column].length === 1
-                                                                ? fetchReferences_1[tableToFetch][column][0]
-                                                                : [
-                                                                    C6.IN, fetchReferences_1[tableToFetch][column]
-                                                                ];
-                                                            return sum;
-                                                        }, {})
-                                                    },
-                                                    _p.fetchDependencies = nextFetchDependencies,
-                                                    _p)));
-                                                return [2 /*return*/];
+                                            ];
                                         }
-                                    });
-                                };
-                                _a = fetchReferences_1;
-                                _b = [];
-                                for (_c in _a)
-                                    _b.push(_c);
-                                _i = 0;
-                                _o.label = 1;
-                            case 1:
-                                if (!(_i < _b.length)) return [3 /*break*/, 4];
-                                _c = _b[_i];
-                                if (!(_c in _a)) return [3 /*break*/, 3];
-                                tableToFetch = _c;
-                                return [5 /*yield**/, _loop_1(tableToFetch)];
-                            case 2:
-                                _o.sent();
-                                _o.label = 3;
-                            case 3:
-                                _i++;
-                                return [3 /*break*/, 1];
-                            case 4:
-                                console.groupEnd();
-                                return [4 /*yield*/, Promise.all(apiRequestPromises)];
-                            case 5:
-                                _o.sent();
-                                apiRequestPromises.map(function (promise) { return __awaiter(_this, void 0, void 0, function () {
-                                    var _a, _b;
-                                    return __generator(this, function (_c) {
-                                        switch (_c.label) {
-                                            case 0:
-                                                if (!Array.isArray(request.fetchDependencies)) {
-                                                    request.fetchDependencies = [];
+                                        else if (requestMethod === PUT) {
+                                            return [
+                                                convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); }),
+                                                {
+                                                    withCredentials: withCredentials,
                                                 }
-                                                _b = (_a = request.fetchDependencies).push;
-                                                return [4 /*yield*/, promise];
-                                            case 1:
-                                                _b.apply(_a, [_c.sent()]);
-                                                return [2 /*return*/];
+                                            ];
+                                        }
+                                        else if (requestMethod === DELETE) {
+                                            return [{
+                                                    withCredentials: withCredentials,
+                                                    data: convertForRequestBody(query, fullTableList, C6, function (message) { return toast.error(message, toastOptions); })
+                                                }];
                                         }
-                                    });
-                                }); });
-                                _o.label = 6;
-                            case 6:
-                                if (request.debug && isDevelopment) {
-                                    toast.success("DEVS: (" + requestMethod + ") request complete.", toastOptionsDevs);
+                                        else {
+                                            throw new Error('The request method (' + requestMethod + ') was not recognized.');
+                                        }
+                                    })()), false));
+                                    if (cachingConfirmed) {
+                                        // push to cache so we do not repeat the request
+                                        apiRequestCache.push({
+                                            requestArgumentsSerialized: querySerialized,
+                                            request: axiosActiveRequest
+                                        });
+                                    }
+                                    // todo - wip verify this works
+                                    // we had removed the value from the request to add to the URI.
+                                    addBackPK === null || addBackPK === void 0 ? void 0 : addBackPK(); // adding back so post-processing methods work
+                                    // returning the promise with this then is important for tests. todo - we could make that optional.
+                                    // https://rapidapi.com/guides/axios-async-await
+                                    return [2 /*return*/, axiosActiveRequest.then(function (response) { return __awaiter(_this, void 0, void 0, function () {
+                                            var cacheIndex, responseData_1, fetchDependencies, dependencies_1, fetchReferences_1, apiRequestPromises, _loop_1, _a, _b, _c, _i, tableToFetch;
+                                            var _this = this;
+                                            var _d, _e, _f, _g, _h, _j, _k, _l, _m;
+                                            return __generator(this, function (_o) {
+                                                switch (_o.label) {
+                                                    case 0:
+                                                        if (typeof response.data === 'string') {
+                                                            if (isTest) {
+                                                                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)];
+                                                        }
+                                                        if (cachingConfirmed) {
+                                                            cacheIndex = apiRequestCache.findIndex(function (cache) { return cache.requestArgumentsSerialized === querySerialized; });
+                                                            apiRequestCache[cacheIndex].final = false === returnGetNextPageFunction;
+                                                            // only cache get method requests
+                                                            apiRequestCache[cacheIndex].response = response;
+                                                        }
+                                                        apiResponse = TestRestfulResponse(response, request === null || request === void 0 ? void 0 : request.success, (_d = request === null || request === void 0 ? void 0 : request.error) !== null && _d !== void 0 ? _d : "An unexpected API error occurred!");
+                                                        if (false === apiResponse) {
+                                                            if (request.debug && isDevelopment) {
+                                                                toast.warning("DEVS: TestRestfulResponse returned false for (" + operatingTable + ").", toastOptionsDevs);
+                                                            }
+                                                            return [2 /*return*/, response];
+                                                        }
+                                                        // stateful operations are done in the response callback - its leverages rest generated functions
+                                                        if (responseCallback) {
+                                                            responseCallback(response, request, apiResponse);
+                                                        }
+                                                        if (!(C6.GET === requestMethod)) return [3 /*break*/, 6];
+                                                        responseData_1 = response.data;
+                                                        returnGetNextPageFunction = 1 !== ((_e = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _e === void 0 ? void 0 : _e[C6.LIMIT]) &&
+                                                            ((_f = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _f === void 0 ? void 0 : _f[C6.LIMIT]) === responseData_1.rest.length;
+                                                        if (false === isTest || true === isVerbose) {
+                                                            console.groupCollapsed('%c API: Response (' + requestMethod + ' ' + tableName + ') returned length (' + ((_g = responseData_1.rest) === null || _g === void 0 ? void 0 : _g.length) + ') of possible (' + ((_h = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _h === void 0 ? void 0 : _h[C6.LIMIT]) + ') limit!', 'color: #0c0');
+                                                            console.log('%c ' + requestMethod + ' ' + tableName, 'color: #0c0');
+                                                            console.log('%c Request Data (note you may see the success and/or error prompt):', 'color: #0c0', request);
+                                                            console.log('%c Response Data:', 'color: #0c0', responseData_1.rest);
+                                                            console.log('%c Will return get next page function:' + (1 !== ((_j = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _j === void 0 ? void 0 : _j[C6.LIMIT]) ? '' : ' (Will not return with explicit limit 1 set)'), 'color: #0c0', true === returnGetNextPageFunction);
+                                                            console.trace();
+                                                            console.groupEnd();
+                                                        }
+                                                        if (false === returnGetNextPageFunction
+                                                            && true === request.debug
+                                                            && isDevelopment) {
+                                                            toast.success("DEVS: Response returned length (" + ((_k = responseData_1.rest) === null || _k === void 0 ? void 0 : _k.length) + ") less than limit (" + ((_l = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _l === void 0 ? void 0 : _l[C6.LIMIT]) + ").", toastOptionsDevs);
+                                                        }
+                                                        (_m = request.fetchDependencies) !== null && _m !== void 0 ? _m : (request.fetchDependencies = eFetchDependencies.NONE);
+                                                        if (!(request.fetchDependencies
+                                                            && 'number' === typeof request.fetchDependencies
+                                                            && responseData_1.rest.length > 0)) return [3 /*break*/, 6];
+                                                        fetchDependencies = request.fetchDependencies;
+                                                        console.groupCollapsed('%c API: Fetch Dependencies segment (' + requestMethod + ' ' + tableName + ')'
+                                                            + (fetchDependencies & eFetchDependencies.CHILDREN ? ' | (CHILDREN|REFERENCED) ' : '')
+                                                            + (fetchDependencies & eFetchDependencies.PARENTS ? ' | (PARENTS|REFERENCED_BY)' : '')
+                                                            + (fetchDependencies & eFetchDependencies.C6ENTITY ? ' | (C6ENTITY)' : '')
+                                                            + (fetchDependencies & eFetchDependencies.RECURSIVE ? ' | (RECURSIVE)' : ''), 'color: #33ccff');
+                                                        console.groupCollapsed('Collapsed JS Trace');
+                                                        console.trace(); // hidden in collapsed group
+                                                        console.groupEnd();
+                                                        dependencies_1 = {};
+                                                        if (fetchDependencies & eFetchDependencies.C6ENTITY) {
+                                                            dependencies_1 = operatingTable.endsWith("carbon_carbons")
+                                                                ? __assign(__assign({}, fetchDependencies & eFetchDependencies.CHILDREN // REFERENCED === CHILDREN
+                                                                    ? C6.TABLES[operatingTable].TABLE_REFERENCED_BY
+                                                                    : {}), fetchDependencies & eFetchDependencies.PARENTS // REFERENCES === PARENTS
+                                                                    ? C6.TABLES[operatingTable].TABLE_REFERENCES
+                                                                    : {}) : __assign(__assign({}, fetchDependencies & eFetchDependencies.CHILDREN // REFERENCED === CHILDREN
+                                                                ? __assign(__assign({}, Object.keys(C6.TABLES[operatingTable].TABLE_REFERENCES).reduce(function (accumulator, columnName) {
+                                                                    if (!C6.TABLES[operatingTable].PRIMARY_SHORT.includes(columnName)) {
+                                                                        accumulator[columnName] = C6.TABLES[operatingTable].TABLE_REFERENCES[columnName];
+                                                                    }
+                                                                    return accumulator;
+                                                                }, {})), C6.TABLES[operatingTable].TABLE_REFERENCED_BY // it is unlikely that a C6 table will have any TABLE_REFERENCED_BY
+                                                                ) : {}), fetchDependencies & eFetchDependencies.PARENTS // REFERENCES === PARENTS
+                                                                ? C6.TABLES[operatingTable].PRIMARY_SHORT.reduce(function (accumulator, primaryKey) {
+                                                                    if (primaryKey in C6.TABLES[operatingTable].TABLE_REFERENCES) {
+                                                                        accumulator[primaryKey] = C6.TABLES[operatingTable].TABLE_REFERENCES[primaryKey];
+                                                                    }
+                                                                    return accumulator;
+                                                                }, {})
+                                                                : {});
+                                                        }
+                                                        else {
+                                                            // this is the natural mysql context
+                                                            dependencies_1 = __assign(__assign({}, fetchDependencies & eFetchDependencies.REFERENCED // REFERENCED === CHILDREN
+                                                                ? C6.TABLES[operatingTable].TABLE_REFERENCED_BY
+                                                                : {}), fetchDependencies & eFetchDependencies.REFERENCES // REFERENCES === PARENTS
+                                                                ? C6.TABLES[operatingTable].TABLE_REFERENCES
+                                                                : {});
+                                                        }
+                                                        fetchReferences_1 = {};
+                                                        apiRequestPromises = [];
+                                                        console.log('%c Dependencies', 'color: #005555', dependencies_1);
+                                                        Object.keys(dependencies_1)
+                                                            .forEach(function (column) { return dependencies_1[column]
+                                                            .forEach(function (constraint) {
+                                                            var _a, _b, _c, _d;
+                                                            var _e, _f, _g;
+                                                            var columnValues = (_b = (_a = responseData_1.rest[column]) !== null && _a !== void 0 ? _a : responseData_1.rest.map(function (row) {
+                                                                if (operatingTable.endsWith("carbons")
+                                                                    && 'entity_tag' in row
+                                                                    && !constraint.TABLE.endsWith(row['entity_tag'].split('\\').pop().toLowerCase())) {
+                                                                    return false; // map
+                                                                }
+                                                                if (!(column in row)) {
+                                                                    return false;
+                                                                }
+                                                                // todo - row[column] is a FK value, we should optionally remove values that are already in state
+                                                                // this could be any column in the table constraint.TABLE, not just the primary key
+                                                                return row[column];
+                                                            }).filter(function (n) { return n; })) !== null && _b !== void 0 ? _b : [];
+                                                            if (columnValues.length === 0) {
+                                                                return; // forEach
+                                                            }
+                                                            (_c = fetchReferences_1[_e = constraint.TABLE]) !== null && _c !== void 0 ? _c : (fetchReferences_1[_e] = {});
+                                                            (_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);
+                                                        _loop_1 = function (tableToFetch) {
+                                                            var referencesTables, shouldContinue, fetchTable, RestApi, nextFetchDependencies;
+                                                            var _p;
+                                                            return __generator(this, function (_q) {
+                                                                switch (_q.label) {
+                                                                    case 0:
+                                                                        if (fetchDependencies & eFetchDependencies.C6ENTITY
+                                                                            && 'string' === typeof tableName
+                                                                            && tableName.endsWith("carbon_carbons")) {
+                                                                            referencesTables = responseData_1.rest.reduce(function (accumulator, row) {
+                                                                                if ('entity_tag' in row && !accumulator.includes(row['entity_tag'])) {
+                                                                                    accumulator.push(row['entity_tag']);
+                                                                                }
+                                                                                return accumulator;
+                                                                            }, []).map(function (entityTag) { return entityTag.split('\\').pop().toLowerCase(); });
+                                                                            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);
+                                                                                return [2 /*return*/, "continue"];
+                                                                            }
+                                                                            console.log('%c C6ENTITY: The constraintTableName (' + tableToFetch + ') will be fetched.', 'color: #0c0');
+                                                                        }
+                                                                        return [4 /*yield*/, C6.IMPORT(tableToFetch)];
+                                                                    case 1:
+                                                                        fetchTable = _q.sent();
+                                                                        RestApi = fetchTable.default;
+                                                                        console.log('%c Fetch Dependencies will select (' + tableToFetch + ') using GET request', 'color: #33ccff');
+                                                                        nextFetchDependencies = eFetchDependencies.NONE;
+                                                                        if (fetchDependencies & eFetchDependencies.RECURSIVE) {
+                                                                            if (fetchDependencies & eFetchDependencies.ALL) {
+                                                                                throw Error('Recursive fetch dependencies with both PARENT and CHILD reference will result in an infin1ite loop. As there is not real ending condition, this is not supported.');
+                                                                            }
+                                                                            nextFetchDependencies = fetchDependencies;
+                                                                        }
+                                                                        else if (fetchDependencies & eFetchDependencies.C6ENTITY) {
+                                                                            if (tableToFetch === "carbon_carbons") {
+                                                                                nextFetchDependencies = fetchDependencies;
+                                                                            }
+                                                                            else {
+                                                                                nextFetchDependencies = fetchDependencies ^ eFetchDependencies.C6ENTITY;
+                                                                            }
+                                                                        }
+                                                                        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
+                                                                        // 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((_p = {},
+                                                                            _p[C6.WHERE] = {
+                                                                                0: 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);
+                                                                                        return false;
+                                                                                    }
+                                                                                    sum[column] = fetchReferences_1[tableToFetch][column].length === 1
+                                                                                        ? fetchReferences_1[tableToFetch][column][0]
+                                                                                        : [
+                                                                                            C6.IN, fetchReferences_1[tableToFetch][column]
+                                                                                        ];
+                                                                                    return sum;
+                                                                                }, {})
+                                                                            },
+                                                                            _p.fetchDependencies = nextFetchDependencies,
+                                                                            _p)));
+                                                                        return [2 /*return*/];
+                                                                }
+                                                            });
+                                                        };
+                                                        _a = fetchReferences_1;
+                                                        _b = [];
+                                                        for (_c in _a)
+                                                            _b.push(_c);
+                                                        _i = 0;
+                                                        _o.label = 1;
+                                                    case 1:
+                                                        if (!(_i < _b.length)) return [3 /*break*/, 4];
+                                                        _c = _b[_i];
+                                                        if (!(_c in _a)) return [3 /*break*/, 3];
+                                                        tableToFetch = _c;
+                                                        return [5 /*yield**/, _loop_1(tableToFetch)];
+                                                    case 2:
+                                                        _o.sent();
+                                                        _o.label = 3;
+                                                    case 3:
+                                                        _i++;
+                                                        return [3 /*break*/, 1];
+                                                    case 4:
+                                                        console.groupEnd();
+                                                        return [4 /*yield*/, Promise.all(apiRequestPromises)];
+                                                    case 5:
+                                                        _o.sent();
+                                                        apiRequestPromises.map(function (promise) { return __awaiter(_this, void 0, void 0, function () {
+                                                            var _a, _b;
+                                                            return __generator(this, function (_c) {
+                                                                switch (_c.label) {
+                                                                    case 0:
+                                                                        if (!Array.isArray(request.fetchDependencies)) {
+                                                                            request.fetchDependencies = [];
+                                                                        }
+                                                                        _b = (_a = request.fetchDependencies).push;
+                                                                        return [4 /*yield*/, promise];
+                                                                    case 1:
+                                                                        _b.apply(_a, [_c.sent()]);
+                                                                        return [2 /*return*/];
+                                                                }
+                                                            });
+                                                        }); });
+                                                        _o.label = 6;
+                                                    case 6:
+                                                        if (request.debug && isDevelopment) {
+                                                            toast.success("DEVS: (" + requestMethod + ") request complete.", toastOptionsDevs);
+                                                        }
+                                                        return [2 /*return*/, response];
+                                                }
+                                            });
+                                        }); })];
                                 }
-                                return [2 /*return*/, response];
+                                catch (error) {
+                                    if (isTest) {
+                                        throw new Error(JSON.stringify(error));
+                                    }
+                                    console.groupCollapsed('%c API: An error occurred in the try catch block. returning null!', 'color: #ff0000');
+                                    console.log('%c ' + requestMethod + ' ' + tableName, 'color: #A020F0');
+                                    console.warn(error);
+                                    console.trace();
+                                    console.groupEnd();
+                                    TestRestfulResponse(error, request === null || request === void 0 ? void 0 : request.success, (request === null || request === void 0 ? void 0 : request.error) || "An restful API error occurred!");
+                                    return [2 /*return*/, null];
+                                }
+                                return [2 /*return*/];
                         }
                     });
-                }); });
+                });
             }
-            catch (error) {
-                if (isTest) {
-                    throw new Error(JSON.stringify(error));
+            var query;
+            if (request === void 0) { request = {}; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        console.groupCollapsed('%c API: (' + requestMethod + ') Request for (' + operatingTable + ')', 'color: #0c0');
+                        console.log('request', request);
+                        console.groupEnd();
+                        if ('function' === typeof queryCallback) {
+                            query = queryCallback(request); // obj or obj[]
+                        }
+                        else {
+                            query = queryCallback;
+                        }
+                        if (undefined === query || null === query) {
+                            if (request.debug && isDevelopment) {
+                                toast.warning("DEV: queryCallback returned undefined, signaling in Custom Cache. (returning null)", toastOptionsDevs);
+                            }
+                            console.groupCollapsed('%c API: (' + requestMethod + ') Request Query for (' + operatingTable + ') undefined, returning null (will not fire ajax)!', 'color: #c00');
+                            console.log('%c Returning (undefined|null) for a query would indicate a custom cache hit (outside API.tsx), thus the request should not fire.', 'color: #c00');
+                            console.trace();
+                            console.groupEnd();
+                            return [2 /*return*/, null];
+                        }
+                        if (C6.GET === requestMethod) {
+                            if (undefined === query[C6.PAGINATION]) {
+                                query[C6.PAGINATION] = {};
+                            }
+                            query[C6.PAGINATION][C6.PAGE] = query[C6.PAGINATION][C6.PAGE] || 1;
+                            query[C6.PAGINATION][C6.LIMIT] = query[C6.PAGINATION][C6.LIMIT] || 100;
+                        }
+                        return [4 /*yield*/, apiRequest()];
+                    case 1: return [2 /*return*/, _a.sent()];
                 }
-                console.groupCollapsed('%c API: An error occurred in the try catch block. returning null!', 'color: #ff0000');
-                console.log('%c ' + requestMethod + ' ' + tableName, 'color: #A020F0');
-                console.warn(error);
-                console.trace();
-                console.groupEnd();
-                TestRestfulResponse(error, request === null || request === void 0 ? void 0 : request.success, (request === null || request === void 0 ? void 0 : request.error) || "An restful API error occurred!");
-                return null;
-            }
-        }
-        return apiRequest();
+            });
+        });
     };
 }
 
@@ -984,5 +1409,5 @@ function timeout(shouldContinueAfterTimeout, cb, timeoutMs) {
     };
 }
 
-export { C6Constants, DELETE, GET, POST, PUT, TestRestfulResponse, axiosInstance, checkAllRequestsComplete, clearCache, convertForRequestBody, eFetchDependencies, extendedTypeHints, getEnvVar, isDevelopment as isLocal, isPromise, isTest, isVerbose, removeInvalidKeys, removePrefixIfExists, restRequest, timeout, toastOptions, toastOptionsDevs };
+export { C6Constants, CarbonSqlExecutor, DELETE, GET, POST, PUT, TestRestfulResponse, axiosInstance, checkAllRequestsComplete, clearCache, convertForRequestBody, eFetchDependencies, extendedTypeHints, getEnvVar, isDevelopment as isLocal, isNode, isPromise, isTest, isVerbose, removeInvalidKeys, removePrefixIfExists, restRequest, timeout, toastOptions, toastOptionsDevs };
 //# sourceMappingURL=index.esm.js.map