feat(orderbook): Add support for creating metadata bids with criteria

[JCSanPedro]

Hi👋, please ensure the PR title follows the below standards:

• PR is titled with conventional commit style naming: type(scope): message. For example: feat(passport): my new feature
• If you have introduced modification that necessitates immediate adjustments by this SDK's users to their applications, clients, or integrations to avert disruptions to existing features or functionalities, add a ! after the type(scope), for example feat(passport)!: my new breaking feature

Summary

Updates the parameters for creating metadata bids to allow specifying either a metadata-id or a set of metadata criteria filters.

Detail and impact of the change

Added

Changed

• Update orderbook
• Update e2e tests for metadata bids with criteria

Deprecated

Removed

Fixed

Security

Anything else worth calling out?

---

Note

Medium Risk
Moderate risk: changes the public CreateMetadataBidParams shape and request payload for metadata bids, which could break callers and affect bid creation/mapping if criteria validation or mapping is incorrect.

Overview
Adds support for creating metadata bids using either a single metadataId or a new metadataCriteria array of field-level filters, enforcing mutual exclusivity and performing client-side validation of allowed field names, non-empty values, and duplicate filters.

Extends the OpenAPI SDK types and mappers to handle metadata_criteria (and optional metadata_id) in both request and response mapping, and updates unit + e2e tests to cover criteria-based creation and fulfillment paths.

^{Reviewed by Cursor Bugbot for commit a2d80d9. Bugbot is set up for automated code reviews on this repo. Configure here.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit a2d80d9

Command	Status	Duration	Result
nx affected -t build,lint,test	✅ Succeeded	2m 46s	View ↗
nx run-many -p @imtbl/sdk,@imtbl/checkout-widge...	✅ Succeeded	1m 19s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-05-21 05:16:29 UTC

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit a2d80d9. Configure here.}