@aws-cdk/toolkit-lib 1.24.0 → 1.25.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/build-info.json +2 -2
  2. package/db.json.gz +0 -0
  3. package/lib/actions/deploy/index.d.ts +15 -1
  4. package/lib/actions/deploy/index.js +1 -1
  5. package/lib/actions/deploy/private/deployment-method.d.ts +5 -9
  6. package/lib/actions/deploy/private/deployment-method.js +8 -1
  7. package/lib/actions/diagnose/index.d.ts +89 -0
  8. package/lib/actions/diagnose/index.js +3 -0
  9. package/lib/actions/diff/private/helpers.js +12 -15
  10. package/lib/actions/index.d.ts +2 -0
  11. package/lib/actions/index.js +3 -1
  12. package/lib/actions/orphan/index.d.ts +18 -0
  13. package/lib/actions/orphan/index.js +3 -0
  14. package/lib/api/aws-auth/sdk.d.ts +2 -1
  15. package/lib/api/aws-auth/sdk.js +2 -1
  16. package/lib/api/bootstrap/bootstrap-environment.js +4 -4
  17. package/lib/api/bootstrap/bootstrap-template.yaml +5 -16
  18. package/lib/api/bootstrap/deploy-bootstrap.js +9 -1
  19. package/lib/api/cloud-assembly/stack-selector.d.ts +1 -1
  20. package/lib/api/cloud-assembly/stack-selector.js +1 -1
  21. package/lib/api/cloudformation/index.d.ts +1 -0
  22. package/lib/api/cloudformation/index.js +2 -1
  23. package/lib/api/cloudformation/logical-id-map.d.ts +24 -0
  24. package/lib/api/cloudformation/logical-id-map.js +45 -0
  25. package/lib/api/cloudformation/stack-helpers.d.ts +6 -0
  26. package/lib/api/cloudformation/stack-helpers.js +12 -1
  27. package/lib/api/deployments/cfn-api.d.ts +8 -17
  28. package/lib/api/deployments/cfn-api.js +60 -71
  29. package/lib/api/deployments/deploy-stack.d.ts +6 -2
  30. package/lib/api/deployments/deploy-stack.js +43 -61
  31. package/lib/api/deployments/deployments.d.ts +3 -2
  32. package/lib/api/deployments/deployments.js +31 -7
  33. package/lib/api/diagnosing/changeset-error-fetcher.d.ts +51 -0
  34. package/lib/api/diagnosing/changeset-error-fetcher.js +83 -0
  35. package/lib/api/diagnosing/diagnosis-formatting.d.ts +13 -0
  36. package/lib/api/diagnosing/diagnosis-formatting.js +140 -0
  37. package/lib/api/diagnosing/stack-diagnoser.d.ts +106 -0
  38. package/lib/api/diagnosing/stack-diagnoser.js +354 -0
  39. package/lib/api/diagnosing/tree-builder.d.ts +13 -0
  40. package/lib/api/diagnosing/tree-builder.js +86 -0
  41. package/lib/api/diagnosing/tree.d.ts +19 -0
  42. package/lib/api/diagnosing/tree.js +72 -0
  43. package/lib/api/diff/diff-formatter.js +8 -12
  44. package/lib/api/drift/drift-formatter.d.ts +0 -1
  45. package/lib/api/drift/drift-formatter.js +3 -10
  46. package/lib/api/hotswap/hotswap-deployments.js +14 -2
  47. package/lib/api/hotswap/hotswap-template-cache.d.ts +19 -0
  48. package/lib/api/hotswap/hotswap-template-cache.js +96 -0
  49. package/lib/api/index.d.ts +1 -0
  50. package/lib/api/index.js +2 -1
  51. package/lib/api/io/private/messages.d.ts +5 -0
  52. package/lib/api/io/private/messages.js +23 -1
  53. package/lib/api/io/toolkit-action.d.ts +1 -1
  54. package/lib/api/io/toolkit-action.js +1 -1
  55. package/lib/api/orphan/orphaner.d.ts +75 -0
  56. package/lib/api/orphan/orphaner.js +246 -0
  57. package/lib/api/orphan/private/helpers.d.ts +56 -0
  58. package/lib/api/orphan/private/helpers.js +219 -0
  59. package/lib/api/orphan/private/index.d.ts +2 -0
  60. package/lib/api/orphan/private/index.js +18 -0
  61. package/lib/api/resource-import/importer.d.ts +5 -1
  62. package/lib/api/resource-import/importer.js +26 -6
  63. package/lib/api/settings.d.ts +3 -1
  64. package/lib/api/settings.js +16 -3
  65. package/lib/api/source-tracing/index.d.ts +2 -0
  66. package/lib/api/source-tracing/index.js +18 -0
  67. package/lib/api/source-tracing/private/source-tracing.d.ts +16 -0
  68. package/lib/api/source-tracing/private/source-tracing.js +8 -0
  69. package/lib/api/source-tracing/private/stack-source-tracing.d.ts +32 -0
  70. package/lib/api/source-tracing/private/stack-source-tracing.js +134 -0
  71. package/lib/api/source-tracing/types.d.ts +9 -0
  72. package/lib/api/source-tracing/types.js +3 -0
  73. package/lib/api/stack-events/resource-errors.d.ts +82 -0
  74. package/lib/api/stack-events/resource-errors.js +129 -0
  75. package/lib/api/stack-events/stack-activity-monitor.d.ts +2 -29
  76. package/lib/api/stack-events/stack-activity-monitor.js +6 -95
  77. package/lib/api/stack-events/stack-event-poller.d.ts +71 -8
  78. package/lib/api/stack-events/stack-event-poller.js +107 -13
  79. package/lib/api/stack-events/stack-progress-monitor.d.ts +2 -2
  80. package/lib/api/stack-events/stack-progress-monitor.js +8 -2
  81. package/lib/api/work-graph/work-graph.d.ts +4 -0
  82. package/lib/api/work-graph/work-graph.js +6 -1
  83. package/lib/index.d.ts +1 -0
  84. package/lib/index.js +2 -1
  85. package/lib/index_bg.wasm +0 -0
  86. package/lib/toolkit/toolkit.d.ts +17 -1
  87. package/lib/toolkit/toolkit.js +194 -57
  88. package/lib/util/arrays.d.ts +1 -0
  89. package/lib/util/arrays.js +23 -1
  90. package/lib/util/type-brands.d.ts +1 -1
  91. package/lib/util/type-brands.js +1 -1
  92. package/package.json +13 -13
  93. package/lib/api/deployments/early-validation.d.ts +0 -19
  94. package/lib/api/deployments/early-validation.js +0 -57
