terraconstructs 0.0.24 → 0.1.0

package/go.mod

@@ -9,15 +9,16 @@ go 1.22.2
 replace github.com/jmespath/go-jmespath => github.com/AndrewKlopper/go-jmespath v0.4.1
 
 require (
-	github.com/aws/aws-sdk-go-v2 v1.32.7
+	github.com/aws/aws-sdk-go-v2 v1.36.5
 	github.com/aws/aws-sdk-go-v2/config v1.28.5
+	github.com/aws/aws-sdk-go-v2/feature/dynamodb/attributevalue v1.19.3
 	github.com/aws/aws-sdk-go-v2/service/acm v1.30.6
 	github.com/aws/aws-sdk-go-v2/service/applicationautoscaling v1.33.6
 	github.com/aws/aws-sdk-go-v2/service/cloudfront v1.38.7
 	github.com/aws/aws-sdk-go-v2/service/cloudwatch v1.43.4
 	github.com/aws/aws-sdk-go-v2/service/cloudwatchevents v1.27.3
 	github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs v1.44.0
-	github.com/aws/aws-sdk-go-v2/service/dynamodb v1.37.1
+	github.com/aws/aws-sdk-go-v2/service/dynamodb v1.43.4
 	github.com/aws/aws-sdk-go-v2/service/ec2 v1.193.0
 	github.com/aws/aws-sdk-go-v2/service/eventbridge v1.36.1
 	github.com/aws/aws-sdk-go-v2/service/iam v1.38.1
@@ -48,17 +49,18 @@ require (
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.46 // indirect
 	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.20 // indirect
 	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.41 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.26 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.26 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.36 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.36 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.26 // indirect
 	github.com/aws/aws-sdk-go-v2/service/autoscaling v1.51.0 // indirect
 	github.com/aws/aws-sdk-go-v2/service/codeartifact v1.30.3 // indirect
+	github.com/aws/aws-sdk-go-v2/service/dynamodbstreams v1.25.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/ecr v1.36.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/ecs v1.52.0 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.4 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.5 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.5 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.17 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.5 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.5 // indirect
 	github.com/aws/aws-sdk-go-v2/service/rds v1.91.0 // indirect
@@ -68,7 +70,7 @@ require (
 	github.com/aws/aws-sdk-go-v2/service/sso v1.24.6 // indirect
 	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.5 // indirect
 	github.com/aws/aws-sdk-go-v2/service/sts v1.33.1 // indirect
-	github.com/aws/smithy-go v1.22.1 // indirect
+	github.com/aws/smithy-go v1.22.4 // indirect
 	github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d // indirect
 	github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.5 // indirect

package/go.sum

@@ -12,22 +12,24 @@ github.com/apparentlymart/go-textseg/v15 v15.0.0 h1:uYvfpb3DyLSCGWnctWKGj857c6ew
 github.com/apparentlymart/go-textseg/v15 v15.0.0/go.mod h1:K8XmNZdhEBkdlyDdvbmmsvpAG721bKi0joRfFdHIWJ4=
 github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio=
 github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs=
-github.com/aws/aws-sdk-go-v2 v1.32.7 h1:ky5o35oENWi0JYWUZkB7WYvVPP+bcRF5/Iq7JWSb5Rw=
-github.com/aws/aws-sdk-go-v2 v1.32.7/go.mod h1:P5WJBrYqqbWVaOxgH0X/FYYD47/nooaPOZPlQdmiN2U=
+github.com/aws/aws-sdk-go-v2 v1.36.5 h1:0OF9RiEMEdDdZEMqF9MRjevyxAQcf6gY+E7vwBILFj0=
+github.com/aws/aws-sdk-go-v2 v1.36.5/go.mod h1:EYrzvCCN9CMUTa5+6lf6MM4tq3Zjp8UhSGR/cBsjai0=
 github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.7 h1:lL7IfaFzngfx0ZwUGOZdsFFnQ5uLvR0hWqqhyE7Q9M8=
 github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.7/go.mod h1:QraP0UcVlQJsmHfioCrveWOC1nbiWUl3ej08h4mXWoc=
 github.com/aws/aws-sdk-go-v2/config v1.28.5 h1:Za41twdCXbuyyWv9LndXxZZv3QhTG1DinqlFsSuvtI0=
 github.com/aws/aws-sdk-go-v2/config v1.28.5/go.mod h1:4VsPbHP8JdcdUDmbTVgNL/8w9SqOkM5jyY8ljIxLO3o=
 github.com/aws/aws-sdk-go-v2/credentials v1.17.46 h1:AU7RcriIo2lXjUfHFnFKYsLCwgbz1E7Mm95ieIRDNUg=
 github.com/aws/aws-sdk-go-v2/credentials v1.17.46/go.mod h1:1FmYyLGL08KQXQ6mcTlifyFXfJVCNJTVGuQP4m0d/UA=
+github.com/aws/aws-sdk-go-v2/feature/dynamodb/attributevalue v1.19.3 h1:xQYRnbQ+ypDMCLiFlLw5cF7Xd6K+oaL7jco2zwIMqTs=
+github.com/aws/aws-sdk-go-v2/feature/dynamodb/attributevalue v1.19.3/go.mod h1:X7RC8FFkx0bjNJRBddd3xdoDaDmNLSxICFdIdJ7asqw=
 github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.20 h1:sDSXIrlsFSFJtWKLQS4PUWRvrT580rrnuLydJrCQ/yA=
 github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.20/go.mod h1:WZ/c+w0ofps+/OUqMwWgnfrgzZH1DZO1RIkktICsqnY=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.41 h1:hqcxMc2g/MwwnRMod9n6Bd+t+9Nf7d5qRg7RaXKPd6o=
 github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.41/go.mod h1:d1eH0VrttvPmrCraU68LOyNdu26zFxQFjrVSb5vdhog=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.26 h1:I/5wmGMffY4happ8NOCuIUEWGUvvFp5NSeQcXl9RHcI=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.26/go.mod h1:FR8f4turZtNy6baO0KJ5FJUmXH/cSkI9fOngs0yl6mA=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.26 h1:zXFLuEuMMUOvEARXFUVJdfqZ4bvvSgdGRq/ATcrQxzM=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.26/go.mod h1:3o2Wpy0bogG1kyOPrgkXA8pgIfEEv0+m19O9D5+W8y8=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.36 h1:SsytQyTMHMDPspp+spo7XwXTP44aJZZAC7fBV2C5+5s=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.36/go.mod h1:Q1lnJArKRXkenyog6+Y+zr7WDpk4e6XlR6gs20bbeNo=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.36 h1:i2vNHQiXUvKhs3quBR6aqlgJaiaexz/aNvdCktW/kAM=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.36/go.mod h1:UdyGa7Q91id/sdyHPwth+043HhmP6yP9MBHgbZM0xo8=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1 h1:VaRN3TlFdd6KxX1x3ILT5ynH6HvKgqdiXoTxAF4HQcQ=
 github.com/aws/aws-sdk-go-v2/internal/ini v1.8.1/go.mod h1:FbtygfRFze9usAadmnGJNc8KsP346kEe+y2/oyhGAGc=
 github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.26 h1:GeNJsIFHB+WW5ap2Tec4K6dzcVTsRbsT1Lra46Hv9ME=
@@ -48,8 +50,10 @@ github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs v1.44.0 h1:OREVd94+oXW5a+3SS
 github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs v1.44.0/go.mod h1:Qbr4yfpNqVNl69l/GEDK+8wxLf/vHi0ChoiSDzD7thU=
 github.com/aws/aws-sdk-go-v2/service/codeartifact v1.30.3 h1:9eAjfGKFWduKyCR94Qi/JfORoJLndGydph2dcLtM7gI=
 github.com/aws/aws-sdk-go-v2/service/codeartifact v1.30.3/go.mod h1:AdirH4VV5v1ik2pOOU0WdEdojBBgzTdECBrOQl0ojOc=
-github.com/aws/aws-sdk-go-v2/service/dynamodb v1.37.1 h1:vucMirlM6D+RDU8ncKaSZ/5dGrXNajozVwpmWNPn2gQ=
-github.com/aws/aws-sdk-go-v2/service/dynamodb v1.37.1/go.mod h1:fceORfs010mNxZbQhfqUjUeHlTwANmIT4mvHamuUaUg=
+github.com/aws/aws-sdk-go-v2/service/dynamodb v1.43.4 h1:Rv6o9v2AfdEIKoAa7pQpJ5ch9ji2HevFUvGY6ufawlI=
+github.com/aws/aws-sdk-go-v2/service/dynamodb v1.43.4/go.mod h1:mWB0GE1bqcVSvpW7OtFA0sKuHk52+IqtnsYU2jUfYAs=
+github.com/aws/aws-sdk-go-v2/service/dynamodbstreams v1.25.6 h1:QHaS/SHXfyNycuu4GiWb+AfW5T3bput6X5E3Ai/Q31M=
+github.com/aws/aws-sdk-go-v2/service/dynamodbstreams v1.25.6/go.mod h1:He/RikglWUczbkV+fkdpcV/3GdL/rTRNVy7VaUiezMo=
 github.com/aws/aws-sdk-go-v2/service/ec2 v1.193.0 h1:RhSoBFT5/8tTmIseJUXM6INTXTQDF8+0oyxWBnozIms=
 github.com/aws/aws-sdk-go-v2/service/ec2 v1.193.0/go.mod h1:mzj8EEjIHSN2oZRXiw1Dd+uB4HZTl7hC8nBzX9IZMWw=
 github.com/aws/aws-sdk-go-v2/service/ecr v1.36.6 h1:zg+3FGHA0PBs0KM25qE/rOf2o5zsjNa1g/Qq83+SDI0=
@@ -60,12 +64,12 @@ github.com/aws/aws-sdk-go-v2/service/eventbridge v1.36.1 h1:T/X6qqOleh63LMUt90Fk
 github.com/aws/aws-sdk-go-v2/service/eventbridge v1.36.1/go.mod h1:pd8aAX/C3BSJ4Y0PSF8KoOpXFP6p511Uu2PObSdhW/Y=
 github.com/aws/aws-sdk-go-v2/service/iam v1.38.1 h1:hfkzDZHBp9jAT4zcd5mtqckpU4E3Ax0LQaEWWk1VgN8=
 github.com/aws/aws-sdk-go-v2/service/iam v1.38.1/go.mod h1:u36ahDtZcQHGmVm/r+0L1sfKX4fzLEMdCqiKRKkUMVM=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1 h1:iXtILhvDxB6kPvEXgsDhGaZCSC6LQET5ZHSdJozeI0Y=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.1/go.mod h1:9nu0fVANtYiAePIBh2/pFUSwtJ402hLnp854CNoDOeE=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.4 h1:CXV68E2dNqhuynZJPB80bhPQwAKqBWVer887figW6Jc=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.4/go.mod h1:/xFi9KtvBXP97ppCz1TAEvU1Uf66qvid89rbem3wCzQ=
 github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.5 h1:gvZOjQKPxFXy1ft3QnEyXmT+IqneM9QAUWlM3r0mfqw=
 github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.4.5/go.mod h1:DLWnfvIcm9IET/mmjdxeXbBKmTCm0ZB8p1za9BVteM8=
-github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.5 h1:3Y457U2eGukmjYjeHG6kanZpDzJADa2m0ADqnuePYVQ=
-github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.5/go.mod h1:CfwEHGkTjYZpkQ/5PvcbEtT7AJlG68KkEvmtwU8z3/U=
+github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.17 h1:x187MqiHwBGjMGAed8Y8K1VGuCtFvQvXb24r+bwmSdo=
+github.com/aws/aws-sdk-go-v2/service/internal/endpoint-discovery v1.10.17/go.mod h1:mC9qMbA6e1pwEq6X3zDGtZRXMG2YaElJkbJlMVHLs5I=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.5 h1:wtpJ4zcwrSbwhECWQoI/g6WM9zqCcSpHDJIWSbMLOu4=
 github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.5/go.mod h1:qu/W9HXQbbQ4+1+JcZp0ZNPV31ym537ZJN+fiS7Ti8E=
 github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.5 h1:P1doBzv5VEg1ONxnJss1Kh5ZG/ewoIE4MQtKKc6Crgg=
@@ -98,8 +102,8 @@ github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.5 h1:K0OQAsDywb0ltlFrZm0JHPY3
 github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.5/go.mod h1:ORITg+fyuMoeiQFiVGoqB3OydVTLkClw/ljbblMq6Cc=
 github.com/aws/aws-sdk-go-v2/service/sts v1.33.1 h1:6SZUVRQNvExYlMLbHdlKB48x0fLbc2iVROyaNEwBHbU=
 github.com/aws/aws-sdk-go-v2/service/sts v1.33.1/go.mod h1:GqWyYCwLXnlUB1lOAXQyNSPqPLQJvmo8J0DWBzp9mtg=
-github.com/aws/smithy-go v1.22.1 h1:/HPHZQ0g7f4eUeK6HKglFz8uwVfZKgoI25rb/J+dnro=
-github.com/aws/smithy-go v1.22.1/go.mod h1:irrKGvNn1InZwb2d7fkIRNucdfwR8R+Ts3wxYa/cJHg=
+github.com/aws/smithy-go v1.22.4 h1:uqXzVZNuNexwc/xrh6Tb56u89WDlJY6HS+KC0S4QSjw=
+github.com/aws/smithy-go v1.22.4/go.mod h1:t1ufH5HMublsJYulve2RKmHDC15xu1f26kHCp/HgceI=
 github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d h1:xDfNPAt8lFiC1UJrqV3uuy861HCTo708pDMbjHHdCas=
 github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d/go.mod h1:6QX/PXZ00z/TKoufEY6K/a0k6AhaJrQKdFe6OfVXsa4=
 github.com/bgentry/speakeasy v0.1.0/go.mod h1:+zsyZBPWlz7T6j88CTgSN5bM796AkVf0kBD4zp0CCIs=

package/lib/asset-manager.d.ts

@@ -0,0 +1,23 @@
+import { DockerImageAssetLocation, DockerImageAssetSource, FileAssetLocation, FileAssetSource } from "./assets";
+/**
+ * Interface for managing assets (files and Docker images) in infrastructure stacks.
+ *
+ * This interface abstracts asset management to avoid circular dependencies between
+ * stack implementations and storage constructs.
+ */
+export interface IAssetManager {
+    /**
+     * Register a file asset and return its location details.
+     *
+     * @param asset The file asset source information
+     * @returns Location details for the uploaded file asset
+     */
+    addFileAsset(asset: FileAssetSource): FileAssetLocation;
+    /**
+     * Register a Docker image asset and return its location details.
+     *
+     * @param asset The Docker image asset source information
+     * @returns Location details for the built and pushed Docker image
+     */
+    addDockerImageAsset(asset: DockerImageAssetSource): DockerImageAssetLocation;
+}

package/lib/asset-manager.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXNzZXQtbWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9hc3NldC1tYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuICBEb2NrZXJJbWFnZUFzc2V0TG9jYXRpb24sXG4gIERvY2tlckltYWdlQXNzZXRTb3VyY2UsXG4gIEZpbGVBc3NldExvY2F0aW9uLFxuICBGaWxlQXNzZXRTb3VyY2UsXG59IGZyb20gXCIuL2Fzc2V0c1wiO1xuXG4vKipcbiAqIEludGVyZmFjZSBmb3IgbWFuYWdpbmcgYXNzZXRzIChmaWxlcyBhbmQgRG9ja2VyIGltYWdlcykgaW4gaW5mcmFzdHJ1Y3R1cmUgc3RhY2tzLlxuICpcbiAqIFRoaXMgaW50ZXJmYWNlIGFic3RyYWN0cyBhc3NldCBtYW5hZ2VtZW50IHRvIGF2b2lkIGNpcmN1bGFyIGRlcGVuZGVuY2llcyBiZXR3ZWVuXG4gKiBzdGFjayBpbXBsZW1lbnRhdGlvbnMgYW5kIHN0b3JhZ2UgY29uc3RydWN0cy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJQXNzZXRNYW5hZ2VyIHtcbiAgLyoqXG4gICAqIFJlZ2lzdGVyIGEgZmlsZSBhc3NldCBhbmQgcmV0dXJuIGl0cyBsb2NhdGlvbiBkZXRhaWxzLlxuICAgKlxuICAgKiBAcGFyYW0gYXNzZXQgVGhlIGZpbGUgYXNzZXQgc291cmNlIGluZm9ybWF0aW9uXG4gICAqIEByZXR1cm5zIExvY2F0aW9uIGRldGFpbHMgZm9yIHRoZSB1cGxvYWRlZCBmaWxlIGFzc2V0XG4gICAqL1xuICBhZGRGaWxlQXNzZXQoYXNzZXQ6IEZpbGVBc3NldFNvdXJjZSk6IEZpbGVBc3NldExvY2F0aW9uO1xuXG4gIC8qKlxuICAgKiBSZWdpc3RlciBhIERvY2tlciBpbWFnZSBhc3NldCBhbmQgcmV0dXJuIGl0cyBsb2NhdGlvbiBkZXRhaWxzLlxuICAgKlxuICAgKiBAcGFyYW0gYXNzZXQgVGhlIERvY2tlciBpbWFnZSBhc3NldCBzb3VyY2UgaW5mb3JtYXRpb25cbiAgICogQHJldHVybnMgTG9jYXRpb24gZGV0YWlscyBmb3IgdGhlIGJ1aWx0IGFuZCBwdXNoZWQgRG9ja2VyIGltYWdlXG4gICAqL1xuICBhZGREb2NrZXJJbWFnZUFzc2V0KGFzc2V0OiBEb2NrZXJJbWFnZUFzc2V0U291cmNlKTogRG9ja2VySW1hZ2VBc3NldExvY2F0aW9uO1xufVxuIl19

package/lib/asset-staging.d.ts

@@ -0,0 +1,178 @@
+import { Construct } from "constructs";
+import { AssetOptions, FileAssetPackaging } from "./assets";
+import { FingerprintOptions } from "./fs";
+import { StackBase } from "./stack-base";
+/**
+ * Initialization properties for `AssetStaging`.
+ */
+export interface AssetStagingProps extends FingerprintOptions, AssetOptions {
+    /**
+     * The source file or directory to copy from.
+     */
+    readonly sourcePath: string;
+}
+/**
+ * Stages a file or directory from a location on the file system into a staging
+ * directory.
+ *
+ * This is controlled by the context key 'aws:cdk:asset-staging' and enabled
+ * by the CLI by default in order to ensure that when the CDK app exists, all
+ * assets are available for deployment. Otherwise, if an app references assets
+ * in temporary locations, those will not be available when it exists (see
+ * https://github.com/aws/aws-cdk/issues/1716).
+ *
+ * The `stagedPath` property is a stringified token that represents the location
+ * of the file or directory after staging. It will be resolved only during the
+ * "prepare" stage and may be either the original path or the staged path
+ * depending on the context setting.
+ *
+ * The file/directory are staged based on their content hash (fingerprint). This
+ * means that only if content was changed, copy will happen.
+ */
+export declare class AssetStaging extends Construct {
+    /**
+     * The directory inside the bundling container into which the asset sources will be mounted.
+     */
+    static readonly BUNDLING_INPUT_DIR = "/asset-input";
+    /**
+     * The directory inside the bundling container into which the bundled output should be written.
+     */
+    static readonly BUNDLING_OUTPUT_DIR = "/asset-output";
+    /**
+     * Clears the asset hash cache
+     */
+    static clearAssetHashCache(): void;
+    /**
+     * Cache of asset hashes based on asset configuration to avoid repeated file
+     * system and bundling operations.
+     */
+    private static assetCache;
+    /**
+     * Absolute path to the asset data.
+     *
+     * If asset staging is disabled, this will just be the source path or
+     * a temporary directory used for bundling.
+     *
+     * If asset staging is enabled it will be the staged path.
+     *
+     * IMPORTANT: If you are going to call `addFileAsset()`, use
+     * `relativeStagedPath()` instead.
+     *
+     * @deprecated - Use `absoluteStagedPath` instead.
+     */
+    readonly stagedPath: string;
+    /**
+     * Absolute path to the asset data.
+     *
+     * If asset staging is disabled, this will just be the source path or
+     * a temporary directory used for bundling.
+     *
+     * If asset staging is enabled it will be the staged path.
+     *
+     * IMPORTANT: If you are going to call `addFileAsset()`, use
+     * `relativeStagedPath()` instead.
+     */
+    readonly absoluteStagedPath: string;
+    /**
+     * The absolute path of the asset as it was referenced by the user.
+     */
+    readonly sourcePath: string;
+    /**
+     * A cryptographic hash of the asset.
+     */
+    readonly assetHash: string;
+    /**
+     * How this asset should be packaged.
+     */
+    readonly packaging: FileAssetPackaging;
+    /**
+     * Whether this asset is an archive (zip or jar).
+     */
+    readonly isArchive: boolean;
+    private readonly fingerprintOptions;
+    private readonly hashType;
+    private readonly assetOutdir;
+    /**
+     * A custom source fingerprint given by the user
+     *
+     * Will not be used literally, always hashed later on.
+     */
+    private customSourceFingerprint?;
+    private readonly cacheKey;
+    private readonly sourceStats;
+    constructor(scope: Construct, id: string, props: AssetStagingProps);
+    /**
+     * A cryptographic hash of the asset.
+     *
+     * @deprecated see `assetHash`.
+     */
+    get sourceHash(): string;
+    /**
+     * Return the path to the staged asset, relative to the Manifest workingDirectory of the given stack
+     *
+     * Only returns a relative path if the asset was staged, returns an absolute path if
+     * it was not staged.
+     *
+     * A bundled asset might end up in the outDir and still not count as
+     * "staged"; if asset staging is disabled we're technically expected to
+     * reference source directories, but we don't have a source directory for the
+     * bundled outputs (as the bundle output is written to a temporary
+     * directory). Nevertheless, we will still return an absolute path.
+     *
+     * A non-obvious directory layout may look like this:
+     *
+     * ```
+     *   MANIFEST ROOT
+     *     +-- asset.12345abcdef/
+     *     +-- assembly-Stage
+     *           +-- MyStack.template.json
+     *           +-- MyStack.assets.json <- will contain { "path": "../asset.12345abcdef" }
+     * ```
+     */
+    relativeStagedPath(_stack: StackBase): string;
+    /**
+     * Stage the source to the target by copying
+     *
+     * Optionally skip if staging is disabled, in which case we pretend we did something but we don't really.
+     */
+    private stageByCopying;
+    /**
+     * Stage the source to the target by bundling
+     *
+     * Optionally skip, in which case we pretend we did something but we don't really.
+     */
+    private stageByBundling;
+    /**
+     * Whether staging has been disabled
+     */
+    private get stagingDisabled();
+    /**
+     * Copies or moves the files from sourcePath to targetPath.
+     *
+     * Moving implies the source directory is temporary and can be trashed.
+     *
+     * Will not do anything if source and target are the same.
+     */
+    private stageAsset;
+    /**
+     * Determine the directory where we're going to write the bundling output
+     *
+     * This is the target directory where we're going to write the staged output
+     * files if we can (if the hash is fully known), or a temporary directory
+     * otherwise.
+     */
+    private determineBundleDir;
+    /**
+     * Bundles an asset to the given directory
+     *
+     * If the given directory already exists, assume that everything's already
+     * in order and don't do anything.
+     *
+     * @param options Bundling options
+     * @param bundleDir Where to create the bundle directory
+     * @returns The fully resolved bundle output directory.
+     */
+    private bundle;
+    private calculateHash;
+    private renderStagedPath;
+}