@mrgrain/cdk-esbuild 2.0.0-alpha.0 → 2.0.0-alpha.5

package/.jsii

@@ -9,6 +9,7 @@
   },
   "dependencies": {
     "@aws-cdk/aws-lambda": "^1.99.0",
+    "@aws-cdk/aws-s3": "^1.99.0",
     "@aws-cdk/aws-s3-assets": "^1.99.0",
     "@aws-cdk/aws-s3-deployment": "^1.99.0",
     "@aws-cdk/aws-synthetics": "^1.99.0",
@@ -968,7 +969,7 @@
   },
   "name": "@mrgrain/cdk-esbuild",
   "readme": {
-    "markdown": "# cdk-esbuild\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started) | [Documentation](#documentation) | [Versioning](#versioning)\n\n## ⚠️ Alpha Version of `jsii` compatible package\n\nDocumentation has not yet been updated.\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## Getting started\n\nInstall `cdk-esbuild`:\n\n```\nnpm install @mrgrain/cdk-esbuild\n```\n\n⚠️ When using an older version of npm (4-6), the required peer dependencies have to be installed manually. Use this command instead:\n\n```\nnpm install @mrgrain/cdk-esbuild @aws-cdk/core @aws-cdk/aws-lambda @aws-cdk/aws-s3-assets @aws-cdk/aws-s3-deployment @aws-cdk/aws-synthetics\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/latest/docs/@aws-cdk_aws-lambda.Function.html#code):\n\n```ts\nimport * as lambda from \"@aws-cdk/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_14_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/aws-s3\";\nimport * as s3deploy from \"@aws-cdk/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> ⚠️ **Status: Experimental** \\\n> Expect the interface to change. Please report any issues!\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```ts\nimport * as synthetics from \"@aws-cdk/aws-synthetics\";\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/latest/docs/@aws-cdk_aws-lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-synthetics.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 plugin to high-level CDK features. They share the same set of parameters, props and build options:_\n\nUnderlying classes the 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/latest/docs/@aws-cdk_aws-s3-assets.Asset.html)) \\\n  creates an asset uploaded to S3 which can be referenced by other constructs\n\n- `EsbuildBundling` implements `core.BundlingOptions` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.BundlingOptions.html)) \\\n  provides a _esbuild_ bundling interface wherever needed\n\n## `TypeScriptCode`, `JavaScriptCode`\n\n> ℹ️ _Although these classes are currently identical, please use the appropriate class as functionality might diverge in future releases._\n\n**Default build options:**\n\n- `bundle=true`\n- `platform=node`\n- `target=nodeX` with `X` being the major node version running the code\n\n### Parameters\n\n- `entryPoints: string | string[] | Record<string, string>` \\\n  A single or list of relative paths to the entry points of your code from the root of the project.\n\n### Props\n\n- `props.buildOptions?` as per esbuild [(reference)](https://esbuild.github.io/getting-started/#build-scripts) \\\n  **All build options are optional.** \\\n  Same defaults and functionalities apply, with a few changes as noted below. Generally speaking usage of entry and output options are different, as these are inferred by CDK.\n\n- ❌ `buildOptions.entryPoints` \\\n  _Not available. Option is exposed as parameter._\n\n- `buildOptions.outdir: string` \\\n  The actual path for the output directory is defined by CDK. However setting this option allows to write files into a subdirectory. \\\n  For example `{ outdir: 'js' }` will create an asset with a single directory called `js`, which contains all built files. This approach can be useful for static website deployments, where JavaScript code should be placed into a subdirectory. \\\n  _Cannot be used together with `outfile`._\n\n- `buildOptions.outfile: string` \\\n  Relative path to a file inside the CDK asset output directory. \\\n  For example `{ outfile: 'js/index.js' }` will create an asset with a single directory called `js`, which contains a single file `index.js`. This can be useful to rename the entry point.\\\n  _Cannot be used with multiple `entryPoints` or together with `outdir`._\n\n- `buildOptions.absWorkingDir: string` \\\n  Absolute path to the [esbuild working directory](https://esbuild.github.io/api/#working-directory) and defaults to the [current working directory](https://en.wikipedia.org/wiki/Working_directory).\\\n  Docker-based builds also use this path to mount local files into the container. A large `absWorkingDir` can slow down the Docker build. \\\n  If paths cannot be found, a good starting point is to look at the concatenation of `absWorkingDir + entryPoint`. It must always be a valid absolute path pointing to the entry point. When needed, the probably easiest way to set `absWorkingDir` is to use a combination of `resolve` and `__dirname` (see \"A note for library authors\" below).\n\n> **⚠️ A note for library authors**\n>\n> When developing a library consumed by other packages, you'll most likely have to set `absWorkingDir`. The easiest way to do this, is to resolve based on the directory name of the 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\n> const props = {\n>   buildOptions: {\n>     absWorkingDir: path.resolve(__dirname, \"..\"), // now: /user/project\n>   },\n> };\n> ```\n>\n> This will dynamically resolve to the correct path, wherever the package is installed.\n\n- `props.copyDir?: string` \\\n  **⚠️ Experimental** - _Likely to change once esbuild supports this natively_ \\\n  Relative path to a directory copied to the output before the build is run (i.e esbuild will overwrite existing files).\n\n- `props.bundlerPriority?: BundlerPriority (BundlerPriority.AttemptLocal)` \\\n  Set the priority order of available bundlers. It can be useful to limit use to one of the bundlers. For Docker, the `absWorkingDir` path (or current working directory) will be mounted into the container as context. By default bundling with a locally installed binary is attempted first and Docker will only be used if the local bundling fails.\n\n## `TypeScriptSource`, `JavaScriptSource`\n\n> ℹ️ _Although these classes are currently identical, please use the appropriate class as functionality might diverge in future releases._\n\n**Default build options:**\n\n- `bundle=true`\n- `platform=browser`\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\n### Parameters & Props\n\n➡️ _Code and Source constructs share the same set of parameters, props and build options. Please see above for details._\n\n## `InlineTypeScriptCode`, `InlineJavaScriptCode`, `InlineTsxCode`, `InlineJsxCode`\n\n**⚠️ Status: Unstable**\n\nAn implementation of `lambda.InlineCode` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.InlineCode.html)) using the esbuild Transform API.\nInline function code is limited to 4 KiB _after_ transformation.\n\n### Parameters\n\n- `code: string` \\\n  The inline code to be transformed.\n\n- `transformOptions: TransformOptions` \\\n  Options from the [esbuild Transform API](https://esbuild.github.io/api/#transform-api).\n\n  **Default transform options:** \\\n  • `loader=ts|js|tsx|jsx` (one of `ts,js,tsx,jsx` depending on the used class)\n\n## `TypeScriptAsset`, `JavaScriptAsset`\n\nBundles the entry points and creates a CDK asset which is uploaded to the bootstrapped CDK S3 bucket during deployment. The asset can be used by other constructs.\n\n> ℹ️ _The high-level constructs for `TypeScriptSource` and `TypeScriptCode` (and respective JavaScript classes) actually just use this asset._\n\n**Default build options:**\n\n- `bundle=true`\n\n### Parameters\n\n- `scope: cdk.Construct`\n- `id: string`\n- `props: TypeScriptAssetProps|JavaScriptAssetProps`\n\n### Props\n\n- `props.entryPoints: string | string[] | Record<string, string>` \\\n  A single or list of relative paths to the entry points of your code from the root of the project.\n\n- `props.copyDir?: string` \\\n   **⚠️ Experimental** - _Likely to change once esbuild supports this natively_ \\\n   Relative path to a directory copied to the output before the build is run (i.e esbuild will overwrite existing files).\n\n- `props.bundlerPriority?: BundlerPriority (BundlerPriority.AttemptLocal)` \\\n  Set the priority order of available bundlers. It can be useful to limit use to one of the bundlers. For Docker, the `absWorkingDir` path (or current working directory) will be mounted into the container as context. By default bundling with a locally installed binary is attempted first and Docker will only be used if the local bundling fails.\n\n- `props.buildOptions?` as per esbuild [(reference)](https://esbuild.github.io/getting-started/#build-scripts) \\\n  **All build options are optional.** \\\n  ➡️ See `TypeScriptCode` for detailed explanation on options.\n\n## `EsbuildBundling`\n\n**⚠️ Status: Unstable**\n\nLow-level class that can be used where a `BundlingOptions` are required. This class provides the local und Docker-based bundling but doesn't come with any kind of safeguards.\n\n### Parameters\n\n- `buildOptions?` \\\n  All esbuild options are available, with adapted functionality as described above.\n\n- `props.priority?: BundlerPriority (BundlerPriority.AttemptLocal)` \\\n  Priority order of available bundlers. Default `BundlerPriority.AttemptLocal` is to attempt using a locally installed binary first, retrying with Docker in case of failure. Can be set to only use either the local or Docker bundler.\n\n- `props.copyDir?: string` \\\n  Copy additional files to the output directory, before the build runs.\n\n- `props.esbuildVersion?: string` \\\n  _Docker build only._ A npm compatible version constraint. If not provided will attempt to read from a `package-lock.json` or `package.json` in the `absWorkingDir`. Otherwise uses the constraint provided by this package (usually `^0.x.0`).\n\n## Versioning\n\n**⚠️ Status: Unstable**\n\n_Because esbuild is still in major version zero, this package must be considered unstable. Notably updates to the minimal version requirement of esbuild will be introduced in minor versions of this package and thus will contain any breaking changes esbuild introduces._\n\n**Upcoming changes to versioning! See Future section below.**\n\nThe package tracks the **minor** version number of CDK releases. It might work with newer versions of CDK, but has not been tested. Features changes, including breaking changes, will only be introduced alongside minor releases.\n\n**Patches releases** will contain fixes to this library only and do not necessarily reflect CDK patches.\n\nAny parts of the code marked as `unstable` can change at any time. Please note that the unstable flag is applied to all new or experimental features and internal classes.\n\n### Future\n\n### `jsii` compatibility\n\nI am actively working on a [jsii](https://aws.github.io/jsii/) compatible version of this constructs library, see the [next branch](https://github.com/mrgrain/cdk-esbuild/tree/next) for further details. Amongst other things, this will allow me to publish the package to the [Construct Hub](https://constructs.dev/).\n\n**The release of this will be in a new major version 2.** Versioning will evolve further towards semantic versioning,with `esbuild` upgrades being the exception. They will continue to be shipped as part of minor version updates and might include breaking changes.\n\n**Most of the package will remain the same** and migration will be easy. However some interfaces need to be updated for `jsii` and deprecated features will be removed.\n\n### AWS CDK v2\n\nWith the monolithic version 2 of CDK (aka Mono-CDK) on the horizon, versioning for this library will change as well.\n\nA major release will be marked alongside CDK. From that point on, this package will mostly use _semantic versioning_ and not longer align version numbers with AWS CDK.\n\nThe big exceptions will be updates to the minimal version requirement of esbuild. As long as esbuild is still in major version zero, these requirement updates will be introduced as minor version updates.\n\nAdditionally any parts of the code marked as `unstable` can change at any time. Please note that the unstable flag is applied to new experimental features and internal classes.\n\n### Stable esbuild\n\nOnce `esbuild` has reached a stable version 1.0, a new major version will be released for _all_ breaking changes, including updated of minimum (peer) dependencies.\n\nAdditionally any parts of the code marked as `unstable` can change at any time. Please note that the unstable flag is applied to new experimental features and internal classes.\n"
+    "markdown": "# cdk-esbuild\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started) | [Migrating to v2](#migrating-to-v2) |\n[Documentation](#documentation) | [API Reference](#api-reference) | [Versioning](#versioning)\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**⚠️ A note on stability**\n\nThis package is generally stable and ready to be used in production as many do. However _esbuild_ is still on major version zero, which you should consider. Please check their guide on [production readiness](https://esbuild.github.io/faq/#production-readiness).\n\nNotably upgrades of the _esbuild_ 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\n```\n\nIf _peer_ and _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 esbuild @aws-cdk/core @aws-cdk/aws-lambda @aws-cdk/aws-s3-assets @aws-cdk/aws-s3-deployment @aws-cdk/aws-synthetics\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/latest/docs/@aws-cdk_aws-lambda.Function.html#code):\n\n```ts\nimport * as lambda from \"@aws-cdk/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_14_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/aws-s3\";\nimport * as s3deploy from \"@aws-cdk/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```ts\nimport * as synthetics from \"@aws-cdk/aws-synthetics\";\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/latest/docs/@aws-cdk_aws-lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-synthetics.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 plugin to high-level CDK features. They share the same set of parameters, props and build options._\n\nUnderlying 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/latest/docs/@aws-cdk_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/latest/docs/@aws-cdk_core.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 within the code completion of your IDE.\n\n## Migrating to v2\n\nThe main changes in cdk-esbuild v2 are:\n\n- The package is now `jsii` compliant and published in the [Construct Hub](https://constructs.dev/). This will also enable a possible feature release for other languages.\n- Deprecated properties and classes have been removed, most notably the previous support for bundling via a Docker container. The implementation had a few issues that cannot be easily resolved. However more generic support for custom executables might arrive in later versions.\n- `esbuild` is now installed as an optional dependency. It's not optional at all, but this is a ramification of using `jsii`. In practice this will have no impact on most people.\n- Interfaces have been streamlined and the names and setup of internal types have been changed. In the unlikely case that someone was relying on these, upgrading will be straight forward.\n\n### Upgrading\n\n- Update the package dependency to v2: `npm install --save @mrgrain/cdk-esbuild@^2.0.0`\n- `esbuild` is now installed as an optional dependency. If your setup does not automatically install optional dependencies, add it as an explicit dependency.\n- Remove any use of `bundlerPriority`.\n- Unstable construct `EsbuildBundling` has been renamed to `EsbuildBundler` and its interface has slightly changed. Like most other constructs, it now takes `entryPoints` as first parameter, with an optional `props` object as the second.\n\n## Versioning\n\nThis package _mostly_ 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\nAlthough great care is taken to avoid this, all features marked as `@unstable` may change with minor versions. Please note that the unstable flag is applied to all new or experimental features and internal classes.\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## Future releases\n\n### AWS CDK v2\n\nThe monolithic version 2 of CDK (aka Mono-CDK) is on the horizon. A new major release of this package will be marked alongside CDK. Support for AWS CDK v1.x.x will be continued, however no new features will be added.\n\n### Stable esbuild\n\nOnce `esbuild` has reached a stable version 1.0, a new major version will be released for _all_ breaking changes, including updates to minimum (peer) dependencies.\n\n## Library authors\n\nWhen developing a library consumed by other packages, you'll most likely have to set `buildOptions.absWorkingDir`. The easiest way to do this, is to resolve based on the directory name of the 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"
   },
   "repository": {
     "type": "git",
@@ -981,6 +982,83 @@
     }
   },
   "types": {
+    "@mrgrain/cdk-esbuild.AssetProps": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.AssetProps",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.BundlerProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/asset.ts",
+        "line": 22
+      },
+      "name": "AssetProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "E.g. `src/index.ts`.",
+            "stability": "stable",
+            "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset.ts",
+            "line": 28
+          },
+          "name": "entryPoints",
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "array"
+                  }
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "map"
+                  }
+                }
+              ]
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "As this is a plain string, it can be used in construct IDs in order to enforce creation of a new resource when the content hash has changed.\n\nDefaults to a hash of all files in the resulting bundle.",
+            "stability": "stable",
+            "summary": "A hash of this asset, which is available at construction time."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset.ts",
+            "line": 19
+          },
+          "name": "assetHash",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/asset:AssetProps"
+    },
     "@mrgrain/cdk-esbuild.BuildOptions": {
       "assembly": "@mrgrain/cdk-esbuild",
       "datatype": true,
@@ -991,7 +1069,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/esbuild-types.ts",
-        "line": 38
+        "line": 40
       },
       "name": "BuildOptions",
       "properties": [
@@ -1003,7 +1081,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 64
+            "line": 66
           },
           "name": "absWorkingDir",
           "optional": true,
