Feature/resource builder

.babelrc

@@ -0,0 +1,10 @@
+{
+  "presets": [
+    "env",
+    "flow"
+  ],
+  "plugins": [
+    "transform-runtime",
+    "transform-object-rest-spread"
+  ]
+}

.circleci/config.yml

@@ -0,0 +1,41 @@
+# Javascript Node CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-javascript/ for more details
+#
+version: 2
+jobs:
+  build:
+    docker:
+      # specify the version you desire here
+      - image: circleci/node:7.10
+
+      # Specify service dependencies here if necessary
+      # CircleCI maintains a library of pre-built images
+      # documented at https://circleci.com/docs/2.0/circleci-images/
+      # - image: circleci/mongo:3.4.4
+
+    working_directory: ~/repo
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+          - v1-dependencies-{{ checksum "package.json" }}
+          # fallback to using the latest cache if no exact match is found
+          - v1-dependencies-
+
+      - run: yarn install
+
+      - save_cache:
+          paths:
+            - node_modules
+          key: v1-dependencies-{{ checksum "package.json" }}
+
+      # run tests!
+      - run:
+          name: Jest Suite
+          command: yarn jest tests --ci --testResultsProcessor="jest-junit"
+          environment:
+            JEST_JUNIT_OUTPUT: "reports/junit/js-test-results.xml"

.eslintrc

@@ -1,3 +1,13 @@
 {
-  "extends": "airbnb-base"
+  "parser": "babel-eslint",
+  "extends": "airbnb-base",
+  "env": {
+    "browser": true,
+    "jest": true
+  },
+  "rules": {
+    "no-underscore-dangle": [1, {
+      "allowAfterThis": true
+    }]
+  }
 }

.flowconfig

@@ -0,0 +1,11 @@
+[ignore]
+
+[include]
+
+[libs]
+
+[lints]
+
+[options]
+
+[strict]

README.md

