dce-reactkit 2.0.3 → 2.0.6

package/lib/helpers/parseRequest.js

@@ -0,0 +1,240 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import caccl libs
+var caccl_lti_1 = require("caccl-lti");
+// Import shared types
+var ReactKitErrorCode_1 = __importDefault(require("../types/ReactKitErrorCode"));
+var ParamType_1 = __importDefault(require("../types/ParamType"));
+// Import helpers
+var handleError_1 = __importDefault(require("./handleError"));
+/**
+ * Parse express request params and body
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param opts.req express request instance
+ * @param opts.res express response instance
+ * @param opts.params map of parameters that should be parsed out of the request
+ * @returns parsed params + user info from session (if it exists) or undefined
+ *   if an error occurred
+ */
+var parseRequest = function (opts) {
+    // Output
+    var output = {};
+    /*----------------------------------------*/
+    /*              Parse Params              */
+    /*----------------------------------------*/
+    // Process items one by one
+    var paramList = Object.entries(opts.params);
+    for (var i = 0; i < paramList.length; i++) {
+        var _a = paramList[i], name_1 = _a[0], type = _a[1];
+        // Find the value as a string
+        var value = (opts.req.params[name_1]
+            || opts.req.query[name_1]
+            || opts.req.body[name_1]);
+        // Parse
+        if (type === ParamType_1.default.Boolean || type === ParamType_1.default.BooleanOptional) {
+            // Boolean
+            // Handle case where value doesn't exist
+            if (value === undefined) {
+                if (type === ParamType_1.default.BooleanOptional) {
+                    output[name_1] = undefined;
+                }
+                else {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Parameter ".concat(name_1, " is required, but it was not included."),
+                        code: ReactKitErrorCode_1.default.MissingParameter,
+                        status: 422,
+                    });
+                }
+            }
+            else {
+                // Value exists
+                // Simplify value
+                var simpleVal = (String(value)
+                    .trim()
+                    .toLowerCase());
+                // Parse
+                output[name_1] = ([
+                    'true',
+                    'yes',
+                    'y',
+                    '1',
+                    't',
+                ].indexOf(simpleVal) >= 0);
+            }
+        }
+        else if (type === ParamType_1.default.Float || type === ParamType_1.default.FloatOptional) {
+            // Float
+            // Handle case where value doesn't exist
+            if (value === undefined) {
+                if (type === ParamType_1.default.FloatOptional) {
+                    output[name_1] = undefined;
+                }
+                else {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Parameter ".concat(name_1, " is required, but it was not included."),
+                        code: ReactKitErrorCode_1.default.MissingParameter,
+                        status: 422,
+                    });
+                }
+            }
+            else if (!Number.isNaN(Number.parseFloat(String(value)))) {
+                // Value is a number
+                output[name_1] = Number.parseFloat(String(value));
+            }
+            else {
+                // Issue!
+                return (0, handleError_1.default)(opts.res, {
+                    message: "Request data was malformed: ".concat(name_1, " was not a valid float."),
+                    code: ReactKitErrorCode_1.default.InvalidParameter,
+                    status: 422,
+                });
+            }
+        }
+        else if (type === ParamType_1.default.Int || type === ParamType_1.default.IntOptional) {
+            // Int
+            // Handle case where value doesn't exist
+            if (value === undefined) {
+                if (type === ParamType_1.default.IntOptional) {
+                    output[name_1] = undefined;
+                }
+                else {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Parameter ".concat(name_1, " is required, but it was not included."),
+                        code: ReactKitErrorCode_1.default.MissingParameter,
+                        status: 422,
+                    });
+                }
+            }
+            else if (!Number.isNaN(Number.parseInt(String(value), 10))) {
+                // Value is a number
+                output[name_1] = Number.parseInt(String(value), 10);
+            }
+            else {
+                // Issue!
+                return (0, handleError_1.default)(opts.res, {
+                    message: "Request data was malformed: ".concat(name_1, " was not a valid int."),
+                    code: ReactKitErrorCode_1.default.InvalidParameter,
+                    status: 422,
+                });
+            }
+        }
+        else if (type === ParamType_1.default.JSON || type === ParamType_1.default.JSONOptional) {
+            // Stringified JSON
+            // Handle case where value doesn't exist
+            if (value === undefined) {
+                if (type === ParamType_1.default.JSONOptional) {
+                    output[name_1] = undefined;
+                }
+                else {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Parameter ".concat(name_1, " is required, but it was not included."),
+                        code: ReactKitErrorCode_1.default.MissingParameter,
+                        status: 422,
+                    });
+                }
+            }
+            else {
+                // Value exists
+                // Parse
+                try {
+                    output[name_1] = JSON.parse(String(value));
+                }
+                catch (err) {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Request data was malformed: ".concat(name_1, " was not a valid JSON payload."),
+                        code: ReactKitErrorCode_1.default.InvalidParameter,
+                        status: 422,
+                    });
+                }
+            }
+        }
+        else if (type === ParamType_1.default.String || type === ParamType_1.default.StringOptional) {
+            // String
+            // Handle case where value doesn't exist
+            if (value === undefined) {
+                if (type === ParamType_1.default.StringOptional) {
+                    output[name_1] = undefined;
+                }
+                else {
+                    return (0, handleError_1.default)(opts.res, {
+                        message: "Parameter ".concat(name_1, " is required, but it was not included."),
+                        code: ReactKitErrorCode_1.default.MissingParameter,
+                        status: 422,
+                    });
+                }
+            }
+            else {
+                // Value exists
+                // Leave as is
+                output[name_1] = value;
+            }
+        }
+        else {
+            // No valid data type
+            return (0, handleError_1.default)(opts.res, {
+                message: "An internal error occurred: we could not determine the type of ".concat(name_1, "."),
+                code: ReactKitErrorCode_1.default.InvalidParameter,
+                status: 422,
+            });
+        }
+    }
+    /*----------------------------------------*/
+    /*               Launch Info              */
+    /*----------------------------------------*/
+    // Get launch info
+    var _b = (0, caccl_lti_1.getLaunchInfo)(opts.req), launched = _b.launched, launchInfo = _b.launchInfo;
+    if (!launched || !launchInfo) {
+        return (0, handleError_1.default)(opts.res, {
+            message: 'Your session has expired. Please refresh the page and try again.',
+            code: ReactKitErrorCode_1.default.SessionExpired,
+            status: 440,
+        });
+    }
+    // Error if user info cannot be found
+    if (!launchInfo.userId
+        || !launchInfo.userFirstName
+        || !launchInfo.userLastName
+        || (launchInfo.notInCourse
+            && !launchInfo.isAdmin)
+        || (!launchInfo.isTTM
+            && !launchInfo.isLearner
+            && !launchInfo.isAdmin)) {
+        return (0, handleError_1.default)(opts.res, {
+            message: 'Your session was invalid. Please refresh the page and try again.',
+            code: ReactKitErrorCode_1.default.SessionExpired,
+            status: 440,
+        });
+    }
+    // Add launch info to output
+    output.userId = launchInfo.userId;
+    output.userFirstName = launchInfo.userFirstName;
+    output.userLastName = launchInfo.userLastName;
+    output.isLearner = !!launchInfo.isLearner;
+    output.isTTM = !!launchInfo.isTTM;
+    output.isAdmin = !!launchInfo.isAdmin;
+    output.isWatchingInPrivate = !!(opts.req.session.isWatchingInPrivate);
+    /*----------------------------------------*/
+    /*       Require Course Consistency       */
+    /*----------------------------------------*/
+    // Make sure the user actually launched from the appropriate course
+    if (output.courseId
+        && launchInfo.courseId
+        && output.courseId !== launchInfo.courseId
+        && !output.isTTM
+        && !output.isAdmin) {
+        // Course of interest is not the launch course
+        return (0, handleError_1.default)(opts.res, {
+            message: 'You switched sessions by opening Immersive Classroom in another tab. Please refresh the page and try again.',
+            code: ReactKitErrorCode_1.default.WrongCourse,
+            status: 401,
+        });
+    }
+    // Return processed params
+    return output;
+};
+exports.default = parseRequest;
+//# sourceMappingURL=parseRequest.js.map

