// ets_tracing: off import * as CL from "../../../../Clock/index.js" import type * as CK from "../../../../Collections/Immutable/Chunk/index.js" import * as T from "../../../../Effect/index.js" import * as CH from "../../Channel/index.js" import * as C from "../core.js" /** * Throttles the chunks of this stream according to the given bandwidth parameters using the token bucket * algorithm. Allows for burst in the processing of elements by allowing the token bucket to accumulate * tokens up to a `units + burst` threshold. Chunks that do not meet the bandwidth constraints are dropped. * The weight of each chunk is determined by the `costFn` effectful function. */ export function throttleEnforceEffect_( self: C.Stream, units: number, duration: number, costFn: (c: CK.Chunk) => T.Effect, burst = 0 ): C.Stream { const loop = ( tokens: number, timestamp: number ): CH.Channel< R1 & CL.HasClock, E | E1, CK.Chunk, unknown, E | E1, CK.Chunk, void > => CH.readWith( (in_) => CH.unwrap( T.map_( T.zip_(costFn(in_), CL.currentTime), ({ tuple: [weight, current] }) => { const elapsed = current - timestamp const cycles = elapsed / duration const available = (() => { const sum = Math.floor(tokens + cycles * units) const max = units + burst < 0 ? Number.MAX_SAFE_INTEGER : units + burst return sum < 0 ? max : Math.min(sum, max) })() if (weight <= available) { return CH.zipRight_(CH.write(in_), loop(available - weight, current)) } else { return loop(available, current) } } ) ), (e) => CH.fail(e), (_) => CH.unit ) return new C.Stream( CH.chain_(CH.fromEffect(CL.currentTime), (_) => self.channel[">>>"](loop(units, _))) ) } /** * Throttles the chunks of this stream according to the given bandwidth parameters using the token bucket * algorithm. Allows for burst in the processing of elements by allowing the token bucket to accumulate * tokens up to a `units + burst` threshold. Chunks that do not meet the bandwidth constraints are dropped. * The weight of each chunk is determined by the `costFn` effectful function. * * @ets_data_first throttleEnforceEffect_ */ export function throttleEnforceEffect( units: number, duration: number, costFn: (c: CK.Chunk) => T.Effect, burst = 0 ) { return (self: C.Stream) => throttleEnforceEffect_(self, units, duration, costFn, burst) }