@@ -1019,7 +1097,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 53
+            "line": 55
           },
           "name": "allowOverwrite",
           "optional": true,
@@ -1035,7 +1113,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 59
+            "line": 61
           },
           "name": "assetNames",
           "optional": true,
@@ -1051,7 +1129,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 61
+            "line": 63
           },
           "name": "banner",
           "optional": true,
@@ -1072,7 +1150,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 39
+            "line": 41
           },
           "name": "bundle",
           "optional": true,
@@ -1088,7 +1166,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 21
+            "line": 23
           },
           "name": "charset",
           "optional": true,
@@ -1104,7 +1182,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 58
+            "line": 60
           },
           "name": "chunkNames",
           "optional": true,
@@ -1120,7 +1198,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 33
+            "line": 35
           },
           "name": "color",
           "optional": true,
@@ -1136,7 +1214,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 51
+            "line": 53
           },
           "name": "conditions",
           "optional": true,
@@ -1157,7 +1235,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 29
+            "line": 31
           },
           "name": "define",
           "optional": true,
@@ -1178,7 +1256,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 57
+            "line": 59
           },
           "name": "entryNames",
           "optional": true,
@@ -1194,7 +1272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 47
+            "line": 49
           },
           "name": "external",
           "optional": true,
@@ -1215,7 +1293,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 62
+            "line": 64
           },
           "name": "footer",
           "optional": true,
