@mrgrain/cdk-esbuild 3.9.0 → 3.11.1

package/.jsii

@@ -2777,7 +2777,7 @@
     "stability": "stable"
   },
   "homepage": "https://github.com/mrgrain/cdk-esbuild",
-  "jsiiVersion": "1.64.0 (build 4c1eae8)",
+  "jsiiVersion": "1.65.0 (build 7a02b7f)",
   "keywords": [
     "aws-cdk",
     "bundler",
@@ -2800,7 +2800,7 @@
   },
   "name": "@mrgrain/cdk-esbuild",
   "readme": {
-    "markdown": "<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"./images/wordmark-dark.svg\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"./images/wordmark-light.svg\">\n  <img src=\"./images/wordmark.svg\" alt=\"cdk-esbuild\">\n</picture>\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started) |\n[Documentation](#documentation) | [API Reference](#api-reference) | [Upgrading from AWS CDK v1](#upgrading-from-aws-cdk-v1)\n\n[![View on Construct Hub](https://constructs.dev/badge?package=%40mrgrain%2Fcdk-esbuild)](https://constructs.dev/packages/@mrgrain/cdk-esbuild)\n\n## Why?\n\n_esbuild_ is an extremely fast bundler and minifier for Typescript and JavaScript.\nThis package makes _esbuild_ available to deploy lambda functions, static websites or to publish build artefacts (assets) for further use.\n\nAWS CDK [supports _esbuild_ with Lambda Functions](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-lambda-nodejs-readme.html). However the implementation cannot be used with any other Constructs and doesn't expose all of _esbuild_'s build interface.\n\nThis package is running _esbuild_ directly in Node.js and bypasses Docker which the AWS CDK implementation uses. The approach is quicker and easier to use for Node.js users, but incompatible with other languages.\n\n**Production readiness**\n\nThis package is stable and ready to be used in production, as many do. However _esbuild_ has not yet released a version 1.0.0 and its API is still in active development. Please read the guide on [esbuild's production readiness](https://esbuild.github.io/faq/#production-readiness).\n\nNotably upgrades of the _esbuild_ minimum version requirement will be introduced in **minor versions** of this package and will inherit breaking changes from _esbuild_.\n\n## Getting started\n\nInstall `cdk-esbuild`:\n\n```\nnpm install @mrgrain/cdk-esbuild@3\n```\n\nIf _peer_ or _optional dependencies_ are not installed automatically (e.g. when using npm v4-6), please use this command to install all of them:\n\n```\nnpm install @mrgrain/cdk-esbuild@3 esbuild\n```\n\n### AWS Lambda: Serverless function\n\n> 💡 See [Lambda Function](examples/lambda) for a complete working example of a how to deploy a lambda function.\n\nUse `TypeScriptCode` as the `code` of a [lambda function](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#code):\n\n```ts\nimport * as lambda from \"aws-cdk-lib/aws-lambda\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\");\n\nconst fn = new lambda.Function(stack, \"MyFunction\", {\n  runtime: lambda.Runtime.NODEJS_16_X,\n  handler: \"index.handler\",\n  code: bundledCode,\n});\n```\n\n### AWS S3: Static Website\n\n> 💡 See [Static Website with React](examples/website) for a complete working example of a how to deploy a React app to S3.\n\nUse `TypeScriptSource` as one of the `sources` of a [static website deployment](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html#roadmap):\n\n```ts\nimport * as s3 from \"aws-cdk-lib/aws-s3\";\nimport * as s3deploy from \"aws-cdk-lib/aws-s3-deployment\";\nimport { TypeScriptSource } from \"@mrgrain/cdk-esbuild\";\n\nconst websiteBundle = new TypeScriptSource(\"src/index.tsx\");\n\nconst websiteBucket = new s3.Bucket(stack, \"WebsiteBucket\", {\n  autoDeleteObjects: true,\n  publicReadAccess: true,\n  removalPolicy: RemovalPolicy.DESTROY,\n  websiteIndexDocument: \"index.html\",\n});\n\nnew s3deploy.BucketDeployment(stack, \"DeployWebsite\", {\n  destinationBucket: websiteBucket,\n  sources: [websiteBundle],\n});\n```\n\n### Amazon CloudWatch Synthetics: Canary monitoring\n\n> 💡 See [Monitored Website](examples/website) for a complete working example of a deployed and monitored website.\n\nSynthetics runs a canary to produce traffic to an application for monitoring purposes. Use `TypeScriptCode` as the `code` of a Canary test:\n\n> ℹ️ This feature depends on the `@aws-cdk/aws-synthetics-alpha` package which is a developer preview. You may need to update your source code when upgrading to a newer version of this package.\n>\n> ```\n> npm i @aws-cdk/aws-synthetics-alpha\n> ```\n\n```ts\nimport * as synthetics from \"@aws-cdk/aws-synthetics-alpha\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\", {\n  buildOptions: {\n    outdir: \"nodejs/node_modules\", // This is required by Synthetics\n  },\n});\n\nconst canary = new synthetics.Canary(stack, \"MyCanary\", {\n  runtime: synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_3_2,\n  test: synthetics.Test.custom({\n    code: bundledCode,\n    handler: \"index.handler\",\n  });\n});\n```\n\n## Documentation\n\nThe package exports various different constructs for use with existing CDK features. A major guiding design principal for this package is to _extend, don't replace_. Expect constructs that you can provide as props, not complete replacements.\n\nFor use in **Lambda Functions** and **Synthetic Canaries**, the following classes implement `lambda.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-synthetics-alpha.Code.html)):\n\n- `TypeScriptCode` & `JavaScriptCode`\n\nInline code is only supported by **Lambda**:\n\n- `InlineTypeScriptCode` & `InlineJavaScriptCode`\n- `InlineTsxCode` & `InlineJsxCode`\n\nFor use with **S3 bucket deployments**, classes implementing `s3deploy.ISource` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html)):\n\n- `TypeScriptSource` & `JavaScriptSource`\n\n> _Code and Source constructs seamlessly plug-in to other high-level CDK constructs. They share the same set of parameters, props and build options._\n\nThe following classes power the other features. You normally won't have to use them, but they are there if you need them:\n\n- `TypeScriptAsset` & `JavaScriptAsset` implements `s3.Asset` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3_assets.Asset.html)) \\\n  creates an asset uploaded to S3 which can be referenced by other constructs\n\n- `EsbuildBundler` implements `core.BundlingOptions` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.BundlingOptions.html)) \\\n  provides an interface for a _esbuild_ bundler wherever needed\n\n### [API Reference](API.md)\n\nAuto-generated reference for classes and structs. This information is also available as part of your IDE's code completion.\n\n### Escape hatches\n\nIt's possible that you want to use an implementation of esbuild that's different to the default one. Common reasons are:\n\n- The current version constraints for esbuild are not suitable\n- To use a version of esbuild that is installed by any other means than `npm`, including Docker\n- Plugin support is needed for building\n\nFor these situations, this package offers an escape hatch to bypass regular the implementation and provide a custom build and transform function.\n\n#### Esbuild binary path\n\nIt is possible to override the binary used by esbuild. The usual way to do this is to set the `ESBUILD_BINARY_PATH` environment variable. For convenience this package allows to set the binary path as a prop:\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  esbuildBinaryPath: \"path/to/esbuild/binary\"\n});\n```\n\n#### Custom build function\n\n> 💡 See [Using esbuild with plugins](examples/esbuild-with-plugins) for a complete working example of a custom build function using this escape hatch.\n\nConstructs that result in starting a build, take a `buildFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `buildSync` function.\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  buildFn: (options: BuildOptions): BuildResult => {\n    try {\n      // custom implementation returning BuildResult\n    } catch (error) {\n      // throw BuildFailure exception here\n    }\n  },\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated build options. The custom build function can amend, change or discard any of these. However integration with CDK relies heavily on the values `outdir`/`outfile` are set to and it's usually required to use them unchanged.\n\nFailures have to cause a `BuildFailure` exception in order to be fully handled.\n\n#### Custom transform function\n\nConstructs that result in starting a transformation, take a `transformFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `transformSync` function.\n\n```ts\nnew InlineTypeScriptCode(\"let x: number = 1\", {\n  transformFn: (options: TransformOptions): TransformResult => {\n    try {\n      // custom implementation returning TransformResult\n    } catch (error) {\n      // throw TransformFailure exception here\n    }\n  },,\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated transform options. The custom transform function can amend, change or discard any of these.\n\nFailures have to cause a `TransformFailure` exception in order to be fully handled.\n\n### Upgrading from AWS CDK v1\n\nThis version is compatible with AWS CDK v2. For the previous, AWS CDK v1 compatible release, see [cdk-esbuild@v2](https://github.com/mrgrain/cdk-esbuild/tree/v2).\n\nTo upgrade from AWS CDK v1 and cdk-esbuild@v2, please follow these steps:\n\n- This version requires AWS CDK v2. Follow the [official migration guide](https://docs.aws.amazon.com/cdk/latest/guide/work-with-cdk-v2.html) to upgrade.\n- Update the package dependency to v3: `npm install --save @mrgrain/cdk-esbuild@^3.0.0`\n- `esbuild` is installed as an optional dependency. If your setup does not automatically install optional dependencies, make sure to add it as an explicit dependency.\n- Any use of `InlineCode` variations has to be updated. Previously the second parameter was either of type `TransformerProps` or `TransformOptions`. Now it must be `TransformerProps`.\\\n  If the passed value is of type `TransformOptions`, turn it into the correct type like this:\n\n  ```ts\n  const oldOptions: TransformOptions = {...}\n\n  new InlineTypeScriptCode('// inline code', {\n    transformOptions: oldOptions\n  });\n  ```\n\n## Versioning\n\nThis package follows [Semantic Versioning](https://semver.org/), with the exception of upgrades to `esbuild`. These will be released as **minor versions** and often include breaking changes from `esbuild`.\n\n### Npm Tags\n\nSome users prefer to use tags over version ranges. The following stable tags are available for use:\n\n- `cdk-v1`, `cdk-v2` are provided for the latest release compatible with each version of the AWS CDK.\n\n- `latest` is the most recent stable release.\n\nThese tags also exist, but usage is strongly not recommended:\n\n- `unstable`, `next` are used for pre-release of the current and next major version respectively.\n\n- ~~`cdk-1.x.x`~~ tags have been deprecated in favour of `cdk-v1`. Use that one instead.\n\n## Roadmap & Contributions\n\n[The project's roadmap is available on GitHub.](https://github.com/mrgrain/cdk-esbuild/projects/1) Please submit any feature requests as issues to the repository.\n\nAll contributions are welcome, no matter if they are for already planned or completely new features.\n\n## Library authors\n\nBuilding a library consumed by other packages that relies on `cdk-esbuild` might require you to set `buildOptions.absWorkingDir`. The easiest way to do this, is to resolve based on the directory name of the calling file, and traverse the tree upwards to the root of your library package (that's where `package.json` and `tsconfig.json` are):\n\n```ts\n// file: project/src/index.ts\nconst props = {\n  buildOptions: {\n    absWorkingDir: path.resolve(__dirname, \"..\"), // now: /user/project\n  },\n};\n```\n\nThis will dynamically resolve to the correct path, wherever the package is installed.\n\nPlease open an issue if you encounter any difficulties.\n"
+    "markdown": "<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/wordmark-dark.svg\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/wordmark-light.svg\">\n  <img src=\"https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/wordmark-dynamic.svg\" alt=\"cdk-esbuild\">\n</picture>\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started) |\n[Documentation](#documentation) | [API Reference](#api-reference) | [Upgrading from AWS CDK v1](#upgrading-from-aws-cdk-v1)\n\n[![View on Construct Hub](https://constructs.dev/badge?package=%40mrgrain%2Fcdk-esbuild)](https://constructs.dev/packages/@mrgrain/cdk-esbuild)\n\n## Why?\n\n_esbuild_ is an extremely fast bundler and minifier for Typescript and JavaScript.\nThis package makes _esbuild_ available to deploy lambda functions, static websites or to publish build artefacts (assets) for further use.\n\nAWS CDK [supports _esbuild_ with Lambda Functions](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-lambda-nodejs-readme.html). However the implementation cannot be used with any other Constructs and doesn't expose all of _esbuild_'s build interface.\n\nThis package is running _esbuild_ directly in Node.js and bypasses Docker which the AWS CDK implementation uses. The approach is quicker and easier to use for Node.js users, but incompatible with other languages.\n\n**Production readiness**\n\nThis package is stable and ready to be used in production, as many do. However _esbuild_ has not yet released a version 1.0.0 and its API is still in active development. Please read the guide on [esbuild's production readiness](https://esbuild.github.io/faq/#production-readiness).\n\nNotably upgrades of the _esbuild_ minimum version requirement will be introduced in **minor versions** of this package and will inherit breaking changes from _esbuild_.\n\n## Getting started\n\nInstall `cdk-esbuild`:\n\n```\nnpm install @mrgrain/cdk-esbuild@3\n```\n\nIf _peer_ or _optional dependencies_ are not installed automatically (e.g. when using npm v4-6), please use this command to install all of them:\n\n```\nnpm install @mrgrain/cdk-esbuild@3 esbuild\n```\n\n### AWS Lambda: Serverless function\n\n> 💡 See [Lambda Function](examples/typescript/lambda) for a complete working example of a how to deploy a lambda function.\n\nUse `TypeScriptCode` as the `code` of a [lambda function](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#code):\n\n```ts\nimport * as lambda from \"aws-cdk-lib/aws-lambda\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\");\n\nconst fn = new lambda.Function(stack, \"MyFunction\", {\n  runtime: lambda.Runtime.NODEJS_16_X,\n  handler: \"index.handler\",\n  code: bundledCode,\n});\n```\n\n### AWS S3: Static Website\n\n> 💡 See [Static Website with React](examples/typescript/website) for a complete working example of a how to deploy a React app to S3.\n\nUse `TypeScriptSource` as one of the `sources` of a [static website deployment](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html#roadmap):\n\n```ts\nimport * as s3 from \"aws-cdk-lib/aws-s3\";\nimport * as s3deploy from \"aws-cdk-lib/aws-s3-deployment\";\nimport { TypeScriptSource } from \"@mrgrain/cdk-esbuild\";\n\nconst websiteBundle = new TypeScriptSource(\"src/index.tsx\");\n\nconst websiteBucket = new s3.Bucket(stack, \"WebsiteBucket\", {\n  autoDeleteObjects: true,\n  publicReadAccess: true,\n  removalPolicy: RemovalPolicy.DESTROY,\n  websiteIndexDocument: \"index.html\",\n});\n\nnew s3deploy.BucketDeployment(stack, \"DeployWebsite\", {\n  destinationBucket: websiteBucket,\n  sources: [websiteBundle],\n});\n```\n\n### Amazon CloudWatch Synthetics: Canary monitoring\n\n> 💡 See [Monitored Website](examples/typescript/website) for a complete working example of a deployed and monitored website.\n\nSynthetics runs a canary to produce traffic to an application for monitoring purposes. Use `TypeScriptCode` as the `code` of a Canary test:\n\n> ℹ️ This feature depends on the `@aws-cdk/aws-synthetics-alpha` package which is a developer preview. You may need to update your source code when upgrading to a newer version of this package.\n>\n> ```\n> npm i @aws-cdk/aws-synthetics-alpha\n> ```\n\n```ts\nimport * as synthetics from \"@aws-cdk/aws-synthetics-alpha\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\", {\n  buildOptions: {\n    outdir: \"nodejs/node_modules\", // This is required by Synthetics\n  },\n});\n\nconst canary = new synthetics.Canary(stack, \"MyCanary\", {\n  runtime: synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_3_2,\n  test: synthetics.Test.custom({\n    code: bundledCode,\n    handler: \"index.handler\",\n  });\n});\n```\n\n## Documentation\n\nThe package exports various different constructs for use with existing CDK features. A major guiding design principal for this package is to _extend, don't replace_. Expect constructs that you can provide as props, not complete replacements.\n\nFor use in **Lambda Functions** and **Synthetic Canaries**, the following classes implement `lambda.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-synthetics-alpha.Code.html)):\n\n- `TypeScriptCode` & `JavaScriptCode`\n\nInline code is only supported by **Lambda**:\n\n- `InlineTypeScriptCode` & `InlineJavaScriptCode`\n- `InlineTsxCode` & `InlineJsxCode`\n\nFor use with **S3 bucket deployments**, classes implementing `s3deploy.ISource` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html)):\n\n- `TypeScriptSource` & `JavaScriptSource`\n\n> _Code and Source constructs seamlessly plug-in to other high-level CDK constructs. They share the same set of parameters, props and build options._\n\nThe following classes power the other features. You normally won't have to use them, but they are there if you need them:\n\n- `TypeScriptAsset` & `JavaScriptAsset` implements `s3.Asset` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3_assets.Asset.html)) \\\n  creates an asset uploaded to S3 which can be referenced by other constructs\n\n- `EsbuildBundler` implements `core.BundlingOptions` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.BundlingOptions.html)) \\\n  provides an interface for a _esbuild_ bundler wherever needed\n\n### [API Reference](API.md)\n\nAuto-generated reference for classes and structs. This information is also available as part of your IDE's code completion.\n\n### Escape hatches\n\nIt's possible that you want to use an implementation of esbuild that's different to the default one. Common reasons are:\n\n- The current version constraints for esbuild are not suitable\n- To use a version of esbuild that is installed by any other means than `npm`, including Docker\n- Plugin support is needed for building\n\nFor these situations, this package offers an escape hatch to bypass regular the implementation and provide a custom build and transform function.\n\n#### Esbuild binary path\n\nIt is possible to override the binary used by esbuild. The usual way to do this is to set the `ESBUILD_BINARY_PATH` environment variable. For convenience this package allows to set the binary path as a prop:\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  esbuildBinaryPath: \"path/to/esbuild/binary\"\n});\n```\n\n#### Custom build function\n\n> 💡 See [Using esbuild with plugins](examples/typescript/esbuild-with-plugins) for a complete working example of a custom build function using this escape hatch.\n\nConstructs that result in starting a build, take a `buildFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `buildSync` function.\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  buildFn: (options: BuildOptions): BuildResult => {\n    try {\n      // custom implementation returning BuildResult\n    } catch (error) {\n      // throw BuildFailure exception here\n    }\n  },\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated build options. The custom build function can amend, change or discard any of these. However integration with CDK relies heavily on the values `outdir`/`outfile` are set to and it's usually required to use them unchanged.\n\nFailures have to cause a `BuildFailure` exception in order to be fully handled.\n\n#### Custom transform function\n\nConstructs that result in starting a transformation, take a `transformFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `transformSync` function.\n\n```ts\nnew InlineTypeScriptCode(\"let x: number = 1\", {\n  transformFn: (options: TransformOptions): TransformResult => {\n    try {\n      // custom implementation returning TransformResult\n    } catch (error) {\n      // throw TransformFailure exception here\n    }\n  },,\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated transform options. The custom transform function can amend, change or discard any of these.\n\nFailures have to cause a `TransformFailure` exception in order to be fully handled.\n\n### Upgrading from AWS CDK v1\n\nThis version is compatible with AWS CDK v2. For the previous, AWS CDK v1 compatible release, see [cdk-esbuild@v2](https://github.com/mrgrain/cdk-esbuild/tree/v2).\n\nTo upgrade from AWS CDK v1 and cdk-esbuild@v2, please follow these steps:\n\n- This version requires AWS CDK v2. Follow the [official migration guide](https://docs.aws.amazon.com/cdk/latest/guide/work-with-cdk-v2.html) to upgrade.\n- Update the package dependency to v3: `npm install --save @mrgrain/cdk-esbuild@^3.0.0`\n- `esbuild` is installed as an optional dependency. If your setup does not automatically install optional dependencies, make sure to add it as an explicit dependency.\n- Any use of `InlineCode` variations has to be updated. Previously the second parameter was either of type `TransformerProps` or `TransformOptions`. Now it must be `TransformerProps`.\\\n  If the passed value is of type `TransformOptions`, turn it into the correct type like this:\n\n  ```ts\n  const oldOptions: TransformOptions = {...}\n\n  new InlineTypeScriptCode('// inline code', {\n    transformOptions: oldOptions\n  });\n  ```\n\n## Versioning\n\nThis package follows [Semantic Versioning](https://semver.org/), with the exception of upgrades to `esbuild`. These will be released as **minor versions** and often include breaking changes from `esbuild`.\n\n### Npm Tags\n\nSome users prefer to use tags over version ranges. The following stable tags are available for use:\n\n- `cdk-v1`, `cdk-v2` are provided for the latest release compatible with each version of the AWS CDK.\n\n- `latest` is the most recent stable release.\n\nThese tags also exist, but usage is strongly not recommended:\n\n- `unstable`, `next` are used for pre-release of the current and next major version respectively.\n\n- ~~`cdk-1.x.x`~~ tags have been deprecated in favour of `cdk-v1`. Use that one instead.\n\n## Roadmap & Contributions\n\n[The project's roadmap is available on GitHub.](https://github.com/mrgrain/cdk-esbuild/projects/1) Please submit any feature requests as issues to the repository.\n\nAll contributions are welcome, no matter if they are for already planned or completely new features.\n\n## Library authors\n\nBuilding a library consumed by other packages that relies on `cdk-esbuild` might require you to set `buildOptions.absWorkingDir`. The easiest way to do this, is to resolve based on the directory name of the calling file, and traverse the tree upwards to the root of your library package (that's where `package.json` and `tsconfig.json` are):\n\n```ts\n// file: project/src/index.ts\nconst props = {\n  buildOptions: {\n    absWorkingDir: path.resolve(__dirname, \"..\"), // now: /user/project\n  },\n};\n```\n\nThis will dynamically resolve to the correct path, wherever the package is installed.\n\nPlease open an issue if you encounter any difficulties.\n"
   },
   "repository": {
     "type": "git",
@@ -2808,8 +2808,17 @@
   },
   "schema": "jsii/0.10.0",
   "targets": {
+    "dotnet": {
+      "iconUrl": "https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/logo.png",
+      "namespace": "Mrgrain.CdkEsbuild",
+      "packageId": "Mrgrain.CdkEsbuild"
+    },
     "js": {
       "npm": "@mrgrain/cdk-esbuild"
+    },
+    "python": {
+      "distName": "mrgrain.cdk-esbuild",
+      "module": "mrgrain.cdk_esbuild"
     }
   },
   "types": {
@@ -4032,7 +4041,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/bundler.ts",
-        "line": 33
+        "line": 34
       },
       "name": "BundlerProps",
       "properties": [
@@ -4043,7 +4052,7 @@
               "throws": "esbuild.BuildFailure",
               "type": "esbuild.buildSync"
             },
