Jspsych Surveys

.eslintrc.js

@@ -12,4 +12,5 @@ module.exports = {
   },
   plugins: ["@typescript-eslint"],
   ignorePatterns: ["packages/**/dist/*"],
+  rules: { "require-await": "error" },
 };

.prettierrc

@@ -1,4 +1,5 @@
 {
+  "jsonRecursiveSort": true,
   "plugins": [
     "prettier-plugin-packagejson",
     "prettier-plugin-sort-json",

README.md

@@ -19,6 +19,7 @@ Add build and test script to new package's `package.json`:
 ```json
   "scripts": {
     "test": "jest --coverage",
+    "dev": "rollup --config rollup.config.dev.mjs --watch",
     "build": "rollup --config"
   },
 ```
@@ -53,8 +54,8 @@ Edit `tsconfig.json`:
 ```json
 {
   "compilerOptions": {
-    "strict": true,
-    "baseUrl": "."
+    "baseUrl": ".",
+    "strict": true
   },
   "extends": "@jspsych/config/tsconfig.core.json",
   "include": ["src"]

package.json

@@ -19,15 +19,15 @@
   "scripts": {
     "build": "npm run build --workspaces",
     "changeset": "changeset",
-    "fix": "eslint ./**/*.{ts,mjs} --fix && prettier . -l --write",
+    "fix": "prettier . -l --write && eslint ./**/*.{ts,mjs} --fix",
     "format": "prettier . -c",
     "lint": "eslint ./packages/**/src/**/*.ts --quiet",
     "test": "npm test --workspaces"
   },
   "devDependencies": {
     "@changesets/cli": "^2.27.1",
-    "@typescript-eslint/eslint-plugin": "^6.14.0",
-    "@typescript-eslint/parser": "^6.14.0",
+    "@typescript-eslint/eslint-plugin": "^7.3.1",
+    "@typescript-eslint/parser": "^7.3.1",
     "eslint": "^8.55.0",
     "eslint-config-prettier": "^9.1.0",
     "jest-fetch-mock": "^3.0.3",

packages/data/jest.config.cjs

@@ -0,0 +1,6 @@
+const config = require("@jspsych/config/jest").makePackageConfig(__dirname);
+module.exports = {
+  ...config,
+  moduleNameMapper: {},
+  transformIgnorePatterns: ["node_modules/(?!deep-freeze-es6)"],
+};

packages/lookit-api/package.json → packages/data/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@lookit/lookit-api",
+  "name": "@lookit/data",
   "version": "0.0.1",
   "description": "This is a JS implementation of lookit's RESTful API.",
   "homepage": "https://github.com/lookit/lookit-jspsych#readme",
@@ -9,7 +9,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lookit/lookit-jspsych.git",
-    "directory": "packages/lookit-api"
+    "directory": "packages/data"
   },
   "license": "ISC",
   "author": "Christopher J Green <[email protected]> (https://github.com/okaycj)",
@@ -20,9 +20,12 @@
     "dev": "rollup --config rollup.config.dev.mjs --watch",
     "test": "jest --coverage"
   },
-  "dependencies": {},
+  "dependencies": {
+    "deep-freeze-es6": "^3.0.2"
+  },
   "devDependencies": {
-    "@jspsych/config": "^2.0.0"
+    "@jspsych/config": "^2.0.0",
+    "jest-fetch-mock": "^3.0.3"
   },
   "peerDependencies": {
     "jspsych": "^7.3.4"

packages/lookit-api/rollup.config.mjs → packages/data/rollup.config.mjs

@@ -1,3 +1,3 @@
 import { makeRollupConfig } from "@jspsych/config/rollup";
 
-export default makeRollupConfig("lookitAPI");
+export default makeRollupConfig("chsData");

packages/data/src/api.spec.ts

@@ -0,0 +1,45 @@
+import {
+  finish,
+  retrieveChild,
+  retrievePastSessions,
+  retrieveResponse,
+  retrieveStudy,
+  updateResponse,
+} from "./api";
+
+jest.mock("./utils", () => ({
+  ...jest.requireActual("./utils"),
+  getUuids: jest.fn(),
+  get: jest.fn().mockReturnValue("get response"),
+  patch: jest.fn().mockReturnValue("patch response"),
+}));
+
+test("Api call to get Child", async () => {
+  expect(await retrieveChild()).toStrictEqual("get response");
+});
+
+test("Api call to get Past Sessions", async () => {
+  expect(await retrievePastSessions("some uuid")).toStrictEqual("get response");
+});
+
+test("Api call to get Study", async () => {
+  expect(await retrieveStudy()).toStrictEqual("get response");
+});
+
+test("Api call to get Response", async () => {
+  expect(await retrieveResponse("some uuid")).toStrictEqual("get response");
+});
+
+test("Api call to patch Response", async () => {
+  expect(await updateResponse("some uuid", {})).toStrictEqual("patch response");
+});
+
+test("Check that all calls to API have finished", async () => {
+  expect(await finish()).toStrictEqual([
+    "get response",
+    "get response",
+    "get response",
+    "get response",
+    "patch response",
+  ]);
+});

packages/data/src/api.ts

@@ -0,0 +1,48 @@
+import {
+  Child,
+  PastSession,
+  Promises,
+  Response,
+  ResponseAttrsUpdate,
+  ResponseUpdate,
+  Study,
+} from "./types";
+import { get, getUuids, patch } from "./utils";
+
+const CONFIG = <const>{ ...getUuids() };
+const promises: Promises[] = [];
+
+function deposit<T extends Promises>(promise: T) {
+  promises.push(promise);
+  return promise;
+}
+
+export function finish() {
+  return Promise.all(promises);
+}
+
+export function retrieveChild() {
+  return deposit(get<Child>(`children/${CONFIG.child}/`));
+}
+
+export function retrievePastSessions(uuid: string) {
+  return deposit(get<PastSession[]>(`past-sessions/${uuid}/`));
+}
+
+export function retrieveStudy() {
+  return deposit(get<Study>(`studies/${CONFIG.study}/`));
+}
+
+export function retrieveResponse(uuid: string) {
+  return deposit(get<Response>(`responses/${uuid}/`));
+}
+
+export function updateResponse(uuid: string, data: ResponseAttrsUpdate) {
+  return deposit(
+    patch<ResponseUpdate, Response>(`responses/${uuid}/`, {
+      id: uuid,
+      type: "responses",
+      attributes: data,
+    }),
+  );
+}

packages/data/src/index.spec.ts

@@ -0,0 +1,25 @@
+import Api from "./index";
+
+jest.mock("./utils", () => ({
+  ...jest.requireActual("./utils"),
+  getUuids: jest.fn(),
+}));
+
+jest.mock("./api", () => ({
+  ...jest.requireActual("./api"),
+  retrieveStudy: jest.fn().mockReturnValue("Study"),
+  retrieveChild: jest.fn().mockReturnValue("Child"),
+  retrievePastSessions: jest.fn().mockReturnValue("PastSessions"),
+  retrieveResponse: jest.fn().mockReturnValue("Response"),
+}));
+
+test("Load data for this study into window.chs", async () => {
+  expect(Object.hasOwn(window, "chs")).toBeFalsy();
+  await Api.load("response uuid");
+  expect(window.chs).toEqual({
+    study: "Study",
+    child: "Child",
+    pastSessions: "PastSessions",
+    response: "Response",
+  });
+});

packages/data/src/index.ts

@@ -0,0 +1,37 @@
+import deepFreeze from "deep-freeze-es6";
+import {
+  finish,
+  retrieveChild,
+  retrievePastSessions,
+  retrieveResponse,
+  retrieveStudy,
+  updateResponse,
+} from "./api";
+import { Child, PastSession, Response, Study } from "./types";
+
+declare global {
+  interface Window {
+    chs: {
+      study: Study;
+      child: Child;
+      pastSessions: PastSession[];
+      response: Response;
+    };
+  }
+}
+
+async function load(response_uuid: string) {
+  if (!window.chs) {
+    Object.assign(window, {
+      chs: {
+        study: await retrieveStudy(),
+        child: await retrieveChild(),
+        pastSessions: await retrievePastSessions(response_uuid),
+        response: await retrieveResponse(response_uuid),
+      },
+    });
+    deepFreeze(window.chs);
+  }
+}
+
+export default { load, retrieveResponse, updateResponse, finish };

packages/lookit-api/src/types.ts → packages/data/src/types.ts

@@ -1,3 +1,7 @@
+import { DataCollection } from "jspsych/dist/modules/data/DataCollection";
+
+export type Promises = Promise<Data<Attributes> | Data<Attributes>[]>;
+
 export type Relationship = {
   links: {
     related: string;
@@ -11,6 +15,36 @@ export type Attributes = {
 
 export interface Relationships {}
 
+export interface StudyAttrs extends Attributes {
+  name: string;
+  short_description: string;
+  purpose: string;
+  criteria: string;
+  duration: string;
+  contact_info: string;
+  /** Format: binary */
+  image?: string | null;
+  structure?: Record<string, never>;
+  generator?: string;
+  use_generator?: boolean;
+  display_full_screen?: boolean;
+  /** Format: uri */
+  exit_url?: string;
+  /** @enum {string} */
+  state?:
+    | "created"
+    | "submitted"
+    | "rejected"
+    | "retracted"
+    | "approved"
+    | "active"
+    | "paused"
+    | "deactivated"
+    | "archived";
+  public?: boolean;
+  responses: string[];
+}
+
 export interface ChildAttrs extends Attributes {
   given_name: string;
   birthday: string;
@@ -27,7 +61,7 @@ export interface ChildAttrs extends Attributes {
 export interface PastSessionAttrs extends Attributes {
   conditions?: Record<string, never>;
   global_event_timings?: Record<string, never>;
-  exp_data?: Record<string, never>;
+  exp_data?: DataCollection[];
   sequence?: string[];
   completed?: boolean;
   completed_consent_frame?: boolean;
@@ -59,12 +93,20 @@ export interface ApiResponse<Data> {
   data: Data;
 }
 
+export interface Study extends Data<StudyAttrs> {
+  type: "studies";
+  relationships: {
+    responses: Relationship;
+  };
+}
+
 export interface Child extends Data<ChildAttrs> {
   type: "children";
   relationships: {
     user: Relationship;
   };
 }
+
 export interface PastSession extends Data<PastSessionAttrs> {
   type: "past_sessions";
   relationships: {
@@ -74,3 +116,26 @@ export interface PastSession extends Data<PastSessionAttrs> {
     demographic_snapshot: Relationship;
   };
 }
+
+export interface Response extends Data<PastSessionAttrs> {
+  type: "responses";
+  relationships: {
+    child: Relationship;
+    user: Relationship;
+    study: Relationship;
+    demographic_snapshot: Relationship;
+  };
+}
+
+export interface ResponseUpdate {
+  type: "responses";
+  id: string;
+  attributes: ResponseAttrsUpdate;
+}
+
+export interface ResponseAttrsUpdate {
+  exp_data?: DataCollection[];
+  completed?: boolean;
+  survey_consent?: boolean;
+  completed_consent_frame?: boolean;
+}