package/lib/helpers/parseRequest.js.map

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

package/lib/helpers/parseRequest.ts

@@ -0,0 +1,299 @@
+// Import caccl libs
+import { getLaunchInfo } from 'caccl-lti';
+
+// Import shared types
+import ReactKitErrorCode from '../types/ReactKitErrorCode';
+import ParamType from '../types/ParamType';
+
+// Import helpers
+import handleError from './handleError';
+
+/**
+ * Parse express request params and body
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param opts.req express request instance
+ * @param opts.res express response instance
+ * @param opts.params map of parameters that should be parsed out of the request
+ * @returns parsed params + user info from session (if it exists) or undefined
+ *   if an error occurred
+ */
+const parseRequest = (
+  opts: {
+    req: any,
+    res: any,
+    params: {
+      [k in string]: ParamType
+    },
+  },
+): ({ [k in string]: any } | undefined) => {
+  // Output
+
+  const output: { [k in string]: any } = {};
+
+  /*----------------------------------------*/
+  /*              Parse Params              */
+  /*----------------------------------------*/
+
+  // Process items one by one
+  const paramList = Object.entries(opts.params);
+  for (let i = 0; i < paramList.length; i++) {
+    const [name, type] = paramList[i];
+
+    // Find the value as a string
+    const value = (
+      opts.req.params[name]
+      || opts.req.query[name]
+      || opts.req.body[name]
+    );
+
+    // Parse
+    if (type === ParamType.Boolean || type === ParamType.BooleanOptional) {
+      // Boolean
+
+      // Handle case where value doesn't exist
+      if (value === undefined) {
+        if (type === ParamType.BooleanOptional) {
+          output[name] = undefined;
+        } else {
+          return handleError(
+            opts.res,
+            {
+              message: `Parameter ${name} is required, but it was not included.`,
+              code: ReactKitErrorCode.MissingParameter,
+              status: 422,
+            },
+          );
+        }
+      } else {
+        // Value exists
+
+        // Simplify value
+        const simpleVal = (
+          String(value)
+            .trim()
+            .toLowerCase()
+        );
+
+        // Parse
+        output[name] = (
+          [
+            'true',
+            'yes',
+            'y',
+            '1',
+            't',
+          ].indexOf(simpleVal) >= 0
+        );
+      }
+    } else if (type === ParamType.Float || type === ParamType.FloatOptional) {
+      // Float
+
+      // Handle case where value doesn't exist
+      if (value === undefined) {
+        if (type === ParamType.FloatOptional) {
+          output[name] = undefined;
+        } else {
+          return handleError(
+            opts.res,
+            {
+              message: `Parameter ${name} is required, but it was not included.`,
+              code: ReactKitErrorCode.MissingParameter,
+              status: 422,
+            },
+          );
+        }
+      } else if (!Number.isNaN(Number.parseFloat(String(value)))) {
+        // Value is a number
+        output[name] = Number.parseFloat(String(value));
+      } else {
+        // Issue!
+        return handleError(
+          opts.res,
+          {
+            message: `Request data was malformed: ${name} was not a valid float.`,
+            code: ReactKitErrorCode.InvalidParameter,
+            status: 422,
+          },
+        );
+      }
+    } else if (type === ParamType.Int || type === ParamType.IntOptional) {
+      // Int
+
+      // Handle case where value doesn't exist
+      if (value === undefined) {
+        if (type === ParamType.IntOptional) {
+          output[name] = undefined;
+        } else {
+          return handleError(
+            opts.res,
+            {
+              message: `Parameter ${name} is required, but it was not included.`,
+              code: ReactKitErrorCode.MissingParameter,
+              status: 422,
+            },
+          );
+        }
+      } else if (!Number.isNaN(Number.parseInt(String(value), 10))) {
+        // Value is a number
+        output[name] = Number.parseInt(String(value), 10);
+      } else {
+        // Issue!
+        return handleError(
+          opts.res,
+          {
+            message: `Request data was malformed: ${name} was not a valid int.`,
+            code: ReactKitErrorCode.InvalidParameter,
+            status: 422,
+          },
+        );
+      }
+    } else if (type === ParamType.JSON || type === ParamType.JSONOptional) {
+      // Stringified JSON
+
+      // Handle case where value doesn't exist
+      if (value === undefined) {
+        if (type === ParamType.JSONOptional) {
+          output[name] = undefined;
+        } else {
+          return handleError(
+            opts.res,
+            {
+              message: `Parameter ${name} is required, but it was not included.`,
+              code: ReactKitErrorCode.MissingParameter,
+              status: 422,
+            },
+          );
+        }
+      } else {
+        // Value exists
+
+        // Parse
+        try {
+          output[name] = JSON.parse(String(value));
+        } catch (err) {
+          return handleError(
+            opts.res,
+            {
+              message: `Request data was malformed: ${name} was not a valid JSON payload.`,
+              code: ReactKitErrorCode.InvalidParameter,
+              status: 422,
+            },
+          );
+        }
+      }
+    } else if (type === ParamType.String || type === ParamType.StringOptional) {
+      // String
+
+      // Handle case where value doesn't exist
+      if (value === undefined) {
+        if (type === ParamType.StringOptional) {
+          output[name] = undefined;
+        } else {
+          return handleError(
+            opts.res,
+            {
+              message: `Parameter ${name} is required, but it was not included.`,
+              code: ReactKitErrorCode.MissingParameter,
+              status: 422,
+            },
+          );
+        }
+      } else {
+        // Value exists
+
+        // Leave as is
+        output[name] = value;
+      }
+    } else {
+      // No valid data type
+      return handleError(
+        opts.res,
+        {
+          message: `An internal error occurred: we could not determine the type of ${name}.`,
+          code: ReactKitErrorCode.InvalidParameter,
+          status: 422,
+        },
+      );
+    }
+  }
+
+  /*----------------------------------------*/
+  /*               Launch Info              */
+  /*----------------------------------------*/
+
+  // Get launch info
+  const { launched, launchInfo } = getLaunchInfo(opts.req);
+  if (!launched || !launchInfo) {
+    return handleError(
+      opts.res,
+      {
+        message: 'Your session has expired. Please refresh the page and try again.',
+        code: ReactKitErrorCode.SessionExpired,
+        status: 440,
+      },
+    );
+  }
+
+  // Error if user info cannot be found
+  if (
+    !launchInfo.userId
+    || !launchInfo.userFirstName
+    || !launchInfo.userLastName
+    || (
+      launchInfo.notInCourse
+      && !launchInfo.isAdmin
+    )
+    || (
+      !launchInfo.isTTM
+      && !launchInfo.isLearner
+      && !launchInfo.isAdmin
+    )
+  ) {
+    return handleError(
+      opts.res,
+      {
+        message: 'Your session was invalid. Please refresh the page and try again.',
+        code: ReactKitErrorCode.SessionExpired,
+        status: 440,
+      },
+    );
+  }
+
+  // Add launch info to output
+  output.userId = launchInfo.userId;
+  output.userFirstName = launchInfo.userFirstName;
+  output.userLastName = launchInfo.userLastName;
+  output.isLearner = !!launchInfo.isLearner;
+  output.isTTM = !!launchInfo.isTTM;
+  output.isAdmin = !!launchInfo.isAdmin;
+  output.isWatchingInPrivate = !!(opts.req.session.isWatchingInPrivate);
+
+  /*----------------------------------------*/
+  /*       Require Course Consistency       */
+  /*----------------------------------------*/
+
+  // Make sure the user actually launched from the appropriate course
+  if (
+    output.courseId
+    && launchInfo.courseId
+    && output.courseId !== launchInfo.courseId
+    && !output.isTTM
+    && !output.isAdmin
+  ) {
+    // Course of interest is not the launch course
+    return handleError(
+      opts.res,
+      {
+        message: 'You switched sessions by opening Immersive Classroom in another tab. Please refresh the page and try again.',
+        code: ReactKitErrorCode.WrongCourse,
+        status: 401,
+      },
+    );
+  }
+
+  // Return processed params
+  return output;
+};
+
+export default parseRequest;