-            "default": "esbuild.buildSync",
+            "default": "`esbuild.buildSync`",
             "remarks": "The function will receive the computed options from the bundler. It can use with these options as it wishes, however `outdir`/`outfile` must be respected to integrate with CDK.\nMust throw a `BuildFailure` on failure to correctly inform the bundler.",
             "returns": "esbuild.BuildResult",
             "stability": "experimental",
@@ -4052,7 +4061,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 89
+            "line": 90
           },
           "name": "buildFn",
           "optional": true,
@@ -4071,7 +4080,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 52
+            "line": 53
           },
           "name": "buildOptions",
           "optional": true,
@@ -4089,7 +4098,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 75
+            "line": 76
           },
           "name": "copyDir",
           "optional": true,
@@ -4143,13 +4152,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 98
+            "line": 99
           },
           "name": "esbuildBinaryPath",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `CDK_ESBUILD_MODULE_PATH` or package resolution (see above)",
+            "remarks": "E.g. \"/home/user/.npm/node_modules/esbuild/lib/main.js\"\n\nIf not set, the module path will be determined in the following order:\n\n- Use a path from the `CDK_ESBUILD_MODULE_PATH` environment variable\n- In TypeScript, fallback to the default Node.js package resolution mechanism\n- All other languages (Python, Go, .NET, Java) use an automatic \"best effort\" resolution mechanism. \\\n   The exact algorithm of this mechanism is considered an implementation detail and should not be relied on.\n   If `esbuild` cannot be found, it might be installed dynamically to a temporary location.\n   To opt-out of this behavior, set either `esbuildModulePath` or `CDK_ESBUILD_MODULE_PATH` env variable.",
+            "stability": "experimental",
+            "summary": "Absolute path to the esbuild module JS file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/bundler.ts",
+            "line": 118
+          },
+          "name": "esbuildModulePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "src/bundler:BundlerProps"
@@ -4226,6 +4254,103 @@
       ],
       "symbolId": "aws-lambda/lib/code:CodeConfig"
     },
