Consolidate TypeScript API type tests into dedicated test file

[DZakh]

Moves comprehensive TypeScript API type assertions from scattered locations into a new dedicated test file TypeScriptApiTypes_test.res, improving test organization and maintainability.

Summary

This change consolidates all TypeScript API type-checking tests into a single, self-contained test suite. Previously, type assertions were distributed across multiple test files (EventHandler.test.ts, CustomSelection.test.ts) and handler source files (EventHandlers.ts). The new test file provides a unified, well-documented home for all public API type contracts.

Key Changes

• New test file: packages/envio-tests/test/TypeScriptApiTypes_test.res (1084 lines)

  • Comprehensive type assertions for EVM, Fuel, and SVM ecosystems
  • Self-contained mock indexer with schema, config, and type checks
  • Organized into describe blocks by ecosystem
  • Documents the full public TypeScript API surface

• Removed from EventHandler.test.ts:

  • Removed ~370 lines of type assertions for EvmEvent, EvmOnEventOptions, EvmContractRegisterOptions, EvmOnEventHandler, EvmContractRegisterHandler, EvmOnEventContext, EvmContractRegisterContext, EvmOnBlockWhereResult, EvmOnBlockFilter, EvmOnBlockOptions, EvmOnBlockContext, EvmOnBlockHandler, EvmOnBlockHandlerArgs, EvmOnBlockWhereArgs
  • Removed unused imports related to these types

• Removed from EventHandlers.ts:

  • Removed ~35 lines of type-only registration surface checks (guarded by if (0))
  • Removed ~70 lines of _typeCheckEvmWhereBlockShape() function with block filter type assertions
  • Removed unused imports

• Removed from CustomSelection.test.ts:

  • Removed ~45 lines of compile-time type assertions for custom field selection
  • Removed unused imports (expectType, TypeEqual)
  • Kept only runtime assertion logic

• New fixture file: packages/envio-tests/test/helpers/FuelAbiFixtures.res

  • Provides a known-good Fuel greeter ABI for type testing

Implementation Details

The new test file uses a pattern where check functions validate TypeScript code snippets against generated types:

• check() for EVM configurations
• checkFuel() for Fuel configurations with virtual ABI files
• checkSvm() for SVM configurations

Each test case is a self-contained TypeScript snippet that exercises a specific API surface, with @ts-expect-error comments documenting type safety guarantees. This approach keeps type assertions close to the API they validate while remaining independent of runtime test execution.

https://claude.ai/code/session_01N8ssQQn6qQ2WMKCTci7iGJ

Summary by CodeRabbit

• Tests
  • Added comprehensive compile-time coverage for EVM, Fuel, and SVM TypeScript APIs.
  • Added fixtures for Fuel ABI and shared GraphQL schema types.
  • Expanded validation of event handlers, registration options, filters, entities, enums, and effect utilities.
  • Updated runtime expectations for simulated event results.
  • Removed redundant type-check assertions from existing handler tests.

[coderabbitai]

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d913619a-5076-4265-a5de-405e95958950

📥 Commits

Reviewing files that changed from the base of the PR and between 657131b and a7ea38b.

📒 Files selected for processing (5)

• packages/envio-tests/test/EvmHandlersApi_test.res
• packages/envio-tests/test/FuelHandlersApi_test.res
• packages/envio-tests/test/SvmHandlersApi_test.res
• scenarios/test_codegen/src/handlers/EventHandlers.ts
• scenarios/test_codegen/test/EventHandler.test.ts

📝 Walkthrough

Walkthrough

Adds comprehensive TypeScript API type tests for EVM, Fuel, and SVM configurations, introduces shared schema and Fuel ABI fixtures, and moves compile-time checks out of runtime-oriented tests.

Changes

TypeScript API type coverage

Layer / File(s)	Summary
Harness and EVM API coverage packages/envio-tests/test/helpers/ApiTypesFixtures.res, packages/envio-tests/test/TypeScriptApiTypesEvm_test.res	Adds shared schema/configuration fixtures and compile-time assertions for EVM APIs, entity bindings, effects, filters, handlers, and utilities.
Fuel API coverage packages/envio-tests/test/helpers/FuelAbiFixtures.res, packages/envio-tests/test/TypeScriptApiTypesFuel_test.res	Adds a Greeter ABI fixture and validates Fuel event, handler, filter, registration, and schema-bound types.
SVM, effect, and utility coverage packages/envio-tests/test/TypeScriptApiTypesSvm_test.res	Validates SVM chain, slot, instruction, registration, field-selection, and schema-bound types.
Legacy check migration and runtime alignment scenarios/test_codegen/src/handlers/EventHandlers.ts, scenarios/test_codegen/test/CustomSelection.test.ts, scenarios/test_codegen/test/EventHandler.test.ts	Removes duplicated unreachable type checks, updates the custom-selection reference, simplifies runtime-test imports, and aligns imported types and simulation expectations.

Estimated code review effort: 4 (Complex) | ~45 minutes

Possibly related PRs

• enviodev/hyperindex#1333: Touches the custom field-selection test and related unselected-field typing.
• enviodev/hyperindex#1467: Touches event-handler type checks and related createTestIndexer behavior.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title matches the main change: consolidating TypeScript API type assertions into dedicated ecosystem-specific tests.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

_{Comment @coderabbitai help to get the list of available commands.}