cdktn 0.25.0-pre.20 → 0.25.0-pre.22

package/.jsii

@@ -1408,6 +1408,307 @@
       ],
       "symbolId": "src/aspect:Aspects"
     },
+    "cdktn.AssetHash": {
+      "assembly": "cdktn",
+      "docs": {
+        "remarks": "Providers that read a local path directly — a Docker build `context`, for\nexample — need a content hash to drive `triggers`, but have no use for a\nstaged copy of the source. `Asset` and `TerraformAsset` always produce a\nstaged copy; this is the identity half without the staging half.",
+        "stability": "experimental",
+        "summary": "Computes a content hash of a file or directory without staging it."
+      },
+      "fqn": "cdktn.AssetHash",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/asset-hash.ts",
+        "line": 49
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "This is a hash of the source tree, and it does not depend on how the\nsource is later packaged. `hashPath` is always called with `archive`\nunset, so directory records are part of the digest; the hash of a given\ntree is therefore the same whether it is later copied, zipped, or packed\nby a custom `IAssetPackaging` such as `tar.bz2`.\n\nA consequence worth stating: this does not equal\n`TerraformAsset(dir, { type: ARCHIVE }).assetHash` for a directory with\nsubdirectories. That asset frames its hash to the emitted ZIP, which has\nno directory entries (see #323), so directory-only changes move it and\nnot this. It equals a `FILE` / `DIRECTORY` `TerraformAsset` hash only\nwhen the `canonicalAssetHashes` flag is enabled, since that flag is what\nputs the asset on this same canonical scheme.\n\nA relative `filePath` is resolved against the directory containing\n`cdktf.json`, the same base `TerraformAsset` uses, so both hash the same\nsource regardless of the process working directory. Absolute paths are\nused as-is. Throws if `filePath` is relative and no `cdktf.json` is found\nabove the working directory.",
+            "stability": "experimental",
+            "summary": "Content hash of a file or directory, without staging it."
+          },
+          "locationInModule": {
+            "filename": "src/asset-hash.ts",
+            "line": 75
+          },
+          "name": "of",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- path to a file or directory to hash."
+              },
+              "name": "filePath",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "docs": {
+                "summary": "- see {@link AssetHashOptions}."
+              },
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "cdktn.AssetHashOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "AssetHash",
+      "symbolId": "src/asset-hash:AssetHash"
+    },
+    "cdktn.AssetHashOptions": {
+      "assembly": "cdktn",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Options for {@link AssetHash.of}."
+      },
+      "fqn": "cdktn.AssetHashOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/asset-hash.ts",
+        "line": 15
+      },
+      "name": "AssetHashOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- nothing is excluded",
+            "remarks": "Cannot be combined with\n`ignoreStrategy`, which replaces this matcher rather than layering on\ntop of it.",
+            "stability": "experimental",
+            "summary": "Paths to exclude, relative to the hashed path."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset-hash.ts",
+            "line": 23
+          },
+          "name": "exclude",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no extra data",
+            "stability": "experimental",
+            "summary": "Extra information to fold into the hash."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset-hash.ts",
+            "line": 30
+          },
+          "name": "extraHash",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `exclude` is used with the built-in matcher",
+            "stability": "experimental",
+            "summary": "Exclusion matching, for callers that need `.gitignore` / `.dockerignore` parity rather than the built-in exact-path / suffix / directory matcher."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/asset-hash.ts",
+            "line": 38
+          },
+          "name": "ignoreStrategy",
+          "optional": true,
+          "type": {
+            "fqn": "cdktn.IIgnoreStrategy"
+          }
+        }
+      ],
+      "symbolId": "src/asset-hash:AssetHashOptions"
+    },
+    "cdktn.AssetHashType": {
+      "assembly": "cdktn",
+      "docs": {
+        "remarks": "NOTE: the hash is used in order to identify a specific revision of the asset, and\nused for optimizing and caching deployment activities related to this asset such as\npackaging, uploading to cloud storage, etc.",
+        "stability": "experimental",
+        "summary": "The type of asset hash."
+      },
+      "fqn": "cdktn.AssetHashType",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 59
+      },
+      "members": [
+        {
+          "docs": {
+            "remarks": "Use `SOURCE` when the content of the asset changes frequently or when\nyou want to track changes to the source files directly.",
+            "stability": "experimental",
+            "summary": "Based on the content of the source path."
+          },
+          "name": "SOURCE"
+        },
+        {
+          "docs": {
+            "remarks": "Use `OUTPUT` when the source of the asset is a top level folder containing\ncode and/or dependencies that are not directly linked to the asset.",
+            "stability": "experimental",
+            "summary": "Based on the content of the bundling output."
+          },
+          "name": "OUTPUT"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Use a custom hash."
+          },
+          "name": "CUSTOM"
+        }
+      ],
+      "name": "AssetHashType",
+      "symbolId": "src/assets:AssetHashType"
+    },
+    "cdktn.AssetOptions": {
+      "assembly": "cdktn",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Asset hash options."
+      },
+      "fqn": "cdktn.AssetOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 23
+      },
+      "name": "AssetOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- based on `assetHashType`",
+            "remarks": "If `assetHashType` is set it must\nbe set to `AssetHashType.CUSTOM`. The value is used verbatim as the asset\nhash, and because it names the staged asset file it may only contain\nletters, digits, `_`, `.` and `-`.\n\nNOTE: the hash is used in order to identify a specific revision of the asset, and\nused for optimizing and caching deployment activities related to this asset such as\npackaging, uploading to cloud storage, etc. If you chose to customize the hash, you will\nneed to make sure it is updated every time the asset changes, or otherwise it is\npossible that some deployments will not be invalidated.",
+            "stability": "experimental",
+            "summary": "Specify a custom hash for this asset."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 38
+          },
+          "name": "assetHash",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the default is `AssetHashType.SOURCE`, but if `assetHash` is\nexplicitly specified this value defaults to `AssetHashType.CUSTOM`.",
+            "remarks": "If `assetHash` is configured, this option must be `undefined` or\n`AssetHashType.CUSTOM`.",
+            "stability": "experimental",
+            "summary": "Specifies the type of hash to calculate for this asset."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 49
+          },
+          "name": "assetHashType",
+          "optional": true,
+          "type": {
+            "fqn": "cdktn.AssetHashType"
+          }
+        }
+      ],
+      "symbolId": "src/assets:AssetOptions"
+    },
+    "cdktn.AssetPackaging": {
+      "assembly": "cdktn",
+      "docs": {
+        "remarks": "Custom formats implement `IAssetPackaging`\ndirectly rather than extending this class.",
+        "stability": "experimental",
+        "summary": "Built-in packaging strategies."
+      },
+      "fqn": "cdktn.AssetPackaging",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 193
+      },
+      "name": "AssetPackaging",
+      "properties": [
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Copy a directory tree as-is, without archiving."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 202
+          },
+          "name": "DIRECTORY",
+          "static": true,
+          "type": {
+            "fqn": "cdktn.IAssetPackaging"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Copy a single file as-is."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 197
+          },
+          "name": "FILE",
+          "static": true,
+          "type": {
+            "fqn": "cdktn.IAssetPackaging"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Archive a directory tree into a single zip file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 207
+          },
+          "name": "ZIP",
+          "static": true,
+          "type": {
+            "fqn": "cdktn.IAssetPackaging"
+          }
+        }
+      ],
+      "symbolId": "src/assets:AssetPackaging"
+    },
     "cdktn.AssetType": {
       "assembly": "cdktn",
       "docs": {
@@ -1417,7 +1718,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/terraform-asset.ts",
-        "line": 31
+        "line": 49
       },
       "members": [
         {
@@ -6787,6 +7088,111 @@
       ],
       "symbolId": "src/tokens/token:EncodingOptions"
     },
+    "cdktn.ExcludeIgnoreStrategy": {
+      "assembly": "cdktn",
+      "docs": {
+        "stability": "experimental",
+        "summary": "The default ignore strategy: exact paths, `*.ext` suffixes, and directories (with everything inside them)."
+      },
+      "fqn": "cdktn.ExcludeIgnoreStrategy",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/ignore-strategy.ts",
+          "line": 94
+        },
+        "parameters": [
+          {
+            "name": "exclude",
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "cdktn.IIgnoreStrategy"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/ignore-strategy.ts",
+        "line": 85
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Whether the given entry should be excluded."
+          },
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 99
+          },
+          "name": "ignores",
+          "overrides": "cdktn.IIgnoreStrategy",
+          "parameters": [
+            {
+              "name": "query",
+              "type": {
+                "fqn": "cdktn.IgnoreQuery"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        }
+      ],
+      "name": "ExcludeIgnoreStrategy",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "Two strategies that return the same\n`cacheKey` must exclude the same paths.\n\nCallers such as `AssetStaging`'s result cache key on a JSON-serializable\nrepresentation of their inputs, which a strategy instance is not. Omit\nthis when the strategy's behavior can't be summarized this way; the\ncaller then has to treat every call as uncacheable.",
+            "stability": "experimental",
+            "summary": "A value identifying this strategy's exclusion behavior, suitable for folding into a cache key."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 88
+          },
+          "name": "cacheKey",
+          "optional": true,
+          "overrides": "cdktn.IIgnoreStrategy",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "remarks": "When `true` (the default), the walkers stop descending as soon as a\ndirectory is excluded — cheaper, and correct for a strategy whose\npatterns never re-include a path below an excluded parent.\n\nA strategy with negation patterns must set this to `false`:\n`.gitignore` / `.dockerignore` allow `node_modules` followed by\n`!node_modules/keep`, which is only reachable if the walk descends into\nthe excluded `node_modules` and asks about `node_modules/keep`. The\nexcluded directory entry itself is still omitted; only the descent\nchanges. Opting out costs a full walk of excluded subtrees.",
+            "stability": "experimental",
+            "summary": "Whether excluding a directory also excludes everything beneath it."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 92
+          },
+          "name": "pruneExcludedDirectories",
+          "optional": true,
+          "overrides": "cdktn.IIgnoreStrategy",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/ignore-strategy:ExcludeIgnoreStrategy"
+    },
     "cdktn.FileProvisioner": {
       "assembly": "cdktn",
       "datatype": true,
@@ -11401,8 +11807,118 @@
           ]
         }
       ],
