dce-reactkit 3.12.1-beta-cross-server.8 → 4.0.0-beta-date-and-time.1

package/dist/cjs/types/helpers/genRouteHandler.d.ts

@@ -1,76 +0,0 @@
-import ParamType from '../types/ParamType';
-import LogFunction from '../types/LogFunction';
-/**
- * Generate an express API route handler
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.paramTypes map containing the types for each parameter that is
- *   included in the request (map: param name => type)
- * @param opts.handler function that processes the request
- * @param [opts.crossServerScope] the scope associated with this endpoint.
- *   If defined, this is a cross-server endpoint, which will never
- *   have any launch data, will never check Canvas roles or launch status, and will
- *   instead use scopes and reactkit credentials to sign and validate requests.
- *   Never start the path with /api/ttm or /api/admin if the endpoint is a cross-server
- *   endpoint because those roles will not be validated
- * @param [opts.skipSessionCheck=true if crossServerScope defined] if true, skip
- *   the session check (allow users to not be logged in and launched via LTI).
- *   If crossServerScope is defined, this is always true
- * @param [opts.unhandledErrorMessagePrefix] if included, when an error that
- *   is not of type ErrorWithCode is thrown, the client will receive an error
- *   where the error message is prefixed with this string. For example,
- *   if unhandledErrorMessagePrefix is
- *   'While saving progress, we encountered an error:'
- *   and the error is 'progressInfo is not an object',
- *   the client will receive an error with the message
- *   'While saving progress, we encountered an error: progressInfo is not an object'
- * @returns express route handler that takes the following arguments:
- *   params (map: param name => value),
- *   req (express request object),
- *   next (express next function),
- *   send (a function that sends a string to the client),
- *   redirect (takes a url and redirects the user to that url),
- *   renderErrorPage (shows a static error page to the user),
- *   renderInfoPage (shows a static info page to the user),
- *   renderCustomHTML (renders custom html and sends it to the user),
- *   and returns the value to send to the client as a JSON API response, or
- *   calls next() or redirect(...) or send(...) or renderErrorPage(...).
- *   Note: params also has userId, userFirstName,
- *   userLastName, userEmail, userAvatarURL, isLearner, isTTM, isAdmin,
- *   and any other variables that
- *   are directly added to the session, if the user does have a session.
- */
-declare const genRouteHandler: (opts: {
-    paramTypes?: {
-        [k: string]: ParamType;
-    } | undefined;
-    handler: (opts: {
-        params: {
-            [k: string]: any;
-        };
-        req: any;
-        next: () => void;
-        redirect: (pathOrURL: string) => void;
-        send: (text: string, status?: number) => void;
-        renderErrorPage: (opts?: {
-            title?: string;
-            description?: string;
-            code?: string;
-            pageTitle?: string;
-            status?: number;
-        }) => void;
-        renderInfoPage: (opts: {
-            title: string;
-            body: string;
-        }) => void;
-        renderCustomHTML: (opts: {
-            html: string;
-            status?: number;
-        }) => void;
-        logServerEvent: LogFunction;
-    }) => any;
-    crossServerScope?: string | undefined;
-    skipSessionCheck?: boolean | undefined;
-    unhandledErrorMessagePrefix?: string | undefined;
-}) => (req: any, res: any, next: () => void) => Promise<undefined>;
-export default genRouteHandler;

package/dist/cjs/types/helpers/handleError.d.ts

@@ -1,18 +0,0 @@
-/**
- * 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)
- */
-declare const handleError: (res: any, error: ({
-    message: any;
-    code?: string;
-    status?: number;
-} | Error | string | any)) => undefined;
-export default handleError;

package/dist/cjs/types/helpers/handleSuccess.d.ts

@@ -1,8 +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
- */
-declare const handleSuccess: (res: any, body: any) => undefined;
-export default handleSuccess;

package/dist/cjs/types/helpers/parseUserAgent.d.ts

