feat: atomic @sentry/utils used only with submodule imports (#1413)

* feat: Add .gitignore for utils
* fix: Utils submodule import
* feat: Build from src into root for utils, Remove browser packages
* feat: Move jest config into package.json to be consitent
* fix: Lint error

Author: HazAT

packages/browser/package.json

@@ -38,7 +38,6 @@
     "rimraf": "^2.6.2",
     "rollup": "^0.58.2",
     "rollup-plugin-commonjs": "^9.1.3",
-    "rollup-plugin-node-builtins": "^2.1.2",
     "rollup-plugin-node-resolve": "^3.3.0",
     "rollup-plugin-npm": "^2.0.0",
     "rollup-plugin-typescript2": "^0.13.0",

packages/browser/rollup.config.js

@@ -2,7 +2,6 @@ import commonjs from 'rollup-plugin-commonjs';
 import uglify from 'rollup-plugin-uglify';
 import resolve from 'rollup-plugin-node-resolve';
 import typescript from 'rollup-plugin-typescript2';
-import builtins from 'rollup-plugin-node-builtins';
 
 export default [
   {
@@ -13,14 +12,8 @@ export default [
       exports: 'named',
       interop: false,
     },
-    external: [
-      '@sentry/core',
-      '@sentry/hub',
-      '@sentry/minimal',
-      '@sentry/utils',
-    ],
+    external: ['@sentry/core', '@sentry/hub', '@sentry/minimal'],
     plugins: [
-      builtins(),
       typescript({
         tsconfig: 'tsconfig.build.json',
       }),
@@ -39,12 +32,9 @@ export default [
       format: 'iife',
       name: 'Sentry',
       sourcemap: true,
-      interop: false,
-      extend: true,
     },
     context: 'window',
     plugins: [
-      builtins(),
       typescript({
         tsconfig: 'tsconfig.build.json',
         tsconfigOverride: { compilerOptions: { declaration: false } },

packages/browser/src/backend.ts

@@ -1,7 +1,7 @@
 import { Backend, DSN, Options, SentryError } from '@sentry/core';
 import { addBreadcrumb, captureEvent } from '@sentry/minimal';
 import { SentryEvent } from '@sentry/types';
-import { supportsFetch } from '@sentry/utils';
+import { supportsFetch } from '@sentry/utils/supports';
 import { Raven } from './raven';
 import { FetchTransport, XHRTransport } from './transports';
 

packages/browser/src/integrations/onunhandledrejection.ts

@@ -1,6 +1,6 @@
 import { captureException } from '@sentry/minimal';
 import { Integration } from '@sentry/types';
-import { getGlobalObject } from '@sentry/utils';
+import { getGlobalObject } from '@sentry/utils/misc';
 
 const global: any = getGlobalObject();
 

packages/browser/src/integrations/tracekit.js

@@ -1,4 +1,4 @@
-import { isError, isErrorEvent } from '@sentry/utils/dist/is';
+import { isError, isErrorEvent } from '@sentry/utils/is';
 
 /*
  TraceKit - Cross brower stack traces

packages/browser/src/transports/base.ts

@@ -5,7 +5,7 @@ import {
   Transport,
   TransportOptions,
 } from '@sentry/types';
-import { urlEncode } from '@sentry/utils';
+import { urlEncode } from '@sentry/utils/object';
 
 /** Base Transport class implementation */
 export abstract class BaseTransport implements Transport {

packages/browser/src/transports/fetch.ts

@@ -1,9 +1,7 @@
 import { SentryEvent } from '@sentry/types';
-import {
-  getGlobalObject,
-  serialize,
-  supportsReferrerPolicy,
-} from '@sentry/utils';
+import { getGlobalObject } from '@sentry/utils/misc';
+import { serialize } from '@sentry/utils/object';
+import { supportsReferrerPolicy } from '@sentry/utils/supports';
 import { BaseTransport } from './base';
 
 const global: any = getGlobalObject();

packages/browser/src/transports/xhr.ts

@@ -1,5 +1,5 @@
 import { SentryEvent } from '@sentry/types';
-import { serialize } from '@sentry/utils';
+import { serialize } from '@sentry/utils/object';
 import { BaseTransport } from './base';
 
 /** `XHR` based transport */

packages/core/jest.config.js

@@ -40,5 +40,17 @@
     "fix:tslint": "tslint --fix -t stylish -p .",
     "test": "jest",
     "test:watch": "jest --watch --notify"
+  },
+  "jest": {
+    "collectCoverage": true,
+    "transform": { "^.+\\.ts$": "ts-jest" },
+    "moduleFileExtensions": ["js", "ts"],
+    "testEnvironment": "node",
+    "testMatch": ["**/*.test.ts"],
+    "globals": {
+      "ts-jest": {
+        "tsConfigFile": "./tsconfig.json"
+      }
+    }
   }
 }

packages/core/package.json

@@ -1,6 +1,7 @@
 import { Scope } from '@sentry/hub';
 import { Breadcrumb, SdkInfo, SentryEvent } from '@sentry/types';
-import { truncate, uuid4 } from '@sentry/utils';
+import { uuid4 } from '@sentry/utils/misc';
+import { truncate } from '@sentry/utils/string';
 import { DSN } from './dsn';
 import { Backend, Client, Options } from './interfaces';
 import { SendStatus } from './status';

packages/core/src/base.ts

@@ -6,10 +6,13 @@ import { TEST_SDK, TestClient } from '../mocks/client';
 
 const PUBLIC_DSN = 'https://username@domain/path';
 
-jest.mock('@sentry/utils', () => ({
+jest.mock('@sentry/utils/misc', () => ({
   uuid4(): string {
     return '42';
   },
+}));
+
+jest.mock('@sentry/utils/string', () => ({
   truncate(str: string): string {
     return str;
   },

packages/core/test/lib/base.test.ts

@@ -37,5 +37,17 @@
     "fix:tslint": "tslint --fix -t stylish -p .",
     "test": "jest",
     "test:watch": "jest --watch --notify"
+  },
+  "jest": {
+    "collectCoverage": true,
+    "transform": { "^.+\\.ts$": "ts-jest" },
+    "moduleFileExtensions": ["js", "ts"],
+    "testEnvironment": "node",
+    "testMatch": ["**/*.test.ts"],
+    "globals": {
+      "ts-jest": {
+        "tsConfigFile": "./tsconfig.json"
+      }
+    }
   }
 }

packages/hub/jest.config.js

@@ -38,5 +38,17 @@
     "fix:tslint": "tslint --fix -t stylish -p .",
     "test": "jest",
     "test:watch": "jest --watch --notify"
+  },
+  "jest": {
+    "collectCoverage": true,
+    "transform": { "^.+\\.ts$": "ts-jest" },
+    "moduleFileExtensions": ["js", "ts"],
+    "testEnvironment": "node",
+    "testMatch": ["**/*.test.ts"],
+    "globals": {
+      "ts-jest": {
+        "tsConfigFile": "./tsconfig.json"
+      }
+    }
   }
 }

packages/hub/package.json

@@ -42,5 +42,17 @@
     "fix:tslint": "tslint --fix -t stylish -p .",
     "test": "jest",
     "test:watch": "jest --watch --notify"
+  },
+  "jest": {
+    "collectCoverage": true,
+    "transform": { "^.+\\.ts$": "ts-jest" },
+    "moduleFileExtensions": ["js", "ts"],
+    "testEnvironment": "node",
+    "testMatch": ["**/*.test.ts"],
+    "globals": {
+      "ts-jest": {
+        "tsConfigFile": "./tsconfig.json"
+      }
+    }
   }
 }

packages/minimal/jest.config.js

@@ -1,6 +1,6 @@
 import { addBreadcrumb } from '@sentry/minimal';
 import { Integration, Severity } from '@sentry/types';
-import { fill } from '@sentry/utils';
+import { fill } from '@sentry/utils/object';
 import { format } from 'util';
 
 /**

packages/minimal/package.json

@@ -1,6 +1,6 @@
 import { addBreadcrumb } from '@sentry/minimal';
 import { Integration } from '@sentry/types';
-import { fill } from '@sentry/utils';
+import { fill } from '@sentry/utils/object';
 import { ClientRequest, ClientRequestArgs, ServerResponse } from 'http';
 import { inherits } from 'util';
 import { getDefaultHub } from '../hub';

packages/node/jest.config.js

@@ -4,6 +4,8 @@
     // This rule has side effects and must be disabled
     "no-unused-variable": false,
 
+    "no-submodule-imports": false,
+
     // We don't want these
     "newline-before-return": false,
     "no-any": false,

packages/node/package.json

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

packages/node/src/integrations/console.ts

@@ -1,2 +1,5 @@
 *
-!/dist/**/*
+!*.js.map
+!*.d.ts
+!*.js
+jest.config.js

packages/node/src/integrations/http.ts

@@ -11,4 +11,5 @@
 [![npm dm](https://img.shields.io/npm/dm/@sentry/utils.svg)](https://www.npmjs.com/package/@sentry/utils)
 [![npm dt](https://img.shields.io/npm/dt/@sentry/utils.svg)](https://www.npmjs.com/package/@sentry/utils)
 
-Common utilities used by the Sentry JavaScript SDKs.
+Common utilities used by the Sentry JavaScript SDKs. **Warning, only submodule
+imports are allowed here.**

packages/typescript/tslint.json

@@ -9,8 +9,6 @@
   "engines": {
     "node": ">=6"
   },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +27,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
-    "clean": "rimraf dist coverage",
+    "clean": "rimraf dist coverage *.js *.js.map *.d.ts",
     "lint": "run-s lint:prettier lint:tslint",
     "lint:prettier": "prettier-check '{src,test}/**/*.ts'",
     "lint:tslint": "tslint -t stylish -p .",
@@ -38,5 +36,17 @@
     "fix:tslint": "tslint --fix -t stylish -p .",
     "test": "jest",
     "test:watch": "jest --watch --notify"
+  },
+  "jest": {
+    "collectCoverage": true,
+    "transform": { "^.+\\.ts$": "ts-jest" },
+    "moduleFileExtensions": ["js", "ts"],
+    "testEnvironment": "node",
+    "testMatch": ["**/*.test.ts"],
+    "globals": {
+      "ts-jest": {
+        "tsConfigFile": "./tsconfig.json"
+      }
+    }
   }
 }

packages/utils/.gitignore

@@ -1,14 +1,2 @@
-export { forget, filterAsync } from './async';
-export { mkdirp, mkdirpSync } from './fs';
-export { clone, deserialize, fill, serialize, urlEncode } from './object';
-export { Store } from './store';
-export { isError, isErrorEvent, isDOMError, isDOMException } from './is';
-export { truncate } from './string';
-export {
-  supportsDOMError,
-  supportsDOMException,
-  supportsErrorEvent,
-  supportsFetch,
-  supportsReferrerPolicy,
-} from './supports';
-export { getGlobalObject, uuid4 } from './misc';
+// We do not export anything by default since we always want to deep import
+// like: import { getGlobalObject } from '@sentry/utils/misc';

packages/utils/.npmignore

@@ -137,7 +137,9 @@ export function fill(
 ): void {
   const orig = source[name];
   source[name] = replacement(orig);
+  // tslint:disable-next-line:no-unsafe-any
   source[name].__raven__ = true;
+  // tslint:disable-next-line:no-unsafe-any
   source[name].__orig__ = orig;
   if (track) {
     track.push([source, name, orig]);
@@ -152,6 +154,9 @@ export function fill(
  */
 export function urlEncode(object: { [key: string]: any }): string {
   return Object.keys(object)
-    .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(object[key])}`)
+    .map(
+      // tslint:disable-next-line:no-unsafe-any
+      key => `${encodeURIComponent(key)}=${encodeURIComponent(object[key])}`,
+    )
     .join('&');
 }

packages/utils/README.md

@@ -1,4 +1,4 @@
-import { filterAsync, forget } from '../src';
+import { filterAsync, forget } from '../src/async';
 
 describe('forget', () => {
   const console = {

packages/utils/jest.config.js

@@ -1,12 +1,9 @@
+import { isDOMError, isDOMException, isError, isErrorEvent } from '../src/is';
 import {
-  isDOMError,
-  isDOMException,
-  isError,
-  isErrorEvent,
   supportsDOMError,
   supportsDOMException,
   supportsErrorEvent,
-} from '../src';
+} from '../src/supports';
 
 class SentryError extends Error {
   public name: string;