dce-reactkit 2.0.11 → 3.0.0-beta.2

package/lib/types/ParamType.d.ts

@@ -1,17 +0,0 @@
-/**
- * API param types
- * @author Gabe Abrams
- */
-declare enum ParamType {
-    Boolean = "boolean",
-    BooleanOptional = "boolean-optional",
-    Float = "float",
-    FloatOptional = "float-optional",
-    Int = "int",
-    IntOptional = "int-optional",
-    JSON = "json",
-    JSONOptional = "json-optional",
-    String = "string",
-    StringOptional = "string-optional"
-}
-export default ParamType;

package/lib/types/ParamType.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * API param types
- * @author Gabe Abrams
- */
-var ParamType;
-(function (ParamType) {
-    ParamType["Boolean"] = "boolean";
-    ParamType["BooleanOptional"] = "boolean-optional";
-    ParamType["Float"] = "float";
-    ParamType["FloatOptional"] = "float-optional";
-    ParamType["Int"] = "int";
-    ParamType["IntOptional"] = "int-optional";
-    ParamType["JSON"] = "json";
-    ParamType["JSONOptional"] = "json-optional";
-    ParamType["String"] = "string";
-    ParamType["StringOptional"] = "string-optional";
-})(ParamType || (ParamType = {}));
-exports.default = ParamType;
-//# sourceMappingURL=ParamType.js.map

package/lib/types/ParamType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParamType.js","sourceRoot":"","sources":["../../src/types/ParamType.ts"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,IAAK,SAWJ;AAXD,WAAK,SAAS;IACZ,gCAAmB,CAAA;IACnB,iDAAoC,CAAA;IACpC,4BAAe,CAAA;IACf,6CAAgC,CAAA;IAChC,wBAAW,CAAA;IACX,yCAA4B,CAAA;IAC5B,0BAAa,CAAA;IACb,2CAA8B,CAAA;IAC9B,8BAAiB,CAAA;IACjB,+CAAkC,CAAA;AACpC,CAAC,EAXI,SAAS,KAAT,SAAS,QAWb;AAED,kBAAe,SAAS,CAAC"}

package/lib/types/ReactKitErrorCode.js

@@ -1,18 +0,0 @@
-"use strict";
-// Highest error code = DRK2
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * List of error codes built into the react kit
- * @author Gabe Abrams
- */
-var ReactKitErrorCode;
-(function (ReactKitErrorCode) {
-    ReactKitErrorCode["NoResponse"] = "DRK1";
-    ReactKitErrorCode["NoCode"] = "DRK2";
-    ReactKitErrorCode["SessionExpired"] = "DRK3";
-    ReactKitErrorCode["MissingParameter"] = "DRK4";
-    ReactKitErrorCode["InvalidParameter"] = "DRK5";
-    ReactKitErrorCode["WrongCourse"] = "DRK6";
-})(ReactKitErrorCode || (ReactKitErrorCode = {}));
-exports.default = ReactKitErrorCode;
-//# sourceMappingURL=ReactKitErrorCode.js.map

package/lib/types/ReactKitErrorCode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactKitErrorCode.js","sourceRoot":"","sources":["../../src/types/ReactKitErrorCode.tsx"],"names":[],"mappings":";AAAA,4BAA4B;;AAE5B;;;GAGG;AACH,IAAK,iBAOJ;AAPD,WAAK,iBAAiB;IACpB,wCAAmB,CAAA;IACnB,oCAAe,CAAA;IACf,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;IACzB,8CAAyB,CAAA;IACzB,yCAAoB,CAAA;AACtB,CAAC,EAPI,iBAAiB,KAAjB,iBAAiB,QAOrB;AAED,kBAAe,iBAAiB,CAAC"}

package/lib/types/Variant.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Bootstrap variants
- * @author Gabe Abrams
- */
-var Variant;
-(function (Variant) {
-    Variant["Primary"] = "primary";
-    Variant["Secondary"] = "secondary";
-    Variant["Success"] = "success";
-    Variant["Warning"] = "warning";
-    Variant["Info"] = "info";
-    Variant["Danger"] = "danger";
-    Variant["Light"] = "light";
-    Variant["Dark"] = "dark";
-})(Variant || (Variant = {}));
-exports.default = Variant;
-//# sourceMappingURL=Variant.js.map

package/lib/types/Variant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Variant.js","sourceRoot":"","sources":["../../src/types/Variant.tsx"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,IAAK,OASJ;AATD,WAAK,OAAO;IACV,8BAAmB,CAAA;IACnB,kCAAuB,CAAA;IACvB,8BAAmB,CAAA;IACnB,8BAAmB,CAAA;IACnB,wBAAa,CAAA;IACb,4BAAiB,CAAA;IACjB,0BAAe,CAAA;IACf,wBAAa,CAAA;AACf,CAAC,EATI,OAAO,KAAP,OAAO,QASX;AAED,kBAAe,OAAO,CAAC"}

package/src/helpers/alert.tsx

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

package/src/helpers/confirm.tsx

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

package/src/helpers/handleError.ts