@@ -1236,7 +1314,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 13
+            "line": 15
           },
           "name": "format",
           "optional": true,
@@ -1252,7 +1330,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 14
+            "line": 16
           },
           "name": "globalName",
           "optional": true,
@@ -1268,7 +1346,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 23
+            "line": 25
           },
           "name": "ignoreAnnotations",
           "optional": true,
@@ -1284,7 +1362,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 63
+            "line": 65
           },
           "name": "incremental",
           "optional": true,
@@ -1300,7 +1378,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 60
+            "line": 62
           },
           "name": "inject",
           "optional": true,
@@ -1321,7 +1399,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 25
+            "line": 27
           },
           "name": "jsx",
           "optional": true,
@@ -1337,7 +1415,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 26
+            "line": 28
           },
           "name": "jsxFactory",
           "optional": true,
@@ -1353,7 +1431,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 27
+            "line": 29
           },
           "name": "jsxFragment",
           "optional": true,
@@ -1369,7 +1447,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 31
+            "line": 33
           },
           "name": "keepNames",
           "optional": true,
@@ -1385,7 +1463,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 9
+            "line": 11
           },
           "name": "legalComments",
           "optional": true,
@@ -1401,7 +1479,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 48
+            "line": 50
           },
           "name": "loader",
           "optional": true,
@@ -1422,7 +1500,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 34
+            "line": 36
           },
           "name": "logLevel",
           "optional": true,
@@ -1438,7 +1516,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 35
+            "line": 37
           },
           "name": "logLimit",
           "optional": true,
@@ -1454,7 +1532,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 50
+            "line": 52
           },
           "name": "mainFields",
           "optional": true,
@@ -1475,7 +1553,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 43
+            "line": 45
           },
           "name": "metafile",
           "optional": true,
@@ -1491,7 +1569,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 17
+            "line": 19
           },
           "name": "minify",
           "optional": true,
@@ -1507,7 +1585,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 19
+            "line": 21
           },
           "name": "minifyIdentifiers",
           "optional": true,
@@ -1523,7 +1601,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 20
+            "line": 22
           },
           "name": "minifySyntax",
           "optional": true,
@@ -1539,7 +1617,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 18
+            "line": 20
           },
           "name": "minifyWhitespace",
           "optional": true,
@@ -1555,7 +1633,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 65
+            "line": 67
           },
           "name": "nodePaths",
           "optional": true,
@@ -1576,7 +1654,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 45
+            "line": 47
           },
           "name": "outbase",
           "optional": true,
@@ -1592,7 +1670,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 44
+            "line": 46
           },
           "name": "outdir",
           "optional": true,
@@ -1608,7 +1686,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 55
+            "line": 57
           },
           "name": "outExtension",
           "optional": true,
@@ -1629,7 +1707,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 42
+            "line": 44
           },
           "name": "outfile",
           "optional": true,
@@ -1645,7 +1723,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 46
+            "line": 48
           },
           "name": "platform",
           "optional": true,
@@ -1661,7 +1739,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 41
+            "line": 43
           },
           "name": "preserveSymlinks",
           "optional": true,
@@ -1677,7 +1755,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 56
+            "line": 58
           },
           "name": "publicPath",
           "optional": true,
@@ -1693,7 +1771,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 30
+            "line": 32
           },
           "name": "pure",
           "optional": true,
@@ -1714,7 +1792,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 49
+            "line": 51
           },
           "name": "resolveExtensions",
           "optional": true,
@@ -1735,7 +1813,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 8
+            "line": 10
           },
           "name": "sourcemap",
           "optional": true,