package/lib/helpers/showFatalError.d.ts

@@ -0,0 +1,2 @@
+import { showFatalError } from '../components/AppWrapper';
+export default showFatalError;

package/lib/helpers/showFatalError.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var AppWrapper_1 = require("../components/AppWrapper");
+exports.default = AppWrapper_1.showFatalError;
+//# sourceMappingURL=showFatalError.js.map

package/lib/helpers/showFatalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showFatalError.js","sourceRoot":"","sources":["../../src/helpers/showFatalError.tsx"],"names":[],"mappings":";;AAAA,uDAA0D;AAE1D,kBAAe,2BAAc,CAAC"}

package/lib/helpers/visitServerEndpoint.d.ts

@@ -1,5 +1,11 @@
 /**
- * Visit an endpoint on the server
+ * Set the session expiry handler
+ * @author Gabe Abrams
+ * @param handler new handler to use when session expires
+ */
+export declare const setSessionExpiryHandler: (handler: () => void) => void;
+/**
+ * Visit an endpoint on the server [for client only]
  * @author Gabe Abrams
  * @param opts object containing all arguments
  * @param opts.path - the path of the server endpoint

package/lib/helpers/visitServerEndpoint.js

@@ -39,13 +39,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSessionExpiryHandler = void 0;
 // Initialize caccl
 var client_1 = require("caccl/client");
 // Import custom error
 var ErrorWithCode_1 = __importDefault(require("../errors/ErrorWithCode"));
 var ReactKitErrorCode_1 = __importDefault(require("../types/ReactKitErrorCode"));
+/*------------------------------------------------------------------------*/
+/*                                Listener                                */
+/*------------------------------------------------------------------------*/
+// Handler for session expiry
+var sessionExpiryHandler;
+// Keep track of whether or not session expiry has already been handled
+var sessionAlreadyExpired = false;
 /**
- * Visit an endpoint on the server
+ * Set the session expiry handler
+ * @author Gabe Abrams
+ * @param handler new handler to use when session expires
+ */
+var setSessionExpiryHandler = function (handler) {
+    sessionExpiryHandler = handler;
+};
+exports.setSessionExpiryHandler = setSessionExpiryHandler;
+/*------------------------------------------------------------------------*/
+/*                                  Main                                  */
+/*------------------------------------------------------------------------*/
+/**
+ * Visit an endpoint on the server [for client only]
  * @author Gabe Abrams
  * @param opts object containing all arguments
  * @param opts.path - the path of the server endpoint
@@ -68,12 +88,43 @@ var visitServerEndpoint = function (opts) { return __awaiter(void 0, void 0, voi
                 if (!response || !response.body) {
                     throw new ErrorWithCode_1.default('We didn\'t get a response from the server. Please check your internet connection.', ReactKitErrorCode_1.default.NoResponse);
                 }
-                if (!response.body.success) {
-                    // Other errors
-                    throw new ErrorWithCode_1.default((response.body.message
-                        || 'An unknown error occurred. Please contact an admin.'), (response.body.code
-                        || ReactKitErrorCode_1.default.NoCode));
+                if (!!response.body.success) return [3 /*break*/, 6];
+                if (!(response.body.code === ReactKitErrorCode_1.default.SessionExpired)) return [3 /*break*/, 5];
+                if (!sessionAlreadyExpired) return [3 /*break*/, 3];
+                // Never return (browser is already reloading)
+                return [4 /*yield*/, new Promise(function () {
+                        // Promise that never returns
+                    })];
+            case 2:
+                // Never return (browser is already reloading)
+                _a.sent();
+                _a.label = 3;
+            case 3:
+                sessionAlreadyExpired = true;
+                // Show session expiration message
+                if (sessionExpiryHandler) {
+                    // Use handler
+                    sessionExpiryHandler();
+                }
+                else {
+                    // Fallback to alert
+                    // eslint-disable-next-line no-alert
+                    alert('Your session has expired. Please start over.');
                 }
