dce-expresskit 4.0.0-beta-logreviewer.1

package/lib/helpers/visitEndpointOnAnotherServer/sendServerToServerRequest.js

@@ -0,0 +1,236 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import libs
+var qs_1 = __importDefault(require("qs"));
+// Import dce-reactkit
+var dce_reactkit_1 = require("dce-reactkit");
+// Import data signer
+var dataSigner_1 = require("../dataSigner");
+// Import shared types
+var ExpressKitErrorCode_1 = __importDefault(require("../../types/ExpressKitErrorCode"));
+/*------------------------------------------------------------------------*/
+/* ----------------------------- Credentials ---------------------------- */
+/*------------------------------------------------------------------------*/
+/*
+DCEKIT_CROSS_SERVER_CREDENTIALS format:
+|host:key:secret||host:key:secret|...
+*/
+var credentials = (((_a = process.env.DCEKIT_CROSS_SERVER_CREDENTIALS) !== null && _a !== void 0 ? _a : '')
+    // Replace multiple | with a single one
+    .replace(/\|+/g, '|')
+    // Split by |
+    .split('|')
+    // Remove empty strings
+    .filter(function (str) {
+    return str.trim().length > 0;
+})
+    // Process each credential
+    .map(function (str) {
+    // Split by :
+    var parts = str.split(':');
+    // Check for errors
+    if (parts.length !== 3) {
+        throw new dce_reactkit_1.ErrorWithCode('Invalid DCEKIT_CROSS_SERVER_CREDENTIALS format. Each credential must be in the format |host:key:secret|', ExpressKitErrorCode_1.default.InvalidCrossServerCredentialsFormat);
+    }
+    // Return the credential
+    return {
+        host: parts[0].trim(),
+        key: parts[1].trim(),
+        secret: parts[2].trim(),
+    };
+}));
+/*------------------------------------------------------------------------*/
+/* ------------------------------- Helpers ------------------------------ */
+/*------------------------------------------------------------------------*/
+/**
+ * Get the credential to use for the request to another server
+ * @author Gabe Abrams
+ * @param host the host of the other server
+ * @return the credential to use
+ */
+var getCrossServerCredential = function (host) {
+    // Find the credential
+    var credential = credentials.find(function (cred) {
+        return cred.host.toLowerCase() === host.toLowerCase();
+    });
+    if (!credential) {
+        throw new dce_reactkit_1.ErrorWithCode('Cannot send cross-server signed request there was no credential that matched the host that the request is being sent to.', ExpressKitErrorCode_1.default.CrossServerNoCredentialsToSignWith);
+    }
+    // Return credential
+    return credential;
+};
+/*------------------------------------------------------------------------*/
+/* -------------------------------- Main -------------------------------- */
+/*------------------------------------------------------------------------*/
+/**
+ * Sends and retries an http request
+ * @author Gabriel Abrams
+ * @param opts object containing all arguments
+ * @param opts.path path to send request to
+ * @param [opts.host] host to send request to
+ * @param [opts.method=GET] http method to use
+ * @param [opts.params] body/data to include in the request
+ * @param [opts.responseType=JSON] expected response type
+ * @returns { body, status, headers } on success
+ */
+var sendServerToServerRequest = function (opts) { return __awaiter(void 0, void 0, void 0, function () {
+    var method, params, credential, stringifiedParams, query, url, headers, data, encodedData, response, responseHeaders_1, responseBody, err_1, err_2;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                method = (opts.method || 'GET');
+                if (opts.params) {
+                    params = {};
+                    Object.entries(opts.params).forEach(function (_a) {
+                        var key = _a[0], val = _a[1];
+                        if (typeof val === 'object' && !Array.isArray(val)) {
+                            params[key] = JSON.stringify(val);
+                        }
+                        else {
+                            params[key] = val;
+                        }
+                    });
+                }
+                credential = getCrossServerCredential(opts.host);
+                return [4 /*yield*/, (0, dataSigner_1.signRequest)({
+                        method: opts.method,
+                        path: opts.path,
+                        params: params !== null && params !== void 0 ? params : {},
+                        key: credential.key,
+                        secret: credential.secret,
+                    })];
+            case 1:
+                // Sign the request, get new params
+                params = _b.sent();
+                stringifiedParams = qs_1.default.stringify(params || {}, {
+                    encodeValuesOnly: true,
+                    arrayFormat: 'brackets',
+                });
+                query = (method === 'GET' ? "?".concat(stringifiedParams) : '');
+                if (!opts.host) {
+                    // No host included at all. Just send to a path
+                    url = "".concat(opts.path).concat(query);
+                }
+                else {
+                    url = "https://".concat(opts.host).concat(opts.path).concat(query);
+                }
+                headers = {};
+                data = null;
+                if (!headers['Content-Type']) {
+                    // Form encoded
+                    headers['Content-Type'] = 'application/x-www-form-urlencoded';
+                    // Add data if applicable
+                    data = (method !== 'GET' ? stringifiedParams : null);
+                }
+                else {
+                    // JSON encode
+                    data = params;
+                }
+                if (data) {
+                    if (headers['Content-Type'] === 'application/x-www-form-urlencoded') {
+                        encodedData = new URLSearchParams(params);
+                    }
+                    else {
+                        encodedData = JSON.stringify(data);
+                    }
+                }
+                _b.label = 2;
+            case 2:
+                _b.trys.push([2, 11, , 12]);
+                return [4 /*yield*/, fetch(url, {
+                        method: method,
+                        mode: 'cors',
+                        headers: headers !== null && headers !== void 0 ? headers : {},
+                        body: ((method !== 'GET' && encodedData)
+                            ? encodedData
+                            : undefined),
+                        redirect: 'follow',
+                    })];
+            case 3:
+                response = _b.sent();
+                responseHeaders_1 = {};
+                response.headers.forEach(function (value, key) {
+                    responseHeaders_1[key] = value;
+                });
+                _b.label = 4;
+            case 4:
+                _b.trys.push([4, 9, , 10]);
+                responseBody = void 0;
+                if (!(opts.responseType
+                    && opts.responseType === 'Text')) return [3 /*break*/, 6];
+                return [4 /*yield*/, response.text()];
+            case 5:
+                // Response type is text
+                responseBody = _b.sent();
+                return [3 /*break*/, 8];
+            case 6: return [4 /*yield*/, response.json()];
+            case 7:
+                // Response type is JSON
+                responseBody = _b.sent();
+                _b.label = 8;
+            case 8: 
+            // Return response
+            return [2 /*return*/, {
+                    body: responseBody,
+                    status: response.status,
+                    headers: responseHeaders_1,
+                }];
+            case 9:
+                err_1 = _b.sent();
+                throw new dce_reactkit_1.ErrorWithCode("Failed to parse response as ".concat(opts.responseType, ": ").concat(err_1 === null || err_1 === void 0 ? void 0 : err_1.message), ExpressKitErrorCode_1.default.ResponseParseError);
+            case 10: return [3 /*break*/, 12];
+            case 11:
+                err_2 = _b.sent();
+                // Self-signed certificate error:
+                if ((_a = err_2 === null || err_2 === void 0 ? void 0 : err_2.message) === null || _a === void 0 ? void 0 : _a.includes('self signed certificate')) {
+                    throw new dce_reactkit_1.ErrorWithCode('We refused to send a request because the receiver has self-signed certificates.', ExpressKitErrorCode_1.default.SelfSigned);
+                }
+                // No tries left
+                throw new dce_reactkit_1.ErrorWithCode("We encountered an error when trying to send a network request. If this issue persists, contact an admin. Error: ".concat(err_2 === null || err_2 === void 0 ? void 0 : err_2.message), ExpressKitErrorCode_1.default.NotConnected);
+            case 12: return [2 /*return*/];
+        }
+    });
+}); };
+exports.default = sendServerToServerRequest;
+//# sourceMappingURL=sendServerToServerRequest.js.map

