@coorpacademy/app-review 0.0.14 → 0.0.16

package/lib/services/fetch-responses.js

@@ -0,0 +1,118 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toVoid = exports.toText = exports.toJSON = exports.ResponseError = void 0;
+var ResponseError = /** @class */ (function (_super) {
+    __extends(ResponseError, _super);
+    function ResponseError(status, statusText, body) {
+        if (body === void 0) { body = ''; }
+        var _this = _super.call(this, "".concat(statusText, " ").concat(body).trim()) || this;
+        _this.name = 'ResponseError';
+        _this.statusCode = status;
+        return _this;
+    }
+    return ResponseError;
+}(Error));
+exports.ResponseError = ResponseError;
+var toJSON = function (response) { return __awaiter(void 0, void 0, void 0, function () {
+    var body, err_1;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!!response.ok) return [3 /*break*/, 2];
+                return [4 /*yield*/, response.text()];
+            case 1:
+                body = _a.sent();
+                throw new ResponseError(response.status, response.statusText, body);
+            case 2:
+                _a.trys.push([2, 4, , 5]);
+                return [4 /*yield*/, response.json()];
+            case 3: return [2 /*return*/, _a.sent()];
+            case 4:
+                err_1 = _a.sent();
+                throw new ResponseError(response.status, response.statusText);
+            case 5: return [2 /*return*/];
+        }
+    });
+}); };
+exports.toJSON = toJSON;
+var toText = function (response) { return __awaiter(void 0, void 0, void 0, function () {
+    var body;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, response.text()];
+            case 1:
+                body = _a.sent();
+                if (!response.ok) {
+                    throw new ResponseError(response.status, response.statusText, body);
+                }
+                return [2 /*return*/, body];
+        }
+    });
+}); };
+exports.toText = toText;
+var toVoid = function (response) { return __awaiter(void 0, void 0, void 0, function () {
+    var body;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!!response.ok) return [3 /*break*/, 2];
+                return [4 /*yield*/, response.text()];
+            case 1:
+                body = _a.sent();
+                throw new ResponseError(response.status, response.statusText, body);
+            case 2: return [2 /*return*/];
+        }
+    });
+}); };
+exports.toVoid = toVoid;

package/lib/services/fetch.mocks.d.ts

@@ -0,0 +1,10 @@
+import { Response } from './fetch-responses';
+export declare const toResponse: (status: number, statusText: string, body: string) => Promise<Response>;
+declare type FetchFunction = () => Promise<Response>;
+export declare const okJSONResponse: (body: unknown) => FetchFunction;
+export declare const internalServerErrorJSONResponse: (body: unknown) => FetchFunction;
+export declare const notFoundJSONResponse: (body: unknown) => FetchFunction;
+export declare const okTextResponse: (body: string) => FetchFunction;
+export declare const internalServerErrorTextResponse: (body: string) => FetchFunction;
+export {};
+//# sourceMappingURL=fetch.mocks.d.ts.map

package/lib/services/fetch.mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.mocks.d.ts","sourceRoot":"","sources":["../../src/services/fetch.mocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAE3C,eAAO,MAAM,UAAU,WAAY,MAAM,cAAc,MAAM,QAAQ,MAAM,KAAG,QAAQ,QAAQ,CAO1F,CAAC;AAEL,aAAK,aAAa,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7C,eAAO,MAAM,cAAc,SAAU,OAAO,KAAG,aACF,CAAC;AAE9C,eAAO,MAAM,+BAA+B,SAAU,OAAO,KAAG,aACF,CAAC;AAE/D,eAAO,MAAM,oBAAoB,SAAU,OAAO,KAAG,aACD,CAAC;AAErD,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,aAAkD,CAAC;AAEjG,eAAO,MAAM,+BAA+B,SAAU,MAAM,KAAG,aACjB,CAAC"}

