Add TypeScript support

Author: matux

CLAUDE.md

@@ -84,7 +84,11 @@ As of version 3.0.0, the SDK has been updated to use modern JavaScript features
 
 ## TypeScript Support
 
+- Full TypeScript support for mixed JS/TS codebases
 - Type definitions in index.d.ts
+- TypeScript compilation via babel-preset-typescript
+- See examples/typescript for a complete example
+- For new development, both .js and .ts files are supported
 - Add JSDoc types to enable intellisense when needed
 
 ## Common Patterns

babel.config.json

@@ -1,9 +1,7 @@
 {
   "parserOpts": {
     "ecmaVersion": 2021,
-    "sourceType": "module",
+    "sourceType": "module"
   },
-  "presets": [
-    "@babel/preset-env"
-  ]
+  "presets": ["@babel/preset-env", "@babel/preset-typescript"]
 }

examples/typescript/README.md

@@ -0,0 +1,36 @@
+# TypeScript Example
+
+This example shows how to use rollbar.js with TypeScript. The example demonstrates how to:
+
+- Import Rollbar in a TypeScript file
+- Configure a Rollbar instance
+- Use TypeScript interfaces with Rollbar
+- Log messages and data with strong typing
+
+## Requirements
+
+- Node.js v18+
+- npm or yarn
+
+## Running the example
+
+```bash
+# Install dependencies
+npm install
+
+# Build the TypeScript files
+npm run build
+
+# Run the example
+npm start
+```
+
+## How it works
+
+The project includes:
+
+1. TypeScript configuration in `tsconfig.json`
+2. Dependencies for TypeScript in `package.json`
+3. Example TypeScript code in `src/example.ts`
+
+This example works because the rollbar.js library includes TypeScript definitions in `index.d.ts` and the build system has been configured to support TypeScript files.

examples/typescript/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "typescript-example",
+  "version": "1.0.0",
+  "description": "Example of using Rollbar with TypeScript",
+  "main": "dist/example.js",
+  "scripts": {
+    "tsc": "tsc",
+    "build": "tsc",
+    "start": "node ./dist/example.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@types/node": "^18.0.0",
+    "rollbar": "file:../../"
+  }
+}

examples/typescript/src/example.ts

@@ -0,0 +1,30 @@
+import * as Rollbar from 'rollbar';
+
+const rollbar = new Rollbar({
+  accessToken: 'POST_SERVER_ITEM_ACCESS_TOKEN',
+  captureUncaught: true,
+  captureUnhandledRejections: true
+});
+
+// TypeScript example using strongly-typed parameters
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+function processUser(user: User): void {
+  rollbar.info(`Processing user: ${user.name}`, user);
+}
+
+// Create a user and process it
+const user: User = {
+  id: 123,
+  name: 'Example User',
+  email: 'user@example.com'
+};
+
+processUser(user);
+
+// Log a message
+rollbar.info('Hello from TypeScript!');

examples/typescript/src/index.ts

@@ -0,0 +1,12 @@
+export = function error() {
+
+  class CustomError extends Error {
+    constructor(message: string) {
+      super(`Lorem "${message}" ipsum dolor.`);
+      this.name = 'CustomError';
+    }
+  }
+  // TypeScript code snippet will include `<Error>`
+  var error = <Error> new CustomError('foo');
+  throw error;
+}

examples/typescript/src/src/index.ts

@@ -0,0 +1,12 @@
+export = function error() {
+
+  class CustomError extends Error {
+    constructor(message: string) {
+      super(`Lorem "${message}" ipsum dolor.`);
+      this.name = 'CustomError';
+    }
+  }
+  // TypeScript code snippet will include `<Error>`
+  var error = <Error> new CustomError('foo');
+  throw error;
+}

examples/typescript/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "es6",
+    "module": "commonjs",
+    "outDir": "dist",
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules"]
+}