@@ -1,17 +0,0 @@
-/**
- * Perform a rudimentary parsing of the user's browser agent string
- * @author Gabe Abrams
- * @param userAgent the user's browser agent
- * @returns user info
- */
-declare const parseUserAgent: (userAgent: string) => {
-    browser: {
-        name: string;
-        version: string;
-    };
-    device: {
-        isMobile: boolean;
-        os: string;
-    };
-};
-export default parseUserAgent;

package/dist/cjs/types/helpers/visitEndpointOnAnotherServer/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Visit an endpoint on another server
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.method the method of the endpoint
- * @param opts.path the path of the other server's endpoint
- * @param opts.host the host of the other server
- * @param [opts.params={}] query/body parameters to include
- * @param [opts.responseType=JSON] the response type from the other server
- */
-declare const visitEndpointOnAnotherServer: (opts: {
-    method: 'GET' | 'POST' | 'DELETE' | 'PUT';
-    path: string;
-    host: string;
-    params?: {
-        [x: string]: any;
-    } | undefined;
-    responseType?: "Text" | "JSON" | undefined;
-}) => Promise<any>;
-export default visitEndpointOnAnotherServer;

package/dist/cjs/types/helpers/visitEndpointOnAnotherServer/sendServerToServerRequest.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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
- */
-declare const sendServerToServerRequest: (opts: {
-    path: string;
-    host?: string | undefined;
-    method?: "GET" | "POST" | "DELETE" | "PUT" | undefined;
-    params?: {
-        [x: string]: any;
-    } | undefined;
-    responseType?: "Text" | "JSON" | undefined;
-}) => Promise<{
-    body: any;
-    status: number;
-    headers: {
-        [x: string]: any;
-    };
-}>;
-export default sendServerToServerRequest;

package/dist/cjs/types/server/initCrossServerCredentialCollection.d.ts

@@ -1,8 +0,0 @@
-/**
- * Initialize a cross-server credential collection given the dce-mango Collection class
- * @author Gabe Abrams
- * @param Collection the Collection class from dce-mango
- * @returns initialized logCollection
- */
-declare const initCrossServerCredentialCollection: (Collection: any) => any;
-export default initCrossServerCredentialCollection;

package/dist/cjs/types/server/initLogCollection.d.ts

@@ -1,8 +0,0 @@
-/**
- * Initialize a log collection given the dce-mango Collection class
- * @author Gabe Abrams
- * @param Collection the Collection class from dce-mango
- * @returns initialized logCollection
- */
-declare const initLogCollection: (Collection: any) => any;
-export default initLogCollection;

package/dist/cjs/types/server/initServer.d.ts

@@ -1,53 +0,0 @@
-type GetLaunchInfoFunction = (req: any) => {
-    launched: boolean;
-    launchInfo?: any;
-};
-/**
- * Get launch info via CACCL
- * @author Gabe Abrams
- * @param req express request object
- * @returns object { launched, launchInfo }
- */
-export declare const cacclGetLaunchInfo: GetLaunchInfoFunction;
-/**
- * Get log collection
- * @author Gabe Abrams
- * @returns log collection if one was included during launch or null if we don't
- *   have a log collection (yet)
- */
-export declare const internalGetLogCollection: () => any;
-/**
- * Get cross-server credential collection
- * @author Gabe Abrams
- * @return cross-server credential collection if one was included during launch or null
- *   if we don't have a cross-server credential collection (yet)
- */
-export declare const internalGetCrossServerCredentialCollection: () => any;
-/**
- * Prepare dce-reactkit to run on the server
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.app express app from inside of the postprocessor function that
- *   we will add routes to
- * @param opts.getLaunchInfo CACCL LTI's get launch info function
- * @param [opts.logCollection] mongo collection from dce-mango to use for
- *   storing logs. If none is included, logs are written to the console
- * @param [opts.logReviewAdmins=all] info on which admins can review
- *   logs from the client. If not included, all Canvas admins are allowed to
- *   review logs. If null, no Canvas admins are allowed to review logs.
- *   If an array of Canvas userIds (numbers), only Canvas admins with those
- *   userIds are allowed to review logs. If a dce-mango collection, only
- *   Canvas admins with entries in that collection ({ userId, ...}) are allowed
- *   to review logs
- * @param [opts.crossServerCredentialCollection] mongo collection from dce-mango to use for
- *   storing cross-server credentials. If none is included, cross-server credentials
- *   are not supported
- */
-declare const initServer: (opts: {
-    app: any;
-    getLaunchInfo: GetLaunchInfoFunction;
-    logCollection?: any;
-    logReviewAdmins?: (number[] | any);
-    crossServerCredentialCollection?: any;
-}) => void;
-export default initServer;