package/lib/index.js CHANGED
@@ -30,4 +30,5 @@ __exportStar(require("./api/cloud-assembly"), exports);
30
30
  __exportStar(require("./api/io"), exports);
31
31
  __exportStar(require("./api/tags"), exports);
32
32
  __exportStar(require("./api/plugin"), exports);
33
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCxrQkFBa0I7QUFDbEIsc0NBQW9DO0FBRXBDLGdCQUFnQjtBQUNoQiw0Q0FBMEI7QUFDMUIsMERBQXdDO0FBQ3hDLDRDQUEwQjtBQUMxQiw2Q0FBMkI7QUFFM0Isa0JBQWtCO0FBQ2xCLGlEQUErQjtBQUMvQix1REFBcUM7QUFDckMsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgdG9vbGtpdC1saWJcbiAqL1xuXG4vLyBQb2x5ZmlsbHMgZmlyc3RcbmltcG9ydCAnLi9wcml2YXRlL2Rpc3Bvc2UtcG9seWZpbGwnO1xuXG4vLyBUaGUgbWFpbiBzaG93XG5leHBvcnQgKiBmcm9tICcuL3Rvb2xraXQnO1xuZXhwb3J0ICogZnJvbSAnLi90b29sa2l0L3Rvb2xraXQtZXJyb3InO1xuZXhwb3J0ICogZnJvbSAnLi9hY3Rpb25zJztcbmV4cG9ydCAqIGZyb20gJy4vcGF5bG9hZHMnO1xuXG4vLyBTdXBwb3J0aW5nIGFjdHNcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2F3cy1hdXRoJztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2Nsb3VkLWFzc2VtYmx5JztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2lvJztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL3RhZ3MnO1xuZXhwb3J0ICogZnJvbSAnLi9hcGkvcGx1Z2luJztcbiJdfQ==
33
+ __exportStar(require("./api/source-tracing"), exports);
34
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCxrQkFBa0I7QUFDbEIsc0NBQW9DO0FBRXBDLGdCQUFnQjtBQUNoQiw0Q0FBMEI7QUFDMUIsMERBQXdDO0FBQ3hDLDRDQUEwQjtBQUMxQiw2Q0FBMkI7QUFFM0Isa0JBQWtCO0FBQ2xCLGlEQUErQjtBQUMvQix1REFBcUM7QUFDckMsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkI7QUFDN0IsdURBQXFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIHRvb2xraXQtbGliXG4gKi9cblxuLy8gUG9seWZpbGxzIGZpcnN0XG5pbXBvcnQgJy4vcHJpdmF0ZS9kaXNwb3NlLXBvbHlmaWxsJztcblxuLy8gVGhlIG1haW4gc2hvd1xuZXhwb3J0ICogZnJvbSAnLi90b29sa2l0JztcbmV4cG9ydCAqIGZyb20gJy4vdG9vbGtpdC90b29sa2l0LWVycm9yJztcbmV4cG9ydCAqIGZyb20gJy4vYWN0aW9ucyc7XG5leHBvcnQgKiBmcm9tICcuL3BheWxvYWRzJztcblxuLy8gU3VwcG9ydGluZyBhY3RzXG5leHBvcnQgKiBmcm9tICcuL2FwaS9hd3MtYXV0aCc7XG5leHBvcnQgKiBmcm9tICcuL2FwaS9jbG91ZC1hc3NlbWJseSc7XG5leHBvcnQgKiBmcm9tICcuL2FwaS9pbyc7XG5leHBvcnQgKiBmcm9tICcuL2FwaS90YWdzJztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL3BsdWdpbic7XG5leHBvcnQgKiBmcm9tICcuL2FwaS9zb3VyY2UtdHJhY2luZyc7XG4iXX0=
package/lib/index_bg.wasm CHANGED
Binary file
@@ -4,9 +4,11 @@ import type { DeployResult, DestroyResult, FeatureFlag, RollbackResult } from '.
4
4
  import type { BootstrapEnvironments, BootstrapOptions, BootstrapResult } from '../actions/bootstrap';
