@carbonorm/carbonnode 5.0.0 → 6.0.0

package/dist/api/convertForRequestBody.d.ts

@@ -1,4 +1,4 @@
-import { iC6Object, iRestMethods, RequestQueryBody } from "./types/ormInterfaces";
+import { iC6Object, iRestMethods, RequestQueryBody } from "../types/ormInterfaces";
 export default function <RequestMethod extends iRestMethods, RestTableInterface extends {
     [key: string]: any;
 }, CustomAndRequiredFields extends {

package/dist/api/restOrm.d.ts

@@ -1,12 +1,12 @@
-import { OrmGenerics } from "./types/ormGenerics";
-import { iRest, iRestMethods } from "./types/ormInterfaces";
+import { OrmGenerics } from "../types/ormGenerics";
+import { iRest, iRestMethods } from "../types/ormInterfaces";
 type WithMethod<G extends Omit<OrmGenerics, "RequestMethod">, M extends iRestMethods> = Omit<G, "RequestMethod"> & {
     RequestMethod: M;
 };
 export declare function restOrm<G extends Omit<OrmGenerics, "RequestMethod">>(configFn: () => Omit<iRest<G['RestShortTableName'], G['RestTableInterface'], G['PrimaryKey']>, "requestMethod">): {
-    Get: (request: import("./types/ormInterfaces").RequestQueryBody<WithMethod<G, "GET">["RequestMethod"], WithMethod<G, "GET">["RestTableInterface"], WithMethod<G, "GET">["CustomAndRequiredFields"], WithMethod<G, "GET">["RequestTableOverrides"]>) => Promise<import("./types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "GET">["RequestMethod"], WithMethod<G, "GET">["RestTableInterface"], {}>>;
-    Put: (request: import("./types/ormInterfaces").RequestQueryBody<WithMethod<G, "PUT">["RequestMethod"], WithMethod<G, "PUT">["RestTableInterface"], WithMethod<G, "PUT">["CustomAndRequiredFields"], WithMethod<G, "PUT">["RequestTableOverrides"]>) => Promise<import("./types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "PUT">["RequestMethod"], WithMethod<G, "PUT">["RestTableInterface"], {}>>;
-    Post: (request: import("./types/ormInterfaces").RequestQueryBody<WithMethod<G, "POST">["RequestMethod"], WithMethod<G, "POST">["RestTableInterface"], WithMethod<G, "POST">["CustomAndRequiredFields"], WithMethod<G, "POST">["RequestTableOverrides"]>) => Promise<import("./types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "POST">["RequestMethod"], WithMethod<G, "POST">["RestTableInterface"], {}>>;
-    Delete: (request: import("./types/ormInterfaces").RequestQueryBody<WithMethod<G, "DELETE">["RequestMethod"], WithMethod<G, "DELETE">["RestTableInterface"], WithMethod<G, "DELETE">["CustomAndRequiredFields"], WithMethod<G, "DELETE">["RequestTableOverrides"]>) => Promise<import("./types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "DELETE">["RequestMethod"], WithMethod<G, "DELETE">["RestTableInterface"], {}>>;
+    Get: (request: import("../types/ormInterfaces").RequestQueryBody<WithMethod<G, "GET">["RequestMethod"], WithMethod<G, "GET">["RestTableInterface"], WithMethod<G, "GET">["CustomAndRequiredFields"], WithMethod<G, "GET">["RequestTableOverrides"]>) => Promise<import("../types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "GET">["RequestMethod"], WithMethod<G, "GET">["RestTableInterface"], {}>>;
+    Put: (request: import("../types/ormInterfaces").RequestQueryBody<WithMethod<G, "PUT">["RequestMethod"], WithMethod<G, "PUT">["RestTableInterface"], WithMethod<G, "PUT">["CustomAndRequiredFields"], WithMethod<G, "PUT">["RequestTableOverrides"]>) => Promise<import("../types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "PUT">["RequestMethod"], WithMethod<G, "PUT">["RestTableInterface"], {}>>;
+    Post: (request: import("../types/ormInterfaces").RequestQueryBody<WithMethod<G, "POST">["RequestMethod"], WithMethod<G, "POST">["RestTableInterface"], WithMethod<G, "POST">["CustomAndRequiredFields"], WithMethod<G, "POST">["RequestTableOverrides"]>) => Promise<import("../types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "POST">["RequestMethod"], WithMethod<G, "POST">["RestTableInterface"], {}>>;
+    Delete: (request: import("../types/ormInterfaces").RequestQueryBody<WithMethod<G, "DELETE">["RequestMethod"], WithMethod<G, "DELETE">["RestTableInterface"], WithMethod<G, "DELETE">["CustomAndRequiredFields"], WithMethod<G, "DELETE">["RequestTableOverrides"]>) => Promise<import("../types/ormInterfaces").DetermineResponseDataType<WithMethod<G, "DELETE">["RequestMethod"], WithMethod<G, "DELETE">["RestTableInterface"], {}>>;
 };
 export {};

package/dist/api/restRequest.d.ts

@@ -1,5 +1,5 @@
-import { OrmGenerics } from "./types/ormGenerics";
-import { DetermineResponseDataType, iRest, RequestQueryBody } from "./types/ormInterfaces";
+import { OrmGenerics } from "../types/ormGenerics";
+import { DetermineResponseDataType, iRest, RequestQueryBody } from "../types/ormInterfaces";
 /**
  * Facade: routes API calls to SQL or HTTP executors based on runtime context.
  */

package/dist/{api/executors → executors}/HttpExecutor.d.ts

@@ -1,5 +1,5 @@
-import { AxiosResponse } from "axios";
-import { OrmGenerics } from "../types/ormGenerics";
+import type { AxiosResponse } from "axios";
+import type { OrmGenerics } from "../types/ormGenerics";
 import { DetermineResponseDataType, RequestQueryBody } from "../types/ormInterfaces";
 import { Executor } from "./Executor";
 export declare class HttpExecutor<G extends OrmGenerics> extends Executor<G> {

package/dist/{api/handlers → handlers}/ExpressHandler.d.ts

@@ -1,6 +1,6 @@
-import { Request, Response, NextFunction } from "express";
-import { Pool } from "mysql2/promise";
-import { iC6Object } from "../types/ormInterfaces";
+import type { Request, Response, NextFunction } from "express";
+import type { Pool } from "mysql2/promise";
+import type { iC6Object } from "../types/ormInterfaces";
 export declare function ExpressHandler({ C6, mysqlPool, sqlAllowListPath, }: {
     C6: iC6Object;
     mysqlPool: Pool;

package/dist/index.cjs.js

@@ -3,11 +3,157 @@
 var axios = require('axios');
 var Qs = require('qs');
 var tslib = require('tslib');
-var reactToastify = require('react-toastify');
 var namedPlaceholders = require('named-placeholders');
 var buffer = require('buffer');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// @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
+//
+// only affects the global instance and instances created afterwards
+// axios.defaults.headers.common['Auth-Token'] = 'foo bar';
+//
+// immediately affects this instance
+// axiosInstance.defaults.headers['Auth-Token'] = 'foo bar';
+var axiosInstance = (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.
+    baseURL: '',
+    /**
+     * These headers are important to C6.
+     * XMLHttpRequest - is a standard header all jquery ajax requests send by default. This allows our php side to return
+     *                  nothing while running the get_header() and get_footer() functions with (bool) DropVariables::$ajax;
+     *
+     * application/json - is for the error catcher in php; this header will cause a JSON response instead of the default HTML
+     */
+    headers: {
+        crossDomain: true,
+        'Access-Control-Allow-Credentials': true,
+        'X-Requested-With': 'XMLHttpRequest',
+        'Content-Type': 'application/json',
+    },
+    // `paramsSerializer` is an optional function in charge of serializing `params`
+    // (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 carbonNodeQsStringify(params);
+    },
+    // `data` is the data to be sent as the request body
+    // Only applicable for request methods 'PUT', 'POST', and 'PATCH'
+    // When no `transformRequest` is set, must be of one of the following types:
+    // - string, plain object, ArrayBuffer, ArrayBufferView, URLSearchParams
+    // - Browser only: FormData, File, Blob
+    // - Node only: Stream, Buffer
+    // data should be default to empty for get request to serialize correctly
+    data: {}, // do not change
+    // `timeout` specifies the number of milliseconds before the request times out.
+    // If the request takes longer than `timeout`, the request will be aborted.
+    // Default is 1000 - lets increase this for large request which we are favored for
+    timeout: 120000, // shit fails
+    // `withCredentials` indicates weather cross-site Access-Control requests
+    // should be made using credentials
+    withCredentials: true,
+    // `adapter` allows custom handling of requests which makes testing easier.
+    // Return a promise and supply a valid response (see lib/adapters/README.md).
+    // adapter: cache.adapter,
+    // `auth` indicates that HTTP Basic auth should be used, and supplies credentials.
+    // This will set an `Authorization` header, overwriting any existing
+    // `Authorization` custom headers you have set using `headers`.
+    /*
+    auth: {
+        username: 'janedoe',
+        password: 's00pers3cret'
+    },
+    */
+    // `responseType` indicates the type of data that the server will respond with
+    // options are 'arraybuffer', 'blob', 'document', 'json', 'text', 'stream'
+    // responseType: 'json', // default
+    // `responseEncoding` indicates encoding to use for decoding responses
+    // Note: Ignored for `responseType` of 'stream' or client-side requests
+    // `xsrfCookieName` is the name of the cookie to use as a value for xsrf token
+    //xsrfCookieName: 'XSRF-TOKEN', // default
+    // `xsrfHeaderName` is the name of the http header that carries the xsrf token value
+    //xsrfHeaderName: 'X-XSRF-TOKEN', // default
+    // `onUploadProgress` allows handling of progress events for uploads
+    onUploadProgress: function () {
+        // Do whatever you want with the native progress event
+    },
+    // `onDownloadProgress` allows handling of progress events for downloads
+    onDownloadProgress: function () {
+        // Do whatever you want with the native progress event
+    },
+    // `maxContentLength` defines the max size of the http response content in bytes allowed
+    /*maxContentLength: 2000,*/
+    // `validateStatus` defines whether to resolve or reject the promise for a given
+    // HTTP response status code. If `validateStatus` returns `true` (or is set to `null`
+    // or `undefined`), the promise will be resolved; otherwise, the promise will be
+    // rejected.
+    /* validateStatus: function (status) {
+         return status >= 200 && status < 300;
+     },*/
+    // `maxRedirects` defines the maximum number of redirects to follow in node.js.
+    // If set to 0, no redirects will be followed.
+    maxRedirects: 2, // default
+    // `socketPath` defines a UNIX Socket to be used in node.js.
+    // e.g. '/var/run/docker.sock' to send requests to the docker daemon.
+    // Only either `socketPath` or `proxy` can be specified.
+    // If both are specified, `socketPath` is used.
+    socketPath: null, // default
+    // `httpAgent` and `httpsAgent` define a custom agent to be used when performing http
+    // and https requests, respectively, in node.js. This allows options to be added like
+    // `keepAlive` that are not enabled by default.
+    /*
+    httpAgent: new http.Agent({ keepAlive: true }),
+    httpsAgent: new https.Agent({ keepAlive: true }),
+    */
+}));
+axiosInstance.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
+            };
+        }
+    }
+    config.__carbonStart = performance.now();
+    return config;
+});
+axiosInstance.interceptors.response.use(function (response) {
+    var end = performance.now();
+    var start = response.config.__carbonStart;
+    response.__carbonTiming = {
+        start: start,
+        end: end,
+        duration: end - start,
+    };
+    return response;
+}, function (error) {
+    if (error.config) {
+        var end = performance.now();
+        var start = error.config.__carbonStart;
+        error.__carbonTiming = {
+            start: start,
+            end: end,
+            duration: end - start,
+        };
+    }
+    throw error;
+});
+
 var C6Constants = {
     // try to 1=1 match the Rest abstract class
     ADDDATE: 'ADDDATE',
@@ -185,153 +331,6 @@ 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
-//
-// only affects the global instance and instances created afterwards
-// axios.defaults.headers.common['Auth-Token'] = 'foo bar';
-//
-// immediately affects this instance
-// axiosInstance.defaults.headers['Auth-Token'] = 'foo bar';
-var axiosInstance = (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.
-    baseURL: '',
-    /**
-     * These headers are important to C6.
-     * XMLHttpRequest - is a standard header all jquery ajax requests send by default. This allows our php side to return
-     *                  nothing while running the get_header() and get_footer() functions with (bool) DropVariables::$ajax;
-     *
-     * application/json - is for the error catcher in php; this header will cause a JSON response instead of the default HTML
-     */
-    headers: {
-        crossDomain: true,
-        'Access-Control-Allow-Credentials': true,
-        'X-Requested-With': 'XMLHttpRequest',
-        'Content-Type': 'application/json',
-    },
-    // `paramsSerializer` is an optional function in charge of serializing `params`
-    // (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 carbonNodeQsStringify(params);
-    },
-    // `data` is the data to be sent as the request body
-    // Only applicable for request methods 'PUT', 'POST', and 'PATCH'
-    // When no `transformRequest` is set, must be of one of the following types:
-    // - string, plain object, ArrayBuffer, ArrayBufferView, URLSearchParams
-    // - Browser only: FormData, File, Blob
-    // - Node only: Stream, Buffer
-    // data should be default to empty for get request to serialize correctly
-    data: {}, // do not change
-    // `timeout` specifies the number of milliseconds before the request times out.
-    // If the request takes longer than `timeout`, the request will be aborted.
-    // Default is 1000 - lets increase this for large request which we are favored for
-    timeout: 120000, // shit fails
-    // `withCredentials` indicates weather cross-site Access-Control requests
-    // should be made using credentials
-    withCredentials: true,
-    // `adapter` allows custom handling of requests which makes testing easier.
-    // Return a promise and supply a valid response (see lib/adapters/README.md).
-    // adapter: cache.adapter,
-    // `auth` indicates that HTTP Basic auth should be used, and supplies credentials.
-    // This will set an `Authorization` header, overwriting any existing
-    // `Authorization` custom headers you have set using `headers`.
-    /*
-    auth: {
-        username: 'janedoe',
-        password: 's00pers3cret'
-    },
-    */
-    // `responseType` indicates the type of data that the server will respond with
-    // options are 'arraybuffer', 'blob', 'document', 'json', 'text', 'stream'
-    // responseType: 'json', // default
-    // `responseEncoding` indicates encoding to use for decoding responses
-    // Note: Ignored for `responseType` of 'stream' or client-side requests
-    // `xsrfCookieName` is the name of the cookie to use as a value for xsrf token
-    //xsrfCookieName: 'XSRF-TOKEN', // default
-    // `xsrfHeaderName` is the name of the http header that carries the xsrf token value
-    //xsrfHeaderName: 'X-XSRF-TOKEN', // default
-    // `onUploadProgress` allows handling of progress events for uploads
-    onUploadProgress: function () {
-        // Do whatever you want with the native progress event
-    },
-    // `onDownloadProgress` allows handling of progress events for downloads
-    onDownloadProgress: function () {
-        // Do whatever you want with the native progress event
-    },
-    // `maxContentLength` defines the max size of the http response content in bytes allowed
-    /*maxContentLength: 2000,*/
-    // `validateStatus` defines whether to resolve or reject the promise for a given
-    // HTTP response status code. If `validateStatus` returns `true` (or is set to `null`
-    // or `undefined`), the promise will be resolved; otherwise, the promise will be
-    // rejected.
-    /* validateStatus: function (status) {
-         return status >= 200 && status < 300;
-     },*/
-    // `maxRedirects` defines the maximum number of redirects to follow in node.js.
-    // If set to 0, no redirects will be followed.
-    maxRedirects: 2, // default
-    // `socketPath` defines a UNIX Socket to be used in node.js.
-    // e.g. '/var/run/docker.sock' to send requests to the docker daemon.
-    // Only either `socketPath` or `proxy` can be specified.
-    // If both are specified, `socketPath` is used.
-    socketPath: null, // default
-    // `httpAgent` and `httpsAgent` define a custom agent to be used when performing http
-    // and https requests, respectively, in node.js. This allows options to be added like
-    // `keepAlive` that are not enabled by default.
-    /*
-    httpAgent: new http.Agent({ keepAlive: true }),
-    httpsAgent: new https.Agent({ keepAlive: true }),
-    */
-}));
-axiosInstance.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
-            };
-        }
-    }
-    config.__carbonStart = performance.now();
-    return config;
-});
-axiosInstance.interceptors.response.use(function (response) {
-    var end = performance.now();
-    var start = response.config.__carbonStart;
-    response.__carbonTiming = {
-        start: start,
-        end: end,
-        duration: end - start,
-    };
-    return response;
-}, function (error) {
-    if (error.config) {
-        var end = performance.now();
-        var start = error.config.__carbonStart;
-        error.__carbonTiming = {
-            start: start,
-            end: end,
-            duration: end - start,
-        };
-    }
-    throw error;
-});
-
 function convertForRequestBody (restfulObject, tableName, C6, regexErrorHandler) {
     if (regexErrorHandler === void 0) { regexErrorHandler = alert; }
     var payload = {};
@@ -605,6 +604,14 @@ var toastOptionsDevs = {
     theme: "dark",
 };
 
+var toastHandler = null;
+var setToastHandler = function (handler) {
+    toastHandler = handler;
+};
+var notifyToast = function (level, message, options) {
+    toastHandler === null || toastHandler === void 0 ? void 0 : toastHandler(level, message, options);
+};
+
 // When we capture DropExceptions and display them as a custom page, this will change.
 function TestRestfulResponse(response, success, error) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -615,14 +622,14 @@ function TestRestfulResponse(response, success, error) {
             || undefined !== ((_e = response.data) === null || _e === void 0 ? void 0 : _e.deleted))) {
         var successReturn = 'function' === typeof success ? success === null || success === void 0 ? void 0 : success(response) : success;
         if (typeof successReturn === 'string') {
-            reactToastify.toast.success(successReturn, toastOptions);
+            notifyToast("success", successReturn, toastOptions);
         }
         // this could end up with bad results for deleting id's === 0
         return (_h = (_g = (_f = response.data.created) !== null && _f !== void 0 ? _f : response.data.updated) !== null && _g !== void 0 ? _g : response.data.deleted) !== null && _h !== void 0 ? _h : true;
     }
     var errorReturn = 'function' === typeof error ? error === null || error === void 0 ? void 0 : error(response) : error;
     if (typeof errorReturn === 'string') {
-        reactToastify.toast.error(errorReturn, toastOptions);
+        notifyToast("error", errorReturn, toastOptions);
     }
     return false;
 }
