test+docs: cover type aliases, document -schemaHash

README.md

@@ -103,3 +103,4 @@ integration suite and tracked example checks on `macos-latest`.
 | --- | --- | --- |
 | `-client` | generate client code | unset (`false`) |
 | `-webrpcHeader` | send the standard `Webrpc` header on client requests | `true` |
+| `-schemaHash=false` | omit the schema hash + version constants from generated output | `true` |

Tests/Tests/GeneratedTests/GeneratedTests.swift

@@ -3,6 +3,18 @@ import XCTest
 @testable import Generated
 
 final class GeneratedTests: XCTestCase {
+    func testTypeAliasResolvesToUnderlyingType() throws {
+        // `type UserID: uint64` in test.ridl must render a typealias to the base type.
+        let id: UserID = 42
+        XCTAssertEqual(id, UInt64(42))
+
+        // Aliases are usable wherever the base type is expected (e.g. request fields).
+        let request = HelperAPI.GetUser.Request(userId: id)
+        let body = try HelperAPI.GetUser.encodeRequest(request)
+        let bodyJSON = try JSONSerialization.jsonObject(with: body) as? [String: Any]
+        XCTAssertEqual(bodyJSON?["userId"] as? NSNumber, 42)
+    }
+
     func testHelperRoundTripWorks() throws {
         let request = HelperAPI.GetUser.Request(userId: 7)
         let body = try HelperAPI.GetUser.encodeRequest(request)

Tests/test.ridl

@@ -4,6 +4,8 @@ name = Helper
 version = v1.0.0
 basepath = /rpc
 
+type UserID: uint64
+
 struct Ledger
   - amount: bigint
   - amounts: []bigint
@@ -20,7 +22,7 @@ struct Box
   - payload: any
 
 service Helper
-  - GetUser(userId: uint64) => (code: uint32, username: string)
+  - GetUser(userId: UserID) => (code: uint32, username: string)
   - EchoLedger(Ledger) => (Ledger)
   - EchoBasket(Basket) => (Basket)
   - EchoBox(Box) => (Box)