-      "name": "IAspect",
-      "symbolId": "src/aspect:IAspect"
+      "name": "IAspect",
+      "symbolId": "src/aspect:IAspect"
+    },
+    "cdktn.IAsset": {
+      "assembly": "cdktn",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Common interface for all assets."
+      },
+      "fqn": "cdktn.IAsset",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 11
+      },
+      "name": "IAsset",
+      "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": "experimental",
+            "summary": "A hash of this asset, which is available at construction time."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 17
+          },
+          "name": "assetHash",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/assets:IAsset"
+    },
+    "cdktn.IAssetPackaging": {
+      "assembly": "cdktn",
+      "docs": {
+        "remarks": "Packaging answers two independent questions: how the artifact is produced\n(copy, zip, tar.gz, ...) and whether the result is a directory or a single\nfile. A closed enum can only ever answer the second one, so it is an\ninterface rather than an enum — custom formats (e.g. `tar.bz2`) need no\ncore change.",
+        "stability": "experimental",
+        "summary": "How a staged asset is produced and what shape it takes on disk."
+      },
+      "fqn": "cdktn.IAssetPackaging",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 91
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Perform the staging transformation, writing the packaged result to `options.target`."
+          },
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 110
+          },
+          "name": "pack",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- see {@link PackOptions}."
+              },
+              "name": "options",
+              "type": {
+                "fqn": "cdktn.PackOptions"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "IAssetPackaging",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Appended to the staged artifact name, e.g. \".zip\", \"\", \".tar.bz2\"."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 95
+          },
+          "name": "extension",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Publishers branch on this to decide whether they upload one object or\nsync a tree.",
+            "stability": "experimental",
+            "summary": "Whether the staged result is a directory rather than a single file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 103
+          },
+          "name": "producesDirectory",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/assets:IAssetPackaging"
     },
     "cdktn.IFragmentConcatenator": {
       "assembly": "cdktn",
@@ -11453,6 +11969,92 @@
       "name": "IFragmentConcatenator",
       "symbolId": "src/tokens/resolvable:IFragmentConcatenator"
     },