package/lib/helpers/visitEndpointOnAnotherServer/sendServerToServerRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendServerToServerRequest.js","sourceRoot":"","sources":["../../../src/helpers/visitEndpointOnAnotherServer/sendServerToServerRequest.ts"],"names":[],"mappings":"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"}

package/lib/html/genErrorPage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate a static error page
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param [opts.title=An Error Occurred] title of the error box
+ * @param [opts.description=An unknown server error occurred. Please contact support.]
+ *   a human-readable description of the error
+ * @param [opts.code=ReactKitErrorCode.NoCode] error code to show
+ * @param [opts.pageTitle=opts.title] title of the page/tab if it differs from
+ *   the title of the error
+ * @returns html of the page
+ */
+declare const genErrorPage: (opts?: {
+    title?: string;
+    description?: string;
+    code?: string;
+    pageTitle?: string;
+}) => string;
+export default genErrorPage;

package/lib/html/genErrorPage.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import dce-reactkit
+var dce_reactkit_1 = require("dce-reactkit");
+/**
+ * Generate a static error page
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param [opts.title=An Error Occurred] title of the error box
+ * @param [opts.description=An unknown server error occurred. Please contact support.]
+ *   a human-readable description of the error
+ * @param [opts.code=ReactKitErrorCode.NoCode] error code to show
+ * @param [opts.pageTitle=opts.title] title of the page/tab if it differs from
+ *   the title of the error
+ * @returns html of the page
+ */
+var genErrorPage = function (opts) {
+    var _a, _b, _c, _d;
+    if (opts === void 0) { opts = {}; }
+    var title = ((_a = opts.title) !== null && _a !== void 0 ? _a : 'An Error Occurred');
+    var pageTitle = ((_b = opts.pageTitle) !== null && _b !== void 0 ? _b : title);
+    var description = ((_c = opts.description) !== null && _c !== void 0 ? _c : 'An unknown server error occurred. Please contact support.');
+    var code = ((_d = opts.code) !== null && _d !== void 0 ? _d : dce_reactkit_1.ReactKitErrorCode.NoCode);
+    return "\n<head>\n  <!-- Metadata -->\n  <meta\n    name=\"viewport\"\n    content=\"width=device-width, height=device-height, initial-scale=1.0, minimum-scale=1.0\"\n  >\n\n  <!-- Title -->\n  <title>".concat(pageTitle, "</title>\n\n  <!-- Bootstrap -->\n  <link\n    rel=\"stylesheet\"\n    href=\"https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.2.1/css/bootstrap.min.css\"\n    integrity=\"sha512-siwe/oXMhSjGCwLn+scraPOWrJxHlUgMBMZXdPe2Tnk3I0x3ESCoLz7WZ5NTH6SZrywMY+PB1cjyqJ5jAluCOg==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  />\n  <script\n    src=\"https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.2.1/js/bootstrap.min.js\"\n    integrity=\"sha512-vyRAVI0IEm6LI/fVSv/Wq/d0KUfrg3hJq2Qz5FlfER69sf3ZHlOrsLriNm49FxnpUGmhx+TaJKwJ+ByTLKT+Yg==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  ></script>\n\n  <!-- FontAwesome -->\n  <link\n    rel=\"stylesheet\"\n    href=\"https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.2.0/css/all.min.css\"\n    integrity=\"sha512-xh6O/CkQoPOWDdYTDqeRdPCVd1SpvCA9XXcUnZS2FmJNp1coAFzvtCN9BmamE+4aHK8yyUHUSCcJHgXloTyT2A==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  />\n\n  <!-- Style -->\n  <style>\n    .DCEReactKit-pop-in {\n      animation-name: DCEReactKit-pop-in;\n      animation-duration: 0.5s;\n      animation-iteration-count: 1;\n      animation-timing-function: ease-out;\n      animation-fill-mode: both;\n\n      transform-origin: center;\n    }\n\n    @keyframes DCEReactKit-pop-in {\n      0% {\n        opacity: 0;\n        transform: scale(0.9);\n      }\n      100% {\n        opacity: 1;\n        transform: scale(1);\n      }\n    }\n\n    .DCEReactKit-slide-in {\n      animation-name: DCEReactKit-slide-in;\n      animation-duration: 1s;\n      animation-iteration-count: 1;\n      animation-timing-function: ease-out;\n      animation-fill-mode: both;\n      animation-delay: 0.2s;\n    }\n\n    @keyframes DCEReactKit-slide-in {\n      0% {\n        opacity: 0;\n        transform: translate(0, 0.3em);\n      }\n      100% {\n        opacity: 1;\n        transform: translate(0, 0);\n      }\n    }\n  </style>\n</head>\n\n<!-- Body -->\n<body class=\"bg-dark text-center pt-3 ps-3 pe-3\">\n  <!-- Alert -->\n  <div\n    class=\"DCEReactKit-pop-in alert alert-warning d-inline-block\"\n    style=\"width: 50em; max-width: 100%\"\n  >\n    <!-- Title -->\n    <h2>\n      <i class=\"me-1 fa-solid fa-triangle-exclamation\"></i>\n      ").concat(title, "\n    </h2>\n    <!-- Description -->\n    <div>\n      ").concat(description, "\n    </div>\n  </div>\n\n  <!-- Error Code -->\n  <div class=\"DCEReactKit-slide-in text-light\">\n    <strong>\n      Error Code:\n    </strong>\n    ").concat(code, "\n  </div>\n</body>\n  ");
+};
+exports.default = genErrorPage;
+//# sourceMappingURL=genErrorPage.js.map