@@ -1760,7 +1838,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 10
+            "line": 12
           },
           "name": "sourceRoot",
           "optional": true,
@@ -1776,7 +1854,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 11
+            "line": 13
           },
           "name": "sourcesContent",
           "optional": true,
@@ -1792,7 +1870,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 40
+            "line": 42
           },
           "name": "splitting",
           "optional": true,
@@ -1808,7 +1886,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 15
+            "line": 17
           },
           "name": "target",
           "optional": true,
@@ -1838,7 +1916,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 22
+            "line": 24
           },
           "name": "treeShaking",
           "optional": true,
@@ -1854,7 +1932,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 54
+            "line": 56
           },
           "name": "tsconfig",
           "optional": true,
@@ -1870,7 +1948,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 52
+            "line": 54
           },
           "name": "write",
           "optional": true,
@@ -1881,260 +1959,180 @@
       ],
       "symbolId": "src/esbuild-types:BuildOptions"
     },
-    "@mrgrain/cdk-esbuild.CodeConfig": {
+    "@mrgrain/cdk-esbuild.BundlerProps": {
       "assembly": "@mrgrain/cdk-esbuild",
       "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "@mrgrain/cdk-esbuild.CodeConfig",
+      "fqn": "@mrgrain/cdk-esbuild.BundlerProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/code.ts",
-        "line": 21
+        "filename": "src/bundler.ts",
+        "line": 22
       },
-      "name": "CodeConfig",
+      "name": "BundlerProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "- `buildOptions.outdir: string` \\\nThe actual path for the output directory is defined by CDK. However setting this option allows to write files into a subdirectory. \\\nFor example `{ outdir: 'js' }` will create an asset with a single directory called `js`, which contains all built files. This approach can be useful for static website deployments, where JavaScript code should be placed into a subdirectory. \\\n*Cannot be used together with `outfile`*.\n- `buildOptions.outfile: string` \\\nRelative path to a file inside the CDK asset output directory. \\\nFor example `{ outfile: 'js/index.js' }` will create an asset with a single directory called `js`, which contains a single file `index.js`. This can be useful to rename the entry point. \\\n*Cannot be used with multiple entryPoints or together with `outdir`.*\n- `buildOptions.absWorkingDir: string` \\\nAbsolute path to the [esbuild working directory](https://esbuild.github.io/api/#working-directory) and defaults to the [current working directory](https://en.wikipedia.org/wiki/Working_directory). \\\nIf paths cannot be found, a good starting point is to look at the concatenation of `absWorkingDir + entryPoint`. It must always be a valid absolute path pointing to the entry point. When needed, the probably easiest way to set absWorkingDir is to use a combination of `resolve` and `__dirname` (see \"Library authors\" section in the documentation).",
+            "see": "https://esbuild.github.io/api/#build-api",
+            "stability": "stable",
+            "summary": "Build options passed on to esbuild. Please refer to the esbuild Build API docs for details."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/code.ts",
-            "line": 23
+            "filename": "src/bundler.ts",
+            "line": 41
           },
-          "name": "inlineCode",
+          "name": "buildOptions",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "@mrgrain/cdk-esbuild.BuildOptions"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "Files copied like this will be overwritten by esbuild if they share the same name as any of the outputs.",
+            "stability": "stable",
+            "summary": "Copy additional files to the output directory, before the build runs."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/code.ts",
-            "line": 22
+            "filename": "src/bundler.ts",
+            "line": 49
           },
-          "name": "s3Location",
+          "name": "copyDir",
           "optional": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.Location"
+            "primitive": "string"
           }
         }
       ],
-      "symbolId": "src/code:CodeConfig"
+      "symbolId": "src/bundler:BundlerProps"
     },
-    "@mrgrain/cdk-esbuild.EsbuildAssetProps": {
+    "@mrgrain/cdk-esbuild.CodeConfig": {
       "assembly": "@mrgrain/cdk-esbuild",
       "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps",
-      "interfaces": [
-        "@mrgrain/cdk-esbuild.EsbuildProps"
-      ],
+      "fqn": "@mrgrain/cdk-esbuild.CodeConfig",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/asset.ts",
-        "line": 29
+        "filename": "src/code.ts",
+        "line": 17
       },
-      "name": "EsbuildAssetProps",
+      "name": "CodeConfig",
       "properties": [
         {
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Relative paths to the entrypoints of your code, e.g. `src/index.ts`."
+            "summary": "The location of the code in S3."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/asset.ts",
-            "line": 33
+            "filename": "src/code.ts",
+            "line": 23
           },
-          "name": "entryPoints",
+          "name": "s3Location",
           "type": {
-            "union": {
-              "types": [
-                {
-                  "primitive": "string"
-                },
-                {
-                  "collection": {
-                    "elementtype": {
-                      "primitive": "string"
-                    },
-                    "kind": "array"
-                  }
-                },
-                {
-                  "collection": {
-                    "elementtype": {
-                      "primitive": "string"
-                    },
-                    "kind": "map"
-                  }
-                }
-              ]
-            }
+            "fqn": "@aws-cdk/aws-s3.Location"
           }
         }
       ],
-      "symbolId": "src/asset:EsbuildAssetProps"
+      "symbolId": "src/code:CodeConfig"
     },
-    "@mrgrain/cdk-esbuild.EsbuildBundling": {
+    "@mrgrain/cdk-esbuild.EsbuildBundler": {
       "assembly": "@mrgrain/cdk-esbuild",
       "docs": {
-        "stability": "experimental"
+        "remarks": "This class directly interfaces with esbuild and provides almost no configuration safeguards.",
+        "stability": "experimental",
+        "summary": "Low-level construct that can be used where `BundlingOptions` are required."
       },
-      "fqn": "@mrgrain/cdk-esbuild.EsbuildBundling",
+      "fqn": "@mrgrain/cdk-esbuild.EsbuildBundler",
       "initializer": {
         "docs": {
           "stability": "experimental"
         },
         "locationInModule": {
-          "filename": "src/bundling.ts",
-          "line": 16
+          "filename": "src/bundler.ts",
+          "line": 76
         },
         "parameters": [
           {
-            "name": "buildOptions",
+            "docs": {
+              "remarks": "E.g. `src/index.ts`.",
+              "stability": "experimental",
+              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            },
+            "name": "entryPoints",
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildOptions"
+              "union": {
+                "types": [
+                  {
+                    "primitive": "string"
+                  },
+                  {
+                    "collection": {
+                      "elementtype": {
+                        "primitive": "string"
+                      },
+                      "kind": "array"
+                    }
+                  },
+                  {
+                    "collection": {
+                      "elementtype": {
+                        "primitive": "string"
+                      },
+                      "kind": "map"
+                    }
+                  }
+                ]
+              }
             }
           },
           {
-            "name": "bundlerProps",
-            "optional": true,
+            "docs": {
+              "stability": "experimental",
+              "summary": "Props to change the behaviour of the bundler."
+            },
+            "name": "props",
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildBundlingProps"
+              "fqn": "@mrgrain/cdk-esbuild.BundlerProps"
             }
           }
         ]
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/bundling.ts",
-        "line": 11
-      },
-      "name": "EsbuildBundling",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundling.ts",
-            "line": 17
-          },
-          "name": "buildOptions",
-          "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildOptions"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundling.ts",
-            "line": 14
-          },
-          "name": "image",
-          "type": {
-            "fqn": "@aws-cdk/core.DockerImage"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundling.ts",
-            "line": 12
-          },
-          "name": "local",
-          "type": {
-            "fqn": "@mrgrain/cdk-esbuild.LocalBundler"
-          }
-        }
-      ],
-      "symbolId": "src/bundling:EsbuildBundling"
-    },
-    "@mrgrain/cdk-esbuild.EsbuildBundlingProps": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "@mrgrain/cdk-esbuild.EsbuildBundlingProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/bundlers.ts",
-        "line": 15
-      },
-      "name": "EsbuildBundlingProps",
-      "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Relative path to a directory copied to the output before esbuild is run (i.e esbuild will overwrite existing files)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundlers.ts",
-            "line": 19
-          },
-          "name": "copyDir",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        }
-      ],
-      "symbolId": "src/bundlers:EsbuildBundlingProps"
-    },
-    "@mrgrain/cdk-esbuild.EsbuildOptions": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "@mrgrain/cdk-esbuild.EsbuildOptions",
-      "interfaces": [
-        "@mrgrain/cdk-esbuild.BuildOptions"
-      ],
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/bundlers.ts",
-        "line": 11
+        "filename": "src/bundler.ts",
+        "line": 58
       },
