@datadog/esbuild-plugin 0.0.13-0 → 0.0.13-10

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,10 +1,16 @@
 import * as esbuild from 'esbuild';
+import * as src from 'src';
 
+type LogLevel = 'debug' | 'warn' | 'error' | 'none';
 interface GetPluginsOptions {
-    auth: {
-        apiKey: string;
-        appKey: string;
+    auth?: {
+        apiKey?: string;
+        endPoint?: string;
     };
+    logLevel?: LogLevel;
+}
+interface GetPluginsOptionsWithCWD extends GetPluginsOptions {
+    cwd: string;
 }
 
 declare const CONFIG_KEY: "telemetry";
@@ -16,33 +22,45 @@ interface Metric {
     tags: string[];
 }
 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;
     dependencies?: boolean;
     bundler?: boolean;
     metrics?: boolean;
+    logs?: boolean;
 };
 type TelemetryOptions = {
     disabled?: boolean;
     output?: OutputOptions;
-    hooks?: string[];
-    datadog?: DatadogOptions;
+    prefix?: string;
+    tags?: string[];
+    timestamp?: number;
+    filters?: Filter[];
+};
+interface TelemetryOptionsEnabled extends TelemetryOptions {
+    disabled?: false;
+}
+interface OptionsWithTelemetryEnabled extends GetPluginsOptionsWithCWD {
+    [CONFIG_KEY]: TelemetryOptionsEnabled;
+}
+
+type types = {
+    Metric: Metric;
+    TelemetryOptions: TelemetryOptions;
+    OptionsWithTelemetryEnabled: OptionsWithTelemetryEnabled;
 };
 
 interface Options extends GetPluginsOptions {
     [CONFIG_KEY]?: TelemetryOptions;
 }
+declare const helpers: {
+    telemetry: {
+        filters: ((metric: Metric) => Metric | null)[];
+    };
+};
 
-declare const datadogEsbuildPlugin: (options: Options) => esbuild.Plugin;
+declare const datadogEsbuildPlugin: (options: src.EsbuildPluginOptions) => esbuild.Plugin;
 
-export { datadogEsbuildPlugin, datadogEsbuildPlugin as default };
+export { type Options as EsbuildPluginOptions, type types as TelemetryTypes, datadogEsbuildPlugin, helpers };
 //# sourceMappingURL=index.d.ts.map