@@ -0,0 +1,129 @@
+# Jsonapi Orchestrator
+
+Building better jsonapi-compliant code
+
+[![BCH compliance](https://bettercodehub.com/edge/badge/MyJobGlasses/jsonapi-orchestrator?branch=master)](https://bettercodehub.com/)
+
+[![CircleCI](https://circleci.com/gh/MyJobGlasses/jsonapi-orchestrator.svg?style=svg)](https://circleci.com/gh/MyJobGlasses/jsonapi-orchestrator)
+
+# What is it ?
+
+Ever wanted to use...
+- json:api communication with your APIs
+- Redux based storage of resources retrieved from the API
+- Side effects with redux-saga posting to your APIs
+- Caching expensive requests to alleviate load on your APIs
+
+**Jsonapi Orchestrator is For You 🎁 🎉**
+
+# HOW TO
+
+Jsonapi Orchestrator helps you to deal with various stages of json:api based API interaction
+
+## Building json:api Requests
+
+A json:api request can be categorized either as a READ request (GET request) or a WRITE request (POST/PATCH/PUT).
+
+Building those requests can be difficult because of the format of filters, sorting, and includes, in addition to specifying the endpoint. In addition, if you ever want to handle caching of requests, you would need to be ablte to specify metadata such as data freshness to decide later if you actually want to fire the query or reuse existing data already fetched.
+
+Our Jsonapi builders will let you store this metadata so it can be reused with cache managers.
+
+Here are some examples of basic read and writes
+
+### APIs
+
+You can manage a list of multiple APIs easily
+
+```javascript
+// my-apis.js
+const EMPLOYEE_API_V1 = new API({
+  name: 'Employee API v1', url: 'https://employee.example.com/api/v1'
+})
+const EMPLOYEE_API_V2 = new API({
+  name: 'Employee API v2', url: process.env.EMPLOYEE_API_V1_URL
+})
+const METRICS_API_V2 = new API({
+  name: 'Metrics API v2', url: 'https://metrics.example.com/api/v2'
+})
+
+export default { METRICS_API_V2, EMPLOYEE_API_V1, EMPLOYEE_API_V2 }
+
+// somewhere
+import APIs from 'my-apis'
+```
+
+### Basic READ of single document
+
+```javascript
+employeeReader = new JsonapiResourceReader({ type: 'employee'})
+employeeReader.sideload({ company: { admins: true } })
+employeeReader.filter({ in_vacation: false })
+employeeReader.sort({ next_holiday_at: 'asc' })
+
+requestBuilder = new JsonapiRequestBuilder({
+  resource: employeeReader,
+  method: 'GET',
+  path: '/employee/profile/:id',
+  params: { id: employeeId }
+  collection: false,
+  api: APIs.EMPLOYEE_API_V1,
+})
+
+yield put(requestBuilder.asReduxAction())
+```
+
+### Basic POST of single document with sideposting
+
+```javascript
+employeeWriter = new JsonapiResourceWriter({ type: 'employee/profile' })
+resourceBuilder.setAttributes(...asReduxAction.attributes)
+
+// Sidepost the user
+userBuilder = new JsonapiResourceWriter({
+  type: 'user',
+  id: 'cafebabe',
+  attributes: currentUser.attributes
+})
+employeeWriter.sidepost({
+  relationship: 'user', method: 'update', userBuilder
+)
+
+// Sidepost educations
+educationBuilders = action.educations.forEach( (e) => {
+  educationWriter = new JsonapiResourceWriter({ type: 'education', attributes: e.attributes })
+  // e.method should return 'create' 'update' or 'destroy' or 'disassociate'
+  employeeWriter.sidepost({ relationship: 'educations', method: e.method, educationWriter)
+})
+
+requestBuilder = new JsonapiRequestBuilder({
+  builder: employeeWriter,
+  method: 'POST',
+  api: APIs.EMPLOYEE_API_V1,
+  attributes: existingEmployee.attributes
+})
+requestBuilder.endpointPath = '/employee/profile'
+requestBuilder.addMeta({ invitation_token: invitation_token }) // SHould merge with existing metas
+
+yield put(requestBuilder.asReduxAction())
+```
+
+You can find more advanced examples, including redux-saga based examples, [in the /examples folder](./examples/)
+
+## Feeding the json:api responses to your Redux state
+
+TODO by Dimitri
+
+## Handle caching of requests
+
+For a later version of JO
+
+# Credits
+
+- Dimitri DOMEY (Grand Bidou) @DOMEYD
+- Cyril Duchon-Doris (Nickname-yet-to-be-found) @Startouf
+
+# Contribute
+
+Well, please
+- Open an Issue describing your feature/bug/whatever addition you want to make,
+- If you feel 💪 enough, open a PR with some commits and reference your issue number inside. If you're also using ZenHub (💕) you can attach your PR to your issue !

examples/building_and_dispatching_requests.js

@@ -38,10 +38,10 @@ function * initEmployeePageView() {
     method: 'GET',
     path: '/employee/profile/:id',
     params: { id: employeeId } // Should be smart substituted
-    api: APIs.HERMES // Helps set the base URL
+    api: APIs.EMPLOYEE_API // Helps set the base URL
   })
 
-  yield put(requestBuilder.action)
+  yield put(requestBuilder.asReduxAction())
   return yield race({
     success: take(READ_EMPLOYEE_RESOURCE_SUCCESS),
     error: take(READ_EMPLOYEE_RESOURCE_ERROR),
@@ -54,9 +54,7 @@ function * initEmployeePageView() {
  */
 
 function * initConversationsPageView() {
-  conversationsReader = new JsonapiResourceListReader({
-    type: 'messaging/conversation',
-  })
+  conversationsReader = new JsonapiResourceListReader({ type: 'messaging/conversation' })
 
   /* Data expiration
    * On READ Lists, it should generate an index whose ID is a hash of
@@ -82,10 +80,10 @@ function * initConversationsPageView() {
     resource: conversationsReader,
     method: 'GET',
     path: '/conversations',
-    api: APIs.HERMES
+    api: APIs.CONVERSATIONS_API_V1
   })
 
-  yield put(requestBuilder.action)
+  yield put(requestBuilder.asReduxAction())
   return yield race({
     success: take(READ_CONVERSATION_RESOURCE_LIST_SUCCESS),
     error: take(READ_CONVERSATION_RESOURCE_LIST_ERROR),
@@ -107,7 +105,7 @@ function* createProfessional(action) {
 
   // Build the resource from the action / form
   employeeWriter = new JsonapiResourceWriter({ type: 'employee/profile' })
-  resourceBuilder.setAttributes(...action.attributes)
+  resourceBuilder.setAttributes(...asReduxAction.attributes)
 
   // Sidepost the user
   userBuilder = new JsonapiResourceWriter({ type: 'user', id: '', attributes: currentUser.attributes })
@@ -123,13 +121,13 @@ function* createProfessional(action) {
   requestBuilder = new JsonapiRequestBuilder({
     builder: employeeWriter,
     method: 'POST',
-    api: process.env.HERMES_API_URL,
+    api: APIs.EMPLOYEE_API,
     attributes: existingEmployee.attributes
   })
   requestBuilder.endpointPath = '/employee/profile'
   requestBuilder.addMeta({ invitation_token: invitation_token }) // SHould merge with existing metas
 
-  yield put(requestBuilder.action)
+  yield put(requestBuilder.asReduxAction())
   return yield race({
     success: take(WRITE_EMPLOYEE_RESOURCE_SUCCESS),
     error: take(WRITE_EMPLOYEE_RESOURCE_ERROR),

package.json

@@ -4,7 +4,7 @@
   "description": "Jsonapi powered framework to harness the power of jsonapi with redux",
   "main": "src/index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "jest --notify --watch"
   },
   "repository": {
     "type": "git",
@@ -21,12 +21,27 @@
   },
   "homepage": "https://github.com/MyJobGlasses/jsonapi-orchestrator#readme",
   "dependencies": {
+    "json-api-normalizer": "^0.4.10",
+    "lodash": "^4.17.10",
     "redux": "^3.7.2",
-    "redux-saga": "^0.16.0"
+    "redux-saga": "^0.16.0",
+    "uuid": "^3.2.1"
   },
   "devDependencies": {
+    "babel-core": "^6.26.3",
+    "babel-eslint": "^8.2.6",
+    "babel-jest": "^22.4.3",
+    "babel-plugin-transform-object-rest-spread": "^6.26.0",
+    "babel-plugin-transform-runtime": "^6.23.0",
+    "babel-preset-env": "^1.6.1",
+    "babel-preset-flow": "^6.23.0",
     "eslint": "^4.19.1",
     "eslint-config-airbnb-base": "^12.1.0",
-    "eslint-plugin-import": "^2.9.0"
+    "eslint-plugin-import": "^2.11.0",
+    "flow-bin": "^0.71.0",
+    "jest": "^22.4.3",
+    "jest-junit": "^4.0.0",
+    "redux-saga-test-plan": "^3.6.0",
+    "regenerator-runtime": "^0.11.1"
   }
 }

src/JsonApiConnector.js

@@ -0,0 +1,24 @@
+let mainConnector = null;
+
+/**
+ * @todo handle if we want to overwrite mainConnector
+ */
+export default class JsonApiConnector {
+  constructor(params) {
+    this.url = params.url;
+    mainConnector = mainConnector || this;
+  }
+
+  static connector() {
+    if (!mainConnector) {
+      return new JsonApiConnector();
+    }
+    return mainConnector;
+  }
+
+  buildEndpoint(path) {
+    return `${this.url}/${path}`;
+  }
+}
+
+export const getMainConnector = JsonApiConnector.connector;