-      "name": "EsbuildOptions",
+      "name": "EsbuildBundler",
       "properties": [
         {
-          "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "E.g. `src/index.ts`.",
+            "stability": "experimental",
+            "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/bundlers.ts",
-            "line": 12
+            "filename": "src/bundler.ts",
+            "line": 83
           },
           "name": "entryPoints",
           "type": {
             "union": {
               "types": [
+                {
+                  "primitive": "string"
+                },
                 {
                   "collection": {
                     "elementtype": {
@@ -2154,84 +2152,61 @@
               ]
             }
           }
-        }
-      ],
-      "symbolId": "src/bundlers:EsbuildOptions"
-    },
-    "@mrgrain/cdk-esbuild.EsbuildProps": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "@mrgrain/cdk-esbuild.EsbuildProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/asset.ts",
-        "line": 8
-      },
-      "name": "EsbuildProps",
-      "properties": [
+        },
         {
-          "abstract": true,
           "docs": {
-            "remarks": "As this is a plain string, it\ncan be used in construct IDs in order to enforce creation of a new resource when the content\nhash has changed.",
-            "stability": "stable",
-            "summary": "A hash of this asset, which is available at construction time."
+            "deprecated": "This value is ignored since the bundler is always using a locally installed version of esbuild. However the property is required to comply with the `BundlingOptions` interface.",
+            "stability": "deprecated"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/asset.ts",
-            "line": 26
+            "filename": "src/bundler.ts",
+            "line": 71
           },
-          "name": "assetHash",
-          "optional": true,
+          "name": "image",
           "type": {
-            "primitive": "string"
+            "fqn": "@aws-cdk/core.DockerImage"
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "Options passed on to esbuild."
+            "stability": "experimental",
+            "summary": "Implementation of `ILocalBundling` interface, responsible for calling esbuild functions."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/asset.ts",
-            "line": 17
+            "filename": "src/bundler.ts",
+            "line": 64
           },
-          "name": "buildOptions",
-          "optional": true,
+          "name": "local",
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.BuildOptions"
+            "fqn": "@aws-cdk/core.ILocalBundling"
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "Relative path to a directory copied to the output BEFORE esbuild is run (i.e esbuild will overwrite existing files)."
+            "stability": "experimental",
+            "summary": "Props to change the behaviour of the bundler."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/asset.ts",
-            "line": 12
+            "filename": "src/bundler.ts",
+            "line": 90
           },
-          "name": "copyDir",
-          "optional": true,
+          "name": "props",
           "type": {
-            "primitive": "string"
+            "fqn": "@mrgrain/cdk-esbuild.BundlerProps"
           }
         }
       ],
-      "symbolId": "src/asset:EsbuildProps"
+      "symbolId": "src/bundler:EsbuildBundler"
     },
     "@mrgrain/cdk-esbuild.InlineJavaScriptCode": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@aws-cdk/aws-lambda.InlineCode",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
       },
       "fqn": "@mrgrain/cdk-esbuild.InlineJavaScriptCode",
       "initializer": {
@@ -2240,16 +2215,26 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 32
+          "line": 34
         },
         "parameters": [
           {
+            "docs": {
+              "stability": "experimental",
+              "summary": "The inline code to be transformed."
+            },
             "name": "code",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Please refer to the esbuild Transform API docs for details. \\\nDefault values for `transformOptions`:\n- `loader='js'`",
+              "see": "https://esbuild.github.io/api/#transform-api",
+              "stability": "experimental",
+              "summary": "Transform options passed on to esbuild."
+            },
             "name": "transformOptions",
             "optional": true,
             "type": {
@@ -2261,7 +2246,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 31
+        "line": 33
       },
       "name": "InlineJavaScriptCode",
       "symbolId": "src/inline-code:InlineJavaScriptCode"
@@ -2270,7 +2255,8 @@
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@aws-cdk/aws-lambda.InlineCode",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
       },
       "fqn": "@mrgrain/cdk-esbuild.InlineJsxCode",
       "initializer": {
@@ -2279,16 +2265,26 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 41
+          "line": 63
         },
         "parameters": [
           {
+            "docs": {
+              "stability": "experimental",
+              "summary": "The inline code to be transformed."
+            },
             "name": "code",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Please refer to the esbuild Transform API docs for details. \\\nDefault values for `transformOptions`:\n- `loader='jsx'`",
+              "see": "https://esbuild.github.io/api/#transform-api",
+              "stability": "experimental",
+              "summary": "Transform options passed on to esbuild."
+            },
             "name": "transformOptions",
             "optional": true,
             "type": {
@@ -2300,7 +2296,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 40
+        "line": 62
       },
       "name": "InlineJsxCode",
       "symbolId": "src/inline-code:InlineJsxCode"
@@ -2309,7 +2305,8 @@
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@aws-cdk/aws-lambda.InlineCode",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
       },
       "fqn": "@mrgrain/cdk-esbuild.InlineTsxCode",
       "initializer": {
@@ -2318,16 +2315,26 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 59
+          "line": 121
         },
         "parameters": [
           {
+            "docs": {
+              "stability": "experimental",
+              "summary": "The inline code to be transformed."
+            },
             "name": "code",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Please refer to the esbuild Transform API docs for details. \\\nDefault values for `transformOptions`:\n- `loader='tsx'`",
+              "see": "https://esbuild.github.io/api/#transform-api",
+              "stability": "experimental",
+              "summary": "Transform options passed on to esbuild."
+            },
             "name": "transformOptions",
             "optional": true,
             "type": {
@@ -2339,7 +2346,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 58
+        "line": 120
       },
       "name": "InlineTsxCode",
       "symbolId": "src/inline-code:InlineTsxCode"
@@ -2348,7 +2355,8 @@
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@aws-cdk/aws-lambda.InlineCode",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
       },
       "fqn": "@mrgrain/cdk-esbuild.InlineTypeScriptCode",
       "initializer": {
@@ -2357,16 +2365,26 @@
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 50
+          "line": 92
         },
         "parameters": [
           {
+            "docs": {
+              "stability": "experimental",
+              "summary": "The inline code to be transformed."
+            },
             "name": "code",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Please refer to the esbuild Transform API docs for details. \\\nDefault values for `transformOptions`:\n- `loader='ts'`",
+              "see": "https://esbuild.github.io/api/#transform-api",
+              "stability": "experimental",
+              "summary": "Transform options passed on to esbuild."
+            },
             "name": "transformOptions",
             "optional": true,
             "type": {
@@ -2378,7 +2396,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 49
+        "line": 91
       },
       "name": "InlineTypeScriptCode",
       "symbolId": "src/inline-code:InlineTypeScriptCode"
@@ -2386,16 +2404,18 @@
     "@mrgrain/cdk-esbuild.JavaScriptAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "docs": {
-        "stability": "experimental"
+        "remarks": "The asset can be used by other constructs.",
+        "stability": "stable",
+        "summary": "Bundles the entry points and creates a CDK asset which is uploaded to the bootstrapped CDK S3 bucket during deployment."
       },
       "fqn": "@mrgrain/cdk-esbuild.JavaScriptAsset",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/asset.ts",
