feat: Add REST mapping for repository interfaces

packages/repository-rest/.gitignore

@@ -0,0 +1,3 @@
+*.tgz
+dist*
+package

packages/repository-rest/.npmrc

@@ -0,0 +1 @@
+package-lock=false

packages/repository-rest/LICENSE

@@ -0,0 +1,25 @@
+Copyright (c) IBM Corp. 2017. All Rights Reserved.
+Node module: @loopback/repository
+This project is licensed under the MIT License, full text below.
+
+--------
+
+MIT license
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

packages/repository-rest/README.md

@@ -0,0 +1,15 @@
+# @loopback/repository-rest
+
+This module provides base controllers to map repository interfaces to REST APIs
+
+## Tests
+
+run 'npm test' from the root folder.
+
+## Contributors
+
+See [all contributors](https://github.com/strongloop/loopback-next/graphs/contributors).
+
+## License
+
+MIT

packages/repository-rest/docs.json

@@ -0,0 +1,11 @@
+{
+    "content": [
+        "./index.ts",
+        "./src/i**/*.ts"
+    ],
+    "codeSectionDepth": 4,
+    "assets": {
+      "/": "/docs",
+      "/docs": "/docs"
+    }
+}

packages/repository-rest/index.d.ts

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './dist/src';

packages/repository-rest/index.js

@@ -0,0 +1,9 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+const nodeMajorVersion = +process.versions.node.split('.')[0];
+module.exports = nodeMajorVersion >= 7 ?
+  require('./dist/src') :
+  require('./dist6/src');

packages/repository-rest/index.ts

@@ -0,0 +1,7 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+// NOTE(bajtos) This file is used by VSCode/TypeScriptServer at dev time only
+export * from './src';

packages/repository-rest/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@loopback/repository-rest",
+  "version": "4.0.0-alpha.1",
+  "description": "Repository REST APIs for LoopBack",
+  "engines": {
+    "node": ">=6"
+  },
+  "main": "index",
+  "scripts": {
+    "acceptance": "lb-dist mocha --opts ../../test/mocha.opts 'DIST/test/acceptance/**/*.js'",
+    "build": "npm run build:dist && npm run build:dist6",
+    "build:current": "lb-tsc",
+    "build:dist": "lb-tsc es2017",
+    "build:dist6": "lb-tsc es2015",
+    "build:apidocs": "lb-apidocs",
+    "clean": "rm -rf loopback-context*.tgz dist* package",
+    "prepare": "npm run build && npm run build:apidocs",
+    "pretest": "npm run build:current",
+    "test": "lb-dist mocha --opts ../../test/mocha.opts 'DIST/test/unit/**/*.js' 'DIST/test/acceptance/**/*.js'",
+    "unit": "lb-dist mocha --opts ../../test/mocha.opts 'DIST/test/unit/**/*.js'",
+    "verify": "npm pack && tar xf loopback-juggler*.tgz && tree package && npm run clean"
+  },
+  "author": "IBM",
+  "license": "MIT",
+  "devDependencies": {
+    "@loopback/build": "^4.0.0-alpha.5",
+    "@loopback/testlab": "^4.0.0-alpha.14"
+  },
+  "dependencies": {
+    "@loopback/context": "^4.0.0-alpha.20",
+    "@loopback/core": "^4.0.0-alpha.22",
+    "@loopback/repository": "^4.0.0-alpha.16",
+    "@loopback/rest": "^4.0.0-alpha.9"
+  },
+  "files": [
+    "README.md",
+    "index.js",
+    "index.d.ts",
+    "dist/src",
+    "dist6/src",
+    "api-docs",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/strongloop/loopback-next.git"
+  }
+}

packages/repository-rest/src/controllers/crud-controller.ts

