@performant-software/user-defined-fields 3.1.22-beta.4 → 3.1.22-beta.5

package/src/components/UserDefinedFieldsList.js

@@ -1,94 +0,0 @@
-// @flow
-
-import { BooleanIcon, ListTable } from '@performant-software/semantic-components';
-import type { ListTableProps } from '@performant-software/semantic-components/types';
-import React, { type ComponentType, useCallback } from 'react';
-import _ from 'underscore';
-import i18n from '../i18n/i18n';
-import UserDefinedFieldModal from './UserDefinedFieldModal';
-import UserDefinedFields from '../utils/UserDefinedFields';
-import UserDefinedFieldsService from '../services/UserDefinedFields';
-
-type Props = ListTableProps & {
-  defaults?: any,
-  excludeColumns?: Array<string>
-};
-
-const OMIT_PROPS = [
-  'collectionName',
-  'columns',
-  'defaults',
-  'excludeColumns',
-  'modal',
-  'onDelete',
-  'onLoad',
-  'onSave'
-];
-
-const DEFAULT_ORDER = 0;
-
-const UserDefinedFieldsList: ComponentType<any> = (props: Props) => {
-  /**
-   * Returns true if the passed column should be hidden by default.
-   *
-   * @type {function(*): *}
-   */
-  const isHidden = useCallback((column) => _.contains(props.excludeColumns, column), [props.excludeColumns]);
-
-  return (
-    <ListTable
-      {..._.omit(props, OMIT_PROPS)}
-      columns={[{
-        name: 'table_name',
-        label: i18n.t('UserDefinedFieldsList.columns.table'),
-        hidden: isHidden('table_name')
-      }, {
-        name: 'column_name',
-        label: i18n.t('UserDefinedFieldsList.columns.name'),
-        hidden: isHidden('column_name')
-      }, {
-        name: 'data_type',
-        label: i18n.t('UserDefinedFieldsList.columns.dataType'),
-        hidden: isHidden('data_type')
-      }, {
-        name: 'required',
-        label: i18n.t('UserDefinedFieldsList.columns.required'),
-        render: (udf) => <BooleanIcon value={udf.required} />,
-        hidden: isHidden('required')
-      }, {
-        name: 'order',
-        label: i18n.t('UserDefinedFieldsList.columns.order'),
-        hidden: isHidden('order')
-      }, {
-        name: 'uuid',
-        label: i18n.t('UserDefinedFieldsList.columns.uuid'),
-        hidden: isHidden('uuid')
-      }]}
-      collectionName='user_defined_fields'
-      modal={{
-        component: UserDefinedFieldModal,
-        props: {
-          defaults: {
-            order: DEFAULT_ORDER,
-            ...(props.defaults || {})
-          },
-          hideTable: isHidden('table_name'),
-          validate: UserDefinedFields.validateUserDefinedField.bind(this)
-        }
-      }}
-      onDelete={(udf) => UserDefinedFieldsService.delete(udf)}
-      onLoad={(params) => UserDefinedFieldsService.fetchAll(params)}
-      onSave={(udf) => UserDefinedFieldsService.save(udf)}
-    />
-  );
-};
-
-UserDefinedFieldsList.defaultProps = {
-  actions: [{
-    name: 'edit'
-  }, {
-    name: 'delete'
-  }]
-};
-
-export default UserDefinedFieldsList;

package/src/constants/DataTypes.js

@@ -1,9 +0,0 @@
-// @flow
-
-import { UserDefinedFields as UserDefinedFieldsUtils } from '@performant-software/shared-components';
-
-const { DataTypes } = UserDefinedFieldsUtils;
-
-export {
-  DataTypes
-};

package/src/hooks/UserDefinedFields.js

