Skip to main content

Overview

Hypi platform tries to include the features most modern applications need to get going quickly. Some of the features of Hypi include the following.

  1. CRUD
  2. App dependencies
  3. Environment variables
  4. Webhooks
  5. Triggers
  6. User defined functions
  7. Serverless functions
  8. Authorisation
  9. Maths API
  10. Aggregations API

CRUD

CRUD is the acronym commonly used for Create, Read, Update and Delete. With Hypi, a CRUD API is automatically generated from your app's schema. It enables you to start working with your app's APIs quickly.

It goes a little further by including the ability to "trash" data i.e. perform a soft delete. The data will not be returned unless explicitly requested. However, data will not get deleted from the database. You can later untrash or permanently delete the data.

See CRUD documentation for more information.

App dependencies

Hypi tries to promote the DRY principle and general separation of concerns by providing you with the ability to split an app into smaller reusable parts.

In doing so, a single app's schema and other code can be simpler to maintain and manage. This is achieved by providing the ability for any app to be used as a dependency of another app.

Imagine creating an app like Twitter. You could break this into multiple smaller apps. E.g. one for timeline, one for searches, one for media lookup (where the image/video of a link is fetched and embedded in a Tweet).

How you choose to break your app down into modular parts is up to you, Hypi provides the facilities that make it possible and then gets out of the way.

See App dependencies

Environment variables

Many applications require settings at run time which change depending on some criteria specific to the app or its users/environment. When you create a release, Hypi lets you define one or more fields that can be populated when an instance of the app is created. These become accessible at runtime.

See Environment variables

Webhooks

Many cloud services provide a mechanism to report the occurrence of certain events in their system. One of those mechanisms is called a Webhook. This is where the service will let you specify a URL that they will send an HTTP request.

Hypi's Webhooks let you define URLs that can be called by external services. In response, you can call a user defined function, a serverless function, execute triggers, and more.

See Webhooks

Triggers

Hypi triggers are a mechanism for automatically executing a function before or after another function. If you're familiar with triggers in databases, it's the same concept.

Let's say you have an app that defines a function called startProcess and you depend on another app that has a function called afterProcessStarted.

You can use a @trigger to execute the afterProcessStarted function when startProcess is called.

The function used can be defined anywhere, either in the current app or in a dependency.

See Triggers

User defined functions

User defined functions (UDF) are a lightweight way of executing custom code in the Hypi platform. They are considered lightweight compared to serverless functions because they are evaluated on the same server where the calling code is executed.

Currently, two languages are supported for UDFs:

  1. Groovy - the entire Groovy syntax is available making it quick, easy, and performant to add custom behaviour to your app.
  2. Velocity - the velocity template language is used in places where you want to output text which executes some dynamic behaviour. For example, you could use this to customise the body of an email, using velocity templating to substitute the receiver's name from a variable, etc.

See User Defined Functions

Serverless functions

Serverless functions are a modern approach to application development.

Just as all the features in Hypi described so far allow you to get work done without worrying about things like servers or execution environment, so is the case with serverless functions.

Serverless functions in Hypi let you write any custom code you want, wrap it in a Docker container, and then use it in your Hypi app as if it was defined by the Hypi platform itself.

See Serverless functions

Authorisation

Many applications require their users to have certain permissions before they can perform an action or execute a request. Hypi has built-in support for extensive authorisation control.

You can define a Scope-based or Resource-based permission to control who can p and when.

See Authorisation

Maths API

In many database systems, it is possible to ask the system to perform some basic mathemetical operations on an existing field/column. This is also possible with Hypi by using the maths API.

Maths APIs exist because in a high throughput system getting a value, performing math operations on the client, and then updating the value on the server can be error-prone.

What happens if two requests update the value having performed their own math operations client-side?

Hypi lets you avoid this conflict by providing an explicit API for executing mathematical operations on numeric fields.

See Maths API

Aggregations API

It's often the case that you may want to count or group data in your app. You may want to ask things like, "How many of these things exist?".

Use cases for this:

  • How many users do i have in my app?
  • How many users exist in each department?
  • How many users registered in the last 30 days?

These are some examples of questions that the aggregations API can be used to answer.

See Aggregations API