dce-reactkit 3.1.20 → 3.2.0-beta.1

package/src/types/Log/LogMainInfo.ts

@@ -0,0 +1,64 @@
+/**
+ * Main information in a log event
+ * @author Gabe Abrams
+ */
+type LogMainInfo = {
+  // Unique id of the log event
+  id: string,
+  // First name of the user
+  userFirstName: string,
+  // Last name of the user
+  userLastName: string,
+  // User email
+  userEmail: string,
+  // User Canvas Id
+  userId: number,
+  // If true, the user is a learner
+  isLearner: boolean,
+  // If true, the user is an admin
+  isAdmin: boolean,
+  // If true, the user is a ttm
+  isTTM: boolean,
+  // The id of the Canvas course that the user launched from
+  courseId: number,
+  // The name of the Canvas course
+  courseName: string,
+  // Browser info
+  browser: {
+    // Name of the browser
+    name: string,
+    // Version of the browser
+    version: string,
+  },
+  // Device info
+  device: {
+    // Name of the operating system
+    os: string,
+    // If true, device is a mobile device
+    isMobile: boolean,
+  },
+  // Calendar year that the event is from
+  year: number,
+  // Month that the event is from (1 = Jan, 12 = Dec)
+  month: number,
+  // Day of the month that the event is from
+  day: number,
+  // Hour of the day (24hr) when the event occurred
+  hour: number,
+  // Minute of the day when the event occurred
+  minute: number,
+  // Timestamp of event (ms since epoch)
+  timestamp: number,
+  // Category of the event (each app determines how to categorize its events)
+  category: string,
+  // Subcategory of the event (each app determines how to categorize its events)
+  subcategory: string,
+  // List of tags that apply to this action (each app determines tag usage)
+  tags: string[],
+  // Additional optional custom metadata
+  metadata?: {
+    [k: string]: any,
+  },
+};
+
+export default LogMainInfo;

package/src/types/Log/LogSourceSpecificInfo.ts

@@ -0,0 +1,25 @@
+// Import shared types
+import LogSource from '../LogSource';
+
+/**
+ * Log info that is specific to the type of source
+ * @author Gabe Abrams
+ */
+type LogSourceSpecificInfo = (
+  // Client
+  | {
+    // Source of the event
+    source: LogSource.Client,
+  }
+  // Server
+  | {
+    // Source of the event
+    source: LogSource.Server,
+    // Route path (e.g. /api/admin/courses/53450/blocks)
+    routePath: string,
+    // Route template (e.g. /api/admin/courses/:courseId/blocks)
+    routeTemplate: string,
+  }
+);
+
+export default LogSourceSpecificInfo;

package/src/types/Log/LogTypeSpecificInfo.ts

@@ -0,0 +1,33 @@
+// Import shared types
+import LogAction from '../LogAction';
+import LogType from '../LogType';
+
+/**
+ * Log info that is specific to the type of log
+ * @author Gabe Abrams
+ */
+type LogTypeSpecificInfo = (
+  // Error
+  | {
+    // Type of the event
+    type: LogType.Error,
+    // The error message
+    errorMessage: string,
+    // The error code
+    errorCode: string,
+    // Error stack trace
+    errorStack: string,
+  }
+  // Action
+  | {
+    // Type of the event
+    type: LogType.Action,
+    // Target of the action (each app determines the list of targets)
+    // These are usually buttons, panels, elements, etc.
+    target: string,
+    // The type of action performed on the target
+    action: LogAction,
+  }
+);
+
+export default LogTypeSpecificInfo;

package/src/types/Log/index.ts

@@ -0,0 +1,17 @@
+// Import shared types
+import LogMainInfo from './LogMainInfo';
+import LogSourceSpecificInfo from './LogSourceSpecificInfo';
+import LogTypeSpecificInfo from './LogTypeSpecificInfo';
+
+/**
+ * A single log event corresponding to an action performed by a user or an
+ *   error encountered by a user
+ * @author Gabe Abrams
+ */
+type Log = (
+  LogMainInfo
+  & LogSourceSpecificInfo
+  & LogTypeSpecificInfo
+);
+
+export default Log;

package/src/types/LogAction.ts

@@ -0,0 +1,38 @@
+/**
+ * Types of actions
+ * @author Gabe Abrams
+ */
+enum LogAction {
+  // Target was opened by the user (it was not on screen, but now it is)
+  Open = 'open',
+  // Target was closed by the user (it was on screen, but now it is not)
+  Close = 'close',
+  // Target was expanded by the user (it always remains on screen, but size was changed)
+  Expand = 'expand',
+  // Target was collapsed by the user (it always remains on screen, but size was changed)
+  Collapse = 'collapse',
+  // Target was viewed by the user (only for items that are not opened or closed, those must use Open/Close actions)
+  View = 'view',
+  // Target interrupted the user (popup, dialog, validation message, etc. appeared without user prompting)
+  Interrupt = 'interrupt',
+  // Target was created by the user (it did not exist before)
+  Create = 'create',
+  // Target was edited by the user (it existed and was changed)
+  Edit = 'edit',
+  // Target was deleted by the user (it existed and now it doesn't)
+  Delete = 'delete',
+  // Target was added by the user (it already existed and was added to another place)
+  Add = 'add',
+  // Target was removed by the user (it was removed from something but still exists)
+  Remove = 'remove',
+  // Target was activated by the user (click, check, tap, keypress, etc.)
+  Activate = 'activate',
+  // Target was deactivated by the user (click away, uncheck, tap outside of, tab away, etc.)
+  Deactivate = 'deactivate',
+  // User showed interest in a target (hover, peek, etc.)
+  Peek = 'peek',
+  // Unknown action
+  Unknown = 'unknown',
+};
+
+export default LogAction;

package/src/types/LogFunction.ts

@@ -0,0 +1,41 @@
+// Import shared types
+import Log from './Log';
+import LogAction from './LogAction';
+
+/**
+ * Type of a log action function
+ * @author Gabe Abrams
+ */
+type LogFunction = (
+  opts: (
+    // Shared info
+    {
+      // Category of the event (each app determines how to categorize its events)
+      category: string,
+      // Subcategory of the event (each app determines how to categorize its events)
+      subcategory?: string,
+      // List of tags that apply to this action (each app determines tag usage)
+      tags?: string[],
+      // Additional optional custom metadata
+      metadata?: {
+        [k: string]: any,
+      },
+    } & (
+      // Error
+      | {
+        // The error object to log
+        error: any,
+      }
+      // Action
+      | {
+        // Target of the action (each app determines the list of targets)
+        // These are usually buttons, panels, elements, etc.
+        target: string,
+        // The type of action performed on the target
+        action: LogAction,
+      }
+    )
+  ),
+) => Promise<Log>;
+
+export default LogFunction;

package/src/types/LogSource.ts

@@ -0,0 +1,12 @@
+/**
+ * Source of a log event
+ * @author Gabe Abrams
+ */
+enum LogSource {
+  // Client
+  Client = 'client',
+  // Server
+  Server = 'server',
+};
+
+export default LogSource;

package/src/types/LogType.ts

@@ -0,0 +1,12 @@
+/**
+ * Type of a log event
+ * @author Gabe Abrams
+ */
+enum LogType {
+  // User action
+  Action = 'action',
+  // Error
+  Error = 'error',
+};
+
+export default LogType;