Spec Version: v1 (Latest)v0.1

RudderTyper v2 Command Reference Beta

This page serves as a detailed reference for the RudderTyper v2 CLI commands available through Rudder CLI.

Overview

RudderTyper v2 is integrated into Rudder CLI and provides the following commands to generate type-safe client bindings from your Tracking Plans:

List Tracking Plans

The workspace tracking-plans list command displays an interactive table with all available Tracking Plans in your workspace.

Command syntax

rudder-cli workspace tracking-plans list

Description

This command displays an interactive interface showing all Tracking Plans in your workspace.

Selecting a Tracking Plan from the list shows its details in a panel on the right, including the plan’s name, description, and current version, as shown:

Generate bindings

The typer generate command generates type-safe bindings for a specified platform from a Tracking Plan.

Command syntax

rudder-cli typer generate --platform=<PLATFORM> --tracking-plan-id=<TRACKING_PLAN_ID> [options]

Parameters

Examples

• Generate Kotlin bindings with default settings:

rudder-cli typer generate --platform=kotlin --tracking-plan-id=tp_1234567890abcdef

• Generate Swift bindings with default settings:

rudder-cli typer generate --platform=swift --tracking-plan-id=tp_1234567890abcdef

• Generate bindings to a specific output directory:

rudder-cli typer generate --platform=kotlin --tracking-plan-id=tp_1234567890abcdef -o ./generated-code

• Generate Kotlin bindings with a custom package name:

rudder-cli typer generate --platform=kotlin --tracking-plan-id=tp_1234567890abcdef --option packageName=com.example.package

View platform options

The typer options command displays available platform-specific options for customizing generated code.

Command syntax

rudder-cli typer options --platform=<platform>

Parameters

Description

This command displays an interactive interface showing all available options for the specified platform, along with their descriptions and usage examples.

Example

rudder-cli typer options --platform=kotlin

Platform options

Platform-specific options customize how code is generated for each platform. Pass these options to the typer generate command using the --option flag with a key/value pair format: --option key=value.

Kotlin platform options

Example:

rudder-cli typer generate --platform=kotlin --tracking-plan-id=tp_1234567890abcdef --option packageName=com.example.package

Swift platform options

The Swift platform does not currently expose any platform-specific options.

Supported platforms

Generated code structure

The generated code structure depends on the platform and options specified.

Kotlin

By default, Kotlin bindings are generated with the package name com.rudderstack.ruddertyper. The generated files should be placed in a directory structure that matches the package name:

src/main/kotlin/com/rudderstack/ruddertyper/

Custom package structure

If you specify a custom packageName option, place the generated files in a directory structure that matches your custom package name. For example, with packageName=com.example.package:

src/main/kotlin/com/example/package/

Swift

Swift bindings are generated as a single RudderTyper.swift file. The file is organized into the following sections:

RudderTyper.swift
├── Custom Types        (type aliases and structs for custom types)
├── Property Types      (type aliases for property types)
├── Event Properties    (structs for event properties and traits)
└── RudderTyperAnalytics (wrapper class with type-safe event methods)

The generated file imports Foundation and RudderStackAnalytics.

Using generated code

After generating the code, import it into your project and use the type-safe methods for tracking.

import com.rudderstack.ruddertyper.RudderAnalytics

val typer = com.rudderstack.ruddertyper.RudderAnalytics(analytics)

typer.trackUserLogin(
  properties = TrackUserLoginProperties(
    // ... properties defined in your Tracking Plan
  )
)

import RudderStackAnalytics

let rudderTyper = RudderTyperAnalytics(analytics: analytics)

rudderTyper.trackUserLogin(
    properties: TrackUserLoginProperties(
        // ... properties defined in your Tracking Plan
    )
)

The generated code provides:

• Type-safe event methods: Each event in your Tracking Plan becomes a method
• Required parameters: Required properties are enforced at compile time
• Property validation: Property types match your Tracking Plan schema

See the RudderTyper v2 Walkthrough Guide for a complete setup example including SDK initialization.

Type mappings

RudderTyper maps YAML types from your Tracking Plan definitions to native types for each platform.

Properties that support multiple types are represented as a sealed class in Kotlin or an enum with associated values in Swift. Each type variant is represented as a distinct case, and a value property provides access to the underlying value.

Naming conventions

RudderTyper applies consistent naming conventions when generating code from your Tracking Plan definitions. These conventions are the same across both Kotlin and Swift.

Event methods

Properties and traits structs

Type name prefixes

Event names are converted to CamelCase for method and struct names, with the original event name preserved in the underlying SDK call.

Supported event types

RudderTyper generates type-safe methods for the following event types:

Every generated method includes an optional options parameter that lets you pass additional configuration (such as integration overrides) to the underlying SDK call. RudderTyper automatically injects a ruddertyper context object into every call for attribution.

See more

• RudderTyper v2 Overview: Features and limitations of RudderTyper v2
• RudderTyper v2 Walkthrough: Step-by-step tutorial to get started with RudderTyper v2
• RudderTyper v1 (npm): npm-based code generation for JavaScript, TypeScript, Java, and Objective-C
• Tracking Plans: Create and manage Tracking Plans in RudderStack
• Commands Reference: All Rudder CLI commands