@datadog/esbuild-plugin 0.0.13-4 → 0.0.13-5

package/README.md

@@ -1 +1,38 @@
-# esbuild-plugin
+# Datadog ESBuild Plugin
+
+A ESBuild plugin to interact with Datadog from your ESBuild builds.
+
+## Installation
+
+-   Yarn
+
+```bash
+yarn add -D @datadog/esbuild-plugin
+```
+
+-   NPM
+
+```bash
+npm install --save-dev @datadog/esbuild-plugin
+```
+
+## Usage
+
+```js
+const { datadogEsbuildPlugin } = require('@datadog/esbuild-plugin');
+
+require('esbuild').build({
+    plugins: [
+        datadogEsbuildPlugin({
+            // Configuration
+        }),
+    ],
+});
+```
+
+> [!TIP]
+> It is important to have the plugin in the first position in order to report every other plugins.
+
+## Configuration
+
+Check the main [README](../../README.md#configuration) for the common configuration options.

package/dist/src/index.d.ts

@@ -1,28 +1,23 @@
 import * as esbuild from 'esbuild';
 
+type LogLevel = 'debug' | 'warn' | 'error' | 'none';
 interface GetPluginsOptions {
-    auth: {
-        apiKey: string;
+    auth?: {
+        apiKey?: string;
+        endPoint?: string;
     };
+    logLevel?: LogLevel;
 }
+
+declare const CONFIG_KEY: "telemetry";
+
 interface Metric {
     metric: string;
     type: 'count' | 'size' | 'duration';
     value: number;
     tags: string[];
 }
-
-declare const CONFIG_KEY: "telemetry";
-
 type Filter = (metric: Metric) => Metric | null;
-interface DatadogOptions {
-    apiKey?: string;
-    endPoint?: string;
-    prefix?: string;
-    tags?: string[];
-    timestamp?: number;
-    filters?: Filter[];
-}
 type OutputOptions = boolean | string | {
     destination: string;
     timings?: boolean;
@@ -33,15 +28,22 @@ type OutputOptions = boolean | string | {
 type TelemetryOptions = {
     disabled?: boolean;
     output?: OutputOptions;
-    hooks?: string[];
-    datadog?: DatadogOptions;
+    prefix?: string;
+    tags?: string[];
+    timestamp?: number;
+    filters?: Filter[];
 };
 
 interface Options extends GetPluginsOptions {
     [CONFIG_KEY]?: TelemetryOptions;
 }
+declare const helpers: {
+    telemetry: {
+        filters: ((metric: Metric) => Metric | null)[];
+    };
+};
 
 declare const datadogEsbuildPlugin: (options: Options) => esbuild.Plugin;
 
-export { type Options as EsbuildPluginOptions, datadogEsbuildPlugin };
+export { type Options as EsbuildPluginOptions, datadogEsbuildPlugin, helpers };
 //# sourceMappingURL=index.d.ts.map