[feat] Add synthetics plugin

.github/CODEOWNERS

@@ -29,3 +29,6 @@ packages/plugins/analytics                                            @yoannmoin
 
 # Custom Hooks
 packages/plugins/custom-hooks                                         @yoannmoinet
+
+# Synthetics
+packages/plugins/synthetics                                           @yoannmoinet @etnbrd

README.md

@@ -29,6 +29,7 @@ To interact with Datadog directly from your builds.
     -   [`customPlugins`](#customplugins)
 -   [Features](#features)
     -   [Error Tracking](#error-tracking-----)
+    -   [Synthetics](#synthetics-----)
     -   [Telemetry](#telemetry-----)
 -   [Contributing](#contributing)
 -   [License](#license)
@@ -103,6 +104,9 @@ Follow the specific documentation for each bundler:
             service: string;
         };
     };
+    synthetics?: {
+        disabled?: boolean;
+    };
     telemetry?: {
         disabled?: boolean;
         enableTracing?: boolean;
@@ -246,6 +250,26 @@ datadogWebpackPlugin({
 
 </details>
 
+### Synthetics <img src="packages/assets/src/esbuild.svg" alt="ESBuild" width="17" /> <img src="packages/assets/src/rollup.svg" alt="Rollup" width="17" /> <img src="packages/assets/src/rspack.svg" alt="Rspack" width="17" /> <img src="packages/assets/src/vite.svg" alt="Vite" width="17" /> <img src="packages/assets/src/webpack.svg" alt="Webpack" width="17" />
+
+> Interact with Synthetics at build time.
+
+#### [📝 Full documentation ➡️](/packages/plugins/synthetics#readme)
+
+<details>
+
+<summary>Configuration</summary>
+
+```typescript
+datadogWebpackPlugin({
+    synthetics?: {
+        disabled?: boolean,
+    }
+});
+```
+
+</details>
+
 ### Telemetry <img src="packages/assets/src/esbuild.svg" alt="ESBuild" width="17" /> <img src="packages/assets/src/rollup.svg" alt="Rollup" width="17" /> <img src="packages/assets/src/rspack.svg" alt="Rspack" width="17" /> <img src="packages/assets/src/vite.svg" alt="Vite" width="17" /> <img src="packages/assets/src/webpack.svg" alt="Webpack" width="17" />
 
 > Display and send telemetry data as metrics to Datadog.

global.d.ts

@@ -19,6 +19,16 @@ declare global {
              * For instance, we only submit logs to Datadog when the environment is `production`.
              */
             BUILD_PLUGINS_ENV?: Env;
+            /**
+             * The port of the dev server of our synthetics plugin.
+             *
+             * This is only used by datadog-ci, in its build'n test workflow,
+             * using the customer's build command, if it includes our plugin,
+             * will launch a dev-server over the outdir of the build so datadog-ci
+             * can trigger a tunnel and a test batch over the branch's code.
+             *
+             */
+            BUILD_PLUGINS_S8S_PORT?: string;
             /**
              * Defined in github actions when running in CI.
              */

packages/core/src/types.ts

@@ -13,6 +13,8 @@ import type { ErrorTrackingOptions } from '@dd/error-tracking-plugin/types';
 import type * as errorTracking from '@dd/error-tracking-plugin';
 import type { RumOptions } from '@dd/rum-plugin/types';
 import type * as rum from '@dd/rum-plugin';
+import type { SyntheticsOptions } from '@dd/synthetics-plugin/types';
+import type * as synthetics from '@dd/synthetics-plugin';
 import type { TelemetryOptions } from '@dd/telemetry-plugin/types';
 import type * as telemetry from '@dd/telemetry-plugin';
 // #imports-injection-marker
@@ -22,8 +24,11 @@ import type { UnpluginOptions } from 'unplugin';
 
 import type { ALL_ENVS, FULL_NAME_BUNDLERS, SUPPORTED_BUNDLERS } from './constants';
 
+// Re-assign B into A.
 export type Assign<A, B> = Omit<A, keyof B> & B;
-export type WithRequired<T, K extends keyof T> = T & { [P in K]-?: T[P] };
+// Type object with specified keys required.
+export type Ensure<T, K extends keyof T> = Assign<T, Required<Pick<T, K>>>;
+// Target one item from an iterable.
 export type IterableElement<IterableType extends Iterable<unknown>> =
     IterableType extends Iterable<infer ElementType> ? ElementType : never;
 
@@ -197,6 +202,7 @@ export interface Options extends BaseOptions {
     // #types-injection-marker
     [errorTracking.CONFIG_KEY]?: ErrorTrackingOptions;
     [rum.CONFIG_KEY]?: RumOptions;
+    [synthetics.CONFIG_KEY]?: SyntheticsOptions;
     [telemetry.CONFIG_KEY]?: TelemetryOptions;
     // #types-injection-marker
     customPlugins?: GetCustomPlugins;

packages/factory/package.json

@@ -25,6 +25,7 @@
         "@dd/internal-git-plugin": "workspace:*",
         "@dd/internal-injection-plugin": "workspace:*",
         "@dd/rum-plugin": "workspace:*",
+        "@dd/synthetics-plugin": "workspace:*",
         "@dd/telemetry-plugin": "workspace:*",
         "chalk": "2.3.1",
         "unplugin": "1.16.0"

packages/factory/src/index.ts

@@ -28,6 +28,7 @@ import { getContext, validateOptions } from './helpers';
 // #imports-injection-marker
 import * as errorTracking from '@dd/error-tracking-plugin';
 import * as rum from '@dd/rum-plugin';
+import * as synthetics from '@dd/synthetics-plugin';
 import * as telemetry from '@dd/telemetry-plugin';
 import { getAnalyticsPlugins } from '@dd/internal-analytics-plugin';
 import { getBuildReportPlugins } from '@dd/internal-build-report-plugin';
@@ -39,6 +40,7 @@ import { getInjectionPlugins } from '@dd/internal-injection-plugin';
 // #types-export-injection-marker
 export type { types as ErrorTrackingTypes } from '@dd/error-tracking-plugin';
 export type { types as RumTypes } from '@dd/rum-plugin';
+export type { types as SyntheticsTypes } from '@dd/synthetics-plugin';
 export type { types as TelemetryTypes } from '@dd/telemetry-plugin';
 // #types-export-injection-marker
 
@@ -102,6 +104,7 @@ export const buildPluginFactory = ({
             // #configs-injection-marker
             errorTracking,
             rum,
+            synthetics,
             telemetry,
             // #configs-injection-marker
         ];

packages/plugins/synthetics/README.md

@@ -0,0 +1,21 @@
+# Synthetics Plugin <!-- #omit in toc -->
+
+Interact with Synthetics at build time.
+
+<!-- The title and the following line will both be added to the root README.md  -->
+
+## Table of content <!-- #omit in toc -->
+
+<!-- This is auto generated with yarn cli integrity -->
+
+<!-- #toc -->
+-   [Configuration](#configuration)
+<!-- #toc -->
+
+## Configuration
+
+```ts
+synthetics?: {
+    disabled?: boolean;
+}
+```

packages/plugins/synthetics/package.json

@@ -0,0 +1,26 @@
+{
+    "name": "@dd/synthetics-plugin",
+    "packageManager": "yarn@4.0.2",
+    "license": "MIT",
+    "private": true,
+    "author": "Datadog",
+    "description": "Interact with Synthetics at build time.",
+    "homepage": "https://github.com/DataDog/build-plugins/tree/main/packages/plugins/synthetics#readme",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/DataDog/build-plugins",
+        "directory": "packages/plugins/synthetics"
+    },
+    "exports": {
+        ".": "./src/index.ts",
+        "./*": "./src/*.ts"
+    },
+    "scripts": {
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@dd/core": "workspace:*",
+        "@dd/error-tracking-plugin": "workspace:*",
+        "chalk": "2.3.1"
+    }
+}

packages/plugins/synthetics/src/constants.ts

@@ -0,0 +1,11 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the MIT License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+import type { PluginName } from '@dd/core/types';
+
+export const CONFIG_KEY = 'synthetics' as const;
+export const PLUGIN_NAME: PluginName = 'datadog-synthetics-plugin' as const;
+
+export const API_PREFIX = '_datadog-ci_' as const;
+export const DEFAULT_PORT = 1234 as const;