@@ -874,10 +881,10 @@ var HttpExecutor = /** @class */ (function (_super) {
                                             cachingConfirmed = true;
                                         }
                                         else if (debug && isLocal()) {
-                                            reactToastify.toast.info("DEVS: Ignore cache was set to true.", toastOptionsDevs);
+                                            notifyToast("info", "DEVS: Ignore cache was set to true.", toastOptionsDevs);
                                         }
                                         if (cacheResults && debug && isLocal()) {
-                                            reactToastify.toast.success("DEVS: Request not in cache." + (requestMethod === C6.GET ? " Page (" + query[C6.PAGINATION][C6.PAGE] + ")" : ''), toastOptionsDevs);
+                                            notifyToast("success", "DEVS: Request not in cache." + (requestMethod === C6.GET ? " Page (" + query[C6.PAGINATION][C6.PAGE] + ")" : ''), toastOptionsDevs);
                                         }
                                         restRequestUri = restURL + operatingTable + '/';
                                         needsConditionOrPrimaryCheck = (PUT === requestMethod || DELETE === requestMethod)
@@ -902,13 +909,13 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                     || null === query
                                                     || (!(primaryKey in query) && !(primaryKeyFullyQualified && primaryKeyFullyQualified in query))) {
                                                     if (true === debug && isLocal()) {
-                                                        reactToastify.toast.error('DEVS: The primary key (' + primaryKey + ') was not provided!!');
+                                                        notifyToast("error", "DEVS: The primary key (".concat(primaryKey, ") was not provided!!"));
                                                     }
                                                     throw Error('You must provide the primary key (' + primaryKey + ') for table (' + operatingTable + '). Request (' + JSON.stringify(this.request, undefined, 4) + ') Query (' + JSON.stringify(query) + ')');
                                                 }
                                                 providedPrimary = (_k = query === null || query === void 0 ? void 0 : query[primaryKey]) !== null && _k !== void 0 ? _k : (primaryKeyFullyQualified ? query === null || query === void 0 ? void 0 : query[primaryKeyFullyQualified] : undefined);
                                                 if (undefined === providedPrimary || null === providedPrimary) {
-                                                    reactToastify.toast.error('The primary key (' + primaryKey + ') provided is undefined or null explicitly!!');
+                                                    notifyToast("error", "The primary key (".concat(primaryKey, ") provided is undefined or null explicitly!!"));
                                                     throw Error('The primary key (' + primaryKey + ') provided in the request was exactly equal to undefined.');
                                                 }
                                             }
