dceky 1.0.0-beta.6 → 1.0.3

package/lib/src/commands/assertDoesNotHaveClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertDoesNotHaveClass.js","sourceRoot":"","sources":["../../../src/commands/assertDoesNotHaveClass.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AA2BjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,sBAAsB,GAAG;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,wBAAwB,EACxB,UACE,IAGC;QAED,EAAE,CAAC,GAAG,CAAC,iBAAU,IAAI,CAAC,IAAI,kCAAwB,IAAI,CAAC,SAAS,CAAE,CAAC,CAAC;QACpE,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,sBAAsB,CAAC"}

package/lib/src/commands/assertHasClass.d.ts

@@ -0,0 +1,20 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Assert that an element has a specific className
+             * @author Yuen Ler Chow
+             * @param opts object containing all arguments
+             * @param opts.item the css selector for finding the element
+             * @param opts.className the className to check for
+             * @return Cypress chainable containing the element that was checked
+             */
+            assertHasClass(opts: {
+                item: string;
+                className: string;
+            }): Chainable<JQuery<HTMLElement>>;
+        }
+    }
+}
+declare const assertHasClass: () => void;
+export default assertHasClass;

package/lib/src/commands/assertHasClass.js

@@ -0,0 +1,17 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var assertHasClass = function () {
+    Cypress.Commands.add('assertHasClass', function (opts) {
+        cy.log("Assert ".concat(opts.item, " has class ").concat(opts.className));
+        return cy.get(opts.item).should('have.class', opts.className);
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = assertHasClass;
+//# sourceMappingURL=assertHasClass.js.map

package/lib/src/commands/assertHasClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertHasClass.js","sourceRoot":"","sources":["../../../src/commands/assertHasClass.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AA2BjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,cAAc,GAAG;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,gBAAgB,EAChB,UACE,IAGC;QAED,EAAE,CAAC,GAAG,CAAC,iBAAU,IAAI,CAAC,IAAI,wBAAc,IAAI,CAAC,SAAS,CAAE,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,cAAc,CAAC"}

package/lib/src/commands/assertNumElements.d.ts

@@ -0,0 +1,19 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Assert a certain number of elements
+             * @author Yuen Ler Chow
+             * @param opts object containing all arguments
+             * @param opts.item a CSS selector corresponding to the item
+             * @param opts.num the precise number of elements expected
+             */
+            assertNumElements(opts: {
+                item: string;
+                num: number;
+            }): Chainable<Element>;
+        }
+    }
+}
+declare const assertNumElements: () => void;
+export default assertNumElements;

package/lib/src/commands/assertNumElements.js

@@ -0,0 +1,17 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var assertNumElements = function () {
+    Cypress.Commands.add('assertNumElements', function (opts) {
+        cy.log("Assert ".concat(opts.num, " elements match ").concat(opts.item));
+        cy.get(opts.item).should('have.length', opts.num);
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = assertNumElements;
+//# sourceMappingURL=assertNumElements.js.map

package/lib/src/commands/assertNumElements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNumElements.js","sourceRoot":"","sources":["../../../src/commands/assertNumElements.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AA0BjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,iBAAiB,GAAG;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,mBAAmB,EACnB,UACE,IAGC;QAED,EAAE,CAAC,GAAG,CAAC,iBAAU,IAAI,CAAC,GAAG,6BAAmB,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC;QACzD,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,iBAAiB,CAAC"}

package/lib/src/commands/extractDataFromClass.d.ts

@@ -0,0 +1,18 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Obtain data from a class attribute that starts with a specific prefix
+             * and return it
+             * @author Allison Zhang
+             * @param selector the css selector for finding the element
+             * @param classPrefix the prefix to look for in the class attribute
+             * @returns the extracted data
+             * @example cy.extractDataFromClass('.item', 'data-').then((data) => { ... })
+             */
+            extractDataFromClass(selector: string, classPrefix: string): Chainable<string[]>;
+        }
+    }
+}
+declare const extractDataFromClass: () => void;
+export default extractDataFromClass;

package/lib/src/commands/extractDataFromClass.js

