yaak/plugins/template-function-random/src/index.ts

import type { CallTemplateFunctionArgs, Context, PluginDefinition } from "@yaakapp/api";

export const plugin: PluginDefinition = {
  templateFunctions: [
    {
      name: "random.range",
      description: "Generate a random number between two values",
      previewArgs: ["min", "max"],
      args: [
        {
          type: "text",
          name: "min",
          label: "Minimum",
          defaultValue: "0",
        },
        {
          type: "text",
          name: "max",
          label: "Maximum",
          defaultValue: "1",
        },
        {
          type: "text",
          name: "decimals",
          optional: true,
          label: "Decimal Places",
        },
      ],
      async onRender(_ctx: Context, args: CallTemplateFunctionArgs): Promise<string | null> {
        const min = args.values.min ? Number.parseInt(String(args.values.min ?? "0"), 10) : 0;
        const max = args.values.max ? Number.parseInt(String(args.values.max ?? "1"), 10) : 1;
        const decimals = args.values.decimals
          ? Number.parseInt(String(args.values.decimals ?? "0"), 10)
          : null;

        let value = Math.random() * (max - min) + min;
        if (decimals !== null) {
          value = Math.round(value * 10 ** decimals) / 10 ** decimals;
        }
        return String(value);
      },
    },
  ],
};