@godspeedsystems/plugins-mongoose-as-datasource
v1.0.7
Published
mongoose-as-datasource as datasource plugin for Godspeed Framework
Downloads
42
Keywords
Readme
Mongoose as Datasource
Welcome to the Godspeed Mongoose Plugin! 🚀
"Mongoose: Perhaps most popular Nodejs client library for Mongodb."
Mongoose is an elegant mongodb object modeling for Node.js
How to Use
- Create a godspeed project from the CLI , open the created project in vscode and then add the plugin from the CLI of vscode, select the
@godspeedsystems/plugins-mongoose-as-datastore
to integrate the plugin.
> godspeed plugin add
,_, ╔════════════════════════════════════╗
(o,o) ║ Welcome to Godspeed ║
({___}) ║ World's First Meta Framework ║
" " ╚════════════════════════════════════╝
? Please select godspeed plugin to install: (Press <space> to select, <Up and Down> to move rows)
┌──────┬────────────────────────────────────┬────────────────────────────────────────────────────────────────────┐
│ │ Name │ Description │
├──────┼────────────────────────────────────┼────────────────────────────────────────────────────────────────────┤
│ ❯◯ │ mongoose-as-datastore │ Mongoose as a datasource plugin for Godspeed Framework. │
├──────┼────────────────────────────────────┼────────────────────────────────────────────────────────────────────┤
│ ◯ │ aws-as-datasource │ aws as datasource plugin for Godspeed Framework │
├──────┼────────────────────────────────────┼────────────────────────────────────────────────────────────────────┤
│ ◯ │ excel-as-datasource │ excel as datasource plugin for Godspeed Framework │
├──────┼────────────────────────────────────┼────────────────────────────────────────────────────────────────────┤
│ ◯ │ mailer-as-datasource │ mailer as datasource plugin for Godspeed Framework │
├──────┼────────────────────────────────────┼────────────────────────────────────────────────────────────────────┤
│ ◯ │ kafka-as-datasource-as-eventsource │ kafka as datasource-as-eventsource plugin for Godspeed Framework │
└──────┴────────────────────────────────────┴────────────────────────────────────────────────────────────────────┘
- This will create some files.
You will find a file in your project related to the Prisma plugin at
src/datasources/types/mongoose.ts
Contents of types/mongoose.ts
The file will look something like this
import { DataSource } from '@godspeedsystems/plugins-mongoose-as-datastore'; export default DataSource;
<mongoose_ds_name>.yaml file
You can keep the file by any name. This file is used to initialize a mongoose datasource instance. Whatever is the name of the file, you will need to invoke the mongoose datasource commands by the same name. Also your models will be needed to be kept in a folder with the same name as your yaml file (i.e. your datasource instance name). For example mongoose1.yaml would mean calling
fn:datasources.mongoose1.<Model_Name>.<Function_Name>
from yaml workflows andctx.datasources.mongoose1.<Model_Name>.<Function_Name>
from TS/JS files. Also you will need to create a folderdatasources/mongoose1/models
and keep your models there as detailed below.You can override the default response codes for success cases for different methods by putting them in the datasource instance's yaml file
type: mongoose
successResponseCodes: #default response codes for success responses
create: 201
find: 200
findOne: 200
aggregate: 200
findOneAndUpdate: 201
findOneAndDelete: 202
Error response
When a call has an error the datasource returns following GSStatus
code: 500
success: false
data:
message: Internal Server Error
Setting up Mongoose models
This datasource loads the Mongoose models from datasources/<datasource_name>/models
folder.
Example Mongoose model file
These files are stored in datasources/<datasource_name>/models
folder Your TS or JS file should export as following
module.exports = {
type: 'SomeModel', //The name by which you will access methods of this collection/model
model: SomeModel //The Mongoose Model
};
An example Mongoose model file
const { model, Schema, Document } =require('mongoose');
const SomeModelSchema = new Schema(
{
partnerName: {
type: String,
required: true,
},
productType: {
type: String,
required: true,
},
apiType: {
type: String,
required: true,
},
method: {
type: String,
required: true,
},
api: {
type: String,
required: true,
},
code: String,
headers: Schema.Types.Mixed,
payload: Schema.Types.Mixed,
response: Schema.Types.Mixed,
isDynamicUrl: Boolean,
expectedResponseStatusCode: Number,
},
{ timestamps: true }
);
const SomeModel = model('some-model', SomeModelSchema, 'some-model');
module.exports = {
type: 'SomeModel', //The name by which you will access methods of this collection/model
model: SomeModel
};
Sample workflow for Mongoose API
When calling any api function it will be called as fn:datasources.mongoose1.<Model_Name>.<Function_Name>
from yaml workflows and
ctx.datasources.mongoose1.<Model_Name>.<Function_Name>
from TS/JS files.
The arguments to any Function_Name
are to be passed in two ways
- Only the first arg of the function as accepted by the API
id: mongoose_workflow tasks: - id: first_task fn: datasource.mongoose.SomeModel.findOne args: {"name": "mastersilv3r"} #Fun fact: YAML acceptes JSON as well.
- Most Mongoose functions accept multiple args. To pass all args to an API call, send an array of the acceptable args. This array is spread and passed to the API call
id: helloworld2_workflow tasks: - id: helloworld2_workflow_first_task fn: datasource.mongoose.SomeModel.findOne args: #as an array - name: mastersilv3r #search clause: First argument - 'name age' #The projection: second argument - {} # Options: the third argument
- Calling from a TS/JS workflow works same as any other datasource
import { GSContext, GSDataSource, GSStatus } from "@godspeedsystems/core";
export default async function (ctx: GSContext, args: any) {
const ds: GSDataSource = ctx.datasources.mongoose1;
//Will need to set a meta object in the args to pass entitType and method
args.meta = {entityType: 'SomeModel', method: 'findOne'};
const response = await ds.execute(ctx, args);
return response;
}
Run the service
- Set an environment variable
MONGO_URL
as your connection string to running mongodb instance. For example, setting via a unix shell.export MONGO_URL='mongodb+srv://<user_name>:<password>@cluster0.xyzabc.mongodb.net/?retryWrites=true&w=majority'
- From your command line run your service in the auto-watch mode
godspeed serve
Thank You For Using Godspeed
You are welcome to submit an issue or improvement via a pull request!