Functions and Triggers

Functions are JavaScript handlers stored as nodes inside a RAP package. Triggers watch for events (node changes, schedules, webhooks) and invoke functions when conditions match. Together they form the server-side logic layer of RaisinDB.

BEFORE writing any server-side function code:

1. Run npm install in the project root — this installs @raisindb/functions-types which contains raisin.d.ts, the COMPLETE TypeScript API for the function runtime. Read it before writing any code.
2. ONLY use methods defined in raisin.d.ts — this is NOT Node.js (no Buffer, fs, no npm modules). fetch() IS available. ES module imports with relative paths ARE supported (import { foo } from './utils.js').

MANDATORY: After creating or modifying ANY .yaml, .node.yaml, or .js file in package/, immediately run:

npm run validate

File Organization

content/functions/
├── lib/{namespace}/{function-name}/
│   ├── .node.yaml          # raisin:Function definition
│   └── index.js            # JavaScript implementation