ref: Introduce @sentry/integrations package

Author: kamilogorek

CHANGELOG.md

@@ -30,6 +30,8 @@ since we removed some methods from the public API and removed some classes from
 - **breaking** [utils] ref: Rename `safeNormalize` to `normalize` and rewrite its internals
 - **breaking** [utils] ref: Remove `serialize`, `deserialize`, `clone` and `serializeObject` functions
 - **breaking** [utils] ref: Rewrite normalization functions by removing most of them and leaving just `normalize` and `normalizeToSize`
+- **breaking** [core] ref: Extract all pluggable integrations into a separate `@sentry/integrations` package
+- **breaking** [core] ref: Move `extraErrorData` integration to `@sentry/integrations` package
 - [core] feat: Add `maxValueLength` option to adjust max string length for values, default is 250.
 
 ## 4.6.4

Makefile

@@ -13,6 +13,7 @@ publish-npm:
 	cd packages/browser; npm publish
 	cd packages/core; npm publish
 	cd packages/hub; npm publish
+	cd packages/integrations; npm publish
 	cd packages/minimal; npm publish
 	cd packages/node; npm publish
 	# cd packages/types; npm publish

README.md

@@ -40,6 +40,8 @@ package. Please refer to the README and instructions of those SDKs for more deta
   including integrations for React, Angular, Ember, Vue and Backbone
 - [`@sentry/node`](https://github.com/getsentry/sentry-javascript/tree/master/packages/node): SDK for Node, including
   integrations for Express, Koa, Loopback, Sails and Connect
+- [`@sentry/integrations`](https://github.com/getsentry/sentry-javascript/tree/master/packages/integrations): Pluggable
+  integrations that can be used to enchance JS SDKs
 - [`@sentry/electron`](https://github.com/getsentry/sentry-electron): SDK for Electron with support for native crashes
 - [`sentry-cordova`](https://github.com/getsentry/sentry-cordova): SDK for Cordova Apps and Ionic with support for
   native crashes
@@ -73,15 +75,16 @@ captureMessage('Hello, world!');
 ```
 
 If you want sentry to be customized for the browsers you want to support use the `esm` build:
+
 ```javascript
 import { init, captureMessage } from '@sentry/browser/esm';
 ```
 
 and add it to your babel/... build, if you want to support older browsers
 
-> TIP: You can use [`<script type="module" str="newbrowser.js">` + 
-  `<script nomodule src="oldbrowser.js">`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#Module_Fallback)
-  to provide builds for newer and older browsers
+> TIP: You can use
+> [`<script type="module" str="newbrowser.js">` + `<script nomodule src="oldbrowser.js">`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#Module_Fallback)
+> to provide builds for newer and older browsers
 
 ## Other Packages
 

dangerfile.ts

@@ -5,7 +5,7 @@ import { resolve } from 'path';
 import tslint from 'danger-plugin-tslint';
 import { prettyResults } from 'danger-plugin-tslint/dist/prettyResults';
 
-const packages = ['browser', 'core', 'hub', 'minimal', 'node', 'types', 'utils'];
+const packages = ['browser', 'core', 'hub', 'integrations', 'minimal', 'node', 'types', 'utils'];
 
 export default async () => {
   if (!danger.github) {

package.json

@@ -16,6 +16,7 @@
     "packages/browser",
     "packages/core",
     "packages/hub",
+    "packages/integrations",
     "packages/minimal",
     "packages/node",
     "packages/types",

packages/browser/src/integrations/index.ts

@@ -3,7 +3,3 @@ export { TryCatch } from './trycatch';
 export { Breadcrumbs } from './breadcrumbs';
 export { LinkedErrors } from './linkederrors';
 export { UserAgent } from './useragent';
-
-export { Ember } from './pluggable/ember';
-export { Vue } from './pluggable/vue';
-export { ReportingObserver } from './pluggable/reportingobserver';

packages/core/src/integrations/index.ts

@@ -2,6 +2,3 @@ export { Dedupe } from './dedupe';
 export { FunctionToString } from './functiontostring';
 export { InboundFilters } from './inboundfilters';
 export { ExtraErrorData } from './extraerrordata';
-
-export { Debug } from './pluggable/debug';
-export { RewriteFrames } from './pluggable/rewriteframes';

packages/integrations/.gitignore

@@ -0,0 +1,3 @@
+*.js.map
+*.d.ts
+*.js

packages/integrations/.npmignore

@@ -0,0 +1,6 @@
+*
+!*.js.map
+!*.d.ts
+!*.js
+!/esm/**/*
+jest.config.js

packages/integrations/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2019, Sentry
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/integrations/README.md

@@ -0,0 +1,22 @@
+<p align="center">
+  <a href="https://sentry.io" target="_blank" align="center">
+    <img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280">
+  </a>
+  <br />
+</p>
+
+# Sentry JavaScript SDK Integrations
+
+[![npm version](https://img.shields.io/npm/v/@sentry/integrations.svg)](https://www.npmjs.com/package/@sentry/integrations)
+[![npm dm](https://img.shields.io/npm/dm/@sentry/integrations.svg)](https://www.npmjs.com/package/@sentry/integrations)
+[![npm dt](https://img.shields.io/npm/dt/@sentry/integrations.svg)](https://www.npmjs.com/package/@sentry/integrations)
+[![typedoc](https://img.shields.io/badge/docs-typedoc-blue.svg)](http://getsentry.github.io/sentry-javascript/)
+
+## Links
+
+- [Official SDK Docs](https://docs.sentry.io/quickstart/)
+- [TypeDoc](http://getsentry.github.io/sentry-javascript/)
+
+## General
+
+Pluggable integrations that can be used to enchance JS SDKs.