Add action creator for RSAA action

This gives cleaner boundary for RSAA actions, gives clean API and allows to add validation to action creation process. And this allows for nicer and cleaner typings for Typescript.

Author: artursvonda

src/index.js

@@ -32,7 +32,7 @@
 import RSAA from './RSAA';
 import { isRSAA, validateRSAA, isValidRSAA } from './validation';
 import { InvalidRSAA, InternalError, RequestError, ApiError } from './errors';
-import { getJSON } from './util';
+import { createAction, getJSON } from './util';
 import { apiMiddleware, createMiddleware } from './middleware';
 
 export {
@@ -45,6 +45,7 @@ export {
   RequestError,
   ApiError,
   getJSON,
+  createAction,
   createMiddleware,
   apiMiddleware
 };

src/util.js

@@ -1,4 +1,5 @@
 import { InternalError, ApiError } from './errors';
+import RSAA from './RSAA';
 
 /**
  * Extract JSON body from a server response
@@ -93,4 +94,16 @@ async function actionWith(descriptor, args = []) {
   return descriptor;
 }
 
-export { getJSON, normalizeTypeDescriptors, actionWith };
+/**
+ * Create RSAA action
+ *
+ * @function createAction
+ * @access public
+ * @param {object} clientCall - The options for the RSAA action
+ * @returns {object} RSAA Action
+ */
+function createAction(clientCall) {
+  return { [RSAA]: clientCall };
+}
+
+export { getJSON, normalizeTypeDescriptors, actionWith, createAction };

src/util.test.js

@@ -2,7 +2,7 @@
 import { RSAA, getJSON } from './index.js';
 
 // Private package import
-import { normalizeTypeDescriptors, actionWith } from './util';
+import { normalizeTypeDescriptors, actionWith, createAction } from './util';
 
 describe('#normalizeTypeDescriptors', () => {
   it('handles string types', () => {
@@ -167,3 +167,10 @@ describe('#getJSON', () => {
     expect(result).toBeUndefined();
   });
 });
+
+describe('#createAction', () => {
+  it('returns valid RSAA action', () => {
+    const apiCall = {};
+    expect(createAction(apiCall)).toHaveProperty(RSAA, apiCall);
+  });
+});