package/lib/html/genErrorPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genErrorPage.js","sourceRoot":"","sources":["../../src/html/genErrorPage.ts"],"names":[],"mappings":";;AAAA,sBAAsB;AACtB,6CAAiD;AAKjD;;;;;;;;;;;GAWG;AACH,IAAM,YAAY,GAAG,UACnB,IAKM;;IALN,qBAAA,EAAA,SAKM;IAEN,IAAM,KAAK,GAAG,CAAC,MAAA,IAAI,CAAC,KAAK,mCAAI,mBAAmB,CAAC,CAAC;IAClD,IAAM,SAAS,GAAG,CAAC,MAAA,IAAI,CAAC,SAAS,mCAAI,KAAK,CAAC,CAAC;IAC5C,IAAM,WAAW,GAAG,CAClB,MAAA,IAAI,CAAC,WAAW,mCACb,2DAA2D,CAC/D,CAAC;IACF,IAAM,IAAI,GAAG,CAAC,MAAA,IAAI,CAAC,IAAI,mCAAI,gCAAiB,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,2MASE,SAAS,uuEAiFZ,KAAK,qEAIL,WAAW,qKASb,IAAI,4BAGP,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,YAAY,CAAC"}

package/lib/html/genInfoPage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate a static info page
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param opts.title title of the info box
+ * @param opts.body a human-readable text body for the info alert
+ * @returns the HTML for the info page
+ */
+declare const genInfoPage: (opts: {
+    title: string;
+    body: string;
+}) => string;
+export default genInfoPage;