@@ -0,0 +1,25 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var extractDataFromClass = function () {
+    Cypress.Commands.add('extractDataFromClass', function (selector, classPrefix) {
+        return (cy
+            .get(selector)
+            .invoke('attr', 'class')
+            .then(function (classAttr) {
+            var classList = classAttr.split(' ');
+            var data = classList
+                .filter(function (className) { return className.startsWith(classPrefix); })
+                .map(function (className) { return className.replace(classPrefix, ''); });
+            return data;
+        }));
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = extractDataFromClass;
+//# sourceMappingURL=extractDataFromClass.js.map

package/lib/src/commands/extractDataFromClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractDataFromClass.js","sourceRoot":"","sources":["../../../src/commands/extractDataFromClass.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AA0BjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,oBAAoB,GAAG;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,EAAE,UAAC,QAAgB,EAAE,WAAmB;QACjF,OAAO,CACL,EAAE;aACC,GAAG,CAAC,QAAQ,CAAC;aACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aACvB,IAAI,CAAC,UAAC,SAAiB;YACtB,IAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,IAAM,IAAI,GAAG,SAAS;iBACnB,MAAM,CAAC,UAAC,SAAS,IAAO,OAAO,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;iBACpE,GAAG,CAAC,UAAC,SAAS,IAAO,OAAO,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,oBAAoB,CAAC"}

package/lib/src/commands/extractDataFromClassByContents.d.ts

@@ -0,0 +1,19 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Obtain data from a class attribute that starts with a specific prefix
+             * and with specific contents, and return it
+             * @author Allison Zhang
+             * @param contents the contents of the element to find
+             * @param selector the css selector for finding the element
+             * @param classPrefix the prefix to look for in the class attribute
+             * @returns the extracted data
+             * @example cy.extractDataFromClassByContents('Submit', '.button', 'btn-').then((data) => { ... })
+             */
+            extractDataFromClassByContents(contents: string, selector: string, classPrefix: string): Chainable<string[]>;
+        }
+    }
+}
+declare const extractDataFromClassByContents: () => void;
+export default extractDataFromClassByContents;

package/lib/src/commands/extractDataFromClassByContents.js

@@ -0,0 +1,26 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var extractDataFromClassByContents = function () {
+    Cypress.Commands.add('extractDataFromClassByContents', function (contents, selector, classPrefix) {
+        return (cy
+            .get(selector)
+            .contains(contents)
+            .invoke('attr', 'class')
+            .then(function (classAttr) {
+            var classList = classAttr.split(' ');
+            var data = classList
+                .filter(function (className) { return className.startsWith(classPrefix); })
+                .map(function (className) { return className.replace(classPrefix, ''); });
+            return data;
+        }));
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = extractDataFromClassByContents;
+//# sourceMappingURL=extractDataFromClassByContents.js.map

package/lib/src/commands/extractDataFromClassByContents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractDataFromClassByContents.js","sourceRoot":"","sources":["../../../src/commands/extractDataFromClassByContents.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AA4BjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,8BAA8B,GAAG;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,gCAAgC,EAAE,UAAC,QAAgB,EAAE,QAAgB,EAAE,WAAmB;QAC7G,OAAO,CACL,EAAE;aACC,GAAG,CAAC,QAAQ,CAAC;aACb,QAAQ,CAAC,QAAQ,CAAC;aAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aACvB,IAAI,CAAC,UAAC,SAAiB;YACtB,IAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,IAAM,IAAI,GAAG,SAAS;iBACnB,MAAM,CAAC,UAAC,SAAS,IAAO,OAAO,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;iBACpE,GAAG,CAAC,UAAC,SAAS,IAAO,OAAO,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,8BAA8B,CAAC"}

package/lib/src/commands/getJSON.d.ts

@@ -0,0 +1,16 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Obtain JSON data from a request and return it.
+             * @author Allison Zhang
+             * @param url the URL to fetch the JSON data from
+             * @returns the JSON data
+             * @example cy.getJSON('https://api.example.com/data').then((data) => { ... })
+             */
+            getJSON(url: string): Chainable<any>;
+        }
+    }
+}
+declare const getJSON: () => void;
+export default getJSON;

package/lib/src/commands/getJSON.js