package/dist/cjs/types/types/CrossServerCredential.d.ts

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

package/dist/esm/types/components/ItemPicker/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/esm/types/helpers/addDBEditorEndpoints.d.ts

@@ -1,41 +0,0 @@
-import express from 'express';
-/**
- * Interface for a collection in the database
- * @author Yuen Ler Chow
- */
-type DCEMangoCollection = {
-    /**
-     * Find all items in the collection that match the filter query
-     * @param filterQuery query for the filter
-     * @returns list of items that match the filter query
-     */
-    find: (filterQuery: any) => Promise<any[]>;
-    /**
-     * Insert an item into the collection
-     * @param item the item to insert
-     */
-    insert: (item: any) => Promise<void>;
-    /**
-     * Delete an item in the collection
-     * @param id the id of the item to delete
-     */
-    delete: (filterQuery: {
-        id: string;
-    }) => Promise<void>;
-};
-/**
- * Add all routes for the DBEditor
- * @author Yuen Ler Chow
- * @param opts object containing all arguments
- * @param opts.app express app to add routes too
- * @param opts.collectionName the name of the collection
- * @param opts.adminsOnly true if the endpoint is for admins only
- * @param opts.collection dce-mango db collection
- */
-declare const addDBEditorEndpoints: (opts: {
-    app: express.Application;
-    collectionName: string;
-    adminsOnly: boolean;
-    collection: DCEMangoCollection;
-}) => void;
-export default addDBEditorEndpoints;

package/dist/esm/types/helpers/dataSigner.d.ts

@@ -1,40 +0,0 @@
-/**
- * Sign a request and get the new request params
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.method the method to sign
- * @param opts.path the http request path
- * @param opts.params the data in the body to sign
- * @param opts.key the reactkit key to sign with
- * @param opts.secret the reactkit secret to sign with
- * @return augmented params for the request, including a signature, timestamp, and key
- */
-export declare const signRequest: (opts: {
-    method: string;
-    path: string;
-    params: {
-        [key: string]: any;
-    };
-    key: string;
-    secret: string;
-}) => Promise<{
-    [key: string]: any;
-}>;
-/**
- * Validate a signed request. Throws an error if invalid
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.method the method of the data validate
- * @param opts.path the http request path to validate
- * @param opts.scope the name of the scope to validate
- * @param opts.params the request data to validate
- * @returns parsed and validated params
- */
-export declare const validateSignedRequest: (opts: {
-    method: string;
-    path: string;
-    scope: string;
-    params: {
-        [key: string]: any;
-    };
-}) => Promise<void>;

package/dist/esm/types/helpers/genRouteHandler.d.ts

