The Actions package aims to provide a powerful and simple way to define actions (which are essentially API primitives) and execute them safely with JSON serializable payloads.
It is part of Rubric's architecture for Generative UI when used with:
bun add @rubriclab/actions
@rubriclab scope packages are not built, they are all raw typescript. If using in a next.js app, make sure to transpile.
// next.config.ts
import type { NextConfig } from 'next'
export default {
transpilePackages: ['@rubriclab/actions'],
reactStrictMode: true
} satisfies NextConfigIf using inside the monorepo (@rubric), simply add
{"@rubriclab/actions": "*"}to dependencies and then runbun i
To get started, define a few actions.
import { createAction } from '@rubriclab/actions'
import { z } from 'zod/v4'
const convertStringToNumber = createAction({
schema: {
input: z.object({
str: z.string()
}),
output: z.number()
},
execute: ({ str }) => Number(str)
})
export const actions = { convertStringToNumber }Pass all your actions into an executor to get a function to execute it.
'use server'
import { createActionExecutor } from '@rubriclab/actions'
import { actions } from './actions'
export const { execute } = createActionExecutor({ actions })const number = await execute({ action: 'convertStringToNumber' params: { str: '2' } })