fix(deps): Updates core to 6.0.2. (#11)

BREAKING CHANGE: The `filter`, `sort`, and `paginate` options are now optional.
BREAKING CHANGE: The `upsertEntity` function has been removed due to filter issues.
BREAKING CHANGE: The `overwriteEntity` function was renamed to `replaceEntity`.
BREAKING CHANGE: Removes Id interface from all functions.

Author: ryasmi

.circleci/config.yml

@@ -38,7 +38,7 @@ jobs:
           command: npm run lint
       - run:
           name: Checking Code Duplication
-          command: npm run duplication -- --limit 10
+          command: npm run duplication -- --limit 15
       - deploy:
           name: Semantic Release
           command: npm run semantic-release

package-lock.json

@@ -25,15 +25,15 @@
     "check-coverage": true
   },
   "dependencies": {
-    "@js-entity-repos/core": "^4.1.2",
+    "@js-entity-repos/core": "^6.0.2",
     "axios": "^0.17.1",
     "http-status-codes": "^1.3.0",
     "lodash": "^4.17.4"
   },
   "devDependencies": {
     "@ht2-labs/semantic-release": "1.0.27",
     "@ht2-labs/typescript-project": "1.0.9",
-    "@js-entity-repos/memory": "1.0.3",
+    "@js-entity-repos/memory": "^3.0.0",
     "@types/body-parser": "1.16.8",
     "@types/dotenv": "4.0.2",
     "@types/express": "4.11.1",

package.json

@@ -4,53 +4,59 @@
 ### Usage
 1. Install it with `npm i @js-entity-repos/axios`.
 1. For each entity you will need to do the following.
-    1. [Create Id and Entity interfaces](#id-and-entity-interface).
-    1. [Create a facade config](#facade-config).
-    1. [Construct the facade with the config and interfaces](#calling-the-facade).
+    1. [Create an Entity interface](#entity-interface).
+    1. [Create a factory config](#factory-config).
+    1. [Construct the facade](#construct-the-facade).
     1. [Use the facade](https://github.com/js-entity-repos/core/blob/master/docs/facade.md).
 
-### Id and Entity Interface
+### Entity Interface
 
 ```ts
-export interface TodoId {
-  readonly id: string;
-}
+import Entity from '@js-entity-repos/core/dist/types/Entity';
 
-export interface TodoEntity extends TodoId {
+export interface TodoEntity extends Entity {
   readonly description: string;
   readonly completed: boolean;
 }
 ```
 
-### Facade Config
+### Factory Config
 
 ```ts
-import FacadeConfig from '@js-entity-repos/axios/dist/Config';
-import connectToDb from '@js-entity-repos/axios/dist/utils/connectToDb';
+import FactoryConfig from '@js-entity-repos/axios/dist/FactoryConfig';
 import axios from 'axios';
 
-const todoFacadeConfig: FacadeConfig = {
+const todoFactoryConfig: FactoryConfig = {
   axios: axios.create({
     baseURL: `http://localhost:80/api/todos`,
   }),
-  constructDocument: (id, patch) => {
-    // Converts an entity to a document for the database.
-    return { ...patch, ...id }
+  constructDocument: (patch) => {
+    // Optional property that converts an entity to a document for the database.
+    return patch;
   },
   constructEntity: (document) => {
-    // Converts a document from the database to an entity.
+    // Optional property that converts a document from the database to an entity.
     return document;
   },
+  constructFilter: (filter) => {
+    // Optional property that converts an entity filter to a filter for the DB.
+    return filter;
+  },
+  constructSort: (sort) => {
+    // Optional property that converts an entity sort to a sort for the DB.
+    return sort;
+  },
+  defaultPaginationLimit: 100, // Optional property.
   entityName: 'todo',
 };
 ```
 
-The tests in this package contain a [demonstration of how to implement an Express router for the functions in this facade](./src/utils/express).
+The tests in this package contain a [demonstration of how to implement an Express router for the functions in this facade](./src/utils/expressPresenter).
 
 ### Construct the Facade
 
 ```ts
-import facade from '@js-entity-repos/axios/dist/facade';
+import factory from '@js-entity-repos/axios/dist/factory';
 
-const todosFacade = facade<TodoId, TodoEntity>(todoFacadeConfig);
+const todosFacade = factory(todoFactoryConfig);
 ```

readme.md

@@ -0,0 +1,16 @@
+import Entity from '@js-entity-repos/core/dist/types/Entity';
+import { Filter } from '@js-entity-repos/core/dist/types/Filter';
+import Sort from '@js-entity-repos/core/dist/types/Sort';
+import { AxiosInstance } from 'axios';
+
+export type Document = any;
+
+export default interface FacadeConfig<E extends Entity> {
+  readonly axios: AxiosInstance;
+  readonly constructDocument: (patch: Partial<E>) => Document;
+  readonly constructEntity: (document: Document) => E;
+  readonly constructFilter: (filter: Filter<E>) => any;
+  readonly constructSort: (sort: Sort<E>) => any;
+  readonly defaultPaginationLimit: number;
+  readonly entityName: string;
+}

src/Config.ts

@@ -0,0 +1,16 @@
+import Entity from '@js-entity-repos/core/dist/types/Entity';
+import { Filter } from '@js-entity-repos/core/dist/types/Filter';
+import Sort from '@js-entity-repos/core/dist/types/Sort';
+import { AxiosInstance } from 'axios';
+
+export type Document = any;
+
+export default interface FactoryConfig<E extends Entity> {
+  readonly axios: AxiosInstance;
+  readonly constructDocument?: (patch: Partial<E>) => Document;
+  readonly constructEntity?: (document: Document) => E;
+  readonly constructFilter?: (filter: Filter<E>) => any;
+  readonly constructSort?: (sort: Sort<E>) => any;
+  readonly defaultPaginationLimit?: number;
+  readonly entityName: string;
+}

src/FacadeConfig.ts

@@ -2,11 +2,11 @@ import * as sourceMapSupport from 'source-map-support';
 sourceMapSupport.install();
 
 import facadeTest from '@js-entity-repos/core/dist/tests';
-import { TestEntity, TestId } from '@js-entity-repos/core/dist/tests/utils/testEntity';
+import { TestEntity } from '@js-entity-repos/core/dist/tests/utils/testEntity';
 import axios from 'axios';
 import { config } from 'dotenv';
 import 'mocha'; // tslint:disable-line:no-import-side-effect
-import facade from './facade';
+import factory from './factory';
 import createTestServer from './utils/createTestServer';
 config();
 
@@ -27,15 +27,13 @@ before(async () => {
 });
 
 after(async () => {
-  const app = await testServer;
-  app.close();
+  const server = await testServer;
+  server.close();
 });
 
-facadeTest(facade<TestId, TestEntity>({
+facadeTest(factory<TestEntity>({
   axios: axios.create({
     baseURL: `http://localhost:${testServerPort}${testServerRoute}`,
   }),
-  constructDocument: (id, patch) => ({ ...patch, ...id }),
-  constructEntity: (document) => document,
   entityName: 'Test Entity',
 }));

src/FactoryConfig.ts

@@ -0,0 +1,33 @@
+import Facade from '@js-entity-repos/core/dist/Facade';
+import Entity from '@js-entity-repos/core/dist/types/Entity';
+import FacadeConfig from './FacadeConfig';
+import FactoryConfig from './FactoryConfig';
+import countEntities from './functions/countEntities';
+import createEntity from './functions/createEntity';
+import getEntities from './functions/getEntities';
+import getEntity from './functions/getEntity';
+import patchEntity from './functions/patchEntity';
+import removeEntities from './functions/removeEntities';
+import removeEntity from './functions/removeEntity';
+import replaceEntity from './functions/replaceEntity';
+
+export default <E extends Entity>(factoryConfig: FactoryConfig<E>): Facade<E> => {
+  const facadeConfig: FacadeConfig<E> = {
+    constructDocument: (patch) => patch,
+    constructEntity: (document) => document,
+    constructFilter: (filter) => filter,
+    constructSort: (sort) => sort,
+    defaultPaginationLimit: 100,
+    ...factoryConfig,
+  };
+  return {
+    countEntities: countEntities<E>(facadeConfig),
+    createEntity: createEntity<E>(facadeConfig),
+    getEntities: getEntities<E>(facadeConfig),
+    getEntity: getEntity<E>(facadeConfig),
+    patchEntity: patchEntity<E>(facadeConfig),
+    removeEntities: removeEntities<E>(facadeConfig),
+    removeEntity: removeEntity<E>(facadeConfig),
+    replaceEntity: replaceEntity<E>(facadeConfig),
+  };
+};