package/lib/html/genInfoPage.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Generate a static info page
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param opts.title title of the info box
+ * @param opts.body a human-readable text body for the info alert
+ * @returns the HTML for the info page
+ */
+var genInfoPage = function (opts) {
+    var title = opts.title, body = opts.body;
+    return "\n<head>\n  <!-- Metadata -->\n  <meta\n    name=\"viewport\"\n    content=\"width=device-width, height=device-height, initial-scale=1.0, minimum-scale=1.0\"\n  >\n\n  <!-- Title -->\n  <title>".concat(title, "</title>\n\n  <!-- Bootstrap -->\n  <link\n    rel=\"stylesheet\"\n    href=\"https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.2.1/css/bootstrap.min.css\"\n    integrity=\"sha512-siwe/oXMhSjGCwLn+scraPOWrJxHlUgMBMZXdPe2Tnk3I0x3ESCoLz7WZ5NTH6SZrywMY+PB1cjyqJ5jAluCOg==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  />\n  <script\n    src=\"https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.2.1/js/bootstrap.min.js\"\n    integrity=\"sha512-vyRAVI0IEm6LI/fVSv/Wq/d0KUfrg3hJq2Qz5FlfER69sf3ZHlOrsLriNm49FxnpUGmhx+TaJKwJ+ByTLKT+Yg==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  ></script>\n\n  <!-- FontAwesome -->\n  <link\n    rel=\"stylesheet\"\n    href=\"https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.2.0/css/all.min.css\"\n    integrity=\"sha512-xh6O/CkQoPOWDdYTDqeRdPCVd1SpvCA9XXcUnZS2FmJNp1coAFzvtCN9BmamE+4aHK8yyUHUSCcJHgXloTyT2A==\"\n    crossorigin=\"anonymous\"\n    referrerpolicy=\"no-referrer\"\n  />\n\n  <!-- Style -->\n  <style>\n    .DCEReactKit-pop-in {\n      animation-name: DCEReactKit-pop-in;\n      animation-duration: 0.5s;\n      animation-iteration-count: 1;\n      animation-timing-function: ease-out;\n      animation-fill-mode: both;\n\n      transform-origin: center;\n    }\n\n    @keyframes DCEReactKit-pop-in {\n      0% {\n        opacity: 0;\n        transform: scale(0.9);\n      }\n      100% {\n        opacity: 1;\n        transform: scale(1);\n      }\n    }\n  </style>\n</head>\n\n<!-- Body -->\n<body class=\"bg-dark text-center pt-3 ps-3 pe-3\">\n  <!-- Alert -->\n  <div\n    class=\"DCEReactKit-pop-in alert alert-info d-inline-block\"\n    style=\"width: 50em; max-width: 100%\"\n  >\n    <!-- Title -->\n    <h2>\n      <i class=\"me-1 fa-solid fa-circle-info\"></i>\n      ").concat(title, "\n    </h2>\n    <!-- Body -->\n    <div>\n      ").concat(body, "\n    </div>\n  </div>\n</body>\n  ");
+};
+exports.default = genInfoPage;
+//# sourceMappingURL=genInfoPage.js.map

package/lib/html/genInfoPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genInfoPage.js","sourceRoot":"","sources":["../../src/html/genInfoPage.ts"],"names":[],"mappings":";;AAAA;;;;;;;GAOG;AACH,IAAM,WAAW,GAAG,UAClB,IAGC;IAGC,IAAA,KAAK,GAEH,IAAI,MAFD,EACL,IAAI,GACF,IAAI,KADF,CACG;IAET,OAAO,2MASE,KAAK,owDA6DR,KAAK,8DAIL,IAAI,wCAIT,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,WAAW,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import { abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMonthName, genCSV, extractProp, compareArraysByProp, getLocalTimeInfo, genCommaList, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, ErrorWithCode, ParamType } from 'dce-reactkit';
+import initCrossServerCredentialCollection from './helpers/initCrossServerCredentialCollection';
+import initLogCollection from './helpers/initLogCollection';
+import initServer from './helpers/initServer';
+import genRouteHandler from './helpers/genRouteHandler';
+import handleError from './helpers/handleError';
+import handleSuccess from './helpers/handleSuccess';
+import addDBEditorEndpoints from './helpers/addDBEditorEndpoints';
+import visitEndpointOnAnotherServer from './helpers/visitEndpointOnAnotherServer';
+import CrossServerCredential from './types/CrossServerCredential';
+export { ErrorWithCode, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMonthName, genCSV, extractProp, compareArraysByProp, genCommaList, getLocalTimeInfo, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, initServer, genRouteHandler, handleError, handleSuccess, initLogCollection, initCrossServerCredentialCollection, addDBEditorEndpoints, visitEndpointOnAnotherServer, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, CrossServerCredential, ParamType, };