-          "line": 40
+          "line": 41
         },
         "parameters": [
           {
@@ -2411,9 +2431,9 @@
             }
           },
           {
-            "name": "__2",
+            "name": "props",
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+              "fqn": "@mrgrain/cdk-esbuild.AssetProps"
             }
           }
         ]
@@ -2421,7 +2441,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/asset.ts",
-        "line": 91
+        "line": 94
       },
       "name": "JavaScriptAsset",
       "symbolId": "src/asset:JavaScriptAsset"
@@ -2429,7 +2449,8 @@
     "@mrgrain/cdk-esbuild.JavaScriptCode": {
       "assembly": "@mrgrain/cdk-esbuild",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Represents the deployed JavaScript Code."
       },
       "fqn": "@mrgrain/cdk-esbuild.JavaScriptCode",
       "initializer": {
@@ -2438,10 +2459,15 @@
         },
         "locationInModule": {
           "filename": "src/code.ts",
-          "line": 107
+          "line": 123
         },
         "parameters": [
           {
+            "docs": {
+              "remarks": "E.g. `src/index.ts`.",
+              "stability": "stable",
+              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            },
             "name": "entryPoints",
             "type": {
               "union": {
@@ -2470,10 +2496,15 @@
             }
           },
           {
+            "docs": {
+              "remarks": "Default values for `props.buildOptions`:\n- `bundle=true`\n- `platform=node`\n- `target=nodeX` with X being the major node version running locally",
+              "stability": "stable",
+              "summary": "Props to change the behavior of the bundler."
+            },
             "name": "props",
             "optional": true,
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildProps"
+              "fqn": "@mrgrain/cdk-esbuild.JavaScriptCodeProps"
             }
           }
         ]
@@ -2481,7 +2512,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 104
+        "line": 120
       },
       "methods": [
         {
@@ -2490,7 +2521,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 68
+            "line": 73
           },
           "name": "bind",
           "parameters": [
@@ -2509,11 +2540,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Specifically it's required to allow assets to add\nmetadata for tooling like SAM CLI to be able to find their origins.",
+            "stability": "stable",
+            "summary": "Called after the CFN function resource has been created to allow the code class to bind to it."
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 94
+            "line": 105
           },
           "name": "bindToResource",
           "parameters": [
@@ -2535,6 +2568,21 @@
       ],
       "name": "JavaScriptCode",
       "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/code.ts",
+            "line": 121
+          },
+          "name": "assetClass",
+          "protected": true,
+          "type": {
+            "fqn": "@mrgrain/cdk-esbuild.JavaScriptAsset"
+          }
+        },
         {
           "docs": {
             "stability": "stable"
@@ -2560,15 +2608,17 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "deprecated": "this value is ignored since inline is now determined based on the the inlineCode field of CodeConfig returned from bind().",
+            "stability": "deprecated",
+            "summary": "Determines whether this Code is inline code or not."
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 105
+            "line": 48
           },
-          "name": "assetClass",
+          "name": "isInline",
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.JavaScriptAsset"
+            "primitive": "boolean"
           }
         },
         {
@@ -2577,29 +2627,54 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 43
+            "line": 39
           },
-          "name": "isInline",
+          "name": "props",
+          "protected": true,
           "type": {
-            "primitive": "boolean"
+            "fqn": "@mrgrain/cdk-esbuild.AssetProps"
           }
-        },
+        }
+      ],
+      "symbolId": "src/code:JavaScriptCode"
+    },
+    "@mrgrain/cdk-esbuild.JavaScriptCodeProps": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.JavaScriptCodeProps",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.BundlerProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/code.ts",
+        "line": 26
+      },
+      "name": "JavaScriptCodeProps",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "As this is a plain string, it can be used in construct IDs in order to enforce creation of a new resource when the content hash has changed.\n\nDefaults to a hash of all files in the resulting bundle.",
+            "stability": "stable",
+            "summary": "A hash of this asset, which is available at construction time."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/code.ts",
-            "line": 39
+            "filename": "src/asset.ts",
+            "line": 19
           },
-          "name": "props",
-          "protected": true,
+          "name": "assetHash",
+          "optional": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+            "primitive": "string"
           }
         }
       ],
-      "symbolId": "src/code:JavaScriptCode"
+      "symbolId": "src/code:JavaScriptCodeProps"
     },
     "@mrgrain/cdk-esbuild.JavaScriptSource": {
       "assembly": "@mrgrain/cdk-esbuild",
@@ -2613,7 +2688,7 @@
         },
         "locationInModule": {
           "filename": "src/source.ts",
-          "line": 87
+          "line": 88
         },
         "parameters": [
           {
@@ -2648,7 +2723,7 @@
             "name": "props",
             "optional": true,
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildProps"
+              "fqn": "@mrgrain/cdk-esbuild.JavaScriptSourceProps"
             }
           }
         ]
@@ -2659,7 +2734,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/source.ts",
-        "line": 81
+        "line": 82
       },
       "methods": [
         {
@@ -2669,7 +2744,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 47
+            "line": 48
           },
           "name": "bind",
           "overrides": "@aws-cdk/aws-s3-deployment.ISource",
@@ -2703,7 +2778,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 25
+            "line": 26
           },
           "name": "asset",
           "protected": true,
