Merge pull request #28 from jhomarolo/master

feat(first): add first method feature

Author: dalssoft

.eslintrc.json

@@ -10,9 +10,10 @@
     "Atomics": "readonly",
     "SharedArrayBuffer": "readonly"
   },
-  "parser": "babel-eslint",
+  "parser": "@babel/eslint-parser",
   "parserOptions": {
-    "ecmaVersion": 2018
+    "ecmaVersion": 2018,
+    "requireConfigFile":false
   },
   "rules": {
     "semi": ["error", "never"],

.github/workflows/ci.yml

@@ -14,10 +14,10 @@ jobs:
     steps:
     - uses: actions/checkout@v2
 
-    - name: Use Node.js (12.16.2)
+    - name: Use Node.js (14.15.0)
       uses: actions/setup-node@v1
       with:
-        node-version: '12.16.2'
+        node-version: '14.15.0'
 
     - name: Install Packages
       run: npm ci

.github/workflows/on_pull_request.yml

@@ -10,7 +10,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [12.x]
+        node-version: [14.x]
 
     steps:
       - uses: actions/checkout@v2

.github/workflows/on_push.yml

@@ -10,7 +10,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [12.x]
+        node-version: [14.x]
 
     steps:
       - uses: actions/checkout@v2

README.md

@@ -139,9 +139,9 @@ class YourRepository extends Repository {
 ## Retrieving and Persisting Data
 
 ### `find`
-Find entities
+Find entities matched by the filter, or empty array `[]` if there is no matching entity.
 
-Format: `.find(options)` where `options` is a optional object containing `{ limit, offset, orderBy, conditions }`
+Format: `.find(options)` where `options` is a optional object containing `{ limit, offset, orderBy, where }`
 
 Return: Entity array
 
@@ -181,12 +181,12 @@ const repo = new ItemRepository(injection)
 const ret = await repo.find({ orderBy: [{ column: 'nome', order: 'desc' }, 'email'] })
 ```
 
-- `conditions`
+- `where`
 Adds a filter to the query with given values.
 
 ```javascript
 const repo = new ItemRepository(injection)
-const ret = await repo.find({ conditions: { name: ["Anne"] } })
+const ret = await repo.find({ where: { name: ["Anne"] } })
 ```
 
 ### `findByID`
@@ -201,6 +201,18 @@ const repo = new ItemRepository(injection)
 const ret = await repo.findByID(10)
 ```
 
+### `first`
+Finds the first entity matched by the filter, or empty array `[]` if there is no matching entity.
+
+Format: `.first(options)` where `options` is a optional object containing `{ orderBy, where }`
+
+Return: Entity
+
+```javascript
+const repo = new ItemRepository(injection)
+const ret = await repo.first({ orderBy: 'description'})
+```
+
 ### `insert`
 
 Insert an Entity into a table.