+    "@mrgrain/cdk-esbuild.CompilerOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.CompilerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/esbuild-types.ts",
+        "line": 590
+      },
+      "name": "CompilerOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 594
+          },
+          "name": "importsNotUsedAsValues",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 591
+          },
+          "name": "jsxFactory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 592
+          },
+          "name": "jsxFragmentFactory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 595
+          },
+          "name": "preserveValueImports",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 593
+          },
+          "name": "useDefineForClassFields",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/esbuild-types:CompilerOptions"
+    },
     "@mrgrain/cdk-esbuild.EsbuildAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "aws-cdk-lib.aws_s3_assets.Asset",
@@ -4286,7 +4411,7 @@
         },
         "locationInModule": {
           "filename": "src/bundler.ts",
-          "line": 125
+          "line": 145
         },
         "parameters": [
           {
@@ -4337,7 +4462,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/bundler.ts",
-        "line": 107
+        "line": 127
       },
       "name": "EsbuildBundler",
       "properties": [
@@ -4350,7 +4475,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 142
+            "line": 162
           },
           "name": "entryPoints",
           "type": {
@@ -4387,7 +4512,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 120
+            "line": 140
           },
           "name": "image",
           "type": {
@@ -4402,7 +4527,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 113
+            "line": 133
           },
           "name": "local",
           "type": {
@@ -4417,7 +4542,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 149
+            "line": 169
           },
           "name": "props",
           "type": {
@@ -4670,6 +4795,141 @@
       ],
       "symbolId": "src/code:EsbuildCode"
     },