@@ -1,65 +0,0 @@
-// Import shared types
-import ReactKitErrorCode from '../types/ReactKitErrorCode';
-
-/**
- * Handle an error and respond to the client
- * @author Gabe Abrams
- * @param res express response
- * @param error error info
- * @param opts.err the error to send to the client
- *   or the error message
- * @param [opts.code] an error code (only used if err.code is not
- *   included)
- * @param [opts.status=500] the https status code to use
- *   defined)
- */
-const handleError = (
-  res: any,
-  error: (
-    | {
-      message: any,
-      code?: string,
-      status?: number,
-    }
-    | Error
-    | string
-    | any
-  ),
-): undefined => {
-  // Get the error message
-  let message;
-  if (error && (error as any).message) {
-    message = (error.message || 'An unknown error occurred.');
-  } else if (typeof error === 'string') {
-    message = (
-      error.trim().length > 0
-        ? error
-        : 'An unknown error occurred.'
-    );
-  } else {
-    message = 'An unknown error occurred.';
-  }
-
-  // Get the error code
-  const code = (error.code || ReactKitErrorCode.NoCode);
-
-  // Get the status code
-  const status = (error.status || 500);
-
-  // Respond to user
-  res
-    // Set the http status code
-    .status(status)
-    // Send a JSON response
-    .json({
-      // Error message
-      message,
-      // Error code
-      code,
-      // Success = false flag so client can detect server-side errors
-      success: false,
-    });
-  return undefined;
-};
-
-export default handleError;

package/src/helpers/handleSuccess.ts

@@ -1,18 +0,0 @@
-/**
- * Send successful API response
- * @author Gabe Abrams
- * @param res express response
- * @param body the body of the response to send to the client
- */
-const handleSuccess = (res: any, body: any): undefined => {
-  // Send a http 200 json response
-  res.json({
-    // Include the body as a parameter
-    body,
-    // Success = true flag so client can detect successful responses
-    success: true,
-  });
-  return undefined;
-};
-
-export default handleSuccess;

package/src/helpers/parseRequest.ts

@@ -1,299 +0,0 @@
-// 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/src/helpers/showFatalError.tsx

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

package/src/helpers/visitServerEndpoint.tsx

@@ -1,110 +0,0 @@
-// Initialize caccl
-import { sendRequest } from 'caccl/client';
-
-// Import custom error
-import ErrorWithCode from '../errors/ErrorWithCode';
-import ReactKitErrorCode from '../types/ReactKitErrorCode';
-
-/*------------------------------------------------------------------------*/
-/*                                Listener                                */
-/*------------------------------------------------------------------------*/
-
-// Handler for session expiry
-let sessionExpiryHandler: () => void;
-
-// Keep track of whether or not session expiry has already been handled
-let sessionAlreadyExpired = false;
-
-/**
- * Set the session expiry handler
- * @author Gabe Abrams
- * @param handler new handler to use when session expires
- */
-export const setSessionExpiryHandler = (handler: () => void) => {
-  sessionExpiryHandler = handler;
-};
-
-/*------------------------------------------------------------------------*/
-/*                                  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
- * @param [opts.method=GET] - the method of the endpoint
- * @param [opts.params] - query/body parameters to include
- * @returns response from server
- */
-const visitServerEndpoint = async (
-  opts: {
-    path: string,
-    method?: ('GET' | 'POST' | 'DELETE' | 'PUT'),
-    params?: { [key in string]: any },
-  },
-): Promise<any> => {
-  // Send the request
-  const response = await sendRequest({
-    path: opts.path,
-    method: opts.method,
-    params: opts.params,
-  });
-
-  // Check for failure
-  if (!response || !response.body) {
-    throw new ErrorWithCode(
-      'We didn\'t get a response from the server. Please check your internet connection.',
-      ReactKitErrorCode.NoResponse,
-    );
-  }
-  if (!response.body.success) {
-    // Session expired
-    if (response.body.code === ReactKitErrorCode.SessionExpired) {
-      // Skip notice if session was already expired
-      if (sessionAlreadyExpired) {
-        // Never return (browser is already reloading)
-        await new Promise<{ [key in string]: any }>(() => {
-          // Promise that never returns
-        });
-      }
-      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)
-      await new Promise<{ [key in string]: any }>(() => {
-        // Promise that never returns
-      });
-    }
-
-    // Other errors
-    throw new ErrorWithCode(
-      (
-        response.body.message
-        || 'An unknown error occurred. Please contact an admin.'
-      ),
-      (
-        response.body.code
-        || ReactKitErrorCode.NoCode
-      ),
-    );
-  }
-
-  // Success! Extract the body
-  const { body } = response.body;
-
-  // Return
-  return body;
-};
-
-export default visitServerEndpoint;

package/src/types/ParamType.ts

@@ -1,18 +0,0 @@
-/**
- * API param types
- * @author Gabe Abrams
- */
-enum ParamType {
-  Boolean = 'boolean', // Boolean
-  BooleanOptional = 'boolean-optional', // Optional boolean
-  Float = 'float', // Float Number
-  FloatOptional = 'float-optional', // Optional Float Number
-  Int = 'int', // Integer Number
-  IntOptional = 'int-optional', // Optional Integer Number
-  JSON = 'json', // JSONified object
-  JSONOptional = 'json-optional', // Optional JSONified object
-  String = 'string', // String
-  StringOptional = 'string-optional', // Optional string
-}
-
-export default ParamType;