package/lib/index.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParamType = exports.LogBuiltInMetadata = exports.LogAction = exports.LogSource = exports.LogType = exports.DayOfWeek = exports.visitEndpointOnAnotherServer = exports.addDBEditorEndpoints = exports.initCrossServerCredentialCollection = exports.initLogCollection = exports.handleSuccess = exports.handleError = exports.genRouteHandler = exports.initServer = exports.shuffleArray = exports.capitalize = exports.someAsync = exports.mapAsync = exports.forEachAsync = exports.filterAsync = exports.everyAsync = exports.prefixWithAOrAn = exports.getLocalTimeInfo = exports.genCommaList = exports.compareArraysByProp = exports.extractProp = exports.genCSV = exports.getMonthName = exports.parallelLimit = exports.onlyKeepLetters = exports.stringsToHumanReadableList = exports.getPartOfDay = exports.getHumanReadableDate = exports.startMinWait = exports.getTimeInfoInET = exports.getOrdinal = exports.waitMs = exports.sum = exports.roundToNumDecimals = exports.padZerosLeft = exports.padDecimalZeros = exports.forceNumIntoBounds = exports.floorToNumDecimals = exports.ceilToNumDecimals = exports.avg = exports.abbreviate = exports.DAY_IN_MS = exports.HOUR_IN_MS = exports.MINUTE_IN_MS = exports.ErrorWithCode = void 0;
+// Import dce-reactkit
+var dce_reactkit_1 = require("dce-reactkit");
+Object.defineProperty(exports, "abbreviate", { enumerable: true, get: function () { return dce_reactkit_1.abbreviate; } });
+Object.defineProperty(exports, "avg", { enumerable: true, get: function () { return dce_reactkit_1.avg; } });
+Object.defineProperty(exports, "ceilToNumDecimals", { enumerable: true, get: function () { return dce_reactkit_1.ceilToNumDecimals; } });
+Object.defineProperty(exports, "floorToNumDecimals", { enumerable: true, get: function () { return dce_reactkit_1.floorToNumDecimals; } });
+Object.defineProperty(exports, "forceNumIntoBounds", { enumerable: true, get: function () { return dce_reactkit_1.forceNumIntoBounds; } });
+Object.defineProperty(exports, "padDecimalZeros", { enumerable: true, get: function () { return dce_reactkit_1.padDecimalZeros; } });
+Object.defineProperty(exports, "padZerosLeft", { enumerable: true, get: function () { return dce_reactkit_1.padZerosLeft; } });
+Object.defineProperty(exports, "roundToNumDecimals", { enumerable: true, get: function () { return dce_reactkit_1.roundToNumDecimals; } });
+Object.defineProperty(exports, "sum", { enumerable: true, get: function () { return dce_reactkit_1.sum; } });
+Object.defineProperty(exports, "waitMs", { enumerable: true, get: function () { return dce_reactkit_1.waitMs; } });
+Object.defineProperty(exports, "getOrdinal", { enumerable: true, get: function () { return dce_reactkit_1.getOrdinal; } });
+Object.defineProperty(exports, "getTimeInfoInET", { enumerable: true, get: function () { return dce_reactkit_1.getTimeInfoInET; } });
+Object.defineProperty(exports, "startMinWait", { enumerable: true, get: function () { return dce_reactkit_1.startMinWait; } });
+Object.defineProperty(exports, "getHumanReadableDate", { enumerable: true, get: function () { return dce_reactkit_1.getHumanReadableDate; } });
+Object.defineProperty(exports, "getPartOfDay", { enumerable: true, get: function () { return dce_reactkit_1.getPartOfDay; } });
+Object.defineProperty(exports, "stringsToHumanReadableList", { enumerable: true, get: function () { return dce_reactkit_1.stringsToHumanReadableList; } });
+Object.defineProperty(exports, "onlyKeepLetters", { enumerable: true, get: function () { return dce_reactkit_1.onlyKeepLetters; } });
+Object.defineProperty(exports, "parallelLimit", { enumerable: true, get: function () { return dce_reactkit_1.parallelLimit; } });
+Object.defineProperty(exports, "getMonthName", { enumerable: true, get: function () { return dce_reactkit_1.getMonthName; } });
+Object.defineProperty(exports, "genCSV", { enumerable: true, get: function () { return dce_reactkit_1.genCSV; } });
+Object.defineProperty(exports, "extractProp", { enumerable: true, get: function () { return dce_reactkit_1.extractProp; } });
+Object.defineProperty(exports, "compareArraysByProp", { enumerable: true, get: function () { return dce_reactkit_1.compareArraysByProp; } });
+Object.defineProperty(exports, "getLocalTimeInfo", { enumerable: true, get: function () { return dce_reactkit_1.getLocalTimeInfo; } });
+Object.defineProperty(exports, "genCommaList", { enumerable: true, get: function () { return dce_reactkit_1.genCommaList; } });
+Object.defineProperty(exports, "prefixWithAOrAn", { enumerable: true, get: function () { return dce_reactkit_1.prefixWithAOrAn; } });
+Object.defineProperty(exports, "everyAsync", { enumerable: true, get: function () { return dce_reactkit_1.everyAsync; } });
+Object.defineProperty(exports, "filterAsync", { enumerable: true, get: function () { return dce_reactkit_1.filterAsync; } });
+Object.defineProperty(exports, "forEachAsync", { enumerable: true, get: function () { return dce_reactkit_1.forEachAsync; } });
+Object.defineProperty(exports, "mapAsync", { enumerable: true, get: function () { return dce_reactkit_1.mapAsync; } });
+Object.defineProperty(exports, "someAsync", { enumerable: true, get: function () { return dce_reactkit_1.someAsync; } });
+Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return dce_reactkit_1.capitalize; } });
+Object.defineProperty(exports, "shuffleArray", { enumerable: true, get: function () { return dce_reactkit_1.shuffleArray; } });
+Object.defineProperty(exports, "DayOfWeek", { enumerable: true, get: function () { return dce_reactkit_1.DayOfWeek; } });
+Object.defineProperty(exports, "LogType", { enumerable: true, get: function () { return dce_reactkit_1.LogType; } });
+Object.defineProperty(exports, "LogSource", { enumerable: true, get: function () { return dce_reactkit_1.LogSource; } });
+Object.defineProperty(exports, "LogAction", { enumerable: true, get: function () { return dce_reactkit_1.LogAction; } });
+Object.defineProperty(exports, "LogBuiltInMetadata", { enumerable: true, get: function () { return dce_reactkit_1.LogBuiltInMetadata; } });
+Object.defineProperty(exports, "MINUTE_IN_MS", { enumerable: true, get: function () { return dce_reactkit_1.MINUTE_IN_MS; } });
+Object.defineProperty(exports, "HOUR_IN_MS", { enumerable: true, get: function () { return dce_reactkit_1.HOUR_IN_MS; } });
+Object.defineProperty(exports, "DAY_IN_MS", { enumerable: true, get: function () { return dce_reactkit_1.DAY_IN_MS; } });
+Object.defineProperty(exports, "ErrorWithCode", { enumerable: true, get: function () { return dce_reactkit_1.ErrorWithCode; } });
+Object.defineProperty(exports, "ParamType", { enumerable: true, get: function () { return dce_reactkit_1.ParamType; } });
+// Import helpers
+var initCrossServerCredentialCollection_1 = __importDefault(require("./helpers/initCrossServerCredentialCollection"));
+exports.initCrossServerCredentialCollection = initCrossServerCredentialCollection_1.default;
+var initLogCollection_1 = __importDefault(require("./helpers/initLogCollection"));
+exports.initLogCollection = initLogCollection_1.default;
+var initServer_1 = __importDefault(require("./helpers/initServer"));
+exports.initServer = initServer_1.default;
+var genRouteHandler_1 = __importDefault(require("./helpers/genRouteHandler"));
+exports.genRouteHandler = genRouteHandler_1.default;
+var handleError_1 = __importDefault(require("./helpers/handleError"));
+exports.handleError = handleError_1.default;
+var handleSuccess_1 = __importDefault(require("./helpers/handleSuccess"));
+exports.handleSuccess = handleSuccess_1.default;
+var addDBEditorEndpoints_1 = __importDefault(require("./helpers/addDBEditorEndpoints"));
+exports.addDBEditorEndpoints = addDBEditorEndpoints_1.default;
+var visitEndpointOnAnotherServer_1 = __importDefault(require("./helpers/visitEndpointOnAnotherServer"));
+exports.visitEndpointOnAnotherServer = visitEndpointOnAnotherServer_1.default;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,sBAAsB;AACtB,6CA8CsB;AAwBpB,2FArEA,yBAAU,OAqEA;AACV,oFArEA,kBAAG,OAqEA;AACH,kGArEA,gCAAiB,OAqEA;AACjB,mGArEA,iCAAkB,OAqEA;AAClB,mGArEA,iCAAkB,OAqEA;AAClB,gGArEA,8BAAe,OAqEA;AACf,6FArEA,2BAAY,OAqEA;AACZ,mGArEA,iCAAkB,OAqEA;AAClB,oFArEA,kBAAG,OAqEA;AACH,uFArEA,qBAAM,OAqEA;AACN,2FArEA,yBAAU,OAqEA;AACV,gGArEA,8BAAe,OAqEA;AACf,6FArEA,2BAAY,OAqEA;AACZ,qGArEA,mCAAoB,OAqEA;AACpB,6FArEA,2BAAY,OAqEA;AACZ,2GArEA,yCAA0B,OAqEA;AAC1B,gGArEA,8BAAe,OAqEA;AACf,8FArEA,4BAAa,OAqEA;AACb,6FArEA,2BAAY,OAqEA;AACZ,uFArEA,qBAAM,OAqEA;AACN,4FArEA,0BAAW,OAqEA;AACX,oGArEA,kCAAmB,OAqEA;AAEnB,iGAtEA,+BAAgB,OAsEA;AADhB,6FApEA,2BAAY,OAoEA;AAEZ,gGArEA,8BAAe,OAqEA;AACf,2FArEA,yBAAU,OAqEA;AACV,4FArEA,0BAAW,OAqEA;AACX,6FArEA,2BAAY,OAqEA;AACZ,yFArEA,uBAAQ,OAqEA;AACR,0FArEA,wBAAS,OAqEA;AACT,2FArEA,yBAAU,OAqEA;AACV,6FArEA,2BAAY,OAqEA;AAWZ,0FA/EA,wBAAS,OA+EA;AAET,wFA/EA,sBAAO,OA+EA;AACP,0FA/EA,wBAAS,OA+EA;AACT,0FA/EA,wBAAS,OA+EA;AACT,mGA/EA,iCAAkB,OA+EA;AAnDlB,6FAzBA,2BAAY,OAyBA;AACZ,2FAzBA,yBAAU,OAyBA;AACV,0FAzBA,wBAAS,OAyBA;AAJT,8FApBA,4BAAa,OAoBA;AA0Db,0FA7EA,wBAAS,OA6EA;AA1EX,iBAAiB;AACjB,sHAAgG;AA2D9F,8CA3DK,6CAAmC,CA2DL;AA1DrC,kFAA4D;AAyD1D,4BAzDK,2BAAiB,CAyDL;AAxDnB,oEAA8C;AAoD5C,qBApDK,oBAAU,CAoDL;AAnDZ,8EAAwD;AAoDtD,0BApDK,yBAAe,CAoDL;AAnDjB,sEAAgD;AAoD9C,sBApDK,qBAAW,CAoDL;AAnDb,0EAAoD;AAoDlD,wBApDK,uBAAa,CAoDL;AAnDf,wFAAkE;AAsDhE,+BAtDK,8BAAoB,CAsDL;AArDtB,wGAAkF;AAsDhF,uCAtDK,sCAA4B,CAsDL"}