@@ -1,114 +0,0 @@
-// @flow
-
-import { BooleanIcon } from '@performant-software/semantic-components';
-import { Date as DateUtils, FuzzyDate as FuzzyDateUtils } from '@performant-software/shared-components';
-import React, {
-  useCallback,
-  useEffect,
-  useMemo,
-  useState
-} from 'react';
-import _ from 'underscore';
-import { DataTypes } from '../constants/DataTypes';
-import UserDefinedFieldsService from '../services/UserDefinedFields';
-
-/**
- * Returns the loading state and list of user defined columns for the passed defineable ID and defineable type.
- *
- * @param defineableId
- * @param defineableType
- * @param options
- *
- * @returns {{userDefinedColumns: [], loading: boolean}}
- */
-const useUserDefinedColumns = (defineableId, defineableType, options = {}) => {
-  const [userDefinedFields, setUserDefinedFields] = useState([]);
-  const [loading, setLoading] = useState(false);
-
-  const { sortable = true } = options;
-
-  /**
-   * Resolves the user defined field value for the passed item.
-   *
-   * @type {(function(*, *): (null|*))|*}
-   */
-  const resolveValue = useCallback((item, field) => {
-    let record = item;
-
-    if (options.resolveRecord) {
-      record = options.resolveRecord(item);
-    }
-
-    if (!record.user_defined) {
-      return null;
-    }
-
-    return record.user_defined[field.uuid];
-  }, [options.resolveRecord]);
-
-  /**
-   * Memo-izes the columns.
-   *
-   * @type {[]}
-   */
-  const userDefinedColumns = useMemo(() => {
-    const columns = [];
-
-    _.each(userDefinedFields, (field) => {
-      const column = {
-        name: field.uuid,
-        label: field.column_name,
-        hidden: true,
-        sortable
-      };
-
-      if (field.data_type === DataTypes.boolean) {
-        columns.push({
-          ...column,
-          render: (item) => (
-            <BooleanIcon
-              value={resolveValue(item, field)}
-            />
-          )
-        });
-      } else if (field.data_type === DataTypes.date) {
-        columns.push({
-          ...column,
-          resolve: (item) => DateUtils.formatDate(resolveValue(item, field))
-        });
-      } else if (field.data_type === DataTypes.fuzzyDate) {
-        columns.push({
-          ...column,
-          resolve: (item) => FuzzyDateUtils.getDateView(resolveValue(item, field))
-        });
-      } else if (field.data_type !== DataTypes.richText) {
-        columns.push({
-          ...column,
-          resolve: (item) => resolveValue(item, field)
-        });
-      }
-    });
-
-    return columns;
-  }, [resolveValue, userDefinedFields]);
-
-  /**
-   * Fetches the user defined fields for the passed defineable ID and defineable type.
-   */
-  useEffect(() => {
-    setLoading(true);
-
-    UserDefinedFieldsService
-      .fetchAll({ defineable_id: defineableId, defineable_type: defineableType })
-      .then(({ data }) => setUserDefinedFields(data.user_defined_fields))
-      .finally(() => setLoading(false));
-  }, [defineableId, defineableId]);
-
-  return {
-    loading,
-    userDefinedColumns,
-    userDefinedFields
-  };
-};
-
-export default useUserDefinedColumns;

package/src/i18n/en.json

@@ -1,42 +0,0 @@
-{
-  "UserDefinedFieldModal": {
-    "labels": {
-      "allowMultiple": "Allow multiple",
-      "dataType": "Data type",
-      "name": "Name",
-      "order": "Order",
-      "required": "Required",
-      "searchable": "Searchable",
-      "table": "Table"
-    },
-    "title": {
-      "add": "Add User Defined Field",
-      "edit": "Edit User Defined Field"
-    }
-  },
-  "UserDefinedFields": {
-    "errors": {
-      "numeric": "{{name}} must be numeric"
-    }
-  },
-  "UserDefinedFieldsEmbeddedList": {
-    "columns": {
-      "dataType": "Data type",
-      "name": "Name",
-      "order": "Order",
-      "required": "Required",
-      "table": "Table",
-      "uuid": "Identifier"
-    }
-  },
-  "UserDefinedFieldsList": {
-    "columns": {
-      "dataType": "Data type",
-      "name": "Name",
-      "order": "Order",
-      "required": "Required",
-      "table": "Table",
-      "uuid": "Identifier"
-    }
-  }
-}

package/src/i18n/i18n.js

@@ -1,24 +0,0 @@
-import { createInstance } from 'i18next';
-
-import en from './en.json';
-
-const resources = {
-  en: {
-    translation: en
-  }
-};
-
-const i18n = createInstance();
-
-i18n
-  .init({
-    debug: true,
-    fallbackLng: 'en',
-    lng: 'en',
-    interpolation: {
-      escapeValue: false
-    },
-    resources
-  });
-
-export default i18n;