5
5
  import { type DeployOptions } from '../actions/deploy';
6
6
  import { type DestroyOptions } from '../actions/destroy';
7
+ import type { DiagnoseOptions, DiagnoseResult } from '../actions/diagnose';
7
8
  import type { DiffOptions } from '../actions/diff';
8
9
  import type { DriftOptions, DriftResult } from '../actions/drift';
9
10
  import { type ListOptions } from '../actions/list';
11
+ import type { OrphanOptions } from '../actions/orphan';
10
12
  import type { PublishAssetsOptions, PublishAssetsResult } from '../actions/publish-assets';
11
13
  import type { RefactorOptions } from '../actions/refactor';
12
14
  import { type RollbackOptions } from '../actions/rollback';
@@ -76,7 +78,7 @@ export interface ToolkitOptions {
76
78
  * Names of toolkit features that are still under development, and may change in
77
79
  * the future.
78
80
  */
79
- export type UnstableFeature = 'refactor' | 'flags' | 'publish-assets';
81
+ export type UnstableFeature = 'refactor' | 'orphan' | 'flags' | 'publish-assets' | 'diagnose';
80
82
  /**
81
83
  * The AWS CDK Programmatic Toolkit
82
84
  */
@@ -136,6 +138,16 @@ export declare class Toolkit extends CloudAssemblySourceBuilder {
136
138
  * List selected stacks and their dependencies
137
139
  */
138
140
  list(cx: ICloudAssemblySource, options?: ListOptions): Promise<StackDetails[]>;
141
+ /**
142
+ * Try to find the root causes for deployment failures of the given stacks.
143
+ *
144
+ * Both emits the diagnosis results over the IO host as they are coming in, as well
145
+ * as returns all of them as the result of the function.
146
+ *
147
+ * NOTE: The Cloud Assembly Source **should** be configured with `debug: true` to add
148
+ * the maximum number of diagnostics.
149
+ */
150
+ diagnose(cx: ICloudAssemblySource, options?: DiagnoseOptions): Promise<DiagnoseResult>;
139
151
  /**
140
152
  * Deploy Action
141
153
  *
@@ -165,6 +177,10 @@ export declare class Toolkit extends CloudAssemblySourceBuilder {
165
177
  * Helper to allow rollback being called as part of the deploy or watch action.
166
178
  */
167
179
  private _rollback;
180
+ /**
181
+ * Orphan Action. Detaches resources from a CloudFormation stack without deleting them.
182
+ */
183
+ orphan(cx: ICloudAssemblySource, options: OrphanOptions): Promise<void>;
168
184
  /**
169
185
  * Refactor Action. Moves resources from one location (stack + logical ID) to another.
170
186
  */