variable / @typed/fx

RefStruct.update

Update a property value in the current state of a RefStruct using a function.

Package version
2.0.0-beta.13
Category
State updates
Since
1.18.0
Member of
RefStruct

Import

import { RefStruct } from "@typed/fx";

Access RefStruct.update through the imported RefStruct export. Its declaration below describes the member.

This public exposure is a re-export. Its import path is supported; declaration documentation is shared with the other public exposures below.

Signatures

export declare const update: {
    <S extends object, K extends keyof S>(key: K, f: (value: S[K]) => S[K]): <E, R>(ref: RefStruct<S, E, R>) => Effect.Effect<S, E, R>;
    <S extends object, K extends keyof S, E, R>(ref: RefStruct<S, E, R>, key: K, f: (value: S[K]) => S[K]): Effect.Effect<S, E, R>;
};

Why

Keeps update atomic with respect to competing RefSubject writes instead of splitting the read and replacement into separate effects.

Ownership and lifetime

Running update performs one serialized struct transition and resolves with its committed value. It acquires no resource; failures and services remain those of the source ref.

Other public imports

These import paths expose the same declaration. Each page retains its own public name and signature.

Source