@@ -2726,7 +2801,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 85
+            "line": 86
           },
           "name": "assetClass",
           "type": {
@@ -2739,168 +2814,54 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 23
+            "line": 24
           },
           "name": "props",
           "protected": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+            "fqn": "@mrgrain/cdk-esbuild.AssetProps"
           }
         }
       ],
       "symbolId": "src/source:JavaScriptSource"
     },
-    "@mrgrain/cdk-esbuild.LocalBundler": {
+    "@mrgrain/cdk-esbuild.JavaScriptSourceProps": {
       "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "@mrgrain/cdk-esbuild.LocalBundler",
-      "initializer": {
-        "docs": {
-          "stability": "stable"
-        },
-        "locationInModule": {
-          "filename": "src/bundlers.ts",
-          "line": 46
-        },
-        "parameters": [
-          {
-            "name": "buildOptions",
-            "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildOptions"
-            }
-          },
-          {
-            "name": "props",
-            "optional": true,
-            "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildBundlingProps"
-            }
-          }
-        ]
-      },
+      "fqn": "@mrgrain/cdk-esbuild.JavaScriptSourceProps",
       "interfaces": [
-        "@aws-cdk/core.ILocalBundling"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/bundlers.ts",
-        "line": 45
-      },
-      "methods": [
-        {
-          "docs": {
-            "remarks": "If the local bundler exists, and bundling\nwas performed locally, return `true`. Otherwise, return `false`.",
-            "stability": "stable",
-            "summary": "This method is called before attempting docker bundling to allow the bundler to be executed locally."
-          },
-          "locationInModule": {
-            "filename": "src/bundlers.ts",
-            "line": 51
-          },
-          "name": "tryBundle",
-          "overrides": "@aws-cdk/core.ILocalBundling",
-          "parameters": [
-            {
-              "name": "outputDir",
-              "type": {
-                "primitive": "string"
-              }
-            },
-            {
-              "name": "_options",
-              "type": {
-                "fqn": "@aws-cdk/core.BundlingOptions"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "primitive": "boolean"
-            }
-          }
-        }
-      ],
-      "name": "LocalBundler",
-      "properties": [
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundlers.ts",
-            "line": 47
-          },
-          "name": "buildOptions",
-          "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildOptions"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundlers.ts",
-            "line": 48
-          },
-          "name": "props",
-          "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildBundlingProps"
-          }
-        }
+        "@mrgrain/cdk-esbuild.BundlerProps"
       ],
-      "symbolId": "src/bundlers:LocalBundler"
-    },
-    "@mrgrain/cdk-esbuild.Location": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "@mrgrain/cdk-esbuild.Location",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/code.ts",
-        "line": 17
+        "filename": "src/source.ts",
+        "line": 11
       },
-      "name": "Location",
+      "name": "JavaScriptSourceProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/code.ts",
-            "line": 18
-          },
-          "name": "bucketName",
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
+            "remarks": "As this is a plain string, it can be used in construct IDs in order to enforce creation of a new resource when the content hash has changed.\n\nDefaults to a hash of all files in the resulting bundle.",
+            "stability": "stable",
+            "summary": "A hash of this asset, which is available at construction time."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/code.ts",
+            "filename": "src/asset.ts",
             "line": 19
           },
-          "name": "objectKey",
+          "name": "assetHash",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
         }
       ],
-      "symbolId": "src/code:Location"
+      "symbolId": "src/source:JavaScriptSourceProps"
     },
     "@mrgrain/cdk-esbuild.TransformOptions": {
       "assembly": "@mrgrain/cdk-esbuild",
@@ -2912,7 +2873,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/esbuild-types.ts",
-        "line": 156
+        "line": 158
       },
       "name": "TransformOptions",
       "properties": [
@@ -2924,7 +2885,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 160
+            "line": 163
           },
           "name": "banner",
           "optional": true,
@@ -2940,7 +2901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 21
+            "line": 23
           },
           "name": "charset",
           "optional": true,
@@ -2956,7 +2917,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 33
+            "line": 35
           },
           "name": "color",
           "optional": true,
@@ -2972,7 +2933,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 29
+            "line": 31
           },
           "name": "define",
           "optional": true,
@@ -2993,7 +2954,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 161
+            "line": 164
           },
           "name": "footer",
           "optional": true,
@@ -3009,7 +2970,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 13
+            "line": 15
           },
           "name": "format",
           "optional": true,
@@ -3025,7 +2986,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 14
+            "line": 16
           },
           "name": "globalName",
           "optional": true,
@@ -3041,7 +3002,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 23
+            "line": 25
           },
           "name": "ignoreAnnotations",
           "optional": true,
@@ -3057,7 +3018,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 25
+            "line": 27
           },
           "name": "jsx",
           "optional": true,
@@ -3073,7 +3034,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 26
+            "line": 28
           },
           "name": "jsxFactory",
           "optional": true,
@@ -3089,7 +3050,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 27
+            "line": 29
           },
           "name": "jsxFragment",
           "optional": true,
@@ -3105,7 +3066,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 31
+            "line": 33
           },
           "name": "keepNames",
           "optional": true,
@@ -3121,7 +3082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 9
+            "line": 11
           },
           "name": "legalComments",
           "optional": true,
@@ -3137,7 +3098,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 159
+            "line": 162
           },
           "name": "loader",
           "optional": true,
@@ -3153,7 +3114,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 34
+            "line": 36
           },
           "name": "logLevel",
           "optional": true,
@@ -3169,7 +3130,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 35
+            "line": 37
           },
           "name": "logLimit",
           "optional": true,
@@ -3185,7 +3146,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 17
+            "line": 19
           },
           "name": "minify",
           "optional": true,
@@ -3201,7 +3162,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 19
+            "line": 21
           },
           "name": "minifyIdentifiers",
           "optional": true,
@@ -3217,7 +3178,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 20
+            "line": 22
           },
           "name": "minifySyntax",
           "optional": true,
@@ -3233,7 +3194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 18
+            "line": 20
           },
           "name": "minifyWhitespace",
           "optional": true,
@@ -3249,7 +3210,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 30
+            "line": 32
           },
           "name": "pure",
           "optional": true,
@@ -3270,7 +3231,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 158
+            "line": 161
           },
           "name": "sourcefile",
           "optional": true,
@@ -3286,7 +3247,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 8
+            "line": 10
           },
           "name": "sourcemap",
           "optional": true,
@@ -3311,7 +3272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 10
+            "line": 12
           },
           "name": "sourceRoot",
           "optional": true,
@@ -3327,7 +3288,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 11
+            "line": 13
           },
           "name": "sourcesContent",
           "optional": true,
@@ -3343,7 +3304,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 15
+            "line": 17
           },
           "name": "target",
           "optional": true,
@@ -3373,7 +3334,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 22
+            "line": 24
           },
           "name": "treeShaking",
           "optional": true,
@@ -3389,7 +3350,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 157
+            "line": 159
           },
           "name": "tsconfigRaw",
           "optional": true,
@@ -3403,16 +3364,18 @@
     "@mrgrain/cdk-esbuild.TypeScriptAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "docs": {
