chore(relayer): add metadata subpath export and re-export types (#8610)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: paulbalaji

.changeset/export-metadata-build-types.md

@@ -0,0 +1,6 @@
+---
+"@hyperlane-xyz/relayer": patch
+---
+
+Re-exported metadata build result types from the relayer public API and added a
+`@hyperlane-xyz/relayer/metadata` subpath export for metadata-only imports.

typescript/relayer/README.md

@@ -34,6 +34,14 @@ await relayer.relayMessage(dispatchTx);
 relayer.start();
 ```
 
+### Metadata-Only Usage
+
+For metadata builders without the relayer runtime API, use the `/metadata` export:
+
+```typescript
+import { BaseMetadataBuilder } from '@hyperlane-xyz/relayer/metadata';
+```
+
 ### Node.js Daemon Mode
 
 For Node.js environments with filesystem access, use the `/fs` export:
@@ -104,10 +112,11 @@ cacheFile: ./relayer-cache.json
 
 ## Package Exports
 
-| Export                      | Description                               | Browser-safe |
-| --------------------------- | ----------------------------------------- | ------------ |
-| `@hyperlane-xyz/relayer`    | Core relayer, metadata builders, schemas  | Yes          |
-| `@hyperlane-xyz/relayer/fs` | RelayerService, loadConfig (file loading) | No (Node.js) |
+| Export                            | Description                               | Browser-safe |
+| --------------------------------- | ----------------------------------------- | ------------ |
+| `@hyperlane-xyz/relayer`          | Core relayer, metadata builders, schemas  | Yes          |
+| `@hyperlane-xyz/relayer/metadata` | Metadata builders only                    | Yes          |
+| `@hyperlane-xyz/relayer/fs`       | RelayerService, loadConfig (file loading) | No (Node.js) |
 
 ## Prometheus Metrics
 

typescript/relayer/package.json

@@ -21,6 +21,9 @@
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
+      "metadata": [
+        "./dist/metadata/index.d.ts"
+      ],
       "fs": [
         "./dist/fs/index.d.ts"
       ]
@@ -31,6 +34,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./metadata": {
+      "types": "./dist/metadata/index.d.ts",
+      "default": "./dist/metadata/index.js"
+    },
     "./fs": {
       "types": "./dist/fs/index.d.ts",
       "default": "./dist/fs/index.js"

typescript/relayer/src/metadata/builder.ts

@@ -65,6 +65,7 @@ export class BaseMetadataBuilder implements MetadataBuilder {
       case IsmType.TEST_ISM:
       case IsmType.OP_STACK:
       case IsmType.PAUSABLE:
+      case IsmType.CCIP:
         return this.nullMetadataBuilder.build({ ...context, ism });
 
       case IsmType.MERKLE_ROOT_MULTISIG:

typescript/relayer/src/metadata/index.ts

@@ -10,7 +10,21 @@ export { MultisigMetadata, MultisigMetadataBuilder } from './multisig.js';
 export { NullMetadata, NullMetadataBuilder } from './null.js';
 export { DynamicRoutingMetadataBuilder, RoutingMetadata } from './routing.js';
 export type {
+  AggregationMetadataBuildResult,
+  ArbL2ToL1MetadataBuildResult,
+  CcipReadMetadataBuildResult,
+  MetadataBuildResult,
   MetadataBuilder,
   MetadataContext,
+  MultisigMetadataBuildResult,
+  NullMetadataBuildResult,
+  RoutingMetadataBuildResult,
   StructuredMetadata,
+  ValidatorInfo,
+} from './types.js';
+export {
+  ValidatorStatus,
+  getSignedValidatorCount,
+  isMetadataBuildable,
+  isQuorumMet,
 } from './types.js';