sailfork / t3code-github / .repos/ alchemy-effect/ packages/ alchemy/ src/ Runtime/ ExecutionMemo.ts

import * as Effect from "effect/Effect";
import * as Scope from "effect/Scope";

/**
 * Per-execution memos, keyed on the execution's `Scope` object. Every bridge
 * (Worker event, Durable Object call, Workflow run, Lambda invoke) provides a
 * fresh `Scope` per execution, so an entry lives exactly as long as its
 * execution and is garbage-collected with the scope object.
 */
const caches = new WeakMap<Scope.Scope, Map<symbol, Effect.Effect<any, any, any>>>();

/**
 * Allocate a per-execution memo cell for `build`. The returned accessor runs
 * `build` at most once per execution scope (Worker fetch/queue/scheduled
 * event, DO call, Workflow run, Lambda invoke) and builds it WITH that scope
 * (`Layer.build` / `Scope`-requiring acquires see the execution scope), so
 * release finalizers fire when the event settles — never held across events.
 * This is the only legal pooling shape on workerd (sockets are
 * IoContext-pinned) and the correct one on Lambda (the instance scope must
 * not own disposables).
 *
 * The `Effect.sync` wrapper allocates the memo's symbol key once per *call
 * site* (i.e. once per layer construction), so distinct clients built from
 * distinct `makeExecutionMemo` calls never share a memo cell even inside the
 * same execution.
 *
 * The memo key and the finalizer target are always the same scope object
 * (`yield* Effect.scope`), so they cannot disagree: wrapping queries in a
 * nested `Effect.scoped` narrows both the memo and the resource's lifetime
 * to that block.
 *
 * The accessor's `Scope` requirement is erased from its type — every runtime
 * bridge provides a fresh execution `Scope`, exactly like
 * `Drizzle.Postgres` before this primitive was extracted. Evaluating the
 * accessor outside an execution scope is a defect.
 */
export const makeExecutionMemo = <A, E, R>(
  build: Effect.Effect<A, E, R | Scope.Scope>,
): Effect.Effect<Effect.Effect<A, E, Exclude<R, Scope.Scope>>> =>
  Effect.sync(function () {
    const symbol = Symbol();

    return Effect.gen(function* () {
      const scope = yield* Effect.scope;
      let cache = caches.get(scope);
      if (cache === undefined) {
        caches.set(scope, (cache = new Map()));
      }
      let memo = cache.get(symbol);
      if (memo === undefined) {
        // `Effect.cached` only allocates the memo cell — the build runs
        // on first evaluation — so this yield is synchronous and the
        // fiber cannot be interleaved between the miss check and the
        // set: a concurrent first access joins this memo (evaluating the
        // same cached effect) instead of building a second resource.
        memo = yield* Effect.cached(build.pipe(Scope.provide(scope)));
        cache.set(symbol, memo);
      }
      return yield* memo;
    }) as Effect.Effect<A, E, Exclude<R, Scope.Scope>>;
  });