package/lib/types/CrossServerCredential.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Single cross-server credential
+ * @author Gabe Abrams
+ */
+type CrossServerCredential = {
+    description: string;
+    key: string;
+    encodedeSecret: string;
+    scopes: string[];
+};
+export default CrossServerCredential;

package/lib/types/CrossServerCredential.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=CrossServerCredential.js.map

package/lib/types/CrossServerCredential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrossServerCredential.js","sourceRoot":"","sources":["../../src/types/CrossServerCredential.ts"],"names":[],"mappings":""}

package/lib/types/ExpressKitErrorCode.d.ts

@@ -0,0 +1,31 @@
+/**
+ * List of error codes built into the express kit
+ * @author Gabe Abrams
+ */
+declare enum ExpressKitErrorCode {
+    WrongCourse = "DEK6",
+    NotTTM = "DEK9",
+    NotAdmin = "DEK10",
+    NotAllowedToReviewLogs = "DEK11",
+    ThemeCheckedBeforeReactKitReady = "DEK12",
+    InvalidParameter = "DEK5",
+    MissingParameter = "DEK4",
+    NotConnected = "DEK14",
+    SelfSigned = "DEK15",
+    ResponseParseError = "DEK16",
+    SignedRequestUnparseable = "DEK28",
+    SignedRequestInvalidCollection = "DEK21",
+    SignedRequestInvalidCredential = "DEK23",
+    SignedRequestInvalidScope = "DEK22",
+    SignedRequestInvalidTimestamp = "DEK24",
+    SignedRequestInvalidSignature = "DEK25",
+    SignedRequestInvalidBody = "DEK26",
+    CrossServerNoCredentialsToSignWith = "DEK27",
+    CrossServerMissingSignedRequestInfo = "DEK29",
+    CrossServerNoCredentialEncodingSalt = "DEK30",
+    NoOauthLib = "DEK31",
+    NoCryptoLib = "DEK32",
+    InvalidCrossServerCredentialsFormat = "DEK33",
+    UnknownCrossServerError = "DEK34"
+}
+export default ExpressKitErrorCode;

