antoine-coulon / unit-of-fork

⋔ Unit of work manager using Effect acquise release model

Unit of Fork

Automatically managed transactions using @effect/io and knex.

transaction() acquires a transactional context that can be passed around. If any of the Effects executed within the scope of that transaction produce a failure, the transaction is automatically rollbacked. Otherwise, the transaction is committed.

const useCase = pipe(
  Z.service(Jobs),
  Z.flatMap(({ createJob }) => {
    return pipe(
      transaction((trx) => Z.gen(function* ($) {
        yield* $(createJob(trx)({ name: 'job_1', id: 1 }));
        // Transaction will be rollbacked automatically as the "id" constraint is violated
        yield* $(createJob(trx)({ name: 'job_2', id: 1 }));
      })),
      Z.tap(() => Z.log("Transaction commit")),
      Z.catchAll(() => Z.logError("Transaction rollback"))
    );
  })
);

For now, there is only a minimalist knex integration, but transaction() aims to offer an abstracted way of offering transactional and effectful computations.

Run the local tests

unit-of-fork uses testcontainers with a dumb repository implementation that provides few transaction examples.

$ pnpm run migrate
$ pnpm run seed
$ pnpm run test