@@ -0,0 +1,21 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var getJSON = function () {
+    Cypress.Commands.add('getJSON', function (url) {
+        return (cy
+            .request(url)
+            .its('body')
+            .then(function (body) {
+            return body;
+        }));
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = getJSON;
+//# sourceMappingURL=getJSON.js.map

package/lib/src/commands/getJSON.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJSON.js","sourceRoot":"","sources":["../../../src/commands/getJSON.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AAuBjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,OAAO,GAAG;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAC,GAAW;QAC1C,OAAO,CACL,EAAE;aACC,OAAO,CAAC,GAAG,CAAC;aACZ,GAAG,CAAC,MAAM,CAAC;aACX,IAAI,CAAC,UAAC,IAAI;YACT,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,OAAO,CAAC"}

package/lib/src/commands/getNumElements.d.ts

@@ -0,0 +1,15 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Get number of elements
+             * @author Yuen Ler Chow
+             * @param selector a CSS selector corresponding to the item to count
+             * @return Cypress chainable containing the number of elements matching the selector
+             */
+            getNumElements(selector: string): Chainable<number>;
+        }
+    }
+}
+declare const getNumElements: () => void;
+export default getNumElements;

package/lib/src/commands/getNumElements.js

@@ -0,0 +1,19 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var getNumElements = function () {
+    Cypress.Commands.add('getNumElements', function (selector) {
+        cy.log("Count elements matching ".concat(selector));
+        return cy.get(selector).then(function ($elements) {
+            return Cypress.$($elements).length;
+        });
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = getNumElements;
+//# sourceMappingURL=getNumElements.js.map

package/lib/src/commands/getNumElements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNumElements.js","sourceRoot":"","sources":["../../../src/commands/getNumElements.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AAsBjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,cAAc,GAAG;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,gBAAgB,EAChB,UACE,QAAgB;QAEhB,EAAE,CAAC,GAAG,CAAC,kCAA2B,QAAQ,CAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAC,SAA8B;YAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,cAAc,CAAC"}

package/lib/src/commands/handleHarvardKey.d.ts

@@ -0,0 +1,15 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Handle a HarvardKey login page for a user
+             * @author Yuen Ler Chow
+             * @param name the name of the user environment variable
+             * @return Cypress chainable (void) - performs authentication flow, no return value
+             */
+            handleHarvardKey(name: string): Chainable<void>;
+        }
+    }
+}
+declare const handleHarvardKey: () => void;
+export default handleHarvardKey;

package/lib/src/commands/handleHarvardKey.js

