@carbonorm/carbonnode 3.7.23 → 3.8.1

package/dist/index.esm.js

@@ -167,6 +167,14 @@ var C6Constants = {
 var C6C = C6Constants;
 
 // @link https://www.npmjs.com/package/axios-cache-adapter
+var carbonNodeQsStringify = function (params) {
+    return Qs.stringify(params, {
+        arrayFormat: "indices",
+        indices: true,
+        skipNulls: false,
+        strictNullHandling: true,
+    });
+};
 // updating these values
 // @link https://github.com/axios/axios/issues/209
 //
@@ -175,7 +183,7 @@ var C6C = C6Constants;
 //
 // immediately affects this instance
 // axiosInstance.defaults.headers['Auth-Token'] = 'foo bar';
-var axiosInstance = (axios.create({
+var carbonAxiosInstance = (axios.create({
     // `baseURL` will be prepended to `url` unless `url` is absolute.
     // It can be convenient to set `baseURL` for an instance of axios to pass relative URLs
     // to methods of that instance.
@@ -197,7 +205,7 @@ var axiosInstance = (axios.create({
     // (e.g. https://www.npmjs.com/package/qs, http://api.jquery.com/jquery.param/)
     paramsSerializer: function (params) {
         // Nested get params [][][,,,] do not serialize correctly without Qs
-        return Qs.stringify(params, { arrayFormat: 'indices', indices: true, skipNulls: false, strictNullHandling: true });
+        return carbonNodeQsStringify(params);
     },
     // `data` is the data to be sent as the request body
     // Only applicable for request methods 'PUT', 'POST', and 'PATCH'
@@ -268,6 +276,20 @@ var axiosInstance = (axios.create({
     httpsAgent: new https.Agent({ keepAlive: true }),
     */
 }));
+carbonAxiosInstance.interceptors.request.use(function (config) {
+    if (config.params) {
+        var serialized = carbonNodeQsStringify(config.params);
+        if (serialized.length > 2000) {
+            // Move params into body but keep track of intended method
+            config.method = "post";
+            config.data = config.params;
+            config.params = {
+                METHOD: "GET", // 👈 explicit signal for your REST parser
+            };
+        }
+    }
+    return config;
+});
 
 function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler) {
     if (regexErrorHandler === void 0) { regexErrorHandler = alert; }
@@ -625,13 +647,20 @@ var HttpExecutor = /** @class */ (function (_super) {
     function HttpExecutor() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
+    HttpExecutor.prototype.isRestResponse = function (r) {
+        return !!r && r.data != null && typeof r.data === 'object' && 'rest' in r.data;
+    };
     HttpExecutor.prototype.stripTableNameFromKeys = function (obj) {
-        var columns = this.config.restModel.COLUMNS || {};
-        return Object.keys(obj || {}).reduce(function (acc, key) {
-            var shortKey = columns[key] || key.split('.').pop();
-            acc[shortKey] = obj[key];
-            return acc;
-        }, {});
+        var _a;
+        var columns = this.config.restModel.COLUMNS;
+        var source = (obj !== null && obj !== void 0 ? obj : {});
+        var out = {};
+        for (var _i = 0, _b = Object.entries(source); _i < _b.length; _i++) {
+            var _c = _b[_i], key = _c[0], value = _c[1];
+            var short = (_a = columns[key]) !== null && _a !== void 0 ? _a : (key.includes('.') ? key.split('.').pop() : key);
+            out[short] = value;
+        }
+        return out;
     };
     HttpExecutor.prototype.putState = function (response, request, callback) {
         var _a, _b;
@@ -648,14 +677,15 @@ var HttpExecutor = /** @class */ (function (_super) {
     HttpExecutor.prototype.postState = function (response, request, callback) {
         var _this = this;
         var _a, _b, _c;
-        if (1 !== this.config.restModel.PRIMARY_SHORT.length) {
-            console.error("C6 received unexpected result's given the primary key length");
-        }
-        else {
+        if (this.config.restModel.PRIMARY_SHORT.length === 1) {
             var pk = this.config.restModel.PRIMARY_SHORT[0];
-            // TODO - should overrides be handled differently? Why override: (react/php), driver missmatches, aux data..
-            // @ts-ignore - this is technically a correct error, but we allow it anyway...
-            request[pk] = (_a = response.data) === null || _a === void 0 ? void 0 : _a.created;
+            try {
+                request[pk] = (_a = response.data) === null || _a === void 0 ? void 0 : _a.created;
+            }
+            catch ( /* best-effort */_d) { /* best-effort */ }
+        }
+        else if (isLocal()) {
+            console.error("C6 received unexpected results given the primary key length");
         }
         (_b = this.config.reactBootstrap) === null || _b === void 0 ? void 0 : _b.updateRestfulObjectArrays({
             callback: callback,
@@ -688,8 +718,9 @@ var HttpExecutor = /** @class */ (function (_super) {
         return __awaiter(this, void 0, void 0, function () {
             var _a, C6, axios, restURL, withCredentials, restModel, reactBootstrap, requestMethod, skipPrimaryCheck, clearCache, tableName, fullTableList, operatingTableFullName, operatingTable, tables, query, apiRequest;
             var _this = this;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         _a = this.config, C6 = _a.C6, axios = _a.axios, restURL = _a.restURL, withCredentials = _a.withCredentials, restModel = _a.restModel, reactBootstrap = _a.reactBootstrap, requestMethod = _a.requestMethod, skipPrimaryCheck = _a.skipPrimaryCheck, clearCache = _a.clearCache;
                         return [4 /*yield*/, this.runLifecycleHooks("beforeProcessing", {
@@ -697,7 +728,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                 request: this.request,
                             })];
                     case 1:
-                        _b.sent();
+                        _c.sent();
                         tableName = restModel.TABLE_NAME;
                         fullTableList = Array.isArray(tableName) ? tableName : [tableName];
                         operatingTableFullName = fullTableList[0];
@@ -712,45 +743,40 @@ var HttpExecutor = /** @class */ (function (_super) {
                             default:
                                 throw Error('Bad request method passed to getApi');
                         }
-                        if (null !== clearCache || undefined !== clearCache) {
-                            userCustomClearCache[tables + requestMethod] = clearCache;
+                        if (clearCache != null) {
+                            userCustomClearCache.push(clearCache);
+                        }
+                        if (isLocal() && (this.config.verbose || ((_b = this.request) === null || _b === void 0 ? void 0 : _b.debug))) {
+                            console.groupCollapsed('%c API:', 'color: #0c0', "(".concat(requestMethod, ") Request for (").concat(tableName, ")"));
+                            console.log('request', this.request);
+                            console.groupEnd();
                         }
-                        console.groupCollapsed('%c API: (' + requestMethod + ') Request for (' + tableName + ')', 'color: #0c0');
-                        console.log('request', this.request);
-                        console.groupEnd();
                         // an undefined query would indicate queryCallback returned undefined,
                         // thus the request shouldn't fire as is in custom cache
                         if (undefined === this.request || null === this.request) {
-                            console.groupCollapsed('%c API: (' + requestMethod + ') Request Query for (' + tableName + ') undefined, returning null (will not fire)!', 'color: #c00');
-                            console.log('request', this.request);
-                            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();
+                            if (isLocal()) {
+                                console.groupCollapsed("API: (".concat(requestMethod, ") (").concat(tableName, ") query undefined/null \u2192 returning null"));
+                                console.log('request', this.request);
+                                console.groupEnd();
+                            }
                             return [2 /*return*/, null];
                         }
                         query = this.request;
-                        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;
-                        }
                         apiRequest = function () { return __awaiter(_this, void 0, void 0, function () {
-                            var _a, debug, _b, cacheResults, dataInsertMultipleRows, success, _c, fetchDependencies, _d, error, querySerialized, cacheResult, cachingConfirmed, cacheCheck, cacheCheck, apiResponse, returnGetNextPageFunction, restRequestUri, needsConditionOrPrimaryCheck, TABLES, primaryKeyList, primaryKeyFullyQualified, primaryKey, providedPrimary, primaryVal, axiosActiveRequest;
+                            var _a, debug, _b, cacheResults, dataInsertMultipleRows, success, _c, fetchDependencies, _d, error, querySerialized, cacheResult, cachingConfirmed, cacheCheck, cacheCheck, apiResponse, returnGetNextPageFunction, restRequestUri, needsConditionOrPrimaryCheck, TABLES, primaryKeyList, primaryKeyFullyQualified, primaryKey, whereVal, whereIsEmpty, providedPrimary, primaryVal, axiosActiveRequest;
                             var _e;
                             var _this = this;
-                            var _f, _g, _h, _j, _k, _l;
-                            return __generator(this, function (_m) {
-                                switch (_m.label) {
+                            var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+                            return __generator(this, function (_r) {
+                                switch (_r.label) {
                                     case 0:
                                         _a = this.request, debug = _a.debug, _b = _a.cacheResults, cacheResults = _b === void 0 ? (C6.GET === requestMethod) : _b, dataInsertMultipleRows = _a.dataInsertMultipleRows, success = _a.success, _c = _a.fetchDependencies, fetchDependencies = _c === void 0 ? eFetchDependencies.NONE : _c, _d = _a.error, error = _d === void 0 ? "An unexpected API error occurred!" : _d;
                                         if (C6.GET === requestMethod
                                             && undefined !== ((_f = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _f === void 0 ? void 0 : _f[C6.PAGE])
-                                            && 1 !== query[C6.PAGINATION][C6.PAGE]) {
-                                            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):', this.request);
-                                            console.trace();
+                                            && 1 !== query[C6.PAGINATION][C6.PAGE]
+                                            && isLocal()) {
+                                            console.groupCollapsed("Request (".concat(tableName, ") page (").concat(query[C6.PAGINATION][C6.PAGE], ")"));
+                                            console.log('request', this.request);
                                             console.groupEnd();
                                         }
                                         querySerialized = sortAndSerializeQueryObject(tables, query !== null && query !== void 0 ? query : {});
@@ -767,39 +793,35 @@ var HttpExecutor = /** @class */ (function (_super) {
                                         query[C6.PAGINATION][C6.LIMIT] = query[C6.PAGINATION][C6.LIMIT] || 100;
                                         if (!(true === cacheResults)) return [3 /*break*/, 7];
                                         if (!(undefined !== cacheResult)) return [3 /*break*/, 6];
-                                        _m.label = 1;
+                                        _r.label = 1;
                                     case 1:
                                         cacheCheck = checkCache(cacheResult, requestMethod, tableName, this.request);
                                         if (!(false !== cacheCheck)) return [3 /*break*/, 3];
                                         return [4 /*yield*/, cacheCheck];
-                                    case 2: return [2 /*return*/, (_m.sent()).data];
+                                    case 2: return [2 /*return*/, (_r.sent()).data];
                                     case 3:
-                                        // 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; });
-                                        _m.label = 4;
+                                        _r.label = 4;
                                     case 4:
                                         if (undefined !== cacheResult) return [3 /*break*/, 1];
-                                        _m.label = 5;
+                                        _r.label = 5;
                                     case 5:
                                         if (debug && isLocal()) {
-                                            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);
+                                            toast.warning("DEVS: Request pages exhausted in cache; firing network.", toastOptionsDevs);
                                         }
-                                        // @ts-ignore - this is an incorrect warning on TS, it's well typed
-                                        return [2 /*return*/, apiRequest];
+                                        _r.label = 6;
                                     case 6:
                                         cachingConfirmed = true;
                                         return [3 /*break*/, 8];
                                     case 7:
-                                        if (debug && isLocal()) {
+                                        if (debug && isLocal())
                                             toast.info("DEVS: Ignore cache was set to true.", toastOptionsDevs);
-                                        }
-                                        _m.label = 8;
+                                        _r.label = 8;
                                     case 8:
                                         if (debug && isLocal()) {
-                                            toast.success("DEVS: Request not in cache." + (requestMethod === C6.GET ? "Page (" + query[C6.PAGINATION][C6.PAGE] + ")." : '') + " Logging cache 2 console.", toastOptionsDevs);
+                                            toast.success("DEVS: Request not in cache." + (requestMethod === C6.GET ? " Page (" + query[C6.PAGINATION][C6.PAGE] + ")" : ''), toastOptionsDevs);
                                         }
                                         return [3 /*break*/, 12];
                                     case 9:
@@ -808,10 +830,10 @@ var HttpExecutor = /** @class */ (function (_super) {
                                         cacheCheck = checkCache(cacheResult, requestMethod, tableName, this.request);
                                         if (!(false !== cacheCheck)) return [3 /*break*/, 11];
                                         return [4 /*yield*/, cacheCheck];
-                                    case 10: return [2 /*return*/, (_m.sent()).data];
+                                    case 10: return [2 /*return*/, (_r.sent()).data];
                                     case 11:
                                         cachingConfirmed = true;
-                                        _m.label = 12;
+                                        _r.label = 12;
                                     case 12:
                                         returnGetNextPageFunction = false;
                                         restRequestUri = restURL + operatingTable + '/';
@@ -823,12 +845,11 @@ var HttpExecutor = /** @class */ (function (_super) {
                                         primaryKey = (_h = primaryKeyFullyQualified === null || primaryKeyFullyQualified === void 0 ? void 0 : primaryKeyFullyQualified.split('.')) === null || _h === void 0 ? void 0 : _h.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)) {
+                                                whereVal = query === null || query === void 0 ? void 0 : query[C6.WHERE];
+                                                whereIsEmpty = whereVal == null ||
+                                                    (Array.isArray(whereVal) && whereVal.length === 0) ||
+                                                    (typeof whereVal === 'object' && !Array.isArray(whereVal) && Object.keys(whereVal).length === 0);
+                                                if (whereIsEmpty) {
                                                     console.error(query);
                                                     throw Error('Failed to parse primary key information. Query: (' + JSON.stringify(query) + ') Primary Key: (' + JSON.stringify(primaryKey) + ') TABLES[operatingTable]?.PRIMARY: (' + JSON.stringify((_j = TABLES[operatingTable]) === null || _j === void 0 ? void 0 : _j.PRIMARY) + ') for operatingTable (' + operatingTable + ').');
                                                 }
@@ -859,22 +880,27 @@ var HttpExecutor = /** @class */ (function (_super) {
                                             primaryVal = (_l = query[primaryKey]) !== null && _l !== void 0 ? _l : (primaryKeyFullyQualified ? query[primaryKeyFullyQualified] : undefined);
                                             if (undefined !== primaryVal) {
                                                 restRequestUri += primaryVal + '/';
-                                                console.log('query', query, 'primaryKey', primaryKey);
+                                                if (isLocal() && (this.config.verbose || ((_m = this.request) === null || _m === void 0 ? void 0 : _m.debug))) {
+                                                    console.log('query', query, 'primaryKey', primaryKey);
+                                                }
                                             }
                                             else {
-                                                console.log('query', query);
+                                                if (isLocal() && (this.config.verbose || ((_o = this.request) === null || _o === void 0 ? void 0 : _o.debug))) {
+                                                    console.log('query', query);
+                                                }
                                             }
                                         }
                                         else {
-                                            console.log('query', query);
+                                            if (isLocal() && (this.config.verbose || ((_p = this.request) === null || _p === void 0 ? void 0 : _p.debug))) {
+                                                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(this.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();
+                                            if (isLocal() && (this.config.verbose || ((_q = this.request) === null || _q === void 0 ? void 0 : _q.debug))) {
+                                                console.groupCollapsed('%c API:', 'color: #A020F0', "(".concat(requestMethod, ") (").concat(operatingTable, ") firing"));
+                                                console.log(this.request);
+                                                console.groupEnd();
+                                            }
                                             this.runLifecycleHooks("beforeExecution", {
                                                 config: this.config,
                                                 request: this.request
@@ -915,11 +941,11 @@ var HttpExecutor = /** @class */ (function (_super) {
                                             // 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, callback, responseData_1, dependencies_1, fetchReferences_1, apiRequestPromises, _loop_1, tableToFetch;
+                                                    var cacheIndex, callback, responseData_1, pageLimit, got, hasNext, cacheIndex, dependencies_1, fetchReferences_1, apiRequestPromises, _loop_1, tableToFetch;
                                                     var _this = this;
-                                                    var _a, _b, _c, _d, _e, _f, _g;
-                                                    return __generator(this, function (_h) {
-                                                        switch (_h.label) {
+                                                    var _a, _b, _c, _d;
+                                                    return __generator(this, function (_e) {
+                                                        switch (_e.label) {
                                                             case 0:
                                                                 // noinspection SuspiciousTypeOfGuard
                                                                 if (typeof response.data === 'string') {
@@ -941,13 +967,13 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                     request: this.request,
                                                                     response: response
                                                                 });
-                                                                // todo - this feels dumb now, but i digress
                                                                 apiResponse = TestRestfulResponse(response, success, error);
                                                                 if (false === apiResponse) {
                                                                     if (debug && isLocal()) {
-                                                                        toast.warning("DEVS: TestRestfulResponse returned false for (" + operatingTable + ").", toastOptionsDevs);
+                                                                        toast.warning("DEVS: TestRestfulResponse returned false.", toastOptionsDevs);
                                                                     }
-                                                                    return [2 /*return*/, response];
+                                                                    // Force a null payload so the final .then(response => response.data) yields null
+                                                                    return [2 /*return*/, Promise.resolve(__assign(__assign({}, response), { data: null }))];
                                                                 }
                                                                 callback = function () { return _this.runLifecycleHooks("afterCommit", {
                                                                     config: _this.config,
@@ -979,28 +1005,29 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 else {
                                                                     callback();
                                                                 }
-                                                                if (!(C6.GET === requestMethod)) return [3 /*break*/, 2];
+                                                                if (!(C6.GET === requestMethod && this.isRestResponse(response))) return [3 /*break*/, 2];
                                                                 responseData_1 = response.data;
-                                                                returnGetNextPageFunction = 1 !== ((_a = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _a === void 0 ? void 0 : _a[C6.LIMIT]) &&
-                                                                    ((_b = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _b === void 0 ? void 0 : _b[C6.LIMIT]) === responseData_1.rest.length;
-                                                                if (false === isTest() || this.config.verbose) {
-                                                                    console.groupCollapsed('%c API: Response (' + requestMethod + ' ' + tableName + ') returned length (' + ((_c = responseData_1.rest) === null || _c === void 0 ? void 0 : _c.length) + ') of possible (' + ((_d = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _d === void 0 ? void 0 : _d[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', this.request);
-                                                                    console.log('%c Response Data:', 'color: #0c0', responseData_1.rest);
-                                                                    console.log('%c Will return get next page function:' + (returnGetNextPageFunction ? '' : ' (Will not return with explicit limit 1 set)'), 'color: #0c0', true === returnGetNextPageFunction);
-                                                                    console.trace();
-                                                                    console.groupEnd();
-                                                                }
-                                                                if (false === returnGetNextPageFunction) {
-                                                                    responseData_1.next = apiRequest;
+                                                                pageLimit = (_a = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _a === void 0 ? void 0 : _a[C6.LIMIT];
+                                                                got = responseData_1.rest.length;
+                                                                hasNext = pageLimit !== 1 && got === pageLimit;
+                                                                if (hasNext) {
+                                                                    responseData_1.next = apiRequest; // there might be more
                                                                 }
                                                                 else {
-                                                                    responseData_1.next = undefined;
-                                                                    if (true === debug
-                                                                        && isLocal()) {
-                                                                        toast.success("DEVS: Response returned length (" + ((_e = responseData_1.rest) === null || _e === void 0 ? void 0 : _e.length) + ") less than limit (" + ((_f = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _f === void 0 ? void 0 : _f[C6.LIMIT]) + ").", toastOptionsDevs);
-                                                                    }
+                                                                    responseData_1.next = undefined; // short page => done
+                                                                }
+                                                                // If you keep this flag, make it reflect reality:
+                                                                returnGetNextPageFunction = hasNext;
+                                                                // and fix cache ‘final’ flag to match:
+                                                                if (cachingConfirmed) {
+                                                                    cacheIndex = apiRequestCache.findIndex(function (c) { return c.requestArgumentsSerialized === querySerialized; });
+                                                                    apiRequestCache[cacheIndex].final = !hasNext;
+                                                                }
+                                                                if ((this.config.verbose || debug) && isLocal()) {
+                                                                    console.groupCollapsed("API: Response (".concat(requestMethod, " ").concat(tableName, ") len (").concat((_b = responseData_1.rest) === null || _b === void 0 ? void 0 : _b.length, ") of (").concat((_c = query === null || query === void 0 ? void 0 : query[C6.PAGINATION]) === null || _c === void 0 ? void 0 : _c[C6.LIMIT], ")"));
+                                                                    console.log('request', this.request);
+                                                                    console.log('response.rest', responseData_1.rest);
+                                                                    console.groupEnd();
                                                                 }
                                                                 if (!(fetchDependencies
                                                                     && 'number' === typeof fetchDependencies
@@ -1075,7 +1102,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 }); });
                                                                 console.log('fetchReferences', fetchReferences_1);
                                                                 _loop_1 = function (tableToFetch) {
-                                                                    var _j;
+                                                                    var _f;
                                                                     if (fetchDependencies & eFetchDependencies.C6ENTITY
                                                                         && 'string' === typeof tableName
                                                                         && tableName.endsWith("carbon_carbons")) {
@@ -1098,7 +1125,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                         .split('_')
                                                                         .map(function (part) { return part.charAt(0).toUpperCase() + part.slice(1); })
                                                                         .join('_');
-                                                                    var RestApi = (_g = C6.ORM[ormKey]) !== null && _g !== void 0 ? _g : new Error("Fetch Dependencies could not find table (".concat(ormKey, ") in the set \u2209 [ ").concat(Object.keys(C6.ORM).join(', '), " ]"));
+                                                                    var RestApi = (_d = C6.ORM[ormKey]) !== null && _d !== void 0 ? _d : new Error("Fetch Dependencies could not find table (".concat(ormKey, ") in the set \u2209 [ ").concat(Object.keys(C6.ORM).join(', '), " ]"));
                                                                     console.log('%c Fetch Dependencies will select (' + tableToFetch + ') using GET request', 'color: #33ccff');
                                                                     var nextFetchDependencies = eFetchDependencies.NONE;
                                                                     if (fetchDependencies & eFetchDependencies.RECURSIVE) {
@@ -1124,8 +1151,8 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                     console.log('RestApi object', RestApi);
                                                                     // this is a dynamic call to the rest api, any generated table may resolve with (RestApi)
                                                                     // todo - using value to avoid joins.... but. maybe this should be a parameterizable option -- think race conditions; its safer to join
-                                                                    apiRequestPromises.push(RestApi.Get((_j = {},
-                                                                        _j[C6.WHERE] = Object.keys(fetchReferences_1[tableToFetch]).reduce(function (sum, column) {
+                                                                    apiRequestPromises.push(RestApi.Get((_f = {},
+                                                                        _f[C6.WHERE] = Object.keys(fetchReferences_1[tableToFetch]).reduce(function (sum, column) {
                                                                             fetchReferences_1[tableToFetch][column] = fetchReferences_1[tableToFetch][column].flat(Infinity);
                                                                             if (0 === fetchReferences_1[tableToFetch][column].length) {
                                                                                 console.warn('The column (' + column + ') was not found in the response data. We will not fetch.', responseData_1);
@@ -1138,8 +1165,8 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                                 ];
                                                                             return sum;
                                                                         }, {}),
-                                                                        _j.fetchDependencies = nextFetchDependencies,
-                                                                        _j)));
+                                                                        _f.fetchDependencies = nextFetchDependencies,
+                                                                        _f)));
                                                                 };
                                                                 for (tableToFetch in fetchReferences_1) {
                                                                     _loop_1(tableToFetch);
@@ -1147,7 +1174,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 console.groupEnd();
                                                                 return [4 /*yield*/, Promise.all(apiRequestPromises)];
                                                             case 1:
-                                                                _h.sent();
+                                                                _e.sent();
                                                                 apiRequestPromises.map(function (promise) { return __awaiter(_this, void 0, void 0, function () {
                                                                     var _a, _b;
                                                                     return __generator(this, function (_c) {
@@ -1165,7 +1192,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                         }
                                                                     });
                                                                 }); });
-                                                                _h.label = 2;
+                                                                _e.label = 2;
                                                             case 2:
                                                                 if (debug && isLocal()) {
                                                                     toast.success("DEVS: (" + requestMethod + ") request complete.", toastOptionsDevs);
@@ -1193,7 +1220,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                             });
                         }); };
                         return [4 /*yield*/, apiRequest()];
-                    case 2: return [2 /*return*/, _b.sent()];
+                    case 2: return [2 /*return*/, _c.sent()];
                 }
             });
         });
@@ -2086,16 +2113,31 @@ function ExpressHandler(_a) {
     var _this = this;
     var C6 = _a.C6, mysqlPool = _a.mysqlPool;
     return function (req, res, next) { return __awaiter(_this, void 0, void 0, function () {
-        var method, table, primary, payload, primaryKeys, primaryKeyName, response, err_1;
-        var _a, _b;
-        return __generator(this, function (_c) {
-            switch (_c.label) {
+        var incomingMethod, table, primary, methodOverrideRaw, methodOverride, treatAsGet, method, payload, primaryKeys, primaryKeyName, response, err_1;
+        var _a, _b, _c, _d, _e;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
                 case 0:
-                    _c.trys.push([0, 2, , 3]);
-                    method = req.method.toUpperCase();
+                    _f.trys.push([0, 2, , 3]);
+                    incomingMethod = req.method.toUpperCase();
                     table = req.params.table;
                     primary = req.params.primary;
-                    payload = method === 'GET' ? req.query : req.body;
+                    methodOverrideRaw = ((_b = (_a = req.query) === null || _a === void 0 ? void 0 : _a.METHOD) !== null && _b !== void 0 ? _b : (_c = req.query) === null || _c === void 0 ? void 0 : _c.method);
+                    methodOverride = typeof methodOverrideRaw === 'string' ? methodOverrideRaw.toUpperCase() : undefined;
+                    treatAsGet = incomingMethod === 'POST' && methodOverride === 'GET';
+                    method = treatAsGet ? 'GET' : incomingMethod;
+                    payload = treatAsGet ? __assign({}, req.body) : (method === 'GET' ? req.query : req.body);
+                    // Remove transport-only METHOD flag so it never leaks into ORM parsing
+                    if (treatAsGet && 'METHOD' in payload) {
+                        try {
+                            delete payload.METHOD;
+                        }
+                        catch ( /* noop */_g) { /* noop */ }
+                    }
+                    // Warn for unsupported overrides but continue normally
+                    if (incomingMethod !== 'GET' && methodOverride && methodOverride !== 'GET') {
+                        console.warn("Ignoring unsupported METHOD override: ".concat(methodOverride));
+                    }
                     if (!(table in C6.TABLES)) {
                         res.status(400).json({ error: "Invalid table: ".concat(table) });
                         return [2 /*return*/];
@@ -2118,11 +2160,11 @@ function ExpressHandler(_a) {
                     if (primary) {
                         if (payload[C6C.WHERE]) {
                             payload[C6C.WHERE][primaryKeyName] =
-                                (_a = payload[C6C.WHERE][primaryKeyName]) !== null && _a !== void 0 ? _a : primary;
+                                (_d = payload[C6C.WHERE][primaryKeyName]) !== null && _d !== void 0 ? _d : primary;
                         }
                         else {
                             payload[primaryKeyName] =
-                                (_b = payload[primaryKeyName]) !== null && _b !== void 0 ? _b : primary;
+                                (_e = payload[primaryKeyName]) !== null && _e !== void 0 ? _e : primary;
                         }
                     }
                     return [4 /*yield*/, restRequest({
@@ -2132,11 +2174,11 @@ function ExpressHandler(_a) {
                             restModel: C6.TABLES[table]
                         })(payload)];
                 case 1:
-                    response = _c.sent();
+                    response = _f.sent();
                     res.status(200).json(__assign({ success: true }, response));
                     return [3 /*break*/, 3];
                 case 2:
-                    err_1 = _c.sent();
+                    err_1 = _f.sent();
                     res.status(500).json({ success: false, error: err_1 });
                     next(err_1);
                     return [3 /*break*/, 3];
@@ -2280,5 +2322,5 @@ function isVerbose () {
     return ['true', '1', 'yes', 'on'].includes(envVerbose.toLowerCase());
 }
 
-export { A, AggregateBuilder, C6C, C6Constants, ConditionBuilder, DELETE, DeleteQueryBuilder, Executor, ExpressHandler, F, GET, HttpExecutor, JoinBuilder, POST, PUT, PaginationBuilder, PostQueryBuilder, SelectQueryBuilder, SqlExecutor, TestRestfulResponse, UpdateQueryBuilder, apiRequestCache, axiosInstance, bbox, checkAllRequestsComplete, checkCache, clearCache, convertForRequestBody, convertHexIfBinary, determineRuntimeJsType, distSphere, eFetchDependencies, error, fieldEq, getEnvVar, getPrimaryKeyTypes, group, info, isLocal, isNode, isTest, isVerbose, normalizeSingularRequest, onError, onSuccess, removeInvalidKeys, removePrefixIfExists, restOrm, restRequest, sortAndSerializeQueryObject, stContains, timeout, toastOptions, toastOptionsDevs, userCustomClearCache, warn };
+export { A, AggregateBuilder, C6C, C6Constants, ConditionBuilder, DELETE, DeleteQueryBuilder, Executor, ExpressHandler, F, GET, HttpExecutor, JoinBuilder, POST, PUT, PaginationBuilder, PostQueryBuilder, SelectQueryBuilder, SqlExecutor, TestRestfulResponse, UpdateQueryBuilder, apiRequestCache, bbox, carbonNodeQsStringify, checkAllRequestsComplete, checkCache, clearCache, convertForRequestBody, convertHexIfBinary, determineRuntimeJsType, distSphere, eFetchDependencies, error, fieldEq, getEnvVar, getPrimaryKeyTypes, group, info, isLocal, isNode, isTest, isVerbose, normalizeSingularRequest, onError, onSuccess, removeInvalidKeys, removePrefixIfExists, restOrm, restRequest, sortAndSerializeQueryObject, stContains, timeout, toastOptions, toastOptionsDevs, userCustomClearCache, warn };
 //# sourceMappingURL=index.esm.js.map