+    "cdktn.IIgnoreStrategy": {
+      "assembly": "cdktn",
+      "docs": {
+        "remarks": "Core ships only the exact-path / `*.ext` / directory matcher used by\n`exclude` today (`ExcludeIgnoreStrategy`). Full glob, `.gitignore`, and\n`.dockerignore` parity can be implemented against this interface without\ncore taking on a glob parser.",
+        "stability": "experimental",
+        "summary": "Decides whether a path relative to an asset root is excluded from staging and hashing."
+      },
+      "fqn": "cdktn.IIgnoreStrategy",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/ignore-strategy.ts",
+        "line": 41
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Whether the given entry should be excluded."
+          },
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 46
+          },
+          "name": "ignores",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- the entry under consideration, see {@link IgnoreQuery}."
+              },
+              "name": "query",
+              "type": {
+                "fqn": "cdktn.IgnoreQuery"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        }
+      ],
+      "name": "IIgnoreStrategy",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- this strategy cannot be represented in a cache key",
+            "remarks": "Two strategies that return the same\n`cacheKey` must exclude the same paths.\n\nCallers such as `AssetStaging`'s result cache key on a JSON-serializable\nrepresentation of their inputs, which a strategy instance is not. Omit\nthis when the strategy's behavior can't be summarized this way; the\ncaller then has to treat every call as uncacheable.",
+            "stability": "experimental",
+            "summary": "A value identifying this strategy's exclusion behavior, suitable for folding into a cache key."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 78
+          },
+          "name": "cacheKey",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "remarks": "When `true` (the default), the walkers stop descending as soon as a\ndirectory is excluded — cheaper, and correct for a strategy whose\npatterns never re-include a path below an excluded parent.\n\nA strategy with negation patterns must set this to `false`:\n`.gitignore` / `.dockerignore` allow `node_modules` followed by\n`!node_modules/keep`, which is only reachable if the walk descends into\nthe excluded `node_modules` and asks about `node_modules/keep`. The\nexcluded directory entry itself is still omitted; only the descent\nchanges. Opting out costs a full walk of excluded subtrees.",
+            "stability": "experimental",
+            "summary": "Whether excluding a directory also excludes everything beneath it."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 64
+          },
+          "name": "pruneExcludedDirectories",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/ignore-strategy:IIgnoreStrategy"
+    },
     "cdktn.IImportableConfig": {
       "assembly": "cdktn",
       "docs": {
@@ -12879,6 +13481,58 @@
       "name": "ITokenResolver",
       "symbolId": "src/tokens/resolvable:ITokenResolver"
     },
+    "cdktn.IgnoreQuery": {
+      "assembly": "cdktn",
+      "datatype": true,
+      "docs": {
+        "remarks": "A struct rather than a positional `relativePath` string so the shape can\nevolve. `isDirectory` is carried from the outset because `.gitignore` /\n`.dockerignore` semantics turn on it: a `foo/` pattern matches a\ndirectory but not a file named `foo`, and a matcher cannot recover\nthat distinction from the path text alone.",
+        "stability": "experimental",
+        "summary": "A single entry presented to an {@link IIgnoreStrategy}."
+      },
+      "fqn": "cdktn.IgnoreQuery",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/ignore-strategy.ts",
+        "line": 14
+      },
+      "name": "IgnoreQuery",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "The tree walkers set this from `lstat`, so a strategy can honor\ndirectory-only patterns without stat-ing the path itself (which it has\nno root to resolve against). Excluding a directory also excludes\neverything below it, since the walkers stop descending once a directory\nis excluded.",
+            "stability": "experimental",
+            "summary": "Whether this entry is a directory rather than a file or symlink."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 29
+          },
+          "name": "isDirectory",
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "`/`-separated path relative to the asset root."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/ignore-strategy.ts",
+            "line": 18
+          },
+          "name": "relativePath",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/ignore-strategy:IgnoreQuery"
+    },
     "cdktn.ImportableResource": {
       "assembly": "cdktn",
       "base": "cdktn.TerraformElement",
@@ -16374,6 +17028,76 @@
       ],
       "symbolId": "src/backends/oss-backend:OssBackendConfig"
     },
