CurrencyAsyncResolver

Defined in: packages/engine/src/uom/CurrencyResolver.ts:27

Fetches exchange rates before the VM runs, so a conversion has real numbers.

Until rates arrive the line evaluates to a pending value rather than a guessed one, and re-evaluates when they land.

Implements

• IAsyncResolver

Constructors

Constructor

new CurrencyAsyncResolver(exchange?): CurrencyAsyncResolver;

Defined in: packages/engine/src/uom/CurrencyResolver.ts:41

Parameters

Parameter	Type
exchange?	CurrencyExchangeService

Returns

CurrencyAsyncResolver

Properties

namespace

readonly namespace: "currency" = CURRENCY_NS;

Defined in: packages/engine/src/uom/CurrencyResolver.ts:28

Unique namespace for cache key scoping (e.g., “currency”, “weather”)

Implementation of

IAsyncResolver.namespace

---

watchedOpcodes

readonly watchedOpcodes: readonly OpCode[];

Defined in: packages/engine/src/uom/CurrencyResolver.ts:37

Every unit the scan below reads arrives as a PUSH_STRING operand, so a program with no string constant cannot name a currency and the engine need not ask. Deliberately not the arithmetic opcodes the scan also checks: ADD is in nearly every line, and declaring it would spare nothing. See IAsyncResolver.watchedOpcodes.

Implementation of

IAsyncResolver.watchedOpcodes

Methods

destroy()

destroy(): void;

Defined in: packages/engine/src/uom/CurrencyResolver.ts:117

Called when the resolver’s namespace is being unregistered. Clean up any in-flight promises, clear caches, unsubscribe.

Returns

void

Implementation of

IAsyncResolver.destroy

---

preflight()

preflight(
   _tokens,
   bytecode,
   packageId,
   signal,
   queryClient
):
  | AsyncCheckResult
  | null;

Defined in: packages/engine/src/uom/CurrencyResolver.ts:45

Pre-flight check: called BEFORE VM execution.

Returns null if all data for this expression is cached and ready. Returns an AsyncCheckResult if async work is needed.

This method is synchronous, it only checks caches, never fetches. If data is missing, it creates a Promise and returns immediately.

Parameters

Parameter	Type	Description
_tokens	Token[]	-
bytecode	BytecodeProgram	The compiled bytecode program
packageId	string	-
signal	AbortSignal	AbortSignal for the current evaluation
queryClient	QueryClient	-

Returns

| AsyncCheckResult | null

Implementation of

IAsyncResolver.preflight