@@ -0,0 +1,85 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+import {
+  CrudRepository,
+  ValueObject,
+  Entity,
+  DataObject,
+  Options,
+  Filter,
+  Where,
+} from '@loopback/repository';
+
+import {post, get, param} from '@loopback/rest';
+
+/**
+ * Base controller class to expose CrudRepository operations to REST
+ */
+export abstract class CrudController<T extends ValueObject | Entity> {
+  protected repository: CrudRepository<T>;
+
+  @post(`/`)
+  create(
+    @param({name: '', in: 'body'})
+    dataObject: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<T> {
+    return this.repository.create(dataObject, options);
+  }
+
+  @post(`/`)
+  createAll(
+    @param({name: '', in: 'body'})
+    dataObjects: DataObject<T>[],
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<T[]> {
+    return this.repository.createAll(dataObjects, options);
+  }
+
+  @get(`/`)
+  find(
+    @param({name: 'filter', required: false, in: 'query'})
+    filter?: Filter,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<T[]> {
+    return this.repository.find(filter, options);
+  }
+
+  @post(`/updateAll`)
+  updateAll(
+    @param({name: '', in: 'body'})
+    dataObject: DataObject<T>,
+    @param({name: 'where', required: false, in: 'query'})
+    where?: Where,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<number> {
+    return this.repository.updateAll(dataObject, where, options);
+  }
+
+  @post(`/deleteAll`)
+  deleteAll(
+    @param({name: 'where', required: false, in: 'query'})
+    where?: Where,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<number> {
+    return this.repository.deleteAll(where, options);
+  }
+
+  @get(`/count`)
+  count(
+    @param({name: 'where', required: false, in: 'query'})
+    where?: Where,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<number> {
+    return this.repository.count(where, options);
+  }
+}

packages/repository-rest/src/controllers/entity-crud-controller.ts

@@ -0,0 +1,110 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+import {
+  Entity,
+  DataObject,
+  Options,
+  Filter,
+  EntityCrudRepository,
+} from '@loopback/repository';
+
+import {post, put, patch, get, del, param} from '@loopback/rest';
+
+import {CrudController} from './crud-controller';
+
+/**
+ * Base controller class to expose CrudRepository operations to REST
+ */
+export abstract class EntityCrudController<
+  T extends Entity,
+  ID
+> extends CrudController<T> {
+  protected repository: EntityCrudRepository<T, ID>;
+
+  @put(`/save`)
+  save(
+    @param({name: '', in: 'body'})
+    entity: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<T | null> {
+    return this.repository.save(entity, options);
+  }
+
+  @post(`/update`)
+  update(
+    @param({name: '', in: 'body'})
+    entity: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.update(entity, options);
+  }
+
+  @post(`/delete`)
+  delete(
+    @param({name: '', in: 'body'})
+    entity: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.update(entity, options);
+  }
+
+  @get(`/{id}`)
+  findById(
+    id: ID,
+    filter?: Filter,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<T> {
+    return this.repository.findById(id, filter, options);
+  }
+
+  @patch(`/{id}`)
+  updateById(
+    @param({name: 'id', in: 'path'})
+    id: ID,
+    @param({name: '', in: 'body'})
+    data: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.updateById(id, data, options);
+  }
+
+  @put(`/{id}`)
+  replaceById(
+    @param({name: 'id', in: 'path'})
+    id: ID,
+    @param({name: '', in: 'body'})
+    data: DataObject<T>,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.replaceById(id, data, options);
+  }
+
+  @del(`{id}`)
+  deleteById(
+    @param({name: 'id', in: 'path'})
+    id: ID,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.deleteById(id, options);
+  }
+
+  @get(`/{id}/exists`)
+  exists(
+    @param({name: 'id', in: 'path'})
+    id: ID,
+    @param({name: 'options', required: false, in: 'query'})
+    options?: Options,
+  ): Promise<boolean> {
+    return this.repository.exists(id, options);
+  }
+}

packages/repository-rest/src/controllers/index.ts

@@ -0,0 +1,7 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './crud-controller';
+export * from './entity-crud-controller';

packages/repository-rest/src/index.ts

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2017. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './controllers';