+    "cdktn.PackOptions": {
+      "assembly": "cdktn",
+      "datatype": true,
+      "docs": {
+        "remarks": "A struct rather than positional parameters: adding a struct field is\nadditive, adding a method parameter is not, and `pack` is called through\nJSII where that distinction is a breaking-change boundary.",
+        "stability": "experimental",
+        "summary": "Options for {@link IAssetPackaging.pack}."
+      },
+      "fqn": "cdktn.PackOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 120
+      },
+      "name": "PackOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Path to the resolved (already bundled, if applicable) source."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 124
+          },
+          "name": "source",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Path the packaged result should be written to."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 129
+          },
+          "name": "target",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- nothing is excluded",
+            "remarks": "Must match the strategy used\nto hash the same source, or the hash and the artifact describe\ndifferent sets of files.",
+            "stability": "experimental",
+            "summary": "Entries to omit from the packaged result."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 138
+          },
+          "name": "ignoreStrategy",
+          "optional": true,
+          "type": {
+            "fqn": "cdktn.IIgnoreStrategy"
+          }
+        }
+      ],
+      "symbolId": "src/assets:PackOptions"
+    },
     "cdktn.PgBackend": {
       "assembly": "cdktn",
       "base": "cdktn.TerraformBackend",
@@ -19470,6 +20194,75 @@
       ],
       "symbolId": "src/manifest:StackManifest"
     },