@@ -0,0 +1,53 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var handleHarvardKey = function () {
+    Cypress.Commands.add('handleHarvardKey', function (name) {
+        cy.log('Handling HarvardKey authentication');
+        var userInfo = Cypress.env(name);
+        if (!userInfo) {
+            throw new Error("Could not find ".concat(name, " in environment variables"));
+        }
+        // Destructure the user info object to get the username and password
+        var username = userInfo.username;
+        var password = userInfo.password;
+        // Get the Harvard login URL using originWithKaixa with auto-initialized functions
+        cy.origin('https://apps.cirrusidentity.com', function () {
+            Cypress.require('dceky');
+            // Clicking the button doesn't work for some reason, so we access the href attribute instead
+            return cy.navigateToHref('#idp_1001962798_button');
+        }).then(function (fullUrl) {
+            // Navigate to the Harvard login page using originWithKaixa
+            cy.origin('https://harvard.idp.cirrusidentity.com', {
+                args: { username: username, password: password, fullUrl: fullUrl },
+            }, function (args) {
+                Cypress.require('dceky');
+                var harvardUsername = args.username, harvardPassword = args.password, harvardLoginUrl = args.fullUrl;
+                cy.on('uncaught:exception', function (e) {
+                    // Ignore known HarvardKey errors
+                    if (!e.message.includes('ready is not defined')) {
+                        throw e;
+                    }
+                    return false;
+                });
+                // Visit the Harvard login page
+                cy.visit(harvardLoginUrl);
+                // Wait for and fill in the login form
+                cy.waitForElementVisible('#username');
+                cy.waitForElementVisible('#password');
+                cy.typeInto({ item: '#username', text: harvardUsername });
+                cy.typeInto({ item: '#password', text: harvardPassword });
+                // Submit the form
+                cy.get('input[type="submit"], button[type="submit"], .btn-primary').click();
+            });
+        });
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = handleHarvardKey;
+//# sourceMappingURL=handleHarvardKey.js.map

package/lib/src/commands/handleHarvardKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleHarvardKey.js","sourceRoot":"","sources":["../../../src/commands/handleHarvardKey.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AAsBjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,gBAAgB,GAAG;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,kBAAkB,EAClB,UACE,IAAY;QAEZ,EAAE,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAE7C,IAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAkB,IAAI,8BAA2B,CAAC,CAAC;QACrE,CAAC;QAED,oEAAoE;QAC5D,IAAA,QAAQ,GAAK,QAAQ,SAAb,CAAc;QACtB,IAAA,QAAQ,GAAK,QAAQ,SAAb,CAAc;QAE9B,kFAAkF;QAClF,EAAE,CAAC,MAAM,CAAC,iCAAiC,EAAE;YAC3C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzB,4FAA4F;YAC5F,OAAO,EAAE,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,IAAI,CAAC,UAAC,OAAe;YACxB,2DAA2D;YACzD,EAAE,CAAC,MAAM,CAAC,wCAAwC,EAAE;gBAClD,IAAI,EAAE,EAAE,QAAQ,UAAA,EAAE,QAAQ,UAAA,EAAE,OAAO,SAAA,EAAE;aACtC,EAAE,UAAC,IAAI;gBACN,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAEvB,IAAU,eAAe,GAGvB,IAAI,SAHmB,EACf,eAAe,GAEvB,IAAI,SAFmB,EAChB,eAAe,GACtB,IAAI,QADkB,CACjB;gBAET,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,UAAC,CAAQ;oBACnC,iCAAiC;oBACjC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;wBAChD,MAAM,CAAC,CAAC;oBACV,CAAC;oBACD,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC,CAAC;gBAEH,+BAA+B;gBAC/B,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBAE1B,sCAAsC;gBACtC,EAAE,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;gBACtC,EAAE,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;gBAEtC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;gBAC1D,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;gBAE1D,kBAAkB;gBAClB,EAAE,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,gBAAgB,CAAC"}

package/lib/src/commands/launchAs.d.ts

@@ -0,0 +1,25 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Log into Canvas and launch an LTI app as a specific user from environment variables.
+             * The user should be defined as an environment variable with the following properties:
+             * - accessToken: Canvas access token for the user (required for production mode)
+             * - type: User type ('student', 'ta', 'teacher') for local mode (defaults to 'teacher')
+             * - simIndex: Simulator index for local mode (defaults to '0')
+             * @author Yuen Ler Chow
+             * @param name the name of the user environment variable
+             * @param opts object containing all arguments
+              * @param [opts.courseId] the Canvas ID of the course to launch from
+              * @param [opts.appName] the name of the app as it appears in the course's left-hand nav
+             * @return Cypress chainable (void) - launches the LTI app, no return value
+             */
+            launchAs(name: string, opts?: {
+                courseId?: number;
+                appName?: string;
+            }): Chainable<void>;
+        }
+    }
+}
+declare const launchAs: () => void;
+export default launchAs;

package/lib/src/commands/launchAs.js