+                // Never return (don't continue execution)
+                return [4 /*yield*/, new Promise(function () {
+                        // Promise that never returns
+                    })];
+            case 4:
+                // Never return (don't continue execution)
+                _a.sent();
+                _a.label = 5;
+            case 5: 
+            // Other errors
+            throw new ErrorWithCode_1.default((response.body.message
+                || 'An unknown error occurred. Please contact an admin.'), (response.body.code
+                || ReactKitErrorCode_1.default.NoCode));
+            case 6:
                 body = response.body.body;
                 // Return
                 return [2 /*return*/, body];

package/lib/helpers/visitServerEndpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"visitServerEndpoint.js","sourceRoot":"","sources":["../../src/helpers/visitServerEndpoint.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAAmB;AACnB,uCAA2C;AAE3C,sBAAsB;AACtB,0EAAoD;AACpD,iFAA2D;AAE3D;;;;;;;;GAQG;AACH,IAAM,mBAAmB,GAAG,UAC1B,IAIC;;;;oBAGgB,qBAAM,IAAA,oBAAW,EAAC;oBACjC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,EAAA;;gBAJI,QAAQ,GAAG,SAIf;gBAEF,oBAAoB;gBACpB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;oBAC/B,MAAM,IAAI,uBAAa,CACrB,mFAAmF,EACnF,2BAAiB,CAAC,UAAU,CAC7B,CAAC;iBACH;gBACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC1B,eAAe;oBACf,MAAM,IAAI,uBAAa,CACrB,CACE,QAAQ,CAAC,IAAI,CAAC,OAAO;2BAClB,qDAAqD,CACzD,EACD,CACE,QAAQ,CAAC,IAAI,CAAC,IAAI;2BACf,2BAAiB,CAAC,MAAM,CAC5B,CACF,CAAC;iBACH;gBAGO,IAAI,GAAK,QAAQ,CAAC,IAAI,KAAlB,CAAmB;gBAE/B,SAAS;gBACT,sBAAO,IAAI,EAAC;;;KACb,CAAC;AAEF,kBAAe,mBAAmB,CAAC"}
+{"version":3,"file":"visitServerEndpoint.js","sourceRoot":"","sources":["../../src/helpers/visitServerEndpoint.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAAmB;AACnB,uCAA2C;AAE3C,sBAAsB;AACtB,0EAAoD;AACpD,iFAA2D;AAE3D,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAE5E,6BAA6B;AAC7B,IAAI,oBAAgC,CAAC;AAErC,uEAAuE;AACvE,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC;;;;GAIG;AACI,IAAM,uBAAuB,GAAG,UAAC,OAAmB;IACzD,oBAAoB,GAAG,OAAO,CAAC;AACjC,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEF,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAE5E;;;;;;;;GAQG;AACH,IAAM,mBAAmB,GAAG,UAC1B,IAIC;;;;oBAGgB,qBAAM,IAAA,oBAAW,EAAC;oBACjC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,EAAA;;gBAJI,QAAQ,GAAG,SAIf;gBAEF,oBAAoB;gBACpB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;oBAC/B,MAAM,IAAI,uBAAa,CACrB,mFAAmF,EACnF,2BAAiB,CAAC,UAAU,CAC7B,CAAC;iBACH;qBACG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAtB,wBAAsB;qBAEpB,CAAA,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,2BAAiB,CAAC,cAAc,CAAA,EAAvD,wBAAuD;qBAErD,qBAAqB,EAArB,wBAAqB;gBACvB,8CAA8C;gBAC9C,qBAAM,IAAI,OAAO,CAA2B;wBAC1C,6BAA6B;oBAC/B,CAAC,CAAC,EAAA;;gBAHF,8CAA8C;gBAC9C,SAEE,CAAC;;;gBAEL,qBAAqB,GAAG,IAAI,CAAC;gBAE7B,kCAAkC;gBAClC,IAAI,oBAAoB,EAAE;oBACxB,cAAc;oBACd,oBAAoB,EAAE,CAAC;iBACxB;qBAAM;oBACL,oBAAoB;oBAEpB,oCAAoC;oBACpC,KAAK,CAAC,8CAA8C,CAAC,CAAC;iBACvD;gBAED,0CAA0C;gBAC1C,qBAAM,IAAI,OAAO,CAA2B;wBAC1C,6BAA6B;oBAC/B,CAAC,CAAC,EAAA;;gBAHF,0CAA0C;gBAC1C,SAEE,CAAC;;;YAGL,eAAe;YACf,MAAM,IAAI,uBAAa,CACrB,CACE,QAAQ,CAAC,IAAI,CAAC,OAAO;mBAClB,qDAAqD,CACzD,EACD,CACE,QAAQ,CAAC,IAAI,CAAC,IAAI;mBACf,2BAAiB,CAAC,MAAM,CAC5B,CACF,CAAC;;gBAII,IAAI,GAAK,QAAQ,CAAC,IAAI,KAAlB,CAAmB;gBAE/B,SAAS;gBACT,sBAAO,IAAI,EAAC;;;KACb,CAAC;AAEF,kBAAe,mBAAmB,CAAC"}