+    "cdktn.StagedAsset": {
+      "assembly": "cdktn",
+      "datatype": true,
+      "docs": {
+        "remarks": "Deliberately narrower than a location: `path` and `isDirectory` are known\nonce staging runs, at synth time, before anything is published. Where an\nasset ends up — a bucket name, an object key, a URL — is resolved at\napply time and belongs on the publisher's own reference type instead.",
+        "stability": "experimental",
+        "summary": "A staged artifact, ready to hand to an `IAssetPublisher`."
+      },
+      "fqn": "cdktn.StagedAsset",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/assets.ts",
+        "line": 220
+      },
+      "name": "StagedAsset",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This hash is used to uniquely identify this\nasset throughout the system. If this value doesn't change, the asset will\nnot be rebuilt or republished.",
+            "stability": "experimental",
+            "summary": "A hash on the content source."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 226
+          },
+          "name": "assetHash",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Publishers branch on this to decide whether they upload one object or\nsync a tree; see `IAssetPackaging.producesDirectory`.",
+            "stability": "experimental",
+            "summary": "Whether the staged artifact is a directory rather than a single file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 239
+          },
+          "name": "isDirectory",
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The path to the staged artifact, relative to the stack directory."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/assets.ts",
+            "line": 231
+          },
+          "name": "path",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/assets:StagedAsset"
+    },
     "cdktn.StringConcat": {
       "assembly": "cdktn",
       "docs": {
@@ -20945,7 +21738,7 @@
         },
         "locationInModule": {
           "filename": "src/terraform-asset.ts",
-          "line": 56
+          "line": 88
         },
         "parameters": [
           {
@@ -20968,24 +21761,29 @@
           }
         ]
       },
+      "interfaces": [
+        "cdktn.IAsset"
+      ],
       "kind": "class",
       "locationInModule": {
         "filename": "src/terraform-asset.ts",
-        "line": 41
+        "line": 73
       },
       "name": "TerraformAsset",
       "properties": [
         {
           "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": "experimental",
-            "summary": "Name of the asset."
+            "summary": "A hash of this asset, which is available at construction time."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 124
+            "line": 77
           },
-          "name": "fileName",
+          "name": "assetHash",
+          "overrides": "cdktn.IAsset",
           "type": {
             "primitive": "string"
           }
@@ -20993,27 +21791,29 @@
         {
           "docs": {
             "stability": "experimental",
-            "summary": "The path relative to the root of the terraform directory in posix format Use this property to reference the asset."
+            "summary": "Name of the asset."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 113
+            "line": 206
           },
-          "name": "path",
+          "name": "fileName",
           "type": {
             "primitive": "string"
           }
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "The path relative to the root of the terraform directory in posix format Use this property to reference the asset."
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 45
+            "line": 193
           },
-          "name": "assetHash",
+          "name": "path",
           "type": {
             "primitive": "string"
           }
@@ -21024,7 +21824,7 @@
           },
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 47
+            "line": 79
           },
           "name": "type",
           "type": {
@@ -21044,7 +21844,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/terraform-asset.ts",
-        "line": 22
+        "line": 27
       },
       "name": "TerraformAssetConfig",
       "properties": [
@@ -21056,7 +21856,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 24
+            "line": 29
           },
           "name": "path",
           "type": {
@@ -21071,7 +21871,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 28
+            "line": 33
           },
           "name": "assetHash",
           "optional": true,
@@ -21079,6 +21879,25 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "AssetHashType.SOURCE",
+            "remarks": "`SOURCE` (the default) hashes the source path. `CUSTOM` uses the\n`assetHash` value verbatim and requires it to be set. `OUTPUT` is not\nsupported yet — there is no bundling step to produce an output to hash —\nand throws if requested.\n\nIf `assetHash` is set, this must be `undefined` or `AssetHashType.CUSTOM`.",
+            "stability": "experimental",
+            "summary": "How the `assetHash` is derived."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/terraform-asset.ts",
+            "line": 46
+          },
+          "name": "assetHashType",
+          "optional": true,
+          "type": {
+            "fqn": "cdktn.AssetHashType"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -21087,7 +21906,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/terraform-asset.ts",
-            "line": 26
+            "line": 31
           },
           "name": "type",
           "optional": true,
@@ -30961,6 +31780,6 @@
       "symbolId": "src/testing/matchers:TerraformConstructor"
     }
   },
-  "version": "0.25.0-pre.20",
-  "fingerprint": "7BC2r6hXafzJc53Xy8raZ7/I2AkCTI5dz7CFLsAjul8="
+  "version": "0.25.0-pre.22",
+  "fingerprint": "hkAZDKwNRSbTsgHRZDywMIh4qjz3hexPa+eGKQR5YbI="
 }