+    "@mrgrain/cdk-esbuild.EsbuildSource": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.EsbuildSource",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/esbuild-source.ts",
+        "line": 11
+      },
+      "name": "EsbuildSource",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "First try to find to module, then install it to a temporary location."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 71
+          },
+          "name": "auto",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Install the module to a temporary location."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 64
+          },
+          "name": "install",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Require module by name, do not attempt to find it anywhere else."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 57
+          },
+          "name": "nodeJs",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "`EsbuildSource.nodeJs` for NodeJs, `EsbuildSource.auto` for all other languages."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 32
+          },
+          "name": "platformDefault",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Try to find the module in most common paths."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 43
+          },
+          "name": "anywhere",
+          "optional": true,
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Try to find the module in common global installation paths."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 50
+          },
+          "name": "globalPaths",
+          "optional": true,
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set the default mechanism to find the module The current default to find the module."
+          },
+          "locationInModule": {
+            "filename": "src/esbuild-source.ts",
+            "line": 18
+          },
+          "name": "default",
+          "optional": true,
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/esbuild-source:EsbuildSource"
+    },
     "@mrgrain/cdk-esbuild.InlineJavaScriptCode": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4684,7 +4944,7 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 122
+          "line": 143
         },
         "parameters": [
           {
@@ -4724,7 +4984,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 121
+        "line": 142
       },
       "methods": [
         {
@@ -4734,7 +4994,7 @@
           },
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 75
+            "line": 95
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4763,7 +5023,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 43
+            "line": 63
           },
           "name": "isInline",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4788,7 +5048,7 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 153
+          "line": 174
         },
         "parameters": [
           {
@@ -4828,7 +5088,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 152
+        "line": 173
       },
       "methods": [
         {
@@ -4838,7 +5098,7 @@
           },
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 75
+            "line": 95
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4867,7 +5127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 43
+            "line": 63
           },
           "name": "isInline",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4892,7 +5152,7 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 213
+          "line": 234
         },
         "parameters": [
           {
@@ -4932,7 +5192,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 212
+        "line": 233
       },
       "methods": [
         {
@@ -4942,7 +5202,7 @@
           },
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 75
+            "line": 95
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4971,7 +5231,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 43
+            "line": 63
           },
           "name": "isInline",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -4996,7 +5256,7 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 183
+          "line": 204
         },
         "parameters": [
           {
@@ -5036,7 +5296,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 182
+        "line": 203
       },
       "methods": [
         {
@@ -5046,7 +5306,7 @@
           },
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 75
+            "line": 95
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -5075,7 +5335,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 43
+            "line": 63
           },
           "name": "isInline",
           "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
@@ -6180,7 +6440,16 @@
           "name": "tsconfigRaw",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "fqn": "@mrgrain/cdk-esbuild.TsconfigOptions"
+                }
+              ]
+            }
           }
         }
       ],