@@ -950,7 +957,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                             });
                                             axiosActiveRequest_1 = (_e = axios)[requestMethod.toLowerCase()].apply(_e, tslib.__spreadArray([restRequestUri], (function () {
                                                 var convert = function (data) {
-                                                    return convertForRequestBody(data, fullTableList, C6, function (message) { return reactToastify.toast.error(message, toastOptions); });
+                                                    return convertForRequestBody(data, fullTableList, C6, function (message) { return notifyToast("error", message, toastOptions); });
                                                 };
                                                 var baseConfig = {
                                                     withCredentials: withCredentials,
@@ -1020,7 +1027,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                 apiResponse = TestRestfulResponse(response, success, error);
                                                                 if (false === apiResponse) {
                                                                     if (debug && isLocal()) {
-                                                                        reactToastify.toast.warning("DEVS: TestRestfulResponse returned false.", toastOptionsDevs);
+                                                                        notifyToast("warning", "DEVS: TestRestfulResponse returned false.", toastOptionsDevs);
                                                                     }
                                                                     // Force a null payload so the final .then(response => response.data) yields null
                                                                     return [2 /*return*/, Promise.resolve(tslib.__assign(tslib.__assign({}, response), { data: null }))];
@@ -1254,7 +1261,7 @@ var HttpExecutor = /** @class */ (function (_super) {
                                                                     });
                                                                 }
                                                                 if (debug && isLocal()) {
-                                                                    reactToastify.toast.success("DEVS: (" + requestMethod + ") request complete.", toastOptionsDevs);
+                                                                    notifyToast("success", "DEVS: (".concat(requestMethod, ") request complete."), toastOptionsDevs);
                                                                 }
                                                                 // this is the literal axios return
                                                                 return [2 /*return*/, response];
@@ -3019,6 +3026,63 @@ var loadSqlAllowList = function (allowListPath) { return tslib.__awaiter(void 0,
         }
     });
 }); };
+var extractSqlEntries = function (payload) {
+    if (typeof payload === "string") {
+        return [payload];
+    }
+    if (Array.isArray(payload)) {
+        return payload.flatMap(extractSqlEntries);
+    }
+    if (!payload || typeof payload !== "object") {
+        return [];
+    }
+    var sqlValue = payload.sql;
+    if (typeof sqlValue === "string") {
+        return [sqlValue];
+    }
+    if (sqlValue && typeof sqlValue === "object") {
+        var nested = sqlValue.sql;
+        if (typeof nested === "string") {
+            return [nested];
+        }
+    }
+    return [];
+};
+var collectSqlAllowListEntries = function (payload, entries) {
+    if (entries === void 0) { entries = new Set(); }
+    var sqlEntries = extractSqlEntries(payload)
+        .map(normalizeSql)
+        .filter(function (entry) { return entry.length > 0; });
+    sqlEntries.forEach(function (entry) { return entries.add(entry); });
+    return entries;
+};
+var compileSqlAllowList = function (allowListPath, entries) { return tslib.__awaiter(void 0, void 0, void 0, function () {
+    var _a, writeFile, mkdir, path, compiled;
+    return tslib.__generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                if (!isNode()) {
+                    throw new Error("SQL allowlist compilation requires a Node runtime.");
+                }
+                return [4 /*yield*/, import('node:fs/promises')];
+            case 1:
+                _a = _b.sent(), writeFile = _a.writeFile, mkdir = _a.mkdir;
+                return [4 /*yield*/, import('node:path')];
+            case 2:
+                path = _b.sent();
+                return [4 /*yield*/, mkdir(path.dirname(allowListPath), { recursive: true })];
+            case 3:
+                _b.sent();
+                compiled = Array.from(new Set(Array.from(entries)
+                    .map(normalizeSql)
+                    .filter(function (entry) { return entry.length > 0; }))).sort();
+                return [4 /*yield*/, writeFile(allowListPath, JSON.stringify(compiled, null, 2))];
+            case 4:
+                _b.sent();
+                return [2 /*return*/, compiled];
+        }
+    });
+}); };
 
 var SqlExecutor = /** @class */ (function (_super) {
     tslib.__extends(SqlExecutor, _super);
@@ -3565,7 +3629,7 @@ function checkAllRequestsComplete() {
     var cacheEntries = Array.from(apiRequestCache.values());
     var stillRunning = cacheEntries.filter(function (cache) { return undefined === cache.response; });
     if (stillRunning.length !== 0) {
-        if (document === null || document === undefined) {
+        if (typeof document === "undefined" || document === null) {
             throw new Error('document is undefined while waiting for API requests to complete (' + JSON.stringify(cacheEntries) + ')');
         }
         // when requests return emtpy sets in full renders, it may not be possible to track their progress.
@@ -3576,10 +3640,10 @@ function checkAllRequestsComplete() {
 }
 
 function onSuccess(message) {
-    reactToastify.toast.success(message, isLocal() ? toastOptionsDevs : toastOptions);
+    notifyToast("success", message, isLocal() ? toastOptionsDevs : toastOptions);
 }
 function onError(message) {
-    reactToastify.toast.error(message, isLocal() ? toastOptionsDevs : toastOptions);
+    notifyToast("error", message, isLocal() ? toastOptionsDevs : toastOptions);
 }
 
 function isVerbose () {
@@ -3615,12 +3679,15 @@ exports.carbonNodeQsStringify = carbonNodeQsStringify;
 exports.checkAllRequestsComplete = checkAllRequestsComplete;
 exports.checkCache = checkCache;
 exports.clearCache = clearCache;
+exports.collectSqlAllowListEntries = collectSqlAllowListEntries;
+exports.compileSqlAllowList = compileSqlAllowList;
 exports.convertForRequestBody = convertForRequestBody;
 exports.convertHexIfBinary = convertHexIfBinary;
 exports.derivedTable = derivedTable;
 exports.determineRuntimeJsType = determineRuntimeJsType;
 exports.distSphere = distSphere;
 exports.error = error;
+exports.extractSqlEntries = extractSqlEntries;
 exports.fieldEq = fieldEq;
 exports.getEnvVar = getEnvVar;
 exports.getPrimaryKeyTypes = getPrimaryKeyTypes;
@@ -3634,6 +3701,7 @@ exports.isVerbose = isVerbose;
 exports.loadSqlAllowList = loadSqlAllowList;
 exports.normalizeSingularRequest = normalizeSingularRequest;
 exports.normalizeSql = normalizeSql;
+exports.notifyToast = notifyToast;
 exports.onError = onError;
 exports.onSuccess = onSuccess;
 exports.removeInvalidKeys = removeInvalidKeys;
@@ -3642,6 +3710,7 @@ exports.resolveDerivedTable = resolveDerivedTable;
 exports.restOrm = restOrm;
 exports.restRequest = restRequest;
 exports.setCache = setCache;
+exports.setToastHandler = setToastHandler;
 exports.sortAndSerializeQueryObject = sortAndSerializeQueryObject;
 exports.stContains = stContains;
 exports.timeout = timeout;