package/lib/services/fetch.mocks.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internalServerErrorTextResponse = exports.okTextResponse = exports.notFoundJSONResponse = exports.internalServerErrorJSONResponse = exports.okJSONResponse = exports.toResponse = void 0;
+var toResponse = function (status, statusText, body) {
+    return Promise.resolve({
+        ok: status < 400,
+        status: status,
+        statusText: statusText,
+        json: function () { return Promise.resolve(body).then(JSON.parse); },
+        text: function () { return Promise.resolve(body); }
+    });
+};
+exports.toResponse = toResponse;
+var okJSONResponse = function (body) { return function () {
+    return (0, exports.toResponse)(200, 'OK', JSON.stringify(body));
+}; };
+exports.okJSONResponse = okJSONResponse;
+var internalServerErrorJSONResponse = function (body) { return function () {
+    return (0, exports.toResponse)(500, 'InternalServerError', JSON.stringify(body));
+}; };
+exports.internalServerErrorJSONResponse = internalServerErrorJSONResponse;
+var notFoundJSONResponse = function (body) { return function () {
+    return (0, exports.toResponse)(404, 'Not Found', JSON.stringify(body));
+}; };
+exports.notFoundJSONResponse = notFoundJSONResponse;
+var okTextResponse = function (body) { return function () { return (0, exports.toResponse)(200, 'OK', body); }; };
+exports.okTextResponse = okTextResponse;
+var internalServerErrorTextResponse = function (body) { return function () {
+    return (0, exports.toResponse)(500, 'InternalServerError', body);
+}; };
+exports.internalServerErrorTextResponse = internalServerErrorTextResponse;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@coorpacademy/app-review",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "",
-  "type": "module",
   "engines": {
     "node": ">=16.15.0"
   },
+  "license": "UNLICENSED",
   "scripts": {
     "start": "node commands/start.js",
     "static": "node commands/build-static-webapp.js",
@@ -17,7 +17,7 @@
     "clean:commonjs": "rm -rf lib",
     "clean:es": "rm -rf es",
     "clean": "concurrently \"npm run clean:commonjs\" \"npm run clean:es\"",
-    "test:unit": "echo @todo setup unit tests"
+    "test:unit": "ava"
   },
   "author": "CoorpAcademy",
   "files": [
@@ -36,7 +36,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@coorpacademy/components": "10.19.6",
+    "@coorpacademy/components": "10.19.8",
+    "cross-fetch": "^3.1.5",
+    "jwt-decode": "^3.1.2",
     "react-redux": "^8.0.1",
     "redux": "^4.2.0"
   },
@@ -45,17 +47,20 @@
     "react-native": "0.68.1"
   },
   "devDependencies": {
-    "@storybook/react-native": "^5.3.25",
-    "chalk": "^5.0.1",
+    "ava": "^4.2.0",
+    "chalk": "^4.1.2",
     "concurrently": "^5.2.0",
     "connect-history-api-fallback": "^1.6.0",
+    "dotenv": "^16.0.1",
     "esbuild": "^0.14.39",
-    "esbuild-css-modules-plugin": "^2.2.16",
+    "esbuild-css-modules-plugin": "https://github.com/chrisdugne/esbuild-css-modules-plugin#main",
     "esbuild-plugin-svgr": "^1.0.1",
     "live-server": "^1.2.2",
+    "postcss-modules-values-replace": "^3.4.0",
     "react-dom": "^17.0.2",
     "redux-devtools-extension": "^2.13.9",
+    "ts-node": "^10.8.0",
     "typescript": "^4.6.4"
   },
-  "gitHead": "24bbf404184a7bacb5a5e85cb35263be7af457dc"
+  "gitHead": "73a9a8b3c5df00a744f15f7be8bbc104f4e21386"
 }

package/readme.md

@@ -1,18 +1,48 @@
 # App Review
 