-        "stability": "experimental"
+        "remarks": "The asset can be used by other constructs.",
+        "stability": "stable",
+        "summary": "Bundles the entry points and creates a CDK asset which is uploaded to the bootstrapped CDK S3 bucket during deployment."
       },
       "fqn": "@mrgrain/cdk-esbuild.TypeScriptAsset",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/asset.ts",
-          "line": 40
+          "line": 41
         },
         "parameters": [
           {
@@ -3428,9 +3391,9 @@
             }
           },
           {
-            "name": "__2",
+            "name": "props",
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+              "fqn": "@mrgrain/cdk-esbuild.AssetProps"
             }
           }
         ]
@@ -3438,7 +3401,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/asset.ts",
-        "line": 96
+        "line": 103
       },
       "name": "TypeScriptAsset",
       "symbolId": "src/asset:TypeScriptAsset"
@@ -3446,7 +3409,8 @@
     "@mrgrain/cdk-esbuild.TypeScriptCode": {
       "assembly": "@mrgrain/cdk-esbuild",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Represents the deployed TypeScript Code."
       },
       "fqn": "@mrgrain/cdk-esbuild.TypeScriptCode",
       "initializer": {
@@ -3455,10 +3419,15 @@
         },
         "locationInModule": {
           "filename": "src/code.ts",
-          "line": 117
+          "line": 155
         },
         "parameters": [
           {
+            "docs": {
+              "remarks": "E.g. `src/index.ts`.",
+              "stability": "stable",
+              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            },
             "name": "entryPoints",
             "type": {
               "union": {
@@ -3487,10 +3456,15 @@
             }
           },
           {
+            "docs": {
+              "remarks": "Default values for `props.buildOptions`:\n- `bundle=true`\n- `platform=node`\n- `target=nodeX` with X being the major node version running locally",
+              "stability": "stable",
+              "summary": "Props to change the behavior of the bundler."
+            },
             "name": "props",
             "optional": true,
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildProps"
+              "fqn": "@mrgrain/cdk-esbuild.TypeScriptCodeProps"
             }
           }
         ]
@@ -3498,7 +3472,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 114
+        "line": 152
       },
       "methods": [
         {
@@ -3507,7 +3481,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 68
+            "line": 73
           },
           "name": "bind",
           "parameters": [
@@ -3526,11 +3500,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Specifically it's required to allow assets to add\nmetadata for tooling like SAM CLI to be able to find their origins.",
+            "stability": "stable",
+            "summary": "Called after the CFN function resource has been created to allow the code class to bind to it."
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 94
+            "line": 105
           },
           "name": "bindToResource",
           "parameters": [
@@ -3552,6 +3528,21 @@
       ],
       "name": "TypeScriptCode",
       "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/code.ts",
+            "line": 153
+          },
+          "name": "assetClass",
+          "protected": true,
+          "type": {
+            "fqn": "@mrgrain/cdk-esbuild.TypeScriptAsset"
+          }
+        },
         {
           "docs": {
             "stability": "stable"
@@ -3577,15 +3568,17 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "deprecated": "this value is ignored since inline is now determined based on the the inlineCode field of CodeConfig returned from bind().",
+            "stability": "deprecated",
+            "summary": "Determines whether this Code is inline code or not."
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 115
+            "line": 48
           },
-          "name": "assetClass",
+          "name": "isInline",
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.TypeScriptAsset"
+            "primitive": "boolean"
           }
         },
         {
@@ -3594,29 +3587,54 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 43
+            "line": 39
           },
-          "name": "isInline",
+          "name": "props",
+          "protected": true,
           "type": {
-            "primitive": "boolean"
+            "fqn": "@mrgrain/cdk-esbuild.AssetProps"
           }
-        },
+        }
+      ],
+      "symbolId": "src/code:TypeScriptCode"
+    },
+    "@mrgrain/cdk-esbuild.TypeScriptCodeProps": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.TypeScriptCodeProps",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.BundlerProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/code.ts",
+        "line": 27
+      },
+      "name": "TypeScriptCodeProps",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "As this is a plain string, it can be used in construct IDs in order to enforce creation of a new resource when the content hash has changed.\n\nDefaults to a hash of all files in the resulting bundle.",
+            "stability": "stable",
+            "summary": "A hash of this asset, which is available at construction time."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/code.ts",
-            "line": 39
+            "filename": "src/asset.ts",
+            "line": 19
           },
-          "name": "props",
-          "protected": true,
+          "name": "assetHash",
+          "optional": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+            "primitive": "string"
           }
         }
       ],
-      "symbolId": "src/code:TypeScriptCode"
+      "symbolId": "src/code:TypeScriptCodeProps"
     },
     "@mrgrain/cdk-esbuild.TypeScriptSource": {
       "assembly": "@mrgrain/cdk-esbuild",
@@ -3630,7 +3648,7 @@
         },
         "locationInModule": {
           "filename": "src/source.ts",
-          "line": 101
+          "line": 102
         },
         "parameters": [
           {
@@ -3665,7 +3683,7 @@
             "name": "props",
             "optional": true,
             "type": {
-              "fqn": "@mrgrain/cdk-esbuild.EsbuildProps"
+              "fqn": "@mrgrain/cdk-esbuild.TypeScriptSourceProps"
             }
           }
         ]
@@ -3676,7 +3694,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/source.ts",
-        "line": 95
+        "line": 96
       },
       "methods": [
         {
@@ -3686,7 +3704,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 47
+            "line": 48
           },
           "name": "bind",
           "overrides": "@aws-cdk/aws-s3-deployment.ISource",
@@ -3720,7 +3738,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 25
+            "line": 26
           },
           "name": "asset",
           "protected": true,
@@ -3743,7 +3761,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 99
+            "line": 100
           },
           "name": "assetClass",
           "type": {
@@ -3756,18 +3774,56 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 23
+            "line": 24
           },
           "name": "props",
           "protected": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.EsbuildAssetProps"
+            "fqn": "@mrgrain/cdk-esbuild.AssetProps"
           }
         }
       ],
       "symbolId": "src/source:TypeScriptSource"
+    },
+    "@mrgrain/cdk-esbuild.TypeScriptSourceProps": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.TypeScriptSourceProps",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.BundlerProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/source.ts",
+        "line": 12
+      },
+      "name": "TypeScriptSourceProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "As this is a plain string, it can be used in construct IDs in order to enforce creation of a new resource when the content hash has changed.\n\nDefaults to a hash of all files in the resulting bundle.",
+            "stability": "stable",
+            "summary": "A hash of this asset, which is available at construction time."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset.ts",
+            "line": 19
+          },
+          "name": "assetHash",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/source:TypeScriptSourceProps"
     }
   },
-  "version": "2.0.0-alpha.0",
-  "fingerprint": "BwAqft59KLNBkqOMqrUI1zzg62FMlqUWiymEl6Yb5WU="
+  "version": "2.0.0-alpha.5",
+  "fingerprint": "AdL6hJY8jZk+fh5n+ST+KSygY3qF3N0pEjQ75LE0OcQ="
 }