package/lib/types/ExpressKitErrorCode.js

@@ -0,0 +1,38 @@
+"use strict";
+// Highest error code = DEK34
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * List of error codes built into the express kit
+ * @author Gabe Abrams
+ */
+var ExpressKitErrorCode;
+(function (ExpressKitErrorCode) {
+    // General errors
+    ExpressKitErrorCode["WrongCourse"] = "DEK6";
+    ExpressKitErrorCode["NotTTM"] = "DEK9";
+    ExpressKitErrorCode["NotAdmin"] = "DEK10";
+    ExpressKitErrorCode["NotAllowedToReviewLogs"] = "DEK11";
+    ExpressKitErrorCode["ThemeCheckedBeforeReactKitReady"] = "DEK12";
+    ExpressKitErrorCode["InvalidParameter"] = "DEK5";
+    ExpressKitErrorCode["MissingParameter"] = "DEK4";
+    // Server-to-server requests
+    ExpressKitErrorCode["NotConnected"] = "DEK14";
+    ExpressKitErrorCode["SelfSigned"] = "DEK15";
+    ExpressKitErrorCode["ResponseParseError"] = "DEK16";
+    ExpressKitErrorCode["SignedRequestUnparseable"] = "DEK28";
+    ExpressKitErrorCode["SignedRequestInvalidCollection"] = "DEK21";
+    ExpressKitErrorCode["SignedRequestInvalidCredential"] = "DEK23";
+    ExpressKitErrorCode["SignedRequestInvalidScope"] = "DEK22";
+    ExpressKitErrorCode["SignedRequestInvalidTimestamp"] = "DEK24";
+    ExpressKitErrorCode["SignedRequestInvalidSignature"] = "DEK25";
+    ExpressKitErrorCode["SignedRequestInvalidBody"] = "DEK26";
+    ExpressKitErrorCode["CrossServerNoCredentialsToSignWith"] = "DEK27";
+    ExpressKitErrorCode["CrossServerMissingSignedRequestInfo"] = "DEK29";
+    ExpressKitErrorCode["CrossServerNoCredentialEncodingSalt"] = "DEK30";
+    ExpressKitErrorCode["NoOauthLib"] = "DEK31";
+    ExpressKitErrorCode["NoCryptoLib"] = "DEK32";
+    ExpressKitErrorCode["InvalidCrossServerCredentialsFormat"] = "DEK33";
+    ExpressKitErrorCode["UnknownCrossServerError"] = "DEK34";
+})(ExpressKitErrorCode || (ExpressKitErrorCode = {}));
+exports.default = ExpressKitErrorCode;
+//# sourceMappingURL=ExpressKitErrorCode.js.map