@@ -1,76 +0,0 @@
-import ParamType from '../types/ParamType';
-import LogFunction from '../types/LogFunction';
-/**
- * Generate an express API route handler
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.paramTypes map containing the types for each parameter that is
- *   included in the request (map: param name => type)
- * @param opts.handler function that processes the request
- * @param [opts.crossServerScope] the scope associated with this endpoint.
- *   If defined, this is a cross-server endpoint, which will never
- *   have any launch data, will never check Canvas roles or launch status, and will
- *   instead use scopes and reactkit credentials to sign and validate requests.
- *   Never start the path with /api/ttm or /api/admin if the endpoint is a cross-server
- *   endpoint because those roles will not be validated
- * @param [opts.skipSessionCheck=true if crossServerScope defined] if true, skip
- *   the session check (allow users to not be logged in and launched via LTI).
- *   If crossServerScope is defined, this is always true
- * @param [opts.unhandledErrorMessagePrefix] if included, when an error that
- *   is not of type ErrorWithCode is thrown, the client will receive an error
- *   where the error message is prefixed with this string. For example,
- *   if unhandledErrorMessagePrefix is
- *   'While saving progress, we encountered an error:'
- *   and the error is 'progressInfo is not an object',
- *   the client will receive an error with the message
- *   'While saving progress, we encountered an error: progressInfo is not an object'
- * @returns express route handler that takes the following arguments:
- *   params (map: param name => value),
- *   req (express request object),
- *   next (express next function),
- *   send (a function that sends a string to the client),
- *   redirect (takes a url and redirects the user to that url),
- *   renderErrorPage (shows a static error page to the user),
- *   renderInfoPage (shows a static info page to the user),
- *   renderCustomHTML (renders custom html and sends it to the user),
- *   and returns the value to send to the client as a JSON API response, or
- *   calls next() or redirect(...) or send(...) or renderErrorPage(...).
- *   Note: params also has userId, userFirstName,
- *   userLastName, userEmail, userAvatarURL, isLearner, isTTM, isAdmin,
- *   and any other variables that
- *   are directly added to the session, if the user does have a session.
- */
-declare const genRouteHandler: (opts: {
-    paramTypes?: {
-        [k: string]: ParamType;
-    } | undefined;
-    handler: (opts: {
-        params: {
-            [k: string]: any;
-        };
-        req: any;
-        next: () => void;
-        redirect: (pathOrURL: string) => void;
-        send: (text: string, status?: number) => void;
-        renderErrorPage: (opts?: {
-            title?: string;
-            description?: string;
-            code?: string;
-            pageTitle?: string;
-            status?: number;
-        }) => void;
-        renderInfoPage: (opts: {
-            title: string;
-            body: string;
-        }) => void;
-        renderCustomHTML: (opts: {
-            html: string;
-            status?: number;
-        }) => void;
-        logServerEvent: LogFunction;
-    }) => any;
-    crossServerScope?: string | undefined;
-    skipSessionCheck?: boolean | undefined;
-    unhandledErrorMessagePrefix?: string | undefined;
-}) => (req: any, res: any, next: () => void) => Promise<undefined>;
-export default genRouteHandler;

package/dist/esm/types/helpers/handleError.d.ts

@@ -1,18 +0,0 @@
-/**
- * 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)
- */
-declare const handleError: (res: any, error: ({
-    message: any;
-    code?: string;
-    status?: number;
-} | Error | string | any)) => undefined;
-export default handleError;

package/dist/esm/types/helpers/handleSuccess.d.ts

@@ -1,8 +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
- */
-declare const handleSuccess: (res: any, body: any) => undefined;
-export default handleSuccess;

package/dist/esm/types/helpers/parseUserAgent.d.ts

@@ -1,17 +0,0 @@
-/**
- * Perform a rudimentary parsing of the user's browser agent string
- * @author Gabe Abrams
- * @param userAgent the user's browser agent
- * @returns user info
- */
-declare const parseUserAgent: (userAgent: string) => {
-    browser: {
-        name: string;
-        version: string;
-    };
-    device: {
-        isMobile: boolean;
-        os: string;
-    };
-};
-export default parseUserAgent;

package/dist/esm/types/helpers/visitEndpointOnAnotherServer/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Visit an endpoint on another server
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.method the method of the endpoint
- * @param opts.path the path of the other server's endpoint
- * @param opts.host the host of the other server
- * @param [opts.params={}] query/body parameters to include
- * @param [opts.responseType=JSON] the response type from the other server
- */
-declare const visitEndpointOnAnotherServer: (opts: {
-    method: 'GET' | 'POST' | 'DELETE' | 'PUT';
-    path: string;
-    host: string;
-    params?: {
-        [x: string]: any;
-    } | undefined;
-    responseType?: "Text" | "JSON" | undefined;
-}) => Promise<any>;
-export default visitEndpointOnAnotherServer;

