@ukhomeoffice/cop-react-form-renderer 2.8.4 → 2.10.0

package/dist/utils/CheckYourAnswers/getCYARowsForPage.js

@@ -13,6 +13,8 @@ var _getCYARow = _interopRequireDefault(require("./getCYARow"));
 
 var _getCYARowForGroup2 = _interopRequireDefault(require("./getCYARowForGroup"));
 
+var _getCYARowsForCollection = _interopRequireDefault(require("./getCYARowsForCollection"));
+
 var _getCYARowsForContainer = _interopRequireDefault(require("./getCYARowsForContainer"));
 
 var _showComponentCYA = _interopRequireDefault(require("./showComponentCYA"));
@@ -36,11 +38,16 @@ var getCYARowsForPage = function getCYARowsForPage(page, onAction) {
     var rows = page.components.filter(function (c) {
       return (0, _showComponentCYA.default)(c, page.formData);
     }).flatMap(function (component) {
-      if (component.type === _models.ComponentTypes.CONTAINER) {
-        return (0, _getCYARowsForContainer.default)(page, component, page.formData[component.fieldId], onAction);
-      }
+      switch (component.type) {
+        case _models.ComponentTypes.CONTAINER:
+          return (0, _getCYARowsForContainer.default)(page, component, page.formData[component.fieldId], onAction);
 
-      return (0, _getCYARow.default)(page, component, onAction);
+        case _models.ComponentTypes.COLLECTION:
+          return (0, _getCYARowsForCollection.default)(page, component, page.formData[component.fieldId], onAction);
+
+        default:
+          return (0, _getCYARow.default)(page, component, onAction);
+      }
     });
 
     if (((_page$groups = page.groups) === null || _page$groups === void 0 ? void 0 : _page$groups.length) > 0) {

package/dist/utils/CheckYourAnswers/getCYARowsForPage.test.js

@@ -2,23 +2,23 @@
 
 var _react = require("@testing-library/react");
 
+var _setupTests = require("../../setupTests");
+
 var _models = require("../../models");
 
 var _getCYARowsForPage = _interopRequireDefault(require("./getCYARowsForPage"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-// Global imports
-// Local imports
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
 describe('utils', function () {
   describe('CheckYourAnswers', function () {
     describe('getCYARowsForPage', function () {
-      var expectObjectLike = function expectObjectLike(received, expected) {
-        Object.keys(expected).forEach(function (key) {
-          expect(received[key]).toEqual(expected[key]);
-        });
-      };
-
       it('should get a appropriate row for a page with a single readonly text component', function () {
         var COMPONENT = {
           type: 'text',
@@ -40,7 +40,7 @@ describe('utils', function () {
         var ROWS = (0, _getCYARowsForPage.default)(PAGE, ON_ACTION);
         expect(ROWS.length).toEqual(1);
         ROWS.forEach(function (row, index) {
-          expectObjectLike(row, {
+          (0, _setupTests.expectObjectLike)(row, {
             pageId: PAGE.id,
             fieldId: PAGE.components[index].fieldId,
             key: PAGE.components[index].label,
@@ -78,14 +78,14 @@ describe('utils', function () {
         var ROWS = (0, _getCYARowsForPage.default)(PAGE, ON_ACTION);
         expect(ROWS.length).toEqual(2);
         ROWS.forEach(function (row, index) {
-          expectObjectLike(row, {
+          (0, _setupTests.expectObjectLike)(row, {
             pageId: PAGE.id,
             fieldId: PAGE.components[index].fieldId,
             key: PAGE.components[index].label,
             component: PAGE.components[index],
             value: "".concat(PAGE.components[index].label, " Charlie")
           });
-          expectObjectLike(row.action, {
+          (0, _setupTests.expectObjectLike)(row.action, {
             onAction: ON_ACTION
           });
         });
@@ -122,14 +122,14 @@ describe('utils', function () {
         var ROWS = (0, _getCYARowsForPage.default)(PAGE, ON_ACTION);
         expect(ROWS.length).toEqual(2);
         ROWS.forEach(function (row, index) {
-          expectObjectLike(row, {
+          (0, _setupTests.expectObjectLike)(row, {
             pageId: PAGE.id,
             fieldId: PAGE.components[index].fieldId,
             key: PAGE.components[index].label,
             component: PAGE.components[index],
             value: "".concat(PAGE.components[index].label, " Charlie")
           });
-          expectObjectLike(row.action, {
+          (0, _setupTests.expectObjectLike)(row.action, {
             onAction: ON_ACTION
           });
         });
@@ -166,7 +166,7 @@ describe('utils', function () {
         var ROWS = (0, _getCYARowsForPage.default)(PAGE, ON_ACTION);
         expect(ROWS.length).toEqual(1);
         ROWS.forEach(function (row, index) {
-          expectObjectLike(row, {
+          (0, _setupTests.expectObjectLike)(row, {
             pageId: PAGE.id,
             fieldId: CONTAINER.components[index].fieldId,
             key: CONTAINER.components[index].label,
@@ -234,6 +234,50 @@ describe('utils', function () {
         expect(addressValues[2].childNodes[0].textContent).toEqual('London');
         expect(addressValues[3].childNodes[0].textContent).toEqual('SW1A 2AA');
       });
+      it('should get appropriate rows for a page with a single readonly text component within a collection', function () {
+        var FORM_DATA = {
+          collection: [{
+            a: 'Bravo'
+          }]
+        };
+        var COMPONENT = {
+          type: 'text',
+          readonly: true,
+          id: 'a',
+          fieldId: 'a',
+          label: 'Alpha'
+        };
+        var COLLECTION = {
+          id: 'collection',
+          fieldId: 'collection',
+          type: _models.ComponentTypes.COLLECTION,
+          item: [COMPONENT],
+          value: FORM_DATA.collection,
+          formData: FORM_DATA
+        };
+        var PAGE = {
+          id: 'page',
+          components: [COLLECTION],
+          formData: FORM_DATA
+        };
+
+        var ON_ACTION = function ON_ACTION() {};
+
+        var ROWS = (0, _getCYARowsForPage.default)(PAGE, ON_ACTION);
+        expect(ROWS.length).toEqual(2); // Title and item row
+
+        (0, _setupTests.expectObjectLike)(ROWS[1], {
+          pageId: PAGE.id,
+          fieldId: COMPONENT.fieldId,
+          full_path: "".concat(COLLECTION.fieldId, "[0].").concat(COMPONENT.fieldId),
+          key: COMPONENT.label,
+          action: null,
+          component: _objectSpread(_objectSpread({}, COMPONENT), {}, {
+            full_path: "".concat(COLLECTION.fieldId, "[0].").concat(COMPONENT.fieldId)
+          }),
+          value: 'Bravo'
+        });
+      });
     });
   });
 });

package/dist/utils/Component/cleanAttributes.js

@@ -19,7 +19,7 @@ function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToAr
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-var JSON_ONLY_PROPERTIES = ['source', 'use', 'show_when', 'options', 'additionalValidation', 'full_path'];
+var JSON_ONLY_PROPERTIES = ['source', 'use', 'show_when', 'options', 'additionalValidation', 'full_path', 'shown', 'formData'];
 /**
  * This method removes and properties that are entirely specific to the JSON
  * configuration and that should not be used as HTML attributes.

package/dist/utils/Component/getComponent.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.getNestedComponent = exports.default = void 0;
 
 var _copReactComponents = require("@ukhomeoffice/cop-react-components");
 
@@ -84,6 +84,13 @@ var getRadios = function getRadios(config) {
     options = val;
   });
 
+  options.forEach(function (option) {
+    if (!option.nested) {
+      return;
+    }
+
+    option.nestedJSX = getNestedComponent(config, option);
+  });
   var attrs = (0, _cleanAttributes.default)(config);
   return /*#__PURE__*/_react.default.createElement(_copReactComponents.Radios, _extends({}, attrs, {
     options: options
@@ -148,6 +155,34 @@ var getComponentByType = function getComponentByType(config) {
       }
   }
 };
+/**
+ * Get nested component with form data
+ * @param {*} parentConfig 
+ * @param {*} nestedConfig 
+ */
+
+
+var getNestedComponent = function getNestedComponent(parentConfig, nestedConfig) {
+  nestedConfig.nested.onChange = parentConfig.onChange;
+
+  if (parentConfig.formData) {
+    var _parentConfig$formDat;
+
+    nestedConfig.nested.value = parentConfig !== null && parentConfig !== void 0 && (_parentConfig$formDat = parentConfig.formData) !== null && _parentConfig$formDat !== void 0 && _parentConfig$formDat[nestedConfig.nested.fieldId] ? parentConfig.formData[nestedConfig.nested.fieldId] : '';
+  }
+
+  if ('readonly' in nestedConfig.nested) delete nestedConfig.nested.readonly;
+
+  if (parentConfig.readonly) {
+    nestedConfig.nested.readonly = parentConfig.readonly;
+    return getComponent(nestedConfig.nested, false);
+  }
+
+  return getComponent(nestedConfig.nested);
+};
+
+exports.getNestedComponent = getNestedComponent;
+
 /**
  * Get a renderable component, based on a configuration object.
  * @param {object} config The configuration object for the component.
@@ -155,8 +190,6 @@ var getComponentByType = function getComponentByType(config) {
  * @param {Function} fnOverride An optional override function for component rendering.
  * @returns A renderable component.
  */
-
-
 var getComponent = function getComponent(config) {
   var wrap = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
   var fnOverride = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : undefined;

package/dist/utils/Component/getComponentTests/getComponent.nested.test.js

@@ -0,0 +1,92 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+
+var _getComponent = require("../getComponent");
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+
+describe('utils.Component.get', function () {
+  it('should return a component that is nested within another component', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
+    var ID, FIELD_ID, LABEL, VALUE, PARENT_CONFIG, NESTED_CONFIG, _render, container, child, label, input;
+
+    return regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) {
+        switch (_context.prev = _context.next) {
+          case 0:
+            ID = 'testId';
+            FIELD_ID = 'fieldId';
+            LABEL = 'Test label';
+            VALUE = 'nestedValue';
+            PARENT_CONFIG = {
+              onChange: function onChange() {},
+              formData: _defineProperty({}, FIELD_ID, VALUE)
+            };
+            NESTED_CONFIG = {
+              nested: {
+                id: ID,
+                fieldId: FIELD_ID,
+                label: LABEL,
+                type: 'text'
+              }
+            };
+            _render = (0, _react.render)((0, _getComponent.getNestedComponent)(PARENT_CONFIG, NESTED_CONFIG)), container = _render.container;
+            child = container.childNodes[0];
+            expect(child.classList).toContain('govuk-form-group');
+            label = child.childNodes[0];
+            expect(label).toBeDefined();
+            expect(label.innerHTML).toContain(LABEL);
+            input = child.childNodes[1];
+            expect(input.tagName).toEqual('INPUT');
+            expect(input.classList).toContain('govuk-input');
+            expect(input.id).toEqual(ID);
+            expect(input.value).toEqual(VALUE);
+
+          case 17:
+          case "end":
+            return _context.stop();
+        }
+      }
+    }, _callee);
+  })));
+  it('should return a read only component that is nested within another readonly component', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee2() {
+    var ID, FIELD_ID, LABEL, VALUE, PARENT_CONFIG, NESTED_CONFIG, _render2, container, child;
+
+    return regeneratorRuntime.wrap(function _callee2$(_context2) {
+      while (1) {
+        switch (_context2.prev = _context2.next) {
+          case 0:
+            ID = 'testId';
+            FIELD_ID = 'fieldId';
+            LABEL = 'Test label';
+            VALUE = 'nestedValue';
+            PARENT_CONFIG = {
+              onChange: function onChange() {},
+              formData: _defineProperty({}, FIELD_ID, VALUE),
+              readonly: true
+            };
+            NESTED_CONFIG = {
+              nested: {
+                id: ID,
+                fieldId: FIELD_ID,
+                label: LABEL,
+                type: 'text',
+                readonly: true
+              }
+            };
+            _render2 = (0, _react.render)((0, _getComponent.getNestedComponent)(PARENT_CONFIG, NESTED_CONFIG)), container = _render2.container;
+            child = container.childNodes[0];
+            expect(child.classList).toContain('hods-readonly');
+
+          case 9:
+          case "end":
+            return _context2.stop();
+        }
+      }
+    }, _callee2);
+  })));
+});

package/dist/utils/Component/getDefaultValue.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _models = require("../../models");
+
+var _DEFAULT_VALUES;
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+var DEFAULT_VALUES = (_DEFAULT_VALUES = {}, _defineProperty(_DEFAULT_VALUES, _models.ComponentTypes.COLLECTION, []), _defineProperty(_DEFAULT_VALUES, _models.ComponentTypes.CONTAINER, {}), _defineProperty(_DEFAULT_VALUES, _models.ComponentTypes.FILE, {}), _DEFAULT_VALUES);
+
+var getDefaultValue = function getDefaultValue(component) {
+  if (component) {
+    return DEFAULT_VALUES[component.type] || '';
+  }
+
+  return '';
+};
+
+var _default = getDefaultValue;
+exports.default = _default;

package/dist/utils/Component/getDefaultValue.test.js

@@ -0,0 +1,53 @@
+"use strict";
+
+var _models = require("../../models");
+
+var _getDefaultValue = _interopRequireDefault(require("./getDefaultValue"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+describe('utils.Component.defaultValue', function () {
+  it('should return an empty string if the component is undefined', function () {
+    expect((0, _getDefaultValue.default)(undefined)).toEqual('');
+  });
+  it('should return an empty string if the component is null', function () {
+    expect((0, _getDefaultValue.default)(null)).toEqual('');
+  });
+  it('should return an empty string if the component has no type', function () {
+    expect((0, _getDefaultValue.default)({})).toEqual('');
+  });
+  it('should return an empty string if the component type is null', function () {
+    expect((0, _getDefaultValue.default)({
+      type: null
+    })).toEqual('');
+  });
+  it('should return an empty string if the component type is undefined', function () {
+    expect((0, _getDefaultValue.default)({
+      type: undefined
+    })).toEqual('');
+  });
+  it("should return an empty array if the component type is 'collection'", function () {
+    expect((0, _getDefaultValue.default)({
+      type: _models.ComponentTypes.COLLECTION
+    })).toEqual([]);
+  });
+  it("should return an empty object if the component type is 'container'", function () {
+    expect((0, _getDefaultValue.default)({
+      type: _models.ComponentTypes.CONTAINER
+    })).toEqual({});
+  });
+  it("should return an empty object if the component type is 'file'", function () {
+    expect((0, _getDefaultValue.default)({
+      type: _models.ComponentTypes.FILE
+    })).toEqual({});
+  });
+  Object.values(_models.ComponentTypes).forEach(function (value) {
+    if (![_models.ComponentTypes.COLLECTION, _models.ComponentTypes.CONTAINER, _models.ComponentTypes.FILE].includes(value)) {
+      it("should return an empty object if the component type is '".concat(value, "'"), function () {
+        expect((0, _getDefaultValue.default)({
+          type: _models.ComponentTypes.TEXT
+        })).toEqual('');
+      });
+    }
+  });
+});

package/dist/utils/Component/index.js

@@ -9,6 +9,8 @@ var _cleanAttributes = _interopRequireDefault(require("./cleanAttributes"));
 
 var _getComponent = _interopRequireDefault(require("./getComponent"));
 
+var _getDefaultValue = _interopRequireDefault(require("./getDefaultValue"));
+
 var _isEditable = _interopRequireDefault(require("./isEditable"));
 
 var _showComponent = _interopRequireDefault(require("./showComponent"));
@@ -19,8 +21,9 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 
 var Component = {
   clean: _cleanAttributes.default,
-  get: _getComponent.default,
+  defaultValue: _getDefaultValue.default,
   editable: _isEditable.default,
+  get: _getComponent.default,
   show: _showComponent.default,
   wrap: _wrapInFormGroup.default
 };

package/dist/utils/Meta/constants.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.META_PROPERTY = exports.META_DOCUMENTS_PROPERTY = void 0;
+var META_PROPERTY = 'meta';
+exports.META_PROPERTY = META_PROPERTY;
+var META_DOCUMENTS_PROPERTY = 'documents';
+exports.META_DOCUMENTS_PROPERTY = META_DOCUMENTS_PROPERTY;

package/dist/utils/Meta/documents/getDocuments.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _constants = require("../constants");
+
+// Local imports
+var getDocuments = function getDocuments(formData) {
+  var _formData$META_PROPER;
+
+  return (formData === null || formData === void 0 ? void 0 : (_formData$META_PROPER = formData[_constants.META_PROPERTY]) === null || _formData$META_PROPER === void 0 ? void 0 : _formData$META_PROPER[_constants.META_DOCUMENTS_PROPERTY]) || [];
+};
+
+var _default = getDocuments;
+exports.default = _default;

package/dist/utils/Meta/documents/getDocuments.test.js

@@ -0,0 +1,43 @@
+"use strict";
+
+var _constants = require("../constants");
+
+var _getDocuments = _interopRequireDefault(require("./getDocuments"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+describe('Utils.Meta.documents.get', function () {
+  it('should return an empty array if formData is null', function () {
+    expect((0, _getDocuments.default)(null)).toEqual([]);
+  });
+  it('should return an empty array if formData does not contain a meta property', function () {
+    expect((0, _getDocuments.default)({})).toEqual([]);
+  });
+  it('should return an empty array if the meta property is undefined', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, undefined);
+
+    expect((0, _getDocuments.default)(FORM_DATA)).toEqual([]);
+  });
+  it('should return an empty array if the meta property contains no documents property', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, {});
+
+    expect((0, _getDocuments.default)(FORM_DATA)).toEqual([]);
+  });
+  it('should return an empty array if the meta.documents property is undefined', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, undefined));
+
+    expect((0, _getDocuments.default)(FORM_DATA)).toEqual([]);
+  });
+  it('should return the meta.documents property if it exists', function () {
+    var DOCUMENTS = [{
+      field: 'alpha',
+      url: 'http://alpha-bravo.com/files/charlie'
+    }];
+
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, DOCUMENTS));
+
+    expect((0, _getDocuments.default)(FORM_DATA)).toEqual(DOCUMENTS);
+  });
+});

package/dist/utils/Meta/documents/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _constants = require("../constants");
+
+var _setDocumentForField = _interopRequireDefault(require("./setDocumentForField"));
+
+var _getDocuments = _interopRequireDefault(require("./getDocuments"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Local imports
+var documents = {
+  setForField: _setDocumentForField.default,
+  get: _getDocuments.default,
+  name: _constants.META_DOCUMENTS_PROPERTY
+};
+var _default = documents;
+exports.default = _default;

package/dist/utils/Meta/documents/setDocumentForField.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _constants = require("../constants");
+
+var _getDocuments = _interopRequireDefault(require("./getDocuments"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+var setDocumentForField = function setDocumentForField(document, formData, field) {
+  var documents = (0, _getDocuments.default)(formData).filter(function (d) {
+    return d.field !== field;
+  });
+
+  if (document) {
+    documents.push(_objectSpread(_objectSpread({}, document), {}, {
+      field: field
+    }));
+  }
+
+  var existing = formData ? formData[_constants.META_PROPERTY] : undefined;
+  return _objectSpread(_objectSpread({}, existing), {}, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, documents));
+};
+
+var _default = setDocumentForField;
+exports.default = _default;

package/dist/utils/Meta/documents/setDocumentForField.test.js

@@ -0,0 +1,49 @@
+"use strict";
+
+var _constants = require("../constants");
+
+var _setDocumentForField = _interopRequireDefault(require("./setDocumentForField"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+describe('Utils.Meta.documents.add', function () {
+  var ALPHA_DOCUMENT = {
+    field: 'alpha',
+    url: 'http://alpha-bravo.com/files/alpha'
+  };
+  var BRAVO_DOCUMENT = {
+    field: 'bravo',
+    url: 'http://alpha-bravo.com/files/bravo'
+  };
+  it('should return an appropriately set up object if formData is null', function () {
+    expect((0, _setDocumentForField.default)(ALPHA_DOCUMENT, null, ALPHA_DOCUMENT.field)).toEqual(_defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+  });
+  it('should add a new document to the array', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+
+    expect((0, _setDocumentForField.default)(BRAVO_DOCUMENT, FORM_DATA, BRAVO_DOCUMENT.field)).toEqual(_defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT, BRAVO_DOCUMENT]));
+  });
+  it('should replace an existing document with the same field', function () {
+    var NEW_URL = 'http://replacement.com/files/alpha';
+    var NEW_ALPHA = {
+      field: ALPHA_DOCUMENT.field,
+      url: NEW_URL
+    };
+
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+
+    expect((0, _setDocumentForField.default)(NEW_ALPHA, FORM_DATA, NEW_ALPHA.field)).toEqual(_defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [NEW_ALPHA]));
+  });
+  it('should handle a null document being passed where a document with that field already exists', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+
+    expect((0, _setDocumentForField.default)(null, FORM_DATA, ALPHA_DOCUMENT.field)).toEqual(_defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, []));
+  });
+  it('should handle a null document being passed where a document with that field does not already exist', function () {
+    var FORM_DATA = _defineProperty({}, _constants.META_PROPERTY, _defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+
+    expect((0, _setDocumentForField.default)(null, FORM_DATA, BRAVO_DOCUMENT.field)).toEqual(_defineProperty({}, _constants.META_DOCUMENTS_PROPERTY, [ALPHA_DOCUMENT]));
+  });
+});

package/dist/utils/Meta/index.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.Meta = void 0;
+
+var _constants = require("./constants");
+
+var _documents = _interopRequireDefault(require("./documents"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Local imports
+var Meta = {
+  documents: _documents.default,
+  name: _constants.META_PROPERTY
+};
+exports.Meta = Meta;
+var _default = Meta;
+exports.default = _default;