River Pro Changelog

All notable changes to this project will be documented in this file.

v0.3.0 - 2024-09-11

Workflows: Fix an issue with directly mutating user-provided opts structs by ensuring we take copies of them prior to mutating. Without this fix, users who provided the same InsertOpts pointer to multiple workflow tasks would see identical metadata on all resulting tasks (rather than task-specific metadata as expected).

Lowered the go directives in go.mod to Go 1.21, which River aims to support. A more modern version of Go is specified with the toolchain directive. This should provide more flexibility on the minimum required Go version for programs importing River. PR #31.
Fixed a potential panic when unwrapping the pro driver and executor.

Tasks can now be dynamically added to an existing workflow. The riverworkflow.FromExisting() constructor initiates a workflow from an existing job in that workflow. New tasks can be added using the same .Add() method that's used for a brand new worfklow. When preparing the workflow for insert using top-level Prepare and PrepareTx functions, existing jobs will be automatically loaded as needed to validate the workflow dependency graph.
New top-level functions in the riverworkflow package for Prepare and PrepareTx. These are used to prepare a workflow's tasks/jobs for insertion into the database, including validations of task dependencies. These functions should be preferred over workflow.Prepare which will be removed in the next release.

The Prepare method on riverworkflow.Workflow has been deprecated in favor of the new top-level Prepare and PrepareTx functions in that package. The new functions present a single interface for preparing workflow tasks for insertion, whether the workflow is brand new or for adding tasks to an existing workflow. This method will be removed in an upcoming release.