feat(google-cloud): Add @sentry/google-cloud package (#10993)

in the first step to our serverless changes, introduce a
`@sentry/google-cloud` package that contains all google cloud functions
related functionality.

No migration guide yet, will write that after I merge this in and open a
PR for the aws changes.

Author: AbhiPrasad

.craft.yml

@@ -91,6 +91,9 @@ targets:
   - name: npm
     id: '@sentry/serverless'
     includeNames: /^sentry-serverless-\d.*\.tgz$/
+  - name: npm
+    id: '@sentry/google-cloud'
+    includeNames: /^sentry-google-cloud-\d.*\.tgz$/
   - name: npm
     id: '@sentry/bun'
     includeNames: /^sentry-bun-\d.*\.tgz$/

.github/ISSUE_TEMPLATE/bug.yml

@@ -43,6 +43,7 @@ body:
         - '@sentry/react'
         - '@sentry/remix'
         - '@sentry/serverless'
+        - '@sentry/google-cloud'
         - '@sentry/svelte'
         - '@sentry/sveltekit'
         - '@sentry/vue'

dev-packages/e2e-tests/test-applications/node-exports-test-app/package.json

@@ -19,6 +19,7 @@
     "@sentry/astro": "latest || *",
     "@sentry/nextjs": "latest || *",
     "@sentry/serverless": "latest || *",
+    "@sentry/google-cloud": "latest || *",
     "@sentry/bun": "latest || *",
     "@sentry/types": "latest || *",
     "@types/node": "18.15.1",

dev-packages/e2e-tests/test-applications/node-exports-test-app/scripts/consistentExports.ts

@@ -1,5 +1,6 @@
 import * as SentryAstro from '@sentry/astro';
 import * as SentryBun from '@sentry/bun';
+import * as SentryGoogleCloud from '@sentry/google-cloud';
 import * as SentryNextJs from '@sentry/nextjs';
 import * as SentryNode from '@sentry/node';
 import * as SentryNodeExperimental from '@sentry/node-experimental';
@@ -81,6 +82,12 @@ const DEPENDENTS: Dependent[] = [
     exports: Object.keys(SentryServerless),
     ignoreExports: ['cron', 'hapiErrorPlugin'],
   },
+  {
+    package: '@sentry/google-cloud',
+    compareWith: nodeExports,
+    exports: Object.keys(SentryGoogleCloud),
+    ignoreExports: ['makeMain'],
+  },
   {
     package: '@sentry/sveltekit',
     compareWith: nodeExperimentalExports,

dev-packages/e2e-tests/verdaccio-config/config.yaml

@@ -140,6 +140,12 @@ packages:
     unpublish: $all
     # proxy: npmjs # Don't proxy for E2E tests!
 
+  '@sentry/google-cloud':
+    access: $all
+    publish: $all
+    unpublish: $all
+    # proxy: npmjs # Don't proxy for E2E tests!
+
   '@sentry/svelte':
     access: $all
     publish: $all

package.json

@@ -33,7 +33,7 @@
     "postpublish": "lerna run --stream --concurrency 1 postpublish",
     "test": "lerna run --ignore \"@sentry-internal/{browser-integration-tests,e2e-tests,integration-shims,node-integration-tests,overhead-metrics}\" test",
     "test:unit": "lerna run --ignore \"@sentry-internal/{browser-integration-tests,e2e-tests,integration-shims,node-integration-tests,overhead-metrics}\" test:unit",
-    "test-ci-browser": "lerna run test --ignore \"@sentry/{bun,deno,node,node-experimental,profiling-node,serverless,nextjs,remix,gatsby,sveltekit,vercel-edge}\" --ignore \"@sentry-internal/{browser-integration-tests,e2e-tests,integration-shims,node-integration-tests,overhead-metrics}\"",
+    "test-ci-browser": "lerna run test --ignore \"@sentry/{bun,deno,node,node-experimental,profiling-node,serverless,google-cloud,nextjs,remix,gatsby,sveltekit,vercel-edge}\" --ignore \"@sentry-internal/{browser-integration-tests,e2e-tests,integration-shims,node-integration-tests,overhead-metrics}\"",
     "test-ci-node": "ts-node ./scripts/node-unit-tests.ts",
     "test-ci-bun": "lerna run test --scope @sentry/bun",
     "test:update-snapshots": "lerna run test:update-snapshots",
@@ -56,6 +56,7 @@
     "packages/eslint-plugin-sdk",
     "packages/feedback",
     "packages/gatsby",
+    "packages/google-cloud",
     "packages/integration-shims",
     "packages/nextjs",
     "packages/node",

packages/google-cloud/.eslintrc.js

@@ -0,0 +1,23 @@
+module.exports = {
+  env: {
+    node: true,
+  },
+  extends: ['../../.eslintrc.js'],
+  rules: {
+    '@sentry-internal/sdk/no-optional-chaining': 'off',
+  },
+  overrides: [
+    {
+      files: ['scripts/**/*.ts'],
+      parserOptions: {
+        project: ['../../tsconfig.dev.json'],
+      },
+    },
+    {
+      files: ['test/**'],
+      parserOptions: {
+        sourceType: 'module',
+      },
+    },
+  ],
+};

packages/google-cloud/LICENSE

@@ -0,0 +1,14 @@
+Copyright (c) 2024 Sentry (https://sentry.io) and individual contributors. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

packages/google-cloud/README.md

@@ -0,0 +1,47 @@
+<p align="center">
+  <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
+    <img src="https://sentry-brand.storage.googleapis.com/sentry-wordmark-dark-280x84.png" alt="Sentry" width="280" height="84">
+  </a>
+</p>
+
+# Official Sentry SDK for Google Cloud Functions
+
+## Links
+
+- [Official SDK Docs](https://docs.sentry.io/)
+- [TypeDoc](http://getsentry.github.io/sentry-javascript/)
+
+## General
+
+This package is a wrapper around `@sentry/node`, with added functionality related to various Serverless solutions. All
+methods available in `@sentry/node` can be imported from `@sentry/google-cloud`.
+
+To use this SDK, call `Sentry.init(options)` at the very beginning of your JavaScript file.
+
+```javascript
+import * as Sentry from '@sentry/google-cloud';
+
+Sentry.init({
+  dsn: '__DSN__',
+  tracesSampleRate: 1.0,
+  // ...
+});
+
+// For HTTP Functions:
+
+exports.helloHttp = Sentry.wrapHttpFunction((req, res) => {
+  throw new Error('oh, hello there!');
+});
+
+// For Background Functions:
+
+exports.helloEvents = Sentry.wrapEventFunction((data, context, callback) => {
+  throw new Error('oh, hello there!');
+});
+
+// For CloudEvents:
+
+exports.helloEvents = Sentry.wrapCloudEventFunction((context, callback) => {
+  throw new Error('oh, hello there!');
+});
+```

packages/google-cloud/jest.config.js

@@ -0,0 +1 @@
+module.exports = require('../../jest/jest.config.js');