UNPKG

41.6 kBPlain TextView Raw
1{
2 "author": {
3 "email": "aws-cdk-dev@amazon.com",
4 "name": "Amazon Web Services",
5 "organization": true,
6 "roles": [
7 "author"
8 ]
9 },
10 "description": "A programming model for software-defined state",
11 "docs": {
12 "stability": "stable"
13 },
14 "homepage": "https://github.com/aws/constructs",
15 "jsiiVersion": "5.4.36 (build 0893030)",
16 "keywords": [
17 "aws",
18 "cdk",
19 "constructs",
20 "jsii"
21 ],
22 "license": "Apache-2.0",
23 "metadata": {
24 "jsii": {
25 "pacmak": {
26 "hasDefaultInterfaces": true
27 }
28 },
29 "tscRootDir": "src"
30 },
31 "name": "constructs",
32 "readme": {
33 "markdown": "# Constructs\n\n> Software-defined persistent state\n\n[![Release](https://github.com/aws/constructs/actions/workflows/release.yml/badge.svg)](https://github.com/aws/constructs/actions/workflows/release.yml)\n[![npm version](https://badge.fury.io/js/constructs.svg)](https://badge.fury.io/js/constructs)\n[![PyPI version](https://badge.fury.io/py/constructs.svg)](https://badge.fury.io/py/constructs)\n[![NuGet version](https://badge.fury.io/nu/Constructs.svg)](https://badge.fury.io/nu/Constructs)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/software.constructs/constructs/badge.svg?style=plastic)](https://maven-badges.herokuapp.com/maven-central/software.constructs/constructs)\n\n## What are constructs?\n\nConstructs are classes which define a \"piece of system state\". Constructs can be composed together to form higher-level building blocks which represent more complex state.\n\nConstructs are often used to represent the _desired state_ of cloud applications. For example, in the AWS CDK, which is used to define the desired state for AWS infrastructure using CloudFormation, the lowest-level construct represents a _resource definition_ in a CloudFormation template. These resources are composed to represent higher-level logical units of a cloud application, etc.\n\n## Support policy\n\nAll [maintained Node.js versions](https://nodejs.org/en/about/previous-releases#release-schedule) are supported by this package.\n\n## Contributing\n\nThis project has adopted the [Amazon Open Source Code of\nConduct](https://aws.github.io/code-of-conduct).\n\nWe welcome community contributions and pull requests. See our [contribution\nguide](./CONTRIBUTING.md) for more information on how to report issues, set up a\ndevelopment environment and submit code.\n\n## License\n\nThis project is distributed under the [Apache License, Version 2.0](./LICENSE).\n"
34 },
35 "repository": {
36 "type": "git",
37 "url": "https://github.com/aws/constructs.git"
38 },
39 "schema": "jsii/0.10.0",
40 "targets": {
41 "dotnet": {
42 "namespace": "Constructs",
43 "packageId": "Constructs"
44 },
45 "go": {
46 "moduleName": "github.com/aws/constructs-go"
47 },
48 "java": {
49 "maven": {
50 "artifactId": "constructs",
51 "groupId": "software.constructs"
52 },
53 "package": "software.constructs"
54 },
55 "js": {
56 "npm": "constructs"
57 },
58 "python": {
59 "distName": "constructs",
60 "module": "constructs"
61 }
62 },
63 "types": {
64 "constructs.Construct": {
65 "assembly": "constructs",
66 "docs": {
67 "remarks": "All constructs besides the root construct must be created within the scope of\nanother construct.",
68 "stability": "stable",
69 "summary": "Represents the building block of the construct graph."
70 },
71 "fqn": "constructs.Construct",
72 "initializer": {
73 "docs": {
74 "stability": "stable",
75 "summary": "Creates a new construct node."
76 },
77 "locationInModule": {
78 "filename": "src/construct.ts",
79 "line": 481
80 },
81 "parameters": [
82 {
83 "docs": {
84 "summary": "The scope in which to define this construct."
85 },
86 "name": "scope",
87 "type": {
88 "fqn": "constructs.Construct"
89 }
90 },
91 {
92 "docs": {
93 "remarks": "Must be unique amongst siblings. If\nthe ID includes a path separator (`/`), then it will be replaced by double\ndash `--`.",
94 "summary": "The scoped construct ID."
95 },
96 "name": "id",
97 "type": {
98 "primitive": "string"
99 }
100 }
101 ]
102 },
103 "interfaces": [
104 "constructs.IConstruct"
105 ],
106 "kind": "class",
107 "locationInModule": {
108 "filename": "src/construct.ts",
109 "line": 443
110 },
111 "methods": [
112 {
113 "docs": {
114 "remarks": "Use this method instead of `instanceof` to properly detect `Construct`\ninstances, even when the construct library is symlinked.\n\nExplanation: in JavaScript, multiple copies of the `constructs` library on\ndisk are seen as independent, completely different libraries. As a\nconsequence, the class `Construct` in each copy of the `constructs` library\nis seen as a different class, and an instance of one class will not test as\n`instanceof` the other class. `npm install` will not create installations\nlike this, but users may manually symlink construct libraries together or\nuse a monorepo tool: in those cases, multiple copies of the `constructs`\nlibrary can be accidentally installed, and `instanceof` will behave\nunpredictably. It is safest to avoid using `instanceof`, and using\nthis type-testing method instead.",
115 "returns": "true if `x` is an object created from a class which extends `Construct`.",
116 "stability": "stable",
117 "summary": "Checks if `x` is a construct."
118 },
119 "locationInModule": {
120 "filename": "src/construct.ts",
121 "line": 464
122 },
123 "name": "isConstruct",
124 "parameters": [
125 {
126 "docs": {
127 "summary": "Any object."
128 },
129 "name": "x",
130 "type": {
131 "primitive": "any"
132 }
133 }
134 ],
135 "returns": {
136 "type": {
137 "primitive": "boolean"
138 }
139 },
140 "static": true
141 },
142 {
143 "docs": {
144 "stability": "stable",
145 "summary": "Returns a string representation of this construct."
146 },
147 "locationInModule": {
148 "filename": "src/construct.ts",
149 "line": 493
150 },
151 "name": "toString",
152 "returns": {
153 "type": {
154 "primitive": "string"
155 }
156 }
157 }
158 ],
159 "name": "Construct",
160 "properties": [
161 {
162 "docs": {
163 "stability": "stable",
164 "summary": "The tree node."
165 },
166 "immutable": true,
167 "locationInModule": {
168 "filename": "src/construct.ts",
169 "line": 471
170 },
171 "name": "node",
172 "overrides": "constructs.IConstruct",
173 "type": {
174 "fqn": "constructs.Node"
175 }
176 }
177 ],
178 "symbolId": "src/construct:Construct"
179 },
180 "constructs.ConstructOrder": {
181 "assembly": "constructs",
182 "docs": {
183 "stability": "stable",
184 "summary": "In what order to return constructs."
185 },
186 "fqn": "constructs.ConstructOrder",
187 "kind": "enum",
188 "locationInModule": {
189 "filename": "src/construct.ts",
190 "line": 516
191 },
192 "members": [
193 {
194 "docs": {
195 "stability": "stable",
196 "summary": "Depth-first, pre-order."
197 },
198 "name": "PREORDER"
199 },
200 {
201 "docs": {
202 "stability": "stable",
203 "summary": "Depth-first, post-order (leaf nodes first)."
204 },
205 "name": "POSTORDER"
206 }
207 ],
208 "name": "ConstructOrder",
209 "symbolId": "src/construct:ConstructOrder"
210 },
211 "constructs.Dependable": {
212 "abstract": true,
213 "assembly": "constructs",
214 "docs": {
215 "example": "// Usage\nconst roots = Dependable.of(construct).dependencyRoots;\n\n// Definition\nDependable.implement(construct, {\n dependencyRoots: [construct],\n});",
216 "remarks": "Traits are interfaces that are privately implemented by objects. Instead of\nshowing up in the public interface of a class, they need to be queried\nexplicitly. This is used to implement certain framework features that are\nnot intended to be used by Construct consumers, and so should be hidden\nfrom accidental use.",
217 "stability": "stable",
218 "summary": "Trait for IDependable."
219 },
220 "fqn": "constructs.Dependable",
221 "initializer": {
222 "docs": {
223 "stability": "stable"
224 }
225 },
226 "kind": "class",
227 "locationInModule": {
228 "filename": "src/dependency.ts",
229 "line": 72
230 },
231 "methods": [
232 {
233 "docs": {
234 "deprecated": "use `of`",
235 "stability": "deprecated",
236 "summary": "Return the matching Dependable for the given class instance."
237 },
238 "locationInModule": {
239 "filename": "src/dependency.ts",
240 "line": 98
241 },
242 "name": "get",
243 "parameters": [
244 {
245 "name": "instance",
246 "type": {
247 "fqn": "constructs.IDependable"
248 }
249 }
250 ],
251 "returns": {
252 "type": {
253 "fqn": "constructs.Dependable"
254 }
255 },
256 "static": true
257 },
258 {
259 "docs": {
260 "stability": "stable",
261 "summary": "Turn any object into an IDependable."
262 },
263 "locationInModule": {
264 "filename": "src/dependency.ts",
265 "line": 76
266 },
267 "name": "implement",
268 "parameters": [
269 {
270 "name": "instance",
271 "type": {
272 "fqn": "constructs.IDependable"
273 }
274 },
275 {
276 "name": "trait",
277 "type": {
278 "fqn": "constructs.Dependable"
279 }
280 }
281 ],
282 "static": true
283 },
284 {
285 "docs": {
286 "stability": "stable",
287 "summary": "Return the matching Dependable for the given class instance."
288 },
289 "locationInModule": {
290 "filename": "src/dependency.ts",
291 "line": 86
292 },
293 "name": "of",
294 "parameters": [
295 {
296 "name": "instance",
297 "type": {
298 "fqn": "constructs.IDependable"
299 }
300 }
301 ],
302 "returns": {
303 "type": {
304 "fqn": "constructs.Dependable"
305 }
306 },
307 "static": true
308 }
309 ],
310 "name": "Dependable",
311 "properties": [
312 {
313 "abstract": true,
314 "docs": {
315 "remarks": "All resources under all returned constructs are included in the ordering\ndependency.",
316 "stability": "stable",
317 "summary": "The set of constructs that form the root of this dependable."
318 },
319 "immutable": true,
320 "locationInModule": {
321 "filename": "src/dependency.ts",
322 "line": 108
323 },
324 "name": "dependencyRoots",
325 "type": {
326 "collection": {
327 "elementtype": {
328 "fqn": "constructs.IConstruct"
329 },
330 "kind": "array"
331 }
332 }
333 }
334 ],
335 "symbolId": "src/dependency:Dependable"
336 },
337 "constructs.DependencyGroup": {
338 "assembly": "constructs",
339 "docs": {
340 "remarks": "This class can be used when a set of constructs which are disjoint in the\nconstruct tree needs to be combined to be used as a single dependable.",
341 "stability": "stable",
342 "summary": "A set of constructs to be used as a dependable."
343 },
344 "fqn": "constructs.DependencyGroup",
345 "initializer": {
346 "docs": {
347 "stability": "stable"
348 },
349 "locationInModule": {
350 "filename": "src/dependency.ts",
351 "line": 27
352 },
353 "parameters": [
354 {
355 "name": "deps",
356 "type": {
357 "fqn": "constructs.IDependable"
358 },
359 "variadic": true
360 }
361 ],
362 "variadic": true
363 },
364 "interfaces": [
365 "constructs.IDependable"
366 ],
367 "kind": "class",
368 "locationInModule": {
369 "filename": "src/dependency.ts",
370 "line": 24
371 },
372 "methods": [
373 {
374 "docs": {
375 "stability": "stable",
376 "summary": "Add a construct to the dependency roots."
377 },
378 "locationInModule": {
379 "filename": "src/dependency.ts",
380 "line": 46
381 },
382 "name": "add",
383 "parameters": [
384 {
385 "name": "scopes",
386 "type": {
387 "fqn": "constructs.IDependable"
388 },
389 "variadic": true
390 }
391 ],
392 "variadic": true
393 }
394 ],
395 "name": "DependencyGroup",
396 "symbolId": "src/dependency:DependencyGroup"
397 },
398 "constructs.IConstruct": {
399 "assembly": "constructs",
400 "docs": {
401 "stability": "stable",
402 "summary": "Represents a construct."
403 },
404 "fqn": "constructs.IConstruct",
405 "interfaces": [
406 "constructs.IDependable"
407 ],
408 "kind": "interface",
409 "locationInModule": {
410 "filename": "src/construct.ts",
411 "line": 11
412 },
413 "name": "IConstruct",
414 "properties": [
415 {
416 "abstract": true,
417 "docs": {
418 "stability": "stable",
419 "summary": "The tree node."
420 },
421 "immutable": true,
422 "locationInModule": {
423 "filename": "src/construct.ts",
424 "line": 15
425 },
426 "name": "node",
427 "type": {
428 "fqn": "constructs.Node"
429 }
430 }
431 ],
432 "symbolId": "src/construct:IConstruct"
433 },
434 "constructs.IDependable": {
435 "assembly": "constructs",
436 "docs": {
437 "remarks": "The presence of this interface indicates that an object has\nan `IDependable` implementation.\n\nThis interface can be used to take an (ordering) dependency on a set of\nconstructs. An ordering dependency implies that the resources represented by\nthose constructs are deployed before the resources depending ON them are\ndeployed.",
438 "stability": "stable",
439 "summary": "Trait marker for classes that can be depended upon."
440 },
441 "fqn": "constructs.IDependable",
442 "kind": "interface",
443 "locationInModule": {
444 "filename": "src/dependency.ts",
445 "line": 14
446 },
447 "name": "IDependable",
448 "symbolId": "src/dependency:IDependable"
449 },
450 "constructs.IValidation": {
451 "assembly": "constructs",
452 "docs": {
453 "stability": "stable",
454 "summary": "Implement this interface in order for the construct to be able to validate itself."
455 },
456 "fqn": "constructs.IValidation",
457 "kind": "interface",
458 "locationInModule": {
459 "filename": "src/construct.ts",
460 "line": 501
461 },
462 "methods": [
463 {
464 "abstract": true,
465 "docs": {
466 "remarks": "This method can be implemented by derived constructs in order to perform\nvalidation logic. It is called on all constructs before synthesis.",
467 "returns": "An array of validation error messages, or an empty array if there the construct is valid.",
468 "stability": "stable",
469 "summary": "Validate the current construct."
470 },
471 "locationInModule": {
472 "filename": "src/construct.ts",
473 "line": 510
474 },
475 "name": "validate",
476 "returns": {
477 "type": {
478 "collection": {
479 "elementtype": {
480 "primitive": "string"
481 },
482 "kind": "array"
483 }
484 }
485 }
486 }
487 ],
488 "name": "IValidation",
489 "symbolId": "src/construct:IValidation"
490 },
491 "constructs.MetadataEntry": {
492 "assembly": "constructs",
493 "datatype": true,
494 "docs": {
495 "stability": "stable",
496 "summary": "An entry in the construct metadata table."
497 },
498 "fqn": "constructs.MetadataEntry",
499 "kind": "interface",
500 "locationInModule": {
501 "filename": "src/metadata.ts",
502 "line": 4
503 },
504 "name": "MetadataEntry",
505 "properties": [
506 {
507 "abstract": true,
508 "docs": {
509 "stability": "stable",
510 "summary": "The data."
511 },
512 "immutable": true,
513 "locationInModule": {
514 "filename": "src/metadata.ts",
515 "line": 13
516 },
517 "name": "data",
518 "type": {
519 "primitive": "any"
520 }
521 },
522 {
523 "abstract": true,
524 "docs": {
525 "stability": "stable",
526 "summary": "The metadata entry type."
527 },
528 "immutable": true,
529 "locationInModule": {
530 "filename": "src/metadata.ts",
531 "line": 8
532 },
533 "name": "type",
534 "type": {
535 "primitive": "string"
536 }
537 },
538 {
539 "abstract": true,
540 "docs": {
541 "default": "- no trace information",
542 "remarks": "Only available if `addMetadata()` is called with `stackTrace: true`.",
543 "stability": "stable",
544 "summary": "Stack trace at the point of adding the metadata."
545 },
546 "immutable": true,
547 "locationInModule": {
548 "filename": "src/metadata.ts",
549 "line": 22
550 },
551 "name": "trace",
552 "optional": true,
553 "type": {
554 "collection": {
555 "elementtype": {
556 "primitive": "string"
557 },
558 "kind": "array"
559 }
560 }
561 }
562 ],
563 "symbolId": "src/metadata:MetadataEntry"
564 },
565 "constructs.MetadataOptions": {
566 "assembly": "constructs",
567 "datatype": true,
568 "docs": {
569 "stability": "stable",
570 "summary": "Options for `construct.addMetadata()`."
571 },
572 "fqn": "constructs.MetadataOptions",
573 "kind": "interface",
574 "locationInModule": {
575 "filename": "src/construct.ts",
576 "line": 541
577 },
578 "name": "MetadataOptions",
579 "properties": [
580 {
581 "abstract": true,
582 "docs": {
583 "default": "false",
584 "stability": "stable",
585 "summary": "Include stack trace with metadata entry."
586 },
587 "immutable": true,
588 "locationInModule": {
589 "filename": "src/construct.ts",
590 "line": 546
591 },
592 "name": "stackTrace",
593 "optional": true,
594 "type": {
595 "primitive": "boolean"
596 }
597 },
598 {
599 "abstract": true,
600 "docs": {
601 "default": "addMetadata()",
602 "remarks": "This option is ignored unless `stackTrace` is `true`.",
603 "stability": "stable",
604 "summary": "A JavaScript function to begin tracing from."
605 },
606 "immutable": true,
607 "locationInModule": {
608 "filename": "src/construct.ts",
609 "line": 555
610 },
611 "name": "traceFromFunction",
612 "optional": true,
613 "type": {
614 "primitive": "any"
615 }
616 }
617 ],
618 "symbolId": "src/construct:MetadataOptions"
619 },
620 "constructs.Node": {
621 "assembly": "constructs",
622 "docs": {
623 "stability": "stable",
624 "summary": "Represents the construct node in the scope tree."
625 },
626 "fqn": "constructs.Node",
627 "initializer": {
628 "docs": {
629 "stability": "stable"
630 },
631 "locationInModule": {
632 "filename": "src/construct.ts",
633 "line": 60
634 },
635 "parameters": [
636 {
637 "name": "host",
638 "type": {
639 "fqn": "constructs.Construct"
640 }
641 },
642 {
643 "name": "scope",
644 "type": {
645 "fqn": "constructs.IConstruct"
646 }
647 },
648 {
649 "name": "id",
650 "type": {
651 "primitive": "string"
652 }
653 }
654 ]
655 },
656 "kind": "class",
657 "locationInModule": {
658 "filename": "src/construct.ts",
659 "line": 21
660 },
661 "methods": [
662 {
663 "docs": {
664 "deprecated": "use `construct.node` instead",
665 "stability": "deprecated",
666 "summary": "Returns the node associated with a construct."
667 },
668 "locationInModule": {
669 "filename": "src/construct.ts",
670 "line": 33
671 },
672 "name": "of",
673 "parameters": [
674 {
675 "docs": {
676 "summary": "the construct."
677 },
678 "name": "construct",
679 "type": {
680 "fqn": "constructs.IConstruct"
681 }
682 }
683 ],
684 "returns": {
685 "type": {
686 "fqn": "constructs.Node"
687 }
688 },
689 "static": true
690 },
691 {
692 "docs": {
693 "remarks": "An `IDependable`",
694 "stability": "stable",
695 "summary": "Add an ordering dependency on another construct."
696 },
697 "locationInModule": {
698 "filename": "src/construct.ts",
699 "line": 345
700 },
701 "name": "addDependency",
702 "parameters": [
703 {
704 "name": "deps",
705 "type": {
706 "fqn": "constructs.IDependable"
707 },
708 "variadic": true
709 }
710 ],
711 "variadic": true
712 },
713 {
714 "docs": {
715 "remarks": "Entries are arbitrary values and will also include a stack trace to allow tracing back to\nthe code location for when the entry was added. It can be used, for example, to include source\nmapping in CloudFormation templates to improve diagnostics.\nNote that construct metadata is not the same as CloudFormation resource metadata and is never written to the CloudFormation template.\nThe metadata entries are written to the Cloud Assembly Manifest if the `treeMetadata` property is specified in the props of the App that contains this Construct.",
716 "stability": "stable",
717 "summary": "Adds a metadata entry to this construct."
718 },
719 "locationInModule": {
720 "filename": "src/construct.ts",
721 "line": 287
722 },
723 "name": "addMetadata",
724 "parameters": [
725 {
726 "docs": {
727 "summary": "a string denoting the type of metadata."
728 },
729 "name": "type",
730 "type": {
731 "primitive": "string"
732 }
733 },
734 {
735 "docs": {
736 "remarks": "If null/undefined, metadata will not be added.",
737 "summary": "the value of the metadata (can be a Token)."
738 },
739 "name": "data",
740 "type": {
741 "primitive": "any"
742 }
743 },
744 {
745 "docs": {
746 "summary": "options."
747 },
748 "name": "options",
749 "optional": true,
750 "type": {
751 "fqn": "constructs.MetadataOptions"
752 }
753 }
754 ]
755 },
756 {
757 "docs": {
758 "remarks": "When `node.validate()` is called, the `validate()` method will be called on\nall validations and all errors will be returned.",
759 "stability": "stable",
760 "summary": "Adds a validation to this construct."
761 },
762 "locationInModule": {
763 "filename": "src/construct.ts",
764 "line": 384
765 },
766 "name": "addValidation",
767 "parameters": [
768 {
769 "docs": {
770 "summary": "The validation object."
771 },
772 "name": "validation",
773 "type": {
774 "fqn": "constructs.IValidation"
775 }
776 }
777 ]
778 },
779 {
780 "docs": {
781 "stability": "stable",
782 "summary": "Return this construct and all of its children in the given order."
783 },
784 "locationInModule": {
785 "filename": "src/construct.ts",
786 "line": 184
787 },
788 "name": "findAll",
789 "parameters": [
790 {
791 "name": "order",
792 "optional": true,
793 "type": {
794 "fqn": "constructs.ConstructOrder"
795 }
796 }
797 ],
798 "returns": {
799 "type": {
800 "collection": {
801 "elementtype": {
802 "fqn": "constructs.IConstruct"
803 },
804 "kind": "array"
805 }
806 }
807 }
808 },
809 {
810 "docs": {
811 "remarks": "Throws an error if the child is not found.",
812 "returns": "Child with the given id.",
813 "stability": "stable",
814 "summary": "Return a direct child by id."
815 },
816 "locationInModule": {
817 "filename": "src/construct.ts",
818 "line": 130
819 },
820 "name": "findChild",
821 "parameters": [
822 {
823 "docs": {
824 "summary": "Identifier of direct child."
825 },
826 "name": "id",
827 "type": {
828 "primitive": "string"
829 }
830 }
831 ],
832 "returns": {
833 "type": {
834 "fqn": "constructs.IConstruct"
835 }
836 }
837 },
838 {
839 "docs": {
840 "remarks": "Context is usually initialized at the root, but can be overridden at any point in the tree.",
841 "returns": "The context object or an empty object if there is discovered context",
842 "stability": "stable",
843 "summary": "Retrieves the all context of a node from tree context."
844 },
845 "locationInModule": {
846 "filename": "src/construct.ts",
847 "line": 247
848 },
849 "name": "getAllContext",
850 "parameters": [
851 {
852 "docs": {
853 "summary": "Any keys to override the retrieved context."
854 },
855 "name": "defaults",
856 "optional": true,
857 "type": {
858 "primitive": "json"
859 }
860 }
861 ],
862 "returns": {
863 "type": {
864 "primitive": "any"
865 }
866 }
867 },
868 {
869 "docs": {
870 "remarks": "Context is usually initialized at the root, but can be overridden at any point in the tree.",
871 "returns": "The context value or throws error if there is no context value for this key",
872 "stability": "stable",
873 "summary": "Retrieves a value from tree context if present. Otherwise, would throw an error."
874 },
875 "locationInModule": {
876 "filename": "src/construct.ts",
877 "line": 227
878 },
879 "name": "getContext",
880 "parameters": [
881 {
882 "docs": {
883 "summary": "The context key."
884 },
885 "name": "key",
886 "type": {
887 "primitive": "string"
888 }
889 }
890 ],
891 "returns": {
892 "type": {
893 "primitive": "any"
894 }
895 }
896 },
897 {
898 "docs": {
899 "remarks": "After this\ncall, no more children can be added to this construct or to any children.",
900 "stability": "stable",
901 "summary": "Locks this construct from allowing more children to be added."
902 },
903 "locationInModule": {
904 "filename": "src/construct.ts",
905 "line": 405
906 },
907 "name": "lock"
908 },
909 {
910 "docs": {
911 "remarks": "Context must be set before any children are added, since children may consult context info during construction.\nIf the key already exists, it will be overridden.",
912 "stability": "stable",
913 "summary": "This can be used to set contextual values."
914 },
915 "locationInModule": {
916 "filename": "src/construct.ts",
917 "line": 211
918 },
919 "name": "setContext",
920 "parameters": [
921 {
922 "docs": {
923 "summary": "The context key."
924 },
925 "name": "key",
926 "type": {
927 "primitive": "string"
928 }
929 },
930 {
931 "docs": {
932 "summary": "The context value."
933 },
934 "name": "value",
935 "type": {
936 "primitive": "any"
937 }
938 }
939 ]
940 },
941 {
942 "docs": {
943 "returns": "the child if found, or undefined",
944 "stability": "stable",
945 "summary": "Return a direct child by id, or undefined."
946 },
947 "locationInModule": {
948 "filename": "src/construct.ts",
949 "line": 118
950 },
951 "name": "tryFindChild",
952 "parameters": [
953 {
954 "docs": {
955 "summary": "Identifier of direct child."
956 },
957 "name": "id",
958 "type": {
959 "primitive": "string"
960 }
961 }
962 ],
963 "returns": {
964 "optional": true,
965 "type": {
966 "fqn": "constructs.IConstruct"
967 }
968 }
969 },
970 {
971 "docs": {
972 "remarks": "Context is usually initialized at the root, but can be overridden at any point in the tree.",
973 "returns": "The context value or `undefined` if there is no context value for this key.",
974 "stability": "stable",
975 "summary": "Retrieves a value from tree context."
976 },
977 "locationInModule": {
978 "filename": "src/construct.ts",
979 "line": 260
980 },
981 "name": "tryGetContext",
982 "parameters": [
983 {
984 "docs": {
985 "summary": "The context key."
986 },
987 "name": "key",
988 "type": {
989 "primitive": "string"
990 }
991 }
992 ],
993 "returns": {
994 "type": {
995 "primitive": "any"
996 }
997 }
998 },
999 {
1000 "docs": {
1001 "returns": "Whether a child with the given name was deleted.",
1002 "stability": "stable",
1003 "summary": "Remove the child with the given name, if present."
1004 },
1005 "locationInModule": {
1006 "filename": "src/construct.ts",
1007 "line": 370
1008 },
1009 "name": "tryRemoveChild",
1010 "parameters": [
1011 {
1012 "name": "childName",
1013 "type": {
1014 "primitive": "string"
1015 }
1016 }
1017 ],
1018 "returns": {
1019 "type": {
1020 "primitive": "boolean"
1021 }
1022 }
1023 },
1024 {
1025 "docs": {
1026 "remarks": "Invokes the `validate()` method on all validations added through\n`addValidation()`.",
1027 "returns": "an array of validation error messages associated with this\nconstruct.",
1028 "stability": "stable",
1029 "summary": "Validates this construct."
1030 },
1031 "locationInModule": {
1032 "filename": "src/construct.ts",
1033 "line": 397
1034 },
1035 "name": "validate",
1036 "returns": {
1037 "type": {
1038 "collection": {
1039 "elementtype": {
1040 "primitive": "string"
1041 },
1042 "kind": "array"
1043 }
1044 }
1045 }
1046 }
1047 ],
1048 "name": "Node",
1049 "properties": [
1050 {
1051 "const": true,
1052 "docs": {
1053 "stability": "stable",
1054 "summary": "Separator used to delimit construct path components."
1055 },
1056 "immutable": true,
1057 "locationInModule": {
1058 "filename": "src/construct.ts",
1059 "line": 25
1060 },
1061 "name": "PATH_SEP",
1062 "static": true,
1063 "type": {
1064 "primitive": "string"
1065 }
1066 },
1067 {
1068 "docs": {
1069 "example": "c83a2846e506bcc5f10682b564084bca2d275709ee",
1070 "remarks": "Addresses are 42 characters hexadecimal strings. They begin with \"c8\"\nfollowed by 40 lowercase hexadecimal characters (0-9a-f).\n\nAddresses are calculated using a SHA-1 of the components of the construct\npath.\n\nTo enable refactoring of construct trees, constructs with the ID `Default`\nwill be excluded from the calculation. In those cases constructs in the\nsame tree may have the same address.",
1071 "stability": "stable",
1072 "summary": "Returns an opaque tree-unique address for this construct."
1073 },
1074 "immutable": true,
1075 "locationInModule": {
1076 "filename": "src/construct.ts",
1077 "line": 104
1078 },
1079 "name": "addr",
1080 "type": {
1081 "primitive": "string"
1082 }
1083 },
1084 {
1085 "docs": {
1086 "stability": "stable",
1087 "summary": "All direct children of this construct."
1088 },
1089 "immutable": true,
1090 "locationInModule": {
1091 "filename": "src/construct.ts",
1092 "line": 177
1093 },
1094 "name": "children",
1095 "type": {
1096 "collection": {
1097 "elementtype": {
1098 "fqn": "constructs.IConstruct"
1099 },
1100 "kind": "array"
1101 }
1102 }
1103 },
1104 {
1105 "docs": {
1106 "stability": "stable",
1107 "summary": "Return all dependencies registered on this node (non-recursive)."
1108 },
1109 "immutable": true,
1110 "locationInModule": {
1111 "filename": "src/construct.ts",
1112 "line": 354
1113 },
1114 "name": "dependencies",
1115 "type": {
1116 "collection": {
1117 "elementtype": {
1118 "fqn": "constructs.IConstruct"
1119 },
1120 "kind": "array"
1121 }
1122 }
1123 },
1124 {
1125 "docs": {
1126 "remarks": "This is a scope-unique id. To obtain an app-unique id for this construct, use `addr`.",
1127 "stability": "stable",
1128 "summary": "The id of this construct within the current scope."
1129 },
1130 "immutable": true,
1131 "locationInModule": {
1132 "filename": "src/construct.ts",
1133 "line": 49
1134 },
1135 "name": "id",
1136 "type": {
1137 "primitive": "string"
1138 }
1139 },
1140 {
1141 "docs": {
1142 "stability": "stable",
1143 "summary": "Returns true if this construct or the scopes in which it is defined are locked."
1144 },
1145 "immutable": true,
1146 "locationInModule": {
1147 "filename": "src/construct.ts",
1148 "line": 328
1149 },
1150 "name": "locked",
1151 "type": {
1152 "primitive": "boolean"
1153 }
1154 },
1155 {
1156 "docs": {
1157 "remarks": "This can be used, for example, to implement support for deprecation notices, source mapping, etc.",
1158 "stability": "stable",
1159 "summary": "An immutable array of metadata objects associated with this construct."
1160 },
1161 "immutable": true,
1162 "locationInModule": {
1163 "filename": "src/construct.ts",
1164 "line": 271
1165 },
1166 "name": "metadata",
1167 "type": {
1168 "collection": {
1169 "elementtype": {
1170 "fqn": "constructs.MetadataEntry"
1171 },
1172 "kind": "array"
1173 }
1174 }
1175 },
1176 {
1177 "docs": {
1178 "remarks": "Components are separated by '/'.",
1179 "stability": "stable",
1180 "summary": "The full, absolute path of this construct in the tree."
1181 },
1182 "immutable": true,
1183 "locationInModule": {
1184 "filename": "src/construct.ts",
1185 "line": 79
1186 },
1187 "name": "path",
1188 "type": {
1189 "primitive": "string"
1190 }
1191 },
1192 {
1193 "docs": {
1194 "returns": "The root of the construct tree.",
1195 "stability": "stable",
1196 "summary": "Returns the root of the construct tree."
1197 },
1198 "immutable": true,
1199 "locationInModule": {
1200 "filename": "src/construct.ts",
1201 "line": 320
1202 },
1203 "name": "root",
1204 "type": {
1205 "fqn": "constructs.IConstruct"
1206 }
1207 },
1208 {
1209 "docs": {
1210 "returns": "a list of parent scopes. The last element in the list will always\nbe the current construct and the first element will be the root of the\ntree.",
1211 "stability": "stable",
1212 "summary": "All parent scopes of this construct."
1213 },
1214 "immutable": true,
1215 "locationInModule": {
1216 "filename": "src/construct.ts",
1217 "line": 304
1218 },
1219 "name": "scopes",
1220 "type": {
1221 "collection": {
1222 "elementtype": {
1223 "fqn": "constructs.IConstruct"
1224 },
1225 "kind": "array"
1226 }
1227 }
1228 },
1229 {
1230 "docs": {
1231 "remarks": "The value is `undefined` at the root of the construct scope tree.",
1232 "stability": "stable",
1233 "summary": "Returns the scope in which this construct is defined."
1234 },
1235 "immutable": true,
1236 "locationInModule": {
1237 "filename": "src/construct.ts",
1238 "line": 42
1239 },
1240 "name": "scope",
1241 "optional": true,
1242 "type": {
1243 "fqn": "constructs.IConstruct"
1244 }
1245 },
1246 {
1247 "docs": {
1248 "custom": {
1249 "throws": "if there is more than one child"
1250 },
1251 "remarks": "This is usually the construct that provides the bulk of the underlying functionality.\nUseful for modifications of the underlying construct that are not available at the higher levels.\nOverride the defaultChild property.\n\nThis should only be used in the cases where the correct\ndefault child is not named 'Resource' or 'Default' as it\nshould be.\n\nIf you set this to undefined, the default behavior of finding\nthe child named 'Resource' or 'Default' will be used.",
1252 "returns": "a construct or undefined if there is no default child",
1253 "stability": "stable",
1254 "summary": "Returns the child construct that has the id `Default` or `Resource\"`."
1255 },
1256 "locationInModule": {
1257 "filename": "src/construct.ts",
1258 "line": 146
1259 },
1260 "name": "defaultChild",
1261 "optional": true,
1262 "type": {
1263 "fqn": "constructs.IConstruct"
1264 }
1265 }
1266 ],
1267 "symbolId": "src/construct:Node"
1268 },
1269 "constructs.RootConstruct": {
1270 "assembly": "constructs",
1271 "base": "constructs.Construct",
1272 "docs": {
1273 "remarks": "The root construct represents the top of the construct tree and is not contained within a parent scope itself.\nFor root constructs, the id is optional.",
1274 "stability": "stable",
1275 "summary": "Creates a new root construct node."
1276 },
1277 "fqn": "constructs.RootConstruct",
1278 "initializer": {
1279 "docs": {
1280 "stability": "stable",
1281 "summary": "Creates a new root construct node."
1282 },
1283 "locationInModule": {
1284 "filename": "src/construct.ts",
1285 "line": 579
1286 },
1287 "parameters": [
1288 {
1289 "docs": {
1290 "remarks": "Must be unique amongst siblings. If\nthe ID includes a path separator (`/`), then it will be replaced by double\ndash `--`.",
1291 "summary": "The scoped construct ID."
1292 },
1293 "name": "id",
1294 "optional": true,
1295 "type": {
1296 "primitive": "string"
1297 }
1298 }
1299 ]
1300 },
1301 "kind": "class",
1302 "locationInModule": {
1303 "filename": "src/construct.ts",
1304 "line": 571
1305 },
1306 "name": "RootConstruct",
1307 "symbolId": "src/construct:RootConstruct"
1308 }
1309 },
1310 "version": "10.4.2",
1311 "fingerprint": "+0GkpuNfNI/pq9SPETomSpMo9D67QcVbiDoOit855Ec="
1312}
\No newline at end of file