Allows you to contextualize your analytics instrumentation and validate it with your event spec, before deploying to production.
You can access and validate your event names, properties, types, etc.
It provides compile-time errors and warns you about any missing required properties, data mismatch, and any issues in the JSON schema configured in your tracking plan.
This feature is currently in a closed beta. If you're interested, please contact your account representative for more information.
Get Started
To fire up a quick start wizard to create a ruddertyper.yml and generate your first client with the specified configuration details, run the following command:
$npxrudder-typerinit|initialize|quickstart
Other Commands
Update
$npxrudder-typerupdate|u|* (default)
This command syncs plan.json with RudderStack to pull the latest changes in your tracking plan and then generates an updated development client.
Build
$npxrudder-typerbuild|b|d|dev|development
This command generates a development client from plan.json.
Production
$npxrudder-typerprod|p|production
This command generates a production client from plan.json.
Token
$npxrudder-typertoken|tokens|t
This command prints the local RudderStack API token configuration.
Version
$npxrudder-typerversion
This command prints the RudderTyper CLI version.
Help
$npxrudder-typerhelp
This command prints the help message describing different commands available with RudderTyper.
CLI Arguments
Argument
Type
Description
config
string
An optional path to a ruddertyper.yml (or a directory with ruddertyper.yml).
debug
boolean
An optional (hidden) flag for enabling Ink debug mode.
version
boolean
Standard --version flag to print the version of this CLI.
v
boolean
Standard -v flag to print the version of this CLI.
help
boolean
Standard --help flag to print help on a command.
h
boolean
Standard -h flag to print help on a command.
Configuration Reference
RudderTyper stores its configuration in a ruddertyper.yml file in the root of your repository.
A sample configuration looks like the following:
# RudderStack RudderTyper Configuration Reference (https://github.com/rudderlabs/rudder-typer)# Just run `npx rudder-typer` to re-generate a client with the latest versions of these events.scripts: # You can supply a RudderStack API token using a `script.token` command. The output of `script.token` command should be a valid RudderStack API token.
token:source.env; echo $RUDDERTYPER_TOKEN # You can supply email address linked to your workspace using a `script.email` command.The output of `script.email` command should be an email address registered with your workspace.
email:source.env:echo $EMAIL# You can format any of RudderTyper's auto-generated files using a `script.after` command.# See `Formatting Generated Files` below.after:./node_modules/.bin/prettier--writeanalytics/plan.jsonclient:# Which RudderStack SDK you are generating for.# Valid values: analytics.js, analytics-node, analytics-ios, analytics-android.sdk:analytics-node# The target language for your RudderTyper client.# Valid values: javascript, java, objective-c, swift.language:javascript# Javascript Transpilation Settings# Valid values: 'ES3','ES5','ES2015','ES2016','ES2017','ES2018','ES2019','ESNext','Latest'scriptTarget:'ES6'# Valid values: 'CommonJS','AMD','UMD','System','ES2015','ESNext'moduleTarget:'ESNext'trackingPlans:# The RudderStack Tracking Plan that you are generating a client for.# Provide your workspace slug and Tracking Plan id# You also need to supply a path to a directory to save your RudderTyper client.-id:rs_QhWHOgp7xg8wkYxilH3scd2uRIDworkspaceSlug:rudderstack-demopath:./analytics
How to integrate RudderTyper-generated client with your app?
This section includes steps to integrate your RudderTyper-generated client with your app across different RudderStack SDKs.
RudderStack Android SDK
Import all the files in the client generated by RudderTyper as a package in your project.
Then, you can directly make the calls using the RudderTyper client as shown below:
// Import your auto-generated RudderTyper client:importcom.rudderstack.generated.*// Issue your first RudderTyper track call! RudderTyperAnalytics.with(this).orderCompleted( OrderCompleted.Builder().orderID("ck-f306fe0e-cc21-445a-9caa-08245a9aa52c").total(39.99).build() );
RudderStack iOS SDK
Import your RudderTyper client into your project using XCode.
NOTE: If you place your generated files into a folder in your project, import the project as a group not a folder reference.
Then, you can directly make the calls using the RudderTyper client as shown:
// Import your auto-generated RudderTyper client:
#import "RSRudderTyperAnalytics.h"
// Issue your first RudderTyper track call!
[RSRudderTyperAnalytics orderCompletedWithOrderID: "ck-f306fe0e-cc21-445a-9caa-08245a9aa52c" total: @39.99];
RudderStack JavaScript SDK
Import the RudderTyper-generated client using require() and make the calls if your framework supports them. Otherwise, you can use Browserify to generate a bundle that supports your implementation. The implementation for each of the alternatives mentioned above will be as shown:
Using the require()method
// Import RudderStack JS SDK and initialize itconstrudderanalytics=require("rudder-sdk-js")rudderanalytics.load(YOUR_WRITE_KEY,DATA_PLANE_URL)// Import your auto-generated RudderTyper client:construdderTyper=require("./rudderTyperClient")// Pass in your rudder-sdk-js instance to RudderTyper clientrudderTyper.setRudderTyperOptions({ analytics: rudderanalytics,})// Issue your first RudderTyper track call!rudderTyper.orderCompleted({ orderID:"ck-f306fe0e-cc21-445a-9caa-08245a9aa52c", total:39.99,})
Using browserify
Execute the following command to generate a bundle from the RudderTyper client:
If you are using an older version of the JavaScript SDK (v1), refer to the Version Migration Guide to migrate to v1.1.
RudderStack Node.js SDK
Import the the RudderTyper-generated client and start making calls using RudderTyper as shown:
// Import Rudder Node SDK and intialize itconstAnalytics=require("@rudderstack/rudder-sdk-node")constclient=newAnalytics(WRITE_KEY,DATA_PLANE_URL/ v1 / batch)construddertyper=require("./rudderTyperClient")// Pass in your rudder-sdk-node instance to RudderTyper.ruddertyper.setRudderTyperOptions({ analytics: client,})// Issue your first RudderTyper track call!ruddertyper.orderCompleted({ orderID:"ck-f306fe0e-cc21-445a-9caa-08245a9aa52c", total:39.99,})
Contribute
To submit a bug report or feature request, file an issue here.