package/src/index.js

@@ -1,28 +0,0 @@
-// @flow
-
-// Components
-export { default as UserDefinedFieldModal } from './components/UserDefinedFieldModal';
-export { default as UserDefinedFieldOptions } from './components/UserDefinedFieldOptions';
-export { default as UserDefinedFieldsEmbeddedList } from './components/UserDefinedFieldsEmbeddedList';
-export { default as UserDefinedFieldsForm } from './components/UserDefinedFieldsForm';
-export { default as UserDefinedFieldsList } from './components/UserDefinedFieldsList';
-
-// Constants
-export { DataTypes } from './constants/DataTypes';
-
-// Hooks
-export { default as useUserDefinedColumns } from './hooks/UserDefinedFields';
-
-// Services
-export { default as UserDefinedFieldsService } from './services/UserDefinedFields';
-
-// Transforms
-export { default as FieldableTransform } from './transforms/Fieldable';
-export { default as UserDefinedFieldTransform } from './transforms/UserDefinedField';
-export { default as UserDefinedFieldsTransform } from './transforms/UserDefinedFields';
-
-// Types
-export type { UserDefinedField } from './types/UserDefinedField';
-
-// Utils
-export { default as UserDefinedFields } from './utils/UserDefinedFields';

package/src/services/UserDefinedFields.js

@@ -1,48 +0,0 @@
-// @flow
-
-import { BaseService } from '@performant-software/shared-components';
-import UserDefinedField from '../transforms/UserDefinedField';
-
-/**
- * Class responsible for handling all user defined field API requests.
- */
-class UserDefinedFields extends BaseService {
-  /**
-   * Calls the /api/user_defined_fields/data_types API endpoint.
-   *
-   * @returns {Promise<AxiosResponse<any>>}
-   */
-  fetchDataTypes(): Promise<any> {
-    return this.getAxios().get('/user_defined_fields/data_types');
-  }
-
-  /**
-   * Calls the /api/user_defined_fields/tables API endpoint.
-   *
-   * @returns {Promise<AxiosResponse<any>>}
-   */
-  fetchTables(): Promise<any> {
-    return this.getAxios().get('/user_defined_fields/tables');
-  }
-
-  /**
-   * Returns the user defined fields base URL.
-   *
-   * @returns {string}
-   */
-  getBaseUrl(): string {
-    return '/user_defined_fields/user_defined_fields';
-  }
-
-  /**
-   * Returns the user defined fields transform object.
-   *
-   * @returns {UserDefinedField}
-   */
-  getTransform(): any {
-    return UserDefinedField;
-  }
-}
-
-const UserDefinedFieldsService: UserDefinedFields = new UserDefinedFields();
-export default UserDefinedFieldsService;

package/src/transforms/Fieldable.js

@@ -1,27 +0,0 @@
-// @flow
-
-import { Form as FormUtils } from '@performant-software/shared-components';
-import _ from 'underscore';
-
-/**
- * Class responsible for transforming fieldable data.
- */
-class Fieldable {
-  /**
-   * Converts the "user_defined" data for the passed fieldable item into form data.
-   *
-   * @param formData
-   * @param prefix
-   * @param item
-   */
-  toFormData(formData, prefix, item) {
-    const { user_defined: userDefined } = item;
-
-    _.each(_.keys(userDefined), (key) => {
-      FormUtils.setAttribute(formData, `${prefix}[user_defined]`, userDefined, key);
-    });
-  }
-}
-
-const FieldableTransform: Fieldable = new Fieldable();
-export default FieldableTransform;

package/src/transforms/UserDefinedField.js

@@ -1,38 +0,0 @@
-// @flow
-
-import { BaseTransform } from '@performant-software/shared-components';
-
-/**
- * Class for transforming user defined field objects for PUT/POST requests.
- */
-class UserDefinedField extends BaseTransform {
-  /**
-   * Returns the user defined field payload keys.
-   *
-   * @returns {string[]}
-   */
-  getPayloadKeys(): Array<string> {
-    return [
-      'table_name',
-      'column_name',
-      'data_type',
-      'required',
-      'searchable',
-      'allow_multiple',
-      'options',
-      'order'
-    ];
-  }
-
-  /**
-   * Returns the user defined field parameter name.
-   *
-   * @returns {string}
-   */
-  getParameterName(): string {
-    return 'user_defined_field';
-  }
-}
-
-const UserDefinedFieldTransform: UserDefinedField = new UserDefinedField();
-export default UserDefinedFieldTransform;

