diff --git a/typescript/raven-tests.ts b/typescript/raven-tests.ts
index 7b38609ba69f..2fb80f66d920 100644
--- a/typescript/raven-tests.ts
+++ b/typescript/raven-tests.ts
@@ -1,8 +1,8 @@
-import Raven = require('..');
+import Raven = require('..'); // or import * as Raven from '..'
Raven.config('https://public@sentry.io/1').install();
-var options = {
+var options: Raven.RavenOptions = {
logger: 'my-logger',
ignoreUrls: [
/graph\.facebook\.com/i,
diff --git a/typescript/raven.d.ts b/typescript/raven.d.ts
index aa613ce28207..4e2618b793ad 100644
--- a/typescript/raven.d.ts
+++ b/typescript/raven.d.ts
@@ -2,271 +2,273 @@
// Project: https://github.com/getsentry/raven-js
// Definitions by: Santi Albo , Benjamin Pannell
-declare var Raven: RavenStatic;
+declare var Raven: Raven.RavenStatic;
export = Raven;
-interface RavenOptions {
- /** The log level associated with this event. Default: error */
- level?: LogLevel;
+declare module Raven {
+ interface RavenOptions {
+ /** The log level associated with this event. Default: error */
+ level?: LogLevel;
- /** The name of the logger used by Sentry. Default: javascript */
- logger?: string;
+ /** The name of the logger used by Sentry. Default: javascript */
+ logger?: string;
- /** The environment of the application you are monitoring with Sentry */
- environment?: string;
+ /** The environment of the application you are monitoring with Sentry */
+ environment?: string;
- /** The release version of the application you are monitoring with Sentry */
- release?: string;
+ /** The release version of the application you are monitoring with Sentry */
+ release?: string;
- /** The name of the server or device that the client is running on */
- serverName?: string;
+ /** The name of the server or device that the client is running on */
+ serverName?: string;
- /** List of messages to be filtered out before being sent to Sentry. */
- ignoreErrors?: (RegExp | string)[];
+ /** List of messages to be filtered out before being sent to Sentry. */
+ ignoreErrors?: (RegExp | string)[];
- /** Similar to ignoreErrors, but will ignore errors from whole urls patching a regex pattern. */
- ignoreUrls?: (RegExp | string)[];
+ /** Similar to ignoreErrors, but will ignore errors from whole urls patching a regex pattern. */
+ ignoreUrls?: (RegExp | string)[];
- /** The inverse of ignoreUrls. Only report errors from whole urls matching a regex pattern. */
- whitelistUrls?: (RegExp | string)[];
+ /** The inverse of ignoreUrls. Only report errors from whole urls matching a regex pattern. */
+ whitelistUrls?: (RegExp | string)[];
- /** An array of regex patterns to indicate which urls are a part of your app. */
- includePaths?: (RegExp | string)[];
-
- /** Additional data to be tagged onto the error. */
- tags?: {
- [id: string]: string;
- };
-
- /** set to true to get the stack trace of your message */
- stacktrace?: boolean;
-
- extra?: any;
-
- /** In some cases you may see issues where Sentry groups multiple events together when they should be separate entities. In other cases, Sentry simply doesn’t group events together because they’re so sporadic that they never look the same. */
- fingerprint?: string[];
-
- /** A function which allows mutation of the data payload right before being sent to Sentry */
- dataCallback?: (data: any) => any;
-
- /** A callback function that allows you to apply your own filters to determine if the message should be sent to Sentry. */
- shouldSendCallback?: (data: any) => boolean;
-
- /** By default, Raven does not truncate messages. If you need to truncate characters for whatever reason, you may set this to limit the length. */
- maxMessageLength?: number;
-
- /** By default, Raven will truncate URLs as they appear in breadcrumbs and other meta interfaces to 250 characters in order to minimize bytes over the wire. This does *not* affect URLs in stack traces. */
- maxUrlLength?: number;
-
- /** Override the default HTTP data transport handler. */
- transport?: (options: RavenTransportOptions) => void;
-
- /** Allow use of private/secretKey. */
- allowSecretKey?: boolean;
-
- /** Enables/disables instrumentation of globals. */
- instrument?: boolean | RavenInstrumentationOptions;
-
- /** Enables/disables automatic collection of breadcrumbs. */
- autoBreadcrumbs?: boolean | AutoBreadcrumbOptions
-}
-
-interface RavenInstrumentationOptions {
- tryCatch?: boolean;
+ /** An array of regex patterns to indicate which urls are a part of your app. */
+ includePaths?: (RegExp | string)[];
+
+ /** Additional data to be tagged onto the error. */
+ tags?: {
+ [id: string]: string;
+ };
+
+ /** set to true to get the stack trace of your message */
+ stacktrace?: boolean;
+
+ extra?: any;
+
+ /** In some cases you may see issues where Sentry groups multiple events together when they should be separate entities. In other cases, Sentry simply doesn’t group events together because they’re so sporadic that they never look the same. */
+ fingerprint?: string[];
+
+ /** A function which allows mutation of the data payload right before being sent to Sentry */
+ dataCallback?: (data: any) => any;
+
+ /** A callback function that allows you to apply your own filters to determine if the message should be sent to Sentry. */
+ shouldSendCallback?: (data: any) => boolean;
+
+ /** By default, Raven does not truncate messages. If you need to truncate characters for whatever reason, you may set this to limit the length. */
+ maxMessageLength?: number;
+
+ /** By default, Raven will truncate URLs as they appear in breadcrumbs and other meta interfaces to 250 characters in order to minimize bytes over the wire. This does *not* affect URLs in stack traces. */
+ maxUrlLength?: number;
+
+ /** Override the default HTTP data transport handler. */
+ transport?: (options: RavenTransportOptions) => void;
+
+ /** Allow use of private/secretKey. */
+ allowSecretKey?: boolean;
+
+ /** Enables/disables instrumentation of globals. */
+ instrument?: boolean | RavenInstrumentationOptions;
+
+ /** Enables/disables automatic collection of breadcrumbs. */
+ autoBreadcrumbs?: boolean | AutoBreadcrumbOptions
+ }
+
+ interface RavenInstrumentationOptions {
+ tryCatch?: boolean;
+ }
+
+ interface RavenStatic {
+
+ /** Raven.js version. */
+ VERSION: string;
+
+ Plugins: { [id: string]: RavenPlugin };
+
+ /*
+ * Allow Raven to be configured as soon as it is loaded
+ * It uses a global RavenConfig = {dsn: '...', config: {}}
+ *
+ * @return undefined
+ */
+ afterLoad(): void;
+
+ /*
+ * Allow multiple versions of Raven to be installed.
+ * Strip Raven from the global context and returns the instance.
+ *
+ * @return {Raven}
+ */
+ noConflict(): RavenStatic;
+
+ /*
+ * Configure Raven with a DSN and extra options
+ *
+ * @param {string} dsn The public Sentry DSN
+ * @param {object} options Optional set of of global options [optional]
+ * @return {Raven}
+ */
+ config(dsn: string, options?: RavenOptions): RavenStatic;
+
+ /*
+ * Installs a global window.onerror error handler
+ * to capture and report uncaught exceptions.
+ * At this point, install() is required to be called due
+ * to the way TraceKit is set up.
+ *
+ * @return {Raven}
+ */
+ install(): RavenStatic;
+
+ /*
+ * Adds a plugin to Raven
+ *
+ * @return {Raven}
+ */
+ addPlugin(plugin: RavenPlugin, ...pluginArgs: any[]): RavenStatic;
+
+ /*
+ * Wrap code within a context so Raven can capture errors
+ * reliably across domains that is executed immediately.
+ *
+ * @param {object} options A specific set of options for this context [optional]
+ * @param {function} func The callback to be immediately executed within the context
+ * @param {array} args An array of arguments to be called with the callback [optional]
+ */
+ context(func: Function, ...args: any[]): void;
+ context(options: RavenOptions, func: Function, ...args: any[]): void;
+
+ /*
+ * Wrap code within a context and returns back a new function to be executed
+ *
+ * @param {object} options A specific set of options for this context [optional]
+ * @param {function} func The function to be wrapped in a new context
+ * @return {function} The newly wrapped functions with a context
+ */
+ wrap(func: Function): Function;
+ wrap(options: RavenOptions, func: Function): Function;
+ wrap(func: T): T;
+ wrap(options: RavenOptions, func: T): T;
+
+ /*
+ * Uninstalls the global error handler.
+ *
+ * @return {Raven}
+ */
+ uninstall(): RavenStatic;
+
+ /*
+ * Manually capture an exception and send it over to Sentry
+ *
+ * @param {error} ex An exception to be logged
+ * @param {object} options A specific set of options for this error [optional]
+ * @return {Raven}
+ */
+ captureException(ex: Error, options?: RavenOptions): RavenStatic;
+
+ /*
+ * Manually send a message to Sentry
+ *
+ * @param {string} msg A plain message to be captured in Sentry
+ * @param {object} options A specific set of options for this message [optional]
+ * @return {Raven}
+ */
+ captureMessage(msg: string, options?: RavenOptions): RavenStatic;
+
+ /** Log a breadcrumb */
+ captureBreadcrumb(crumb: Breadcrumb): RavenStatic;
+
+ /**
+ * Clear the user context, removing the user data that would be sent to Sentry.
+ */
+ setUserContext(): RavenStatic;
+
+ /*
+ * Set a user to be sent along with the payload.
+ *
+ * @param {object} user An object representing user data [optional]
+ * @return {Raven}
+ */
+ setUserContext(user: {
+ id?: string;
+ username?: string;
+ email?: string;
+ }): RavenStatic;
+
+ /** Merge extra attributes to be sent along with the payload. */
+ setExtraContext(context: Object): RavenStatic;
+
+ /** Merge tags to be sent along with the payload. */
+ setTagsContext(tags: Object): RavenStatic;
+
+ /** Clear all of the context. */
+ clearContext(): RavenStatic;
+
+ /** Get a copy of the current context. This cannot be mutated.*/
+ getContext(): Object;
+
+ /** Override the default HTTP data transport handler. */
+ setTransport(transportFunction: (options: RavenTransportOptions) => void): RavenStatic;
+
+ /** Set environment of application */
+ setEnvironment(environment: string): RavenStatic;
+
+ /** Set release version of application */
+ setRelease(release: string): RavenStatic;
+
+ /** Get the latest raw exception that was captured by Raven.*/
+ lastException(): Error;
+
+ /** An event id is a globally unique id for the event that was just sent. This event id can be used to find the exact event from within Sentry. */
+ lastEventId(): string;
+
+ /** If you need to conditionally check if raven needs to be initialized or not, you can use the isSetup function. It will return true if Raven is already initialized. */
+ isSetup(): boolean;
+
+ /** Specify a function that allows mutation of the data payload right before being sent to Sentry. */
+ setDataCallback(data: any, orig?: any): RavenStatic;
+
+ /** Specify a callback function that allows you to mutate or filter breadcrumbs when they are captured. */
+ setBreadcrumbCallback(data: any, orig?: any): RavenStatic;
+
+ /** Specify a callback function that allows you to apply your own filters to determine if the message should be sent to Sentry. */
+ setShouldSendCallback(data: any, orig?: any): RavenStatic;
+
+ /** Show Sentry user feedback dialog */
+ showReportDialog(options: Object): void;
+ }
+
+ interface RavenTransportOptions {
+ url: string;
+ data: any;
+ auth: {
+ sentry_version: string;
+ sentry_client: string;
+ sentry_key: string;
+ };
+ onSuccess: () => void;
+ onFailure: () => void;
+ }
+
+ interface RavenPlugin {
+ (raven: RavenStatic, ...args: any[]): RavenStatic;
+ }
+
+ interface Breadcrumb {
+ message?: string;
+ category?: string;
+ level?: LogLevel;
+ data?: any;
+ type?: BreadcrumbType
+ }
+
+ type BreadcrumbType = "navigation" | "http";
+
+ interface AutoBreadcrumbOptions {
+ xhr?: boolean;
+ console?: boolean;
+ dom?: boolean;
+ location?: boolean;
+ }
+
+ type LogLevel = "critical" | "error" | "warning" | "info" | "debug";
}
-
-interface RavenStatic {
-
- /** Raven.js version. */
- VERSION: string;
-
- Plugins: { [id: string]: RavenPlugin };
-
- /*
- * Allow Raven to be configured as soon as it is loaded
- * It uses a global RavenConfig = {dsn: '...', config: {}}
- *
- * @return undefined
- */
- afterLoad(): void;
-
- /*
- * Allow multiple versions of Raven to be installed.
- * Strip Raven from the global context and returns the instance.
- *
- * @return {Raven}
- */
- noConflict(): RavenStatic;
-
- /*
- * Configure Raven with a DSN and extra options
- *
- * @param {string} dsn The public Sentry DSN
- * @param {object} options Optional set of of global options [optional]
- * @return {Raven}
- */
- config(dsn: string, options?: RavenOptions): RavenStatic;
-
- /*
- * Installs a global window.onerror error handler
- * to capture and report uncaught exceptions.
- * At this point, install() is required to be called due
- * to the way TraceKit is set up.
- *
- * @return {Raven}
- */
- install(): RavenStatic;
-
- /*
- * Adds a plugin to Raven
- *
- * @return {Raven}
- */
- addPlugin(plugin: RavenPlugin, ...pluginArgs: any[]): RavenStatic;
-
- /*
- * Wrap code within a context so Raven can capture errors
- * reliably across domains that is executed immediately.
- *
- * @param {object} options A specific set of options for this context [optional]
- * @param {function} func The callback to be immediately executed within the context
- * @param {array} args An array of arguments to be called with the callback [optional]
- */
- context(func: Function, ...args: any[]): void;
- context(options: RavenOptions, func: Function, ...args: any[]): void;
-
- /*
- * Wrap code within a context and returns back a new function to be executed
- *
- * @param {object} options A specific set of options for this context [optional]
- * @param {function} func The function to be wrapped in a new context
- * @return {function} The newly wrapped functions with a context
- */
- wrap(func: Function): Function;
- wrap(options: RavenOptions, func: Function): Function;
- wrap(func: T): T;
- wrap(options: RavenOptions, func: T): T;
-
- /*
- * Uninstalls the global error handler.
- *
- * @return {Raven}
- */
- uninstall(): RavenStatic;
-
- /*
- * Manually capture an exception and send it over to Sentry
- *
- * @param {error} ex An exception to be logged
- * @param {object} options A specific set of options for this error [optional]
- * @return {Raven}
- */
- captureException(ex: Error, options?: RavenOptions): RavenStatic;
-
- /*
- * Manually send a message to Sentry
- *
- * @param {string} msg A plain message to be captured in Sentry
- * @param {object} options A specific set of options for this message [optional]
- * @return {Raven}
- */
- captureMessage(msg: string, options?: RavenOptions): RavenStatic;
-
- /** Log a breadcrumb */
- captureBreadcrumb(crumb: Breadcrumb): RavenStatic;
-
- /**
- * Clear the user context, removing the user data that would be sent to Sentry.
- */
- setUserContext(): RavenStatic;
-
- /*
- * Set a user to be sent along with the payload.
- *
- * @param {object} user An object representing user data [optional]
- * @return {Raven}
- */
- setUserContext(user: {
- id?: string;
- username?: string;
- email?: string;
- }): RavenStatic;
-
- /** Merge extra attributes to be sent along with the payload. */
- setExtraContext(context: Object): RavenStatic;
-
- /** Merge tags to be sent along with the payload. */
- setTagsContext(tags: Object): RavenStatic;
-
- /** Clear all of the context. */
- clearContext(): RavenStatic;
-
- /** Get a copy of the current context. This cannot be mutated.*/
- getContext(): Object;
-
- /** Override the default HTTP data transport handler. */
- setTransport(transportFunction: (options: RavenTransportOptions) => void): RavenStatic;
-
- /** Set environment of application */
- setEnvironment(environment: string): RavenStatic;
-
- /** Set release version of application */
- setRelease(release: string): RavenStatic;
-
- /** Get the latest raw exception that was captured by Raven.*/
- lastException(): Error;
-
- /** An event id is a globally unique id for the event that was just sent. This event id can be used to find the exact event from within Sentry. */
- lastEventId(): string;
-
- /** If you need to conditionally check if raven needs to be initialized or not, you can use the isSetup function. It will return true if Raven is already initialized. */
- isSetup(): boolean;
-
- /** Specify a function that allows mutation of the data payload right before being sent to Sentry. */
- setDataCallback(data: any, orig?: any): RavenStatic;
-
- /** Specify a callback function that allows you to mutate or filter breadcrumbs when they are captured. */
- setBreadcrumbCallback(data: any, orig?: any): RavenStatic;
-
- /** Specify a callback function that allows you to apply your own filters to determine if the message should be sent to Sentry. */
- setShouldSendCallback(data: any, orig?: any): RavenStatic;
-
- /** Show Sentry user feedback dialog */
- showReportDialog(options: Object): void;
-}
-
-interface RavenTransportOptions {
- url: string;
- data: any;
- auth: {
- sentry_version: string;
- sentry_client: string;
- sentry_key: string;
- };
- onSuccess: () => void;
- onFailure: () => void;
-}
-
-interface RavenPlugin {
- (raven: RavenStatic, ...args: any[]): RavenStatic;
-}
-
-interface Breadcrumb {
- message?: string;
- category?: string;
- level?: LogLevel;
- data?: any;
- type?: BreadcrumbType
-}
-
-type BreadcrumbType = "navigation" | "http";
-
-interface AutoBreadcrumbOptions {
- xhr?: boolean;
- console?: boolean;
- dom?: boolean;
- location?: boolean;
-}
-
-type LogLevel = "critical" | "error" | "warning" | "info" | "debug";
\ No newline at end of file