Creating Functions

Create serverless functions to extend RaisinDB with custom logic.

What are Functions?

Functions in RaisinDB run in a sandboxed environment with configurable resource limits. Supported runtimes:

Runtime	Language	Engine
QuickJS	JavaScript	QuickJS embedded runtime
Starlark	Python-like	Starlark interpreter
SQL	SQL	RaisinDB SQL engine

Functions can:

• Process data
• Integrate with external APIs (allowlisted endpoints)
• Respond to triggers (events, HTTP, schedule, SQL)
• Handle webhooks

Create a Function

Functions are stored as raisin:Function nodes in the functions workspace.

Via Admin Console

1. Navigate to Functions
2. Click Create Function
3. Enter function details:
   • Name: send-welcome-email
   • Description: Send welcome email to new users
4. Add code in the editor
5. Click Save

Via API

curl -X POST \
  http://localhost:8080/api/repository/myapp/main/head/functions/send-welcome-email \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "node_type": "raisin:Function",
    "properties": {
      "code": "export async function handler(event) { ... }",
      "runtime": "node20",
      "timeout": 30
    }
  }'

Function Code

Functions have access to the sandboxed raisin API:

API	Operations
raisin.nodes	get, getById, getChildren, create, update, delete, query
raisin.sql	query, execute
raisin.http	get, post, put, delete (allowlisted endpoints)
raisin.events	emit (publish events)

async function handler(input) {
  // Read a node
  const user = await raisin.nodes.get("default", input.path);

  // Update properties
  await raisin.nodes.update("default", input.path, {
    properties: { ...user.properties, status: "processed" }
  });

  // Execute SQL queries
  const results = await raisin.sql.query(
    "SELECT * FROM 'default' WHERE node_type = 'blog:Article'"
  );

  // Make HTTP requests (allowlisted)
  const response = await raisin.http.post("https://api.example.com/notify", {
    body: { user_id: input.user_id }
  });

  return { success: true, count: results.length };
}

Invoke a Function

Via HTTP API

curl -X POST \
  http://localhost:8080/api/functions/myapp/send-welcome-email/invoke \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user-123",
    "email": "user@example.com"
  }'

Via JavaScript Client

const result = await client.functions.invoke('send-welcome-email', {
  user_id: 'user-123',
  email: 'user@example.com'
});

Next Steps

• Triggers
• Execution Logs