package/lib/types/ExpressKitErrorCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressKitErrorCode.js","sourceRoot":"","sources":["../../src/types/ExpressKitErrorCode.ts"],"names":[],"mappings":";AAAA,6BAA6B;;AAE7B;;;GAGG;AACH,IAAK,mBA4BJ;AA5BD,WAAK,mBAAmB;IACtB,iBAAiB;IACjB,2CAAoB,CAAA;IACpB,sCAAe,CAAA;IACf,yCAAkB,CAAA;IAClB,uDAAgC,CAAA;IAChC,gEAAyC,CAAA;IACzC,gDAAyB,CAAA;IACzB,gDAAyB,CAAA;IAEzB,4BAA4B;IAC5B,6CAAsB,CAAA;IACtB,2CAAoB,CAAA;IACpB,mDAA4B,CAAA;IAC5B,yDAAkC,CAAA;IAClC,+DAAwC,CAAA;IACxC,+DAAwC,CAAA;IACxC,0DAAmC,CAAA;IACnC,8DAAuC,CAAA;IACvC,8DAAuC,CAAA;IACvC,yDAAkC,CAAA;IAClC,mEAA4C,CAAA;IAC5C,oEAA6C,CAAA;IAC7C,oEAA6C,CAAA;IAC7C,2CAAoB,CAAA;IACpB,4CAAqB,CAAA;IACrB,oEAA6C,CAAA;IAC7C,wDAAiC,CAAA;AACnC,CAAC,EA5BI,mBAAmB,KAAnB,mBAAmB,QA4BvB;AAED,kBAAe,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "dce-expresskit",
+  "version": "4.0.0-beta-logreviewer.1",
+  "description": "Shared functions, helpers, and tools for Harvard DCE Express-based servers",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "scripts": {
+    "build": "tsc --project ./tsconfig.json",
+    "gen-cross-server-secret": "npx tsx genEncodedSecret.ts",
+    "gen-cross-server-salt": "npx tsx genSalt.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harvard-edtech/dce-expresskit.git"
+  },
+  "keywords": [
+    "Express",
+    "Harvard",
+    "DCE",
+    "Toolkit"
+  ],
+  "dependencies": {
+    "@fortawesome/fontawesome-svg-core": "^6.7.2",
+    "@fortawesome/free-regular-svg-icons": "^6.7.2",
+    "@fortawesome/free-solid-svg-icons": "^6.7.2",
+    "@fortawesome/react-fontawesome": "^0.2.2",
+    "bootstrap": "^5.3.3",
+    "dce-reactkit": "4.0.0-beta-logreviewer.1",
+    "react": "^19.0.0"
+  },
+  "peerDependencies": {
+    "caccl": "^x.x.x",
+    "dce-mango": "^x.x.x",
+    "express": "^4.21.2",
+    "express-session": "^1.18.1"
+  },
+  "author": "Gabe Abrams <gabeabrams@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/harvard-edtech/dce-expresskit/issues"
+  },
+  "homepage": "https://github.com/harvard-edtech/dce-expresskit#readme",
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/express-session": "^1.18.1",
+    "@types/node": "^22.13.10",
+    "@types/oauth-signature": "^1.5.2",
+    "@typescript-eslint/eslint-plugin": "^5.59.9",
+    "@typescript-eslint/parser": "^5.59.9",
+    "eslint": "^8.42.0",
+    "typescript": "^5.8.2"
+  }
+}

package/src/constants/LOG_REVIEW_PAGE_SIZE.ts

@@ -0,0 +1,7 @@
+/**
+ * Log reviewer page size
+ * @author Yuen Ler Chow
+ */
+const LOG_REVIEW_PAGE_SIZE = 100;
+
+export default LOG_REVIEW_PAGE_SIZE;

package/src/errors/ErrorWithCode.tsx

@@ -0,0 +1,15 @@
+/**
+ * An error with a code
+ * @author Gabe Abrams
+ */
+class ErrorWithCode extends Error {
+  code: string;
+
+  constructor(message: string, code: string) {
+    super(message);
+    this.name = 'ErrorWithCode';
+    this.code = code;
+  }
+}
+
+export default ErrorWithCode;

package/src/helpers/addDBEditorEndpoints/generateEndpointPath.ts

@@ -0,0 +1,16 @@
+/**
+ * Generates the endpoint path for the given collection name
+ * @author Yuen Ler Chow
+ * @param collectionName the name of the collection
+ * @param [adminsOnly] true if the endpoint is for admins only
+ * @returns the endpoint path
+ */
+const generateEndpointPath = (collectionName: string, adminsOnly?: boolean) => {
+  // Determine prefix based on whether the endpoint is for admins only
+  const userPath = adminsOnly ? 'admin' : 'ttm';
+
+  // Return the endpoint path
+  return `/api/${userPath}/dce-reactkit/dbeditor/${collectionName}`;
+};
+
+export default generateEndpointPath;