package/src/transforms/UserDefinedFields.js

@@ -1,57 +0,0 @@
-// @flow
-
-import { NestedAttributesTransform } from '@performant-software/shared-components';
-
-/**
- * Class for transforming user defined field nested objects for PUT/POST requests.
- */
-class UserDefinedFields extends NestedAttributesTransform {
-  /**
-   * Returns the user defined field payload keys.
-   *
-   * @returns {string[]}
-   */
-  getPayloadKeys(): Array<string> {
-    return [
-      'id',
-      'table_name',
-      'column_name',
-      'data_type',
-      'required',
-      'searchable',
-      'allow_multiple',
-      'options',
-      'order',
-      '_destroy'
-    ];
-  }
-
-  /**
-   * Converts the user defined field collection for the passed object to form data to be sent on
-   * the request as nested attributes.
-   *
-   * @param formData
-   * @param prefix
-   * @param record
-   * @param collection
-   */
-  toFormData(formData: FormData, prefix: string, record: any, collection: string = 'user_defined_fields'): void {
-    return super.toFormData(formData, prefix, record, collection);
-  }
-
-  /**
-   * Converts the user defined field collection for the passed object to JSON to be sent on
-   * the request as nested attributes.
-   *
-   * @param record
-   * @param collectionName
-   *
-   * @returns {{[p: string]: *}}
-   */
-  toPayload(record: any, collectionName: string = 'user_defined_fields'): any {
-    return super.toPayload(record, collectionName);
-  }
-}
-
-const UserDefinedFieldsTransform: UserDefinedFields = new UserDefinedFields();
-export default UserDefinedFieldsTransform;

package/src/types/UserDefinedField.js

@@ -1,15 +0,0 @@
-// @flow
-
-export type UserDefinedField = {
-  id: number,
-  defineable_id: number,
-  defineable_type: string,
-  column_name: string,
-  table_name: string,
-  data_type: string,
-  required: boolean,
-  searchable: boolean,
-  allow_multiple: boolean,
-  options: Array<string>,
-  order: number
-};

package/src/utils/UserDefinedFields.js

@@ -1,69 +0,0 @@
-// @flow
-
-import _ from 'underscore';
-import i18n from '../i18n/i18n';
-
-type ErrorProps = {
-  key: string,
-  error: Array<string>
-};
-
-type ErrorReturn = {
-  [key: string]: string
-};
-
-const KEY_USER_DEFINED = 'user_defined';
-
-const FIELD_DELIMITER = '.';
-
-/**
- * Returns the error for the passed user defined field.
- *
- * @param key
- * @param error
- *
- * @returns {{}|{[p: string]: *}}
- */
-const resolveError = ({ key, error }: ErrorProps): ErrorReturn => {
-  const errors = {};
-
-  /**
-   * Resolve errors returned when creating user defined fields.
-   */
-  if (key && key.startsWith(KEY_USER_DEFINED) && _.contains(key, FIELD_DELIMITER)) {
-    const [, field] = key.split(FIELD_DELIMITER);
-    _.extend(errors, { [`${KEY_USER_DEFINED}[${field}]`]: `${field} ${error}` });
-  }
-
-  /**
-   * Resolve errors returned when entering data into user field fields.
-   */
-  if (key === KEY_USER_DEFINED && !_.isEmpty(error)) {
-    const [field, message] = error;
-    _.extend(errors, { [`${KEY_USER_DEFINED}[${field}]`]: message });
-  }
-
-  return errors;
-};
-
-/**
- * Validates the passed user defined field.
- *
- * @param item
- *
- * @returns {{}}
- */
-const validateUserDefinedField = (item) => {
-  const errors = {};
-
-  if (!item.order) {
-    _.extend(errors, { order: i18n.t('UserDefinedFields.errors.numeric', { name: 'order' }) });
-  }
-
-  return errors;
-};
-
-export default {
-  resolveError,
-  validateUserDefinedField
-};