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

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.
BREAKING CHANGE: The `db` property in the factory config allows for reconnections.

Author: ryasmi

package-lock.json

@@ -25,7 +25,7 @@
     "check-coverage": true
   },
   "dependencies": {
-    "@js-entity-repos/core": "^4.1.2",
+    "@js-entity-repos/core": "^6.0.2",
     "knex": "^0.14.2",
     "lodash": "^4.17.4"
   },

package.json

@@ -4,39 +4,45 @@
 ### Usage
 1. Install it with `npm i @js-entity-repos/knex`.
 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 interfaces](#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/knex/dist/Config';
+import FactoryConfig from '@js-entity-repos/knex/dist/FactoryConfig';
 import connectToDb from '@js-entity-repos/knex/dist/utils/connectToDb';
 
-const todoFacadeConfig: FacadeConfig = {
-  constructDocument: (id, patch) => {
-    // Converts an entity to a document for the database.
-    return { ...patch, ...id }
+const todoFactoryConfig: FactoryConfig<TodoEntity> = {
+  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;
+  }.
   db: connectToDb({
     client: 'mysql',
     connection: {
@@ -46,6 +52,7 @@ const todoFacadeConfig: FacadeConfig = {
       user: 'todouser',
     },
   }),
+  defaultPaginationLimit: 100, // Optional property.
   entityName: 'todo',
   tableName: 'todos',
 };
@@ -54,7 +61,7 @@ const todoFacadeConfig: FacadeConfig = {
 ### Construct the Facade
 
 ```ts
-import facade from '@js-entity-repos/knex/dist/facade';
+import factory from '@js-entity-repos/knex/dist/factory';
 
-const todosFacade = facade<TodoId, TodoEntity>(todoFacadeConfig);
+const todosFacade = factory(todoFactoryConfig);
 ```

readme.md

@@ -0,0 +1,17 @@
+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 * as knex from 'knex';
+
+export type Document = any;
+
+export default interface FacadeConfig<E extends Entity> {
+  readonly constructDocument: (patch: Partial<E>) => Document;
+  readonly constructEntity: (document: Document) => E;
+  readonly constructFilter: (filter: Filter<E>) => any;
+  readonly constructSort: (sort: Sort<E>) => any;
+  readonly db: () => Promise<knex>;
+  readonly defaultPaginationLimit: number;
+  readonly entityName: string;
+  readonly tableName: string;
+}

src/Config.ts

@@ -0,0 +1,17 @@
+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 * as knex from 'knex';
+
+export type Document = any;
+
+export default interface FacadeConfig<E extends Entity> {
+  readonly constructDocument?: (patch: Partial<E>) => Document;
+  readonly constructEntity?: (document: Document) => E;
+  readonly constructFilter?: (filter: Filter<E>) => any;
+  readonly constructSort?: (sort: Sort<E>) => any;
+  readonly db: () => Promise<knex>;
+  readonly defaultPaginationLimit?: number;
+  readonly entityName: string;
+  readonly tableName: string;
+}

src/FacadeConfig.ts

@@ -1,8 +1,8 @@
 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 { config } from 'dotenv';
 import 'mocha'; // tslint:disable-line:no-import-side-effect
-import facade from './facade';
+import factory from './factory';
 import connectToDb from './utils/connectToDb';
 config();
 
@@ -21,18 +21,17 @@ const db = connectToDb({
 const tableName = 'testentities';
 
 before(async () => {
-  await Promise.resolve(db.schema.dropTableIfExists(tableName));
-  await Promise.resolve(db.schema.createTableIfNotExists(tableName, async (table) => {
+  const schema = (await db()).schema;
+  await Promise.resolve(schema.dropTableIfExists(tableName));
+  await Promise.resolve(schema.createTableIfNotExists(tableName, async (table) => {
     table.string('id').unique();
     table.string('stringProp');
     table.float('numberProp');
     table.boolean('booleanProp');
   }));
 });
 
-facadeTest(facade<TestId, TestEntity>({
-  constructDocument: (id, patch) => ({ ...patch, ...id }),
-  constructEntity: (document) => document,
+facadeTest(factory<TestEntity>({
   db,
   entityName: 'Test Entity',
   tableName,

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),
+  };
+};

src/facade.ts

@@ -1,10 +1,11 @@
 import CountEntities from '@js-entity-repos/core/dist/signatures/CountEntities';
-import Config from '../Config';
+import Entity from '@js-entity-repos/core/dist/types/Entity';
+import FacadeConfig from '../FacadeConfig';
 import filterEntities from '../utils/filterEntities';
 
-export default <Id, Entity extends Id>(config: Config<Id, Entity>): CountEntities<Entity> => {
-  return async ({ filter }) => {
-    const table = config.db.table(config.tableName);
+export default <E extends Entity>(config: FacadeConfig<E>): CountEntities<E> => {
+  return async ({ filter = {} }) => {
+    const table = (await config.db()).table(config.tableName);
     const [result] = await Promise.resolve(filterEntities(table, filter).count());
     return { count: result['count(*)'] };
   };