package/dist/esm/types/helpers/visitEndpointOnAnotherServer/sendServerToServerRequest.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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
- */
-declare const sendServerToServerRequest: (opts: {
-    path: string;
-    host?: string | undefined;
-    method?: "GET" | "POST" | "DELETE" | "PUT" | undefined;
-    params?: {
-        [x: string]: any;
-    } | undefined;
-    responseType?: "Text" | "JSON" | undefined;
-}) => Promise<{
-    body: any;
-    status: number;
-    headers: {
-        [x: string]: any;
-    };
-}>;
-export default sendServerToServerRequest;

package/dist/esm/types/server/initCrossServerCredentialCollection.d.ts

@@ -1,8 +0,0 @@
-/**
- * Initialize a cross-server credential collection given the dce-mango Collection class
- * @author Gabe Abrams
- * @param Collection the Collection class from dce-mango
- * @returns initialized logCollection
- */
-declare const initCrossServerCredentialCollection: (Collection: any) => any;
-export default initCrossServerCredentialCollection;

package/dist/esm/types/server/initLogCollection.d.ts

@@ -1,8 +0,0 @@
-/**
- * Initialize a log collection given the dce-mango Collection class
- * @author Gabe Abrams
- * @param Collection the Collection class from dce-mango
- * @returns initialized logCollection
- */
-declare const initLogCollection: (Collection: any) => any;
-export default initLogCollection;

package/dist/esm/types/server/initServer.d.ts

@@ -1,53 +0,0 @@
-type GetLaunchInfoFunction = (req: any) => {
-    launched: boolean;
-    launchInfo?: any;
-};
-/**
- * Get launch info via CACCL
- * @author Gabe Abrams
- * @param req express request object
- * @returns object { launched, launchInfo }
- */
-export declare const cacclGetLaunchInfo: GetLaunchInfoFunction;
-/**
- * Get log collection
- * @author Gabe Abrams
- * @returns log collection if one was included during launch or null if we don't
- *   have a log collection (yet)
- */
-export declare const internalGetLogCollection: () => any;
-/**
- * Get cross-server credential collection
- * @author Gabe Abrams
- * @return cross-server credential collection if one was included during launch or null
- *   if we don't have a cross-server credential collection (yet)
- */
-export declare const internalGetCrossServerCredentialCollection: () => any;
-/**
- * Prepare dce-reactkit to run on the server
- * @author Gabe Abrams
- * @param opts object containing all arguments
- * @param opts.app express app from inside of the postprocessor function that
- *   we will add routes to
- * @param opts.getLaunchInfo CACCL LTI's get launch info function
- * @param [opts.logCollection] mongo collection from dce-mango to use for
- *   storing logs. If none is included, logs are written to the console
- * @param [opts.logReviewAdmins=all] info on which admins can review
- *   logs from the client. If not included, all Canvas admins are allowed to
- *   review logs. If null, no Canvas admins are allowed to review logs.
- *   If an array of Canvas userIds (numbers), only Canvas admins with those
- *   userIds are allowed to review logs. If a dce-mango collection, only
- *   Canvas admins with entries in that collection ({ userId, ...}) are allowed
- *   to review logs
- * @param [opts.crossServerCredentialCollection] mongo collection from dce-mango to use for
- *   storing cross-server credentials. If none is included, cross-server credentials
- *   are not supported
- */
-declare const initServer: (opts: {
-    app: any;
-    getLaunchInfo: GetLaunchInfoFunction;
-    logCollection?: any;
-    logReviewAdmins?: (number[] | any);
-    crossServerCredentialCollection?: any;
-}) => void;
-export default initServer;

package/dist/esm/types/types/CrossServerCredential.d.ts

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