@@ -6196,7 +6465,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 10
+        "line": 11
       },
       "name": "TransformerProps",
       "properties": [
@@ -6210,7 +6479,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 39
+            "line": 40
           },
           "name": "esbuildBinaryPath",
           "optional": true,
@@ -6218,6 +6487,25 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `CDK_ESBUILD_MODULE_PATH` or package resolution (see above)",
+            "remarks": "E.g. \"/home/user/.npm/node_modules/esbuild/lib/main.js\"\n\nIf not set, the module path will be determined in the following order:\n\n- Use a path from the `CDK_ESBUILD_MODULE_PATH` environment variable\n- In TypeScript, fallback to the default Node.js package resolution mechanism\n- All other languages (Python, Go, .NET, Java) use an automatic \"best effort\" resolution mechanism. \\\n   The exact algorithm of this mechanism is considered an implementation detail and should not be relied on.\n   If `esbuild` cannot be found, it might be installed dynamically to a temporary location.\n   To opt-out of this behavior, set either `esbuildModulePath` or `CDK_ESBUILD_MODULE_PATH` env variable.",
+            "stability": "experimental",
+            "summary": "Absolute path to the esbuild module JS file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/inline-code.ts",
+            "line": 59
+          },
+          "name": "esbuildModulePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -6225,7 +6513,7 @@
               "throws": "esbuild.TransformFailure",
               "type": "esbuild.transformSync"
             },
