@mrgrain/cdk-esbuild 3.4.0 → 3.7.0

package/API.md

@@ -1,5 +1,114 @@
 # API Reference <a name="API Reference"></a>
 
+## Constructs <a name="Constructs"></a>
+
+### EsbuildAsset <a name="@mrgrain/cdk-esbuild.EsbuildAsset"></a>
+
+Represents a generic esbuild asset.
+
+You should always use `TypeScriptAsset` or `JavaScriptAsset`.
+
+#### Initializers <a name="@mrgrain/cdk-esbuild.EsbuildAsset.Initializer"></a>
+
+```typescript
+import { EsbuildAsset } from '@mrgrain/cdk-esbuild'
+
+new EsbuildAsset(scope: Construct, id: string, props: AssetProps)
+```
+
+##### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildAsset.parameter.scope"></a>
+
+- *Type:* [`constructs.Construct`](#constructs.Construct)
+
+---
+
+##### `id`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildAsset.parameter.id"></a>
+
+- *Type:* `string`
+
+---
+
+##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildAsset.parameter.props"></a>
+
+- *Type:* [`@mrgrain/cdk-esbuild.AssetProps`](#@mrgrain/cdk-esbuild.AssetProps)
+
+---
+
+
+
+
+
+### JavaScriptAsset <a name="@mrgrain/cdk-esbuild.JavaScriptAsset"></a>
+
+Bundles 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.
+
+#### Initializers <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.Initializer"></a>
+
+```typescript
+import { JavaScriptAsset } from '@mrgrain/cdk-esbuild'
+
+new JavaScriptAsset(scope: Construct, id: string, props: AssetProps)
+```
+
+##### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.scope"></a>
+
+- *Type:* [`constructs.Construct`](#constructs.Construct)
+
+---
+
+##### `id`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.id"></a>
+
+- *Type:* `string`
+
+---
+
+##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.props"></a>
+
+- *Type:* [`@mrgrain/cdk-esbuild.AssetProps`](#@mrgrain/cdk-esbuild.AssetProps)
+
+---
+
+
+
+
+
+### TypeScriptAsset <a name="@mrgrain/cdk-esbuild.TypeScriptAsset"></a>
+
+Bundles 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.
+
+#### Initializers <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.Initializer"></a>
+
+```typescript
+import { TypeScriptAsset } from '@mrgrain/cdk-esbuild'
+
+new TypeScriptAsset(scope: Construct, id: string, props: AssetProps)
+```
+
+##### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.scope"></a>
+
+- *Type:* [`constructs.Construct`](#constructs.Construct)
+
+---
+
+##### `id`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.id"></a>
+
+- *Type:* `string`
+
+---
+
+##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.props"></a>
+
+- *Type:* [`@mrgrain/cdk-esbuild.AssetProps`](#@mrgrain/cdk-esbuild.AssetProps)
+
+---
+
+
+
+
 
 ## Structs <a name="Structs"></a>
 
@@ -82,6 +191,20 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.AssetProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ##### `entryPoints`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.AssetProps.property.entryPoints"></a>
 
 ```typescript
@@ -90,9 +213,18 @@ public readonly entryPoints: string | string[] | {[ key: string ]: string};
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
-A relative path or list or map of relative paths to the entry points of your code from the root of the project.
+A path or list or map of paths to the entry points of your code.
 
-E.g. `src/index.ts`.
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
 
 ---
 
@@ -446,6 +578,18 @@ Documentation: https://esbuild.github.io/api/#log-limit.
 
 ---
 
+##### `logOverride`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.BuildOptions.property.logOverride"></a>
+
+```typescript
+public readonly logOverride: {[ key: string ]: string};
+```
+
+- *Type:* {[ key: string ]: `string`}
+
+Documentation: https://esbuild.github.io/api/#log-override.
+
+---
+
 ##### `mainFields`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.BuildOptions.property.mainFields"></a>
 
 ```typescript
@@ -734,6 +878,18 @@ Documentation: https://esbuild.github.io/api/#splitting.
 
 ---
 
+##### `supported`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.BuildOptions.property.supported"></a>
+
+```typescript
+public readonly supported: {[ key: string ]: boolean};
+```
+
+- *Type:* {[ key: string ]: `boolean`}
+
+Documentation: https://esbuild.github.io/api/#supported.
+
+---
+
 ##### `target`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.BuildOptions.property.target"></a>
 
 ```typescript
@@ -861,8 +1017,24 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.BundlerProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ### CodeConfig <a name="@mrgrain/cdk-esbuild.CodeConfig"></a>
 
+Result of binding `Code` into a `Function`.
+
 #### Initializer <a name="[object Object].Initializer"></a>
 
 ```typescript
@@ -871,15 +1043,42 @@ import { CodeConfig } from '@mrgrain/cdk-esbuild'
 const codeConfig: CodeConfig = { ... }
 ```
 
-##### `s3Location`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.CodeConfig.property.s3Location"></a>
+##### `image`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.CodeConfig.property.image"></a>
+
+```typescript
+public readonly image: CodeImageConfig;
+```
+
+- *Type:* [`aws-cdk-lib.aws_lambda.CodeImageConfig`](#aws-cdk-lib.aws_lambda.CodeImageConfig)
+- *Default:* code is not an ECR container image
+
+Docker image configuration (mutually exclusive with `s3Location` and `inlineCode`).
+
+---
+
+##### `inlineCode`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.CodeConfig.property.inlineCode"></a>
+
+```typescript
+public readonly inlineCode: string;
+```
+
+- *Type:* `string`
+- *Default:* code is not inline code
+
+Inline code (mutually exclusive with `s3Location` and `image`).
+
+---
+
+##### `s3Location`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.CodeConfig.property.s3Location"></a>
 
 ```typescript
 public readonly s3Location: Location;
 ```
 
 - *Type:* [`aws-cdk-lib.aws_s3.Location`](#aws-cdk-lib.aws_s3.Location)
+- *Default:* code is not an s3 location
 
-The location of the code in S3.
+The location of the code in S3 (mutually exclusive with `inlineCode` and `image`).
 
 ---
 
@@ -962,6 +1161,20 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCodeProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ##### `assetHash`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCodeProps.property.assetHash"></a>
 
 ```typescript
@@ -1057,6 +1270,20 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptSourceProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ##### `assetHash`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptSourceProps.property.assetHash"></a>
 
 ```typescript
@@ -1323,6 +1550,18 @@ Documentation: https://esbuild.github.io/api/#log-limit.
 
 ---
 
+##### `logOverride`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TransformOptions.property.logOverride"></a>
+
+```typescript
+public readonly logOverride: {[ key: string ]: string};
+```
+
+- *Type:* {[ key: string ]: `string`}
+
+Documentation: https://esbuild.github.io/api/#log-override.
+
+---
+
 ##### `mangleCache`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TransformOptions.property.mangleCache"></a>
 
 ```typescript
@@ -1477,6 +1716,18 @@ Documentation: https://esbuild.github.io/api/#sources-content.
 
 ---
 
+##### `supported`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TransformOptions.property.supported"></a>
+
+```typescript
+public readonly supported: {[ key: string ]: boolean};
+```
+
+- *Type:* {[ key: string ]: `boolean`}
+
+Documentation: https://esbuild.github.io/api/#supported.
+
+---
+
 ##### `target`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TransformOptions.property.target"></a>
 
 ```typescript
@@ -1590,6 +1841,20 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCodeProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ##### `assetHash`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCodeProps.property.assetHash"></a>
 
 ```typescript
@@ -1685,6 +1950,20 @@ Instead use only relative paths and avoid `..`.
 
 ---
 
+##### `esbuildBinaryPath`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptSourceProps.property.esbuildBinaryPath"></a>
+
+```typescript
+public readonly esbuildBinaryPath: string;
+```
+
+- *Type:* `string`
+
+Path to the binary used by esbuild.
+
+This is the same as setting the ESBUILD_BINARY_PATH environment variable.
+
+---
+
 ##### `assetHash`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptSourceProps.property.assetHash"></a>
 
 ```typescript
@@ -1721,9 +2000,18 @@ new EsbuildBundler(entryPoints: string | string[] | {[ key: string ]: string}, p
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
-A relative path or list or map of relative paths to the entry points of your code from the root of the project.
+A path or list or map of paths to the entry points of your code.
 
-E.g. `src/index.ts`.
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
 
 ---
 
@@ -1747,9 +2035,18 @@ public readonly entryPoints: string | string[] | {[ key: string ]: string};
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
-A relative path or list or map of relative paths to the entry points of your code from the root of the project.
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
 
-E.g. `src/index.ts`.
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
 
 ---
 
@@ -1790,6 +2087,125 @@ Props to change the behaviour of the bundler.
 ---
 
 
+### EsbuildCode <a name="@mrgrain/cdk-esbuild.EsbuildCode"></a>
+
+Represents a generic esbuild code bundle.
+
+You should always use `TypeScriptCode` or `JavaScriptCode`.
+
+#### Initializers <a name="@mrgrain/cdk-esbuild.EsbuildCode.Initializer"></a>
+
+```typescript
+import { EsbuildCode } from '@mrgrain/cdk-esbuild'
+
+new EsbuildCode(entryPoints: string | string[] | {[ key: string ]: string}, props: JavaScriptCodeProps | TypeScriptCodeProps)
+```
+
+##### `entryPoints`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.parameter.entryPoints"></a>
+
+- *Type:* `string` | `string`[] | {[ key: string ]: `string`}
+
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
+
+---
+
+##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.parameter.props"></a>
+
+- *Type:* [`@mrgrain/cdk-esbuild.JavaScriptCodeProps`](#@mrgrain/cdk-esbuild.JavaScriptCodeProps) | [`@mrgrain/cdk-esbuild.TypeScriptCodeProps`](#@mrgrain/cdk-esbuild.TypeScriptCodeProps)
+
+Props to change the behavior of the bundler.
+
+Default values for `props.buildOptions`:
+- `bundle=true`
+- `platform=node`
+- `target=nodeX` with X being the major node version running locally
+
+---
+
+#### Methods <a name="Methods"></a>
+
+##### `bind` <a name="@mrgrain/cdk-esbuild.EsbuildCode.bind"></a>
+
+```typescript
+public bind(scope: Construct)
+```
+
+###### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.parameter.scope"></a>
+
+- *Type:* [`constructs.Construct`](#constructs.Construct)
+
+---
+
+##### `bindToResource` <a name="@mrgrain/cdk-esbuild.EsbuildCode.bindToResource"></a>
+
+```typescript
+public bindToResource(resource: CfnResource, options?: ResourceBindOptions)
+```
+
+###### `resource`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.parameter.resource"></a>
+
+- *Type:* [`aws-cdk-lib.CfnResource`](#aws-cdk-lib.CfnResource)
+
+---
+
+###### `options`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.parameter.options"></a>
+
+- *Type:* [`aws-cdk-lib.aws_lambda.ResourceBindOptions`](#aws-cdk-lib.aws_lambda.ResourceBindOptions)
+
+---
+
+
+#### Properties <a name="Properties"></a>
+
+##### `entryPoints`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.property.entryPoints"></a>
+
+```typescript
+public readonly entryPoints: string | string[] | {[ key: string ]: string};
+```
+
+- *Type:* `string` | `string`[] | {[ key: string ]: `string`}
+
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
+
+---
+
+##### ~~`isInline`~~<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.EsbuildCode.property.isInline"></a>
+
+- *Deprecated:* this value is ignored since inline is now determined based on the the inlineCode field of CodeConfig returned from bind().
+
+```typescript
+public readonly isInline: boolean;
+```
+
+- *Type:* `boolean`
+
+Determines whether this Code is inline code or not.
+
+---
+
+
 ### InlineJavaScriptCode <a name="@mrgrain/cdk-esbuild.InlineJavaScriptCode"></a>
 
 An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation.
@@ -1946,42 +2362,6 @@ Default values for `transformOptions`:
 
 
 
-### JavaScriptAsset <a name="@mrgrain/cdk-esbuild.JavaScriptAsset"></a>
-
-Bundles 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.
-
-#### Initializers <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.Initializer"></a>
-
-```typescript
-import { JavaScriptAsset } from '@mrgrain/cdk-esbuild'
-
-new JavaScriptAsset(scope: Construct, id: string, props: AssetProps)
-```
-
-##### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.scope"></a>
-
-- *Type:* [`constructs.Construct`](#constructs.Construct)
-
----
-
-##### `id`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.id"></a>
-
-- *Type:* `string`
-
----
-
-##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptAsset.parameter.props"></a>
-
-- *Type:* [`@mrgrain/cdk-esbuild.AssetProps`](#@mrgrain/cdk-esbuild.AssetProps)
-
----
-
-
-
-
-
 ### JavaScriptCode <a name="@mrgrain/cdk-esbuild.JavaScriptCode"></a>
 
 Represents the deployed JavaScript Code.
@@ -1998,9 +2378,18 @@ new JavaScriptCode(entryPoints: string | string[] | {[ key: string ]: string}, p
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
-A relative path or list or map of relative paths to the entry points of your code from the root of the project.
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
 
-E.g. `src/index.ts`.
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
 
 ---
 
@@ -2017,54 +2406,8 @@ Default values for `props.buildOptions`:
 
 ---
 
-#### Methods <a name="Methods"></a>
-
-##### `bind` <a name="@mrgrain/cdk-esbuild.JavaScriptCode.bind"></a>
-
-```typescript
-public bind(scope: Construct)
-```
-
-###### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCode.parameter.scope"></a>
-
-- *Type:* [`constructs.Construct`](#constructs.Construct)
-
----
-
-##### `bindToResource` <a name="@mrgrain/cdk-esbuild.JavaScriptCode.bindToResource"></a>
-
-```typescript
-public bindToResource(resource: CfnResource, options?: ResourceBindOptions)
-```
-
-###### `resource`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCode.parameter.resource"></a>
-
-- *Type:* [`aws-cdk-lib.CfnResource`](#aws-cdk-lib.CfnResource)
-
----
-
-###### `options`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCode.parameter.options"></a>
-
-- *Type:* [`aws-cdk-lib.aws_lambda.ResourceBindOptions`](#aws-cdk-lib.aws_lambda.ResourceBindOptions)
-
----
-
-
-#### Properties <a name="Properties"></a>
-
-##### ~~`isInline`~~<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptCode.property.isInline"></a>
-
-- *Deprecated:* this value is ignored since inline is now determined based on the the inlineCode field of CodeConfig returned from bind().
-
-```typescript
-public readonly isInline: boolean;
-```
-
-- *Type:* `boolean`
 
-Determines whether this Code is inline code or not.
 
----
 
 
 ### JavaScriptSource <a name="@mrgrain/cdk-esbuild.JavaScriptSource"></a>
@@ -2083,12 +2426,31 @@ new JavaScriptSource(entryPoints: string | string[] | {[ key: string ]: string},
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
+
 ---
 
 ##### `props`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.JavaScriptSource.parameter.props"></a>
 
 - *Type:* [`@mrgrain/cdk-esbuild.JavaScriptSourceProps`](#@mrgrain/cdk-esbuild.JavaScriptSourceProps)
 
+Props to change the behavior of the bundler.
+
+Default values for `props.buildOptions`:
+- `bundle=true`
+- `platform=browser`
+
 ---
 
 #### Methods <a name="Methods"></a>
@@ -2125,42 +2487,6 @@ public readonly assetClass: JavaScriptAsset;
 ---
 
 
-### TypeScriptAsset <a name="@mrgrain/cdk-esbuild.TypeScriptAsset"></a>
-
-Bundles 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.
-
-#### Initializers <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.Initializer"></a>
-
-```typescript
-import { TypeScriptAsset } from '@mrgrain/cdk-esbuild'
-
-new TypeScriptAsset(scope: Construct, id: string, props: AssetProps)
-```
-
-##### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.scope"></a>
-
-- *Type:* [`constructs.Construct`](#constructs.Construct)
-
----
-
-##### `id`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.id"></a>
-
-- *Type:* `string`
-
----
-
-##### `props`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptAsset.parameter.props"></a>
-
-- *Type:* [`@mrgrain/cdk-esbuild.AssetProps`](#@mrgrain/cdk-esbuild.AssetProps)
-
----
-
-
-
-
-
 ### TypeScriptCode <a name="@mrgrain/cdk-esbuild.TypeScriptCode"></a>
 
 Represents the deployed TypeScript Code.
@@ -2177,9 +2503,18 @@ new TypeScriptCode(entryPoints: string | string[] | {[ key: string ]: string}, p
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
-A relative path or list or map of relative paths to the entry points of your code from the root of the project.
+A path or list or map of paths to the entry points of your code.
 
-E.g. `src/index.ts`.
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
 
 ---
 
@@ -2196,54 +2531,8 @@ Default values for `props.buildOptions`:
 
 ---
 
-#### Methods <a name="Methods"></a>
-
-##### `bind` <a name="@mrgrain/cdk-esbuild.TypeScriptCode.bind"></a>
-
-```typescript
-public bind(scope: Construct)
-```
-
-###### `scope`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCode.parameter.scope"></a>
-
-- *Type:* [`constructs.Construct`](#constructs.Construct)
-
----
-
-##### `bindToResource` <a name="@mrgrain/cdk-esbuild.TypeScriptCode.bindToResource"></a>
 
-```typescript
-public bindToResource(resource: CfnResource, options?: ResourceBindOptions)
-```
 
-###### `resource`<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCode.parameter.resource"></a>
-
-- *Type:* [`aws-cdk-lib.CfnResource`](#aws-cdk-lib.CfnResource)
-
----
-
-###### `options`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCode.parameter.options"></a>
-
-- *Type:* [`aws-cdk-lib.aws_lambda.ResourceBindOptions`](#aws-cdk-lib.aws_lambda.ResourceBindOptions)
-
----
-
-
-#### Properties <a name="Properties"></a>
-
-##### ~~`isInline`~~<sup>Required</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptCode.property.isInline"></a>
-
-- *Deprecated:* this value is ignored since inline is now determined based on the the inlineCode field of CodeConfig returned from bind().
-
-```typescript
-public readonly isInline: boolean;
-```
-
-- *Type:* `boolean`
-
-Determines whether this Code is inline code or not.
-
----
 
 
 ### TypeScriptSource <a name="@mrgrain/cdk-esbuild.TypeScriptSource"></a>
@@ -2262,12 +2551,31 @@ new TypeScriptSource(entryPoints: string | string[] | {[ key: string ]: string},
 
 - *Type:* `string` | `string`[] | {[ key: string ]: `string`}
 
+A path or list or map of paths to the entry points of your code.
+
+Relative paths are by default resolved from the current working directory.
+To change the working directory, see `buildOptions.absWorkingDir`.
+
+Absolute paths can be used if files are part of the working directory.
+
+Examples:
+  - `'src/index.ts'`
+  - `require.resolve('./lambda')`
+  - `['src/index.ts', 'src/util.ts']`
+  - `{one: 'src/two.ts', two: 'src/one.ts'}`
+
 ---
 
 ##### `props`<sup>Optional</sup> <a name="@mrgrain/cdk-esbuild.TypeScriptSource.parameter.props"></a>
 
 - *Type:* [`@mrgrain/cdk-esbuild.TypeScriptSourceProps`](#@mrgrain/cdk-esbuild.TypeScriptSourceProps)
 
+Props to change the behavior of the bundler.
+
+Default values for `props.buildOptions`:
+- `bundle=true`
+- `platform=browser`
+
 ---
 
 #### Methods <a name="Methods"></a>