@@ -0,0 +1,66 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var launchAs = function () {
+    Cypress.Commands.add('launchAs', function (name, opts) {
+        if (opts === void 0) { opts = {}; }
+        var courseId = opts.courseId, appName = opts.appName;
+        // Get courseId from environment variables if not provided
+        if (!courseId) {
+            var envCourseId = Cypress.env('courseId');
+            if (!envCourseId) {
+                throw new Error('Could not find courseId in environment variables');
+            }
+            courseId = Number.parseInt(envCourseId, 10);
+        }
+        // Get appName from environment variables if not provided
+        appName = appName || Cypress.env('appName');
+        if (!appName) {
+            throw new Error('Could not find appName in environment variables');
+        }
+        // Get user info from environment variables
+        var userInfo = Cypress.env(name);
+        if (!userInfo) {
+            throw new Error("Could not find ".concat(name, " in environment variables"));
+        }
+        cy.log("\uD83D\uDE80 Launch as ".concat(name));
+        // Check if this is a local launch
+        var isLocal = Cypress.env('local') === 'true';
+        if (isLocal) {
+            // Handle local simulator launch
+            var userType = userInfo.type || 'teacher';
+            var simIndex = userInfo.simIndex || '0';
+            var simLaunchButtonId = "".concat(userType, "_").concat(simIndex, "-launch-button");
+            cy.log('Local mode: launching simulator');
+            cy.visit('https://localhost:8088/simulator');
+            // Handle potential SSL certificate issues
+            cy.get('body').then(function ($body) {
+                if ($body.find('.ssl').length > 0) {
+                    cy.log('Handling SSL certificate issue');
+                    cy.get('#details-button').click();
+                    cy.get('#proceed-link').click();
+                }
+            });
+            // Launch the app
+            cy.get("#".concat(simLaunchButtonId)).click();
+            // Click the authorize button
+            cy.get('.authorize-button', { timeout: 1000 }).click();
+            return;
+        }
+        // Handle production launch with access token
+        var accessToken = userInfo.accessToken;
+        if (!accessToken) {
+            throw new Error("Could not find accessToken for ".concat(name, " in environment variables"));
+        }
+        // Launch using the access token
+        cy.launchLTIUsingToken(accessToken, { courseId: courseId, appName: appName });
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = launchAs;
+//# sourceMappingURL=launchAs.js.map

package/lib/src/commands/launchAs.js.map

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

package/lib/src/commands/launchLTIUsingToken.d.ts

@@ -0,0 +1,21 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Log into Canvas using an access token and launch an LTI app
+             * @author Yuen Ler Chow
+             * @param accessToken the user's Canvas access token
+             * @param opts object containing all arguments
+             * @param [opts.courseId] the Canvas ID of the course to launch from
+             * @param [opts.appName] the name of the app as it appears in the course's left-hand nav
+             * @return Cypress chainable (void) - launches the LTI app and navigates to it, no return value
+             */
+            launchLTIUsingToken(accessToken: string, opts?: {
+                courseId?: number;
+                appName?: string;
+            }): Chainable<void>;
+        }
+    }
+}
+declare const launchLTIUsingToken: () => void;
+export default launchLTIUsingToken;

package/lib/src/commands/launchLTIUsingToken.js

@@ -0,0 +1,68 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var launchLTIUsingToken = function () {
+    Cypress.Commands.add('launchLTIUsingToken', function (accessToken, opts) {
+        if (opts === void 0) { opts = {}; }
+        var courseId = opts.courseId, appName = opts.appName;
+        if (!courseId) {
+            var envCourseId = Cypress.env('courseId');
+            if (!envCourseId) {
+                throw new Error('Could not find courseId in environment variables');
+            }
+            courseId = Number.parseInt(envCourseId, 10);
+        }
+        appName = appName || Cypress.env('appName');
+        if (!appName) {
+            throw new Error('Could not find appName in environment variables');
+        }
+        cy.log("Launch LTI app \"".concat(appName, "\" in course ").concat(courseId, " using access token"));
+        // Get the external tools for the course
+        cy.visitCanvasGETEndpoint({
+            path: "/courses/".concat(courseId, "/external_tools"),
+            accessToken: accessToken,
+        }).then(function (externalTools) {
+            cy.log("Found ".concat(externalTools.length, " external tools"));
+            // Find the external tool of interest
+            var matchingTool = externalTools.find(function (externalTool) {
+                // Skip non-nav items
+                if (!externalTool.course_navigation || typeof externalTool.course_navigation !== 'object') {
+                    return false;
+                }
+                // Skip non-labeled items
+                if (!externalTool.course_navigation.text) {
+                    return false;
+                }
+                // Skip if the app name does not match the expected name
+                var thisAppName = externalTool.course_navigation.text.trim().toLowerCase();
+                return thisAppName === appName.trim().toLowerCase();
+            });
+            var toolId = (matchingTool === null || matchingTool === void 0 ? void 0 : matchingTool.id) || 0;
+            if (matchingTool) {
+                cy.log("Found matching app: \"".concat(matchingTool.course_navigation.text, "\" with ID ").concat(toolId));
+            }
+            // Make sure we found the app
+            if (toolId === 0) {
+                throw new Error("Could not find any apps named \"".concat(appName, "\" in course ").concat(courseId));
+            }
+            // Get a sessionless launch URL
+            cy.visitCanvasGETEndpoint({
+                path: "/courses/".concat(courseId, "/external_tools/sessionless_launch?id=").concat(toolId),
+                accessToken: accessToken,
+            }).then(function (sessionlessLaunchInfo) {
+                var launchURL = sessionlessLaunchInfo.url;
+                cy.log("Launching LTI app at: ".concat(launchURL));
+                // Launch the tool
+                cy.visit(launchURL);
+            });
+        });
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = launchLTIUsingToken;
+//# sourceMappingURL=launchLTIUsingToken.js.map

package/lib/src/commands/launchLTIUsingToken.js.map

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

package/lib/src/commands/navigateToHref.d.ts

@@ -0,0 +1,15 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Navigate to href attribute of Harvard identity provider button
+             * @author Yuen Ler Chow
+             * @param item the CSS selector of interest
+             * @return Cypress chainable containing the full URL string (hostname + href attribute value)
+             */
+            navigateToHref(item: string): Chainable<string>;
+        }
+    }
+}
+declare const navigateToHref: () => void;
+export default navigateToHref;

