feat: initial commit of a typegoose extension

docs: add more example code to README.md

fix: use build-extension to create @loopback/typegoose

feat: adds mongoose variant

docs: update README files

fix: license headers

fix: remove mongoose

extensions/typegoose/.npmrc

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

extensions/typegoose/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) IBM Corp. 2020.
+Node module: @loopback/typegoose
+This project is licensed under the MIT License, full text below.
+
+--------
+
+MIT License
+
+MIT License Copyright (c) IBM Corp. 2020
+
+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 (including the next
+paragraph) 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.

extensions/typegoose/README.md

@@ -0,0 +1,165 @@
+# @loopback/typegoose
+
+## Stability: ⚠️Experimental⚠️
+
+> Experimental packages provide early access to advanced or experimental
+> functionality to get community feedback. Such modules are published to npm
+> using `0.x.y` versions. Their APIs and functionality may be subject to
+> breaking changes in future releases.
+
+[![LoopBack](<https://github.com/strongloop/loopback-next/raw/master/docs/site/imgs/branding/Powered-by-LoopBack-Badge-(blue)[email protected]>)](http://loopback.io/)
+
+## ⚠️Warnings⚠️
+
+As of `0.0.1` of this extension, the type definitions of `@types/mongoose` are
+several signifigant minor versions out of date: it supports mongoose `5.7.12`,
+and the latest stable version of mongoose is `5.9.10`. These types are used by
+the latest version of `@typegoose/typegoose`.
+
+## Using your existing Typegoose Schemas in Loopback
+
+Using typegoose schemas is relatively straightforward, though at this early
+stage it's still a number of steps:
+
+- Import the component, and it's binding:
+  `import {LoopbackTypegooseComponent, TypegooseBindings} from '@loopback/typegoose'`
+
+- Register your configuration (see below)
+  ```ts
+  this.configure(TypegooseBindings.COMPONENT).to(configuration);
+  ```
+- Add the component to your application
+  ```ts
+  this.component(LoopbackTypegooseComponent);
+  ```
+- Finally, `@inject` your Entity Models for use
+  ```ts
+  public async MyService(@inject('loopback-typegoose-component.model.ModelName') ModelName) {
+    const result = await ModelName.findOne({});
+  }
+  ```
+
+## Configuration
+
+There are three pieces of information that the Mongoose Component needs in order
+to create a connection to your database and set up the mongoose models:
+
+- the `uri` of the connection
+- an array of Schema classes
+- optionally, an array of Discriminator Schema classes
+
+The configuration looks like the following:
+
+```ts
+ this.configure(TypegooseBindings.COMPONENT).to({
+   uri: 'mongodb://localhost:27017',
+   connectionOptions: {} // anything valid to mongoose.createConnection(),
+   schemas: [
+     {
+       bindingKey: 'my-custom.binding.key',
+       schema: myImportedSchema,
+       name: 'MyModel'
+      }
+   ],
+   discriminators: [
+     {
+       bindingKey: 'my-custom.discriminator.binding.key',
+       modelKey: 'my-custom.binding.key',
+       schema: myImportedDiscriminatorSchema,
+       value: 'MyModelDiscriminator'
+     }
+   ]
+ })
+```
+
+For multiple connections, pass an array instead of an object:
+
+```ts
+this.configure(MongooseBindings.COMPONENT).to([
+  {
+    uri: 'mongodb://localhost:27017',
+    schemas: [...]
+  },
+  {
+    uri: 'mongodb://127.0.0.12:27017',
+    schemas: [...]
+  }
+])
+```
+
+Remember, models are **always** scoped to a single connection. See the
+[Mongoose Documentation for Multiple Connections](https://mongoosejs.com/docs/connections.html#multiple_connections)
+for more information.
+
+### uri
+
+This is a valid mongodb connection uri string. See the
+[MongoDB Documentation](https://docs.mongodb.com/manual/reference/connection-string/)
+for more information.
+
+### connectionOptions
+
+_(optional)_
+
+Optionally, these are options that can be passed to the mongoose
+`createConnection` function. See the
+[Mongoose Documentation](https://mongoosejs.com/docs/api.html#mongoose_Mongoose-createConnection)
+for more details.
+
+### Schemas
+
+The Mongoose Component will create the schemas for you. Each item in this array
+contains the information necessary to so do:
+
+**schema**
+
+The schema class itself, created from `class MySchema {}`, and passed to
+`getModelForClass()`
+
+**schemaOptions**
+
+See the
+[typegoose documentation](https://typegoose.github.io/typegoose/docs/functions/getModelForClass/#example)
+**customOptions**
+
+See the
+[typegoose documentation](https://typegoose.github.io/typegoose/docs/functions/getModelForClass/#example)
+
+**bindingKey** _optional_
+
+Optionally, you can create your own binding key. The default binding key will be
+`loopback-typegoose-extensions.model.${name}`. If you have multiple connections,
+the binding key will include the connection index:
+`loopback-typegoose-extension.connection.0.model.${name}`
+
+Using the same binding key for a model on multiple connections is not supported,
+and doing so will throw an `Error`.
+
+## Discriminators
+
+Creating discriminators requires having already created a model to create the
+discriminator from. The configuration to do so requires the bindingKey for the
+original model, as well as the binding key for the new model, as well as the
+name of the discriminator.
+
+**schema**
+
+The schema class itself, created from `class MySchema {}`, and passed to
+`getDiscriminatorModelForClass(BaseModel, DiscriminatorClass)`
+
+**modelKey**
+
+This must be the same binding key used for the discriminator base model.
+
+**bindingKey** _(optional)_
+
+Optionally, you can create your own binding key. The default binding key will be
+`loopback-typegoose-extensions.model.${name}`. If you have multiple connections,
+the binding key will include the connection index:
+`loopback-typegoose-extension.connection.0.model.${name}`
+
+# Using the Typegoose Extension
+
+There is a full REST server used for
+[integration tests](./src/__tests__/integration), which contains an example of
+how to set up and use mongoose models and discriminators.

extensions/typegoose/index.d.ts

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

extensions/typegoose/index.js

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2020. All Rights Reserved.
+// Node module: @loopback/typegoose
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+module.exports = require('./dist');

extensions/typegoose/index.ts

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