sdk: add evaluateBatch()

[srenatus]

TODO:

• deal with mixed results
• allow fall-back to a sequence of evaluate() calls
• inject license via GHA secrets

[srenatus]

Some reviewer notes 👇

[srenatus]

ℹ️ We'll upstream this if it turns out to do the trick for C#, too!

[srenatus]

...and drop the commit (StyraInc/opa-typescript@93fa195)

[srenatus]

Restructured the tests a bit. These are the cases that are included now:

▶ tests
  ▶ with eopa
    ✔ can be called without types, without input (11.54083ms)
    ✔ rejects with server error on failure (2.418835ms)
    ✔ can be called with input==false (8.864047ms)
    ▶ default
      ✔ can be called without types, without input (5.759252ms)
      ✔ can be called with input (4.895409ms)
    ▶ default (11.259281ms)

    ✔ supports rules with slashes (3.708803ms)
    ✔ supports input/result types (4.165662ms)
    ✔ supports input of type bool (4.347747ms)
    ✔ calls stringify on a class as input (4.387289ms)
    ✔ supports input class implementing ToInput (4.131907ms)
    ✔ supports result class implementing FromResult (3.347218ms)
    ✔ allows custom low-level SDKOptions' HTTPClient (3.213485ms)
    ✔ allows fetch options (0.774398ms)
    ✔ allows custom headers (3.010292ms)
    ✔ supports rules with slashes when proxied (5.027933ms)
    ▶ batch
      ✔ supports rules with slashes (12.372602ms)
      ✔ can be called with input==false (5.318301ms)
      ✔ calls stringify on a class as input (4.528926ms)
      ✔ supports input class implementing ToInput (3.98718ms)
      ✔ supports result class implementing FromResult (3.364944ms)
      ✔ allows custom low-level SDKOptions' HTTPClient (3.036248ms)
      ✔ allows fetch options (1.398168ms)
      ✔ allows custom headers (3.596054ms)
      ✔ supports rules with slashes when proxied (3.562676ms)
      ✔ returns mixed-mode result on a failure (3.875064ms)
      ✔ rejects mixed-mode result if instructed (0.618417ms)
    ▶ batch (46.664602ms)

  ▶ with eopa (2963.970092ms)

  ▶ with opa
    ▶ batch-fallback
      ✔ fails unless instructed to fallback (0.910582ms)
      ▶ fallback
        ✔ returns same result, without errors (14.021788ms)
        ✔ returns same result, with errors (6.970417ms)
      ▶ fallback (21.21245ms)

      ✔ rejects mixed-mode result if instructed (0.599692ms)
    ▶ batch-fallback (148.2918ms)

  ▶ with opa (1460.965599ms)

▶ tests (5400.462863ms)

[philipaconrad]

Looks good to me!

One bit of feedback I'll add to what @charlesdaniels noted around how feature detection works for the Batch Query API: we potentially can memoize the feature detection for whether or not a remote "OPA" supports the Batch Query API or not, allowing future batch requests to skip the "feature detect" query in the future. That sort of feature can definitely wait until a future PR though!