Photo by chuttersnap on Unsplash
Travis tests: https://travis-ci.org/owsas/parse-cloud-class/builds
A new way to define Parse.Cloud events for your classes (DB tables). With this module you can easily:
- Define minimum values for keys on your classes
- Define maximum values for keys on your classes
- Define default values
- Define required keys
- Define immutable keys (only editable with the master key)
- Use addons to easily extend the funcionality of your app
- Create new addons and share them with the community
- Customize the default behaviour to your own needs
This module is meant to be used with Parse and Parse Server
Installation
> npm install parse-server-addon-cloud-class
Typescript: This module comes bundled with Intellisense :)
Example
A working example can be found here: https://github.com/owsas/parse-cloud-class-example
Supported versions
- Parse >1.10.0
- Parse >=2.0
Basic Usage
/*
* This is the main cloud file for Parse
* cloud/main.js
*/
// with normal ES5
const ParseCloudClass = require('parse-server-addon-cloud-class').ParseCloudClass;
// with typescript or ES6
import { ParseCloudClass } from 'parse-server-addon-cloud-class';
const myConfig = new ParseCloudClass({
// New items will not be created if they have no 'name' set
requiredKeys: ['name'],
defaultValues: {
// All new items will have active: true
active: true,
// By default, timesShared will be 0
timesShared: 0,
},
minimumValues: {
// timesShared cannot go below 0
timesShared: 0,
},
// Keys that are only editable by the master key.
// Trying to edit apiKey without the master key will throw an error
immutableKeys: ['apiKey'],
});
// Configure your class to use the configuration
ParseCloudClass.configureClass(Parse, 'MyClass', myConfig);
When you configure your classes to work with ParseCloudClass, they will be attached the following events
beforeFind
beforeSave
beforeDelete
afterSave
afterDelete
By default, the only event that is going to do something is the beforeSave
, that is going to check the minimumValues
, defaultValues
and requiredKeys
Extending ParseCloudClass
You can easily extend ParseCloudClass in order to define your custom behaviours. In this case, you must have into account the following two extra methods of a ParseCloudClass:
processBeforeSave
: Here you would define your custom behaviour forbeforeSave
processBeforeDelete
: Here you would define your custom behaviour forbeforeDelete
// myCustomFile.js
import { ParseCloudClass } from 'parse-server-addon-cloud-class';
export class MyCustomClass extends ParseCloudClass {
/*
* Here you can define your custom minimumValues,
* defaultValues and requiredKeys
*/
requiredKeys = ['title']
/**
* @param req {Parse.Cloud.BeforeSaveRequest}
*/
async processBeforeSave(req) {
// Make sure the super class validates the required keys,
// minimum values, executes the addons, etc
const object = await super.processBeforeSave(req);
// write your own code here
....
// make sure to return req.object
return object;
}
}
You can change the implementation of any method to your needs, but please, call the super class' processBeforeSave if you expect to have requiredKeys checking, minimum values checking, addon functionalities, etcetera.
All the possibilities
interface IParseCloudClass {
beforeFind(
req: Parse.Cloud.BeforeFindRequest,
): Parse.Query;
processBeforeSave (
req: Parse.Cloud.BeforeSaveRequest | IProcessRequest,
): Promise<Parse.Object>;
beforeSave(
req: Parse.Cloud.BeforeSaveRequest | IProcessRequest,
// parse sdk > 2.0 does not have the res parameter
res?: Parse.Cloud.BeforeSaveResponse | IProcessResponse,
): Promise<boolean>;
afterSave (
req: Parse.Cloud.BeforeDeleteRequest | IProcessRequest,
): Promise<Parse.Object>;
processBeforeDelete (
req: Parse.Cloud.BeforeDeleteRequest | IProcessRequest,
): Promise<Parse.Object>;
beforeDelete(
req: Parse.Cloud.BeforeDeleteRequest | IProcessRequest,
// parse sdk > 2.0 does not have the res parameter
res?: Parse.Cloud.BeforeDeleteResponse | IProcessResponse,
): Promise<boolean>;
afterDelete (
req: Parse.Cloud.BeforeDeleteRequest | IProcessRequest,
): Promise<Parse.Object>;
}
Note: IProcessRequest is an interface that allows you to do testing
interface IProcessRequest {
object: Parse.Object;
user?: Parse.User;
master?: boolean;
}
Using addons
To use an addon, you would first import it, and then configure your class to use that addon. Example:
// with typescript or ES6
import { ParseCloudClass } from 'parse-server-addon-cloud-class';
import { SomeAddon } from 'some-addon-module';
const myConfig = new ParseCloudClass();
// use the addon
myConfig.useAddon(SomeAddon);
// you can use any number of addons
myConfig.useAddon(SomeOtherAddon);
// Configure your class to use the configuration
ParseCloudClass.configureClass(Parse, 'MyClass', myConfig);
Take into account that addons are executed in the order in which they were added.
Creating addons
Addons can be created by extending ParseCloudClass and defining new behaviours on:
beforeFind
beforeSave
beforeDelete
afterSave
afterDelete
processBeforeSave
processBeforeDelete
Example addon:
// In Javascript
class Addon1 extends ParseCloudClass {
async processBeforeSave(req) {
req.object.set('addon1', true);
return req.object;
}
}
// In Typescript
class Addon1 extends ParseCloudClass {
async processBeforeSave(req: Parse.Cloud.BeforeSaveRequest) {
req.object.set('addon1', true);
return req.object;
}
}
Addons
- Algolia Search: https://github.com/owsas/parse-server-addon-cloud-algolia
Credits
Developed by Juan Camilo Guarín Peñaranda,
Otherwise SAS, Colombia
2017
License
MIT.