-            "default": "esbuild.transformSync",
+            "default": "`esbuild.transformSync`",
             "remarks": "The function will receive the computed options from the bundler. It can use with these options as it wishes, however a TransformResult must be returned to integrate with CDK.\nMust throw a `TransformFailure` on failure to correctly inform the bundler.",
             "returns": "esbuild.TransformResult",
             "stability": "experimental",
@@ -6234,7 +6522,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 30
+            "line": 31
           },
           "name": "transformFn",
           "optional": true,
@@ -6253,7 +6541,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 17
+            "line": 18
           },
           "name": "transformOptions",
           "optional": true,
@@ -6264,6 +6552,39 @@
       ],
       "symbolId": "src/inline-code:TransformerProps"
     },
+    "@mrgrain/cdk-esbuild.TsconfigOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.TsconfigOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/esbuild-types.ts",
+        "line": 598
+      },
+      "name": "TsconfigOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 599
+          },
+          "name": "compilerOptions",
+          "optional": true,
+          "type": {
+            "fqn": "@mrgrain/cdk-esbuild.CompilerOptions"
+          }
+        }
+      ],
+      "symbolId": "src/esbuild-types:TsconfigOptions"
+    },
     "@mrgrain/cdk-esbuild.TypeScriptAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@mrgrain/cdk-esbuild.EsbuildAsset",
@@ -6645,6 +6966,6 @@
       "symbolId": "src/source:TypeScriptSourceProps"
     }
   },
-  "version": "3.9.0",
-  "fingerprint": "Bp8QFIef4EnkeSogdcX2OtOp8WZjqAaMiN0b4Ke2I3M="
+  "version": "3.11.1",
+  "fingerprint": "oJIeTM/sMlbD0OLm8lmgp4pmaRkuVDN76R6mb2VTXkg="
 }