+📚 [Static Demo](http://coorpacademy.github.io/components/app-review)
+
 ## start local sandbox
 
 ```sh
 npm start
 ```
 
+requirements:
+
+- [mooc](https://github.com/CoorpAcademy/coorpacademy) installed and running to expose a local API.
+- duplicated `.env.sample` to `.env` with a local token to access the mooc API.
+
+## developing views locally
+
+Be sure to build `es/` on `@coorpademy/components`
+
+```sh
+> cd ../@coorpademy-components
+> npm run build:es
+```
+
+then start [the sandbox](#start-local-sandbox)
+
 ## generate /static
 
 ```sh
 npm run static
 ```
 
-(This script is generated by lerna to publish the static web app)
+(This script is used by lerna to publish the [static web app](http://coorpacademy.github.io/components/app-review))
+
+## unit tests
+
+```sh
+npm run test:unit
+```
+
+or
+
+```sh
+npx ava --watch
+```
 
 ## dependencies notes
 
@@ -25,3 +55,10 @@ npm run static
 ### tmp notes
 
 export: <https://stackoverflow.com/a/70020984/959219>
+
+css modules:
+
+- <https://github.com/evanw/esbuild/issues/20>
+- <https://github.com/indooorsman/esbuild-css-modules-plugin/issues/35>
+- <https://github.com/princed/postcss-modules-values-replace>
+- <https://github.com/CoorpAcademy/coorpacademy-lambda/blob/master/teams/postcss.config.js#L4>

package/src/actions/courses.ts

@@ -0,0 +1,11 @@
+export const RECEIVED_COURSE = '@@api/RECEIVED_COURSE';
+
+export type ReceivedCourse = {
+  type: '@@api/RECEIVED_COURSE';
+  payload: string;
+};
+
+export const receivedCourse = (course: any): ReceivedCourse => ({
+  type: RECEIVED_COURSE,
+  payload: course
+});

package/src/actions/index.ts

@@ -1 +1,9 @@
+import {ReceivedCourse} from './courses';
+import {NavigateBack, NavigateTo, StartApp} from './navigation';
+import {StoreToken} from './token';
+
+export * from './courses';
 export * from './navigation';
+export * from './token';
+
+export type Action = StartApp | StoreToken | NavigateBack | NavigateTo | ReceivedCourse;

package/src/actions/navigation.ts

@@ -1,22 +1,34 @@
 import {ActionCreator} from 'redux';
+import {AppOptions} from '..';
 
 export const NAVIGATE_TO = '@@navigation/NAVIGATE_TO';
 export const NAVIGATE_BACK = '@@navigation/NAVIGATE_BACK';
+export const START_APP = '@@navigation/START_APP';
 
-export type $NAVIGATE_TO = {
+export type NavigateTo = {
   type: '@@navigation/NAVIGATE_TO';
   payload: string;
 };
 
-export type $NAVIGATE_BACK = {
+export type NavigateBack = {
   type: '@@navigation/NAVIGATE_BACK';
 };
 
-export const navigateTo: ActionCreator<$NAVIGATE_TO> = (newPath: string) => ({
+export type StartApp = {
+  type: '@@navigation/START_APP';
+  payload: AppOptions;
+};
+
+export const navigateTo: ActionCreator<NavigateTo> = (newPath: string) => ({
   type: NAVIGATE_TO,
   payload: newPath
 });
 
-export const navigateBack: ActionCreator<$NAVIGATE_BACK> = () => ({
+export const navigateBack: ActionCreator<NavigateBack> = () => ({
   type: NAVIGATE_BACK
 });
+
+export const startApp = (options: AppOptions): StartApp => ({
+  type: START_APP,
+  payload: options
+});

package/src/actions/token.ts

@@ -0,0 +1,11 @@
+export const STORE_TOKEN = '@@token/STORE_TOKEN';
+
+export type StoreToken = {
+  type: '@@token/STORE_TOKEN';
+  payload: string;
+};
+
+export const storeToken = (token: string): StoreToken => ({
+  type: STORE_TOKEN,
+  payload: token
+});

package/src/components/__tmp-backup-vues-mobile/revision-home.stories.tsx

@@ -1,16 +1,16 @@
-import * as React from 'react';
-import {storiesOf} from '@storybook/react-native';
-import RevisionHome from './revision-home';
+// import * as React from 'react';
+// import {storiesOf} from '@storybook/react-native';
+// import RevisionHome from './revision-home';
 
-const emptySkills: [] = [];
-const skillsToRevise: {title: string; info: string}[] = [
-  {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
-  {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
-  {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
-  {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
-  {title: 'Creativity and innovation', info: '75 questions to revise'}
-];
+// const emptySkills: [] = [];
+// const skillsToRevise: {title: string; info: string}[] = [
+//   {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
+//   {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
+//   {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
+//   {title: 'Negotiation and powers of persuasion', info: '75 questions to revise'},
+//   {title: 'Creativity and innovation', info: '75 questions to revise'}
+// ];
 
-storiesOf('RevisionHome', module)
-  .add('No skills', () => <RevisionHome skillsToRevise={emptySkills} />)
-  .add('Few skills', () => <RevisionHome skillsToRevise={skillsToRevise} />);
+// storiesOf('RevisionHome', module)
+//   .add('No skills', () => <RevisionHome skillsToRevise={emptySkills} />)
+//   .add('Few skills', () => <RevisionHome skillsToRevise={skillsToRevise} />);

package/src/configure-store.ts

@@ -4,9 +4,15 @@ import {composeWithDevTools} from 'redux-devtools-extension';
 
 import rootReducer from './reducers';
 
+import {State as NavigationState} from './reducers/navigation';
+import {State as TokenState} from './reducers/token';
+import onStartApp from './middlewares/on-start-app';
+
 const preloadedState = undefined;
 
-export default function configureStore(services) {
+// -----------------------------------------------------------------------------
+
+export default function configureStore() {
   const _compose =
     process.env.NODE_ENV !== 'production'
       ? composeWithDevTools({
@@ -16,8 +22,15 @@ export default function configureStore(services) {
         })
       : compose;
 
-  const enhancer = _compose(applyMiddleware(thunk));
+  const enhancer = _compose(applyMiddleware(thunk, onStartApp));
   const store = createStore(rootReducer, preloadedState, enhancer);
 
   return store;
 }
+
+// -----------------------------------------------------------------------------
+
+export type StoreState = {
+  navigation: NavigationState;
+  token: TokenState;
+};

package/src/index.tsx

@@ -3,7 +3,7 @@ import {connect, Provider} from 'react-redux';
 import AppReviewRootView from '@coorpacademy/components/es/template/app-review/root-view/root-view';
 
 import configureStore from './configure-store';
-import {navigateTo, navigateBack} from './actions/navigation';
+import {navigateTo, navigateBack, startApp} from './actions/navigation';
 import {getCurrentViewName} from './reducers/navigation';
 
 // -----------------------------------------------------------------------------
@@ -17,11 +17,12 @@ const App = connect(mapStateToProps, mapDispatchToProps)(AppReviewRootView);
 
 // -----------------------------------------------------------------------------
 
-const AppRevision = ({services}) => {
+const AppRevision = ({options}: Props) => {
   const [store, setStore] = useState(null);
 
   useEffect(() => {
-    const store = configureStore(services);
+    const store = configureStore();
+    store.dispatch(startApp(options));
     setStore(store);
   }, []);
 
@@ -36,4 +37,12 @@ const AppRevision = ({services}) => {
 
 // -----------------------------------------------------------------------------
 
+type Props = {options: AppOptions};
+
+export type AppOptions = {
+  token: string;
+  theme?: any;
+  translations?: any;
+};
+
 export default AppRevision;

package/src/middlewares/on-start-app.ts

@@ -0,0 +1,30 @@
+import fetch from 'cross-fetch';
+import type {Middleware} from 'redux';
+import {Dispatch} from 'redux';
+
+import {Action, receivedCourse, START_APP, storeToken} from '../actions';
+import {StoreState} from '../configure-store';
+import fetchCourse from '../services/fetch-demo';
+
+const onStartApp: Middleware<{}, StoreState, Dispatch<Action>> = ({dispatch}) => next => (
+  action: Action
+) => {
+  if (action.type === START_APP) {
+    const {token} = action.payload;
+    dispatch(storeToken(token));
+
+    // --------------
+    // demo service
+
+    const language = 'fr';
+    const universalRef = 'dis_xxx15';
+
+    fetchCourse(token, language, universalRef).then(course => {
+      dispatch(receivedCourse(course));
+    });
+  }
+
+  return next(action);
+};
+
+export default onStartApp;

package/src/reducers/courses.ts

@@ -0,0 +1,22 @@
+import {ReceivedCourse, RECEIVED_COURSE} from '../actions';
+
+// -----------------------------------------------------------------------------
+
+export type State = Array<any>;
+export const initialState: State = [];
+
+// -----------------------------------------------------------------------------
+
+const reducer = (state: State = initialState, action: ReceivedCourse): State => {
+  switch (action.type) {
+    case RECEIVED_COURSE: {
+      return [...state, action.payload];
+    }
+    default:
+      return state;
+  }
+};
+
+// -----------------------------------------------------------------------------
+
+export default reducer;

package/src/reducers/index.ts

@@ -1,8 +1,13 @@
 import {combineReducers} from 'redux';
+
+import courses from './courses';
 import navigation from './navigation';
+import token from './token';
 
 const rootReducer = combineReducers({
-  navigation
+  courses,
+  navigation,
+  token
 });
 
 export default rootReducer;

package/src/reducers/navigation.ts

@@ -1,11 +1,14 @@
 import {NAVIGATE_BACK, NAVIGATE_TO} from '../actions/navigation';
-import type {$NAVIGATE_TO, $NAVIGATE_BACK} from '../actions/navigation';
+import type {NavigateTo, NavigateBack} from '../actions/navigation';
 
-export type State = Array<string>;
+// -----------------------------------------------------------------------------
 
+export type State = Array<string>;
 export const initialState: State = ['home'];
 
-const reducer = (state: State = initialState, action: $NAVIGATE_TO | $NAVIGATE_BACK): State => {
+// -----------------------------------------------------------------------------
+
+const reducer = (state: State = initialState, action: NavigateTo | NavigateBack): State => {
   switch (action.type) {
     case NAVIGATE_TO: {
       return [...state, action.payload];
@@ -20,5 +23,10 @@ const reducer = (state: State = initialState, action: $NAVIGATE_TO | $NAVIGATE_B
   }
 };
 
+// -----------------------------------------------------------------------------
+
 export const getCurrentViewName = appState => appState.navigation[appState.navigation.length - 1];
+
+// -----------------------------------------------------------------------------
+
 export default reducer;

package/src/reducers/token.ts

@@ -0,0 +1,26 @@
+import {StoreToken, STORE_TOKEN} from '../actions';
+
+// -----------------------------------------------------------------------------
+
+export type State = string;
+export const initialState: State = null;
+
+// -----------------------------------------------------------------------------
+
+const reducer = (state: State = initialState, action: StoreToken): State => {
+  switch (action.type) {
+    case STORE_TOKEN: {
+      return action.payload;
+    }
+    default:
+      return state;
+  }
+};
+
+// -----------------------------------------------------------------------------
+
+export const getToken = appState => appState.token;
+
+// -----------------------------------------------------------------------------
+
+export default reducer;

package/src/services/fetch-demo.test.ts

@@ -0,0 +1,16 @@
+import test from 'ava';
+import {fetchCourse as _fetchCourse} from './fetch-demo';
+import {okJSONResponse} from './fetch.mocks';
+import type {CatalogHits} from './fetch-demo';
+
+test('should fetch a demo course', async t => {
+  const token =
+    'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
+  const language = 'fr';
+  const universalRef = 'bar';
+
+  const result: CatalogHits = {hits: [{title: 'Digital IQ test'}]};
+  const fetchCourse = _fetchCourse(okJSONResponse(result));
+  const course = await fetchCourse(token, language, universalRef);
+  t.is(course.title, 'Digital IQ test');
+});

package/src/services/fetch-demo.ts

@@ -0,0 +1,55 @@
+import crossFetch from 'cross-fetch';
+import decode from 'jwt-decode';
+import {Fetch, toJSON} from './fetch-responses';
+
+// -----------------------------------------------------------------------------
+
+type JWT = {
+  exp: number;
+  iat: number;
+  grants: unknown;
+  iss: string;
+  user: string;
+  usage: string;
+  host: string;
+};
+
+type QueryParams = {
+  [key: string]: string | number | boolean;
+};
+
+const buildUrlQueryParams = (params: QueryParams) =>
+  Object.keys(params)
+    .map(key => {
+      const value = params[key].toString();
+      return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+    })
+    .join('&');
+
+// -----------------------------------------------------------------------------
+
+const fetchCourse = (fetch: Fetch) => async (token, language, universalRef): Promise<Course> => {
+  const jwt: JWT = decode(token);
+  const query = {
+    type: 'course',
+    universalRef,
+    lang: language
+  };
+
+  const response = await fetch(`${jwt.host}/api/v2/contents?${buildUrlQueryParams(query)}`, {
+    headers: {authorization: token}
+  });
+
+  const {hits} = (await toJSON(response)) as CatalogHits;
+  return hits?.[0];
+};
+
+// -----------------------------------------------------------------------------
+
+export type Course = {title};
+export type CatalogHits = {hits: Course[]};
+
+// -----------------------------------------------------------------------------
+
+export {fetchCourse};
+export default fetchCourse(crossFetch);