ANNOUNCEMENT | The build tool is undergoing active development without a garantee of everything working perfectly.

• 𝙍𝙚𝙖𝙡𝙢 𝙒𝙞𝙩𝙝 | 𝒞ℒ𝐼 ⋆ ˚｡⋆୨˚✧
  • Installation
    • npm
    • pnpm
    • yarn
  • Quickguide [package.json]
  • Purpose
    • How does Realm Fun work?
    • What does Realm Fun achive?
  • Roadmap
  • Simple Function File
  • Building
    • Directory
  • Helpers
  • Collaboration
  • Licence

npm install "@realm.w/cli@latest"

pnpm add "@realm.w/cli@latest"

yarn install "@realm.w/cli@latest"

Here, your functions written in TypeScript are located at ./src/realm/function. The resulting JavaScript functions and meta files are built to ./out/functions.

{
    "scripts":{
        "build": "npx @realm.w/cli functions build ./src/realm/functions ./out/functions [--watch] [--flatten]"
    }
}

Realm.w is a suite of tools that aim to help with the development of Atlas App Services' backend as a service infrastructure. As its main perk, it makes possible to develop and configure Functions in TypeScript. Moreover, it provides right types for Function's Context, which otherwise are assumed from the MongoDB's documentation.

The TypeScript support is achived by analyzing and transpiling code written in TypeScript to JavaScript with a custom Babel transpiler. In contrast to using Webpack, it gives the build tool more control over the transpilation process as well as the endform of the output files.

The tool's main goal is to provide the quality developer experience while reducing the hastle around writing, testing and deploying Realm Applications.

Less checking and more writing :)

• Build Tool
• Dead Code Elimination
• Simplified Secrets Deployment from .env file

// ---- CONFIG
export const config: Config = {
    args:{
        logs: true
    },
    exec:{
        priv: false,
        cond: {
            "%%user.type":"normal",
            "%%user.plan.id": "63246b0a67ffbd80f8c81505"
        },
        auth: "system"  
    }
}

// ---- FUNCTION
export default async (args) =>{
    // ?? More on [global context](https://github.com/uceumice/realm.w-types);
    return context.services.get("mongodb-atlas").db("realm").collection("w").find({
        w: 0
    },{
        _id: 0
    });
}

realm-cli functions build ./src/realm/functions ./out/functions [--watch] [--flatten]

Important: You should use --flatten, which breaks down directory structure into files structure, in order to delpoy to Atlas App Services via GitHub Deployments

    .
    └── out/
        └─ functions/
           ├── config.json
           ├── package.json
           └── function
               ├── function_1.js
               ├── function_2.js
               └── [...].js
  

    .
    └── out/
        └─ functions/
           ├── config.json
           ├── package.json
           ├── function_1.js
           ├── function_2.js
           └── [...].js
  

Helpers provide some additional functionality, like arguments type validation.

import { crf } from '@realm.w/helpers'

type Args = [{
  name: string
}];

type Rtrn = string;

export default crf<Args, Rtrn>(
    {
        arguments:{
            log: false,
            validate([{name}]) {
                if (typeof name !== "string") throw new Error("`name` must be a string");
            }
        },
        execution:{
            throw: false,
            private: false,
            condition: {
                "%%user.billing.plan": {
                    "$eq": "standart"
                }
            },
            authorization: "application"
        }
    },
    async ([{ name }]) => { 
        return `Hello, ${name}`;
    }
);

You are welcome to propose new features. You can also complain about the bugs, open all sorts of code related issues.

MIT