package/lib/src/commands/navigateToHref.js

@@ -0,0 +1,35 @@
+"use strict";
+/// <reference types="cypress" />
+Object.defineProperty(exports, "__esModule", { value: true });
+/*----------------------------------------*/
+/* --------------- Command -------------- */
+/*----------------------------------------*/
+var navigateToHref = function () {
+    Cypress.Commands.add('navigateToHref', function (item) {
+        cy.waitForElementVisible(item);
+        return cy
+            .url()
+            // get origin (protocol + '//' + host) from current URL
+            .then(function (url) {
+            var _a = new URL(url), protocol = _a.protocol, host = _a.host;
+            return "".concat(protocol, "//").concat(host);
+        })
+            .then(function (origin) {
+            return cy
+                .get(item)
+                .invoke('attr', 'href')
+                .then(function (href) {
+                // If the href is a relative URL, prepend the hostname
+                if (href.startsWith('/')) {
+                    return origin + href;
+                }
+                return href;
+            });
+        });
+    });
+};
+/*----------------------------------------*/
+/* --------------- Export --------------- */
+/*----------------------------------------*/
+exports.default = navigateToHref;
+//# sourceMappingURL=navigateToHref.js.map

package/lib/src/commands/navigateToHref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigateToHref.js","sourceRoot":"","sources":["../../../src/commands/navigateToHref.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AAoBjC,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,IAAM,cAAc,GAAG;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,gBAAgB,EAChB,UACE,IAAY;QAEZ,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAE/B,OAAO,EAAE;aACN,GAAG,EAAE;YACN,uDAAuD;aACtD,IAAI,CAAC,UAAC,GAAW;YACV,IAAA,KAAqB,IAAI,GAAG,CAAC,GAAG,CAAC,EAA/B,QAAQ,cAAA,EAAE,IAAI,UAAiB,CAAC;YACxC,OAAO,UAAG,QAAQ,eAAK,IAAI,CAAE,CAAC;QAChC,CAAC,CAAC;aACD,IAAI,CAAC,UAAC,MAAc;YACnB,OAAO,EAAE;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;iBACtB,IAAI,CAAC,UAAC,IAAY;gBACjB,sDAAsD;gBACtD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,OAAO,MAAM,GAAG,IAAI,CAAC;gBACvB,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,4CAA4C;AAC5C,4CAA4C;AAC5C,4CAA4C;AAE5C,kBAAe,cAAc,CAAC"}

package/lib/src/commands/runScript.d.ts

@@ -0,0 +1,15 @@
+declare global {
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Run a script on the page
+             * @author Yuen Ler Chow
+             * @param script the script to run
+             * @return Cypress chainable containing the return value from executing the script
+             */
+            runScript(scriptLines: string): Chainable<any>;
+        }
+    }
+}
+declare const runScript: () => void;
+export default runScript;