dce-reactkit 3.0.0-beta.23 → 3.0.0-beta.27

package/src/server/initServer.ts

@@ -0,0 +1,53 @@
+// Import custom error
+import ErrorWithCode from '../errors/ErrorWithCode';
+import ReactKitErrorCode from '../types/ReactKitErrorCode';
+
+// Types
+type GetLaunchInfoFunction = (req: any) => {
+  launched: boolean,
+  launchInfo?: any,
+};
+
+// Stored copy of caccl functions
+let _cacclGetLaunchInfo: GetLaunchInfoFunction;
+
+/*------------------------------------------------------------------------*/
+/*                                 Helpers                                */
+/*------------------------------------------------------------------------*/
+
+/**
+ * Get launch info via CACCL
+ * @author Gabe Abrams
+ * @param req express request object
+ * @returns object { launched, launchInfo }
+ */
+export const cacclGetLaunchInfo: GetLaunchInfoFunction = (req: any) => {
+  if (!_cacclGetLaunchInfo) {
+    throw new ErrorWithCode(
+      'Could not get launch info because server was not initialized with dce-reactkit\'s initServer function',
+      ReactKitErrorCode.NoCACCLGetLaunchInfoFunction,
+    );
+  }
+
+  return _cacclGetLaunchInfo(req);
+};
+
+/*------------------------------------------------------------------------*/
+/*                                  Main                                  */
+/*------------------------------------------------------------------------*/
+
+/**
+ * Prepare dce-reactkit to run on the server
+ * @author Gabe Abrams
+ * @param opts object containing all arguments
+ * @param opts.getLaunchInfo CACCL LTI's get launch info function
+ */
+const initServer = (
+  opts: {
+    getLaunchInfo: GetLaunchInfoFunction,
+  },
+) => {
+  _cacclGetLaunchInfo = opts.getLaunchInfo;
+};
+
+export default initServer;

package/src/types/ParamType.tsx

@@ -0,0 +1,18 @@
+/**
+ * Server-side 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;

package/src/types/ReactKitErrorCode.tsx

@@ -1,4 +1,4 @@
-// Highest error code = DRK2
+// Highest error code = DRK8
 
 /**
  * List of error codes built into the react kit
@@ -11,6 +11,8 @@ enum ReactKitErrorCode {
   MissingParameter = 'DRK4',
   InvalidParameter = 'DRK5',
   WrongCourse = 'DRK6',
+  NoCACCLSendRequestFunction = 'DRK7',
+  NoCACCLGetLaunchInfoFunction = 'DRK8',
 }
 
 export default ReactKitErrorCode;